godpowers 2.4.2 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/README.md +22 -6
  3. package/RELEASE.md +29 -35
  4. package/SKILL.md +5 -0
  5. package/agents/god-orchestrator.md +31 -1255
  6. package/bin/install.js +16 -107
  7. package/fixtures/gate/build-pass/.godpowers/build/STATE.md +10 -0
  8. package/fixtures/gate/harden-pass/.godpowers/harden/FINDINGS.md +14 -0
  9. package/fixtures/gate/repo-pass/.godpowers/repo/AUDIT.md +9 -0
  10. package/lib/artifact-map.js +60 -0
  11. package/lib/cli-dispatch.js +162 -0
  12. package/lib/command-families.js +10 -2
  13. package/lib/dashboard.js +3 -2
  14. package/lib/gate.js +271 -0
  15. package/lib/installer-args.js +11 -1
  16. package/lib/route-quality-sync.js +38 -0
  17. package/package.json +3 -2
  18. package/references/orchestration/GOD-MODE-RUNBOOK.md +19 -0
  19. package/references/orchestration/GOD-NEXT-RUNBOOK.md +32 -0
  20. package/references/orchestration/GOD-ORCHESTRATOR-RUNBOOK.md +1259 -0
  21. package/references/orchestration/README.md +6 -0
  22. package/references/shared/DASHBOARD-CONTRACT.md +93 -0
  23. package/references/shared/LOCKING.md +15 -0
  24. package/references/shared/README.md +2 -0
  25. package/routing/god-arch.yaml +1 -0
  26. package/routing/god-build.yaml +1 -0
  27. package/routing/god-design.yaml +1 -0
  28. package/routing/god-harden.yaml +1 -0
  29. package/routing/god-prd.yaml +1 -0
  30. package/routing/god-repo.yaml +1 -0
  31. package/routing/god-roadmap-check.yaml +1 -1
  32. package/routing/god-roadmap.yaml +1 -0
  33. package/routing/god-stack.yaml +1 -0
  34. package/skills/god-arch.md +3 -13
  35. package/skills/god-build.md +5 -14
  36. package/skills/god-deploy.md +1 -12
  37. package/skills/god-design.md +9 -12
  38. package/skills/god-feature.md +1 -12
  39. package/skills/god-harden.md +3 -13
  40. package/skills/god-hotfix.md +1 -12
  41. package/skills/god-launch.md +1 -12
  42. package/skills/god-link.md +1 -12
  43. package/skills/god-migrate.md +1 -3
  44. package/skills/god-mode.md +4 -0
  45. package/skills/god-next.md +34 -410
  46. package/skills/god-observe.md +1 -12
  47. package/skills/god-prd.md +3 -13
  48. package/skills/god-redo.md +1 -12
  49. package/skills/god-refactor.md +1 -12
  50. package/skills/god-repair.md +1 -12
  51. package/skills/god-repo.md +3 -13
  52. package/skills/god-restore.md +1 -12
  53. package/skills/god-roadmap-check.md +5 -0
  54. package/skills/god-roadmap.md +3 -13
  55. package/skills/god-rollback.md +1 -12
  56. package/skills/god-scan.md +1 -12
  57. package/skills/god-skip.md +1 -12
  58. package/skills/god-stack.md +3 -13
  59. package/skills/god-status.md +27 -204
  60. package/skills/god-story-build.md +1 -12
  61. package/skills/god-story-close.md +1 -12
  62. package/skills/god-story.md +1 -12
  63. package/skills/god-sync.md +1 -12
  64. package/skills/god-undo.md +1 -12
  65. package/skills/god-update-deps.md +1 -12
  66. package/skills/god-upgrade.md +1 -12
package/CHANGELOG.md CHANGED
@@ -7,6 +7,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [2.5.0] - 2026-06-10
11
+
12
+ ### Added
13
+ - Added `npx godpowers gate --tier=<tier> --project=.` for PRD, design,
14
+ architecture, roadmap, stack, repo, build, and harden tier gates.
15
+ - Added `lib/artifact-map.js`, `lib/gate.js`, and `lib/cli-dispatch.js` so
16
+ artifact paths, executable gates, and CLI command dispatch are tested outside
17
+ the installer binary.
18
+ - Added gate fixtures and tests for green tier artifacts, missing artifacts,
19
+ lint failures, harden Critical findings, build verification evidence, JSON
20
+ shape stability, async API coverage, and CLI exit codes.
21
+
22
+ ### Changed
23
+ - Updated eight tier skills and their routing metadata to require the
24
+ executable gate before downstream work proceeds.
25
+ - Updated `/god-mode` and its runbook to run executable gates between tier
26
+ transitions.
27
+ - Updated static checks and route-quality sync so missing gate instructions and
28
+ missing `standards.gate-command` metadata block release readiness.
29
+
30
+ ## [2.4.3] - 2026-06-09
31
+
32
+ ### Added
33
+ - Added three external CLI adoption canary case studies for sindresorhus/is,
34
+ expressjs/cors, and tinyhttp/tinyhttp with commit hashes, elapsed time,
35
+ zero-dollar local CLI cost, pause counts, and explicit host-run gaps.
36
+ - Added a shared Godpowers Dashboard contract and shared locking contract under
37
+ `references/shared/`.
38
+ - Added detailed runbook references for `god-orchestrator` and `/god-next`.
39
+ - Added CLI dispatch tests for status, next, quick-proof, automation, dogfood,
40
+ extension scaffold, and unknown-command branches.
41
+ - Added `npm run coverage:lib`, enforcing a 90 percent line coverage floor for
42
+ `lib/**/*.js` through c8.
43
+
44
+ ### Changed
45
+ - Slimmed `agents/god-orchestrator.md`, `skills/god-next.md`, and
46
+ `skills/god-status.md` into concise dispatch contracts that delegate
47
+ long-form operational detail to references.
48
+ - Replaced repeated skill locking boilerplate with one-line pointers to the
49
+ shared locking reference.
50
+ - Updated `npm run release:check` to run the full suite under the lib coverage
51
+ floor before audit and package checks.
52
+ - Updated package verification to pack into a temporary directory and clean the
53
+ generated tarball automatically.
54
+ - Marked `/god-roadmap-check` deprecated, removed it from the command-family
55
+ presentation, and locked non-full install profiles against installing it.
56
+
57
+ ### Fixed
58
+ - Removed ignored root tarball and `.DS_Store` clutter before release.
59
+
10
60
  ## [2.4.2] - 2026-06-09
11
61
 
12
62
  ### Added
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
- [![Version](https://img.shields.io/badge/version-2.4.2-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-2.5.0-blue)](CHANGELOG.md)
6
6
  [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
7
7
 
8
8
  **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -16,16 +16,20 @@ Want the short proof first? Start with [Quick Proof](docs/quick-proof.md) to
16
16
  run `npx godpowers quick-proof --project=. --brief`, see outcome metrics, pick
17
17
  a starter command set, and understand runtime expectations before reading the
18
18
  full reference. The [First 10 Minute Proof Case Study](docs/case-studies/first-10-minute-proof.md)
19
- shows the same evidence as a before-and-after adoption story.
19
+ shows the same evidence as a before-and-after adoption story. External
20
+ CLI-verifiable canaries now cover [sindresorhus/is](docs/case-studies/sindresorhus-is-adoption-canary.md),
21
+ [expressjs/cors](docs/case-studies/expressjs-cors-adoption-canary.md), and
22
+ [tinyhttp/tinyhttp](docs/case-studies/tinyhttp-adoption-canary.md), with host
23
+ slash-command gaps called out rather than hidden.
20
24
 
21
25
  Godpowers makes AI coding accountable: every serious run should leave disk
22
26
  state, artifacts, validation gates, host guarantees, and a next action. Code is
23
27
  only one output. The project memory and proof trail matter too.
24
28
 
25
- Version 2.4.2 keeps the 2.4 command-family UX and hardens the release-facing
26
- runtime: strict YAML diagnostics for routing, recipes, workflows, and extension
27
- manifests; shared markdown frontmatter parsing; dev-only coverage tooling; and
28
- clean package hygiene before publish.
29
+ Version 2.5.0 adds executable tier gates through `npx godpowers gate` while
30
+ keeping the 2.4 command-family UX, external CLI canary evidence, prompt-size
31
+ guardrails, legacy command quarantine, lib coverage gating, and package
32
+ verification before publish.
29
33
 
30
34
  Maintainer hardening continues on the 2.x line with small, audited public
31
35
  surface updates when they close real workflow gaps. The 2.1.0 patch closes a command-injection vector in the
@@ -248,6 +252,7 @@ npx godpowers next --project=.
248
252
  npx godpowers status --project=. --brief
249
253
  npx godpowers status --project=. --json
250
254
  npx godpowers quick-proof --project=.
255
+ npx godpowers gate --tier=prd --project=.
251
256
  npx godpowers dogfood
252
257
  npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.
253
258
  ```
@@ -268,6 +273,17 @@ test order is maintained as a readable list instead of a long package script.
268
273
  decomposition, async runtime APIs, agent reference validation coverage, and God
269
274
  Mode runbook delegation.
270
275
 
276
+ Tier skills now run the executable gate before downstream work proceeds:
277
+
278
+ ```bash
279
+ npx godpowers gate --tier=prd --project=.
280
+ npx godpowers gate --tier=build --project=.
281
+ npx godpowers gate --tier=harden --project=.
282
+ ```
283
+
284
+ The gate reads disk artifacts, runs the shared artifact linter, checks build
285
+ verification evidence, and blocks unresolved Critical harden findings.
286
+
271
287
  The runtime remains dependency-free. YAML parsing is intentionally limited to
272
288
  the documented Godpowers subset used by intent, routing, workflow, and
273
289
  extension files, with parser coverage in `scripts/test-yaml-parser.js`.
package/RELEASE.md CHANGED
@@ -1,12 +1,12 @@
1
- # Godpowers 2.4.2 Release
1
+ # Godpowers 2.5.0 Release
2
2
 
3
3
  > Status: Ready for package verification
4
- > Date: 2026-06-09
4
+ > Date: 2026-06-10
5
5
 
6
- Godpowers 2.4.2 is a release-hardening patch for the 2.4 line. It keeps the
7
- 2.4 command-family UX intact while making parser failures, frontmatter
8
- metadata, coverage visibility, and package hygiene more accountable before
9
- publish.
6
+ Godpowers 2.5.0 ships executable tier gates for the code-first kernel
7
+ migration. It keeps the slash-command workflow intact while giving command
8
+ capable hosts a stable JSON gate contract and non-zero exit codes for blocked
9
+ tier transitions.
10
10
 
11
11
  ## What's in this release
12
12
 
@@ -14,45 +14,39 @@ publish.
14
14
  - 40 specialist agents
15
15
  - 13 executable workflows
16
16
  - 42 intent recipes
17
+ - 8 installer CLI helpers
17
18
 
18
19
  ## Highlights
19
20
 
20
- - YAML parsing now exposes strict diagnostics for malformed skipped lines and
21
- unsafe prototype-pollution keys while preserving default legacy reads.
22
- - Routing, recipe, and workflow YAML loaders now surface warnings with file and
23
- line context.
24
- - Extension manifests now fail closed on malformed YAML lines and unsafe keys.
25
- - Markdown frontmatter parsing is centralized in `lib/frontmatter.js` and
26
- enforced by `scripts/static-check.js`.
27
- - Installer metadata, Pillars, skill validation, agent validation,
28
- checkpoints, context budgets, skill surface metadata, and DESIGN.md parsing
29
- now share the same frontmatter path.
30
- - `npm run coverage` is available through dev-only `c8` tooling.
31
- - Stale root package tarballs and `.DS_Store` clutter were removed before
32
- release.
21
+ - `npx godpowers gate --tier=<tier> --project=.` checks PRD, design,
22
+ architecture, roadmap, stack, repo, build, and harden artifacts.
23
+ - Gate JSON returns `{tier, verdict, artifacts, checks, findings, summary}` for
24
+ host-visible evidence.
25
+ - Build gates require `.godpowers/build/STATE.md` to record exact verification
26
+ commands that passed.
27
+ - Harden gates fail unresolved Critical findings and blocked launch gates.
28
+ - `/god-mode` now runs executable gates between tier transitions.
29
+ - Tier routes declare `standards.gate-command`, and static checks enforce the
30
+ skill and route metadata.
31
+ - CLI command dispatch now lives in `lib/cli-dispatch.js`, keeping
32
+ `bin/install.js` thin.
33
33
 
34
34
  ## Validation
35
35
 
36
- - `node scripts/test-yaml-parser.js` green
37
- - `node scripts/test-frontmatter.js` green
38
- - `node scripts/test-extensions.js` green
39
- - `node scripts/test-router.js` green
40
- - `node scripts/test-recipes.js` green
41
- - `node scripts/test-install-smoke.js` green
36
+ - `node scripts/test-gate.js` green
37
+ - `node scripts/test-cli-dispatch.js` green
38
+ - `node scripts/static-check.js` green
42
39
  - `npm run release:check` required before publish
43
- - `npm pack` creates a local `godpowers-2.4.2.tgz` tarball for package
44
- inspection
45
40
 
46
41
  ## Upgrade
47
42
 
48
- - `npm install -g godpowers@2.4.2` or `npx godpowers@2.4.2`
49
- - Re-run `/god-context` in each project to refresh installed runtime metadata
50
- - No breaking changes for valid `.godpowers/` state. Invalid extension
51
- manifests that were previously partially accepted now fail with parse errors.
43
+ - `npm install -g godpowers@2.5.0` or `npx godpowers@2.5.0`
44
+ - Re-run `/god-context` in each project to refresh installed runtime metadata.
45
+ - Existing `.godpowers/` state remains compatible.
52
46
 
53
47
  ## Notes
54
48
 
55
- - GitHub release creation for `v2.4.2`
56
- - The tag should match the npm package version
57
- - The `v2.4.2` tag should point to the release commit that matches the npm
58
- `godpowers@2.4.2` package.
49
+ - GitHub release creation for `v2.5.0`.
50
+ - The tag should match the npm package version.
51
+ - The `v2.5.0` tag should point to the release commit that matches the npm
52
+ `godpowers@2.5.0` package.
package/SKILL.md CHANGED
@@ -53,6 +53,11 @@ Each tier gates on a verified artifact from the prior tier. You cannot build
53
53
  without architecture. You cannot deploy without a build. You cannot launch with
54
54
  unresolved Critical security findings.
55
55
 
56
+ For PRD, design, architecture, roadmap, stack, repo, build, and harden, run
57
+ `npx godpowers gate --tier=<tier> --project=.` after the tier artifact is
58
+ created and before starting downstream tier work. A non-zero exit blocks
59
+ progress until the artifact or evidence is repaired.
60
+
56
61
  ### 5. Context Isolation
57
62
  Every execution agent gets a fresh context window. The orchestrator is thin; it
58
63
  spawns workers with full context budgets. This defeats context rot.