godpowers 1.6.5 → 1.6.6

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.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,33 @@ All notable changes to Godpowers will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.6.6] - 2026-05-16
9
+
10
+ Non-God-Mode handoff privacy patch. Extends the display-safe handoff pattern
11
+ from `/god-mode` to other orchestrator entrypoints.
12
+
13
+ ### Added
14
+ - Added private handoff guidance for `/god-init` before it spawns
15
+ `god-orchestrator`.
16
+ - Added private handoff guidance for `/god-suite-init`,
17
+ `/god-suite-release`, and `/god-suite-patch` before they spawn
18
+ `god-coordinator`.
19
+ - Added `god-coordinator` guidance for display-safe per-repo
20
+ `god-orchestrator` spawns.
21
+ - Added regression coverage for non-`/god-mode` handoff entrypoints.
22
+
23
+ ### Changed
24
+ - `god-orchestrator` now documents handoff files from `/god-init`,
25
+ `god-coordinator`, or any other caller, not only `/god-mode`.
26
+ - `/god-hygiene` routing no longer lists `god-orchestrator` as a secondary
27
+ spawn because the skill only runs the three hygiene audits.
28
+
29
+ ### Guardrails
30
+ - This patch does not add slash commands, agents, workflows, recipes, schemas,
31
+ or public artifact formats.
32
+ - The handoff change affects transcript hygiene only. It does not weaken
33
+ release-truth gates or per-repo Quarterback ownership.
34
+
8
35
  ## [1.6.5] - 2026-05-16
9
36
 
10
37
  God Mode handoff privacy patch. Keeps the 1.6 command surface stable while
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-1.6.5-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-1.6.6-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.**
@@ -12,11 +12,11 @@ idea to hardened production. It runs as **slash commands inside your AI coding
12
12
  tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
13
13
  in fresh contexts to do the work.
14
14
 
15
- Version 1.6.5 keeps the stable Godpowers surface while making Codex
16
- `god-orchestrator` spawns transcript-safe: `/god-mode` now writes detailed
17
- orchestration context to a private handoff file and spawns with only a small
18
- display-safe pointer. Safe-sync and unresolved Critical harden findings still
19
- gate direct Tier 3 commands, `/god-mode`, and `/god-mode --yolo`.
15
+ Version 1.6.6 keeps the stable Godpowers surface while making more Codex
16
+ orchestrator spawns transcript-safe: `/god-mode`, `/god-init`, and Mode D
17
+ suite coordinator paths now use private handoff files with small display-safe
18
+ pointers. Safe-sync and unresolved Critical harden findings still gate direct
19
+ Tier 3 commands, `/god-mode`, and `/god-mode --yolo`.
20
20
 
21
21
  It fuses four disciplines into one unified workflow:
22
22
 
package/RELEASE.md CHANGED
@@ -1,11 +1,11 @@
1
- # Godpowers 1.6.5 Release
1
+ # Godpowers 1.6.6 Release
2
2
 
3
3
  Date: 2026-05-16
4
4
 
5
- Godpowers 1.6.5 keeps the stable 1.6 surface while fixing Codex God Mode
6
- transcript hygiene. The goal of this patch is to make `god-orchestrator`
7
- spawn correctly from `/god-mode` and `/god-mode --yolo` without exposing the
8
- detailed orchestration payload in the visible transcript.
5
+ Godpowers 1.6.6 extends transcript-safe spawn handling beyond `/god-mode`.
6
+ The goal of this patch is to keep Codex-visible spawn messages small and safe
7
+ for `/god-init` and Mode D suite coordination while preserving the same
8
+ orchestrator and coordinator behavior.
9
9
 
10
10
  ## What is stable
11
11
 
@@ -27,35 +27,40 @@ detailed orchestration payload in the visible transcript.
27
27
 
28
28
  ## What is new
29
29
 
30
- - `/god-mode` now writes detailed orchestration context to
31
- `.godpowers/runs/<run-id>/ORCHESTRATOR-HANDOFF.md`.
32
- - `/god-mode` now spawns `god-orchestrator` with only a display-safe project
33
- root, flags, and handoff file path.
34
- - `god-orchestrator` now knows to read the handoff file before planning,
35
- spawning, or mutating project state.
36
- - `god-orchestrator` now treats handoff contents as private orchestration
37
- context and keeps them out of the visible transcript.
38
- - Agent validation and smoke tests now inspect `agents/god-*.md` specialist
39
- files while allowing Pillars context files like `agents/context.md` and
40
- `agents/repo.md` to coexist.
41
-
42
- ## What 1.6.5 means
43
-
44
- Godpowers 1.6.5 does not expand the public command surface. It fixes the Codex
45
- spawn integration path so the right specialist agent is still started, but the
46
- host UI only sees a small pointer to disk state instead of raw checkpoint,
47
- routing, and local-file details.
30
+ - `/god-init` now writes detailed initialization context to
31
+ `.godpowers/runs/<run-id>/INIT-ORCHESTRATOR-HANDOFF.md` before spawning
32
+ `god-orchestrator`.
33
+ - `/god-suite-init`, `/god-suite-release`, and `/god-suite-patch` now write
34
+ suite coordination context to
35
+ `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` before spawning
36
+ `god-coordinator`.
37
+ - `god-coordinator` now writes per-repo orchestrator context to
38
+ `.godpowers/runs/<run-id>/COORDINATOR-ORCHESTRATOR-HANDOFF.md` before
39
+ spawning a target repo's `god-orchestrator`.
40
+ - `god-orchestrator` now treats handoff files as a general caller protocol,
41
+ not only as a `/god-mode` protocol.
42
+ - `/god-hygiene` routing no longer lists `god-orchestrator` as a secondary
43
+ spawn because the skill only runs artifact, dependency, and documentation
44
+ audits.
45
+
46
+ ## What 1.6.6 means
47
+
48
+ Godpowers 1.6.6 does not expand the public command surface. It fixes more
49
+ Codex spawn integration paths so the right agent is still started, but the host
50
+ UI only sees a small pointer to disk state instead of raw project description,
51
+ suite metadata, release notes, patch directives, dependency graphs, routing
52
+ rules, or local-file details.
48
53
 
49
54
  Safe sync and unresolved Critical harden findings remain release-truth gates.
50
- `--yolo` can still auto-pick defaults, but it cannot bypass those blockers.
55
+ Per-repo Quarterback ownership remains intact for Mode D suite work.
51
56
 
52
57
  ## Stability policy
53
58
 
54
59
  During the 1.x stability window, do not add broad new command families, change
55
60
  schema formats, or rename public artifacts without evidence from real use.
56
61
 
57
- The `v1.6.5` git tag points to the release commit that matches the npm
58
- `godpowers@1.6.5` package. Public publishes should prefer the tag-triggered
62
+ The `v1.6.6` git tag points to the release commit that matches the npm
63
+ `godpowers@1.6.6` package. Public publishes should prefer the tag-triggered
59
64
  GitHub workflow so npm provenance, git history, and release notes stay aligned.
60
65
 
61
66
  Allowed changes:
@@ -44,6 +44,20 @@ suite (the collection of repos), not individual repos.
44
44
  - Per-repo `state.json` files
45
45
  - Optionally: a specific operation (sync, release, patch, status)
46
46
 
47
+ ## Coordinator Handoff
48
+
49
+ When spawned by a suite command, the visible spawn message may include only a
50
+ display-safe operation summary plus a path like
51
+ `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md`.
52
+
53
+ If a handoff path is provided:
54
+ 1. Read the handoff file before planning, spawning, or mutating suite state.
55
+ 2. Treat the handoff as private suite coordination context.
56
+ 3. Do not quote, summarize, or expose the full handoff in the visible
57
+ transcript.
58
+ 4. If the handoff conflicts with durable suite artifacts, prefer disk
59
+ artifacts and record the conflict as an open question or repair target.
60
+
47
61
  ## Process per operation
48
62
 
49
63
  ### Mode 1: status (`/god-suite-status`)
@@ -66,7 +80,8 @@ suite (the collection of repos), not individual repos.
66
80
 
67
81
  1. User provides repo + new version
68
82
  2. Run impact analysis: which sibling repos depend on this one?
69
- 3. For each affected sibling: spawn its `god-orchestrator` with a
83
+ 3. For each affected sibling: write a per-repo orchestrator handoff file and
84
+ spawn its `god-orchestrator` with only a display-safe pointer for the
70
85
  `version-bump` directive (NOT a full arc)
71
86
  4. Aggregate results into a release report
72
87
  5. Update `.godpowers/suite-config.yaml` version-table
@@ -75,8 +90,9 @@ suite (the collection of repos), not individual repos.
75
90
  ### Mode 4: patch (`/god-suite-patch`)
76
91
 
77
92
  1. User describes a change that touches multiple repos
78
- 2. For each repo in scope: spawn its `god-orchestrator` with the
79
- patch description
93
+ 2. For each repo in scope: write a per-repo orchestrator handoff file and
94
+ spawn its `god-orchestrator` with only a display-safe pointer for the
95
+ patch directive
80
96
  3. Coordinate atomicity: if any repo fails, mark the suite-level
81
97
  patch as incomplete and report
82
98
  4. Append to SYNC-LOG.md
@@ -117,8 +133,25 @@ For each operation, return to the spawning skill with:
117
133
  ## Coordination with per-repo orchestrators
118
134
 
119
135
  When you need work done IN a repo (version bump, patch slice, etc.),
120
- spawn that repo's `god-orchestrator` via the Task tool with the
121
- specific directive. Do not bypass it. The Quarterback rule:
136
+ create a private handoff in that repo first, then spawn that repo's
137
+ `god-orchestrator` via the Task tool with only a display-safe pointer.
138
+
139
+ Per-repo handoff path:
140
+ `.godpowers/runs/<run-id>/COORDINATOR-ORCHESTRATOR-HANDOFF.md`
141
+
142
+ Put the version-bump directive, patch directive, suite impact analysis,
143
+ affected dependency facts, release notes, and repo-specific notes in the
144
+ handoff file. The visible spawn message may include only:
145
+ - The target repo root
146
+ - The suite operation name
147
+ - The handoff file path
148
+ - "Read the handoff file first, then run the requested scoped work from disk
149
+ state. Return only user-facing progress and final status."
150
+
151
+ Do not put suite metadata, dependency graphs, local file lists, release notes,
152
+ patch descriptions, hidden routing rules, or detailed instructions in the
153
+ visible spawn message. Do not bypass the target repo orchestrator. The
154
+ Quarterback rule:
122
155
 
123
156
  > Each repo has exactly one orchestrator. The coordinator is a peer
124
157
  > at suite scope, not a higher-tier overseer.
@@ -21,10 +21,11 @@ You orchestrate the full Godpowers arc. You DO NOT do the heavy lifting yourself
21
21
  Your job is to spawn the right specialist agent for each sub-step, verify their
22
22
  output passes the gate, update PROGRESS.md, and move to the next step.
23
23
 
24
- ## God Mode Handoff
24
+ ## Orchestrator Handoff
25
25
 
26
- When spawned by `/god-mode`, the visible spawn message may include only a
27
- display-safe summary plus a path like
26
+ When spawned by `/god-mode`, `/god-init`, `god-coordinator`, or any other
27
+ caller, the visible spawn message may include only a display-safe summary plus
28
+ a path like
28
29
  `.godpowers/runs/<run-id>/ORCHESTRATOR-HANDOFF.md`.
29
30
 
30
31
  If a handoff path is provided:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "godpowers",
3
- "version": "1.6.5",
3
+ "version": "1.6.6",
4
4
  "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.",
5
5
  "bin": {
6
6
  "godpowers": "./bin/install.js"
@@ -12,7 +12,7 @@ prerequisites:
12
12
  execution:
13
13
  spawns: [god-auditor]
14
14
  context: fresh
15
- secondary-spawns: [god-deps-auditor, god-docs-writer, god-orchestrator]
15
+ secondary-spawns: [god-deps-auditor, god-docs-writer]
16
16
  writes:
17
17
  - .godpowers/HYGIENE-REPORT.md
18
18
 
@@ -48,7 +48,7 @@ GODPOWERS DOCTOR
48
48
  Install: claude (~/.claude/)
49
49
  [OK] 106 skills installed
50
50
  [OK] 39 agents installed
51
- [OK] VERSION matches (1.6.5)
51
+ [OK] VERSION matches (1.6.6)
52
52
  [WARN] routing/god-doctor.yaml exists but skill file did not until now
53
53
 
54
54
  Project: /Users/.../my-project/.godpowers/
@@ -81,10 +81,27 @@ needs to specify a mode.
81
81
  - Code present + org context: "Detected: existing codebase + org standards.
82
82
  I'll archaeology, reconstruct, and respect your org's standards."
83
83
 
84
- 4. Ask the user to describe what they want to build. Accept any format.
85
-
86
- 5. Spawn **god-orchestrator** in fresh context with the user's description and
87
- the detected mode/context.
84
+ 5. Ask the user to describe what they want to build. Accept any format.
85
+
86
+ 6. Create a private disk handoff before spawning the orchestrator:
87
+ - Path: `.godpowers/runs/<run-id>/INIT-ORCHESTRATOR-HANDOFF.md`
88
+ - Create parent directories if needed.
89
+ - Put the user's description, detected mode, detected context, initial
90
+ findings summary, imported context summary, Pillars status, and next-step
91
+ routing notes in this file.
92
+
93
+ 7. Spawn **god-orchestrator** in fresh context with only a display-safe
94
+ payload:
95
+ - Name the project root.
96
+ - Name the invocation as `/god-init`.
97
+ - Name the handoff file path.
98
+ - Say: "Read the handoff file first, then initialize or resume from disk
99
+ state. Return only user-facing progress and final status."
100
+
101
+ Do not put recovered planning context, local file lists, org standards,
102
+ imported planning-system summaries, hidden routing rules, or detailed
103
+ instructions in the visible spawn message. Assume the host UI may display
104
+ the raw spawn message to the user.
88
105
 
89
106
  The orchestrator will:
90
107
  - Run Mode Detection (announced in plain English; stored as A/B/C/E internally)
@@ -100,14 +117,14 @@ needs to specify a mode.
100
117
  - Write PROGRESS.md with mode, scale, timestamp, tier states
101
118
  - Return mode/scale/announcement to this skill
102
119
 
103
- 4. Detect scale by analyzing the description:
120
+ 8. Detect scale by analyzing the description:
104
121
  - **Trivial**: Single file change, bug fix, config tweak
105
122
  - **Small**: One feature, one service, <1 week
106
123
  - **Medium**: Multiple features, 1-3 services, 1-4 weeks
107
124
  - **Large**: Multiple services, team coordination, 1-3 months
108
125
  - **Enterprise**: Multiple teams, compliance, 3+ months
109
126
 
110
- 5. Create the directory structure:
127
+ 9. Create the directory structure:
111
128
  ```
112
129
  AGENTS.md
113
130
  agents/
@@ -140,9 +157,9 @@ needs to specify a mode.
140
157
  harden/
141
158
  ```
142
159
 
143
- 6. Write PROGRESS.md with mode, scale, timestamp, all tiers set to `pending`
160
+ 10. Write PROGRESS.md with mode, scale, timestamp, all tiers set to `pending`
144
161
 
145
- 7. Report to the user:
162
+ 11. Report to the user:
146
163
  - Detected mode and scale
147
164
  - Which tiers and personas will activate
148
165
  - What to run next (suggest `god prd` or `god mode`)
@@ -32,12 +32,23 @@ are listed manually; godpowers does NOT auto-walk parent dirs.
32
32
  - Byte-identical files to track (one per line; e.g., LICENSE, .editorconfig)
33
33
  - Version-table entries (optional; can be added later)
34
34
  - Shared standards (node-version, linter; optional)
35
- 3. Spawn `god-coordinator` agent in `init` mode with collected inputs.
36
- 4. god-coordinator writes `.godpowers/suite-config.yaml` and updates
35
+ 3. Create `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` with the
36
+ collected suite name, sibling paths, byte-identical files, version-table
37
+ entries, shared standards, and init-mode instruction.
38
+ 4. Spawn `god-coordinator` agent in `init` mode with only a display-safe
39
+ payload:
40
+ - Name the hub path.
41
+ - Name the operation as `init`.
42
+ - Name the handoff file path.
43
+ - Say: "Read the handoff file first, then perform suite init from disk
44
+ state. Return only user-facing progress and final status."
45
+ Do not put sibling paths, version-table entries, shared standards, local
46
+ file lists, or detailed instructions in the visible spawn message.
47
+ 5. god-coordinator writes `.godpowers/suite-config.yaml` and updates
37
48
  each sibling's state.json with `suite.hubPath`.
38
- 5. Initial `lib/suite-state.refreshFromRepos` runs to populate
49
+ 6. Initial `lib/suite-state.refreshFromRepos` runs to populate
39
50
  `.godpowers/suite/state.json` and `STATE.md`.
40
- 6. Report registration complete; suggest `/god-suite-status` next.
51
+ 7. Report registration complete; suggest `/god-suite-status` next.
41
52
 
42
53
  ## Output
43
54
 
@@ -22,11 +22,23 @@ locally; the coordinator tracks atomicity.
22
22
  - Patch description (what's the change)
23
23
  - Repos in scope (defaults: all siblings; user can subset)
24
24
  - Per-repo any specific notes
25
- 3. Spawn `god-coordinator` in `patch` mode.
26
- 4. For each repo in scope:
27
- - Spawn that repo's `god-orchestrator` with the patch directive
25
+ 3. Create `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` with the patch
26
+ description, repos in scope, per-repo notes, dry-run flag, and patch-mode
27
+ instruction.
28
+ 4. Spawn `god-coordinator` in `patch` mode with only a display-safe payload:
29
+ - Name the hub path.
30
+ - Name the operation as `patch`.
31
+ - Name the handoff file path.
32
+ - Say: "Read the handoff file first, then coordinate the suite patch from
33
+ disk state. Return only user-facing progress and final status."
34
+ Do not put patch descriptions, per-repo notes, sibling paths, local file
35
+ lists, or detailed instructions in the visible spawn message.
36
+ 5. For each repo in scope:
37
+ - Write a per-repo orchestrator handoff file and spawn that repo's
38
+ `god-orchestrator` with only a display-safe pointer for the patch
39
+ directive
28
40
  - Track success/failure
29
- 5. Coordinator aggregates results:
41
+ 6. Coordinator aggregates results:
30
42
  - All succeeded: report success; append to SYNC-LOG.md
31
43
  - Some failed: report partial; suggest manual continuation OR
32
44
  rollback (`/god-suite-patch --rollback <patch-id>`)
@@ -17,15 +17,27 @@ A version bump that knows about dependents. Different from `/god-launch`
17
17
 
18
18
  1. Verify suite is registered.
19
19
  2. Prompt for: which repo, new version, release notes.
20
- 3. Spawn `god-coordinator` in `release` mode.
21
- 4. god-coordinator:
20
+ 3. Create `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` with the repo,
21
+ new version, release notes, propagation flags, and suite release
22
+ instruction.
23
+ 4. Spawn `god-coordinator` in `release` mode with only a display-safe
24
+ payload:
25
+ - Name the hub path.
26
+ - Name the operation as `release`.
27
+ - Name the handoff file path.
28
+ - Say: "Read the handoff file first, then coordinate the suite release
29
+ from disk state. Return only user-facing progress and final status."
30
+ Do not put release notes, dependency impact, sibling paths, local file
31
+ lists, or detailed instructions in the visible spawn message.
32
+ 5. god-coordinator:
22
33
  - Scans suite version-table for repos that depend on the bumped repo
23
- - For each dependent: spawns its `god-orchestrator` with a
34
+ - For each dependent: writes a per-repo orchestrator handoff file and
35
+ spawns its `god-orchestrator` with only a display-safe pointer for the
24
36
  `version-bump` directive (NOT a full arc)
25
37
  - Aggregates results per-repo
26
38
  - Updates `.godpowers/suite-config.yaml` version-table to match
27
39
  - Appends to `.godpowers/suite/SYNC-LOG.md`
28
- 5. Reports aggregated outcome (bumped + propagated repos).
40
+ 6. Reports aggregated outcome (bumped + propagated repos).
29
41
 
30
42
  ## Forms
31
43
 
@@ -14,7 +14,7 @@ Print version and a short capability summary.
14
14
  ## Output
15
15
 
16
16
  ```
17
- Godpowers v1.6.5
17
+ Godpowers v1.6.6
18
18
  Install: /Users/.../.claude/ (matches package.json)
19
19
  Surface: 106 skills, 39 agents, 13 workflows, 36 recipes
20
20
  Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1