@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,117 @@
1
+ import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
2
+
3
+ // src/scripts/_lib/claude_plugin.ts
4
+ import * as fs from "node:fs";
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+ import process from "node:process";
8
+ var CLAUDE_PLUGIN_ID = "agent-config";
9
+ var CLAUDE_MARKETPLACE_NAME = "event4u-agent-config";
10
+ var CLAUDE_MARKETPLACE_REPO = "event4u-app/agent-config";
11
+ var CLAUDE_PLUGIN_INSTALL_HINT = [
12
+ `claude plugin marketplace add ${CLAUDE_MARKETPLACE_REPO}`,
13
+ `claude plugin install ${CLAUDE_PLUGIN_ID}@${CLAUDE_MARKETPLACE_NAME}`
14
+ ];
15
+ var CODEX_PLUGIN_ID = "codex";
16
+ var CODEX_MARKETPLACE_NAME = "openai-codex";
17
+ var CODEX_MARKETPLACE_REPO = "openai/codex-plugin-cc";
18
+ var CODEX_PLUGIN_INSTALL_HINT = [
19
+ `claude plugin marketplace add ${CODEX_MARKETPLACE_REPO}`,
20
+ `claude plugin install ${CODEX_PLUGIN_ID}@${CODEX_MARKETPLACE_NAME}`
21
+ ];
22
+ function claude_config_dir() {
23
+ const env = (process.env["CLAUDE_CONFIG_DIR"] ?? "").trim();
24
+ return env !== "" ? env : path.join(os.homedir(), ".claude");
25
+ }
26
+ function _plugin_id_recorded(plugin_id) {
27
+ const p = path.join(claude_config_dir(), "plugins", "installed_plugins.json");
28
+ let data;
29
+ try {
30
+ data = JSON.parse(fs.readFileSync(p, "utf-8"));
31
+ } catch {
32
+ return false;
33
+ }
34
+ if (data === null || typeof data !== "object") return false;
35
+ const plugins = data.plugins;
36
+ if (plugins === null || plugins === void 0 || typeof plugins !== "object") return false;
37
+ return Object.keys(plugins).some(
38
+ (k) => k.startsWith(`${plugin_id}@`)
39
+ );
40
+ }
41
+ function claude_plugin_installed() {
42
+ return _plugin_id_recorded(CLAUDE_PLUGIN_ID);
43
+ }
44
+ function _plugin_marketplaces(plugin_id) {
45
+ const p = path.join(claude_config_dir(), "plugins", "installed_plugins.json");
46
+ let data;
47
+ try {
48
+ data = JSON.parse(fs.readFileSync(p, "utf-8"));
49
+ } catch {
50
+ return [];
51
+ }
52
+ if (data === null || typeof data !== "object") return [];
53
+ const plugins = data.plugins;
54
+ if (plugins === null || plugins === void 0 || typeof plugins !== "object") return [];
55
+ const prefix = `${plugin_id}@`;
56
+ return Object.keys(plugins).filter((k) => k.startsWith(prefix)).map((k) => k.slice(prefix.length));
57
+ }
58
+ function _marketplace_source_repo(marketplace) {
59
+ const p = path.join(claude_config_dir(), "plugins", "known_marketplaces.json");
60
+ let data;
61
+ try {
62
+ data = JSON.parse(fs.readFileSync(p, "utf-8"));
63
+ } catch {
64
+ return null;
65
+ }
66
+ if (data === null || typeof data !== "object") return null;
67
+ const entry = data[marketplace];
68
+ if (entry === null || entry === void 0 || typeof entry !== "object") return null;
69
+ const source = entry.source;
70
+ if (source === null || source === void 0 || typeof source !== "object") return null;
71
+ const repo = source.repo;
72
+ return typeof repo === "string" && repo.trim() !== "" ? repo.trim() : null;
73
+ }
74
+ function codex_plugin_identity() {
75
+ const marketplaces = _plugin_marketplaces(CODEX_PLUGIN_ID);
76
+ if (marketplaces.length === 0) {
77
+ return { installed: false, identity_verified: false };
78
+ }
79
+ const want = CODEX_MARKETPLACE_REPO.toLowerCase();
80
+ const identity_verified = marketplaces.some(
81
+ (m) => (_marketplace_source_repo(m) ?? "").toLowerCase() === want
82
+ );
83
+ return { installed: true, identity_verified };
84
+ }
85
+ function claude_plugin_snapshot_version() {
86
+ const p = path.join(
87
+ claude_config_dir(),
88
+ "plugins",
89
+ "marketplaces",
90
+ CLAUDE_MARKETPLACE_NAME,
91
+ ".claude-plugin",
92
+ "marketplace.json"
93
+ );
94
+ let data;
95
+ try {
96
+ data = JSON.parse(fs.readFileSync(p, "utf-8"));
97
+ } catch {
98
+ return null;
99
+ }
100
+ if (data === null || typeof data !== "object") return null;
101
+ const metadata = data.metadata;
102
+ if (metadata === null || metadata === void 0 || typeof metadata !== "object") return null;
103
+ const v = metadata.version;
104
+ return typeof v === "string" && v.trim() !== "" ? v.trim() : null;
105
+ }
106
+
107
+ export {
108
+ CLAUDE_PLUGIN_ID,
109
+ CLAUDE_MARKETPLACE_NAME,
110
+ CODEX_PLUGIN_ID,
111
+ CODEX_MARKETPLACE_NAME,
112
+ CODEX_PLUGIN_INSTALL_HINT,
113
+ claude_config_dir,
114
+ claude_plugin_installed,
115
+ codex_plugin_identity,
116
+ claude_plugin_snapshot_version
117
+ };
@@ -0,0 +1,82 @@
1
+ import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
2
+
3
+ // src/scripts/_cli/explain_last/state_loader.ts
4
+ import * as fs from "node:fs";
5
+ var EXPECTED_VERSION = 1;
6
+ var StateLoadError = class extends Error {
7
+ exitCode;
8
+ constructor(message, options = {}) {
9
+ super(message);
10
+ this.name = "StateLoadError";
11
+ this.exitCode = options.exitCode ?? 2;
12
+ }
13
+ };
14
+ function _pyRepr(value) {
15
+ if (value === null || value === void 0) {
16
+ return "None";
17
+ }
18
+ if (typeof value === "boolean") {
19
+ return value ? "True" : "False";
20
+ }
21
+ if (typeof value === "string") {
22
+ if (value.includes("'") && !value.includes('"')) {
23
+ return `"${value}"`;
24
+ }
25
+ return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
26
+ }
27
+ return String(value);
28
+ }
29
+ function load_state(state_file) {
30
+ if (!fs.existsSync(state_file)) {
31
+ throw new StateLoadError(`state file not found: ${state_file}`, {
32
+ exitCode: 1
33
+ });
34
+ }
35
+ let text;
36
+ try {
37
+ text = fs.readFileSync(state_file, "utf-8");
38
+ } catch (exc) {
39
+ throw new StateLoadError(
40
+ `cannot read state file ${state_file}: ${_osErr(exc)}`
41
+ );
42
+ }
43
+ let payload;
44
+ try {
45
+ payload = JSON.parse(text);
46
+ } catch (exc) {
47
+ throw new StateLoadError(
48
+ `state file ${state_file} is not valid JSON: ${_jsonErr(exc, text)}`
49
+ );
50
+ }
51
+ if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
52
+ throw new StateLoadError(
53
+ `state file ${state_file} must contain a JSON object`
54
+ );
55
+ }
56
+ const version = payload.version;
57
+ if (version !== EXPECTED_VERSION) {
58
+ throw new StateLoadError(
59
+ `trace format upgraded; rerun the upstream command on this branch to regenerate (found version=${_pyRepr(version === void 0 ? null : version)}, expected ${EXPECTED_VERSION})`,
60
+ { exitCode: 0 }
61
+ // informational, not a failure (council fix).
62
+ );
63
+ }
64
+ return payload;
65
+ }
66
+ function _osErr(exc) {
67
+ if (exc instanceof Error) {
68
+ return exc.message;
69
+ }
70
+ return String(exc);
71
+ }
72
+ function _jsonErr(exc, _text) {
73
+ if (exc instanceof Error) {
74
+ return exc.message;
75
+ }
76
+ return String(exc);
77
+ }
78
+
79
+ export {
80
+ StateLoadError,
81
+ load_state
82
+ };
@@ -0,0 +1,336 @@
1
+ import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
2
+ import {
3
+ resolve_with_fallback,
4
+ write_target
5
+ } from "./chunk-NDJLNC6Q.js";
6
+
7
+ // src/scripts/_lib/installed_lock.ts
8
+ import { randomBytes } from "node:crypto";
9
+ import * as fs from "node:fs";
10
+ import * as os from "node:os";
11
+ import * as path from "node:path";
12
+ import { fileURLToPath } from "node:url";
13
+
14
+ // src/scripts/_lib/install_layout.ts
15
+ var PRE_FREEZE_LAYOUT_VERSION = 0;
16
+ var INSTALL_LAYOUT_VERSION = 1;
17
+ function _pyInt(value) {
18
+ if (typeof value === "boolean") {
19
+ return value ? 1 : 0;
20
+ }
21
+ if (typeof value === "number") {
22
+ if (!Number.isFinite(value)) {
23
+ return null;
24
+ }
25
+ return Math.trunc(value);
26
+ }
27
+ if (typeof value === "string") {
28
+ const trimmed = value.trim();
29
+ if (!/^[+-]?\d+(?:_\d+)*$/.test(trimmed)) {
30
+ return null;
31
+ }
32
+ return Number.parseInt(trimmed.replace(/_/g, ""), 10);
33
+ }
34
+ return null;
35
+ }
36
+ function coerce_layout_version(value) {
37
+ if (value === null || value === void 0) {
38
+ return PRE_FREEZE_LAYOUT_VERSION;
39
+ }
40
+ const parsed = _pyInt(value);
41
+ if (parsed === null) {
42
+ return PRE_FREEZE_LAYOUT_VERSION;
43
+ }
44
+ return parsed;
45
+ }
46
+ function needs_migration(recorded) {
47
+ return coerce_layout_version(recorded) < INSTALL_LAYOUT_VERSION;
48
+ }
49
+
50
+ // src/scripts/_lib/installed_lock.ts
51
+ var LOCKFILE_ENV = "AGENT_CONFIG_INSTALLED_LOCK";
52
+ var SCHEMA_VERSION = 1;
53
+ function _default_lockfile() {
54
+ return write_target("installed.lock");
55
+ }
56
+ var DEFAULT_LOCKFILE = _default_lockfile();
57
+ var _VERSION_RE = /^\s*agent_config_version\s*:\s*"?([^"\s]+)"?\s*$/;
58
+ var _SCHEMA_RE = /^\s*schema_version\s*:\s*(\d+)\s*$/;
59
+ var _LAYOUT_RE = /^\s*install_layout_version\s*:\s*(\d+)\s*$/;
60
+ var _INSTALLED_AT_RE = /^\s*installed_at\s*:\s*"?([^"\s]+)"?\s*$/;
61
+ var _TOOL_RE = /^\s*-\s*([A-Za-z0-9_\-.]+)\s*$/;
62
+ function expanduser(p) {
63
+ if (p === "~") {
64
+ return os.homedir();
65
+ }
66
+ if (p.startsWith("~/") || process.platform === "win32" && p.startsWith("~\\")) {
67
+ return path.join(os.homedir(), p.slice(2));
68
+ }
69
+ return p;
70
+ }
71
+ function lockfile_path(env) {
72
+ const env_map = env ?? process.env;
73
+ const override = env_map[LOCKFILE_ENV];
74
+ if (override) {
75
+ return expanduser(override);
76
+ }
77
+ const resolved = resolve_with_fallback("installed.lock", { env: env ?? null });
78
+ if (resolved !== null) {
79
+ return resolved;
80
+ }
81
+ return write_target("installed.lock", { env: env ?? null });
82
+ }
83
+ function lockfile_write_path(env) {
84
+ const env_map = env ?? process.env;
85
+ const override = env_map[LOCKFILE_ENV];
86
+ if (override) {
87
+ return expanduser(override);
88
+ }
89
+ return write_target("installed.lock", { env: env ?? null });
90
+ }
91
+ function read_lockfile(path2) {
92
+ const target = path2 ?? lockfile_path();
93
+ let text;
94
+ try {
95
+ text = fs.readFileSync(target, { encoding: "utf-8" });
96
+ } catch {
97
+ return null;
98
+ }
99
+ const data = { tools: [] };
100
+ let in_tools = false;
101
+ for (const raw_line of splitlines(text)) {
102
+ const schema_m = _SCHEMA_RE.exec(raw_line);
103
+ if (schema_m) {
104
+ data.schema_version = Number.parseInt(schema_m[1], 10);
105
+ in_tools = false;
106
+ continue;
107
+ }
108
+ const layout_m = _LAYOUT_RE.exec(raw_line);
109
+ if (layout_m) {
110
+ data.install_layout_version = Number.parseInt(layout_m[1], 10);
111
+ in_tools = false;
112
+ continue;
113
+ }
114
+ const version_m = _VERSION_RE.exec(raw_line);
115
+ if (version_m) {
116
+ data.agent_config_version = version_m[1];
117
+ in_tools = false;
118
+ continue;
119
+ }
120
+ const installed_m = _INSTALLED_AT_RE.exec(raw_line);
121
+ if (installed_m) {
122
+ data.installed_at = installed_m[1];
123
+ in_tools = false;
124
+ continue;
125
+ }
126
+ if (raw_line.trim().startsWith("tools:")) {
127
+ in_tools = true;
128
+ continue;
129
+ }
130
+ if (in_tools) {
131
+ const m = _TOOL_RE.exec(raw_line);
132
+ if (m) {
133
+ data.tools.push(m[1]);
134
+ } else if (raw_line.trim() && !(raw_line.startsWith(" ") || raw_line.startsWith(" ") || raw_line.startsWith("-"))) {
135
+ in_tools = false;
136
+ }
137
+ }
138
+ }
139
+ return data;
140
+ }
141
+ function splitlines(text) {
142
+ const parts = text.split("\n");
143
+ if (parts.length > 0 && parts[parts.length - 1] === "") {
144
+ parts.pop();
145
+ }
146
+ return parts;
147
+ }
148
+ function _render(version, tools, installed_at) {
149
+ const lines = [
150
+ `schema_version: ${SCHEMA_VERSION}`,
151
+ `install_layout_version: ${INSTALL_LAYOUT_VERSION}`,
152
+ `agent_config_version: "${version}"`,
153
+ `installed_at: "${installed_at}"`,
154
+ "tools:"
155
+ ];
156
+ for (const tool of tools) {
157
+ lines.push(` - ${tool}`);
158
+ }
159
+ return lines.join("\n") + "\n";
160
+ }
161
+ function write_lockfile(version, tools, options = {}) {
162
+ const target = options.path ?? lockfile_path();
163
+ fs.mkdirSync(path.dirname(target), { recursive: true });
164
+ const stamp = strftime_iso_z(options.now ?? /* @__PURE__ */ new Date());
165
+ const rendered = _render(version, sorted_unique(tools), stamp);
166
+ const parent = path.dirname(target);
167
+ const { fd, tmp_name } = mkstemp(parent, ".installed.lock.");
168
+ try {
169
+ fs.writeFileSync(fd, rendered, { encoding: "utf-8" });
170
+ fs.closeSync(fd);
171
+ fs.renameSync(tmp_name, target);
172
+ } catch (err) {
173
+ try {
174
+ fs.closeSync(fd);
175
+ } catch {
176
+ }
177
+ try {
178
+ fs.unlinkSync(tmp_name);
179
+ } catch {
180
+ }
181
+ throw err;
182
+ }
183
+ return target;
184
+ }
185
+ function _parse_installed_at(stamp) {
186
+ if (!stamp) {
187
+ return null;
188
+ }
189
+ const m = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})Z$/.exec(stamp);
190
+ if (!m) {
191
+ return null;
192
+ }
193
+ const [, y, mo, d, h, mi, s] = m;
194
+ const ms = Date.UTC(
195
+ Number.parseInt(y, 10),
196
+ Number.parseInt(mo, 10) - 1,
197
+ Number.parseInt(d, 10),
198
+ Number.parseInt(h, 10),
199
+ Number.parseInt(mi, 10),
200
+ Number.parseInt(s, 10)
201
+ );
202
+ const parsed = new Date(ms);
203
+ if (parsed.getUTCFullYear() !== Number.parseInt(y, 10) || parsed.getUTCMonth() !== Number.parseInt(mo, 10) - 1 || parsed.getUTCDate() !== Number.parseInt(d, 10) || parsed.getUTCHours() !== Number.parseInt(h, 10) || parsed.getUTCMinutes() !== Number.parseInt(mi, 10) || parsed.getUTCSeconds() !== Number.parseInt(s, 10)) {
204
+ return null;
205
+ }
206
+ return parsed;
207
+ }
208
+ function migrate_layout(options = {}) {
209
+ const target = options.path ?? lockfile_write_path();
210
+ const existing = read_lockfile(target);
211
+ if (existing === null) {
212
+ return null;
213
+ }
214
+ const from_v = coerce_layout_version(existing.install_layout_version);
215
+ if (!needs_migration(existing.install_layout_version)) {
216
+ return { from: from_v, to: from_v, changed: [] };
217
+ }
218
+ const version = existing.agent_config_version || current_package_version();
219
+ const tools = [...existing.tools ?? []];
220
+ const when = options.now ?? _parse_installed_at(existing.installed_at);
221
+ write_lockfile(version, tools, { path: target, now: when });
222
+ return {
223
+ from: from_v,
224
+ to: INSTALL_LAYOUT_VERSION,
225
+ changed: [`install_layout_version ${from_v} \u2192 ${INSTALL_LAYOUT_VERSION}`]
226
+ };
227
+ }
228
+ function sorted_unique(tools) {
229
+ return [...new Set(tools)].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
230
+ }
231
+ function strftime_iso_z(now) {
232
+ return now.toISOString().replace(/\.\d{3}Z$/, "Z");
233
+ }
234
+ function mkstemp(dir, prefix) {
235
+ for (let attempt = 0; attempt < 32; attempt += 1) {
236
+ const tmp_name = path.join(dir, `${prefix}${randomBytes(6).toString("hex")}`);
237
+ try {
238
+ const fd = fs.openSync(tmp_name, "wx", 384);
239
+ return { fd, tmp_name };
240
+ } catch (err) {
241
+ if (err.code === "EEXIST") {
242
+ continue;
243
+ }
244
+ throw err;
245
+ }
246
+ }
247
+ throw new Error("mkstemp: could not create a unique temp file");
248
+ }
249
+ function check_version(installed_version, options = {}) {
250
+ const existing = read_lockfile(options.path ?? null);
251
+ if (existing === null) {
252
+ return [true, null];
253
+ }
254
+ const recorded = existing.agent_config_version;
255
+ if (!recorded) {
256
+ return [true, null];
257
+ }
258
+ return [recorded === installed_version, recorded];
259
+ }
260
+ var _SEMVER_RE = /^\s*v?(\d+)\.(\d+)\.(\d+)/;
261
+ function _parse_semver(version) {
262
+ const match = _SEMVER_RE.exec(version);
263
+ if (!match) {
264
+ return null;
265
+ }
266
+ return [Number.parseInt(match[1], 10), Number.parseInt(match[2], 10), Number.parseInt(match[3], 10)];
267
+ }
268
+ function classify_mismatch(installed_version, recorded) {
269
+ if (recorded === null) {
270
+ return "none";
271
+ }
272
+ if (recorded === installed_version) {
273
+ return "match";
274
+ }
275
+ const rec = _parse_semver(recorded);
276
+ const inst = _parse_semver(installed_version);
277
+ if (rec === null || inst === null) {
278
+ return "unparseable";
279
+ }
280
+ if (tuple_lt(rec, inst)) {
281
+ return "upgrade";
282
+ }
283
+ return "downgrade";
284
+ }
285
+ function tuple_lt(a, b) {
286
+ for (let i = 0; i < a.length; i += 1) {
287
+ const av = a[i];
288
+ const bv = b[i];
289
+ if (av < bv) return true;
290
+ if (av > bv) return false;
291
+ }
292
+ return false;
293
+ }
294
+ function _read_package_version(dir) {
295
+ try {
296
+ const data = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), { encoding: "utf-8" }));
297
+ const version = data.version;
298
+ if (typeof version === "string" && version.trim()) {
299
+ return version.trim();
300
+ }
301
+ } catch {
302
+ }
303
+ return null;
304
+ }
305
+ function _find_package_version_upward(start_dir) {
306
+ let dir = start_dir;
307
+ for (; ; ) {
308
+ const found = _read_package_version(dir);
309
+ if (found !== null) {
310
+ return found;
311
+ }
312
+ const parent = path.dirname(dir);
313
+ if (parent === dir) {
314
+ return null;
315
+ }
316
+ dir = parent;
317
+ }
318
+ }
319
+ function current_package_version(repo_root) {
320
+ if (repo_root != null) {
321
+ return _read_package_version(repo_root) ?? "0.0.0";
322
+ }
323
+ const here = path.dirname(fileURLToPath(import.meta.url));
324
+ return _find_package_version_upward(here) ?? "0.0.0";
325
+ }
326
+
327
+ export {
328
+ lockfile_path,
329
+ lockfile_write_path,
330
+ read_lockfile,
331
+ write_lockfile,
332
+ migrate_layout,
333
+ check_version,
334
+ classify_mismatch,
335
+ current_package_version
336
+ };