fix(#2376): emit absolute subagent-facing paths from init/state, convert workflow literals (#2428)

* fix(#2376): emit absolute subagent-facing init/state paths

Make init.* and state.* path fields absolute rather than cwd-relative
so subagent prompts resolve correctly regardless of working directory.
Adds intel_dir/conflicts_path/requirements_path/roadmap_path/state_path
to cmdInitIngestDocs, an absolute debug_dir to cmdStateLoad, and
replaces bare .planning/... literals in 12 workflow Agent() prompt
blocks with the absolute init-JSON path fields. Includes decoy-cwd
regression tests and realpath'd tmpdir fixtures for macOS.

Squashed rebase of the #2376 commit series onto a fresh origin/next
(previous merge ee25543a1 was against a now-stale next).

* chore(#2376): add changeset

* chore(#2376): regenerate golden fixtures + workflow size baseline

Regenerated after rebasing the absolute-path fix onto current next
(picks up #2351's run-with-timeout content in execute-phase.md too).

* fix(#2376): trim execute-phase.md redundancy to stay under the size margin

* chore(#2376): regenerate golden/size baseline after rebase onto next
This commit is contained in:
Tom Boucher
2026-07-19 15:43:48 -04:00
committed by GitHub
parent d04e287fa9
commit 1a46bc068a
42 changed files with 905 additions and 510 deletions

View File

@@ -388,7 +388,9 @@ function buildOnboardProjection(cwd: string, options: BuildOnboardProjectionOpti
projectExists,
mapReadiness: mapReadinessValue,
onboardingSummaryExists,
onboardingSummaryPath: toPosixPath(path.relative(cwd, onboardingSummaryPath)),
// #2376: absolute (anchored on cwd/project_root), not orchestrator-cwd-relative —
// a spawned subagent's own cwd may differ from the orchestrator's.
onboardingSummaryPath: toPosixPath(onboardingSummaryPath),
hasPlanningArtifacts,
missingPlanningFiles,
handoffCommands,
@@ -410,19 +412,15 @@ function buildOnboardProjection(cwd: string, options: BuildOnboardProjectionOpti
doc_candidates: docCandidates,
onboarding_summary_exists: onboardingSummaryExists,
onboarding_summary_path: toPosixPath(path.relative(cwd, onboardingSummaryPath)),
// #2376: absolute — see comment on onboardingSummaryPath above.
onboarding_summary_path: toPosixPath(onboardingSummaryPath),
project_path: toPosixPath(path.relative(
cwd,
fs.existsSync(projectRootPath) ? projectRootPath : projectScopedPath,
)),
requirements_path: toPosixPath(
path.relative(cwd, path.join(planningDir(cwd), 'REQUIREMENTS.md')),
),
roadmap_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'ROADMAP.md'))),
state_path: toPosixPath(path.relative(cwd, path.join(planningDir(cwd), 'STATE.md'))),
codebase_dir: toPosixPath(path.relative(cwd, path.join(planningRoot(cwd), 'codebase'))),
onboarding_dir: toPosixPath(path.relative(cwd, path.join(planningRoot(cwd), 'onboarding'))),
project_path: toPosixPath(fs.existsSync(projectRootPath) ? projectRootPath : projectScopedPath),
requirements_path: toPosixPath(path.join(planningDir(cwd), 'REQUIREMENTS.md')),
roadmap_path: toPosixPath(path.join(planningDir(cwd), 'ROADMAP.md')),
state_path: toPosixPath(path.join(planningDir(cwd), 'STATE.md')),
codebase_dir: toPosixPath(path.join(planningRoot(cwd), 'codebase')),
onboarding_dir: toPosixPath(path.join(planningRoot(cwd), 'onboarding')),
};
}