@carloswon/cairn-memory 0.0.0-stage → 0.2.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 +54 -0
- package/LICENSE +21 -0
- package/README.md +158 -2
- package/dist/src/agents/adapters.d.ts +82 -0
- package/dist/src/agents/adapters.js +209 -0
- package/dist/src/agents/adapters.js.map +1 -0
- package/dist/src/agents/config.d.ts +82 -0
- package/dist/src/agents/config.js +603 -0
- package/dist/src/agents/config.js.map +1 -0
- package/dist/src/agents/cordisPatch.d.ts +89 -0
- package/dist/src/agents/cordisPatch.js +201 -0
- package/dist/src/agents/cordisPatch.js.map +1 -0
- package/dist/src/agents/index.d.ts +2 -0
- package/dist/src/agents/index.js +3 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/core/errors.d.ts +36 -0
- package/dist/src/core/errors.js +74 -0
- package/dist/src/core/errors.js.map +1 -0
- package/dist/src/core/hash.d.ts +14 -0
- package/dist/src/core/hash.js +48 -0
- package/dist/src/core/hash.js.map +1 -0
- package/dist/src/core/ids.d.ts +10 -0
- package/dist/src/core/ids.js +41 -0
- package/dist/src/core/ids.js.map +1 -0
- package/dist/src/core/index.d.ts +6 -0
- package/dist/src/core/index.js +7 -0
- package/dist/src/core/index.js.map +1 -0
- package/dist/src/core/scope.d.ts +78 -0
- package/dist/src/core/scope.js +181 -0
- package/dist/src/core/scope.js.map +1 -0
- package/dist/src/core/secrets.d.ts +13 -0
- package/dist/src/core/secrets.js +122 -0
- package/dist/src/core/secrets.js.map +1 -0
- package/dist/src/core/time.d.ts +7 -0
- package/dist/src/core/time.js +18 -0
- package/dist/src/core/time.js.map +1 -0
- package/dist/src/core/types.d.ts +133 -0
- package/dist/src/core/types.js +30 -0
- package/dist/src/core/types.js.map +1 -0
- package/dist/src/governance/apply.d.ts +64 -0
- package/dist/src/governance/apply.js +160 -0
- package/dist/src/governance/apply.js.map +1 -0
- package/dist/src/governance/dedup.d.ts +21 -0
- package/dist/src/governance/dedup.js +23 -0
- package/dist/src/governance/dedup.js.map +1 -0
- package/dist/src/governance/index.d.ts +16 -0
- package/dist/src/governance/index.js +17 -0
- package/dist/src/governance/index.js.map +1 -0
- package/dist/src/governance/propose.d.ts +78 -0
- package/dist/src/governance/propose.js +150 -0
- package/dist/src/governance/propose.js.map +1 -0
- package/dist/src/index.d.ts +15 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/interfaces/app-service.d.ts +242 -0
- package/dist/src/interfaces/app-service.js +614 -0
- package/dist/src/interfaces/app-service.js.map +1 -0
- package/dist/src/interfaces/cli/main.d.ts +2 -0
- package/dist/src/interfaces/cli/main.js +790 -0
- package/dist/src/interfaces/cli/main.js.map +1 -0
- package/dist/src/interfaces/console/assets/page.d.ts +18 -0
- package/dist/src/interfaces/console/assets/page.js +39 -0
- package/dist/src/interfaces/console/assets/page.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
- package/dist/src/interfaces/console/assets/ui-css.js +119 -0
- package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
- package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
- package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
- package/dist/src/interfaces/console/assets/url-state.js +45 -0
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
- package/dist/src/interfaces/console/export.d.ts +46 -0
- package/dist/src/interfaces/console/export.js +84 -0
- package/dist/src/interfaces/console/export.js.map +1 -0
- package/dist/src/interfaces/console/model.d.ts +372 -0
- package/dist/src/interfaces/console/model.js +731 -0
- package/dist/src/interfaces/console/model.js.map +1 -0
- package/dist/src/interfaces/console/review-store.d.ts +142 -0
- package/dist/src/interfaces/console/review-store.js +342 -0
- package/dist/src/interfaces/console/review-store.js.map +1 -0
- package/dist/src/interfaces/console/security.d.ts +76 -0
- package/dist/src/interfaces/console/security.js +105 -0
- package/dist/src/interfaces/console/security.js.map +1 -0
- package/dist/src/interfaces/console/server.d.ts +45 -0
- package/dist/src/interfaces/console/server.js +476 -0
- package/dist/src/interfaces/console/server.js.map +1 -0
- package/dist/src/interfaces/console/suggestions.d.ts +112 -0
- package/dist/src/interfaces/console/suggestions.js +511 -0
- package/dist/src/interfaces/console/suggestions.js.map +1 -0
- package/dist/src/interfaces/console/text.d.ts +4 -0
- package/dist/src/interfaces/console/text.js +18 -0
- package/dist/src/interfaces/console/text.js.map +1 -0
- package/dist/src/interfaces/mcp/server.d.ts +4 -0
- package/dist/src/interfaces/mcp/server.js +412 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -0
- package/dist/src/jobs/index.d.ts +6 -0
- package/dist/src/jobs/index.js +7 -0
- package/dist/src/jobs/index.js.map +1 -0
- package/dist/src/jobs/remote.d.ts +42 -0
- package/dist/src/jobs/remote.js +34 -0
- package/dist/src/jobs/remote.js.map +1 -0
- package/dist/src/jobs/worker.d.ts +67 -0
- package/dist/src/jobs/worker.js +169 -0
- package/dist/src/jobs/worker.js.map +1 -0
- package/dist/src/onboarding/auto.d.ts +88 -0
- package/dist/src/onboarding/auto.js +399 -0
- package/dist/src/onboarding/auto.js.map +1 -0
- package/dist/src/onboarding/batches.d.ts +103 -0
- package/dist/src/onboarding/batches.js +219 -0
- package/dist/src/onboarding/batches.js.map +1 -0
- package/dist/src/onboarding/discover.d.ts +54 -0
- package/dist/src/onboarding/discover.js +369 -0
- package/dist/src/onboarding/discover.js.map +1 -0
- package/dist/src/onboarding/import.d.ts +69 -0
- package/dist/src/onboarding/import.js +279 -0
- package/dist/src/onboarding/import.js.map +1 -0
- package/dist/src/onboarding/index.d.ts +24 -0
- package/dist/src/onboarding/index.js +22 -0
- package/dist/src/onboarding/index.js.map +1 -0
- package/dist/src/onboarding/judgement.d.ts +50 -0
- package/dist/src/onboarding/judgement.js +121 -0
- package/dist/src/onboarding/judgement.js.map +1 -0
- package/dist/src/onboarding/policy.d.ts +86 -0
- package/dist/src/onboarding/policy.js +249 -0
- package/dist/src/onboarding/policy.js.map +1 -0
- package/dist/src/projection/brief.d.ts +77 -0
- package/dist/src/projection/brief.js +111 -0
- package/dist/src/projection/brief.js.map +1 -0
- package/dist/src/projection/index.d.ts +1 -0
- package/dist/src/projection/index.js +2 -0
- package/dist/src/projection/index.js.map +1 -0
- package/dist/src/projection/markdown.d.ts +82 -0
- package/dist/src/projection/markdown.js +313 -0
- package/dist/src/projection/markdown.js.map +1 -0
- package/dist/src/retrieval/export.d.ts +80 -0
- package/dist/src/retrieval/export.js +215 -0
- package/dist/src/retrieval/export.js.map +1 -0
- package/dist/src/retrieval/index.d.ts +5 -0
- package/dist/src/retrieval/index.js +6 -0
- package/dist/src/retrieval/index.js.map +1 -0
- package/dist/src/retrieval/search.d.ts +37 -0
- package/dist/src/retrieval/search.js +294 -0
- package/dist/src/retrieval/search.js.map +1 -0
- package/dist/src/store/archives.d.ts +94 -0
- package/dist/src/store/archives.js +135 -0
- package/dist/src/store/archives.js.map +1 -0
- package/dist/src/store/audit.d.ts +26 -0
- package/dist/src/store/audit.js +48 -0
- package/dist/src/store/audit.js.map +1 -0
- package/dist/src/store/backup.d.ts +36 -0
- package/dist/src/store/backup.js +90 -0
- package/dist/src/store/backup.js.map +1 -0
- package/dist/src/store/blocks.d.ts +64 -0
- package/dist/src/store/blocks.js +104 -0
- package/dist/src/store/blocks.js.map +1 -0
- package/dist/src/store/conflicts.d.ts +52 -0
- package/dist/src/store/conflicts.js +112 -0
- package/dist/src/store/conflicts.js.map +1 -0
- package/dist/src/store/db.d.ts +44 -0
- package/dist/src/store/db.js +162 -0
- package/dist/src/store/db.js.map +1 -0
- package/dist/src/store/device.d.ts +46 -0
- package/dist/src/store/device.js +111 -0
- package/dist/src/store/device.js.map +1 -0
- package/dist/src/store/index.d.ts +14 -0
- package/dist/src/store/index.js +15 -0
- package/dist/src/store/index.js.map +1 -0
- package/dist/src/store/memories.d.ts +101 -0
- package/dist/src/store/memories.js +378 -0
- package/dist/src/store/memories.js.map +1 -0
- package/dist/src/store/migrate.d.ts +32 -0
- package/dist/src/store/migrate.js +86 -0
- package/dist/src/store/migrate.js.map +1 -0
- package/dist/src/store/open.d.ts +53 -0
- package/dist/src/store/open.js +177 -0
- package/dist/src/store/open.js.map +1 -0
- package/dist/src/store/outbox.d.ts +65 -0
- package/dist/src/store/outbox.js +137 -0
- package/dist/src/store/outbox.js.map +1 -0
- package/dist/src/store/plans.d.ts +137 -0
- package/dist/src/store/plans.js +243 -0
- package/dist/src/store/plans.js.map +1 -0
- package/dist/src/store/schema.d.ts +34 -0
- package/dist/src/store/schema.js +527 -0
- package/dist/src/store/schema.js.map +1 -0
- package/dist/src/store/scopes.d.ts +44 -0
- package/dist/src/store/scopes.js +220 -0
- package/dist/src/store/scopes.js.map +1 -0
- package/dist/src/store/write-guard.d.ts +10 -0
- package/dist/src/store/write-guard.js +10 -0
- package/dist/src/store/write-guard.js.map +1 -0
- package/dist/src/sync/apply.d.ts +24 -0
- package/dist/src/sync/apply.js +130 -0
- package/dist/src/sync/apply.js.map +1 -0
- package/dist/src/sync/cryptoutil.d.ts +86 -0
- package/dist/src/sync/cryptoutil.js +339 -0
- package/dist/src/sync/cryptoutil.js.map +1 -0
- package/dist/src/sync/events.d.ts +69 -0
- package/dist/src/sync/events.js +78 -0
- package/dist/src/sync/events.js.map +1 -0
- package/dist/src/sync/obs-store.d.ts +41 -0
- package/dist/src/sync/obs-store.js +325 -0
- package/dist/src/sync/obs-store.js.map +1 -0
- package/dist/src/sync/orchestrate.d.ts +37 -0
- package/dist/src/sync/orchestrate.js +84 -0
- package/dist/src/sync/orchestrate.js.map +1 -0
- package/dist/src/sync/pull.d.ts +24 -0
- package/dist/src/sync/pull.js +150 -0
- package/dist/src/sync/pull.js.map +1 -0
- package/dist/src/sync/push.d.ts +19 -0
- package/dist/src/sync/push.js +227 -0
- package/dist/src/sync/push.js.map +1 -0
- package/dist/src/sync/syncd-store.d.ts +31 -0
- package/dist/src/sync/syncd-store.js +92 -0
- package/dist/src/sync/syncd-store.js.map +1 -0
- package/dist/src/sync/vault.d.ts +37 -0
- package/dist/src/sync/vault.js +53 -0
- package/dist/src/sync/vault.js.map +1 -0
- package/docs/cairn-security.md +254 -0
- package/docs/cairn-usage.md +821 -0
- package/package.json +71 -4
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/onboarding/discover.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { CairnStore } from '../store/open.js';
|
|
2
|
+
import { ImportSourceKind } from '../store/archives.js';
|
|
3
|
+
/**
|
|
4
|
+
* 快照导入(任务 4.2 / spec agent-onboarding「不可变快照与默认本地档案」):
|
|
5
|
+
*
|
|
6
|
+
* 1. 读取来源字节并计算 sha256;【源文件绝不修改】(导入后重读比对做诚实
|
|
7
|
+
* 的 TOCTOU 检测)。
|
|
8
|
+
* 2. 原始字节写入 dataDir 旁的 snapshotsDir/<sha256前16位>-<basename>,
|
|
9
|
+
* 已存在则不覆盖(不可变快照)。
|
|
10
|
+
* 3. 档案幂等:(sourceLocator = 路径+大小+mtime 稳定序列化, contentHash = 文件
|
|
11
|
+
* sha256) 命中即复用,零新增档案与条目(spec「重复导入同一来源」)。
|
|
12
|
+
* 4. markdown-generic 解析:空行分隔的块;每条记 byteOffset 与
|
|
13
|
+
* sourceRef `basename#item-N`(N 与 item_index 一致,0 起)。
|
|
14
|
+
* 5. 每条 scanText:命中秘密/注入 → scan_state='blocked',content 以占位符
|
|
15
|
+
* 入库(原文只存在于不可变快照文件,DB 绝不落秘密原文),scan_findings
|
|
16
|
+
* 只存 kind+masked 摘要;全部 clean → 'scanned_clean',有 blocked →
|
|
17
|
+
* 'scanned_blocked'(spec memory-governance「秘密与提示注入阻断」)。
|
|
18
|
+
* 6. 审计 record('import', ...) 记录 snapshot_created / snapshot_reused。
|
|
19
|
+
*
|
|
20
|
+
* 两层导入模型中的档案层:导入完成内容即本地可检索(imported_unverified、
|
|
21
|
+
* local_only),晋升为正式记忆是 batches.ts 的另一层,需治理计划+真实审批,
|
|
22
|
+
* 全程不依赖模型可用。
|
|
23
|
+
*/
|
|
24
|
+
export declare const DEFAULT_MAX_ITEM_BYTES: number;
|
|
25
|
+
export interface ImportSourceInput {
|
|
26
|
+
/** 来源 Agent 类型:'claude-code' | 'cursor' | 'copilot' | 'openclaw' | 'workbuddy' | 'manual'。 */
|
|
27
|
+
agentKind: string;
|
|
28
|
+
/** 用户勾选的来源文件路径。 */
|
|
29
|
+
sourcePath: string;
|
|
30
|
+
/** 默认 'markdown-generic'。 */
|
|
31
|
+
parser?: string;
|
|
32
|
+
/** 默认新建(uuidv7)。 */
|
|
33
|
+
batchId?: string;
|
|
34
|
+
/** 默认 'markdown'。 */
|
|
35
|
+
sourceKind?: ImportSourceKind;
|
|
36
|
+
/** 默认 64KB;超长条目按行(单行再按 UTF-8 安全字节边界)再切。 */
|
|
37
|
+
maxItemBytes?: number;
|
|
38
|
+
}
|
|
39
|
+
export interface ImportOutcome {
|
|
40
|
+
/** 新建档案 id;幂等复用时为 null。 */
|
|
41
|
+
archiveId: string | null;
|
|
42
|
+
/** 幂等复用的既有档案 id;新建时为 null。 */
|
|
43
|
+
reusedArchiveId: string | null;
|
|
44
|
+
batchId: string;
|
|
45
|
+
/** archive 是否新建。 */
|
|
46
|
+
created: boolean;
|
|
47
|
+
/** 本次新登记条目数(重复导入为 0)。 */
|
|
48
|
+
itemCount: number;
|
|
49
|
+
/** 秘密/注入命中被阻断的条目数。 */
|
|
50
|
+
skippedItems: number;
|
|
51
|
+
/** 导入前源文件 sha256。 */
|
|
52
|
+
sourceHashBefore: string;
|
|
53
|
+
/** 导入后源文件 sha256(成功返回时必与 before 相等,不等已抛 E_IO)。 */
|
|
54
|
+
sourceHashAfter: string;
|
|
55
|
+
}
|
|
56
|
+
interface ParsedItem {
|
|
57
|
+
content: string;
|
|
58
|
+
byteOffset: number;
|
|
59
|
+
}
|
|
60
|
+
export declare function importSnapshot(store: CairnStore, input: ImportSourceInput): Promise<ImportOutcome>;
|
|
61
|
+
/**
|
|
62
|
+
* markdown-generic 解析:按空行(trim 后为空)分隔成块,连续非空行为一条;
|
|
63
|
+
* 去掉每行 Markdown 引用前缀('> ')后作为 content;byteOffset 是该条内容
|
|
64
|
+
* 首字节在源文件中的真实字节偏移(按 UTF-8 字节计,多字节字符安全)。
|
|
65
|
+
* 超过 maxItemBytes 的块再切分:优先按行边界;单行超长按 UTF-8 安全字节
|
|
66
|
+
* 边界硬切(绝不切断多字节字符),拼接可无损还原。
|
|
67
|
+
*/
|
|
68
|
+
export declare function parseMarkdownItems(buf: Buffer, maxItemBytes: number): ParsedItem[];
|
|
69
|
+
export {};
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
import { readFile, stat, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { basename, join, resolve } from 'node:path';
|
|
3
|
+
import { scanText } from '../core/secrets.js';
|
|
4
|
+
import { sha256Hex } from '../core/hash.js';
|
|
5
|
+
import { uuidv7 } from '../core/ids.js';
|
|
6
|
+
import { err } from '../core/errors.js';
|
|
7
|
+
/**
|
|
8
|
+
* 快照导入(任务 4.2 / spec agent-onboarding「不可变快照与默认本地档案」):
|
|
9
|
+
*
|
|
10
|
+
* 1. 读取来源字节并计算 sha256;【源文件绝不修改】(导入后重读比对做诚实
|
|
11
|
+
* 的 TOCTOU 检测)。
|
|
12
|
+
* 2. 原始字节写入 dataDir 旁的 snapshotsDir/<sha256前16位>-<basename>,
|
|
13
|
+
* 已存在则不覆盖(不可变快照)。
|
|
14
|
+
* 3. 档案幂等:(sourceLocator = 路径+大小+mtime 稳定序列化, contentHash = 文件
|
|
15
|
+
* sha256) 命中即复用,零新增档案与条目(spec「重复导入同一来源」)。
|
|
16
|
+
* 4. markdown-generic 解析:空行分隔的块;每条记 byteOffset 与
|
|
17
|
+
* sourceRef `basename#item-N`(N 与 item_index 一致,0 起)。
|
|
18
|
+
* 5. 每条 scanText:命中秘密/注入 → scan_state='blocked',content 以占位符
|
|
19
|
+
* 入库(原文只存在于不可变快照文件,DB 绝不落秘密原文),scan_findings
|
|
20
|
+
* 只存 kind+masked 摘要;全部 clean → 'scanned_clean',有 blocked →
|
|
21
|
+
* 'scanned_blocked'(spec memory-governance「秘密与提示注入阻断」)。
|
|
22
|
+
* 6. 审计 record('import', ...) 记录 snapshot_created / snapshot_reused。
|
|
23
|
+
*
|
|
24
|
+
* 两层导入模型中的档案层:导入完成内容即本地可检索(imported_unverified、
|
|
25
|
+
* local_only),晋升为正式记忆是 batches.ts 的另一层,需治理计划+真实审批,
|
|
26
|
+
* 全程不依赖模型可用。
|
|
27
|
+
*/
|
|
28
|
+
export const DEFAULT_MAX_ITEM_BYTES = 64 * 1024;
|
|
29
|
+
/** 当前唯一实现的解析器;其他 parser 名一律 E_VALIDATION(诚实拒绝,不静默降级)。 */
|
|
30
|
+
const SUPPORTED_PARSERS = new Set(['markdown-generic']);
|
|
31
|
+
const SOURCE_KINDS = ['markdown', 'jsonl', 'agent_memory_file', 'manual_export'];
|
|
32
|
+
export async function importSnapshot(store, input) {
|
|
33
|
+
if (typeof input.agentKind !== 'string' || input.agentKind.trim().length === 0) {
|
|
34
|
+
throw err('E_VALIDATION', 'agentKind 不能为空');
|
|
35
|
+
}
|
|
36
|
+
const parser = input.parser ?? 'markdown-generic';
|
|
37
|
+
if (!SUPPORTED_PARSERS.has(parser)) {
|
|
38
|
+
throw err('E_VALIDATION', `暂不支持的解析器: ${parser}(当前仅 markdown-generic)`);
|
|
39
|
+
}
|
|
40
|
+
const sourceKind = input.sourceKind ?? 'markdown';
|
|
41
|
+
if (!SOURCE_KINDS.includes(sourceKind)) {
|
|
42
|
+
throw err('E_VALIDATION', `非法 sourceKind: ${String(sourceKind)}`);
|
|
43
|
+
}
|
|
44
|
+
const maxItemBytes = input.maxItemBytes ?? DEFAULT_MAX_ITEM_BYTES;
|
|
45
|
+
if (!Number.isInteger(maxItemBytes) || maxItemBytes < 16) {
|
|
46
|
+
throw err('E_VALIDATION', 'maxItemBytes 必须是不小于 16 的整数');
|
|
47
|
+
}
|
|
48
|
+
// 1. 读取源字节(不存在 → E_NOT_FOUND);只读,绝不写回源文件。
|
|
49
|
+
let bytes;
|
|
50
|
+
try {
|
|
51
|
+
bytes = await readFile(input.sourcePath);
|
|
52
|
+
}
|
|
53
|
+
catch (e) {
|
|
54
|
+
if (e.code === 'ENOENT') {
|
|
55
|
+
throw err('E_NOT_FOUND', `来源文件不存在: ${input.sourcePath}`);
|
|
56
|
+
}
|
|
57
|
+
throw err('E_IO', `无法读取来源文件 ${input.sourcePath}: ${e.message}`);
|
|
58
|
+
}
|
|
59
|
+
const sourceHashBefore = sha256Hex(bytes);
|
|
60
|
+
let st;
|
|
61
|
+
try {
|
|
62
|
+
st = await stat(input.sourcePath);
|
|
63
|
+
}
|
|
64
|
+
catch (e) {
|
|
65
|
+
throw err('E_IO', `无法获取来源文件元数据 ${input.sourcePath}: ${e.message}`);
|
|
66
|
+
}
|
|
67
|
+
// sourceLocator:路径 + 大小 + mtime 的稳定序列化(resolve 消除相对路径差异)。
|
|
68
|
+
const sourceLocator = JSON.stringify({
|
|
69
|
+
v: 1,
|
|
70
|
+
path: resolve(input.sourcePath),
|
|
71
|
+
size: bytes.byteLength,
|
|
72
|
+
mtimeMs: st.mtimeMs,
|
|
73
|
+
});
|
|
74
|
+
// 2. 解析先行:空文件/无条目在任何写入发生前即 E_VALIDATION(零副作用)。
|
|
75
|
+
const items = parseMarkdownItems(bytes, maxItemBytes);
|
|
76
|
+
if (items.length === 0) {
|
|
77
|
+
throw err('E_VALIDATION', '来源文件没有可导入的条目(空文件或仅空白行)');
|
|
78
|
+
}
|
|
79
|
+
// 3. 不可变快照:wx 标志写入,已存在则不覆盖。
|
|
80
|
+
const base = basename(input.sourcePath);
|
|
81
|
+
const snapshotPath = await ensureSnapshot(store.paths.snapshotsDir, sourceHashBefore, base, bytes);
|
|
82
|
+
const batchId = input.batchId ?? uuidv7();
|
|
83
|
+
// 4-6. 档案登记 + 条目扫描 + 审计,全部包在单事务里保证原子性。
|
|
84
|
+
const result = store.db.transaction(() => {
|
|
85
|
+
const { archive, created } = store.archives.createArchive({
|
|
86
|
+
batchId,
|
|
87
|
+
sourceKind,
|
|
88
|
+
sourceLocator,
|
|
89
|
+
sourceLabel: `${input.agentKind}:${base}`,
|
|
90
|
+
byteSize: bytes.byteLength,
|
|
91
|
+
contentHash: sourceHashBefore,
|
|
92
|
+
snapshotPath,
|
|
93
|
+
parser,
|
|
94
|
+
});
|
|
95
|
+
if (!created) {
|
|
96
|
+
// 幂等复用:零新增档案与条目;已入库条目不重扫、不换批。
|
|
97
|
+
store.audit.record('import', 'snapshot_reused', { type: 'archive', id: archive.id }, {
|
|
98
|
+
sourceHash: sourceHashBefore,
|
|
99
|
+
itemCount: 0,
|
|
100
|
+
blockedCount: 0,
|
|
101
|
+
agentKind: input.agentKind,
|
|
102
|
+
});
|
|
103
|
+
return { archive, created, itemCount: 0, skippedItems: 0 };
|
|
104
|
+
}
|
|
105
|
+
let blockedCount = 0;
|
|
106
|
+
for (let index = 0; index < items.length; index++) {
|
|
107
|
+
const it = items[index];
|
|
108
|
+
const scan = scanText(it.content);
|
|
109
|
+
let content = it.content;
|
|
110
|
+
let scanFindings;
|
|
111
|
+
if (!scan.clean) {
|
|
112
|
+
blockedCount++;
|
|
113
|
+
// 阻断条目的 content 用占位符入库:原文只存在于不可变快照文件,
|
|
114
|
+
// DB(含审计与任何 dump)绝不落秘密/注入原文;仅 kind+masked 摘要。
|
|
115
|
+
content = blockedPlaceholder(scan);
|
|
116
|
+
scanFindings = JSON.stringify({
|
|
117
|
+
secrets: scan.findings.map((f) => ({ kind: f.kind, masked: f.masked })),
|
|
118
|
+
injections: scan.injectionFindings.map((f) => ({ kind: f.kind, rule: f.rule })),
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
store.archives.addItem({
|
|
122
|
+
archiveId: archive.id,
|
|
123
|
+
itemIndex: index,
|
|
124
|
+
content,
|
|
125
|
+
byteOffset: it.byteOffset,
|
|
126
|
+
sourceRef: `${base}#item-${index}`,
|
|
127
|
+
scanState: scan.clean ? 'clean' : 'blocked',
|
|
128
|
+
scanFindings,
|
|
129
|
+
batchId,
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
store.archives.setRedactionState(archive.id, blockedCount > 0 ? 'scanned_blocked' : 'scanned_clean');
|
|
133
|
+
store.archives.setStatus(archive.id, 'indexed');
|
|
134
|
+
store.audit.record('import', 'snapshot_created', { type: 'archive', id: archive.id }, {
|
|
135
|
+
sourceHash: sourceHashBefore,
|
|
136
|
+
itemCount: items.length,
|
|
137
|
+
blockedCount,
|
|
138
|
+
agentKind: input.agentKind,
|
|
139
|
+
});
|
|
140
|
+
return { archive, created, itemCount: items.length, skippedItems: blockedCount };
|
|
141
|
+
});
|
|
142
|
+
// 7. TOCTOU 诚实检测:导入后重读源文件,字节变化即 E_IO(导入本身仍基于
|
|
143
|
+
// 读取时点的快照成立,但必须把不一致大声暴露,绝不静默吞掉)。
|
|
144
|
+
const sourceHashAfter = await rehashSource(input.sourcePath, sourceHashBefore);
|
|
145
|
+
return {
|
|
146
|
+
archiveId: result.created ? result.archive.id : null,
|
|
147
|
+
reusedArchiveId: result.created ? null : result.archive.id,
|
|
148
|
+
batchId: result.created ? batchId : (input.batchId ?? result.archive.batchId),
|
|
149
|
+
created: result.created,
|
|
150
|
+
itemCount: result.itemCount,
|
|
151
|
+
skippedItems: result.skippedItems,
|
|
152
|
+
sourceHashBefore,
|
|
153
|
+
sourceHashAfter,
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
/** 不可变快照:写入 snapshotsDir/<hash前16位>-<basename>;EEXIST 视为快照已存在,不覆盖。 */
|
|
157
|
+
async function ensureSnapshot(snapshotsDir, contentHash, base, bytes) {
|
|
158
|
+
const snapshotPath = join(snapshotsDir, `${contentHash.slice(0, 16)}-${base}`);
|
|
159
|
+
try {
|
|
160
|
+
await writeFile(snapshotPath, bytes, { flag: 'wx' });
|
|
161
|
+
}
|
|
162
|
+
catch (e) {
|
|
163
|
+
if (e.code !== 'EEXIST') {
|
|
164
|
+
throw err('E_IO', `无法写入不可变快照 ${snapshotPath}: ${e.message}`);
|
|
165
|
+
}
|
|
166
|
+
// 已存在:不可变快照语义,保持原字节不动。
|
|
167
|
+
}
|
|
168
|
+
return snapshotPath;
|
|
169
|
+
}
|
|
170
|
+
async function rehashSource(sourcePath, before) {
|
|
171
|
+
let after;
|
|
172
|
+
try {
|
|
173
|
+
after = await readFile(sourcePath);
|
|
174
|
+
}
|
|
175
|
+
catch (e) {
|
|
176
|
+
throw err('E_IO', '导入完成后无法重新读取源文件(TOCTOU 检测失败,来源可能已被移动或删除)', {
|
|
177
|
+
reason: e.message,
|
|
178
|
+
});
|
|
179
|
+
}
|
|
180
|
+
const afterHash = sha256Hex(after);
|
|
181
|
+
if (afterHash !== before) {
|
|
182
|
+
throw err('E_IO', '导入期间源文件字节发生变化:本次导入基于读取时点完成,请核对来源后重试', {
|
|
183
|
+
sourceHashBefore: before,
|
|
184
|
+
sourceHashAfter: afterHash,
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
return afterHash;
|
|
188
|
+
}
|
|
189
|
+
/** blocked 条目入库占位符:只含 kind/rule 名,不含任何原文片段。 */
|
|
190
|
+
function blockedPlaceholder(scan) {
|
|
191
|
+
const kinds = [...scan.findings.map((f) => f.kind), ...scan.injectionFindings.map((f) => f.rule)];
|
|
192
|
+
return `[blocked:${kinds.join(',')}]`;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* markdown-generic 解析:按空行(trim 后为空)分隔成块,连续非空行为一条;
|
|
196
|
+
* 去掉每行 Markdown 引用前缀('> ')后作为 content;byteOffset 是该条内容
|
|
197
|
+
* 首字节在源文件中的真实字节偏移(按 UTF-8 字节计,多字节字符安全)。
|
|
198
|
+
* 超过 maxItemBytes 的块再切分:优先按行边界;单行超长按 UTF-8 安全字节
|
|
199
|
+
* 边界硬切(绝不切断多字节字符),拼接可无损还原。
|
|
200
|
+
*/
|
|
201
|
+
export function parseMarkdownItems(buf, maxItemBytes) {
|
|
202
|
+
const text = buf.toString('utf8');
|
|
203
|
+
const lines = [];
|
|
204
|
+
let byteStart = 0;
|
|
205
|
+
for (const raw of text.split('\n')) {
|
|
206
|
+
const line = raw.endsWith('\r') ? raw.slice(0, -1) : raw;
|
|
207
|
+
lines.push({ text: line, byteStart });
|
|
208
|
+
byteStart += Buffer.byteLength(raw, 'utf8') + 1; // +1 为换行符本身
|
|
209
|
+
}
|
|
210
|
+
const out = [];
|
|
211
|
+
let block = [];
|
|
212
|
+
const flushBlock = () => {
|
|
213
|
+
if (block.length > 0) {
|
|
214
|
+
out.push(...emitChunked(block, maxItemBytes));
|
|
215
|
+
block = [];
|
|
216
|
+
}
|
|
217
|
+
};
|
|
218
|
+
for (const line of lines) {
|
|
219
|
+
if (line.text.trim().length === 0)
|
|
220
|
+
flushBlock();
|
|
221
|
+
else
|
|
222
|
+
block.push(line);
|
|
223
|
+
}
|
|
224
|
+
flushBlock();
|
|
225
|
+
// 纯引用符号等剥完前缀为空白的块不构成条目。
|
|
226
|
+
return out.filter((it) => it.content.trim().length > 0);
|
|
227
|
+
}
|
|
228
|
+
function emitChunked(block, maxItemBytes) {
|
|
229
|
+
const stripped = block.map((l) => {
|
|
230
|
+
const m = /^> ?/.exec(l.text);
|
|
231
|
+
const prefixBytes = m ? Buffer.byteLength(m[0], 'utf8') : 0;
|
|
232
|
+
return { text: m ? l.text.slice(m[0].length) : l.text, byteStart: l.byteStart + prefixBytes };
|
|
233
|
+
});
|
|
234
|
+
const full = stripped.map((l) => l.text).join('\n');
|
|
235
|
+
if (Buffer.byteLength(full, 'utf8') <= maxItemBytes) {
|
|
236
|
+
return [{ content: full, byteOffset: stripped[0].byteStart }];
|
|
237
|
+
}
|
|
238
|
+
const out = [];
|
|
239
|
+
let cur = null;
|
|
240
|
+
const flush = () => {
|
|
241
|
+
if (cur == null)
|
|
242
|
+
return;
|
|
243
|
+
out.push({ content: cur.parts.join('\n'), byteOffset: cur.start });
|
|
244
|
+
cur = null;
|
|
245
|
+
};
|
|
246
|
+
for (const line of stripped) {
|
|
247
|
+
const lineBytes = Buffer.byteLength(line.text, 'utf8');
|
|
248
|
+
if (lineBytes > maxItemBytes) {
|
|
249
|
+
// 单行超长:按 UTF-8 安全字节边界硬切(回退到字符起始字节)。
|
|
250
|
+
flush();
|
|
251
|
+
const lineBuf = Buffer.from(line.text, 'utf8');
|
|
252
|
+
let off = 0;
|
|
253
|
+
while (off < lineBuf.length) {
|
|
254
|
+
let end = Math.min(off + maxItemBytes, lineBuf.length);
|
|
255
|
+
if (end < lineBuf.length) {
|
|
256
|
+
while (end > off) {
|
|
257
|
+
const b = lineBuf[end];
|
|
258
|
+
if (b !== undefined && (b & 0xc0) === 0x80)
|
|
259
|
+
end--;
|
|
260
|
+
else
|
|
261
|
+
break;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
out.push({ content: lineBuf.subarray(off, end).toString('utf8'), byteOffset: line.byteStart + off });
|
|
265
|
+
off = end;
|
|
266
|
+
}
|
|
267
|
+
continue;
|
|
268
|
+
}
|
|
269
|
+
if (cur != null && cur.size + 1 + lineBytes > maxItemBytes)
|
|
270
|
+
flush();
|
|
271
|
+
if (cur == null)
|
|
272
|
+
cur = { parts: [], start: line.byteStart, size: 0 };
|
|
273
|
+
cur.parts.push(line.text);
|
|
274
|
+
cur.size += (cur.parts.length > 1 ? 1 : 0) + lineBytes; // 行间 '\n' 占 1 字节
|
|
275
|
+
}
|
|
276
|
+
flush();
|
|
277
|
+
return out;
|
|
278
|
+
}
|
|
279
|
+
//# sourceMappingURL=import.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../src/onboarding/import.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cairn 首次初始化(onboarding)公共入口。
|
|
3
|
+
*
|
|
4
|
+
* 两层导入模型(spec agent-onboarding):
|
|
5
|
+
*
|
|
6
|
+
* 1. 档案层 —— importSnapshot():授权后创建带来源哈希的不可变快照并登记
|
|
7
|
+
* 条目,导入完成内容即本地可检索(imported_unverified + local_only)。
|
|
8
|
+
* 全程确定性代码,不依赖任何模型;模型不可用或整理任务中断时,用户仍可
|
|
9
|
+
* 检索、导出原始档案,未验证状态保持清晰。
|
|
10
|
+
*
|
|
11
|
+
* 2. 晋升层 —— batches.ts:当前 Agent 按批次分块(nextBatchChunk 的持久化
|
|
12
|
+
* 游标)读取 clean 且未晋升的条目生成治理建议,经治理计划 + 真实审批后
|
|
13
|
+
* 才晋升为正式记忆(markItemPromoted)。会话中断后可在新会话继续未完成
|
|
14
|
+
* 批次,不重复已应用操作,也不扩大原授权范围。晋升状态由审计事件承载
|
|
15
|
+
* (审计即状态,schema 冻结不加列)。
|
|
16
|
+
*
|
|
17
|
+
* 秘密与注入阻断(spec memory-governance):命中扫描的条目 scan_state='blocked',
|
|
18
|
+
* 以占位符入库、原文仅存于不可变快照文件,永不进入批次、日志或上行内容。
|
|
19
|
+
*/
|
|
20
|
+
export { importSnapshot, parseMarkdownItems, DEFAULT_MAX_ITEM_BYTES } from './import.js';
|
|
21
|
+
export type { ImportSourceInput, ImportOutcome } from './import.js';
|
|
22
|
+
export { assignBatch, batchProgress, nextBatchChunk, markItemPromoted, markItemSkipped, listSkippedItems, } from './batches.js';
|
|
23
|
+
export type { SkipBasis, SkippedItem } from './batches.js';
|
|
24
|
+
export type { BatchProgress, BatchChunkItem } from './batches.js';
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cairn 首次初始化(onboarding)公共入口。
|
|
3
|
+
*
|
|
4
|
+
* 两层导入模型(spec agent-onboarding):
|
|
5
|
+
*
|
|
6
|
+
* 1. 档案层 —— importSnapshot():授权后创建带来源哈希的不可变快照并登记
|
|
7
|
+
* 条目,导入完成内容即本地可检索(imported_unverified + local_only)。
|
|
8
|
+
* 全程确定性代码,不依赖任何模型;模型不可用或整理任务中断时,用户仍可
|
|
9
|
+
* 检索、导出原始档案,未验证状态保持清晰。
|
|
10
|
+
*
|
|
11
|
+
* 2. 晋升层 —— batches.ts:当前 Agent 按批次分块(nextBatchChunk 的持久化
|
|
12
|
+
* 游标)读取 clean 且未晋升的条目生成治理建议,经治理计划 + 真实审批后
|
|
13
|
+
* 才晋升为正式记忆(markItemPromoted)。会话中断后可在新会话继续未完成
|
|
14
|
+
* 批次,不重复已应用操作,也不扩大原授权范围。晋升状态由审计事件承载
|
|
15
|
+
* (审计即状态,schema 冻结不加列)。
|
|
16
|
+
*
|
|
17
|
+
* 秘密与注入阻断(spec memory-governance):命中扫描的条目 scan_state='blocked',
|
|
18
|
+
* 以占位符入库、原文仅存于不可变快照文件,永不进入批次、日志或上行内容。
|
|
19
|
+
*/
|
|
20
|
+
export { importSnapshot, parseMarkdownItems, DEFAULT_MAX_ITEM_BYTES } from './import.js';
|
|
21
|
+
export { assignBatch, batchProgress, nextBatchChunk, markItemPromoted, markItemSkipped, listSkippedItems, } from './batches.js';
|
|
22
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEzF,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { DuplicateHit } from '../governance/dedup.js';
|
|
2
|
+
/**
|
|
3
|
+
* 写入时判断(design D6 / D10):判断是**建议**,不是授权。
|
|
4
|
+
*
|
|
5
|
+
* 它只回答"这条值不值得记",不回答"允许不允许记"。后者一律由写入参数、作用域解析与
|
|
6
|
+
* 策略白名单决定。因此这里**没有**任何能改敏感度、改作用域、或构成审批凭证的字段——
|
|
7
|
+
* 不是没实现,是不允许存在。
|
|
8
|
+
*/
|
|
9
|
+
export declare const JUDGEMENT_CONFIDENCES: readonly ["high", "medium", "low"];
|
|
10
|
+
export type JudgementConfidence = (typeof JUDGEMENT_CONFIDENCES)[number];
|
|
11
|
+
export declare const DEDUPE_INTENTS: readonly ["merge", "keep_both"];
|
|
12
|
+
export type DedupeIntent = (typeof DEDUPE_INTENTS)[number];
|
|
13
|
+
export type VerdictKind = 'keep' | 'skip' | 'merge_into';
|
|
14
|
+
export declare const RATIONALE_MAX = 500;
|
|
15
|
+
export interface Judgement {
|
|
16
|
+
verdict: VerdictKind;
|
|
17
|
+
/** 仅 verdict === 'merge_into' 时非空。 */
|
|
18
|
+
mergeIntoId: string | null;
|
|
19
|
+
confidence: JudgementConfidence;
|
|
20
|
+
rationale: string;
|
|
21
|
+
dedupe: DedupeIntent;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* 解析并校验判断。非法值一律拒绝,MUST NOT 用默认值补齐——
|
|
25
|
+
* 补齐会把"调用方说错了"变成"系统替它选了一个",而这两件事在审计里必须能分开。
|
|
26
|
+
*/
|
|
27
|
+
export declare function parseJudgement(raw: unknown): Judgement;
|
|
28
|
+
/** CLI 用扁平参数拼装,复杂到需要对象时由调用方直接传 JSON。 */
|
|
29
|
+
export declare function judgementFromFlags(flags: Record<string, string | boolean | undefined>): Judgement | null;
|
|
30
|
+
export type WriteAction = 'insert' | 'merge' | 'promote_candidate' | 'skip' | 'candidate';
|
|
31
|
+
export interface WriteDecision {
|
|
32
|
+
action: WriteAction;
|
|
33
|
+
/** merge 时指向被并入的记忆;其余为 null。 */
|
|
34
|
+
targetMemoryId: string | null;
|
|
35
|
+
/** 落审计的判定依据,形如 judgement_skip_medium / duplicate_active。 */
|
|
36
|
+
basis: string;
|
|
37
|
+
}
|
|
38
|
+
export interface DecideWriteInput {
|
|
39
|
+
judgement: Judgement | null;
|
|
40
|
+
duplicate: DuplicateHit | null;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* 判断 + 查重 → 落库动作。纯函数,不读库不写库。
|
|
44
|
+
*
|
|
45
|
+
* 关键取舍:**没有判断时也要查重**。写入路径的重复不是判断出来的,是比对出来的;
|
|
46
|
+
* 先把这件事做掉,才谈得上"只有一条"。
|
|
47
|
+
*/
|
|
48
|
+
export declare function decideWrite(input: DecideWriteInput): WriteDecision;
|
|
49
|
+
/** 审计用的紧凑描述:不落原文,只落结论与理由。 */
|
|
50
|
+
export declare function describeJudgement(j: Judgement): string;
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* 写入时判断(design D6 / D10):判断是**建议**,不是授权。
|
|
4
|
+
*
|
|
5
|
+
* 它只回答"这条值不值得记",不回答"允许不允许记"。后者一律由写入参数、作用域解析与
|
|
6
|
+
* 策略白名单决定。因此这里**没有**任何能改敏感度、改作用域、或构成审批凭证的字段——
|
|
7
|
+
* 不是没实现,是不允许存在。
|
|
8
|
+
*/
|
|
9
|
+
export const JUDGEMENT_CONFIDENCES = ['high', 'medium', 'low'];
|
|
10
|
+
export const DEDUPE_INTENTS = ['merge', 'keep_both'];
|
|
11
|
+
export const RATIONALE_MAX = 500;
|
|
12
|
+
const MERGE_INTO_PREFIX = 'merge_into:';
|
|
13
|
+
/**
|
|
14
|
+
* 解析并校验判断。非法值一律拒绝,MUST NOT 用默认值补齐——
|
|
15
|
+
* 补齐会把"调用方说错了"变成"系统替它选了一个",而这两件事在审计里必须能分开。
|
|
16
|
+
*/
|
|
17
|
+
export function parseJudgement(raw) {
|
|
18
|
+
if (raw == null)
|
|
19
|
+
throw err('E_VALIDATION', '判断不能为空');
|
|
20
|
+
if (typeof raw !== 'object' || Array.isArray(raw)) {
|
|
21
|
+
throw err('E_VALIDATION', '判断必须是对象');
|
|
22
|
+
}
|
|
23
|
+
const obj = raw;
|
|
24
|
+
const verdictRaw = obj['verdict'];
|
|
25
|
+
if (typeof verdictRaw !== 'string' || verdictRaw.trim().length === 0) {
|
|
26
|
+
throw err('E_VALIDATION', '判断缺少 verdict(keep / skip / merge_into:<记忆id>)');
|
|
27
|
+
}
|
|
28
|
+
const verdictText = verdictRaw.trim();
|
|
29
|
+
let verdict;
|
|
30
|
+
let mergeIntoId = null;
|
|
31
|
+
if (verdictText === 'keep' || verdictText === 'skip') {
|
|
32
|
+
verdict = verdictText;
|
|
33
|
+
}
|
|
34
|
+
else if (verdictText.startsWith(MERGE_INTO_PREFIX)) {
|
|
35
|
+
const target = verdictText.slice(MERGE_INTO_PREFIX.length).trim();
|
|
36
|
+
if (target.length === 0) {
|
|
37
|
+
throw err('E_VALIDATION', 'merge_into 必须指定目标记忆 id');
|
|
38
|
+
}
|
|
39
|
+
verdict = 'merge_into';
|
|
40
|
+
mergeIntoId = target;
|
|
41
|
+
}
|
|
42
|
+
else {
|
|
43
|
+
throw err('E_VALIDATION', `verdict 非法: ${verdictText}(只允许 keep / skip / merge_into:<记忆id>)`);
|
|
44
|
+
}
|
|
45
|
+
const confidenceRaw = obj['confidence'];
|
|
46
|
+
if (typeof confidenceRaw !== 'string' || !JUDGEMENT_CONFIDENCES.includes(confidenceRaw)) {
|
|
47
|
+
throw err('E_VALIDATION', `confidence 缺失或非法(只允许 ${JUDGEMENT_CONFIDENCES.join(' / ')}),不能省略`);
|
|
48
|
+
}
|
|
49
|
+
const confidence = confidenceRaw;
|
|
50
|
+
const rationaleRaw = obj['rationale'];
|
|
51
|
+
if (typeof rationaleRaw !== 'string' || rationaleRaw.trim().length === 0) {
|
|
52
|
+
throw err('E_VALIDATION', '判断必须给出一句话理由(rationale),不能为空');
|
|
53
|
+
}
|
|
54
|
+
const rationale = rationaleRaw.trim();
|
|
55
|
+
if (rationale.length > RATIONALE_MAX) {
|
|
56
|
+
throw err('E_VALIDATION', `rationale 超过 ${RATIONALE_MAX} 字符上限`);
|
|
57
|
+
}
|
|
58
|
+
const dedupeRaw = obj['dedupe'];
|
|
59
|
+
let dedupe = 'merge';
|
|
60
|
+
if (dedupeRaw != null) {
|
|
61
|
+
if (typeof dedupeRaw !== 'string' || !DEDUPE_INTENTS.includes(dedupeRaw)) {
|
|
62
|
+
throw err('E_VALIDATION', `dedupe 非法: ${String(dedupeRaw)}(只允许 ${DEDUPE_INTENTS.join(' / ')})`);
|
|
63
|
+
}
|
|
64
|
+
dedupe = dedupeRaw;
|
|
65
|
+
}
|
|
66
|
+
if (dedupe === 'keep_both' && verdict === 'merge_into') {
|
|
67
|
+
throw err('E_VALIDATION', 'keep_both 与 merge_into 互斥:一个要求并存,一个要求并入指定记忆');
|
|
68
|
+
}
|
|
69
|
+
return { verdict, mergeIntoId, confidence, rationale, dedupe };
|
|
70
|
+
}
|
|
71
|
+
/** CLI 用扁平参数拼装,复杂到需要对象时由调用方直接传 JSON。 */
|
|
72
|
+
export function judgementFromFlags(flags) {
|
|
73
|
+
const verdict = flags['judgement'];
|
|
74
|
+
if (verdict == null || typeof verdict !== 'string')
|
|
75
|
+
return null;
|
|
76
|
+
const merged = { verdict };
|
|
77
|
+
for (const key of ['confidence', 'rationale', 'dedupe']) {
|
|
78
|
+
const v = flags[key];
|
|
79
|
+
if (typeof v === 'string')
|
|
80
|
+
merged[key] = v;
|
|
81
|
+
}
|
|
82
|
+
return parseJudgement(merged);
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* 判断 + 查重 → 落库动作。纯函数,不读库不写库。
|
|
86
|
+
*
|
|
87
|
+
* 关键取舍:**没有判断时也要查重**。写入路径的重复不是判断出来的,是比对出来的;
|
|
88
|
+
* 先把这件事做掉,才谈得上"只有一条"。
|
|
89
|
+
*/
|
|
90
|
+
export function decideWrite(input) {
|
|
91
|
+
const { judgement, duplicate } = input;
|
|
92
|
+
if (judgement?.verdict === 'skip') {
|
|
93
|
+
if (judgement.confidence === 'high') {
|
|
94
|
+
return { action: 'skip', targetMemoryId: null, basis: 'judgement_skip_high' };
|
|
95
|
+
}
|
|
96
|
+
// 低置信的"不值得记"不足以丢弃,也不足以新建:既有 active 就并进去,没有就降为候选。
|
|
97
|
+
if (duplicate?.status === 'active') {
|
|
98
|
+
return { action: 'merge', targetMemoryId: duplicate.memoryId, basis: `judgement_skip_${judgement.confidence}_existing_active` };
|
|
99
|
+
}
|
|
100
|
+
return { action: 'candidate', targetMemoryId: null, basis: `judgement_skip_${judgement.confidence}` };
|
|
101
|
+
}
|
|
102
|
+
if (judgement?.verdict === 'merge_into') {
|
|
103
|
+
return { action: 'merge', targetMemoryId: judgement.mergeIntoId, basis: 'judgement_merge_into' };
|
|
104
|
+
}
|
|
105
|
+
// verdict = keep,或没有判断:都走同一条查重路径。
|
|
106
|
+
if (judgement?.dedupe === 'keep_both') {
|
|
107
|
+
return { action: 'insert', targetMemoryId: null, basis: 'judgement_keep_both' };
|
|
108
|
+
}
|
|
109
|
+
if (duplicate) {
|
|
110
|
+
return duplicate.status === 'active'
|
|
111
|
+
? { action: 'merge', targetMemoryId: duplicate.memoryId, basis: 'duplicate_active' }
|
|
112
|
+
: { action: 'promote_candidate', targetMemoryId: duplicate.memoryId, basis: 'duplicate_candidate' };
|
|
113
|
+
}
|
|
114
|
+
return { action: 'insert', targetMemoryId: null, basis: judgement ? 'judgement_keep' : 'no_duplicate' };
|
|
115
|
+
}
|
|
116
|
+
/** 审计用的紧凑描述:不落原文,只落结论与理由。 */
|
|
117
|
+
export function describeJudgement(j) {
|
|
118
|
+
const target = j.mergeIntoId ? `→${j.mergeIntoId}` : '';
|
|
119
|
+
return `${j.verdict}${target}/${j.confidence}/${j.dedupe}`;
|
|
120
|
+
}
|
|
121
|
+
//# sourceMappingURL=judgement.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"judgement.js","sourceRoot":"","sources":["../../../src/onboarding/judgement.ts"],"names":[],"mappings":"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"}
|