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.
- package/LIESMICH.txt +18 -0
- package/README.md +20 -6
- package/bin/blun.js +3 -3
- package/bin/king.js +3 -3
- package/bin/launcher-mode.js +125 -126
- package/bin/launcher-runtime.js +603 -616
- package/bin/plugin-bootstrap.js +339 -405
- package/bin/rename-private-staging.cjs +2 -2
- package/bin/retired-bundled-plugins.cjs +84 -0
- package/bin/startup-security-host.cjs +105 -0
- package/bin/startup-security.cjs +9 -105
- package/bin/startup-warning-policy.cjs +22 -0
- package/bin/update-lease-installer.cjs +125 -0
- package/bin/update-lease-sockets.cjs +228 -0
- package/bin/update-lease.js +22 -327
- package/bin/verify-bundled-agent-sources.cjs +2 -4
- package/blun.mjs +78 -193
- package/bundled-agent-sources.json +1 -552
- package/package.json +4 -6
- package/tool-liveness642/index.cjs +7 -0
- package/tool-liveness642/queue-delivery.cjs +109 -0
- package/tool-liveness642/receipt.json +40 -0
- package/tool-liveness642/shell-yield.cjs +43 -0
- package/tool-liveness642/task-wait.cjs +45 -0
- package/versionierung/BELEG.json +43 -0
- package/versionierung/LIESMICH.md +5 -0
- package/versionierung/urspruenglicher-overlay-beleg.json +39 -0
- package/worker-host.mjs +48 -128
- package/agent-spine-plugin/.claude-plugin/marketplace.json +0 -20
- package/agent-spine-plugin/.claude-plugin/plugin.json +0 -14
- package/agent-spine-plugin/.codex-plugin/plugin.json +0 -47
- package/agent-spine-plugin/.mcp.json +0 -8
- package/agent-spine-plugin/CHANGELOG.md +0 -1614
- package/agent-spine-plugin/LICENSE +0 -186
- package/agent-spine-plugin/README.md +0 -432
- package/agent-spine-plugin/assets/agentspine-banner.svg +0 -32
- package/agent-spine-plugin/bin/agentspine-mcp.js +0 -4
- package/agent-spine-plugin/bin/agentspine.js +0 -7
- package/agent-spine-plugin/blun.plugin.json +0 -68
- package/agent-spine-plugin/docs/acceptance.md +0 -61
- package/agent-spine-plugin/docs/artifact-evaluation.md +0 -93
- package/agent-spine-plugin/docs/host-integration.md +0 -193
- package/agent-spine-plugin/docs/preflight-recall.md +0 -71
- package/agent-spine-plugin/docs/preservation-contract.md +0 -53
- package/agent-spine-plugin/docs/quality-gates.md +0 -50
- package/agent-spine-plugin/docs/session-timeline.md +0 -112
- package/agent-spine-plugin/docs/source-roots.md +0 -113
- package/agent-spine-plugin/docs/world-model.md +0 -119
- package/agent-spine-plugin/hooks/codex.json +0 -47
- package/agent-spine-plugin/hooks/hooks.json +0 -106
- package/agent-spine-plugin/hooks/version.json +0 -5
- package/agent-spine-plugin/package.json +0 -77
- package/agent-spine-plugin/scripts/check-codex-install.js +0 -226
- package/agent-spine-plugin/scripts/check-hosts.js +0 -208
- package/agent-spine-plugin/scripts/check-install-hook.js +0 -227
- package/agent-spine-plugin/scripts/check-install-selfstarter.js +0 -154
- package/agent-spine-plugin/scripts/check-install.js +0 -478
- package/agent-spine-plugin/scripts/check-line-budget.js +0 -58
- package/agent-spine-plugin/scripts/check-syntax.js +0 -29
- package/agent-spine-plugin/scripts/github-actions.js +0 -11
- package/agent-spine-plugin/scripts/hermetic-process.js +0 -191
- package/agent-spine-plugin/scripts/release-check.js +0 -150
- package/agent-spine-plugin/scripts/run-acceptance.js +0 -19
- package/agent-spine-plugin/scripts/run-checks.js +0 -50
- package/agent-spine-plugin/scripts/run-tests-hermetic.js +0 -112
- package/agent-spine-plugin/skills/agent-spine/SKILL.md +0 -99
- package/agent-spine-plugin/spine-example/1-identity.md +0 -12
- package/agent-spine-plugin/spine-example/2-voice.md +0 -6
- package/agent-spine-plugin/spine-example/3-conduct.md +0 -8
- package/agent-spine-plugin/spine-example/4-history.md +0 -4
- package/agent-spine-plugin/src/cli-agent.js +0 -315
- package/agent-spine-plugin/src/cli-attention.js +0 -95
- package/agent-spine-plugin/src/cli-autonomy.js +0 -36
- package/agent-spine-plugin/src/cli-common.js +0 -71
- package/agent-spine-plugin/src/cli-continuity.js +0 -116
- package/agent-spine-plugin/src/cli-core.js +0 -128
- package/agent-spine-plugin/src/cli-diagnostics.js +0 -291
- package/agent-spine-plugin/src/cli-host.js +0 -21
- package/agent-spine-plugin/src/cli-learning.js +0 -320
- package/agent-spine-plugin/src/cli-premortem.js +0 -16
- package/agent-spine-plugin/src/cli-sharing.js +0 -230
- package/agent-spine-plugin/src/cli.js +0 -181
- package/agent-spine-plugin/src/codex-reader-launcher.js +0 -182
- package/agent-spine-plugin/src/hook.js +0 -500
- package/agent-spine-plugin/src/index.js +0 -108
- package/agent-spine-plugin/src/lib/acceptance.js +0 -435
- package/agent-spine-plugin/src/lib/action-lesson-recall.js +0 -118
- package/agent-spine-plugin/src/lib/attention-context.js +0 -167
- package/agent-spine-plugin/src/lib/attention-events.js +0 -113
- package/agent-spine-plugin/src/lib/attention-privacy.js +0 -72
- package/agent-spine-plugin/src/lib/attention-schema.js +0 -164
- package/agent-spine-plugin/src/lib/attention-storage.js +0 -93
- package/agent-spine-plugin/src/lib/attention.js +0 -164
- package/agent-spine-plugin/src/lib/audit-premortem.js +0 -223
- package/agent-spine-plugin/src/lib/audit.js +0 -401
- package/agent-spine-plugin/src/lib/authentication.js +0 -515
- package/agent-spine-plugin/src/lib/autonomy-policy.js +0 -110
- package/agent-spine-plugin/src/lib/autonomy-store.js +0 -202
- package/agent-spine-plugin/src/lib/autonomy.js +0 -8
- package/agent-spine-plugin/src/lib/briefing.js +0 -493
- package/agent-spine-plugin/src/lib/catalog-document-read.js +0 -51
- package/agent-spine-plugin/src/lib/catalog.js +0 -167
- package/agent-spine-plugin/src/lib/channel-continuity.js +0 -19
- package/agent-spine-plugin/src/lib/channel-runtime.js +0 -665
- package/agent-spine-plugin/src/lib/codex-installation.js +0 -231
- package/agent-spine-plugin/src/lib/codex-skill-installation.js +0 -211
- package/agent-spine-plugin/src/lib/context.js +0 -156
- package/agent-spine-plugin/src/lib/continuity.js +0 -338
- package/agent-spine-plugin/src/lib/coordination.js +0 -577
- package/agent-spine-plugin/src/lib/delivery-agent-usage.js +0 -231
- package/agent-spine-plugin/src/lib/delivery-assignment.js +0 -220
- package/agent-spine-plugin/src/lib/delivery-command-actions.js +0 -462
- package/agent-spine-plugin/src/lib/delivery-knowledge.js +0 -78
- package/agent-spine-plugin/src/lib/delivery-premortem-binding.js +0 -107
- package/agent-spine-plugin/src/lib/delivery-premortem-closure.js +0 -171
- package/agent-spine-plugin/src/lib/delivery-premortem-codec.js +0 -45
- package/agent-spine-plugin/src/lib/delivery-premortem-correction.js +0 -101
- package/agent-spine-plugin/src/lib/delivery-premortem-file.js +0 -21
- package/agent-spine-plugin/src/lib/delivery-premortem-index.js +0 -493
- package/agent-spine-plugin/src/lib/delivery-premortem-inspection.js +0 -37
- package/agent-spine-plugin/src/lib/delivery-premortem-recovery.js +0 -120
- package/agent-spine-plugin/src/lib/delivery-premortem-rejection.js +0 -65
- package/agent-spine-plugin/src/lib/delivery-premortem-results.js +0 -28
- package/agent-spine-plugin/src/lib/delivery-premortem-session-guard.js +0 -46
- package/agent-spine-plugin/src/lib/delivery-premortem-write-ledger.js +0 -285
- package/agent-spine-plugin/src/lib/delivery-premortem.js +0 -499
- package/agent-spine-plugin/src/lib/delivery-shell-heredoc.js +0 -115
- package/agent-spine-plugin/src/lib/delivery-shell-substitutions.js +0 -111
- package/agent-spine-plugin/src/lib/delivery-shell-wrapper.js +0 -64
- package/agent-spine-plugin/src/lib/delivery-target.js +0 -73
- package/agent-spine-plugin/src/lib/delivery-verification.js +0 -445
- package/agent-spine-plugin/src/lib/documents.js +0 -239
- package/agent-spine-plugin/src/lib/feed-transport.js +0 -499
- package/agent-spine-plugin/src/lib/filesystem-retry.js +0 -34
- package/agent-spine-plugin/src/lib/gateway-common.js +0 -68
- package/agent-spine-plugin/src/lib/gateway-control.js +0 -370
- package/agent-spine-plugin/src/lib/gateway-delivery.js +0 -103
- package/agent-spine-plugin/src/lib/gateway-execution.js +0 -350
- package/agent-spine-plugin/src/lib/gateway-group-response.js +0 -128
- package/agent-spine-plugin/src/lib/gateway-host-fencing.js +0 -92
- package/agent-spine-plugin/src/lib/gateway-host-lifecycle.js +0 -193
- package/agent-spine-plugin/src/lib/gateway-inspection.js +0 -85
- package/agent-spine-plugin/src/lib/gateway-knowledge.js +0 -129
- package/agent-spine-plugin/src/lib/gateway-policy-provenance.js +0 -197
- package/agent-spine-plugin/src/lib/gateway-premortem-disposition.js +0 -82
- package/agent-spine-plugin/src/lib/gateway-premortem.js +0 -363
- package/agent-spine-plugin/src/lib/gateway-prepared-host.js +0 -28
- package/agent-spine-plugin/src/lib/gateway-runs.js +0 -345
- package/agent-spine-plugin/src/lib/gateway-runtime-identity.js +0 -31
- package/agent-spine-plugin/src/lib/gateway-runtime-records.js +0 -21
- package/agent-spine-plugin/src/lib/gateway-runtime.js +0 -18
- package/agent-spine-plugin/src/lib/gateway-state-transaction.js +0 -356
- package/agent-spine-plugin/src/lib/gateway-state.js +0 -344
- package/agent-spine-plugin/src/lib/graph.js +0 -337
- package/agent-spine-plugin/src/lib/hook-artifact-guards.js +0 -356
- package/agent-spine-plugin/src/lib/hook-audit.js +0 -43
- package/agent-spine-plugin/src/lib/hook-briefing-use.js +0 -78
- package/agent-spine-plugin/src/lib/hook-context.js +0 -441
- package/agent-spine-plugin/src/lib/hook-final-message.js +0 -26
- package/agent-spine-plugin/src/lib/hook-input.js +0 -27
- package/agent-spine-plugin/src/lib/hook-output.js +0 -284
- package/agent-spine-plugin/src/lib/hook-premortem.js +0 -257
- package/agent-spine-plugin/src/lib/hook-process-advisory.js +0 -36
- package/agent-spine-plugin/src/lib/hook-protection.js +0 -95
- package/agent-spine-plugin/src/lib/hook-stop-verification.js +0 -84
- package/agent-spine-plugin/src/lib/hook-timeline.js +0 -102
- package/agent-spine-plugin/src/lib/host-instruction-budget.js +0 -11
- package/agent-spine-plugin/src/lib/https-transport.js +0 -392
- package/agent-spine-plugin/src/lib/identifier-analysis.js +0 -446
- package/agent-spine-plugin/src/lib/indexed-memory-offline.js +0 -40
- package/agent-spine-plugin/src/lib/indexed-memory.js +0 -298
- package/agent-spine-plugin/src/lib/knowledge-evidence.js +0 -431
- package/agent-spine-plugin/src/lib/learning-applications.js +0 -441
- package/agent-spine-plugin/src/lib/learning-artifact-evaluator.js +0 -114
- package/agent-spine-plugin/src/lib/learning-candidates.js +0 -274
- package/agent-spine-plugin/src/lib/learning-context.js +0 -137
- package/agent-spine-plugin/src/lib/learning-delivery-contracts.js +0 -310
- package/agent-spine-plugin/src/lib/learning-evaluation-contracts.js +0 -350
- package/agent-spine-plugin/src/lib/learning-evaluation-registration.js +0 -372
- package/agent-spine-plugin/src/lib/learning-evaluation-revocation.js +0 -292
- package/agent-spine-plugin/src/lib/learning-evidence-contracts.js +0 -321
- package/agent-spine-plugin/src/lib/learning-findings.js +0 -458
- package/agent-spine-plugin/src/lib/learning-measurement-contracts.js +0 -285
- package/agent-spine-plugin/src/lib/learning-measurements.js +0 -265
- package/agent-spine-plugin/src/lib/learning-outcome-contracts.js +0 -165
- package/agent-spine-plugin/src/lib/learning-outcomes.js +0 -343
- package/agent-spine-plugin/src/lib/learning-reconciliation.js +0 -290
- package/agent-spine-plugin/src/lib/learning-retry-contracts.js +0 -188
- package/agent-spine-plugin/src/lib/learning-schema.js +0 -229
- package/agent-spine-plugin/src/lib/learning-scope-targets.js +0 -424
- package/agent-spine-plugin/src/lib/learning-state-upgrade.js +0 -477
- package/agent-spine-plugin/src/lib/learning-status-configuration.js +0 -476
- package/agent-spine-plugin/src/lib/learning-storage.js +0 -203
- package/agent-spine-plugin/src/lib/learning-trial-recovery.js +0 -218
- package/agent-spine-plugin/src/lib/learning-validation-contracts.js +0 -375
- package/agent-spine-plugin/src/lib/learning-validation-renewal.js +0 -298
- package/agent-spine-plugin/src/lib/learning-validation-runtime.js +0 -234
- package/agent-spine-plugin/src/lib/learning.js +0 -36
- package/agent-spine-plugin/src/lib/lesson-recall-session.js +0 -172
- package/agent-spine-plugin/src/lib/mcp-autonomy-tools.js +0 -37
- package/agent-spine-plugin/src/lib/mcp-delivery-completion.js +0 -124
- package/agent-spine-plugin/src/lib/mcp-delivery-tools.js +0 -45
- package/agent-spine-plugin/src/lib/mcp-premortem.js +0 -68
- package/agent-spine-plugin/src/lib/mcp-runtime.js +0 -355
- package/agent-spine-plugin/src/lib/mcp-source-context.js +0 -61
- package/agent-spine-plugin/src/lib/mcp-timeline-tools.js +0 -240
- package/agent-spine-plugin/src/lib/mcp-world-tools.js +0 -52
- package/agent-spine-plugin/src/lib/object-transport.js +0 -206
- package/agent-spine-plugin/src/lib/owned-file-lock.js +0 -182
- package/agent-spine-plugin/src/lib/paths.js +0 -109
- package/agent-spine-plugin/src/lib/peer-transport.js +0 -283
- package/agent-spine-plugin/src/lib/persona-runtime.js +0 -581
- package/agent-spine-plugin/src/lib/pre-answer-timeline-recall.js +0 -104
- package/agent-spine-plugin/src/lib/preflight-delivery-id.js +0 -27
- package/agent-spine-plugin/src/lib/preflight.js +0 -688
- package/agent-spine-plugin/src/lib/project-portfolio.js +0 -176
- package/agent-spine-plugin/src/lib/runtime.js +0 -13
- package/agent-spine-plugin/src/lib/selfstarter-core.js +0 -382
- package/agent-spine-plugin/src/lib/selfstarter-jobs.js +0 -149
- package/agent-spine-plugin/src/lib/selfstarter-lease.js +0 -204
- package/agent-spine-plugin/src/lib/selfstarter-policy.js +0 -90
- package/agent-spine-plugin/src/lib/selfstarter-workspace.js +0 -111
- package/agent-spine-plugin/src/lib/selfstarter.js +0 -11
- package/agent-spine-plugin/src/lib/session-timeline-auth.js +0 -316
- package/agent-spine-plugin/src/lib/session-timeline-codex.js +0 -69
- package/agent-spine-plugin/src/lib/session-timeline-contract.js +0 -56
- package/agent-spine-plugin/src/lib/session-timeline-enrollment-source.js +0 -38
- package/agent-spine-plugin/src/lib/session-timeline-enrollment-storage.js +0 -128
- package/agent-spine-plugin/src/lib/session-timeline-enrollment-transport.js +0 -15
- package/agent-spine-plugin/src/lib/session-timeline-enrollment.js +0 -478
- package/agent-spine-plugin/src/lib/session-timeline-event-extract.js +0 -186
- package/agent-spine-plugin/src/lib/session-timeline-host-origin.js +0 -73
- package/agent-spine-plugin/src/lib/session-timeline-host-receipt.js +0 -117
- package/agent-spine-plugin/src/lib/session-timeline-invocation.js +0 -201
- package/agent-spine-plugin/src/lib/session-timeline-king.js +0 -93
- package/agent-spine-plugin/src/lib/session-timeline-prior.js +0 -57
- package/agent-spine-plugin/src/lib/session-timeline-provider.js +0 -36
- package/agent-spine-plugin/src/lib/session-timeline-query.js +0 -56
- package/agent-spine-plugin/src/lib/session-timeline-results.js +0 -56
- package/agent-spine-plugin/src/lib/session-timeline-root.js +0 -11
- package/agent-spine-plugin/src/lib/session-timeline-search.js +0 -82
- package/agent-spine-plugin/src/lib/session-timeline-sid-acl.js +0 -213
- package/agent-spine-plugin/src/lib/session-timeline-source-open.js +0 -30
- package/agent-spine-plugin/src/lib/session-timeline-source.js +0 -80
- package/agent-spine-plugin/src/lib/session-timeline-state.js +0 -45
- package/agent-spine-plugin/src/lib/session-timeline-transport.js +0 -42
- package/agent-spine-plugin/src/lib/session-timeline-windows-acl.js +0 -145
- package/agent-spine-plugin/src/lib/session-timeline.js +0 -462
- package/agent-spine-plugin/src/lib/sharing.js +0 -969
- package/agent-spine-plugin/src/lib/source-roots.js +0 -475
- package/agent-spine-plugin/src/lib/source-tree-scan.js +0 -178
- package/agent-spine-plugin/src/lib/sqlite-transport.js +0 -501
- package/agent-spine-plugin/src/lib/task-knowledge-context.js +0 -99
- package/agent-spine-plugin/src/lib/telegram-adapter.js +0 -119
- package/agent-spine-plugin/src/lib/timeline-continuation-update.js +0 -100
- package/agent-spine-plugin/src/lib/timeline-tool-guard.js +0 -225
- package/agent-spine-plugin/src/lib/timeline-user-feedback.js +0 -216
- package/agent-spine-plugin/src/lib/timeline-world-capture.js +0 -233
- package/agent-spine-plugin/src/lib/voice-runtime.js +0 -39
- package/agent-spine-plugin/src/lib/world-knowledge.js +0 -306
- package/agent-spine-plugin/src/lib/world-model.js +0 -333
- package/agent-spine-plugin/src/mcp.js +0 -456
- package/agent-spine-plugin/src/version.js +0 -1
- package/agent-spine-plugin/src/worker.js +0 -257
- package/bin/agentspine-king-goal-inbox.mjs +0 -127
- package/bin/agentspine-king-goal-intake.mjs +0 -106
- package/bin/agentspine-king-host-runner.mjs +0 -109
- package/bin/agentspine-king-snapshot-policy.cjs +0 -80
- package/bin/agentspine-king-status-policy.mjs +0 -226
- package/bin/agentspine-king-worker-host.mjs +0 -160
- package/bin/managed-plugin-selection.cjs +0 -141
- package/bin/verify-agent-behavior.cjs +0 -122
- package/bin/verify-agent-components.cjs +0 -104
|
@@ -1,112 +0,0 @@
|
|
|
1
|
-
# Bounded session timeline and evidence recall
|
|
2
|
-
|
|
3
|
-
AgentSpine indexes immutable host transcripts without copying them. Signed
|
|
4
|
-
sidecars contain bounded redacted evidence and opaque references, never text.
|
|
5
|
-
Recall is private, task-scoped, context-only, and grants no authority.
|
|
6
|
-
|
|
7
|
-
## Enrollment and retrieval
|
|
8
|
-
|
|
9
|
-
Claude, Codex, and King use separate deny-by-default adapters. Verified
|
|
10
|
-
`UserPromptSubmit` issues a short-lived one-use receipt bound to source,
|
|
11
|
-
provider, session, user, tenant, project, task, optional goal, and derived
|
|
12
|
-
portal/thread route. Model values, partial routes, groups, and unknown visibility
|
|
13
|
-
cannot enroll.
|
|
14
|
-
|
|
15
|
-
```text
|
|
16
|
-
agentspine timeline-receipt --root /path/to/project
|
|
17
|
-
agentspine timeline-enroll --root /path/to/project --receipt asthr_… --confirm-local-timeline
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
Enrollment reads fixed metadata and at most 4 KiB. Each operation revalidates
|
|
21
|
-
source, root, provider, and scope; changed bytes invalidate the snapshot. No
|
|
22
|
-
append, broad scan, refresh, retry, or fallback exists. One-use `PreToolUse`
|
|
23
|
-
permits expose:
|
|
24
|
-
|
|
25
|
-
```text
|
|
26
|
-
session_timeline_index(maxBytes)
|
|
27
|
-
session_timeline_search(at | terms, includePriorSessions, includePriorProviders)
|
|
28
|
-
session_timeline_capture(eventId, at | terms, includePriorSessions, interpretation)
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Indexing is serialized and limited to 64 KiB–16 MiB. Search uses an exact UTC
|
|
32
|
-
window or two terms, opens ≤1 ranked source, verifies bounded lines,
|
|
33
|
-
returns at most eight cards, and never widens misses. Prior sessions require the
|
|
34
|
-
exact private route. Cross-provider recall additionally requires
|
|
35
|
-
`AGENTSPINE_TIMELINE_CROSS_PROVIDER=1` and both prior flags while retaining the
|
|
36
|
-
original provider enrollment.
|
|
37
|
-
|
|
38
|
-
Capture consumes a new permit and derives provenance from the reopened source.
|
|
39
|
-
Only allowlisted objective fields enter the existing world model. Direct stdio,
|
|
40
|
-
replay mutation, foreign/group scope, expiry, unsafe state, or changed bytes
|
|
41
|
-
writes nothing. Conflicts remain unresolved; duplicates survive restart.
|
|
42
|
-
|
|
43
|
-
## Natural user-message continuity (development)
|
|
44
|
-
|
|
45
|
-
Authenticated routes may retain 256 native user references without evicting
|
|
46
|
-
objective/strict-correction evidence; the combined cap is 4096. Text and derived
|
|
47
|
-
terms are not indexed. The technical `user message` query selects this lane.
|
|
48
|
-
|
|
49
|
-
Capture rechecks one single-line user message (maximum 2048 UTF-8 bytes), its
|
|
50
|
-
route, and checkpoint. The exact quote becomes an `uninterpreted-user-message`
|
|
51
|
-
assumption with provenance and target—not a fact, correction, completion,
|
|
52
|
-
supersession, permission, or action.
|
|
53
|
-
|
|
54
|
-
One active candidate may receive a source-bound
|
|
55
|
-
`agentspine.timeline-user-feedback-interpretation-request/v1` proposal. Two or
|
|
56
|
-
three same-task candidates accept only an
|
|
57
|
-
`agentspine.timeline-user-feedback-clarification-request/v2` bound to the full
|
|
58
|
-
sorted assertion set. Each candidate keeps its own provider, session, message,
|
|
59
|
-
source digest, message digest and timestamp. Each registered source is reopened
|
|
60
|
-
and rechecked within the capture gate; partial, reordered, changed,
|
|
61
|
-
foreign-scope, unregistered, or larger sets fail. Replay deduplicates and
|
|
62
|
-
competing proposals conflict.
|
|
63
|
-
|
|
64
|
-
Both private `model-suggestion` forms keep model/source provenance, target,
|
|
65
|
-
replaced next step, and `completionVerified:false`; neither mutates continuation
|
|
66
|
-
nor grants authority. Pre-answer recall carries them across restart/compaction.
|
|
67
|
-
Three candidates use lossless field/row encoding. King's
|
|
68
|
-
bounded form shares repeated values and prefixes, so all IDs, messages, times,
|
|
69
|
-
provider, session, and source digest reconstruct within the unchanged 1200-byte
|
|
70
|
-
host field.
|
|
71
|
-
|
|
72
|
-
An objective result may advance continuation only when the same private task
|
|
73
|
-
and route already contain one confirmed
|
|
74
|
-
`agentspine.timeline-continuation-outcome-contract/v1`. The contract fixes the
|
|
75
|
-
exact current step, test label, total, success count, and success state before
|
|
76
|
-
the event. Capture reopens the source, retains the raw measurement, and then
|
|
77
|
-
updates `lastVerifiedStep`; failure keeps the agreed step without retrying,
|
|
78
|
-
while success applies only the contract's explicit next step or terminal state.
|
|
79
|
-
Postdated, stale, conflicting, foreign, superseded, or model-suggested contracts
|
|
80
|
-
cannot advance work. A newer user correction wins because its step no longer
|
|
81
|
-
matches the old contract. Raw contradictory outcomes remain visible uncertainty.
|
|
82
|
-
|
|
83
|
-
The deterministic lane still requires a whole native line beginning
|
|
84
|
-
`Correction: next step:` or `Korrektur: nächster Schritt:` and changes only
|
|
85
|
-
`nextStep` on one same-thread active conflict-free continuation. Ordinary,
|
|
86
|
-
assistant, multiline, stale, unsafe, foreign, and group inputs fail.
|
|
87
|
-
|
|
88
|
-
Repository tests for Claude, Codex, and King are independent. Quotes,
|
|
89
|
-
hypotheticals, negations, old/foreign text, and completion claims remain context.
|
|
90
|
-
Acceptance still needs a genuinely new model session to recognize the job, name
|
|
91
|
-
its result file, apply a natural correction, and ask only on real ambiguity.
|
|
92
|
-
Technical checks do not prove semantics, repetition, tokens, or live behavior.
|
|
93
|
-
|
|
94
|
-
## Integrity and provider formats
|
|
95
|
-
|
|
96
|
-
Signed sidecar, head, and protected anchor detect state-only/mixed rollback. One
|
|
97
|
-
torn generation is lock-repairable; malformed, missing, altered, linked,
|
|
98
|
-
rerooted, racing, or signature-invalid state yields no cards. Detecting a fully
|
|
99
|
-
matching anchor restoration needs an external monotonic anchor. Failure means
|
|
100
|
-
unverified recall, not a work ban or retry loop.
|
|
101
|
-
|
|
102
|
-
`codex-rollout-jsonl/v1` accepts one enrolled uncompressed file below verified
|
|
103
|
-
Codex `sessions` and validates bounded `session_meta`; `king-agent-wire-jsonl/v1`
|
|
104
|
-
requires a protected source/protocol mapping. Unknown, inherited, compressed,
|
|
105
|
-
or changed formats fail closed. Only reviewed native tool results yield
|
|
106
|
-
objective cards; chat never does.
|
|
107
|
-
|
|
108
|
-
Format provenance was inspected on 2026-09-06 in [Codex hooks](https://learn.chatgpt.com/docs/hooks),
|
|
109
|
-
[Codex 6af3454](https://github.com/openai/codex/tree/6af345407d9c2a568da9d01b6c4b81a9e61495c0),
|
|
110
|
-
and [BLUN fbb97459](https://github.com/Maykbiletti/blun-code/tree/fbb97459a3fa2157f8bfea3d24931be63288ab11).
|
|
111
|
-
No source was copied/executed; live mapping, trust, blocking, model use, and
|
|
112
|
-
installation remain separate acceptance boundaries.
|
|
@@ -1,113 +0,0 @@
|
|
|
1
|
-
# Host-native source roots
|
|
2
|
-
|
|
3
|
-
## MCP preflight source parity (0.72.2)
|
|
4
|
-
|
|
5
|
-
`session_briefing`, `delivery_knowledge_query`, `resolve_context`, and
|
|
6
|
-
`read_document` resolve bounded sources internally. The knowledge query shares
|
|
7
|
-
one catalog across contract readers and its nested briefing; it never falls back
|
|
8
|
-
to a home-tree scan. Pass the exact resolved project root and choose the host
|
|
9
|
-
with `host` where supported. `read_document` accepts the same host selector and
|
|
10
|
-
host source IDs returned by the briefing. Generic mode loads project sources,
|
|
11
|
-
not another provider's profile or auto-memory.
|
|
12
|
-
|
|
13
|
-
Catalogs, source registries, environments and user-state locations are internal
|
|
14
|
-
inputs, not trusted MCP arguments. A required preflight with incomplete discovery
|
|
15
|
-
returns an error without a successful receipt. Retry after correcting the source
|
|
16
|
-
problem; no state reset is necessary. Read-only briefing may return bounded
|
|
17
|
-
available context with diagnostics, while hook scan errors retain their existing
|
|
18
|
-
fail-open lifecycle handling. Source metadata and receipts confer no authority.
|
|
19
|
-
|
|
20
|
-
Synthetic tests count directory accesses through actual MCP requests, exercise
|
|
21
|
-
permission-error retry, independent protocol instances, exact requirement scope,
|
|
22
|
-
source replacement and read races. They do not establish installed Codex, Claude
|
|
23
|
-
or Kimi tool availability; native discovery and live task outcomes need separate
|
|
24
|
-
measurements. No live configuration or user source is changed by this repair.
|
|
25
|
-
|
|
26
|
-
AgentSpine `0.8.0` resolves active user, project, and host-memory sources before every production lifecycle hook. Resolution does not depend on the directory from which the plugin was installed, and it never treats the entire home directory as one project.
|
|
27
|
-
|
|
28
|
-
## Resolution contract
|
|
29
|
-
|
|
30
|
-
```mermaid
|
|
31
|
-
flowchart LR
|
|
32
|
-
H["Native hook payload"] --> R["Provider-neutral source-root resolver"]
|
|
33
|
-
C["Claude profile"] --> R
|
|
34
|
-
X["Codex profile"] --> R
|
|
35
|
-
P["Active project chain"] --> R
|
|
36
|
-
B["Explicit local state binding"] --> R
|
|
37
|
-
R --> U["User-wide sources"]
|
|
38
|
-
R --> J["Exact project sources"]
|
|
39
|
-
R --> M["Exact Claude project memory"]
|
|
40
|
-
U --> S["Byte-budgeted session_briefing"]
|
|
41
|
-
J --> S
|
|
42
|
-
M --> S
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Claude resolution follows the documented user and project hierarchy: `CLAUDE_CONFIG_DIR` or `~/.claude`, user `CLAUDE.md` and rules, the active project chain, and the exact project-memory directory evidenced by `autoMemoryDirectory`, `CLAUDE_CODE_PROJECT_DIR_NAME`, or the native hook `transcript_path`. Inside that directory, `MEMORY.md` is the only index. The live path never enumerates that directory and never follows links found inside a fact file. AgentSpine does not guess Claude's private project-directory encoding. See Anthropic's [memory hierarchy and storage-location documentation](https://code.claude.com/docs/en/memory) and [Claude configuration directory documentation](https://code.claude.com/docs/en/claude-directory).
|
|
46
|
-
|
|
47
|
-
## Indexed and lazy memory
|
|
48
|
-
|
|
49
|
-
Every direct index link is counted as indexed, but its target is opened only when a marker proves relevance:
|
|
50
|
-
|
|
51
|
-
```markdown
|
|
52
|
-
- [Communication style](style.md) <!-- agentspine:always -->
|
|
53
|
-
- [BLUN project](projects/blun.md) <!-- agentspine:project=project:blun -->
|
|
54
|
-
- [Alpha team](groups/alpha.md) <!-- agentspine:group=group:alpha -->
|
|
55
|
-
- [Owner preference](people/owner.md) <!-- agentspine:entity=person:owner -->
|
|
56
|
-
- [Current handoff](tasks/handoff.md) <!-- agentspine:task=task:handoff -->
|
|
57
|
-
- [Carbonara preference](food/pasta.md) <!-- agentspine:keywords=carbonara,pasta -->
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
An exact person, project, group, or task ID must match the current hook scope. Prompt relevance requires a normalized keyword match against the link label, filename, or explicit `keywords` marker. If relevance is uncertain, the target remains unopened. The index itself is always loaded so the host retains its native memory overview.
|
|
61
|
-
|
|
62
|
-
The persistent cache lives under AgentSpine's platform state directory, outside ordinary agent projects. If the active project root is exactly a recognized user home, the configured AgentSpine state subtree may be below that root but is explicitly pruned before source enumeration; it is never context. The exception does not apply to nested project roots. The cache stores integrity-checked snapshots keyed by an opaque root digest and relative path. A cache hit still opens and validates the original path and file identity, but does not reread or rehash unchanged source bytes. Corrections, deletion, link removal, source-binding rollback, purge, restart, and compaction invalidate or prune the affected cache record immediately. Cache contents and relevance markers are context-only.
|
|
63
|
-
|
|
64
|
-
Indexed targets use no-follow open semantics. Parent components, canonical scope, regular-file status, size, identity, modification metadata, and the pathname-to-handle identity are checked around the same read. A changing target is retried a bounded number of times and then rejected as a race; mixed snapshots are never injected.
|
|
65
|
-
|
|
66
|
-
The live resolver processes at most 4,096 direct index links, selects at most eight relevant targets, and opens them one at a time under the host resolver's two-second work budget. `MEMORY.md` and each target are limited to 4 MiB, while the complete external cache is capped at 16 MiB. Exceeding a bound fails closed instead of widening discovery.
|
|
67
|
-
|
|
68
|
-
Codex resolution uses `CODEX_HOME` or `~/.codex`, selects `AGENTS.override.md` before `AGENTS.md` at user scope, and walks from the configured project root to `cwd`. Per directory it selects override, regular, then the configured `project_doc_fallback_filenames`; `project_root_markers` and `project_doc_max_bytes` are read from the active profile's `config.toml`. Without a root marker, only `cwd` is the project root. See OpenAI's [AGENTS.md discovery order](https://developers.openai.com/codex/agent-configuration/agents-md) and [configuration reference](https://developers.openai.com/codex/config-reference).
|
|
69
|
-
|
|
70
|
-
Only regular files under these evidenced roots are read. Symlinks are skipped. The resolver caps source count, per-file bytes, aggregate bytes, and recursive host-rule files. Required native instructions are collected first. Optional project-wide Markdown then uses only the remaining aggregate budget, at most 240 files, 8,192 directory entries and the shared two-second resolution budget. Reaching one of those optional discovery bounds keeps the deterministic partial context, skips the remainder and emits an audited `bounded-truncated` warning instead of blocking tools. Mandatory-source, aggregate-byte and safety failures are unchanged.
|
|
71
|
-
|
|
72
|
-
A project-root scan is never run when the resolved root is the user's home directory or the exact configured Claude, Codex, or BLUN profile root. The self-starter applies the same exact-root exclusion before catalog construction or fingerprinting. A project nested inside a profile is not excluded and remains bounded and fully enforced. Foreign repositories and arbitrary hidden directories are not traversed.
|
|
73
|
-
|
|
74
|
-
An inaccessible or concurrently removed entry is omitted from a bounded scan and reported in its skipped-path diagnostics. If a deeper scanner still reports a raw `EPERM` or `EACCES` directory-enumeration error, or a scanner-tagged incomplete traversal, every native hook event returns successfully and appends the actual event, phase, code, and affected path to the local scan audit. This availability rule does not convert policy, identity, permission, protected-source, or execution-grant failures into allows.
|
|
75
|
-
|
|
76
|
-
## Portable user continuity
|
|
77
|
-
|
|
78
|
-
Accepted preferences, no-gos, corrections, and references can be attached once to the local user through an explicit state binding. The binding references the existing external AgentSpine state; it does not copy records between project hashes.
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
agentspine source-bind /path/where/continuity-was-configured \
|
|
82
|
-
--host all \
|
|
83
|
-
--scope state-user \
|
|
84
|
-
--project /current/project \
|
|
85
|
-
--host-home /current/profile \
|
|
86
|
-
--confirm-local-binding
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
Only portable low-risk learning and the known person relationship context are read from this binding. Project facts, tasks, attention events, group/private project content, delegation policy, execution grants, jobs, secrets, and trust material remain in the exact project state. The registry is append-audited and supports explicit rollback and purge:
|
|
90
|
-
|
|
91
|
-
```bash
|
|
92
|
-
agentspine source-status --host claude --cwd /current/project --json
|
|
93
|
-
agentspine source-rollback binding:ID --confirm-local-binding
|
|
94
|
-
agentspine source-purge binding:ID --confirm-local-binding
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
Bindings and their provenance are context-only. They cannot create identity equivalence, roles, permissions, delegation, host trust, or self-starter rights.
|
|
98
|
-
|
|
99
|
-
## Empty and damaged state
|
|
100
|
-
|
|
101
|
-
Hook context includes a bounded `sourceResolution` report with checked scopes, counts, profile digest, project root, and the concrete empty or fail-closed reason. Indexed-memory diagnostics add counts for indexed, relevant, loaded, cache hits, cache misses, missing targets, scope omissions, path escapes, symlinks, size rejection, races, and live directory enumeration. They never include fact contents or fact paths. `agentspine doctor --host claude|codex --cwd … --json`, `agentspine source-status`, and `agentspine audit … --host … --json` expose the same report.
|
|
102
|
-
|
|
103
|
-
Live hooks never enumerate orphaned files. An operator can request the separate bounded offline diagnostic explicitly:
|
|
104
|
-
|
|
105
|
-
```bash
|
|
106
|
-
agentspine doctor --host claude --cwd /current/project --offline-memory-orphans --json
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
It reports counts only, reads no orphan content, follows no symlinks, and grants no cleanup or deletion authority.
|
|
110
|
-
|
|
111
|
-
The installed-bundle check reproduces the original zero-source failure from an AgentSpine checkout and a foreign `cwd`, repeats restart and compaction, exercises custom Claude and Codex homes, Codex fallback and nested override precedence, and proves no broad home scan, no foreign-project visibility, zero model-side MCP calls, exactly one hook set, and unchanged source bytes.
|
|
112
|
-
|
|
113
|
-
The scale acceptance creates 50,000 real unindexed files beside six indexed entries. For the fully matching scope it records five loaded facts, seven safe opens (`MEMORY.md` twice plus five targets), zero directory enumerations, and no opens, reads, hashes, or counts for the 50,000 files. The same instrumentation result is independent of the unindexed file count; wall-clock thresholds are deliberately not used as a correctness oracle.
|
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
# Provenance-bound world model
|
|
2
|
-
|
|
3
|
-
AgentSpine's world model keeps durable assertions about synthetic or real-world subjects outside user-owned source files. It is designed for continuity across turns, restarts, and compaction without turning remembered text or model output into truth or authority.
|
|
4
|
-
|
|
5
|
-
## Evidence classes
|
|
6
|
-
|
|
7
|
-
Every assertion has one immutable `evidenceKind`:
|
|
8
|
-
|
|
9
|
-
- `objective-measurement` records an externally checkable observation;
|
|
10
|
-
- `explicit-user-feedback` records an explicit correction or confirmation;
|
|
11
|
-
- `model-suggestion` records a hypothesis that must remain a proposal.
|
|
12
|
-
|
|
13
|
-
All three require a stable evidence ID, an evidence SHA-256, an exact observation timestamp, a subject, a predicate, a privacy scope, and the stored value. A model suggestion can never supersede established context. It stays in `proposals` even when its value happens to match an established fact.
|
|
14
|
-
|
|
15
|
-
`record_world_assertion` is append-only. Repeating the same ID and material is idempotent; reusing an ID for different material fails closed. A newer measured or explicitly user-confirmed assertion can list older same-subject, same-predicate assertions in `supersedes`. Their history remains stored while the new assertion becomes the active view.
|
|
16
|
-
|
|
17
|
-
## Truth and uncertainty rules
|
|
18
|
-
|
|
19
|
-
`world_context` returns four separate collections:
|
|
20
|
-
|
|
21
|
-
- `facts`: unexpired measured or explicitly user-confirmed assertions with one non-conflicting value;
|
|
22
|
-
- `conflicts`: active established values that disagree for the same subject and predicate;
|
|
23
|
-
- `proposals`: active model suggestions;
|
|
24
|
-
- `stale`: assertions whose explicit expiry has passed.
|
|
25
|
-
|
|
26
|
-
A conflict removes that subject/predicate from `facts` and sets `uncertainty.requiresResolution`. No confidence average can hide it. Expired evidence is never silently reused. Resolving a conflict requires a new established assertion that explicitly supersedes the conflicting assertion IDs.
|
|
27
|
-
|
|
28
|
-
Session briefing reads this same model. It can expose conflicts, proposals, and stale items as uncertainty, but only the `facts` collection is established world context.
|
|
29
|
-
|
|
30
|
-
## Structured knowledge and correction history
|
|
31
|
-
|
|
32
|
-
An assertion may opt into one of five explicit knowledge kinds: `fact`, `user-preference`, `decision`, `task-state`, or `error-lesson`. This is a typed view over the same immutable evidence record, not a second memory store. Each typed item retains its evidence source and digest, observation and recording times, exact project/group/privacy scope, and optional stable session/message references. Decisions additionally require a bounded rationale.
|
|
33
|
-
|
|
34
|
-
`world_context` derives one of four evidence-based statuses:
|
|
35
|
-
|
|
36
|
-
- `confirmed` for current objective measurements or explicit user feedback;
|
|
37
|
-
- `assumption` for model suggestions, including repeated matching suggestions;
|
|
38
|
-
- `contradictory` for unresolved established values that disagree;
|
|
39
|
-
- `superseded` for explicitly replaced or expired entries.
|
|
40
|
-
|
|
41
|
-
Contradictory entries never enter `facts`. A newer explicit correction names every replaced assertion in `supersedes`; the current view then contains the correction while `includeKnowledgeHistory: true` exposes the traceable predecessors. Legacy assertions remain readable but are never retroactively assigned a knowledge kind.
|
|
42
|
-
|
|
43
|
-
The session briefing carries only the bounded current structured view. Detailed correction history remains opt-in through `world_context`, preventing restarts from loading an ever-growing record. Secret-shaped structured values or rationales are rejected both at ingestion and state validation. A source reference is provenance only: it cannot confirm a model suggestion or create authority.
|
|
44
|
-
|
|
45
|
-
## Normal-task continuation capsule
|
|
46
|
-
|
|
47
|
-
A `task-state` assertion may use predicate `task.continuation` and value schema
|
|
48
|
-
`agentspine.task-continuation/v1`. Its task ID must equal the assertion subject.
|
|
49
|
-
The bounded value records the current objective, `active`, `blocked`, `paused`,
|
|
50
|
-
or `completed` state, the last verified step and measurement ID/digest, at most eight
|
|
51
|
-
open questions, and one next step. Both the checkpoint and its last verified
|
|
52
|
-
step carry stable session/message provenance. A completed checkpoint requires a
|
|
53
|
-
passed last step, objective-measurement evidence, and no open questions or next step.
|
|
54
|
-
|
|
55
|
-
`world_context` derives `knowledge.continuation` only from current, confirmed,
|
|
56
|
-
conflict-free checkpoints. Repeated model suggestions remain assumptions and
|
|
57
|
-
never appear as resumable work. Competing established checkpoints are withheld
|
|
58
|
-
until an explicit supersession resolves them. A newer correction preserves all
|
|
59
|
-
predecessors in opt-in history. The selected checkpoint survives process restart
|
|
60
|
-
and enters `SessionStart`/`PostCompact` briefing without rereading a transcript.
|
|
61
|
-
Terminal checkpoints remain visible separately so completed work is not started
|
|
62
|
-
again. At most eight capsules are returned, and `continuationTaskId` narrows the
|
|
63
|
-
view to one exact task.
|
|
64
|
-
|
|
65
|
-
This capsule is a working-memory aid, not a job lease or permission. It cannot
|
|
66
|
-
start a tool, authorize a file change, publish, delegate, or replace the existing
|
|
67
|
-
coordination, goal-plan, timeline, host, and safety contracts.
|
|
68
|
-
|
|
69
|
-
## Task-relevant knowledge
|
|
70
|
-
|
|
71
|
-
When `continuationTaskId` selects one current resumable capsule, `world_context`
|
|
72
|
-
derives `knowledge.taskContext` from the loaded structured index. A deterministic
|
|
73
|
-
query over its objective, questions, and next step selects at most six confirmed
|
|
74
|
-
facts, preferences, decisions, or error lessons and keeps their source references.
|
|
75
|
-
Uncertain, stale, superseded, private, foreign, and terminal state is excluded.
|
|
76
|
-
No transcript or source is opened, and the view grants no authority.
|
|
77
|
-
|
|
78
|
-
## Authenticated portal and thread continuity
|
|
79
|
-
|
|
80
|
-
When the gateway starts a portal-bound task, it derives opaque `portalRef` and
|
|
81
|
-
`threadRef` values from the complete authenticated route. The MCP runtime, not
|
|
82
|
-
the model or tool arguments, attaches that pair to structured knowledge whose
|
|
83
|
-
subject is the exact current task. `SessionStart`, `PostCompact`,
|
|
84
|
-
`session_briefing`, and `world_context` then use the same pair. A continuation,
|
|
85
|
-
decision, correction, or error lesson about that task is visible only on that
|
|
86
|
-
route, even when another portal thread uses the same user, project, and task ID.
|
|
87
|
-
|
|
88
|
-
An unbound reader cannot see route-bound task knowledge. Conversely, an
|
|
89
|
-
authenticated portal task does not silently inherit older unbound task-local
|
|
90
|
-
knowledge. Historical records remain byte-valid and stored, but need an
|
|
91
|
-
explicitly reviewed migration rather than an inferred binding. Supersession
|
|
92
|
-
must keep subject, predicate, portal, and thread identical, so a correction in
|
|
93
|
-
one conversation cannot retire another conversation's state.
|
|
94
|
-
|
|
95
|
-
This narrower rule does not trap intentionally portable memory. General user
|
|
96
|
-
preferences and measured project-level lessons that are not assertions about
|
|
97
|
-
the current task retain their existing project/group/privacy scope and may be
|
|
98
|
-
reused across threads. Portal references are not MCP input fields, do not expose
|
|
99
|
-
raw route identifiers, and grant no retrieval, sending, tool, or execution
|
|
100
|
-
right. A host without the authenticated gateway pair gets no portal-bound task
|
|
101
|
-
context.
|
|
102
|
-
|
|
103
|
-
## Privacy and authority
|
|
104
|
-
|
|
105
|
-
Assertions use `private`, `shared`, or exact `group` privacy. A group read rejects private inclusion, sees only its exact group records plus shared records, and cannot observe another group's values. Project-scoped records are visible only in that exact project; unscoped records may follow the same installation across project turns when intentionally read from that root.
|
|
106
|
-
|
|
107
|
-
Every record and result is `context-only`. Predicate and nested-value keys that resemble permissions, authorization, credentials, secrets, tokens, tool access, delegation, production access, payment, or spending are rejected. World context is never consulted by host authorization, delegation, execution, signing, or trust code.
|
|
108
|
-
|
|
109
|
-
State is written atomically under an owned, heartbeat-protected lock with a 5 MiB bound and mode `0600`. Corrupt JSON, altered value digests, invalid schemas, or authority-shaped persisted data fail closed. The state lives at `world-model.json` under the external per-project AgentSpine state directory; Markdown and other user sources are never changed.
|
|
110
|
-
|
|
111
|
-
## Research provenance
|
|
112
|
-
|
|
113
|
-
The design review on 2026-09-04 inspected repository `main` at commit `26b181e95dde34d2fea62cdb8f37258e2bb3f082`, current tests, project instructions, history, open pull requests, and the following public primary sources as untrusted context:
|
|
114
|
-
|
|
115
|
-
- [W3C PROV-DM](https://www.w3.org/TR/prov-dm/), W3C Recommendation dated 2013-04-30, W3C Document License. Relevant principle: represent provenance through distinct entities, activities, agents, and relations rather than an ungrounded truth label.
|
|
116
|
-
- [NIST AI Risk Management Framework 1.0](https://www.nist.gov/itl/ai-risk-management-framework), released 2023-01-26, official NIST publication. Relevant principle: trustworthy behavior needs explicit measurement, evaluation, and risk handling; the NIST page reported an AI RMF revision in progress when checked.
|
|
117
|
-
- [NIST AI RMF Playbook — Measure](https://airc.nist.gov/airmf-resources/playbook/measure/), checked 2026-09-04, official NIST guidance. Relevant principles: record provenance, repeat measurements, expose measurable and unmeasurable risks, and compare user/community feedback separately from internal measurements.
|
|
118
|
-
|
|
119
|
-
No external code, data, executable, credential, policy, or permission was imported. The standards influenced only AgentSpine's local schema boundaries and synthetic evaluation cases; AgentSpine remains Apache-2.0.
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"description": "Resolves host-native user and project instructions before injecting scoped context, persisting attention and checkpoints, rechecking rights, and protecting sources.",
|
|
3
|
-
"hooks": {
|
|
4
|
-
"SessionStart": [
|
|
5
|
-
{
|
|
6
|
-
"matcher": "startup|resume|clear|compact",
|
|
7
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
8
|
-
}
|
|
9
|
-
],
|
|
10
|
-
"UserPromptSubmit": [
|
|
11
|
-
{
|
|
12
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
13
|
-
}
|
|
14
|
-
],
|
|
15
|
-
"PreToolUse": [
|
|
16
|
-
{
|
|
17
|
-
"matcher": "^(?:Edit|Write|apply_patch|Bash|PowerShell|mcp__(?:plugin_agent-spine_agent-spine|agent-spine)__session_timeline_(?:index|search|capture))$",
|
|
18
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
19
|
-
}
|
|
20
|
-
],
|
|
21
|
-
"PostToolUse": [
|
|
22
|
-
{
|
|
23
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\" --silent-oversize-post-tool-use", "timeout": 15 }]
|
|
24
|
-
}
|
|
25
|
-
],
|
|
26
|
-
"PreCompact": [
|
|
27
|
-
{
|
|
28
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
29
|
-
}
|
|
30
|
-
],
|
|
31
|
-
"PostCompact": [
|
|
32
|
-
{
|
|
33
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
34
|
-
}
|
|
35
|
-
],
|
|
36
|
-
"Stop": [
|
|
37
|
-
{
|
|
38
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
39
|
-
}
|
|
40
|
-
],
|
|
41
|
-
"SubagentStop": [
|
|
42
|
-
{
|
|
43
|
-
"hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/src/hook.js\"", "timeout": 15 }]
|
|
44
|
-
}
|
|
45
|
-
]
|
|
46
|
-
}
|
|
47
|
-
}
|
|
@@ -1,106 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"description": "Resolves host-native user, project, and memory roots before injecting scoped context, persisting attention and checkpoints, rechecking rights, and protecting sources.",
|
|
3
|
-
"hooks": {
|
|
4
|
-
"SessionStart": [
|
|
5
|
-
{
|
|
6
|
-
"matcher": "startup|resume|clear|compact",
|
|
7
|
-
"hooks": [
|
|
8
|
-
{
|
|
9
|
-
"type": "command",
|
|
10
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
11
|
-
"timeout": 15
|
|
12
|
-
}
|
|
13
|
-
]
|
|
14
|
-
}
|
|
15
|
-
],
|
|
16
|
-
"UserPromptSubmit": [
|
|
17
|
-
{
|
|
18
|
-
"hooks": [
|
|
19
|
-
{
|
|
20
|
-
"type": "command",
|
|
21
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
22
|
-
"timeout": 15
|
|
23
|
-
}
|
|
24
|
-
]
|
|
25
|
-
}
|
|
26
|
-
],
|
|
27
|
-
"InstructionsLoaded": [
|
|
28
|
-
{
|
|
29
|
-
"hooks": [
|
|
30
|
-
{
|
|
31
|
-
"type": "command",
|
|
32
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
33
|
-
"timeout": 15
|
|
34
|
-
}
|
|
35
|
-
]
|
|
36
|
-
}
|
|
37
|
-
],
|
|
38
|
-
"PreToolUse": [
|
|
39
|
-
{
|
|
40
|
-
"matcher": "^(?:Edit|Write|apply_patch|Bash|PowerShell|mcp__plugin_agent-spine_agent-spine__session_timeline_(?:index|search|capture))$",
|
|
41
|
-
"hooks": [
|
|
42
|
-
{
|
|
43
|
-
"type": "command",
|
|
44
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
45
|
-
"timeout": 15
|
|
46
|
-
}
|
|
47
|
-
]
|
|
48
|
-
}
|
|
49
|
-
],
|
|
50
|
-
"PostToolUse": [
|
|
51
|
-
{
|
|
52
|
-
"hooks": [
|
|
53
|
-
{
|
|
54
|
-
"type": "command",
|
|
55
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\" --silent-oversize-post-tool-use",
|
|
56
|
-
"timeout": 15
|
|
57
|
-
}
|
|
58
|
-
]
|
|
59
|
-
}
|
|
60
|
-
],
|
|
61
|
-
"PreCompact": [
|
|
62
|
-
{
|
|
63
|
-
"hooks": [
|
|
64
|
-
{
|
|
65
|
-
"type": "command",
|
|
66
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
67
|
-
"timeout": 15
|
|
68
|
-
}
|
|
69
|
-
]
|
|
70
|
-
}
|
|
71
|
-
],
|
|
72
|
-
"PostCompact": [
|
|
73
|
-
{
|
|
74
|
-
"hooks": [
|
|
75
|
-
{
|
|
76
|
-
"type": "command",
|
|
77
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
78
|
-
"timeout": 15
|
|
79
|
-
}
|
|
80
|
-
]
|
|
81
|
-
}
|
|
82
|
-
],
|
|
83
|
-
"Stop": [
|
|
84
|
-
{
|
|
85
|
-
"hooks": [
|
|
86
|
-
{
|
|
87
|
-
"type": "command",
|
|
88
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
89
|
-
"timeout": 15
|
|
90
|
-
}
|
|
91
|
-
]
|
|
92
|
-
}
|
|
93
|
-
],
|
|
94
|
-
"SubagentStop": [
|
|
95
|
-
{
|
|
96
|
-
"hooks": [
|
|
97
|
-
{
|
|
98
|
-
"type": "command",
|
|
99
|
-
"command": "node \"${CLAUDE_PLUGIN_ROOT}/src/hook.js\"",
|
|
100
|
-
"timeout": 15
|
|
101
|
-
}
|
|
102
|
-
]
|
|
103
|
-
}
|
|
104
|
-
]
|
|
105
|
-
}
|
|
106
|
-
}
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "agent-spine",
|
|
3
|
-
"version": "0.73.0",
|
|
4
|
-
"description": "A non-destructive identity and memory spine for AI agents.",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"bin": {
|
|
7
|
-
"agentspine": "./bin/agentspine.js",
|
|
8
|
-
"agentspine-mcp": "./bin/agentspine-mcp.js",
|
|
9
|
-
"agentspine-worker": "./src/worker.js"
|
|
10
|
-
},
|
|
11
|
-
"exports": {
|
|
12
|
-
".": "./src/index.js"
|
|
13
|
-
},
|
|
14
|
-
"files": [
|
|
15
|
-
"blun.plugin.json",
|
|
16
|
-
".claude-plugin",
|
|
17
|
-
".codex-plugin",
|
|
18
|
-
".mcp.json",
|
|
19
|
-
"assets",
|
|
20
|
-
"bin",
|
|
21
|
-
"docs/acceptance.md",
|
|
22
|
-
"docs/artifact-evaluation.md",
|
|
23
|
-
"docs/host-integration.md",
|
|
24
|
-
"docs/preflight-recall.md",
|
|
25
|
-
"docs/preservation-contract.md",
|
|
26
|
-
"docs/quality-gates.md",
|
|
27
|
-
"docs/session-timeline.md",
|
|
28
|
-
"docs/source-roots.md",
|
|
29
|
-
"docs/world-model.md",
|
|
30
|
-
"hooks",
|
|
31
|
-
"scripts",
|
|
32
|
-
"skills",
|
|
33
|
-
"spine-example",
|
|
34
|
-
"src",
|
|
35
|
-
"CHANGELOG.md",
|
|
36
|
-
"LICENSE",
|
|
37
|
-
"README.md"
|
|
38
|
-
],
|
|
39
|
-
"scripts": {
|
|
40
|
-
"check": "node scripts/run-checks.js",
|
|
41
|
-
"acceptance": "node scripts/run-acceptance.js",
|
|
42
|
-
"audit:self": "node bin/agentspine.js audit . --json",
|
|
43
|
-
"host:check": "node scripts/check-hosts.js --json",
|
|
44
|
-
"host:install-check": "node scripts/check-install.js --json",
|
|
45
|
-
"lint": "node scripts/check-syntax.js",
|
|
46
|
-
"line-budget": "node scripts/check-line-budget.js",
|
|
47
|
-
"release:check": "node scripts/release-check.js --json",
|
|
48
|
-
"release:sbom": "npm sbom --sbom-format cyclonedx",
|
|
49
|
-
"smoke": "node bin/agentspine.js doctor --json",
|
|
50
|
-
"test": "node scripts/run-tests-hermetic.js",
|
|
51
|
-
"prepack": "npm run check"
|
|
52
|
-
},
|
|
53
|
-
"engines": {
|
|
54
|
-
"node": ">=20.9.0"
|
|
55
|
-
},
|
|
56
|
-
"keywords": [
|
|
57
|
-
"agent",
|
|
58
|
-
"memory",
|
|
59
|
-
"identity",
|
|
60
|
-
"mcp",
|
|
61
|
-
"claude-code",
|
|
62
|
-
"codex"
|
|
63
|
-
],
|
|
64
|
-
"author": {
|
|
65
|
-
"name": "Mayk Biletti",
|
|
66
|
-
"url": "https://github.com/Maykbiletti"
|
|
67
|
-
},
|
|
68
|
-
"license": "Apache-2.0",
|
|
69
|
-
"repository": {
|
|
70
|
-
"type": "git",
|
|
71
|
-
"url": "git+https://github.com/Maykbiletti/AgentSpine.git"
|
|
72
|
-
},
|
|
73
|
-
"bugs": {
|
|
74
|
-
"url": "https://github.com/Maykbiletti/AgentSpine/issues"
|
|
75
|
-
},
|
|
76
|
-
"homepage": "https://github.com/Maykbiletti/AgentSpine#readme"
|
|
77
|
-
}
|