Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions .godpowers/CHECKPOINT.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
id: CHECKPOINT-2026-08-18T04-06-56-142Z
id: CHECKPOINT-2026-08-19T06-45-56-035Z
project: godpowers
mode: B
mode-d-suite: false
Expand All @@ -12,7 +12,7 @@ progress-total: 19
current-step: 19
last-action: tier-0.sync done
last-actor: unknown
last-update: 2026-08-18T04:06:56.142Z
last-update: 2026-08-19T06:45:56.035Z
facts-hash: sha256:6bae3971008651bba3c5c4943ef21f4acfe4d2a17ac57b165f4c03bf8682d9d9
---
# Checkpoint
Expand All @@ -28,20 +28,20 @@ facts-hash: sha256:6bae3971008651bba3c5c4943ef21f4acfe4d2a17ac57b165f4c03bf8682d
- Lifecycle phase: **steady-state-active**
- Progress: **100%** (19 of 19 steps complete; current step 19 of 19)
- Current tier: **tier-3** / **launch**
- Last action: `tier-0.sync done` by unknown at 2026-08-18T04:06:56.142Z
- Last action: `tier-0.sync done` by unknown at 2026-08-19T06:45:56.035Z

## What happened recently

_(no recent actions recorded yet)_

## What happens next

- /god-feature
- The 6.0.0 release is complete and the project has returned to steady-state feature work.
- /god-ship
- The reviewed 31-test evidence correction is synchronized for the 6.1.0 source candidate; publication remains pending.

## Next suggested command

`/god-feature` - The 6.0.0 release is complete and the project has returned to steady-state feature work.
`/god-ship` - The reviewed 31-test evidence correction is synchronized for the 6.1.0 source candidate; publication remains pending.

## Last actions (most recent first, max 20)

Expand Down Expand Up @@ -74,7 +74,7 @@ _(no actions recorded yet)_

## Provenance

- Generated: 2026-08-18T04:06:56.142Z
- Generated: 2026-08-19T06:45:56.035Z
- Schema version: 1.0
- Authoritative state: `.godpowers/state.json`
- Authoritative history: `.godpowers/runs/<id>/events.jsonl` + `.godpowers/log`
10 changes: 5 additions & 5 deletions .godpowers/PROGRESS.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@
- [DECISION] PRD and ROADMAP were reconstructed from the shipped v2.1.1 codebase with stable requirement ids, and the linkage map was populated via `scripts/reconstruct-self-ledger.js`. Deliverable status lives in `.godpowers/REQUIREMENTS.mdx`: 32 of 33 requirements done, 1 in progress (deliverable-progress, unreleased), 100% requirement-to-code coverage.

<!-- godpowers:state-view:begin -->
<!-- godpowers:checksum sha256:aa342dce75202a050663cc261d7dc88943f7c379d3d27905b985d670199d3167 -->
<!-- godpowers:checksum sha256:6d1b624aacc2f408ae362d260f2a10da4c3d89a37977d6add87a0fdffb45cff1 -->
# Godpowers Progress

- [DECISION] This file is a generated human-readable view of `.godpowers/state.json`.
Expand All @@ -61,12 +61,12 @@
| 4 | Orchestration | Tech Debt | done | tech-debt/ASSESSMENT.mdx | 2026-07-13T05:12:51.236Z |
| 5 | Orchestration | Greenfield Simulation | done | audit/GREENFIELD-SIMULATION.mdx | 2026-07-13T05:12:51.236Z |
| 6 | Orchestration | Greenfieldify | done | audit/GREENFIELDIFY-PLAN.mdx | 2026-07-13T05:45:00.000Z |
| 7 | Orchestration | Sync | done | SYNC-LOG.mdx | 2026-08-18T04:04:11.227Z |
| 8 | Planning | PRD | done | prd/PRD.mdx | 2026-08-18T03:37:48.425Z |
| 7 | Orchestration | Sync | done | SYNC-LOG.mdx | 2026-08-19T06:45:56.026Z |
| 8 | Planning | PRD | done | prd/PRD.mdx | 2026-08-19T06:45:56.026Z |
| 9 | Planning | Design | not-required | - | 2026-07-13T05:12:51.236Z |
| 10 | Planning | Product | not-required | - | 2026-07-13T05:12:51.236Z |
| 11 | Planning | Architecture | done | arch/ARCH.mdx | 2026-08-18T03:37:48.425Z |
| 12 | Planning | Roadmap | done | roadmap/ROADMAP.mdx | 2026-08-18T03:37:48.425Z |
| 11 | Planning | Architecture | done | arch/ARCH.mdx | 2026-08-19T06:24:23.963Z |
| 12 | Planning | Roadmap | done | roadmap/ROADMAP.mdx | 2026-08-19T06:45:56.026Z |
| 13 | Planning | Stack | done | stack/DECISION.mdx | 2026-08-18T03:37:48.425Z |
| 14 | Building | Repo | done | repo/AUDIT.mdx | 2026-07-13T05:57:20.000Z |
| 15 | Building | Build | done | build/STATE.mdx | 2026-08-18T03:46:06.501Z |
Expand Down
15 changes: 11 additions & 4 deletions .godpowers/REQUIREMENTS.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,19 @@
> `/god-progress`, `/god-status`, or `/god-sync`. Do not hand-edit statuses;
> they are recomputed from disk.

Updated: 2026-08-18T03:04:41.200Z
Updated: 2026-08-19T06:21:23.536Z
Source: PRD + ROADMAP + linkage forward map + build state
Progress: [####################] 41/41 done (100%) | 0 in progress | 0 not started
Progress: [####################] 47/47 done (100%) | 0 in progress | 0 not started

## By priority

| Priority | Done | In progress | Not started | Total |
|----------|------|-------------|-------------|-------|
| MUST | 29 | 0 | 0 | 29 |
| MUST | 35 | 0 | 0 | 35 |
| SHOULD | 8 | 0 | 0 | 8 |
| COULD | 4 | 0 | 0 | 4 |

## Done (41)
## Done (47)

- [x] **P-MUST-01** Run a full idea-to-production project autonomously through tiered specialist agents _(increment: M-orchestration)_ - agents/god-orchestrator.md, docs/change-propagation.md, docs/linkage.md, lib/code-scanner.js, +9 more
- [x] **P-MUST-02** Hold project state on disk and re-derive it every turn, never from agent memory _(increment: M-orchestration)_ - lib/state.js, scripts/test-linkage.js, specialists/god-executor.md
Expand Down Expand Up @@ -48,6 +48,12 @@ Progress: [####################] 41/41 done (100%) | 0 in progress | 0 not start
- [x] **P-MUST-27** Derive a compact structured slice handoff from authoritative disk evidence on completion, pause, or ownership change _(increment: M-harness-quality-hardening)_ - lib/slice-handoff.js
- [x] **P-MUST-28** Capture deterministic before-and-after maintainability evidence with signed deltas and sample counts for independent quality review _(increment: M-harness-quality-hardening)_ - lib/maintainability-trajectory.js, lib/style-stats.js
- [x] **P-MUST-29** Run a deterministic six-checkpoint evolution benchmark that reveals requirements one at a time and measures continued correctness and changeability _(increment: M-harness-quality-hardening)_ - lib/evolution-benchmark.js
- [x] **P-MUST-30** Extend the shared voice contract with plain and concrete prose guidance plus a separate post-draft audit _(increment: M-prose-quality-hardening)_ - SKILL.md, references/shared/VOICE.md, scripts/test-prose-lint.js
- [x] **P-MUST-31** Provide a dependency-free deterministic advisory prose scanner _(increment: M-prose-quality-hardening)_ - lib/prose-lint.js, scripts/test-prose-lint.js
- [x] **P-MUST-32** Integrate prose findings into universal artifact validation as U-12 warnings _(increment: M-prose-quality-hardening)_ - lib/have-nots-validator.js, references/HAVE-NOTS.md, scripts/test-artifact-linter.js, scripts/test-prose-lint.js
- [x] **P-MUST-33** Verify prose lint behavior, precision, performance, integration, and shipped-framework self-dogfood _(increment: M-prose-quality-hardening)_ - lib/prose-lint.js, scripts/run-tests.js, scripts/static-check.js, scripts/test-prose-lint.js
- [x] **P-MUST-34** Apply the shared prose contract through the documentation and launch specialists according to output type _(increment: M-prose-quality-hardening)_ - scripts/test-prose-lint.js, specialists/god-docs-writer.md, specialists/god-launch-strategist.md
- [x] **P-MUST-35** Preserve independent authorship and release discipline for the pstack `unslop`-inspired prose-quality feature _(increment: M-prose-quality-hardening)_ - scripts/check-package-contents.js, scripts/test-prose-lint.js
- [x] **P-SHOULD-01** Set up a deploy pipeline that promotes the same artifact with tested rollback _(increment: M-shipping)_ - agents/god-deploy-engineer.md
- [x] **P-SHOULD-02** Wire observability with SLOs tied to product success metrics _(increment: M-shipping)_ - agents/god-observability-engineer.md
- [x] **P-SHOULD-03** Produce launch readiness: landing copy, Open Graph cards, and a launch runbook _(increment: M-shipping)_ - agents/god-launch-strategist.md
Expand Down Expand Up @@ -85,4 +91,5 @@ Progress: [####################] 41/41 done (100%) | 0 in progress | 0 not start
- [x] **M-advanced**: Advanced capabilities _[next]_ - done - 4/4 requirements done
- [x] **M-authorized-ai-provenance-cleaning**: Authorized AI provenance cleaning _[next]_ - done - 2/2 requirements done
- [x] **M-harness-quality-hardening**: Harness quality hardening _[next]_ - done - 6/6 requirements done
- [x] **M-prose-quality-hardening**: Prose quality hardening _[next]_ - done - 6/6 requirements done
- [ ] **M-deeper-traceability-and-ecosystem**: Deeper traceability and ecosystem _[later]_ - pending - 0/0 requirements done
17 changes: 17 additions & 0 deletions .godpowers/SYNC-LOG.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -50,3 +50,20 @@
- [DECISION] Isolated exact-version root installation and published MCP executable verification pass.
- [DECISION] GitHub Release `v6.0.0` is published at `https://github.com/hannsxpeter/godpowers/releases/tag/v6.0.0` with notes and no duplicate package assets; npm is the authoritative artifact source.
- [DECISION] The publication workflow now retries exact-version registry reads for up to 120 seconds before stopping pair verification, preventing the observed propagation race from failing immediately.

## 2026-08-19: Prose Quality Hardening Source Closeout

- [DECISION] Reverse sync scanned 840 eligible files, found 132 current annotation and filename links, added 18 code-scanner-owned links, removed none, refreshed the PRD, architecture, roadmap, and stack linkage footers, and reported zero drift findings or review items.
- [DECISION] P-MUST-30 through P-MUST-35 now link to the scanner, U-12 integration, focused tests, shared voice contract, documentation and launch specialists, self-dogfood, and package guard that implement them.
- [DECISION] The generated requirements ledger records 47 of 47 requirements complete with 100 percent linkage coverage, zero gaps, 15 completed increments, and one empty later-horizon theme still pending.
- [DECISION] The root PRD, architecture, and deliberately reviewed roadmap remain complete with exact hashes recorded in authoritative state, and M-prose-quality-hardening is complete in source while publication evidence remains pending.
- [DECISION] Independent Stage 1 specification review, Stage 2 quality review, and scoped hardening review passed for the prose-quality feature; the current focused evidence records 31 prose tests, 73 artifact-linter tests, 35 static checks, 11 voice tests, and zero prose warnings across 233 shipped Markdown and MDX files.
- [DECISION] Pillars synchronization refreshed context, architecture, quality, deploy, and observe projections from the current PRD, architecture, roadmap, state, and 6.1.0 release candidate; context and deploy now record 113 runtime modules and 111 focused test scripts instead of the prior 112 and 110 counts.
- [DECISION] Source-system sync was skipped because authoritative state has no enabled source systems, and repository documentation and repository surface evidence were already refreshed by the feature workflow.
- [DECISION] Full release-gate evidence, pull-request CI, merge identity, merged-main CI, annotated tag, GitHub Release, npm publication, registry integrity, and isolated published-install verification remain pending and are not marked complete by this sync.

- 2026-08-19T06:22:48.602Z roadmap hash re-blessed deliberately via version-sync --bless-roadmap: Reviewed the completed prose-quality increment, 47 linked requirements, reverse-synced footers, and final PRD, ARCH, and stack provenance for the 6.1.0 release candidate

- 2026-08-19T06:23:01.251Z roadmap hash re-blessed deliberately via version-sync --bless-roadmap: Corrected the prose-quality roadmap evidence timestamp to the actual closeout time after reviewing the same approved 6.1.0 content

- 2026-08-19T06:45:55.998Z roadmap hash re-blessed deliberately via version-sync --bless-roadmap: Reviewed the focused prose evidence correction from 30 to 31 tests and refreshed the exact PRD provenance for the 6.1.0 release candidate
23 changes: 23 additions & 0 deletions .godpowers/arch/ARCH.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@
| C-slice-handoff | [DECISION] Project authoritative plan, state, event, linkage, and verification facts into one bounded resume record. | [DECISION] Dependency-free Node.js CommonJS and JSON. |
| C-maintainability-trajectory | [DECISION] Capture stable code-shape snapshots and signed deltas without executing repository imports. | [DECISION] Dependency-free Node.js CommonJS. |
| C-evolution-benchmark | [DECISION] Reveal six ordered requirements to a temporary repository and retain deterministic correctness and changeability evidence. | [DECISION] Dependency-free Node.js CommonJS plus packaged fixtures. |
| C-prose-lint within the Artifact layer | [DECISION] Scan caller-supplied Markdown as inert text and return ordered advisory U-12 prose findings. | [DECISION] Dependency-free Node.js CommonJS. |

## Architecture Decision Records

Expand Down Expand Up @@ -93,6 +94,14 @@
- [DECISION] Flip point: advisory maintainability thresholds may be considered after three release-candidate datasets, but state authority remains fixed by ADR-001.
- [DECISION] Consequence: slice transitions remain resumable and measurable without promoting one metric or summary to source-of-truth status.

### ADR-009: Keep prose-quality detection advisory and local

- [DECISION] Context: labeled Godpowers prose can still hide actors, mechanisms, evidence, effects, or reader actions behind polished wording.
- [DECISION] Decision: C-prose-lint stays inside the existing Artifact layer, treats input as inert text, returns bounded sanitized findings, and enters universal validation only as U-12 warnings.
- [DECISION] Rationale: local structured warnings support human review without automatic rewriting, a model call, persistence, or a new external trust boundary.
- [DECISION] Flip point: reconsider a rule's advisory severity only after two release candidates provide reviewed precision evidence and a maintainer-approved override design.
- [DECISION] Consequence: existing artifact errors keep their severity, while maintainers receive deterministic prose findings that cannot block a gate by themselves.

## Critical Flows

### Authorized provenance inspection and cleaning
Expand All @@ -112,6 +121,13 @@
5. [DECISION] C-slice-handoff writes a bounded projection for resume, with current state winning every conflict.
6. [DECISION] C-evolution-benchmark repeats behavior and maintainability evidence across six isolated checkpoint reveals and retains JSON plus Markdown summaries after temporary cleanup.

### Advisory prose-quality flow

1. [DECISION] The Artifact layer passes caller-owned Markdown or MDX text to C-prose-lint without granting filesystem, network, model, or mutation authority.
2. [DECISION] C-prose-lint masks frontmatter, fenced code, inline code, link destinations, and clearly quoted bad examples before matching high-confidence sentence patterns.
3. [DECISION] C-prose-lint returns ordered findings with bounded excerpts after terminal control bytes are removed.
4. [DECISION] The universal have-nots wrapper maps each finding to a U-12 warning, while the existing artifact linter preserves every blocking error and aggregate warning count.

## Capacity Envelope

| Input | Supported envelope | Source |
Expand All @@ -125,6 +141,7 @@
| Slice handoff | [DECISION] One canonical JSON record at or below 8 KiB, with mandatory recovery fields protected from trimming. | [DECISION] P-MUST-27 serialization fixtures. |
| Evolution checkpoints | [DECISION] Exactly six sequential checkpoints with no parallel project mutation or future-checkpoint reads. | [DECISION] P-MUST-29 packaged scenario and isolation fixtures. |
| Evolution input and output | [DECISION] Manifests and checkpoints are each capped at 16 KiB, scalar fields at 4 KiB, baselines at 64 MiB, 5,000 entries, and depth 48, machine evidence at 256 KiB, and human summaries at 128 KiB. | [DECISION] P-MUST-29 adversarial boundary fixtures. |
| Prose scan | [DECISION] At least 1 MiB or 10,000 lines per invocation, excerpts capped at 160 characters, and a 1 MiB fixture completing within 250 milliseconds at p95 across 20 runs. | [DECISION] P-MUST-31 focused performance and boundary fixtures. |

## Failure and Degradation

Expand All @@ -137,6 +154,7 @@
| Guarded publication | [DECISION] Reject parent or destination identity changes and attempt one local restoration when replacement publication fails. | [DECISION] Preserve the competing file, restore the prior destination when possible, and report any retained recovery path. |
| Context or plan validation | [DECISION] Complete each local validation within a 30 second harness deadline, reject missing, escaped, contradictory, oversized, or negatively approved evidence, and never retry; the read-only validation is idempotent by input-byte digest. | [DECISION] Return bounded findings and leave authoritative state unchanged. |
| Trajectory or benchmark input | [DECISION] Complete each fixture checkpoint within a 30 second behavior deadline, reject incompatible snapshots, malformed manifests, future-checkpoint access, or incomplete evidence, and never retry a mutation; snapshot reads are idempotent by repository-byte digest. | [DECISION] Stop at the first invalid checkpoint, retain partial evidence, and remove the temporary repository. |
| Advisory prose scan | [DECISION] Complete one local pass without retry, execute no input content, make no I/O request, and leave caller bytes unchanged; identical input and options are idempotent by returned finding bytes. | [DECISION] Return bounded sanitized U-12 warnings, or a scanner error that leaves existing artifact state and severity unchanged. |

## NFR-to-Architecture Map

Expand All @@ -155,6 +173,8 @@
| Deterministic resume | State-authoritative structured handoffs capped at 8 KiB | ADR-008 |
| Changeability evidence | Report-only maintainability deltas plus isolated sequential benchmark checkpoints | ADR-008 |
| Harness isolation | Dependency-free local helpers, inert source parsing, and an offline temporary-repository benchmark | ADR-007 and ADR-008 |
| Advisory prose quality | Local inert-text scanning, bounded sanitized findings, and warning-only U-12 integration | ADR-002 and ADR-009 |
| Prose scan isolation | No filesystem, network, model, persistence, or mutation authority for caller-owned text | ADR-002 and ADR-009 |

## Trust Boundaries

Expand All @@ -167,6 +187,7 @@
- [DECISION] Provenance filesystem boundary: the bundled client pins input, parent, and destination identities, rejects unsafe links and concurrent changes, and retains a named recovery path when guarded restoration cannot complete.
- [DECISION] Harness path boundary: context files reject symlinks and retain pinned bytes, program-design approval binds to an exact path and digest, and handoff plus benchmark paths resolve within their declared roots before reads or writes.
- [DECISION] Harness content boundary: repository source and imports are inert measurement input, loadout events omit contents, and compact logs never add environment dumps or credentials.
- [DECISION] Artifact-quality boundary: prose input remains inert caller-owned text, C-prose-lint performs no I/O, terminal control bytes are removed from excerpts, findings are capped at 160 characters, and U-12 remains advisory; this local path adds no external trust boundary.

## Data Ownership

Expand All @@ -188,6 +209,7 @@
| Slice handoff projection | `lib/slice-handoff.js`, with workflow authority retained by `.godpowers/state.json` |
| Maintainability snapshots and deltas | `lib/maintainability-trajectory.js` plus the independent quality reviewer |
| Evolution checkpoint evidence | `lib/evolution-benchmark.js` and `fixtures/evolution/maintainability-sequence/` |
| Advisory prose findings | `lib/prose-lint.js`, with universal warning integration owned by `lib/have-nots-validator.js` |

## Have-Nots Checklist

Expand All @@ -199,6 +221,7 @@

## Architecture Changelog

- [DECISION] 2026-08-19: Added ADR-009 and C-prose-lint inside the existing Artifact layer because deterministic inert-text scanning, bounded sanitized findings, and warning-only U-12 integration now participate in artifact validation without a new service or production dependency.
- [DECISION] 2026-08-17: Added ADR-007, ADR-008, and six harness-quality containers because verified pre-spawn context, program design, compact verification, handoffs, trajectory measures, and evolution evidence now participate in the Build and release paths.
- [DECISION] 2026-08-17: Added ADR-004 through ADR-006 and the five provenance containers because the completed extension introduced a lazy package boundary, a deterministic upstream client, a visible external transfer gate, and guarded local publication.

Expand Down
Loading