godpowers 1.6.11 → 1.6.13

package/lib/dashboard.js

@@ -0,0 +1,311 @@
+/**
+ * Godpowers Dashboard
+ *
+ * Shared executable status engine for /god-status, /god-next, /god-sync,
+ * /god-scan, and /god-mode closeouts. Disk state is authoritative.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const cp = require('child_process');
+
+const state = require('./state');
+const router = require('./router');
+const automationProviders = require('./automation-providers');
+
+const GOD_DIR = '.godpowers';
+const PRD_PATH = '.godpowers/prd/PRD.md';
+const ROADMAP_PATH = '.godpowers/roadmap/ROADMAP.md';
+const CHECKPOINT_PATH = '.godpowers/CHECKPOINT.md';
+const SYNC_LOG_PATH = '.godpowers/SYNC-LOG.md';
+const REVIEW_PATH = '.godpowers/REVIEW-REQUIRED.md';
+
+function exists(projectRoot, relPath) {
+  return fs.existsSync(path.join(projectRoot, relPath));
+}
+
+function readText(projectRoot, relPath) {
+  const file = path.join(projectRoot, relPath);
+  if (!fs.existsSync(file)) return '';
+  return fs.readFileSync(file, 'utf8');
+}
+
+function mtimeMs(projectRoot, relPath) {
+  const file = path.join(projectRoot, relPath);
+  if (!fs.existsSync(file)) return null;
+  return fs.statSync(file).mtimeMs;
+}
+
+function artifactStatus(projectRoot, relPath) {
+  return exists(projectRoot, relPath) ? 'done' : 'missing';
+}
+
+function currentPhase(progress) {
+  const current = progress && progress.current;
+  if (!current) {
+    return {
+      phase: 'Complete',
+      tierKey: null,
+      tierNumber: null,
+      tierTotal: 0,
+      tierOrdinal: 0,
+      tierCount: 0,
+      tierLabel: 'Complete',
+      stepLabel: 'Complete',
+      stepNumber: 0,
+      totalSteps: progress ? progress.total : 0
+    };
+  }
+
+  const tierNumbers = (progress.tiers || [])
+    .map(tier => tier.tierNumber)
+    .filter(n => Number.isFinite(n))
+    .sort((a, b) => a - b);
+  const tierTotal = tierNumbers.length > 0 ? Math.max(...tierNumbers) : current.tierNumber;
+  const tierOrdinal = tierNumbers.indexOf(current.tierNumber) + 1;
+  const tierCount = tierNumbers.length || (Number.isFinite(current.tierNumber) ? current.tierNumber + 1 : 0);
+
+  return {
+    phase: current.tierLabel,
+    tierKey: current.tierKey,
+    tierNumber: current.tierNumber,
+    tierTotal,
+    tierOrdinal: tierOrdinal > 0 ? tierOrdinal : 1,
+    tierCount,
+    tierLabel: current.tierLabel,
+    stepLabel: current.subStepLabel,
+    stepNumber: current.ordinal,
+    totalSteps: progress.total
+  };
+}
+
+function worktree(projectRoot) {
+  try {
+    const out = cp.execFileSync('git', ['status', '--porcelain'], {
+      cwd: projectRoot,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore']
+    });
+    return parseGitStatus(out);
+  } catch (e) {
+    return { worktree: 'unknown', index: 'unknown', entries: [] };
+  }
+}
+
+function parseGitStatus(out) {
+  if (!out || !out.trim()) {
+    return { worktree: 'clean', index: 'untouched', entries: [] };
+  }
+  const entries = out.split(/\r?\n/).filter(Boolean);
+  const staged = entries.filter(line => line[0] !== ' ' && line[0] !== '?');
+  const unstaged = entries.filter(line => line[1] !== ' ' || line.startsWith('??'));
+  let worktreeState = 'modified files unstaged';
+  if (staged.length > 0 && unstaged.length > 0) worktreeState = 'mixed';
+  else if (staged.length > 0) worktreeState = 'staged changes';
+  return {
+    worktree: worktreeState,
+    index: staged.length > 0 ? staged.map(statusPath).join(', ') : 'untouched',
+    entries
+  };
+}
+
+function statusPath(line) {
+  if (line.startsWith('?? ')) return line.slice(3);
+  return line.length > 3 ? line.slice(3) : line.trim();
+}
+
+function reviewCount(projectRoot) {
+  const text = readText(projectRoot, REVIEW_PATH);
+  if (!text.trim()) return 0;
+  const unchecked = (text.match(/\[\s\]\s*(?:TODO|PENDING|OPEN|REVIEW|BLOCKER|[Pp][0-3])/g) || []).length;
+  if (unchecked > 0) return unchecked;
+  const headings = (text.match(/^###\s+/gm) || []).length;
+  return headings;
+}
+
+function hasRecentPath(projectRoot, relPath, maxAgeMs) {
+  const modified = mtimeMs(projectRoot, relPath);
+  if (!modified) return false;
+  return Date.now() - modified <= maxAgeMs;
+}
+
+function proactiveChecks(projectRoot, changedFiles = []) {
+  const oneDay = 24 * 60 * 60 * 1000;
+  const thirtyDays = 30 * oneDay;
+  const reviews = reviewCount(projectRoot);
+
+  const checkpoint = exists(projectRoot, CHECKPOINT_PATH)
+    ? (hasRecentPath(projectRoot, CHECKPOINT_PATH, oneDay) ? 'fresh' : 'stale')
+    : 'missing';
+
+  const sync = exists(projectRoot, SYNC_LOG_PATH)
+    ? (hasRecentPath(projectRoot, SYNC_LOG_PATH, oneDay) ? 'fresh' : 'stale, suggest /god-sync')
+    : 'missing, suggest /god-sync';
+
+  const hygieneFresh = exists(projectRoot, CHECKPOINT_PATH)
+    && hasRecentPath(projectRoot, CHECKPOINT_PATH, thirtyDays);
+
+  const pkgChanged = changedFiles.some(file => [
+    'package.json',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'yarn.lock'
+  ].includes(file));
+  const sensitiveChanged = changedFiles.some(file => matchesAnyPrefix(file, [
+    '.env.example',
+    'SECURITY.md',
+    '.github/workflows',
+    'auth',
+    'security'
+  ]));
+
+  return {
+    checkpoint,
+    reviews: reviews > 0 ? `${reviews} pending, suggest /god-review-changes` : 'none',
+    sync,
+    docs: 'fresh',
+    runtime: 'not-applicable',
+    automation: automationSummary(projectRoot),
+    security: sensitiveChanged ? 'sensitive files changed, suggest /god-harden' : 'clear',
+    dependencies: pkgChanged ? 'dependency files changed, suggest /god-update-deps' : 'clear',
+    hygiene: hygieneFresh ? 'fresh' : 'stale, suggest /god-hygiene'
+  };
+}
+
+function automationSummary(projectRoot) {
+  const report = automationProviders.detect(projectRoot);
+  if (report.active.length > 0) {
+    return `${report.active.length} active`;
+  }
+  if (report.recommendedProvider) {
+    return `available via ${report.recommendedProvider.id}, suggest /god-automation-setup`;
+  }
+  return 'not configured';
+}
+
+function matchesAnyPrefix(file, prefixes) {
+  return prefixes.some(prefix => file === prefix || file.startsWith(`${prefix}/`));
+}
+
+function planningVisibility(projectRoot, progress) {
+  const prd = artifactStatus(projectRoot, PRD_PATH);
+  const roadmap = artifactStatus(projectRoot, ROADMAP_PATH);
+  const phase = currentPhase(progress);
+  return {
+    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`
+  };
+}
+
+function compute(projectRoot, opts = {}) {
+  const s = state.read(projectRoot);
+  const git = opts.git === false ? { worktree: 'not-checked', index: 'not-checked', entries: [] } : worktree(projectRoot);
+
+  if (!s) {
+    const next = { command: '/god-init', reason: 'No Godpowers project initialized' };
+    return {
+      state: 'not initialized',
+      mode: null,
+      lifecycle: 'pre-init',
+      progress: { percent: 0, completed: 0, total: 0, currentStep: 0, current: null, tiers: [] },
+      current: currentPhase(null),
+      worktree: git.worktree,
+      index: git.index,
+      planning: {
+        prd: { status: 'missing', path: null },
+        roadmap: { status: 'missing', path: null },
+        currentMilestone: 'Project initialization',
+        completion: '0% based on missing state.json'
+      },
+      proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+      next,
+      openItems: ['No .godpowers/state.json found']
+    };
+  }
+
+  const progress = state.progressSummary(s);
+  const current = currentPhase(progress);
+  const next = router.suggestNext(projectRoot);
+  const openItems = [];
+  const drift = state.detectDrift(projectRoot);
+
+  if (drift.length > 0) openItems.push(`${drift.length} artifact drift item(s), suggest /god-repair`);
+  if (next && next.blocker) openItems.push(`${next.blocker} blocks next route`);
+  if (reviewCount(projectRoot) > 0) openItems.push('pending review items');
+  if (openItems.length === 0) openItems.push('none');
+
+  return {
+    state: progress.remaining === 0 ? 'complete' : 'in progress',
+    mode: s.mode || s['mode-announced-as'] || null,
+    lifecycle: s['lifecycle-phase'] || 'in-arc',
+    progress,
+    current,
+    worktree: git.worktree,
+    index: git.index,
+    planning: planningVisibility(projectRoot, progress),
+    proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+    next,
+    openItems
+  };
+}
+
+function render(dashboard) {
+  const current = dashboard.current || {};
+  const planning = dashboard.planning || {};
+  const proactive = dashboard.proactive || {};
+  const next = dashboard.next || {};
+  const progress = dashboard.progress || {};
+  const prd = planning.prd || {};
+  const roadmap = planning.roadmap || {};
+  const openItems = dashboard.openItems && dashboard.openItems.length > 0
+    ? dashboard.openItems
+    : ['none'];
+
+  return [
+    'Godpowers Dashboard',
+    '',
+    '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)`,
+    `  Worktree: ${dashboard.worktree}`,
+    `  Index: ${dashboard.index}`,
+    '',
+    'Planning visibility:',
+    `  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'}`,
+    '',
+    'Proactive checks:',
+    `  Checkpoint: ${proactive.checkpoint || 'unknown'}`,
+    `  Reviews: ${proactive.reviews || 'unknown'}`,
+    `  Sync: ${proactive.sync || 'unknown'}`,
+    `  Docs: ${proactive.docs || 'unknown'}`,
+    `  Runtime: ${proactive.runtime || 'unknown'}`,
+    `  Automation: ${proactive.automation || 'unknown'}`,
+    `  Security: ${proactive.security || 'unknown'}`,
+    `  Dependencies: ${proactive.dependencies || 'unknown'}`,
+    `  Hygiene: ${proactive.hygiene || 'unknown'}`,
+    '',
+    'Open items:',
+    ...openItems.map((item, index) => `  ${index + 1}. ${item}`),
+    '',
+    'Next:',
+    `  Recommended: ${next.command || 'describe the next intent'}`,
+    `  Why: ${next.reason || 'No route was computed.'}`
+  ].join('\n');
+}
+
+module.exports = {
+  compute,
+  render,
+  worktree,
+  parseGitStatus,
+  proactiveChecks,
+  automationSummary,
+  planningVisibility
+};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "godpowers",
-  "version": "1.6.11",
-  "description": "AI-powered development system: 106 slash commands and 39 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.",
+  "version": "1.6.13",
+  "description": "AI-powered development system: 108 slash commands and 39 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-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-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-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/routing/god-automation-setup.yaml

@@ -0,0 +1,25 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-automation-setup
+  description: Prepare opt-in host automation setup
+  tier: 0
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  writes:
+    - .godpowers/automations.json
+
+success-path:
+  next-recommended: /god-automation-status
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: tier-0 updated for /god-automation-setup
+  events: [agent.start, artifact.created, agent.end]

package/routing/god-automation-status.yaml

@@ -0,0 +1,24 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-automation-status
+  description: Show host automation provider support
+  tier: 0
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  writes: []
+
+success-path:
+  next-recommended: /god-automation-setup
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: tier-0 updated for /god-automation-status
+  events: [agent.start, agent.end]

package/skills/god-automation-setup.md

@@ -0,0 +1,105 @@
+---
+name: god-automation-setup
+description: |
+  Prepare an explicit opt-in setup plan for host-native Godpowers automation.
+  Never creates schedules, routines, background agents, API triggers, or CI
+  workflows without user approval.
+
+  Triggers on: "god automation setup", "set up background automation", "make godpowers proactive"
+---
+
+# /god-automation-setup
+
+Prepare a safe, host-native automation setup plan.
+
+## Process
+
+1. Resolve the runtime root and load `<runtimeRoot>/lib/automation-providers.js`.
+2. Call `automation.setupPlan(projectRoot)`.
+3. Print `automation.renderSetupPlan(plan)`.
+4. Ask the user to choose:
+   - provider
+   - templates
+   - cadence
+   - connector or repository scope
+   - whether write actions are allowed
+5. Create provider-native automation only if the current host exposes a safe
+   automation tool and the user explicitly approved the exact provider,
+   template, cadence, and scope.
+6. After creation, write or update `.godpowers/automations.json` with:
+   - automation id
+   - provider id
+   - status
+   - cadence
+   - prompt summary
+   - created timestamp
+   - host surface used
+7. Run `/god-automation-status` after setup and show the result.
+
+## Hard Stops
+
+Do not create automations during install.
+
+Do not create any automation that can do these unless the user explicitly asks
+for that exact write-capable automation:
+
+- stage, commit, push, merge, package, publish, or release
+- deploy to staging or production
+- access provider dashboards, DNS, credentials, secrets, or billing
+- clear `.godpowers/REVIEW-REQUIRED.md`
+- accept Critical security findings
+- run broad dependency upgrades
+- delete files, reset branches, or clean worktrees
+
+## Safe Starting Templates
+
+- `daily-status`: run `godpowers status --project .` and summarize current phase, progress, open items, and next action
+- `stale-checkpoint`: inspect checkpoint freshness and suggest `/god-sync` or `/god-resume-work`
+- `review-queue`: report unresolved review items without clearing them
+- `weekly-hygiene`: report docs, dependencies, checkpoint, reviews, and hygiene signals
+- `release-readiness`: report release readiness without publishing
+
+## Provider Guidance
+
+- Codex App: use native Codex automations when the host exposes them.
+- Claude Code: use `/schedule` for scheduled routines. Use Claude web for API or GitHub triggers.
+- Cline: use `cline schedule` or the Cline SDK scheduler.
+- Kilo: use KiloClaw Scheduled Triggers.
+- Qwen Code: use `/loop` only for session-scoped checks and report that it is not durable.
+- Cursor: use Background Agents or the Background Agent API for branch-scoped async work.
+- GitHub Copilot: use issues, pull requests, or Copilot cloud agent entry points.
+- Windsurf: install workflows or skills, but report that workflows are manual-only.
+- Gemini CLI, OpenCode, CodeBuddy, and Pi: use headless or SDK execution only with an approved scheduler.
+- Trae and Antigravity: report scheduled automation as unknown unless the host proves otherwise.
+
+## Output Shape
+
+```text
+Godpowers Automation Setup Plan
+
+Recommended provider: <provider>
+
+Setup steps:
+  1. <host-native setup step>
+
+Recommended safe templates:
+  - <template id>: <prompt>
+
+Approval required:
+  - Choose a provider
+  - Choose one or more templates
+  - Confirm any host-native schedule, routine, background agent, API trigger, or connector scope
+```
+
+## Proposition Closeout
+
+End with:
+
+```text
+Proposition:
+  1. Implement partial: create one read-only automation after approval
+  2. Implement complete: create all safe read-only automations after approval
+  3. Discuss more: tune provider, cadence, or safety rules
+  4. Inspect status: /god-automation-status
+Recommended: <one option tied to provider capability and user risk>
+```

package/skills/god-automation-status.md

@@ -0,0 +1,76 @@
+---
+name: god-automation-status
+description: |
+  Show host-native automation provider support for the current project.
+  Reports Codex App, Claude Routines, Cline schedules, Qwen loops, Cursor
+  background agents, Copilot cloud agent, and scriptable CLI providers.
+
+  Triggers on: "god automation status", "automation support", "background automation status"
+---
+
+# /god-automation-status
+
+Show which automation providers Godpowers can safely use in this project.
+
+## Process
+
+1. Resolve the runtime root and load `<runtimeRoot>/lib/automation-providers.js`.
+2. Call `automation.detect(projectRoot)`.
+3. Print `automation.render(result)`.
+4. Read `.godpowers/automations.json` if present and report active automations.
+5. Do not create, update, trigger, pause, resume, or delete schedules.
+6. Do not stage, commit, push, publish, deploy, clear review queues, or access
+   provider dashboards.
+
+If the executable runtime module is unavailable, manually report these provider
+classes:
+
+- native-scheduler: Codex App automations, Claude Code routines, Cline schedules, Kilo scheduled triggers
+- session-scheduler: Qwen Code `/loop`
+- background-agent: Cursor Background Agents, GitHub Copilot cloud agent
+- scriptable-headless: Gemini CLI, OpenCode, CodeBuddy SDK, Pi SDK
+- manual-workflow: Windsurf workflows, Augment subagents
+- unknown: Trae, Antigravity scheduled automation
+
+## Output Shape
+
+```text
+Godpowers Automation Providers
+
+Config: .godpowers/automations.json
+Recommended provider: <provider or none available>
+
+Active automations:
+  - <id via provider: status or none recorded>
+
+Provider status:
+  - <provider>: <status> (<class>)
+
+Safe templates:
+  - daily-status: Daily Godpowers status, Daily at 9am local time, read-only
+  - stale-checkpoint: Stale checkpoint watcher, Weekdays at 9am local time, read-only
+  - review-queue: Review queue watcher, Daily at 10am local time, read-only
+  - weekly-hygiene: Weekly hygiene report, Monday at 9am local time, read-only
+  - release-readiness: Release readiness report, Manual or before release, read-only
+
+Safety rules:
+  - Do not create automations during install.
+  - Create schedules, routines, background agents, or API triggers only after explicit user approval.
+  - Default templates are read-only.
+```
+
+## Proposition Closeout
+
+End with:
+
+```text
+Proposition:
+  1. Implement partial: /god-automation-setup for one safe read-only template
+  2. Implement complete: /god-automation-setup for all safe templates supported by the current host
+  3. Discuss more: /god-discuss automation policy and provider choice
+  4. Inspect status: /god-status to see project progress and automation status together
+Recommended: <one option tied to the detected provider>
+```
+
+If no provider is available, recommend manual `/god-next` or
+`godpowers next --project .`.

package/skills/god-doctor.md

@@ -46,7 +46,7 @@ Plain-text report grouped by severity:
 GODPOWERS DOCTOR
 
 Install: claude (~/.claude/)
-  [OK] 106 skills installed
+  [OK] 108 skills installed
   [OK] 39 agents installed
   [OK] VERSION matches (1.6.6)
   [WARN] routing/god-doctor.yaml exists but skill file did not until now

package/skills/god-mode.md

@@ -178,8 +178,9 @@ Show:
 - short progress updates for phases, commands, validations, and file edits
 - concise validation summaries instead of full command noise when possible
 - final changed paths, validation results, and completion or pause status
-- final current status, open items, worktree/index state, and recommended next
-  action
+- final Godpowers Dashboard from disk, including phase, tier, step, progress,
+  planning visibility, proactive checks, open items, worktree/index state, and
+  recommended next action
 
 Hide:
 - raw spawn input
@@ -202,11 +203,11 @@ missing them, synthesize them from disk state before continuing.
 
 Before work starts:
 
-```
+```text
 Next step
-Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
-Tier: <tier-number> <tier-label>
+Phase: <plain-language phase> (tier <human ordinal> of <human total>)
 Step: <sub-step-label>
+Progress: <pct>% (<done> of <total> steps complete; step <n> of <total>)
 Why this now: <one sentence>
 What will happen:
   1. <observable action>
@@ -216,11 +217,11 @@ Expected output: <artifact path or verification result>
 
 After work completes or pauses:
 
-```
+```text
 Step result
-Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
-Tier: <tier-number> <tier-label>
+Phase: <plain-language phase> (tier <human ordinal> of <human total>)
 Step: <sub-step-label>
+Progress: <pct>% (<done> of <total> steps complete; step <n> of <total>)
 Result: <done | blocked | failed | skipped | imported>
 What happened:
   1. <observable action completed>