godpowers 1.6.20 → 1.6.22

package/lib/release-surface-sync.js

@@ -12,11 +12,25 @@ const path = require('path');
 const LOG_PATH = '.godpowers/surface/RELEASE-SURFACE-SYNC.md';
 
 const REQUIRED_PACKAGE_GUARDS = [
+  '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'
 ];
 
+const REQUIRED_RELEASE_TESTS = [
+  'scripts/test-dogfood-runner.js',
+  'scripts/test-extension-authoring.js',
+  'scripts/test-host-capabilities.js',
+  'scripts/test-automation-surface-sync.js',
+  'scripts/test-repo-surface-sync.js',
+  'scripts/test-extensions-publish.js',
+  'scripts/test-mode-d.js',
+  'scripts/test-install-smoke.js'
+];
+
 function read(projectRoot, relPath) {
   const file = path.join(projectRoot, relPath);
   if (!fs.existsSync(file)) return '';
@@ -100,6 +114,21 @@ function detect(projectRoot) {
     );
   }
 
+  const scriptsText = JSON.stringify(pkg.scripts || {});
+  for (const required of REQUIRED_RELEASE_TESTS) {
+    const ok = scriptsText.includes(required);
+    addCheck(
+      checks,
+      `release-test-${required.replace(/[^a-z0-9]+/gi, '-')}`,
+      ok ? 'fresh' : 'stale',
+      'package.json',
+      ok
+        ? `Release gate includes ${required}.`
+        : `Release gate does not include ${required}.`,
+      { spawn: ok ? null : 'god-auditor' }
+    );
+  }
+
   const stale = checks.filter((check) => check.status !== 'fresh');
   return {
     status: stale.length === 0 ? 'fresh' : 'stale',
@@ -147,6 +176,7 @@ function summary(report) {
 module.exports = {
   LOG_PATH,
   REQUIRED_PACKAGE_GUARDS,
+  REQUIRED_RELEASE_TESTS,
   detect,
   run,
   summary

package/lib/repo-surface-sync.js

@@ -29,6 +29,7 @@ const REQUIRED_PACKAGE_FILE_ENTRIES = [
   'workflows/',
   'schema/',
   'lib/',
+  'fixtures/',
   'extensions/',
   'RELEASE.md',
   'SKILL.md',
@@ -41,6 +42,9 @@ const REQUIRED_PACKAGE_CHECKS = [
   'lib/feature-awareness.js',
   'lib/repo-doc-sync.js',
   'lib/repo-surface-sync.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',
@@ -357,6 +361,128 @@ function extensionChecks(projectRoot) {
   return checks;
 }
 
+function suiteChecks(projectRoot) {
+  const checks = [];
+  const pkg = readJson(projectRoot, 'package.json') || {};
+  const scriptsText = JSON.stringify(pkg.scripts || {});
+  const roadmap = read(projectRoot, 'docs/ROADMAP.md');
+  const suiteCommands = [
+    'god-suite-init',
+    'god-suite-status',
+    'god-suite-sync',
+    'god-suite-patch',
+    'god-suite-release'
+  ];
+
+  addCheck(
+    checks,
+    'suite',
+    'suite-runtime-helper',
+    exists(projectRoot, 'lib/suite-state.js') ? 'fresh' : 'stale',
+    'lib/suite-state.js',
+    exists(projectRoot, 'lib/suite-state.js')
+      ? 'Mode D suite state helper exists.'
+      : 'Mode D suite state helper is missing.',
+    { spawn: exists(projectRoot, 'lib/suite-state.js') ? null : 'god-coordinator' }
+  );
+
+  addCheck(
+    checks,
+    'suite',
+    'suite-test-gate',
+    scriptsText.includes('scripts/test-mode-d.js') ? 'fresh' : 'stale',
+    'package.json',
+    scriptsText.includes('scripts/test-mode-d.js')
+      ? 'Release gate includes Mode D suite tests.'
+      : 'Release gate does not include Mode D suite tests.',
+    { spawn: scriptsText.includes('scripts/test-mode-d.js') ? null : 'god-coordinator' }
+  );
+
+  addCheck(
+    checks,
+    'suite',
+    'suite-docs',
+    roadmap.includes('Mode D') ? 'fresh' : 'stale',
+    'docs/ROADMAP.md',
+    roadmap.includes('Mode D')
+      ? 'Roadmap documents Mode D suite support.'
+      : 'Roadmap does not document Mode D suite support.',
+    { spawn: roadmap.includes('Mode D') ? null : 'god-coordinator' }
+  );
+
+  for (const command of suiteCommands) {
+    const skill = `skills/${command}.md`;
+    const route = `routing/${command}.yaml`;
+    const ok = exists(projectRoot, skill) && exists(projectRoot, route);
+    addCheck(
+      checks,
+      'suite',
+      `suite-command-${command}`,
+      ok ? 'fresh' : 'stale',
+      skill,
+      ok
+        ? `/${command} has skill and routing metadata.`
+        : `/${command} is missing a skill or route.`,
+      { spawn: ok ? null : 'god-coordinator' }
+    );
+  }
+
+  return checks;
+}
+
+function dogfoodChecks(projectRoot) {
+  const checks = [];
+  const pkg = readJson(projectRoot, 'package.json') || {};
+  const scriptsText = JSON.stringify(pkg.scripts || {});
+  const scenarios = [
+    'fixtures/dogfood/half-migrated-gsd/manifest.json',
+    'fixtures/dogfood/host-degraded/manifest.json',
+    'fixtures/dogfood/host-full/manifest.json',
+    'fixtures/dogfood/extension-authoring/manifest.json',
+    'fixtures/dogfood/suite-release-dry-run/manifest.json'
+  ];
+
+  addCheck(
+    checks,
+    'dogfood',
+    'dogfood-runtime-helper',
+    exists(projectRoot, 'lib/dogfood-runner.js') ? 'fresh' : 'stale',
+    'lib/dogfood-runner.js',
+    exists(projectRoot, 'lib/dogfood-runner.js')
+      ? 'Dogfood runner helper exists.'
+      : 'Dogfood runner helper is missing.',
+    { spawn: exists(projectRoot, 'lib/dogfood-runner.js') ? null : 'god-auditor' }
+  );
+
+  addCheck(
+    checks,
+    'dogfood',
+    'dogfood-test-gate',
+    scriptsText.includes('scripts/test-dogfood-runner.js') ? 'fresh' : 'stale',
+    'package.json',
+    scriptsText.includes('scripts/test-dogfood-runner.js')
+      ? 'Release gate includes dogfood runner tests.'
+      : 'Release gate does not include dogfood runner tests.',
+    { spawn: scriptsText.includes('scripts/test-dogfood-runner.js') ? null : 'god-auditor' }
+  );
+
+  for (const scenario of scenarios) {
+    addCheck(
+      checks,
+      'dogfood',
+      `dogfood-scenario-${path.basename(path.dirname(scenario))}`,
+      exists(projectRoot, scenario) ? 'fresh' : 'stale',
+      scenario,
+      exists(projectRoot, scenario)
+        ? `${scenario} exists.`
+        : `${scenario} is missing.`,
+      { spawn: exists(projectRoot, scenario) ? null : 'god-auditor' }
+    );
+  }
+
+  return checks;
+}
+
 function releasePolicyChecks(projectRoot) {
   const checks = [];
   const docs = repoDocSync.detect(projectRoot);
@@ -393,6 +519,8 @@ function detect(projectRoot) {
     ...agentChecks(projectRoot),
     ...workflowRecipeChecks(projectRoot),
     ...extensionChecks(projectRoot),
+    ...suiteChecks(projectRoot),
+    ...dogfoodChecks(projectRoot),
     ...releasePolicyChecks(projectRoot),
     ...routeQualitySync.detect(projectRoot).checks,
     ...recipeCoverageSync.detect(projectRoot).checks,

package/lib/route-quality-sync.js

@@ -2,9 +2,8 @@
  * Route quality sync.
  *
  * Detects disconnected route automation surfaces: symbolic spawn tokens,
- * unresolved agent targets, contextual exits without an approved reason, and
- * composite flows that should be represented as primary plus secondary or
- * parallel spawns.
+ * unresolved agent targets, contextual exits without an approved reason,
+ * missing standards coverage, and agent-spawn routes without trace events.
  */
 
 const fs = require('fs');
@@ -141,14 +140,16 @@ function detect(projectRoot) {
   let unresolvedCount = 0;
   let contextualExitCount = 0;
   let standardsExemptCount = 0;
+  let traceEventMissingCount = 0;
 
   for (const routePath of routes) {
     const route = parseRoute(projectRoot, routePath);
     const command = route.metadata && route.metadata.command
       ? route.metadata.command
       : `/${path.basename(routePath, '.yaml')}`;
+    const tokens = spawnTokens(route);
 
-    for (const token of spawnTokens(route)) {
+    for (const token of tokens) {
       if (!isAtomicSpawn(String(token))) {
         symbolicCount++;
         addCheck(
@@ -174,6 +175,22 @@ function detect(projectRoot) {
       }
     }
 
+    const agentTokens = tokens
+      .map((token) => String(token))
+      .filter((token) => /^god-[a-z0-9-]+$/.test(token));
+    const events = arr(route.endoff && route.endoff.events).map((event) => String(event));
+    if (agentTokens.length > 0 && (!events.includes('agent.start') || !events.includes('agent.end'))) {
+      traceEventMissingCount++;
+      addCheck(
+        checks,
+        `missing-trace-events-${command.replace(/[^a-z0-9]+/gi, '-')}`,
+        'stale',
+        routePath,
+        `${command} spawns agents but does not declare both agent.start and agent.end trace events.`,
+        { spawn: 'god-auditor' }
+      );
+    }
+
     const next = route['success-path'] && route['success-path']['next-recommended'];
     const conditionalNext = route['success-path'] && arr(route['success-path']['conditional-next']);
     if (next === 'varies' && conditionalNext.length === 0) {
@@ -231,6 +248,16 @@ function detect(projectRoot) {
     `${standardsExemptCount} durable-writing routes have approved standards exemptions and all other writing routes declare standards.`,
     { spawn: checks.some((check) => check.id.startsWith('missing-standards-')) ? 'god-auditor' : null }
   );
+  addCheck(
+    checks,
+    'agent-trace-policy',
+    traceEventMissingCount === 0 ? 'fresh' : 'stale',
+    'routing/',
+    traceEventMissingCount === 0
+      ? 'All agent-spawning routes declare agent.start and agent.end trace events.'
+      : `${traceEventMissingCount} agent-spawning routes are missing required trace events.`,
+    { spawn: traceEventMissingCount === 0 ? null : 'god-auditor' }
+  );
 
   const stale = checks.filter((check) => check.status !== 'fresh');
   return {

package/lib/suite-state.js

@@ -143,6 +143,94 @@ function refreshFromRepos(hubPath) {
   return data;
 }
 
+function readPackageName(repoPath) {
+  const file = path.join(repoPath, 'package.json');
+  if (!fs.existsSync(file)) return path.basename(repoPath);
+  try {
+    const pkg = JSON.parse(fs.readFileSync(file, 'utf8'));
+    return pkg.name || path.basename(repoPath);
+  } catch (err) {
+    return path.basename(repoPath);
+  }
+}
+
+function readPackageDeps(repoPath) {
+  const file = path.join(repoPath, 'package.json');
+  if (!fs.existsSync(file)) return {};
+  try {
+    const pkg = JSON.parse(fs.readFileSync(file, 'utf8'));
+    return {
+      ...(pkg.dependencies || {}),
+      ...(pkg.devDependencies || {}),
+      ...(pkg.peerDependencies || {}),
+      ...(pkg.optionalDependencies || {})
+    };
+  } catch (err) {
+    return {};
+  }
+}
+
+function siblingRecords(hubPath) {
+  const config = detector.readSuiteConfig(hubPath);
+  if (!config) return [];
+  return (config.siblings || []).map((sib) => {
+    if (typeof sib === 'string') {
+      const repoPath = path.resolve(hubPath, sib);
+      return { name: sib, path: repoPath, packageName: readPackageName(repoPath) };
+    }
+    const repoPath = path.resolve(hubPath, sib.path || sib.name);
+    return { name: sib.name, path: repoPath, packageName: readPackageName(repoPath) };
+  });
+}
+
+function planRelease(hubPath, repoName, version, opts = {}) {
+  const siblings = siblingRecords(hubPath);
+  const target = siblings.find((repo) => repo.name === repoName || repo.packageName === repoName);
+  if (!target) {
+    return {
+      mode: 'dry-run',
+      status: 'blocked',
+      repo: repoName,
+      version,
+      impacted: [],
+      blockers: [`${repoName} is not registered in suite-config.yaml`],
+      writes: []
+    };
+  }
+
+  const impacted = [];
+  for (const repo of siblings) {
+    if (repo.name === target.name) continue;
+    const deps = readPackageDeps(repo.path);
+    if (Object.prototype.hasOwnProperty.call(deps, target.packageName)
+      || Object.prototype.hasOwnProperty.call(deps, target.name)) {
+      impacted.push({
+        name: repo.name,
+        packageName: repo.packageName,
+        path: repo.path,
+        dependsOn: target.packageName,
+        currentRange: deps[target.packageName] || deps[target.name]
+      });
+    }
+  }
+
+  return {
+    mode: opts.apply ? 'apply-plan' : 'dry-run',
+    status: 'ready',
+    repo: target.name,
+    packageName: target.packageName,
+    version,
+    impacted,
+    blockers: [],
+    writes: [
+      { path: path.join(target.path, 'package.json'), action: 'bump-version' },
+      ...impacted.map((repo) => ({ path: path.join(repo.path, 'package.json'), action: 'update-dependency-range' })),
+      { path: path.join(hubPath, '.godpowers', 'suite-config.yaml'), action: 'update-version-table' },
+      { path: suiteSyncLogPath(hubPath), action: 'append-release-plan' }
+    ]
+  };
+}
+
 /**
  * Write a human-readable STATE.md from the aggregate.
  */
@@ -216,5 +304,6 @@ module.exports = {
   writeSuiteState,
   refreshFromRepos,
   appendSyncLog,
-  format
+  format,
+  planRelease
 };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "godpowers",
-  "version": "1.6.20",
-  "description": "AI-powered development system: 109 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": "1.6.22",
+  "description": "AI-powered development system: 110 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"
   },
   "scripts": {
-    "test": "node scripts/validate-skills.js && node scripts/test-doc-surface-counts.js && bash scripts/smoke.sh && node scripts/test-runtime.js && node scripts/test-router.js && node scripts/test-recipes.js && node scripts/test-context-writer.js && node scripts/test-pillars.js && node scripts/test-artifact-linter.js && node scripts/test-artifact-diff.js && node scripts/test-design-foundation.js && node scripts/test-linkage.js && node scripts/test-impact.js && node scripts/test-reverse-sync.js && node scripts/test-planning-systems.js && node scripts/test-feature-awareness.js && node scripts/test-repo-doc-sync.js && node scripts/test-repo-surface-sync.js && node scripts/test-automation-surface-sync.js && node scripts/test-integration.js && node scripts/test-cross-artifact.js && node scripts/test-awesome-design.js && node scripts/test-skillui-bridge.js && node scripts/test-runtime-verification.js && node scripts/test-agent-browser.js && node scripts/test-mode-d.js && node scripts/test-runtime-heuristics.js && node scripts/test-agent-validator.js && node scripts/test-story-validator.js && node scripts/test-state.js && node scripts/test-dashboard.js && node scripts/test-automation-providers.js && node scripts/test-intent.js && node scripts/test-events.js && node scripts/test-golden-artifacts.js && node scripts/test-install-smoke.js && node scripts/test-checkpoint.js && node scripts/test-extensions.js && node scripts/test-event-reader.js && node scripts/test-state-lock.js && node scripts/test-cost-saver.js && node scripts/test-budget-onoff.js && node scripts/test-workflow-runner.js && npm run test:e2e && node scripts/test-otel-exporter.js && node scripts/test-extensions-publish.js",
+    "test": "node scripts/validate-skills.js && node scripts/test-doc-surface-counts.js && bash scripts/smoke.sh && node scripts/test-runtime.js && node scripts/test-router.js && node scripts/test-recipes.js && node scripts/test-context-writer.js && node scripts/test-pillars.js && node scripts/test-artifact-linter.js && node scripts/test-artifact-diff.js && node scripts/test-design-foundation.js && node scripts/test-linkage.js && node scripts/test-impact.js && node scripts/test-reverse-sync.js && node scripts/test-planning-systems.js && node scripts/test-feature-awareness.js && node scripts/test-repo-doc-sync.js && node scripts/test-repo-surface-sync.js && node scripts/test-automation-surface-sync.js && node scripts/test-host-capabilities.js && node scripts/test-extension-authoring.js && node scripts/test-dogfood-runner.js && node scripts/test-integration.js && node scripts/test-cross-artifact.js && node scripts/test-awesome-design.js && node scripts/test-skillui-bridge.js && node scripts/test-runtime-verification.js && node scripts/test-agent-browser.js && node scripts/test-mode-d.js && node scripts/test-runtime-heuristics.js && node scripts/test-agent-validator.js && node scripts/test-story-validator.js && node scripts/test-state.js && node scripts/test-dashboard.js && node scripts/test-automation-providers.js && node scripts/test-intent.js && node scripts/test-events.js && node scripts/test-golden-artifacts.js && node scripts/test-install-smoke.js && node scripts/test-checkpoint.js && node scripts/test-extensions.js && node scripts/test-event-reader.js && node scripts/test-state-lock.js && node scripts/test-cost-saver.js && node scripts/test-budget-onoff.js && node scripts/test-workflow-runner.js && npm run test:e2e && node scripts/test-otel-exporter.js && node scripts/test-extensions-publish.js",
     "prepublishOnly": "npm test",
     "validate-skills": "node scripts/validate-skills.js",
     "test:surface": "node scripts/test-doc-surface-counts.js",
@@ -74,6 +74,7 @@
     "workflows/",
     "schema/",
     "lib/",
+    "fixtures/",
     "extensions/",
     "INSPIRATION.md",
     "RELEASE.md",

package/routing/god-dogfood.yaml

@@ -0,0 +1,35 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-dogfood
+  description: Run messy-repo dogfood scenarios for release and autonomy readiness.
+  tier: 0
+
+prerequisites:
+  required: []
+
+execution:
+  spawns:
+    - built-in
+  secondary-spawns:
+    - god-greenfieldifier
+    - god-context-writer
+    - god-coordinator
+  context: current
+  writes: []
+
+success-path:
+  next-recommended: /god-status
+
+failure-path:
+  on-error: /god-repair
+  auto-spawn:
+    - god-greenfieldifier
+    - god-context-writer
+    - god-coordinator
+
+endoff:
+  state-update: none
+  events:
+    - agent.start
+    - agent.end

package/routing/god-init.yaml

@@ -35,5 +35,5 @@ failure-path:
 
 endoff:
   state-update: tier-0.orchestration.status = done
-  events: [orchestrator.spawn, artifact.created, agent.end]
+  events: [orchestrator.spawn, agent.start, artifact.created, agent.end]
   lifecycle-transition: pre-init -> in-arc

package/routing/god-roadmap-update.yaml

@@ -34,4 +34,4 @@ failure-path:
 
 endoff:
   state-update: tier-1.roadmap.updated timestamp
-  events: [artifact.updated, have-nots.check, agent.end]
+  events: [agent.start, artifact.updated, have-nots.check, agent.end]

package/routing/god-sync.yaml

@@ -30,4 +30,4 @@ failure-path:
 
 endoff:
   state-update: tier statuses updated based on what was synced
-  events: [artifact.updated, have-nots.check, agent.end]
+  events: [agent.start, artifact.updated, have-nots.check, agent.end]

package/skills/god-doctor.md

@@ -48,7 +48,7 @@ Plain-text report grouped by severity:
 GODPOWERS DOCTOR
 
 Install: claude (~/.claude/)
-  [OK] 109 skills installed
+  [OK] 110 skills installed
   [OK] 40 agents installed
   [OK] VERSION matches (1.6.6)
   [WARN] routing/god-doctor.yaml exists but skill file did not until now

package/skills/god-dogfood.md

@@ -0,0 +1,63 @@
+---
+name: god-dogfood
+description: |
+  Run built-in messy-repo dogfood scenarios against Godpowers automation,
+  migration, host capability, extension authoring, and suite release surfaces.
+
+  Triggers on: "god dogfood", "/god-dogfood", "dogfood godpowers",
+  "test messy repos", "real-project dogfooding"
+---
+
+# /god-dogfood
+
+Run deterministic messy-repo scenarios before release or after automation changes.
+
+## When To Use
+
+- [DECISION] Use `/god-dogfood` before a release when migration, host autonomy,
+  extension authoring, or Mode D suite release behavior changes.
+- [DECISION] Use `/god-dogfood` when a project already contains GSD, BMAD, or
+  Superpowers context and you need confidence that Godpowers can import and
+  sync back without deleting prior-system files.
+- [DECISION] Use `/god-dogfood` when host-spawn guarantees are unclear and the
+  dashboard reports degraded or unknown host capability.
+
+## Process
+
+1. Resolve the runtime root and load `lib/dogfood-runner.js`.
+2. Run `dogfood.runAll()` against `fixtures/dogfood/`.
+3. Report each scenario with pass or fail status.
+4. If any scenario fails, auto-invoke the matching specialist by visible card:
+   - `god-greenfieldifier` for planning-system import failures.
+   - `god-context-writer` for host capability or install surface failures.
+   - `god-coordinator` for extension authoring or suite release failures.
+5. Do not edit user projects while running fixture scenarios.
+6. End with the Godpowers Dashboard and make `/god-repair` the recommended
+   route when dogfood is red.
+
+## CLI Equivalent
+
+```bash
+npx godpowers dogfood
+npx godpowers dogfood --json
+```
+
+## Expected Coverage
+
+- [DECISION] The dogfood suite includes a half-migrated GSD project.
+- [DECISION] The dogfood suite includes degraded and full host capability
+  scenarios.
+- [DECISION] The dogfood suite includes extension scaffold validation.
+- [DECISION] The dogfood suite includes a Mode D suite release dry-run.
+
+## Auto-Invoke Card
+
+```text
+Auto-invoked:
+  Trigger: /god-dogfood scenario failure
+  Agent: <god-greenfieldifier | god-context-writer | god-coordinator | none, local runtime only>
+  Local syncs:
+    + dogfood-runner: <pass, fail, or skipped reason>
+  Artifacts: fixture-only unless repair is explicitly requested
+  Log: none
+```

package/skills/god-version.md

@@ -16,7 +16,7 @@ Print version and a short capability summary.
 ```
 Godpowers v1.6.19
 Install: /Users/.../.claude/  (matches package.json)
-Surface: 109 skills, 40 agents, 13 workflows, 40 recipes
+Surface: 110 skills, 40 agents, 13 workflows, 40 recipes
 Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1
 External integrations available: impeccable, agent-browser (others lazy)
 Feature awareness: planning-system migration, source-system sync-back, context refresh, dashboard status labels, repo documentation sync, repo surface sync