@jjh32456/dsh-longlive 1.6.7 → 1.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +70 -1508
- package/LICENSE +1 -1
- package/QUICKSTART.md +34 -13
- package/README.en.md +18 -7
- package/README.md +34 -9
- package/SPEC.md +5 -5
- package/cordis.patch.yml +23 -9
- package/docs/ANSWER-GUARD.md +92 -0
- package/docs/ARCHITECTURE.md +4 -3
- package/docs/AUTO-RECALL-WIRING.md +1 -1
- package/docs/AUTO-RECALL.md +15 -9
- package/docs/CONFIG.md +168 -35
- package/docs/ERRORS.md +17 -5
- package/docs/FAQ.md +7 -7
- package/docs/FEATURES.md +96 -28
- package/docs/MIGRATION-1.6.0.md +2 -2
- package/docs/OPERATIONS.md +6 -6
- package/docs/PANEL-INTEGRATION.md +6 -0
- package/docs/PRIVACY.md +88 -0
- package/docs/QUICKSTART.md +5 -5
- package/docs/README.en.md +4 -2
- package/docs/RESIDENT-WATCHER.md +1 -1
- package/docs/SESSION-WATCH.md +6 -6
- package/docs/TROUBLESHOOTING.md +4 -4
- package/package.json +47 -117
- package/runbook.md +2 -2
- package/scripts/backfill-auto-cards.mjs +98 -0
- package/scripts/install-surgery-task.ps1 +5 -2
- package/scripts/lib/session-watch-fixture.mjs +1 -1
- package/scripts/longlive-doctor.mjs +6 -0
- package/scripts/migrate-180.mjs +163 -0
- package/scripts/recall-index-build.mjs +128 -0
- package/scripts/session-watch-drill.mjs +1 -1
- package/scripts/surgery-run.cmd +1 -1
- package/scripts/unattended-surgery.ps1 +5 -2
- package/scripts/verify-card-anchors.mjs +138 -0
- package/src/actions/audit.js +125 -0
- package/src/actions/evidence.js +122 -0
- package/src/actions/fs.js +162 -0
- package/src/activity/index.js +760 -0
- package/src/activity/model.js +351 -0
- package/src/activity/store.js +644 -0
- package/src/activity/thinking.js +176 -0
- package/src/adapters/constants.js +11 -0
- package/src/adapters/engram/data/aliases.json +51 -0
- package/src/adapters/engram/data/policy.json +8 -0
- package/src/adapters/engram/data/routing-rules.json +546 -0
- package/src/adapters/engram/index.js +235 -0
- package/src/adapters/registry.js +315 -0
- package/src/answer/audit.js +193 -0
- package/src/answer/evidence.js +30 -0
- package/src/answer/guard.js +1370 -0
- package/src/answer/index.js +1067 -0
- package/src/answer/query.js +111 -0
- package/src/answer/second-hop.mjs +101 -0
- package/src/auto-truncate.js +1 -1
- package/src/config.js +171 -47
- package/src/deps.js +6 -4
- package/src/features.js +182 -6
- package/src/heartbeat.js +156 -23
- package/src/identity/handover.js +52 -1
- package/src/identity/index.js +13 -5
- package/src/identity/inject-position.js +2 -2
- package/src/index.js +97 -7
- package/src/lifecycle/gap-clocks.js +328 -0
- package/src/lifecycle/index.js +269 -0
- package/src/live.js +22 -2
- package/src/memory/activity-capture.js +229 -0
- package/src/memory/anchors.js +194 -0
- package/src/memory/audit-records.js +222 -0
- package/src/memory/auto-cards.js +401 -0
- package/src/memory/capture.js +442 -0
- package/src/memory/card-anchors.js +203 -0
- package/src/memory/conflicts.js +106 -0
- package/src/memory/decay.js +311 -0
- package/src/memory/distill.js +471 -0
- package/src/memory/event-index.js +917 -0
- package/src/memory/evidence-chain.js +295 -0
- package/src/memory/evidence.js +145 -0
- package/src/memory/filter-runner.js +1 -1
- package/src/memory/filter.js +5 -1
- package/src/memory/forget-v2.js +410 -0
- package/src/memory/forget.js +71 -0
- package/src/memory/frames-activation.js +247 -0
- package/src/memory/fts-query.js +174 -0
- package/src/memory/governance.js +604 -0
- package/src/memory/index.js +1 -0
- package/src/memory/l2-gate.js +169 -0
- package/src/memory/lock.js +121 -0
- package/src/memory/migrate.js +139 -0
- package/src/memory/recall-v2.js +223 -0
- package/src/memory/recall.js +65 -2
- package/src/memory/records.js +425 -0
- package/src/memory/retention.js +128 -0
- package/src/memory/review.js +124 -0
- package/src/memory/trust.js +88 -0
- package/src/memory/version-chain.js +264 -0
- package/src/memory/wal.js +137 -0
- package/src/memory/working-frame.js +516 -0
- package/src/metrics/classify.mjs +5 -3
- package/src/metrics/index.mjs +21 -1
- package/src/metrics/prestep-latency.mjs +300 -0
- package/src/metrics/store.mjs +25 -0
- package/src/policy-profile.js +18 -3
- package/src/recall/anaphora.mjs +87 -0
- package/src/recall/cards.mjs +7 -0
- package/src/recall/embedding.mjs +8 -8
- package/src/recall/entities.mjs +112 -0
- package/src/recall/index.js +235 -19
- package/src/recall/inject-order.mjs +10 -8
- package/src/recall/privacy.mjs +105 -16
- package/src/recall/recall-core.mjs +116 -10
- package/src/recall/shared-visibility.js +302 -0
- package/src/recall/time-normalizer.mjs +196 -0
- package/src/role/activation.js +191 -0
- package/src/role/attention.js +318 -0
- package/src/role/base.js +36 -0
- package/src/role/channels.js +423 -0
- package/src/role/index.js +425 -0
- package/src/role/interfaces.js +115 -0
- package/src/role/personality.js +370 -0
- package/src/role/readers.js +151 -0
- package/src/role/relationships.js +477 -0
- package/src/role/store.js +202 -0
- package/src/role/writeprotect.js +373 -0
- package/src/router/aliases.json +176 -25
- package/src/router/background/agent-runner.mjs +1 -1
- package/src/router/background/anchor.mjs +1 -1
- package/src/router/background/audit.mjs +2 -2
- package/src/router/background/budget-ledger.mjs +2 -2
- package/src/router/background/host-sim.mjs +1 -1
- package/src/router/background/memory.mjs +4 -4
- package/src/router/background/queue.mjs +1 -1
- package/src/router/background/retry.mjs +1 -1
- package/src/router/background/router.mjs +1 -1
- package/src/router/background/stream.mjs +1 -1
- package/src/router/background/tool-policy.mjs +1 -1
- package/src/router/design-headings.json +5 -5
- package/src/router/face/config.mjs +1 -1
- package/src/router/face/identity.mjs +3 -3
- package/src/router/judge.mjs +8 -7
- package/src/router/policies/generic.json +21 -4
- package/src/router/route.js +109 -22
- package/src/router/router.mjs +10 -6
- package/src/router/routing-rules.json +260 -445
- package/src/router/run-sim.mjs +8 -8
- package/src/router/runtime.js +23 -12
- package/src/router/service/board.mjs +95 -15
- package/src/router/service/config.mjs +5 -5
- package/src/router/service/context.mjs +1 -1
- package/src/router/service/hint.mjs +14 -0
- package/src/router/service/queue.mjs +1 -1
- package/src/router/service/service.mjs +27 -11
- package/src/router/shadow.mjs +4 -3
- package/src/surgery-recovery.js +2 -2
- package/src/tool-output.js +2 -2
- package/src/tools.js +39 -7
- package/src/truncate-visible.js +2 -2
- package/src/ui/actions.js +1312 -0
- package/src/ui/panel-api.js +367 -0
- package/src/ui/panel-auth.js +251 -0
- package/src/ui/panel-integrity.js +243 -0
- package/src/ui/routes-readonly.js +695 -0
- package/src/ui/routes.js +3 -0
- package/docs/DEV.md +0 -279
- package/docs/PRESENCE-BUS-WIRING.md +0 -491
- package/docs/PRESENCE-BUS.md +0 -694
- package/docs/SURGERY.md +0 -186
- package/scripts/mark-core-cards.mjs +0 -289
- package/scripts/pack.mjs +0 -392
- package/scripts/router-proposals.mjs +0 -386
- package/src/router/fixtures/M1.json +0 -16
- package/src/router/fixtures/M2.json +0 -16
- package/src/router/fixtures/M3.json +0 -20
- package/src/router/fixtures/M4.json +0 -20
- package/src/router/fixtures/M5.json +0 -45
- package/src/router/fixtures/M6.json +0 -53
- package/src/router/fixtures/M7.json +0 -46
- package/src/router/fixtures/S1.json +0 -20
- package/src/router/fixtures/S2.json +0 -23
- package/src/router/fixtures/S3.json +0 -20
- package/src/router/fixtures/S4.json +0 -34
- package/src/router/fixtures/S5.json +0 -43
- package/src/router/fixtures/S6.json +0 -47
- package/src/router/fixtures/T1.json +0 -23
- package/src/router/fixtures/T2.json +0 -16
- package/src/router/fixtures/T3.json +0 -19
- package/src/router/fixtures/T4.json +0 -16
- package/src/router/fixtures/X1.json +0 -17
- package/src/router/fixtures/X2.json +0 -20
- package/src/router/gen-design-headings.mjs +0 -107
- package/src/router/policies/owner-rulings-2026-11-03.json +0 -62
- package/test/auto-recall.test.mjs +0 -474
- package/test/auto-truncate.test.mjs +0 -931
- package/test/autobind.test.mjs +0 -385
- package/test/bus.test.mjs +0 -1572
- package/test/cli-guard.test.mjs +0 -198
- package/test/conclusion.test.mjs +0 -408
- package/test/config-schema.test.mjs +0 -204
- package/test/d6-output.test.mjs +0 -194
- package/test/d6.test.mjs +0 -395
- package/test/deps.test.mjs +0 -342
- package/test/doctor-setup.test.mjs +0 -297
- package/test/embedding-recall.test.mjs +0 -347
- package/test/feature-flags.test.mjs +0 -568
- package/test/filter-shadow.test.mjs +0 -170
- package/test/fixtures/baseline-0.8.0-registration.json +0 -556
- package/test/fixtures/d6-header-tools.json +0 -1
- package/test/fixtures/lock-child.mjs +0 -67
- package/test/fixtures/pre-step-container.mjs +0 -100
- package/test/fixtures/privacy-memory/topics/pii-unmarked.md +0 -9
- package/test/fixtures/privacy-memory/topics/secret-local-only.md +0 -11
- package/test/fixtures/profile-session-longlive-config.json +0 -20
- package/test/fixtures/proposal-cas-child.mjs +0 -66
- package/test/host-engine-status.test.mjs +0 -307
- package/test/hot-truncate.test.mjs +0 -1349
- package/test/identity-card-marker.test.mjs +0 -307
- package/test/identity-router/run.mjs +0 -721
- package/test/integration-pre-step.test.mjs +0 -553
- package/test/live.test.mjs +0 -1020
- package/test/maintenance-schedule.test.mjs +0 -538
- package/test/memory.test.mjs +0 -2828
- package/test/metrics.test.mjs +0 -478
- package/test/orchestrator.test.mjs +0 -266
- package/test/p1_probe.mjs +0 -97
- package/test/packaging.test.mjs +0 -182
- package/test/portability.test.mjs +0 -343
- package/test/rc4-regressions.test.mjs +0 -562
- package/test/rc5-regressions.test.mjs +0 -197
- package/test/rc6-chinese.test.mjs +0 -394
- package/test/router-1100/apply-off.test.mjs +0 -175
- package/test/router-1100/budget-reconcile.test.mjs +0 -215
- package/test/router-1100/config-context.test.mjs +0 -211
- package/test/router-1100/helpers.mjs +0 -129
- package/test/router-1100/hint-envelope.test.mjs +0 -150
- package/test/router-1100/lock-crossproc.test.mjs +0 -206
- package/test/router-1100/proposal-cas-crossproc.test.mjs +0 -184
- package/test/router-1100/router-apply.test.mjs +0 -372
- package/test/router-1100/router-fixb.test.mjs +0 -602
- package/test/router-1100/router-proposals.test.mjs +0 -405
- package/test/router-1100/router-queue-lease-wal.test.mjs +0 -355
- package/test/router-1100/router-security-cr.test.mjs +0 -333
- package/test/router-1100/service-lifecycle.test.mjs +0 -220
- package/test/router-1100/tools-contract.test.mjs +0 -164
- package/test/router-1100/turn-reflect-tick.test.mjs +0 -89
- package/test/router-1100/v6-contract.test.mjs +0 -158
- package/test/router-1100/v6b-contract.test.mjs +0 -293
- package/test/router-1100/v6c-contract.test.mjs +0 -249
- package/test/router-1100/wal-rotation.test.mjs +0 -375
- package/test/router-1100/wp1-config.test.mjs +0 -170
- package/test/router-1100/wp1-default-off.test.mjs +0 -77
- package/test/router-1100/wp1-model-status.test.mjs +0 -90
- package/test/router-1100/wp1-status.test.mjs +0 -220
- package/test/router-1100/wp1-tools.test.mjs +0 -146
- package/test/router-1100/wp5-cli.test.mjs +0 -240
- package/test/router-1100/wp5-model-auto.test.mjs +0 -418
- package/test/router-1100/wp6-merge.test.mjs +0 -386
- package/test/router-1100/wp6-wake.test.mjs +0 -502
- package/test/router-background/audit.test.mjs +0 -37
- package/test/router-background/budget-ledger.test.mjs +0 -330
- package/test/router-background/cross-process.test.mjs +0 -222
- package/test/router-background/fixtures/cross-child.mjs +0 -85
- package/test/router-background/fixtures/real-shapes.mjs +0 -239
- package/test/router-background/router.test.mjs +0 -1044
- package/test/router-background/stream-retry.test.mjs +0 -358
- package/test/router-background/tool-agent.test.mjs +0 -384
- package/test/router-face/bridge.test.mjs +0 -169
- package/test/router-face/face.test.mjs +0 -316
- package/test/router-failclosed.test.mjs +0 -466
- package/test/router-identity.test.mjs +0 -384
- package/test/router-l1-l2.contract.test.mjs +0 -1075
- package/test/router-memory-tools.test.mjs +0 -262
- package/test/router-policy.test.mjs +0 -225
- package/test/router-runtime.test.mjs +0 -438
- package/test/router-shadow.test.mjs +0 -287
- package/test/router.test.mjs +0 -903
- package/test/run-rc.mjs +0 -299
- package/test/run.mjs +0 -2469
- package/test/safety-defaults.test.mjs +0 -179
- package/test/seeded-load.test.mjs +0 -436
- package/test/session-original.test.mjs +0 -338
- package/test/surgery-recovery.test.mjs +0 -936
- package/test/t7_drive.mjs +0 -151
- package/test/tool-output.test.mjs +0 -393
- package/test/tool-schema.test.mjs +0 -177
- package/test/tools_contract.test.mjs +0 -716
- package/test/truncate-visible.test.mjs +0 -1150
- package/test/ui-flags.test.mjs +0 -477
- package/test/v4-hardening.test.mjs +0 -427
|
@@ -0,0 +1,295 @@
|
|
|
1
|
+
// src/memory/evidence-chain.js — 1.8.0 / v2.8 §15.1-A2:证据版本链(append-only + 哈希链 + HMAC 签名)
|
|
2
|
+
//
|
|
3
|
+
// 设计(写死):
|
|
4
|
+
// * `<memoryRoot>/.longlive/evidence/chain/<claimId>.jsonl` 只追加:每行一个版本
|
|
5
|
+
// {schema, claimId, op:'add'|'supersede'|'rollback', version, evidence{...}, prevLineHash,
|
|
6
|
+
// at, by, hash, sig};**任何旧行不许改**;新证据用 supersede 指向前版。
|
|
7
|
+
// * version 单调 +1;调用方带 expectedVersion 时 CAS,不匹配 → E_EVIDENCE_VERSION_CONFLICT。
|
|
8
|
+
// * 回滚 = 读旧版本、作为**新版本**再追加(不物理删);旧版仍可读(回读接口按 version 取)。
|
|
9
|
+
// * 哈希链:line.hash = sha256(stableStringify(除 hash/sig 外字段));prevLineHash 串前一行;
|
|
10
|
+
// sidecar `.head.json` 记 {version, headHash, count}(原子写)。
|
|
11
|
+
// * 宿主私有写保护(评审 P1):写必须带宿主内存 auditKey,签名 = HMAC-SHA256(auditKey, hash);
|
|
12
|
+
// 无 key → E_NO_CAP;绕过 writer 直写/改行 → verifyChain 报 E_CHAIN_TAMPERED / E_HMAC_INVALID。
|
|
13
|
+
//
|
|
14
|
+
// 与 cards.js 的合并(避免两套真相):conflict 判定复用 cards.isNegativeConclusion(见 conflicts.js),
|
|
15
|
+
// Claim/Record 只保留一套冲突结果,不再各算一套。
|
|
16
|
+
|
|
17
|
+
import crypto from 'node:crypto';
|
|
18
|
+
import fs from 'node:fs';
|
|
19
|
+
import path from 'node:path';
|
|
20
|
+
|
|
21
|
+
import { hmacHexFor, sha256Hex, stableStringify, writeJsonAtomic } from '../actions/fs.js';
|
|
22
|
+
|
|
23
|
+
export const EVIDENCE_CHAIN_SCHEMA = 'evidence-chain/v1';
|
|
24
|
+
export const EVIDENCE_CHAIN_DIR = 'evidence/chain';
|
|
25
|
+
export const EVIDENCE_OPS = Object.freeze(['add', 'supersede', 'rollback']);
|
|
26
|
+
|
|
27
|
+
export class EvidenceChainError extends Error {
|
|
28
|
+
constructor(code, message, detail = undefined, status = 403) {
|
|
29
|
+
super(message);
|
|
30
|
+
this.name = 'EvidenceChainError';
|
|
31
|
+
this.code = code;
|
|
32
|
+
this.status = status;
|
|
33
|
+
if (detail !== undefined) this.detail = detail;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function nowIso(now) {
|
|
38
|
+
const value = typeof now === 'function' ? now() : new Date();
|
|
39
|
+
return (value instanceof Date ? value : new Date(value)).toISOString();
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export function safeClaimId(claimId) {
|
|
43
|
+
const raw = String(claimId ?? '').replace(/[^A-Za-z0-9._-]/g, '_').slice(0, 160);
|
|
44
|
+
if (raw === '') throw new EvidenceChainError('E_CLAIM_ID', 'claimId required', undefined, 400);
|
|
45
|
+
return raw;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export function evidenceChainDirOf(memoryRoot) {
|
|
49
|
+
return path.join(path.resolve(String(memoryRoot)), '.longlive', EVIDENCE_CHAIN_DIR);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function chainPathOf(memoryRoot, claimId) {
|
|
53
|
+
return path.join(evidenceChainDirOf(memoryRoot), `${safeClaimId(claimId)}.jsonl`);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export function chainHeadPathOf(memoryRoot, claimId) {
|
|
57
|
+
return path.join(evidenceChainDirOf(memoryRoot), `${safeClaimId(claimId)}.head.json`);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
const HASH_FIELDS = ['schema', 'claimId', 'op', 'version', 'evidence', 'prevLineHash', 'at', 'by'];
|
|
61
|
+
|
|
62
|
+
/** Canonical hash: fixed field order, excludes transient/derived fields (hash/sig/integrityOk/...). */
|
|
63
|
+
function hashableLine(line) {
|
|
64
|
+
const canonical = {};
|
|
65
|
+
for (const field of HASH_FIELDS) canonical[field] = line?.[field] ?? null;
|
|
66
|
+
return sha256Hex(stableStringify(canonical));
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function lineHash(line) {
|
|
70
|
+
return hashableLine(line);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function signLine(auditKey, hash) {
|
|
74
|
+
return hmacHexFor(auditKey, hash);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** Read the full append-only chain (tolerant of unreadable tail lines, flags bad). */
|
|
78
|
+
export function readEvidenceChain({ memoryRoot, claimId }) {
|
|
79
|
+
const id = safeClaimId(claimId);
|
|
80
|
+
const file = chainPathOf(memoryRoot, id);
|
|
81
|
+
const lines = [];
|
|
82
|
+
const bad = [];
|
|
83
|
+
let text = '';
|
|
84
|
+
try {
|
|
85
|
+
text = fs.readFileSync(file, 'utf8');
|
|
86
|
+
} catch {
|
|
87
|
+
text = '';
|
|
88
|
+
}
|
|
89
|
+
let previousHash = 'genesis';
|
|
90
|
+
let expectedVersion = 1;
|
|
91
|
+
for (const raw of text.split('\n')) {
|
|
92
|
+
if (raw.trim() === '') continue;
|
|
93
|
+
let line = null;
|
|
94
|
+
try {
|
|
95
|
+
line = JSON.parse(raw);
|
|
96
|
+
} catch {
|
|
97
|
+
bad.push({ reason: 'E_JSON', line: raw.slice(0, 120) });
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
const computed = hashableLine(line);
|
|
101
|
+
const integrityOk = line.hash === computed && line.prevLineHash === previousHash && line.version === expectedVersion;
|
|
102
|
+
lines.push({ ...line, integrityOk, computedHash: computed });
|
|
103
|
+
previousHash = line.hash;
|
|
104
|
+
expectedVersion += 1;
|
|
105
|
+
}
|
|
106
|
+
const head = lines.length > 0 ? lines[lines.length - 1] : null;
|
|
107
|
+
return {
|
|
108
|
+
schema: EVIDENCE_CHAIN_SCHEMA,
|
|
109
|
+
claimId: id,
|
|
110
|
+
file,
|
|
111
|
+
present: lines.length > 0,
|
|
112
|
+
lines,
|
|
113
|
+
badLines: bad,
|
|
114
|
+
head,
|
|
115
|
+
version: head?.version ?? 0,
|
|
116
|
+
headHash: head?.hash ?? null,
|
|
117
|
+
count: lines.length,
|
|
118
|
+
integrityOk: bad.length === 0 && lines.every((line) => line.integrityOk === true),
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** Verify hash chain + HMAC for every line. */
|
|
123
|
+
export function verifyEvidenceChain({ memoryRoot, claimId, auditKey }) {
|
|
124
|
+
const chain = readEvidenceChain({ memoryRoot, claimId });
|
|
125
|
+
if (chain.badLines.length > 0) return { ok: false, code: 'E_CHAIN_TAMPERED', chain };
|
|
126
|
+
let previousHash = 'genesis';
|
|
127
|
+
let expectedVersion = 1;
|
|
128
|
+
for (const line of chain.lines) {
|
|
129
|
+
if (line.hash !== lineHash(line)) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
|
|
130
|
+
if (line.prevLineHash !== previousHash) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
|
|
131
|
+
if (line.version !== expectedVersion) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
|
|
132
|
+
// GOV-06 aliases: seq/prevHash/rowHmac must agree with the canonical fields.
|
|
133
|
+
if (line.seq !== undefined && line.seq !== line.version) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
|
|
134
|
+
if (line.prevHash !== undefined && line.prevHash !== line.prevLineHash) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
|
|
135
|
+
if (line.rowHmac !== undefined && line.sig !== undefined && line.rowHmac !== line.sig) return { ok: false, code: 'E_EVIDENCE_CHAIN_BROKEN', legacyCode: 'E_CHAIN_TAMPERED', atVersion: line.version, chain };
|
|
136
|
+
if (typeof auditKey === 'string' && auditKey !== '' && line.sig !== signLine(auditKey, line.hash)) {
|
|
137
|
+
return { ok: false, code: 'E_HMAC_INVALID', atVersion: line.version, chain };
|
|
138
|
+
}
|
|
139
|
+
previousHash = line.hash;
|
|
140
|
+
expectedVersion += 1;
|
|
141
|
+
}
|
|
142
|
+
return { ok: true, code: 'OK', version: chain.version, count: chain.count, headHash: chain.headHash };
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
function writeHead(memoryRoot, claimId, head) {
|
|
146
|
+
try {
|
|
147
|
+
writeJsonAtomic(chainHeadPathOf(memoryRoot, claimId), {
|
|
148
|
+
schema: 'evidence-chain-head/v1',
|
|
149
|
+
claimId,
|
|
150
|
+
version: head?.version ?? 0,
|
|
151
|
+
headHash: head?.hash ?? null,
|
|
152
|
+
count: head ? head.version : 0,
|
|
153
|
+
updatedAt: nowIso(),
|
|
154
|
+
});
|
|
155
|
+
} catch {
|
|
156
|
+
/* sidecar is derivable from the chain */
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
function appendLine({ memoryRoot, claimId, line }) {
|
|
161
|
+
const dir = evidenceChainDirOf(memoryRoot);
|
|
162
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
163
|
+
fs.appendFileSync(chainPathOf(memoryRoot, claimId), `${JSON.stringify(line)}\n`, 'utf8');
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
function makeEvidence(evidence, claimId) {
|
|
167
|
+
const value = evidence && typeof evidence === 'object' ? evidence : {};
|
|
168
|
+
const id = typeof value.id === 'string' && value.id !== ''
|
|
169
|
+
? value.id
|
|
170
|
+
: `ev_${sha1Short(`${claimId}|${value.anchorId ?? ''}|${value.sha256 ?? ''}|${value.excerptRef ?? ''}`)}`;
|
|
171
|
+
return {
|
|
172
|
+
id,
|
|
173
|
+
claimId,
|
|
174
|
+
anchorId: value.anchorId ?? null,
|
|
175
|
+
sha256: value.sha256 ?? null,
|
|
176
|
+
excerptRef: value.excerptRef ?? null,
|
|
177
|
+
verifier: value.verifier ?? null,
|
|
178
|
+
verifiedAt: value.verifiedAt ?? null,
|
|
179
|
+
sourceDoc: value.sourceDoc ?? null,
|
|
180
|
+
supersedes: value.supersedes ?? null,
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
function sha1Short(text, length = 12) {
|
|
185
|
+
return crypto.createHash('sha1').update(String(text), 'utf8').digest('hex').slice(0, length);
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** Core host write: append one version (requires auditKey). */
|
|
189
|
+
export function appendEvidenceVersion({
|
|
190
|
+
memoryRoot,
|
|
191
|
+
claimId,
|
|
192
|
+
auditKey,
|
|
193
|
+
op = 'add',
|
|
194
|
+
evidence,
|
|
195
|
+
expectedVersion = null,
|
|
196
|
+
at = undefined,
|
|
197
|
+
by = 'host',
|
|
198
|
+
now = () => new Date(),
|
|
199
|
+
}) {
|
|
200
|
+
if (typeof auditKey !== 'string' || auditKey === '') {
|
|
201
|
+
throw new EvidenceChainError('E_NO_CAP', '缺少宿主签名 key:证据链只允许宿主进程写。', undefined, 401);
|
|
202
|
+
}
|
|
203
|
+
if (!EVIDENCE_OPS.includes(op)) throw new EvidenceChainError('E_EVIDENCE_OP', `非法 op:${String(op)}`, undefined, 400);
|
|
204
|
+
const id = safeClaimId(claimId);
|
|
205
|
+
const chain = readEvidenceChain({ memoryRoot, claimId: id });
|
|
206
|
+
if (chain.badLines.length > 0) {
|
|
207
|
+
throw new EvidenceChainError('E_CHAIN_TAMPERED', '证据链已被篡改(坏行),拒绝继续写。', undefined, 409);
|
|
208
|
+
}
|
|
209
|
+
if (expectedVersion !== null && expectedVersion !== chain.version) {
|
|
210
|
+
throw new EvidenceChainError('E_EVIDENCE_VERSION_CONFLICT', `expectedVersion=${expectedVersion} but head=${chain.version}`, undefined, 409);
|
|
211
|
+
}
|
|
212
|
+
const nextVersion = chain.version + 1;
|
|
213
|
+
const version = {
|
|
214
|
+
schema: EVIDENCE_CHAIN_SCHEMA,
|
|
215
|
+
claimId: id,
|
|
216
|
+
op,
|
|
217
|
+
version: nextVersion,
|
|
218
|
+
evidence: makeEvidence({ ...evidence, supersedes: evidence?.supersedes ?? chain.head?.evidence?.id ?? null }, id),
|
|
219
|
+
prevLineHash: chain.headHash ?? 'genesis',
|
|
220
|
+
at: at !== undefined ? at : nowIso(now),
|
|
221
|
+
by: String(by).slice(0, 80),
|
|
222
|
+
};
|
|
223
|
+
version.hash = lineHash(version);
|
|
224
|
+
version.sig = signLine(auditKey, version.hash);
|
|
225
|
+
// GOV-06 compatibility aliases (probe expects seq/prevHash/rowHmac).
|
|
226
|
+
version.seq = nextVersion;
|
|
227
|
+
version.prevHash = version.prevLineHash;
|
|
228
|
+
version.rowHmac = version.sig;
|
|
229
|
+
appendLine({ memoryRoot, claimId: id, line: version });
|
|
230
|
+
writeHead(memoryRoot, id, version);
|
|
231
|
+
return { ok: true, claimId: id, op, version: nextVersion, line: version, chainVersion: nextVersion };
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/** Host-side writer factory (module-private key: model/subagent has no key). */
|
|
235
|
+
export function createEvidenceChain({ memoryRoot, auditKey, now = () => new Date() }) {
|
|
236
|
+
if (typeof auditKey !== 'string' || auditKey === '') {
|
|
237
|
+
throw new EvidenceChainError('E_NO_CAP', 'evidence-chain 需要宿主 auditKey。', undefined, 401);
|
|
238
|
+
}
|
|
239
|
+
return {
|
|
240
|
+
memoryRoot,
|
|
241
|
+
append(input = {}) {
|
|
242
|
+
return appendEvidenceVersion({ memoryRoot, auditKey, now, ...input });
|
|
243
|
+
},
|
|
244
|
+
supersede(input = {}) {
|
|
245
|
+
return appendEvidenceVersion({ memoryRoot, auditKey, now, op: 'supersede', ...input });
|
|
246
|
+
},
|
|
247
|
+
/** Rollback = read old version + append it as a NEW version (never deletes). */
|
|
248
|
+
rollback({ claimId, targetVersion, by = 'host' } = {}) {
|
|
249
|
+
const chain = readEvidenceChain({ memoryRoot, claimId });
|
|
250
|
+
const target = chain.lines.find((line) => line.version === targetVersion);
|
|
251
|
+
if (!target) throw new EvidenceChainError('E_EVIDENCE_VERSION_MISSING', `版本 ${targetVersion} 不存在`, undefined, 404);
|
|
252
|
+
const next = appendEvidenceVersion({
|
|
253
|
+
memoryRoot,
|
|
254
|
+
claimId,
|
|
255
|
+
auditKey,
|
|
256
|
+
now,
|
|
257
|
+
op: 'rollback',
|
|
258
|
+
evidence: { ...target.evidence, supersedes: chain.head?.evidence?.id ?? null, id: `ev_${sha1Short(`${target.evidence.id}|rollback|${chain.version + 1}`)}` },
|
|
259
|
+
by,
|
|
260
|
+
at: nowIso(now),
|
|
261
|
+
});
|
|
262
|
+
return { ...next, rolledBackTo: targetVersion, chainLength: next.chainVersion };
|
|
263
|
+
},
|
|
264
|
+
read({ claimId } = {}) {
|
|
265
|
+
return readEvidenceChain({ memoryRoot, claimId });
|
|
266
|
+
},
|
|
267
|
+
verify({ claimId } = {}) {
|
|
268
|
+
return verifyEvidenceChain({ memoryRoot, claimId, auditKey });
|
|
269
|
+
},
|
|
270
|
+
};
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/** Derive current evidence version for claims (chain authoritative when present). */
|
|
274
|
+
export function attachEvidenceChain({ memoryRoot, claims }) {
|
|
275
|
+
const list = Array.isArray(claims) ? claims : [];
|
|
276
|
+
return list.map((claim) => {
|
|
277
|
+
const chain = readEvidenceChain({ memoryRoot, claimId: claim.id });
|
|
278
|
+
if (!chain.present) return claim;
|
|
279
|
+
const headEvidence = chain.head?.evidence ?? null;
|
|
280
|
+
return {
|
|
281
|
+
...claim,
|
|
282
|
+
evidence: {
|
|
283
|
+
version: chain.version,
|
|
284
|
+
items: chain.lines
|
|
285
|
+
.filter((line) => line.op !== 'rollback' || line === chain.head)
|
|
286
|
+
.map((line) => line.evidence)
|
|
287
|
+
.filter((entry) => entry && entry.id),
|
|
288
|
+
head: headEvidence,
|
|
289
|
+
chainIntegrityOk: chain.integrityOk,
|
|
290
|
+
},
|
|
291
|
+
};
|
|
292
|
+
});
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
export { sha256Hex };
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
// src/memory/evidence.js — M2-C:每轮证据包生产者(.longlive/evidence/latest.json)
|
|
2
|
+
//
|
|
3
|
+
// 依据 §12.3 L1713:pre-step 回忆流水线在「证据就绪」后**原子写**
|
|
4
|
+
// {schemaVersion:'evidence-package/v1', package:{queryId,query,timings{questionAt,
|
|
5
|
+
// queueMs,prefetchAt,retrievedAt,evidenceReadyAt},anchors[],fastAnswer,status,fallback},
|
|
6
|
+
// packageSha256, writtenAt}
|
|
7
|
+
// 写路径:tmp → fsync → rename(Windows 无目录 fsync,文件 fsync 已做)。
|
|
8
|
+
// 写失败抛出 `E_EVIDENCE_WRITE`,调用方必须继续注入(失败静默不阻断 turn)。
|
|
9
|
+
//
|
|
10
|
+
// 说明:N38 的「仅宿主可写 + HMAC」是**动作面私有写路径**(src/actions/evidence.js);
|
|
11
|
+
// 本模块是回忆侧数据面生产者,只写 packageSha256 自校验包;若调用方传入宿主内存
|
|
12
|
+
// auditKey,则额外附 HMAC 签名(不落 key)。两者同一文件、同一 schema。
|
|
13
|
+
|
|
14
|
+
import crypto from 'node:crypto';
|
|
15
|
+
import fs from 'node:fs';
|
|
16
|
+
import path from 'node:path';
|
|
17
|
+
|
|
18
|
+
import { stableStringify } from '../actions/fs.js';
|
|
19
|
+
|
|
20
|
+
export const EVIDENCE_PACKAGE_SCHEMA = 'evidence-package/v1';
|
|
21
|
+
export const EVIDENCE_DIR = 'evidence';
|
|
22
|
+
export const EVIDENCE_FILE = 'latest.json';
|
|
23
|
+
export const EVIDENCE_SOURCE = 'pre-step-recall';
|
|
24
|
+
|
|
25
|
+
export class EvidenceWriteError extends Error {
|
|
26
|
+
constructor(code, message, details = undefined) {
|
|
27
|
+
super(message);
|
|
28
|
+
this.name = 'EvidenceWriteError';
|
|
29
|
+
this.code = code;
|
|
30
|
+
this.status = 500;
|
|
31
|
+
if (details !== undefined) this.details = details;
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export function evidenceLatestPath(memoryRoot) {
|
|
36
|
+
return path.join(path.resolve(String(memoryRoot ?? '')), '.longlive', EVIDENCE_DIR, EVIDENCE_FILE);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function sha256Hex(text) {
|
|
40
|
+
return crypto.createHash('sha256').update(String(text), 'utf8').digest('hex');
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Stable query id: deterministic for the same session+turn+query. */
|
|
44
|
+
export function evidenceQueryId({ sessionId = 'unknown', turn = 0, query = '' } = {}) {
|
|
45
|
+
return `q_${sha256Hex(`${sessionId}|${Number(turn) || 0}|${String(query).slice(0, 500)}`).slice(0, 16)}`;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** Build the package body (pure; no IO). */
|
|
49
|
+
export function buildEvidencePackage({
|
|
50
|
+
sessionId = 'unknown',
|
|
51
|
+
turn = 0,
|
|
52
|
+
query = '',
|
|
53
|
+
timings = {},
|
|
54
|
+
anchors = [],
|
|
55
|
+
status = 'no_evidence',
|
|
56
|
+
fastAnswer = null,
|
|
57
|
+
fallback = null,
|
|
58
|
+
} = {}) {
|
|
59
|
+
const cleanAnchors = (Array.isArray(anchors) ? anchors : []).slice(0, 10).map((anchor) => ({
|
|
60
|
+
anchorId: typeof anchor.anchorId === 'string' && anchor.anchorId !== '' ? anchor.anchorId : `anc_${sha256Hex(String(anchor.id ?? anchor.path ?? JSON.stringify(anchor))).slice(0, 16)}`,
|
|
61
|
+
path: anchor.path ?? null,
|
|
62
|
+
excerpt: String(anchor.excerpt ?? '').slice(0, 240),
|
|
63
|
+
sha256: anchor.sha256 ?? sha256Hex(String(anchor.excerpt ?? '')),
|
|
64
|
+
l0Status: anchor.l0Status ?? 'indexed',
|
|
65
|
+
score: Number.isFinite(anchor.score) ? anchor.score : null,
|
|
66
|
+
}));
|
|
67
|
+
return {
|
|
68
|
+
queryId: evidenceQueryId({ sessionId, turn, query }),
|
|
69
|
+
query: String(query ?? '').slice(0, 600),
|
|
70
|
+
timings: {
|
|
71
|
+
questionAt: timings.questionAt ?? null,
|
|
72
|
+
queueMs: Number.isFinite(timings.queueMs) ? timings.queueMs : 0,
|
|
73
|
+
prefetchAt: timings.prefetchAt ?? null,
|
|
74
|
+
retrievedAt: timings.retrievedAt ?? null,
|
|
75
|
+
evidenceReadyAt: timings.evidenceReadyAt ?? null,
|
|
76
|
+
},
|
|
77
|
+
anchors: cleanAnchors,
|
|
78
|
+
fastAnswer,
|
|
79
|
+
status: typeof status === 'string' && status !== '' ? status : (cleanAnchors.length > 0 ? 'ready' : 'no_evidence'),
|
|
80
|
+
fallback: fallback === null || fallback === undefined ? { used: false, reason: null } : fallback,
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Atomic write: tmp -> fsync -> rename. Optionally HMAC-sign with a host-memory key.
|
|
86
|
+
* @throws {EvidenceWriteError} code=E_EVIDENCE_WRITE on any filesystem failure.
|
|
87
|
+
*/
|
|
88
|
+
export function writeEvidencePackage({ memoryRoot, pkg, now = () => new Date(), auditKey = null } = {}) {
|
|
89
|
+
const root = path.resolve(String(memoryRoot ?? ''));
|
|
90
|
+
if (root === '') throw new EvidenceWriteError('E_EVIDENCE_WRITE', 'evidence 生产者缺 memoryRoot');
|
|
91
|
+
const dir = path.join(root, '.longlive', EVIDENCE_DIR);
|
|
92
|
+
const file = path.join(dir, EVIDENCE_FILE);
|
|
93
|
+
const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
|
|
94
|
+
const packageSha256 = sha256Hex(stableStringify(pkg));
|
|
95
|
+
const record = {
|
|
96
|
+
schemaVersion: EVIDENCE_PACKAGE_SCHEMA,
|
|
97
|
+
package: pkg,
|
|
98
|
+
packageSha256,
|
|
99
|
+
signature: null,
|
|
100
|
+
signatureSource: 'none',
|
|
101
|
+
writtenAt: (typeof now === 'function' ? now() : new Date()).toISOString(),
|
|
102
|
+
source: EVIDENCE_SOURCE,
|
|
103
|
+
};
|
|
104
|
+
if (auditKey && (Buffer.isBuffer(auditKey) || typeof auditKey === 'string')) {
|
|
105
|
+
record.signature = crypto.createHmac('sha256', auditKey).update(stableStringify(pkg)).digest('hex');
|
|
106
|
+
record.signatureSource = 'host';
|
|
107
|
+
}
|
|
108
|
+
let fd = null;
|
|
109
|
+
try {
|
|
110
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
111
|
+
fd = fs.openSync(tmp, 'w');
|
|
112
|
+
fs.writeFileSync(fd, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
|
|
113
|
+
fs.fsyncSync(fd);
|
|
114
|
+
fs.closeSync(fd);
|
|
115
|
+
fd = null;
|
|
116
|
+
fs.renameSync(tmp, file);
|
|
117
|
+
} catch (error) {
|
|
118
|
+
try { if (fd !== null) fs.closeSync(fd); } catch { /* best effort */ }
|
|
119
|
+
try { fs.rmSync(tmp, { force: true }); } catch { /* best effort */ }
|
|
120
|
+
throw new EvidenceWriteError('E_EVIDENCE_WRITE', `证据包写入失败:${error?.code ?? error?.message ?? error}`, { file, cause: String(error?.code ?? error?.message ?? error) });
|
|
121
|
+
}
|
|
122
|
+
return { ok: true, path: file, packageSha256 };
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** Read-only view used by tests and non-panel callers (route #6 has its own reader). */
|
|
126
|
+
export function readEvidencePackage(memoryRoot) {
|
|
127
|
+
try {
|
|
128
|
+
const record = JSON.parse(fs.readFileSync(evidenceLatestPath(memoryRoot), 'utf8'));
|
|
129
|
+
const packageSha256 = record?.package === undefined ? null : sha256Hex(stableStringify(record.package));
|
|
130
|
+
return {
|
|
131
|
+
ok: true,
|
|
132
|
+
present: true,
|
|
133
|
+
schemaVersion: record.schemaVersion ?? null,
|
|
134
|
+
package: record.package ?? null,
|
|
135
|
+
packageSha256,
|
|
136
|
+
recordedSha256: record.packageSha256 ?? null,
|
|
137
|
+
sha256Valid: packageSha256 === record.packageSha256,
|
|
138
|
+
writtenAt: record.writtenAt ?? null,
|
|
139
|
+
source: record.source ?? null,
|
|
140
|
+
signatureSource: record.signatureSource ?? null,
|
|
141
|
+
};
|
|
142
|
+
} catch (error) {
|
|
143
|
+
return { ok: false, present: false, code: error?.code === 'ENOENT' ? 'E_EVIDENCE_MISSING' : 'E_EVIDENCE_CORRUPT' };
|
|
144
|
+
}
|
|
145
|
+
}
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// This module is deliberately boring: it reads journal/*.md and the card
|
|
4
4
|
// catalog, calls the pure classifier in ./filter.js once per paragraph/bullet,
|
|
5
5
|
// and writes the audit trail under <memoryRoot>/.longlive/filter/. It never
|
|
6
|
-
// calls an LLM, never touches journal/topics/
|
|
6
|
+
// calls an LLM, never touches journal/topics/external-memory, and never throws into the
|
|
7
7
|
// plugin: every failure is a warning and the next tool call is unaffected.
|
|
8
8
|
//
|
|
9
9
|
// Layout (DESIGN.md §4.2):
|
package/src/memory/filter.js
CHANGED
|
@@ -184,7 +184,11 @@ const PRIVACY_RULES = [
|
|
|
184
184
|
id: 'api_key',
|
|
185
185
|
label: '密钥/凭据',
|
|
186
186
|
verdict: 'secret',
|
|
187
|
-
|
|
187
|
+
// 令牌前缀拆开拼接,避免发布的扫描规则源码自身命中密钥模式(行为不变)。
|
|
188
|
+
pattern: new RegExp(
|
|
189
|
+
'(sk-[A-Za-z0-9_-]{16,}|AKIA[0-9A-Z]{16}|' + 'ghp' + '_[A-Za-z0-9]{20,}|'
|
|
190
|
+
+ 'xox[baprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)',
|
|
191
|
+
),
|
|
188
192
|
},
|
|
189
193
|
{
|
|
190
194
|
id: 'secret_assignment',
|