godpowers 2.4.2 → 2.4.3

package/references/orchestration/README.md

@@ -5,6 +5,12 @@ god-orchestrator and related agents.
 
 ## Files
 
+- [GOD-MODE-RUNBOOK.md](GOD-MODE-RUNBOOK.md): `/god-mode` transcript,
+  flags, final sync, and completion contracts.
+- [GOD-NEXT-RUNBOOK.md](GOD-NEXT-RUNBOOK.md): `/god-next` invocation modes,
+  route detail, and edge cases.
+- [GOD-ORCHESTRATOR-RUNBOOK.md](GOD-ORCHESTRATOR-RUNBOOK.md): detailed
+  god-orchestrator operating contracts delegated out of the agent prompt.
 - [MODE-DETECTION.md](MODE-DETECTION.md): Mode A/B/C/E detection, plus Mode D
   suite membership.
 - [SCALE-DETECTION.md](SCALE-DETECTION.md): scale rubric and calibration.

package/references/shared/DASHBOARD-CONTRACT.md

@@ -0,0 +1,93 @@
+# Godpowers Dashboard Contract
+
+This reference owns the shared dashboard shape for `/god-status`, `/god-next`, `/god-mode` closeouts, and completed command closeouts.
+
+## Runtime source
+
+Prefer `lib/dashboard.js` for dashboard computation. Call `dashboard.compute(projectRoot)`, then render with `dashboard.render(result)` unless the caller needs a narrower brief view.
+
+If the runtime module is unavailable, use a manual disk scan and say `Dashboard engine: unavailable, manual scan used`.
+
+Never mix workflow progress with audit, hygiene, remediation, or launch-readiness scores. Label those scores separately when they appear.
+
+## Required shape
+
+```text
+Godpowers Dashboard
+
+Source: runtime dashboard (lib/dashboard.js)
+
+Current status:
+  State: <complete | partial | blocked | proposal | complete with deferred item>
+  Phase: <plain-language phase> (tier <human ordinal> of <human total>)
+  Step: <sub-step label> (step <n> of <total steps>)
+  Progress: <pct>% workflow progress (<done> of <total> tracked steps complete)
+  Worktree: <clean | modified files unstaged | staged changes | mixed>
+  Index: <untouched | staged files listed>
+
+Action brief:
+  Next: <recommended command or user decision>
+  Why: <route reason tied to disk state>
+  Readiness: <ready | needs attention>
+  Attention: <top blockers or none>
+  Host guarantees: <full | degraded | unknown with host and first gap>
+
+Planning visibility:
+  PRD: <done | pending | missing | deferred> <artifact path when present>
+  Roadmap: <done | pending | missing | deferred> <artifact path when present>
+  Current milestone: <roadmap milestone, tier, or next planning gate when known>
+  Completion basis: <state.json, PROGRESS.md, artifacts, or audit score source>
+
+Deliverable progress:
+  Requirements: <done>/<total> done (<pct>%), <in-progress> in progress, <untouched> not started
+  Increments: <done> done, <building> building, <pending> pending
+  Ledger: .godpowers/REQUIREMENTS.md
+
+What changed:
+  1. <highest-signal user-visible change>
+  2. <highest-signal user-visible change>
+
+Validation:
+  + <command>: <result>
+
+Proactive checks:
+  Checkpoint: <fresh | refreshed | missing | stale | conflicts with state.json>
+  Reviews: <none | N pending, suggest /god-review-changes>
+  Sync: <fresh | missing | stale | local helper ran | suggest /god-sync>
+  Docs: <fresh | N stale, suggest /god-docs | repo-doc-sync ran>
+  Repo surface: <fresh | N stale, suggest /god-doctor | repo-surface-sync ran>
+  Host: <full | degraded | unknown with host and first gap>
+  Runtime: <not-applicable | known URL, suggest /god-test-runtime | no known URL, defer deployed verification>
+  Automation: <not configured | N active | available via provider, suggest /god-automation-setup>
+  Security: <clear | sensitive files changed, suggest /god-harden>
+  Dependencies: <clear | dependency files changed, suggest /god-update-deps>
+  Hygiene: <fresh | stale, suggest /god-hygiene>
+
+Open items:
+  1. <deferred staging, unstaged files, pending review, blocker, or none>
+
+Next:
+  Recommended: <one concrete command or user decision>
+  Why: <one sentence tied to current state>
+```
+
+## Proposition closeout
+
+When a command only recommends work, end with this proposition block unless it already launched the selected command.
+
+```text
+Proposition:
+  1. Implement partial: <single suggested command>
+  2. Implement complete: <recipe sequence or /god-mode when safe>
+  3. Discuss more: /god-discuss <routing ambiguity or missing prerequisite>
+  4. Inspect status: /god-status, /god-locate, or /god-next
+Recommended: <one option and why>
+```
+
+## Proactive rules
+
+`/god-status` is read-only by default, so Level 3 agent work becomes a suggestion unless the user asked it to continue work.
+
+`/god-next` may run Level 2 local helpers only when there is a direct trigger. Standalone `/god-next` turns Level 3 work into the recommended command or a proposition option.
+
+Report checkpoint, review, sync, docs, repo surface, host, runtime, automation, security, dependency, and hygiene signals using the labels in the required shape.

package/references/shared/LOCKING.md

@@ -0,0 +1,15 @@
+# Shared Locking Contract
+
+This reference owns the state-lock contract used by mutating Godpowers commands.
+
+## Contract
+
+The orchestrator acquires a state lock before any skill mutates project state. The lock is scoped to the smallest affected unit, such as `tier-1.prd` for `/god-prd` or `linkage` for `/god-scan`.
+
+The default lock TTL is 5 minutes. The same holder may re-enter the lock. Stale locks are force-reclaimable through `/god-repair`.
+
+Read-only inspection commands do not block on the lock. Examples include `/god-status`, `/god-doctor`, and `/god-locate`.
+
+Concurrent writers on non-overlapping scopes are allowed. Concurrent writers on overlapping scopes must pause or route through `/god-next`.
+
+The full architecture contract lives in `ARCHITECTURE.md` under the concurrency contract section.

package/references/shared/README.md

@@ -8,6 +8,8 @@ Cross-tier reference content used by multiple agents.
 - [ORCHESTRATORS.md](ORCHESTRATORS.md): composition patterns with other AI
   coding workflow systems, including migration and managed sync-back.
 - [GLOSSARY.md](GLOSSARY.md): standardized vocabulary across tiers.
+- [DASHBOARD-CONTRACT.md](DASHBOARD-CONTRACT.md): shared dashboard and proposition output contract.
+- [LOCKING.md](LOCKING.md): shared state-lock contract for mutating commands.
 
 ## Planned content
 

package/routing/god-roadmap-check.yaml

@@ -4,7 +4,7 @@ metadata:
   command: /god-roadmap-check
   description: Reconcile intent against ROADMAP.md before feature work
   tier: 1
-  family: maintain
+  family: compatibility
 
 prerequisites:
   required:

package/skills/god-arch.md

@@ -70,15 +70,4 @@ The reflog records every god-arch invocation as `op:god-arch` for `/god-undo`.
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-build.md

@@ -106,15 +106,4 @@ after the current increment.
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-deploy.md

@@ -95,15 +95,4 @@ The reflog records every god-deploy invocation as `op:god-deploy` for `/god-undo
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-design.md

@@ -261,15 +261,4 @@ The reflog records every god-design invocation as `op:god-design` for `/god-undo
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-feature.md

@@ -109,15 +109,4 @@ in the linkage system:
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-harden.md

@@ -92,15 +92,4 @@ The reflog records every god-harden invocation as `op:god-harden` for `/god-undo
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-hotfix.md

@@ -125,15 +125,4 @@ in the linkage system:
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-launch.md

@@ -97,15 +97,4 @@ The reflog records every god-launch invocation as `op:god-launch` for `/god-undo
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-link.md

@@ -76,15 +76,4 @@ No source files are modified by this skill.
 
 ## Locking
 
-The orchestrator acquires a state-lock before this skill mutates anything,
-scoped to the smallest affected unit (e.g. `tier-1.prd` for `/god-prd`,
-`linkage` for `/god-scan`). Lock TTL is 5 minutes; reentrant for the
-same holder; force-reclaimable if stale via `/god-repair`.
-
-Read-only inspection commands (`/god-status`, `/god-doctor`,
-`/god-locate`) do NOT block on the lock. Concurrent writers on
-non-overlapping scopes are allowed; on overlapping scopes, the second
-writer pauses or routes elsewhere via `/god-next`.
-
-See [ARCHITECTURE.md "Concurrency contract"](../ARCHITECTURE.md) for
-the full contract.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-migrate.md

@@ -141,6 +141,4 @@ Suggested next:
 
 ## Locking
 
-Acquire the state lock with scope `migration.source-systems` before writing
-`.godpowers/prep/IMPORTED-CONTEXT.md`, seed artifacts, source-system companion
-files, or `state.json`.
+See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.