godpowers 1.6.20 → 1.6.22

package/CHANGELOG.md

@@ -7,6 +7,65 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.6.22] - 2026-05-16
+
+Dogfooding, host guarantees, extension authoring, and suite release dry-runs.
+
+### Added
+- Added `lib/dogfood-runner.js`, `/god-dogfood`, and `npx godpowers dogfood`
+  for deterministic messy-repo dogfood scenarios.
+- Added `fixtures/dogfood/` scenarios for half-migrated GSD import,
+  degraded and full host guarantees, extension scaffolding, and Mode D suite
+  release dry-run planning.
+- Added `lib/host-capabilities.js` and dashboard host guarantee reporting for
+  full, degraded, and unknown runtime capability states.
+- Added compact dashboard rendering with `npx godpowers status --brief`.
+- Added `lib/extension-authoring.js` and
+  `npx godpowers extension-scaffold --name=@scope/pack --output=.`.
+- Added Mode D suite release dry-run planning through
+  `suiteState.planRelease`.
+
+### Changed
+- Release-surface sync now requires dogfood, host capability, and extension
+  authoring test gates.
+- Repo-surface sync now checks dogfood runner presence, test wiring, and
+  required fixture manifests.
+- Package payload checks now include dogfood fixtures and the new runtime
+  helpers.
+- README, architecture, reference, release checklist, and runtime docs now
+  document dogfood, host guarantees, extension authoring, and suite dry-runs.
+
+### Guardrails
+- Dogfood runs copy fixtures into temporary directories before executing.
+- Host capability detection does not require network access.
+- Extension scaffolding does not overwrite existing files unless requested.
+- Suite release dry-runs return planned writes and impacted dependents without
+  mutating sibling repositories.
+
+## [1.6.21] - 2026-05-16
+
+Dashboard compression, trace guardrails, and suite release readiness.
+
+### Added
+- Added dashboard action briefs so `/god-status`, `/god-next`, and CLI status
+  output show the recommended command, reason, readiness, and top blockers
+  before the detailed check list.
+- Added release-surface checks that verify dogfood, extension publish, Mode D
+  suite, and installer smoke tests remain wired into the release gate.
+- Added repo-surface suite readiness checks for Mode D helper, docs, tests,
+  and suite command route coverage.
+
+### Changed
+- Route-quality sync now requires every agent-spawning route to declare both
+  `agent.start` and `agent.end` trace events.
+- `/god-init`, `/god-roadmap-update`, and `/god-sync` route metadata now
+  declare the missing `agent.start` trace event.
+
+### Guardrails
+- Spawn observability, release dogfooding, extension readiness, suite
+  readiness, and onboarding compression are now checked by executable tests
+  instead of remaining documentation-only goals.
+
 ## [1.6.20] - 2026-05-16
 
 Automation surface closeout and release guardrails.

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.6.20-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.6.22-blue)](CHANGELOG.md)
 [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
 
 **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -12,11 +12,15 @@ idea to hardened production. It runs as **slash commands inside your AI coding
 tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
 in fresh contexts to do the work.
 
-Version 1.6.20 closes the automation surface gaps around route quality, recipe
-coverage, and release readiness. Godpowers now checks symbolic route spawns,
-unresolved agent targets, standards coverage for durable-writing routes, missing
-high-frequency recipes, package payload guards, and release-facing version drift
-before closeout.
+Version 1.6.22 turns the last "needs more outside use" gaps into executable
+surface area. Godpowers now ships a messy-repo dogfood runner, dashboard host
+guarantee reporting, compact dashboard output, extension scaffolding, and
+Mode D suite release dry-run planning.
+
+The dashboard now starts with an action brief and a host guarantee line: the
+next command, why it is recommended, whether the project is ready, the first
+blockers that need attention, and whether the current host can provide full,
+degraded, or unknown runtime guarantees.
 
 It fuses four disciplines into one unified workflow:
 
@@ -107,8 +111,8 @@ You can also ask any time:
 ```
 
 This reads `.godpowers/PROGRESS.md`, scans disk, reconciles any drift, and
-suggests the next logical command. The SessionStart hook does the same thing
-when you open a new session in a Godpowers project.
+suggests the next logical command with a compact action brief. The SessionStart
+hook does the same thing when you open a new session in a Godpowers project.
 
 The same status engine is available from the installer CLI for humans, CI,
 Codex, Claude, Cursor, Gemini, OpenCode, Windsurf, Antigravity, and any host
@@ -117,7 +121,10 @@ runtime that can execute Node:
 ```bash
 npx godpowers status --project=.
 npx godpowers next --project=.
+npx godpowers status --project=. --brief
 npx godpowers status --project=. --json
+npx godpowers dogfood
+npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.
 ```
 
 ### Slash Commands
@@ -142,6 +149,7 @@ npx godpowers status --project=. --json
 | `/god-status` | Re-derive state from disk | (built-in) |
 | `/god-automation-status` | Show host automation provider support | (built-in) |
 | `/god-automation-setup` | Prepare opt-in automation setup | (built-in) |
+| `/god-dogfood` | Run messy-repo dogfood scenarios for release and autonomy readiness | (built-in) |
 | `/god-migrate` | Detect GSD, BMAD, and Superpowers context; import and sync back | god-greenfieldifier when needed |
 | `/god-preflight` | Read-only intake audit before project-run readiness and pillars | god-auditor |
 | `/god-audit` | Score artifacts against have-nots | god-auditor |
@@ -209,6 +217,17 @@ npx godpowers automation-status --project=.
 npx godpowers automation-setup --project=.
 ```
 
+Godpowers can dogfood itself against shipped messy-repo fixtures:
+
+```bash
+npx godpowers dogfood
+```
+
+The dogfood suite covers a half-migrated GSD project, full and degraded host
+guarantee detection, extension scaffold validation, and a Mode D suite release
+dry-run. `/god-dogfood` reports failures with scoped specialist ownership
+rather than treating fixture checks as silent background work.
+
 Automation setup is opt-in. The installer does not create schedules, routines,
 background agents, API triggers, or CI workflows. Safe starting templates are
 read-only status, checkpoint, review queue, hygiene, and release readiness
@@ -359,7 +378,7 @@ Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
 
 - [Getting Started](docs/getting-started.md)
 - [Concepts](docs/concepts.md)
-- [Command reference (all 109 skills + 40 agents)](docs/reference.md)
+- [Command reference (all 110 skills + 40 agents)](docs/reference.md)
 - [Feature awareness](docs/feature-awareness.md)
 - [Repository documentation sync](docs/repo-doc-sync.md)
 - [Repository surface sync](docs/repo-surface-sync.md)

package/RELEASE.md

@@ -1,16 +1,15 @@
-# Godpowers 1.6.20 Release
+# Godpowers 1.6.22 Release
 
 Date: 2026-05-16
 
-Godpowers 1.6.20 closes the automation gaps found after repository surface
-sync. It adds dedicated route-quality, recipe-coverage, and release-surface
-checks so Godpowers detects disconnected route spawns, missing intent recipes,
-and stale release-facing documentation before declaring a project or release
-current.
+Godpowers 1.6.22 turns the remaining "needs more real use" risks into
+executable surfaces. It adds deterministic messy-repo dogfooding, dashboard
+host guarantees, compact status output, extension authoring scaffolds, and
+Mode D suite release dry-run planning.
 
 ## What is stable
 
-- 109 slash commands
+- 110 slash commands
 - 40 specialist agents
 - 13 executable workflows
 - 40 intent recipes
@@ -28,21 +27,25 @@ current.
 - Repository documentation sync checks
 - Repository surface sync checks
 - Route quality, recipe coverage, and release surface sync checks
+- Dashboard action briefs for next-step compression
+- Dashboard host guarantees for full, degraded, and unknown runtime capability
+- Agent-spawn trace event guardrails
+- Mode D suite readiness checks
+- Messy-repo dogfood scenarios
+- Extension authoring scaffold helper
+- Mode D suite release dry-run planner
 
 ## What is new
 
-- Added `lib/route-quality-sync.js`.
-- Added `lib/recipe-coverage-sync.js`.
-- Added `lib/release-surface-sync.js`.
-- Added `scripts/test-automation-surface-sync.js`.
-- Added release maintenance, context refresh, story work, and automation setup
-  recipes.
-- `/god-party` now declares concrete parallel specialist personas.
-- `/god-story-build` now declares planner, executor, and reviewer handoffs
-  without symbolic spawn tokens.
-- Feature awareness now records route quality, recipe coverage, and release
-  surface sync as known runtime features.
-- Package contents checks now require all three new sync helpers.
+- Added `lib/dogfood-runner.js`, `/god-dogfood`, and CLI `dogfood`.
+- Added dogfood fixtures for half-migrated GSD import and sync-back, full and
+  degraded host guarantees, extension scaffold validation, and suite release
+  dry-run planning.
+- Added `lib/host-capabilities.js` and dashboard host guarantee reporting.
+- Added compact dashboard output through `--brief`.
+- Added `lib/extension-authoring.js` and CLI `extension-scaffold`.
+- Added `suiteState.planRelease` for Mode D dependent impact planning before
+  mutation.
 
 ## Automation surface behavior
 
@@ -50,12 +53,18 @@ For a Godpowers repository, the helper checks:
 
 - every routed specialist spawn resolves to a real agent or built-in runtime
   owner
+- every agent-spawning route declares `agent.start` and `agent.end`
 - every durable-writing route declares standards coverage or an approved
   exemption
 - high-frequency work has discoverable intent recipes
 - release-facing version surfaces agree with `package.json`
 - package content checks require load-bearing runtime helper files
 - release checklist policy names the current sync guards
+- release gates include dogfood, extension publish, Mode D suite, and installer
+  smoke checks
+- dogfood fixtures cover migration, host guarantees, extension authoring, and
+  suite release dry-runs
+- host guarantees are visible in dashboard and compact dashboard output
 
 Detection is read-only by default. Applying sync writes logs and leaves
 judgment-heavy rewrites to scoped specialists.
@@ -74,16 +83,24 @@ Godpowers recommends scoped specialists only when judgment is needed:
 - `god-roadmap-reconciler` for workflow or recipe lifecycle drift
 - `god-coordinator` for extension pack drift
 - `god-docs-writer` for release prose drift
+- `god-greenfieldifier` for dogfood migration failures
+- `god-context-writer` for host capability failures
 
 ## Validation
 
 Release validation includes:
 
+- `node scripts/test-dogfood-runner.js`
+- `node scripts/test-host-capabilities.js`
+- `node scripts/test-extension-authoring.js`
 - `node scripts/test-repo-surface-sync.js`
 - `node scripts/test-automation-surface-sync.js`
 - `node scripts/test-repo-doc-sync.js`
 - `node scripts/test-feature-awareness.js`
 - `node scripts/test-dashboard.js`
+- `node scripts/test-mode-d.js`
+- `node scripts/test-extensions-publish.js`
+- `node scripts/test-install-smoke.js`
 - `node scripts/test-context-writer.js`
 - `node scripts/test-planning-systems.js`
 - `node scripts/test-doc-surface-counts.js`
@@ -91,5 +108,5 @@ Release validation includes:
 - `git diff --check`
 - `npm run release:check`
 
-The `v1.6.20` tag should point to the release commit that matches the npm
-`godpowers@1.6.20` package.
+The `v1.6.22` tag should point to the release commit that matches the npm
+`godpowers@1.6.22` package.

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/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