godpowers 1.6.19 → 1.6.21

package/AGENTS.md

@@ -37,11 +37,34 @@ projects from raw idea to hardened production.
 - Every claim must fail the substitution test (swap in a competitor, sentence must break)
 
 <!-- pillars:begin -->
-## Godpowers Pillars Protocol
+# Godpowers Project Context
 
-- [DECISION] Load `agents/context.md` and `agents/repo.md` before Godpowers commands make durable project decisions.
-- [DECISION] Load additional `agents/*.md` pillar files only when their frontmatter matches the task.
-- [DECISION] Treat `.godpowers/state.json`, `.godpowers/PROGRESS.md`, and `.godpowers/CHECKPOINT.md` as workflow state.
-- [DECISION] Treat Pillars files as portable project context for any coding agent that opens this repository.
-- [DECISION] Disk state wins over conversation memory when these sources disagree.
+This is a Godpowers project. Godpowers uses the Pillars standard as its native project context layer.
+Coding agents read project context from `./agents/*.md` before changing code, while `.godpowers/` remains the Godpowers workflow state and artifact layer.
+
+## At the start of any task
+
+1. Load every pillar whose frontmatter has `always_load: true`.
+2. Scan remaining pillar frontmatter and select task-relevant primaries from `triggers` and `covers`.
+3. Add each primary pillar direct `must_read_with` dependencies, depth 1 only.
+4. Read every pillar body in the computed load set.
+5. Read `see_also` pillars only when the task explicitly touches that area.
+6. Follow Rules, apply Workflows, heed Watchouts, and ask before deciding open Gaps.
+
+## Handling missing pillars
+
+| State | Action |
+|---|---|
+| `status: present` | Load and comply. |
+| `status: stub` | Treat the concern as acknowledged but undecided. Ask before making domain decisions. |
+| Name in `excluded:` | Treat as intentionally not applicable. |
+| Relevant but absent | Infer from code, state the assumption, and recommend authoring the pillar. |
+
+If `context.md` or `repo.md` is missing, pause and create stubs before continuing.
+
+## Excluded pillars
+
+```yaml
+excluded: []
+```
 <!-- pillars:end -->

package/CHANGELOG.md

@@ -5,6 +5,66 @@ All notable changes to Godpowers will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [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.
+
+### Added
+- Added `lib/route-quality-sync.js` to detect symbolic route spawns,
+  unresolved agent targets, and unapproved contextual route exits.
+- Added `lib/recipe-coverage-sync.js` to detect missing high-frequency intent
+  recipes for release maintenance, docs drift, context refresh, story work, and
+  automation setup.
+- Added `lib/release-surface-sync.js` to detect release-facing drift across
+  badges, changelog, release notes, package guards, release checklist policy,
+  and package lock version.
+- Added recipe routes for release maintenance, context refresh, story work, and
+  automation setup.
+
+### Changed
+- `/god-party` routing now uses `built-in` as the primary owner and declares
+  selectable specialist personas under `parallel-spawns`.
+- `/god-story-build` routing now uses `god-planner` as primary and declares
+  executor plus reviewer agents as secondary spawns.
+- `lib/router.js` now includes conditional `parallel-spawns` in spawned-agent
+  resolution.
+- Repo surface sync now includes route-quality, recipe-coverage, and
+  release-surface checks.
+
+### Guardrails
+- Route quality checks now block symbolic spawn tokens, unresolved specialist
+  targets, unapproved contextual exits, and durable-writing routes without
+  standards coverage.
+- Release surface checks now require package, lockfile, README badge,
+  changelog, release notes, release checklist, and package payload guards to
+  agree before publish.
+
 ## [1.6.19] - 2026-05-16
 
 Repository surface sync and status truth closeout.

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.19-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.6.21-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,14 @@ 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.19 sharpens Godpowers status truth and adds repository surface
-sync. Dashboards now name whether they came from `lib/dashboard.js` or a manual
-fallback, and Godpowers checks routing gaps, package payload drift, agent
-handoff drift, workflow metadata drift, recipe route drift, extension pack
-drift, and release-policy drift before closeout.
+Version 1.6.21 sharpens the daily operating loop. Godpowers now shows a compact
+action brief in dashboard output, enforces trace events for every
+agent-spawning route, and keeps dogfood, extension publish, Mode D suite, and
+installer smoke gates wired into release readiness.
+
+The dashboard now starts with an action brief: the next command, why it is
+recommended, whether the project is ready, and the first blockers that need
+attention. Detailed proactive checks remain below the brief for auditability.
 
 It fuses four disciplines into one unified workflow:
 
@@ -107,8 +110,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

package/RELEASE.md

@@ -1,19 +1,18 @@
-# Godpowers 1.6.19 Release
+# Godpowers 1.6.21 Release
 
 Date: 2026-05-16
 
-Godpowers 1.6.19 adds repository surface sync and clarifies status truth across
-`/god-status`, `/god-next`, God Mode closeouts, and installer CLI status
-helpers. Godpowers can now detect structural drift across routes, package
-payload rules, agent handoffs, workflow metadata, recipe routes, extension
-packs, and release policy before declaring a project run current.
+Godpowers 1.6.21 sharpens the daily operating loop after the automation
+surface closeout. It adds dashboard action briefs, requires agent-spawning
+routes to declare trace events, and expands release readiness checks across
+dogfood, extension publish, Mode D suite, and installer smoke gates.
 
 ## What is stable
 
 - 109 slash commands
 - 40 specialist agents
 - 13 executable workflows
-- 36 intent recipes
+- 40 intent recipes
 - 15-runtime installer
 - Codex installs with generated `god-*.toml` agent metadata files
 - Markdown specialist agent contracts at `<runtime>/agents/god-*.md`
@@ -27,35 +26,42 @@ packs, and release policy before declaring a project run current.
 - Feature awareness for existing Godpowers projects
 - Repository documentation sync checks
 - Repository surface sync checks
+- Route quality, recipe coverage, and release surface sync checks
+- Dashboard action briefs for next-step compression
+- Agent-spawn trace event guardrails
+- Mode D suite readiness checks
 
 ## What is new
 
-- Added `lib/repo-surface-sync.js`.
-- Added `docs/repo-surface-sync.md`.
-- Added `scripts/test-repo-surface-sync.js`.
-- `/god-sync`, `/god-docs`, `/god-doctor`, `/god-status`, and `/god-mode` now
-  document repo surface sync integration.
-- Dashboard proactive checks now include a repo surface status line.
-- Package contents checks now require `lib/repo-surface-sync.js`.
-- Feature awareness now records `repo-surface-sync` as a known runtime feature.
-- Dashboard output keeps workflow progress distinct from audit, hygiene,
-  remediation, and launch-readiness scores.
+- Added `Action brief` output to `lib/dashboard.js` and CLI status rendering.
+- Added route-quality enforcement for `agent.start` and `agent.end` trace
+  event declarations on agent-spawning routes.
+- Added repo-surface Mode D suite readiness checks for suite helper presence,
+  suite command skill and routing coverage, roadmap documentation, and release
+  test wiring.
+- Added release-surface checks for dogfood, extension publish, Mode D suite,
+  and installer smoke tests.
+- Updated `/god-init`, `/god-roadmap-update`, and `/god-sync` route metadata
+  to declare `agent.start`.
 
-## Surface sync behavior
+## Automation surface behavior
 
 For a Godpowers repository, the helper checks:
 
-- every `skills/god-*.md` command has matching `routing/god-*.yaml` metadata
-- required package payload entries exist in `package.json`
+- 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
-- routed specialist spawns resolve to real agent files
-- workflows have parseable metadata
-- recipes contain slash-command routes
-- extension manifests, package metadata, peer dependencies, and provided files agree
-- release docs and release policy checks name repo documentation and repo surface sync
+- release checklist policy names the current sync guards
+- release gates include dogfood, extension publish, Mode D suite, and installer
+  smoke checks
 
-Detection is read-only by default. Applying sync only writes a log and may
-create missing routing stubs when `fixRouting` is explicitly enabled.
+Detection is read-only by default. Applying sync writes logs and leaves
+judgment-heavy rewrites to scoped specialists.
 
 ## Auto-invoke and auto-spawn policy
 
@@ -77,9 +83,13 @@ Godpowers recommends scoped specialists only when judgment is needed:
 Release validation includes:
 
 - `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`
@@ -87,5 +97,5 @@ Release validation includes:
 - `git diff --check`
 - `npm run release:check`
 
-The `v1.6.19` tag should point to the release commit that matches the npm
-`godpowers@1.6.19` package.
+The `v1.6.21` tag should point to the release commit that matches the npm
+`godpowers@1.6.21` package.

package/SKILL.md

@@ -215,7 +215,7 @@ Auto-invoked:
   Trigger: <what caused this automatic step>
   Agent: <god-updater | god-context-writer | none, local runtime only>
   Local syncs:
-    + <feature-awareness | planning-system-import | reverse-sync | source-sync | repo-doc-sync | repo-surface-sync | pillars-sync | checkpoint-sync | context-refresh>: <result or skipped reason>
+    + <feature-awareness | planning-system-import | reverse-sync | source-sync | repo-doc-sync | repo-surface-sync | route-quality-sync | recipe-coverage-sync | release-surface-sync | pillars-sync | checkpoint-sync | context-refresh>: <result or skipped reason>
   Artifacts: <changed files, no-op, or deferred>
   Log: <SYNC-LOG.md, CHECKPOINT.md, REVIEW-REQUIRED.md, or none>
 ```
@@ -247,6 +247,9 @@ Automatic steps that especially need visible reporting:
   `/god-status`, or `/god-mode`
 - repo surface sync during `/god-sync`, `/god-docs`, `/god-doctor`,
   `/god-status`, or `/god-mode`
+- route-quality sync, recipe-coverage sync, and release-surface sync through
+  repo-surface sync during `/god-sync`, `/god-docs`, `/god-doctor`,
+  `/god-status`, or `/god-mode`
 
 ### 13. Proactive Auto-Invoke Policy
 Godpowers should be proactive from disk evidence, not from guesswork. Before
@@ -291,6 +294,9 @@ Run these local runtime helpers automatically when their trigger is present:
   `lib/repo-surface-sync.run` during `/god-sync`, `/god-docs`, or
   `/god-mode` when command routing, package payload, agent handoffs, workflow
   metadata, recipe routes, extension packs, or release policy may have drifted.
+- `lib/route-quality-sync.detect`, `lib/recipe-coverage-sync.detect`, and
+  `lib/release-surface-sync.detect` through repo-surface sync when route
+  spawns, high-frequency recipes, or release-facing surfaces may have drifted.
 - Context refresh dry-run after `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`,
   `.cursor/rules/`, `.windsurfrules`, `.github/copilot-instructions.md`,
   `.clinerules`, `.roo/`, or `.continue/` changes.

package/lib/README.md

@@ -15,6 +15,9 @@ package-level integrations.
 | `feature-awareness.js` | Detect and refresh existing-project awareness after runtime upgrades. |
 | `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. |
 | `budget.js` | Read and enforce configured budget controls. |
 | `cost-tracker.js` | Track token and cost estimates from event streams. |
 

package/lib/dashboard.js

@@ -217,7 +217,7 @@ function compute(projectRoot, opts = {}) {
 
   if (!s) {
     const next = { command: '/god-init', reason: 'No Godpowers project initialized' };
-    return {
+    const result = {
       source: 'runtime dashboard (lib/dashboard.js)',
       state: 'not initialized',
       mode: null,
@@ -237,6 +237,8 @@ function compute(projectRoot, opts = {}) {
       next,
       openItems: ['No .godpowers/state.json found']
     };
+    result.actionBrief = actionBrief(result);
+    return result;
   }
 
   const progress = state.progressSummary(s);
@@ -250,7 +252,7 @@ function compute(projectRoot, opts = {}) {
   if (reviewCount(projectRoot) > 0) openItems.push('pending review items');
   if (openItems.length === 0) openItems.push('none');
 
-  return {
+  const result = {
     source: 'runtime dashboard (lib/dashboard.js)',
     state: progress.remaining === 0 ? 'complete' : 'in progress',
     mode: s.mode || s['mode-announced-as'] || null,
@@ -264,6 +266,37 @@ function compute(projectRoot, opts = {}) {
     next,
     openItems
   };
+  result.actionBrief = actionBrief(result);
+  return result;
+}
+
+function actionBrief(dashboard) {
+  const proactive = dashboard.proactive || {};
+  const next = dashboard.next || {};
+  const blockers = [];
+  for (const [label, value] of [
+    ['Repo surface', proactive.repoSurface],
+    ['Docs', proactive.docs],
+    ['Reviews', proactive.reviews],
+    ['Sync', proactive.sync],
+    ['Security', proactive.security],
+    ['Dependencies', proactive.dependencies],
+    ['Hygiene', proactive.hygiene]
+  ]) {
+    if (!value) continue;
+    if (value === 'fresh' || value === 'none' || value === 'clear' || value === 'not-applicable') continue;
+    if (/^available via /.test(value)) continue;
+    blockers.push(`${label}: ${value}`);
+  }
+
+  const recommended = next.command || 'describe the next intent';
+  return {
+    recommended,
+    reason: next.reason || 'No route was computed.',
+    confidence: blockers.length === 0 ? 'ready' : 'needs attention',
+    blockers: blockers.slice(0, 3),
+    overflow: Math.max(0, blockers.length - 3)
+  };
 }
 
 function render(dashboard) {
@@ -277,6 +310,7 @@ function render(dashboard) {
   const openItems = dashboard.openItems && dashboard.openItems.length > 0
     ? dashboard.openItems
     : ['none'];
+  const brief = dashboard.actionBrief || actionBrief(dashboard);
 
   return [
     'Godpowers Dashboard',
@@ -291,6 +325,12 @@ function render(dashboard) {
     `  Worktree: ${dashboard.worktree}`,
     `  Index: ${dashboard.index}`,
     '',
+    '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` : ''}`,
+    '',
     'Planning visibility:',
     `  PRD: ${prd.status || 'missing'}${prd.path ? ` ${prd.path}` : ''}`,
     `  Roadmap: ${roadmap.status || 'missing'}${roadmap.path ? ` ${roadmap.path}` : ''}`,
@@ -325,5 +365,6 @@ module.exports = {
   parseGitStatus,
   proactiveChecks,
   automationSummary,
+  actionBrief,
   planningVisibility
 };

package/lib/feature-awareness.js

@@ -46,6 +46,24 @@ const FEATURES = [
     since: '1.6.19',
     commands: ['/god-sync', '/god-docs', '/god-doctor', '/god-status', '/god-mode'],
     description: 'Detect structural drift across routing, packages, agents, workflows, recipes, extensions, and release policy.'
+  },
+  {
+    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.'
+  },
+  {
+    id: 'recipe-coverage-sync',
+    since: '1.6.19',
+    commands: ['/god-sync', '/god-doctor', '/god-status', '/god-mode'],
+    description: 'Detect missing intent recipes for release, docs, context refresh, story work, and automation setup.'
+  },
+  {
+    id: 'release-surface-sync',
+    since: '1.6.19',
+    commands: ['/god-sync', '/god-docs', '/god-doctor', '/god-status', '/god-mode'],
+    description: 'Detect release-facing drift across badges, release notes, changelog, package checks, and release checklist policy.'
   }
 ];
 

package/lib/recipe-coverage-sync.js

@@ -0,0 +1,149 @@
+/**
+ * Recipe coverage sync.
+ *
+ * Keeps fuzzy user intent connected to shipped command routes for the
+ * high-frequency areas that users naturally ask for in prose.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const recipes = require('./recipes');
+
+const LOG_PATH = '.godpowers/surface/RECIPE-COVERAGE-SYNC.md';
+
+const REQUIRED_COVERAGE = [
+  {
+    id: 'release-maintenance',
+    description: 'release maintenance',
+    commands: ['/god-sync', '/god-docs', '/god-version']
+  },
+  {
+    id: 'docs-drift',
+    description: 'documentation drift',
+    commands: ['/god-docs']
+  },
+  {
+    id: 'context-refresh',
+    description: 'context refresh and feature awareness',
+    commands: ['/god-context', '/god-sync', '/god-status']
+  },
+  {
+    id: 'story-work',
+    description: 'story creation, build, verify, and close',
+    commands: ['/god-story', '/god-story-build', '/god-story-verify', '/god-story-close']
+  },
+  {
+    id: 'automation-setup',
+    description: 'automation setup and status',
+    commands: ['/god-automation-setup', '/god-automation-status']
+  }
+];
+
+function read(projectRoot, relPath) {
+  const file = path.join(projectRoot, relPath);
+  if (!fs.existsSync(file)) return '';
+  return fs.readFileSync(file, 'utf8');
+}
+
+function write(projectRoot, relPath, content) {
+  const file = path.join(projectRoot, relPath);
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, content);
+}
+
+function addCheck(checks, id, status, relPath, message, opts = {}) {
+  checks.push({
+    area: 'recipe-coverage',
+    id,
+    status,
+    path: relPath,
+    message,
+    severity: opts.severity || (status === 'fresh' ? 'info' : 'warning'),
+    spawn: opts.spawn || null
+  });
+}
+
+function recipePath(projectRoot, name) {
+  const rel = `routing/recipes/${name}.yaml`;
+  return fs.existsSync(path.join(projectRoot, rel)) ? rel : 'routing/recipes/';
+}
+
+function detect(projectRoot) {
+  recipes.clearCache();
+  const checks = [];
+  const all = recipes.loadAll();
+  const recipeTexts = new Map();
+  for (const recipe of all) {
+    const name = recipe.metadata && recipe.metadata.name;
+    if (!name) continue;
+    recipeTexts.set(name, read(projectRoot, `routing/recipes/${name}.yaml`));
+  }
+
+  for (const required of REQUIRED_COVERAGE) {
+    const matched = [...recipeTexts.entries()].filter(([, text]) =>
+      required.commands.every((command) => text.includes(command))
+    );
+    addCheck(
+      checks,
+      `coverage-${required.id}`,
+      matched.length > 0 ? 'fresh' : 'stale',
+      matched.length > 0 ? `routing/recipes/${matched[0][0]}.yaml` : recipePath(projectRoot, required.id),
+      matched.length > 0
+        ? `Recipe coverage exists for ${required.description}.`
+        : `No recipe covers ${required.description} with ${required.commands.join(', ')}.`,
+      { spawn: matched.length > 0 ? null : 'god-roadmap-reconciler' }
+    );
+  }
+
+  const stale = checks.filter((check) => check.status !== 'fresh');
+  return {
+    status: stale.length === 0 ? 'fresh' : 'stale',
+    checks,
+    stale
+  };
+}
+
+function appendLog(projectRoot, before, after) {
+  const now = new Date().toISOString();
+  const lines = [];
+  if (fs.existsSync(path.join(projectRoot, LOG_PATH))) {
+    lines.push(read(projectRoot, LOG_PATH).replace(/\s*$/, ''));
+    lines.push('');
+  } else {
+    lines.push('# Recipe Coverage Sync Log');
+    lines.push('');
+    lines.push('- [DECISION] This file records recipe-coverage sync checks run by Godpowers.');
+    lines.push('');
+  }
+  lines.push(`## ${now}`);
+  lines.push('');
+  lines.push(`- [DECISION] Recipe coverage status before apply was ${before.status}.`);
+  lines.push(`- [DECISION] Recipe coverage status after apply is ${after.status}.`);
+  lines.push('');
+  write(projectRoot, LOG_PATH, lines.join('\n'));
+}
+
+function run(projectRoot, opts = {}) {
+  const before = detect(projectRoot);
+  const after = detect(projectRoot);
+  if (opts.log !== false) appendLog(projectRoot, before, after);
+  return {
+    before,
+    after,
+    applied: [],
+    logPath: opts.log === false ? null : LOG_PATH
+  };
+}
+
+function summary(report) {
+  return report.status === 'fresh' ? 'fresh' : `${report.stale.length} stale`;
+}
+
+module.exports = {
+  LOG_PATH,
+  REQUIRED_COVERAGE,
+  detect,
+  run,
+  summary
+};