blun-king-cli 9.1.642 → 9.1.644

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 (273) hide show
  1. package/LIESMICH.txt +18 -0
  2. package/README.md +20 -6
  3. package/bin/blun.js +3 -3
  4. package/bin/king.js +3 -3
  5. package/bin/launcher-mode.js +125 -126
  6. package/bin/launcher-runtime.js +603 -616
  7. package/bin/plugin-bootstrap.js +339 -405
  8. package/bin/rename-private-staging.cjs +2 -2
  9. package/bin/retired-bundled-plugins.cjs +84 -0
  10. package/bin/startup-security-host.cjs +105 -0
  11. package/bin/startup-security.cjs +9 -105
  12. package/bin/startup-warning-policy.cjs +22 -0
  13. package/bin/update-lease-installer.cjs +125 -0
  14. package/bin/update-lease-sockets.cjs +228 -0
  15. package/bin/update-lease.js +22 -327
  16. package/bin/verify-bundled-agent-sources.cjs +2 -4
  17. package/blun.mjs +78 -193
  18. package/bundled-agent-sources.json +1 -552
  19. package/package.json +4 -6
  20. package/tool-liveness642/index.cjs +7 -0
  21. package/tool-liveness642/queue-delivery.cjs +109 -0
  22. package/tool-liveness642/receipt.json +40 -0
  23. package/tool-liveness642/shell-yield.cjs +43 -0
  24. package/tool-liveness642/task-wait.cjs +45 -0
  25. package/versionierung/BELEG.json +43 -0
  26. package/versionierung/LIESMICH.md +5 -0
  27. package/versionierung/urspruenglicher-overlay-beleg.json +39 -0
  28. package/worker-host.mjs +48 -128
  29. package/agent-spine-plugin/.claude-plugin/marketplace.json +0 -20
  30. package/agent-spine-plugin/.claude-plugin/plugin.json +0 -14
  31. package/agent-spine-plugin/.codex-plugin/plugin.json +0 -47
  32. package/agent-spine-plugin/.mcp.json +0 -8
  33. package/agent-spine-plugin/CHANGELOG.md +0 -1614
  34. package/agent-spine-plugin/LICENSE +0 -186
  35. package/agent-spine-plugin/README.md +0 -432
  36. package/agent-spine-plugin/assets/agentspine-banner.svg +0 -32
  37. package/agent-spine-plugin/bin/agentspine-mcp.js +0 -4
  38. package/agent-spine-plugin/bin/agentspine.js +0 -7
  39. package/agent-spine-plugin/blun.plugin.json +0 -68
  40. package/agent-spine-plugin/docs/acceptance.md +0 -61
  41. package/agent-spine-plugin/docs/artifact-evaluation.md +0 -93
  42. package/agent-spine-plugin/docs/host-integration.md +0 -193
  43. package/agent-spine-plugin/docs/preflight-recall.md +0 -71
  44. package/agent-spine-plugin/docs/preservation-contract.md +0 -53
  45. package/agent-spine-plugin/docs/quality-gates.md +0 -50
  46. package/agent-spine-plugin/docs/session-timeline.md +0 -112
  47. package/agent-spine-plugin/docs/source-roots.md +0 -113
  48. package/agent-spine-plugin/docs/world-model.md +0 -119
  49. package/agent-spine-plugin/hooks/codex.json +0 -47
  50. package/agent-spine-plugin/hooks/hooks.json +0 -106
  51. package/agent-spine-plugin/hooks/version.json +0 -5
  52. package/agent-spine-plugin/package.json +0 -77
  53. package/agent-spine-plugin/scripts/check-codex-install.js +0 -226
  54. package/agent-spine-plugin/scripts/check-hosts.js +0 -208
  55. package/agent-spine-plugin/scripts/check-install-hook.js +0 -227
  56. package/agent-spine-plugin/scripts/check-install-selfstarter.js +0 -154
  57. package/agent-spine-plugin/scripts/check-install.js +0 -478
  58. package/agent-spine-plugin/scripts/check-line-budget.js +0 -58
  59. package/agent-spine-plugin/scripts/check-syntax.js +0 -29
  60. package/agent-spine-plugin/scripts/github-actions.js +0 -11
  61. package/agent-spine-plugin/scripts/hermetic-process.js +0 -191
  62. package/agent-spine-plugin/scripts/release-check.js +0 -150
  63. package/agent-spine-plugin/scripts/run-acceptance.js +0 -19
  64. package/agent-spine-plugin/scripts/run-checks.js +0 -50
  65. package/agent-spine-plugin/scripts/run-tests-hermetic.js +0 -112
  66. package/agent-spine-plugin/skills/agent-spine/SKILL.md +0 -99
  67. package/agent-spine-plugin/spine-example/1-identity.md +0 -12
  68. package/agent-spine-plugin/spine-example/2-voice.md +0 -6
  69. package/agent-spine-plugin/spine-example/3-conduct.md +0 -8
  70. package/agent-spine-plugin/spine-example/4-history.md +0 -4
  71. package/agent-spine-plugin/src/cli-agent.js +0 -315
  72. package/agent-spine-plugin/src/cli-attention.js +0 -95
  73. package/agent-spine-plugin/src/cli-autonomy.js +0 -36
  74. package/agent-spine-plugin/src/cli-common.js +0 -71
  75. package/agent-spine-plugin/src/cli-continuity.js +0 -116
  76. package/agent-spine-plugin/src/cli-core.js +0 -128
  77. package/agent-spine-plugin/src/cli-diagnostics.js +0 -291
  78. package/agent-spine-plugin/src/cli-host.js +0 -21
  79. package/agent-spine-plugin/src/cli-learning.js +0 -320
  80. package/agent-spine-plugin/src/cli-premortem.js +0 -16
  81. package/agent-spine-plugin/src/cli-sharing.js +0 -230
  82. package/agent-spine-plugin/src/cli.js +0 -181
  83. package/agent-spine-plugin/src/codex-reader-launcher.js +0 -182
  84. package/agent-spine-plugin/src/hook.js +0 -500
  85. package/agent-spine-plugin/src/index.js +0 -108
  86. package/agent-spine-plugin/src/lib/acceptance.js +0 -435
  87. package/agent-spine-plugin/src/lib/action-lesson-recall.js +0 -118
  88. package/agent-spine-plugin/src/lib/attention-context.js +0 -167
  89. package/agent-spine-plugin/src/lib/attention-events.js +0 -113
  90. package/agent-spine-plugin/src/lib/attention-privacy.js +0 -72
  91. package/agent-spine-plugin/src/lib/attention-schema.js +0 -164
  92. package/agent-spine-plugin/src/lib/attention-storage.js +0 -93
  93. package/agent-spine-plugin/src/lib/attention.js +0 -164
  94. package/agent-spine-plugin/src/lib/audit-premortem.js +0 -223
  95. package/agent-spine-plugin/src/lib/audit.js +0 -401
  96. package/agent-spine-plugin/src/lib/authentication.js +0 -515
  97. package/agent-spine-plugin/src/lib/autonomy-policy.js +0 -110
  98. package/agent-spine-plugin/src/lib/autonomy-store.js +0 -202
  99. package/agent-spine-plugin/src/lib/autonomy.js +0 -8
  100. package/agent-spine-plugin/src/lib/briefing.js +0 -493
  101. package/agent-spine-plugin/src/lib/catalog-document-read.js +0 -51
  102. package/agent-spine-plugin/src/lib/catalog.js +0 -167
  103. package/agent-spine-plugin/src/lib/channel-continuity.js +0 -19
  104. package/agent-spine-plugin/src/lib/channel-runtime.js +0 -665
  105. package/agent-spine-plugin/src/lib/codex-installation.js +0 -231
  106. package/agent-spine-plugin/src/lib/codex-skill-installation.js +0 -211
  107. package/agent-spine-plugin/src/lib/context.js +0 -156
  108. package/agent-spine-plugin/src/lib/continuity.js +0 -338
  109. package/agent-spine-plugin/src/lib/coordination.js +0 -577
  110. package/agent-spine-plugin/src/lib/delivery-agent-usage.js +0 -231
  111. package/agent-spine-plugin/src/lib/delivery-assignment.js +0 -220
  112. package/agent-spine-plugin/src/lib/delivery-command-actions.js +0 -462
  113. package/agent-spine-plugin/src/lib/delivery-knowledge.js +0 -78
  114. package/agent-spine-plugin/src/lib/delivery-premortem-binding.js +0 -107
  115. package/agent-spine-plugin/src/lib/delivery-premortem-closure.js +0 -171
  116. package/agent-spine-plugin/src/lib/delivery-premortem-codec.js +0 -45
  117. package/agent-spine-plugin/src/lib/delivery-premortem-correction.js +0 -101
  118. package/agent-spine-plugin/src/lib/delivery-premortem-file.js +0 -21
  119. package/agent-spine-plugin/src/lib/delivery-premortem-index.js +0 -493
  120. package/agent-spine-plugin/src/lib/delivery-premortem-inspection.js +0 -37
  121. package/agent-spine-plugin/src/lib/delivery-premortem-recovery.js +0 -120
  122. package/agent-spine-plugin/src/lib/delivery-premortem-rejection.js +0 -65
  123. package/agent-spine-plugin/src/lib/delivery-premortem-results.js +0 -28
  124. package/agent-spine-plugin/src/lib/delivery-premortem-session-guard.js +0 -46
  125. package/agent-spine-plugin/src/lib/delivery-premortem-write-ledger.js +0 -285
  126. package/agent-spine-plugin/src/lib/delivery-premortem.js +0 -499
  127. package/agent-spine-plugin/src/lib/delivery-shell-heredoc.js +0 -115
  128. package/agent-spine-plugin/src/lib/delivery-shell-substitutions.js +0 -111
  129. package/agent-spine-plugin/src/lib/delivery-shell-wrapper.js +0 -64
  130. package/agent-spine-plugin/src/lib/delivery-target.js +0 -73
  131. package/agent-spine-plugin/src/lib/delivery-verification.js +0 -445
  132. package/agent-spine-plugin/src/lib/documents.js +0 -239
  133. package/agent-spine-plugin/src/lib/feed-transport.js +0 -499
  134. package/agent-spine-plugin/src/lib/filesystem-retry.js +0 -34
  135. package/agent-spine-plugin/src/lib/gateway-common.js +0 -68
  136. package/agent-spine-plugin/src/lib/gateway-control.js +0 -370
  137. package/agent-spine-plugin/src/lib/gateway-delivery.js +0 -103
  138. package/agent-spine-plugin/src/lib/gateway-execution.js +0 -350
  139. package/agent-spine-plugin/src/lib/gateway-group-response.js +0 -128
  140. package/agent-spine-plugin/src/lib/gateway-host-fencing.js +0 -92
  141. package/agent-spine-plugin/src/lib/gateway-host-lifecycle.js +0 -193
  142. package/agent-spine-plugin/src/lib/gateway-inspection.js +0 -85
  143. package/agent-spine-plugin/src/lib/gateway-knowledge.js +0 -129
  144. package/agent-spine-plugin/src/lib/gateway-policy-provenance.js +0 -197
  145. package/agent-spine-plugin/src/lib/gateway-premortem-disposition.js +0 -82
  146. package/agent-spine-plugin/src/lib/gateway-premortem.js +0 -363
  147. package/agent-spine-plugin/src/lib/gateway-prepared-host.js +0 -28
  148. package/agent-spine-plugin/src/lib/gateway-runs.js +0 -345
  149. package/agent-spine-plugin/src/lib/gateway-runtime-identity.js +0 -31
  150. package/agent-spine-plugin/src/lib/gateway-runtime-records.js +0 -21
  151. package/agent-spine-plugin/src/lib/gateway-runtime.js +0 -18
  152. package/agent-spine-plugin/src/lib/gateway-state-transaction.js +0 -356
  153. package/agent-spine-plugin/src/lib/gateway-state.js +0 -344
  154. package/agent-spine-plugin/src/lib/graph.js +0 -337
  155. package/agent-spine-plugin/src/lib/hook-artifact-guards.js +0 -356
  156. package/agent-spine-plugin/src/lib/hook-audit.js +0 -43
  157. package/agent-spine-plugin/src/lib/hook-briefing-use.js +0 -78
  158. package/agent-spine-plugin/src/lib/hook-context.js +0 -441
  159. package/agent-spine-plugin/src/lib/hook-final-message.js +0 -26
  160. package/agent-spine-plugin/src/lib/hook-input.js +0 -27
  161. package/agent-spine-plugin/src/lib/hook-output.js +0 -284
  162. package/agent-spine-plugin/src/lib/hook-premortem.js +0 -257
  163. package/agent-spine-plugin/src/lib/hook-process-advisory.js +0 -36
  164. package/agent-spine-plugin/src/lib/hook-protection.js +0 -95
  165. package/agent-spine-plugin/src/lib/hook-stop-verification.js +0 -84
  166. package/agent-spine-plugin/src/lib/hook-timeline.js +0 -102
  167. package/agent-spine-plugin/src/lib/host-instruction-budget.js +0 -11
  168. package/agent-spine-plugin/src/lib/https-transport.js +0 -392
  169. package/agent-spine-plugin/src/lib/identifier-analysis.js +0 -446
  170. package/agent-spine-plugin/src/lib/indexed-memory-offline.js +0 -40
  171. package/agent-spine-plugin/src/lib/indexed-memory.js +0 -298
  172. package/agent-spine-plugin/src/lib/knowledge-evidence.js +0 -431
  173. package/agent-spine-plugin/src/lib/learning-applications.js +0 -441
  174. package/agent-spine-plugin/src/lib/learning-artifact-evaluator.js +0 -114
  175. package/agent-spine-plugin/src/lib/learning-candidates.js +0 -274
  176. package/agent-spine-plugin/src/lib/learning-context.js +0 -137
  177. package/agent-spine-plugin/src/lib/learning-delivery-contracts.js +0 -310
  178. package/agent-spine-plugin/src/lib/learning-evaluation-contracts.js +0 -350
  179. package/agent-spine-plugin/src/lib/learning-evaluation-registration.js +0 -372
  180. package/agent-spine-plugin/src/lib/learning-evaluation-revocation.js +0 -292
  181. package/agent-spine-plugin/src/lib/learning-evidence-contracts.js +0 -321
  182. package/agent-spine-plugin/src/lib/learning-findings.js +0 -458
  183. package/agent-spine-plugin/src/lib/learning-measurement-contracts.js +0 -285
  184. package/agent-spine-plugin/src/lib/learning-measurements.js +0 -265
  185. package/agent-spine-plugin/src/lib/learning-outcome-contracts.js +0 -165
  186. package/agent-spine-plugin/src/lib/learning-outcomes.js +0 -343
  187. package/agent-spine-plugin/src/lib/learning-reconciliation.js +0 -290
  188. package/agent-spine-plugin/src/lib/learning-retry-contracts.js +0 -188
  189. package/agent-spine-plugin/src/lib/learning-schema.js +0 -229
  190. package/agent-spine-plugin/src/lib/learning-scope-targets.js +0 -424
  191. package/agent-spine-plugin/src/lib/learning-state-upgrade.js +0 -477
  192. package/agent-spine-plugin/src/lib/learning-status-configuration.js +0 -476
  193. package/agent-spine-plugin/src/lib/learning-storage.js +0 -203
  194. package/agent-spine-plugin/src/lib/learning-trial-recovery.js +0 -218
  195. package/agent-spine-plugin/src/lib/learning-validation-contracts.js +0 -375
  196. package/agent-spine-plugin/src/lib/learning-validation-renewal.js +0 -298
  197. package/agent-spine-plugin/src/lib/learning-validation-runtime.js +0 -234
  198. package/agent-spine-plugin/src/lib/learning.js +0 -36
  199. package/agent-spine-plugin/src/lib/lesson-recall-session.js +0 -172
  200. package/agent-spine-plugin/src/lib/mcp-autonomy-tools.js +0 -37
  201. package/agent-spine-plugin/src/lib/mcp-delivery-completion.js +0 -124
  202. package/agent-spine-plugin/src/lib/mcp-delivery-tools.js +0 -45
  203. package/agent-spine-plugin/src/lib/mcp-premortem.js +0 -68
  204. package/agent-spine-plugin/src/lib/mcp-runtime.js +0 -355
  205. package/agent-spine-plugin/src/lib/mcp-source-context.js +0 -61
  206. package/agent-spine-plugin/src/lib/mcp-timeline-tools.js +0 -240
  207. package/agent-spine-plugin/src/lib/mcp-world-tools.js +0 -52
  208. package/agent-spine-plugin/src/lib/object-transport.js +0 -206
  209. package/agent-spine-plugin/src/lib/owned-file-lock.js +0 -182
  210. package/agent-spine-plugin/src/lib/paths.js +0 -109
  211. package/agent-spine-plugin/src/lib/peer-transport.js +0 -283
  212. package/agent-spine-plugin/src/lib/persona-runtime.js +0 -581
  213. package/agent-spine-plugin/src/lib/pre-answer-timeline-recall.js +0 -104
  214. package/agent-spine-plugin/src/lib/preflight-delivery-id.js +0 -27
  215. package/agent-spine-plugin/src/lib/preflight.js +0 -688
  216. package/agent-spine-plugin/src/lib/project-portfolio.js +0 -176
  217. package/agent-spine-plugin/src/lib/runtime.js +0 -13
  218. package/agent-spine-plugin/src/lib/selfstarter-core.js +0 -382
  219. package/agent-spine-plugin/src/lib/selfstarter-jobs.js +0 -149
  220. package/agent-spine-plugin/src/lib/selfstarter-lease.js +0 -204
  221. package/agent-spine-plugin/src/lib/selfstarter-policy.js +0 -90
  222. package/agent-spine-plugin/src/lib/selfstarter-workspace.js +0 -111
  223. package/agent-spine-plugin/src/lib/selfstarter.js +0 -11
  224. package/agent-spine-plugin/src/lib/session-timeline-auth.js +0 -316
  225. package/agent-spine-plugin/src/lib/session-timeline-codex.js +0 -69
  226. package/agent-spine-plugin/src/lib/session-timeline-contract.js +0 -56
  227. package/agent-spine-plugin/src/lib/session-timeline-enrollment-source.js +0 -38
  228. package/agent-spine-plugin/src/lib/session-timeline-enrollment-storage.js +0 -128
  229. package/agent-spine-plugin/src/lib/session-timeline-enrollment-transport.js +0 -15
  230. package/agent-spine-plugin/src/lib/session-timeline-enrollment.js +0 -478
  231. package/agent-spine-plugin/src/lib/session-timeline-event-extract.js +0 -186
  232. package/agent-spine-plugin/src/lib/session-timeline-host-origin.js +0 -73
  233. package/agent-spine-plugin/src/lib/session-timeline-host-receipt.js +0 -117
  234. package/agent-spine-plugin/src/lib/session-timeline-invocation.js +0 -201
  235. package/agent-spine-plugin/src/lib/session-timeline-king.js +0 -93
  236. package/agent-spine-plugin/src/lib/session-timeline-prior.js +0 -57
  237. package/agent-spine-plugin/src/lib/session-timeline-provider.js +0 -36
  238. package/agent-spine-plugin/src/lib/session-timeline-query.js +0 -56
  239. package/agent-spine-plugin/src/lib/session-timeline-results.js +0 -56
  240. package/agent-spine-plugin/src/lib/session-timeline-root.js +0 -11
  241. package/agent-spine-plugin/src/lib/session-timeline-search.js +0 -82
  242. package/agent-spine-plugin/src/lib/session-timeline-sid-acl.js +0 -213
  243. package/agent-spine-plugin/src/lib/session-timeline-source-open.js +0 -30
  244. package/agent-spine-plugin/src/lib/session-timeline-source.js +0 -80
  245. package/agent-spine-plugin/src/lib/session-timeline-state.js +0 -45
  246. package/agent-spine-plugin/src/lib/session-timeline-transport.js +0 -42
  247. package/agent-spine-plugin/src/lib/session-timeline-windows-acl.js +0 -145
  248. package/agent-spine-plugin/src/lib/session-timeline.js +0 -462
  249. package/agent-spine-plugin/src/lib/sharing.js +0 -969
  250. package/agent-spine-plugin/src/lib/source-roots.js +0 -475
  251. package/agent-spine-plugin/src/lib/source-tree-scan.js +0 -178
  252. package/agent-spine-plugin/src/lib/sqlite-transport.js +0 -501
  253. package/agent-spine-plugin/src/lib/task-knowledge-context.js +0 -99
  254. package/agent-spine-plugin/src/lib/telegram-adapter.js +0 -119
  255. package/agent-spine-plugin/src/lib/timeline-continuation-update.js +0 -100
  256. package/agent-spine-plugin/src/lib/timeline-tool-guard.js +0 -225
  257. package/agent-spine-plugin/src/lib/timeline-user-feedback.js +0 -216
  258. package/agent-spine-plugin/src/lib/timeline-world-capture.js +0 -233
  259. package/agent-spine-plugin/src/lib/voice-runtime.js +0 -39
  260. package/agent-spine-plugin/src/lib/world-knowledge.js +0 -306
  261. package/agent-spine-plugin/src/lib/world-model.js +0 -333
  262. package/agent-spine-plugin/src/mcp.js +0 -456
  263. package/agent-spine-plugin/src/version.js +0 -1
  264. package/agent-spine-plugin/src/worker.js +0 -257
  265. package/bin/agentspine-king-goal-inbox.mjs +0 -127
  266. package/bin/agentspine-king-goal-intake.mjs +0 -106
  267. package/bin/agentspine-king-host-runner.mjs +0 -109
  268. package/bin/agentspine-king-snapshot-policy.cjs +0 -80
  269. package/bin/agentspine-king-status-policy.mjs +0 -226
  270. package/bin/agentspine-king-worker-host.mjs +0 -160
  271. package/bin/managed-plugin-selection.cjs +0 -141
  272. package/bin/verify-agent-behavior.cjs +0 -122
  273. package/bin/verify-agent-components.cjs +0 -104
@@ -1,231 +0,0 @@
1
- import { mkdir, readFile, unlink } from "node:fs/promises";
2
- import { join } from "node:path";
3
- import { withOwnedFileLock } from "./owned-file-lock.js";
4
- import { canonicalPath, projectStateDir } from "./paths.js";
5
- import { writePremortemFile } from "./delivery-premortem-file.js";
6
- import { inspectPremortemState } from "./delivery-premortem.js";
7
- import { parsePremortemRequirementId } from "./delivery-premortem-binding.js";
8
- import { premortemBlock as block, premortemBoundary as boundary } from "./delivery-premortem-results.js";
9
- import { premortemSha256 as sha256, premortemTime as at,
10
- sealPremortem as seal, validPremortemSeal as validSeal,
11
- validPremortemTime as validTime } from "./delivery-premortem-codec.js";
12
-
13
- const STATE_SCHEMA = "agentspine.delivery-agent-usage/v1";
14
- const RECEIPT_SCHEMA = "agentspine.delivery-agent-use-receipt/v1";
15
- const AUTHORITY = "context-only";
16
- const MAX_BYTES = 32 * 1024;
17
- const DIGEST_RE = /^[a-f0-9]{64}$/;
18
-
19
- export const DELIVERY_AGENT_USE_TEXT = [
20
- "Reuse a host-verified briefing for this requirement; no second content fetch is needed.",
21
- "Use delivery_knowledge_query and record_delivery_premortem for relevant preparation.",
22
- "Without a verified briefing, report uncertainty; session_briefing is optional. No automatic retry or work restriction.",
23
- "Only matching host or MCP evidence counts; claims, foreign or reused receipts do not. Context-only; no authority."
24
- ].join("\n");
25
-
26
- function stateMaterial(state) {
27
- const material = { ...state };
28
- delete material.integrityDigest;
29
- return material;
30
- }
31
-
32
- function sealState(state) {
33
- return { ...state, integrityDigest: sha256(stateMaterial(state)) };
34
- }
35
-
36
- function validReceipt(value, stage, requirementId) {
37
- return value && value.schema === RECEIPT_SCHEMA && value.stage === stage
38
- && value.requirementId === requirementId && value.authority === AUTHORITY
39
- && [undefined, "verified-host-preflight", "verified-host-handoff"].includes(value.origin)
40
- && (value.origin !== "verified-host-handoff" || (value.handoff?.schema === "agentspine.host-context-handoff/v1"
41
- && ["additionalContext", "message"].includes(value.handoff.field)
42
- && ["claude", "codex", "generic", "king"].includes(value.handoff.host)
43
- && Number.isSafeInteger(value.handoff.bytes) && value.handoff.bytes > 0
44
- && DIGEST_RE.test(value.handoff.digest || "")))
45
- && DIGEST_RE.test(value.inputDigest || "") && DIGEST_RE.test(value.resultDigest || "")
46
- && validTime(value.recordedAt) && validSeal(value);
47
- }
48
-
49
- function validateState(state, parsed) {
50
- if (!state || state.schema !== STATE_SCHEMA || state.authority !== AUTHORITY
51
- || state.requirementId !== `premortem-requirement:${parsed.laneDigest}:${parsed.generationDigest}`
52
- || state.laneDigest !== parsed.laneDigest || state.generationDigest !== parsed.generationDigest
53
- || !Number.isInteger(state.revision) || state.revision < 0 || state.revision > 3
54
- || (state.briefing !== null && !validReceipt(state.briefing, "briefing", state.requirementId))
55
- || (state.knowledge !== null && !validReceipt(state.knowledge, "knowledge", state.requirementId))
56
- || Boolean(state.knowledge) > Boolean(state.briefing)
57
- || (state.consumedAt !== null && !validTime(state.consumedAt))
58
- || (state.consumedDigest !== null && !DIGEST_RE.test(state.consumedDigest))
59
- || Boolean(state.consumedAt) !== Boolean(state.consumedDigest)
60
- || !DIGEST_RE.test(state.integrityDigest || "")
61
- || state.integrityDigest !== sha256(stateMaterial(state))) {
62
- const error = new Error("delivery AgentSpine usage state failed integrity validation");
63
- error.code = "AGENTSPINE_USAGE_UNCERTAIN";
64
- throw error;
65
- }
66
- return state;
67
- }
68
-
69
- async function pathsFor(root, requirementId) {
70
- const parsed = parsePremortemRequirementId(requirementId);
71
- const directory = join(await projectStateDir(await canonicalPath(root)), "delivery-agent-usage");
72
- await mkdir(directory, { recursive: true, mode: 0o700 });
73
- const path = join(directory, `${parsed.generationDigest}.json`);
74
- return { parsed, path, lockPath: `${path}.lock` };
75
- }
76
-
77
- async function readState(path, parsed) {
78
- try {
79
- const text = await readFile(path, "utf8");
80
- if (Buffer.byteLength(text) > MAX_BYTES) throw new Error("delivery AgentSpine usage state exceeds 32 KiB");
81
- return validateState(JSON.parse(text), parsed);
82
- } catch (error) {
83
- if (error.code === "ENOENT") return null;
84
- if (error instanceof SyntaxError) {
85
- const invalid = new Error("delivery AgentSpine usage state is not valid JSON");
86
- invalid.code = "AGENTSPINE_USAGE_UNCERTAIN";
87
- throw invalid;
88
- }
89
- throw error;
90
- }
91
- }
92
-
93
- function emptyState(requirementId, parsed) {
94
- return sealState({ schema: STATE_SCHEMA, requirementId,
95
- laneDigest: parsed.laneDigest, generationDigest: parsed.generationDigest,
96
- revision: 0, briefing: null, knowledge: null,
97
- consumedAt: null, consumedDigest: null, authority: AUTHORITY });
98
- }
99
-
100
- async function currentRequirement(root, requirementId) {
101
- const current = await inspectPremortemState({ root, requirementId });
102
- if (current.status === "degraded") return current;
103
- if (current.blocked) return current;
104
- if (current.status === "absent" || !current.requirement) {
105
- return block("stale", `AgentSpine cannot bind usage to current requirement ${requirementId}.`,
106
- { requirementId });
107
- }
108
- return current;
109
- }
110
-
111
- function receipt(stage, requirementId, input, result, now, verifiedHostHandoff) {
112
- return seal({ schema: RECEIPT_SCHEMA, stage, requirementId,
113
- ...(verifiedHostHandoff ? { origin: "verified-host-handoff", handoff: structuredClone(result.handoff) } : {}),
114
- inputDigest: sha256(input), resultDigest: sha256(result),
115
- recordedAt: at(now), authority: AUTHORITY });
116
- }
117
-
118
- async function recordStage({ root, requirementId, stage, input, result,
119
- verifiedHostHandoff = false, preserveConsumed = false, now = new Date() }) {
120
- try {
121
- const current = await currentRequirement(root, requirementId);
122
- if (current.status === "degraded" || current.blocked) return current;
123
- const paths = await pathsFor(root, requirementId);
124
- return await withOwnedFileLock(paths.lockPath, async ({ assertOwned }) => {
125
- let state = await readState(paths.path, paths.parsed)
126
- || emptyState(requirementId, paths.parsed);
127
- if (!preserveConsumed && state.briefing?.origin !== "verified-host-handoff"
128
- && state.consumedAt && stage === "briefing" && current.closed && !current.consumed) {
129
- state = emptyState(requirementId, paths.parsed);
130
- } else if (state.consumedAt) return block("reused",
131
- `AgentSpine usage receipts for ${requirementId} were already consumed.`, { requirementId });
132
- if (stage === "knowledge" && !state.briefing) return block("missing-briefing",
133
- "AgentSpine delivery preflight is missing stage 1: session_briefing.", { requirementId });
134
- if (stage === "briefing" && !verifiedHostHandoff && state.briefing?.origin === "verified-host-handoff") {
135
- return { status: "satisfied-by-host", blocked: false, requirementId,
136
- receipt: structuredClone(state.briefing), digest: state.briefing.digest };
137
- }
138
- const proposed = receipt(stage, requirementId, input, result, now, verifiedHostHandoff);
139
- if (state[stage]) {
140
- if (state[stage].inputDigest !== proposed.inputDigest
141
- || state[stage].resultDigest !== proposed.resultDigest) {
142
- return block(`conflicting-${stage}`,
143
- `AgentSpine delivery preflight has a conflicting ${stage} call.`, { requirementId });
144
- }
145
- return { status: "duplicate", blocked: false, requirementId,
146
- receipt: structuredClone(state[stage]), digest: state[stage].digest };
147
- }
148
- state[stage] = proposed;
149
- state.revision += 1;
150
- state = sealState(state);
151
- await writePremortemFile(paths.path, state, assertOwned, MAX_BYTES);
152
- return { status: "recorded", blocked: false, requirementId,
153
- receipt: structuredClone(proposed), digest: proposed.digest };
154
- });
155
- } catch (error) {
156
- return boundary(error);
157
- }
158
- }
159
-
160
- export function deliveryAgentUseGuidance(root, requirementId) {
161
- return { root, requirementId, calls: ["session_briefing", "delivery_knowledge_query",
162
- "record_delivery_premortem"], instruction: DELIVERY_AGENT_USE_TEXT };
163
- }
164
-
165
- export function recordDeliveryBriefingUse(input) {
166
- return recordStage({ ...input, stage: "briefing" });
167
- }
168
-
169
- export function recordDeliveryKnowledgeUse(input) {
170
- return recordStage({ ...input, stage: "knowledge" });
171
- }
172
-
173
- export async function verifyDeliveryAgentUse({ root, requirementId }) {
174
- try {
175
- const current = await currentRequirement(root, requirementId);
176
- if (current.status === "degraded" || current.blocked) return current;
177
- const paths = await pathsFor(root, requirementId);
178
- const state = await readState(paths.path, paths.parsed);
179
- if (!state?.briefing) return block("missing-briefing",
180
- "AgentSpine delivery preflight is missing stage 1: session_briefing.", { requirementId });
181
- if (state.briefing.origin === "verified-host-preflight") return block("handoff-unverified",
182
- "The historical hook receipt predates verified host-context handoff.", { requirementId });
183
- if (!state.knowledge) return block("missing-knowledge",
184
- "AgentSpine delivery preflight is missing stage 2: delivery_knowledge_query.", { requirementId });
185
- if (state.consumedAt) return block("reused",
186
- `AgentSpine usage receipts for ${requirementId} were already consumed.`, { requirementId });
187
- return { status: "verified", blocked: false, requirementId,
188
- briefingReceipt: structuredClone(state.briefing),
189
- knowledgeReceipt: structuredClone(state.knowledge),
190
- digest: sha256({ briefing: state.briefing.digest, knowledge: state.knowledge.digest }) };
191
- } catch (error) {
192
- return boundary(error);
193
- }
194
- }
195
-
196
- export async function consumeDeliveryAgentUse({ root, requirementId, now = new Date() }) {
197
- try {
198
- const verified = await verifyDeliveryAgentUse({ root, requirementId });
199
- if (verified.blocked || verified.status === "degraded") return verified;
200
- const paths = await pathsFor(root, requirementId);
201
- return withOwnedFileLock(paths.lockPath, async ({ assertOwned }) => {
202
- let state = await readState(paths.path, paths.parsed);
203
- if (state.consumedAt) return { status: "duplicate", blocked: false,
204
- requirementId, digest: state.consumedDigest };
205
- state.consumedAt = at(now);
206
- state.consumedDigest = sha256({ requirementId, usageDigest: verified.digest });
207
- state.revision += 1;
208
- state = sealState(state);
209
- await writePremortemFile(paths.path, state, assertOwned, MAX_BYTES);
210
- return { status: "consumed", blocked: false, requirementId,
211
- digest: state.consumedDigest };
212
- });
213
- } catch (error) {
214
- return boundary(error);
215
- }
216
- }
217
-
218
- export async function removeDeliveryAgentUse({ root, requirementId }) {
219
- try {
220
- const paths = await pathsFor(root, requirementId);
221
- return withOwnedFileLock(paths.lockPath, async ({ assertOwned }) => {
222
- await assertOwned();
223
- await unlink(paths.path).catch((error) => {
224
- if (error.code !== "ENOENT") throw error;
225
- });
226
- return { status: "removed", blocked: false, requirementId };
227
- });
228
- } catch (error) {
229
- return boundary(error);
230
- }
231
- }
@@ -1,220 +0,0 @@
1
- import { mkdir, readFile } from "node:fs/promises";
2
- import { join } from "node:path";
3
- import { withOwnedFileLock } from "./owned-file-lock.js";
4
- import { canonicalPath, projectStateDir } from "./paths.js";
5
- import { writePremortemFile } from "./delivery-premortem-file.js";
6
- import { inspectPremortemState } from "./delivery-premortem.js";
7
- import { canonicalPremortem as canonical, premortemSha256 as sha256,
8
- premortemTime as at, sealPremortem as seal,
9
- validPremortemSeal as validSeal, validPremortemTime as validTime } from "./delivery-premortem-codec.js";
10
-
11
- const ASSIGNMENT_SCHEMA = "agentspine.delivery-assignment/v1";
12
- const POINTER_SCHEMA = "agentspine.delivery-assignment-pointer/v1";
13
- const AUTHORITY = "context-only";
14
- const MAX_BYTES = 16 * 1024;
15
- const ID_RE = /^assignment:[a-f0-9]{64}$/;
16
-
17
- function sessionBinding(binding) {
18
- return {
19
- host: binding.host,
20
- sessionId: binding.sessionId,
21
- projectId: binding.projectId
22
- };
23
- }
24
-
25
- function sessionDigest(binding) {
26
- return sha256({ schema: "agentspine.delivery-assignment-session/v1",
27
- binding: sessionBinding(binding) });
28
- }
29
-
30
- function eventDigest(binding, eventId) {
31
- return sha256({ schema: "agentspine.delivery-assignment-event/v1",
32
- binding: sessionBinding(binding), eventId });
33
- }
34
-
35
- function validAssignment(value, expectedSessionDigest = null) {
36
- return value && value.schema === ASSIGNMENT_SCHEMA && value.authority === AUTHORITY
37
- && ID_RE.test(value.assignmentId || "")
38
- && /^[a-f0-9]{64}$/.test(value.sessionDigest || "")
39
- && /^[a-f0-9]{64}$/.test(value.eventDigest || "")
40
- && (value.predecessorAssignmentId === null || ID_RE.test(value.predecessorAssignmentId || ""))
41
- && value.binding && canonical(sessionBinding(value.binding)) === canonical(sessionBinding(value))
42
- && (!expectedSessionDigest || value.sessionDigest === expectedSessionDigest)
43
- && validTime(value.createdAt) && validSeal(value);
44
- }
45
-
46
- function validPointer(value, digest) {
47
- return value && value.schema === POINTER_SCHEMA && value.authority === AUTHORITY
48
- && value.sessionDigest === digest && validAssignment(value.assignment, digest)
49
- && value.assignmentId === value.assignment.assignmentId
50
- && Number.isInteger(value.revision) && value.revision > 0
51
- && validTime(value.updatedAt) && validSeal(value);
52
- }
53
-
54
- async function pathsFor(root, binding) {
55
- const digest = sessionDigest(binding);
56
- const directory = join(await projectStateDir(await canonicalPath(root)),
57
- "delivery-assignments", digest);
58
- await mkdir(join(directory, "events"), { recursive: true, mode: 0o700 });
59
- return { digest, directory, pointer: join(directory, "active.json"),
60
- lock: join(directory, "active.lock") };
61
- }
62
-
63
- async function readJson(path, maxBytes = MAX_BYTES) {
64
- try {
65
- const text = await readFile(path, "utf8");
66
- if (Buffer.byteLength(text) > maxBytes) throw new Error("delivery assignment state exceeds 16 KiB");
67
- return JSON.parse(text);
68
- } catch (error) {
69
- if (error.code === "ENOENT") return null;
70
- if (error instanceof SyntaxError) throw new Error("delivery assignment state is not valid JSON");
71
- throw error;
72
- }
73
- }
74
-
75
- async function readPointer(paths) {
76
- const value = await readJson(paths.pointer);
77
- if (value && !validPointer(value, paths.digest)) {
78
- throw new Error("delivery assignment pointer failed integrity validation");
79
- }
80
- return value;
81
- }
82
-
83
- function assignmentFor(binding, eventId, digest, predecessor, now) {
84
- const event = eventDigest(binding, eventId);
85
- return seal({ schema: ASSIGNMENT_SCHEMA,
86
- assignmentId: `assignment:${sha256({ sessionDigest: digest, eventDigest: event })}`,
87
- sessionDigest: digest, eventDigest: event,
88
- host: binding.host, sessionId: binding.sessionId, projectId: binding.projectId,
89
- binding: { host: binding.host, sessionId: binding.sessionId,
90
- projectId: binding.projectId, entityId: binding.entityId || null,
91
- groupId: binding.groupId || null, taskId: binding.taskId || null,
92
- goalId: binding.goalId || null, goalStepId: binding.goalStepId || null,
93
- queueId: binding.queueId || null, gatewayAttempt: binding.gatewayAttempt ?? null,
94
- planDefinitionsDigest: binding.planDefinitionsDigest || null },
95
- predecessorAssignmentId: predecessor?.assignmentId || null,
96
- createdAt: at(now), authority: AUTHORITY });
97
- }
98
-
99
- function pointerFor(paths, assignment, previous, now) {
100
- return seal({ schema: POINTER_SCHEMA, sessionDigest: paths.digest,
101
- assignmentId: assignment.assignmentId, assignment,
102
- revision: (previous?.revision || 0) + 1,
103
- updatedAt: at(now), authority: AUTHORITY });
104
- }
105
-
106
- async function publishEvent(path, assignment, assertOwned) {
107
- const existing = await readJson(path);
108
- if (existing) {
109
- if (!validAssignment(existing, assignment.sessionDigest)
110
- || existing.assignmentId !== assignment.assignmentId
111
- || existing.eventDigest !== assignment.eventDigest) {
112
- throw new Error("delivery assignment event conflicts with stored history");
113
- }
114
- return existing;
115
- }
116
- await writePremortemFile(path, assignment, assertOwned, MAX_BYTES);
117
- return assignment;
118
- }
119
-
120
- export async function beginDeliveryAssignment({ root, binding, eventId, now = new Date() }) {
121
- if (typeof eventId !== "string" || !eventId || eventId.length > 512 || /[\0\r\n]/.test(eventId)) {
122
- throw new Error("delivery assignment requires an exact prompt eventId");
123
- }
124
- const paths = await pathsFor(root, binding);
125
- return withOwnedFileLock(paths.lock, async ({ assertOwned }) => {
126
- const previous = await readPointer(paths);
127
- const proposed = assignmentFor(binding, eventId, paths.digest, previous?.assignment || null, now);
128
- const path = join(paths.directory, "events", `${proposed.eventDigest}.json`);
129
- const assignment = await publishEvent(path, proposed, assertOwned);
130
- if (previous?.assignmentId === assignment.assignmentId) {
131
- return { status: "duplicate", blocked: false, assignmentId: assignment.assignmentId,
132
- assignment: structuredClone(assignment) };
133
- }
134
- if (assignment.predecessorAssignmentId !== (previous?.assignmentId || null)) {
135
- return { status: "stale-assignment", blocked: true,
136
- reason: "A replayed prompt cannot replace the current delivery assignment." };
137
- }
138
- await writePremortemFile(paths.pointer, pointerFor(paths, assignment, previous, now),
139
- assertOwned, MAX_BYTES);
140
- return { status: "started", blocked: false, assignmentId: assignment.assignmentId,
141
- assignment: structuredClone(assignment) };
142
- });
143
- }
144
-
145
- export async function resolveDeliveryAssignment({ root, binding, assignmentId = null }) {
146
- const paths = await pathsFor(root, binding);
147
- const pointer = await readPointer(paths);
148
- if (!pointer) return { status: "legacy", blocked: false, assignmentId: null, assignment: null };
149
- if (assignmentId && assignmentId !== pointer.assignmentId) {
150
- return { status: "foreign-assignment", blocked: true,
151
- reason: "The supplied delivery assignment is not active for this exact session and project." };
152
- }
153
- const stored = pointer.assignment.binding;
154
- for (const key of ["entityId", "groupId", "taskId"]) {
155
- if (stored[key] && binding[key] && stored[key] !== binding[key]) {
156
- return { status: "foreign-assignment", blocked: true,
157
- reason: `The active delivery assignment is bound to a different ${key}.` };
158
- }
159
- }
160
- return { status: "resolved", blocked: false, assignmentId: pointer.assignmentId,
161
- assignment: structuredClone(pointer.assignment) };
162
- }
163
-
164
- export async function continueDeliveryAssignment({ root, binding, assignmentId }) {
165
- if (!ID_RE.test(assignmentId || "")) {
166
- return { status: "foreign-assignment", blocked: true,
167
- reason: "Continuation requires the exact active assignmentId returned by this host session." };
168
- }
169
- const paths = await pathsFor(root, binding);
170
- // Serialize the check with new assignments. Continuation never advances the pointer
171
- // or rewrites history, including when a process exits during this inspection.
172
- return withOwnedFileLock(paths.lock, async () => {
173
- const current = await resolveDeliveryAssignment({ root, binding, assignmentId });
174
- if (current.blocked) return current;
175
- if (!current.assignment) return { status: "foreign-assignment", blocked: true,
176
- reason: "This session has no active assignment matching the continuation." };
177
- for (const key of ["entityId", "groupId", "taskId", "goalId", "goalStepId", "queueId",
178
- "gatewayAttempt", "planDefinitionsDigest"]) {
179
- if ((current.assignment.binding[key] || null) !== (binding[key] || null)) {
180
- return { status: "foreign-assignment", blocked: true,
181
- reason: `Continuation requires the same explicit ${key} binding, including absence.` };
182
- }
183
- }
184
- const exact = assignmentPremortemBinding(binding, current);
185
- const inspected = await inspectPremortemState({ root, binding: exact });
186
- if (inspected.blocked || inspected.status === "degraded") return inspected;
187
- if (!inspected.requirement) return { status: "missing", blocked: true,
188
- reason: "The exact continuation scope has no existing premortem requirement." };
189
- if (inspected.closed || inspected.consumed) return { status: "finalized", blocked: true,
190
- reason: "A completed assignment cannot be continued; a new delivery needs fresh preflight calls." };
191
- if (inspected.conflicted) return { status: "conflict", blocked: true,
192
- requirementId: inspected.requirementId,
193
- reason: "Continuation cannot repair a conflicted registration or bypass its recovery checks." };
194
- return { ...current, status: "continued", requirement: inspected.requirement,
195
- requirementId: inspected.requirementId, binding: exact };
196
- });
197
- }
198
-
199
- export async function withActiveDeliveryAssignment({ root, binding }, action) {
200
- const paths = await pathsFor(root, binding);
201
- return withOwnedFileLock(paths.lock, async ({ assertOwned }) => {
202
- const current = await resolveDeliveryAssignment({ root, binding,
203
- assignmentId: binding.assignmentId });
204
- if (current.blocked) return current;
205
- if (!current.assignment || current.assignmentId !== binding.assignmentId) {
206
- return { status: "foreign-assignment", blocked: true,
207
- reason: "Completion requires the active assignment for this session and project." };
208
- }
209
- const result = await action(assertOwned);
210
- await assertOwned();
211
- return result;
212
- });
213
- }
214
-
215
- export function assignmentPremortemBinding(binding, result) {
216
- if (binding.goalId || binding.queueId) return { ...binding, assignmentId: null };
217
- if (!result?.assignment) return { ...binding, assignmentId: null };
218
- return { ...binding, ...result.assignment.binding,
219
- assignmentId: result.assignment.assignmentId };
220
- }