godpowers 1.6.20 → 1.6.21

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [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.

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.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.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.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,12 +1,11 @@
-# Godpowers 1.6.20 Release
+# Godpowers 1.6.21 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.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
 
@@ -28,21 +27,22 @@ 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
+- Agent-spawn trace event guardrails
+- Mode D suite readiness checks
 
 ## 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 `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`.
 
 ## Automation surface behavior
 
@@ -50,12 +50,15 @@ 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
 
 Detection is read-only by default. Applying sync writes logs and leaves
 judgment-heavy rewrites to scoped specialists.
@@ -84,6 +87,9 @@ Release validation includes:
 - `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 +97,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.21` tag should point to the release commit that matches the npm
+`godpowers@1.6.21` package.

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/release-surface-sync.js

@@ -17,6 +17,14 @@ const REQUIRED_PACKAGE_GUARDS = [
   'lib/release-surface-sync.js'
 ];
 
+const REQUIRED_RELEASE_TESTS = [
+  '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 +108,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 +170,7 @@ function summary(report) {
 module.exports = {
   LOG_PATH,
   REQUIRED_PACKAGE_GUARDS,
+  REQUIRED_RELEASE_TESTS,
   detect,
   run,
   summary

package/lib/repo-surface-sync.js

@@ -357,6 +357,75 @@ 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 releasePolicyChecks(projectRoot) {
   const checks = [];
   const docs = repoDocSync.detect(projectRoot);
@@ -393,6 +462,7 @@ function detect(projectRoot) {
     ...agentChecks(projectRoot),
     ...workflowRecipeChecks(projectRoot),
     ...extensionChecks(projectRoot),
+    ...suiteChecks(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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "1.6.20",
+  "version": "1.6.21",
   "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.",
   "bin": {
     "godpowers": "./bin/install.js"

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]