@carloswon/cairn-memory 0.0.0-stage → 0.3.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 +81 -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 +139 -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/archive.d.ts +29 -0
- package/dist/src/governance/archive.js +52 -0
- package/dist/src/governance/archive.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 +292 -0
- package/dist/src/interfaces/app-service.js +743 -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 +854 -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 +480 -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 +112 -0
- package/dist/src/projection/brief.js +200 -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 +57 -0
- package/dist/src/store/audit.js +131 -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 +133 -0
- package/dist/src/store/memories.js +442 -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 +87 -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 +203 -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 +46 -0
- package/dist/src/store/schema.js +544 -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 +267 -0
- package/docs/cairn-usage.md +919 -0
- package/package.json +71 -4
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import type { Sensitivity } from '../core/types.js';
|
|
2
|
+
/**
|
|
3
|
+
* 自动整理策略(design D1 / D2)。
|
|
4
|
+
*
|
|
5
|
+
* 策略是"人一次性签发、确定性代码按条件代签审批"的凭据。因此这里的原则是:
|
|
6
|
+
* **宁可拒绝,不做宽松默认**。缺字段、多字段、类型不对、值越界,一律终止并说清是哪一项,
|
|
7
|
+
* 不替调用方补一个"看起来合理"的值——补出来的策略在审计里与真实意图无法区分。
|
|
8
|
+
*/
|
|
9
|
+
export declare const POLICY_DIR = "policy";
|
|
10
|
+
/** 签发通道只有两条:终端 CLI 与本机回环控制台。MCP 不在其中。 */
|
|
11
|
+
export declare const POLICY_CHANNELS: readonly ["cli", "console"];
|
|
12
|
+
export type PolicyChannel = (typeof POLICY_CHANNELS)[number];
|
|
13
|
+
export declare const POLICY_CONDITIONS: readonly ["scan_state", "scope", "sensitivity", "conflict", "ai_agreement", "confidence", "duplicate", "create"];
|
|
14
|
+
export type PolicyCondition = (typeof POLICY_CONDITIONS)[number];
|
|
15
|
+
export interface PolicySpec {
|
|
16
|
+
id: string;
|
|
17
|
+
/** 允许自动写入的作用域(preset 名或 scope id)。空集合等于策略无效,直接拒绝签发。 */
|
|
18
|
+
allowedScopes: string[];
|
|
19
|
+
/** 允许的最高敏感度:normal 表示只放普通内容,sensitive 表示也放敏感内容。 */
|
|
20
|
+
maxSensitivity: Sensitivity;
|
|
21
|
+
/** 是否要求规则层与 AI 层的动作完全一致才放行。 */
|
|
22
|
+
requireAiAgreement: boolean;
|
|
23
|
+
/** 是否允许自动创建新记忆(false 时只允许并入既有记忆)。 */
|
|
24
|
+
allowCreate: boolean;
|
|
25
|
+
/** AI 判断的最低置信度(0..1);低于此值转人工。 */
|
|
26
|
+
minConfidence: number;
|
|
27
|
+
/** 人写的备注,说明这份策略打算用来做什么。 */
|
|
28
|
+
note: string;
|
|
29
|
+
}
|
|
30
|
+
export interface SignedPolicy {
|
|
31
|
+
spec: PolicySpec;
|
|
32
|
+
policyHash: string;
|
|
33
|
+
signedAt: string;
|
|
34
|
+
signedVia: PolicyChannel;
|
|
35
|
+
/** 显式撤销时间;非 null 时该策略不可再用于自动整理。 */
|
|
36
|
+
revokedAt: string | null;
|
|
37
|
+
}
|
|
38
|
+
export declare function validatePolicySpec(raw: unknown): PolicySpec;
|
|
39
|
+
/** 规范化序列化后取 sha256:字段顺序与空白不影响结果,改动任一字段必然改变哈希。 */
|
|
40
|
+
export declare function policyHashOf(spec: PolicySpec): string;
|
|
41
|
+
export declare function policyDir(home: string): string;
|
|
42
|
+
export declare function policyPath(home: string, id: string): string;
|
|
43
|
+
export declare function signPolicy(home: string, raw: unknown, opts?: {
|
|
44
|
+
via: PolicyChannel;
|
|
45
|
+
force?: boolean;
|
|
46
|
+
}): SignedPolicy;
|
|
47
|
+
/**
|
|
48
|
+
* 读取并重算哈希。不一致即拒绝使用,不降级——
|
|
49
|
+
* 策略文件被人改过而系统照用,等于这条授权路径没有边界。
|
|
50
|
+
*/
|
|
51
|
+
export declare function loadPolicy(home: string, id: string): SignedPolicy;
|
|
52
|
+
/** 可运行时使用的策略:存在、哈希一致、未被撤销。 */
|
|
53
|
+
export declare function requireUsablePolicy(home: string, id: string): SignedPolicy;
|
|
54
|
+
export declare function listPolicies(home: string): SignedPolicy[];
|
|
55
|
+
export declare function revokePolicy(home: string, id: string): SignedPolicy;
|
|
56
|
+
/** 供策略用的置信度换算;与 judgement 的 high/medium/low 一一对应。 */
|
|
57
|
+
export declare const CONFIDENCE_SCORE: {
|
|
58
|
+
readonly high: 0.9;
|
|
59
|
+
readonly medium: 0.6;
|
|
60
|
+
readonly low: 0.3;
|
|
61
|
+
};
|
|
62
|
+
export interface PolicyCandidate {
|
|
63
|
+
itemId: string;
|
|
64
|
+
scanState: 'clean' | 'blocked';
|
|
65
|
+
/** 将被写入的作用域(preset 名或 scope id)。 */
|
|
66
|
+
scope: string;
|
|
67
|
+
sensitivity: Sensitivity;
|
|
68
|
+
/** 它将并入的目标记忆是否处于未解决冲突。 */
|
|
69
|
+
hasConflict: boolean;
|
|
70
|
+
/** 规则层动作。 */
|
|
71
|
+
ruleAction: string;
|
|
72
|
+
/** AI 层动作;未产出判断时为 null。 */
|
|
73
|
+
aiAction: string | null;
|
|
74
|
+
/** AI 置信度 0..1;未产出判断时为 null。 */
|
|
75
|
+
aiConfidence: number | null;
|
|
76
|
+
/** 正文是否为重复(已存在同作用域同内容)。 */
|
|
77
|
+
isDuplicate: boolean;
|
|
78
|
+
/** 该操作是否会新建记忆(false 表示并入既有)。 */
|
|
79
|
+
wouldCreate: boolean;
|
|
80
|
+
}
|
|
81
|
+
export interface PolicyVerdict {
|
|
82
|
+
ok: boolean;
|
|
83
|
+
failedCondition: PolicyCondition | null;
|
|
84
|
+
detail: string;
|
|
85
|
+
}
|
|
86
|
+
export declare function evaluatePolicy(candidate: PolicyCandidate, policy: SignedPolicy): PolicyVerdict;
|
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { err } from '../core/errors.js';
|
|
4
|
+
import { canonicalJson, sha256Hex } from '../core/hash.js';
|
|
5
|
+
import { nowIso } from '../core/time.js';
|
|
6
|
+
/**
|
|
7
|
+
* 自动整理策略(design D1 / D2)。
|
|
8
|
+
*
|
|
9
|
+
* 策略是"人一次性签发、确定性代码按条件代签审批"的凭据。因此这里的原则是:
|
|
10
|
+
* **宁可拒绝,不做宽松默认**。缺字段、多字段、类型不对、值越界,一律终止并说清是哪一项,
|
|
11
|
+
* 不替调用方补一个"看起来合理"的值——补出来的策略在审计里与真实意图无法区分。
|
|
12
|
+
*/
|
|
13
|
+
export const POLICY_DIR = 'policy';
|
|
14
|
+
/** 签发通道只有两条:终端 CLI 与本机回环控制台。MCP 不在其中。 */
|
|
15
|
+
export const POLICY_CHANNELS = ['cli', 'console'];
|
|
16
|
+
export const POLICY_CONDITIONS = [
|
|
17
|
+
'scan_state',
|
|
18
|
+
'scope',
|
|
19
|
+
'sensitivity',
|
|
20
|
+
'conflict',
|
|
21
|
+
'ai_agreement',
|
|
22
|
+
'confidence',
|
|
23
|
+
'duplicate',
|
|
24
|
+
'create',
|
|
25
|
+
];
|
|
26
|
+
const SPEC_KEYS = new Set([
|
|
27
|
+
'id',
|
|
28
|
+
'allowedScopes',
|
|
29
|
+
'maxSensitivity',
|
|
30
|
+
'requireAiAgreement',
|
|
31
|
+
'allowCreate',
|
|
32
|
+
'minConfidence',
|
|
33
|
+
'note',
|
|
34
|
+
]);
|
|
35
|
+
const ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,63}$/;
|
|
36
|
+
// ------------------------------------------------------------------ 校验与哈希
|
|
37
|
+
export function validatePolicySpec(raw) {
|
|
38
|
+
if (raw == null || typeof raw !== 'object' || Array.isArray(raw)) {
|
|
39
|
+
throw err('E_VALIDATION', '策略必须是对象');
|
|
40
|
+
}
|
|
41
|
+
const obj = raw;
|
|
42
|
+
const unknown = Object.keys(obj).filter((k) => !SPEC_KEYS.has(k));
|
|
43
|
+
if (unknown.length > 0) {
|
|
44
|
+
// 静默忽略拼错的字段,等于让"我写了 allowedScope"看起来生效了实际没有。
|
|
45
|
+
throw err('E_VALIDATION', `策略含未知字段: ${unknown.join(', ')}`, { unknown });
|
|
46
|
+
}
|
|
47
|
+
const id = obj['id'];
|
|
48
|
+
if (typeof id !== 'string' || !ID_PATTERN.test(id)) {
|
|
49
|
+
throw err('E_VALIDATION', '策略 id 非法:只允许小写字母数字与 ._-,长度 1-64,且以字母数字开头');
|
|
50
|
+
}
|
|
51
|
+
const scopesRaw = obj['allowedScopes'];
|
|
52
|
+
if (!Array.isArray(scopesRaw) || scopesRaw.length === 0) {
|
|
53
|
+
throw err('E_VALIDATION', '策略必须声明非空的 allowedScopes:空的允许集合没有任何语义');
|
|
54
|
+
}
|
|
55
|
+
const allowedScopes = scopesRaw.map((s) => {
|
|
56
|
+
if (typeof s !== 'string' || s.trim().length === 0) {
|
|
57
|
+
throw err('E_VALIDATION', 'allowedScopes 只能包含非空字符串');
|
|
58
|
+
}
|
|
59
|
+
return s.trim();
|
|
60
|
+
});
|
|
61
|
+
const maxSensitivity = obj['maxSensitivity'];
|
|
62
|
+
if (maxSensitivity !== 'normal' && maxSensitivity !== 'sensitive') {
|
|
63
|
+
throw err('E_VALIDATION', "maxSensitivity 必须是 'normal' 或 'sensitive'");
|
|
64
|
+
}
|
|
65
|
+
const requireAiAgreement = obj['requireAiAgreement'];
|
|
66
|
+
if (typeof requireAiAgreement !== 'boolean') {
|
|
67
|
+
throw err('E_VALIDATION', 'requireAiAgreement 必须是布尔值(不接受 "true" 这类字符串)');
|
|
68
|
+
}
|
|
69
|
+
const allowCreate = obj['allowCreate'];
|
|
70
|
+
if (typeof allowCreate !== 'boolean') {
|
|
71
|
+
throw err('E_VALIDATION', 'allowCreate 必须是布尔值');
|
|
72
|
+
}
|
|
73
|
+
const minConfidence = obj['minConfidence'];
|
|
74
|
+
if (typeof minConfidence !== 'number' || !Number.isFinite(minConfidence) || minConfidence < 0 || minConfidence > 1) {
|
|
75
|
+
throw err('E_VALIDATION', 'minConfidence 必须是 [0,1] 内的数字');
|
|
76
|
+
}
|
|
77
|
+
const note = obj['note'];
|
|
78
|
+
if (typeof note !== 'string') {
|
|
79
|
+
throw err('E_VALIDATION', 'note 必须是字符串(可为空,但不能缺)');
|
|
80
|
+
}
|
|
81
|
+
return { id, allowedScopes, maxSensitivity, requireAiAgreement, allowCreate, minConfidence, note };
|
|
82
|
+
}
|
|
83
|
+
/** 规范化序列化后取 sha256:字段顺序与空白不影响结果,改动任一字段必然改变哈希。 */
|
|
84
|
+
export function policyHashOf(spec) {
|
|
85
|
+
const ordered = {
|
|
86
|
+
id: spec.id,
|
|
87
|
+
allowedScopes: [...spec.allowedScopes],
|
|
88
|
+
maxSensitivity: spec.maxSensitivity,
|
|
89
|
+
requireAiAgreement: spec.requireAiAgreement,
|
|
90
|
+
allowCreate: spec.allowCreate,
|
|
91
|
+
minConfidence: spec.minConfidence,
|
|
92
|
+
note: spec.note,
|
|
93
|
+
};
|
|
94
|
+
return sha256Hex(canonicalJson(ordered));
|
|
95
|
+
}
|
|
96
|
+
// ------------------------------------------------------------------ 落盘
|
|
97
|
+
export function policyDir(home) {
|
|
98
|
+
return join(home, POLICY_DIR);
|
|
99
|
+
}
|
|
100
|
+
export function policyPath(home, id) {
|
|
101
|
+
return join(policyDir(home), `${id}.json`);
|
|
102
|
+
}
|
|
103
|
+
export function signPolicy(home, raw, opts = { via: 'cli' }) {
|
|
104
|
+
const spec = validatePolicySpec(raw);
|
|
105
|
+
const file = policyPath(home, spec.id);
|
|
106
|
+
if (existsSync(file) && opts.force !== true) {
|
|
107
|
+
throw err('E_VALIDATION', `策略 ${spec.id} 已存在;改签需显式 --force(会替换既有签发,旧哈希随之失效)`);
|
|
108
|
+
}
|
|
109
|
+
const signed = {
|
|
110
|
+
spec,
|
|
111
|
+
policyHash: policyHashOf(spec),
|
|
112
|
+
signedAt: nowIso(),
|
|
113
|
+
signedVia: opts.via,
|
|
114
|
+
revokedAt: null,
|
|
115
|
+
};
|
|
116
|
+
mkdirSync(policyDir(home), { recursive: true });
|
|
117
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
118
|
+
writeFileSync(tmp, `${JSON.stringify(signed, null, 2)}\n`, 'utf8');
|
|
119
|
+
renameSync(tmp, file);
|
|
120
|
+
return signed;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* 读取并重算哈希。不一致即拒绝使用,不降级——
|
|
124
|
+
* 策略文件被人改过而系统照用,等于这条授权路径没有边界。
|
|
125
|
+
*/
|
|
126
|
+
export function loadPolicy(home, id) {
|
|
127
|
+
const file = policyPath(home, id);
|
|
128
|
+
if (!existsSync(file)) {
|
|
129
|
+
throw err('E_NOT_FOUND', `策略不存在: ${id}(先执行 cairn policy sign)`);
|
|
130
|
+
}
|
|
131
|
+
let parsed;
|
|
132
|
+
try {
|
|
133
|
+
parsed = JSON.parse(readFileSync(file, 'utf8'));
|
|
134
|
+
}
|
|
135
|
+
catch (e) {
|
|
136
|
+
throw err('E_VALIDATION', `策略文件无法解析: ${id}`, { cause: String(e) });
|
|
137
|
+
}
|
|
138
|
+
if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
139
|
+
throw err('E_VALIDATION', `策略文件结构非法: ${id}`);
|
|
140
|
+
}
|
|
141
|
+
const obj = parsed;
|
|
142
|
+
const spec = validatePolicySpec(obj['spec']);
|
|
143
|
+
const recorded = obj['policyHash'];
|
|
144
|
+
const actual = policyHashOf(spec);
|
|
145
|
+
if (typeof recorded !== 'string' || recorded !== actual) {
|
|
146
|
+
throw err('E_FORBIDDEN', `策略 ${id} 的内容与签发哈希不一致,已拒绝使用(改动后必须重新签发)`, {
|
|
147
|
+
recorded,
|
|
148
|
+
actual,
|
|
149
|
+
});
|
|
150
|
+
}
|
|
151
|
+
return {
|
|
152
|
+
spec,
|
|
153
|
+
policyHash: actual,
|
|
154
|
+
signedAt: String(obj['signedAt'] ?? ''),
|
|
155
|
+
signedVia: (obj['signedVia'] === 'console' ? 'console' : 'cli'),
|
|
156
|
+
revokedAt: typeof obj['revokedAt'] === 'string' ? obj['revokedAt'] : null,
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
/** 可运行时使用的策略:存在、哈希一致、未被撤销。 */
|
|
160
|
+
export function requireUsablePolicy(home, id) {
|
|
161
|
+
const p = loadPolicy(home, id);
|
|
162
|
+
if (p.revokedAt != null) {
|
|
163
|
+
throw err('E_FORBIDDEN', `策略 ${id} 已于 ${p.revokedAt} 撤销,不能用于自动整理`);
|
|
164
|
+
}
|
|
165
|
+
return p;
|
|
166
|
+
}
|
|
167
|
+
export function listPolicies(home) {
|
|
168
|
+
const dir = policyDir(home);
|
|
169
|
+
if (!existsSync(dir))
|
|
170
|
+
return [];
|
|
171
|
+
const out = [];
|
|
172
|
+
for (const name of readdirSync(dir)) {
|
|
173
|
+
if (!name.endsWith('.json'))
|
|
174
|
+
continue;
|
|
175
|
+
const id = name.slice(0, -'.json'.length);
|
|
176
|
+
try {
|
|
177
|
+
out.push(loadPolicy(home, id));
|
|
178
|
+
}
|
|
179
|
+
catch {
|
|
180
|
+
// 坏文件不该让整个列表不可用;调用方要看细节时用 policy show。
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
return out.sort((a, b) => a.spec.id.localeCompare(b.spec.id));
|
|
184
|
+
}
|
|
185
|
+
export function revokePolicy(home, id) {
|
|
186
|
+
const p = loadPolicy(home, id);
|
|
187
|
+
if (p.revokedAt != null)
|
|
188
|
+
return p;
|
|
189
|
+
const next = { ...p, revokedAt: nowIso() };
|
|
190
|
+
const file = policyPath(home, id);
|
|
191
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
192
|
+
writeFileSync(tmp, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
|
|
193
|
+
renameSync(tmp, file);
|
|
194
|
+
return next;
|
|
195
|
+
}
|
|
196
|
+
// ------------------------------------------------------------------ 条件判定
|
|
197
|
+
const SENSITIVITY_RANK = { normal: 0, sensitive: 1 };
|
|
198
|
+
/** 供策略用的置信度换算;与 judgement 的 high/medium/low 一一对应。 */
|
|
199
|
+
export const CONFIDENCE_SCORE = { high: 0.9, medium: 0.6, low: 0.3 };
|
|
200
|
+
export function evaluatePolicy(candidate, policy) {
|
|
201
|
+
const spec = policy.spec;
|
|
202
|
+
const fail = (condition, detail) => ({
|
|
203
|
+
ok: false,
|
|
204
|
+
failedCondition: condition,
|
|
205
|
+
detail,
|
|
206
|
+
});
|
|
207
|
+
// 1. 扫描状态:最廉价,先挡掉注定不能进库的。
|
|
208
|
+
if (candidate.scanState !== 'clean') {
|
|
209
|
+
return fail('scan_state', `扫描状态为 ${candidate.scanState}`);
|
|
210
|
+
}
|
|
211
|
+
// 2. 作用域白名单。
|
|
212
|
+
if (!spec.allowedScopes.includes(candidate.scope)) {
|
|
213
|
+
return fail('scope', `作用域 ${candidate.scope} 不在允许集内(${spec.allowedScopes.join(', ')})`);
|
|
214
|
+
}
|
|
215
|
+
// 3. 敏感度:序数比较,超限即拒,不降级。
|
|
216
|
+
if (SENSITIVITY_RANK[candidate.sensitivity] > SENSITIVITY_RANK[spec.maxSensitivity]) {
|
|
217
|
+
return fail('sensitivity', `敏感度 ${candidate.sensitivity} 高于上限 ${spec.maxSensitivity}`);
|
|
218
|
+
}
|
|
219
|
+
// 4. 未解决冲突。
|
|
220
|
+
if (candidate.hasConflict) {
|
|
221
|
+
return fail('conflict', '目标记忆存在未解决冲突');
|
|
222
|
+
}
|
|
223
|
+
// 5. 两层一致:到这里才碰 AI 结果。前面三项本地可判,先失败先返回,
|
|
224
|
+
// 避免为注定被拒的条目白等一次模型判断。
|
|
225
|
+
if (spec.requireAiAgreement) {
|
|
226
|
+
if (candidate.aiAction == null) {
|
|
227
|
+
return fail('ai_agreement', '尚无 AI 判断,无法确认两层一致');
|
|
228
|
+
}
|
|
229
|
+
if (candidate.aiAction !== candidate.ruleAction) {
|
|
230
|
+
return fail('ai_agreement', `规则层 ${candidate.ruleAction} 与 AI 层 ${candidate.aiAction} 不一致`);
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
// 6. 置信度门槛:有判断才比较。没有判断时是否放行由上一项(requireAiAgreement)决定,
|
|
234
|
+
// 否则 requireAiAgreement=false 会被这一项抵消,等于开关不生效。
|
|
235
|
+
if (candidate.aiConfidence != null && candidate.aiConfidence < spec.minConfidence) {
|
|
236
|
+
return fail('confidence', `AI 置信度 ${candidate.aiConfidence} 低于门槛 ${spec.minConfidence}`);
|
|
237
|
+
}
|
|
238
|
+
// 7. 重复:内容已经在同一作用域里,唯一正确的动作是并入。
|
|
239
|
+
// 这里不是在问"要不要允许创建",而是在问"规则层给对了动作没有"。
|
|
240
|
+
if (candidate.isDuplicate && candidate.ruleAction !== 'merge') {
|
|
241
|
+
return fail('duplicate', '内容已存在于该作用域,但规则层未给出合并动作');
|
|
242
|
+
}
|
|
243
|
+
// 8. 新建许可:只有真的要新建一条时才检查。
|
|
244
|
+
if (candidate.wouldCreate && !spec.allowCreate) {
|
|
245
|
+
return fail('create', '策略未授权自动创建新记忆');
|
|
246
|
+
}
|
|
247
|
+
return { ok: true, failedCondition: null, detail: '全部条件满足' };
|
|
248
|
+
}
|
|
249
|
+
//# sourceMappingURL=policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/onboarding/policy.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
import type { CairnStore } from '../store/open.js';
|
|
2
|
+
/**
|
|
3
|
+
* 投影简报渲染(变更 add-memory-projection-brief)。
|
|
4
|
+
*
|
|
5
|
+
* 两个不变量,改实现前先读:
|
|
6
|
+
*
|
|
7
|
+
* 1. **敏感排除放在取数阶段**,不放在渲染阶段。先渲染再过滤,一旦某处漏过滤
|
|
8
|
+
* 就会把 local_only / sensitive / blocked 的内容写进宿主文件——泄露面不可控。
|
|
9
|
+
* 2. **同输入必然同字节**。排序键全序且不含"当前时间":用 confidence、updated_at、
|
|
10
|
+
* id 三个稳定字段。任何把 now() 写进输出都会让每次渲染不同,破坏缓存、也让
|
|
11
|
+
* "内容未变化 → 不重写文件"的幂等判断失效。
|
|
12
|
+
*
|
|
13
|
+
* 摘要用确定性渲染而不是 LLM:引入模型会让上述第 2 条不成立,且多一层依赖与成本。
|
|
14
|
+
*/
|
|
15
|
+
/** 投影候选:已完成敏感排除的记忆。 */
|
|
16
|
+
export interface ProjectionCandidate {
|
|
17
|
+
id: string;
|
|
18
|
+
kind: string;
|
|
19
|
+
content: string;
|
|
20
|
+
confidence: number;
|
|
21
|
+
updatedAt: string;
|
|
22
|
+
}
|
|
23
|
+
export interface ProjectionSelection {
|
|
24
|
+
/** 入选记忆(已按预算排序)。 */
|
|
25
|
+
selected: ProjectionCandidate[];
|
|
26
|
+
/** 因敏感/状态被排除的条数(只计数,不暴露内容)。 */
|
|
27
|
+
excludedCount: number;
|
|
28
|
+
/** 因预算被裁掉的条数。 */
|
|
29
|
+
truncatedCount: number;
|
|
30
|
+
/** 渲染结果字节数。 */
|
|
31
|
+
bytes: number;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* 取数 + 敏感排除(第 1 条不变量)。
|
|
35
|
+
*
|
|
36
|
+
* 排除条件(任一命中即排除,且**先于**任何排序与预算判断):
|
|
37
|
+
* - scope.sync_policy = 'local_only'(设备限定内容不得离开本机语境)
|
|
38
|
+
* - memory.sensitivity = 'sensitive'
|
|
39
|
+
* - memory.status = 'blocked'
|
|
40
|
+
*/
|
|
41
|
+
/** 艾宾浩斯分桶(天数 → 权重)。照抄 dsh-meow-memory 的实测分桶,不自创。 */
|
|
42
|
+
export declare function recencyWeight(days: number): number;
|
|
43
|
+
/** 绝对地板:最差情况也保留一半基线分(prime-memory 的 max(0.5, ...))。 */
|
|
44
|
+
export declare const DECAY_FLOOR = 0.5;
|
|
45
|
+
/** 高重要度豁免衰减的阈值。 */
|
|
46
|
+
export declare const NO_DECAY_IMPORTANCE = 4;
|
|
47
|
+
/** 「本轮高度相关」豁免衰减的比例(相对本轮最高分)。 */
|
|
48
|
+
export declare const SUPER_MATCH_RATIO = 0.85;
|
|
49
|
+
/**
|
|
50
|
+
* 投影排序分值(add-memory-importance-and-usage-signal D8)。
|
|
51
|
+
*
|
|
52
|
+
* `score = 基线分 × 衰减系数`,衰减系数带三重地板:
|
|
53
|
+
* ① importance >= 4 → 不衰减;
|
|
54
|
+
* ② 本轮相关度 >= 0.85 × 最高分 → 不衰减;
|
|
55
|
+
* ③ 绝对地板 0.5 → 任何记忆至少保留一半基线分。
|
|
56
|
+
*
|
|
57
|
+
* **地板不是可选装饰**:纯衰减会让「被注入过的更容易被注入」,一年后只剩几条
|
|
58
|
+
* 明星记忆被反复注入,其余成为存在于库中但不可见的僵尸——那反而加剧库膨胀。
|
|
59
|
+
*
|
|
60
|
+
* @param nowMs 当前时间(ms)。传入以保持纯函数可测。
|
|
61
|
+
*/
|
|
62
|
+
export declare function scoreCandidate(input: {
|
|
63
|
+
importance: number | null;
|
|
64
|
+
lastUsedAt: string | null;
|
|
65
|
+
createdAt: string;
|
|
66
|
+
nowMs: number;
|
|
67
|
+
/** 本轮相关度(0-1)。拿不到时传 undefined,跳过地板②。 */
|
|
68
|
+
relevance?: number;
|
|
69
|
+
maxRelevance?: number;
|
|
70
|
+
}): {
|
|
71
|
+
score: number;
|
|
72
|
+
decay: number;
|
|
73
|
+
flooredBy: 'importance' | 'relevance' | 'floor' | null;
|
|
74
|
+
};
|
|
75
|
+
export declare function selectProjectionCandidates(store: CairnStore, opts?: {
|
|
76
|
+
scopeIds: string[];
|
|
77
|
+
limit?: number;
|
|
78
|
+
nowMs?: number;
|
|
79
|
+
}): {
|
|
80
|
+
candidates: ProjectionCandidate[];
|
|
81
|
+
excludedCount: number;
|
|
82
|
+
};
|
|
83
|
+
/** brief 模式单行渲染:`- [kind] 摘要 (id:xxxxxxxx)` */
|
|
84
|
+
export declare function renderBriefLine(m: ProjectionCandidate): string;
|
|
85
|
+
/** index 模式单行渲染(ZCode 约定):`- [标题](id:xxxxxxxx) — 一句话` */
|
|
86
|
+
export declare function renderIndexLine(m: ProjectionCandidate): string;
|
|
87
|
+
export interface RenderOptions {
|
|
88
|
+
mode: 'brief' | 'index';
|
|
89
|
+
budgetBytes: number;
|
|
90
|
+
/** 单行字符上限(index 模式为 200)。 */
|
|
91
|
+
maxLineChars?: number;
|
|
92
|
+
}
|
|
93
|
+
export interface RenderResult {
|
|
94
|
+
text: string;
|
|
95
|
+
selected: number;
|
|
96
|
+
truncated: number;
|
|
97
|
+
bytes: number;
|
|
98
|
+
excludedCount: number;
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* 渲染简报:按预算裁剪,超出时写明省略条数(第 2 条不变量:确定性)。
|
|
102
|
+
*
|
|
103
|
+
* 裁剪顺序即入参顺序(调用方已按 confidence/updated_at/id 排好),
|
|
104
|
+
* 不做二次排序——否则"哪几条被裁掉"会随实现变化而漂移。
|
|
105
|
+
*/
|
|
106
|
+
export declare function renderProjection(candidates: ProjectionCandidate[], opts: RenderOptions): RenderResult;
|
|
107
|
+
/** 便捷入口:取数 + 渲染一步到位(仍保证排除先于渲染)。 */
|
|
108
|
+
export declare function buildProjection(store: CairnStore, opts: {
|
|
109
|
+
scopeIds: string[];
|
|
110
|
+
mode: 'brief' | 'index';
|
|
111
|
+
budgetBytes: number;
|
|
112
|
+
}): RenderResult;
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
/** 单条摘要的首行截断长度(含省略号)。 */
|
|
3
|
+
const SUMMARY_MAX = 120;
|
|
4
|
+
function firstLine(content) {
|
|
5
|
+
const line = content.split(/\r?\n/).find((l) => l.trim().length > 0) ?? '';
|
|
6
|
+
return line.trim();
|
|
7
|
+
}
|
|
8
|
+
function truncate(s, max) {
|
|
9
|
+
if (s.length <= max)
|
|
10
|
+
return s;
|
|
11
|
+
return s.slice(0, Math.max(0, max - 1)).trimEnd() + '…';
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* 取数 + 敏感排除(第 1 条不变量)。
|
|
15
|
+
*
|
|
16
|
+
* 排除条件(任一命中即排除,且**先于**任何排序与预算判断):
|
|
17
|
+
* - scope.sync_policy = 'local_only'(设备限定内容不得离开本机语境)
|
|
18
|
+
* - memory.sensitivity = 'sensitive'
|
|
19
|
+
* - memory.status = 'blocked'
|
|
20
|
+
*/
|
|
21
|
+
/** 艾宾浩斯分桶(天数 → 权重)。照抄 dsh-meow-memory 的实测分桶,不自创。 */
|
|
22
|
+
export function recencyWeight(days) {
|
|
23
|
+
if (days < 1)
|
|
24
|
+
return 1.0;
|
|
25
|
+
if (days < 2)
|
|
26
|
+
return 0.9;
|
|
27
|
+
if (days < 4)
|
|
28
|
+
return 0.8;
|
|
29
|
+
if (days < 7)
|
|
30
|
+
return 0.65;
|
|
31
|
+
if (days < 15)
|
|
32
|
+
return 0.5;
|
|
33
|
+
if (days < 30)
|
|
34
|
+
return 0.35;
|
|
35
|
+
if (days < 60)
|
|
36
|
+
return 0.25;
|
|
37
|
+
if (days < 180)
|
|
38
|
+
return 0.15;
|
|
39
|
+
return 0.08;
|
|
40
|
+
}
|
|
41
|
+
/** 绝对地板:最差情况也保留一半基线分(prime-memory 的 max(0.5, ...))。 */
|
|
42
|
+
export const DECAY_FLOOR = 0.5;
|
|
43
|
+
/** 高重要度豁免衰减的阈值。 */
|
|
44
|
+
export const NO_DECAY_IMPORTANCE = 4;
|
|
45
|
+
/** 「本轮高度相关」豁免衰减的比例(相对本轮最高分)。 */
|
|
46
|
+
export const SUPER_MATCH_RATIO = 0.85;
|
|
47
|
+
/**
|
|
48
|
+
* 投影排序分值(add-memory-importance-and-usage-signal D8)。
|
|
49
|
+
*
|
|
50
|
+
* `score = 基线分 × 衰减系数`,衰减系数带三重地板:
|
|
51
|
+
* ① importance >= 4 → 不衰减;
|
|
52
|
+
* ② 本轮相关度 >= 0.85 × 最高分 → 不衰减;
|
|
53
|
+
* ③ 绝对地板 0.5 → 任何记忆至少保留一半基线分。
|
|
54
|
+
*
|
|
55
|
+
* **地板不是可选装饰**:纯衰减会让「被注入过的更容易被注入」,一年后只剩几条
|
|
56
|
+
* 明星记忆被反复注入,其余成为存在于库中但不可见的僵尸——那反而加剧库膨胀。
|
|
57
|
+
*
|
|
58
|
+
* @param nowMs 当前时间(ms)。传入以保持纯函数可测。
|
|
59
|
+
*/
|
|
60
|
+
export function scoreCandidate(input) {
|
|
61
|
+
const base = input.importance ?? 3;
|
|
62
|
+
const refIso = input.lastUsedAt ?? input.createdAt;
|
|
63
|
+
const refMs = Date.parse(refIso);
|
|
64
|
+
const days = Number.isFinite(refMs) ? Math.max(0, (input.nowMs - refMs) / 86_400_000) : 0;
|
|
65
|
+
let decay = recencyWeight(days);
|
|
66
|
+
let flooredBy = null;
|
|
67
|
+
if (base >= NO_DECAY_IMPORTANCE) {
|
|
68
|
+
decay = 1;
|
|
69
|
+
flooredBy = 'importance';
|
|
70
|
+
}
|
|
71
|
+
else if (input.relevance !== undefined &&
|
|
72
|
+
input.maxRelevance !== undefined &&
|
|
73
|
+
input.maxRelevance > 0 &&
|
|
74
|
+
input.relevance >= SUPER_MATCH_RATIO * input.maxRelevance) {
|
|
75
|
+
decay = 1;
|
|
76
|
+
flooredBy = 'relevance';
|
|
77
|
+
}
|
|
78
|
+
else if (decay < DECAY_FLOOR) {
|
|
79
|
+
decay = DECAY_FLOOR;
|
|
80
|
+
flooredBy = 'floor';
|
|
81
|
+
}
|
|
82
|
+
return { score: base * decay, decay, flooredBy };
|
|
83
|
+
}
|
|
84
|
+
export function selectProjectionCandidates(store, opts = { scopeIds: [] }) {
|
|
85
|
+
const where = ["m.status = 'active'"];
|
|
86
|
+
const params = [];
|
|
87
|
+
if (opts.scopeIds.length > 0) {
|
|
88
|
+
where.push(`m.scope_id IN (${opts.scopeIds.map(() => '?').join(',')})`);
|
|
89
|
+
params.push(...opts.scopeIds);
|
|
90
|
+
}
|
|
91
|
+
// 取回后在 JS 里算分并排序(add-memory-importance-and-usage-signal D8):
|
|
92
|
+
// 衰减需要「当前时间」与可选的相关度,放进 SQL 会既难读又难调;投影每会话一次,
|
|
93
|
+
// 而 FETCH_CAP 已有上限,数据量小,性能不敏感。
|
|
94
|
+
const rows = store.db.all(`SELECT m.id, m.kind, m.content, m.confidence, m.updated_at, m.created_at,
|
|
95
|
+
m.importance, m.last_used_at, m.sensitivity, s.sync_policy
|
|
96
|
+
FROM memory m
|
|
97
|
+
JOIN scope s ON s.id = m.scope_id
|
|
98
|
+
WHERE ${where.join(' AND ')}`, ...params);
|
|
99
|
+
const nowMs = opts.nowMs ?? Date.now();
|
|
100
|
+
const scored = rows.map((r) => ({
|
|
101
|
+
row: r,
|
|
102
|
+
...scoreCandidate({
|
|
103
|
+
importance: r['importance'] == null ? null : Number(r['importance']),
|
|
104
|
+
lastUsedAt: r['last_used_at'] ?? null,
|
|
105
|
+
createdAt: String(r['created_at'] ?? r['updated_at'] ?? ''),
|
|
106
|
+
nowMs,
|
|
107
|
+
}),
|
|
108
|
+
}));
|
|
109
|
+
scored.sort((a, b) => {
|
|
110
|
+
// lesson 优先(既有语义:承担「曾经错了,别再犯」,会话开场最该看到)
|
|
111
|
+
const la = a.row['kind'] === 'lesson' ? 0 : 1;
|
|
112
|
+
const lb = b.row['kind'] === 'lesson' ? 0 : 1;
|
|
113
|
+
if (la !== lb)
|
|
114
|
+
return la - lb;
|
|
115
|
+
if (b.score !== a.score)
|
|
116
|
+
return b.score - a.score;
|
|
117
|
+
const ua = String(a.row['updated_at'] ?? '');
|
|
118
|
+
const ub = String(b.row['updated_at'] ?? '');
|
|
119
|
+
if (ua !== ub)
|
|
120
|
+
return ua < ub ? 1 : -1;
|
|
121
|
+
return String(a.row['id']) < String(b.row['id']) ? -1 : 1;
|
|
122
|
+
});
|
|
123
|
+
const candidates = [];
|
|
124
|
+
let excludedCount = 0;
|
|
125
|
+
for (const { row: r } of scored) {
|
|
126
|
+
const localOnly = String(r['sync_policy']) === 'local_only';
|
|
127
|
+
const sensitive = String(r['sensitivity']) !== 'normal';
|
|
128
|
+
const blocked = String(r['sensitivity']) === 'blocked';
|
|
129
|
+
if (localOnly || sensitive || blocked) {
|
|
130
|
+
excludedCount += 1;
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
candidates.push({
|
|
134
|
+
id: String(r['id']),
|
|
135
|
+
kind: String(r['kind']),
|
|
136
|
+
content: String(r['content']),
|
|
137
|
+
confidence: Number(r['confidence'] ?? 0),
|
|
138
|
+
updatedAt: String(r['updated_at']),
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
return { candidates, excludedCount };
|
|
142
|
+
}
|
|
143
|
+
/** brief 模式单行渲染:`- [kind] 摘要 (id:xxxxxxxx)` */
|
|
144
|
+
export function renderBriefLine(m) {
|
|
145
|
+
const id8 = m.id.replace(/-/g, '').slice(0, 8);
|
|
146
|
+
return `- [${m.kind}] ${truncate(firstLine(m.content), SUMMARY_MAX)} (id:${id8})`;
|
|
147
|
+
}
|
|
148
|
+
/** index 模式单行渲染(ZCode 约定):`- [标题](id:xxxxxxxx) — 一句话` */
|
|
149
|
+
export function renderIndexLine(m) {
|
|
150
|
+
const id8 = m.id.replace(/-/g, '').slice(0, 8);
|
|
151
|
+
const head = truncate(firstLine(m.content), 80);
|
|
152
|
+
return `- [${head}](id:${id8}) — ${m.kind}`;
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* 渲染简报:按预算裁剪,超出时写明省略条数(第 2 条不变量:确定性)。
|
|
156
|
+
*
|
|
157
|
+
* 裁剪顺序即入参顺序(调用方已按 confidence/updated_at/id 排好),
|
|
158
|
+
* 不做二次排序——否则"哪几条被裁掉"会随实现变化而漂移。
|
|
159
|
+
*/
|
|
160
|
+
export function renderProjection(candidates, opts) {
|
|
161
|
+
if (!Number.isInteger(opts.budgetBytes) || opts.budgetBytes < 0) {
|
|
162
|
+
throw err('E_VALIDATION', 'budgetBytes 必须是非负整数');
|
|
163
|
+
}
|
|
164
|
+
const render = opts.mode === 'brief' ? renderBriefLine : renderIndexLine;
|
|
165
|
+
const maxLine = opts.maxLineChars ?? (opts.mode === 'index' ? 200 : 0);
|
|
166
|
+
const lines = [];
|
|
167
|
+
let used = 0;
|
|
168
|
+
let truncated = 0;
|
|
169
|
+
for (let i = 0; i < candidates.length; i++) {
|
|
170
|
+
let line = render(candidates[i]);
|
|
171
|
+
if (maxLine > 0 && line.length > maxLine)
|
|
172
|
+
line = truncate(line, maxLine);
|
|
173
|
+
// 预留省略提示的字节(约占 40 字节,足够 "…(另 N 条未显示)")
|
|
174
|
+
const reserve = 48;
|
|
175
|
+
if (used + Buffer.byteLength(line, 'utf8') + reserve > opts.budgetBytes) {
|
|
176
|
+
truncated = candidates.length - i;
|
|
177
|
+
break;
|
|
178
|
+
}
|
|
179
|
+
lines.push(line);
|
|
180
|
+
used += Buffer.byteLength(line, 'utf8') + 1; // +1 = 换行
|
|
181
|
+
}
|
|
182
|
+
if (truncated > 0) {
|
|
183
|
+
lines.push(`…(另 ${truncated} 条未显示)`);
|
|
184
|
+
}
|
|
185
|
+
const text = lines.join('\n');
|
|
186
|
+
return {
|
|
187
|
+
text,
|
|
188
|
+
selected: lines.length - (truncated > 0 ? 1 : 0),
|
|
189
|
+
truncated,
|
|
190
|
+
bytes: Buffer.byteLength(text, 'utf8'),
|
|
191
|
+
excludedCount: 0,
|
|
192
|
+
};
|
|
193
|
+
}
|
|
194
|
+
/** 便捷入口:取数 + 渲染一步到位(仍保证排除先于渲染)。 */
|
|
195
|
+
export function buildProjection(store, opts) {
|
|
196
|
+
const { candidates, excludedCount } = selectProjectionCandidates(store, { scopeIds: opts.scopeIds });
|
|
197
|
+
const result = renderProjection(candidates, { mode: opts.mode, budgetBytes: opts.budgetBytes });
|
|
198
|
+
return { ...result, excludedCount };
|
|
199
|
+
}
|
|
200
|
+
//# sourceMappingURL=brief.js.map
|