gsdd-cli 0.18.4 → 0.19.0

package/bin/lib/runtime-freshness.mjs

@@ -8,22 +8,22 @@ import {
   renderOpenCodeCommandContent,
   renderSkillContent,
 } from './rendering.mjs';
-import {
-  CLAUDE_MODEL_PROFILES,
-  renderClaudeApproachExplorer,
-  renderClaudePlanChecker,
-  renderClaudePlanCommand,
-  renderClaudePlanSkill,
-} from '../adapters/claude.mjs';
-import {
-  renderOpenCodeApproachExplorer,
-  renderOpenCodePlanChecker,
-  renderOpenCodePlanCommand,
-} from '../adapters/opencode.mjs';
-import {
-  renderCodexApproachExplorer,
-  renderCodexPlanChecker,
-} from '../adapters/codex.mjs';
+import {
+  CLAUDE_MODEL_PROFILES,
+  renderClaudeApproachExplorer,
+  renderClaudePlanChecker,
+  renderClaudePlanCommand,
+  renderClaudePlanSkill,
+} from '../adapters/claude.mjs';
+import {
+  renderOpenCodeApproachExplorer,
+  renderOpenCodePlanChecker,
+  renderOpenCodePlanCommand,
+} from '../adapters/opencode.mjs';
+import {
+  renderCodexApproachExplorer,
+  renderCodexPlanChecker,
+} from '../adapters/codex.mjs';
 import {
   getRuntimeModelOverride,
   loadProjectModelConfig,
@@ -33,121 +33,121 @@ import {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PACKAGE_JSON = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
-
-function normalizeContent(content) {
-  return String(content).replace(/\r\n/g, '\n');
-}
-
-function compareGeneratedFile({ cwd, runtime, relativePath, expectedContent, repairCommand }) {
-  const absolutePath = join(cwd, relativePath);
-  if (!existsSync(absolutePath)) {
-    return {
-      runtime,
-      relativePath,
-      status: 'missing',
-      repairCommand,
-    };
-  }
-
-  const actualContent = normalizeContent(readFileSync(absolutePath, 'utf-8'));
-  const expected = normalizeContent(expectedContent);
-  if (actualContent === expected) {
-    return {
-      runtime,
-      relativePath,
-      status: 'clean',
-      repairCommand,
-    };
-  }
-
-  return {
-    runtime,
-    relativePath,
-    status: 'stale',
-    repairCommand,
-  };
-}
-
-function buildClaudeEntries({ cwd, workflows }) {
-  const checkerModelAlias = resolveRuntimeAgentModel({
-    cwd,
-    runtime: 'claude',
-    agentId: 'plan-checker',
-    profileMap: CLAUDE_MODEL_PROFILES,
-  });
-  const explorerModelAlias = resolveRuntimeAgentModel({
-    cwd,
-    runtime: 'claude',
-    agentId: 'approach-explorer',
-    profileMap: CLAUDE_MODEL_PROFILES,
-  });
-
-  const entries = workflows.map((workflow) => ({
-    relativePath: `.claude/skills/${workflow.name}/SKILL.md`,
-    expectedContent: workflow.name === 'gsdd-plan'
-      ? renderClaudePlanSkill()
-      : renderSkillContent(workflow),
-  }));
-
-  entries.push(
-    {
-      relativePath: '.claude/commands/gsdd-plan.md',
-      expectedContent: renderClaudePlanCommand(),
-    },
-    {
-      relativePath: '.claude/agents/gsdd-plan-checker.md',
-      expectedContent: renderClaudePlanChecker(getDelegateContent('plan-checker.md'), checkerModelAlias),
-    },
-    {
-      relativePath: '.claude/agents/gsdd-approach-explorer.md',
-      expectedContent: renderClaudeApproachExplorer(getDelegateContent('approach-explorer.md'), explorerModelAlias),
-    }
-  );
-
-  return entries;
-}
-
-function buildOpenCodeEntries({ cwd, workflows }) {
-  const config = loadProjectModelConfig(cwd);
-  const checkerModelId = getRuntimeModelOverride(config, 'opencode', 'plan-checker');
-  const explorerModelId = getRuntimeModelOverride(config, 'opencode', 'approach-explorer');
-
-  const entries = workflows.map((workflow) => ({
-    relativePath: `.opencode/commands/${workflow.name}.md`,
-    expectedContent: workflow.name === 'gsdd-plan'
-      ? renderOpenCodePlanCommand()
-      : renderOpenCodeCommandContent(workflow),
-  }));
-
-  entries.push(
-    {
-      relativePath: '.opencode/agents/gsdd-plan-checker.md',
-      expectedContent: renderOpenCodePlanChecker(getDelegateContent('plan-checker.md'), checkerModelId),
-    },
-    {
-      relativePath: '.opencode/agents/gsdd-approach-explorer.md',
-      expectedContent: renderOpenCodeApproachExplorer(getDelegateContent('approach-explorer.md'), explorerModelId),
-    }
-  );
-
-  return entries;
-}
-
+
+function normalizeContent(content) {
+  return String(content).replace(/\r\n/g, '\n');
+}
+
+function compareGeneratedFile({ cwd, runtime, relativePath, expectedContent, repairCommand }) {
+  const absolutePath = join(cwd, relativePath);
+  if (!existsSync(absolutePath)) {
+    return {
+      runtime,
+      relativePath,
+      status: 'missing',
+      repairCommand,
+    };
+  }
+
+  const actualContent = normalizeContent(readFileSync(absolutePath, 'utf-8'));
+  const expected = normalizeContent(expectedContent);
+  if (actualContent === expected) {
+    return {
+      runtime,
+      relativePath,
+      status: 'clean',
+      repairCommand,
+    };
+  }
+
+  return {
+    runtime,
+    relativePath,
+    status: 'stale',
+    repairCommand,
+  };
+}
+
+function buildClaudeEntries({ cwd, workflows }) {
+  const checkerModelAlias = resolveRuntimeAgentModel({
+    cwd,
+    runtime: 'claude',
+    agentId: 'plan-checker',
+    profileMap: CLAUDE_MODEL_PROFILES,
+  });
+  const explorerModelAlias = resolveRuntimeAgentModel({
+    cwd,
+    runtime: 'claude',
+    agentId: 'approach-explorer',
+    profileMap: CLAUDE_MODEL_PROFILES,
+  });
+
+  const entries = workflows.map((workflow) => ({
+    relativePath: `.claude/skills/${workflow.name}/SKILL.md`,
+    expectedContent: workflow.name === 'gsdd-plan'
+      ? renderClaudePlanSkill()
+      : renderSkillContent(workflow),
+  }));
+
+  entries.push(
+    {
+      relativePath: '.claude/commands/gsdd-plan.md',
+      expectedContent: renderClaudePlanCommand(),
+    },
+    {
+      relativePath: '.claude/agents/gsdd-plan-checker.md',
+      expectedContent: renderClaudePlanChecker(getDelegateContent('plan-checker.md'), checkerModelAlias),
+    },
+    {
+      relativePath: '.claude/agents/gsdd-approach-explorer.md',
+      expectedContent: renderClaudeApproachExplorer(getDelegateContent('approach-explorer.md'), explorerModelAlias),
+    }
+  );
+
+  return entries;
+}
+
+function buildOpenCodeEntries({ cwd, workflows }) {
+  const config = loadProjectModelConfig(cwd);
+  const checkerModelId = getRuntimeModelOverride(config, 'opencode', 'plan-checker');
+  const explorerModelId = getRuntimeModelOverride(config, 'opencode', 'approach-explorer');
+
+  const entries = workflows.map((workflow) => ({
+    relativePath: `.opencode/commands/${workflow.name}.md`,
+    expectedContent: workflow.name === 'gsdd-plan'
+      ? renderOpenCodePlanCommand()
+      : renderOpenCodeCommandContent(workflow),
+  }));
+
+  entries.push(
+    {
+      relativePath: '.opencode/agents/gsdd-plan-checker.md',
+      expectedContent: renderOpenCodePlanChecker(getDelegateContent('plan-checker.md'), checkerModelId),
+    },
+    {
+      relativePath: '.opencode/agents/gsdd-approach-explorer.md',
+      expectedContent: renderOpenCodeApproachExplorer(getDelegateContent('approach-explorer.md'), explorerModelId),
+    }
+  );
+
+  return entries;
+}
+
 function buildCodexEntries({ cwd }) {
-  const config = loadProjectModelConfig(cwd);
-  const checkerModelId = getRuntimeModelOverride(config, 'codex', 'plan-checker');
-  const explorerModelId = getRuntimeModelOverride(config, 'codex', 'approach-explorer');
-
-  return [
-    {
-      relativePath: '.codex/agents/gsdd-plan-checker.toml',
-      expectedContent: renderCodexPlanChecker(getDelegateContent('plan-checker.md'), checkerModelId),
-    },
-    {
-      relativePath: '.codex/agents/gsdd-approach-explorer.toml',
-      expectedContent: renderCodexApproachExplorer(getDelegateContent('approach-explorer.md'), explorerModelId),
-    },
-  ];
+  const config = loadProjectModelConfig(cwd);
+  const checkerModelId = getRuntimeModelOverride(config, 'codex', 'plan-checker');
+  const explorerModelId = getRuntimeModelOverride(config, 'codex', 'approach-explorer');
+
+  return [
+    {
+      relativePath: '.codex/agents/gsdd-plan-checker.toml',
+      expectedContent: renderCodexPlanChecker(getDelegateContent('plan-checker.md'), checkerModelId),
+    },
+    {
+      relativePath: '.codex/agents/gsdd-approach-explorer.toml',
+      expectedContent: renderCodexApproachExplorer(getDelegateContent('approach-explorer.md'), explorerModelId),
+    },
+  ];
 }
 
 function buildWorkspaceHelperEntries() {
@@ -166,97 +166,99 @@ export function collectExpectedRuntimeSurfaceGroups({ cwd = process.cwd(), workf
       runtime: 'workspace-helper',
       label: 'workspace workflow helper',
       root: '.planning/bin',
-      repairCommand: 'gsdd update',
+      repairCommand: 'npx -y gsdd-cli update',
       entries: buildWorkspaceHelperEntries(),
     },
     {
       runtime: 'portable',
       label: 'portable skills',
-      root: '.agents/skills',
-      repairCommand: 'gsdd update',
-      entries: buildPortableSkillEntries(workflows).map((entry) => ({
-        relativePath: entry.relativePath,
-        expectedContent: entry.content,
-      })),
-    },
-    {
-      runtime: 'claude',
-      label: 'Claude Code native surfaces',
-      root: '.claude',
-      repairCommand: 'gsdd update --tools claude',
-      entries: buildClaudeEntries({ cwd, workflows }),
-    },
-    {
-      runtime: 'opencode',
-      label: 'OpenCode native surfaces',
-      root: '.opencode',
-      repairCommand: 'gsdd update --tools opencode',
-      entries: buildOpenCodeEntries({ cwd, workflows }),
-    },
-    {
-      runtime: 'codex',
-      label: 'Codex CLI native agents',
-      root: '.codex',
-      repairCommand: 'gsdd update --tools codex',
-      entries: buildCodexEntries({ cwd }),
-    },
-  ];
-}
-
-export function evaluateRuntimeFreshness({ cwd = process.cwd(), workflows = [] }) {
-  const groups = collectExpectedRuntimeSurfaceGroups({ cwd, workflows }).map((group) => {
-    const installed = existsSync(join(cwd, group.root));
-    const comparisons = installed
-      ? group.entries.map((entry) => compareGeneratedFile({
-        cwd,
-        runtime: group.runtime,
-        relativePath: entry.relativePath,
-        expectedContent: entry.expectedContent,
-        repairCommand: group.repairCommand,
-      }))
-      : [];
-
-    const stale = comparisons.filter((entry) => entry.status === 'stale');
-    const missing = comparisons.filter((entry) => entry.status === 'missing');
-
-    return {
-      ...group,
-      installed,
-      comparisons,
-      stale,
-      missing,
-      issueCount: stale.length + missing.length,
-    };
-  });
-
-  const checkedGroups = groups.filter((group) => group.installed);
-  const issues = checkedGroups.flatMap((group) => group.comparisons.filter((entry) => entry.status !== 'clean'));
-
-  return {
-    groups,
-    checkedGroups: checkedGroups.map((group) => group.runtime),
-    hasInstalledRuntimeSurfaces: checkedGroups.length > 0,
-    issueCount: issues.length,
-    staleCount: issues.filter((entry) => entry.status === 'stale').length,
-    missingCount: issues.filter((entry) => entry.status === 'missing').length,
-    issues,
-  };
-}
-
-export function summarizeRuntimeFreshnessIssues(report, limit = 4) {
-  if (!report || report.issueCount === 0) return '';
-  const listed = report.issues
-    .slice(0, limit)
-    .map((entry) => `${entry.relativePath} [${entry.status}]`);
-  const remainder = report.issueCount - listed.length;
-  return remainder > 0 ? `${listed.join(', ')} (+${remainder} more)` : listed.join(', ');
-}
-
-export function getRuntimeFreshnessRepairGuidance(report) {
-  if (!report || report.issueCount === 0) return 'Run `gsdd update` to regenerate installed runtime surfaces.';
-  const commands = [...new Set(report.issues.map((entry) => entry.repairCommand))];
-  if (commands.length === 1) {
-    return `Run \`${commands[0]}\` to regenerate the installed runtime surfaces.`;
-  }
-  return `Run \`gsdd update\` to regenerate all installed runtime surfaces, or target the affected adapters individually: ${commands.map((command) => `\`${command}\``).join(', ')}.`;
-}
+      root: '.agents/skills',
+      repairCommand: 'npx -y gsdd-cli update',
+      entries: buildPortableSkillEntries(workflows).map((entry) => ({
+        relativePath: entry.relativePath,
+        expectedContent: entry.content,
+      })),
+    },
+    {
+      runtime: 'claude',
+      label: 'Claude Code native surfaces',
+      root: '.claude',
+      repairCommand: 'npx -y gsdd-cli update --tools claude',
+      entries: buildClaudeEntries({ cwd, workflows }),
+    },
+    {
+      runtime: 'opencode',
+      label: 'OpenCode native surfaces',
+      root: '.opencode',
+      repairCommand: 'npx -y gsdd-cli update --tools opencode',
+      entries: buildOpenCodeEntries({ cwd, workflows }),
+    },
+    {
+      runtime: 'codex',
+      label: 'Codex CLI native agents',
+      root: '.codex',
+      repairCommand: 'npx -y gsdd-cli update --tools codex',
+      entries: buildCodexEntries({ cwd }),
+    },
+  ];
+}
+
+export function evaluateRuntimeFreshness({ cwd = process.cwd(), workflows = [] }) {
+  const groups = collectExpectedRuntimeSurfaceGroups({ cwd, workflows }).map((group) => {
+    const installed = group.runtime === 'workspace-helper'
+      ? existsSync(join(cwd, '.planning'))
+      : existsSync(join(cwd, group.root));
+    const comparisons = installed
+      ? group.entries.map((entry) => compareGeneratedFile({
+        cwd,
+        runtime: group.runtime,
+        relativePath: entry.relativePath,
+        expectedContent: entry.expectedContent,
+        repairCommand: group.repairCommand,
+      }))
+      : [];
+
+    const stale = comparisons.filter((entry) => entry.status === 'stale');
+    const missing = comparisons.filter((entry) => entry.status === 'missing');
+
+    return {
+      ...group,
+      installed,
+      comparisons,
+      stale,
+      missing,
+      issueCount: stale.length + missing.length,
+    };
+  });
+
+  const checkedGroups = groups.filter((group) => group.installed);
+  const issues = checkedGroups.flatMap((group) => group.comparisons.filter((entry) => entry.status !== 'clean'));
+
+  return {
+    groups,
+    checkedGroups: checkedGroups.map((group) => group.runtime),
+    hasInstalledRuntimeSurfaces: checkedGroups.length > 0,
+    issueCount: issues.length,
+    staleCount: issues.filter((entry) => entry.status === 'stale').length,
+    missingCount: issues.filter((entry) => entry.status === 'missing').length,
+    issues,
+  };
+}
+
+export function summarizeRuntimeFreshnessIssues(report, limit = 4) {
+  if (!report || report.issueCount === 0) return '';
+  const listed = report.issues
+    .slice(0, limit)
+    .map((entry) => `${entry.relativePath} [${entry.status}]`);
+  const remainder = report.issueCount - listed.length;
+  return remainder > 0 ? `${listed.join(', ')} (+${remainder} more)` : listed.join(', ');
+}
+
+export function getRuntimeFreshnessRepairGuidance(report) {
+  if (!report || report.issueCount === 0) return 'Run `npx -y gsdd-cli update` to regenerate installed runtime surfaces.';
+  const commands = [...new Set(report.issues.map((entry) => entry.repairCommand))];
+  if (commands.length === 1) {
+    return `Run \`${commands[0]}\` to regenerate the installed runtime surfaces.`;
+  }
+  return `Run \`npx -y gsdd-cli update\` to regenerate all installed runtime surfaces, or target the affected adapters individually: ${commands.map((command) => `\`${command}\``).join(', ')}.`;
+}