godpowers 1.6.21 → 1.6.23

package/agents/god-updater.md

@@ -4,8 +4,9 @@ description: |
   After feature work, syncs all affected artifacts: PRD (add requirement),
   ARCH (add ADR/delta), ROADMAP (mark progress, append entries), STACK
   (add deps), DEPLOY/OBSERVE/HARDEN/LAUNCH (note new surface), TODOS
-  (resolve superseded), THREADS (update). Re-validates have-nots after
-  each update.
+  (resolve superseded), THREADS (update), repository documentation, runtime
+  feature awareness, source-system sync-back, host capability notes, and
+  repository surface checks. Re-validates have-nots after each update.
 
   Spawned by: /god-sync, end of feature-addition recipe execution
 tools: Read, Write, Edit, Bash, Grep, Glob, Task
@@ -20,6 +21,9 @@ After feature work, every artifact that was impacted needs to reflect reality.
 - The reconciliation verdict (from god-reconciler) showing which artifacts changed
 - Description of what was just done (commits, slice plans, etc.)
 - Project root
+- Changed files, when the caller can provide them
+- Trigger type: manual `/god-sync`, closeout from `/god-mode`, release work,
+  migration import, hotfix, or docs-only sync
 
 ## Operations (per artifact, conditional)
 
@@ -118,6 +122,74 @@ After feature work, every artifact that was impacted needs to reflect reality.
   - drift findings
   - REVIEW-REQUIRED.md items created
 
+### Repository documentation sync
+- Call `lib/repo-doc-sync.run(projectRoot, { changedFiles })` when the runtime
+  is available. Use detect-only mode when the caller is in read-only audit mode.
+- Safe mechanical fixes may update version badges, package description counts,
+  README command counts, reference counts, and shipped-version markers.
+- Narrative drift in release notes, changelog, contribution policy, security
+  policy, or support docs must spawn or recommend `god-docs-writer`.
+- Emit or preserve the local log at `.godpowers/docs/REPO-DOC-SYNC.md`.
+- Report:
+  - status: fresh, stale, applied, or skipped
+  - safe fixes applied
+  - narrative paths requiring a docs writer
+  - Pillars sync plan count when touched docs affect portable context
+
+### Repository surface sync
+- Call `lib/repo-surface-sync.run(projectRoot, { changedFiles })` when the
+  runtime is available.
+- This checks routing, package file entries, package content checks, agent
+  contracts, workflow metadata, recipe coverage, extension publish readiness,
+  route quality, release surface, and repository documentation drift.
+- Safe local fixes may write missing routing stubs only when explicitly allowed
+  by the caller.
+- Emit or preserve the local log at `.godpowers/surface/REPO-SURFACE-SYNC.md`.
+- Report:
+  - status: fresh, stale, applied, or skipped
+  - stale checks by area
+  - spawn recommendations
+  - whether route, recipe, release, and documentation sub-checks were fresh
+
+### Runtime feature awareness
+- Call `lib/feature-awareness.run(projectRoot)` for existing `.godpowers`
+  projects when the runtime is available.
+- Record the installed runtime version, the current feature-set version, and
+  known feature IDs into `.godpowers/state.json`.
+- Refresh AI-tool context fences only through `god-context-writer` or
+  `lib/context-writer.js`; do not hand-edit outside managed fences.
+- If low-confidence imported planning systems or sync-back conflicts are
+  detected, spawn or recommend `god-greenfieldifier`.
+- Report:
+  - runtime version
+  - missing features before refresh
+  - whether state changed
+  - context files refreshed or skipped
+
+### Source-system sync-back
+- Call `lib/source-sync.run(projectRoot)` when `.godpowers/state.json`
+  declares GSD, BMAD, Superpowers, or other source-system records.
+- Write only managed Godpowers summary sections back to source systems.
+- Preserve user-authored source-system content outside managed sections.
+- If source-system confidence is low or conflicts are present, recommend
+  `god-greenfieldifier` before writing.
+- Report:
+  - source systems found
+  - summaries written, unchanged, skipped, or blocked
+  - conflict count
+
+### Host capability and dashboard refresh
+- Call `lib/host-capabilities.detect(projectRoot)` when available and include
+  the guarantee level in closeouts.
+- Call `lib/dashboard.compute(projectRoot)` and `lib/dashboard.render(result)`
+  for user-facing status when available.
+- Treat host guarantee gaps as visible runtime facts, not fatal failures.
+- Report:
+  - host name
+  - guarantee level: full, degraded, or unknown
+  - top gap, when present
+  - dashboard readiness and attention line
+
 ### Pillars sync (native context)
 - Call `lib/pillars.pillarizeExisting(projectRoot)` if Pillars is absent or
   partial.
@@ -171,6 +243,11 @@ Sync status:
 - Pillars sync: [applied/proposed/no-op/skipped], [N] pillar files
 - Checkpoint sync: [created/updated/no-op/skipped] .godpowers/CHECKPOINT.md
 - Context refresh: [spawned god-context-writer/no-op/skipped], [N] files
+- Repo docs sync: [fresh/applied/stale/skipped], [N] safe fixes, [N] docs-writer paths
+- Repo surface sync: [fresh/applied/stale/skipped], [N] stale checks, [N] spawn recommendations
+- Feature awareness: [fresh/applied/skipped], runtime [version], [N] new features recorded
+- Source sync-back: [written/unchanged/blocked/skipped], [N] source systems
+- Host capabilities: [full/degraded/unknown], [top gap or none]
 
 Updated:
 - prd/PRD.md: added requirement P-MUST-12
@@ -201,8 +278,13 @@ Sync status:
   Local syncs:
     + reverse-sync: <counts and result>
     + pillars-sync: <counts and result>
+    + repo-doc-sync: <fresh, applied, stale, or skipped>
+    + repo-surface-sync: <fresh, applied, stale, or skipped>
+    + feature-awareness: <fresh, applied, or skipped>
+    + source-sync-back: <written, unchanged, blocked, or skipped>
     + checkpoint-sync: <created, updated, no-op, or skipped>
     + context-refresh: <spawned, no-op, or skipped>
+    + host-capabilities: <full, degraded, or unknown>
   Artifacts: <changed files or no-op>
   Log: .godpowers/SYNC-LOG.md
 

package/bin/install.js

@@ -303,6 +303,12 @@ function parseArgs(argv) {
     command: null,
     project: process.cwd(),
     json: false,
+    brief: false,
+    extensionName: null,
+    extensionOutput: process.cwd(),
+    extensionSkill: null,
+    extensionAgent: null,
+    extensionWorkflow: null,
     runtimes: [],
     global: false,
     local: false,
@@ -318,11 +324,16 @@ function parseArgs(argv) {
       case 'next':
       case 'automation-status':
       case 'automation-setup':
+      case 'dogfood':
+      case 'extension-scaffold':
         opts.command = arg;
         break;
       case '--json':
         opts.json = true;
         break;
+      case '--brief':
+        opts.brief = true;
+        break;
       case '--project':
         if (args[i + 1]) {
           opts.project = path.resolve(args[i + 1]);
@@ -351,6 +362,16 @@ function parseArgs(argv) {
       default:
         if (arg.startsWith('--project=')) {
           opts.project = path.resolve(arg.slice('--project='.length));
+        } else if (arg.startsWith('--name=')) {
+          opts.extensionName = arg.slice('--name='.length);
+        } else if (arg.startsWith('--output=')) {
+          opts.extensionOutput = path.resolve(arg.slice('--output='.length));
+        } else if (arg.startsWith('--skill=')) {
+          opts.extensionSkill = arg.slice('--skill='.length);
+        } else if (arg.startsWith('--agent=')) {
+          opts.extensionAgent = arg.slice('--agent='.length);
+        } else if (arg.startsWith('--workflow=')) {
+          opts.extensionWorkflow = arg.slice('--workflow='.length);
         } else if (arg.startsWith('--') && RUNTIMES[arg.slice(2)]) {
           opts.runtimes.push(arg.slice(2));
         }
@@ -575,10 +596,18 @@ function showHelp() {
   log('  next                 Show the dashboard and recommended next command');
   log('  automation-status    Show host automation provider support');
   log('  automation-setup     Show an opt-in automation setup plan');
+  log('  dogfood              Run built-in messy-repo dogfood scenarios');
+  log('  extension-scaffold   Create a publishable extension pack skeleton');
   log('');
   log('Options:');
   log('  --project=<path>     Project root for status, next, or automation commands');
   log('  --json               Emit JSON for status, next, or automation commands');
+  log('  --brief              Render a compact dashboard for status or next');
+  log('  --name=<scope/name>  Extension package name for extension-scaffold');
+  log('  --output=<path>      Extension output root for extension-scaffold');
+  log('  --skill=<name>       Extension skill name for extension-scaffold');
+  log('  --agent=<name>       Extension agent name for extension-scaffold');
+  log('  --workflow=<name>    Extension workflow name for extension-scaffold');
   log('  -g, --global         Install globally (to config directory)');
   log('  -l, --local          Install locally (to current directory)');
   log('  --claude             Install for Claude Code');
@@ -605,6 +634,8 @@ function showHelp() {
   log('  npx godpowers next --project=.');
   log('  npx godpowers automation-status --project=.');
   log('  npx godpowers automation-setup --project=.');
+  log('  npx godpowers dogfood');
+  log('  npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.');
   log('  npx godpowers --claude --global');
   log('  npx godpowers --all');
   log('  npx godpowers --codex --cursor');
@@ -630,7 +661,7 @@ function runDashboardCommand(opts) {
   if (opts.json) {
     console.log(JSON.stringify(result, null, 2));
   } else {
-    console.log(dashboard.render(result));
+      console.log(dashboard.render(result, { brief: opts.brief }));
     if (opts.command === 'next') {
       console.log('');
       console.log('Suggested next command:');
@@ -639,6 +670,45 @@ function runDashboardCommand(opts) {
   }
 }
 
+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 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));
+  } else {
+    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');
+    }
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
@@ -661,6 +731,16 @@ function main() {
     return;
   }
 
+  if (opts.command === 'dogfood') {
+    runDogfoodCommand(opts);
+    return;
+  }
+
+  if (opts.command === 'extension-scaffold') {
+    runExtensionScaffoldCommand(opts);
+    return;
+  }
+
   console.log(BANNER);
 
   const srcDir = path.resolve(__dirname, '..');

package/fixtures/dogfood/extension-authoring/manifest.json

@@ -0,0 +1,13 @@
+{
+  "name": "Extension authoring scaffold",
+  "kind": "extension-authoring",
+  "extensionName": "@godpowers/dogfood-pack",
+  "expectedFiles": [
+    "manifest.yaml",
+    "package.json",
+    "README.md",
+    "skills/god-dogfood-extension.md",
+    "agents/god-dogfood-agent.md",
+    "workflows/dogfood-workflow.yaml"
+  ]
+}

package/fixtures/dogfood/half-migrated-gsd/.planning/PROJECT.md

@@ -0,0 +1,5 @@
+# Project
+
+## Users
+
+- [ ] Operators need a planning import that keeps prior state visible.

package/fixtures/dogfood/half-migrated-gsd/.planning/REQUIREMENTS.md

@@ -0,0 +1,5 @@
+# Requirements
+
+## Functional Requirements
+
+- [ ] Import prior requirements into Godpowers preparation context.

package/fixtures/dogfood/half-migrated-gsd/.planning/ROADMAP.md

@@ -0,0 +1,5 @@
+# Roadmap
+
+## Phase 1
+
+- [ ] Migrate the project without deleting GSD files.

package/fixtures/dogfood/half-migrated-gsd/manifest.json

@@ -0,0 +1,16 @@
+{
+  "name": "Half migrated GSD project",
+  "kind": "planning-migration",
+  "actions": [
+    "import-planning-context",
+    "sync-back"
+  ],
+  "expectedSystems": [
+    "gsd"
+  ],
+  "expectedFiles": [
+    ".godpowers/prep/IMPORTED-CONTEXT.md",
+    ".godpowers/prd/PRD.md",
+    ".planning/GODPOWERS-SYNC.md"
+  ]
+}

package/fixtures/dogfood/host-degraded/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "Host guarantee degraded mode",
+  "kind": "host-capabilities",
+  "expectedLevel": "degraded"
+}

package/fixtures/dogfood/host-full/home/.codex/agents/god-orchestrator.toml

@@ -0,0 +1,2 @@
+name = "god-orchestrator"
+description = "Fixture agent metadata."

package/fixtures/dogfood/host-full/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "Host guarantee full mode",
+  "kind": "host-capabilities",
+  "expectedLevel": "full"
+}

package/fixtures/dogfood/suite-release-dry-run/.godpowers/suite-config.yaml

@@ -0,0 +1,9 @@
+name: dogfood-suite
+siblings:
+  - repo-a
+  - repo-b
+version-table:
+  repo-a:
+    repo-a: 1.2.3
+  repo-b:
+    repo-b: 1.2.3

package/fixtures/dogfood/suite-release-dry-run/manifest.json

@@ -0,0 +1,7 @@
+{
+  "name": "Mode D suite release dry-run",
+  "kind": "suite-release",
+  "repo": "repo-a",
+  "version": "1.2.4",
+  "expectedImpacted": 1
+}

package/fixtures/dogfood/suite-release-dry-run/repo-a/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "repo-a",
+  "version": "1.2.3"
+}

package/fixtures/dogfood/suite-release-dry-run/repo-b/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "repo-b",
+  "version": "1.2.3",
+  "dependencies": {
+    "repo-a": "^1.2.3"
+  }
+}

package/hooks/pre-tool-use.sh

@@ -1,7 +1,8 @@
 #!/usr/bin/env bash
 # Godpowers PreToolUse Safety Hook
 # Runs before destructive tool calls in a Godpowers project.
-# Warns on: rm -rf, git reset --hard, force push to main, deleting .godpowers/
+# Warns on: rm -rf, git reset --hard, force push to main, deleting .godpowers/,
+# and irreversible public release actions.
 
 set -euo pipefail
 
@@ -31,6 +32,17 @@ case "$TOOL_INPUT" in
     echo "destroy collaborators' work."
     exit 1
     ;;
+  *"npm publish"*)
+    echo "WARNING: npm publish is a public release action."
+    echo "Confirm release checklist, repo-doc-sync, repo-surface-sync,"
+    echo "release-surface-sync, package contents, and installer smoke first."
+    exit 1
+    ;;
+  *"gh release create"*)
+    echo "WARNING: gh release create publishes public release notes."
+    echo "Confirm README, badges, CHANGELOG, RELEASE, package, tag, and npm version agree."
+    exit 1
+    ;;
   *"rm -rf node_modules"*)
     # Allowed: this is just cache
     exit 0

package/hooks/session-start.sh

@@ -30,6 +30,17 @@ cat <<'EOF'
 A Godpowers project is active in this directory.
 EOF
 
+# Prefer the shared dashboard action brief when the installed CLI is available.
+# This keeps hook orientation aligned with /god-status and /god-next.
+if command -v godpowers >/dev/null 2>&1; then
+  BRIEF="$(godpowers status --project . --brief 2>/dev/null | head -30 || true)"
+  if [ -n "$BRIEF" ]; then
+    echo ""
+    echo "$BRIEF"
+    echo ""
+  fi
+fi
+
 # Prefer CHECKPOINT.md (the orient-a-new-session pin) when present
 if [ -f "$CHECKPOINT_FILE" ]; then
   echo ""
@@ -69,6 +80,7 @@ Next step: run /god-next  (it inspects disk state and proposes the next command)
 Or:       /god-mode for the full autonomous project run
 Or:       /god-help to see the catalog
 Or:       /god-status for the full project snapshot
+Or:       /god-context refresh after installing a newer Godpowers runtime
 
 Disk state is authoritative. Conversation memory is not.
 EOF

package/lib/README.md

@@ -13,11 +13,13 @@ package-level integrations.
 | `intent.js` | Read and validate `intent.yaml` from project roots or `.godpowers/`. |
 | `checkpoint.js` | Create and inspect resumable checkpoint artifacts. |
 | `feature-awareness.js` | Detect and refresh existing-project awareness after runtime upgrades. |
+| `host-capabilities.js` | Detect host guarantees for shell, git, npm, agent spawning, extension authoring, and suite dry-runs. |
 | `repo-doc-sync.js` | Detect and refresh mechanical repository documentation surfaces. |
 | `repo-surface-sync.js` | Detect structural drift across commands, routes, packages, agents, workflows, recipes, extensions, and release policy. |
 | `route-quality-sync.js` | Detect symbolic route spawns, unresolved agent targets, and unapproved contextual route exits. |
 | `recipe-coverage-sync.js` | Detect missing high-frequency intent recipe coverage. |
 | `release-surface-sync.js` | Detect release-facing drift across badges, release notes, changelog, package checks, and release checklist policy. |
+| `dogfood-runner.js` | Run deterministic messy-repo scenarios against migration, host, extension, and suite release behavior. |
 | `budget.js` | Read and enforce configured budget controls. |
 | `cost-tracker.js` | Track token and cost estimates from event streams. |
 
@@ -68,6 +70,7 @@ package-level integrations.
 | `skillui-bridge.js` | Bridge skill metadata into UI surfaces. |
 | `impeccable-bridge.js` | Bridge runtime checks into impeccable quality workflows. |
 | `extensions.js` | Load and validate extension packs. |
+| `extension-authoring.js` | Scaffold publishable extension packs with manifest, package, README, skill, agent, and workflow files. |
 
 ## Repository and graph helpers
 

package/lib/dashboard.js

@@ -14,6 +14,7 @@ const router = require('./router');
 const automationProviders = require('./automation-providers');
 const repoDocSync = require('./repo-doc-sync');
 const repoSurfaceSync = require('./repo-surface-sync');
+const hostCapabilities = require('./host-capabilities');
 
 const GOD_DIR = '.godpowers';
 const PRD_PATH = '.godpowers/prd/PRD.md';
@@ -168,6 +169,7 @@ function proactiveChecks(projectRoot, changedFiles = []) {
   const repoSurfaceStatus = repoSurface.status === 'fresh'
     ? 'fresh'
     : `${repoSurface.stale.length} stale, suggest /god-doctor`;
+  const host = hostCapabilities.detect(projectRoot);
 
   return {
     checkpoint,
@@ -175,6 +177,7 @@ function proactiveChecks(projectRoot, changedFiles = []) {
     sync,
     docs: repoDocsStatus,
     repoSurface: repoSurfaceStatus,
+    host: hostCapabilities.summary(host),
     runtime: 'not-applicable',
     automation: automationSummary(projectRoot),
     security: sensitiveChanged ? 'sensitive files changed, suggest /god-harden' : 'clear',
@@ -234,6 +237,7 @@ function compute(projectRoot, opts = {}) {
         completionBasis: 'missing .godpowers/state.json'
       },
       proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+      host: hostCapabilities.detect(projectRoot, opts.host || {}),
       next,
       openItems: ['No .godpowers/state.json found']
     };
@@ -263,6 +267,7 @@ function compute(projectRoot, opts = {}) {
     index: git.index,
     planning: planningVisibility(projectRoot, progress),
     proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+    host: hostCapabilities.detect(projectRoot, opts.host || {}),
     next,
     openItems
   };
@@ -277,6 +282,7 @@ function actionBrief(dashboard) {
   for (const [label, value] of [
     ['Repo surface', proactive.repoSurface],
     ['Docs', proactive.docs],
+    ['Host', proactive.host],
     ['Reviews', proactive.reviews],
     ['Sync', proactive.sync],
     ['Security', proactive.security],
@@ -285,6 +291,7 @@ function actionBrief(dashboard) {
   ]) {
     if (!value) continue;
     if (value === 'fresh' || value === 'none' || value === 'clear' || value === 'not-applicable') continue;
+    if (/^full on /.test(value)) continue;
     if (/^available via /.test(value)) continue;
     blockers.push(`${label}: ${value}`);
   }
@@ -299,7 +306,7 @@ function actionBrief(dashboard) {
   };
 }
 
-function render(dashboard) {
+function render(dashboard, opts = {}) {
   const current = dashboard.current || {};
   const planning = dashboard.planning || {};
   const proactive = dashboard.proactive || {};
@@ -311,6 +318,26 @@ function render(dashboard) {
     ? dashboard.openItems
     : ['none'];
   const brief = dashboard.actionBrief || actionBrief(dashboard);
+  if (opts.mode === 'brief' || opts.brief === true) {
+    return [
+      'Godpowers Dashboard',
+      '',
+      'Action brief:',
+      `  Next: ${brief.recommended}`,
+      `  Why: ${brief.reason}`,
+      `  Readiness: ${brief.confidence}`,
+      `  Attention: ${brief.blockers && brief.blockers.length > 0 ? brief.blockers.join('; ') : 'none'}${brief.overflow ? `; ${brief.overflow} more` : ''}`,
+      `  Host guarantees: ${dashboard.host ? hostCapabilities.summary(dashboard.host) : proactive.host || 'unknown'}`,
+      '',
+      'Current status:',
+      `  State: ${dashboard.state}`,
+      `  Progress: ${progress.percent || 0}% workflow progress (${progress.completed || 0} of ${progress.total || 0} tracked steps complete)`,
+      '',
+      'Next:',
+      `  Recommended: ${next.command || 'describe the next intent'}`,
+      `  Why: ${next.reason || 'No route was computed.'}`
+    ].join('\n');
+  }
 
   return [
     'Godpowers Dashboard',
@@ -330,6 +357,7 @@ function render(dashboard) {
     `  Why: ${brief.reason}`,
     `  Readiness: ${brief.confidence}`,
     `  Attention: ${brief.blockers && brief.blockers.length > 0 ? brief.blockers.join('; ') : 'none'}${brief.overflow ? `; ${brief.overflow} more` : ''}`,
+    `  Host guarantees: ${dashboard.host ? hostCapabilities.summary(dashboard.host) : proactive.host || 'unknown'}`,
     '',
     'Planning visibility:',
     `  PRD: ${prd.status || 'missing'}${prd.path ? ` ${prd.path}` : ''}`,
@@ -343,6 +371,7 @@ function render(dashboard) {
     `  Sync: ${proactive.sync || 'unknown'}`,
     `  Docs: ${proactive.docs || 'unknown'}`,
     `  Repo surface: ${proactive.repoSurface || 'unknown'}`,
+    `  Host: ${proactive.host || 'unknown'}`,
     `  Runtime: ${proactive.runtime || 'unknown'}`,
     `  Automation: ${proactive.automation || 'unknown'}`,
     `  Security: ${proactive.security || 'unknown'}`,