@sema-agent/core 7.62.0 → 7.64.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 (320) hide show
  1. package/CHANGELOG.md +936 -0
  2. package/dist/agents/cc-peer-directory.js +1 -0
  3. package/dist/agents/cc-peer-wire.d.ts +4 -0
  4. package/dist/agents/cc-peer-wire.js +1 -0
  5. package/dist/agents/cc-uds-peer-channel.js +5 -0
  6. package/dist/agents/cross-session-judge.d.ts +3 -1
  7. package/dist/agents/cross-session-judge.js +4 -1
  8. package/dist/agents/peer-directory.d.ts +8 -0
  9. package/dist/agents/peer-directory.js +4 -0
  10. package/dist/agents/peer-held-queue.d.ts +9 -3
  11. package/dist/agents/peer-held-queue.js +12 -9
  12. package/dist/agents/peer-idle.d.ts +20 -1
  13. package/dist/agents/peer-idle.js +23 -12
  14. package/dist/agents/peer-notice-route.d.ts +16 -5
  15. package/dist/agents/peer-notice-route.js +11 -9
  16. package/dist/agents/peer-notices.d.ts +25 -8
  17. package/dist/agents/peer-notices.js +6 -1
  18. package/dist/agents/peer-session-drain.d.ts +32 -6
  19. package/dist/agents/peer-session-drain.js +100 -26
  20. package/dist/agents/send-message-tool.d.ts +7 -0
  21. package/dist/agents/send-message-tool.js +18 -6
  22. package/dist/agents/subagent-transcript-placement.d.ts +23 -0
  23. package/dist/agents/subagent-transcript-placement.js +14 -0
  24. package/dist/agents/subagent.js +102 -54
  25. package/dist/brain/route-adjudicator.js +9 -4
  26. package/dist/core/allow-entry.d.ts +4 -0
  27. package/dist/core/approval-object.js +1 -1
  28. package/dist/core/arg-summary.js +1 -1
  29. package/dist/core/ask-origin.d.ts +1 -1
  30. package/dist/core/ask-origin.js +2 -2
  31. package/dist/core/ask-question.d.ts +2 -2
  32. package/dist/core/ask-unresolvable-notice.d.ts +13 -4
  33. package/dist/core/ask-unresolvable-notice.js +10 -3
  34. package/dist/core/auto-compaction.d.ts +7 -5
  35. package/dist/core/background-agent-store.d.ts +7 -0
  36. package/dist/core/background-agent-store.js +3 -0
  37. package/dist/core/canonical-json.d.ts +23 -13
  38. package/dist/core/canonical-json.js +4 -4
  39. package/dist/core/checkpoint-queries.d.ts +50 -4
  40. package/dist/core/checkpoint-queries.js +42 -17
  41. package/dist/core/checkpoint-requirements.d.ts +3 -3
  42. package/dist/core/checkpoint-requirements.js +2 -1
  43. package/dist/core/checkpoint-row-verdict.d.ts +15 -4
  44. package/dist/core/checkpoint-row-verdict.js +22 -2
  45. package/dist/core/checkpoint-store.d.ts +28 -11
  46. package/dist/core/checkpoint-store.js +45 -4
  47. package/dist/core/compliance.d.ts +6 -2
  48. package/dist/core/compliance.js +3 -3
  49. package/dist/core/context-settings.d.ts +40 -9
  50. package/dist/core/context-settings.js +32 -10
  51. package/dist/core/engine-attestation.d.ts +27 -7
  52. package/dist/core/engine-attestation.js +5 -1
  53. package/dist/core/engine-notice.d.ts +43 -5
  54. package/dist/core/extension-requester.d.ts +9 -0
  55. package/dist/core/extension-requester.js +7 -0
  56. package/dist/core/file-history-store.d.ts +28 -0
  57. package/dist/core/file-history-store.js +48 -5
  58. package/dist/core/fs-write-gate-policy.js +1 -1
  59. package/dist/core/gate-fold.js +2 -0
  60. package/dist/core/gate-lanes.js +2 -0
  61. package/dist/core/gate-outcome.d.ts +39 -2
  62. package/dist/core/gate-outcome.js +20 -1
  63. package/dist/core/git-worktree-env.d.ts +62 -3
  64. package/dist/core/git-worktree-env.js +91 -30
  65. package/dist/core/governance-codes.d.ts +9 -3
  66. package/dist/core/governance-codes.js +17 -3
  67. package/dist/core/leg-identity.d.ts +19 -1
  68. package/dist/core/leg-identity.js +12 -0
  69. package/dist/core/mailbox-store.d.ts +39 -4
  70. package/dist/core/mailbox-store.js +14 -2
  71. package/dist/core/memory-engine/consolidation-driver.d.ts +32 -17
  72. package/dist/core/memory-engine/consolidation-driver.js +99 -98
  73. package/dist/core/memory-engine/consolidation.d.ts +74 -10
  74. package/dist/core/memory-engine/consolidation.js +183 -11
  75. package/dist/core/memory-engine/control-objects.d.ts +25 -0
  76. package/dist/core/memory-engine/control-objects.js +151 -0
  77. package/dist/core/memory-engine/control-plane-adoption.d.ts +48 -0
  78. package/dist/core/memory-engine/control-plane-adoption.js +159 -0
  79. package/dist/core/memory-engine/data-plane.d.ts +8 -4
  80. package/dist/core/memory-engine/data-plane.js +11 -6
  81. package/dist/core/memory-engine/delegation-settlement.d.ts +58 -40
  82. package/dist/core/memory-engine/delegation-settlement.js +270 -85
  83. package/dist/core/memory-engine/dual-root.d.ts +12 -6
  84. package/dist/core/memory-engine/dual-root.js +11 -7
  85. package/dist/core/memory-engine/engine.d.ts +136 -58
  86. package/dist/core/memory-engine/engine.js +491 -394
  87. package/dist/core/memory-engine/entry-scan.d.ts +8 -0
  88. package/dist/core/memory-engine/entry-scan.js +3 -0
  89. package/dist/core/memory-engine/file-backend.d.ts +62 -60
  90. package/dist/core/memory-engine/file-backend.js +122 -198
  91. package/dist/core/memory-engine/index.d.ts +8 -7
  92. package/dist/core/memory-engine/index.js +7 -6
  93. package/dist/core/memory-engine/landing-admission.d.ts +5 -3
  94. package/dist/core/memory-engine/landing-admission.js +3 -3
  95. package/dist/core/memory-engine/layout.d.ts +127 -46
  96. package/dist/core/memory-engine/layout.js +264 -109
  97. package/dist/core/memory-engine/memory-backend-contract.d.ts +26 -1
  98. package/dist/core/memory-engine/memory-backend-contract.js +476 -0
  99. package/dist/core/memory-engine/memory-deployment.d.ts +42 -11
  100. package/dist/core/memory-engine/memory-deployment.js +54 -15
  101. package/dist/core/memory-engine/origin-clearance.d.ts +12 -3
  102. package/dist/core/memory-engine/origin-clearance.js +68 -9
  103. package/dist/core/memory-engine/scope-contract.d.ts +52 -11
  104. package/dist/core/memory-engine/scope-contract.js +68 -19
  105. package/dist/core/memory-engine/session-write-home.d.ts +37 -2
  106. package/dist/core/memory-engine/session-write-home.js +38 -11
  107. package/dist/core/memory-engine/sync-client.d.ts +3 -1
  108. package/dist/core/memory-engine/sync-client.js +7 -0
  109. package/dist/core/memory-engine/sync-report.d.ts +3 -2
  110. package/dist/core/memory-engine/sync-report.js +6 -2
  111. package/dist/core/memory-engine/tools.d.ts +2 -2
  112. package/dist/core/memory-engine/tools.js +10 -10
  113. package/dist/core/memory-engine/types.d.ts +155 -19
  114. package/dist/core/memory-engine/types.js +2 -0
  115. package/dist/core/memory.js +15 -6
  116. package/dist/core/mode-policy.js +3 -3
  117. package/dist/core/mods/agent-stations.d.ts +18 -0
  118. package/dist/core/mods/agent-stations.js +8 -6
  119. package/dist/core/mods/extension-call.d.ts +4 -0
  120. package/dist/core/mods/extension-call.js +8 -0
  121. package/dist/core/mods/stations.d.ts +20 -1
  122. package/dist/core/mods/stations.js +21 -2
  123. package/dist/core/mods/tool-call.js +3 -4
  124. package/dist/core/parent-spec-seat.d.ts +2 -2
  125. package/dist/core/park-selfcheck.js +2 -2
  126. package/dist/core/pause-registry.d.ts +2 -0
  127. package/dist/core/pause-registry.js +3 -0
  128. package/dist/core/peer-channel.d.ts +5 -0
  129. package/dist/core/permission-rule-consent.d.ts +26 -8
  130. package/dist/core/permission-rule-consent.js +76 -36
  131. package/dist/core/permission-rule-store.d.ts +72 -13
  132. package/dist/core/permission-rule-store.js +29 -8
  133. package/dist/core/read-only-shell.js +3 -2
  134. package/dist/core/redaction-marks.d.ts +8 -0
  135. package/dist/core/redaction-marks.js +6 -0
  136. package/dist/core/refusal-echo.d.ts +20 -0
  137. package/dist/core/refusal-echo.js +33 -0
  138. package/dist/core/remote-env.d.ts +12 -1
  139. package/dist/core/remote-env.js +3 -0
  140. package/dist/core/retention.d.ts +180 -10
  141. package/dist/core/retention.js +45 -0
  142. package/dist/core/retired-keys.d.ts +5 -0
  143. package/dist/core/retired-keys.js +3 -0
  144. package/dist/core/rule-offer-read.d.ts +0 -4
  145. package/dist/core/rule-offer-read.js +2 -18
  146. package/dist/core/runner/child-tree.d.ts +29 -3
  147. package/dist/core/runner/child-tree.js +39 -16
  148. package/dist/core/runner/classifier-ladder.d.ts +7 -1
  149. package/dist/core/runner/classifier-ladder.js +4 -2
  150. package/dist/core/runner/compact-session.js +10 -7
  151. package/dist/core/runner/compaction-call-options.d.ts +7 -7
  152. package/dist/core/runner/compaction-call-options.js +3 -2
  153. package/dist/core/runner/contracts.d.ts +39 -11
  154. package/dist/core/runner/delegation-owner.d.ts +10 -3
  155. package/dist/core/runner/delegation-owner.js +4 -1
  156. package/dist/core/runner/gate-exit.d.ts +6 -0
  157. package/dist/core/runner/gate-exit.js +13 -4
  158. package/dist/core/runner/inherited-ask-grants.js +1 -1
  159. package/dist/core/runner/memory-consolidation-driver.d.ts +10 -5
  160. package/dist/core/runner/memory-consolidation-driver.js +12 -9
  161. package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
  162. package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
  163. package/dist/core/runner/person-path-rows.d.ts +8 -3
  164. package/dist/core/runner/person-path-rows.js +5 -1
  165. package/dist/core/runner/placement-fence.d.ts +12 -0
  166. package/dist/core/runner/placement-fence.js +20 -6
  167. package/dist/core/runner/prepare-ask-lane.js +5 -5
  168. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -2
  169. package/dist/core/runner/prepare-caps-and-workflow.js +7 -4
  170. package/dist/core/runner/prepare-config-doors.js +4 -0
  171. package/dist/core/runner/prepare-delegation-surface.d.ts +3 -0
  172. package/dist/core/runner/prepare-delegation-surface.js +2 -2
  173. package/dist/core/runner/prepare-execution-env.js +17 -6
  174. package/dist/core/runner/prepare-gate-stations.d.ts +5 -0
  175. package/dist/core/runner/prepare-gate-stations.js +5 -5
  176. package/dist/core/runner/prepare-hands-readface.d.ts +2 -1
  177. package/dist/core/runner/prepare-hands-readface.js +5 -4
  178. package/dist/core/runner/prepare-inherited-gate.d.ts +13 -9
  179. package/dist/core/runner/prepare-inherited-gate.js +12 -6
  180. package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
  181. package/dist/core/runner/prepare-memory-engine-session.js +4 -4
  182. package/dist/core/runner/prepare-memory.d.ts +7 -2
  183. package/dist/core/runner/prepare-memory.js +41 -39
  184. package/dist/core/runner/prepare-park-ask.js +4 -3
  185. package/dist/core/runner/prepare-policy-chain.js +7 -7
  186. package/dist/core/runner/prepare-prompt-inputs.js +1 -1
  187. package/dist/core/runner/prepare-task.js +26 -18
  188. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -1
  189. package/dist/core/runner/prepare-wiring-manifest.js +3 -2
  190. package/dist/core/runner/prepare-workspace-restore.js +3 -6
  191. package/dist/core/runner/resume-admission.d.ts +2 -2
  192. package/dist/core/runner/resume-admission.js +2 -23
  193. package/dist/core/runner/role-resolution-table.d.ts +98 -0
  194. package/dist/core/runner/role-resolution-table.js +62 -0
  195. package/dist/core/runner/run-compaction-machinery.js +2 -2
  196. package/dist/core/runner/run-identity-wiring.js +12 -9
  197. package/dist/core/runner/run-leg.js +9 -5
  198. package/dist/core/runner/run-notification-lane.js +22 -22
  199. package/dist/core/runner/run-recovery-lanes.js +3 -3
  200. package/dist/core/runner/run-settle-and-teardown.js +3 -2
  201. package/dist/core/runner/run-terminal-adoption.js +1 -1
  202. package/dist/core/runner/run-turn-boundary.js +14 -15
  203. package/dist/core/runner/runtask.js +1 -1
  204. package/dist/core/runner/terminal-account.js +1 -1
  205. package/dist/core/runner/tool-occurrence.d.ts +4 -2
  206. package/dist/core/runner/tool-occurrence.js +2 -2
  207. package/dist/core/runner-deps.d.ts +7 -3
  208. package/dist/core/secret-env.d.ts +1 -1
  209. package/dist/core/secret-env.js +4 -4
  210. package/dist/core/session-checkout.d.ts +168 -0
  211. package/dist/core/session-checkout.js +579 -0
  212. package/dist/core/session-store.d.ts +12 -4
  213. package/dist/core/session-store.js +23 -3
  214. package/dist/core/session.d.ts +16 -2
  215. package/dist/core/session.js +3 -0
  216. package/dist/core/shell-read-silence.js +8 -0
  217. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +0 -12
  218. package/dist/core/store-contracts/checkpoint-store-contract.js +6 -7
  219. package/dist/core/store-contracts/peer-directory-contract.js +8 -1
  220. package/dist/core/store-contracts/session-store-contract.js +39 -0
  221. package/dist/core/task-event.d.ts +30 -5
  222. package/dist/core/task-notification.d.ts +119 -32
  223. package/dist/core/task-notification.js +186 -100
  224. package/dist/core/task-registry-agent.d.ts +25 -2
  225. package/dist/core/task-registry-agent.js +56 -22
  226. package/dist/core/task-registry-shared.d.ts +33 -11
  227. package/dist/core/task-registry.d.ts +33 -9
  228. package/dist/core/task-registry.js +36 -18
  229. package/dist/core/task-spec-members.js +1 -1
  230. package/dist/core/task-spec.d.ts +27 -2
  231. package/dist/core/tool-errors.d.ts +14 -6
  232. package/dist/core/tool-errors.js +1 -1
  233. package/dist/core/tool-policy.d.ts +32 -13
  234. package/dist/core/tool-policy.js +27 -17
  235. package/dist/core/tool-result-store.d.ts +20 -0
  236. package/dist/core/tool-spec.d.ts +42 -19
  237. package/dist/core/trace.d.ts +3 -2
  238. package/dist/core/types.d.ts +1 -1
  239. package/dist/core/untrusted-egress.d.ts +15 -4
  240. package/dist/core/untrusted-egress.js +23 -22
  241. package/dist/core/workflow-journal-store.d.ts +11 -0
  242. package/dist/core/workflow-journal-store.js +7 -0
  243. package/dist/core/workflow-run-store.d.ts +9 -0
  244. package/dist/core/workflow-run-store.js +6 -0
  245. package/dist/core/workspace-snapshot.d.ts +3 -1
  246. package/dist/core/workspace-snapshot.js +1 -0
  247. package/dist/engine/compaction/compaction.d.ts +2 -1
  248. package/dist/engine/harness/types.d.ts +67 -1
  249. package/dist/engine/harness/types.js +108 -0
  250. package/dist/engine/session/import-validate.js +6 -1
  251. package/dist/engine/session/session.d.ts +30 -1
  252. package/dist/engine/session/session.js +48 -1
  253. package/dist/index.d.ts +12 -7
  254. package/dist/index.js +12 -7
  255. package/dist/internal/harness-types.d.ts +1 -1
  256. package/dist/orchestration/run-workflow-tool.d.ts +8 -1
  257. package/dist/orchestration/run-workflow-tool.js +8 -0
  258. package/dist/orchestration/workflow-types.d.ts +2 -1
  259. package/dist/orchestration/workflow.d.ts +6 -0
  260. package/dist/orchestration/workflow.js +5 -2
  261. package/dist/stores/file/checkpoint-store.d.ts +6 -0
  262. package/dist/stores/file/checkpoint-store.js +4 -1
  263. package/dist/stores/file/file-history-store.d.ts +13 -0
  264. package/dist/stores/file/file-history-store.js +75 -13
  265. package/dist/stores/file/index.d.ts +11 -1
  266. package/dist/stores/file/index.js +7 -11
  267. package/dist/stores/file/permission-rule-store.d.ts +23 -0
  268. package/dist/stores/file/permission-rule-store.js +75 -7
  269. package/dist/stores/file/session-store.js +2 -1
  270. package/dist/stores/file/tool-result-store.d.ts +14 -0
  271. package/dist/stores/file/tool-result-store.js +39 -2
  272. package/dist/stores/file/workflow-journal-store.d.ts +4 -0
  273. package/dist/stores/file/workflow-journal-store.js +17 -0
  274. package/dist/stores/file/workflow-run-store.d.ts +3 -0
  275. package/dist/stores/file/workflow-run-store.js +15 -0
  276. package/dist/tools/fs/bash-program-position.js +3 -3
  277. package/dist/tools/fs/program-read-model.d.ts +34 -10
  278. package/dist/tools/fs/program-read-model.js +37 -7
  279. package/dist/tools/fs/program-read-model.rows.js +13 -2
  280. package/dist/tools/fs/read-deny.d.ts +28 -3
  281. package/dist/tools/fs/read-deny.js +18 -2
  282. package/dist/tools/fs/removal-targets.js +3 -3
  283. package/dist/tools/fs/safety.d.ts +2 -0
  284. package/dist/tools/fs/safety.js +1 -1
  285. package/dist/tools/fs/shell-read-argv.d.ts +8 -1
  286. package/dist/tools/fs/shell-read-argv.js +34 -29
  287. package/dist/tools/fs/shell-read-bindings.d.ts +2 -0
  288. package/dist/tools/fs/shell-read-bindings.js +5 -1
  289. package/dist/tools/fs/shell-read-brace.d.ts +18 -0
  290. package/dist/tools/fs/shell-read-brace.js +79 -0
  291. package/dist/tools/fs/shell-read-check.d.ts +8 -2
  292. package/dist/tools/fs/shell-read-check.js +16 -14
  293. package/dist/tools/fs/shell-read-establish.js +23 -16
  294. package/dist/tools/fs/shell-read-judge.d.ts +11 -0
  295. package/dist/tools/fs/shell-read-judge.js +3 -3
  296. package/dist/tools/fs/shell-read-plan.d.ts +10 -0
  297. package/dist/tools/fs/shell-read-plan.js +189 -93
  298. package/dist/tools/fs/shell-read-start.d.ts +19 -9
  299. package/dist/tools/fs/shell-read-start.js +20 -12
  300. package/dist/tools/fs/shell-read-word.d.ts +10 -0
  301. package/dist/tools/fs/shell-read-word.js +9 -5
  302. package/dist/tools/fs/shell-read-workdir.d.ts +26 -7
  303. package/dist/tools/fs/shell-read-workdir.js +73 -12
  304. package/dist/tools/fs/shell-read-write-targets.js +13 -8
  305. package/dist/tools/worktree.d.ts +3 -2
  306. package/dist/tools/worktree.js +7 -35
  307. package/package.json +3 -2
  308. package/test/export-surface.snapshot.json +135 -11
  309. package/wire-changes/core-stores-sql@7.63.0.json +30 -0
  310. package/wire-changes/core-stores-sql@7.64.0.json +30 -0
  311. package/wire-changes/core@7.63.0.json +3523 -0
  312. package/wire-changes/core@7.64.0.json +2653 -0
  313. package/wire-changes/mods-kernel@7.63.0.json +30 -0
  314. package/wire-changes/mods-kernel@7.64.0.json +30 -0
  315. package/wire-changes/primitives@7.63.0.json +445 -0
  316. package/wire-changes/primitives@7.64.0.json +30 -0
  317. package/dist/core/credential-vocabulary.d.ts +0 -176
  318. package/dist/core/credential-vocabulary.js +0 -190
  319. package/dist/core/redaction-passes.d.ts +0 -82
  320. package/dist/core/redaction-passes.js +0 -377
@@ -1,9 +1,9 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { closeSync, existsSync, fsyncSync, linkSync, lstatSync, openSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
3
3
  import { basename, dirname, join } from "node:path";
4
- import { QUARANTINE_DIR, appendChallengeEvents, claimStaging, enqueueMemoryAnnouncement, ensureDirExists, isSameFile, mintStagingName, stagingNamePattern, v1MemoryPathKeyResolver, lineageContributionsOfSession, lockedStrictUpdate, markSessionPolluted, readProjectionDebts, readSessionPollution, readStrictSidecar, ControlPlaneCorruptError } from "./layout.js";
4
+ import { QUARANTINE_DIR, appendChallengeEvents, claimStaging, ensureDirExists, fileGovernanceDocOf, isSameFile, lockedStrictUpdate, mintStagingName, readStrictSidecar, stagingNamePattern, v1MemoryPathKeyResolver, lineageContributionsOfSession, markSessionPolluted, readProjectionDebts, readSessionPollution, ControlPlaneCorruptError } from "./layout.js";
5
5
  import { thrownText } from "../thrown-value.js";
6
- export const DELEGATION_SETTLEMENT_FILE = "delegation-settlement.json";
6
+ import { fileControlObjectDirOf } from "./control-objects.js";
7
7
  function reqStr(v) {
8
8
  return typeof v === "string" && v.length > 0;
9
9
  }
@@ -48,33 +48,33 @@ function coerceSettlement(raw) {
48
48
  export function syncSettleId(sessionId, toolCallId) {
49
49
  return `sync:${encodeURIComponent(sessionId)}:${encodeURIComponent(toolCallId)}`;
50
50
  }
51
- export function registerDelegationLaunch(controlDir, input) {
52
- lockedStrictUpdate(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger", coerceSettlement, (rec) => {
51
+ export async function registerDelegationLaunch(docs, input) {
52
+ await docs.updateDoc("settlements", coerceSettlement, (rec) => {
53
53
  if (rec.rows.some((r) => r.settleId === input.settleId))
54
54
  return { result: undefined };
55
55
  rec.rows.push({ settleId: input.settleId, sessionId: input.sessionId, launchedAt: input.now(), lane: "background", status: "pending", ...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}) });
56
56
  return { next: rec, result: undefined };
57
57
  });
58
58
  }
59
- export function recordSyncUnattestable(controlDir, input) {
59
+ export async function recordSyncUnattestable(docs, input) {
60
60
  const settleId = syncSettleId(input.sessionId, input.toolCallId);
61
- lockedStrictUpdate(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger", coerceSettlement, (rec) => {
61
+ await docs.updateDoc("settlements", coerceSettlement, (rec) => {
62
62
  if (rec.rows.some((r) => r.settleId === settleId))
63
63
  return { result: undefined };
64
64
  rec.rows.push({ settleId, sessionId: input.sessionId, launchedAt: input.now(), lane: "sync", status: "unattestable" });
65
65
  return { next: rec, result: undefined };
66
66
  });
67
67
  }
68
- export function settleDelegation(controlDir, input) {
68
+ export async function settleDelegation(docs, input) {
69
69
  const eventId = input.eventId ?? `settle:${input.settleId}:${input.status}`;
70
- lockedStrictUpdate(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger", coerceSettlement, (rec) => {
70
+ await docs.updateDoc("settlements", coerceSettlement, (rec) => {
71
71
  if (rec.events.some((e) => e.eventId === eventId))
72
72
  return { result: undefined };
73
73
  rec.events.push({ settleId: input.settleId, eventId, at: input.now(), kind: "settle", status: input.status, ...(input.note !== undefined ? { note: input.note } : {}) });
74
74
  return { next: rec, result: undefined };
75
75
  });
76
76
  }
77
- export function resolveSettlementRecord(controlDir, input) {
77
+ export async function resolveSettlementRecord(docs, input) {
78
78
  if (typeof input.requestId !== "string" || input.requestId.length === 0) {
79
79
  const e = new Error("resolveSettlement requires a non-empty requestId (the audit attribution of who resolved) — refused, never defaulted.");
80
80
  e.code = "memory.settlement_resolve_unattributed";
@@ -86,7 +86,7 @@ export function resolveSettlementRecord(controlDir, input) {
86
86
  throw e;
87
87
  }
88
88
  const eventId = `admin:${input.requestId}:${input.settleId}:${input.to}`;
89
- lockedStrictUpdate(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger", coerceSettlement, (rec) => {
89
+ await docs.updateDoc("settlements", coerceSettlement, (rec) => {
90
90
  if (!rec.rows.some((r) => r.settleId === input.settleId)) {
91
91
  const e = new Error(`resolveSettlement: unknown settleId ${JSON.stringify(input.settleId)}`);
92
92
  e.code = "memory.settlement_resolve_unknown";
@@ -143,8 +143,8 @@ function foldOne(row, events) {
143
143
  }
144
144
  return { row, effective, everExternal, ...(terminalEventId !== undefined ? { terminalEventId } : {}) };
145
145
  }
146
- export function effectiveSettlements(controlDir) {
147
- const rec = coerceSettlement(readStrictSidecar(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger"));
146
+ export async function effectiveSettlements(docs) {
147
+ const rec = coerceSettlement(await docs.readDoc("settlements"));
148
148
  const bySettle = new Map();
149
149
  for (const e of rec.events) {
150
150
  const arr = bySettle.get(e.settleId);
@@ -155,8 +155,8 @@ export function effectiveSettlements(controlDir) {
155
155
  }
156
156
  return rec.rows.map((row) => foldOne(row, bySettle.get(row.settleId) ?? []));
157
157
  }
158
- export function sessionSettlements(controlDir, sessionId) {
159
- return effectiveSettlements(controlDir).filter((s) => s.row.sessionId === sessionId);
158
+ export async function sessionSettlements(docs, sessionId) {
159
+ return (await effectiveSettlements(docs)).filter((s) => s.row.sessionId === sessionId);
160
160
  }
161
161
  export function classifySessionSettlements(rows) {
162
162
  let sawPending = false;
@@ -184,18 +184,18 @@ export function classifySessionSettlements(rows) {
184
184
  return { state: "pending" };
185
185
  return { state: "clean" };
186
186
  }
187
- export function expireOverdueSettlements(controlDir, input) {
188
- const overdue = effectiveSettlements(controlDir).filter((s) => s.effective === "pending" && input.now() - s.row.launchedAt > input.timeoutMs);
187
+ export async function expireOverdueSettlements(docs, input) {
188
+ const overdue = (await effectiveSettlements(docs)).filter((s) => s.effective === "pending" && input.now() - s.row.launchedAt > input.timeoutMs);
189
189
  for (const s of overdue)
190
- settleDelegation(controlDir, { settleId: s.row.settleId, status: "expired", now: input.now });
190
+ await settleDelegation(docs, { settleId: s.row.settleId, status: "expired", now: input.now });
191
191
  return overdue.map((s) => s.row.settleId);
192
192
  }
193
- export function replayExternalSettlementEffects(controlDir, input) {
193
+ export async function replayExternalSettlementEffects(docs, controlDir, input) {
194
194
  const applied = [];
195
- const folded = effectiveSettlements(controlDir).filter((s) => s.effective === "external" && s.terminalEventId !== undefined);
195
+ const folded = (await effectiveSettlements(docs)).filter((s) => s.effective === "external" && s.terminalEventId !== undefined);
196
196
  if (folded.length === 0)
197
197
  return applied;
198
- const rec = coerceSettlement(readStrictSidecar(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger"));
198
+ const rec = coerceSettlement(await docs.readDoc("settlements"));
199
199
  for (const s of folded) {
200
200
  if (rec.effects[s.row.settleId] === s.terminalEventId)
201
201
  continue;
@@ -204,9 +204,9 @@ export function replayExternalSettlementEffects(controlDir, input) {
204
204
  if (outcome === "unpersisted")
205
205
  continue;
206
206
  try {
207
- const swept = lineageContributionsOfSession(controlDir, sessionId);
207
+ const swept = await lineageContributionsOfSession(docs, sessionId);
208
208
  const contributions = input.carry ? swept.filter((c) => c.marked !== true) : swept;
209
- appendChallengeEvents(controlDir, contributions.map((c) => ({
209
+ await appendChallengeEvents(docs, contributions.map((c) => ({
210
210
  eventId: `settlement:${s.row.settleId}:${s.terminalEventId}:${c.entryId}`,
211
211
  entryId: c.entryId,
212
212
  reason: "challenged: the contributing session's delegation settled external",
@@ -217,7 +217,7 @@ export function replayExternalSettlementEffects(controlDir, input) {
217
217
  continue;
218
218
  }
219
219
  console.warn(`[sema] delegation settlement: a background delegation of session ${JSON.stringify(sessionId)} settled EXTERNAL after launch — the session is marked and its unmarked committed contributions are challenged`);
220
- lockedStrictUpdate(controlDir, DELEGATION_SETTLEMENT_FILE, "memory delegation-settlement ledger", coerceSettlement, (r) => {
220
+ await docs.updateDoc("settlements", coerceSettlement, (r) => {
221
221
  r.effects[s.row.settleId] = s.terminalEventId;
222
222
  return { next: r, result: undefined };
223
223
  });
@@ -225,7 +225,6 @@ export function replayExternalSettlementEffects(controlDir, input) {
225
225
  }
226
226
  return applied;
227
227
  }
228
- export const SESSION_ACCOUNTS_FILE = "session-accounts.json";
229
228
  function malformedAccountRow(row) {
230
229
  return (typeof row !== "object" ||
231
230
  row === null ||
@@ -301,30 +300,36 @@ function convertSessionAccounts(read, controlDir) {
301
300
  export function convertV1SidecarKeys(controlDir) {
302
301
  readProjectionDebts(controlDir);
303
302
  readHolds(controlDir);
304
- readSessionAccountsConverted(controlDir);
303
+ const accounts = fileGovernanceDocOf("session-accounts");
304
+ if (coerceSessionAccounts(readStrictSidecar(controlDir, accounts.file, accounts.what)).version !== 2) {
305
+ lockedStrictUpdate(controlDir, accounts.file, accounts.what, coerceSessionAccounts, (again) => {
306
+ const { rec, converted } = convertSessionAccounts(again, controlDir);
307
+ return converted ? { next: rec, result: undefined } : { result: undefined };
308
+ });
309
+ }
305
310
  }
306
- function readSessionAccountsConverted(controlDir) {
307
- const read = coerceSessionAccounts(readStrictSidecar(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger"));
311
+ async function readSessionAccountsConverted(docs, controlDir) {
312
+ const read = coerceSessionAccounts(await docs.readDoc("session-accounts"));
308
313
  if (read.version === 2)
309
314
  return read;
310
- return lockedStrictUpdate(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger", coerceSessionAccounts, (again) => {
315
+ return docs.updateDoc("session-accounts", coerceSessionAccounts, (again) => {
311
316
  const { rec, converted } = convertSessionAccounts(again, controlDir);
312
317
  return converted ? { next: rec, result: rec } : { result: rec };
313
318
  });
314
319
  }
315
- export function foreignDanglingSessionAccounts(controlDir, selfSessionId) {
316
- const rec = readSessionAccountsConverted(controlDir);
320
+ export async function foreignDanglingSessionAccounts(docs, controlDir, selfSessionId) {
321
+ const rec = await readSessionAccountsConverted(docs, controlDir);
317
322
  return rec.rows.filter((r) => r.sessionId !== selfSessionId && (r.closedAt === undefined || r.unadjudicated === true));
318
323
  }
319
- export function openLayerWriters(controlDir, selfLeg) {
320
- const open = readSessionAccountsConverted(controlDir).rows.filter((r) => (selfLeg === undefined || r.leg !== selfLeg) && (r.writeScope !== undefined ? r.terminatedAt === undefined : r.closedAt === undefined));
324
+ export async function openLayerWriters(docs, controlDir, selfLeg) {
325
+ const open = (await readSessionAccountsConverted(docs, controlDir)).rows.filter((r) => (selfLeg === undefined || r.leg !== selfLeg) && (r.writeScope !== undefined ? r.terminatedAt === undefined : r.closedAt === undefined));
321
326
  return { scopes: new Set(open.flatMap((r) => (r.writeScope !== undefined ? [r.writeScope] : []))), unscoped: open.filter((r) => r.writeScope === undefined).length };
322
327
  }
323
- export function sessionAccountLeg(controlDir, sessionId) {
324
- return readSessionAccountsConverted(controlDir).rows.find((r) => r.sessionId === sessionId)?.leg;
328
+ export async function sessionAccountLeg(docs, controlDir, sessionId) {
329
+ return (await readSessionAccountsConverted(docs, controlDir)).rows.find((r) => r.sessionId === sessionId)?.leg;
325
330
  }
326
- export function sessionAccountWriteHome(controlDir, sessionId) {
327
- const read = coerceSessionAccounts(readStrictSidecar(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger"));
331
+ export async function sessionAccountWriteHome(docs, sessionId) {
332
+ const read = coerceSessionAccounts(await docs.readDoc("session-accounts"));
328
333
  if (read.version !== 2)
329
334
  return undefined;
330
335
  const row = read.rows.find((r) => r.sessionId === sessionId);
@@ -336,8 +341,8 @@ export function emptyUnattributedSet() {
336
341
  function memberKey(scope, rel) {
337
342
  return JSON.stringify([scope, rel]);
338
343
  }
339
- export function openSessionAccount(controlDir, input) {
340
- lockedStrictUpdate(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger", coerceSessionAccounts, (read) => {
344
+ export async function openSessionAccount(docs, controlDir, input) {
345
+ await docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
341
346
  const { rec } = convertSessionAccounts(read, controlDir);
342
347
  const row = rec.rows.find((r) => r.sessionId === input.sessionId);
343
348
  if (row !== undefined && input.writeScope !== undefined)
@@ -369,16 +374,16 @@ export function openSessionAccount(controlDir, input) {
369
374
  return { next: rec, result: undefined };
370
375
  });
371
376
  }
372
- export function sessionUnattributedSet(controlDir, sessionId) {
373
- const row = readSessionAccountsConverted(controlDir).rows.find((r) => r.sessionId === sessionId);
377
+ export async function sessionUnattributedSet(docs, controlDir, sessionId) {
378
+ const row = (await readSessionAccountsConverted(docs, controlDir)).rows.find((r) => r.sessionId === sessionId);
374
379
  if (row === undefined)
375
380
  return emptyUnattributedSet();
376
381
  const all = (row.unattributable?.length ?? 0) > 0;
377
382
  const keys = new Set(row.unattributed.map((m) => memberKey(m.scope, m.rel)));
378
383
  return { has: (scope, rel) => all || keys.has(memberKey(scope, rel.split("\\").join("/"))), empty: !all && keys.size === 0 };
379
384
  }
380
- export function closeSessionAccount(controlDir, input) {
381
- return lockedStrictUpdate(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger", coerceSessionAccounts, (read) => {
385
+ export async function closeSessionAccount(docs, controlDir, input) {
386
+ return docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
382
387
  const { rec } = convertSessionAccounts(read, controlDir);
383
388
  const row = rec.rows.find((r) => r.sessionId === input.sessionId);
384
389
  if (row === undefined)
@@ -392,8 +397,8 @@ export function closeSessionAccount(controlDir, input) {
392
397
  return { next: rec, result: "written" };
393
398
  });
394
399
  }
395
- export function terminateSessionAccount(controlDir, input) {
396
- return lockedStrictUpdate(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger", coerceSessionAccounts, (read) => {
400
+ export async function terminateSessionAccount(docs, controlDir, input) {
401
+ return docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
397
402
  const { rec } = convertSessionAccounts(read, controlDir);
398
403
  const row = rec.rows.find((r) => r.sessionId === input.sessionId);
399
404
  if (row === undefined)
@@ -404,13 +409,13 @@ export function terminateSessionAccount(controlDir, input) {
404
409
  return { next: rec, result: "written" };
405
410
  });
406
411
  }
407
- export function resolveSessionAccountRecord(controlDir, input) {
412
+ export async function resolveSessionAccountRecord(docs, controlDir, input) {
408
413
  if (typeof input.requestId !== "string" || input.requestId.length === 0) {
409
414
  const e = new Error("resolveSessionAccount requires a non-empty requestId (the audit attribution of who closed) — refused, never defaulted.");
410
415
  e.code = "memory.session_account_resolve_unattributed";
411
416
  throw e;
412
417
  }
413
- lockedStrictUpdate(controlDir, SESSION_ACCOUNTS_FILE, "memory session-account ledger", coerceSessionAccounts, (read) => {
418
+ await docs.updateDoc("session-accounts", coerceSessionAccounts, (read) => {
414
419
  const { rec } = convertSessionAccounts(read, controlDir);
415
420
  const row = rec.rows.find((r) => r.sessionId === input.sessionId);
416
421
  if (row === undefined) {
@@ -424,8 +429,9 @@ export function resolveSessionAccountRecord(controlDir, input) {
424
429
  return { next: rec, result: undefined };
425
430
  });
426
431
  }
427
- export const HOLDS_FILE = "holds.json";
428
- export const HOLD_DIR = "hold";
432
+ export const HOLDS_FILE = fileGovernanceDocOf("holds").file;
433
+ const HOLDS_WHAT = fileGovernanceDocOf("holds").what;
434
+ export const HOLD_DIR = fileControlObjectDirOf("hold");
429
435
  const HOLD_STATUSES = new Set(["capturing", "held", "released", "disposed"]);
430
436
  const HOLD_TERMINALS = new Set(["dirty", "expired", "conflict", "discarded", "capture_lost"]);
431
437
  function coerceHolds(raw) {
@@ -479,10 +485,10 @@ function holdsOnDiskAreV1(raw) {
479
485
  return typeof raw === "object" && raw !== null && raw.version === 1;
480
486
  }
481
487
  export function readHolds(controlDir) {
482
- const raw = readStrictSidecar(controlDir, HOLDS_FILE, "memory instruction-hold ledger");
488
+ const raw = readStrictSidecar(controlDir, HOLDS_FILE, HOLDS_WHAT);
483
489
  if (!holdsOnDiskAreV1(raw))
484
490
  return coerceHolds(raw).rows;
485
- return lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (again) => ({ next: again, result: again.rows }));
491
+ return lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (again) => ({ next: again, result: again.rows }));
486
492
  }
487
493
  function sha256(buf) {
488
494
  return createHash("sha256").update(buf).digest("hex");
@@ -571,14 +577,14 @@ export function openInstructionHold(controlDir, input) {
571
577
  const refuse = (rawReason, terminal) => {
572
578
  const reason = thirdWriterStrandedAt === undefined ? rawReason : `${rawReason}; a concurrent writer's bytes are preserved at ${thirdWriterStrandedAt}`;
573
579
  try {
574
- disposeHold(controlDir, { holdId, terminal, now: input.now });
580
+ disposeHold(controlDir, { holdId, terminal });
575
581
  }
576
582
  catch {
577
583
  }
578
584
  return { ok: false, holdId, reason };
579
585
  };
580
586
  try {
581
- lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
587
+ lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
582
588
  if (rec.rows.some((r) => r.holdId === holdId))
583
589
  return { result: undefined };
584
590
  rec.rows.push({
@@ -640,7 +646,7 @@ export function openInstructionHold(controlDir, input) {
640
646
  }
641
647
  }
642
648
  try {
643
- lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
649
+ lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
644
650
  const row = rec.rows.find((r) => r.holdId === holdId);
645
651
  if (row === undefined || row.status !== "capturing")
646
652
  return { result: undefined };
@@ -656,17 +662,7 @@ export function openInstructionHold(controlDir, input) {
656
662
  export function reconcileHolds(controlDir, input) {
657
663
  const holdDir = join(controlDir, HOLD_DIR);
658
664
  const discloseStranded = (holdId, scope, rel, at) => {
659
- try {
660
- enqueueMemoryAnnouncement(controlDir, {
661
- kind: "gate",
662
- scope,
663
- at: input.now(),
664
- items: [`instruction hold ${holdId}: a concurrent writer's bytes for ${JSON.stringify(rel)} could not be restored onto the plane — they are preserved at ${at} for host recovery`],
665
- });
666
- }
667
- catch {
668
- console.warn(`[sema] instruction hold ${holdId}: concurrent-writer bytes preserved at ${at} could not be restored or announced`);
669
- }
665
+ input.onStranded(scope, `instruction hold ${holdId}: a concurrent writer's bytes for ${JSON.stringify(rel)} could not be restored onto the plane — they are preserved at ${at} for host recovery`);
670
666
  };
671
667
  const finishRemoval = (row, plane) => {
672
668
  const stagingName = mintStagingName(row.holdId, input.now);
@@ -733,7 +729,8 @@ export function reconcileHolds(controlDir, input) {
733
729
  discloseStranded(row.holdId, row.scope, row.rel, retired.at);
734
730
  }
735
731
  };
736
- const rows = readHolds(controlDir).filter((r) => r.status === "capturing");
732
+ const ledger = readHolds(controlDir);
733
+ const rows = ledger.filter((r) => r.status === "capturing");
737
734
  for (const row of rows) {
738
735
  const custody = join(holdDir, row.captureName);
739
736
  let custodyBytes;
@@ -789,7 +786,7 @@ export function reconcileHolds(controlDir, input) {
789
786
  terminalLost = true;
790
787
  }
791
788
  }
792
- lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
789
+ lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
793
790
  const r = rec.rows.find((x) => x.holdId === row.holdId);
794
791
  if (r === undefined || r.status !== "capturing")
795
792
  return { result: undefined };
@@ -803,36 +800,224 @@ export function reconcileHolds(controlDir, input) {
803
800
  return { next: rec, result: undefined };
804
801
  });
805
802
  }
803
+ let custodyNames;
804
+ try {
805
+ custodyNames = new Set(readdirSync(holdDir));
806
+ }
807
+ catch {
808
+ custodyNames = new Set();
809
+ }
810
+ for (const row of ledger) {
811
+ const quarantineName = row.disposition?.quarantineName;
812
+ if (row.status !== "disposed" || quarantineName === undefined || !custodyNames.has(row.captureName))
813
+ continue;
814
+ try {
815
+ const moved = moveCustodyToSeat(controlDir, row, quarantineName);
816
+ if (moved.at === "custody") {
817
+ input.onStranded(row.scope, `instruction hold ${row.holdId} (disposed, ${row.disposition.terminal}): its custody bytes could not be moved to the quarantine seat ${quarantineName} (${moved.code}) — they stay at ${join(holdDir, row.captureName)} for host recovery, and the move is retried at every harvest`);
818
+ }
819
+ }
820
+ catch (err) {
821
+ input.onStranded(row.scope, `instruction hold ${row.holdId} (disposed, ${row.disposition.terminal}): ${thrownText(err)}`);
822
+ }
823
+ }
824
+ adoptOrphanedQuarantineBytes(controlDir, ledger);
806
825
  }
807
- export function disposeHold(controlDir, input) {
808
- const rows = readHolds(controlDir);
809
- const row = rows.find((r) => r.holdId === input.holdId);
810
- if (row === undefined || row.status === "disposed" || row.status === "released")
811
- return { ok: false };
826
+ function adoptOrphanedQuarantineBytes(controlDir, snapshot) {
827
+ const holdDir = join(controlDir, HOLD_DIR);
828
+ const qDir = join(controlDir, QUARANTINE_DIR);
829
+ let listing;
830
+ try {
831
+ listing = readdirSync(qDir).filter((n) => n.includes("-hold-") && safeBasename(n)).sort();
832
+ }
833
+ catch {
834
+ return;
835
+ }
836
+ const seats = new Set();
837
+ for (const r of snapshot)
838
+ if (r.disposition?.quarantineName !== undefined)
839
+ seats.add(r.disposition.quarantineName);
840
+ if (listing.every((n) => seats.has(n)))
841
+ return;
842
+ lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
843
+ const claimed = new Set();
844
+ for (const r of rec.rows)
845
+ if (r.disposition?.quarantineName !== undefined)
846
+ claimed.add(r.disposition.quarantineName);
847
+ const digests = new Map();
848
+ const digestOf = (name) => {
849
+ if (!digests.has(name)) {
850
+ let digest;
851
+ try {
852
+ const path = join(qDir, name);
853
+ digest = lstatSync(path).isFile() ? sha256(readFileSync(path)) : undefined;
854
+ }
855
+ catch {
856
+ digest = undefined;
857
+ }
858
+ digests.set(name, digest);
859
+ }
860
+ return digests.get(name);
861
+ };
862
+ const wants = (r) => {
863
+ if (existsSync(join(holdDir, r.captureName)))
864
+ return false;
865
+ if (r.status === "held")
866
+ return true;
867
+ if (r.status !== "disposed")
868
+ return false;
869
+ const seat = r.disposition?.quarantineName;
870
+ return seat === undefined || !existsSync(join(qDir, seat));
871
+ };
872
+ const endsWithCapture = (name, r) => name.endsWith(`-hold-${r.captureName}`);
873
+ const reservedForOther = (name) => rec.rows.some((r) => endsWithCapture(name, r));
874
+ const wanting = rec.rows.filter(wants);
875
+ const found = new Map();
876
+ for (const r of wanting) {
877
+ const f = listing.find((n) => !claimed.has(n) && endsWithCapture(n, r) && digestOf(n) === r.contentDigest);
878
+ if (f !== undefined) {
879
+ found.set(r, f);
880
+ claimed.add(f);
881
+ }
882
+ }
883
+ for (const r of wanting) {
884
+ if (found.has(r))
885
+ continue;
886
+ const f = listing.find((n) => !claimed.has(n) && !reservedForOther(n) && digestOf(n) === r.contentDigest);
887
+ if (f !== undefined) {
888
+ found.set(r, f);
889
+ claimed.add(f);
890
+ }
891
+ }
892
+ let changed = false;
893
+ for (const [r, f] of found) {
894
+ if (r.status === "disposed") {
895
+ r.disposition = { ...r.disposition, quarantineName: f };
896
+ changed = true;
897
+ continue;
898
+ }
899
+ try {
900
+ ensureDirExists(holdDir);
901
+ moveNoReplace(join(qDir, f), join(holdDir, r.captureName));
902
+ }
903
+ catch {
904
+ }
905
+ }
906
+ return changed ? { next: rec, result: undefined } : { result: undefined };
907
+ });
908
+ }
909
+ export function holdQuarantineNameOf(row) {
910
+ return `${row.contentDigest.slice(0, 16)}-hold-${row.captureName}`;
911
+ }
912
+ function quarantineSeatState(seat, digest) {
913
+ let isFile;
914
+ try {
915
+ isFile = lstatSync(seat).isFile();
916
+ }
917
+ catch (err) {
918
+ return err.code === "ENOENT" ? "absent" : "foreign";
919
+ }
920
+ if (!isFile)
921
+ return "foreign";
922
+ try {
923
+ return sha256(readFileSync(seat)) === digest ? "holds" : "foreign";
924
+ }
925
+ catch {
926
+ return "foreign";
927
+ }
928
+ }
929
+ function foreignSeatRefusal(holdId, seat) {
930
+ return new ControlPlaneCorruptError(`memory instruction hold ${holdId}: the quarantine seat ${seat} is occupied by something that is not the hold's captured bytes — refusing to replace or adopt it (fail-closed; inspect or remove it, and the next harvest converges)`);
931
+ }
932
+ function moveCustodyToSeat(controlDir, row, seatName) {
812
933
  const custody = join(controlDir, HOLD_DIR, row.captureName);
813
- const quarantineName = `${input.now()}-hold-${row.captureName}`;
814
934
  const qDir = join(controlDir, QUARANTINE_DIR);
815
- let moved = false;
935
+ const seat = join(qDir, seatName);
936
+ const atSeat = () => {
937
+ const state = quarantineSeatState(seat, row.contentDigest);
938
+ if (state === "foreign")
939
+ throw foreignSeatRefusal(row.holdId, seat);
940
+ if (state === "absent")
941
+ return undefined;
942
+ try {
943
+ if (sha256(readFileSync(custody)) === row.contentDigest)
944
+ unlinkSync(custody);
945
+ }
946
+ catch {
947
+ }
948
+ return { at: "seat" };
949
+ };
950
+ const there = atSeat();
951
+ if (there !== undefined)
952
+ return there;
953
+ if (!existsSync(custody))
954
+ return { at: "none" };
816
955
  try {
817
956
  ensureDirExists(qDir);
818
- renameSync(custody, join(qDir, quarantineName));
819
- moved = true;
957
+ }
958
+ catch (err) {
959
+ return { at: "custody", code: err.code ?? "mkdir error" };
960
+ }
961
+ if (moveNoReplace(custody, seat) === "moved")
962
+ return { at: "seat" };
963
+ return atSeat() ?? { at: "custody", code: "move refused" };
964
+ }
965
+ function moveNoReplace(from, to) {
966
+ try {
967
+ linkSync(from, to);
968
+ }
969
+ catch (err) {
970
+ const code = err.code;
971
+ if (code === "EEXIST")
972
+ return "occupied";
973
+ if (code === "ENOENT")
974
+ return "refused";
975
+ try {
976
+ renameSync(from, to);
977
+ return "moved";
978
+ }
979
+ catch {
980
+ return "refused";
981
+ }
982
+ }
983
+ try {
984
+ unlinkSync(from);
820
985
  }
821
986
  catch {
822
- moved = existsSync(join(qDir, quarantineName));
823
987
  }
824
- lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
988
+ return "moved";
989
+ }
990
+ export function disposeHold(controlDir, input) {
991
+ const row = readHolds(controlDir).find((r) => r.holdId === input.holdId);
992
+ if (row === undefined || row.status === "disposed" || row.status === "released")
993
+ return { ok: false };
994
+ const quarantineName = holdQuarantineNameOf(row);
995
+ if (!safeBasename(quarantineName)) {
996
+ throw new ControlPlaneCorruptError(`memory instruction hold ${row.holdId}: its digest and capture name do not make a safe quarantine file name — refusing (fail-closed)`);
997
+ }
998
+ const seatPath = join(controlDir, QUARANTINE_DIR, quarantineName);
999
+ const verdict = lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
825
1000
  const r = rec.rows.find((x) => x.holdId === input.holdId);
826
1001
  if (r === undefined || r.status === "disposed" || r.status === "released")
827
1002
  return { result: undefined };
1003
+ const custodyHere = existsSync(join(controlDir, HOLD_DIR, r.captureName));
1004
+ const seatState = quarantineSeatState(seatPath, r.contentDigest);
1005
+ const named = seatState === "holds" || (custodyHere && seatState === "absent");
828
1006
  r.status = "disposed";
829
- r.disposition = { terminal: input.terminal, ...(moved ? { quarantineName } : {}) };
830
- return { next: rec, result: undefined };
1007
+ r.disposition = { terminal: input.terminal, ...(named ? { quarantineName } : {}) };
1008
+ return { next: rec, result: { named, refused: custodyHere && seatState === "foreign" } };
831
1009
  });
832
- return { ok: true, ...(moved ? { quarantineName } : {}) };
1010
+ if (verdict === undefined)
1011
+ return { ok: false };
1012
+ if (verdict.refused)
1013
+ throw foreignSeatRefusal(row.holdId, seatPath);
1014
+ if (!verdict.named)
1015
+ return { ok: true };
1016
+ const moved = moveCustodyToSeat(controlDir, row, quarantineName);
1017
+ return { ok: true, ...(moved.at === "seat" ? { quarantineName } : {}) };
833
1018
  }
834
1019
  export function markHoldReleased(controlDir, input) {
835
- const captureName = lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
1020
+ const captureName = lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
836
1021
  const r = rec.rows.find((x) => x.holdId === input.holdId);
837
1022
  if (r === undefined || (r.status !== "held" && !(r.status === "disposed" && r.disposition?.terminal === "expired")))
838
1023
  return { result: undefined };
@@ -860,7 +1045,7 @@ export function resolveHoldRecord(controlDir, input) {
860
1045
  e.code = "memory.hold_resolve_invalid";
861
1046
  throw e;
862
1047
  }
863
- lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
1048
+ lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
864
1049
  const r = rec.rows.find((x) => x.holdId === input.holdId);
865
1050
  if (r === undefined) {
866
1051
  const e = new Error(`resolveHold: unknown holdId ${JSON.stringify(input.holdId)}`);
@@ -884,7 +1069,7 @@ export function resolveHoldRecord(controlDir, input) {
884
1069
  });
885
1070
  }
886
1071
  export function clearHoldResolution(controlDir, input) {
887
- lockedStrictUpdate(controlDir, HOLDS_FILE, "memory instruction-hold ledger", coerceHolds, (rec) => {
1072
+ lockedStrictUpdate(controlDir, HOLDS_FILE, HOLDS_WHAT, coerceHolds, (rec) => {
888
1073
  const r = rec.rows.find((x) => x.holdId === input.holdId);
889
1074
  if (r === undefined || r.resolved === undefined || r.resolvedAt !== input.ifResolvedAt)
890
1075
  return { result: undefined };
@@ -906,8 +1091,8 @@ export function readHoldCustody(controlDir, row) {
906
1091
  }
907
1092
  return undefined;
908
1093
  }
909
- export function sessionBlocksCleanRelease(controlDir, sessionId) {
1094
+ export async function sessionBlocksCleanRelease(docs, controlDir, sessionId) {
910
1095
  if (readSessionPollution(controlDir, sessionId) !== undefined)
911
1096
  return true;
912
- return sessionSettlements(controlDir, sessionId).some((s) => s.effective !== "clean" && s.effective !== "void");
1097
+ return (await sessionSettlements(docs, sessionId)).some((s) => s.effective !== "clean" && s.effective !== "void");
913
1098
  }
@@ -10,11 +10,12 @@ export declare function derivePersonalControlDir(configRoot: string): string;
10
10
  export interface ScopePlanes {
11
11
  /** proj:/legacy scopes — the repo/path-keyed plane (order preserved). */
12
12
  project: string[];
13
- /** user:/userproj:/org: scopes — the home-mount plane (order preserved). `org` is
13
+ /** user:/userlocal:/userproj:/org: scopes — the home-mount plane (order preserved). `org` is
14
14
  * CENTRAL-authority (§2 表), so it routes with the personal keys — under a pinned in-repo File
15
15
  * backend an org layer projected into the repo would leak tenant-shared memory into commit
16
16
  * history. The mount is still the "personal" directory (one home plane; the plane is about
17
- * WHERE-NOT-to-project, not about ownership — org's authority disk is the central DB anyway). */
17
+ * WHERE-NOT-to-project, not about ownership — org's authority disk is the central DB anyway, and a
18
+ * `userlocal:` layer's is the store it is written in: it is never replicated). */
18
19
  personal: string[];
19
20
  /** Which plane owns the write face (null = read-only layering everywhere). */
20
21
  writePlane: "project" | "personal" | null;
@@ -67,7 +68,8 @@ export interface MemoryScopeStoreInput {
67
68
  * non-empty string, and under v2 a typed key the scope contract cannot read.
68
69
  * On a directory-pinned deployment a personal-plane answer is a File store opened over the
69
70
  * personal mount (opening creates the mount's directories and finishes an interrupted transaction,
70
- * as a session's opening does); resolve once per scope and keep it.
71
+ * as a session's opening does); resolve once per scope and keep it. Opening is not a write: a store
72
+ * only opened or read is not in a deployment's store set (`memory.deployment.store_set`).
71
73
  */
72
74
  export declare function resolveMemoryScopeStore(input: MemoryScopeStoreInput): MemoryScopeStore;
73
75
  /** The two deployment facts a store resolution reads besides the backend, judged as {@link resolveMemoryScopeStore}
@@ -76,9 +78,13 @@ export declare function judgeMemoryStoreSeat(face: string, input: {
76
78
  scopeContract: "v2" | undefined;
77
79
  memoryEngineDir: string | undefined;
78
80
  }): void;
79
- /** The plane carrying `scope`, read as a session spells the key: the Runner's own normalization (trimmed;
80
- * under v2 the contract's parse), then {@link scopePlanesOf}. A key the contract cannot read, or a blank or
81
- * non-string one, is refused (`config.memory_scope_key`). */
81
+ /** The plane carrying `scope`: the one reading of which plane a scope key belongs to, shared by the store resolution and the
82
+ * deployment face and exported for a host that needs the answer without a store — the Runner's own normalization
83
+ * (surrounding whitespace trimmed; under v2 the scope contract's parse), then {@link scopePlanesOf}. No store is opened and
84
+ * no disk is read. `face` is the caller's own name, written into every refusal (`<face>: …`); `scopeContract` is the
85
+ * session's `TaskSpec.memory.scopeContract`, `undefined` written out for the opt-in absent (anything but `"v2"` and
86
+ * `undefined` is refused). A key the contract cannot read, a blank or non-string one, and a bad contract are refused
87
+ * (`config.memory_scope_key`). */
82
88
  export declare function memoryScopePlaneOf(face: string, scope: unknown, scopeContract: "v2" | undefined): "project" | "personal";
83
89
  /** The store-resolution input refusal (`config.memory_scope_key`), named by the face that refused. */
84
90
  export declare function refuseMemoryStoreInput(face: string, what: string, v: unknown, cause?: unknown): never;