godpowers 1.6.17 → 1.6.19

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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).
 
+## [1.6.19] - 2026-05-16
+
+Repository surface sync and status truth closeout.
+
+### Added
+- Added `lib/repo-surface-sync.js` to detect structural drift across command
+  routing, package payload rules, agent handoffs, workflow metadata, recipe
+  routes, extension packs, and release policy checks.
+- Added `docs/repo-surface-sync.md` with auto-invoke, auto-spawn, and guardrail
+  behavior.
+- Added behavioral tests for missing route detection, explicit route stub
+  creation, sync logging, package checks, agent handoff checks, and current
+  repo freshness.
+
+### Changed
+- `/god-sync`, `/god-docs`, `/god-doctor`, `/god-status`, and `/god-mode` now
+  document repo surface sync behavior.
+- Dashboard proactive checks now include a repo surface status line.
+- Feature awareness now records `repo-surface-sync` as a known runtime feature.
+- Package contents checks now require `lib/repo-surface-sync.js`.
+- README, release notes, command flows, release checklist, command reference,
+  and runtime docs now describe repo surface sync.
+
+### Guardrails
+- Detection is read-only by default.
+- Safe apply can create missing routing stubs only when `fixRouting` is
+  explicitly enabled.
+- Agent, workflow, recipe, extension, and release-policy ambiguity routes to
+  scoped specialists instead of being rewritten blindly.
+
 ## [1.6.17] - 2026-05-16
 
 Autonomous repository documentation sync.

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.17-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.6.19-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,11 @@ 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.17 adds autonomous repository documentation sync. `/god-sync`,
-`/god-docs`, `/god-doctor`, `/god-status`, and `/god-mode` can now detect stale
-README badges, public surface counts, release docs, contribution guidance,
-security policy, and Pillars context planning needs before a project run is
-declared complete.
+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.
 
 It fuses four disciplines into one unified workflow:
 
@@ -194,12 +194,13 @@ durable `.godpowers` artifacts change project truth. The decision is logged to
 `.godpowers/YOLO-DECISIONS.md`.
 
 Every completing command now ends with a **Godpowers Dashboard**. It shows the
-current phase, tier, step count, percent complete, PRD and roadmap visibility,
+current phase, tier, step count, workflow progress, PRD and roadmap visibility,
 recent work, proactive checks, open items, and the single recommended next
 action. `/god-status` and `/god-next` use the same shape so the project never
 ends in a vague "done" state. The dashboard is backed by
-`lib/dashboard.js`, so status and next-step commands share one executable
-source of disk truth instead of parallel Markdown-only contracts.
+`lib/dashboard.js`, and the rendered output names that source when the runtime
+engine is available. Audit, hygiene, and remediation scores are reported as
+separate scores rather than being reused as workflow progress.
 
 Godpowers can also inspect automation support:
 
@@ -361,6 +362,7 @@ Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
 - [Command reference (all 109 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)
 - [Roadmap](docs/ROADMAP.md)
 - [Release Notes](RELEASE.md)
 - [Changelog](CHANGELOG.md)

package/RELEASE.md

@@ -1,12 +1,12 @@
-# Godpowers 1.6.17 Release
+# Godpowers 1.6.19 Release
 
 Date: 2026-05-16
 
-Godpowers 1.6.17 adds autonomous repository documentation sync for release
-surfaces and project-run closeout. Godpowers can now detect stale README badges,
-public surface counts, release notes, changelog entries, contribution guidance,
-security policy, and Pillars context planning needs before a sync, docs, doctor,
-status, or god-mode closeout declares the repository current.
+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.
 
 ## What is stable
 
@@ -25,57 +25,67 @@ status, or god-mode closeout declares the repository current.
 - Planning-system migration for GSD, BMAD, and Superpowers
 - Managed sync-back companion files for imported source systems
 - Feature awareness for existing Godpowers projects
+- Repository documentation sync checks
+- Repository surface sync checks
 
 ## What is new
 
-- Added `lib/repo-doc-sync.js`.
-- Added `docs/repo-doc-sync.md`.
-- Added `scripts/test-repo-doc-sync.js`.
-- Added missing `/god-export-otel` routing metadata.
+- 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 documentation sync integration.
-- The dashboard proactive docs check now reads repo documentation sync status.
-- Package contents checks now require the repo documentation sync helper and
-  `/god-export-otel` routing metadata.
+  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.
 
-## Sync behavior
+## Surface sync behavior
 
-For a Godpowers repository, the helper:
+For a Godpowers repository, the helper checks:
 
-- reads package version and repository surface counts
-- detects stale mechanical claims in README, user docs, architecture docs,
-  roadmap docs, command reference docs, `/god-version`, and `/god-doctor`
-- applies safe mechanical badge, version, and count refreshes when requested
-- plans Pillars sync for changed repo documentation paths
-- recommends `god-docs-writer` for release notes, changelog, contribution,
-  support, or security policy prose
+- every `skills/god-*.md` command has matching `routing/god-*.yaml` metadata
+- required package payload entries exist in `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
 
-Detection is read-only by default. Applying sync does not invent narrative
-release notes, changelog entries, contribution policy, support policy, or
-security support policy.
+Detection is read-only by default. Applying sync only writes a log and may
+create missing routing stubs when `fixRouting` is explicitly enabled.
 
 ## Auto-invoke and auto-spawn policy
 
-Safe repo documentation sync is local runtime work and must be reported as:
+Safe repo surface sync is local runtime work and must be reported as:
 
 ```text
 Agent: none, local runtime only
 ```
 
-Godpowers recommends or spawns `god-docs-writer` only when narrative docs need
-claim verification or policy judgment after local mechanical sync has finished.
+Godpowers recommends scoped specialists only when judgment is needed:
+
+- `god-auditor` for agent contract or handoff drift
+- `god-roadmap-reconciler` for workflow or recipe lifecycle drift
+- `god-coordinator` for extension pack drift
+- `god-docs-writer` for release prose drift
 
 ## Validation
 
 Release validation includes:
 
+- `node scripts/test-repo-surface-sync.js`
 - `node scripts/test-repo-doc-sync.js`
 - `node scripts/test-feature-awareness.js`
+- `node scripts/test-dashboard.js`
 - `node scripts/test-context-writer.js`
 - `node scripts/test-planning-systems.js`
 - `node scripts/test-doc-surface-counts.js`
 - `node scripts/validate-skills.js`
 - `git diff --check`
+- `npm run release:check`
 
-The `v1.6.17` tag should point to the release commit that matches the npm
-`godpowers@1.6.17` package.
+The `v1.6.19` tag should point to the release commit that matches the npm
+`godpowers@1.6.19` package.

package/SKILL.md

@@ -155,6 +155,7 @@ Proactive checks:
   Reviews: <none | N pending, suggest /god-review-changes>
   Sync: <fresh | missing | stale | local helper ran | suggest /god-sync>
   Docs: <fresh | N stale, suggest /god-docs | repo-doc-sync ran>
+  Repo surface: <fresh | N stale, suggest /god-doctor | repo-surface-sync ran>
   Runtime: <not-applicable | known URL, suggest /god-test-runtime | no known URL, defer deployed verification>
   Automation: <not configured | N active | available via provider, suggest /god-automation-setup>
   Security: <clear | sensitive files changed, suggest /god-harden>
@@ -214,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 | 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 | 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>
 ```
@@ -244,6 +245,8 @@ Automatic steps that especially need visible reporting:
   `/god-sync`, or `/god-mode`
 - repo documentation sync during `/god-sync`, `/god-docs`, `/god-doctor`,
   `/god-status`, or `/god-mode`
+- 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
@@ -284,6 +287,10 @@ Run these local runtime helpers automatically when their trigger is present:
   `lib/repo-doc-sync.run` during `/god-sync`, `/god-docs`, or `/god-mode`
   when README badges, public surface counts, release docs, contribution docs,
   or security policy may have drifted.
+- `lib/repo-surface-sync.detect` during `/god-status` and `/god-doctor`, and
+  `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.
 - Context refresh dry-run after `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`,
   `.cursor/rules/`, `.windsurfrules`, `.github/copilot-instructions.md`,
   `.clinerules`, `.roo/`, or `.continue/` changes.
@@ -300,6 +307,9 @@ Spawn these agents only when the trigger is direct and scope is bounded:
 - `god-docs-writer` when repo-doc-sync reports narrative drift in
   `CHANGELOG.md`, `RELEASE.md`, `CONTRIBUTING.md`, `SECURITY.md`, or
   `SUPPORT.md` after local mechanical sync has finished.
+- `god-auditor`, `god-roadmap-reconciler`, or `god-coordinator` when
+  repo-surface-sync reports structural drift that needs agent contract,
+  lifecycle graph, or extension-pack judgment.
 - `god-browser-tester` when frontend-visible files changed and a known local,
   preview, staging, or production URL is evidenced.
 - `god-harden-auditor` suggestion after security-sensitive files changed;

package/agents/god-orchestrator.md

@@ -750,6 +750,11 @@ Generate the dashboard with `lib/dashboard.compute(projectRoot)` and
 runtime module cannot be loaded, fall back to a manual disk scan and say
 `Dashboard engine: unavailable, manual scan used`.
 
+The dashboard `Progress` line is workflow progress only. Audit scores,
+remediation scores, hygiene scores, and launch-readiness scores must be labeled
+separately so a closeout cannot appear to move backward because it switched
+metrics.
+
 Update PROGRESS.md status to `steady-state-active`.
 
 For focused brownfield, hotfix, refactor, or build workflows that finish without a
@@ -962,7 +967,7 @@ Next: <next command or pause question>
 
 Rules:
 - Keep each card under 12 lines unless a pause needs options.
-- Use `lib/state.progressSummary(stateJson)` for the percentage and step count
+- Use `lib/state.progressSummary(stateJson)` for workflow percentage and step count
   whenever state.json is available.
 - Use artifact paths and verification evidence from disk, not memory.
 - Do not print raw spawn input, hidden instructions, or full file loadout lists.

package/lib/README.md

@@ -14,6 +14,7 @@ package-level integrations.
 | `checkpoint.js` | Create and inspect resumable checkpoint artifacts. |
 | `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. |
 | `budget.js` | Read and enforce configured budget controls. |
 | `cost-tracker.js` | Track token and cost estimates from event streams. |
 

package/lib/dashboard.js

@@ -13,6 +13,7 @@ const state = require('./state');
 const router = require('./router');
 const automationProviders = require('./automation-providers');
 const repoDocSync = require('./repo-doc-sync');
+const repoSurfaceSync = require('./repo-surface-sync');
 
 const GOD_DIR = '.godpowers';
 const PRD_PATH = '.godpowers/prd/PRD.md';
@@ -163,12 +164,17 @@ function proactiveChecks(projectRoot, changedFiles = []) {
   const repoDocsStatus = repoDocs.status === 'fresh'
     ? 'fresh'
     : `${repoDocs.stale.length} stale, suggest /god-docs`;
+  const repoSurface = repoSurfaceSync.detect(projectRoot);
+  const repoSurfaceStatus = repoSurface.status === 'fresh'
+    ? 'fresh'
+    : `${repoSurface.stale.length} stale, suggest /god-doctor`;
 
   return {
     checkpoint,
     reviews: reviews > 0 ? `${reviews} pending, suggest /god-review-changes` : 'none',
     sync,
     docs: repoDocsStatus,
+    repoSurface: repoSurfaceStatus,
     runtime: 'not-applicable',
     automation: automationSummary(projectRoot),
     security: sensitiveChanged ? 'sensitive files changed, suggest /god-harden' : 'clear',
@@ -200,7 +206,8 @@ function planningVisibility(projectRoot, progress) {
     prd: { status: prd, path: prd === 'done' ? PRD_PATH : null },
     roadmap: { status: roadmap, path: roadmap === 'done' ? ROADMAP_PATH : null },
     currentMilestone: phase.stepLabel ? `${phase.phase} / ${phase.stepLabel}` : phase.phase,
-    completion: `${progress.percent}% based on state.json tracked steps`
+    completion: `${progress.percent}% workflow progress from .godpowers/state.json tracked steps`,
+    completionBasis: '.godpowers/state.json workflow steps'
   };
 }
 
@@ -211,6 +218,7 @@ function compute(projectRoot, opts = {}) {
   if (!s) {
     const next = { command: '/god-init', reason: 'No Godpowers project initialized' };
     return {
+      source: 'runtime dashboard (lib/dashboard.js)',
       state: 'not initialized',
       mode: null,
       lifecycle: 'pre-init',
@@ -222,7 +230,8 @@ function compute(projectRoot, opts = {}) {
         prd: { status: 'missing', path: null },
         roadmap: { status: 'missing', path: null },
         currentMilestone: 'Project initialization',
-        completion: '0% based on missing state.json'
+        completion: '0% workflow progress because .godpowers/state.json is missing',
+        completionBasis: 'missing .godpowers/state.json'
       },
       proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
       next,
@@ -242,6 +251,7 @@ function compute(projectRoot, opts = {}) {
   if (openItems.length === 0) openItems.push('none');
 
   return {
+    source: 'runtime dashboard (lib/dashboard.js)',
     state: progress.remaining === 0 ? 'complete' : 'in progress',
     mode: s.mode || s['mode-announced-as'] || null,
     lifecycle: s['lifecycle-phase'] || 'in-arc',
@@ -271,11 +281,13 @@ function render(dashboard) {
   return [
     'Godpowers Dashboard',
     '',
+    `Source: ${dashboard.source || 'manual disk scan'}`,
+    '',
     'Current status:',
     `  State: ${dashboard.state}`,
     `  Phase: ${current.phase || 'unknown'}${current.tierNumber !== null && current.tierNumber !== undefined ? ` (tier ${current.tierOrdinal} of ${current.tierCount}, internal ${current.tierKey || `tier-${current.tierNumber}`})` : ''}`,
     `  Step: ${current.stepLabel || 'unknown'}${current.stepNumber ? ` (step ${current.stepNumber} of ${current.totalSteps})` : ''}`,
-    `  Progress: ${progress.percent || 0}% (${progress.completed || 0} of ${progress.total || 0} steps complete)`,
+    `  Progress: ${progress.percent || 0}% workflow progress (${progress.completed || 0} of ${progress.total || 0} tracked steps complete)`,
     `  Worktree: ${dashboard.worktree}`,
     `  Index: ${dashboard.index}`,
     '',
@@ -283,13 +295,14 @@ function render(dashboard) {
     `  PRD: ${prd.status || 'missing'}${prd.path ? ` ${prd.path}` : ''}`,
     `  Roadmap: ${roadmap.status || 'missing'}${roadmap.path ? ` ${roadmap.path}` : ''}`,
     `  Current milestone: ${planning.currentMilestone || 'unknown'}`,
-    `  Completion: ${planning.completion || 'unknown'}`,
+    `  Completion basis: ${planning.completionBasis || planning.completion || 'unknown'}`,
     '',
     'Proactive checks:',
     `  Checkpoint: ${proactive.checkpoint || 'unknown'}`,
     `  Reviews: ${proactive.reviews || 'unknown'}`,
     `  Sync: ${proactive.sync || 'unknown'}`,
     `  Docs: ${proactive.docs || 'unknown'}`,
+    `  Repo surface: ${proactive.repoSurface || 'unknown'}`,
     `  Runtime: ${proactive.runtime || 'unknown'}`,
     `  Automation: ${proactive.automation || 'unknown'}`,
     `  Security: ${proactive.security || 'unknown'}`,

package/lib/feature-awareness.js

@@ -40,6 +40,12 @@ const FEATURES = [
     since: '1.6.17',
     commands: ['/god-sync', '/god-docs', '/god-doctor', '/god-status', '/god-mode'],
     description: 'Detect and refresh repository documentation surfaces, release docs, and Pillars planning signals.'
+  },
+  {
+    id: 'repo-surface-sync',
+    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.'
   }
 ];
 

package/lib/repo-surface-sync.js

@@ -0,0 +1,512 @@
+/**
+ * Repository surface sync.
+ *
+ * Detects structural drift between commands, routing, package metadata,
+ * agent contracts, workflows, recipes, extensions, and release policy docs.
+ * The helper is read-only by default. The apply path writes only safe local
+ * logs and optional missing routing stubs when explicitly requested.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { parseSimpleYaml } = require('./intent');
+const extensions = require('./extensions');
+const repoDocSync = require('./repo-doc-sync');
+
+const LOG_PATH = '.godpowers/surface/REPO-SURFACE-SYNC.md';
+
+const REQUIRED_PACKAGE_FILE_ENTRIES = [
+  'bin/',
+  'skills/',
+  'agents/god-*.md',
+  'templates/',
+  'references/',
+  'routing/',
+  'workflows/',
+  'schema/',
+  'lib/',
+  'extensions/',
+  'RELEASE.md',
+  'SKILL.md',
+  'AGENTS.md',
+  'CHANGELOG.md',
+  'LICENSE'
+];
+
+const REQUIRED_PACKAGE_CHECKS = [
+  'lib/feature-awareness.js',
+  'lib/repo-doc-sync.js',
+  'lib/repo-surface-sync.js',
+  'routing/god-export-otel.yaml'
+];
+
+function rel(projectRoot, absPath) {
+  return path.relative(projectRoot, absPath).split(path.sep).join('/');
+}
+
+function exists(projectRoot, relPath) {
+  return fs.existsSync(path.join(projectRoot, relPath));
+}
+
+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 listFiles(projectRoot, relDir, pattern) {
+  const dir = path.join(projectRoot, relDir);
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir)
+    .filter((name) => pattern.test(name))
+    .sort()
+    .map((name) => `${relDir}/${name}`.replace(/\\/g, '/'));
+}
+
+function readJson(projectRoot, relPath) {
+  try {
+    return JSON.parse(read(projectRoot, relPath));
+  } catch (err) {
+    return null;
+  }
+}
+
+function routeForSkill(skillPath) {
+  const base = path.basename(skillPath, '.md');
+  return `routing/${base}.yaml`;
+}
+
+function commandForSkill(skillPath) {
+  return `/${path.basename(skillPath, '.md')}`;
+}
+
+function addCheck(checks, area, id, status, relPath, message, opts = {}) {
+  checks.push({
+    area,
+    id,
+    status,
+    path: relPath,
+    message,
+    severity: opts.severity || (status === 'fresh' ? 'info' : 'warning'),
+    safeFix: opts.safeFix === true,
+    spawn: opts.spawn || null
+  });
+}
+
+function routingChecks(projectRoot) {
+  const checks = [];
+  const skills = listFiles(projectRoot, 'skills', /^god.*\.md$/);
+  const routes = listFiles(projectRoot, 'routing', /^god.*\.yaml$/);
+  const skillRoutes = new Set(skills.map(routeForSkill));
+  const routeSet = new Set(routes);
+
+  for (const skill of skills) {
+    const route = routeForSkill(skill);
+    addCheck(
+      checks,
+      'routing',
+      `route-for-${path.basename(skill, '.md')}`,
+      routeSet.has(route) ? 'fresh' : 'stale',
+      route,
+      routeSet.has(route)
+        ? `${commandForSkill(skill)} has routing metadata.`
+        : `${commandForSkill(skill)} is missing routing metadata.`,
+      { safeFix: !routeSet.has(route) }
+    );
+  }
+
+  for (const route of routes) {
+    if (!skillRoutes.has(route)) {
+      addCheck(
+        checks,
+        'routing',
+        `skill-for-${path.basename(route, '.yaml')}`,
+        'stale',
+        route,
+        `${route} has no matching skill file.`,
+        { severity: 'warning' }
+      );
+    }
+  }
+  return checks;
+}
+
+function packageChecks(projectRoot) {
+  const checks = [];
+  const pkg = readJson(projectRoot, 'package.json') || {};
+  const lock = readJson(projectRoot, 'package-lock.json');
+  const fileEntries = Array.isArray(pkg.files) ? pkg.files : [];
+
+  for (const entry of REQUIRED_PACKAGE_FILE_ENTRIES) {
+    addCheck(
+      checks,
+      'package',
+      `package-files-${entry.replace(/[^a-z0-9]+/gi, '-')}`,
+      fileEntries.includes(entry) ? 'fresh' : 'stale',
+      'package.json',
+      fileEntries.includes(entry)
+        ? `package.json includes ${entry}.`
+        : `package.json files is missing ${entry}.`
+    );
+  }
+
+  const packageCheckText = read(projectRoot, 'scripts/check-package-contents.js');
+  for (const required of REQUIRED_PACKAGE_CHECKS) {
+    addCheck(
+      checks,
+      'package',
+      `package-check-${required.replace(/[^a-z0-9]+/gi, '-')}`,
+      packageCheckText.includes(required) ? 'fresh' : 'stale',
+      'scripts/check-package-contents.js',
+      packageCheckText.includes(required)
+        ? `package contents check requires ${required}.`
+        : `package contents check does not require ${required}.`
+    );
+  }
+
+  if (lock && lock.version) {
+    addCheck(
+      checks,
+      'package',
+      'package-lock-version',
+      lock.version === pkg.version ? 'fresh' : 'stale',
+      'package-lock.json',
+      lock.version === pkg.version
+        ? 'package-lock.json version matches package.json.'
+        : `package-lock.json version ${lock.version} does not match package.json ${pkg.version}.`
+    );
+  }
+
+  return checks;
+}
+
+function parseRoute(projectRoot, routePath) {
+  try {
+    return parseSimpleYaml(read(projectRoot, routePath));
+  } catch (err) {
+    return null;
+  }
+}
+
+function agentChecks(projectRoot) {
+  const checks = [];
+  const agents = new Set(listFiles(projectRoot, 'agents', /^god.*\.md$/)
+    .map((file) => path.basename(file, '.md')));
+  const routes = listFiles(projectRoot, 'routing', /^god.*\.yaml$/);
+  const missing = new Set();
+
+  for (const route of routes) {
+    const parsed = parseRoute(projectRoot, route);
+    const spawns = parsed && parsed.execution && Array.isArray(parsed.execution.spawns)
+      ? parsed.execution.spawns
+      : [];
+    for (const spawn of spawns) {
+      if (!String(spawn).startsWith('god-')) continue;
+      if (!/^god-[a-z0-9-]+$/.test(String(spawn))) continue;
+      if (!agents.has(spawn)) {
+        missing.add(`${route}:${spawn}`);
+        addCheck(
+          checks,
+          'agents',
+          `missing-agent-${spawn}`,
+          'stale',
+          route,
+          `${route} references missing agent ${spawn}.`,
+          { spawn: 'god-auditor' }
+        );
+      }
+    }
+  }
+
+  if (missing.size === 0) {
+    addCheck(checks, 'agents', 'route-spawn-targets', 'fresh',
+      'routing/', 'All routed specialist spawns resolve to agent files.');
+  }
+
+  return checks;
+}
+
+function workflowRecipeChecks(projectRoot) {
+  const checks = [];
+  const workflows = listFiles(projectRoot, 'workflows', /\.yaml$/);
+  const recipes = listFiles(projectRoot, path.join('routing', 'recipes'), /\.yaml$/);
+  const commandFlows = read(projectRoot, 'docs/command-flows.md');
+
+  for (const workflow of workflows) {
+    const text = read(projectRoot, workflow);
+    const parsed = parseSimpleYaml(text);
+    const hasMetadata = Boolean(parsed.apiVersion || parsed.name || parsed.metadata);
+    addCheck(
+      checks,
+      'workflow',
+      `workflow-metadata-${path.basename(workflow, '.yaml')}`,
+      hasMetadata ? 'fresh' : 'stale',
+      workflow,
+      hasMetadata ? `${workflow} has metadata.` : `${workflow} is missing parseable metadata.`,
+      { spawn: hasMetadata ? null : 'god-roadmap-reconciler' }
+    );
+  }
+
+  for (const recipe of recipes) {
+    const text = read(projectRoot, recipe);
+    const hasCommand = /\/god-[a-z0-9-]+/.test(text);
+    const recipeName = path.basename(recipe, '.yaml');
+    addCheck(
+      checks,
+      'workflow',
+      `recipe-command-${recipeName}`,
+      hasCommand ? 'fresh' : 'stale',
+      recipe,
+      hasCommand ? `${recipe} includes a slash-command route.` : `${recipe} has no slash-command route.`,
+      { spawn: hasCommand ? null : 'god-roadmap-reconciler' }
+    );
+  }
+
+  if (workflows.length > 0) {
+    addCheck(
+      checks,
+      'workflow',
+      'command-flows-workflows',
+      commandFlows.includes('/god-docs') && commandFlows.includes('/god-sync') ? 'fresh' : 'stale',
+      'docs/command-flows.md',
+      'docs/command-flows.md includes core docs and sync flows.',
+      { spawn: 'god-roadmap-reconciler' }
+    );
+  }
+  return checks;
+}
+
+function extensionChecks(projectRoot) {
+  const checks = [];
+  const extRoot = path.join(projectRoot, 'extensions');
+  const pkg = readJson(projectRoot, 'package.json') || {};
+  if (!fs.existsSync(extRoot)) return checks;
+  for (const entry of fs.readdirSync(extRoot, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const packRel = `extensions/${entry.name}`;
+    const manifestRel = `${packRel}/manifest.yaml`;
+    const packageRel = `${packRel}/package.json`;
+    const manifestText = read(projectRoot, manifestRel);
+    const packPkg = readJson(projectRoot, packageRel);
+    const parsed = manifestText ? extensions.parseManifest(manifestText).manifest : null;
+    const validation = parsed ? extensions.validateManifest(parsed, pkg.version || '0.0.0') : ['missing manifest'];
+
+    addCheck(
+      checks,
+      'extensions',
+      `extension-manifest-${entry.name}`,
+      validation.length === 0 ? 'fresh' : 'stale',
+      manifestRel,
+      validation.length === 0
+        ? `${entry.name} manifest validates against current Godpowers.`
+        : `${entry.name} manifest validation failed: ${validation.join('; ')}.`,
+      { spawn: validation.length === 0 ? null : 'god-coordinator' }
+    );
+
+    if (parsed && packPkg) {
+      const sameName = parsed.metadata && parsed.metadata.name === packPkg.name;
+      const sameVersion = parsed.metadata && parsed.metadata.version === packPkg.version;
+      const sameEngine = packPkg.peerDependencies
+        && packPkg.peerDependencies.godpowers === parsed.engines.godpowers;
+      addCheck(checks, 'extensions', `extension-name-${entry.name}`,
+        sameName ? 'fresh' : 'stale', packageRel,
+        sameName ? `${entry.name} package name matches manifest.` : `${entry.name} package name does not match manifest.`,
+        { spawn: sameName ? null : 'god-coordinator' });
+      addCheck(checks, 'extensions', `extension-version-${entry.name}`,
+        sameVersion ? 'fresh' : 'stale', packageRel,
+        sameVersion ? `${entry.name} package version matches manifest.` : `${entry.name} package version does not match manifest.`,
+        { spawn: sameVersion ? null : 'god-coordinator' });
+      addCheck(checks, 'extensions', `extension-engine-${entry.name}`,
+        sameEngine ? 'fresh' : 'stale', packageRel,
+        sameEngine ? `${entry.name} peer dependency matches manifest engine.` : `${entry.name} peer dependency does not match manifest engine.`,
+        { spawn: sameEngine ? null : 'god-coordinator' });
+      for (const kind of ['skills', 'agents', 'workflows']) {
+        const provided = parsed.provides && Array.isArray(parsed.provides[kind])
+          ? parsed.provides[kind]
+          : [];
+        for (const item of provided) {
+          const ext = kind === 'workflows' ? 'yaml' : 'md';
+          const providedRel = `${packRel}/${kind}/${item}.${ext}`;
+          addCheck(checks, 'extensions', `extension-${kind}-${entry.name}-${item}`,
+            exists(projectRoot, providedRel) ? 'fresh' : 'stale',
+            providedRel,
+            exists(projectRoot, providedRel)
+              ? `${providedRel} exists.`
+              : `${providedRel} is missing.`,
+            { spawn: exists(projectRoot, providedRel) ? null : 'god-coordinator' });
+        }
+      }
+    }
+  }
+  return checks;
+}
+
+function releasePolicyChecks(projectRoot) {
+  const checks = [];
+  const docs = repoDocSync.detect(projectRoot);
+  addCheck(
+    checks,
+    'release',
+    'repo-doc-sync-fresh',
+    docs.status === 'fresh' ? 'fresh' : 'stale',
+    'docs/repo-doc-sync.md',
+    docs.status === 'fresh'
+      ? 'Repository documentation sync reports fresh.'
+      : `Repository documentation sync reports ${docs.stale.length} stale checks.`,
+    { spawn: docs.status === 'fresh' ? null : 'god-docs-writer' }
+  );
+  addCheck(
+    checks,
+    'release',
+    'release-checklist-surface-sync',
+    read(projectRoot, 'docs/RELEASE-CHECKLIST.md').includes('repo-surface-sync'),
+    'docs/RELEASE-CHECKLIST.md',
+    'Release checklist references repo-surface-sync readiness.',
+    { spawn: 'god-docs-writer' }
+  );
+  return checks.map((check) => ({
+    ...check,
+    status: check.status === true ? 'fresh' : (check.status === false ? 'stale' : check.status)
+  }));
+}
+
+function detect(projectRoot) {
+  const checks = [
+    ...routingChecks(projectRoot),
+    ...packageChecks(projectRoot),
+    ...agentChecks(projectRoot),
+    ...workflowRecipeChecks(projectRoot),
+    ...extensionChecks(projectRoot),
+    ...releasePolicyChecks(projectRoot)
+  ];
+  const stale = checks.filter((check) => check.status !== 'fresh');
+  const byArea = {};
+  for (const check of checks) {
+    if (!byArea[check.area]) byArea[check.area] = { total: 0, stale: 0 };
+    byArea[check.area].total++;
+    if (check.status !== 'fresh') byArea[check.area].stale++;
+  }
+  const spawnRecommendations = [...new Set(stale.map((check) => check.spawn).filter(Boolean))]
+    .map((agent) => ({
+      agent,
+      reason: `Repo surface drift requires ${agent} judgment.`,
+      paths: [...new Set(stale.filter((check) => check.spawn === agent).map((check) => check.path))].sort()
+    }));
+  return {
+    status: stale.length === 0 ? 'fresh' : 'stale',
+    checks,
+    stale,
+    byArea,
+    spawnRecommendations
+  };
+}
+
+function routeTemplate(command) {
+  const name = command.replace(/^\//, '');
+  return [
+    'apiVersion: godpowers/v1',
+    'kind: CommandRouting',
+    'metadata:',
+    `  command: ${command}`,
+    '  description: ',
+    '  tier: 0',
+    '',
+    'prerequisites:',
+    '  required: []',
+    '',
+    'execution:',
+    '  spawns: [built-in]',
+    '  context: fresh',
+    '  writes: []',
+    '',
+    'success-path:',
+    '  next-recommended: /god-status',
+    '',
+    'failure-path:',
+    '  on-error: /god-doctor',
+    '',
+    'endoff:',
+    '  state-update: none',
+    '  events: [agent.start, agent.end]',
+    ''
+  ].join('\n').replace('description: ', `description: Route metadata for /${name}`);
+}
+
+function applySafeFixes(projectRoot, report, opts = {}) {
+  const applied = [];
+  if (!opts.fixRouting) return applied;
+  for (const check of report.stale) {
+    if (check.area !== 'routing' || !check.safeFix || !check.path.startsWith('routing/')) continue;
+    if (exists(projectRoot, check.path)) continue;
+    const command = `/${path.basename(check.path, '.yaml')}`;
+    write(projectRoot, check.path, routeTemplate(command));
+    applied.push({ path: check.path, check: check.id });
+  }
+  return applied;
+}
+
+function appendLog(projectRoot, before, after, applied) {
+  const now = new Date().toISOString();
+  const lines = [];
+  if (exists(projectRoot, LOG_PATH)) {
+    lines.push(read(projectRoot, LOG_PATH).replace(/\s*$/, ''));
+    lines.push('');
+  } else {
+    lines.push('# Repo Surface Sync Log');
+    lines.push('');
+    lines.push('- [DECISION] This file records structural repository surface sync checks run by Godpowers.');
+    lines.push('- [DECISION] Detection is read-only by default and safe fixes require explicit fix options.');
+    lines.push('');
+  }
+  lines.push(`## ${now}`);
+  lines.push('');
+  lines.push(`- [DECISION] Repo surface sync status before apply was ${before.status}.`);
+  lines.push(`- [DECISION] Repo surface sync status after apply is ${after.status}.`);
+  if (applied.length === 0) {
+    lines.push('- [DECISION] No structural repository surface files were changed.');
+  } else {
+    for (const item of applied) {
+      lines.push(`- [DECISION] Created or refreshed ${item.path} for ${item.check}.`);
+    }
+  }
+  for (const rec of after.spawnRecommendations) {
+    lines.push(`- [HYPOTHESIS] ${rec.agent} should review ${rec.paths.join(', ')}.`);
+  }
+  lines.push('');
+  write(projectRoot, LOG_PATH, lines.join('\n'));
+}
+
+function run(projectRoot, opts = {}) {
+  const before = detect(projectRoot);
+  const applied = applySafeFixes(projectRoot, before, opts);
+  const after = detect(projectRoot);
+  if (opts.log !== false) appendLog(projectRoot, before, after, applied);
+  return {
+    before,
+    after,
+    applied,
+    logPath: opts.log === false ? null : LOG_PATH
+  };
+}
+
+function summary(report) {
+  if (report.status === 'fresh') return 'fresh';
+  return `${report.stale.length} stale across ${Object.keys(report.byArea).length} areas`;
+}
+
+module.exports = {
+  LOG_PATH,
+  REQUIRED_PACKAGE_CHECKS,
+  REQUIRED_PACKAGE_FILE_ENTRIES,
+  detect,
+  run,
+  summary,
+  routeTemplate
+};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "godpowers",
-  "version": "1.6.17",
+  "version": "1.6.19",
   "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"
   },
   "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-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-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",

package/skills/god-docs.md

@@ -28,6 +28,10 @@ documentation claims such as README badges, version references, public surface
 counts, and `/god-doctor` sample counts. Report this as `Agent: none, local
 runtime only`.
 
+Then call `lib/repo-surface-sync.run(projectRoot)` so documentation work sees
+whether route, package, agent, workflow, recipe, extension, or release policy
+surfaces disagree before prose claims are rewritten.
+
 Spawn **god-docs-writer** in fresh context.
 
 The agent:
@@ -62,6 +66,7 @@ Godpowers may invoke docs work proactively in two ways:
 | Docs changed after code changed | Spawn `god-docs-writer` in drift-check mode when current workflow owns docs | Do not invent new docs scope |
 | Code changed after docs that claim current behavior | Suggest `/god-docs` or spawn drift-check inside `/god-mode`, `/god-feature`, `/god-refactor`, or `/god-sync` closeout | Verify claims against code before editing |
 | Repo docs surface drift | Run `lib/repo-doc-sync.run` for safe mechanical fixes, then spawn `god-docs-writer` for prose | Do not auto-invent changelog or release notes |
+| Repo structural surface drift | Run `lib/repo-surface-sync.run` and include findings in docs scope | Do not invent routing or agent ownership prose without evidence |
 | `REVIEW-REQUIRED.md` contains docs drift items | Suggest `/god-review-changes` first | Do not auto-clear review items |
 
 When auto-invoked, show:
@@ -72,6 +77,7 @@ Auto-invoked:
   Agent: god-docs-writer
   Local syncs:
     + repo-doc-sync: <safe mechanical fixes, prose review needed, or no-op>
+    + repo-surface-sync: <structural surface fresh, scoped findings, or no-op>
     + docs-drift-check: <N claims checked, N drift items>
   Artifacts: .godpowers/docs/UPDATE-LOG.md or no-op
   Log: .godpowers/docs/UPDATE-LOG.md

package/skills/god-doctor.md

@@ -126,6 +126,18 @@ helper writes only safe mechanical version, badge, and count claims. It should
 recommend `god-docs-writer` when narrative release, contribution, support, or
 security prose needs judgment.
 
+## Repo Surface Sync
+
+For initialized projects, `/god-doctor` calls `lib/repo-surface-sync.detect`
+as a read-only diagnostic. It reports structural drift across command routing,
+package payload rules, agent spawn targets, workflow metadata, recipe command
+routes, extension packs, and release policy checks.
+
+`/god-doctor --fix` may call
+`lib/repo-surface-sync.run(projectRoot, { fixRouting: true })` to create
+missing routing metadata for shipped slash-command skills. Other structural
+findings should recommend the scoped specialist named by the helper.
+
 ## Implementation
 
 Built-in, no spawned agent. Reads:
@@ -135,6 +147,8 @@ Built-in, no spawned agent. Reads:
 - `lib/feature-awareness.detect(projectRoot)` for existing-project upgrade
   awareness
 - `lib/repo-doc-sync.detect(projectRoot)` for repo documentation freshness
+- `lib/repo-surface-sync.detect(projectRoot)` for structural repo surface
+  freshness
 - `bin/install.js` VERSION constant
 
 ## Exit codes

package/skills/god-mode.md

@@ -307,6 +307,7 @@ Sync status:
     + feature-awareness: <recorded runtime features, refreshed context, or no-op>
     + reverse-sync: <counts and result>
     + repo-doc-sync: <refreshed repo docs, recommended god-docs-writer, or no-op>
+    + repo-surface-sync: <checked structural surfaces, recommended scoped agents, or no-op>
     + pillars-sync: <counts and result>
     + checkpoint-sync: <created, updated, no-op, or skipped>
     + context-refresh: <spawned, no-op, or skipped>
@@ -330,6 +331,11 @@ The mandatory final sync also receives repo documentation sync through
 security policy checks, and Pillars context planning arc-ready before the
 project run is declared complete.
 
+The mandatory final sync also receives repo surface sync through `/god-sync`.
+This keeps routes, packages, agent handoffs, workflow metadata, recipe routes,
+extension packs, and release policy checks aligned before the project run is
+declared complete.
+
 If `/god-mode` resumes an existing `.godpowers` project that lacks Pillars,
 it Pillar-izes the project before continuing. Existing `.godpowers` artifacts
 become managed source references in the relevant `agents/*.md` files.
@@ -352,6 +358,7 @@ Sync status:
     + feature-awareness: <recorded runtime features, refreshed context, or no-op>
     + reverse-sync: <counts and result>
     + repo-doc-sync: <refreshed repo docs, recommended god-docs-writer, or no-op>
+    + repo-surface-sync: <checked structural surfaces, recommended scoped agents, or no-op>
     + pillars-sync: <counts and result>
     + checkpoint-sync: <created, updated, no-op, or skipped>
     + context-refresh: <spawned, no-op, or skipped>

package/skills/god-next.md

@@ -25,6 +25,9 @@ Before reading routing data or calling runtime modules, resolve the Godpowers ru
 4. For status output, load `<runtimeRoot>/lib/dashboard.js` and call
    `dashboard.compute(projectRoot)`. Use `dashboard.render(result)` for the
    shared dashboard section before adding route-specific detail.
+5. If the checkout runtime and installed runtime differ, say which runtime root
+   was used. Only call the output a manual disk scan when `lib/dashboard.js`
+   cannot be loaded at all.
 
 ## Three modes of invocation
 
@@ -347,11 +350,13 @@ Godpowers Next
 
 Godpowers Dashboard
 
+Source: runtime dashboard (lib/dashboard.js)
+
 Current status:
   State: proposal
   Phase: [plain-language phase] (tier [human ordinal] of [human total])
   Step: [current step label] (step [n] of [total steps])
-  Progress: [pct]% ([done] of [total] steps complete)
+  Progress: [pct]% workflow progress ([done] of [total] tracked steps complete)
   Worktree: [clean | modified files unstaged | staged changes | mixed]
   Index: [untouched | staged files listed]
 
@@ -359,7 +364,7 @@ Planning visibility:
   PRD: [done | pending | missing | deferred] [path when present]
   Roadmap: [done | pending | missing | deferred] [path when present]
   Current milestone: [roadmap milestone, phase, tier, or next planning gate]
-  Completion: [pct]% [basis from state.json, PROGRESS.md, or artifacts]
+  Completion basis: [state.json, PROGRESS.md, artifacts, or audit score source]
 
 Suggested next: [/god-X]
 

package/skills/god-status.md

@@ -38,9 +38,10 @@ Re-derive state from disk. Your memory is not authoritative. The file system is.
    - If PROGRESS.md says "done" but artifact is missing: FLAG as phantom resume
    - If artifact exists but PROGRESS.md says "pending": FLAG as untracked work
 8. Report the Godpowers Dashboard from `dashboard.render(result)`:
+   - Dashboard source: runtime dashboard or unavailable manual scan
    - Current mode and scale
    - Current phase, tier number, step label, and step number
-   - Progress summary: percentage, completed step count, current step number
+   - Workflow progress summary: percentage, completed step count, current step number
    - Planning visibility: PRD status, roadmap status, active milestone, and
      completion basis
    - What happened recently, using CHECKPOINT.md actions when available
@@ -55,11 +56,16 @@ Re-derive state from disk. Your memory is not authoritative. The file system is.
 If the runtime module is unavailable, fall back to the manual scan below and
 say `Dashboard engine: unavailable, manual scan used`.
 
+Never mix workflow progress with audit, hygiene, or remediation scores. If an
+audit score is relevant, label it separately as `Audit score`.
+
 ## Output Format
 
 ```text
 Godpowers Dashboard
 
+Source: runtime dashboard (lib/dashboard.js)
+
 Mode: A (greenfield)    Scale: medium
 Started: 2026-05-09
 
@@ -67,7 +73,7 @@ Current status:
   State: in progress
   Phase: Planning (tier 2 of 4, internal tier-1)
   Step: Architecture (step 3 of 13)
-  Progress: 15% (2 of 13 steps complete)
+  Progress: 15% workflow progress (2 of 13 tracked steps complete)
   Worktree: clean
   Index: untouched
 
@@ -75,7 +81,7 @@ Planning visibility:
   PRD: done .godpowers/prd/PRD.md
   Roadmap: pending
   Current milestone: Planning / Architecture
-  Completion: 15% based on PROGRESS.md tracked steps
+  Completion basis: .godpowers/state.json workflow steps
 
 What happened recently:
   1. PRD artifact verified on disk
@@ -173,6 +179,8 @@ Report:
 - Sync: `fresh`, `missing`, `stale`, or `suggest /god-sync`
 - Docs: `fresh`, `<N> stale, suggest /god-docs`, `possible drift, suggest
   /god-docs`, or `repo-doc-sync ran`
+- Repo surface: `fresh`, `<N> stale, suggest /god-doctor`, or
+  `repo-surface-sync ran`
 - Runtime: `not-applicable`, `known URL, suggest /god-test-runtime`, or
   `no known URL, defer deployed verification`
 - Automation: `not configured`, `<N> active`, or

package/skills/god-sync.md

@@ -39,14 +39,19 @@ User runs `/god-sync` after manual changes. Useful for:
    counts, release references, contribution docs, and security policy are
    checked before sync closes. Safe mechanical updates are local runtime work.
    Narrative drift should recommend or spawn `god-docs-writer`.
-5. If repo documentation changed durable project truth, plan or apply Pillars
+5. Call `lib/repo-surface-sync.run(projectRoot)` so command routing, package
+   payload, agent handoffs, workflow metadata, recipe routes, extension packs,
+   and release policy are checked before sync closes. Structural drift should
+   recommend scoped agents such as `god-auditor`, `god-roadmap-reconciler`, or
+   `god-coordinator`.
+6. If repo documentation changed durable project truth, plan or apply Pillars
    updates through `lib/pillars.planArtifactSync` or
    `lib/pillars.applyArtifactSync` under the active Pillars policy.
-6. If `state.json` contains enabled `source-systems`, auto-invoke
+7. If `state.json` contains enabled `source-systems`, auto-invoke
    `lib/source-sync.run(projectRoot)` so current Godpowers progress is written
    back to imported GSD, BMAD, or Superpowers companion files. Report this as
    `Agent: none, local runtime only`.
-7. Spawn god-updater in fresh context with:
+8. Spawn god-updater in fresh context with:
    - The reconciliation verdict (if available from a prior /god-reconcile)
    - Or: re-run reconciliation against current state to detect what changed
    - Recent commits for context
@@ -58,7 +63,7 @@ Auto-invoked:
   Trigger: <manual /god-sync, recipe closeout, /god-mode final sync, or other source>
   Agent: god-updater
   Local syncs:
-    - pending: feature-awareness, reverse-sync, source-sync, repo-doc-sync, pillars-sync, checkpoint-sync, context-refresh
+    - pending: feature-awareness, reverse-sync, source-sync, repo-doc-sync, repo-surface-sync, pillars-sync, checkpoint-sync, context-refresh
   Artifacts: pending
   Log: .godpowers/SYNC-LOG.md
 ```
@@ -86,6 +91,7 @@ Sync status:
     + feature-awareness: <recorded runtime features, refreshed context, or no-op>
     + source-sync: <written GSD/BMAD/Superpowers companion files, no-op, or skipped>
     + repo-doc-sync: <refreshed README badges/counts, recommended god-docs-writer, or no-op>
+    + repo-surface-sync: <checked routes/package/agents/workflows/extensions, recommended scoped agents, or no-op>
     + pillars-sync: <updated N pillar files, no-op, or proposed>
     + checkpoint-sync: <CHECKPOINT.md updated or skipped>
     + context-refresh: <updated AGENTS.md/tool pointers, no-op, or skipped by setting>
@@ -131,6 +137,7 @@ Next:
 | Lost threads | Active threads get progress notes |
 | Pillars drift | Keeps `agents/*.md` aligned with current `.godpowers` artifacts |
 | Repo docs drift | Keeps README badges, repo docs, and release surfaces aligned |
+| Repo surface drift | Keeps routes, packages, agents, workflows, recipes, and extensions aligned |
 
 The loop:
 

package/skills/god-version.md

@@ -14,12 +14,12 @@ Print version and a short capability summary.
 ## Output
 
 ```
-Godpowers v1.6.16
+Godpowers v1.6.19
 Install: /Users/.../.claude/  (matches package.json)
 Surface: 109 skills, 40 agents, 13 workflows, 36 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
+Feature awareness: planning-system migration, source-system sync-back, context refresh, dashboard status labels, repo documentation sync, repo surface sync
 ```
 
 ## Subcommands