@event4u/agent-config 15.0.0 → 16.1.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 (283) hide show
  1. package/.augment-plugin/marketplace.json +3 -3
  2. package/.augment-plugin/plugin.json +1 -1
  3. package/.claude-plugin/marketplace.json +1 -1
  4. package/CHANGELOG.md +301 -347
  5. package/CONTRIBUTING.md +9 -0
  6. package/README.md +2 -2
  7. package/dist/agent-src/commands/analyze/inbox.md +26 -0
  8. package/dist/agent-src/commands/analyze/roadmap-repos.md +27 -0
  9. package/dist/agent-src/commands/challenge-me/closure.md +178 -0
  10. package/dist/agent-src/commands/challenge-me.md +9 -2
  11. package/dist/agent-src/commands/council/default.md +25 -5
  12. package/dist/agent-src/commands/feature/plan.md +28 -1
  13. package/dist/agent-src/commands/feature/roadmap.md +28 -1
  14. package/dist/agent-src/commands/implement-ticket.md +27 -0
  15. package/dist/agent-src/commands/jira-ticket.md +27 -0
  16. package/dist/agent-src/commands/pr/create.md +29 -0
  17. package/dist/agent-src/commands/pr/merge.md +60 -9
  18. package/dist/agent-src/commands/roadmap/ai-council.md +7 -1
  19. package/dist/agent-src/commands/roadmap/create.md +77 -29
  20. package/dist/agent-src/commands/roadmap/materialize.md +27 -0
  21. package/dist/agent-src/commands/roadmap/process-full.md +123 -18
  22. package/dist/agent-src/commands/team.md +22 -0
  23. package/dist/agent-src/contexts/authority/scope-growth-ownership.md +80 -0
  24. package/dist/agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +97 -0
  25. package/dist/agent-src/contexts/execution/auto-orchestration-activation.md +44 -3
  26. package/dist/agent-src/contexts/execution/autonomy-mechanics.md +15 -15
  27. package/dist/agent-src/contexts/execution/decision-closure-execution.md +93 -0
  28. package/dist/agent-src/contexts/execution/fix-loop-ladder.md +108 -0
  29. package/dist/agent-src/contexts/execution/plan-confidence-gate.md +4 -2
  30. package/dist/agent-src/contexts/execution/roadmap-process-loop.md +75 -6
  31. package/dist/agent-src/guidelines/agent-infra/active-remediation-mechanics.md +57 -0
  32. package/dist/agent-src/guidelines/agent-infra/evaluator-independence-mechanics.md +102 -0
  33. package/dist/agent-src/guidelines/design-fidelity-routing.md +29 -0
  34. package/dist/agent-src/rules/autonomous-execution.md +15 -8
  35. package/dist/agent-src/rules/delegation-policy.md +23 -45
  36. package/dist/agent-src/rules/design-fidelity.md +32 -37
  37. package/dist/agent-src/rules/evaluator-independence.md +43 -49
  38. package/dist/agent-src/rules/test-first.md +41 -0
  39. package/dist/agent-src/rules/user-interaction.md +31 -30
  40. package/dist/agent-src/skills/accessibility-auditor/data/manifest.json +3 -3
  41. package/dist/agent-src/skills/ai-council/SKILL.md +11 -3
  42. package/dist/agent-src/skills/api-design/data/manifest.json +3 -3
  43. package/dist/agent-src/skills/database/data/manifest.json +4 -4
  44. package/dist/agent-src/skills/database/data/query-tuning.csv +3 -3
  45. package/dist/agent-src/skills/design-review/SKILL.md +50 -0
  46. package/dist/agent-src/skills/error-handling-patterns/SKILL.md +9 -0
  47. package/dist/agent-src/skills/existing-ui-audit/SKILL.md +14 -4
  48. package/dist/agent-src/skills/experiment-loop/SKILL.md +31 -1
  49. package/dist/agent-src/skills/roadmap-writing/SKILL.md +1 -1
  50. package/dist/agent-src/skills/storybook-workshop/SKILL.md +42 -3
  51. package/dist/agent-src/skills/threat-modeling/SKILL.md +9 -4
  52. package/dist/agent-src/skills/threat-modeling/data/manifest.json +4 -4
  53. package/dist/agent-src/skills/verify-repair-loop/SKILL.md +37 -3
  54. package/dist/agent-src/templates/agent-settings.md +1 -1
  55. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  56. package/dist/agent-src/templates/roadmaps.md +188 -0
  57. package/dist/agent-src/templates/scripts/work_engine/directives/backend/_self_fix.ts +62 -2
  58. package/dist/agent-src/templates/scripts/work_engine/directives/backend/test.ts +1 -0
  59. package/dist/agent-src/templates/scripts/work_engine/directives/backend/verify.ts +1 -0
  60. package/dist/cli-delegate/check_update_banner.js +40 -2
  61. package/dist/cli-delegate/chunk-4E2W63DA.js +335 -0
  62. package/dist/cli-delegate/chunk-5R7HOLAF.js +99 -0
  63. package/dist/cli-delegate/{chunk-IVBPRCQO.js → chunk-6KFEC3G7.js} +1 -1
  64. package/dist/cli-delegate/{chunk-2TAQ2K4V.js → chunk-6KM6ORRY.js} +55 -386
  65. package/dist/cli-delegate/{chunk-2XY7ILBT.js → chunk-FC75PGJE.js} +42 -2
  66. package/dist/cli-delegate/{chunk-GYC3VRYN.js → chunk-FXYUYU4N.js} +57 -13
  67. package/dist/cli-delegate/{chunk-55ACLDUE.js → chunk-GJCBB2UG.js} +168 -10
  68. package/dist/cli-delegate/{chunk-AK6HODNQ.js → chunk-HDVVGPQW.js} +873 -539
  69. package/dist/cli-delegate/chunk-NUHLI2RX.js +80 -0
  70. package/dist/cli-delegate/{chunk-HZ52BRGG.js → chunk-P6ZHP5W2.js} +15 -90
  71. package/dist/cli-delegate/{chunk-TYSY33MD.js → chunk-QJWAUMJW.js} +12 -2
  72. package/dist/cli-delegate/{chunk-57PN4GYJ.js → chunk-RGNIWTEA.js} +1 -1
  73. package/dist/cli-delegate/chunk-ROYYTEZU.js +39 -0
  74. package/dist/cli-delegate/{chunk-2KKXJW25.js → chunk-S3VFXMTM.js} +1 -1
  75. package/dist/cli-delegate/{chunk-3FKR64R5.js → chunk-UNCRJBT3.js} +31 -7
  76. package/dist/cli-delegate/{chunk-2DK2VJWG.js → chunk-WGXTVKCQ.js} +20 -6
  77. package/dist/cli-delegate/chunk-YDPILCOL.js +152 -0
  78. package/dist/cli-delegate/cmd_analyze_session.js +1 -1
  79. package/dist/cli-delegate/cmd_brand_status.js +1 -1
  80. package/dist/cli-delegate/cmd_conformance.js +918 -325
  81. package/dist/cli-delegate/cmd_doctor.js +7 -5
  82. package/dist/cli-delegate/cmd_explain.js +5 -3
  83. package/dist/cli-delegate/cmd_export.js +9 -7
  84. package/dist/cli-delegate/cmd_fleet.js +4 -2
  85. package/dist/cli-delegate/cmd_handoff.js +6 -6
  86. package/dist/cli-delegate/cmd_mcp_available.js +1 -1
  87. package/dist/cli-delegate/cmd_migrate.js +2 -2
  88. package/dist/cli-delegate/cmd_packs_active.js +3 -2
  89. package/dist/cli-delegate/cmd_preflight.js +4 -2
  90. package/dist/cli-delegate/cmd_prune.js +10 -8
  91. package/dist/cli-delegate/cmd_route_audit.js +2 -2
  92. package/dist/cli-delegate/cmd_route_explain.js +1 -1
  93. package/dist/cli-delegate/cmd_session_recycle.js +4 -4
  94. package/dist/cli-delegate/cmd_settings_get.js +28 -2
  95. package/dist/cli-delegate/cmd_settings_migrate.js +9 -7
  96. package/dist/cli-delegate/cmd_settings_set.js +14 -1
  97. package/dist/cli-delegate/cmd_sync.js +10 -8
  98. package/dist/cli-delegate/cmd_uninstall.js +16 -13
  99. package/dist/cli-delegate/cmd_update.js +1 -1
  100. package/dist/cli-delegate/cmd_upgrade.js +1 -1
  101. package/dist/cli-delegate/cmd_validate.js +12 -10
  102. package/dist/cli-delegate/cmd_versions.js +1 -1
  103. package/dist/discovery/deprecation-report.md +1 -1
  104. package/dist/discovery/discovery-manifest.json +87 -40
  105. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  106. package/dist/discovery/discovery-manifest.summary.md +4 -4
  107. package/dist/discovery/dormancy-report.md +1 -1
  108. package/dist/discovery/orphan-report.md +1 -1
  109. package/dist/discovery/packs.json +10 -8
  110. package/dist/discovery/trust-report.md +3 -3
  111. package/dist/discovery/workspaces.json +8 -6
  112. package/dist/hooks/dispatch.js +2601 -1073
  113. package/dist/install/claudeRuleRewrite.js +14 -3
  114. package/dist/install/conflict.js +60 -10
  115. package/dist/install/conflictTracker.js +218 -0
  116. package/dist/install/fsPrimitives.js +54 -0
  117. package/dist/install/install.mjs +2008 -1481
  118. package/dist/install/manifestFiles.js +259 -0
  119. package/dist/install/preflight.js +14 -2
  120. package/dist/install/preserve.js +157 -0
  121. package/dist/install/recordedOwnership.js +132 -0
  122. package/dist/install/txlog.js +11 -2
  123. package/dist/mcp/registry-manifest.json +3 -3
  124. package/dist/mcp/server.json +2 -2
  125. package/dist/mcp/server.mjs +1612 -667
  126. package/dist/router.json +1 -1
  127. package/dist/scripts/_lib/agent_settings.js +3 -2
  128. package/dist/scripts/_lib/fs_atomic.js +167 -0
  129. package/dist/scripts/_lib/installed_lock.js +1 -1
  130. package/dist/scripts/_lib/installed_tools.js +460 -0
  131. package/dist/scripts/_lib/lean_projection_mode.js +3 -2
  132. package/dist/scripts/_lib/settings_renamed_keys.js +78 -0
  133. package/dist/server/io/yamlIO.js +50 -0
  134. package/dist/server/routes/install.js +8 -0
  135. package/dist/server/routes/wizard.js +9 -3
  136. package/dist/server/schemas/settings.js +17 -5
  137. package/dist/shared/missionExecution.js +97 -0
  138. package/dist/ui/assets/{index-D0jaCRPM.js → index-DH1xc62v.js} +17 -17
  139. package/dist/ui/index.html +1 -1
  140. package/docs/MIGRATION.md +103 -0
  141. package/docs/contracts/settings-classes.md +26 -7
  142. package/docs/guidelines/agent-infra/active-remediation-mechanics.md +57 -0
  143. package/docs/guidelines/agent-infra/evaluator-independence-mechanics.md +102 -0
  144. package/docs/guidelines/design-fidelity-routing.md +29 -0
  145. package/package.json +1 -1
  146. package/src/agent-src/templates/scripts/work_engine/directives/backend/_self_fix.ts +62 -2
  147. package/src/agent-src/templates/scripts/work_engine/directives/backend/test.ts +1 -0
  148. package/src/agent-src/templates/scripts/work_engine/directives/backend/verify.ts +1 -0
  149. package/src/config/agent-settings.template.yml +139 -27
  150. package/src/config/auto-rule-budget.json +16 -0
  151. package/src/config/ci-local-parity.yml +18 -5
  152. package/src/config/continuity-surface.json +28 -0
  153. package/src/config/gate-coverage.yml +146 -13
  154. package/src/config/gate-violation-baselines.json +6 -6
  155. package/src/config/hook-token-budget.json +2 -0
  156. package/src/config/host-injection-effect.json +1 -1
  157. package/src/config/loop-surfaces.yaml +215 -0
  158. package/src/config/platform-anchor.json +3 -2
  159. package/src/config/preamble-payload-budget.json +12 -7
  160. package/src/config/preamble-payload-exceptions.json +28 -0
  161. package/src/config/release-gate-locality.yml +11 -0
  162. package/src/config/routing-coverage-seed.json +18 -4
  163. package/src/config/rule-enforcement-baseline.json +0 -1
  164. package/src/install/claudeRuleRewrite.ts +16 -2
  165. package/src/install/conflict.ts +65 -9
  166. package/src/install/conflictTracker.ts +299 -0
  167. package/src/install/fsPrimitives.ts +54 -0
  168. package/src/install/manifestFiles.ts +312 -0
  169. package/src/install/preflight.ts +16 -2
  170. package/src/install/preserve.ts +205 -0
  171. package/src/install/recordedOwnership.ts +149 -0
  172. package/src/install/txlog.ts +11 -2
  173. package/src/install/types.ts +19 -4
  174. package/src/scripts/_cli/cmd_conformance.ts +88 -15
  175. package/src/scripts/_cli/cmd_doctor.ts +4 -3
  176. package/src/scripts/_cli/cmd_route_explain.ts +9 -2
  177. package/src/scripts/_cli/cmd_settings_get.ts +44 -0
  178. package/src/scripts/_cli/doctor_execution.ts +90 -0
  179. package/src/scripts/_dispatch.bash +3 -1
  180. package/src/scripts/_lib/activation_payload.ts +247 -0
  181. package/src/scripts/_lib/agent_settings.ts +4 -2
  182. package/src/scripts/_lib/authority_path.ts +102 -0
  183. package/src/scripts/_lib/base_ref_payload.ts +315 -0
  184. package/src/scripts/_lib/cascade_base.ts +94 -0
  185. package/src/scripts/_lib/changelog_eras.ts +7 -2
  186. package/src/scripts/_lib/continuation_ladder.ts +149 -2
  187. package/src/scripts/_lib/council_transport.ts +129 -0
  188. package/src/scripts/_lib/delivery_ready.ts +112 -0
  189. package/src/scripts/_lib/dropped_decision.ts +142 -0
  190. package/src/scripts/_lib/forge_protection.ts +267 -0
  191. package/src/scripts/_lib/hook_platform_keys.ts +27 -0
  192. package/src/scripts/_lib/installed_lock.ts +1 -1
  193. package/src/scripts/_lib/json_python_parity.ts +127 -0
  194. package/src/scripts/_lib/lean_projection_mode.ts +14 -3
  195. package/src/scripts/_lib/loop_surfaces.ts +382 -0
  196. package/src/scripts/_lib/measured_payload_ceiling.ts +424 -0
  197. package/src/scripts/_lib/mission_record.ts +190 -0
  198. package/src/scripts/_lib/obligation_frequency.ts +217 -0
  199. package/src/scripts/_lib/obligations.ts +402 -0
  200. package/src/scripts/_lib/orchestration_record.ts +11 -20
  201. package/src/scripts/_lib/payload_catalogue_completeness.ts +211 -0
  202. package/src/scripts/_lib/release_findings_ingest.ts +324 -0
  203. package/src/scripts/_lib/release_highlights.ts +199 -10
  204. package/src/scripts/_lib/release_holds.ts +493 -0
  205. package/src/scripts/_lib/release_migration_gate.ts +184 -0
  206. package/src/scripts/_lib/release_tag_dispatch.ts +63 -0
  207. package/src/scripts/_lib/review_baseline.ts +254 -0
  208. package/src/scripts/_lib/review_skipped_record.ts +61 -1
  209. package/src/scripts/_lib/rides_along.ts +102 -0
  210. package/src/scripts/_lib/settings_renamed_keys.ts +82 -0
  211. package/src/scripts/_lib/standing_bound_ratchet.ts +216 -103
  212. package/src/scripts/_lib/test_delta.ts +166 -0
  213. package/src/scripts/_lib/test_provenance.ts +171 -0
  214. package/src/scripts/_lib/turn_end_refusals.ts +51 -4
  215. package/src/scripts/_lib/typed_op_grant.ts +246 -0
  216. package/src/scripts/_lib/typed_op_watch.ts +185 -0
  217. package/src/scripts/ai_council/config.ts +8 -11
  218. package/src/scripts/ai_council/fallback_config.ts +5 -3
  219. package/src/scripts/ai_council/ownership_classes.ts +118 -0
  220. package/src/scripts/ask_block_census.ts +285 -15
  221. package/src/scripts/check_beta_review_markers.ts +35 -4
  222. package/src/scripts/check_enforcement_matrix.ts +624 -0
  223. package/src/scripts/check_finding_dispositions.ts +167 -16
  224. package/src/scripts/check_gate_reachability.ts +173 -10
  225. package/src/scripts/check_generator_sync.ts +954 -0
  226. package/src/scripts/check_held_object_arrivals.ts +381 -0
  227. package/src/scripts/check_preamble_payload_budget.ts +474 -124
  228. package/src/scripts/check_release_highlights.ts +33 -1
  229. package/src/scripts/check_release_holds.ts +567 -0
  230. package/src/scripts/check_release_published.ts +1 -1
  231. package/src/scripts/check_reply_consistency.ts +86 -17
  232. package/src/scripts/check_rule_projection_integrity.ts +22 -12
  233. package/src/scripts/check_test_delta.ts +294 -0
  234. package/src/scripts/check_test_weakening.ts +299 -0
  235. package/src/scripts/closure_scan.ts +333 -0
  236. package/src/scripts/compile_hook_manifest.ts +43 -3
  237. package/src/scripts/council_record_shape.ts +209 -0
  238. package/src/scripts/hook_manifest.json +1 -1
  239. package/src/scripts/hook_manifest.yaml +127 -12
  240. package/src/scripts/hooks/block_kernel_rule_writes.ts +12 -2
  241. package/src/scripts/hooks/concern_registry.ts +6 -0
  242. package/src/scripts/hooks/design_pass_hook.ts +128 -3
  243. package/src/scripts/hooks/end_review_nudge_hook.ts +101 -21
  244. package/src/scripts/hooks/evidence_independence.ts +96 -0
  245. package/src/scripts/hooks/memory_recall_hook.ts +540 -0
  246. package/src/scripts/hooks/obligation_settle_hook.ts +182 -0
  247. package/src/scripts/hooks/review_baseline_hook.ts +130 -0
  248. package/src/scripts/hooks/rule_inject_hook.ts +49 -1
  249. package/src/scripts/hooks/run_continuation_hook.ts +17 -20
  250. package/src/scripts/hooks/turn_end_gate_hook.ts +232 -14
  251. package/src/scripts/hooks_doctor.ts +89 -1
  252. package/src/scripts/hooks_status.ts +19 -0
  253. package/src/scripts/install.ts +107 -207
  254. package/src/scripts/interruption_report.ts +8 -2
  255. package/src/scripts/janitor.ts +15 -1
  256. package/src/scripts/lint_decision_classes.ts +464 -0
  257. package/src/scripts/lint_hook_manifest.ts +11 -0
  258. package/src/scripts/lint_major_migration_sections.ts +450 -0
  259. package/src/scripts/lint_plan_risk_register.ts +47 -3
  260. package/src/scripts/lint_roadmap_blockers.ts +61 -0
  261. package/src/scripts/lint_roadmap_producers.ts +202 -0
  262. package/src/scripts/measure_rule_budget.ts +101 -5
  263. package/src/scripts/measure_turn_end_gate.ts +302 -5
  264. package/src/scripts/new_roadmap.ts +37 -0
  265. package/src/scripts/orchestration_record.ts +0 -5
  266. package/src/scripts/release.ts +66 -162
  267. package/src/scripts/release_drill.ts +460 -15
  268. package/src/scripts/release_env.ts +1 -1
  269. package/src/scripts/release_publication.ts +52 -1
  270. package/src/scripts/report_enforcement_drift.ts +566 -0
  271. package/src/scripts/report_held_object_arrivals.ts +456 -0
  272. package/src/scripts/report_host_injection_effect.ts +3 -11
  273. package/src/scripts/report_standing_payload_by_host.ts +26 -152
  274. package/src/scripts/schemas/agent-settings.schema.json +23 -0
  275. package/src/scripts/schemas/command.schema.json +4 -0
  276. package/src/scripts/scope_growth.ts +219 -0
  277. package/src/scripts/sync_agent_settings.ts +140 -18
  278. package/src/scripts/trigger_eval_grandfather.json +0 -1
  279. package/src/scripts/ui_conformance_probe.ts +622 -0
  280. package/src/server/io/yamlIO.ts +48 -0
  281. package/src/server/schemas/settings.ts +31 -7
  282. package/src/shared/missionExecution.ts +126 -0
  283. package/dist/cli-delegate/chunk-523HCFYO.js +0 -90
@@ -0,0 +1,335 @@
1
+ import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
2
+ import {
3
+ write_atomic
4
+ } from "./chunk-MWRD5YOH.js";
5
+
6
+ // src/scripts/_lib/installed_tools.ts
7
+ import * as fs from "node:fs";
8
+ import * as os from "node:os";
9
+ import * as fsPath from "node:path";
10
+ var MANIFEST_ENV = "AGENT_CONFIG_INSTALLED_TOOLS";
11
+ var DEFAULT_MANIFEST_RELATIVE = fsPath.join("agents", "installed-tools.lock");
12
+ var SCHEMA_VERSION = 2;
13
+ var SCHEMA_VERSIONS_SUPPORTED = [1, 2];
14
+ var _VALID_SCOPES = ["global", "project"];
15
+ var DEFAULT_DEPLOY_ROOTS = [
16
+ ".augment/rules",
17
+ ".augment/skills",
18
+ ".augment/commands",
19
+ ".cursor/rules",
20
+ ".claude/skills",
21
+ ".claude/commands",
22
+ ".clinerules",
23
+ ".windsurf/rules"
24
+ ];
25
+ function expanduser(p) {
26
+ if (p === "~") {
27
+ return os.homedir();
28
+ }
29
+ if (p.startsWith("~/") || process.platform === "win32" && p.startsWith("~\\")) {
30
+ return fsPath.join(os.homedir(), p.slice(2));
31
+ }
32
+ return p;
33
+ }
34
+ function manifest_path(project_root, env) {
35
+ const env_map = env ?? process.env;
36
+ const override = env_map[MANIFEST_ENV];
37
+ if (override) {
38
+ return expanduser(override);
39
+ }
40
+ return fsPath.join(project_root, DEFAULT_MANIFEST_RELATIVE);
41
+ }
42
+ var _TOP_KEY_RE = /^([A-Za-z_][A-Za-z0-9_]*)\s*:\s*"?([^"\n]*?)"?\s*$/;
43
+ var _LIST_DASH_RE = /^\s*-\s*(.+?)\s*$/;
44
+ var _INDENT_KEY_RE = /^\s+([A-Za-z_][A-Za-z0-9_]*)\s*:\s*"?([^"\n]*?)"?\s*$/;
45
+ function read_manifest(path) {
46
+ let text;
47
+ try {
48
+ text = require_read_text(path);
49
+ } catch {
50
+ return null;
51
+ }
52
+ const data = _parse_manual(text);
53
+ return _normalise_v2_shape(data);
54
+ }
55
+ function require_read_text(path) {
56
+ return fs.readFileSync(path, { encoding: "utf-8" });
57
+ }
58
+ function _normalise_v2_shape(data) {
59
+ if (data["tools"] === void 0 || data["tools"] === null) {
60
+ data["tools"] = [];
61
+ }
62
+ if (data["deploy_roots"] === void 0 || data["deploy_roots"] === null) {
63
+ data["deploy_roots"] = [];
64
+ }
65
+ const tools = data["tools"];
66
+ for (const tool of tools) {
67
+ if (typeof tool !== "object" || tool === null) {
68
+ continue;
69
+ }
70
+ const t = tool;
71
+ if (t["files"] === void 0 || t["files"] === null) {
72
+ t["files"] = [];
73
+ }
74
+ if (t["merged_keys"] === void 0 || t["merged_keys"] === null) {
75
+ t["merged_keys"] = [];
76
+ }
77
+ }
78
+ return data;
79
+ }
80
+ function _parse_manual(text) {
81
+ const data = { tools: [] };
82
+ const tools = data["tools"];
83
+ let in_tools = false;
84
+ let current = null;
85
+ let skip_until_outdent = false;
86
+ for (const raw of splitlines(text)) {
87
+ const stripped = raw.trim();
88
+ if (!stripped || stripped.startsWith("#")) {
89
+ continue;
90
+ }
91
+ if (stripped === "tools:") {
92
+ in_tools = true;
93
+ current = null;
94
+ skip_until_outdent = false;
95
+ continue;
96
+ }
97
+ if (in_tools) {
98
+ const indent = raw.length - lstrip_spaces(raw).length;
99
+ if (skip_until_outdent && indent > 4) {
100
+ continue;
101
+ }
102
+ skip_until_outdent = false;
103
+ const m = _LIST_DASH_RE.exec(raw);
104
+ if (m && indent === 2) {
105
+ const first = m[1];
106
+ current = {};
107
+ tools.push(current);
108
+ const inline = _TOP_KEY_RE.exec(first);
109
+ if (inline) {
110
+ current[inline[1]] = inline[2];
111
+ }
112
+ continue;
113
+ }
114
+ const mk = _INDENT_KEY_RE.exec(raw);
115
+ if (mk && current !== null && indent === 4) {
116
+ const key = mk[1];
117
+ const val = mk[2];
118
+ if ((key === "files" || key === "merged_keys") && !val) {
119
+ skip_until_outdent = true;
120
+ continue;
121
+ }
122
+ current[key] = val;
123
+ continue;
124
+ }
125
+ }
126
+ const m_top = _TOP_KEY_RE.exec(raw);
127
+ if (m_top) {
128
+ const key = m_top[1];
129
+ const value = m_top[2];
130
+ if (key === "deploy_roots" && !value) {
131
+ in_tools = false;
132
+ current = null;
133
+ skip_until_outdent = true;
134
+ continue;
135
+ }
136
+ if (key === "schema_version") {
137
+ const parsed = parse_int_strict(value);
138
+ data[key] = parsed === null ? value : parsed;
139
+ } else {
140
+ data[key] = value;
141
+ }
142
+ in_tools = false;
143
+ current = null;
144
+ skip_until_outdent = false;
145
+ }
146
+ }
147
+ return data;
148
+ }
149
+ function splitlines(text) {
150
+ const parts = text.split("\n");
151
+ if (parts.length > 0 && parts[parts.length - 1] === "") {
152
+ parts.pop();
153
+ }
154
+ return parts;
155
+ }
156
+ function lstrip_spaces(s) {
157
+ let i = 0;
158
+ while (i < s.length && s[i] === " ") {
159
+ i += 1;
160
+ }
161
+ return s.slice(i);
162
+ }
163
+ function parse_int_strict(value) {
164
+ if (!/^[+-]?\d+$/.test(value.trim())) {
165
+ return null;
166
+ }
167
+ return Number.parseInt(value, 10);
168
+ }
169
+ function _render(version, tools, options = {}) {
170
+ const deploy_roots = options.deploy_roots ?? null;
171
+ const lines = [
172
+ `schema_version: ${SCHEMA_VERSION}`,
173
+ `agent_config_version: "${version}"`
174
+ ];
175
+ if (deploy_roots && deploy_roots.length > 0) {
176
+ lines.push("deploy_roots:");
177
+ for (const root of deploy_roots) {
178
+ lines.push(` - ${root}`);
179
+ }
180
+ }
181
+ lines.push("tools:");
182
+ for (const tool of tools) {
183
+ lines.push(` - name: ${String(tool["name"])}`);
184
+ lines.push(` scope: ${String(tool["scope"])}`);
185
+ lines.push(` bridge_marker: ${String(tool["bridge_marker"])}`);
186
+ lines.push(` installed_at: "${String(tool["installed_at"])}"`);
187
+ const status = tool["status"];
188
+ if (status) {
189
+ lines.push(` status: ${String(status)}`);
190
+ }
191
+ let files = tool["files"] ?? [];
192
+ if (files.length > 0) {
193
+ files = stable_sort(files, (f) => [String(f["path"])]);
194
+ lines.push(" files:");
195
+ for (const entry of files) {
196
+ lines.push(` - path: ${String(entry["path"])}`);
197
+ lines.push(` kind: ${String(entry["kind"])}`);
198
+ const sha = entry["sha256"];
199
+ if (sha === null || sha === void 0) {
200
+ lines.push(" sha256: null");
201
+ } else {
202
+ lines.push(` sha256: "${String(sha)}"`);
203
+ }
204
+ }
205
+ }
206
+ let merged = tool["merged_keys"] ?? [];
207
+ if (merged.length > 0) {
208
+ merged = stable_sort(merged, (e) => [
209
+ String(e["file"]),
210
+ String(e["json_pointer"])
211
+ ]);
212
+ lines.push(" merged_keys:");
213
+ for (const entry of merged) {
214
+ lines.push(` - file: ${String(entry["file"])}`);
215
+ lines.push(` json_pointer: "${String(entry["json_pointer"])}"`);
216
+ const vh = entry["value_hash"];
217
+ if (vh !== null && vh !== void 0) {
218
+ lines.push(` value_hash: "${String(vh)}"`);
219
+ }
220
+ }
221
+ }
222
+ }
223
+ return lines.join("\n") + "\n";
224
+ }
225
+ function stable_sort(items, key) {
226
+ return items.map((item, index) => ({ item, index, k: key(item) })).sort((a, b) => {
227
+ const len = Math.max(a.k.length, b.k.length);
228
+ for (let i = 0; i < len; i += 1) {
229
+ const av = a.k[i] ?? "";
230
+ const bv = b.k[i] ?? "";
231
+ if (av < bv) return -1;
232
+ if (av > bv) return 1;
233
+ }
234
+ return a.index - b.index;
235
+ }).map((entry) => entry.item);
236
+ }
237
+ function write_manifest(path, version, tools, options = {}) {
238
+ const rendered = _render(version, tools, { deploy_roots: options.deploy_roots ?? null });
239
+ return write_atomic(path, rendered);
240
+ }
241
+ var ScopeMismatchError = class extends Error {
242
+ name_;
243
+ recorded_scope;
244
+ new_scope;
245
+ constructor(name, recorded_scope, new_scope) {
246
+ super(
247
+ `tool '${name}' is committed as scope=${recorded_scope}; refusing to change it to scope=${new_scope} without --force`
248
+ );
249
+ this.name = "ScopeMismatchError";
250
+ this.name_ = name;
251
+ this.recorded_scope = recorded_scope;
252
+ this.new_scope = new_scope;
253
+ }
254
+ };
255
+ function upsert_tool(existing, options) {
256
+ const {
257
+ name,
258
+ scope,
259
+ bridge_marker,
260
+ installed_at = null,
261
+ force = false,
262
+ files = null,
263
+ merged_keys = null
264
+ } = options;
265
+ if (!_VALID_SCOPES.includes(scope)) {
266
+ throw new ValueError(`scope must be one of ${_VALID_SCOPES.join(",")}: '${scope}'`);
267
+ }
268
+ const stamp = installed_at || _today();
269
+ const _build = (prior = null) => {
270
+ const entry = {
271
+ name,
272
+ scope,
273
+ bridge_marker,
274
+ installed_at: stamp
275
+ };
276
+ if (files !== null) {
277
+ entry["files"] = [...files];
278
+ } else if (prior !== null && Array.isArray(prior["files"]) && prior["files"].length > 0) {
279
+ entry["files"] = [...prior["files"]];
280
+ }
281
+ if (merged_keys !== null) {
282
+ entry["merged_keys"] = [...merged_keys];
283
+ } else if (prior !== null && Array.isArray(prior["merged_keys"]) && prior["merged_keys"].length > 0) {
284
+ entry["merged_keys"] = [...prior["merged_keys"]];
285
+ }
286
+ return entry;
287
+ };
288
+ const result = [];
289
+ let found = false;
290
+ for (const entry of existing) {
291
+ if (entry["name"] === name) {
292
+ found = true;
293
+ const recorded = String(entry["scope"] ?? "");
294
+ if (recorded === scope) {
295
+ if (files === null && merged_keys === null) {
296
+ result.push(entry);
297
+ } else {
298
+ const refreshed = _build(entry);
299
+ refreshed["installed_at"] = entry["installed_at"] ?? stamp;
300
+ result.push(refreshed);
301
+ }
302
+ continue;
303
+ }
304
+ if (!force) {
305
+ throw new ScopeMismatchError(name, recorded, scope);
306
+ }
307
+ result.push(_build(entry));
308
+ continue;
309
+ }
310
+ result.push(entry);
311
+ }
312
+ if (!found) {
313
+ result.push(_build());
314
+ }
315
+ return result;
316
+ }
317
+ var ValueError = class extends Error {
318
+ constructor(message) {
319
+ super(message);
320
+ this.name = "ValueError";
321
+ }
322
+ };
323
+ function _today() {
324
+ return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
325
+ }
326
+
327
+ export {
328
+ SCHEMA_VERSIONS_SUPPORTED,
329
+ DEFAULT_DEPLOY_ROOTS,
330
+ manifest_path,
331
+ read_manifest,
332
+ write_manifest,
333
+ ScopeMismatchError,
334
+ upsert_tool
335
+ };
@@ -0,0 +1,99 @@
1
+ import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
2
+ import {
3
+ atomicAppendLine
4
+ } from "./chunk-6KM6ORRY.js";
5
+
6
+ // src/install/txlog.ts
7
+ import { createGzip } from "node:zlib";
8
+ import { createReadStream, createWriteStream, existsSync, readFileSync, renameSync, statSync, unlinkSync } from "node:fs";
9
+ import { pipeline } from "node:stream/promises";
10
+ var ROTATION_MAX_BYTES = 10 * 1024 * 1024;
11
+ var ROTATION_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1e3;
12
+ var RECOVERY_DEPTH_CAP = 500;
13
+ function appendTxLog(logPath, entry) {
14
+ if (shouldRotate(logPath)) {
15
+ rotateLogSync(logPath);
16
+ }
17
+ atomicAppendLine(logPath, JSON.stringify(entry));
18
+ }
19
+ function readRecentEntries(logPath) {
20
+ if (!existsSync(logPath)) {
21
+ return [];
22
+ }
23
+ const raw = readFileSync(logPath, "utf8");
24
+ const lines = raw.split("\n").filter((l) => l.length > 0);
25
+ const tail = lines.slice(-RECOVERY_DEPTH_CAP);
26
+ const out = [];
27
+ for (const line of tail) {
28
+ const parsed = tryParseEntry(line);
29
+ if (parsed !== null) {
30
+ out.push(parsed);
31
+ }
32
+ }
33
+ return out;
34
+ }
35
+ function shouldRotate(logPath, now = /* @__PURE__ */ new Date()) {
36
+ if (!existsSync(logPath)) {
37
+ return false;
38
+ }
39
+ let size = 0;
40
+ try {
41
+ size = statSync(logPath).size;
42
+ } catch {
43
+ return false;
44
+ }
45
+ if (size >= ROTATION_MAX_BYTES) {
46
+ return true;
47
+ }
48
+ const firstTs = readFirstTimestamp(logPath);
49
+ if (firstTs === null) {
50
+ return false;
51
+ }
52
+ return now.getTime() - firstTs >= ROTATION_MAX_AGE_MS;
53
+ }
54
+ function rotateLogSync(logPath) {
55
+ if (!existsSync(logPath)) {
56
+ return;
57
+ }
58
+ const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
59
+ const rotated = logPath.replace(/\.jsonl$/, `.${stamp}.jsonl`);
60
+ renameSync(logPath, rotated);
61
+ void gzipInPlace(rotated).catch(() => {
62
+ });
63
+ }
64
+ async function gzipInPlace(source) {
65
+ const target = `${source}.gz`;
66
+ await pipeline(createReadStream(source), createGzip(), createWriteStream(target));
67
+ try {
68
+ unlinkSync(source);
69
+ } catch {
70
+ }
71
+ }
72
+ function readFirstTimestamp(logPath) {
73
+ try {
74
+ const raw = readFileSync(logPath, "utf8");
75
+ const firstLine = raw.split("\n", 1)[0] ?? "";
76
+ const parsed = tryParseEntry(firstLine);
77
+ if (parsed === null) return null;
78
+ const t = Date.parse(parsed.ts);
79
+ return Number.isFinite(t) ? t : null;
80
+ } catch {
81
+ return null;
82
+ }
83
+ }
84
+ function tryParseEntry(line) {
85
+ try {
86
+ const obj = JSON.parse(line);
87
+ if (typeof obj.ts !== "string" || typeof obj.kind !== "string" || typeof obj.path !== "string") {
88
+ return null;
89
+ }
90
+ return obj;
91
+ } catch {
92
+ return null;
93
+ }
94
+ }
95
+
96
+ export {
97
+ appendTxLog,
98
+ readRecentEntries
99
+ };
@@ -4,7 +4,7 @@ import {
4
4
  } from "./chunk-MCJYCQPF.js";
5
5
  import {
6
6
  resolve_project_root
7
- } from "./chunk-2XY7ILBT.js";
7
+ } from "./chunk-FC75PGJE.js";
8
8
 
9
9
  // src/scripts/_cli/cmd_migrate.ts
10
10
  import { spawnSync } from "node:child_process";