@opengsd/gsd-core 1.5.0-rc.4 → 1.5.0

package/gsd-core/bin/lib/roadmap-command-router.cjs

@@ -22,8 +22,8 @@ const roadmapUpgrade = require("./roadmap-upgrade.cjs");
 const planningWorkspace = require("./planning-workspace.cjs");
 const { planningDir } = planningWorkspace;
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const core = require("./core.cjs");
-const { loadConfig } = core;
+const configLoaderMod = require("./config-loader.cjs");
+const { loadConfig } = configLoaderMod;
 // ─── W021 Implementation ──────────────────────────────────────────────────────
 /**
  * Check each phase entry in a milestone-prefixed ROADMAP.md for W021 violations.

package/gsd-core/bin/lib/roadmap-parser.cjs

@@ -6,12 +6,10 @@
  * Owns shipped-milestone slicing, current-milestone extraction,
  * milestone/phase lookups, and milestone-phase filtering.
  * Behaviour is preserved byte-for-behaviour from the prior location;
- * only the module boundary moved. core.cjs re-exports every symbol here
- * under its own `export =` object so existing consumers are unaffected.
+ * only the module boundary moved. The core.cjs re-export spine was retired
+ * in epic #1267; callers import roadmap-parser helpers directly.
  *
- * New imports should pull roadmap-parser helpers from roadmap-parser.cjs directly.
- *
- * Dependencies (leaf modules only — no core.cjs, no loadConfig):
+ * Dependencies (leaf modules only — no loadConfig):
  *   - node:fs / node:path (stdlib)
  *   - ./phase-id.cjs        (escapeRegex, phaseMarkdownRegexSource)
  *   - ./planning-workspace.cjs (planningDir)
@@ -180,6 +178,27 @@ function replaceInCurrentMilestone(content, pattern, replacement) {
     const after = content.slice(offset);
     return before + after.replace(pattern, replacement);
 }
+function findRoadmapPhaseInContent(content, phaseNum) {
+    const phasePattern = new RegExp(`#{2,4}\\s*(?:\\[[^\\]]+\\]\\s*)?Phase\\s+${phaseMarkdownRegexSource(phaseNum)}:\\s*([^\\n]+)`, 'i');
+    const headerMatch = content.match(phasePattern);
+    if (!headerMatch)
+        return null;
+    const phaseName = headerMatch[1].trim();
+    const headerIndex = headerMatch.index;
+    const restOfContent = content.slice(headerIndex);
+    const nextHeaderMatch = restOfContent.match(/\n#{2,4}\s+(?:\[[^\]]+\]\s*)?Phase\s+[\w]/i);
+    const sectionEnd = nextHeaderMatch ? headerIndex + nextHeaderMatch.index : content.length;
+    const section = content.slice(headerIndex, sectionEnd).trim();
+    const goalMatch = section.match(/\*\*Goal(?:\*\*:|\*?\*?:\*\*)\s*([^\n]+)/i);
+    const goal = goalMatch ? goalMatch[1].trim() : null;
+    return {
+        found: true,
+        phase_number: String(phaseNum),
+        phase_name: phaseName,
+        goal,
+        section,
+    };
+}
 function getRoadmapPhaseInternal(cwd, phaseNum) {
     if (!phaseNum)
         return null;
@@ -191,26 +210,10 @@ function getRoadmapPhaseInternal(cwd, phaseNum) {
         if (roadmapRaw === null)
             throw new Error('missing');
         const content = extractCurrentMilestone(roadmapRaw, cwd);
-        const phasePattern = new RegExp(`#{2,4}\\s*(?:\\[[^\\]]+\\]\\s*)?Phase\\s+${phaseMarkdownRegexSource(phaseNum)}:\\s*([^\\n]+)`, 'i');
-        const headerMatch = content.match(phasePattern);
-        if (!headerMatch)
-            return null;
-        const phaseName = headerMatch[1].trim();
-        const headerIndex = headerMatch.index;
-        const restOfContent = content.slice(headerIndex);
-        const nextHeaderMatch = restOfContent.match(/\n#{2,4}\s+(?:\[[^\]]+\]\s*)?Phase\s+[\w]/i);
-        const sectionEnd = nextHeaderMatch ? headerIndex + nextHeaderMatch.index : content.length;
-        const section = content.slice(headerIndex, sectionEnd).trim();
-        const goalMatch = section.match(/\*\*Goal(?:\*\*:|\*?\*?:\*\*)\s*([^\n]+)/i);
-        const goal = goalMatch ? goalMatch[1].trim() : null;
-        return {
-            found: true,
-            // eslint-disable-next-line @typescript-eslint/no-base-to-string
-            phase_number: String(phaseNum),
-            phase_name: phaseName,
-            goal,
-            section,
-        };
+        const scopedResult = findRoadmapPhaseInContent(content, phaseNum);
+        if (scopedResult)
+            return scopedResult;
+        return findRoadmapPhaseInContent(stripShippedMilestones(roadmapRaw), phaseNum);
     }
     catch {
         return null;

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

@@ -13,8 +13,14 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const clock_cjs_1 = require("./clock.cjs");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const core = require("./core.cjs");
-const { escapeRegex, normalizePhaseName, phaseMarkdownRegexSource, phaseMarkdownRegexSourceExact, output, error, findPhaseInternal, phaseTokenMatches } = core;
+const ioMod = require("./io.cjs");
+const { output, error } = ioMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const phaseIdMod = require("./phase-id.cjs");
+const { escapeRegex, normalizePhaseName, phaseMarkdownRegexSource, phaseMarkdownRegexSourceExact, phaseTokenMatches } = phaseIdMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const phaseLocatorMod = require("./phase-locator.cjs");
+const { findPhaseInternal } = phaseLocatorMod;
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const roadmapParserModule = require("./roadmap-parser.cjs");
 const { stripShippedMilestones, extractCurrentMilestone, replaceInCurrentMilestone } = roadmapParserModule;
@@ -77,8 +83,7 @@ function countPhasePlansAndSummaries(phaseDir) {
         hasResearch: phaseFiles.some(f => f.endsWith('-RESEARCH.md') || f === 'RESEARCH.md'),
     };
 }
-// `phaseMarkdownRegexSource` moved to core.cjs (#3537) so phase.cjs and
-// core.cjs itself can consume it without circular deps. Imported above.
+// `phaseMarkdownRegexSource` lives in phase-id.cjs (#3537) and is imported above.
 // ─── searchPhaseInContent ─────────────────────────────────────────────────────
 /**
  * Search for a phase header (and its section) within the given content string.

package/gsd-core/bin/lib/runtime-artifact-conversion.cjs

@@ -287,6 +287,9 @@ function skillFrontmatterName(skillDirName) {
     // Return the hyphen form as-is (gsd-<cmd>) — canonical since #2808.
     return skillDirName;
 }
+function normalizeClaudeSkillEffort(effort) {
+    return effort === 'xhigh' ? 'max' : effort;
+}
 /**
  * Qwen Code skills accept an optional numeric `priority` frontmatter field.
  * Per the Qwen skills spec (qwen-code/docs/users/features/skills.md, verified
@@ -386,7 +389,7 @@ function convertClaudeCommandToClaudeSkill(content, skillName, runtime = null, c
     if (context)
         fm += `context: ${context}\n`;
     if (effort)
-        fm += `effort: ${effort}\n`;
+        fm += `effort: ${normalizeClaudeSkillEffort(effort)}\n`;
     if (toolsBlock)
         fm += toolsBlock;
     fm += '---';

package/gsd-core/bin/lib/runtime-hooks-surface.cjs

@@ -406,7 +406,25 @@ function reconcileCodexHooksJsonEvent(targetDir, eventName, opts = {}) {
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
         parsed = {};
     const usesNestedHooksObject = parsed['hooks'] && typeof parsed['hooks'] === 'object' && !Array.isArray(parsed['hooks']);
-    const hookTable = usesNestedHooksObject ? parsed['hooks'] : parsed;
+    // #1348: canonicalize every write to the nested { hooks: { <Event>: [...] } }
+    // shape. Lift ANY top-level event array (legacy, empty, OR mixed nested+top-level)
+    // into the nested table — merging when the same event exists in both — so
+    // user/legacy entries are preserved under `hooks` and no stray top-level event
+    // key survives (Codex deny_unknown_fields rejects them). Mirrors reconcileCursorHooksJson.
+    const hookTable = usesNestedHooksObject
+        ? parsed['hooks']
+        : {};
+    for (const key of Object.keys(parsed)) {
+        if (key === 'hooks')
+            continue;
+        if (Array.isArray(parsed[key])) {
+            const lifted = parsed[key];
+            const existing = Array.isArray(hookTable[key]) ? hookTable[key] : [];
+            hookTable[key] = [...lifted, ...existing];
+            delete parsed[key];
+        }
+    }
+    parsed['hooks'] = hookTable;
     const eventEntries = Array.isArray(hookTable[eventName]) ? hookTable[eventName] : [];
     let removedLegacy = false;
     const sanitizedEntries = [];
@@ -452,8 +470,11 @@ function reconcileCodexHooksJsonEvent(targetDir, eventName, opts = {}) {
     else {
         delete hookTable[eventName];
     }
-    if (usesNestedHooksObject)
-        parsed['hooks'] = hookTable;
+    // Avoid writing an empty `{ "hooks": {} }` artifact (e.g. removal on an absent
+    // file): collapse an empty hook table back to `{}` so the existing
+    // shouldWrite/no-write-on-empty behavior is preserved.
+    if (Object.keys(hookTable).length === 0)
+        delete parsed['hooks'];
     const nextContent = `${JSON.stringify(parsed, null, 2)}\n`;
     const changed = currentContent !== nextContent;
     const shouldWrite = changed && (currentContent !== null || Object.keys(parsed).length > 0);

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

@@ -12,8 +12,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const core = require("./core.cjs");
-const { escapeRegex, loadConfig, getMilestoneInfo, getMilestonePhaseFilter, extractCurrentMilestone, output, error } = core;
+const ioMod = require("./io.cjs");
+const { output, error } = ioMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const configLoaderMod = require("./config-loader.cjs");
+const { loadConfig } = configLoaderMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const phaseIdMod = require("./phase-id.cjs");
+const { escapeRegex } = phaseIdMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const roadmapParserMod = require("./roadmap-parser.cjs");
+const { getMilestoneInfo, getMilestonePhaseFilter, extractCurrentMilestone } = roadmapParserMod;
 const shell_command_projection_cjs_1 = require("./shell-command-projection.cjs");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const planningWorkspace = require("./planning-workspace.cjs");
@@ -25,6 +34,19 @@ const { extractFrontmatter, reconstructFrontmatter } = frontmatter;
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const scanPhasePlans = require("./plan-scan.cjs");
 const state_document_cjs_1 = require("./state-document.cjs");
+const STATE_PROGRESS_RESYNC_FIELDS = new Set([
+    'Progress',
+    'Total Plans in Phase',
+    'Total Phases',
+]);
+function shouldResyncStateProgress(fields) {
+    for (const field of fields) {
+        if (STATE_PROGRESS_RESYNC_FIELDS.has(field)) {
+            return true;
+        }
+    }
+    return false;
+}
 // ─── Cache ────────────────────────────────────────────────────────────────────
 // Cache disk scan results from buildStateFrontmatter per cwd per process (#1967).
 // Avoids re-reading N+1 directories on every state write when the phase structure
@@ -148,6 +170,7 @@ function cmdStatePatch(cwd, patches, raw) {
     const statePath = planningPaths(cwd).state;
     try {
         const results = { updated: [], failed: [] };
+        const shouldResync = shouldResyncStateProgress(Object.keys(patches));
         // Use atomic read-modify-write to prevent lost updates from concurrent agents
         readModifyWriteStateMd(statePath, (content) => {
             for (const [field, value] of Object.entries(patches)) {
@@ -161,7 +184,7 @@ function cmdStatePatch(cwd, patches, raw) {
                 }
             }
             return content;
-        }, cwd);
+        }, cwd, { resync: shouldResync });
         output(results, raw, results.updated.length > 0 ? 'true' : 'false');
     }
     catch {
@@ -182,7 +205,7 @@ function cmdStateUpdate(cwd, field, value) {
     const statePath = planningPaths(cwd).state;
     try {
         let updated = false;
-        const shouldResync = ['Progress', 'Total Plans in Phase', 'Total Phases'].includes(field);
+        const shouldResync = shouldResyncStateProgress([field]);
         // Preserve curated progress for body-only updates, but allow fields that
         // directly project into progress.* frontmatter to rebuild after mutation.
         readModifyWriteStateMd(statePath, (content) => {
@@ -922,6 +945,32 @@ function matchSessionSection(body) {
     return body.match(/(?:^|\n)##[ \t]*Session[ \t]*\n([\s\S]*?)(?=\n##|$)/i)
         || body.match(/(?:^|\n)##[ \t]*Session Continuity[ \t]*\n([\s\S]*?)(?=\n##|$)/i);
 }
+function parseProsePhaseField(value) {
+    if (!value)
+        return { phase: null, name: null };
+    const phaseMatch = value.match(/\b(\d+[A-Z]?(?:\.\d+)*)\b/i);
+    const parenName = value.match(/\(([^)]+)\)/);
+    const dashName = value.match(/—\s*([^(\n]+?)(?:\s*\(|$)/);
+    const rawName = parenName?.[1] ?? dashName?.[1] ?? null;
+    const name = rawName && !/^(?:complete|executing|not started)$/i.test(rawName.trim())
+        ? rawName.trim()
+        : null;
+    return {
+        phase: phaseMatch ? phaseMatch[1] : null,
+        name,
+    };
+}
+function parseProseLastActivityField(value) {
+    if (!value)
+        return { date: null, description: null };
+    const match = value.match(/^(\d{4}-\d{2}-\d{2})(?:\s+[—-]{1,2}\s+(.+))?$/);
+    if (!match)
+        return { date: value, description: null };
+    return {
+        date: match[1],
+        description: match[2]?.trim() || null,
+    };
+}
 function cmdStateSnapshot(cwd, raw) {
     const statePath = planningPaths(cwd).state;
     if (!node_fs_1.default.existsSync(statePath)) {
@@ -950,15 +999,18 @@ function cmdStateSnapshot(cwd, raw) {
         return null;
     };
     // Extract basic fields — frontmatter keys take precedence over body
-    const currentPhase = fmScalar('current_phase') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Current Phase');
-    const currentPhaseName = fmScalar('current_phase_name') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Current Phase Name');
+    const prosePhase = parseProsePhaseField((0, state_document_cjs_1.stateExtractField)(body, 'Phase'));
+    const currentPhase = fmScalar('current_phase') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Current Phase') ?? prosePhase.phase;
+    const currentPhaseName = fmScalar('current_phase_name') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Current Phase Name') ?? prosePhase.name;
     const totalPhasesRaw = fmScalar('total_phases') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Total Phases');
     const currentPlan = fmScalar('current_plan') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Current Plan');
     const totalPlansRaw = fmScalar('total_plans_in_phase') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Total Plans in Phase');
     const status = fmScalar('status') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Status');
     const progressRaw = fmScalar('progress') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Progress');
-    const lastActivity = fmScalar('last_activity') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Last Activity');
-    const lastActivityDesc = fmScalar('last_activity_desc') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Last Activity Description');
+    const rawLastActivity = (0, state_document_cjs_1.stateExtractField)(body, 'Last Activity') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Last activity');
+    const proseLastActivity = parseProseLastActivityField(rawLastActivity);
+    const lastActivity = fmScalar('last_activity') ?? proseLastActivity.date ?? rawLastActivity;
+    const lastActivityDesc = fmScalar('last_activity_desc') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Last Activity Description') ?? proseLastActivity.description;
     const pausedAt = fmScalar('paused_at') ?? (0, state_document_cjs_1.stateExtractField)(body, 'Paused At');
     // Parse numeric fields
     const totalPhases = totalPhasesRaw ? parseInt(totalPhasesRaw, 10) : null;
@@ -1043,14 +1095,18 @@ function cmdStateSnapshot(cwd, raw) {
  * reliably via `state json` instead of fragile regex parsing.
  */
 function buildStateFrontmatter(bodyContent, cwd) {
-    const currentPhase = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Current Phase');
-    const currentPhaseName = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Current Phase Name');
+    const prosePhase = parseProsePhaseField((0, state_document_cjs_1.stateExtractField)(bodyContent, 'Phase'));
+    const currentPhase = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Current Phase') ?? prosePhase.phase;
+    const currentPhaseName = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Current Phase Name') ?? prosePhase.name;
     const currentPlan = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Current Plan');
     const totalPhasesRaw = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Total Phases');
     const totalPlansRaw = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Total Plans in Phase');
     const status = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Status');
     const progressRaw = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Progress');
-    const lastActivity = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Last Activity');
+    const rawLastActivity = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Last Activity') ?? (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Last activity');
+    const proseLastActivity = parseProseLastActivityField(rawLastActivity);
+    const lastActivity = proseLastActivity.date ?? rawLastActivity;
+    const lastActivityDesc = (0, state_document_cjs_1.stateExtractField)(bodyContent, 'Last Activity Description') ?? proseLastActivity.description;
     // Bug #2444: scope Stopped At extraction to the ## Session section so that
     // historical "Stopped at:" prose elsewhere in the body (e.g. in a
     // Session Continuity Archive section) never overwrites the current value.
@@ -1194,6 +1250,8 @@ function buildStateFrontmatter(bodyContent, cwd) {
     fm['last_updated'] = clock_cjs_1.realClock.nowIso();
     if (lastActivity)
         fm['last_activity'] = lastActivity;
+    if (lastActivityDesc)
+        fm['last_activity_desc'] = lastActivityDesc;
     const progress = {};
     if (totalPhases !== null)
         progress['total_phases'] = totalPhases;
@@ -1745,14 +1803,14 @@ function cmdStateBeginPhase(cwd, phaseNumber, phaseName, planCount, raw) {
                         posBody = replaced;
                 }
                 // Update Last activity line if present
-                const newActivity = `Last activity: ${today} -- Phase ${phaseNumber} execution started`;
+                const newActivity = `Last activity: ${today} — Phase ${phaseNumber} execution started`;
                 if (/^Last activity:/im.test(posBody)) {
                     posBody = posBody.replace(/^Last activity:.*$/im, newActivity);
                 }
                 else {
                     // Pipe-table format in Current Position (#1255)
                     // Value must match the inline branch (date + narrative), not bare date.
-                    const activityValue = `${today} -- Phase ${phaseNumber} execution started`;
+                    const activityValue = `${today} — Phase ${phaseNumber} execution started`;
                     const replaced = (0, state_document_cjs_1.stateReplaceField)(posBody, 'Last Activity', activityValue)
                         ?? (0, state_document_cjs_1.stateReplaceField)(posBody, 'Last activity', activityValue);
                     if (replaced !== null)
@@ -1770,7 +1828,7 @@ function cmdStateBeginPhase(cwd, phaseNumber, phaseName, planCount, raw) {
             if (positionMatch) {
                 const header = positionMatch[1];
                 let posBody = positionMatch[2];
-                const resumeActivity = `Last activity: ${today} -- Phase ${phaseNumber} execution resumed (wave continue)`;
+                const resumeActivity = `Last activity: ${today} — Phase ${phaseNumber} execution resumed (wave continue)`;
                 if (/^Last activity:/im.test(posBody)) {
                     posBody = posBody.replace(/^Last activity:.*$/im, resumeActivity);
                     body = body.replace(positionPattern, () => `${header}${posBody}`);
@@ -1933,7 +1991,7 @@ function cmdStatePlannedPhase(cwd, phaseNumber, planCount, raw) {
         // Update Current Position section
         body = updateCurrentPositionFields(body, {
             status: 'Ready to execute',
-            lastActivity: `${today} -- Phase ${phaseNumber} planning complete`,
+            lastActivity: `${today} — Phase ${phaseNumber} planning complete`,
         });
         return reassemble(body);
     }, cwd, { resync: false });
@@ -2472,14 +2530,14 @@ function cmdStateCompletePhase(cwd, raw, overridePhase) {
                     posBody = replaced;
             }
             // Update Last activity line if present
-            const newActivity = `Last activity: ${today} -- Phase ${currentPhase} marked complete`;
+            const newActivity = `Last activity: ${today} — Phase ${currentPhase} marked complete`;
             if (/^Last activity:/im.test(posBody)) {
                 posBody = posBody.replace(/^Last activity:.*$/im, newActivity);
             }
             else {
                 // Pipe-table format in Current Position (#1255)
                 // Value must match the inline branch (date + narrative), not bare date.
-                const activityValue = `${today} -- Phase ${currentPhase} marked complete`;
+                const activityValue = `${today} — Phase ${currentPhase} marked complete`;
                 const replaced = (0, state_document_cjs_1.stateReplaceField)(posBody, 'Last Activity', activityValue)
                     ?? (0, state_document_cjs_1.stateReplaceField)(posBody, 'Last activity', activityValue);
                 if (replaced !== null)

package/gsd-core/bin/lib/task-command-router.cjs

@@ -12,8 +12,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const core = require("./core.cjs");
-const { output, error, ERROR_REASON } = core;
+const ioMod = require("./io.cjs");
+const { output, error, ERROR_REASON } = ioMod;
 // ─── Implementation ───────────────────────────────────────────────────────────
 function isBehaviorAddingTaskContent(content) {
     const tddTrue = /\btdd\s*=\s*["']true["']/i.test(content);

package/gsd-core/bin/lib/teams-status.cjs

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Teams Status Module — issue #1355
+ *
+ * Read-only detector for claude-code's experimental agent-teams feature.
+ * Exposes a PURE core function (env injected, no process.env/disk inside) and
+ * a thin CLI wrapper that reuses resolveRuntime from runtime-slash.cjs.
+ *
+ * Exports:
+ *   resolveTeamsStatus({ runtime, env }) → TeamsStatus
+ *   cmdTeamsStatus(cwd, opts)  — I/O entry point
+ *
+ * resolveTeamsStatus is PURE: env and runtime are injected, no process.env or
+ * disk access inside the function. Pass process.env explicitly at call sites.
+ *
+ * cmdTeamsStatus is the I/O handler. It reads process.env, resolves the
+ * runtime via resolveRuntime(cwd) from runtime-slash.cjs (GSD_RUNTIME →
+ * config.runtime → 'claude' precedence), then:
+ *   - default: prints JSON.stringify(status) to stdout via io.output, exits 0.
+ *   - --active: prints nothing, exits 0 if status.active, exit 1 otherwise.
+ *
+ * Strictly read-only — no config writes, no disk mutation.
+ *
+ * Dependencies:
+ *   - ./io.cjs             (output)
+ *   - ./runtime-slash.cjs  (resolveRuntime)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTeamsStatus = resolveTeamsStatus;
+exports.cmdTeamsStatus = cmdTeamsStatus;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const ioMod = require("./io.cjs");
+const { output: coreOutput } = ioMod;
+// ─── Pure core ────────────────────────────────────────────────────────────────
+/**
+ * Resolve the agent-teams status from injected runtime and env.
+ *
+ * Strict truthiness: only '1' and 'true' (case-insensitive, trimmed) are on.
+ * '0', 'false', '', and unset are all off.
+ *
+ * @param opts.runtime  The resolved runtime name (e.g. 'claude', 'codex')
+ * @param opts.env      The environment map to read from (typically process.env)
+ */
+function resolveTeamsStatus(opts) {
+    const raw = (opts.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] ?? '').trim().toLowerCase();
+    const envOn = raw === '1' || raw === 'true'; // strict: never '0'/'false'/'' as on
+    const isClaude = opts.runtime === 'claude';
+    const source = !isClaude ? 'off: non-claude' : (envOn ? 'on: env' : 'off: flag absent');
+    return { active: envOn && isClaude, runtime: opts.runtime, env_present: envOn, source };
+}
+// ─── CLI command handler ──────────────────────────────────────────────────────
+/**
+ * Command entry point: resolve runtime via resolveRuntime(cwd), read process.env,
+ * call resolveTeamsStatus, and emit the result.
+ *
+ * @param cwd       Project root directory (used by resolveRuntime for config.json)
+ * @param opts      Command options
+ * @param opts.active  When true: print nothing, exit 0 if active, exit 1 otherwise
+ */
+function cmdTeamsStatus(cwd, opts) {
+    // Resolve runtime via the canonical precedence:
+    //   GSD_RUNTIME → config.runtime → 'claude'
+    // Reuses resolveRuntime from runtime-slash.cjs — no reimplementation.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const runtimeSlash = require('./runtime-slash.cjs');
+    const runtime = runtimeSlash.resolveRuntime(cwd);
+    const status = resolveTeamsStatus({ runtime, env: process.env });
+    if (opts.active) {
+        // --active mode: no output, exit code encodes the boolean
+        process.exit(status.active ? 0 : 1);
+    }
+    // Default: emit JSON to stdout via io.output, exit 0
+    coreOutput(status, false);
+}

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

@@ -12,8 +12,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const core = require("./core.cjs");
-const { normalizePhaseName, findPhaseInternal, generateSlugInternal, toPosixPath, output, error } = core;
+const ioMod = require("./io.cjs");
+const { output, error } = ioMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const coreUtilsMod = require("./core-utils.cjs");
+const { toPosixPath, generateSlugInternal } = coreUtilsMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const phaseIdMod = require("./phase-id.cjs");
+const { normalizePhaseName } = phaseIdMod;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const phaseLocatorMod = require("./phase-locator.cjs");
+const { findPhaseInternal } = phaseLocatorMod;
 const shell_command_projection_cjs_1 = require("./shell-command-projection.cjs");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const planningWorkspace = require("./planning-workspace.cjs");

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

@@ -15,8 +15,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const core = require("./core.cjs");
-const { output, error, getMilestonePhaseFilter, toPosixPath } = core;
+const io = require("./io.cjs");
+const { output, error } = io;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const roadmapParser = require("./roadmap-parser.cjs");
+const { getMilestonePhaseFilter } = roadmapParser;
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const coreUtils = require("./core-utils.cjs");
+const { toPosixPath } = coreUtils;
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const planningWorkspace = require("./planning-workspace.cjs");
 const { planningDir } = planningWorkspace;
@@ -139,6 +145,13 @@ function parseCurrentTest(content) {
         || section.match(/^expected:\s*\|\n([\s\S]+)/m);
     const expectedInlineMatch = section.match(/^expected:\s*(.+)\s*$/m);
     if (!numberMatch || !nameMatch || (!expectedBlockMatch && !expectedInlineMatch)) {
+        if (!numberMatch && !nameMatch && !expectedBlockMatch && !expectedInlineMatch) {
+            const pendingTest = parseFirstPendingTest(content);
+            if (pendingTest) {
+                return pendingTest;
+            }
+            error('Current Test section is non-structured and no pending UAT test remains to resume');
+        }
         error('Current Test section is malformed');
     }
     let expected;
@@ -159,6 +172,55 @@ function parseCurrentTest(content) {
         expected: (0, security_cjs_1.sanitizeForDisplay)(expected),
     };
 }
+function parseFirstPendingTest(content) {
+    const testsMatch = content.match(/##\s*Tests\s*\n([\s\S]*?)(?=\n##\s|$)/i);
+    if (!testsMatch) {
+        return null;
+    }
+    const testsSection = testsMatch[1];
+    const headingPattern = /^###\s*(\d+)\.\s*([^\n]+)\s*$/gm;
+    const headings = [];
+    let headingMatch;
+    while ((headingMatch = headingPattern.exec(testsSection)) !== null) {
+        headings.push({
+            index: headingMatch.index,
+            number: parseInt(headingMatch[1], 10),
+            name: headingMatch[2].trim(),
+        });
+    }
+    for (let i = 0; i < headings.length; i += 1) {
+        const current = headings[i];
+        const next = headings[i + 1];
+        const block = testsSection.slice(current.index, next ? next.index : undefined);
+        if (!/^result:\s*\[?pending\]?\s*$/im.test(block)) {
+            continue;
+        }
+        const expected = parseExpectedFromTestBlock(block);
+        if (!expected) {
+            error(`Pending UAT test ${current.number} is missing an expected field`);
+        }
+        return {
+            complete: false,
+            number: current.number,
+            name: (0, security_cjs_1.sanitizeForDisplay)(current.name),
+            expected: (0, security_cjs_1.sanitizeForDisplay)(expected),
+        };
+    }
+    return null;
+}
+function parseExpectedFromTestBlock(block) {
+    const expectedBlockMatch = block.match(/^expected:\s*\|\n([\s\S]*?)(?=^\w[\w-]*:\s)/m)
+        || block.match(/^expected:\s*\|\n([\s\S]+)/m);
+    if (expectedBlockMatch) {
+        return expectedBlockMatch[1]
+            .split('\n')
+            .map((line) => line.replace(/^ {2}/, ''))
+            .join('\n')
+            .trim();
+    }
+    const expectedInlineMatch = block.match(/^expected:\s*(.+)\s*$/m);
+    return expectedInlineMatch ? expectedInlineMatch[1].trim() : null;
+}
 // ─── buildCheckpoint ──────────────────────────────────────────────────────────
 function buildCheckpoint(currentTest) {
     return [

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

@@ -21,11 +21,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
-// eslint-disable-next-line @typescript-eslint/no-require-imports -- core.cjs is an export= CommonJS module
-const core = require("./core.cjs");
+// eslint-disable-next-line @typescript-eslint/no-require-imports -- io.cjs is an export= CommonJS module
+const io = require("./io.cjs");
+// eslint-disable-next-line @typescript-eslint/no-require-imports -- phase-id.cjs is an export= CommonJS module
+const phaseId = require("./phase-id.cjs");
 // eslint-disable-next-line @typescript-eslint/no-require-imports -- frontmatter.cjs is an export= CommonJS module
 const frontmatterMod = require("./frontmatter.cjs");
-const { output, extractPhaseToken } = core;
+const { output, error } = io;
+const { extractPhaseToken } = phaseId;
 const { extractFrontmatter } = frontmatterMod;
 // ─── Constants ────────────────────────────────────────────────────────────────
 /** The set of status values that the gsd-verifier agent emits. */
@@ -170,7 +173,7 @@ function readVerificationStatus(phaseDir, opts = {}) {
 }
 /**
  * CLI command handler: resolve phaseDir against cwd, call readVerificationStatus,
- * emit via core.output().
+ * emit via io.output().
  *
  * @param cwd         - Current working directory (used to resolve phaseDirArg).
  * @param phaseDirArg - Phase directory path (absolute or relative to cwd).
@@ -178,7 +181,7 @@ function readVerificationStatus(phaseDir, opts = {}) {
  */
 function cmdVerificationStatus(cwd, phaseDirArg, raw) {
     if (!phaseDirArg) {
-        core.error('phase directory required for verification.status');
+        error('phase directory required for verification.status');
         return;
     }
     const phaseDir = node_path_1.default.resolve(cwd, phaseDirArg);