kandev/docs/plans/submodule-review/task-02-aggregate-submodule-git-data.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
02-aggregate-submodule-git-data	Aggregate root and submodule Git data	done	1	01-discover-nested-repository-scopes	plan.md	../../specs/ui/requirements/submodule-review.md

Task 02: Aggregate root and submodule Git data

Acceptance

• Unpinned status, log, and cumulative-diff requests include a real workspace root plus all initialized submodule scopes in stable order, while bare multi-repository task roots remain excluded.
• Cumulative files carry nested repository_name, repository-relative path, and the parent-derived base_ref; one scope's failure preserves successful results according to the existing endpoint contract.
• Root file/ref access, LSP/search consumers, cancellation, deterministic merges, and class-aware Git admission retain their existing behavior when named submodule scopes exist.

Verification

cd apps/backend && go test ./internal/agentctl/server/api -run 'Test.*SubmoduleReview|TestMultiRepoReview|TestGitStatusMulti'
cd apps/backend && go test ./internal/agentctl/server/process -run 'TestManager_.*RepoScopes|TestManager_RepoSubpaths'

Files likely touched

• apps/backend/internal/agentctl/server/process/manager.go
• apps/backend/internal/agentctl/server/api/git.go
• apps/backend/internal/agentctl/server/api/workspace.go
• apps/backend/internal/agentctl/server/api/git_multi_repo_review_test.go
• apps/backend/internal/agentctl/server/api/git_status_fresh_concurrency_test.go
• apps/backend/internal/agentctl/server/process/manager_multi_repo_stream_test.go
• Runtime client or gateway status tests only if the unchanged JSON shape exposes a compatibility gap

Dependencies

Task 01.

Parallelism

sequential — it consumes and finalizes the manager contract introduced by Task 01.

Inputs

• Spec API surface and partial-failure scenarios.
• Existing multi-repository fan-out in api/git.go and root-content guard in api/workspace.go.
• ADR 2026-08-02-class-aware-git-subprocess-admission.md.

Output contract

Report endpoint shapes, ordering, partial failures, root-access audit, files changed, exact tests and counts, blockers/risks, and synchronized task/plan status.

Results

Implemented ordered root/direct/nested repository-scope fan-out for status, log, and cumulative diff, preserving repository-relative paths, nested names, stable parent-derived base refs, partial failures, and root file access. Bare task roots retain their existing named-only behavior.

Verification:

• go test ./internal/agentctl/server/api -run 'Test(NestedSubmoduleReviewEndpointsIncludeRootAndStableChildBase|MultiRepoReviewEndpoints)' -count=1 — 3 passed.
• make -C apps/backend test — passed; make -C apps/backend build — completed.