@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
|
@@ -1,438 +0,0 @@
|
|
|
1
|
-
// R1 runtime adapter tests (node:test). Run with:
|
|
2
|
-
// node --test test/router-runtime.test.mjs
|
|
3
|
-
//
|
|
4
|
-
// This suite is deliberately separate from test/run.mjs: the existing 18 suites
|
|
5
|
-
// are a hand-rolled harness, and nothing here needs to change their baseline.
|
|
6
|
-
//
|
|
7
|
-
// Every test writes only inside mkdtemp() directories: no real memory root, no
|
|
8
|
-
// ~/.dsh, no personal store.
|
|
9
|
-
|
|
10
|
-
import { test } from 'node:test';
|
|
11
|
-
import assert from 'node:assert/strict';
|
|
12
|
-
import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync, mkdirSync } from 'node:fs';
|
|
13
|
-
import { tmpdir } from 'node:os';
|
|
14
|
-
import { join } from 'node:path';
|
|
15
|
-
|
|
16
|
-
import {
|
|
17
|
-
DEFAULT_RUNTIME_MODE,
|
|
18
|
-
INTERCEPTED_TOOLS,
|
|
19
|
-
MAX_RECORDS_DEFAULT,
|
|
20
|
-
ROUTE_REFUSED_CODE,
|
|
21
|
-
WRITE_TOOLS,
|
|
22
|
-
buildJudgeText,
|
|
23
|
-
classifyRisk,
|
|
24
|
-
createRouterRuntime,
|
|
25
|
-
normalizeMode,
|
|
26
|
-
resolveStatePath,
|
|
27
|
-
} from '../src/router/runtime.js';
|
|
28
|
-
import { registerTools, TOOLS } from '../src/tools.js';
|
|
29
|
-
|
|
30
|
-
const dirs = [];
|
|
31
|
-
function tempDir() {
|
|
32
|
-
const dir = mkdtempSync(join(tmpdir(), 'router-runtime-'));
|
|
33
|
-
dirs.push(dir);
|
|
34
|
-
return dir;
|
|
35
|
-
}
|
|
36
|
-
function statePathIn(dir) {
|
|
37
|
-
return join(dir, 'router-runtime.jsonl');
|
|
38
|
-
}
|
|
39
|
-
function readRecords(path) {
|
|
40
|
-
if (!existsSync(path)) return [];
|
|
41
|
-
return readFileSync(path, 'utf8')
|
|
42
|
-
.split('\n')
|
|
43
|
-
.filter(Boolean)
|
|
44
|
-
.map((line) => JSON.parse(line));
|
|
45
|
-
}
|
|
46
|
-
function cleanup() {
|
|
47
|
-
for (const dir of dirs.splice(0)) {
|
|
48
|
-
try {
|
|
49
|
-
rmSync(dir, { recursive: true, force: true });
|
|
50
|
-
} catch {
|
|
51
|
-
/* best effort */
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
process.on('exit', cleanup);
|
|
56
|
-
|
|
57
|
-
// ---------------------------------------------------------------- normalize
|
|
58
|
-
|
|
59
|
-
test('modes: off is the default and unknown values never become on', () => {
|
|
60
|
-
assert.equal(DEFAULT_RUNTIME_MODE, 'off');
|
|
61
|
-
assert.equal(normalizeMode(undefined), 'off');
|
|
62
|
-
assert.equal(normalizeMode(''), 'off');
|
|
63
|
-
assert.equal(normalizeMode('SHADOW'), 'shadow');
|
|
64
|
-
assert.equal(normalizeMode(' on '), 'on');
|
|
65
|
-
assert.equal(normalizeMode('enabled'), 'off');
|
|
66
|
-
assert.equal(normalizeMode('true'), 'off');
|
|
67
|
-
assert.equal(MAX_RECORDS_DEFAULT, 1000);
|
|
68
|
-
assert.deepEqual([...INTERCEPTED_TOOLS].sort(), ['memory_consolidate', 'memory_forget', 'memory_recall', 'memory_save']);
|
|
69
|
-
assert.deepEqual([...WRITE_TOOLS].sort(), ['memory_consolidate', 'memory_forget', 'memory_save']);
|
|
70
|
-
});
|
|
71
|
-
|
|
72
|
-
test('state path: explicit wins, memory root is the fallback, neither means no sink', () => {
|
|
73
|
-
assert.equal(resolveStatePath({ statePath: 'C:/tmp/x.jsonl' }).endsWith('x.jsonl'), true);
|
|
74
|
-
assert.equal(resolveStatePath({ memoryRoot: 'C:/tmp/root' }).endsWith('router-runtime.jsonl'), true);
|
|
75
|
-
assert.equal(resolveStatePath({}), null);
|
|
76
|
-
});
|
|
77
|
-
|
|
78
|
-
// ---------------------------------------------------------------------- off
|
|
79
|
-
|
|
80
|
-
test('off: never judges, never writes, and stays synchronous', () => {
|
|
81
|
-
const dir = tempDir();
|
|
82
|
-
const path = statePathIn(dir);
|
|
83
|
-
const runtime = createRouterRuntime({ mode: 'off', statePath: path });
|
|
84
|
-
assert.equal(runtime.enabled, false);
|
|
85
|
-
|
|
86
|
-
let calls = 0;
|
|
87
|
-
const value = runtime.intercept('memory_forget', { confirm: 'FORGET' }, () => {
|
|
88
|
-
calls += 1;
|
|
89
|
-
return { ok: true };
|
|
90
|
-
});
|
|
91
|
-
assert.deepEqual(value, { ok: true });
|
|
92
|
-
assert.equal(calls, 1, 'the tool still runs');
|
|
93
|
-
assert.equal(typeof value.then, 'undefined', 'off must not turn a sync tool into a promise');
|
|
94
|
-
assert.equal(existsSync(path), false, 'off writes nothing');
|
|
95
|
-
});
|
|
96
|
-
|
|
97
|
-
test('off: an unregistered tool is not judged either', () => {
|
|
98
|
-
const dir = tempDir();
|
|
99
|
-
const path = statePathIn(dir);
|
|
100
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
|
|
101
|
-
let calls = 0;
|
|
102
|
-
runtime.intercept('session_health', {}, () => {
|
|
103
|
-
calls += 1;
|
|
104
|
-
return 'x';
|
|
105
|
-
});
|
|
106
|
-
assert.equal(calls, 1);
|
|
107
|
-
assert.equal(existsSync(path), false, 'session_* is out of scope');
|
|
108
|
-
});
|
|
109
|
-
|
|
110
|
-
// ------------------------------------------------------------------- shadow
|
|
111
|
-
|
|
112
|
-
test('shadow: records the decision and returns the tool value unchanged', async () => {
|
|
113
|
-
const dir = tempDir();
|
|
114
|
-
const path = statePathIn(dir);
|
|
115
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
|
|
116
|
-
const expected = { ok: true, cards: 3 };
|
|
117
|
-
const result = await runtime.intercept('memory_forget', { confirm: 'FORGET', reason: '删除重复卡片' }, () => expected);
|
|
118
|
-
assert.equal(result, expected, 'the exact same object comes back');
|
|
119
|
-
|
|
120
|
-
const records = readRecords(path);
|
|
121
|
-
assert.equal(records.length, 1);
|
|
122
|
-
const record = records[0];
|
|
123
|
-
assert.equal(record.mode, 'shadow');
|
|
124
|
-
assert.equal(record.tool, 'memory_forget');
|
|
125
|
-
assert.equal(record.decision.matchedRule, 'R-MEM-DISTILL');
|
|
126
|
-
assert.equal(record.decision.ruleId, 'R-MEM-DISTILL');
|
|
127
|
-
assert.equal(record.decision.action, 'memory.distillPropose', 'the deciding action, not decisions[0] (engram.search)');
|
|
128
|
-
assert.equal(record.decision.level, 'X');
|
|
129
|
-
assert.equal(record.decision.needsHuman, true);
|
|
130
|
-
assert.equal(typeof record.latencyMs, 'number');
|
|
131
|
-
assert.equal(record.outcome.status, 'ok');
|
|
132
|
-
assert.equal(record.guard.verdict, 'allow');
|
|
133
|
-
assert.equal(record.risk.level, 'delete');
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
test('shadow: a thrown tool error is rethrown as the same object and still recorded', async () => {
|
|
137
|
-
const dir = tempDir();
|
|
138
|
-
const path = statePathIn(dir);
|
|
139
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
|
|
140
|
-
const boom = Object.assign(new Error('E_RECALL_NO_MATCH: nothing'), { code: 'E_RECALL_NO_MATCH' });
|
|
141
|
-
const thrown = await runtime
|
|
142
|
-
.intercept('memory_recall', { query: '听觉训练' }, () => {
|
|
143
|
-
throw boom;
|
|
144
|
-
})
|
|
145
|
-
.then(
|
|
146
|
-
() => null,
|
|
147
|
-
(error) => error,
|
|
148
|
-
);
|
|
149
|
-
assert.equal(thrown, boom, 'identity of the error object is preserved');
|
|
150
|
-
const [record] = readRecords(path);
|
|
151
|
-
assert.equal(record.outcome.status, 'error');
|
|
152
|
-
assert.equal(record.outcome.code, 'E_RECALL_NO_MATCH');
|
|
153
|
-
assert.equal(record.guard.verdict, 'allow');
|
|
154
|
-
});
|
|
155
|
-
|
|
156
|
-
test('shadow: a read is judged and recorded but never refused', async () => {
|
|
157
|
-
const dir = tempDir();
|
|
158
|
-
const path = statePathIn(dir);
|
|
159
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
|
|
160
|
-
const value = await runtime.intercept('memory_recall', { query: '改名 小蓝' }, () => 'cards');
|
|
161
|
-
assert.equal(value, 'cards');
|
|
162
|
-
const [record] = readRecords(path);
|
|
163
|
-
assert.equal(record.decision.matchedRule, 'R-ID-CONSENT');
|
|
164
|
-
assert.equal(record.guard.verdict, 'allow');
|
|
165
|
-
assert.equal(runtime.stats().denied, 0);
|
|
166
|
-
});
|
|
167
|
-
|
|
168
|
-
// ----------------------------------------------------------------------- on
|
|
169
|
-
|
|
170
|
-
test('on: a confirmed delete is refused and the underlying tool is not called', async () => {
|
|
171
|
-
const dir = tempDir();
|
|
172
|
-
const path = statePathIn(dir);
|
|
173
|
-
const runtime = createRouterRuntime({ mode: 'on', statePath: path });
|
|
174
|
-
let calls = 0;
|
|
175
|
-
const error = await runtime
|
|
176
|
-
.intercept('memory_forget', { confirm: 'FORGET' }, () => {
|
|
177
|
-
calls += 1;
|
|
178
|
-
return 'deleted';
|
|
179
|
-
})
|
|
180
|
-
.then(
|
|
181
|
-
() => null,
|
|
182
|
-
(failure) => failure,
|
|
183
|
-
);
|
|
184
|
-
assert.ok(error, 'the call must reject');
|
|
185
|
-
assert.equal(error.code, ROUTE_REFUSED_CODE);
|
|
186
|
-
assert.equal(error.details.risk, 'delete');
|
|
187
|
-
assert.equal(calls, 0, 'invoke is never reached');
|
|
188
|
-
const [record] = readRecords(path);
|
|
189
|
-
assert.equal(record.outcome.status, 'denied');
|
|
190
|
-
assert.equal(record.guard.verdict, 'deny');
|
|
191
|
-
assert.equal(record.mode, 'on');
|
|
192
|
-
});
|
|
193
|
-
|
|
194
|
-
test('on: a dry-run forget and a read both pass through', async () => {
|
|
195
|
-
const dir = tempDir();
|
|
196
|
-
const path = statePathIn(dir);
|
|
197
|
-
const runtime = createRouterRuntime({ mode: 'on', statePath: path });
|
|
198
|
-
assert.equal(await runtime.intercept('memory_forget', {}, () => 'preview'), 'preview');
|
|
199
|
-
assert.equal(await runtime.intercept('memory_recall', { query: '任意' }, () => 'cards'), 'cards');
|
|
200
|
-
const records = readRecords(path);
|
|
201
|
-
assert.equal(records.length, 2);
|
|
202
|
-
assert.deepEqual(records.map((r) => r.outcome.status), ['ok', 'ok']);
|
|
203
|
-
});
|
|
204
|
-
|
|
205
|
-
test('on: identity risk is refused', async () => {
|
|
206
|
-
const dir = tempDir();
|
|
207
|
-
const runtime = createRouterRuntime({ mode: 'on', statePath: statePathIn(dir) });
|
|
208
|
-
const failure = await runtime.guard('memory_save', { content: '以后叫我小蓝' });
|
|
209
|
-
assert.equal(typeof failure, 'string');
|
|
210
|
-
assert.match(failure, /E_ROUTE_REFUSED/);
|
|
211
|
-
assert.match(failure, /R-ID-CONSENT/);
|
|
212
|
-
assert.equal(classifyRisk({ tool: 'memory_save', args: {}, matchedRule: 'R-ID-CONSENT', action: 'identity.hold' }).level, 'identity');
|
|
213
|
-
});
|
|
214
|
-
|
|
215
|
-
// -------------------------------------------------------------- fail-closed
|
|
216
|
-
|
|
217
|
-
test('fail-closed: a broken router refuses writes but not reads, and never throws', async () => {
|
|
218
|
-
const dir = tempDir();
|
|
219
|
-
const path = statePathIn(dir);
|
|
220
|
-
const runtime = createRouterRuntime({
|
|
221
|
-
mode: 'on',
|
|
222
|
-
statePath: path,
|
|
223
|
-
routeImpl: () => {
|
|
224
|
-
throw new Error('router exploded');
|
|
225
|
-
},
|
|
226
|
-
});
|
|
227
|
-
let called = 0;
|
|
228
|
-
const write = await runtime
|
|
229
|
-
.intercept('memory_consolidate', { since: '2026-11-01' }, () => {
|
|
230
|
-
called += 1;
|
|
231
|
-
return 'merged';
|
|
232
|
-
})
|
|
233
|
-
.then(
|
|
234
|
-
() => null,
|
|
235
|
-
(error) => error,
|
|
236
|
-
);
|
|
237
|
-
assert.ok(write);
|
|
238
|
-
assert.equal(write.code, ROUTE_REFUSED_CODE);
|
|
239
|
-
assert.equal(called, 0);
|
|
240
|
-
assert.equal(await runtime.intercept('memory_recall', { query: 'x' }, () => 'cards'), 'cards');
|
|
241
|
-
|
|
242
|
-
const records = readRecords(path);
|
|
243
|
-
assert.equal(records.length, 2);
|
|
244
|
-
assert.equal(records[0].decision.failClosed, true);
|
|
245
|
-
assert.equal(records[0].decision.ruleId, 'R-ROUTER-FAILCLOSED');
|
|
246
|
-
assert.equal(records[1].outcome.status, 'ok', 'the read still ran');
|
|
247
|
-
});
|
|
248
|
-
|
|
249
|
-
test('fail-closed in shadow: records the failure and runs the tool anyway', async () => {
|
|
250
|
-
const dir = tempDir();
|
|
251
|
-
const path = statePathIn(dir);
|
|
252
|
-
const runtime = createRouterRuntime({
|
|
253
|
-
mode: 'shadow',
|
|
254
|
-
statePath: path,
|
|
255
|
-
routeImpl: () => {
|
|
256
|
-
throw new Error('router exploded');
|
|
257
|
-
},
|
|
258
|
-
});
|
|
259
|
-
assert.equal(await runtime.intercept('memory_forget', { confirm: 'FORGET' }, () => 'deleted'), 'deleted');
|
|
260
|
-
const [record] = readRecords(path);
|
|
261
|
-
assert.equal(record.decision.failClosed, true);
|
|
262
|
-
assert.equal(record.outcome.status, 'ok');
|
|
263
|
-
assert.equal(record.guard.verdict, 'allow');
|
|
264
|
-
});
|
|
265
|
-
|
|
266
|
-
// ------------------------------------------------------------------ rolling
|
|
267
|
-
|
|
268
|
-
test('rolling: the file never exceeds the cap and keeps the newest lines', async () => {
|
|
269
|
-
const dir = tempDir();
|
|
270
|
-
const path = statePathIn(dir);
|
|
271
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path, maxRecords: 3 });
|
|
272
|
-
for (let i = 0; i < 7; i += 1) {
|
|
273
|
-
await runtime.intercept('memory_recall', { query: `q-${i}` }, () => `r-${i}`);
|
|
274
|
-
}
|
|
275
|
-
const records = readRecords(path);
|
|
276
|
-
assert.equal(records.length, 3, 'capped at maxRecords');
|
|
277
|
-
assert.deepEqual(
|
|
278
|
-
records.map((r) => r.call.args.query),
|
|
279
|
-
['q-4', 'q-5', 'q-6'],
|
|
280
|
-
'the newest three survive',
|
|
281
|
-
);
|
|
282
|
-
assert.equal(runtime.stats().recorded, 7);
|
|
283
|
-
});
|
|
284
|
-
|
|
285
|
-
test('rolling: rotation is atomic and leaves no stray tmp file', async () => {
|
|
286
|
-
const dir = tempDir();
|
|
287
|
-
const path = statePathIn(dir);
|
|
288
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path, maxRecords: 2 });
|
|
289
|
-
for (let i = 0; i < 4; i += 1) await runtime.intercept('memory_recall', { query: `q-${i}` }, () => 'ok');
|
|
290
|
-
assert.equal(existsSync(`${path}.tmp-${process.pid}`), false);
|
|
291
|
-
assert.equal(readRecords(path).length, 2);
|
|
292
|
-
});
|
|
293
|
-
|
|
294
|
-
// -------------------------------------------------------------- sink broken
|
|
295
|
-
|
|
296
|
-
test('a broken record sink never changes what the tool does', async () => {
|
|
297
|
-
const dir = tempDir();
|
|
298
|
-
const blocker = join(dir, 'not-a-dir');
|
|
299
|
-
writeFileSync(blocker, 'x', 'utf8');
|
|
300
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: join(blocker, 'router-runtime.jsonl') });
|
|
301
|
-
assert.equal(await runtime.intercept('memory_recall', { query: 'q' }, () => 'cards'), 'cards');
|
|
302
|
-
assert.equal(runtime.stats().recorded, 0, 'nothing could be recorded');
|
|
303
|
-
assert.equal(runtime.stats().judged, 1, 'the judgement still happened');
|
|
304
|
-
});
|
|
305
|
-
|
|
306
|
-
// ----------------------------------------------------------------- coercion
|
|
307
|
-
|
|
308
|
-
test('judge text carries the tool name and the flag values', () => {
|
|
309
|
-
const text = buildJudgeText('memory_forget', { confirm: 'FORGET', reason: '删除重复', topK: 5, nested: { deep: '清掉' } });
|
|
310
|
-
assert.match(text, /memory_forget/);
|
|
311
|
-
assert.match(text, /confirm=forget/);
|
|
312
|
-
assert.match(text, /删除重复/);
|
|
313
|
-
assert.match(text, /清掉/, 'nested strings are flattened');
|
|
314
|
-
assert.ok(text.length <= 2000);
|
|
315
|
-
});
|
|
316
|
-
|
|
317
|
-
// -------------------------------------------------------------- integration
|
|
318
|
-
|
|
319
|
-
function fakeCtx() {
|
|
320
|
-
const registered = [];
|
|
321
|
-
const guards = [];
|
|
322
|
-
return {
|
|
323
|
-
registered,
|
|
324
|
-
guards,
|
|
325
|
-
tools: {
|
|
326
|
-
register(definition) {
|
|
327
|
-
registered.push(definition);
|
|
328
|
-
return () => {};
|
|
329
|
-
},
|
|
330
|
-
guard(fn) {
|
|
331
|
-
guards.push(fn);
|
|
332
|
-
return () => {};
|
|
333
|
-
},
|
|
334
|
-
},
|
|
335
|
-
};
|
|
336
|
-
}
|
|
337
|
-
|
|
338
|
-
test('registerTools: shadow wraps execute and records, without touching the result', async () => {
|
|
339
|
-
const dir = tempDir();
|
|
340
|
-
const path = statePathIn(dir);
|
|
341
|
-
const runtime = createRouterRuntime({ mode: 'shadow', statePath: path });
|
|
342
|
-
const ctx = fakeCtx();
|
|
343
|
-
const count = await registerTools(ctx, {
|
|
344
|
-
defineTool: (definition) => definition,
|
|
345
|
-
memoryRoot: dir,
|
|
346
|
-
memRoot: dir,
|
|
347
|
-
routerRuntime: runtime,
|
|
348
|
-
});
|
|
349
|
-
assert.equal(count, TOOLS.length);
|
|
350
|
-
assert.equal(ctx.registered.length, TOOLS.length);
|
|
351
|
-
assert.equal(ctx.guards.length, 1, 'the guard is registered for memory_save');
|
|
352
|
-
|
|
353
|
-
const forget = ctx.registered.find((tool) => tool.name === 'memory_forget');
|
|
354
|
-
const preview = await forget.execute({}, {});
|
|
355
|
-
assert.equal(preview.ok, true);
|
|
356
|
-
assert.equal(preview.dryRun !== false, true, 'no confirm means a preview');
|
|
357
|
-
const [record] = readRecords(path);
|
|
358
|
-
assert.equal(record.tool, 'memory_forget');
|
|
359
|
-
assert.equal(record.outcome.status, 'ok');
|
|
360
|
-
});
|
|
361
|
-
|
|
362
|
-
test('registerTools: on refuses through execute, and the guard only covers foreign tools', async () => {
|
|
363
|
-
const dir = tempDir();
|
|
364
|
-
const path = statePathIn(dir);
|
|
365
|
-
const runtime = createRouterRuntime({ mode: 'on', statePath: path, ownTools: TOOLS.map((t) => t.name) });
|
|
366
|
-
const ctx = fakeCtx();
|
|
367
|
-
await registerTools(ctx, { defineTool: (definition) => definition, memoryRoot: dir, memRoot: dir, routerRuntime: runtime });
|
|
368
|
-
|
|
369
|
-
const forget = ctx.registered.find((tool) => tool.name === 'memory_forget');
|
|
370
|
-
const failure = await forget.execute({ confirm: 'FORGET' }, {}).then(
|
|
371
|
-
() => null,
|
|
372
|
-
(error) => error,
|
|
373
|
-
);
|
|
374
|
-
assert.equal(failure.code, ROUTE_REFUSED_CODE);
|
|
375
|
-
|
|
376
|
-
const guard = ctx.guards[0];
|
|
377
|
-
assert.equal(guard({ name: 'memory_recall', arguments: { query: 'x' } }), undefined, 'own tools are skipped by the guard');
|
|
378
|
-
assert.equal(typeof guard({ name: 'memory_save', arguments: { content: '以后叫我小蓝' } }), 'string');
|
|
379
|
-
assert.equal(guard({ name: 'memory_save', arguments: { content: '普通事实' } }), undefined);
|
|
380
|
-
});
|
|
381
|
-
|
|
382
|
-
test('registerTools: off registers no guard and does not touch the routing layer', async () => {
|
|
383
|
-
const dir = tempDir();
|
|
384
|
-
const ctx = fakeCtx();
|
|
385
|
-
const runtime = createRouterRuntime({ mode: 'off', statePath: statePathIn(dir) });
|
|
386
|
-
await registerTools(ctx, { defineTool: (definition) => definition, memoryRoot: dir, memRoot: dir, routerRuntime: runtime });
|
|
387
|
-
assert.equal(ctx.guards.length, 0);
|
|
388
|
-
assert.equal(existsSync(statePathIn(dir)), false);
|
|
389
|
-
});
|
|
390
|
-
|
|
391
|
-
test('registerTools without a runtime behaves exactly like the old build', async () => {
|
|
392
|
-
const dir = tempDir();
|
|
393
|
-
const ctx = fakeCtx();
|
|
394
|
-
await registerTools(ctx, { defineTool: (definition) => definition, memoryRoot: dir, memRoot: dir });
|
|
395
|
-
assert.equal(ctx.guards.length, 0);
|
|
396
|
-
const forget = ctx.registered.find((tool) => tool.name === 'memory_forget');
|
|
397
|
-
const preview = await forget.execute({}, {});
|
|
398
|
-
assert.equal(preview.ok, true);
|
|
399
|
-
assert.equal(existsSync(join(dir, 'router-runtime.jsonl')), false);
|
|
400
|
-
});
|
|
401
|
-
|
|
402
|
-
// --------------------------------------------------------------- guard edge
|
|
403
|
-
|
|
404
|
-
test('guard: a router exception in shadow allows the call and never throws', () => {
|
|
405
|
-
const dir = tempDir();
|
|
406
|
-
const runtime = createRouterRuntime({
|
|
407
|
-
mode: 'shadow',
|
|
408
|
-
statePath: statePathIn(dir),
|
|
409
|
-
routeImpl: () => {
|
|
410
|
-
throw new Error('exploded');
|
|
411
|
-
},
|
|
412
|
-
});
|
|
413
|
-
assert.equal(runtime.guard('memory_save', { content: 'x' }), undefined);
|
|
414
|
-
});
|
|
415
|
-
|
|
416
|
-
test('guard: refuses fail-closed writes in on mode without throwing', () => {
|
|
417
|
-
const dir = tempDir();
|
|
418
|
-
const runtime = createRouterRuntime({
|
|
419
|
-
mode: 'on',
|
|
420
|
-
statePath: statePathIn(dir),
|
|
421
|
-
routeImpl: () => {
|
|
422
|
-
throw new Error('exploded');
|
|
423
|
-
},
|
|
424
|
-
});
|
|
425
|
-
const reason = runtime.guard('memory_save', { content: 'x' });
|
|
426
|
-
assert.equal(typeof reason, 'string');
|
|
427
|
-
assert.match(reason, /E_ROUTE_REFUSED/);
|
|
428
|
-
});
|
|
429
|
-
|
|
430
|
-
test('guard: an unwritable sink still returns a decision (recording is best effort)', () => {
|
|
431
|
-
const dir = tempDir();
|
|
432
|
-
mkdirSync(join(dir, 'ro'), { recursive: true });
|
|
433
|
-
const blocker = join(dir, 'ro', 'file');
|
|
434
|
-
writeFileSync(blocker, 'x', 'utf8');
|
|
435
|
-
const runtime = createRouterRuntime({ mode: 'on', statePath: join(blocker, 'x.jsonl') });
|
|
436
|
-
const reason = runtime.guard('memory_save', { content: '以后叫我小蓝' });
|
|
437
|
-
assert.equal(typeof reason, 'string', 'the refusal does not depend on the record landing');
|
|
438
|
-
});
|