blun-king-cli 9.1.643 → 9.1.645

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 (268) hide show
  1. package/CHANGELOG.md +19 -123
  2. package/LIESMICH.txt +17 -45
  3. package/README.md +15 -76
  4. package/RELEASE-9.1.645.md +29 -0
  5. package/bin/blun.js +3 -3
  6. package/bin/king.js +3 -3
  7. package/bin/launcher-mode.js +125 -126
  8. package/bin/launcher-runtime.js +603 -616
  9. package/bin/plugin-bootstrap.js +339 -405
  10. package/bin/rename-private-staging.cjs +2 -2
  11. package/bin/retired-bundled-plugins.cjs +84 -0
  12. package/bin/startup-security-host.cjs +105 -0
  13. package/bin/startup-security.cjs +9 -105
  14. package/bin/startup-warning-policy.cjs +22 -0
  15. package/bin/update-lease-installer.cjs +125 -0
  16. package/bin/update-lease-sockets.cjs +228 -0
  17. package/bin/update-lease.js +22 -327
  18. package/bin/verify-bundled-agent-sources.cjs +2 -4
  19. package/blun.mjs +77 -180
  20. package/bundled-agent-sources.json +1 -552
  21. package/package.json +3 -6
  22. package/tool-liveness642/receipt.json +1 -1
  23. package/worker-host.mjs +62 -120
  24. package/agent-spine-plugin/.claude-plugin/marketplace.json +0 -20
  25. package/agent-spine-plugin/.claude-plugin/plugin.json +0 -14
  26. package/agent-spine-plugin/.codex-plugin/plugin.json +0 -47
  27. package/agent-spine-plugin/.mcp.json +0 -8
  28. package/agent-spine-plugin/CHANGELOG.md +0 -1614
  29. package/agent-spine-plugin/LICENSE +0 -186
  30. package/agent-spine-plugin/README.md +0 -432
  31. package/agent-spine-plugin/assets/agentspine-banner.svg +0 -32
  32. package/agent-spine-plugin/bin/agentspine-mcp.js +0 -4
  33. package/agent-spine-plugin/bin/agentspine.js +0 -7
  34. package/agent-spine-plugin/blun.plugin.json +0 -68
  35. package/agent-spine-plugin/docs/acceptance.md +0 -61
  36. package/agent-spine-plugin/docs/artifact-evaluation.md +0 -93
  37. package/agent-spine-plugin/docs/host-integration.md +0 -193
  38. package/agent-spine-plugin/docs/preflight-recall.md +0 -71
  39. package/agent-spine-plugin/docs/preservation-contract.md +0 -53
  40. package/agent-spine-plugin/docs/quality-gates.md +0 -50
  41. package/agent-spine-plugin/docs/session-timeline.md +0 -112
  42. package/agent-spine-plugin/docs/source-roots.md +0 -113
  43. package/agent-spine-plugin/docs/world-model.md +0 -119
  44. package/agent-spine-plugin/hooks/codex.json +0 -47
  45. package/agent-spine-plugin/hooks/hooks.json +0 -106
  46. package/agent-spine-plugin/hooks/version.json +0 -5
  47. package/agent-spine-plugin/package.json +0 -77
  48. package/agent-spine-plugin/scripts/check-codex-install.js +0 -226
  49. package/agent-spine-plugin/scripts/check-hosts.js +0 -208
  50. package/agent-spine-plugin/scripts/check-install-hook.js +0 -227
  51. package/agent-spine-plugin/scripts/check-install-selfstarter.js +0 -154
  52. package/agent-spine-plugin/scripts/check-install.js +0 -478
  53. package/agent-spine-plugin/scripts/check-line-budget.js +0 -58
  54. package/agent-spine-plugin/scripts/check-syntax.js +0 -29
  55. package/agent-spine-plugin/scripts/github-actions.js +0 -11
  56. package/agent-spine-plugin/scripts/hermetic-process.js +0 -191
  57. package/agent-spine-plugin/scripts/release-check.js +0 -150
  58. package/agent-spine-plugin/scripts/run-acceptance.js +0 -19
  59. package/agent-spine-plugin/scripts/run-checks.js +0 -50
  60. package/agent-spine-plugin/scripts/run-tests-hermetic.js +0 -112
  61. package/agent-spine-plugin/skills/agent-spine/SKILL.md +0 -99
  62. package/agent-spine-plugin/spine-example/1-identity.md +0 -12
  63. package/agent-spine-plugin/spine-example/2-voice.md +0 -6
  64. package/agent-spine-plugin/spine-example/3-conduct.md +0 -8
  65. package/agent-spine-plugin/spine-example/4-history.md +0 -4
  66. package/agent-spine-plugin/src/cli-agent.js +0 -315
  67. package/agent-spine-plugin/src/cli-attention.js +0 -95
  68. package/agent-spine-plugin/src/cli-autonomy.js +0 -36
  69. package/agent-spine-plugin/src/cli-common.js +0 -71
  70. package/agent-spine-plugin/src/cli-continuity.js +0 -116
  71. package/agent-spine-plugin/src/cli-core.js +0 -128
  72. package/agent-spine-plugin/src/cli-diagnostics.js +0 -291
  73. package/agent-spine-plugin/src/cli-host.js +0 -21
  74. package/agent-spine-plugin/src/cli-learning.js +0 -320
  75. package/agent-spine-plugin/src/cli-premortem.js +0 -16
  76. package/agent-spine-plugin/src/cli-sharing.js +0 -230
  77. package/agent-spine-plugin/src/cli.js +0 -181
  78. package/agent-spine-plugin/src/codex-reader-launcher.js +0 -182
  79. package/agent-spine-plugin/src/hook.js +0 -500
  80. package/agent-spine-plugin/src/index.js +0 -108
  81. package/agent-spine-plugin/src/lib/acceptance.js +0 -435
  82. package/agent-spine-plugin/src/lib/action-lesson-recall.js +0 -118
  83. package/agent-spine-plugin/src/lib/attention-context.js +0 -167
  84. package/agent-spine-plugin/src/lib/attention-events.js +0 -113
  85. package/agent-spine-plugin/src/lib/attention-privacy.js +0 -72
  86. package/agent-spine-plugin/src/lib/attention-schema.js +0 -164
  87. package/agent-spine-plugin/src/lib/attention-storage.js +0 -93
  88. package/agent-spine-plugin/src/lib/attention.js +0 -164
  89. package/agent-spine-plugin/src/lib/audit-premortem.js +0 -223
  90. package/agent-spine-plugin/src/lib/audit.js +0 -401
  91. package/agent-spine-plugin/src/lib/authentication.js +0 -515
  92. package/agent-spine-plugin/src/lib/autonomy-policy.js +0 -110
  93. package/agent-spine-plugin/src/lib/autonomy-store.js +0 -202
  94. package/agent-spine-plugin/src/lib/autonomy.js +0 -8
  95. package/agent-spine-plugin/src/lib/briefing.js +0 -493
  96. package/agent-spine-plugin/src/lib/catalog-document-read.js +0 -51
  97. package/agent-spine-plugin/src/lib/catalog.js +0 -167
  98. package/agent-spine-plugin/src/lib/channel-continuity.js +0 -19
  99. package/agent-spine-plugin/src/lib/channel-runtime.js +0 -665
  100. package/agent-spine-plugin/src/lib/codex-installation.js +0 -231
  101. package/agent-spine-plugin/src/lib/codex-skill-installation.js +0 -211
  102. package/agent-spine-plugin/src/lib/context.js +0 -156
  103. package/agent-spine-plugin/src/lib/continuity.js +0 -338
  104. package/agent-spine-plugin/src/lib/coordination.js +0 -577
  105. package/agent-spine-plugin/src/lib/delivery-agent-usage.js +0 -231
  106. package/agent-spine-plugin/src/lib/delivery-assignment.js +0 -220
  107. package/agent-spine-plugin/src/lib/delivery-command-actions.js +0 -462
  108. package/agent-spine-plugin/src/lib/delivery-knowledge.js +0 -78
  109. package/agent-spine-plugin/src/lib/delivery-premortem-binding.js +0 -107
  110. package/agent-spine-plugin/src/lib/delivery-premortem-closure.js +0 -171
  111. package/agent-spine-plugin/src/lib/delivery-premortem-codec.js +0 -45
  112. package/agent-spine-plugin/src/lib/delivery-premortem-correction.js +0 -101
  113. package/agent-spine-plugin/src/lib/delivery-premortem-file.js +0 -21
  114. package/agent-spine-plugin/src/lib/delivery-premortem-index.js +0 -493
  115. package/agent-spine-plugin/src/lib/delivery-premortem-inspection.js +0 -37
  116. package/agent-spine-plugin/src/lib/delivery-premortem-recovery.js +0 -120
  117. package/agent-spine-plugin/src/lib/delivery-premortem-rejection.js +0 -65
  118. package/agent-spine-plugin/src/lib/delivery-premortem-results.js +0 -28
  119. package/agent-spine-plugin/src/lib/delivery-premortem-session-guard.js +0 -46
  120. package/agent-spine-plugin/src/lib/delivery-premortem-write-ledger.js +0 -285
  121. package/agent-spine-plugin/src/lib/delivery-premortem.js +0 -499
  122. package/agent-spine-plugin/src/lib/delivery-shell-heredoc.js +0 -115
  123. package/agent-spine-plugin/src/lib/delivery-shell-substitutions.js +0 -111
  124. package/agent-spine-plugin/src/lib/delivery-shell-wrapper.js +0 -64
  125. package/agent-spine-plugin/src/lib/delivery-target.js +0 -73
  126. package/agent-spine-plugin/src/lib/delivery-verification.js +0 -445
  127. package/agent-spine-plugin/src/lib/documents.js +0 -239
  128. package/agent-spine-plugin/src/lib/feed-transport.js +0 -499
  129. package/agent-spine-plugin/src/lib/filesystem-retry.js +0 -34
  130. package/agent-spine-plugin/src/lib/gateway-common.js +0 -68
  131. package/agent-spine-plugin/src/lib/gateway-control.js +0 -370
  132. package/agent-spine-plugin/src/lib/gateway-delivery.js +0 -103
  133. package/agent-spine-plugin/src/lib/gateway-execution.js +0 -350
  134. package/agent-spine-plugin/src/lib/gateway-group-response.js +0 -128
  135. package/agent-spine-plugin/src/lib/gateway-host-fencing.js +0 -92
  136. package/agent-spine-plugin/src/lib/gateway-host-lifecycle.js +0 -193
  137. package/agent-spine-plugin/src/lib/gateway-inspection.js +0 -85
  138. package/agent-spine-plugin/src/lib/gateway-knowledge.js +0 -129
  139. package/agent-spine-plugin/src/lib/gateway-policy-provenance.js +0 -197
  140. package/agent-spine-plugin/src/lib/gateway-premortem-disposition.js +0 -82
  141. package/agent-spine-plugin/src/lib/gateway-premortem.js +0 -363
  142. package/agent-spine-plugin/src/lib/gateway-prepared-host.js +0 -28
  143. package/agent-spine-plugin/src/lib/gateway-runs.js +0 -345
  144. package/agent-spine-plugin/src/lib/gateway-runtime-identity.js +0 -31
  145. package/agent-spine-plugin/src/lib/gateway-runtime-records.js +0 -21
  146. package/agent-spine-plugin/src/lib/gateway-runtime.js +0 -18
  147. package/agent-spine-plugin/src/lib/gateway-state-transaction.js +0 -356
  148. package/agent-spine-plugin/src/lib/gateway-state.js +0 -344
  149. package/agent-spine-plugin/src/lib/graph.js +0 -337
  150. package/agent-spine-plugin/src/lib/hook-artifact-guards.js +0 -356
  151. package/agent-spine-plugin/src/lib/hook-audit.js +0 -43
  152. package/agent-spine-plugin/src/lib/hook-briefing-use.js +0 -78
  153. package/agent-spine-plugin/src/lib/hook-context.js +0 -441
  154. package/agent-spine-plugin/src/lib/hook-final-message.js +0 -26
  155. package/agent-spine-plugin/src/lib/hook-input.js +0 -27
  156. package/agent-spine-plugin/src/lib/hook-output.js +0 -284
  157. package/agent-spine-plugin/src/lib/hook-premortem.js +0 -257
  158. package/agent-spine-plugin/src/lib/hook-process-advisory.js +0 -36
  159. package/agent-spine-plugin/src/lib/hook-protection.js +0 -95
  160. package/agent-spine-plugin/src/lib/hook-stop-verification.js +0 -84
  161. package/agent-spine-plugin/src/lib/hook-timeline.js +0 -102
  162. package/agent-spine-plugin/src/lib/host-instruction-budget.js +0 -11
  163. package/agent-spine-plugin/src/lib/https-transport.js +0 -392
  164. package/agent-spine-plugin/src/lib/identifier-analysis.js +0 -446
  165. package/agent-spine-plugin/src/lib/indexed-memory-offline.js +0 -40
  166. package/agent-spine-plugin/src/lib/indexed-memory.js +0 -298
  167. package/agent-spine-plugin/src/lib/knowledge-evidence.js +0 -431
  168. package/agent-spine-plugin/src/lib/learning-applications.js +0 -441
  169. package/agent-spine-plugin/src/lib/learning-artifact-evaluator.js +0 -114
  170. package/agent-spine-plugin/src/lib/learning-candidates.js +0 -274
  171. package/agent-spine-plugin/src/lib/learning-context.js +0 -137
  172. package/agent-spine-plugin/src/lib/learning-delivery-contracts.js +0 -310
  173. package/agent-spine-plugin/src/lib/learning-evaluation-contracts.js +0 -350
  174. package/agent-spine-plugin/src/lib/learning-evaluation-registration.js +0 -372
  175. package/agent-spine-plugin/src/lib/learning-evaluation-revocation.js +0 -292
  176. package/agent-spine-plugin/src/lib/learning-evidence-contracts.js +0 -321
  177. package/agent-spine-plugin/src/lib/learning-findings.js +0 -458
  178. package/agent-spine-plugin/src/lib/learning-measurement-contracts.js +0 -285
  179. package/agent-spine-plugin/src/lib/learning-measurements.js +0 -265
  180. package/agent-spine-plugin/src/lib/learning-outcome-contracts.js +0 -165
  181. package/agent-spine-plugin/src/lib/learning-outcomes.js +0 -343
  182. package/agent-spine-plugin/src/lib/learning-reconciliation.js +0 -290
  183. package/agent-spine-plugin/src/lib/learning-retry-contracts.js +0 -188
  184. package/agent-spine-plugin/src/lib/learning-schema.js +0 -229
  185. package/agent-spine-plugin/src/lib/learning-scope-targets.js +0 -424
  186. package/agent-spine-plugin/src/lib/learning-state-upgrade.js +0 -477
  187. package/agent-spine-plugin/src/lib/learning-status-configuration.js +0 -476
  188. package/agent-spine-plugin/src/lib/learning-storage.js +0 -203
  189. package/agent-spine-plugin/src/lib/learning-trial-recovery.js +0 -218
  190. package/agent-spine-plugin/src/lib/learning-validation-contracts.js +0 -375
  191. package/agent-spine-plugin/src/lib/learning-validation-renewal.js +0 -298
  192. package/agent-spine-plugin/src/lib/learning-validation-runtime.js +0 -234
  193. package/agent-spine-plugin/src/lib/learning.js +0 -36
  194. package/agent-spine-plugin/src/lib/lesson-recall-session.js +0 -172
  195. package/agent-spine-plugin/src/lib/mcp-autonomy-tools.js +0 -37
  196. package/agent-spine-plugin/src/lib/mcp-delivery-completion.js +0 -124
  197. package/agent-spine-plugin/src/lib/mcp-delivery-tools.js +0 -45
  198. package/agent-spine-plugin/src/lib/mcp-premortem.js +0 -68
  199. package/agent-spine-plugin/src/lib/mcp-runtime.js +0 -355
  200. package/agent-spine-plugin/src/lib/mcp-source-context.js +0 -61
  201. package/agent-spine-plugin/src/lib/mcp-timeline-tools.js +0 -240
  202. package/agent-spine-plugin/src/lib/mcp-world-tools.js +0 -52
  203. package/agent-spine-plugin/src/lib/object-transport.js +0 -206
  204. package/agent-spine-plugin/src/lib/owned-file-lock.js +0 -182
  205. package/agent-spine-plugin/src/lib/paths.js +0 -109
  206. package/agent-spine-plugin/src/lib/peer-transport.js +0 -283
  207. package/agent-spine-plugin/src/lib/persona-runtime.js +0 -581
  208. package/agent-spine-plugin/src/lib/pre-answer-timeline-recall.js +0 -104
  209. package/agent-spine-plugin/src/lib/preflight-delivery-id.js +0 -27
  210. package/agent-spine-plugin/src/lib/preflight.js +0 -688
  211. package/agent-spine-plugin/src/lib/project-portfolio.js +0 -176
  212. package/agent-spine-plugin/src/lib/runtime.js +0 -13
  213. package/agent-spine-plugin/src/lib/selfstarter-core.js +0 -382
  214. package/agent-spine-plugin/src/lib/selfstarter-jobs.js +0 -149
  215. package/agent-spine-plugin/src/lib/selfstarter-lease.js +0 -204
  216. package/agent-spine-plugin/src/lib/selfstarter-policy.js +0 -90
  217. package/agent-spine-plugin/src/lib/selfstarter-workspace.js +0 -111
  218. package/agent-spine-plugin/src/lib/selfstarter.js +0 -11
  219. package/agent-spine-plugin/src/lib/session-timeline-auth.js +0 -316
  220. package/agent-spine-plugin/src/lib/session-timeline-codex.js +0 -69
  221. package/agent-spine-plugin/src/lib/session-timeline-contract.js +0 -56
  222. package/agent-spine-plugin/src/lib/session-timeline-enrollment-source.js +0 -38
  223. package/agent-spine-plugin/src/lib/session-timeline-enrollment-storage.js +0 -128
  224. package/agent-spine-plugin/src/lib/session-timeline-enrollment-transport.js +0 -15
  225. package/agent-spine-plugin/src/lib/session-timeline-enrollment.js +0 -478
  226. package/agent-spine-plugin/src/lib/session-timeline-event-extract.js +0 -186
  227. package/agent-spine-plugin/src/lib/session-timeline-host-origin.js +0 -73
  228. package/agent-spine-plugin/src/lib/session-timeline-host-receipt.js +0 -117
  229. package/agent-spine-plugin/src/lib/session-timeline-invocation.js +0 -201
  230. package/agent-spine-plugin/src/lib/session-timeline-king.js +0 -93
  231. package/agent-spine-plugin/src/lib/session-timeline-prior.js +0 -57
  232. package/agent-spine-plugin/src/lib/session-timeline-provider.js +0 -36
  233. package/agent-spine-plugin/src/lib/session-timeline-query.js +0 -56
  234. package/agent-spine-plugin/src/lib/session-timeline-results.js +0 -56
  235. package/agent-spine-plugin/src/lib/session-timeline-root.js +0 -11
  236. package/agent-spine-plugin/src/lib/session-timeline-search.js +0 -82
  237. package/agent-spine-plugin/src/lib/session-timeline-sid-acl.js +0 -213
  238. package/agent-spine-plugin/src/lib/session-timeline-source-open.js +0 -30
  239. package/agent-spine-plugin/src/lib/session-timeline-source.js +0 -80
  240. package/agent-spine-plugin/src/lib/session-timeline-state.js +0 -45
  241. package/agent-spine-plugin/src/lib/session-timeline-transport.js +0 -42
  242. package/agent-spine-plugin/src/lib/session-timeline-windows-acl.js +0 -145
  243. package/agent-spine-plugin/src/lib/session-timeline.js +0 -462
  244. package/agent-spine-plugin/src/lib/sharing.js +0 -969
  245. package/agent-spine-plugin/src/lib/source-roots.js +0 -475
  246. package/agent-spine-plugin/src/lib/source-tree-scan.js +0 -178
  247. package/agent-spine-plugin/src/lib/sqlite-transport.js +0 -501
  248. package/agent-spine-plugin/src/lib/task-knowledge-context.js +0 -99
  249. package/agent-spine-plugin/src/lib/telegram-adapter.js +0 -119
  250. package/agent-spine-plugin/src/lib/timeline-continuation-update.js +0 -100
  251. package/agent-spine-plugin/src/lib/timeline-tool-guard.js +0 -225
  252. package/agent-spine-plugin/src/lib/timeline-user-feedback.js +0 -216
  253. package/agent-spine-plugin/src/lib/timeline-world-capture.js +0 -233
  254. package/agent-spine-plugin/src/lib/voice-runtime.js +0 -39
  255. package/agent-spine-plugin/src/lib/world-knowledge.js +0 -306
  256. package/agent-spine-plugin/src/lib/world-model.js +0 -333
  257. package/agent-spine-plugin/src/mcp.js +0 -456
  258. package/agent-spine-plugin/src/version.js +0 -1
  259. package/agent-spine-plugin/src/worker.js +0 -257
  260. package/bin/agentspine-king-goal-inbox.mjs +0 -127
  261. package/bin/agentspine-king-goal-intake.mjs +0 -106
  262. package/bin/agentspine-king-host-runner.mjs +0 -109
  263. package/bin/agentspine-king-snapshot-policy.cjs +0 -80
  264. package/bin/agentspine-king-status-policy.mjs +0 -226
  265. package/bin/agentspine-king-worker-host.mjs +0 -160
  266. package/bin/managed-plugin-selection.cjs +0 -141
  267. package/bin/verify-agent-behavior.cjs +0 -122
  268. package/bin/verify-agent-components.cjs +0 -104
@@ -1,501 +0,0 @@
1
- import { createHash, randomUUID } from "node:crypto";
2
- import { chmod, lstat, mkdir, realpath, stat } from "node:fs/promises";
3
- import { basename, dirname, resolve } from "node:path";
4
- import { verifyEnvelope } from "./authentication.js";
5
- import { buildCatalog } from "./catalog.js";
6
- import { buildHttpsSnapshot, importHttpsSnapshot, validateHttpsSnapshot } from "./https-transport.js";
7
- import { isInside } from "./paths.js";
8
- import { readDirectoryExchange } from "./sharing.js";
9
-
10
- const SCHEMA = "agentspine.sqlite/v1";
11
- const REVISION_SCHEMA = "agentspine.sqlite-revision/v1";
12
- const CONFIRMATION = "local-share-confirmed";
13
- const MAX_DATABASE_BYTES = 128 * 1024 * 1024;
14
- const MAX_SNAPSHOT_BYTES = 21 * 1024 * 1024;
15
- const MAX_REVISIONS = 1000;
16
- const ID_RE = /^[A-Za-z0-9][A-Za-z0-9:_.@/-]{0,127}$/;
17
- const DIGEST_RE = /^[a-f0-9]{64}$/;
18
- const TABLES = ["agentspine_head", "agentspine_meta", "agentspine_revisions"];
19
- const COLUMNS = {
20
- agentspine_meta: [
21
- ["id", "INTEGER", 0, 1], ["schema", "TEXT", 1, 0], ["scope_id", "TEXT", 1, 0],
22
- ["adapter_id", "TEXT", 1, 0], ["manifest_json", "TEXT", 1, 0],
23
- ["manifest_digest", "TEXT", 1, 0], ["signer_id", "TEXT", 1, 0],
24
- ["key_id", "TEXT", 1, 0], ["created_at", "TEXT", 1, 0], ["authority", "TEXT", 1, 0]
25
- ],
26
- agentspine_revisions: [
27
- ["sequence", "INTEGER", 0, 1], ["snapshot_id", "TEXT", 1, 0],
28
- ["snapshot_digest", "TEXT", 1, 0], ["previous_revision_digest", "TEXT", 0, 0],
29
- ["snapshot_json", "TEXT", 1, 0], ["created_at", "TEXT", 1, 0],
30
- ["authority", "TEXT", 1, 0], ["revision_digest", "TEXT", 1, 0]
31
- ],
32
- agentspine_head: [
33
- ["id", "INTEGER", 0, 1], ["sequence", "INTEGER", 1, 0],
34
- ["revision_digest", "TEXT", 1, 0], ["snapshot_digest", "TEXT", 1, 0],
35
- ["authority", "TEXT", 1, 0]
36
- ]
37
- };
38
-
39
- function canonical(value) {
40
- if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
41
- if (value && typeof value === "object") {
42
- return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(",")}}`;
43
- }
44
- return JSON.stringify(value);
45
- }
46
-
47
- function digest(value) {
48
- return createHash("sha256").update(canonical(value)).digest("hex");
49
- }
50
-
51
- function exactKeys(value, expected) {
52
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
53
- const actual = Object.keys(value).sort();
54
- const wanted = [...expected].sort();
55
- return actual.length === wanted.length && actual.every((key, index) => key === wanted[index]);
56
- }
57
-
58
- function validDate(value) {
59
- return typeof value === "string" && value.length > 0 && Number.isFinite(new Date(value).getTime());
60
- }
61
-
62
- async function sqliteModule() {
63
- const [major, minor] = process.versions.node.split(".").map(Number);
64
- if (major < 22 || (major === 22 && minor < 13)) {
65
- throw new Error("SQLite transport requires Node.js 22.13 or newer with node:sqlite support");
66
- }
67
- try {
68
- return await import("node:sqlite");
69
- } catch (error) {
70
- throw new Error("SQLite transport requires Node.js 22.13 or newer with node:sqlite support", {
71
- cause: error
72
- });
73
- }
74
- }
75
-
76
- async function prospectiveCanonicalPath(path) {
77
- let ancestor = path;
78
- const missing = [];
79
- while (true) {
80
- try {
81
- const canonicalAncestor = await realpath(ancestor);
82
- return resolve(canonicalAncestor, ...missing.reverse());
83
- } catch (error) {
84
- if (error.code !== "ENOENT") throw error;
85
- const parent = dirname(ancestor);
86
- if (parent === ancestor) throw error;
87
- missing.push(basename(ancestor));
88
- ancestor = parent;
89
- }
90
- }
91
- }
92
-
93
- async function databasePath(root, database, { create = false } = {}) {
94
- if (!database || typeof database !== "string" || database === ":memory:") {
95
- throw new Error("a file-backed SQLite database path is required");
96
- }
97
- const catalog = await buildCatalog(root);
98
- const target = resolve(database);
99
- const canonicalTarget = await prospectiveCanonicalPath(target);
100
- if (isInside(catalog.root, canonicalTarget)) {
101
- throw new Error("SQLite transport database must remain outside the scanned project");
102
- }
103
- if (create) await mkdir(dirname(target), { recursive: true, mode: 0o700 });
104
- let metadata = null;
105
- try {
106
- metadata = await lstat(target);
107
- } catch (error) {
108
- if (error.code !== "ENOENT" || !create) throw error;
109
- }
110
- if (metadata && (!metadata.isFile() || metadata.isSymbolicLink())) {
111
- throw new Error("SQLite transport path must be a real regular file");
112
- }
113
- if (metadata && metadata.nlink !== 1) {
114
- throw new Error("SQLite transport database must not be a hard link");
115
- }
116
- if (metadata && metadata.size > MAX_DATABASE_BYTES) {
117
- throw new Error("SQLite transport database exceeds the 128 MiB limit");
118
- }
119
- for (const suffix of ["-journal", "-wal", "-shm"]) {
120
- try {
121
- const sidecar = await lstat(`${target}${suffix}`);
122
- if (!metadata) throw new Error("SQLite transport sidecar exists without its database");
123
- if (!sidecar.isFile() || sidecar.isSymbolicLink() || sidecar.nlink !== 1) {
124
- throw new Error("SQLite transport sidecars must be real, single-link regular files");
125
- }
126
- if (sidecar.size > MAX_DATABASE_BYTES) throw new Error("SQLite transport sidecar exceeds the 128 MiB limit");
127
- } catch (error) {
128
- if (error.code !== "ENOENT") throw error;
129
- }
130
- }
131
- const parent = await realpath(dirname(target));
132
- if (isInside(catalog.root, parent)) {
133
- throw new Error("SQLite transport database must remain outside the scanned project");
134
- }
135
- return { catalog, target: resolve(parent, basename(target)), exists: Boolean(metadata) };
136
- }
137
-
138
- async function openDatabase(path, { readOnly = false } = {}) {
139
- const { DatabaseSync } = await sqliteModule();
140
- let database;
141
- try {
142
- database = new DatabaseSync(path, {
143
- readOnly, enableForeignKeyConstraints: true,
144
- enableDoubleQuotedStringLiterals: false, allowExtension: false
145
- });
146
- } catch (error) {
147
- throw new Error(`SQLite transport database could not be opened: ${error.message}`, { cause: error });
148
- }
149
- try {
150
- database.exec("PRAGMA trusted_schema = OFF; PRAGMA foreign_keys = ON; PRAGMA busy_timeout = 5000;");
151
- if (typeof database.enableDefensive === "function") database.enableDefensive(true);
152
- if (readOnly) database.exec("PRAGMA query_only = ON;");
153
- else database.exec("PRAGMA synchronous = FULL;");
154
- return database;
155
- } catch (error) {
156
- database.close();
157
- throw error;
158
- }
159
- }
160
-
161
- function createSchema(database) {
162
- database.exec(`
163
- CREATE TABLE IF NOT EXISTS agentspine_meta (
164
- id INTEGER PRIMARY KEY CHECK (id = 1),
165
- schema TEXT NOT NULL CHECK (schema = 'agentspine.sqlite/v1'),
166
- scope_id TEXT NOT NULL,
167
- adapter_id TEXT NOT NULL,
168
- manifest_json TEXT NOT NULL,
169
- manifest_digest TEXT NOT NULL,
170
- signer_id TEXT NOT NULL,
171
- key_id TEXT NOT NULL,
172
- created_at TEXT NOT NULL,
173
- authority TEXT NOT NULL CHECK (authority = 'context-only')
174
- ) STRICT;
175
- CREATE TABLE IF NOT EXISTS agentspine_revisions (
176
- sequence INTEGER PRIMARY KEY CHECK (sequence > 0),
177
- snapshot_id TEXT NOT NULL,
178
- snapshot_digest TEXT NOT NULL UNIQUE,
179
- previous_revision_digest TEXT,
180
- snapshot_json TEXT NOT NULL,
181
- created_at TEXT NOT NULL,
182
- authority TEXT NOT NULL CHECK (authority = 'context-only'),
183
- revision_digest TEXT NOT NULL UNIQUE
184
- ) STRICT;
185
- CREATE TABLE IF NOT EXISTS agentspine_head (
186
- id INTEGER PRIMARY KEY CHECK (id = 1),
187
- sequence INTEGER NOT NULL,
188
- revision_digest TEXT NOT NULL,
189
- snapshot_digest TEXT NOT NULL,
190
- authority TEXT NOT NULL CHECK (authority = 'context-only')
191
- ) STRICT;
192
- PRAGMA user_version = 1;
193
- `);
194
- }
195
-
196
- function parseJson(value, label, maximum = MAX_SNAPSHOT_BYTES) {
197
- if (typeof value !== "string" || Buffer.byteLength(value) > maximum) {
198
- throw new Error(`${label} exceeds its validation limit`);
199
- }
200
- try {
201
- return JSON.parse(value);
202
- } catch {
203
- throw new Error(`${label} is not valid JSON`);
204
- }
205
- }
206
-
207
- function validateSchema(database) {
208
- const integrity = database.prepare("PRAGMA integrity_check").get();
209
- if (!integrity || Object.values(integrity)[0] !== "ok") throw new Error("SQLite transport integrity check failed");
210
- const objects = database.prepare(`
211
- SELECT type, name FROM sqlite_master
212
- WHERE name NOT LIKE 'sqlite_%'
213
- ORDER BY type, name
214
- `).all();
215
- if (objects.length !== TABLES.length
216
- || objects.some((item) => item.type !== "table")
217
- || objects.map((item) => item.name).sort().some((name, index) => name !== TABLES[index])) {
218
- throw new Error("SQLite transport schema contains missing or unexpected objects");
219
- }
220
- for (const table of TABLES) {
221
- const columns = database.prepare(`PRAGMA table_info(${table})`).all();
222
- const expected = COLUMNS[table];
223
- if (columns.length !== expected.length || columns.some((column, index) => {
224
- const wanted = expected[index];
225
- return column.name !== wanted[0] || String(column.type).toUpperCase() !== wanted[1]
226
- || Number(column.notnull) !== wanted[2] || Number(column.pk) !== wanted[3]
227
- || column.dflt_value !== null;
228
- })) throw new Error(`SQLite transport table layout is invalid: ${table}`);
229
- }
230
- for (const table of ["agentspine_meta", "agentspine_head"]) {
231
- if (database.prepare(`PRAGMA index_list(${table})`).all().length !== 0) {
232
- throw new Error(`SQLite transport table has an unexpected index: ${table}`);
233
- }
234
- }
235
- const revisionIndexes = database.prepare("PRAGMA index_list(agentspine_revisions)").all();
236
- if (revisionIndexes.length !== 2 || revisionIndexes.some((index) => (
237
- Number(index.unique) !== 1 || index.origin !== "u" || Number(index.partial) !== 0
238
- ))) throw new Error("SQLite transport revision indexes are invalid");
239
- const expectedIndexes = new Map([
240
- ["sqlite_autoindex_agentspine_revisions_1", "snapshot_digest"],
241
- ["sqlite_autoindex_agentspine_revisions_2", "revision_digest"]
242
- ]);
243
- for (const index of revisionIndexes) {
244
- const expectedColumn = expectedIndexes.get(index.name);
245
- if (!expectedColumn) throw new Error("SQLite transport revision indexes are invalid");
246
- const columns = database.prepare(`PRAGMA index_info(${index.name})`).all();
247
- if (columns.length !== 1 || columns[0].name !== expectedColumn) {
248
- throw new Error("SQLite transport revision indexes are invalid");
249
- }
250
- }
251
- const version = database.prepare("PRAGMA user_version").get();
252
- if (!version || Number(Object.values(version)[0]) !== 1) throw new Error("SQLite transport schema version is unsupported");
253
- }
254
-
255
- function validateManifestMetadata(row) {
256
- if (!row || row.schema !== SCHEMA || !ID_RE.test(row.scope_id || "")
257
- || !ID_RE.test(row.adapter_id || "") || !ID_RE.test(row.signer_id || "")
258
- || !ID_RE.test(row.key_id || "") || !DIGEST_RE.test(row.manifest_digest || "")
259
- || !validDate(row.created_at) || row.authority !== "context-only") {
260
- throw new Error("SQLite transport metadata is invalid");
261
- }
262
- const manifest = parseJson(row.manifest_json, "SQLite signed manifest", 64 * 1024);
263
- const verified = verifyEnvelope(manifest, "manifest");
264
- if (digest(manifest) !== row.manifest_digest
265
- || verified.payload?.scopeId !== row.scope_id || verified.payload?.adapterId !== row.adapter_id
266
- || verified.payload?.adapter !== "directory" || verified.publicIdentity.signerId !== row.signer_id
267
- || verified.publicIdentity.keyId !== row.key_id) {
268
- throw new Error("SQLite transport metadata does not match its signed manifest");
269
- }
270
- return { manifest, verified };
271
- }
272
-
273
- function revisionBody(row) {
274
- return {
275
- schema: REVISION_SCHEMA, sequence: row.sequence, snapshotId: row.snapshot_id,
276
- snapshotDigest: row.snapshot_digest, previousRevisionDigest: row.previous_revision_digest,
277
- createdAt: row.created_at, authority: row.authority
278
- };
279
- }
280
-
281
- function readValidatedState(database) {
282
- validateSchema(database);
283
- const metadata = database.prepare("SELECT * FROM agentspine_meta WHERE id = 1").get();
284
- const { manifest, verified } = validateManifestMetadata(metadata);
285
- const rows = database.prepare("SELECT * FROM agentspine_revisions ORDER BY sequence").all();
286
- if (rows.length > MAX_REVISIONS) throw new Error(`SQLite transport exceeds ${MAX_REVISIONS} retained revisions`);
287
- let previousDigest = null;
288
- let totalBytes = 0;
289
- const revisions = rows.map((row, index) => {
290
- totalBytes += Buffer.byteLength(row.snapshot_json || "");
291
- if (totalBytes > MAX_DATABASE_BYTES) throw new Error("SQLite transport retained snapshots exceed the 128 MiB limit");
292
- if (Number(row.sequence) !== index + 1 || !ID_RE.test(row.snapshot_id || "")
293
- || !DIGEST_RE.test(row.snapshot_digest || "")
294
- || row.previous_revision_digest !== previousDigest || !validDate(row.created_at)
295
- || row.authority !== "context-only" || !DIGEST_RE.test(row.revision_digest || "")
296
- || digest(revisionBody(row)) !== row.revision_digest) {
297
- throw new Error("SQLite transport revision chain is invalid");
298
- }
299
- const snapshot = validateHttpsSnapshot(parseJson(row.snapshot_json, "SQLite snapshot"));
300
- if (snapshot.digest !== row.snapshot_digest || snapshot.snapshotId !== row.snapshot_id
301
- || snapshot.scopeId !== metadata.scope_id || snapshot.adapterId !== metadata.adapter_id
302
- || digest(snapshot.manifest) !== metadata.manifest_digest) {
303
- throw new Error("SQLite transport revision does not match its authenticated metadata");
304
- }
305
- previousDigest = row.revision_digest;
306
- return { ...row, snapshot };
307
- });
308
- const head = database.prepare("SELECT * FROM agentspine_head WHERE id = 1").get();
309
- if (revisions.length === 0) {
310
- if (head) throw new Error("SQLite transport head exists without a revision");
311
- } else {
312
- const latest = revisions.at(-1);
313
- if (!head || !exactKeys(head, ["id", "sequence", "revision_digest", "snapshot_digest", "authority"])
314
- || Number(head.sequence) !== latest.sequence || head.revision_digest !== latest.revision_digest
315
- || head.snapshot_digest !== latest.snapshot_digest || head.authority !== "context-only") {
316
- throw new Error("SQLite transport head does not match the append-only revision chain");
317
- }
318
- }
319
- return { metadata, manifest, verified, revisions, head };
320
- }
321
-
322
- async function secureFile(path) {
323
- await chmod(path, 0o600);
324
- const metadata = await stat(path);
325
- if (!metadata.isFile() || metadata.nlink !== 1 || metadata.size > MAX_DATABASE_BYTES) {
326
- throw new Error("SQLite transport database is not a bounded regular file");
327
- }
328
- }
329
-
330
- export async function initSqliteAdapter({
331
- root = process.cwd(), directory, database, confirmation, now = new Date()
332
- }) {
333
- if (confirmation !== CONFIRMATION) throw new Error("SQLite adapter initialization requires explicit local owner confirmation");
334
- const exchange = await readDirectoryExchange({ root, directory, requireAuthenticated: true });
335
- const manifestVerification = verifyEnvelope(exchange.manifest, "manifest");
336
- const location = await databasePath(root, database, { create: true });
337
- const connection = await openDatabase(location.target);
338
- let completed = false;
339
- let created = false;
340
- try {
341
- connection.exec("BEGIN IMMEDIATE");
342
- try {
343
- createSchema(connection);
344
- const existing = connection.prepare("SELECT * FROM agentspine_meta WHERE id = 1").get();
345
- if (existing) {
346
- const validated = validateManifestMetadata(existing);
347
- if (existing.scope_id !== exchange.scopeId || existing.adapter_id !== exchange.adapterId
348
- || existing.manifest_digest !== digest(exchange.manifest)
349
- || validated.verified.publicIdentity.keyId !== manifestVerification.publicIdentity.keyId) {
350
- throw new Error("SQLite transport already belongs to a different signed adapter");
351
- }
352
- } else {
353
- created = true;
354
- connection.prepare(`
355
- INSERT INTO agentspine_meta
356
- (id, schema, scope_id, adapter_id, manifest_json, manifest_digest, signer_id, key_id, created_at, authority)
357
- VALUES (1, ?, ?, ?, ?, ?, ?, ?, ?, 'context-only')
358
- `).run(
359
- SCHEMA, exchange.scopeId, exchange.adapterId, JSON.stringify(exchange.manifest), digest(exchange.manifest),
360
- manifestVerification.publicIdentity.signerId, manifestVerification.publicIdentity.keyId,
361
- new Date(now).toISOString()
362
- );
363
- }
364
- connection.exec("COMMIT");
365
- } catch (error) {
366
- try { connection.exec("ROLLBACK"); } catch {}
367
- throw error;
368
- }
369
- const state = readValidatedState(connection);
370
- completed = true;
371
- return {
372
- created, database: location.target, schema: SCHEMA,
373
- scopeId: state.metadata.scope_id, adapterId: state.metadata.adapter_id,
374
- signer: { signerId: state.metadata.signer_id, keyId: state.metadata.key_id },
375
- revisions: state.revisions.length, authority: "context-only"
376
- };
377
- } finally {
378
- connection.close();
379
- if (completed) await secureFile(location.target);
380
- }
381
- }
382
-
383
- export async function publishSqliteSnapshot({
384
- root = process.cwd(), directory, database, snapshotId = `snapshot:${randomUUID()}`,
385
- confirmation, now = new Date()
386
- }) {
387
- if (confirmation !== CONFIRMATION) throw new Error("SQLite snapshot publication requires explicit local owner confirmation");
388
- const snapshot = await buildHttpsSnapshot({ root, directory, snapshotId, now });
389
- const location = await databasePath(root, database);
390
- const connection = await openDatabase(location.target);
391
- let completed = false;
392
- try {
393
- connection.exec("BEGIN IMMEDIATE");
394
- try {
395
- const state = readValidatedState(connection);
396
- if (snapshot.scopeId !== state.metadata.scope_id || snapshot.adapterId !== state.metadata.adapter_id
397
- || digest(snapshot.manifest) !== state.metadata.manifest_digest) {
398
- throw new Error("SQLite snapshot does not belong to this authenticated adapter");
399
- }
400
- const existing = connection.prepare("SELECT * FROM agentspine_revisions WHERE snapshot_digest = ?").get(snapshot.digest);
401
- if (existing) {
402
- connection.exec("COMMIT");
403
- completed = true;
404
- return {
405
- created: false, database: location.target, sequence: existing.sequence,
406
- snapshotId: existing.snapshot_id, snapshotDigest: existing.snapshot_digest,
407
- revisionDigest: existing.revision_digest, events: snapshot.events.length,
408
- authority: "context-only"
409
- };
410
- }
411
- const sequence = state.revisions.length + 1;
412
- const previousRevisionDigest = state.revisions.at(-1)?.revision_digest || null;
413
- const createdAt = new Date(now).toISOString();
414
- if (!validDate(createdAt)) throw new Error("now must be a valid date");
415
- const body = {
416
- schema: REVISION_SCHEMA, sequence, snapshotId: snapshot.snapshotId,
417
- snapshotDigest: snapshot.digest, previousRevisionDigest, createdAt,
418
- authority: "context-only"
419
- };
420
- const revisionDigest = digest(body);
421
- connection.prepare(`
422
- INSERT INTO agentspine_revisions
423
- (sequence, snapshot_id, snapshot_digest, previous_revision_digest, snapshot_json, created_at, authority, revision_digest)
424
- VALUES (?, ?, ?, ?, ?, ?, 'context-only', ?)
425
- `).run(sequence, snapshot.snapshotId, snapshot.digest, previousRevisionDigest, JSON.stringify(snapshot), createdAt, revisionDigest);
426
- if (state.head) {
427
- const changed = connection.prepare(`
428
- UPDATE agentspine_head SET sequence = ?, revision_digest = ?, snapshot_digest = ?
429
- WHERE id = 1 AND sequence = ? AND revision_digest = ? AND authority = 'context-only'
430
- `).run(sequence, revisionDigest, snapshot.digest, state.head.sequence, state.head.revision_digest);
431
- if (Number(changed.changes) !== 1) throw new Error("SQLite transport head changed concurrently");
432
- } else {
433
- connection.prepare(`
434
- INSERT INTO agentspine_head (id, sequence, revision_digest, snapshot_digest, authority)
435
- VALUES (1, ?, ?, ?, 'context-only')
436
- `).run(sequence, revisionDigest, snapshot.digest);
437
- }
438
- connection.exec("COMMIT");
439
- completed = true;
440
- return {
441
- created: true, database: location.target, sequence, snapshotId: snapshot.snapshotId,
442
- snapshotDigest: snapshot.digest, revisionDigest, previousRevisionDigest,
443
- events: snapshot.events.length, authority: "context-only"
444
- };
445
- } catch (error) {
446
- try { connection.exec("ROLLBACK"); } catch {}
447
- throw error;
448
- }
449
- } finally {
450
- connection.close();
451
- if (completed) await secureFile(location.target);
452
- }
453
- }
454
-
455
- export async function inspectSqliteAdapter({ root = process.cwd(), database }) {
456
- const location = await databasePath(root, database);
457
- const connection = await openDatabase(location.target, { readOnly: true });
458
- try {
459
- const state = readValidatedState(connection);
460
- return {
461
- database: location.target, schema: SCHEMA, scopeId: state.metadata.scope_id,
462
- adapterId: state.metadata.adapter_id,
463
- signer: { signerId: state.metadata.signer_id, keyId: state.metadata.key_id },
464
- revisions: state.revisions.length,
465
- head: state.head ? {
466
- sequence: state.head.sequence, revisionDigest: state.head.revision_digest,
467
- snapshotDigest: state.head.snapshot_digest
468
- } : null,
469
- snapshots: state.revisions.map((item) => ({
470
- sequence: item.sequence, snapshotId: item.snapshot_id,
471
- snapshotDigest: item.snapshot_digest, revisionDigest: item.revision_digest,
472
- previousRevisionDigest: item.previous_revision_digest, createdAt: item.created_at,
473
- events: item.snapshot.events.length, authority: "context-only"
474
- })),
475
- authority: "context-only"
476
- };
477
- } finally {
478
- connection.close();
479
- }
480
- }
481
-
482
- export async function pullSqliteSnapshot({ root = process.cwd(), database, now = new Date() }) {
483
- const location = await databasePath(root, database);
484
- const connection = await openDatabase(location.target, { readOnly: true });
485
- let snapshot;
486
- let revision;
487
- try {
488
- const state = readValidatedState(connection);
489
- revision = state.revisions.at(-1);
490
- if (!revision) throw new Error("SQLite transport has no published snapshot");
491
- snapshot = structuredClone(revision.snapshot);
492
- } finally {
493
- connection.close();
494
- }
495
- const imported = await importHttpsSnapshot({ root, snapshot, now });
496
- return {
497
- ...imported, transport: "sqlite", database: location.target,
498
- sequence: revision.sequence, revisionDigest: revision.revision_digest,
499
- authority: "context-only"
500
- };
501
- }
@@ -1,99 +0,0 @@
1
- import {
2
- relevantUserFeedback, relevantUserFeedbackInterpretation
3
- } from "./timeline-user-feedback.js";
4
-
5
- const MAX_ITEMS = 6;
6
- const STOP_WORDS = new Set([
7
- "and", "are", "das", "der", "die", "eine", "einer", "for", "from", "für", "ist",
8
- "mit", "soll", "that", "the", "this", "und", "von", "was", "with"
9
- ]);
10
- const KIND_WEIGHT = {
11
- "error-lesson": 40,
12
- decision: 30,
13
- "user-preference": 20,
14
- fact: 10
15
- };
16
-
17
- function terms(value) {
18
- return [...new Set(String(value).normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase()
19
- .match(/[\p{L}\p{N}]+/gu)?.filter((item) => item.length >= 3 && !STOP_WORDS.has(item)) || [])]
20
- .slice(0, 64);
21
- }
22
-
23
- function taskText(task) {
24
- return [task.objective, task.nextStep?.summary,
25
- ...task.openQuestions.map((item) => item.question)].filter(Boolean).join(" ");
26
- }
27
-
28
- function entryText(entry) {
29
- return [entry.subjectId, entry.predicate, JSON.stringify(entry.value), entry.rationale]
30
- .filter(Boolean).join(" ").slice(0, 12_288);
31
- }
32
-
33
- function empty(taskId, status) {
34
- return {
35
- schema: "agentspine.task-knowledge-context/v1",
36
- taskId,
37
- status,
38
- items: [],
39
- omitted: 0,
40
- authority: "context-only"
41
- };
42
- }
43
-
44
- export function taskKnowledgeContext(entries, { taskId = null, continuation, maxItems = MAX_ITEMS } = {}) {
45
- if (!taskId) return empty(null, "not-requested");
46
- const task = [...continuation.tasks, ...continuation.terminal].find((item) => item.taskId === taskId);
47
- if (!task) {
48
- const terminal = continuation.terminal.some((item) => item.taskId === taskId);
49
- return empty(taskId, terminal ? "terminal" : "unavailable");
50
- }
51
- const queryTerms = terms(taskText(task));
52
- if (!queryTerms.length) return empty(taskId, "no-query");
53
- const querySet = new Set(queryTerms);
54
- const minimumMatches = Math.min(2, queryTerms.length);
55
- const seen = new Set();
56
- const ranked = [];
57
- const feedbackIds = entries.filter((entry) => relevantUserFeedback(entry, task))
58
- .map((entry) => entry.id).sort();
59
- for (const entry of entries) {
60
- if (relevantUserFeedback(entry, task)) {
61
- ranked.push({ entry, matchedTerms: [], score: 100_000 });
62
- continue;
63
- }
64
- if (relevantUserFeedbackInterpretation(entry, task)) {
65
- const sourceIds = [...(entry.value.sourceBindings?.map((item) => item.feedbackAssertionId)
66
- || [entry.value.sourceFeedbackAssertionId])].sort();
67
- if (sourceIds.length === feedbackIds.length
68
- && sourceIds.every((id, index) => id === feedbackIds[index])) {
69
- ranked.push({ entry, matchedTerms: [], score: 99_999 });
70
- }
71
- continue;
72
- }
73
- if (task.status === "completed") continue;
74
- if (entry.status !== "confirmed" || !(entry.kind in KIND_WEIGHT)) continue;
75
- const matchedTerms = terms(entryText(entry)).filter((item) => querySet.has(item));
76
- if (matchedTerms.length < minimumMatches) continue;
77
- const key = `${entry.kind}\0${entry.subjectId}\0${entry.predicate}\0${JSON.stringify(entry.value)}`;
78
- if (seen.has(key)) continue;
79
- seen.add(key);
80
- ranked.push({ entry, matchedTerms,
81
- score: matchedTerms.length * 100 + KIND_WEIGHT[entry.kind] });
82
- }
83
- ranked.sort((left, right) => right.score - left.score
84
- || right.entry.observedAt.localeCompare(left.entry.observedAt)
85
- || left.entry.id.localeCompare(right.entry.id));
86
- if (task.status === "completed" && !ranked.length) return empty(taskId, "terminal");
87
- const limit = Math.min(MAX_ITEMS, Math.max(1, maxItems));
88
- return {
89
- schema: "agentspine.task-knowledge-context/v1",
90
- taskId,
91
- status: ranked.length ? "available" : "no-match",
92
- items: ranked.slice(0, limit).map(({ entry, matchedTerms }) => ({
93
- ...structuredClone(entry),
94
- relevance: { matchedTerms, authority: "context-only" }
95
- })),
96
- omitted: Math.max(0, ranked.length - limit),
97
- authority: "context-only"
98
- };
99
- }