pi-daddy 0.49.5 → 0.51.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 (160) hide show
  1. package/CHANGELOG.md +57 -1
  2. package/README.md +231 -27
  3. package/dist/governance/initiative-coordinator.d.ts +63 -0
  4. package/dist/governance/initiative-coordinator.d.ts.map +1 -0
  5. package/dist/governance/initiative-coordinator.js +364 -0
  6. package/dist/governance/initiative-coordinator.js.map +1 -0
  7. package/dist/governance/initiative-effects.d.ts +20 -0
  8. package/dist/governance/initiative-effects.d.ts.map +1 -0
  9. package/dist/governance/initiative-effects.js +108 -0
  10. package/dist/governance/initiative-effects.js.map +1 -0
  11. package/dist/governance/initiative-state.d.ts +13 -0
  12. package/dist/governance/initiative-state.d.ts.map +1 -0
  13. package/dist/governance/initiative-state.js +122 -0
  14. package/dist/governance/initiative-state.js.map +1 -0
  15. package/dist/governance/operation-artifact-io.d.ts +8 -0
  16. package/dist/governance/operation-artifact-io.d.ts.map +1 -0
  17. package/dist/governance/operation-artifact-io.js +95 -0
  18. package/dist/governance/operation-artifact-io.js.map +1 -0
  19. package/dist/governance/operation-artifact-scan.d.ts +13 -0
  20. package/dist/governance/operation-artifact-scan.d.ts.map +1 -0
  21. package/dist/governance/operation-artifact-scan.js +71 -0
  22. package/dist/governance/operation-artifact-scan.js.map +1 -0
  23. package/dist/governance/operation-artifacts.d.ts +53 -0
  24. package/dist/governance/operation-artifacts.d.ts.map +1 -0
  25. package/dist/governance/operation-artifacts.js +309 -0
  26. package/dist/governance/operation-artifacts.js.map +1 -0
  27. package/dist/governance/runtime-settlement.d.ts +2 -0
  28. package/dist/governance/runtime-settlement.d.ts.map +1 -1
  29. package/dist/governance/runtime-settlement.js +26 -0
  30. package/dist/governance/runtime-settlement.js.map +1 -1
  31. package/dist/governance/workspace-acceptance.d.ts +5 -0
  32. package/dist/governance/workspace-acceptance.d.ts.map +1 -1
  33. package/dist/governance/workspace-acceptance.js +16 -0
  34. package/dist/governance/workspace-acceptance.js.map +1 -1
  35. package/dist/index.d.ts +8 -0
  36. package/dist/index.d.ts.map +1 -1
  37. package/dist/index.js +8 -0
  38. package/dist/index.js.map +1 -1
  39. package/dist/kernel/dashboard-observation.d.ts +76 -0
  40. package/dist/kernel/dashboard-observation.d.ts.map +1 -0
  41. package/dist/kernel/dashboard-observation.js +49 -0
  42. package/dist/kernel/dashboard-observation.js.map +1 -0
  43. package/dist/kernel/dispatch-operation.d.ts +2 -0
  44. package/dist/kernel/dispatch-operation.d.ts.map +1 -1
  45. package/dist/kernel/dispatch-operation.js.map +1 -1
  46. package/dist/kernel/initiative.d.ts +94 -0
  47. package/dist/kernel/initiative.d.ts.map +1 -0
  48. package/dist/kernel/initiative.js +38 -0
  49. package/dist/kernel/initiative.js.map +1 -0
  50. package/dist/kernel/operation-artifact.d.ts +49 -0
  51. package/dist/kernel/operation-artifact.d.ts.map +1 -0
  52. package/dist/kernel/operation-artifact.js +4 -0
  53. package/dist/kernel/operation-artifact.js.map +1 -0
  54. package/dist/kernel/principal-binding.d.ts +4 -0
  55. package/dist/kernel/principal-binding.d.ts.map +1 -0
  56. package/dist/kernel/principal-binding.js +94 -0
  57. package/dist/kernel/principal-binding.js.map +1 -0
  58. package/dist/kernel/project-paths.d.ts +6 -0
  59. package/dist/kernel/project-paths.d.ts.map +1 -1
  60. package/dist/kernel/project-paths.js +12 -0
  61. package/dist/kernel/project-paths.js.map +1 -1
  62. package/dist/kernel/selected-definitions.d.ts.map +1 -1
  63. package/dist/kernel/selected-definitions.js +5 -91
  64. package/dist/kernel/selected-definitions.js.map +1 -1
  65. package/dist/kernel/workspace-diagnostics.d.ts +24 -0
  66. package/dist/kernel/workspace-diagnostics.d.ts.map +1 -0
  67. package/dist/kernel/workspace-diagnostics.js +81 -0
  68. package/dist/kernel/workspace-diagnostics.js.map +1 -0
  69. package/dist/products/activity-storage.d.ts +2 -0
  70. package/dist/products/activity-storage.d.ts.map +1 -0
  71. package/dist/products/activity-storage.js +119 -0
  72. package/dist/products/activity-storage.js.map +1 -0
  73. package/dist/products/activity-timeline.d.ts +4 -0
  74. package/dist/products/activity-timeline.d.ts.map +1 -1
  75. package/dist/products/activity-timeline.js +12 -0
  76. package/dist/products/activity-timeline.js.map +1 -1
  77. package/dist/products/dashboard-cli.d.ts +2 -0
  78. package/dist/products/dashboard-cli.d.ts.map +1 -1
  79. package/dist/products/dashboard-cli.js +50 -10
  80. package/dist/products/dashboard-cli.js.map +1 -1
  81. package/dist/products/dashboard-display-controls.d.ts.map +1 -1
  82. package/dist/products/dashboard-display-controls.js +72 -2
  83. package/dist/products/dashboard-display-controls.js.map +1 -1
  84. package/dist/products/dashboard-file-cache.d.ts +10 -0
  85. package/dist/products/dashboard-file-cache.d.ts.map +1 -0
  86. package/dist/products/dashboard-file-cache.js +38 -0
  87. package/dist/products/dashboard-file-cache.js.map +1 -0
  88. package/dist/products/dashboard-layout.d.ts +6 -0
  89. package/dist/products/dashboard-layout.d.ts.map +1 -0
  90. package/dist/products/dashboard-layout.js +45 -0
  91. package/dist/products/dashboard-layout.js.map +1 -0
  92. package/dist/products/dashboard-panels.d.ts +10 -0
  93. package/dist/products/dashboard-panels.d.ts.map +1 -0
  94. package/dist/products/dashboard-panels.js +319 -0
  95. package/dist/products/dashboard-panels.js.map +1 -0
  96. package/dist/products/dashboard-recap.d.ts +4 -0
  97. package/dist/products/dashboard-recap.d.ts.map +1 -0
  98. package/dist/products/dashboard-recap.js +47 -0
  99. package/dist/products/dashboard-recap.js.map +1 -0
  100. package/dist/products/dashboard-screen.d.ts +14 -1
  101. package/dist/products/dashboard-screen.d.ts.map +1 -1
  102. package/dist/products/dashboard-screen.js +217 -40
  103. package/dist/products/dashboard-screen.js.map +1 -1
  104. package/dist/products/dashboard-session-client.d.ts +16 -2
  105. package/dist/products/dashboard-session-client.d.ts.map +1 -1
  106. package/dist/products/dashboard-session-client.js +64 -11
  107. package/dist/products/dashboard-session-client.js.map +1 -1
  108. package/dist/products/dashboard-settings.d.ts.map +1 -1
  109. package/dist/products/dashboard-settings.js +4 -6
  110. package/dist/products/dashboard-settings.js.map +1 -1
  111. package/dist/products/ecosystem-versions.d.ts +1 -1
  112. package/dist/products/ecosystem-versions.d.ts.map +1 -1
  113. package/extensions/activity-timeline.ts +3 -1
  114. package/extensions/artifact-bridge.ts +130 -0
  115. package/extensions/dashboard-live.ts +63 -0
  116. package/extensions/dashboard-observation.ts +39 -0
  117. package/extensions/dashboard-session-server.ts +45 -3
  118. package/extensions/dashboard-sources.ts +124 -0
  119. package/extensions/delegation-artifacts.ts +133 -0
  120. package/extensions/delegation-operations.ts +42 -13
  121. package/extensions/ecosystem-versions.ts +12 -5
  122. package/extensions/grants-command.ts +34 -6
  123. package/extensions/grants.ts +9 -20
  124. package/extensions/initiative-dashboard.ts +143 -0
  125. package/extensions/initiative-handoff.ts +59 -0
  126. package/extensions/initiative-runtime.ts +444 -0
  127. package/extensions/runtime-snapshot.ts +118 -2
  128. package/extensions/session-environment.ts +13 -1
  129. package/extensions/session.ts +28 -10
  130. package/extensions/workspace-diagnostics.ts +90 -0
  131. package/package.json +1 -1
  132. package/src/governance/initiative-coordinator.ts +416 -0
  133. package/src/governance/initiative-effects.ts +146 -0
  134. package/src/governance/initiative-state.ts +144 -0
  135. package/src/governance/operation-artifact-io.ts +103 -0
  136. package/src/governance/operation-artifact-scan.ts +77 -0
  137. package/src/governance/operation-artifacts.ts +363 -0
  138. package/src/governance/runtime-settlement.ts +28 -0
  139. package/src/governance/workspace-acceptance.ts +18 -0
  140. package/src/index.ts +13 -0
  141. package/src/kernel/dashboard-observation.ts +109 -0
  142. package/src/kernel/dispatch-operation.ts +2 -0
  143. package/src/kernel/initiative.ts +126 -0
  144. package/src/kernel/operation-artifact.ts +46 -0
  145. package/src/kernel/principal-binding.ts +104 -0
  146. package/src/kernel/project-paths.ts +16 -0
  147. package/src/kernel/selected-definitions.ts +5 -100
  148. package/src/kernel/workspace-diagnostics.ts +110 -0
  149. package/src/products/activity-storage.ts +128 -0
  150. package/src/products/activity-timeline.ts +11 -0
  151. package/src/products/dashboard-cli.ts +53 -10
  152. package/src/products/dashboard-display-controls.ts +63 -2
  153. package/src/products/dashboard-file-cache.ts +38 -0
  154. package/src/products/dashboard-layout.ts +50 -0
  155. package/src/products/dashboard-panels.ts +379 -0
  156. package/src/products/dashboard-recap.ts +48 -0
  157. package/src/products/dashboard-screen.ts +266 -43
  158. package/src/products/dashboard-session-client.ts +78 -14
  159. package/src/products/dashboard-settings.ts +4 -6
  160. package/src/products/ecosystem-versions.ts +2 -1
@@ -0,0 +1,364 @@
1
+ /** One coordinator per local initiative. Reuses OS-held ownership; ordinary dispatch still owns grants and writer leases. */
2
+ import { realpathSync, existsSync } from "node:fs";
3
+ import { basename } from "node:path";
4
+ import { validOperationId } from "../kernel/dispatch-operation.js";
5
+ import { validInitiativeTask, sameEffectTarget, } from "../kernel/initiative.js";
6
+ import { effectCurrent, assertTaskPriorSettled, currentEffectReceipt, receiptResolves, effectObservation, effectIdentity, exactEffect, settledInitiative, } from "./initiative-effects.js";
7
+ import { lockRuntimeSettlement } from "./runtime-settlement-lock.js";
8
+ import { publishArtifact } from "./operation-artifact-io.js";
9
+ import { initiativeLocation, initiativeRevision, readInitiativeState, saveInitiative } from "./initiative-state.js";
10
+ export async function acquireInitiativeCoordinator(directory, request, options) {
11
+ directory = realpathSync(directory);
12
+ request = {
13
+ initiativeId: request.initiativeId,
14
+ expectedRevision: request.expectedRevision,
15
+ recoveryOnly: request.recoveryOnly === true,
16
+ owner: { sessionId: request.owner.sessionId, cwd: request.owner.cwd },
17
+ };
18
+ if (!request.owner.sessionId ||
19
+ request.owner.sessionId.length > 512 ||
20
+ request.owner.cwd !== realpathSync(request.owner.cwd))
21
+ throw Error("initiative owner identity unavailable");
22
+ await options.assertAuthority();
23
+ const { root, path } = initiativeLocation(directory, request.initiativeId, !request.recoveryOnly);
24
+ const lock = await lockRuntimeSettlement(path + ".lock");
25
+ let closed = false, failed = false;
26
+ try {
27
+ await options.assertAuthority();
28
+ const old = readInitiativeState(directory, request.initiativeId);
29
+ if ((old?.revision ?? null) !== request.expectedRevision)
30
+ throw Error("initiative revision conflict");
31
+ const marker = basename(path) + ".initialized";
32
+ if (!old && existsSync(path + ".initialized"))
33
+ throw Error("initiative state missing; restore trusted state");
34
+ const settled = (record) => settledInitiative(record, options);
35
+ if (request.recoveryOnly && !old)
36
+ throw Error("no retained initiative to recover");
37
+ if (!request.recoveryOnly && old && !(await settled(old.record)))
38
+ throw Error("initiative reconciliation required; prior attempt or effects unresolved");
39
+ await options.assertAuthority();
40
+ if (!lock.healthy())
41
+ throw Error("initiative ownership lock lost");
42
+ if ((readInitiativeState(directory, request.initiativeId)?.revision ?? null) !== request.expectedRevision)
43
+ throw Error("initiative changed before takeover");
44
+ if (!old)
45
+ publishArtifact(root, marker, JSON.stringify({ version: 1, initiativeId: request.initiativeId }) + "\n", false);
46
+ const record = request.recoveryOnly
47
+ ? structuredClone(old.record)
48
+ : {
49
+ version: 1,
50
+ initiativeId: request.initiativeId,
51
+ generation: (old?.record.generation ?? 0) + 1,
52
+ owner: { ...request.owner },
53
+ state: "owned",
54
+ tasks: structuredClone(old?.record.tasks ?? []),
55
+ };
56
+ if (!Number.isSafeInteger(record.generation))
57
+ throw Error("initiative generation exhausted");
58
+ let revision = initiativeRevision(record);
59
+ if (!request.recoveryOnly)
60
+ saveInitiative(path, root, record);
61
+ let tail = Promise.resolve();
62
+ const currentGuard = (authority) => async () => {
63
+ if (closed || failed || !lock.healthy())
64
+ throw Error("initiative coordinator is no longer current");
65
+ await authority();
66
+ if (closed ||
67
+ failed ||
68
+ !lock.healthy() ||
69
+ readInitiativeState(directory, request.initiativeId)?.revision !== revision)
70
+ throw Error("initiative coordinator generation or state changed");
71
+ };
72
+ const assertCurrent = currentGuard(() => options.assertAuthority());
73
+ const assertObservationCurrent = currentGuard(() => options.assertObservationAuthority ? options.assertObservationAuthority() : options.assertAuthority());
74
+ const change = (work) => {
75
+ const next = tail.then(work);
76
+ tail = next.then(() => undefined, () => undefined);
77
+ return next;
78
+ };
79
+ const save = () => {
80
+ try {
81
+ saveInitiative(path, root, record);
82
+ revision = initiativeRevision(record);
83
+ }
84
+ catch (error) {
85
+ failed = true;
86
+ throw error;
87
+ }
88
+ };
89
+ const observeAttempts = async (task) => {
90
+ const states = [];
91
+ const effects = [], receipts = [];
92
+ // Retained attempts are bounded; never fan all historical filesystem checks out at once.
93
+ for (const attempt of task?.attempts ?? []) {
94
+ states.push(await options.resolveAttempt(structuredClone(attempt)));
95
+ const receipt = await currentEffectReceipt(record.initiativeId, task, attempt, options);
96
+ receipts.push(receipt);
97
+ effects.push(receiptResolves(task, receipt));
98
+ }
99
+ return { states, effects, receipts };
100
+ };
101
+ const taskAt = (task) => {
102
+ if (!validInitiativeTask(task))
103
+ throw Error("invalid initiative task");
104
+ const found = record.tasks.find((t) => t.taskId === task.taskId && t.taskRevision === task.taskRevision);
105
+ if (found && (found.effectScope !== task.effectScope || !sameEffectTarget(found.effectTarget, task.effectTarget)))
106
+ throw Error("task effect scope or target changed without revision");
107
+ return found;
108
+ };
109
+ return {
110
+ generation: record.generation,
111
+ recoveryOnly: request.recoveryOnly === true,
112
+ revision: () => revision,
113
+ metadata: () => ({
114
+ initiativeId: record.initiativeId,
115
+ generation: record.generation,
116
+ knownSessions: new Set([
117
+ record.owner.sessionId,
118
+ ...record.tasks.flatMap((t) => t.attempts.map((a) => a.owner.sessionId)),
119
+ ]).size,
120
+ recordedTasks: record.tasks.length,
121
+ recordedAttempts: record.tasks.reduce((n, t) => n + t.attempts.length, 0),
122
+ }),
123
+ assertCurrent,
124
+ assertObservationCurrent,
125
+ claim(task) {
126
+ task = structuredClone(task);
127
+ return change(async () => {
128
+ await assertCurrent();
129
+ if (request.recoveryOnly)
130
+ throw Error("recovery-only owner cannot claim or dispatch");
131
+ if (taskAt(task)?.generation === record.generation)
132
+ return;
133
+ const prior = record.tasks.filter((t) => t.taskId === task.taskId);
134
+ if (!(await settled({ ...record, tasks: prior })))
135
+ throw Error("task prior attempts need reconciliation");
136
+ await assertCurrent();
137
+ const found = taskAt(task);
138
+ if (found)
139
+ found.generation = record.generation;
140
+ else
141
+ record.tasks.push({ ...structuredClone(task), generation: record.generation, attempts: [] });
142
+ save();
143
+ });
144
+ },
145
+ begin(task, operation) {
146
+ task = structuredClone(task);
147
+ return change(async () => {
148
+ await assertCurrent();
149
+ if (request.recoveryOnly)
150
+ throw Error("recovery-only owner cannot claim or dispatch");
151
+ const found = taskAt(task);
152
+ if (!found || found.generation !== record.generation || !validOperationId(operation.operationId))
153
+ throw Error("initiative task is not claimed by current generation");
154
+ await assertTaskPriorSettled(record, task, options);
155
+ await assertCurrent();
156
+ const all = record.tasks.flatMap((t) => t.attempts);
157
+ if (all.some((a) => a.owner.sessionId === request.owner.sessionId &&
158
+ a.owner.cwd === request.owner.cwd &&
159
+ a.operationId === operation.operationId))
160
+ throw Error("initiative operation already associated");
161
+ found.attempts.push({
162
+ owner: { ...request.owner },
163
+ operationId: operation.operationId,
164
+ executionId: operation.executionId,
165
+ requestDigest: operation.requestDigest,
166
+ state: "pending",
167
+ });
168
+ save();
169
+ });
170
+ },
171
+ async assertPriorAttemptsSettled(task, operation) {
172
+ task = structuredClone(task);
173
+ operation = { ...operation };
174
+ const captured = revision;
175
+ await assertCurrent();
176
+ const found = taskAt(task);
177
+ const attempt = found?.attempts.find((a) => a.owner.sessionId === request.owner.sessionId &&
178
+ a.owner.cwd === request.owner.cwd &&
179
+ a.operationId === operation.operationId &&
180
+ a.executionId === operation.executionId &&
181
+ a.requestDigest === operation.requestDigest);
182
+ if (request.recoveryOnly ||
183
+ !found ||
184
+ found.generation !== record.generation ||
185
+ !attempt ||
186
+ attempt.state === "not-admitted")
187
+ throw Error("exact admitted initiative attempt required before start");
188
+ await assertTaskPriorSettled(record, task, options, attempt);
189
+ await assertCurrent();
190
+ if (revision !== captured)
191
+ throw Error("initiative changed before start");
192
+ },
193
+ notAdmitted(operation) {
194
+ return change(async () => {
195
+ await assertCurrent();
196
+ const a = record.tasks
197
+ .flatMap((t) => t.attempts)
198
+ .find((a) => a.owner.sessionId === request.owner.sessionId &&
199
+ a.owner.cwd === request.owner.cwd &&
200
+ a.operationId === operation.operationId &&
201
+ a.executionId === operation.executionId);
202
+ if (!a)
203
+ throw Error("initiative attempt missing");
204
+ a.state = "not-admitted";
205
+ save();
206
+ });
207
+ },
208
+ async observe(input, selectedTask) {
209
+ input = structuredClone(input);
210
+ selectedTask = selectedTask ? structuredClone(selectedTask) : undefined;
211
+ if (input.initiativeId !== record.initiativeId)
212
+ return { status: "unavailable" };
213
+ const captured = revision;
214
+ await assertObservationCurrent();
215
+ const task = record.tasks.find((t) => t.taskId === input.taskId && t.taskRevision === input.taskRevision);
216
+ if (!task && !selectedTask && record.tasks.some((t) => t.taskId === input.taskId))
217
+ return { status: "unavailable" };
218
+ if (selectedTask &&
219
+ (!validInitiativeTask(selectedTask) ||
220
+ selectedTask.taskId !== input.taskId ||
221
+ selectedTask.taskRevision !== input.taskRevision ||
222
+ (task &&
223
+ (task.effectScope !== selectedTask.effectScope ||
224
+ !sameEffectTarget(task.effectTarget, selectedTask.effectTarget)))))
225
+ return { status: "unavailable" };
226
+ const { states, effects, receipts } = await observeAttempts(task);
227
+ const prior = record.tasks.filter((t) => t.taskId === input.taskId && t !== task);
228
+ const priorCurrent = await settled({ ...record, tasks: prior });
229
+ const target = task?.effectTarget ?? selectedTask?.effectTarget;
230
+ const observedEffect = effectObservation(target, task?.attempts.at(-1), states.at(-1), receipts.at(-1));
231
+ await assertObservationCurrent();
232
+ if (captured !== revision)
233
+ return { status: "unavailable" };
234
+ const unresolved = !priorCurrent ||
235
+ states.some((status, i) => status === "unknown" || (status !== "not-started" && !effects[i]));
236
+ return {
237
+ status: "observed",
238
+ ...input,
239
+ ownerGeneration: record.generation,
240
+ claim: unresolved
241
+ ? "uncertain"
242
+ : !task || (!request.recoveryOnly && task.generation !== record.generation && !states.includes("running"))
243
+ ? "unclaimed"
244
+ : !request.recoveryOnly && task.generation === record.generation
245
+ ? "owned"
246
+ : "other-owner",
247
+ execution: states.includes("unknown")
248
+ ? "unknown"
249
+ : states.includes("running")
250
+ ? "running"
251
+ : states.length
252
+ ? "settled"
253
+ : "none",
254
+ reconciliationRequired: unresolved,
255
+ ...(observedEffect ? { effectObservation: observedEffect } : {}),
256
+ async assertCurrent() {
257
+ await assertObservationCurrent();
258
+ const { states: currentStates, effects: currentEffects, receipts: currentReceipts, } = await observeAttempts(task);
259
+ const currentEffect = effectObservation(target, task?.attempts.at(-1), currentStates.at(-1), currentReceipts.at(-1));
260
+ const priorStillCurrent = await settled({ ...record, tasks: prior });
261
+ await assertObservationCurrent();
262
+ if (revision !== captured ||
263
+ priorStillCurrent !== priorCurrent ||
264
+ JSON.stringify(currentStates) !== JSON.stringify(states) ||
265
+ JSON.stringify(currentEffects) !== JSON.stringify(effects) ||
266
+ JSON.stringify(currentEffect) !== JSON.stringify(observedEffect))
267
+ throw Error("initiative observation changed");
268
+ },
269
+ };
270
+ },
271
+ /** Bind a final to the only admitted attempt for this exact selected task revision. */
272
+ async handoffAttempt(identity, selectedTask) {
273
+ if (request.recoveryOnly || identity.initiativeId !== record.initiativeId)
274
+ return;
275
+ const observation = await this.observe(identity, selectedTask);
276
+ if (observation.status !== "observed" ||
277
+ observation.execution !== "settled" ||
278
+ observation.reconciliationRequired)
279
+ return;
280
+ const attempts = taskAt(selectedTask)?.attempts.filter((attempt) => attempt.state !== "not-admitted");
281
+ // A task with several admitted operations needs an explicit output choice.
282
+ if (attempts?.length !== 1)
283
+ return;
284
+ await observation.assertCurrent();
285
+ return { attempt: structuredClone(attempts[0]), assertCurrent: observation.assertCurrent };
286
+ },
287
+ async pendingEffects() {
288
+ const captured = revision;
289
+ await assertCurrent();
290
+ const pending = [];
291
+ for (const task of record.tasks)
292
+ for (const attempt of task.attempts) {
293
+ if (task.effectScope === "local")
294
+ continue;
295
+ const execution = await options.resolveAttempt(structuredClone(attempt));
296
+ if (execution !== "not-started" && !(await effectCurrent(record.initiativeId, task, attempt, options)))
297
+ pending.push({
298
+ ...effectIdentity(record.initiativeId, task, attempt),
299
+ execution,
300
+ ...(task.effectTarget ? { effectTarget: structuredClone(task.effectTarget) } : {}),
301
+ });
302
+ }
303
+ await assertCurrent();
304
+ if (captured !== revision)
305
+ throw Error("initiative observation changed");
306
+ return pending;
307
+ },
308
+ reconcileEffect(input) {
309
+ input = structuredClone(input);
310
+ return change(async () => {
311
+ await assertCurrent();
312
+ const { task, attempt } = exactEffect(record, input);
313
+ if (!options.assertEffectReconciled)
314
+ throw Error("trusted receipt verifier unavailable");
315
+ if ((await options.resolveAttempt(structuredClone(attempt))) !== "settled")
316
+ throw Error("native attempt settlement required");
317
+ await options.assertEffectReconciled({
318
+ ...effectIdentity(record.initiativeId, task, attempt),
319
+ receipt: structuredClone(input.receipt),
320
+ });
321
+ await assertCurrent();
322
+ if ((await options.resolveAttempt(structuredClone(attempt))) !== "settled")
323
+ throw Error("native attempt settlement changed");
324
+ await options.assertEffectReconciled({
325
+ ...effectIdentity(record.initiativeId, task, attempt),
326
+ receipt: structuredClone(input.receipt),
327
+ });
328
+ await assertCurrent();
329
+ attempt.effectReceipt = structuredClone(input.receipt);
330
+ save();
331
+ const observed = effectObservation(task.effectTarget, attempt, "settled", input.receipt);
332
+ return {
333
+ reconciled: receiptResolves(task, input.receipt),
334
+ taskAccepted: false,
335
+ executionAuthorized: false,
336
+ ...(observed ? { effectObservation: observed } : {}),
337
+ };
338
+ });
339
+ },
340
+ release() {
341
+ return change(async () => {
342
+ await assertCurrent();
343
+ if (!(await settled(record)))
344
+ throw Error("initiative reconciliation required before release");
345
+ await assertCurrent();
346
+ record.state = "released";
347
+ save();
348
+ closed = true;
349
+ await lock.release();
350
+ });
351
+ },
352
+ /** Abandon only cooperative ownership; unresolved attempts remain durable and block takeover. */
353
+ async close() {
354
+ closed = true;
355
+ await lock.release();
356
+ },
357
+ };
358
+ }
359
+ catch (error) {
360
+ await lock.release();
361
+ throw error;
362
+ }
363
+ }
364
+ //# sourceMappingURL=initiative-coordinator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initiative-coordinator.js","sourceRoot":"","sources":["../../src/governance/initiative-coordinator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /** Bounded exact reconciliation helpers; receipt authority is supplied by the selected owner, not a model. */
2
+ import { type InitiativeEffectReceipt, type InitiativeEffectTarget, type InitiativeEffectObservation, type InitiativeTask, type InitiativeTaskRecord, type InitiativeAttempt, type InitiativeRecord, type InitiativeEffectIdentity, type InitiativeEffectReconciliation } from "../kernel/initiative.ts";
3
+ export interface InitiativeResolution {
4
+ resolveAttempt(attempt: InitiativeAttempt): Promise<"settled" | "not-started" | "running" | "unknown">;
5
+ assertEffectReconciled?(input: InitiativeEffectReconciliation): void | Promise<void>;
6
+ }
7
+ export declare function effectIdentity(initiativeId: string, task: InitiativeTaskRecord, attempt: InitiativeAttempt): InitiativeEffectIdentity;
8
+ export declare function currentEffectReceipt(initiativeId: string, task: InitiativeTaskRecord, attempt: InitiativeAttempt, options: InitiativeResolution): Promise<InitiativeEffectReceipt | undefined>;
9
+ export declare function receiptResolves(task: InitiativeTaskRecord, receipt?: InitiativeEffectReceipt): boolean;
10
+ export declare function effectCurrent(initiativeId: string, task: InitiativeTaskRecord, attempt: InitiativeAttempt, options: InitiativeResolution): Promise<boolean>;
11
+ /** Last exact attempt for the selected target; unknown evidence is never promoted to an applied effect. */
12
+ export declare function effectObservation(target: InitiativeEffectTarget | undefined, attempt: InitiativeAttempt | undefined, execution: "settled" | "not-started" | "running" | "unknown" | undefined, receipt?: InitiativeEffectReceipt): InitiativeEffectObservation | undefined;
13
+ export declare function settledInitiative(record: InitiativeRecord, options: InitiativeResolution): Promise<boolean>;
14
+ /** A changed task revision cannot silently repeat an already-applied exact target. */
15
+ export declare function assertTaskPriorSettled(record: InitiativeRecord, task: InitiativeTask, options: InitiativeResolution, exclude?: InitiativeAttempt): Promise<void>;
16
+ export declare function exactEffect(record: InitiativeRecord, input: InitiativeEffectReconciliation): {
17
+ task: InitiativeTaskRecord;
18
+ attempt: InitiativeAttempt;
19
+ };
20
+ //# sourceMappingURL=initiative-effects.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initiative-effects.d.ts","sourceRoot":"","sources":["../../src/governance/initiative-effects.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACpC,MAAM,yBAAyB,CAAC;AACjC,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;IACvG,sBAAsB,CAAC,CAAC,KAAK,EAAE,8BAA8B,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AACD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,iBAAiB,GACzB,wBAAwB,CAU1B;AACD,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAgB9C;AACD,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,uBAAuB,WAG5F;AACD,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,oBAAoB,oBAG9B;AACD,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,GAAG,SAAS,EAC1C,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,EACxE,OAAO,CAAC,EAAE,uBAAuB,GAChC,2BAA2B,GAAG,SAAS,CAmBzC;AACD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,oBAQ9F;AACD,sFAAsF;AACtF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,iBAAiB,iBAiB5B;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,8BAA8B;;;EAoB1F"}
@@ -0,0 +1,108 @@
1
+ /** Bounded exact reconciliation helpers; receipt authority is supplied by the selected owner, not a model. */
2
+ import { validEffectReceipt, sameEffectTarget, } from "../kernel/initiative.js";
3
+ export function effectIdentity(initiativeId, task, attempt) {
4
+ return {
5
+ initiativeId,
6
+ taskId: task.taskId,
7
+ taskRevision: task.taskRevision,
8
+ effectScope: task.effectScope,
9
+ owner: { ...attempt.owner },
10
+ operationId: attempt.operationId,
11
+ executionId: attempt.executionId,
12
+ };
13
+ }
14
+ export async function currentEffectReceipt(initiativeId, task, attempt, options) {
15
+ if (!attempt.effectReceipt || !options.assertEffectReconciled)
16
+ return undefined;
17
+ if (attempt.effectReceipt.observation &&
18
+ !sameEffectTarget(task.effectTarget, attempt.effectReceipt.observation.target))
19
+ return undefined;
20
+ try {
21
+ await options.assertEffectReconciled({
22
+ ...effectIdentity(initiativeId, task, attempt),
23
+ receipt: structuredClone(attempt.effectReceipt),
24
+ });
25
+ return structuredClone(attempt.effectReceipt);
26
+ }
27
+ catch {
28
+ return undefined;
29
+ }
30
+ }
31
+ export function receiptResolves(task, receipt) {
32
+ if (receipt?.observation?.outcome === "unknown")
33
+ return false;
34
+ return task.effectScope === "local" || (!!receipt && (!task.effectTarget || !!receipt.observation));
35
+ }
36
+ export async function effectCurrent(initiativeId, task, attempt, options) {
37
+ return receiptResolves(task, await currentEffectReceipt(initiativeId, task, attempt, options));
38
+ }
39
+ /** Last exact attempt for the selected target; unknown evidence is never promoted to an applied effect. */
40
+ export function effectObservation(target, attempt, execution, receipt) {
41
+ if (!target)
42
+ return undefined;
43
+ const identity = attempt
44
+ ? { owner: { ...attempt.owner }, operationId: attempt.operationId, executionId: attempt.executionId }
45
+ : undefined;
46
+ if (!attempt || execution === "not-started")
47
+ return {
48
+ target: structuredClone(target),
49
+ outcome: "pending",
50
+ provenance: "not-observed",
51
+ ...(identity ? { attempt: identity } : {}),
52
+ };
53
+ if (execution === "settled" && receipt?.observation && sameEffectTarget(target, receipt.observation.target))
54
+ return {
55
+ ...structuredClone(receipt.observation),
56
+ receipt: { reference: receipt.reference, sha256: receipt.sha256 },
57
+ attempt: identity,
58
+ };
59
+ return { target: structuredClone(target), outcome: "unknown", provenance: "not-observed", attempt: identity };
60
+ }
61
+ export async function settledInitiative(record, options) {
62
+ for (const task of record.tasks)
63
+ for (const attempt of task.attempts) {
64
+ const status = await options.resolveAttempt(structuredClone(attempt));
65
+ if (status === "not-started")
66
+ continue;
67
+ if (status !== "settled" || !(await effectCurrent(record.initiativeId, task, attempt, options)))
68
+ return false;
69
+ }
70
+ return true;
71
+ }
72
+ /** A changed task revision cannot silently repeat an already-applied exact target. */
73
+ export async function assertTaskPriorSettled(record, task, options, exclude) {
74
+ for (const previous of record.tasks.filter((t) => t.taskId === task.taskId))
75
+ for (const attempt of previous.attempts) {
76
+ if (attempt === exclude)
77
+ continue;
78
+ const status = await options.resolveAttempt(structuredClone(attempt));
79
+ if (status === "not-started")
80
+ continue;
81
+ if (status !== "settled")
82
+ throw Error("task already has unresolved attempts");
83
+ const receipt = await currentEffectReceipt(record.initiativeId, previous, attempt, options);
84
+ if (!receiptResolves(previous, receipt))
85
+ throw Error("task prior attempts need reconciliation before start");
86
+ if (task.effectTarget &&
87
+ sameEffectTarget(task.effectTarget, previous.effectTarget) &&
88
+ receipt?.observation?.outcome === "applied")
89
+ throw Error("exact task target is already applied; an amended task revision does not authorize repeating it");
90
+ }
91
+ }
92
+ export function exactEffect(record, input) {
93
+ if (input.initiativeId !== record.initiativeId || !validEffectReceipt(input.receipt))
94
+ throw Error("invalid effect receipt identity");
95
+ const task = record.tasks.find((t) => t.taskId === input.taskId && t.taskRevision === input.taskRevision && t.effectScope === input.effectScope);
96
+ const attempt = task?.attempts.find((a) => a.owner.sessionId === input.owner?.sessionId &&
97
+ a.owner.cwd === input.owner?.cwd &&
98
+ a.operationId === input.operationId &&
99
+ a.executionId === input.executionId);
100
+ if (!task || !attempt || task.effectScope === "local")
101
+ throw Error("effect attempt is outside the exact retained task");
102
+ if (input.receipt.observation && !sameEffectTarget(task.effectTarget, input.receipt.observation.target))
103
+ throw Error("effect observation target differs from selected task");
104
+ if (task.effectTarget && !input.receipt.observation)
105
+ throw Error("selected effect target requires an explicit outcome observation");
106
+ return { task, attempt };
107
+ }
108
+ //# sourceMappingURL=initiative-effects.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initiative-effects.js","sourceRoot":"","sources":["../../src/governance/initiative-effects.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { type InitiativeRecord } from "../kernel/initiative.ts";
2
+ export declare const initiativeRevision: (record: InitiativeRecord) => string;
3
+ export declare function initiativeLocation(directory: string, id: string, create?: boolean): {
4
+ root: string;
5
+ path: string;
6
+ };
7
+ export declare function validateInitiative(v: unknown, id: string): InitiativeRecord;
8
+ export declare function readInitiativeState(directory: string, id: string): {
9
+ record: InitiativeRecord;
10
+ revision: string;
11
+ } | null;
12
+ export declare function saveInitiative(path: string, root: string, record: InitiativeRecord): void;
13
+ //# sourceMappingURL=initiative-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initiative-state.d.ts","sourceRoot":"","sources":["../../src/governance/initiative-state.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAGjC,eAAO,MAAM,kBAAkB,GAAI,QAAQ,gBAAgB,KAAG,MAA8C,CAAC;AAC7G,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAQ;;;EAK/E;AACD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,CA6D3E;AACD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;;;SAiBhE;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,QA8BlF"}