@opengsd/gsd-core 1.7.0 → 1.9.0

package/gsd-core/bin/lib/init.cjs

@@ -112,18 +112,6 @@ function listPhaseSummaryFiles(phaseDir) {
 function listPhasePlanFiles(phaseDir) {
     return scanPhasePlans(phaseDir)['planFiles'];
 }
-function verificationNextCommand(status, phaseNumber, slashRuntime) {
-    if (status === 'gaps_found') {
-        return `${(0, runtime_slash_cjs_1.formatGsdSlash)('plan-phase', slashRuntime)} ${phaseNumber} --gaps`;
-    }
-    if (status === 'human_needed' || status === 'stale') {
-        return `${(0, runtime_slash_cjs_1.formatGsdSlash)('verify-work', slashRuntime)} ${phaseNumber}`;
-    }
-    if (status === 'missing' || status === 'unknown') {
-        return `${(0, runtime_slash_cjs_1.formatGsdSlash)('execute-phase', slashRuntime)} ${phaseNumber}`;
-    }
-    return '';
-}
 function projectCompletionStatus(implementationComplete, verificationPassed) {
     if (implementationComplete && verificationPassed)
         return 'complete';
@@ -134,8 +122,14 @@ function projectCompletionStatus(implementationComplete, verificationPassed) {
 function buildPhaseCompletionProjection(cwd, phaseNumber, phaseDir, planCount, summaryCount, slashRuntime) {
     const implementationComplete = planCount > 0 && summaryCount >= planCount;
     const phaseFullDir = phaseDir ? node_path_1.default.join(cwd, phaseDir) : '';
+    // #2617: ONE verification-routing seam. init used to re-derive next_command
+    // from the status with its own projector, which had drifted from the router's
+    // table — it appended the phase number and answered `human_needed`; the table
+    // did neither. The router now owns both the content and the runtime
+    // projection, and init passes the phase number it already knows (its phaseDir
+    // is unresolved in some branches, where the router could not derive one).
     const verificationStatus = implementationComplete
-        ? readVerificationStatus(phaseFullDir)
+        ? readVerificationStatus(phaseFullDir, { runtime: slashRuntime, phaseNumber })
         : { status: 'not_required', next_action: '', next_command: '' };
     const projectedVerificationStatus = verificationStatus.status;
     const projectedVerificationAction = verificationStatus.next_action;
@@ -148,7 +142,7 @@ function buildPhaseCompletionProjection(cwd, phaseNumber, phaseDir, planCount, s
         phase_complete: phaseComplete,
         completion_status: projectCompletionStatus(implementationComplete, verificationPassed),
         verification_next_action: projectedVerificationAction,
-        verification_next_command: verificationNextCommand(projectedVerificationStatus, phaseNumber, slashRuntime),
+        verification_next_command: verificationStatus.next_command,
     };
 }
 function getLatestCompletedMilestone(cwd) {
@@ -305,7 +299,11 @@ function cmdInitExecutePhase(cwd, phase, raw, options = {}) {
         milestone_branch_template: config.milestone_branch_template,
         verifier_enabled: config.verifier,
         phase_found: !!phaseInfo,
-        phase_dir: phaseInfo?.['directory'] || null,
+        // #2376: absolute (anchored on cwd/project_root), not orchestrator-cwd-relative —
+        // a spawned subagent's own cwd may differ from the orchestrator's.
+        phase_dir: phaseInfo?.['directory']
+            ? toPosixPath(node_path_1.default.join(cwd, phaseInfo['directory']))
+            : null,
         phase_number: phaseInfo?.['phase_number'] || null,
         phase_name: phaseInfo?.['phase_name'] || null,
         phase_slug: phaseInfo?.['phase_slug'] || null,
@@ -331,9 +329,13 @@ function cmdInitExecutePhase(cwd, phase, raw, options = {}) {
         state_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         config_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'config.json')),
-        state_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'STATE.md'))),
-        roadmap_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'ROADMAP.md'))),
-        config_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'config.json'))),
+        // #2376: emit absolute paths — see comment above on phase_dir.
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        config_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'config.json')),
+        // #2376: execute-phase.md's verify_phase_goal step reads this instead of
+        // hardcoding '.planning/REQUIREMENTS.md' into the gsd-verifier spawn prompt.
+        requirements_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md')),
     };
     if (options['validate']) {
         try {
@@ -405,7 +407,8 @@ function cmdInitPlanPhase(cwd, phase, raw, options = {}) {
         if (slug) {
             const prefix = rawProjectCodePlan ? `${rawProjectCodePlan}-` : '';
             const dirName = `${prefix}${paddedNum}-${slug}`;
-            expectedPhaseDirPlan = toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningPaths(cwd).phases, dirName)));
+            // #2376: absolute — see comment on phase_dir below.
+            expectedPhaseDirPlan = toPosixPath(node_path_1.default.join(planningPaths(cwd).phases, dirName));
         }
     }
     const granularityOverride = options['granularity'];
@@ -427,7 +430,10 @@ function cmdInitPlanPhase(cwd, phase, raw, options = {}) {
         auto_chain_active: !!(config._auto_chain_active),
         mode: config.mode || 'interactive',
         phase_found: !!phaseInfo,
-        phase_dir: phaseDirPlan,
+        // #2376: absolute (anchored on cwd/project_root) — path.join(cwd, phaseDirPlan)
+        // handed to a spawned subagent must resolve regardless of that subagent's own cwd.
+        // phaseDirPlan itself stays relative — phase_status below still joins it against cwd.
+        phase_dir: phaseDirPlan ? toPosixPath(node_path_1.default.join(cwd, phaseDirPlan)) : null,
         expected_phase_dir: expectedPhaseDirPlan,
         phase_number: phaseNumberPlan,
         phase_name: phaseNamePlan,
@@ -444,9 +450,10 @@ function cmdInitPlanPhase(cwd, phase, raw, options = {}) {
         plan_count: phaseInfo?.['plans']?.length || 0,
         planning_exists: node_fs_1.default.existsSync(planningDir(cwd)),
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
-        state_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'STATE.md'))),
-        roadmap_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'ROADMAP.md'))),
-        requirements_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md'))),
+        // #2376: absolute — see comment on phase_dir above.
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        requirements_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md')),
         patterns_path: null,
     };
     if (phaseInfo?.['directory']) {
@@ -455,27 +462,27 @@ function cmdInitPlanPhase(cwd, phase, raw, options = {}) {
             const files = node_fs_1.default.readdirSync(phaseDirFull);
             const contextFile = findContextMdIn(phaseDirFull);
             if (contextFile) {
-                result['context_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], contextFile));
+                result['context_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, contextFile));
             }
             const researchFile = files.find((f) => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
             if (researchFile) {
-                result['research_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], researchFile));
+                result['research_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, researchFile));
             }
             const verificationFile = files.find((f) => f.endsWith('-VERIFICATION.md') || f === 'VERIFICATION.md');
             if (verificationFile) {
-                result['verification_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], verificationFile));
+                result['verification_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, verificationFile));
             }
             const uatFile = files.find((f) => f.endsWith('-UAT.md') || f === 'UAT.md');
             if (uatFile) {
-                result['uat_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], uatFile));
+                result['uat_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, uatFile));
             }
             const reviewsFile = files.find((f) => f.endsWith('-REVIEWS.md') || f === 'REVIEWS.md');
             if (reviewsFile) {
-                result['reviews_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], reviewsFile));
+                result['reviews_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, reviewsFile));
             }
             const patternsFile = files.find((f) => f.endsWith('-PATTERNS.md') || f === 'PATTERNS.md');
             if (patternsFile) {
-                result['patterns_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], patternsFile));
+                result['patterns_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, patternsFile));
             }
         }
         catch {
@@ -536,7 +543,14 @@ function cmdInitNewProject(cwd, raw) {
         brave_search_available: hasBraveSearch,
         firecrawl_available: hasFirecrawl,
         exa_search_available: hasExaSearch,
-        project_path: '.planning/PROJECT.md',
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        project_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'PROJECT.md')),
+        // #2376: new-project.md's research-synthesizer/roadmapper spawn prompts
+        // read these instead of hardcoding '.planning/...' literals.
+        requirements_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        config_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'config.json')),
+        research_dir: toPosixPath(node_path_1.default.join(planningRoot(cwd), 'research')),
     };
     output(withProjectRoot(cwd, result), raw);
 }
@@ -570,15 +584,22 @@ function cmdInitNewMilestone(cwd, raw) {
         latest_completed_milestone: latestCompleted?.version || null,
         latest_completed_milestone_name: latestCompleted?.name || null,
         phase_dir_count: phaseDirCount,
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
         phase_archive_path: latestCompleted
-            ? toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningRoot(cwd), 'milestones', `${latestCompleted.version}-phases`)))
+            ? toPosixPath(node_path_1.default.join(planningRoot(cwd), 'milestones', `${latestCompleted.version}-phases`))
             : null,
         project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         state_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
-        project_path: '.planning/PROJECT.md',
-        roadmap_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'ROADMAP.md'))),
-        state_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'STATE.md'))),
+        project_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'PROJECT.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        // #2376: new-milestone.md's research-synthesizer/roadmapper spawn prompts
+        // read these instead of hardcoding '.planning/...' literals.
+        requirements_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md')),
+        config_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'config.json')),
+        research_dir: toPosixPath(node_path_1.default.join(planningRoot(cwd), 'research')),
+        milestones_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'MILESTONES.md')),
     };
     output(withProjectRoot(cwd, result), raw);
 }
@@ -616,8 +637,11 @@ function cmdInitQuick(cwd, description, raw) {
         description: description || null,
         date: clock_cjs_1.realClock.localToday(),
         timestamp: clock_cjs_1.realClock.nowIso(),
-        quick_dir: '.planning/quick',
-        task_dir: slug ? `.planning/quick/${quickId}-${slug}` : null,
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        quick_dir: toPosixPath(node_path_1.default.join(planningDir(cwd), 'quick')),
+        task_dir: slug
+            ? toPosixPath(node_path_1.default.join(planningDir(cwd), 'quick', `${quickId}-${slug}`))
+            : null,
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         planning_exists: node_fs_1.default.existsSync(planningRoot(cwd)),
     };
@@ -629,7 +653,18 @@ function cmdInitIngestDocs(cwd, raw) {
         project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
         planning_exists: node_fs_1.default.existsSync(planningRoot(cwd)),
         ...getInitGitState(cwd),
-        project_path: '.planning/PROJECT.md',
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase. The
+        // classify_parallel/synthesize/route_new_mode spawns in ingest-docs.md
+        // (gsd-doc-classifier, gsd-doc-synthesizer, gsd-roadmapper) previously
+        // hardcoded bare '.planning/intel/...', '.planning/PROJECT.md', etc.
+        // literals into their Agent(prompt=...) blocks; those now interpolate
+        // these fields instead.
+        project_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'PROJECT.md')),
+        requirements_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        intel_dir: toPosixPath(node_path_1.default.join(planningDir(cwd), 'intel')),
+        conflicts_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'INGEST-CONFLICTS.md')),
         commit_docs: config.commit_docs,
     };
     output(withProjectRoot(cwd, result), raw);
@@ -658,9 +693,10 @@ function cmdInitResume(cwd, raw) {
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
         planning_exists: node_fs_1.default.existsSync(planningRoot(cwd)),
-        state_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'STATE.md'))),
-        roadmap_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'ROADMAP.md'))),
-        project_path: '.planning/PROJECT.md',
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        project_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'PROJECT.md')),
         has_interrupted_agent: !!interruptedAgentId,
         interrupted_agent_id: interruptedAgentId,
         commit_docs: config.commit_docs,
@@ -715,9 +751,15 @@ function cmdInitVerifyWork(cwd, phase, raw) {
         checker_model: resolveModelInternal(cwd, 'gsd-plan-checker'),
         commit_docs: config.commit_docs,
         phase_found: !!phaseInfo,
-        phase_dir: phaseDir,
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase. phaseDir
+        // itself stays relative — evaluateUatPassed above still joins it against cwd.
+        phase_dir: phaseDir ? toPosixPath(node_path_1.default.join(cwd, phaseDir)) : null,
         phase_number: phaseInfo?.['phase_number'] || null,
         phase_name: phaseInfo?.['phase_name'] || null,
+        // #2376: verify-work.md's plan_gap_closure step reads these instead of
+        // hardcoding '.planning/STATE.md' / '.planning/ROADMAP.md' literals.
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         has_verification: phaseInfo?.['has_verification'] || false,
         phase_completion: {
             ...completion,
@@ -799,7 +841,8 @@ function cmdInitPhaseOp(cwd, phase, raw) {
         if (slug) {
             const prefix = rawProjectCode ? `${rawProjectCode}-` : '';
             const dirName = `${prefix}${paddedNum}-${slug}`;
-            expectedPhaseDir = toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningPaths(cwd).phases, dirName)));
+            // #2376: absolute — see comment on phase_dir below.
+            expectedPhaseDir = toPosixPath(node_path_1.default.join(planningPaths(cwd).phases, dirName));
         }
     }
     const result = {
@@ -814,7 +857,8 @@ function cmdInitPhaseOp(cwd, phase, raw) {
             ? (0, secrets_cjs_1.maskIfSecret)('exa_search', config.exa_search)
             : config.exa_search,
         phase_found: !!phaseInfo,
-        phase_dir: phaseDir,
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        phase_dir: phaseDir ? toPosixPath(node_path_1.default.join(cwd, phaseDir)) : null,
         expected_phase_dir: expectedPhaseDir,
         phase_number: phaseNumber,
         phase_name: phaseName,
@@ -828,9 +872,10 @@ function cmdInitPhaseOp(cwd, phase, raw) {
         plan_count: phaseInfo?.['plans']?.length || 0,
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         planning_exists: node_fs_1.default.existsSync(planningDir(cwd)),
-        state_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'STATE.md'))),
-        roadmap_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'ROADMAP.md'))),
-        requirements_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md'))),
+        // #2376: absolute — see comment on phase_dir above.
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        requirements_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'REQUIREMENTS.md')),
     };
     if (phaseInfo?.['directory']) {
         const phaseDirFull = node_path_1.default.join(cwd, phaseInfo['directory']);
@@ -838,23 +883,23 @@ function cmdInitPhaseOp(cwd, phase, raw) {
             const files = node_fs_1.default.readdirSync(phaseDirFull);
             const contextFile = findContextMdIn(phaseDirFull);
             if (contextFile) {
-                result['context_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], contextFile));
+                result['context_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, contextFile));
             }
             const researchFile = files.find((f) => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md');
             if (researchFile) {
-                result['research_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], researchFile));
+                result['research_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, researchFile));
             }
             const verificationFile = files.find((f) => f.endsWith('-VERIFICATION.md') || f === 'VERIFICATION.md');
             if (verificationFile) {
-                result['verification_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], verificationFile));
+                result['verification_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, verificationFile));
             }
             const uatFile = files.find((f) => f.endsWith('-UAT.md') || f === 'UAT.md');
             if (uatFile) {
-                result['uat_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], uatFile));
+                result['uat_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, uatFile));
             }
             const reviewsFile = files.find((f) => f.endsWith('-REVIEWS.md') || f === 'REVIEWS.md');
             if (reviewsFile) {
-                result['reviews_path'] = toPosixPath(node_path_1.default.join(phaseInfo['directory'], reviewsFile));
+                result['reviews_path'] = toPosixPath(node_path_1.default.join(phaseDirFull, reviewsFile));
             }
         }
         catch {
@@ -878,6 +923,9 @@ function cmdInitTodos(cwd, area, raw) {
                 const createdMatch = content.match(/^created:\s*(.+)$/m);
                 const titleMatch = content.match(/^title:\s*(.+)$/m);
                 const areaMatch = content.match(/^area:\s*(.+)$/m);
+                // #2337: kept in parity with cmdListTodos — surface severity when
+                // present, omit the key entirely for todos with no severity line.
+                const severityMatch = content.match(/^severity:\s*(.+)$/m);
                 const todoArea = areaMatch ? areaMatch[1].trim() : 'general';
                 if (area && todoArea !== area)
                     continue;
@@ -887,7 +935,9 @@ function cmdInitTodos(cwd, area, raw) {
                     created: createdMatch ? createdMatch[1].trim() : 'unknown',
                     title: titleMatch ? titleMatch[1].trim() : 'Untitled',
                     area: todoArea,
-                    path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'todos', 'pending', file))),
+                    // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+                    path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'todos', 'pending', file)),
+                    ...(severityMatch ? { severity: severityMatch[1].trim() } : {}),
                 });
             }
             catch {
@@ -905,8 +955,9 @@ function cmdInitTodos(cwd, area, raw) {
         todo_count: count,
         todos,
         area_filter: area || null,
-        pending_dir: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'todos', 'pending'))),
-        completed_dir: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'todos', 'completed'))),
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        pending_dir: toPosixPath(node_path_1.default.join(planningDir(cwd), 'todos', 'pending')),
+        completed_dir: toPosixPath(node_path_1.default.join(planningDir(cwd), 'todos', 'completed')),
         planning_exists: node_fs_1.default.existsSync(planningDir(cwd)),
         todos_dir_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'todos')),
         pending_dir_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'todos', 'pending')),
@@ -1038,7 +1089,8 @@ function cmdInitMapCodebase(cwd, raw) {
         subagent_timeout: config.subagent_timeout,
         date: clock_cjs_1.realClock.localToday(),
         timestamp: clock_cjs_1.realClock.nowIso(),
-        codebase_dir: '.planning/codebase',
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        codebase_dir: toPosixPath(node_path_1.default.join(planningRoot(cwd), 'codebase')),
         existing_maps: existingMaps,
         has_maps: existingMaps.length > 0,
         planning_exists: pathExistsInternal(cwd, '.planning'),
@@ -1439,7 +1491,10 @@ function cmdInitProgress(cwd, raw) {
             const phaseInfo = {
                 number: phaseNumber,
                 name: phaseName,
-                directory: phaseDirRel,
+                // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+                // phaseDirRel itself stays relative — buildPhaseCompletionProjection
+                // above still joins it against cwd.
+                directory: toPosixPath(node_path_1.default.join(cwd, phaseDirRel)),
                 status,
                 plan_count: plans.length,
                 summary_count: summaries.length,
@@ -1507,10 +1562,11 @@ function cmdInitProgress(cwd, raw) {
         project_exists: pathExistsInternal(cwd, '.planning/PROJECT.md'),
         roadmap_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
         state_exists: node_fs_1.default.existsSync(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
-        state_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'STATE.md'))),
-        roadmap_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'ROADMAP.md'))),
-        project_path: '.planning/PROJECT.md',
-        config_path: toPosixPath(node_path_1.default.relative(cwd, node_path_1.default.join(planningDir(cwd), 'config.json'))),
+        // #2376: absolute — see comment on phase_dir in cmdInitExecutePhase.
+        state_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'STATE.md')),
+        roadmap_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'ROADMAP.md')),
+        project_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'PROJECT.md')),
+        config_path: toPosixPath(node_path_1.default.join(planningDir(cwd), 'config.json')),
     };
     output(withProjectRoot(cwd, result), raw);
 }
@@ -1668,7 +1724,9 @@ function cmdInitRemoveWorkspace(cwd, name, raw) {
         dirty_repos: dirtyRepos,
         has_dirty_repos: dirtyRepos.length > 0,
     };
-    output(result, raw);
+    // #2402: sibling init commands route through withProjectRoot so response_language
+    // (and project_root/agents_installed) reach the workflow; this one didn't.
+    output(withProjectRoot(cwd, result), raw);
 }
 function buildAgentSkillsBlock(config, agentType, projectRoot, diagnostics) {
     const warn = (message) => {
@@ -1790,7 +1848,38 @@ function cmdAgentSkills(cwd, agentType, raw, jsonMode) {
     const projectRoot = (0, project_root_cjs_1.findProjectRoot)(cwd);
     const { config, source, degraded } = loadConfigResolved(projectRoot);
     const diagnostics = { warnings: [] };
-    const block = buildAgentSkillsBlock(config, agentType, projectRoot, diagnostics);
+    let block = buildAgentSkillsBlock(config, agentType, projectRoot, diagnostics);
+    // #2454: Agent prompt fallback for AGENTS-native runtimes where named
+    // subagents are NOT dispatchable (kimi-code, kimi, opencode, kilo, etc.).
+    // On these runtimes, workflows inject ${AGENT_SKILLS_*} into the dispatch
+    // prompt of a built-in subagent (coder/explore/plan). If no
+    // model_profile_overrides or agent_skills config entry exists, the block
+    // is empty — but the agent's prompt CONTENT is installed on disk at the
+    // runtime's agents directory. Read it as a fallback so the persona survives
+    // the dispatch even without explicit config opt-in.
+    //
+    // GATED to non-claude runtimes: Claude Code supports named subagent dispatch
+    // and its ${AGENT_SKILLS_*} contract is a skills-injection path, not a
+    // persona fallback. Triggering the fallback for claude would change the
+    // documented "unconfigured → empty block" contract that agent-skills tests
+    // pin.
+    if (!block) {
+        const runtime = (config && config['runtime']) || process.env['GSD_RUNTIME'] || 'claude';
+        if (runtime !== 'claude') {
+            const agentCheck = checkAgentsInstalled(runtime);
+            const agentsDir = agentCheck?.agents_dir;
+            if (typeof agentsDir === 'string' && agentsDir.length > 0) {
+                const agentFile = node_path_1.default.join(agentsDir, `${agentType}.md`);
+                try {
+                    const content = (0, shell_command_projection_cjs_1.platformReadSync)(agentFile);
+                    if (content && content.length > 0) {
+                        block = content;
+                    }
+                }
+                catch { /* agent file not found — fall through to empty block */ }
+            }
+        }
+    }
     // Compute configured + reason for diagnostic output.
     const agentSkillsMap = (config && config['agent_skills'] && typeof config['agent_skills'] === 'object')
         ? config['agent_skills']
@@ -1989,8 +2078,8 @@ function buildSkillManifest(cwd, skillsDir = null) {
         // posix-style for cross-platform stability; flat entries use template
         // literals that always produce '/'; nested entries are joined below
         // with explicit '/' separators rather than path.join).
-        relPath, content) {
-            const frontmatter = extractFrontmatter(content);
+        relPath, content, sourcePath) {
+            const frontmatter = extractFrontmatter(content, sourcePath);
             const dirPart = relPath.replace(/\/SKILL\.md$/, '');
             const stem = dirPart.includes('/') ? dirPart.split('/').pop() : dirPart;
             const name = frontmatter['name'] || stem;
@@ -2031,7 +2120,7 @@ function buildSkillManifest(cwd, skillsDir = null) {
             const skillMdPath = node_path_1.default.join(rootPath, entry.name, 'SKILL.md');
             const content = (0, shell_command_projection_cjs_1.platformReadSync)(skillMdPath);
             if (content !== null) {
-                if (pushSkillEntry(`${entry.name}/SKILL.md`, content))
+                if (pushSkillEntry(`${entry.name}/SKILL.md`, content, skillMdPath))
                     skillCount++;
             }
             // Nested layout: <entry>/skills/<stem>/SKILL.md
@@ -2060,7 +2149,7 @@ function buildSkillManifest(cwd, skillsDir = null) {
                 // Use forward-slash separator explicitly so manifest paths are posix-style
                 // on all platforms, matching the flat-layout behaviour above.
                 const relPath = `${entry.name}/skills/${nested.name}/SKILL.md`;
-                if (pushSkillEntry(relPath, nestedContent))
+                if (pushSkillEntry(relPath, nestedContent, nestedSkillMd))
                     skillCount++;
             }
         }