project_tools

Project Tools

Tools for managing projects in config.json.

Overview

These tools help you add, list, update, and remove projects from the workflow configuration. They support auto-detection of project settings from the filesystem.

Tools

project_list

List all configured projects.

project_list()

Shows:

• Project name and path
• GitLab and Jira configuration
• Default branch
• Status (✅ if path exists, ❌ if missing)

project_detect

Auto-detect project settings from a directory.

project_detect(path="/path/to/project")

Detects:

• Language: Python, JavaScript, Go, Rust, Java
• Default branch: From git remote HEAD
• GitLab remote: From git origin URL
• Lint command: Based on config files (pyproject.toml, package.json, etc.)
• Test command: Based on test framework detection
• Scopes: From directory structure

Returns a suggested config entry that can be used with project_add.

project_add

Add a new project to config.json.

project_add(
    name="my-project",
    path="/home/user/src/my-project",
    gitlab="org/my-project",
    jira_project="AAP",
    jira_component="My Component",  # optional
    lint_command="",                # auto-detected if empty
    test_command="",                # auto-detected if empty
    default_branch="main",          # auto-detected if empty
    konflux_namespace="",           # optional
    scopes="api,core,tests",        # comma-separated, auto-detected if empty
    auto_detect=True                # enable auto-detection
)

If auto_detect=True (default), empty fields will be populated from the project directory.

project_update

Update an existing project's configuration.

project_update(
    name="my-project",
    lint_command="ruff check .",    # only updates provided fields
    test_command="pytest -v"
)

Only updates fields that are provided (non-empty).

project_remove

Remove a project from config.json.

project_remove(name="my-project")           # shows confirmation prompt
project_remove(name="my-project", confirm=True)  # actually removes