Skip to content

Multi-Codebase Orchestration CLI #152

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
OBenner wants to merge 9 commits into
base: develop
Choose a base branch
from
Open

Multi-Codebase Orchestration CLI #152

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
a51c8d1
feat(cli): add multi_repo_commands.py with workspace create, list, ad…
Mar 20, 2026
8148702
feat(analysis): add MultiRepoDependencyGraph for multi-repo graph vis…
Mar 20, 2026
f686723
feat(cli): add multi-repo workspace CLI arguments and dispatch
Mar 20, 2026
3acb44f
test(cli): add multi-repo CLI command handler tests
Mar 20, 2026
d9b6ea6
test(analysis): add dependency graph analysis tests
Mar 20, 2026
738cbe8
chore(plan): mark subtask-3-2 as completed
Mar 20, 2026
8f61c56
Merge remote-tracking branch 'origin/develop' into auto-claude/163-mu…
Mar 24, 2026
16eb72e
fix: resolve merge conflict, fix lint errors, and reduce code duplica…
Mar 24, 2026
c5cd69c
fix: address all review feedback for multi-codebase orchestration
Mar 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
197 changes: 197 additions & 0 deletions .auto-claude/specs/163-multi-codebase-orchestration/implementation_plan.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,197 @@
{
"feature": "Multi-Codebase Orchestration CLI",
"workflow_type": "feature",
"workflow_rationale": "New CLI commands layered on top of existing workspace_config/workspace_manager infrastructure",
"phases": [
{
"id": "phase-1-multi-repo-commands",
"name": "Multi-Repo CLI Commands",
"type": "implementation",
"description": "Create CLI module exposing workspace create/list/add-project and dependency graph commands",
"depends_on": [],
"parallel_safe": true,
"subtasks": [
{
"id": "subtask-1-1",
"description": "Create multi_repo_commands.py with workspace create, list, add-project handlers",
"service": "backend",
"files_to_create": [
"apps/backend/cli/multi_repo_commands.py"
],
"files_to_modify": [],
"patterns_from": [
"apps/backend/cli/workspace_commands.py",
"apps/backend/core/workspace_manager.py"
],
"verification": {
"type": "command",
"command": "python -c \"from apps.backend.cli.multi_repo_commands import handle_workspace_create_command; print('OK')\"",
"expected": "OK"
},
"status": "completed"
},
{
"id": "subtask-1-2",
"description": "Create dependency_graph.py analysis module for multi-repo graph visualization",
"service": "backend",
"files_to_create": [
"apps/backend/analysis/dependency_graph.py"
],
"files_to_modify": [],
"patterns_from": [
"apps/backend/core/workspace_config.py",
"apps/backend/context/dependency_analyzer.py"
],
"verification": {
"type": "command",
"command": "python -c \"from apps.backend.analysis.dependency_graph import MultiRepoDependencyGraph; print('OK')\"",
"expected": "OK"
},
"status": "completed"
}
]
},
{
"id": "phase-2-cli-integration",
"name": "CLI Integration",
"type": "implementation",
"description": "Add --workspace-create, --workspace-list, --workspace-add-project, --dep-graph args to main.py",
"depends_on": [
"phase-1-multi-repo-commands"
],
"parallel_safe": false,
"subtasks": [
{
"id": "subtask-2-1",
"description": "Add multi-repo CLI arguments and dispatch to main.py",
"service": "backend",
"files_to_modify": [
"apps/backend/cli/main.py"
],
"files_to_create": [],
"patterns_from": [
"apps/backend/cli/main.py"
],
"verification": {
"type": "command",
"command": "python apps/backend/run.py --help 2>&1 | grep -c workspace",
"expected": "2"
},
Comment on lines +58 to +79
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot Mar 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

This completed phase is already out of sync with the actual CLI.

The description still mentions --dep-graph, and the verifier assumes only two workspace hits in --help. apps/backend/cli/main.py in this PR adds three workspace flags and no --dep-graph, so this plan will misreport completion if it gets re-run or audited.

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In @.auto-claude/specs/163-multi-codebase-orchestration/implementation_plan.json
around lines 58 - 79, Update the implementation plan JSON to match the actual
CLI changes: remove the stale reference to `--dep-graph` from the task
"description" and update the verifier under "verification.command" to expect
three `workspace` occurrences (change the grep count expected from 2 to 3) so it
matches the flags added in `apps/backend/cli/main.py` (`--workspace-create`,
`--workspace-list`, `--workspace-add-project`); ensure the "description" text
and the "expected" value in the `implementation_plan.json` subtask reflect these
exact CLI flags and counts.

"status": "completed"
}
]
},
{
"id": "phase-3-tests",
"name": "Tests",
"type": "implementation",
"description": "Unit tests for multi_repo_commands and dependency_graph modules",
"depends_on": [
"phase-2-cli-integration"
],
"parallel_safe": false,
"subtasks": [
{
"id": "subtask-3-1",
"description": "Create tests/test_multi_repo_commands.py for CLI command handlers",
"service": "backend",
"files_to_create": [
"tests/test_multi_repo_commands.py"
],
"files_to_modify": [],
"patterns_from": [
"apps/backend/cli/workspace_commands.py"
],
"verification": {
"type": "command",
"command": "apps/backend/.venv/bin/pytest tests/test_multi_repo_commands.py -v 2>&1 | tail -5",
"expected": "passed"
},
"status": "completed"
},
{
"id": "subtask-3-2",
"description": "Create tests/test_dependency_graph.py for dependency graph analysis",
"service": "backend",
"files_to_create": [
"tests/test_dependency_graph.py"
],
"files_to_modify": [],
"patterns_from": [
"apps/backend/analysis/dependency_scanner.py"
],
"verification": {
"type": "command",
"command": "apps/backend/.venv/bin/pytest tests/test_dependency_graph.py -v 2>&1 | tail -5",
"expected": "passed"
},
"status": "completed"
}
]
}
],
"summary": {
"total_phases": 3,
"total_subtasks": 5,
"services_involved": [
"backend"
],
"parallelism": {
"max_parallel_phases": 1,
"parallel_groups": [],
"recommended_workers": 1
},
"startup_command": "source apps/backend/.venv/bin/activate && python apps/backend/run.py --help"
},
"verification_strategy": {
"risk_level": "medium",
"skip_validation": false,
"test_creation_phase": "phase-3-tests",
"test_types_required": [
"unit"
],
"security_scanning_required": false,
"staging_deployment_required": false,
"acceptance_criteria": [
"CLI exposes --workspace-create, --workspace-list, --workspace-add-project flags",
"Dependency graph analysis shows topological build order",
"All new tests pass"
],
"verification_steps": [
{
"name": "Unit Tests",
"command": "apps/backend/.venv/bin/pytest tests/test_multi_repo_commands.py tests/test_dependency_graph.py -v",
"expected_outcome": "All tests pass",
"type": "test",
"required": true,
"blocking": true
}
],
"reasoning": "Medium risk: new backend CLI module, no existing code modified except main.py imports"
},
"qa_acceptance": {
"unit_tests": {
"required": true,
"commands": [
"apps/backend/.venv/bin/pytest tests/test_multi_repo_commands.py tests/test_dependency_graph.py -v"
],
"minimum_coverage": null
},
"integration_tests": {
"required": false
},
"e2e_tests": {
"required": false
},
"browser_verification": {
"required": false
},
"database_verification": {
"required": false
}
},
"qa_signoff": null,
"status": "in_progress",
"planStatus": "in_progress",
"updated_at": "2026-03-20T12:37:19.724Z"
}
Loading
Loading