godpowers 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.1] - 2026-05-30
+
+### Fixed
+- Made `.godpowers/REQUIREMENTS.md` stable on no-op regenerations by ignoring
+  generated timestamp-only changes and removing the extra blank line at EOF.
+- Persisted reverse-sync deliverable summaries into `state.json.deliverables`,
+  matching the documented `/god-sync` and reverse-sync behavior.
+- Reconciled the Godpowers self-ledger so the shipped deliverable-progress
+  feature is marked done in `.godpowers/roadmap/ROADMAP.md`,
+  `.godpowers/REQUIREMENTS.md`, and `.godpowers/state.json`.
+
 ## [2.2.0] - 2026-05-30
 
 ### Added

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-2.2.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.2.1-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.**
@@ -21,7 +21,7 @@ Godpowers makes AI coding accountable: every serious run should leave disk
 state, artifacts, validation gates, host guarantees, and a next action. Code is
 only one output. The project memory and proof trail matter too.
 
-Version 2.2.0 keeps the proof loop executable. `npx godpowers quick-proof
+Version 2.2.1 keeps the proof loop executable. `npx godpowers quick-proof
 --project=.` now renders a shipped fixture with real `.godpowers/state.json`,
 computed next action, missing-artifact visibility, and host guarantees. The
 2.0 line also ships a proof transcript, adoption canary harness, published npm

package/RELEASE.md

@@ -1,11 +1,11 @@
-# Godpowers 2.2.0 Release
+# Godpowers 2.2.1 Release
 
 > Status: Ready for release
 > Date: 2026-05-30
 
-Godpowers 2.2.0 adds deliverable progress tracking on top of the 2.1.1
-documentation and off-switch safety patch. It keeps the public slash-command
-surface stable and backward compatible.
+Godpowers 2.2.1 is a patch release for the 2.2 deliverable-progress line. It
+keeps the public slash-command surface stable and fixes ledger persistence,
+idempotence, and release-state reconciliation.
 
 ## What's in this release
 
@@ -16,23 +16,15 @@ surface stable and backward compatible.
 
 ## Highlights
 
-- Deliverable progress tracking: the new `/god-progress` command and the
-  `.godpowers/REQUIREMENTS.md` ledger report which PRD requirements and roadmap
-  increments are done, in progress, or not started. Status is derived from the
-  linkage map by `lib/requirements.js`, so it cannot drift from the code that is
-  actually implemented.
-- Stable requirement and increment ids: PRD requirements carry
-  `P-MUST-NN`/`P-SHOULD-NN`/`P-COULD-NN`, and ROADMAP increments carry `M-slug`
-  ids with a per-increment `Status` and member requirement ids.
-- The build chain populates the ledger during real runs: `god-planner` names the
-  requirement ids each slice delivers, `god-executor` stamps `// Implements: P-...`
-  annotations, and the spec and quality reviewers verify them.
-- The dashboard (`/god-status`, `/god-next`, `/god-mode` closeout) gains a
-  `Deliverable progress` section, and a `whats-done` recipe routes natural
-  language like "how far along are we" to `/god-progress`.
-- Documentation reconciled with the shipped surface and version: accurate
-  counts and `/god-progress`/`REQUIREMENTS.md` awareness across README,
-  ARCHITECTURE, reference, linkage, recipes, and the artifact inventories.
+- `.godpowers/REQUIREMENTS.md` no longer rewrites on timestamp-only no-op
+  regenerations, and the generated ledger no longer carries an extra blank line
+  at EOF.
+- `lib/reverse-sync.js` now persists deliverable summaries into
+  `state.json.deliverables`, matching the documented `/god-sync` behavior.
+- The Godpowers self-ledger now reports the shipped deliverable-progress feature
+  as done across roadmap, requirements ledger, and state cache.
+- Regression tests cover no-op ledger writes, state-cache persistence, and
+  no-op reverse-sync stability.
 
 ## Validation
 
@@ -42,14 +34,14 @@ surface stable and backward compatible.
 
 ## Upgrade
 
-- `npm install -g godpowers@2.2.0` or `npx godpowers@2.2.0`
+- `npm install -g godpowers@2.2.1` or `npx godpowers@2.2.1`
 - Re-run `/god-context` in each project to refresh installed runtime metadata
 - No breaking changes; existing `.godpowers/` state is compatible. Projects gain
   a `REQUIREMENTS.md` ledger the next time `/god-progress` or `/god-sync` runs.
 
 ## Notes
 
-- GitHub release creation for `v2.2.0`
+- GitHub release creation for `v2.2.1`
 - The tag should match the npm package version
-- The `v2.2.0` tag should point to the release commit that matches the npm
-  `godpowers@2.2.0` package.
+- The `v2.2.1` tag should point to the release commit that matches the npm
+  `godpowers@2.2.1` package.

package/lib/requirements.js

@@ -363,6 +363,27 @@ function progressBar(done, total, width = 20) {
 
 const MARK = { done: '[x]', 'in-progress': '[~]', untouched: '[ ]' };
 const INC_MARK = { done: '[x]', building: '[~]', pending: '[ ]' };
+const UPDATED_LINE_RE = /^Updated: .+$/m;
+
+function finishLedger(lines) {
+  while (lines.length > 0 && lines[lines.length - 1] === '') lines.pop();
+  return lines.join('\n');
+}
+
+function normalizeLedgerTimestamp(content) {
+  return String(content).replace(UPDATED_LINE_RE, 'Updated: <timestamp>');
+}
+
+function withoutUpdated(value) {
+  if (!value || typeof value !== 'object') return value;
+  const copy = JSON.parse(JSON.stringify(value));
+  delete copy.updated;
+  return copy;
+}
+
+function sameIgnoringUpdated(a, b) {
+  return JSON.stringify(withoutUpdated(a)) === JSON.stringify(withoutUpdated(b));
+}
 
 /**
  * Compact lines for the dashboard "Deliverable progress" section.
@@ -411,7 +432,7 @@ function renderLedger(derived) {
     out.push('No requirements are declared yet. Once the PRD lists MUST/SHOULD/COULD');
     out.push('requirements with stable ids (P-MUST-01, ...), they appear here.');
     out.push('');
-    return out.join('\n');
+    return finishLedger(out);
   }
 
   out.push(`Progress: ${progressBar(s.done, s.total)} done (${s.percent}%) | ${s.inProgress} in progress | ${s.untouched} not started`);
@@ -469,23 +490,30 @@ function renderLedger(derived) {
     out.push('');
   }
 
-  return out.join('\n');
+  return finishLedger(out);
 }
 
 function writeLedger(projectRoot, derived) {
   const data = derived || derive(projectRoot);
   const file = path.join(projectRoot, LEDGER_PATH);
   fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, renderLedger(data) + '\n');
+  const rendered = renderLedger(data) + '\n';
+  if (fs.existsSync(file)) {
+    const current = fs.readFileSync(file, 'utf8');
+    if (normalizeLedgerTimestamp(current) === normalizeLedgerTimestamp(rendered)) {
+      return LEDGER_PATH;
+    }
+  }
+  fs.writeFileSync(file, rendered);
   return LEDGER_PATH;
 }
 
 /**
  * Small cacheable summary for state.json (state.deliverables).
  */
-function summarizeForState(derived) {
+function summarizeForState(derived, currentSummary = null) {
   const s = derived.summary;
-  return {
+  const next = {
     updated: derived.updated,
     source: 'PRD + ROADMAP + linkage + build state',
     requirements: {
@@ -505,6 +533,10 @@ function summarizeForState(derived) {
     })),
     gaps: derived.gaps.length
   };
+  if (currentSummary && currentSummary.updated && sameIgnoringUpdated(currentSummary, next)) {
+    next.updated = currentSummary.updated;
+  }
+  return next;
 }
 
 module.exports = {

package/lib/reverse-sync.js

@@ -27,6 +27,7 @@ const reviewRequired = require('./review-required');
 const impeccable = require('./impeccable-bridge');
 const sourceSync = require('./source-sync');
 const requirements = require('./requirements');
+const state = require('./state');
 
 const FENCE_BEGIN = '<!-- godpowers:linkage:begin -->';
 const FENCE_END = '<!-- godpowers:linkage:end -->';
@@ -321,7 +322,15 @@ function run(projectRoot, opts = {}) {
       const derived = requirements.derive(projectRoot);
       if (derived.hasRequirements) {
         requirements.writeLedger(projectRoot, derived);
-        requirementsSummary = requirements.summarizeForState(derived);
+        const currentState = state.read(projectRoot);
+        requirementsSummary = requirements.summarizeForState(
+          derived,
+          currentState && currentState.deliverables
+        );
+        if (currentState) {
+          currentState.deliverables = requirementsSummary;
+          state.write(projectRoot, currentState);
+        }
       }
     } catch (e) {
       requirementsSummary = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "AI-powered development system: 111 slash commands and 40 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
   "bin": {
     "godpowers": "./bin/install.js"

package/skills/god-doctor.md

@@ -50,7 +50,7 @@ GODPOWERS DOCTOR
 Install: claude (~/.claude/)
   [OK] 111 skills installed
   [OK] 40 agents installed
-  [OK] VERSION matches (2.2.0)
+  [OK] VERSION matches (2.2.1)
   [WARN] routing/god-doctor.yaml exists but skill file did not until now
 
 Project: /Users/.../my-project/.godpowers/

package/skills/god-version.md

@@ -14,7 +14,7 @@ Print version and a short capability summary.
 ## Output
 
 ```
-Godpowers v2.2.0
+Godpowers v2.2.1
 Install: /Users/.../.claude/  (matches package.json)
 Surface: 111 skills, 40 agents, 13 workflows, 41 recipes
 Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1