godpowers 2.4.2 → 2.5.0

package/bin/install.js

@@ -20,6 +20,7 @@ const {
 const { describeProfiles } = require('../lib/install-profiles');
 const commandFamilies = require('../lib/command-families');
 const identity = require('../lib/package-identity');
+const cliDispatch = require('../lib/cli-dispatch');
 
 const VERSION = identity.PACKAGE_VERSION;
 
@@ -50,6 +51,7 @@ function showHelp() {
   log('Commands:');
   log('  status               Show the Godpowers Dashboard for a project');
   log('  next                 Show the dashboard and recommended next command');
+  log('  gate                 Check a tier artifact gate');
   log('  quick-proof          Show a runnable proof from the shipped fixture');
   log('  automation-status    Show host automation provider support');
   log('  automation-setup     Show an opt-in automation setup plan');
@@ -63,6 +65,7 @@ function showHelp() {
   log('');
   log('Options:');
   log('  --project=<path>     Project root for status, next, proof, or automation commands');
+  log('  --tier=<name>        Tier for gate: prd, design, arch, roadmap, stack, repo, build, or harden');
   log('  --json               Emit JSON for status, next, proof, or automation commands');
   log('  --brief              Render compact output for status, next, or proof');
   log('  --name=<scope/name>  Extension package name for extension-scaffold');
@@ -96,6 +99,7 @@ function showHelp() {
   log('Examples:');
   log('  npx godpowers status --project=.');
   log('  npx godpowers next --project=.');
+  log('  npx godpowers gate --tier=prd --project=.');
   log('  npx godpowers quick-proof --project=.');
   log('  npx godpowers automation-status --project=.');
   log('  npx godpowers automation-setup --project=.');
@@ -107,110 +111,6 @@ function showHelp() {
   log('  npx godpowers --codex --cursor');
 }
 
-function runAutomationCommand(opts) {
-  const automation = require('../lib/automation-providers');
-  const result = opts.command === 'automation-setup'
-    ? automation.setupPlan(opts.project)
-    : automation.detect(opts.project);
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else if (opts.command === 'automation-setup') {
-    console.log(automation.renderSetupPlan(result));
-  } else {
-    console.log(automation.render(result));
-  }
-}
-
-function runDashboardCommand(opts) {
-  const dashboard = require('../lib/dashboard');
-  const result = dashboard.compute(opts.project);
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(dashboard.render(result, { brief: opts.brief }));
-  if (opts.command === 'next') {
-    console.log('');
-    console.log('Suggested next command:');
-    console.log(`  ${result.next && result.next.command ? result.next.command : 'describe the next intent'}`);
-  }
-}
-
-function runDogfoodCommand(opts) {
-  const dogfood = require('../lib/dogfood-runner');
-  const result = dogfood.runAll();
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    console.log(dogfood.render(result));
-  }
-  if (result.status !== 'pass') process.exit(1);
-}
-
-function runQuickProofCommand(opts) {
-  const quickProof = require('../lib/quick-proof');
-  const result = quickProof.compute(opts.project);
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    console.log(quickProof.render(result, { brief: opts.brief }));
-  }
-}
-
-function runExtensionScaffoldCommand(opts) {
-  const authoring = require('../lib/extension-authoring');
-  if (!opts.extensionName) {
-    error('extension-scaffold requires --name=@scope/package');
-    process.exit(1);
-  }
-  const result = authoring.scaffold(opts.extensionOutput, {
-    name: opts.extensionName,
-    skill: opts.extensionSkill || undefined,
-    agent: opts.extensionAgent || undefined,
-    workflow: opts.extensionWorkflow || undefined,
-    runtimeVersion: VERSION
-  });
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  success(`Scaffolded ${result.name} at ${result.path}`);
-  if (result.written.length > 0) {
-    log(`Wrote ${result.written.length} file(s): ${result.written.join(', ')}`);
-  }
-  if (result.validation.length > 0) {
-    warn(`Validation warnings: ${result.validation.join('; ')}`);
-  } else {
-    success('Extension manifest validates');
-  }
-}
-
-function runCommand(opts) {
-  if (opts.command === 'status' || opts.command === 'next') {
-    runDashboardCommand(opts);
-    return true;
-  }
-  if (opts.command === 'quick-proof') {
-    runQuickProofCommand(opts);
-    return true;
-  }
-  if (opts.command === 'automation-status' || opts.command === 'automation-setup') {
-    runAutomationCommand(opts);
-    return true;
-  }
-  if (opts.command === 'dogfood') {
-    runDogfoodCommand(opts);
-    return true;
-  }
-  if (opts.command === 'extension-scaffold') {
-    runExtensionScaffoldCommand(opts);
-    return true;
-  }
-  return false;
-}
-
 function applyDefaultRuntimeSelection(opts) {
   if (opts.runtimes.length > 0 || opts.all) return;
   if (!process.stdin.isTTY) {
@@ -282,7 +182,7 @@ function main() {
     process.exit(0);
   }
 
-  if (runCommand(opts)) return;
+  if (cliDispatch.runCommand(opts)) return;
 
   console.log(BANNER);
   const srcDir = path.resolve(__dirname, '..');
@@ -299,11 +199,20 @@ function main() {
   }
 }
 
-main();
+if (require.main === module) {
+  main();
+}
 
 module.exports = {
   showHelp,
-  runCommand,
+  COMMAND_RUNNERS: cliDispatch.COMMAND_RUNNERS,
+  runCommand: cliDispatch.runCommand,
+  runAutomationCommand: cliDispatch.runAutomationCommand,
+  runDashboardCommand: cliDispatch.runDashboardCommand,
+  runDogfoodCommand: cliDispatch.runDogfoodCommand,
+  runQuickProofCommand: cliDispatch.runQuickProofCommand,
+  runExtensionScaffoldCommand: cliDispatch.runExtensionScaffoldCommand,
+  runGateCommand: cliDispatch.runGateCommand,
   applyDefaultRuntimeSelection,
   runInstall,
   runUninstall,

package/fixtures/gate/build-pass/.godpowers/build/STATE.md

@@ -0,0 +1,10 @@
+# Build State
+
+## Delivered
+
+[DECISION] The build gate fixture records a completed implementation slice for executable gate tests.
+
+## Verification Commands
+
+- [DECISION] `npm test`: passed for the fixture project.
+- [DECISION] `npm run lint`: passed for the fixture project.

package/fixtures/gate/harden-pass/.godpowers/harden/FINDINGS.md

@@ -0,0 +1,14 @@
+# Security Findings
+
+## Summary
+
+[DECISION] The harden fixture contains no unresolved Critical findings.
+
+| Severity | Count |
+|---|---:|
+| Critical | 0 |
+| High | 0 |
+| Medium | 0 |
+| Low | 0 |
+
+[DECISION] Launch gate: PASSED.

package/fixtures/gate/repo-pass/.godpowers/repo/AUDIT.md

@@ -0,0 +1,9 @@
+# Repo Audit
+
+## Scaffold Evidence
+
+[DECISION] The repo gate fixture records that the scaffold artifact exists and can be linted by the Phase 1 gate.
+
+## Verification
+
+[DECISION] The fixture is intentionally minimal because Phase 1 does not run scaffold CI commands.

package/lib/artifact-map.js

@@ -0,0 +1,60 @@
+/**
+ * Shared tier artifact map for dashboard, gates, and documentation checks.
+ */
+
+const TIER_ARTIFACTS = {
+  prd: [
+    { path: '.godpowers/prd/PRD.md', required: true, lint: true }
+  ],
+  design: [
+    { path: 'DESIGN.md', required: true, lint: true },
+    { path: 'PRODUCT.md', required: false, lint: true },
+    { path: '.godpowers/design/STATE.md', required: true, lint: true }
+  ],
+  arch: [
+    { path: '.godpowers/arch/ARCH.md', required: true, lint: true }
+  ],
+  roadmap: [
+    { path: '.godpowers/roadmap/ROADMAP.md', required: true, lint: true }
+  ],
+  stack: [
+    { path: '.godpowers/stack/DECISION.md', required: true, lint: true }
+  ],
+  repo: [
+    { path: '.godpowers/repo/AUDIT.md', required: true, lint: true }
+  ],
+  build: [
+    { path: '.godpowers/build/STATE.md', required: true, lint: true }
+  ],
+  harden: [
+    { path: '.godpowers/harden/FINDINGS.md', required: true, lint: true }
+  ]
+};
+
+function normalizeTier(tier) {
+  if (!tier) return null;
+  return String(tier).replace(/^\/?god-/, '').toLowerCase();
+}
+
+function tiers() {
+  return Object.keys(TIER_ARTIFACTS);
+}
+
+function artifactsForTier(tier) {
+  const key = normalizeTier(tier);
+  if (!key || !TIER_ARTIFACTS[key]) return null;
+  return TIER_ARTIFACTS[key].map((artifact) => ({ ...artifact }));
+}
+
+function requiredArtifactsForTier(tier) {
+  const artifacts = artifactsForTier(tier);
+  return artifacts ? artifacts.filter((artifact) => artifact.required) : null;
+}
+
+module.exports = {
+  TIER_ARTIFACTS,
+  normalizeTier,
+  tiers,
+  artifactsForTier,
+  requiredArtifactsForTier
+};

package/lib/cli-dispatch.js

@@ -0,0 +1,162 @@
+/**
+ * Installer CLI command dispatch.
+ */
+
+const gate = require('./gate');
+const identity = require('./package-identity');
+
+const VERSION = identity.PACKAGE_VERSION;
+
+function log(msg) {
+  console.log(`  ${msg}`);
+}
+
+function success(msg) {
+  console.log(`  \x1b[32m+\x1b[0m ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  \x1b[33m!\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.error(`  \x1b[31mx\x1b[0m ${msg}`);
+}
+
+function runAutomationCommand(opts) {
+  const automation = require('./automation-providers');
+  const result = opts.command === 'automation-setup'
+    ? automation.setupPlan(opts.project)
+    : automation.detect(opts.project);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else if (opts.command === 'automation-setup') {
+    console.log(automation.renderSetupPlan(result));
+  } else {
+    console.log(automation.render(result));
+  }
+}
+
+function runDashboardCommand(opts) {
+  const dashboard = require('./dashboard');
+  const result = dashboard.compute(opts.project);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  console.log(dashboard.render(result, { brief: opts.brief }));
+  if (opts.command === 'next') {
+    console.log('');
+    console.log('Suggested next command:');
+    console.log(`  ${result.next && result.next.command ? result.next.command : 'describe the next intent'}`);
+  }
+}
+
+function runDogfoodCommand(opts) {
+  const dogfood = require('./dogfood-runner');
+  const result = dogfood.runAll();
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(dogfood.render(result));
+  }
+  if (result.status !== 'pass') process.exit(1);
+}
+
+function runQuickProofCommand(opts) {
+  const quickProof = require('./quick-proof');
+  const result = quickProof.compute(opts.project);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(quickProof.render(result, { brief: opts.brief }));
+  }
+}
+
+function runExtensionScaffoldCommand(opts) {
+  const authoring = require('./extension-authoring');
+  if (!opts.extensionName) {
+    error('extension-scaffold requires --name=@scope/package');
+    process.exit(1);
+  }
+  const result = authoring.scaffold(opts.extensionOutput, {
+    name: opts.extensionName,
+    skill: opts.extensionSkill || undefined,
+    agent: opts.extensionAgent || undefined,
+    workflow: opts.extensionWorkflow || undefined,
+    runtimeVersion: VERSION
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  success(`Scaffolded ${result.name} at ${result.path}`);
+  if (result.written.length > 0) {
+    log(`Wrote ${result.written.length} file(s): ${result.written.join(', ')}`);
+  }
+  if (result.validation.length > 0) {
+    warn(`Validation warnings: ${result.validation.join('; ')}`);
+  } else {
+    success('Extension manifest validates');
+  }
+}
+
+function runGateCommand(opts) {
+  if (!opts.tier) {
+    const result = {
+      tier: null,
+      verdict: 'fail',
+      artifacts: [],
+      checks: [{ id: 'tier-required', status: 'fail', artifact: null, reason: 'gate requires --tier=<name>' }],
+      findings: [{ id: 'tier-required', severity: 'error', artifact: null, reason: 'gate requires --tier=<name>' }],
+      summary: { errors: 1, warnings: 0, infos: 0, missing: 0, checkedArtifacts: 0 }
+    };
+    if (opts.json) console.log(JSON.stringify(result, null, 2));
+    else console.log(gate.render(result));
+    process.exitCode = 1;
+    return;
+  }
+
+  const result = gate.check({ tier: opts.tier, projectRoot: opts.project });
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(gate.render(result));
+  }
+  if (gate.exitCode(result) !== 0) {
+    process.exitCode = 1;
+  }
+}
+
+const COMMAND_RUNNERS = {
+  status: runDashboardCommand,
+  next: runDashboardCommand,
+  'quick-proof': runQuickProofCommand,
+  'automation-status': runAutomationCommand,
+  'automation-setup': runAutomationCommand,
+  dogfood: runDogfoodCommand,
+  'extension-scaffold': runExtensionScaffoldCommand,
+  gate: runGateCommand
+};
+
+function runCommand(opts) {
+  const runner = COMMAND_RUNNERS[opts.command];
+  if (runner) {
+    runner(opts);
+    return true;
+  }
+  return false;
+}
+
+module.exports = {
+  COMMAND_RUNNERS,
+  runCommand,
+  runAutomationCommand,
+  runDashboardCommand,
+  runDogfoodCommand,
+  runQuickProofCommand,
+  runExtensionScaffoldCommand,
+  runGateCommand
+};

package/lib/command-families.js

@@ -119,7 +119,6 @@ const COMMAND_FAMILIES = [
       '/god-upgrade',
       '/god-context',
       '/god-context-scan',
-      '/god-roadmap-check',
       '/god-roadmap-update'
     ]
   },
@@ -198,6 +197,15 @@ const COMMAND_FAMILIES = [
       '/god-help',
       '/god-version'
     ]
+  },
+  {
+    id: 'compatibility',
+    label: 'Compatibility',
+    purpose: 'Deprecated full-profile commands kept for backward compatibility.',
+    visibility: 'hidden',
+    commands: [
+      '/god-roadmap-check'
+    ]
   }
 ];
 
@@ -279,7 +287,7 @@ function familyForCommand(command) {
   return COMMAND_FAMILIES.find((family) => family.commands.includes(command)) || null;
 }
 
-function renderFamilyCards(families = COMMAND_FAMILIES) {
+function renderFamilyCards(families = COMMAND_FAMILIES.filter((family) => family.visibility !== 'hidden')) {
   return families.map((family) => (
     `${family.label}: ${family.purpose} (${family.commands.join(', ')})`
   ));

package/lib/dashboard.js

@@ -16,10 +16,11 @@ const automationProviders = require('./automation-providers');
 const repoDocSync = require('./repo-doc-sync');
 const repoSurfaceSync = require('./repo-surface-sync');
 const hostCapabilities = require('./host-capabilities');
+const artifactMap = require('./artifact-map');
 
 const GOD_DIR = '.godpowers';
-const PRD_PATH = '.godpowers/prd/PRD.md';
-const ROADMAP_PATH = '.godpowers/roadmap/ROADMAP.md';
+const PRD_PATH = artifactMap.requiredArtifactsForTier('prd')[0].path;
+const ROADMAP_PATH = artifactMap.requiredArtifactsForTier('roadmap')[0].path;
 const CHECKPOINT_PATH = '.godpowers/CHECKPOINT.md';
 const SYNC_LOG_PATH = '.godpowers/SYNC-LOG.md';
 const REVIEW_PATH = '.godpowers/REVIEW-REQUIRED.md';