godpowers 2.3.0 → 2.4.0

package/lib/extensions.js

@@ -27,6 +27,7 @@ const fs = require('fs');
 const path = require('path');
 
 const intentLib = require('./intent'); // reuses parseSimpleYaml
+const { copyRecursive } = require('./installer-files');
 
 function extensionsDir(runtimeConfigDir) {
   return path.join(runtimeConfigDir, 'godpowers-extensions');
@@ -159,11 +160,13 @@ function list(runtimeConfigDir) {
   const results = [];
   for (const scope of fs.readdirSync(dir)) {
     const scopePath = path.join(dir, scope);
-    if (!fs.statSync(scopePath).isDirectory()) continue;
+    const scopeStat = fs.lstatSync(scopePath);
+    if (scopeStat.isSymbolicLink() || !scopeStat.isDirectory()) continue;
     if (!scope.startsWith('@')) continue;
     for (const name of fs.readdirSync(scopePath)) {
       const packDir = path.join(scopePath, name);
-      if (!fs.statSync(packDir).isDirectory()) continue;
+      const packStat = fs.lstatSync(packDir);
+      if (packStat.isSymbolicLink() || !packStat.isDirectory()) continue;
       const manifestFile = path.join(packDir, 'manifest.yaml');
       if (!fs.existsSync(manifestFile)) continue;
       const { manifest } = parseManifest(fs.readFileSync(manifestFile, 'utf8'));
@@ -220,22 +223,12 @@ function install(runtimeConfigDir, sourceDir, godpowersVersion) {
   for (const sub of ['agents', 'skills', 'workflows', 'references']) {
     const src = path.join(sourceDir, sub);
     if (fs.existsSync(src)) {
-      copyDirRecursive(src, path.join(destDir, sub));
+      copyRecursive(src, path.join(destDir, sub));
     }
   }
   return { installed: true, path: destDir, manifest };
 }
 
-function copyDirRecursive(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const s = path.join(src, entry.name);
-    const d = path.join(dest, entry.name);
-    if (entry.isDirectory()) copyDirRecursive(s, d);
-    else fs.copyFileSync(s, d);
-  }
-}
-
 /**
  * Remove an installed extension by name.
  */

package/lib/feature-awareness.js

@@ -51,7 +51,7 @@ const FEATURES = [
     id: 'route-quality-sync',
     since: '1.6.19',
     commands: ['/god-sync', '/god-doctor', '/god-status', '/god-mode'],
-    description: 'Detect symbolic route spawns, unresolved agent targets, and unapproved contextual route exits.'
+    description: 'Detect symbolic route spawns, unresolved agent targets, and untyped contextual route exits.'
   },
   {
     id: 'recipe-coverage-sync',
@@ -110,7 +110,7 @@ const FEATURES = [
   {
     id: 'extension-authoring',
     since: '1.6.22',
-    commands: ['/god-extension-add', '/god-test-extension'],
+    commands: ['/god-extension-scaffold', '/god-test-extension', '/god-extension-add'],
     description: 'Scaffold and validate publishable Godpowers extension packs.'
   },
   {

package/lib/host-capabilities.js

@@ -10,6 +10,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const cp = require('child_process');
+const codeIntelligence = require('./code-intelligence');
 
 function exists(filePath) {
   return fs.existsSync(filePath);
@@ -55,6 +56,7 @@ function detect(projectRoot, opts = {}) {
   const git = commandVersion('git', ['--version'], { cwd: root });
   const npm = commandVersion('npm', ['--version'], { cwd: root });
   const gh = commandVersion('gh', ['--version'], { cwd: root });
+  const codeIntel = opts.codeIntelligence || codeIntelligence.detect(root, opts.codeIntelligenceOpts || {});
   const shell = Boolean(env.SHELL || env.ComSpec);
   const agentSpawn = Boolean(installedAgents.codex || installedAgents.claude || opts.agentSpawn);
   const extensionAuthoring = exists(path.join(root, 'lib', 'extension-authoring.js'))
@@ -84,6 +86,7 @@ function detect(projectRoot, opts = {}) {
       npm,
       gh,
       agentSpawn,
+      codeIntelligence: codeIntel,
       extensionAuthoring,
       suiteReleaseDryRun
     },
@@ -109,6 +112,7 @@ function render(report) {
   lines.push(`  Git: ${report.guarantees.git || 'not detected'}`);
   lines.push(`  npm: ${report.guarantees.npm || 'not detected'}`);
   lines.push(`  GitHub CLI: ${report.guarantees.gh || 'not detected'}`);
+  lines.push(`  Code intelligence: ${codeIntelligence.summary(report.guarantees.codeIntelligence)}`);
   lines.push(`  Gaps: ${report.gaps.length > 0 ? report.gaps.join('; ') : 'none'}`);
   return lines.join('\n');
 }

package/lib/install-profiles.js

@@ -70,6 +70,7 @@ const PROFILE_SKILLS = {
     'god-migrate',
     'god-automation-status',
     'god-automation-setup',
+    'god-extension-scaffold',
     'god-extension-add',
     'god-extension-list',
     'god-extension-info',

package/lib/planning-systems.js

@@ -112,7 +112,7 @@ function hashFiles(projectRoot, files) {
   for (const file of files.map((f) => f.path).sort()) {
     const full = path.join(projectRoot, file);
     h.update(file);
-    if (fs.existsSync(full) && fs.statSync(full).isFile()) {
+    if (fs.existsSync(full) && fs.lstatSync(full).isFile()) {
       h.update(fs.readFileSync(full));
     }
   }
@@ -125,8 +125,10 @@ function isTextFile(filePath) {
 
 function readText(projectRoot, relPath) {
   const full = path.join(projectRoot, relPath);
-  if (!fs.existsSync(full) || !fs.statSync(full).isFile()) return '';
-  const size = fs.statSync(full).size;
+  if (!fs.existsSync(full)) return '';
+  const stat = fs.lstatSync(full);
+  if (!stat.isFile()) return '';
+  const size = stat.size;
   const buffer = fs.readFileSync(full);
   const raw = buffer.slice(0, Math.min(size, MAX_FILE_BYTES)).toString('utf8');
   return raw.replace(/\r\n/g, '\n');
@@ -134,7 +136,8 @@ function readText(projectRoot, relPath) {
 
 function walkFiles(rootDir, projectRoot, out = []) {
   if (!fs.existsSync(rootDir) || out.length >= MAX_SYSTEM_FILES) return out;
-  const stat = fs.statSync(rootDir);
+  const stat = fs.lstatSync(rootDir);
+  if (stat.isSymbolicLink()) return out;
   if (stat.isFile()) {
     if (isTextFile(rootDir)) out.push(rel(projectRoot, rootDir));
     return out;

package/lib/quick-proof.js

@@ -93,6 +93,9 @@ function render(proof, opts = {}) {
   const next = proof.dashboard.next || {};
   const progress = proof.dashboard.progress || {};
   const planning = proof.dashboard.planning || {};
+  const projectCommandRoot = path.resolve(proof.projectRoot) === path.resolve(proof.fixtureRoot)
+    ? '.'
+    : proof.projectRoot;
 
   if (opts.brief) {
     return [
@@ -140,8 +143,8 @@ function render(proof, opts = {}) {
     `  npx godpowers next --project=${proof.fixtureRoot} --brief`,
     '',
     'Try it on your project:',
-    `  npx godpowers status --project=${proof.projectRoot} --brief`,
-    `  npx godpowers next --project=${proof.projectRoot} --brief`
+    `  npx godpowers status --project=${projectCommandRoot} --brief`,
+    `  npx godpowers next --project=${projectCommandRoot} --brief`
   ].join('\n');
 }
 

package/lib/release-surface-sync.js

@@ -12,15 +12,18 @@ const path = require('path');
 const LOG_PATH = '.godpowers/surface/RELEASE-SURFACE-SYNC.md';
 
 const REQUIRED_PACKAGE_GUARDS = [
+  'lib/command-families.js',
   'lib/dogfood-runner.js',
   'lib/extension-authoring.js',
   'lib/host-capabilities.js',
   'lib/route-quality-sync.js',
   'lib/recipe-coverage-sync.js',
-  'lib/release-surface-sync.js'
+  'lib/release-surface-sync.js',
+  'lib/workflow-helper-groups.js'
 ];
 
 const REQUIRED_RELEASE_TESTS = [
+  'scripts/test-command-families.js',
   'scripts/test-dogfood-runner.js',
   'scripts/test-extension-authoring.js',
   'scripts/test-host-capabilities.js',

package/lib/route-quality-sync.js

@@ -2,8 +2,8 @@
  * Route quality sync.
  *
  * Detects disconnected route automation surfaces: symbolic spawn tokens,
- * unresolved agent targets, contextual exits without an approved reason,
- * missing standards coverage, and agent-spawn routes without trace events.
+ * unresolved agent targets, contextual exits without typed outcomes, missing
+ * standards coverage, and agent-spawn routes without trace events.
  */
 
 const fs = require('fs');
@@ -12,6 +12,21 @@ const path = require('path');
 const { parseSimpleYaml } = require('./intent');
 
 const LOG_PATH = '.godpowers/surface/ROUTE-QUALITY-SYNC.md';
+const CONTEXTUAL_NEXT_VALUES = new Set([
+  'varies',
+  'varies-by-verdict',
+  'steady-state',
+  'session-end'
+]);
+const OUTCOME_TYPES = new Set([
+  'contextual',
+  'verdict-based',
+  'steady-state',
+  'session-end',
+  'requires-selection',
+  'no-next-command',
+  'explicit-command'
+]);
 
 const CONTEXTUAL_NEXT_ALLOWED = new Set([
   '/god',
@@ -21,6 +36,7 @@ const CONTEXTUAL_NEXT_ALLOWED = new Set([
   '/god-check-todos',
   '/god-context-scan',
   '/god-cost',
+  '/god-design-impact',
   '/god-discuss',
   '/god-doctor',
   '/god-extension-add',
@@ -33,10 +49,17 @@ const CONTEXTUAL_NEXT_ALLOWED = new Set([
   '/god-list-assumptions',
   '/god-locate',
   '/god-logs',
+  '/god-launch',
   '/god-metrics',
+  '/god-mode',
   '/god-next',
+  '/god-pause-work',
   '/god-redo',
+  '/god-reconcile',
   '/god-resume-work',
+  '/god-roadmap-check',
+  '/god-sprint',
+  '/god-suite-status',
   '/god-test-extension',
   '/god-thread',
   '/god-trace',
@@ -61,6 +84,7 @@ const STANDARDS_EXEMPT_COMMANDS = new Set([
   '/god-progress',
   '/god-reconstruct',
   '/god-roadmap-check',
+  '/god-extension-scaffold',
   '/god-smite',
   '/god-tech-debt'
 ]);
@@ -139,7 +163,7 @@ function detect(projectRoot) {
     .map((file) => path.basename(file, '.md')));
   let symbolicCount = 0;
   let unresolvedCount = 0;
-  let contextualExitCount = 0;
+  let typedOutcomeCount = 0;
   let standardsExemptCount = 0;
   let traceEventMissingCount = 0;
 
@@ -192,18 +216,22 @@ function detect(projectRoot) {
       );
     }
 
-    const next = route['success-path'] && route['success-path']['next-recommended'];
+    const successPath = route['success-path'] || {};
+    const next = successPath['next-recommended'];
     const conditionalNext = route['success-path'] && arr(route['success-path']['conditional-next']);
-    if (next === 'varies' && conditionalNext.length === 0) {
-      if (CONTEXTUAL_NEXT_ALLOWED.has(command)) {
-        contextualExitCount++;
+    const outcome = successPath.outcome || {};
+    const needsTypedOutcome = next
+      && (CONTEXTUAL_NEXT_VALUES.has(String(next)) || /\s+or\s+/.test(String(next)));
+    if (needsTypedOutcome) {
+      if (outcome.type && OUTCOME_TYPES.has(String(outcome.type))) {
+        typedOutcomeCount++;
       } else {
         addCheck(
           checks,
-          `unapproved-varies-${command.replace(/[^a-z0-9]+/gi, '-')}`,
+          `missing-route-outcome-${command.replace(/[^a-z0-9]+/gi, '-')}`,
           'stale',
           routePath,
-          `${command} uses next-recommended: varies without an approved contextual-exit classification.`,
+          `${command} uses contextual next route ${next} without a typed success-path.outcome.`,
           { spawn: 'god-roadmap-reconciler' }
         );
       }
@@ -236,10 +264,10 @@ function detect(projectRoot) {
   addCheck(
     checks,
     'contextual-exit-policy',
-    checks.some((check) => check.id.startsWith('unapproved-varies-')) ? 'stale' : 'fresh',
+    checks.some((check) => check.id.startsWith('missing-route-outcome-')) ? 'stale' : 'fresh',
     'routing/',
-    `${contextualExitCount} contextual route exits are approved and all other next routes are explicit.`,
-    { spawn: checks.some((check) => check.id.startsWith('unapproved-varies-')) ? 'god-roadmap-reconciler' : null }
+    `${typedOutcomeCount} contextual route exits have typed outcomes and all other next routes are explicit.`,
+    { spawn: checks.some((check) => check.id.startsWith('missing-route-outcome-')) ? 'god-roadmap-reconciler' : null }
   );
   addCheck(
     checks,
@@ -307,6 +335,8 @@ function summary(report) {
 module.exports = {
   LOG_PATH,
   CONTEXTUAL_NEXT_ALLOWED,
+  CONTEXTUAL_NEXT_VALUES,
+  OUTCOME_TYPES,
   STANDARDS_EXEMPT_COMMANDS,
   detect,
   run,

package/lib/router.js

@@ -12,6 +12,7 @@ const fs = require('fs');
 const path = require('path');
 const { parseSimpleYaml } = require('./intent');
 const state = require('./state');
+const commandFamilies = require('./command-families');
 
 const ROUTING_DIR = path.join(__dirname, '..', 'routing');
 const SAFE_SYNC_PLAN = '.godpowers/sync/SAFE-SYNC-PLAN.md';
@@ -186,6 +187,33 @@ function getNextCommand(command, opts = {}) {
   return sp['next-recommended'] || null;
 }
 
+function inferOutcomeType(next) {
+  if (!next) return 'no-next-command';
+  if (next === 'varies') return 'contextual';
+  if (next === 'varies-by-verdict') return 'verdict-based';
+  if (next === 'steady-state') return 'steady-state';
+  if (next === 'session-end') return 'session-end';
+  if (/\s+or\s+/.test(next)) return 'requires-selection';
+  if (/^\/god(?:-[a-z-]+)?(?:\s.*)?$/.test(next)) return 'explicit-command';
+  return 'contextual';
+}
+
+function getRouteOutcome(command) {
+  const routing = getRouting(command);
+  if (!routing) return null;
+  const sp = routing['success-path'] || {};
+  const outcome = sp.outcome || {};
+  const next = sp['next-recommended'] || null;
+  const type = outcome.type || inferOutcomeType(next);
+  return {
+    type,
+    label: outcome.label || type,
+    reason: outcome.reason || 'Route outcome is inferred from success-path.next-recommended.',
+    next,
+    allowedNext: outcome['allowed-next'] || []
+  };
+}
+
 /**
  * Evaluate a routing condition against the project state.
  */
@@ -368,9 +396,13 @@ module.exports = {
   getRouting,
   checkPrerequisites,
   getNextCommand,
+  getRouteOutcome,
   getAlternatives,
   getStandards,
   getSpawnedAgents,
+  getCommandFamily: commandFamilies.familyForCommand,
+  resolveTrigger: commandFamilies.resolveTrigger,
+  commandFamilies,
   suggestNext,
   evaluateCheck,
   resolveProjectRelative,

package/lib/workflow-helper-groups.js

@@ -0,0 +1,50 @@
+/**
+ * Workflow helper groups.
+ *
+ * Workflow YAML can use these groups to avoid repeating long closeout helper
+ * lists. Plans still expand them into exact helper names for visibility.
+ */
+
+const HELPER_GROUPS = {
+  'standard-closeout': [
+    'repo-doc-sync',
+    'repo-surface-sync',
+    'checkpoint-sync',
+    'pillars-sync-plan'
+  ],
+  'repo-maintenance-closeout': [
+    'repo-doc-sync',
+    'repo-surface-sync'
+  ],
+  'runtime-awareness-closeout': [
+    'feature-awareness',
+    'host-capabilities'
+  ],
+  'release-readiness-closeout': [
+    'route-quality-sync',
+    'recipe-coverage-sync',
+    'release-surface-sync'
+  ],
+  'source-sync-closeout': [
+    'source-sync-back'
+  ]
+};
+
+function expand(groups = [], helpers = []) {
+  const expanded = [];
+  const names = Array.isArray(groups) ? groups : [groups].filter(Boolean);
+  for (const group of names) {
+    for (const helper of HELPER_GROUPS[group] || []) {
+      if (!expanded.includes(helper)) expanded.push(helper);
+    }
+  }
+  for (const helper of helpers || []) {
+    if (!expanded.includes(helper)) expanded.push(helper);
+  }
+  return expanded;
+}
+
+module.exports = {
+  HELPER_GROUPS,
+  expand
+};

package/lib/workflow-runner.js

@@ -31,6 +31,7 @@ const path = require('path');
 const parser = require('./workflow-parser');
 const asyncFs = require('./fs-async');
 const agentRefs = require('./agent-refs');
+const helperGroups = require('./workflow-helper-groups');
 
 /**
  * @typedef {Object} WorkflowPlanStep
@@ -134,7 +135,8 @@ function plan(workflow, ctx = {}) {
         review: job.review || null,
         'on-pass': job['on-pass'] || null,
         'on-fail': job['on-fail'] || null,
-        localHelpers: job['local-helpers'] || [],
+        localHelperGroups: job['local-helper-groups'] || [],
+        localHelpers: helperGroups.expand(job['local-helper-groups'] || [], job['local-helpers'] || []),
         with: job.with || null
       });
     }
@@ -221,6 +223,9 @@ function serializePlan(p) {
       if (step.tier) lines.push(`        tier: ${step.tier}`);
       if (step.agent) lines.push(`        agent: ${step.agent}`);
       if (step.uses)  lines.push(`        uses: ${step.uses}`);
+      if (step.localHelperGroups && step.localHelperGroups.length) {
+        lines.push(`        local-helper-groups: [${step.localHelperGroups.join(', ')}]`);
+      }
       if (step.localHelpers && step.localHelpers.length) {
         lines.push(`        local-helpers: [${step.localHelpers.join(', ')}]`);
       }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "godpowers",
-  "version": "2.3.0",
-  "description": "AI-powered development system: 111 slash commands and 40 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
+  "version": "2.4.0",
+  "description": "AI-powered development system: 112 slash commands and 40 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
   "bin": {
     "godpowers": "./bin/install.js"
   },

package/routing/god-add-backlog.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-add-backlog
   description: Add idea to backlog (less urgent than todo)
   tier: 0
+  family: capture
 
 prerequisites:
   required: []

package/routing/god-add-tests.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-add-tests
   description: Add tests to legacy code
   tier: 0
+  family: build
 
 prerequisites:
   required:

package/routing/god-add-todo.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-add-todo
   description: Capture a todo from current context
   tier: 0
+  family: capture
 
 prerequisites:
   required: []

package/routing/god-agent-audit.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-agent-audit
   description: Validate agents/*.md against agent contract
   tier: 0
+  family: verify
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-arch.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-arch
   description: Design system architecture
   tier: 1
+  family: start
 
 prerequisites:
   required:

package/routing/god-archaeology.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-archaeology
   description: Deep brownfield code archaeology
   tier: 0
+  family: start
 
 prerequisites:
   required: []

package/routing/god-audit.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-audit
   description: Score artifacts against have-nots
   tier: 0
+  family: verify
 
 prerequisites:
   required:

package/routing/god-automation-setup.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-automation-setup
   description: Prepare opt-in host automation setup
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-automation-status.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-automation-status
   description: Show host automation provider support
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-budget.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-budget
   description: 
   tier: 0
+  family: configure
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-build-agent.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-build-agent
   description: Generate custom specialist agent
   tier: 0
+  family: extend
 
 prerequisites:
   required: []

package/routing/god-build.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-build
   description: Build slices with TDD enforcement and two-stage review
   tier: 2
+  family: build
 
 prerequisites:
   required:

package/routing/god-cache-clear.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-cache-clear
   description: 
   tier: 0
+  family: configure
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-check-todos.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-check-todos
   description: List pending todos; optionally route to one
   tier: 0
+  family: capture
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-context-scan.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-context-scan
   description: 
   tier: 0
+  family: maintain
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-context.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-context
   description: Manage Godpowers fence in AGENTS.md / CLAUDE.md / GEMINI.md / others
   tier: 0
+  family: maintain
 
 prerequisites:
   required: