arkgate 4.7.1 → 4.7.3

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 (48) hide show
  1. package/CHANGELOG.md +38 -1
  2. package/README.md +43 -34
  3. package/bin/lib/agent-projection.mjs +1 -1
  4. package/bin/lib/ci-and-commands.mjs +3 -3
  5. package/bin/lib/enforcement-honesty.mjs +1 -1
  6. package/bin/lib/first-run-help.mjs +3 -3
  7. package/bin/lib/html-report-depth.mjs +1 -1
  8. package/bin/lib/html-report.mjs +4 -4
  9. package/dist/index.cjs +2 -2
  10. package/dist/index.d.ts +1 -1
  11. package/dist/index.js +2 -2
  12. package/docs/README.md +9 -5
  13. package/docs/agent-guide.md +6 -5
  14. package/docs/ai-gates.md +3 -2
  15. package/docs/develop.md +10 -6
  16. package/docs/enthusiast/README.md +11 -8
  17. package/docs/package-surface.md +6 -3
  18. package/docs/product-voice.md +151 -38
  19. package/docs/use.md +21 -14
  20. package/package.json +3 -4
  21. package/server.json +4 -4
  22. package/templates/agent-skills/README.md +1 -1
  23. package/templates/agent-skills/ark-adopt/SKILL.md +2 -2
  24. package/templates/agent-skills/ark-architect/SKILL.md +1 -1
  25. package/templates/agent-skills/ark-autopilot/SKILL.md +2 -2
  26. package/templates/agent-skills/ark-contract/SKILL.md +1 -1
  27. package/templates/agent-skills/ark-coverage/SKILL.md +1 -1
  28. package/templates/agent-skills/ark-explain/SKILL.md +1 -1
  29. package/templates/agent-skills/ark-explore/SKILL.md +1 -1
  30. package/templates/agent-skills/ark-fix/SKILL.md +1 -1
  31. package/templates/agent-skills/ark-loop/SKILL.md +1 -1
  32. package/templates/agent-skills/ark-place/SKILL.md +1 -1
  33. package/templates/agent-skills/ark-runtime/SKILL.md +1 -1
  34. package/templates/agent-skills/ark-think/SKILL.md +1 -1
  35. package/templates/agent-skills/ark-upgrade/SKILL.md +1 -1
  36. package/templates/skills/ark-adopt.md +2 -2
  37. package/templates/skills/ark-architect.md +1 -1
  38. package/templates/skills/ark-autopilot.md +2 -2
  39. package/templates/skills/ark-contract.md +1 -1
  40. package/templates/skills/ark-coverage.md +1 -1
  41. package/templates/skills/ark-explain.md +1 -1
  42. package/templates/skills/ark-explore.md +1 -1
  43. package/templates/skills/ark-fix.md +1 -1
  44. package/templates/skills/ark-loop.md +1 -1
  45. package/templates/skills/ark-place.md +1 -1
  46. package/templates/skills/ark-runtime.md +1 -1
  47. package/templates/skills/ark-think.md +1 -1
  48. package/templates/skills/ark-upgrade.md +1 -1
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-architect
3
- description: Shortcut to /ark-adopt for greenfield shape. Deprecated as a first-class door. Do adopt’s job.
3
+ description: Shortcut to /ark-adopt for a new tree. Deprecated as a first-class door.
4
4
  ---
5
5
 
6
6
  # /ark-architect — Shortcut to /ark-adopt
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-autopilot
3
- description: Apply Ark end-to-end — explore first; dual plan A (edges) + B (shape); write mechanical-safe and judgment in this turn; one Shape refactor. Empty plan A is not healthy if leftover design remains. CLI is a sensor; you edit files.
3
+ description: Fix illegal imports and one leftover-design refactor. CLI is a sensor; you edit files.
4
4
  ---
5
5
 
6
6
  # /ark-autopilot — Apply the path
@@ -14,7 +14,7 @@ description: Apply Ark end-to-end — explore first; dual plan A (edges) + B (sh
14
14
  2. Fix import-rule debt; if leftover design remains, apply **one** small refactor.
15
15
  3. Re-run doctor. Never weaken `ark.config.json`.
16
16
 
17
- **This is the apply door.** Invoking it **is** the approval. Doctor remains the control plane.
17
+ **This is the apply door.** Invoking it **is** the approval. Run `arkgate-check --doctor` for the next step.
18
18
 
19
19
  ## Autonomy contract
20
20
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-contract
3
- description: Shortcut to /ark-adopt (session 0) or /ark-autopilot (later config tighten). Edit layers, ArkRules, or the ArkRun extra. Deprecated as a first-class door.
3
+ description: Shortcut edit the rules file or extra rules. Use /ark-adopt or /ark-autopilot.
4
4
  ---
5
5
 
6
6
  # /ark-contract — Shortcut to adopt / autopilot
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-coverage
3
- description: Ark adoption fitness audit governed%, gates, baseline honesty, capability gaps. CLI is a sensor; read enough source to prove gaps. Full product recon and pattern dual-plan belong to /ark-explore.
3
+ description: How much of the tree the rules file covers. CLI is a sensor; read the source.
4
4
  ---
5
5
 
6
6
  # /ark-coverage — Ark adoption fitness (not full recon)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-explain
3
- description: Explain this project's architecture in plain language and generate the showcase HTML report — layers, rules, coverage, gates, and why the contract exists.
3
+ description: Explain the rules file in plain language and generate the HTML report.
4
4
  ---
5
5
 
6
6
  # /ark-explain — Understand this project's architecture
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-explore
3
- description: Map skill decision-grade recon of layers + ArkRules opportunities + dual-plan seed (no apply). Primary post-green door when leftover design work remains. CLI is a sensor; you read the tree. No gate bypass.
3
+ description: Map import rules and leftover design. No apply. CLI is a sensor; you read the tree.
4
4
  ---
5
5
 
6
6
  # /ark-explore — Recon the real project (map only)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-fix
3
- description: Shortcut to /ark-autopilot for a small violation cluster. Deprecated as a first-class door.
3
+ description: Shortcut to /ark-autopilot for a small illegal-import cluster.
4
4
  ---
5
5
 
6
6
  # /ark-fix — Shortcut to /ark-autopilot
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-loop
3
- description: Shortcut to /ark-autopilot for driving plan A to zero. Deprecated as a first-class door. CLI validates — you edit code.
3
+ description: Shortcut to /ark-autopilot for illegal-import fixes. CLI validates — you edit code.
4
4
  ---
5
5
 
6
6
  # /ark-loop — Shortcut to /ark-autopilot
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-place
3
- description: "Where does new code go? Names the layer, directory, and naming for a new artifact from the contract, and writes it there. Autonomous."
3
+ description: "Where does new code go? Names the folder from the rules file and writes the file there."
4
4
  ---
5
5
 
6
6
  # /ark-place — Where does this code go?
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-runtime
3
- description: Evaluate and wire the experimental ArkRun companion (@arkgate/runtime) against hand-rolled event bus, outbox, saga, projection, policy, or NestJS code. One candidate. Extra on via /ark-adopt; new files via /ark-place. Skills never enforce.
3
+ description: Wire the optional ArkRun extra (@arkgate/runtime). One candidate. Extra on via /ark-adopt.
4
4
  ---
5
5
 
6
6
  # /ark-runtime — Evaluate and wire ArkRun (experimental opt-in)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-think
3
- description: Host-side architectural reasoning — 2–3 enforceable options on layer and/or ArkRules planes for ONE decision. Not full recon (use /ark-explore). No gate bypass. No package LLM call.
3
+ description: 2–3 options for one import-rule or ArkRules decision. Not a full map (use /ark-explore).
4
4
  ---
5
5
 
6
6
  # /ark-think — Architectural reasoning (host LLM only)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ark-upgrade
3
- description: Upgrade ArkGate through a content-identity preview, preserve customized files, and verify the active host and architecture contract.
3
+ description: Upgrade ArkGate. Preview first, keep customized files, then apply.
4
4
  ---
5
5
 
6
6
  # /ark-upgrade — managed ArkGate upgrade