godpowers 2.6.0 → 3.0.0

package/agents/god-launch-strategist.md

@@ -69,9 +69,8 @@ For each channel:
 - D+7: post-launch retrospective
 
 ### 6. Shipping Closure
-- Read `.godpowers/deploy/STATE.md`,
-  `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md` if present, and
-  `.godpowers/observe/STATE.md`.
+- Read `.godpowers/state.json` deploy and observe evidence plus
+  `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md` if present.
 - If deploy or observe is waiting on external access, do not create a broad
   dashboard checklist. Reference only the smallest next access item from the
   waiting bundle and write launch state as local-ready with deployed
@@ -96,7 +95,7 @@ For each channel:
 
 ## Output
 
-Write `.godpowers/launch/STATE.md` with all artifacts.
+Return launch evidence for `.godpowers/state.json`; `lib/state-views.js` generates `.godpowers/launch/STATE.md` with the launch artifact summary.
 
 ## Have-Nots
 
@@ -129,7 +128,7 @@ pause. Log to YOLO-DECISIONS.md so the user can revise:
 - Auto-picked tone: direct/professional (default)
 - Auto-picked headline: [actual headline written]
 - Reason: substitution-tested headline that emphasizes the strongest PRD value prop
-- Reversible by: edit `.godpowers/launch/STATE.md` headline section
+- Reversible by: update launch evidence in `.godpowers/state.json` and regenerate the launch state view
 - Timestamp: [ISO 8601]
 ```
 

package/agents/god-observability-engineer.md

@@ -15,10 +15,10 @@ Wire observability.
 
 ## Gate Check
 
-`.godpowers/deploy/STATE.md` exists. App is deployed and reachable, or deploy
-state documents a tested local staging harness plus a single external access
-bundle. A deferred staging URL must not block observability setup when local or
-CI-verifiable checks can still run.
+`.godpowers/state.json` records deploy completion. The deploy evidence says the
+app is deployed and reachable, or it documents a tested local staging harness
+plus a single external access bundle. A deferred staging URL must not block
+observability setup when local or CI-verifiable checks can still run.
 
 ## Process
 
@@ -78,7 +78,7 @@ For each PRD success metric, define an SLO:
 
 ## Output
 
-Write `.godpowers/observe/STATE.md` with:
+Return observability evidence for `.godpowers/state.json`; `lib/state-views.js` generates `.godpowers/observe/STATE.md` with:
 - SLO definitions
 - Error budget policies
 - Alert catalog

package/agents/god-reconciler.md

@@ -82,12 +82,16 @@ For each artifact below, check (in parallel where possible):
 
 ### Tier 3 artifacts
 
-#### DEPLOY (`.godpowers/deploy/STATE.md`)
+#### DEPLOY state evidence
+
+Source: `.godpowers/state.json` `tier-3.deploy`.
 - Does the feature need a new env var?
 - New deploy step (e.g., new service)?
 - Verdict: covered / needs-extension
 
-#### OBSERVE (`.godpowers/observe/STATE.md`)
+#### OBSERVE state evidence
+
+Source: `.godpowers/state.json` `tier-3.observe`.
 - Does the feature need a new SLO?
 - New error budget category?
 - New alert + runbook?
@@ -99,7 +103,9 @@ For each artifact below, check (in parallel where possible):
 - New input source to validate?
 - Verdict: covered / needs-review / new-surface
 
-#### LAUNCH (`.godpowers/launch/STATE.md`)
+#### LAUNCH state evidence
+
+Source: `.godpowers/state.json` `tier-3.launch`.
 - Is the feature user-visible?
 - Does launch copy need updating?
 - New channel-specific messaging needed?
@@ -168,7 +174,7 @@ Return structured JSON to the orchestrating skill:
   "roadmap": { "status": "enhancement", "match": "Milestone 2", "action": "fold in or amend" },
   "stack": { "status": "covered" },
   "repo": { "status": "scaffolded" },
-  "deploy": { "status": "needs-extension", "action": "add env var to deploy/STATE.md" },
+  "deploy": { "status": "needs-extension", "action": "record new env var in state.json deploy evidence" },
   "observe": { "status": "needs-slo", "action": "add SLO for new endpoint" },
   "harden": { "status": "needs-review", "action": "scope-to-new-code review" },
   "launch": { "status": "copy-update", "action": "update landing if launching publicly" },

package/agents/god-retrospective.md

@@ -22,7 +22,7 @@ sprint, not generic platitudes.
 ### 1. Gather Data
 Read:
 - Sprint PLAN.md (what was committed)
-- Sprint slice completion record from `.godpowers/build/STATE.md`
+- Sprint slice completion record from `.godpowers/state.json`
 - Git log for the sprint window
 - Any HANDOFF.md or pause logs from the sprint
 

package/agents/god-updater.md

@@ -54,13 +54,13 @@ After feature work, every artifact that was impacted needs to reflect reality.
 - Validate have-nots S-01 through S-05
 
 ### DEPLOY update (if reconciler said "needs-extension")
-- Update deploy/STATE.md
+- Update `.godpowers/state.json` deploy evidence
 - Document new env vars
 - Update CI/CD config notes
 - Have-nots D-01 through D-08
 
 ### OBSERVE update (if reconciler said "needs-slo" or "needs-alert")
-- Update observe/STATE.md
+- Update `.godpowers/state.json` observe evidence
 - Define new SLO with error budget policy
 - Define new alert with runbook reference
 - Have-nots OB-01 through OB-08
@@ -71,7 +71,7 @@ After feature work, every artifact that was impacted needs to reflect reality.
 - Have-nots H-01 through H-11
 
 ### LAUNCH update (if reconciler said "copy-update" or "new-launch")
-- Update launch/STATE.md
+- Update `.godpowers/state.json` launch evidence
 - Update landing copy if user-visible
 - Substitution-test new copy
 
@@ -260,8 +260,8 @@ Updated:
 - arch/ARCH.md: added ADR-007 (auth refactor)
 - arch/adr/007-auth-refactor.md: created
 - roadmap/ROADMAP.md: Milestone 2 marked complete
-- deploy/STATE.md: added STRIPE_WEBHOOK_SECRET env var
-- observe/STATE.md: added SLO for /api/stripe-webhook (99.5%)
+- state.json tier-3.deploy: added STRIPE_WEBHOOK_SECRET env var
+- state.json tier-3.observe: added SLO for /api/stripe-webhook (99.5%)
 - backlog/BACKLOG.md: resolved entry "Stripe webhook handling"
 - todos/TODOS.md: marked "wire stripe events" as done
 - threads/auth-migration.md: appended progress note

package/bin/install.js

@@ -51,6 +51,7 @@ function showHelp() {
   log('Commands:');
   log('  status               Show the Godpowers Dashboard for a project');
   log('  next                 Show the dashboard and recommended next command');
+  log('  state advance        Update one tracked Godpowers state step');
   log('  gate                 Check a tier artifact gate');
   log('  mcp-info             Show read-only MCP companion setup instructions');
   log('  quick-proof          Show a runnable proof from the shipped fixture');
@@ -65,7 +66,9 @@ function showHelp() {
   }
   log('');
   log('Options:');
-  log('  --project=<path>     Project root for status, next, proof, or automation commands');
+  log('  --project=<path>     Project root for status, next, state, proof, or automation commands');
+  log('  --step=<name>        Step for state advance, such as prd or tier-1.prd');
+  log('  --status=<status>    Status for state advance');
   log('  --tier=<name>        Tier for gate: prd, design, arch, roadmap, stack, repo, build, or harden');
   log('  --json               Emit JSON for status, next, proof, or automation commands');
   log('  --brief              Render compact output for status, next, or proof');
@@ -92,7 +95,7 @@ function showHelp() {
   log('  --codebuddy          Install for CodeBuddy');
   log('  --pi                 Install for Pi');
   log('  --all                Install for all 15 runtimes');
-  log('  --profile=<name>     Install profile: core, builder, maintainer, suite, or full');
+  log('  --profile=<name>     Install profile: core, builder, maintainer, suite, or full (default: core)');
   log('  --minimal            Alias for --profile=core');
   log('  -u, --uninstall      Uninstall Godpowers');
   log('  -h, --help           Show this help message');
@@ -100,6 +103,7 @@ function showHelp() {
   log('Examples:');
   log('  npx godpowers status --project=.');
   log('  npx godpowers next --project=.');
+  log('  npx godpowers state advance --step=prd --status=done --project=.');
   log('  npx godpowers gate --tier=prd --project=.');
   log('  npx godpowers mcp-info --project=.');
   log('  npx godpowers quick-proof --project=.');
@@ -162,15 +166,15 @@ function runInstall(opts, srcDir) {
   log('');
   log(`\x1b[36mProfile:\x1b[0m ${describeProfiles(opts.profile)}`);
   log(`\x1b[36mInstalled:\x1b[0m`);
-  log(`  ${surface.skills} slash commands (try: /god-mode, /god-next, /god-status, /god-progress)`);
+  log(`  ${surface.skills} slash commands (try: /god, /god-plan, /god-status, /god-mode)`);
   log(`  ${surface.agents} specialist agents`);
   log('  Templates and references for artifact discipline');
   log('');
   log(`\x1b[36mNext steps:\x1b[0m`);
   log('  1. Open your AI coding tool in any project directory');
-  log(`  2. Type: \x1b[36m/god-mode\x1b[0m for the full autonomous project run`);
-  log(`     Or:   \x1b[36m/god-next\x1b[0m to see what to run next`);
-  log(`     Or:   \x1b[36m/god-init\x1b[0m to start a new project`);
+  log(`  2. Type: \x1b[36m/god\x1b[0m for the front door`);
+  log(`     Or:   \x1b[36m/god-plan\x1b[0m to start planning`);
+  log(`     Or:   \x1b[36m/god-mode\x1b[0m for the full autonomous project run`);
   log('');
   log(`\x1b[36mDocs:\x1b[0m ${identity.HOMEPAGE_URL}`);
   log('');
@@ -216,6 +220,7 @@ module.exports = {
   runMcpInfoCommand: cliDispatch.runMcpInfoCommand,
   runExtensionScaffoldCommand: cliDispatch.runExtensionScaffoldCommand,
   runGateCommand: cliDispatch.runGateCommand,
+  runStateCommand: cliDispatch.runStateCommand,
   applyDefaultRuntimeSelection,
   runInstall,
   runUninstall,

package/extensions/data-pack/manifest.yaml

@@ -9,7 +9,7 @@ metadata:
     without SLOs, ETL without idempotency.
 
 engines:
-  godpowers: ">=2.0.0 <3.0.0"
+  godpowers: ">=2.0.0 <4.0.0"
 
 provides:
   agents:

package/extensions/data-pack/package.json

@@ -37,6 +37,6 @@
     "README.md"
   ],
   "peerDependencies": {
-    "godpowers": ">=2.0.0 <3.0.0"
+    "godpowers": ">=2.0.0 <4.0.0"
   }
 }

package/extensions/launch-pack/manifest.yaml

@@ -9,7 +9,7 @@ metadata:
     god-launch-strategist with channel expertise.
 
 engines:
-  godpowers: ">=2.0.0 <3.0.0"
+  godpowers: ">=2.0.0 <4.0.0"
 
 provides:
   agents:

package/extensions/launch-pack/package.json

@@ -36,6 +36,6 @@
     "README.md"
   ],
   "peerDependencies": {
-    "godpowers": ">=2.0.0 <3.0.0"
+    "godpowers": ">=2.0.0 <4.0.0"
   }
 }

package/extensions/security-pack/manifest.yaml

@@ -8,7 +8,7 @@ metadata:
     Layers on top of god-harden-auditor with regulation-specific checks.
 
 engines:
-  godpowers: ">=2.0.0 <3.0.0"
+  godpowers: ">=2.0.0 <4.0.0"
 
 provides:
   agents:

package/extensions/security-pack/package.json

@@ -37,6 +37,6 @@
     "README.md"
   ],
   "peerDependencies": {
-    "godpowers": ">=2.0.0 <3.0.0"
+    "godpowers": ">=2.0.0 <4.0.0"
   }
 }

package/fixtures/gate/build-pass/.godpowers/state.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://godpowers.dev/schema/state.v1.json",
+  "version": "1.0.0",
+  "project": {
+    "name": "build-pass",
+    "started": "2026-06-10T00:00:00.000Z"
+  },
+  "tiers": {
+    "tier-2": {
+      "build": {
+        "status": "done",
+        "updated": "2026-06-10T18:08:00.000Z",
+        "artifact": "build/STATE.md",
+        "verification": {
+          "commands": [
+            {
+              "command": "npm test",
+              "status": "pass",
+              "exitCode": 0,
+              "ranAt": "2026-06-10T18:07:00.000Z"
+            },
+            {
+              "command": "npm run lint",
+              "status": "pass",
+              "exitCode": 0,
+              "ranAt": "2026-06-10T18:07:30.000Z"
+            }
+          ]
+        }
+      }
+    }
+  }
+}

package/lib/README.md

@@ -9,6 +9,8 @@ package-level integrations.
 | Module | Purpose |
 |--------|---------|
 | `state.js` | Read, initialize, validate, and write `.godpowers/state.json`. |
+| `state-views.js` | Generate managed markdown views such as `.godpowers/PROGRESS.md` and Godpowers-owned per-tier `STATE.md` files from `state.json`. |
+| `state-advance.js` | Mutate one tracked state step through locking and generated state view refresh. |
 | `state-lock.js` | Coordinate state writes with a lock file. |
 | `intent.js` | Read and validate `intent.yaml` from project roots or `.godpowers/`. |
 | `frontmatter.js` | Parse shared markdown YAML frontmatter for skills, agents, Pillars, checkpoints, and design specs. |

package/lib/artifact-map.js

@@ -9,7 +9,7 @@ const TIER_ARTIFACTS = {
   design: [
     { path: 'DESIGN.md', required: true, lint: true },
     { path: 'PRODUCT.md', required: false, lint: true },
-    { path: '.godpowers/design/STATE.md', required: true, lint: true }
+    { path: '.godpowers/state.json', required: true, lint: false }
   ],
   arch: [
     { path: '.godpowers/arch/ARCH.md', required: true, lint: true }
@@ -24,13 +24,18 @@ const TIER_ARTIFACTS = {
     { path: '.godpowers/repo/AUDIT.md', required: true, lint: true }
   ],
   build: [
-    { path: '.godpowers/build/STATE.md', required: true, lint: true }
+    { path: '.godpowers/state.json', required: true, lint: false }
   ],
   harden: [
     { path: '.godpowers/harden/FINDINGS.md', required: true, lint: true }
   ]
 };
 
+const TIER_STATE_STEPS = {
+  design: { tierKey: 'tier-1', subStepKey: 'design' },
+  build: { tierKey: 'tier-2', subStepKey: 'build' }
+};
+
 function normalizeTier(tier) {
   if (!tier) return null;
   return String(tier).replace(/^\/?god-/, '').toLowerCase();
@@ -51,10 +56,17 @@ function requiredArtifactsForTier(tier) {
   return artifacts ? artifacts.filter((artifact) => artifact.required) : null;
 }
 
+function stateStepForTier(tier) {
+  const key = normalizeTier(tier);
+  if (!key || !TIER_STATE_STEPS[key]) return null;
+  return { ...TIER_STATE_STEPS[key] };
+}
+
 module.exports = {
   TIER_ARTIFACTS,
   normalizeTier,
   tiers,
   artifactsForTier,
-  requiredArtifactsForTier
+  requiredArtifactsForTier,
+  stateStepForTier
 };

package/lib/cli-dispatch.js

@@ -4,6 +4,7 @@
 
 const gate = require('./gate');
 const identity = require('./package-identity');
+const stateAdvance = require('./state-advance');
 
 const VERSION = identity.PACKAGE_VERSION;
 
@@ -140,9 +141,45 @@ function runGateCommand(opts) {
   }
 }
 
+function runStateCommand(opts) {
+  if (opts.stateAction !== 'advance') {
+    const result = {
+      command: 'state',
+      verdict: 'fail',
+      project: opts.project,
+      step: opts.step || null,
+      status: opts.status || null,
+      previousStatus: null,
+      updated: null,
+      warnings: [],
+      checks: [{ id: 'state-action-required', status: 'fail', artifact: '.godpowers/state.json', reason: 'state requires subcommand advance' }],
+      findings: [{ id: 'state-action-required', severity: 'error', artifact: '.godpowers/state.json', reason: 'state requires subcommand advance' }],
+      summary: { updated: false, state: '.godpowers/state.json', views: ['.godpowers/PROGRESS.md'] }
+    };
+    if (opts.json) console.log(JSON.stringify(result, null, 2));
+    else console.log(stateAdvance.render(result));
+    process.exitCode = 1;
+    return;
+  }
+
+  const result = stateAdvance.advance(opts.project, {
+    step: opts.step,
+    status: opts.status
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(stateAdvance.render(result));
+  }
+  if (stateAdvance.exitCode(result) !== 0) {
+    process.exitCode = 1;
+  }
+}
+
 const COMMAND_RUNNERS = {
   status: runDashboardCommand,
   next: runDashboardCommand,
+  state: runStateCommand,
   'quick-proof': runQuickProofCommand,
   'mcp-info': runMcpInfoCommand,
   'automation-status': runAutomationCommand,
@@ -170,5 +207,6 @@ module.exports = {
   runQuickProofCommand,
   runMcpInfoCommand,
   runExtensionScaffoldCommand,
-  runGateCommand
+  runGateCommand,
+  runStateCommand
 };

package/lib/command-families.js

@@ -17,6 +17,7 @@ const COMMAND_FAMILIES = [
       '/god',
       '/god-init',
       '/god-mode',
+      '/god-plan',
       '/god-explore',
       '/god-discuss',
       '/god-list-assumptions',
@@ -42,8 +43,6 @@ const COMMAND_FAMILIES = [
       '/god-status',
       '/god-next',
       '/god-progress',
-      '/god-lifecycle',
-      '/god-locate',
       '/god-resume-work',
       '/god-pause-work'
     ]
@@ -54,6 +53,7 @@ const COMMAND_FAMILIES = [
     purpose: 'Plan, implement, test, and ship product work.',
     commands: [
       '/god-build',
+      '/god-fix',
       '/god-feature',
       '/god-story',
       '/god-stories',
@@ -91,6 +91,7 @@ const COMMAND_FAMILIES = [
     purpose: 'Deploy, observe, harden, launch, and respond in production.',
     commands: [
       '/god-deploy',
+      '/god-ship',
       '/god-observe',
       '/god-harden',
       '/god-launch',
@@ -128,6 +129,7 @@ const COMMAND_FAMILIES = [
     purpose: 'Save thoughts, tasks, backlog items, seeds, and learnings.',
     commands: [
       '/god-note',
+      '/god-capture',
       '/god-add-todo',
       '/god-check-todos',
       '/god-add-backlog',
@@ -158,6 +160,7 @@ const COMMAND_FAMILIES = [
     purpose: 'Install, inspect, test, remove, or author extension packs.',
     commands: [
       '/god-extension-scaffold',
+      '/god-extend',
       '/god-extension-add',
       '/god-extension-list',
       '/god-extension-info',
@@ -204,7 +207,9 @@ const COMMAND_FAMILIES = [
     purpose: 'Deprecated full-profile commands kept for backward compatibility.',
     visibility: 'hidden',
     commands: [
-      '/god-roadmap-check'
+      '/god-roadmap-check',
+      '/god-lifecycle',
+      '/god-locate'
     ]
   }
 ];
@@ -212,8 +217,8 @@ const COMMAND_FAMILIES = [
 const STATUS_VIEWS = [
   { id: 'overview', command: '/god-status', label: 'Overview', purpose: 'Operational state, proactive checks, and blockers.' },
   { id: 'progress', command: '/god-progress', label: 'Progress', purpose: 'Requirement and roadmap increment completion.' },
-  { id: 'lifecycle', command: '/god-lifecycle', label: 'Lifecycle', purpose: 'Project phase and fitting workflows.' },
-  { id: 'locate', command: '/god-locate', label: 'Locate', purpose: 'Resume orientation from checkpoint and disk state.' },
+  { id: 'lifecycle', command: '/god-status --lifecycle', label: 'Lifecycle', purpose: 'Project phase and fitting workflows.' },
+  { id: 'locate', command: '/god-status --locate', label: 'Locate', purpose: 'Resume orientation from checkpoint and disk state.' },
   { id: 'next', command: '/god-next', label: 'Next', purpose: 'Single recommended command with reason.' }
 ];
 
@@ -275,11 +280,11 @@ const TRIGGER_PRECEDENCE = {
     reason: 'Progress answers deliverables while status answers operational state.'
   },
   'where am i': {
-    default: '/god-lifecycle',
+    default: '/god-status --lifecycle',
     conditional: [
-      { command: '/god-locate', when: 'checkpoint-or-handoff-exists', reason: 'Resume artifacts exist on disk.' }
+      { command: '/god-status --locate', when: 'checkpoint-or-handoff-exists', reason: 'Resume artifacts exist on disk.' }
     ],
-    reason: 'Lifecycle explains the phase while locate orients a resumed session.'
+    reason: 'Status flags explain the phase or orient a resumed session.'
   }
 };
 

package/lib/context-writer.js

@@ -83,13 +83,13 @@ function buildCanonicalContent(state, opts = {}) {
   const scale = (state && (state.scale || (state.project && state.project.scale))) || opts.scale || 'unknown';
   lines.push(`- Project: ${projectName}`);
   lines.push(`- Mode: ${mode}    Scale: ${scale}`);
-  lines.push('- State: `.godpowers/state.json` (machine) and `.godpowers/PROGRESS.md` (human)');
+  lines.push('- State: `.godpowers/state.json` is authority; `.godpowers/PROGRESS.md` is generated for humans');
   lines.push('');
 
   lines.push('### Quarterback rule');
   lines.push('');
-  lines.push('There is exactly one orchestrator: `god-orchestrator`. It owns all writes to');
-  lines.push('`state.json`, `PROGRESS.md`, `intent.yaml`, and `events.jsonl`. Skills like');
+  lines.push('There is exactly one orchestrator: `god-orchestrator`. It owns writes to');
+  lines.push('`state.json`, `intent.yaml`, and `events.jsonl`; `PROGRESS.md` is regenerated from state. Skills like');
   lines.push('`/god`, `/god-next`, `/god-status` read state without writing.');
   lines.push('');
 
@@ -148,7 +148,7 @@ function buildCanonicalContent(state, opts = {}) {
     }
   }
 
-  lines.push('See `.godpowers/PROGRESS.md` for the live tier table.');
+  lines.push('See `.godpowers/state.json` for authority and `.godpowers/PROGRESS.md` for the generated tier table.');
   return lines.join('\n');
 }