@milehimikey/em 1.13.1 → 1.14.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 (232) hide show
  1. package/.claude/agents/em-critic.md +26 -0
  2. package/.claude/agents/em-implementer.md +34 -0
  3. package/.claude/agents/em-reviewer.md +31 -0
  4. package/.claude/agents/em-validator.md +27 -0
  5. package/.claude/skills/event-modeling/SKILL.md +50 -11
  6. package/.claude/skills/event-modeling-conform/SKILL.md +1 -1
  7. package/.claude/skills/event-modeling-design/SKILL.md +126 -18
  8. package/.claude/skills/event-modeling-discover/SKILL.md +1 -1
  9. package/.claude/skills/event-modeling-engagement/SKILL.md +192 -0
  10. package/.claude/skills/event-modeling-engagement/reference/engagement.md +143 -0
  11. package/.claude/skills/event-modeling-implement/SKILL.md +1 -1
  12. package/.claude/skills/event-modeling-implement/reference/implement.md +38 -11
  13. package/.claude/skills/event-modeling-review/SKILL.md +1 -1
  14. package/.claude/skills/event-modeling-shared/reference/em-dsl.md +274 -189
  15. package/.claude/skills/event-modeling-shared/reference/operating-principles.md +61 -0
  16. package/.claude/skills/event-modeling-shared/reference/slice-doc-schema.md +108 -5
  17. package/.claude/skills/event-modeling-shared/templates/constitution.md +18 -1
  18. package/.claude/skills/event-modeling-shared/templates/slice.md +64 -39
  19. package/.claude/skills/event-modeling-shared/templates/state.md +5 -1
  20. package/.claude-plugin/marketplace.json +14 -0
  21. package/README.md +25 -11
  22. package/dist/catalog/apiFirst.d.ts +28 -0
  23. package/dist/catalog/apiFirst.js +49 -0
  24. package/dist/catalog/apiFirst.js.map +1 -0
  25. package/dist/catalog/docJoin.d.ts +13 -0
  26. package/dist/catalog/docJoin.js +11 -0
  27. package/dist/catalog/docJoin.js.map +1 -1
  28. package/dist/catalog/docModelConsistencyValidate.js +44 -4
  29. package/dist/catalog/docModelConsistencyValidate.js.map +1 -1
  30. package/dist/catalog/invariantsValidate.d.ts +4 -0
  31. package/dist/catalog/invariantsValidate.js +102 -0
  32. package/dist/catalog/invariantsValidate.js.map +1 -0
  33. package/dist/catalog/scenarios.d.ts +15 -0
  34. package/dist/catalog/scenarios.js +97 -0
  35. package/dist/catalog/scenarios.js.map +1 -0
  36. package/dist/catalog/sliceDoc.d.ts +8 -0
  37. package/dist/catalog/sliceDoc.js +9 -0
  38. package/dist/catalog/sliceDoc.js.map +1 -1
  39. package/dist/catalog/sliceReadyValidate.d.ts +31 -4
  40. package/dist/catalog/sliceReadyValidate.js +66 -8
  41. package/dist/catalog/sliceReadyValidate.js.map +1 -1
  42. package/dist/catalog/sliceSections.d.ts +55 -0
  43. package/dist/catalog/sliceSections.js +317 -0
  44. package/dist/catalog/sliceSections.js.map +1 -0
  45. package/dist/cli/agentsMd.js +7 -1
  46. package/dist/cli/agentsMd.js.map +1 -1
  47. package/dist/cli/api.d.ts +90 -0
  48. package/dist/cli/api.js +318 -0
  49. package/dist/cli/api.js.map +1 -0
  50. package/dist/cli/ciInit.d.ts +82 -21
  51. package/dist/cli/ciInit.js +468 -64
  52. package/dist/cli/ciInit.js.map +1 -1
  53. package/dist/cli/conformScope.d.ts +28 -0
  54. package/dist/cli/conformScope.js +67 -0
  55. package/dist/cli/conformScope.js.map +1 -1
  56. package/dist/cli/coverage.d.ts +9 -0
  57. package/dist/cli/coverage.js +60 -8
  58. package/dist/cli/coverage.js.map +1 -1
  59. package/dist/cli/engagement.d.ts +210 -0
  60. package/dist/cli/engagement.js +444 -0
  61. package/dist/cli/engagement.js.map +1 -0
  62. package/dist/cli/engagementFile.d.ts +86 -0
  63. package/dist/cli/engagementFile.js +255 -0
  64. package/dist/cli/engagementFile.js.map +1 -0
  65. package/dist/cli/metrics.d.ts +10 -0
  66. package/dist/cli/metrics.js +49 -1
  67. package/dist/cli/metrics.js.map +1 -1
  68. package/dist/cli/pluginPin.d.ts +55 -0
  69. package/dist/cli/pluginPin.js +188 -0
  70. package/dist/cli/pluginPin.js.map +1 -0
  71. package/dist/cli/ratify.d.ts +27 -2
  72. package/dist/cli/ratify.js +112 -13
  73. package/dist/cli/ratify.js.map +1 -1
  74. package/dist/cli/reratify.d.ts +3 -2
  75. package/dist/cli/reratify.js +36 -14
  76. package/dist/cli/reratify.js.map +1 -1
  77. package/dist/cli/scopeInputs.d.ts +48 -0
  78. package/dist/cli/scopeInputs.js +176 -0
  79. package/dist/cli/scopeInputs.js.map +1 -0
  80. package/dist/cli/skillCheck.d.ts +15 -1
  81. package/dist/cli/skillCheck.js +22 -1
  82. package/dist/cli/skillCheck.js.map +1 -1
  83. package/dist/cli/skillDirs.d.ts +5 -0
  84. package/dist/cli/skillDirs.js +13 -1
  85. package/dist/cli/skillDirs.js.map +1 -1
  86. package/dist/cli/skillSync.d.ts +4 -0
  87. package/dist/cli/skillSync.js +23 -0
  88. package/dist/cli/skillSync.js.map +1 -1
  89. package/dist/cli/sliceNew.d.ts +11 -7
  90. package/dist/cli/sliceNew.js +91 -18
  91. package/dist/cli/sliceNew.js.map +1 -1
  92. package/dist/cli/sliceSync.d.ts +50 -0
  93. package/dist/cli/sliceSync.js +170 -0
  94. package/dist/cli/sliceSync.js.map +1 -0
  95. package/dist/cli/status.d.ts +24 -1
  96. package/dist/cli/status.js +20 -1
  97. package/dist/cli/status.js.map +1 -1
  98. package/dist/cli/systemInputs.d.ts +53 -10
  99. package/dist/cli/systemInputs.js +186 -11
  100. package/dist/cli/systemInputs.js.map +1 -1
  101. package/dist/cli/upgrade.d.ts +16 -3
  102. package/dist/cli/upgrade.js +366 -30
  103. package/dist/cli/upgrade.js.map +1 -1
  104. package/dist/cli/usageLog.d.ts +4 -2
  105. package/dist/cli/usageLog.js +4 -2
  106. package/dist/cli/usageLog.js.map +1 -1
  107. package/dist/cli.js +554 -94
  108. package/dist/cli.js.map +1 -1
  109. package/dist/emit/api.d.ts +29 -0
  110. package/dist/emit/api.js +220 -0
  111. package/dist/emit/api.js.map +1 -0
  112. package/dist/emit/apiCheckJson.d.ts +3 -0
  113. package/dist/emit/apiCheckJson.js +21 -0
  114. package/dist/emit/apiCheckJson.js.map +1 -0
  115. package/dist/emit/codeownersJson.d.ts +3 -0
  116. package/dist/emit/codeownersJson.js +19 -0
  117. package/dist/emit/codeownersJson.js.map +1 -0
  118. package/dist/emit/diffJson.d.ts +1 -1
  119. package/dist/emit/diffJson.js +8 -1
  120. package/dist/emit/diffJson.js.map +1 -1
  121. package/dist/emit/engagementJson.d.ts +8 -0
  122. package/dist/emit/engagementJson.js +46 -0
  123. package/dist/emit/engagementJson.js.map +1 -0
  124. package/dist/emit/glossaryJson.d.ts +1 -1
  125. package/dist/emit/glossaryJson.js +4 -1
  126. package/dist/emit/glossaryJson.js.map +1 -1
  127. package/dist/emit/json.d.ts +17 -1
  128. package/dist/emit/json.js +30 -1
  129. package/dist/emit/json.js.map +1 -1
  130. package/dist/emit/metricsJson.d.ts +1 -1
  131. package/dist/emit/metricsJson.js +4 -1
  132. package/dist/emit/metricsJson.js.map +1 -1
  133. package/dist/emit/queryJson.d.ts +1 -1
  134. package/dist/emit/queryJson.js +7 -1
  135. package/dist/emit/queryJson.js.map +1 -1
  136. package/dist/emit/scopeJson.d.ts +12 -0
  137. package/dist/emit/scopeJson.js +26 -0
  138. package/dist/emit/scopeJson.js.map +1 -0
  139. package/dist/emit/skillCheckJson.d.ts +3 -2
  140. package/dist/emit/skillCheckJson.js +10 -2
  141. package/dist/emit/skillCheckJson.js.map +1 -1
  142. package/dist/emit/statusJson.d.ts +1 -1
  143. package/dist/emit/statusJson.js +15 -1
  144. package/dist/emit/statusJson.js.map +1 -1
  145. package/dist/emit/systemJson.d.ts +15 -8
  146. package/dist/emit/systemJson.js +28 -13
  147. package/dist/emit/systemJson.js.map +1 -1
  148. package/dist/emit/validateJson.d.ts +3 -3
  149. package/dist/emit/validateJson.js +10 -4
  150. package/dist/emit/validateJson.js.map +1 -1
  151. package/dist/mcp/server.d.ts +1 -1
  152. package/dist/mcp/server.js +163 -31
  153. package/dist/mcp/server.js.map +1 -1
  154. package/dist/model/diff.d.ts +4 -1
  155. package/dist/model/diff.js +44 -8
  156. package/dist/model/diff.js.map +1 -1
  157. package/dist/model/glossary.d.ts +2 -0
  158. package/dist/model/glossary.js +1 -0
  159. package/dist/model/glossary.js.map +1 -1
  160. package/dist/model/model.d.ts +55 -2
  161. package/dist/model/model.js +57 -0
  162. package/dist/model/model.js.map +1 -1
  163. package/dist/model/qualifiedRef.d.ts +18 -0
  164. package/dist/model/qualifiedRef.js +26 -0
  165. package/dist/model/qualifiedRef.js.map +1 -1
  166. package/dist/model/queryIndex.d.ts +9 -1
  167. package/dist/model/queryIndex.js +18 -2
  168. package/dist/model/queryIndex.js.map +1 -1
  169. package/dist/model/rules.d.ts +143 -2
  170. package/dist/model/rules.js +162 -3
  171. package/dist/model/rules.js.map +1 -1
  172. package/dist/model/validate.d.ts +40 -0
  173. package/dist/model/validate.js +147 -1
  174. package/dist/model/validate.js.map +1 -1
  175. package/dist/parser/ast.d.ts +31 -3
  176. package/dist/parser/parser.js +148 -14
  177. package/dist/parser/parser.js.map +1 -1
  178. package/dist/query/format.js +1 -1
  179. package/dist/query/format.js.map +1 -1
  180. package/dist/query/verbs.d.ts +6 -0
  181. package/dist/query/verbs.js +6 -2
  182. package/dist/query/verbs.js.map +1 -1
  183. package/dist/system/adaptation.d.ts +14 -0
  184. package/dist/system/adaptation.js +49 -0
  185. package/dist/system/adaptation.js.map +1 -0
  186. package/dist/system/codeowners.d.ts +77 -0
  187. package/dist/system/codeowners.js +242 -0
  188. package/dist/system/codeowners.js.map +1 -0
  189. package/dist/system/manifest.d.ts +10 -5
  190. package/dist/system/manifest.js +54 -26
  191. package/dist/system/manifest.js.map +1 -1
  192. package/dist/system/migrateManifest.d.ts +28 -0
  193. package/dist/system/migrateManifest.js +155 -0
  194. package/dist/system/migrateManifest.js.map +1 -0
  195. package/dist/system/scope.d.ts +46 -0
  196. package/dist/system/scope.js +132 -0
  197. package/dist/system/scope.js.map +1 -0
  198. package/dist/system/verify.d.ts +50 -13
  199. package/dist/system/verify.js +179 -58
  200. package/dist/system/verify.js.map +1 -1
  201. package/dist/templates.d.ts +2 -2
  202. package/dist/templates.js +23 -2
  203. package/dist/templates.js.map +1 -1
  204. package/package.json +5 -2
  205. package/plugin/.claude-plugin/plugin.json +18 -0
  206. package/plugin/agents/em-critic.md +27 -0
  207. package/plugin/agents/em-implementer.md +35 -0
  208. package/plugin/agents/em-reviewer.md +32 -0
  209. package/plugin/agents/em-validator.md +28 -0
  210. package/plugin/shared/reference/em-dsl.md +866 -0
  211. package/plugin/shared/reference/methodology.md +329 -0
  212. package/plugin/shared/reference/operating-principles.md +222 -0
  213. package/plugin/shared/reference/slice-doc-schema.md +566 -0
  214. package/plugin/shared/templates/conformance-report.md +85 -0
  215. package/plugin/shared/templates/constitution.md +136 -0
  216. package/plugin/shared/templates/model-readme.md +46 -0
  217. package/plugin/shared/templates/slice.md +251 -0
  218. package/plugin/shared/templates/state.md +77 -0
  219. package/plugin/skills/conform/SKILL.md +93 -0
  220. package/plugin/skills/conform/reference/conform.md +428 -0
  221. package/plugin/skills/design/SKILL.md +297 -0
  222. package/plugin/skills/discover/SKILL.md +90 -0
  223. package/plugin/skills/discover/reference/extract.md +147 -0
  224. package/plugin/skills/engagement/SKILL.md +193 -0
  225. package/plugin/skills/engagement/reference/engagement.md +144 -0
  226. package/plugin/skills/event-modeling/SKILL.md +132 -0
  227. package/plugin/skills/implement/SKILL.md +61 -0
  228. package/plugin/skills/implement/reference/implement.md +439 -0
  229. package/plugin/skills/review/SKILL.md +74 -0
  230. package/dist/emit/typespec.d.ts +0 -26
  231. package/dist/emit/typespec.js +0 -356
  232. package/dist/emit/typespec.js.map +0 -1
@@ -0,0 +1,444 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // `em engagement` (MIL-268): the pure logic behind `new | plan | set | status | close` — unit
3
+ // folding, selection, the dependency graph, the levelled plan, and the Ledger join. The file
4
+ // format and its splices live in `./engagementFile.ts`; the JSON envelopes in
5
+ // `../emit/engagementJson.ts`; the CLI action and the MCP tools only read files and print.
6
+ //
7
+ // The graph (R22) is the model's own semantic edges (`model/edges.ts`, serialized by `em export`
8
+ // as `model.edges`) with `source !== "loops-to"`: a `loops-to` edge re-feeds an EARLIER read
9
+ // model and would turn every to-do-list/reaction pair into a cycle. Edges are lifted from
10
+ // elements to UNITS — the slice that owns a doc: a continuation slice (an again-view-only slice,
11
+ // MIL-208) and an `again` view instance fold into the originating slice, and a slice whose doc
12
+ // is a ratified `covers:` cross-binding (MIL-121) folds into the slice owning that doc. One
13
+ // unit = one doc = one PR = one Ledger row.
14
+ //
15
+ // Determinism: units and every list derived from them are in model (slice) order; no sort by
16
+ // anything but that order and plain string order for stable tie-breaks.
17
+ import { serializeDiagnostic } from "../model/validate.js";
18
+ import { semanticEdges } from "../model/edges.js";
19
+ import { classifySlicePattern } from "../catalog/classify.js";
20
+ import { loadSliceDocsOnce, joinSliceDocFast } from "../model/sliceDocIndex.js";
21
+ import { computeSliceReadiness } from "../catalog/sliceReadyValidate.js";
22
+ import { buildModelIndex } from "../model/queryIndex.js";
23
+ import { buildQuerySystem, resolveElement } from "../query/system.js";
24
+ import { LEDGER_STATES, LEDGER_MARKER, SLUG_RE, buildLedgerLines, formatSliceEntryLine, isLedgerState, loadEngagement, modelRefFor, engagementPath, renderEngagementFile, spliceLedger, spliceSliceEntry, spliceStatus, } from "./engagementFile.js";
25
+ import { ENGAGEMENT_SCHEMA_VERSION } from "../emit/engagementJson.js";
26
+ export function buildUnitIndex(model, refs, baseDir) {
27
+ const docsByKey = loadSliceDocsOnce(baseDir);
28
+ const keys = refs.sliceKeys;
29
+ const unitOfSlice = keys.map((key, i) => {
30
+ const join = joinSliceDocFast(model, refs, model.slices[i], key, docsByKey);
31
+ if (join.continuationOf)
32
+ return join.continuationOf;
33
+ const own = `slices/${key}.md`;
34
+ if (join.found && join.reason === null && join.path !== own) {
35
+ const other = join.path.replace(/^slices\//, "").replace(/\.md$/, "");
36
+ if (keys.includes(other))
37
+ return other;
38
+ }
39
+ return key;
40
+ });
41
+ // A continuation of a covered slice resolves one more hop (rare; the chain is at most 2).
42
+ for (let i = 0; i < unitOfSlice.length; i++) {
43
+ const j = keys.indexOf(unitOfSlice[i]);
44
+ if (j !== -1 && unitOfSlice[j] !== unitOfSlice[i])
45
+ unitOfSlice[i] = unitOfSlice[j];
46
+ }
47
+ const units = [];
48
+ const sliceIndexOf = new Map();
49
+ const pattern = new Map();
50
+ const docStatus = new Map();
51
+ for (let i = 0; i < keys.length; i++) {
52
+ if (unitOfSlice[i] !== keys[i])
53
+ continue;
54
+ units.push(keys[i]);
55
+ sliceIndexOf.set(keys[i], i);
56
+ pattern.set(keys[i], classifySlicePattern(model.slices[i]));
57
+ const join = joinSliceDocFast(model, refs, model.slices[i], keys[i], docsByKey);
58
+ docStatus.set(keys[i], join.found && join.reason === null ? join.status : null);
59
+ }
60
+ return { unitOfSlice, units, sliceIndexOf, pattern, docStatus };
61
+ }
62
+ /** Unit of one element: an `again` view instance belongs to its originating declaration. */
63
+ function unitOfElement(model, idx, id) {
64
+ const el = model.byId.get(id);
65
+ if (!el)
66
+ return null;
67
+ const origin = el.again ? model.byId.get(el.logicalId) ?? el : el;
68
+ return idx.unitOfSlice[origin.sliceIndex] ?? null;
69
+ }
70
+ /** Direct unit-level predecessors over the non-`loops-to` edges (self-edges dropped). */
71
+ export function unitPredecessors(model, idx) {
72
+ const preds = new Map(idx.units.map((u) => [u, new Set()]));
73
+ for (const e of semanticEdges(model)) {
74
+ if (e.source === "loops-to")
75
+ continue;
76
+ const from = unitOfElement(model, idx, e.from);
77
+ const to = unitOfElement(model, idx, e.to);
78
+ if (!from || !to || from === to)
79
+ continue;
80
+ preds.get(to)?.add(from);
81
+ }
82
+ return preds;
83
+ }
84
+ const byOrder = (idx) => (a, b) => (idx.sliceIndexOf.get(a) ?? 0) - (idx.sliceIndexOf.get(b) ?? 0);
85
+ export function resolveSelection(input, idx, sel) {
86
+ const { model, refs } = input;
87
+ const picked = new Set();
88
+ if (sel.kind === "slices") {
89
+ const unknown = sel.keys.filter((k) => !refs.sliceKeys.includes(k));
90
+ if (unknown.length > 0)
91
+ return { ok: false, message: `unknown slice key(s): ${unknown.join(", ")}` };
92
+ for (const k of sel.keys)
93
+ picked.add(idx.unitOfSlice[refs.sliceKeys.indexOf(k)]);
94
+ }
95
+ else if (sel.kind === "context") {
96
+ const want = sel.context.toLowerCase();
97
+ model.slices.forEach((slice, i) => {
98
+ if (slice.elements.some((el) => el.kind === "event" && (el.context ?? "").toLowerCase() === want))
99
+ picked.add(idx.unitOfSlice[i]);
100
+ });
101
+ }
102
+ else {
103
+ // Starting elements: every element of a named slice, or the one element a ref/display name
104
+ // resolves to (`em query`'s own resolver, so the same inputs work and fail the same way).
105
+ let start;
106
+ const sliceIdx = refs.sliceKeys.indexOf(sel.ref);
107
+ if (sliceIdx !== -1) {
108
+ start = model.slices[sliceIdx].elements.map((el) => el.id);
109
+ }
110
+ else {
111
+ const system = buildQuerySystem([{ file: input.file, model, refs, index: buildModelIndex(model, refs, input.baseDir) }]);
112
+ const resolved = resolveElement(system, sel.ref);
113
+ if (!resolved.ok)
114
+ return { ok: false, message: `--downstream-of: ${resolved.error.replace(/^em query: /, "")}` };
115
+ const el = resolved.match.entry.index.byRef.get(resolved.match.ref);
116
+ start = [el.id];
117
+ }
118
+ // `em query downstream`'s closure (instances of one read model are one node), minus
119
+ // `loops-to` edges (R22) — a loop back re-feeds an EARLIER view and is not "downstream".
120
+ const out = new Map();
121
+ for (const e of semanticEdges(model)) {
122
+ if (e.source === "loops-to")
123
+ continue;
124
+ (out.get(e.from) ?? out.set(e.from, []).get(e.from)).push(e.to);
125
+ }
126
+ const instances = new Map();
127
+ for (const el of model.elements) {
128
+ if (el.kind !== "view")
129
+ continue;
130
+ (instances.get(el.logicalId) ?? instances.set(el.logicalId, []).get(el.logicalId)).push(el.id);
131
+ }
132
+ const visited = new Set();
133
+ const queue = [];
134
+ const visit = (id) => {
135
+ const el = model.byId.get(id);
136
+ const group = el && el.kind === "view" ? instances.get(el.logicalId) ?? [id] : [id];
137
+ for (const g of group) {
138
+ if (visited.has(g))
139
+ continue;
140
+ visited.add(g);
141
+ queue.push(g);
142
+ }
143
+ };
144
+ start.forEach(visit);
145
+ while (queue.length > 0)
146
+ for (const next of out.get(queue.shift()) ?? [])
147
+ visit(next);
148
+ for (const id of visited) {
149
+ const u = unitOfElement(model, idx, id);
150
+ if (u)
151
+ picked.add(u);
152
+ }
153
+ }
154
+ return { ok: true, units: [...picked].sort(byOrder(idx)) };
155
+ }
156
+ /** Connected components of the selection, judged over the WHOLE model's non-`loops-to` unit
157
+ * graph (undirected): two selected slices that share an upstream (e.g. two views over one
158
+ * foundation event) are related; three lifecycles that never touch are three components. */
159
+ export function selectionComponents(units, idx, preds) {
160
+ const parent = new Map(idx.units.map((u) => [u, u]));
161
+ const find = (u) => {
162
+ let r = u;
163
+ while (parent.get(r) !== r)
164
+ r = parent.get(r);
165
+ parent.set(u, r);
166
+ return r;
167
+ };
168
+ for (const [to, froms] of preds)
169
+ for (const from of froms) {
170
+ const a = find(to);
171
+ const b = find(from);
172
+ if (a !== b)
173
+ parent.set(a, b);
174
+ }
175
+ const groups = new Map();
176
+ for (const u of units) {
177
+ const r = find(u);
178
+ (groups.get(r) ?? groups.set(r, []).get(r)).push(u);
179
+ }
180
+ return [...groups.values()];
181
+ }
182
+ export function formatComponentsWarning(components) {
183
+ const lines = [
184
+ `warn: em engagement new: the selection has ${components.length} unconnected components in the dependency graph — consider ${components.length} engagements:`,
185
+ ];
186
+ components.forEach((c, i) => lines.push(` ${i + 1}: ${c.join(", ")}`));
187
+ return lines.join("\n");
188
+ }
189
+ /** Ledger facts (pattern, doc status) for the derived table. */
190
+ export function ledgerFacts(idx, keys) {
191
+ return new Map(keys.map((k) => [k, { pattern: idx.pattern.get(k) ?? "unknown", docStatus: idx.docStatus.get(k) ?? null }]));
192
+ }
193
+ // ---- the Ledger join (status, plan) ----
194
+ /** R23: `merged` is also inferred (read-only) when the slice doc has reached `implemented`. */
195
+ export function effectiveState(entry, docStatus) {
196
+ if (entry.state !== "merged" && docStatus === "implemented")
197
+ return { state: "merged", stateInferred: true };
198
+ return { state: entry.state, stateInferred: false };
199
+ }
200
+ export function buildEngagementStatus(file, engagementFile, eng, idx) {
201
+ const counts = Object.fromEntries(LEDGER_STATES.map((s) => [s, 0]));
202
+ const slices = eng.slices.map((e) => {
203
+ const docStatus = idx.docStatus.get(e.key) ?? null;
204
+ const { state, stateInferred } = effectiveState(e, docStatus);
205
+ counts[state]++;
206
+ return {
207
+ key: e.key,
208
+ pattern: idx.pattern.get(e.key) ?? "unknown",
209
+ docStatus,
210
+ state,
211
+ stateInferred,
212
+ heldBy: e.heldBy ?? null,
213
+ branch: e.branch,
214
+ base: e.base,
215
+ pr: e.pr,
216
+ };
217
+ });
218
+ const closable = slices.every((s) => s.state === "merged" || s.state === "gap");
219
+ return {
220
+ file,
221
+ engagement: engagementFile,
222
+ slug: eng.slug,
223
+ status: eng.status,
224
+ created: eng.created,
225
+ createdBy: eng.createdBy,
226
+ parallel: eng.parallel,
227
+ slices,
228
+ counts,
229
+ closable,
230
+ };
231
+ }
232
+ export function formatEngagementStatusText(s) {
233
+ const by = s.createdBy ? ` by ${s.createdBy}` : "";
234
+ const lines = [`engagement "${s.slug}" (${s.status}) — ${s.slices.length} slice(s), parallel ${s.parallel}, created ${s.created}${by}`];
235
+ for (const x of s.slices) {
236
+ const state = `${x.state}${x.stateInferred ? " (inferred: doc implemented)" : ""}${x.heldBy ? ` (${x.heldBy})` : ""}`;
237
+ const extra = [x.branch ? `branch ${x.branch}` : null, x.base ? `base ${x.base}` : null, x.pr ? `pr ${x.pr}` : null].filter(Boolean).join(" · ");
238
+ lines.push(` ${x.key} [${x.pattern}] doc: ${x.docStatus ?? "(no doc)"} · state: ${state}${extra ? ` · ${extra}` : ""}`);
239
+ }
240
+ const open = s.slices.filter((x) => x.state !== "merged" && x.state !== "gap").length;
241
+ lines.push(s.closable ? "closable: yes — every slice is merged or gap" : `closable: no — ${open} slice(s) not merged or gap`);
242
+ return lines.join("\n");
243
+ }
244
+ // ---- the plan ----
245
+ export const HOLD_REASONS = ["not-ready", "upstream-outside-engagement-unmerged", "multiple-unmerged-upstreams"];
246
+ /** Names the engagement keys the current model no longer has as units, or null. */
247
+ export function missingKeys(eng, idx) {
248
+ return eng.slices.map((e) => e.key).filter((k) => !idx.sliceIndexOf.has(k));
249
+ }
250
+ export function buildEngagementPlan(input, engagementFile, eng, idx) {
251
+ const preds = unitPredecessors(input.model, idx);
252
+ const members = eng.slices.map((e) => e.key);
253
+ const memberSet = new Set(members);
254
+ const order = byOrder(idx);
255
+ const inPreds = new Map(members.map((k) => [k, [...(preds.get(k) ?? [])].filter((p) => memberSet.has(p)).sort(order)]));
256
+ // Levels: longest path from an in-engagement root (Kahn's algorithm).
257
+ const level = new Map();
258
+ let remaining = [...members];
259
+ while (remaining.length > 0) {
260
+ const next = remaining.filter((k) => inPreds.get(k).every((p) => level.has(p)));
261
+ if (next.length === 0)
262
+ return { ok: false, message: `the engagement's dependency graph has a cycle (loops-to edges already excluded): ${describeCycle(remaining, inPreds)}` };
263
+ for (const k of next)
264
+ level.set(k, Math.max(-1, ...inPreds.get(k).map((p) => level.get(p))) + 1);
265
+ remaining = remaining.filter((k) => !level.has(k));
266
+ }
267
+ const entryOf = new Map(eng.slices.map((e) => [e.key, e]));
268
+ const mergedOf = (k) => {
269
+ const e = entryOf.get(k);
270
+ const doc = idx.docStatus.get(k) ?? null;
271
+ return e ? effectiveState(e, doc).state === "merged" : doc === "implemented";
272
+ };
273
+ const slices = members.map((key) => {
274
+ const entry = entryOf.get(key);
275
+ const docStatus = idx.docStatus.get(key) ?? null;
276
+ const { state, stateInferred } = effectiveState(entry, docStatus);
277
+ const { scoped, ready } = computeSliceReadiness(input.model, input.refs, input.baseDir, key, input.contract, input.allDiagnostics);
278
+ const upstreams = inPreds.get(key);
279
+ const unmergedIn = upstreams.filter((p) => !mergedOf(p));
280
+ const unmergedOut = [...(preds.get(key) ?? [])].filter((p) => !memberSet.has(p) && idx.docStatus.get(p) !== "implemented");
281
+ let planHeld = null;
282
+ if (state !== "merged") {
283
+ if (!ready)
284
+ planHeld = "not-ready";
285
+ else if (unmergedOut.length > 0)
286
+ planHeld = "upstream-outside-engagement-unmerged";
287
+ else if (unmergedIn.length >= 2)
288
+ planHeld = "multiple-unmerged-upstreams";
289
+ }
290
+ const base = unmergedIn.length >= 2 ? null : unmergedIn.length === 1 ? `impl/${unmergedIn[0]}` : "main";
291
+ return {
292
+ key,
293
+ pattern: idx.pattern.get(key) ?? "unknown",
294
+ docStatus,
295
+ ready,
296
+ readyDiagnostics: scoped.map(serializeDiagnostic),
297
+ level: level.get(key),
298
+ upstreams,
299
+ branch: `impl/${key}`,
300
+ base,
301
+ planHeld,
302
+ held: planHeld ?? (entry.heldBy === "human" && state === "held" ? "human" : null),
303
+ state,
304
+ stateInferred,
305
+ };
306
+ });
307
+ const maxLevel = Math.max(-1, ...slices.map((s) => s.level));
308
+ const levels = [];
309
+ for (let l = 0; l <= maxLevel; l++) {
310
+ const at = slices.filter((s) => s.level === l).map((s) => s.key);
311
+ levels.push({ level: l, width: at.length, ceiling: eng.parallel, slices: at });
312
+ }
313
+ // Slices listed level by level, model order within a level.
314
+ slices.sort((a, b) => a.level - b.level || order(a.key, b.key));
315
+ return { ok: true, plan: { file: input.file, engagement: engagementFile, slug: eng.slug, status: eng.status, parallel: eng.parallel, levels, slices } };
316
+ }
317
+ /** Walk predecessors among the unlevelled nodes until one repeats: `a -> b -> a` (upstream
318
+ * first). Every unlevelled node has an unlevelled predecessor, so the walk always closes. */
319
+ function describeCycle(remaining, inPreds) {
320
+ const left = new Set(remaining);
321
+ const path = [];
322
+ let cur = remaining[0];
323
+ while (!path.includes(cur)) {
324
+ path.push(cur);
325
+ cur = inPreds.get(cur).find((p) => left.has(p));
326
+ }
327
+ const cycle = path.slice(path.indexOf(cur));
328
+ cycle.reverse();
329
+ return [...cycle, cycle[0]].join(" -> ");
330
+ }
331
+ export function formatEngagementPlanText(p) {
332
+ const lines = [`engagement "${p.slug}" (${p.status}) — ${p.slices.length} slice(s) in ${p.levels.length} level(s), parallel ${p.parallel}`];
333
+ for (const lvl of p.levels) {
334
+ lines.push(`level ${lvl.level}: ${lvl.width} slice${lvl.width === 1 ? "" : "s"} (ceiling ${lvl.ceiling})`);
335
+ for (const s of p.slices.filter((x) => x.level === lvl.level)) {
336
+ const held = s.held ? ` · held: ${s.held}` : "";
337
+ const inferred = s.stateInferred ? " (inferred)" : "";
338
+ lines.push(` ${s.key} [${s.pattern}] ${s.branch} on ${s.base ?? "(none)"} · state: ${s.state}${inferred}${held}`);
339
+ }
340
+ }
341
+ return lines.join("\n");
342
+ }
343
+ // ---- load + build (shared by the CLI actions and the MCP tools) ----
344
+ export function engagementPlanFor(input, slug) {
345
+ const loaded = loadEngagement(input.file, slug);
346
+ if (!loaded.ok)
347
+ return loaded;
348
+ const idx = buildUnitIndex(input.model, input.refs, input.baseDir);
349
+ const missing = missingKeys(loaded.file, idx);
350
+ if (missing.length > 0)
351
+ return { ok: false, message: missingMessage(slug, missing) };
352
+ return buildEngagementPlan(input, loaded.path, loaded.file, idx);
353
+ }
354
+ export function engagementStatusFor(input, slug) {
355
+ const loaded = loadEngagement(input.file, slug);
356
+ if (!loaded.ok)
357
+ return loaded;
358
+ const idx = buildUnitIndex(input.model, input.refs, input.baseDir);
359
+ const missing = missingKeys(loaded.file, idx);
360
+ if (missing.length > 0)
361
+ return { ok: false, message: missingMessage(slug, missing) };
362
+ return { ok: true, status: buildEngagementStatus(input.file, loaded.path, loaded.file, idx) };
363
+ }
364
+ export function missingMessage(slug, missing) {
365
+ return `engagement "${slug}" names slice(s) the model no longer has as a doc-owning slice: ${missing.join(", ")}`;
366
+ }
367
+ export function buildNewEngagement(input, opts) {
368
+ if (!SLUG_RE.test(opts.slug))
369
+ return { ok: false, message: `invalid slug "${opts.slug}" — expected kebab-case (a-z, 0-9, -)` };
370
+ if (!Number.isInteger(opts.parallel) || opts.parallel < 1)
371
+ return { ok: false, message: "--parallel must be a positive integer" };
372
+ const idx = buildUnitIndex(input.model, input.refs, input.baseDir);
373
+ const sel = resolveSelection(input, idx, opts.selector);
374
+ if (!sel.ok)
375
+ return sel;
376
+ if (sel.units.length === 0)
377
+ return { ok: false, message: "the selection is empty — nothing to engage" };
378
+ const preds = unitPredecessors(input.model, idx);
379
+ const components = selectionComponents(sel.units, idx, preds);
380
+ const fm = {
381
+ engagementSchemaVersion: ENGAGEMENT_SCHEMA_VERSION,
382
+ slug: opts.slug,
383
+ model: modelRefFor(engagementPath(input.file, opts.slug), input.file),
384
+ created: opts.created,
385
+ createdBy: opts.createdBy,
386
+ parallel: opts.parallel,
387
+ status: "open",
388
+ slices: sel.units.map((key) => ({ key, state: "planned", branch: null, base: null, pr: null })),
389
+ };
390
+ return {
391
+ ok: true,
392
+ text: renderEngagementFile(fm, buildLedgerLines(fm.slices, ledgerFacts(idx, sel.units))),
393
+ units: sel.units,
394
+ warning: components.length > 1 ? formatComponentsWarning(components) : null,
395
+ };
396
+ }
397
+ /** R23: any state is settable, same-state-and-fields is a no-op, `merged` is terminal, `held`
398
+ * records `heldBy: human`. Splices the one entry line and regenerates the Ledger region. */
399
+ export function applyEngagementSet(input, slug, text, eng, opts) {
400
+ if (!isLedgerState(opts.state))
401
+ return { ok: false, message: `invalid --state "${opts.state}" — expected one of: ${LEDGER_STATES.join(", ")}` };
402
+ if (eng.status === "closed")
403
+ return { ok: false, message: `engagement "${slug}" is closed` };
404
+ const current = eng.slices.find((e) => e.key === opts.key);
405
+ if (!current)
406
+ return { ok: false, message: `slice "${opts.key}" is not in engagement "${slug}"` };
407
+ const next = {
408
+ key: current.key,
409
+ state: opts.state,
410
+ branch: opts.branch ?? current.branch,
411
+ base: opts.base ?? current.base,
412
+ pr: opts.pr ?? current.pr,
413
+ };
414
+ if (opts.state === "held")
415
+ next.heldBy = "human";
416
+ const same = formatSliceEntryLine(next) === formatSliceEntryLine(current);
417
+ if (current.state === "merged" && !same)
418
+ return { ok: false, message: `slice "${opts.key}" is merged — merged is terminal` };
419
+ if (same)
420
+ return { ok: true, changed: false, text, entry: current };
421
+ const spliced = spliceSliceEntry(text, next);
422
+ if (spliced === null)
423
+ return { ok: false, message: `slice "${opts.key}"'s slices entry is not on one line — the file was hand-edited; restore the one-line entry shape` };
424
+ const idx = buildUnitIndex(input.model, input.refs, input.baseDir);
425
+ const slices = eng.slices.map((e) => (e.key === next.key ? next : e));
426
+ const withLedger = spliceLedger(spliced, buildLedgerLines(slices, ledgerFacts(idx, slices.map((e) => e.key))));
427
+ if (withLedger === null)
428
+ return { ok: false, message: `the Ledger markers (<!-- GENERATED:${LEDGER_MARKER}:start/end -->) are missing — the file was hand-edited` };
429
+ return { ok: true, changed: true, text: withLedger, entry: next };
430
+ }
431
+ /** R25: closes only when every slice is merged (recorded or inferred) or gap. */
432
+ export function applyEngagementClose(slug, text, status) {
433
+ if (status.status === "closed")
434
+ return { ok: true, changed: false, text };
435
+ if (!status.closable) {
436
+ const open = status.slices.filter((s) => s.state !== "merged" && s.state !== "gap").map((s) => `${s.key} (${s.state})`);
437
+ return { ok: false, message: `engagement "${slug}" is not closable — every slice must be merged or gap; still open: ${open.join(", ")}` };
438
+ }
439
+ const spliced = spliceStatus(text, "closed");
440
+ if (spliced === null)
441
+ return { ok: false, message: "no status: line in the frontmatter — the file was hand-edited" };
442
+ return { ok: true, changed: true, text: spliced };
443
+ }
444
+ //# sourceMappingURL=engagement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engagement.js","sourceRoot":"","sources":["../../src/cli/engagement.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8FAA8F;AAC9F,6FAA6F;AAC7F,8EAA8E;AAC9E,2FAA2F;AAC3F,EAAE;AACF,iGAAiG;AACjG,6FAA6F;AAC7F,0FAA0F;AAC1F,iGAAiG;AACjG,+FAA+F;AAC/F,4FAA4F;AAC5F,4CAA4C;AAC5C,EAAE;AACF,6FAA6F;AAC7F,wEAAwE;AAIxE,OAAO,EAAc,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAsB,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAIL,aAAa,EACb,aAAa,EAEb,OAAO,EACP,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AA6BtE,MAAM,UAAU,cAAc,CAAC,KAAsB,EAAE,IAAgB,EAAE,OAAe;IACtF,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;IAC5B,MAAM,WAAW,GAAa,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC;QACpD,MAAM,GAAG,GAAG,UAAU,GAAG,KAAK,CAAC;QAC/B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtE,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QACzC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IACH,0FAA0F;IAC1F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC;YAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAChF,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAClE,CAAC;AAED,4FAA4F;AAC5F,SAAS,aAAa,CAAC,KAAsB,EAAE,GAAc,EAAE,EAAU;IACvE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AACpD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,KAAsB,EAAE,GAAc;IACrE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAsB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC,CAAC,CAAC;IACzF,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAC1C,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,GAAc,EAAE,EAAE,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAQ9H,MAAM,UAAU,gBAAgB,CAAC,KAAkF,EAAE,GAAc,EAAE,GAAa;IAChJ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrG,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACpI,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,2FAA2F;QAC3F,0FAA0F;QAC1F,IAAI,KAAe,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YACzH,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YACjH,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC;YACrE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,oFAAoF;QACpF,yFAAyF;QACzF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;gBAAE,SAAS;YACtC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC9C,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YACjC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE;YAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,SAAS;gBAC7B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC,IAAI,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvF,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;6FAE6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,KAAe,EAAE,GAAc,EAAE,KAA+B;IAClG,MAAM,MAAM,GAAG,IAAI,GAAG,CAAiB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE;QACjC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK;QAAE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAsB;IAC5D,MAAM,KAAK,GAAG;QACZ,8CAA8C,UAAU,CAAC,MAAM,8DAA8D,UAAU,CAAC,MAAM,eAAe;KAC9J,CAAC;IACF,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,GAAc,EAAE,IAAc;IACxD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9H,CAAC;AAED,2CAA2C;AAE3C,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,KAA2B,EAAE,SAAwB;IAClF,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,KAAK,aAAa;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC7G,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC;AA4BD,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,cAAsB,EAAE,GAAmB,EAAE,GAAc;IAC7G,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAgC,CAAC;IACnG,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACnD,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO;YACL,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,SAAS;YAC5C,SAAS;YACT,KAAK;YACL,aAAa;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;YACxB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,EAAE,EAAE,CAAC,CAAC,EAAE;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAChF,OAAO;QACL,IAAI;QACJ,UAAU,EAAE,cAAc;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM;QACN,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,CAAmB;IAC5D,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,uBAAuB,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC;IACxI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtH,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjJ,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,SAAS,IAAI,UAAU,aAAa,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3H,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,kBAAkB,IAAI,6BAA6B,CAAC,CAAC;IAC9H,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,qBAAqB;AAErB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,sCAAsC,EAAE,6BAA6B,CAAU,CAAC;AA0C1H,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,GAAmB,EAAE,GAAc;IAC7D,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA2B,EAAE,cAAsB,EAAE,GAAmB,EAAE,GAAc;IAC1H,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAExH,sEAAsE;IACtE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,IAAI,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC7B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oFAAoF,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QAC9K,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnG,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAW,EAAE;QACtC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACzC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,aAAa,CAAC;IAC/E,CAAC,CAAC;IAEF,MAAM,MAAM,GAA0B,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAChC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACjD,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QACnI,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QACpC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC;QAC3H,IAAI,QAAQ,GAAsB,IAAI,CAAC;QACvC,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK;gBAAE,QAAQ,GAAG,WAAW,CAAC;iBAC9B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,GAAG,sCAAsC,CAAC;iBAC9E,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC;gBAAE,QAAQ,GAAG,6BAA6B,CAAC;QAC5E,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACxG,OAAO;YACL,GAAG;YACH,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS;YAC1C,SAAS;YACT,KAAK;YACL,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACjD,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE;YACtB,SAAS;YACT,MAAM,EAAE,QAAQ,GAAG,EAAE;YACrB,IAAI;YACJ,QAAQ;YACR,IAAI,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YACjF,KAAK;YACL,aAAa;SACd,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,4DAA4D;IAC5D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;AAC1J,CAAC;AAED;8FAC8F;AAC9F,SAAS,aAAa,CAAC,SAAmB,EAAE,OAA8B;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,CAAC;IAChB,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,CAAiB;IACxD,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,gBAAgB,CAAC,CAAC,MAAM,CAAC,MAAM,uBAAuB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5I,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,SAAS,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC;QAC3G,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,IAAI,IAAI,QAAQ,aAAa,CAAC,CAAC,KAAK,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,uEAAuE;AAEvE,MAAM,UAAU,iBAAiB,CAAC,KAA2B,EAAE,IAAY;IACzE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IACrF,OAAO,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAID,MAAM,UAAU,mBAAmB,CAAC,KAAkF,EAAE,IAAY;IAClI,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IACrF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAiB;IAC5D,OAAO,eAAe,IAAI,mEAAmE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACpH,CAAC;AAcD,MAAM,UAAU,kBAAkB,CAAC,KAAkF,EAAE,IAA0B;IAC/I,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC,IAAI,uCAAuC,EAAE,CAAC;IAC/H,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;IAClI,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC;IACxB,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;IACxG,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAmB;QACzB,uBAAuB,EAAE,yBAAyB;QAClD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;QACrE,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;KAChG,CAAC;IACF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACxF,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;KAC5E,CAAC;AACJ,CAAC;AAYD;6FAC6F;AAC7F,MAAM,UAAU,kBAAkB,CAChC,KAAkF,EAClF,IAAY,EACZ,IAAY,EACZ,GAAmB,EACnB,IAAgB;IAEhB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,IAAI,CAAC,KAAK,wBAAwB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAChJ,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,CAAC;IAC7F,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC,GAAG,2BAA2B,IAAI,GAAG,EAAE,CAAC;IAClG,MAAM,IAAI,GAAyB;QACjC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;QAC/B,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE;KAC1B,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IACjD,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC,GAAG,kCAAkC,EAAE,CAAC;IAC7H,IAAI,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC,GAAG,kGAAkG,EAAE,CAAC;IAC1K,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/G,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,sCAAsC,aAAa,wDAAwD,EAAE,CAAC;IACpK,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACpE,CAAC;AAID,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAY,EAAE,MAAwB;IACvF,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QACxH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,IAAI,sEAAsE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5I,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,+DAA+D,EAAE,CAAC;IACrH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}
@@ -0,0 +1,86 @@
1
+ /** The Ledger states (R23), in lifecycle order. Any state is settable; `merged` is terminal. */
2
+ export declare const LEDGER_STATES: readonly ["planned", "building", "validating", "review", "awaiting-merge", "merged", "held", "gap"];
3
+ export type LedgerState = (typeof LEDGER_STATES)[number];
4
+ export declare function isLedgerState(value: string): value is LedgerState;
5
+ export declare const ENGAGEMENTS_DIR = "engagements";
6
+ export declare const LEDGER_MARKER = "em-engagement-ledger";
7
+ /** Same kebab grammar as a slice export key — the slug is a filename stem. */
8
+ export declare const SLUG_RE: RegExp;
9
+ export interface EngagementSliceEntry {
10
+ key: string;
11
+ state: LedgerState;
12
+ branch: string | null;
13
+ base: string | null;
14
+ pr: string | null;
15
+ /** R23: present (always `"human"`) only while `state` is `held` via `em engagement set`. */
16
+ heldBy?: "human";
17
+ }
18
+ export interface EngagementFile {
19
+ engagementSchemaVersion: string;
20
+ slug: string;
21
+ /** The model file's path relative to the engagement file (`/`-separated, e.g. `../checkout.em`). */
22
+ model: string;
23
+ created: string;
24
+ createdBy: string | null;
25
+ parallel: number;
26
+ status: "open" | "closed";
27
+ slices: EngagementSliceEntry[];
28
+ }
29
+ /** `<modelDir>/engagements/<slug>.md`, built from the model path as given (never absolutized —
30
+ * it is echoed into JSON output). */
31
+ export declare function engagementPath(modelFile: string, slug: string): string;
32
+ /** The file's dominant line ending — CRLF if it contains any, else LF. */
33
+ export declare function detectEol(text: string): "\r\n" | "\n";
34
+ /** One `slices:` entry as its single frontmatter line (no EOL). Key order is fixed. */
35
+ export declare function formatSliceEntryLine(e: EngagementSliceEntry): string;
36
+ /** One Ledger row's derived facts that do not live in the file (the model's pattern, the slice
37
+ * doc's current status). */
38
+ export interface LedgerRowFacts {
39
+ pattern: string;
40
+ docStatus: string | null;
41
+ }
42
+ /** The Ledger table lines (header + one row per slice, file order) — the body of the
43
+ * generated region. Every cell comes from the frontmatter entry or the model/doc facts. */
44
+ export declare function buildLedgerLines(slices: EngagementSliceEntry[], facts: Map<string, LedgerRowFacts>): string[];
45
+ /** The whole file `em engagement new` writes (LF). */
46
+ export declare function renderEngagementFile(fm: EngagementFile, ledgerLines: string[]): string;
47
+ export type ParseResult = {
48
+ ok: true;
49
+ file: EngagementFile;
50
+ } | {
51
+ ok: false;
52
+ message: string;
53
+ };
54
+ /** Read the frontmatter (read-only — writes never go through this). Strict on the fields every
55
+ * command relies on; the message is appended to the caller's `em engagement <verb>: ` prefix. */
56
+ export declare function parseEngagementFile(text: string): ParseResult;
57
+ /** Replace slice `key`'s one entry line in the frontmatter, keeping its EOL. Null when the line
58
+ * is not found (the file was hand-edited out of the one-line shape). */
59
+ export declare function spliceSliceEntry(text: string, entry: EngagementSliceEntry): string | null;
60
+ /** Replace the frontmatter `status:` value. Null when the line is not found. */
61
+ export declare function spliceStatus(text: string, status: "open" | "closed"): string | null;
62
+ /** Regenerate the Ledger region's body in the file's own EOL. Null when the marker pair is
63
+ * missing. */
64
+ export declare function spliceLedger(text: string, ledgerLines: string[]): string | null;
65
+ /** MIL-268 `em status` line: the open engagements beside each input model (one scan per
66
+ * distinct model directory), slugs sorted. Unreadable or unparseable files are skipped — `em
67
+ * status` reports, it does not lint (`em engagement status` names the problem). */
68
+ export declare function readOpenEngagements(modelFiles: string[]): {
69
+ open: number;
70
+ slugs: string[];
71
+ };
72
+ export type LoadResult = {
73
+ ok: true;
74
+ path: string;
75
+ text: string;
76
+ file: EngagementFile;
77
+ } | {
78
+ ok: false;
79
+ message: string;
80
+ };
81
+ /** Read + parse `<modelDir>/engagements/<slug>.md`; the message completes `em engagement <verb>: `. */
82
+ export declare function loadEngagement(modelFile: string, slug: string): LoadResult;
83
+ /** `model:` for a new engagement file: the model's path relative to the file, `/`-separated. */
84
+ export declare function modelRefFor(engagementFile: string, modelFile: string): string;
85
+ /** Does the engagement file at `path` belong to `modelFile` (its `model:` resolves to it)? */
86
+ export declare function belongsTo(path: string, eng: EngagementFile, modelFile: string): boolean;