@event4u/agent-config 9.9.0 → 9.11.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 (479) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +212 -194
  3. package/README.md +13 -16
  4. package/agents/templates/.ai-council.yml.example +481 -0
  5. package/agents/templates/.ai-video.xml.example +247 -0
  6. package/dist/agent-src/commands/agent-status.md +12 -11
  7. package/dist/agent-src/commands/agents/user/accept.md +115 -30
  8. package/dist/agent-src/commands/agents/user/delete.md +147 -0
  9. package/dist/agent-src/commands/agents/user/review.md +65 -28
  10. package/dist/agent-src/commands/agents/user/show.md +82 -29
  11. package/dist/agent-src/commands/agents/user/update.md +2 -2
  12. package/dist/agent-src/commands/agents/user.md +16 -3
  13. package/dist/agent-src/commands/check-current-md.md +0 -10
  14. package/dist/agent-src/commands/condense.md +28 -97
  15. package/dist/agent-src/commands/cost/report.md +7 -0
  16. package/dist/agent-src/commands/fix/portability.md +0 -8
  17. package/dist/agent-src/commands/fix/refs.md +0 -8
  18. package/dist/agent-src/commands/humanize.md +2 -2
  19. package/dist/agent-src/commands/jira-ticket.md +1 -1
  20. package/dist/agent-src/commands/memory/load.md +11 -0
  21. package/dist/agent-src/commands/optimize/skills.md +1 -1
  22. package/dist/agent-src/commands/pr/create.md +4 -4
  23. package/dist/agent-src/commands/profile/show.md +3 -3
  24. package/dist/agent-src/commands/rule-compliance-audit.md +5 -4
  25. package/dist/agent-src/commands/security-audit-config.md +1 -1
  26. package/dist/agent-src/commands/sync/gitignore/fix.md +1 -1
  27. package/dist/agent-src/commands/tdd.md +21 -0
  28. package/dist/agent-src/commands/team/delegate.md +2 -2
  29. package/dist/agent-src/commands/team-knowledge/bootstrap.md +9 -8
  30. package/dist/agent-src/commands/team-knowledge/consolidate.md +8 -7
  31. package/dist/agent-src/commands/team.md +4 -1
  32. package/dist/agent-src/commands/upstream-contribute.md +0 -1
  33. package/dist/agent-src/contexts/authority/commit-mechanics.md +7 -0
  34. package/dist/agent-src/contexts/authority/destructive-mechanics.md +16 -0
  35. package/dist/agent-src/contexts/authority/scope-mechanics.md +61 -0
  36. package/dist/agent-src/contexts/communication/rules-auto/reply-close-mechanics.md +20 -18
  37. package/dist/agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +1 -1
  38. package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +1 -1
  39. package/dist/agent-src/contexts/communication/rules-auto/source-of-truth-mechanics.md +9 -10
  40. package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +1 -1
  41. package/dist/agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +11 -0
  42. package/dist/agent-src/contexts/contracts/artifact-engagement-flow.md +26 -15
  43. package/dist/agent-src/contexts/contracts/command-suggestion-flow.md +3 -0
  44. package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +67 -37
  45. package/dist/agent-src/contexts/execution/auto-orchestration-activation.md +1 -1
  46. package/dist/agent-src/contexts/execution/autonomy-examples.md +1 -1
  47. package/dist/agent-src/contexts/execution/autonomy-mechanics.md +7 -6
  48. package/dist/agent-src/contexts/execution/evidence-discipline.md +92 -77
  49. package/dist/agent-src/contexts/execution/orchestration-benchmark-gate.md +22 -21
  50. package/dist/agent-src/contexts/execution/orchestration-telemetry.md +24 -0
  51. package/dist/agent-src/contexts/execution/project-intelligence.md +122 -103
  52. package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +23 -21
  53. package/dist/agent-src/contexts/execution/subagent-response-contract.md +5 -5
  54. package/dist/agent-src/contexts/execution/subagent-routing.md +11 -0
  55. package/dist/agent-src/contexts/execution/subagent-spawn-contract.md +13 -13
  56. package/dist/agent-src/contexts/execution/subagent-steering.md +36 -34
  57. package/dist/agent-src/contexts/execution/toolchain-resolver.md +1 -1
  58. package/dist/agent-src/contexts/execution/user-memory-channels.md +189 -0
  59. package/dist/agent-src/contexts/execution/verification-mechanics.md +9 -0
  60. package/dist/agent-src/contexts/model-recommendations.md +3 -2
  61. package/dist/agent-src/contexts/subagent-configuration.md +3 -3
  62. package/dist/agent-src/ghostwriter/README.md +2 -2
  63. package/dist/agent-src/packs/README.md +1 -1
  64. package/dist/agent-src/personas/README.md +5 -5
  65. package/dist/agent-src/personas/_template-specialist/persona.md +3 -3
  66. package/dist/agent-src/personas/backend-architect.md +24 -23
  67. package/dist/agent-src/personas/eloquent-tamer.md +30 -30
  68. package/dist/agent-src/personas/frontend-engineer.md +30 -30
  69. package/dist/agent-src/personas/product-owner.md +41 -38
  70. package/dist/agent-src/personas/qa.md +13 -13
  71. package/dist/agent-src/personas/security-engineer.md +22 -22
  72. package/dist/agent-src/presets/README.md +3 -3
  73. package/dist/agent-src/profiles/README.md +3 -3
  74. package/dist/agent-src/rules/active-remediation.md +2 -2
  75. package/dist/agent-src/rules/artifact-engagement-recording.md +4 -4
  76. package/dist/agent-src/rules/ask-when-uncertain.md +0 -4
  77. package/dist/agent-src/rules/augment-edit-discipline.md +1 -1
  78. package/dist/agent-src/rules/broken-access-control.md +4 -4
  79. package/dist/agent-src/rules/code-comment-discipline.md +1 -1
  80. package/dist/agent-src/rules/code-provenance.md +2 -2
  81. package/dist/agent-src/rules/commit-policy.md +4 -9
  82. package/dist/agent-src/rules/communication-through-line.md +5 -5
  83. package/dist/agent-src/rules/decision-revisit-gate.md +1 -1
  84. package/dist/agent-src/rules/design-fidelity.md +1 -1
  85. package/dist/agent-src/rules/doc-screenshot-hygiene.md +1 -1
  86. package/dist/agent-src/rules/domain-adoption-policy.md +1 -1
  87. package/dist/agent-src/rules/domain-safety-pii.md +1 -1
  88. package/dist/agent-src/rules/external-code-graph-interop.md +1 -1
  89. package/dist/agent-src/rules/fast-path-marker-visibility.md +43 -7
  90. package/dist/agent-src/rules/finance-safety-floor.md +1 -1
  91. package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +3 -3
  92. package/dist/agent-src/rules/history-discipline.md +1 -1
  93. package/dist/agent-src/rules/legal-safety-floor.md +1 -1
  94. package/dist/agent-src/rules/lethal-trifecta-guard.md +5 -5
  95. package/dist/agent-src/rules/low-impact-corpus-privacy-floor.md +10 -8
  96. package/dist/agent-src/rules/media-governance-routing.md +13 -13
  97. package/dist/agent-src/rules/media-sync-ground-truth.md +29 -11
  98. package/dist/agent-src/rules/no-cheap-questions.md +7 -7
  99. package/dist/agent-src/rules/no-decorative-emojis-in-git-surfaces.md +29 -18
  100. package/dist/agent-src/rules/non-destructive-by-default.md +5 -23
  101. package/dist/agent-src/rules/onboarding-gate.md +14 -4
  102. package/dist/agent-src/rules/persona-governance.md +2 -2
  103. package/dist/agent-src/rules/prefer-enums-over-literals.md +9 -9
  104. package/dist/agent-src/rules/preservation-guard.md +10 -2
  105. package/dist/agent-src/rules/question-not-instruction.md +1 -1
  106. package/dist/agent-src/rules/roadmap-progress-sync.md +6 -6
  107. package/dist/agent-src/rules/rule-type-governance.md +1 -1
  108. package/dist/agent-src/rules/scale-discipline.md +1 -1
  109. package/dist/agent-src/rules/scope-control.md +1 -1
  110. package/dist/agent-src/rules/secret-vcs-guard.md +1 -1
  111. package/dist/agent-src/rules/security-sensitive-stop.md +17 -11
  112. package/dist/agent-src/rules/senior-engineering-discipline.md +17 -17
  113. package/dist/agent-src/rules/session-canary.md +1 -1
  114. package/dist/agent-src/rules/skill-quality.md +1 -1
  115. package/dist/agent-src/rules/source-confidentiality.md +21 -19
  116. package/dist/agent-src/rules/source-of-truth.md +6 -5
  117. package/dist/agent-src/rules/spreadsheet-source-quality.md +2 -2
  118. package/dist/agent-src/rules/strategy-safety-floor.md +1 -1
  119. package/dist/agent-src/rules/think-before-action.md +5 -5
  120. package/dist/agent-src/rules/token-budget-discipline.md +5 -3
  121. package/dist/agent-src/rules/token-efficiency.md +2 -2
  122. package/dist/agent-src/rules/untrusted-input-defense.md +4 -4
  123. package/dist/agent-src/rules/user-interaction.md +12 -0
  124. package/dist/agent-src/rules/verify-before-complete.md +4 -24
  125. package/dist/agent-src/skills/adversarial-review/SKILL.md +2 -2
  126. package/dist/agent-src/skills/agent-security-review/SKILL.md +52 -45
  127. package/dist/agent-src/skills/agents-md-thin-root/SKILL.md +2 -2
  128. package/dist/agent-src/skills/ai-code-blindspots/SKILL.md +20 -20
  129. package/dist/agent-src/skills/ai-council/SKILL.md +185 -128
  130. package/dist/agent-src/skills/analysis-skill-router/SKILL.md +3 -3
  131. package/dist/agent-src/skills/api-endpoint/SKILL.md +2 -2
  132. package/dist/agent-src/skills/artisan-commands/SKILL.md +2 -2
  133. package/dist/agent-src/skills/async-python-patterns/SKILL.md +8 -7
  134. package/dist/agent-src/skills/authz-review/SKILL.md +16 -15
  135. package/dist/agent-src/skills/aws-infrastructure/SKILL.md +5 -5
  136. package/dist/agent-src/skills/blade-ui/SKILL.md +1 -1
  137. package/dist/agent-src/skills/bug-analyzer/SKILL.md +30 -12
  138. package/dist/agent-src/skills/code-intelligence/SKILL.md +0 -1
  139. package/dist/agent-src/skills/code-intelligence/evals/triggers.json +52 -0
  140. package/dist/agent-src/skills/code-review/SKILL.md +6 -6
  141. package/dist/agent-src/skills/command-routing/SKILL.md +5 -4
  142. package/dist/agent-src/skills/composer-packages/SKILL.md +2 -2
  143. package/dist/agent-src/skills/condense-memory/SKILL.md +43 -41
  144. package/dist/agent-src/skills/context-document/SKILL.md +23 -21
  145. package/dist/agent-src/skills/copilot-config/SKILL.md +6 -1
  146. package/dist/agent-src/skills/decision-record/SKILL.md +20 -18
  147. package/dist/agent-src/skills/design-intelligence/SKILL.md +4 -4
  148. package/dist/agent-src/skills/design-review/SKILL.md +15 -14
  149. package/dist/agent-src/skills/design-system-capture/reference/design-system-json.md +28 -25
  150. package/dist/agent-src/skills/devcontainer/SKILL.md +2 -2
  151. package/dist/agent-src/skills/docker/SKILL.md +1 -1
  152. package/dist/agent-src/skills/docx-authoring/evals/triggers.json +52 -0
  153. package/dist/agent-src/skills/emit-tickets/SKILL.md +2 -2
  154. package/dist/agent-src/skills/error-handling-patterns/SKILL.md +1 -1
  155. package/dist/agent-src/skills/estimate-ticket/SKILL.md +2 -2
  156. package/dist/agent-src/skills/evaluate-llm-feature/SKILL.md +0 -1
  157. package/dist/agent-src/skills/evaluate-llm-feature/evals/triggers.json +52 -0
  158. package/dist/agent-src/skills/existing-ui-audit/SKILL.md +21 -7
  159. package/dist/agent-src/skills/fe-design/SKILL.md +10 -0
  160. package/dist/agent-src/skills/feature-planning/SKILL.md +2 -2
  161. package/dist/agent-src/skills/finishing-a-development-branch/SKILL.md +3 -3
  162. package/dist/agent-src/skills/flux/SKILL.md +1 -1
  163. package/dist/agent-src/skills/frontend-render-security/SKILL.md +13 -13
  164. package/dist/agent-src/skills/git-workflow/SKILL.md +33 -33
  165. package/dist/agent-src/skills/grafana/SKILL.md +5 -0
  166. package/dist/agent-src/skills/humanizer/SKILL.md +83 -66
  167. package/dist/agent-src/skills/humanizer/data/patterns.md +14 -14
  168. package/dist/agent-src/skills/humanizer/references/anti-aiisms.md +4 -4
  169. package/dist/agent-src/skills/judge-artifact-completeness/SKILL.md +82 -37
  170. package/dist/agent-src/skills/judge-bug-hunter/SKILL.md +17 -5
  171. package/dist/agent-src/skills/judge-injection-defense/SKILL.md +63 -25
  172. package/dist/agent-src/skills/judge-security-auditor/SKILL.md +2 -0
  173. package/dist/agent-src/skills/judge-synthesis/SKILL.md +72 -28
  174. package/dist/agent-src/skills/laravel-horizon/SKILL.md +5 -0
  175. package/dist/agent-src/skills/laravel-mail/SKILL.md +5 -4
  176. package/dist/agent-src/skills/laravel-middleware/SKILL.md +5 -4
  177. package/dist/agent-src/skills/laravel-notifications/SKILL.md +10 -9
  178. package/dist/agent-src/skills/laravel-pennant/SKILL.md +1 -1
  179. package/dist/agent-src/skills/laravel-pulse/SKILL.md +9 -8
  180. package/dist/agent-src/skills/laravel-reverb/SKILL.md +6 -5
  181. package/dist/agent-src/skills/laravel-scheduling/SKILL.md +6 -1
  182. package/dist/agent-src/skills/laravel-validation/SKILL.md +12 -0
  183. package/dist/agent-src/skills/launch-readiness/SKILL.md +1 -1
  184. package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +7 -7
  185. package/dist/agent-src/skills/learning-tutor/SKILL.md +44 -43
  186. package/dist/agent-src/skills/learning-tutor/evals/triggers.json +52 -0
  187. package/dist/agent-src/skills/license-compliance-audit/SKILL.md +7 -7
  188. package/dist/agent-src/skills/license-compliance-borrow-check/SKILL.md +3 -3
  189. package/dist/agent-src/skills/license-compliance-credits/SKILL.md +4 -4
  190. package/dist/agent-src/skills/llm-provider-knowledge/SKILL.md +0 -1
  191. package/dist/agent-src/skills/memory-consolidation/SKILL.md +69 -64
  192. package/dist/agent-src/skills/motion-choreographer/SKILL.md +6 -6
  193. package/dist/agent-src/skills/pdf-tools/evals/triggers.json +52 -0
  194. package/dist/agent-src/skills/performance-analysis/SKILL.md +7 -3
  195. package/dist/agent-src/skills/persona-improvement/SKILL.md +0 -2
  196. package/dist/agent-src/skills/persona-improvement/evals/triggers.json +52 -0
  197. package/dist/agent-src/skills/php-coder/SKILL.md +10 -0
  198. package/dist/agent-src/skills/prediction-pool-optimizer/SKILL.md +129 -120
  199. package/dist/agent-src/skills/prediction-pool-optimizer/reference/ev-fixtures.md +36 -35
  200. package/dist/agent-src/skills/prediction-pool-optimizer/reference/odds-and-bonus.md +45 -41
  201. package/dist/agent-src/skills/project-analysis-core/SKILL.md +4 -4
  202. package/dist/agent-src/skills/project-analysis-hypothesis-driven/SKILL.md +3 -3
  203. package/dist/agent-src/skills/project-analysis-react/SKILL.md +1 -1
  204. package/dist/agent-src/skills/project-analysis-symfony/SKILL.md +1 -1
  205. package/dist/agent-src/skills/project-analysis-zend-laminas/SKILL.md +2 -2
  206. package/dist/agent-src/skills/prompt-engineering-patterns/SKILL.md +1 -1
  207. package/dist/agent-src/skills/prompt-validator/SKILL.md +39 -39
  208. package/dist/agent-src/skills/quality-tools/SKILL.md +15 -15
  209. package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +55 -19
  210. package/dist/agent-src/skills/react-shadcn-ui/reference/registry.md +29 -27
  211. package/dist/agent-src/skills/readme-writing-package/SKILL.md +2 -2
  212. package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +25 -25
  213. package/dist/agent-src/skills/recursive-verification/SKILL.md +6 -5
  214. package/dist/agent-src/skills/refine-prompt/SKILL.md +1 -1
  215. package/dist/agent-src/skills/refine-ticket/SKILL.md +20 -2
  216. package/dist/agent-src/skills/repomix-packer/SKILL.md +1 -1
  217. package/dist/agent-src/skills/requesting-code-review/SKILL.md +2 -2
  218. package/dist/agent-src/skills/roadmap-management/SKILL.md +80 -66
  219. package/dist/agent-src/skills/roadmap-writing/SKILL.md +84 -77
  220. package/dist/agent-src/skills/rule-refactor/SKILL.md +1 -1
  221. package/dist/agent-src/skills/screenshot-hygiene/evals/triggers.json +52 -0
  222. package/dist/agent-src/skills/security-audit/SKILL.md +26 -9
  223. package/dist/agent-src/skills/security-maturity-assessment/SKILL.md +38 -16
  224. package/dist/agent-src/skills/skill-improvement-pipeline/SKILL.md +14 -11
  225. package/dist/agent-src/skills/skill-writing/SKILL.md +9 -8
  226. package/dist/agent-src/skills/song-to-script/SKILL.md +93 -85
  227. package/dist/agent-src/skills/sql-writing/SKILL.md +2 -2
  228. package/dist/agent-src/skills/stakeholder-tradeoff/SKILL.md +4 -3
  229. package/dist/agent-src/skills/standards-from-config/SKILL.md +61 -43
  230. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +22 -8
  231. package/dist/agent-src/skills/subagent-orchestration/prompts/README.md +28 -2
  232. package/dist/agent-src/skills/supply-chain-intake/SKILL.md +13 -13
  233. package/dist/agent-src/skills/systematic-debugging/SKILL.md +22 -21
  234. package/dist/agent-src/skills/tailwind-engineer/SKILL.md +1 -1
  235. package/dist/agent-src/skills/technical-specification/SKILL.md +5 -0
  236. package/dist/agent-src/skills/terraform/SKILL.md +2 -2
  237. package/dist/agent-src/skills/terragrunt/SKILL.md +8 -8
  238. package/dist/agent-src/skills/testing-anti-patterns/process-anti-patterns.md +1 -1
  239. package/dist/agent-src/skills/threat-modeling/SKILL.md +19 -13
  240. package/dist/agent-src/skills/universal-project-analysis/SKILL.md +1 -1
  241. package/dist/agent-src/skills/upstream-contribute/SKILL.md +0 -1
  242. package/dist/agent-src/skills/using-git-worktrees/SKILL.md +9 -9
  243. package/dist/agent-src/skills/validate-feature-fit/SKILL.md +3 -1
  244. package/dist/agent-src/skills/verify-completion-evidence/SKILL.md +4 -6
  245. package/dist/agent-src/skills/verify-repair-loop/SKILL.md +67 -61
  246. package/dist/agent-src/skills/video-director/SKILL.md +7 -7
  247. package/dist/agent-src/skills/worktree-lifecycle/SKILL.md +3 -3
  248. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  249. package/dist/agent-src/templates/contexts/knowledge-pages.md +47 -45
  250. package/dist/agent-src/templates/contexts/lesson-card.md +2 -2
  251. package/dist/agent-src/templates/contexts/tenant-boundaries.md +2 -2
  252. package/dist/agent-src/templates/contexts.md +1 -1
  253. package/dist/agent-src/templates/features.md +1 -1
  254. package/dist/agent-src/templates/roadmaps.md +125 -116
  255. package/dist/agent-src/templates/rule.md +2 -1
  256. package/dist/agent-src/templates/scripts/pr_risk_review.ts +0 -0
  257. package/dist/agent-src/templates/scripts/telemetry/aggregator.ts +0 -0
  258. package/dist/agent-src/templates/scripts/tier_usage_report.ts +2 -2
  259. package/dist/agent-src/templates/scripts/work_engine/directives/ui/apply.ts +30 -30
  260. package/dist/agent-src/templates/scripts/work_engine/directives/ui/design.ts +88 -33
  261. package/dist/agent-src/templates/scripts/work_engine/directives/ui/polish.ts +22 -2
  262. package/dist/agent-src/templates/scripts/work_engine/directives/ui/review.ts +21 -2
  263. package/dist/agent-src/templates/scripts/work_engine/directives/ui/stack_bundles.ts +179 -0
  264. package/dist/agent-src/templates/scripts/work_engine/stack/detect.ts +155 -4
  265. package/dist/agent-src/templates/scripts/work_engine/state.ts +21 -4
  266. package/dist/agent-src/user-types/README.md +8 -8
  267. package/dist/agent-src/user-types/galabau-field-crew.md +34 -33
  268. package/dist/agent-src/user-types/metalworking-shop.md +35 -34
  269. package/dist/agent-src/user-types/truck-driver.md +22 -20
  270. package/dist/cli/initRouting.js +74 -11
  271. package/dist/cli/initRouting.js.map +1 -1
  272. package/dist/cli/main.js +14 -3
  273. package/dist/cli/main.js.map +1 -1
  274. package/dist/cli/python/workspace_roles.js +2 -2
  275. package/dist/cli/python/workspace_roles.js.map +1 -1
  276. package/dist/cli-delegate/chunk-4SV3XGFA.js +6910 -0
  277. package/dist/cli-delegate/chunk-736JCWLM.js +1104 -0
  278. package/dist/cli-delegate/chunk-7DSAMZFU.js +356 -0
  279. package/dist/cli-delegate/chunk-7HQ52DHU.js +74 -0
  280. package/dist/cli-delegate/chunk-BJGXZNPM.js +266 -0
  281. package/dist/cli-delegate/chunk-FTAISGDQ.js +117 -0
  282. package/dist/cli-delegate/chunk-GME3Q44L.js +82 -0
  283. package/dist/cli-delegate/chunk-GRRPEPRN.js +336 -0
  284. package/dist/cli-delegate/chunk-HJ6DAJHR.js +502 -0
  285. package/dist/cli-delegate/chunk-IR7P7JWA.js +872 -0
  286. package/dist/cli-delegate/chunk-J55WI3RR.js +47 -0
  287. package/dist/cli-delegate/chunk-MCJYCQPF.js +35 -0
  288. package/dist/cli-delegate/chunk-NDJLNC6Q.js +169 -0
  289. package/dist/cli-delegate/chunk-OMIVVCG2.js +26 -0
  290. package/dist/cli-delegate/chunk-OY53J6II.js +7336 -0
  291. package/dist/cli-delegate/chunk-RDGRHAAB.js +259 -0
  292. package/dist/cli-delegate/chunk-TFG57JJM.js +1969 -0
  293. package/dist/cli-delegate/chunk-XX6TOPD7.js +715 -0
  294. package/dist/cli-delegate/chunk-YMFO6FDN.js +10603 -0
  295. package/dist/cli-delegate/cmd_analyze_session.js +294 -0
  296. package/dist/cli-delegate/cmd_conformance.js +646 -0
  297. package/dist/cli-delegate/cmd_converge.js +326 -0
  298. package/dist/cli-delegate/cmd_doctor.js +144 -0
  299. package/dist/cli-delegate/cmd_explain.js +2508 -0
  300. package/dist/cli-delegate/cmd_export.js +296 -0
  301. package/dist/cli-delegate/cmd_fleet.js +332 -0
  302. package/dist/cli-delegate/cmd_memory_get.js +3878 -0
  303. package/dist/cli-delegate/cmd_migrate.js +11 -0
  304. package/dist/cli-delegate/cmd_preflight.js +270 -0
  305. package/dist/cli-delegate/cmd_prune.js +444 -0
  306. package/dist/cli-delegate/cmd_refresh.js +28 -0
  307. package/dist/cli-delegate/cmd_settings_check.js +574 -0
  308. package/dist/cli-delegate/cmd_settings_migrate.js +223 -0
  309. package/dist/cli-delegate/cmd_sync.js +264 -0
  310. package/dist/cli-delegate/cmd_uninstall.js +656 -0
  311. package/dist/cli-delegate/cmd_update.js +425 -0
  312. package/dist/cli-delegate/cmd_upgrade.js +444 -0
  313. package/dist/cli-delegate/cmd_validate.js +305 -0
  314. package/dist/cli-delegate/cmd_versions.js +370 -0
  315. package/dist/discovery/deprecation-report.md +1 -1
  316. package/dist/discovery/discovery-manifest.json +100 -67
  317. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  318. package/dist/discovery/discovery-manifest.summary.md +4 -4
  319. package/dist/discovery/orphan-report.md +1 -1
  320. package/dist/discovery/packs.json +16 -10
  321. package/dist/discovery/trust-report.md +2 -2
  322. package/dist/discovery/workspaces.json +7 -5
  323. package/dist/hooks/dispatch.js +186 -12
  324. package/dist/install/emit_host_rules_cli.js +2 -1
  325. package/dist/install/emit_host_rules_cli.js.map +1 -1
  326. package/dist/install/install.mjs +418 -378
  327. package/dist/install/rule_scope.js +5 -1
  328. package/dist/install/rule_scope.js.map +1 -1
  329. package/dist/install/toolDetection.js +40 -12
  330. package/dist/install/toolDetection.js.map +1 -1
  331. package/dist/install/wizard-plan.js +2 -2
  332. package/dist/install/wizard-plan.js.map +1 -1
  333. package/dist/mcp/registry-manifest.json +3 -3
  334. package/dist/mcp/server.json +2 -2
  335. package/dist/mcp/server.mjs +2194 -1003
  336. package/dist/router.json +1 -1
  337. package/dist/scripts/_lib/compile_time_toggles.js +48 -0
  338. package/dist/scripts/_lib/compile_time_toggles.js.map +1 -0
  339. package/dist/scripts/condense.js +234 -217
  340. package/dist/scripts/condense.js.map +1 -1
  341. package/dist/server/schemas/settings.js +4 -0
  342. package/dist/server/schemas/settings.js.map +1 -1
  343. package/dist/shared/userMd/utils.js +30 -0
  344. package/dist/shared/userMd/utils.js.map +1 -1
  345. package/dist/ui/assets/index-BpSQt5vm.js.map +1 -1
  346. package/docs/guidelines/agent-infra/api-cost-levers.md +56 -5
  347. package/docs/guidelines/agent-infra/simplicity-and-goal-demos.md +93 -33
  348. package/package.json +4 -2
  349. package/src/agent-src/templates/scripts/pr_risk_review.ts +0 -0
  350. package/src/agent-src/templates/scripts/telemetry/aggregator.ts +0 -0
  351. package/src/agent-src/templates/scripts/tier_usage_report.ts +2 -2
  352. package/src/agent-src/templates/scripts/work_engine/directives/ui/apply.ts +30 -30
  353. package/src/agent-src/templates/scripts/work_engine/directives/ui/design.ts +88 -33
  354. package/src/agent-src/templates/scripts/work_engine/directives/ui/polish.ts +22 -2
  355. package/src/agent-src/templates/scripts/work_engine/directives/ui/review.ts +21 -2
  356. package/src/agent-src/templates/scripts/work_engine/directives/ui/stack_bundles.ts +179 -0
  357. package/src/agent-src/templates/scripts/work_engine/stack/detect.ts +155 -4
  358. package/src/agent-src/templates/scripts/work_engine/state.ts +21 -4
  359. package/src/config/agent-settings.template.yml +32 -2
  360. package/src/config/ci-local-parity.yml +142 -0
  361. package/src/config/discovery/packs.yml +7 -0
  362. package/src/config/evaluator-budgets.json +1 -1
  363. package/src/config/gate-coverage.yml +127 -0
  364. package/src/config/pack-size-budget.json +27 -0
  365. package/src/config/preamble-payload-budget.json +44 -0
  366. package/src/install/emit_host_rules_cli.ts +2 -1
  367. package/src/install/rule_scope.ts +5 -1
  368. package/src/install/toolDetection.ts +39 -8
  369. package/src/install/wizard-plan.ts +2 -2
  370. package/src/scripts/_cli/cmd_conformance.ts +2 -1
  371. package/src/scripts/_cli/cmd_converge.ts +2 -1
  372. package/src/scripts/_cli/cmd_doctor.ts +292 -15
  373. package/src/scripts/_cli/cmd_export.ts +2 -1
  374. package/src/scripts/_cli/cmd_fleet.ts +2 -1
  375. package/src/scripts/_cli/cmd_migrate.ts +2 -1
  376. package/src/scripts/_cli/cmd_preflight.ts +2 -1
  377. package/src/scripts/_cli/cmd_refresh.ts +2 -1
  378. package/src/scripts/_cli/cmd_update.ts +2 -1
  379. package/src/scripts/_cli/cmd_upgrade.ts +2 -1
  380. package/src/scripts/_cli/cmd_versions.ts +2 -1
  381. package/src/scripts/_cli/detection_report.ts +480 -0
  382. package/src/scripts/_dispatch.bash +52 -14
  383. package/src/scripts/_lib/agent_user_profile.ts +381 -0
  384. package/src/scripts/_lib/agents_overlay.ts +9 -0
  385. package/src/scripts/_lib/anchor_eval.ts +311 -0
  386. package/src/scripts/_lib/cc_transcript.ts +316 -0
  387. package/src/scripts/_lib/changelog_eras.ts +103 -9
  388. package/src/scripts/_lib/compile_time_toggles.ts +79 -0
  389. package/src/scripts/_lib/confusables.ts +101 -0
  390. package/src/scripts/_lib/duplicate_scope_census.ts +77 -0
  391. package/src/scripts/_lib/environment_detector.ts +441 -0
  392. package/src/scripts/_lib/managed_agents_folder.ts +181 -0
  393. package/src/scripts/_lib/package_root.ts +72 -0
  394. package/src/scripts/_lib/payload_hash_drift.ts +126 -0
  395. package/src/scripts/_lib/preservation_migration.ts +291 -0
  396. package/src/scripts/_lib/retrieval_sanitize.ts +166 -2
  397. package/src/scripts/_lib/scan_scope.ts +115 -0
  398. package/src/scripts/_lib/user_global_memory_audit.ts +187 -0
  399. package/src/scripts/_lib/user_global_observations.ts +830 -0
  400. package/src/scripts/_lib/user_global_revocations.ts +110 -0
  401. package/src/scripts/_lib/user_memory_gate_counters.ts +291 -0
  402. package/src/scripts/ai_council/blind_review.ts +0 -0
  403. package/src/scripts/ai_council/budget_guard.ts +90 -11
  404. package/src/scripts/ai_council/bundler.ts +2 -2
  405. package/src/scripts/ai_council/clients.ts +59 -3
  406. package/src/scripts/ai_council/config.ts +53 -7
  407. package/src/scripts/ai_council/modes.ts +68 -2
  408. package/src/scripts/ai_council/orchestrator.ts +54 -9
  409. package/src/scripts/ai_council/transport_resolver.ts +331 -0
  410. package/src/scripts/ai_team/team_dispatch.ts +17 -6
  411. package/src/scripts/anchor_eval_falsify.ts +198 -0
  412. package/src/scripts/anchor_scoring_run.ts +239 -0
  413. package/src/scripts/annotate_discovery.ts +1 -65
  414. package/src/scripts/bench_quality_run.ts +168 -4
  415. package/src/scripts/cache_realization_report.ts +782 -0
  416. package/src/scripts/check_artefact_count_messaging.ts +5 -1
  417. package/src/scripts/check_augment_description_cap.ts +15 -4
  418. package/src/scripts/check_bundle_path_leakage.ts +10 -4
  419. package/src/scripts/check_ci_local_parity.ts +317 -0
  420. package/src/scripts/check_condensation.ts +96 -191
  421. package/src/scripts/check_context_paths.ts +38 -9
  422. package/src/scripts/check_dependency_floors.ts +153 -0
  423. package/src/scripts/check_gate_coverage.ts +299 -0
  424. package/src/scripts/check_iron_law_prominence.ts +22 -1
  425. package/src/scripts/check_kernel_prefix_stability.ts +0 -0
  426. package/src/scripts/check_no_new_legacy_path.ts +16 -6
  427. package/src/scripts/check_no_roadmap_refs.ts +22 -9
  428. package/src/scripts/check_originality_freshness.ts +167 -0
  429. package/src/scripts/check_pack_size.ts +188 -0
  430. package/src/scripts/check_preamble_payload_budget.ts +130 -0
  431. package/src/scripts/check_proposal.ts +0 -0
  432. package/src/scripts/check_references.ts +0 -1
  433. package/src/scripts/check_safety_floor_untouched.ts +171 -24
  434. package/src/scripts/check_site_links.ts +62 -3
  435. package/src/scripts/ci_status.ts +0 -0
  436. package/src/scripts/cluster_near_miss_patterns.ts +0 -0
  437. package/src/scripts/code_graph/build.ts +0 -0
  438. package/src/scripts/command_suggester/types.ts +0 -0
  439. package/src/scripts/compile_router.ts +10 -14
  440. package/src/scripts/condense.sh +3 -4
  441. package/src/scripts/condense.ts +247 -228
  442. package/src/scripts/cost/track.mjs +168 -33
  443. package/src/scripts/cost_summary.ts +33 -1
  444. package/src/scripts/council_cli.ts +51 -5
  445. package/src/scripts/discovery_graph.ts +0 -0
  446. package/src/scripts/encoding_corpus.ts +500 -0
  447. package/src/scripts/encoding_corpus_report.ts +216 -0
  448. package/src/scripts/evaluator_umbrella.sh +34 -1
  449. package/src/scripts/generate_index.ts +19 -2
  450. package/src/scripts/install-hooks.sh +2 -2
  451. package/src/scripts/learning_sidecar.ts +0 -0
  452. package/src/scripts/lint_confusables.ts +10 -72
  453. package/src/scripts/lint_eval_fixture_citations.ts +113 -0
  454. package/src/scripts/lint_featured_skills.ts +0 -0
  455. package/src/scripts/lint_hidden_unicode.ts +208 -0
  456. package/src/scripts/lint_load_context.ts +17 -5
  457. package/src/scripts/lint_new_skill_gate.ts +9 -3
  458. package/src/scripts/lint_no_python_twin_rationale.ts +17 -2
  459. package/src/scripts/lint_originality.ts +1 -1
  460. package/src/scripts/lint_skill_originality.ts +1 -1
  461. package/src/scripts/lint_ticket_buildable.ts +1 -1
  462. package/src/scripts/lint_ui_stack_bundles.ts +170 -0
  463. package/src/scripts/mcp_server/tools.ts +4 -4
  464. package/src/scripts/measure_scope_dedup.ts +224 -0
  465. package/src/scripts/memory_lookup.ts +0 -0
  466. package/src/scripts/mine_session.ts +98 -0
  467. package/src/scripts/orchestration_payload_hash_drift.ts +145 -0
  468. package/src/scripts/preamble_byte_census.ts +574 -0
  469. package/src/scripts/probe_skill_registration.ts +2 -2
  470. package/src/scripts/redact_hook_capture.ts +13 -0
  471. package/src/scripts/release.ts +65 -10
  472. package/src/scripts/router_telemetry.ts +1 -1
  473. package/src/scripts/second_brain_retrieval.ts +14 -4
  474. package/src/scripts/skill_linter.ts +5 -0
  475. package/src/scripts/surface-tiers.yml +2 -0
  476. package/src/scripts/validate_pack_yaml.ts +0 -0
  477. package/src/server/schemas/settings.ts +8 -0
  478. package/src/shared/userMd/utils.ts +31 -0
  479. package/dist/agent-src/rules/telegraph-speak.md +0 -87
@@ -0,0 +1,444 @@
1
+ #!/usr/bin/env tsx
2
+ import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
3
+ import {
4
+ _is_newer,
5
+ fetch_latest_from_npm
6
+ } from "./chunk-7HQ52DHU.js";
7
+ import {
8
+ CLAUDE_MARKETPLACE_NAME,
9
+ CLAUDE_PLUGIN_ID,
10
+ claude_plugin_installed
11
+ } from "./chunk-FTAISGDQ.js";
12
+ import {
13
+ _is_source_repo,
14
+ install_cli_wrapper,
15
+ needs_refresh
16
+ } from "./chunk-736JCWLM.js";
17
+ import {
18
+ read_lockfile
19
+ } from "./chunk-GRRPEPRN.js";
20
+ import {
21
+ project_settings_path
22
+ } from "./chunk-HJ6DAJHR.js";
23
+ import {
24
+ event4u_root,
25
+ write_target
26
+ } from "./chunk-NDJLNC6Q.js";
27
+ import {
28
+ resolvePackageRoot
29
+ } from "./chunk-MCJYCQPF.js";
30
+ import "./chunk-J55WI3RR.js";
31
+
32
+ // src/scripts/_cli/cmd_upgrade.ts
33
+ import * as fs from "node:fs";
34
+ import * as path from "node:path";
35
+ import { spawnSync } from "node:child_process";
36
+ import process from "node:process";
37
+ import { fileURLToPath, pathToFileURL } from "node:url";
38
+ var PACKAGE_NAME = "@event4u/agent-config";
39
+ var PACKAGE_ROOT = resolvePackageRoot(import.meta.url);
40
+ var _HERE = fileURLToPath(import.meta.url);
41
+ var ArgparseExit = class extends Error {
42
+ constructor(code) {
43
+ super(`argparse-exit-${code}`);
44
+ this.code = code;
45
+ }
46
+ code;
47
+ };
48
+ var _stdout = { write: (t) => process.stdout.write(t) };
49
+ var _stderr = { write: (t) => process.stderr.write(t) };
50
+ function _print(out, line = "") {
51
+ out.write(line + "\n");
52
+ }
53
+ function _isFile(p) {
54
+ try {
55
+ return fs.statSync(p).isFile();
56
+ } catch {
57
+ return false;
58
+ }
59
+ }
60
+ function shutilWhich(name) {
61
+ const isExe = (p) => {
62
+ try {
63
+ const st = fs.statSync(p);
64
+ if (!st.isFile()) return false;
65
+ if (process.platform === "win32") return true;
66
+ fs.accessSync(p, fs.constants.X_OK);
67
+ return true;
68
+ } catch {
69
+ return false;
70
+ }
71
+ };
72
+ if (name.includes("/") || name.includes("\\")) {
73
+ return isExe(name) ? name : null;
74
+ }
75
+ const pathEnv = process.env["PATH"] || "";
76
+ const sep = process.platform === "win32" ? ";" : ":";
77
+ const exts = process.platform === "win32" ? (process.env["PATHEXT"] || ".COM;.EXE;.BAT;.CMD").split(";") : [""];
78
+ const seen = /* @__PURE__ */ new Set();
79
+ for (const dir of pathEnv.split(sep)) {
80
+ const d = dir === "" ? "." : dir;
81
+ if (seen.has(d)) continue;
82
+ seen.add(d);
83
+ for (const ext of exts) {
84
+ const candidate = path.join(d, name + ext);
85
+ if (isExe(candidate)) {
86
+ return candidate;
87
+ }
88
+ }
89
+ }
90
+ return null;
91
+ }
92
+ function _default_runner(cmd) {
93
+ const r = spawnSync(cmd[0], cmd.slice(1), { stdio: "inherit" });
94
+ if (r.error) {
95
+ _stderr.write(`agent-config upgrade: cannot run ${cmd[0]}: ${osErrorStr(r.error)}
96
+ `);
97
+ return 1;
98
+ }
99
+ return r.status ?? 1;
100
+ }
101
+ function osErrorStr(exc) {
102
+ if (exc && typeof exc === "object" && "message" in exc) {
103
+ return String(exc.message);
104
+ }
105
+ return String(exc);
106
+ }
107
+ function lstripV(s) {
108
+ let out = s;
109
+ while (out.length > 0 && out[0] === "v") {
110
+ out = out.slice(1);
111
+ }
112
+ return out;
113
+ }
114
+ function _installed_version() {
115
+ const lock = read_lockfile();
116
+ if (lock !== null && typeof lock === "object") {
117
+ const v = lock["agent_config_version"];
118
+ if (typeof v === "string" && v) {
119
+ return lstripV(v.trim());
120
+ }
121
+ }
122
+ return "";
123
+ }
124
+ function _agent_config_bin() {
125
+ return shutilWhich("agent-config") ?? path.join(PACKAGE_ROOT, "agent-config");
126
+ }
127
+ function _maybe_refresh_project_wrapper(project_root, out, _err) {
128
+ if (_is_source_repo(project_root)) {
129
+ return;
130
+ }
131
+ if (!_isFile(path.join(project_root, "agent-config"))) {
132
+ return;
133
+ }
134
+ if (!needs_refresh(project_root)) {
135
+ return;
136
+ }
137
+ const wrapper = install_cli_wrapper(project_root);
138
+ if (wrapper !== null) {
139
+ _print(out, `\u2705 refreshed stale project wrapper: ${wrapper}`);
140
+ }
141
+ }
142
+ function _maybe_refresh_git_hook(project_root, runner, out, err) {
143
+ const hook = path.join(project_root, ".git", "hooks", "pre-commit");
144
+ let text;
145
+ try {
146
+ text = fs.readFileSync(hook, "utf-8");
147
+ } catch {
148
+ return;
149
+ }
150
+ if (!text.includes("pre-commit-roadmap-progress")) {
151
+ return;
152
+ }
153
+ const cmd = [_agent_config_bin(), "hooks:install", "--force"];
154
+ _print(out, "\u2192 " + cmd.join(" "));
155
+ let rc;
156
+ try {
157
+ rc = runner(cmd);
158
+ } catch (exc) {
159
+ rc = 127;
160
+ _print(err, `cannot run ${cmd[0]}: ${osErrorStr(exc)}`);
161
+ }
162
+ if (rc !== 0) {
163
+ _print(
164
+ err,
165
+ `\u26A0\uFE0F agent-config upgrade: pre-commit hook refresh failed (exit ${rc}) \u2014 run \`agent-config hooks:install --force\` manually.`
166
+ );
167
+ }
168
+ }
169
+ function _settings_sync_targets(project_root) {
170
+ const targets = [];
171
+ const global_settings = path.join(event4u_root(), "settings", ".agent-settings.yml");
172
+ if (_isFile(global_settings)) {
173
+ targets.push(global_settings);
174
+ }
175
+ const project_settings = project_settings_path(project_root);
176
+ if (project_settings !== global_settings && _isFile(project_settings)) {
177
+ targets.push(project_settings);
178
+ }
179
+ return targets;
180
+ }
181
+ function _sync_settings_files(targets, runner, out, err) {
182
+ for (const target of targets) {
183
+ const cmd = [_agent_config_bin(), "settings:sync", "--path", target];
184
+ _print(out, "\u2192 " + cmd.join(" "));
185
+ let rc;
186
+ try {
187
+ rc = runner(cmd);
188
+ } catch (exc) {
189
+ rc = 127;
190
+ _print(err, `cannot run ${cmd[0]}: ${osErrorStr(exc)}`);
191
+ }
192
+ if (rc !== 0) {
193
+ _print(
194
+ err,
195
+ `\u26A0\uFE0F agent-config upgrade: settings sync failed (exit ${rc}) for ${target} \u2014 run \`agent-config settings:sync --path ${target}\` manually.`
196
+ );
197
+ }
198
+ }
199
+ }
200
+ function _claude_plugin_refresh_steps() {
201
+ const claude = shutilWhich("claude");
202
+ if (claude === null) return [];
203
+ if (!claude_plugin_installed()) return [];
204
+ return [
205
+ [claude, "plugin", "marketplace", "update", CLAUDE_MARKETPLACE_NAME],
206
+ [
207
+ claude,
208
+ "plugin",
209
+ "update",
210
+ `${CLAUDE_PLUGIN_ID}@${CLAUDE_MARKETPLACE_NAME}`
211
+ ]
212
+ ];
213
+ }
214
+ function _refresh_claude_plugin(steps, runner, out, err) {
215
+ for (const cmd of steps) {
216
+ _print(out, "\u2192 " + cmd.join(" "));
217
+ let rc;
218
+ try {
219
+ rc = runner(cmd);
220
+ } catch (exc) {
221
+ rc = 127;
222
+ _print(err, `cannot run ${cmd[0]}: ${osErrorStr(exc)}`);
223
+ }
224
+ if (rc !== 0) {
225
+ _print(
226
+ err,
227
+ `\u26A0\uFE0F agent-config upgrade: Claude Code plugin refresh failed (exit ${rc}) \u2014 run \`${cmd.join(" ")}\` manually.`
228
+ );
229
+ return;
230
+ }
231
+ }
232
+ if (steps.length > 0) {
233
+ _print(out, "\u2139\uFE0F Claude Code plugin refreshed \u2014 restart Claude Code to load it.");
234
+ }
235
+ }
236
+ var PROG = "agent-config upgrade";
237
+ var USAGE = `usage: ${PROG} [-h] [--check] [--dry-run] [--converge]
238
+ `;
239
+ function _argError(msg) {
240
+ _stderr.write(USAGE);
241
+ _stderr.write(`${PROG}: error: ${msg}
242
+ `);
243
+ throw new ArgparseExit(2);
244
+ }
245
+ function _parse(argv) {
246
+ const args = { check: false, dry_run: false, converge: false };
247
+ const positionals = [];
248
+ let i = 0;
249
+ while (i < argv.length) {
250
+ const a = argv[i];
251
+ if (a === "-h" || a === "--help") {
252
+ _stdout.write(USAGE);
253
+ throw new ArgparseExit(0);
254
+ }
255
+ const eq = a.startsWith("--") ? a.indexOf("=") : -1;
256
+ const flag = eq >= 0 ? a.slice(0, eq) : a;
257
+ const inlineVal = eq >= 0 ? a.slice(eq + 1) : null;
258
+ if (flag === "--check") {
259
+ if (inlineVal !== null) {
260
+ _argError(`argument --check: ignored explicit argument '${inlineVal}'`);
261
+ }
262
+ args.check = true;
263
+ i += 1;
264
+ continue;
265
+ }
266
+ if (flag === "--dry-run") {
267
+ if (inlineVal !== null) {
268
+ _argError(`argument --dry-run: ignored explicit argument '${inlineVal}'`);
269
+ }
270
+ args.dry_run = true;
271
+ i += 1;
272
+ continue;
273
+ }
274
+ if (flag === "--converge") {
275
+ if (inlineVal !== null) {
276
+ _argError(`argument --converge: ignored explicit argument '${inlineVal}'`);
277
+ }
278
+ args.converge = true;
279
+ i += 1;
280
+ continue;
281
+ }
282
+ if (a.startsWith("-") && a !== "-") {
283
+ _argError(`unrecognized arguments: ${a}`);
284
+ }
285
+ positionals.push(a);
286
+ i += 1;
287
+ }
288
+ if (positionals.length > 0) {
289
+ _argError(`unrecognized arguments: ${positionals.join(" ")}`);
290
+ }
291
+ return args;
292
+ }
293
+ async function main(argv = null, options = {}) {
294
+ const runner = options.runner ?? _default_runner;
295
+ const fetcher = options.fetcher ?? (() => fetch_latest_from_npm());
296
+ const out = options.out ?? _stdout;
297
+ const err = options.err ?? _stderr;
298
+ const args = _parse(argv ?? process.argv.slice(2));
299
+ const installed = options.installed !== void 0 && options.installed !== null ? options.installed : _installed_version();
300
+ const latest = await fetcher() || "";
301
+ if (args.check) {
302
+ if (!latest) {
303
+ _print(
304
+ err,
305
+ "agent-config upgrade: latest version unavailable (registry unreachable)."
306
+ );
307
+ return 0;
308
+ }
309
+ if (installed && !installed_lock_is_newer(latest, installed)) {
310
+ _print(out, `\u2705 agent-config is up to date (${installed}).`);
311
+ } else {
312
+ _print(
313
+ out,
314
+ `\u2139\uFE0F agent-config ${latest} available (installed: ${installed || "unknown"}). Run \`agent-config upgrade\`.`
315
+ );
316
+ }
317
+ return 0;
318
+ }
319
+ const target = `${PACKAGE_NAME}@latest`;
320
+ const npm_cmd = ["npm", "install", "-g", target];
321
+ const global_cmd = [_agent_config_bin(), "global", "--no-ui"];
322
+ const steps = [npm_cmd, global_cmd];
323
+ const project_root = options.project_root ?? process.cwd();
324
+ const sync_targets = _settings_sync_targets(project_root);
325
+ const plugin_steps = _claude_plugin_refresh_steps();
326
+ if (args.dry_run) {
327
+ _print(out, "agent-config upgrade \u2014 dry run, would execute:");
328
+ for (const cmd of steps) {
329
+ _print(out, " " + cmd.join(" "));
330
+ }
331
+ for (const cmd of plugin_steps) {
332
+ _print(out, " " + cmd.join(" "));
333
+ }
334
+ for (const target2 of sync_targets) {
335
+ _print(out, " " + [_agent_config_bin(), "settings:sync", "--path", target2].join(" "));
336
+ }
337
+ return 0;
338
+ }
339
+ _print(out, "\u2192 " + npm_cmd.join(" "));
340
+ const npm_rc = runner(npm_cmd);
341
+ if (npm_rc !== 0) {
342
+ _print(
343
+ err,
344
+ `\u274C agent-config upgrade: step failed (exit ${npm_rc}): ${npm_cmd.join(" ")}`
345
+ );
346
+ return 1;
347
+ }
348
+ const failed_essential = [];
349
+ for (const cmd of steps.slice(1)) {
350
+ _print(out, "\u2192 " + cmd.join(" "));
351
+ const rc = runner(cmd);
352
+ if (rc !== 0) {
353
+ failed_essential.push(cmd.join(" "));
354
+ _print(
355
+ err,
356
+ `\u274C agent-config upgrade: step failed (exit ${rc}): ${cmd.join(" ")} \u2014 continuing with the remaining steps.`
357
+ );
358
+ }
359
+ }
360
+ _refresh_claude_plugin(plugin_steps, runner, out, err);
361
+ {
362
+ const converge_mod = await import("./cmd_converge.js");
363
+ const consent = converge_mod.read_consent(write_target("agent-settings.yml"));
364
+ const tty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
365
+ if (args.converge || consent || tty) {
366
+ const rc = converge_mod.main(args.converge ? ["--yes"] : [], { out, err });
367
+ if (rc !== 0 && (args.converge || consent)) {
368
+ failed_essential.push("agent-config converge");
369
+ }
370
+ } else if (plugin_steps.length > 0) {
371
+ _print(
372
+ out,
373
+ `\u2139\uFE0F Claude Code marketplace plugin detected \u2014 deprecated surface. Hooks now live in ~/.claude/settings.json (wired by the global step above), so the plugin only duplicates skills/commands. Remove it with:
374
+ claude plugin uninstall ${CLAUDE_PLUGIN_ID}@${CLAUDE_MARKETPLACE_NAME}
375
+ (or: agent-config converge)`
376
+ );
377
+ }
378
+ }
379
+ _sync_settings_files(sync_targets, runner, out, err);
380
+ _maybe_refresh_project_wrapper(project_root, out, err);
381
+ _maybe_refresh_git_hook(project_root, runner, out, err);
382
+ const doctor_cmd = [_agent_config_bin(), "doctor"];
383
+ _print(out, "\u2192 " + doctor_cmd.join(" "));
384
+ const doctor_rc = runner(doctor_cmd);
385
+ if (doctor_rc !== 0) {
386
+ _print(
387
+ err,
388
+ `\u26A0\uFE0F agent-config doctor reported findings (exit ${doctor_rc}) \u2014 see the check output above for per-item fixes.`
389
+ );
390
+ }
391
+ if (failed_essential.length > 0) {
392
+ _print(
393
+ err,
394
+ `\u274C agent-config upgrade finished with ${failed_essential.length} failed step(s):
395
+ ` + failed_essential.map((c) => ` \xB7 ${c}`).join("\n") + "\n Re-run `agent-config upgrade`, or run the failed step directly. `agent-config doctor` names anything left in a mixed state."
396
+ );
397
+ return 1;
398
+ }
399
+ _print(
400
+ out,
401
+ "\u2705 agent-config upgraded" + (doctor_rc === 0 ? " \u2014 doctor green." : " \u2014 review the doctor findings above.") + " Tune settings any time with `agent-config config`."
402
+ );
403
+ return 0;
404
+ }
405
+ function installed_lock_is_newer(latest, installed) {
406
+ return _is_newer(latest, installed);
407
+ }
408
+ function _isCliEntry() {
409
+ if (process.argv[1] === void 0) {
410
+ return false;
411
+ }
412
+ const argvUrl = pathToFileURL(path.resolve(process.argv[1])).href;
413
+ if (import.meta.url === argvUrl) {
414
+ return true;
415
+ }
416
+ try {
417
+ const here = fs.realpathSync(fileURLToPath(import.meta.url));
418
+ const argv = fs.realpathSync(path.resolve(process.argv[1]));
419
+ return here === argv;
420
+ } catch {
421
+ return false;
422
+ }
423
+ }
424
+ if (_isCliEntry() || process.argv[1] === _HERE) {
425
+ main(process.argv.slice(2)).then((code) => {
426
+ process.exitCode = code;
427
+ }).catch((exc) => {
428
+ if (exc instanceof ArgparseExit) {
429
+ process.exitCode = exc.code;
430
+ } else {
431
+ throw exc;
432
+ }
433
+ });
434
+ }
435
+ export {
436
+ ArgparseExit,
437
+ _agent_config_bin,
438
+ _default_runner,
439
+ _installed_version,
440
+ _maybe_refresh_project_wrapper,
441
+ _parse,
442
+ installed_lock_is_newer,
443
+ main
444
+ };