arkgate 4.5.7 → 4.6.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 (36) hide show
  1. package/CHANGELOG.md +24 -1
  2. package/README.md +12 -10
  3. package/bin/ark-check-runtime.mjs +9 -1
  4. package/bin/lib/agent-homes.mjs +296 -0
  5. package/bin/lib/agent-projection.mjs +1 -1
  6. package/bin/lib/ci-and-commands.mjs +7 -7
  7. package/bin/lib/design-smells.mjs +3 -7
  8. package/bin/lib/doctor-plan.mjs +36 -12
  9. package/bin/lib/golden-pattern.mjs +1 -1
  10. package/bin/lib/host-support-matrix.mjs +4 -4
  11. package/bin/lib/html-report-depth.mjs +7 -8
  12. package/bin/lib/html-report.mjs +2 -1
  13. package/bin/lib/install-migrate.mjs +12 -0
  14. package/bin/lib/post-green-path.mjs +3 -2
  15. package/bin/lib/product-copy.mjs +32 -0
  16. package/bin/lib/skill-write.mjs +1 -1
  17. package/bin/lib/upgrade-whats-new.mjs +16 -0
  18. package/dist/index.cjs +19 -19
  19. package/dist/index.d.ts +1 -1
  20. package/dist/index.js +22 -22
  21. package/docs/README.md +3 -2
  22. package/docs/agent-guide.md +10 -7
  23. package/docs/ai-gates.md +19 -0
  24. package/docs/develop.md +3 -3
  25. package/docs/package-surface.md +2 -2
  26. package/docs/product-voice.md +80 -74
  27. package/docs/use.md +7 -5
  28. package/package.json +2 -2
  29. package/server.json +3 -3
  30. package/templates/agent-skills/README.md +1 -1
  31. package/templates/agent-skills/ark-autopilot/SKILL.md +1 -1
  32. package/templates/agent-skills/ark-explore/SKILL.md +5 -5
  33. package/templates/agent-skills/ark-upgrade/SKILL.md +2 -1
  34. package/templates/skills/ark-autopilot.md +1 -1
  35. package/templates/skills/ark-explore.md +5 -5
  36. package/templates/skills/ark-upgrade.md +2 -1
package/templates/skills/ark-upgrade.md CHANGED
@@ -21,7 +21,7 @@ Name 1–3 **residual** lenses in plain language before skill-shopping. Always `
21
21
 
22
22
  **What the user should feel next:** fewer blocked AI writes, clearer folders, safer domain — then jargon.
23
23
 
24
- **Anti false-done:** empty plan A + residual lenses / design-weak → **Incomplete? yes**. Green edges alone
24
+ **Anti false-done:** empty plan A + leftover design work → **Incomplete? yes**. Green imports alone
25
25
  are not “architecture finished.”
26
26
 
27
27
  **AI-easy architecture:** ports over concrete I/O in domain; one concern per module; golden pattern for
@@ -58,6 +58,7 @@ Never invent gate verdicts from these suggestions. Missing residual is honest em
58
58
  | Skills customized after install | Preserved by default. Preview `skillDrift` shows counts. **`--refresh-skills`** rewrites customized *skills* only with consent. |
59
59
  | Conflicted managed assets | Still need `--accept-conflicts`. Never silent overwrite of true edits. |
60
60
  | Multiple checkouts / monorepo packages | One `expectedRoot` per project; upgrade **each** pin; restart MCP after bump; prefer project-local CLI until identity matched **and** process version aligns. |
61
+ | Stale `~/.claude/skills` or `~/.grok/skills` | Shared homes should be the newest ArkGate on the machine (additive; never downgrade). Refresh: `--install-agent-gates --skills-only --agent-homes --force`. Project skills may lag with the pin. |
61
62
  | Active host not in `--tools` / manifest | Preview `hostSelection` notes it and suggests `--tools` expansion. |
62
63
 
63
64
  **Post-apply:** read `postUpgradeChecks` (advisory). Confirm pin↔CLI, run doctor (compass + deepModuleCoach),