@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,64 @@
|
|
|
1
|
+
import { EvidenceInput, SecretScanResult } from '../core/types.js';
|
|
2
|
+
import { CairnStore } from '../store/open.js';
|
|
3
|
+
/**
|
|
4
|
+
* 计划应用(apply,spec memory-governance「计划绑定真实审批」+「幂等应用与中断续跑」)。
|
|
5
|
+
*
|
|
6
|
+
* 前置(确定性校验,顺序有意为之):
|
|
7
|
+
* 1. plan.status === 'applied' → 返回 alreadyApplied 报告,不消耗审批;
|
|
8
|
+
* 2. expireStale() 过期清扫(只清扫 awaiting_approval/draft);
|
|
9
|
+
* 3. 篡改预检(只读):审批与计划绑定 + plan_hash 一致。放在状态检查之前,
|
|
10
|
+
* 因为批准后改哈希会触发 DB 触发器把计划置为 invalidated 并撤销审批——
|
|
11
|
+
* 若先查状态会以 E_APPROVAL_INVALID 掩盖真正的篡改;先比哈希让
|
|
12
|
+
* 「批准后计划被修改」以 E_PLAN_TAMPERED 暴露(spec memory-governance);
|
|
13
|
+
* 4. status 必须是 'approved'(否则 E_APPROVAL_INVALID,审批不被消耗);
|
|
14
|
+
* 5. consumeApproval:一次性凭证(重放 E_APPROVAL_REPLAY、过期
|
|
15
|
+
* E_APPROVAL_EXPIRED、撤销 E_APPROVAL_INVALID),失败不消耗 uses。
|
|
16
|
+
*
|
|
17
|
+
* 逐 op 应用(每个 op 独立 store.db.transaction:记忆写入 + 证据 + op 状态同事务):
|
|
18
|
+
* - 已 applied/skipped → 计入 skipped,不产生任何副作用(续跑幂等);
|
|
19
|
+
* - 应用前秘密复检(op.content 存在时):不干净 → op 标记 failed(只存 masked
|
|
20
|
+
* 摘要)、剩余 op 保持 pending、撤销已消耗审批、抛 E_SECRET_DETECTED
|
|
21
|
+
* (details 只含 {kind, masked},绝不回显原文);
|
|
22
|
+
* - add/keep_both:memories.add(authority='user_confirmed', createdBy='plan:<id>');
|
|
23
|
+
* keep_both 且带 target 时补 addRelation(new, target, 'contradicts');
|
|
24
|
+
* - merge:memories.revise(target, …, expectedCurrentRevisionId=快照);
|
|
25
|
+
* E_TARGET_CHANGED → op failed('target_changed')、剩余 pending、原样抛出
|
|
26
|
+
* (拒绝基于过期目标应用,spec「目标在批准后变化」);
|
|
27
|
+
* - 其他每 op 错误:op failed(error code) 并继续其余 op(失败计数进报告);
|
|
28
|
+
* - 全部处理完成 → setStatus('applied') + 审计 plan/applied(无正文)。
|
|
29
|
+
*
|
|
30
|
+
* 恢复路径(spec「应用在 halfway 中断」):
|
|
31
|
+
* - 进程在逐 op 应用中途退出:审批已消耗(一次性)、计划仍 approved、
|
|
32
|
+
* 已完成 op 状态为 applied。此时用同一 approvalId 重试会得到
|
|
33
|
+
* E_APPROVAL_REPLAY;恢复 = plans.revokeApproval(旧审批) +
|
|
34
|
+
* plans.setStatus(planId,'awaiting_approval') → 重新 issueApproval →
|
|
35
|
+
* 再次 applyPlan(已 applied/skipped 的 op 幂等跳过,最终结果与单次成功一致)。
|
|
36
|
+
* - 治理性中止(E_SECRET_DETECTED / E_TARGET_CHANGED):applyPlan 已就地
|
|
37
|
+
* 撤销消耗掉的审批并把计划送回 awaiting_approval(plan_hash 不变,重新批准
|
|
38
|
+
* 的是同一份计划内容),可直接「再次 issueApproval → 再次 applyPlan」;
|
|
39
|
+
* failed 的 op 会被重试并确定性复现同一失败——此类计划应重新 propose
|
|
40
|
+
* (剔除带秘密/目标已推进的条目),而不是反复重试。
|
|
41
|
+
*/
|
|
42
|
+
export interface ApplyResultEntry {
|
|
43
|
+
opIndex: number;
|
|
44
|
+
opType: string;
|
|
45
|
+
memoryId?: string;
|
|
46
|
+
note?: string;
|
|
47
|
+
}
|
|
48
|
+
export interface ApplyReport {
|
|
49
|
+
planId: string;
|
|
50
|
+
alreadyApplied: boolean;
|
|
51
|
+
applied: number;
|
|
52
|
+
skipped: number;
|
|
53
|
+
failed: number;
|
|
54
|
+
results: ApplyResultEntry[];
|
|
55
|
+
}
|
|
56
|
+
export interface ApplyPlanInput {
|
|
57
|
+
planId: string;
|
|
58
|
+
approvalId: string;
|
|
59
|
+
deviceId: string;
|
|
60
|
+
scan: (text: string) => SecretScanResult;
|
|
61
|
+
/** 按 itemId 附加证据:随 add 初始修订 / merge 新修订落库。 */
|
|
62
|
+
evidenceByItem?: Record<string, EvidenceInput[]>;
|
|
63
|
+
}
|
|
64
|
+
export declare function applyPlan(store: CairnStore, input: ApplyPlanInput): ApplyReport;
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
import { err, isCairnError } from '../core/errors.js';
|
|
2
|
+
export function applyPlan(store, input) {
|
|
3
|
+
const { planId, approvalId, deviceId, scan } = input;
|
|
4
|
+
const emptyReport = { planId, alreadyApplied: true, applied: 0, skipped: 0, failed: 0, results: [] };
|
|
5
|
+
let plan = store.plans.requireById(planId);
|
|
6
|
+
if (plan.status === 'applied')
|
|
7
|
+
return emptyReport;
|
|
8
|
+
// 过期清扫(approved 计划不受影响),随后以最新状态继续
|
|
9
|
+
store.plans.expireStale();
|
|
10
|
+
plan = store.plans.requireById(planId);
|
|
11
|
+
// 篡改预检(只读):先于状态检查,见模块文档
|
|
12
|
+
const approval = store.plans.requireApproval(approvalId);
|
|
13
|
+
if (approval.planId !== planId) {
|
|
14
|
+
throw err('E_APPROVAL_INVALID', '审批与计划不匹配', { approvalId, expectedPlan: approval.planId });
|
|
15
|
+
}
|
|
16
|
+
if (approval.planHash !== plan.planHash) {
|
|
17
|
+
throw err('E_PLAN_TAMPERED', '计划哈希与审批不一致:计划在批准后被修改', { approvalId });
|
|
18
|
+
}
|
|
19
|
+
if (plan.status !== 'approved') {
|
|
20
|
+
throw err('E_APPROVAL_INVALID', `计划状态为 ${plan.status},不能应用`, { planId, status: plan.status });
|
|
21
|
+
}
|
|
22
|
+
// 一次性审批消费:重放/过期/撤销在此拒绝;失败不消耗 uses
|
|
23
|
+
store.plans.consumeApproval(approvalId, planId, plan.planHash);
|
|
24
|
+
const evidenceByItem = input.evidenceByItem ?? {};
|
|
25
|
+
let applied = 0;
|
|
26
|
+
let skipped = 0;
|
|
27
|
+
let failed = 0;
|
|
28
|
+
const results = [];
|
|
29
|
+
/** 治理性中止:退役已消耗的一次性审批并把计划送回 awaiting_approval(见模块文档恢复路径)。 */
|
|
30
|
+
const abortRun = (reason) => {
|
|
31
|
+
try {
|
|
32
|
+
store.plans.revokeApproval(approvalId);
|
|
33
|
+
store.plans.setStatus(planId, 'awaiting_approval');
|
|
34
|
+
store.audit.record('plan', 'apply_aborted', { type: 'plan', id: planId }, { approvalId, reason });
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
// 尽力而为:清理失败不掩盖原始治理错误
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
for (const op of store.plans.ops(planId)) {
|
|
41
|
+
// 续跑幂等:已完成的操作不再产生任何副作用
|
|
42
|
+
if (op.status === 'applied' || op.status === 'skipped') {
|
|
43
|
+
skipped += 1;
|
|
44
|
+
results.push({
|
|
45
|
+
opIndex: op.opIndex,
|
|
46
|
+
opType: op.opType,
|
|
47
|
+
note: op.status === 'applied' ? 'already_applied' : 'already_skipped',
|
|
48
|
+
});
|
|
49
|
+
continue;
|
|
50
|
+
}
|
|
51
|
+
// 应用前秘密复检:错误与 op.error 只含 masked 摘要,绝不回显原文
|
|
52
|
+
if (op.content != null) {
|
|
53
|
+
const rescan = scan(op.content);
|
|
54
|
+
if (!rescan.clean) {
|
|
55
|
+
const maskedFindings = rescan.findings.map((f) => ({ kind: f.kind, masked: f.masked }));
|
|
56
|
+
const summary = maskedFindings.length > 0
|
|
57
|
+
? `secret_detected ${maskedFindings.map((f) => `${f.kind}:${f.masked}`).join(',')}`
|
|
58
|
+
: 'secret_detected:injection_findings';
|
|
59
|
+
store.plans.markOpFailed(op.id, summary);
|
|
60
|
+
failed += 1;
|
|
61
|
+
abortRun('E_SECRET_DETECTED');
|
|
62
|
+
throw err('E_SECRET_DETECTED', '计划应用被阻断:操作内容检测到疑似秘密(不回显原文)', {
|
|
63
|
+
planId,
|
|
64
|
+
opIndex: op.opIndex,
|
|
65
|
+
findings: maskedFindings,
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
try {
|
|
70
|
+
const memoryId = store.db.transaction(() => {
|
|
71
|
+
const id = applyOp(store, plan, op, evidenceByItem, deviceId);
|
|
72
|
+
if (op.opType === 'skip')
|
|
73
|
+
store.plans.markOpSkipped(op.id);
|
|
74
|
+
else
|
|
75
|
+
store.plans.markOpApplied(op.id);
|
|
76
|
+
return id;
|
|
77
|
+
});
|
|
78
|
+
const entry = { opIndex: op.opIndex, opType: op.opType };
|
|
79
|
+
if (op.opType === 'skip') {
|
|
80
|
+
skipped += 1;
|
|
81
|
+
entry.note = 'skipped';
|
|
82
|
+
}
|
|
83
|
+
else {
|
|
84
|
+
applied += 1;
|
|
85
|
+
if (memoryId !== undefined)
|
|
86
|
+
entry.memoryId = memoryId;
|
|
87
|
+
}
|
|
88
|
+
results.push(entry);
|
|
89
|
+
}
|
|
90
|
+
catch (e) {
|
|
91
|
+
if (isCairnError(e) && e.code === 'E_TARGET_CHANGED') {
|
|
92
|
+
store.plans.markOpFailed(op.id, 'target_changed');
|
|
93
|
+
failed += 1;
|
|
94
|
+
abortRun('E_TARGET_CHANGED');
|
|
95
|
+
throw e; // 原样抛出(details 只含 memoryId/expected/actual)
|
|
96
|
+
}
|
|
97
|
+
const note = isCairnError(e) ? e.code : 'E_INTERNAL';
|
|
98
|
+
store.plans.markOpFailed(op.id, note);
|
|
99
|
+
failed += 1;
|
|
100
|
+
results.push({ opIndex: op.opIndex, opType: op.opType, note: `failed:${note}` });
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
store.plans.setStatus(planId, 'applied');
|
|
104
|
+
store.audit.record('plan', 'applied', { type: 'plan', id: planId }, {
|
|
105
|
+
approvalId,
|
|
106
|
+
deviceId,
|
|
107
|
+
applied,
|
|
108
|
+
skipped,
|
|
109
|
+
failed,
|
|
110
|
+
});
|
|
111
|
+
return { planId, alreadyApplied: false, applied, skipped, failed, results };
|
|
112
|
+
}
|
|
113
|
+
/** 应用单个操作(在调用方的 per-op 事务内执行),返回新记忆 id(skip 为 undefined)。 */
|
|
114
|
+
function applyOp(store, plan, op, evidenceByItem, deviceId) {
|
|
115
|
+
const evidence = evidenceForOp(op, evidenceByItem);
|
|
116
|
+
switch (op.opType) {
|
|
117
|
+
case 'skip':
|
|
118
|
+
return undefined;
|
|
119
|
+
case 'add':
|
|
120
|
+
case 'keep_both': {
|
|
121
|
+
if (typeof op.content !== 'string' || op.content.length === 0) {
|
|
122
|
+
throw err('E_VALIDATION', `${op.opType} 操作缺少 content`, { opIndex: op.opIndex });
|
|
123
|
+
}
|
|
124
|
+
const memory = store.memories.add({
|
|
125
|
+
kind: op.kind ?? 'fact',
|
|
126
|
+
content: op.content,
|
|
127
|
+
scopeId: op.scopeId ?? plan.scopeId,
|
|
128
|
+
authority: 'user_confirmed',
|
|
129
|
+
createdBy: `plan:${plan.id}`,
|
|
130
|
+
evidence,
|
|
131
|
+
}, deviceId);
|
|
132
|
+
if (op.opType === 'keep_both' && op.targetMemoryId) {
|
|
133
|
+
store.memories.addRelation(memory.id, op.targetMemoryId, 'contradicts');
|
|
134
|
+
}
|
|
135
|
+
return memory.id;
|
|
136
|
+
}
|
|
137
|
+
case 'merge': {
|
|
138
|
+
if (!op.targetMemoryId) {
|
|
139
|
+
throw err('E_VALIDATION', 'merge 操作缺少 targetMemoryId', { opIndex: op.opIndex });
|
|
140
|
+
}
|
|
141
|
+
if (typeof op.content !== 'string' || op.content.length === 0) {
|
|
142
|
+
throw err('E_VALIDATION', 'merge 操作缺少 content', { opIndex: op.opIndex });
|
|
143
|
+
}
|
|
144
|
+
const { memory, revision } = store.memories.revise(op.targetMemoryId, op.content, {
|
|
145
|
+
expectedCurrentRevisionId: op.targetExpectedRevision ?? undefined,
|
|
146
|
+
reason: op.reason ?? 'plan merge',
|
|
147
|
+
author: `plan:${plan.id}`,
|
|
148
|
+
}, deviceId);
|
|
149
|
+
for (const ev of evidence)
|
|
150
|
+
store.memories.addEvidence(memory.id, revision.id, ev);
|
|
151
|
+
return memory.id;
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
function evidenceForOp(op, evidenceByItem) {
|
|
156
|
+
if (op.itemId == null)
|
|
157
|
+
return [];
|
|
158
|
+
return evidenceByItem[op.itemId] ?? [];
|
|
159
|
+
}
|
|
160
|
+
//# sourceMappingURL=apply.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/governance/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAsEtD,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,KAAqB;IAChE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACrD,MAAM,WAAW,GAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAElH,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAElD,kCAAkC;IAClC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAEvC,wBAAwB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,GAAG,CAAC,oBAAoB,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,GAAG,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,GAAG,CAAC,oBAAoB,EAAE,SAAS,IAAI,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE/D,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;IAClD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAQ,EAAE;QACxC,IAAI,CAAC;YACH,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YACvC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;YACnD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACpG,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,uBAAuB;QACvB,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,CAAC;YACb,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,IAAI,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;aACtE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,IAAI,EAAE,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAc,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAClG,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;oBACvC,CAAC,CAAC,mBAAmB,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;oBACnF,CAAC,CAAC,oCAAoC,CAAC;gBACzC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACzC,MAAM,IAAI,CAAC,CAAC;gBACZ,QAAQ,CAAC,mBAAmB,CAAC,CAAC;gBAC9B,MAAM,GAAG,CAAC,mBAAmB,EAAE,4BAA4B,EAAE;oBAC3D,MAAM;oBACN,OAAO,EAAE,EAAE,CAAC,OAAO;oBACnB,QAAQ,EAAE,cAAc;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBACzC,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;gBAC9D,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM;oBAAE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;;oBACtD,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACtC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,MAAM,KAAK,GAAqB,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC;YAC3E,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC,CAAC;gBACb,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,CAAC,CAAC;gBACb,IAAI,QAAQ,KAAK,SAAS;oBAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACxD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACrD,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;gBAClD,MAAM,IAAI,CAAC,CAAC;gBACZ,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBAC7B,MAAM,CAAC,CAAC,CAAC,4CAA4C;YACvD,CAAC;YACD,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;YACrD,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,CAAC,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;QAClE,UAAU;QACV,QAAQ;QACR,OAAO;QACP,OAAO;QACP,MAAM;KACP,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC9E,CAAC;AAED,6DAA6D;AAC7D,SAAS,OAAO,CACd,KAAiB,EACjB,IAAgB,EAChB,EAAgB,EAChB,cAA+C,EAC/C,QAAgB;IAEhB,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK,CAAC;QACX,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9D,MAAM,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,eAAe,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAC/B;gBACE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,MAAM;gBACvB,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;gBACnC,SAAS,EAAE,gBAAgB;gBAC3B,SAAS,EAAE,QAAQ,IAAI,CAAC,EAAE,EAAE;gBAC5B,QAAQ;aACT,EACD,QAAQ,CACT,CAAC;YACF,IAAI,EAAE,CAAC,MAAM,KAAK,WAAW,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;gBACnD,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,MAAM,CAAC,EAAE,CAAC;QACnB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC;gBACvB,MAAM,GAAG,CAAC,cAAc,EAAE,2BAA2B,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9D,MAAM,GAAG,CAAC,cAAc,EAAE,oBAAoB,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAChD,EAAE,CAAC,cAAc,EACjB,EAAE,CAAC,OAAO,EACV;gBACE,yBAAyB,EAAE,EAAE,CAAC,sBAAsB,IAAI,SAAS;gBACjE,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,YAAY;gBACjC,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,EAAE;aAC1B,EACD,QAAQ,CACT,CAAC;YACF,KAAK,MAAM,EAAE,IAAI,QAAQ;gBAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAClF,OAAO,MAAM,CAAC,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,EAAgB,EAAE,cAA+C;IACtF,IAAI,EAAE,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { CairnDb } from '../store/db.js';
|
|
2
|
+
/**
|
|
3
|
+
* 内容去重(design D3):写入、计划生成、计划应用三个时机共用这一处判定。
|
|
4
|
+
*
|
|
5
|
+
* 分三份写是错的——越界条件会各自漂移,最后出现"写入时认为重复、晋升时认为不重复"
|
|
6
|
+
* 这种事后无法解释的状态。
|
|
7
|
+
*
|
|
8
|
+
* 判定只认"在活动集里的"记忆:`active` 与 `candidate`。
|
|
9
|
+
* - `tombstoned` / `superseded` 是明确退出活动集的历史,不算重复,否则"遗忘之后再记同一条"
|
|
10
|
+
* 会被静默吞掉;
|
|
11
|
+
* - `archived` 不算重复:归档的语义是"不活跃但仍保留",用户重新记下同一件事是恢复意图。
|
|
12
|
+
*/
|
|
13
|
+
export type DuplicateKind = 'active' | 'candidate';
|
|
14
|
+
export interface DuplicateHit {
|
|
15
|
+
memoryId: string;
|
|
16
|
+
scopeId: string;
|
|
17
|
+
contentHash: string;
|
|
18
|
+
status: DuplicateKind;
|
|
19
|
+
}
|
|
20
|
+
export declare function findDuplicateByHash(db: CairnDb, scopeId: string, hash: string): DuplicateHit | null;
|
|
21
|
+
export declare function findDuplicate(db: CairnDb, scopeId: string, content: string): DuplicateHit | null;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { err } from '../core/errors.js';
|
|
2
|
+
import { contentHash as contentHashOf, normalizeContent } from '../core/hash.js';
|
|
3
|
+
export function findDuplicateByHash(db, scopeId, hash) {
|
|
4
|
+
const row = db.get(`SELECT id, scope_id, content_hash, status FROM memory
|
|
5
|
+
WHERE scope_id = ? AND content_hash = ? AND status IN ('active','candidate')
|
|
6
|
+
ORDER BY CASE status WHEN 'active' THEN 0 ELSE 1 END, updated_at DESC
|
|
7
|
+
LIMIT 1`, scopeId, hash);
|
|
8
|
+
if (!row)
|
|
9
|
+
return null;
|
|
10
|
+
return {
|
|
11
|
+
memoryId: row.id,
|
|
12
|
+
scopeId: row.scope_id,
|
|
13
|
+
contentHash: row.content_hash,
|
|
14
|
+
status: row.status,
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
export function findDuplicate(db, scopeId, content) {
|
|
18
|
+
if (normalizeContent(content).length === 0) {
|
|
19
|
+
throw err('E_VALIDATION', '内容为空,无法判定重复');
|
|
20
|
+
}
|
|
21
|
+
return findDuplicateByHash(db, scopeId, contentHashOf(content));
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=dedup.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../../src/governance/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAwBjF,MAAM,UAAU,mBAAmB,CAAC,EAAW,EAAE,OAAe,EAAE,IAAY;IAC5E,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAChB;;;cAGU,EACV,OAAO,EACP,IAAI,CACkC,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,EAAY;QAC1B,OAAO,EAAE,GAAG,CAAC,QAAkB;QAC/B,WAAW,EAAE,GAAG,CAAC,YAAsB;QACvC,MAAM,EAAE,GAAG,CAAC,MAAuB;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAW,EAAE,OAAe,EAAE,OAAe;IACzE,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 治理模块(memory-governance spec)公共入口:候选计划的真实应用。
|
|
3
|
+
*
|
|
4
|
+
* 职责边界——模型只生成候选,以下全部是确定性代码:
|
|
5
|
+
* - proposePlan:候选逐项校验(instruction 拒绝、秘密/注入扫描、精确去重、
|
|
6
|
+
* opHint 映射)→ awaiting_approval 计划 + plan_hash。审批不在此签发,
|
|
7
|
+
* 必须由本地可信通道(CLI / MCP UI)另行 issueApproval;
|
|
8
|
+
* - applyPlan:消费一次性真实审批(重放/过期/篡改由确定性代码校验,
|
|
9
|
+
* 调用方声明 user_confirmed 不构成凭证)→ 逐 op 幂等应用(per-op 事务、
|
|
10
|
+
* 应用前秘密复检、目标修订快照重检)→ 审计。
|
|
11
|
+
*
|
|
12
|
+
* 隐私硬约束:审计、报告、错误详情只含计数、id 与 masked 摘要;
|
|
13
|
+
* 记忆正文与秘密原文绝不进入日志、投影或上行内容。
|
|
14
|
+
*/
|
|
15
|
+
export * from './propose.js';
|
|
16
|
+
export * from './apply.js';
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 治理模块(memory-governance spec)公共入口:候选计划的真实应用。
|
|
3
|
+
*
|
|
4
|
+
* 职责边界——模型只生成候选,以下全部是确定性代码:
|
|
5
|
+
* - proposePlan:候选逐项校验(instruction 拒绝、秘密/注入扫描、精确去重、
|
|
6
|
+
* opHint 映射)→ awaiting_approval 计划 + plan_hash。审批不在此签发,
|
|
7
|
+
* 必须由本地可信通道(CLI / MCP UI)另行 issueApproval;
|
|
8
|
+
* - applyPlan:消费一次性真实审批(重放/过期/篡改由确定性代码校验,
|
|
9
|
+
* 调用方声明 user_confirmed 不构成凭证)→ 逐 op 幂等应用(per-op 事务、
|
|
10
|
+
* 应用前秘密复检、目标修订快照重检)→ 审计。
|
|
11
|
+
*
|
|
12
|
+
* 隐私硬约束:审计、报告、错误详情只含计数、id 与 masked 摘要;
|
|
13
|
+
* 记忆正文与秘密原文绝不进入日志、投影或上行内容。
|
|
14
|
+
*/
|
|
15
|
+
export * from './propose.js';
|
|
16
|
+
export * from './apply.js';
|
|
17
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/governance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { EvidenceInput, MemoryKind, SecretScanResult } from '../core/types.js';
|
|
2
|
+
import { CairnStore } from '../store/open.js';
|
|
3
|
+
import { PlanRecord } from '../store/plans.js';
|
|
4
|
+
/**
|
|
5
|
+
* 候选计划生成(propose,spec memory-governance「计划绑定真实审批」前置环节)。
|
|
6
|
+
*
|
|
7
|
+
* 模型只产出候选(ProposedItem);本模块是纯确定性代码管线:
|
|
8
|
+
* 1. 逐项校验(content 非空且 ≤1MB、kind 合法、instruction 直接拒绝——
|
|
9
|
+
* instruction 只能走用户显式写入,不得经由候选计划入库);
|
|
10
|
+
* 2. 秘密/注入扫描(scan 由调用方注入,通常为 core/secrets 的 scanText);
|
|
11
|
+
* 不干净 → 整项 rejected,findings 只保留 {kind, masked},绝不回显原文;
|
|
12
|
+
* 3. 精确去重:与本地库现有记忆按规范化内容哈希(contentHash)比对,
|
|
13
|
+
* 命中 → 不建 op,记 duplicates;
|
|
14
|
+
* 4. opHint 映射:skip → skip op;targetMemoryId + merge/keep_both → 对应 op
|
|
15
|
+
* (携带 targetExpectedRevision 修订快照);其余 → add op;
|
|
16
|
+
* 5. 全部被拒/去重、无任何 op → E_PLAN_INVALID;
|
|
17
|
+
* 6. createPlan(awaiting_approval,plan_hash 由 store 规范化计算);
|
|
18
|
+
* 7. 审计 plan/proposed:detail 只含计数,不含正文。
|
|
19
|
+
*
|
|
20
|
+
* 审批不在此签发:proposePlan 只产出 awaiting_approval 计划,
|
|
21
|
+
* 必须由本地可信通道(CLI/MCP UI)另行 issueApproval——
|
|
22
|
+
* 调用方声明 user_confirmed 不构成审批凭证(spec memory-governance)。
|
|
23
|
+
*/
|
|
24
|
+
/** 单条候选正文上限(与 MemoryRepository.validateMemoryInput 一致)。 */
|
|
25
|
+
export declare const MAX_ITEM_CONTENT_LENGTH = 1000000;
|
|
26
|
+
declare const OP_HINTS: readonly ["add", "merge", "keep_both", "skip"];
|
|
27
|
+
export type OpHint = (typeof OP_HINTS)[number];
|
|
28
|
+
export interface ProposedItem {
|
|
29
|
+
/**
|
|
30
|
+
* 必须引用已存在的 import_item(plan_operation.item_id 外键约束),
|
|
31
|
+
* 同时作为 applyPlan evidenceByItem 的键(按条目附加证据)。无导入来源时可省略。
|
|
32
|
+
*/
|
|
33
|
+
itemId?: string;
|
|
34
|
+
content: string;
|
|
35
|
+
kind: MemoryKind;
|
|
36
|
+
opHint?: OpHint;
|
|
37
|
+
/** merge/keep_both 的目标记忆。 */
|
|
38
|
+
targetMemoryId?: string;
|
|
39
|
+
/** 目标修订快照:apply 时重检,目标推进后 E_TARGET_CHANGED。 */
|
|
40
|
+
targetExpectedRevision?: string;
|
|
41
|
+
reason?: string;
|
|
42
|
+
/**
|
|
43
|
+
* 随行证据提示。计划 op 本身不承载证据;证据在 applyPlan 时通过
|
|
44
|
+
* evidenceByItem(按 itemId)落库,调用方用自己的 items 数组构造该映射。
|
|
45
|
+
*/
|
|
46
|
+
evidence?: EvidenceInput[];
|
|
47
|
+
}
|
|
48
|
+
/** 被拒条目:只含原因与打码摘要,绝不回显正文/秘密原文。 */
|
|
49
|
+
export interface RejectedItem {
|
|
50
|
+
itemId?: string;
|
|
51
|
+
reason: string;
|
|
52
|
+
findings: {
|
|
53
|
+
kind: string;
|
|
54
|
+
masked: string;
|
|
55
|
+
}[];
|
|
56
|
+
}
|
|
57
|
+
/** 与库中现有记忆精确重复的条目。 */
|
|
58
|
+
export interface DuplicateItem {
|
|
59
|
+
itemId?: string;
|
|
60
|
+
duplicateOfMemoryId: string;
|
|
61
|
+
}
|
|
62
|
+
export interface ProposeOutput {
|
|
63
|
+
plan: PlanRecord;
|
|
64
|
+
planHash: string;
|
|
65
|
+
/** 建立的操作数(= plan.itemCount)。 */
|
|
66
|
+
accepted: number;
|
|
67
|
+
rejected: RejectedItem[];
|
|
68
|
+
duplicates: DuplicateItem[];
|
|
69
|
+
}
|
|
70
|
+
export interface ProposePlanInput {
|
|
71
|
+
scopeId: string;
|
|
72
|
+
items: ProposedItem[];
|
|
73
|
+
sourceArchiveIds?: string[];
|
|
74
|
+
proposedBy: string;
|
|
75
|
+
scan: (text: string) => SecretScanResult;
|
|
76
|
+
}
|
|
77
|
+
export declare function proposePlan(store: CairnStore, input: ProposePlanInput): ProposeOutput;
|
|
78
|
+
export {};
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
import { contentHash } from '../core/hash.js';
|
|
2
|
+
import { findDuplicate } from './dedup.js';
|
|
3
|
+
import { err } from '../core/errors.js';
|
|
4
|
+
import { MEMORY_KINDS } from '../core/types.js';
|
|
5
|
+
/**
|
|
6
|
+
* 候选计划生成(propose,spec memory-governance「计划绑定真实审批」前置环节)。
|
|
7
|
+
*
|
|
8
|
+
* 模型只产出候选(ProposedItem);本模块是纯确定性代码管线:
|
|
9
|
+
* 1. 逐项校验(content 非空且 ≤1MB、kind 合法、instruction 直接拒绝——
|
|
10
|
+
* instruction 只能走用户显式写入,不得经由候选计划入库);
|
|
11
|
+
* 2. 秘密/注入扫描(scan 由调用方注入,通常为 core/secrets 的 scanText);
|
|
12
|
+
* 不干净 → 整项 rejected,findings 只保留 {kind, masked},绝不回显原文;
|
|
13
|
+
* 3. 精确去重:与本地库现有记忆按规范化内容哈希(contentHash)比对,
|
|
14
|
+
* 命中 → 不建 op,记 duplicates;
|
|
15
|
+
* 4. opHint 映射:skip → skip op;targetMemoryId + merge/keep_both → 对应 op
|
|
16
|
+
* (携带 targetExpectedRevision 修订快照);其余 → add op;
|
|
17
|
+
* 5. 全部被拒/去重、无任何 op → E_PLAN_INVALID;
|
|
18
|
+
* 6. createPlan(awaiting_approval,plan_hash 由 store 规范化计算);
|
|
19
|
+
* 7. 审计 plan/proposed:detail 只含计数,不含正文。
|
|
20
|
+
*
|
|
21
|
+
* 审批不在此签发:proposePlan 只产出 awaiting_approval 计划,
|
|
22
|
+
* 必须由本地可信通道(CLI/MCP UI)另行 issueApproval——
|
|
23
|
+
* 调用方声明 user_confirmed 不构成审批凭证(spec memory-governance)。
|
|
24
|
+
*/
|
|
25
|
+
/** 单条候选正文上限(与 MemoryRepository.validateMemoryInput 一致)。 */
|
|
26
|
+
export const MAX_ITEM_CONTENT_LENGTH = 1_000_000;
|
|
27
|
+
const OP_HINTS = ['add', 'merge', 'keep_both', 'skip'];
|
|
28
|
+
export function proposePlan(store, input) {
|
|
29
|
+
const rejected = [];
|
|
30
|
+
const duplicates = [];
|
|
31
|
+
const ops = [];
|
|
32
|
+
/** 批内已占用正文哈希 → 保留它的条目 id(用于告诉调用方"重复到哪条去了")。 */
|
|
33
|
+
const batchHashes = new Map();
|
|
34
|
+
for (const item of input.items) {
|
|
35
|
+
// 1. 逐项确定性校验:逐项拒绝(不抛错),全部无 op 时才抛 E_PLAN_INVALID
|
|
36
|
+
if (typeof item.content !== 'string' || item.content.trim().length === 0) {
|
|
37
|
+
rejected.push({ itemId: item.itemId, reason: 'content 不能为空', findings: [] });
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
if (item.content.length > MAX_ITEM_CONTENT_LENGTH) {
|
|
41
|
+
rejected.push({ itemId: item.itemId, reason: `content 超过 ${MAX_ITEM_CONTENT_LENGTH} 字符上限`, findings: [] });
|
|
42
|
+
continue;
|
|
43
|
+
}
|
|
44
|
+
if (!MEMORY_KINDS.includes(item.kind)) {
|
|
45
|
+
rejected.push({ itemId: item.itemId, reason: `kind 非法: ${String(item.kind)}`, findings: [] });
|
|
46
|
+
continue;
|
|
47
|
+
}
|
|
48
|
+
if (item.kind === 'instruction') {
|
|
49
|
+
rejected.push({ itemId: item.itemId, reason: 'instruction 只能通过用户显式写入创建,不能进入候选计划', findings: [] });
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
if (item.opHint != null && !OP_HINTS.includes(item.opHint)) {
|
|
53
|
+
rejected.push({ itemId: item.itemId, reason: `opHint 非法: ${String(item.opHint)}`, findings: [] });
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
// plan_operation.item_id 外键 REFERENCES import_item(id):
|
|
57
|
+
// 提前确定性校验,避免 createPlan 落库时抛原始 SQLITE 错误
|
|
58
|
+
if (item.itemId != null) {
|
|
59
|
+
try {
|
|
60
|
+
store.archives.requireItem(item.itemId);
|
|
61
|
+
}
|
|
62
|
+
catch {
|
|
63
|
+
rejected.push({ itemId: item.itemId, reason: 'itemId 不存在于 import_item,不能绑定到计划操作', findings: [] });
|
|
64
|
+
continue;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
// 2. 秘密/注入扫描:不干净 → 整项拒绝;findings 只保留 kind 与 masked
|
|
68
|
+
const scanResult = input.scan(item.content);
|
|
69
|
+
if (!scanResult.clean) {
|
|
70
|
+
const hasSecretFinding = scanResult.findings.length > 0;
|
|
71
|
+
rejected.push({
|
|
72
|
+
itemId: item.itemId,
|
|
73
|
+
reason: hasSecretFinding ? 'content 检测到疑似秘密' : 'content 检测到疑似提示注入指令',
|
|
74
|
+
findings: scanResult.findings.map((f) => ({ kind: f.kind, masked: f.masked })),
|
|
75
|
+
});
|
|
76
|
+
continue;
|
|
77
|
+
}
|
|
78
|
+
// 3. 精确去重:skip 不承载正文、不建记忆,不参与去重;
|
|
79
|
+
// 其余条目与库中现有记忆比对,再与批内更早条目比对
|
|
80
|
+
if (item.opHint !== 'skip') {
|
|
81
|
+
const hash = contentHash(item.content);
|
|
82
|
+
// 与写入路径共用同一判定(governance/dedup):只认 active/candidate。
|
|
83
|
+
// 若用 findByContentHash,会把 archived 也算成重复,导致"归档后重新导入永远无法晋升"。
|
|
84
|
+
const existing = findDuplicate(store.db, input.scopeId, item.content);
|
|
85
|
+
if (existing) {
|
|
86
|
+
duplicates.push({ itemId: item.itemId, duplicateOfMemoryId: existing.memoryId });
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
if (batchHashes.has(hash)) {
|
|
90
|
+
const keep = batchHashes.get(hash) ?? null;
|
|
91
|
+
rejected.push({
|
|
92
|
+
itemId: item.itemId,
|
|
93
|
+
// 前缀机器可读(调用方据此把证据并到保留项),后缀给人看。
|
|
94
|
+
reason: `repeatOf:${keep ?? '?'} 与同批更早条目内容重复`,
|
|
95
|
+
findings: [],
|
|
96
|
+
});
|
|
97
|
+
continue;
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
// 4. opHint 映射
|
|
101
|
+
if (item.opHint === 'skip') {
|
|
102
|
+
// skip op 只记录决策与原因,不携带正文(减少计划中的秘密暴露面)
|
|
103
|
+
ops.push({ opType: 'skip', itemId: item.itemId ?? null, reason: item.reason ?? null });
|
|
104
|
+
continue;
|
|
105
|
+
}
|
|
106
|
+
batchHashes.set(contentHash(item.content), item.itemId ?? null);
|
|
107
|
+
const common = {
|
|
108
|
+
itemId: item.itemId ?? null,
|
|
109
|
+
content: item.content,
|
|
110
|
+
kind: item.kind,
|
|
111
|
+
reason: item.reason ?? null,
|
|
112
|
+
};
|
|
113
|
+
if ((item.opHint === 'merge' || item.opHint === 'keep_both') && item.targetMemoryId) {
|
|
114
|
+
ops.push({
|
|
115
|
+
opType: item.opHint,
|
|
116
|
+
targetMemoryId: item.targetMemoryId,
|
|
117
|
+
targetExpectedRevision: item.targetExpectedRevision ?? null,
|
|
118
|
+
...common,
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
else {
|
|
122
|
+
// 其余(含带 target 但未声明 merge/keep_both 的)一律 add
|
|
123
|
+
ops.push({ opType: 'add', ...common });
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
// 5. 空计划拒绝(store.plans.createPlan 亦有兜底)
|
|
127
|
+
if (ops.length === 0) {
|
|
128
|
+
throw err('E_PLAN_INVALID', '所有候选均被拒绝或去重,计划为空', {
|
|
129
|
+
itemCount: input.items.length,
|
|
130
|
+
rejectedCount: rejected.length,
|
|
131
|
+
duplicatesCount: duplicates.length,
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
// 6. 落库为 awaiting_approval 计划(plan_hash 基于规范化操作列表)
|
|
135
|
+
const { plan, planHash } = store.plans.createPlan({
|
|
136
|
+
scopeId: input.scopeId,
|
|
137
|
+
sourceArchiveIds: input.sourceArchiveIds,
|
|
138
|
+
ops,
|
|
139
|
+
proposedBy: input.proposedBy,
|
|
140
|
+
keyPrefix: 'governance',
|
|
141
|
+
});
|
|
142
|
+
// 7. 审计:只记计数与 id,不含正文
|
|
143
|
+
store.audit.record('plan', 'proposed', { type: 'plan', id: plan.id }, {
|
|
144
|
+
itemCount: ops.length,
|
|
145
|
+
rejected: rejected.length,
|
|
146
|
+
duplicates: duplicates.length,
|
|
147
|
+
});
|
|
148
|
+
return { plan, planHash, accepted: ops.length, rejected, duplicates };
|
|
149
|
+
}
|
|
150
|
+
//# sourceMappingURL=propose.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"propose.js","sourceRoot":"","sources":["../../../src/governance/propose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAiB,YAAY,EAAgC,MAAM,kBAAkB,CAAC;AAI7F;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEjD,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAU,CAAC;AAsDhE,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,KAAuB;IACpE,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,iDAAiD;QACjD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7E,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,uBAAuB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3G,SAAS;QACX,CAAC;QACD,IAAI,CAAE,YAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9F,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,mCAAmC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAClG,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,CAAE,QAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAClG,SAAS;QACX,CAAC;QACD,wDAAwD;QACxD,yCAAyC;QACzC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,mCAAmC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;gBAClG,SAAS;YACX,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,gBAAgB,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,qBAAqB;gBACpE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;aAC/E,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,8BAA8B;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,qDAAqD;YACrD,4DAA4D;YAC5D,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACtE,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjF,SAAS;YACX,CAAC;YACD,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,+BAA+B;oBAC/B,MAAM,EAAE,YAAY,IAAI,IAAI,GAAG,cAAc;oBAC7C,QAAQ,EAAE,EAAE;iBACb,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,sCAAsC;YACtC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;YACvF,SAAS;QACX,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;SAC5B,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACpF,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,IAAI,IAAI;gBAC3D,GAAG,MAAM;aACV,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,EAAE;YAC9C,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAC7B,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,eAAe,EAAE,UAAU,CAAC,MAAM;SACnC,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,GAAG;QACH,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,YAAY;KACxB,CAAC,CAAC;IAEH,sBAAsB;IACtB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE;QACpE,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,UAAU,EAAE,UAAU,CAAC,MAAM;KAC9B,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACxE,CAAC"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @carloswon/cairn-memory 库入口:聚合核心公共 API,供以库方式消费的用户 import。
|
|
3
|
+
* CLI / MCP 入口请使用 bin(cairn / cairn-mcp)或 dist 下的对应文件。
|
|
4
|
+
*/
|
|
5
|
+
export * from './core/index.js';
|
|
6
|
+
export { scanText, maskText, assertClean } from './core/secrets.js';
|
|
7
|
+
export * from './store/index.js';
|
|
8
|
+
export * from './retrieval/index.js';
|
|
9
|
+
export * from './governance/index.js';
|
|
10
|
+
export * from './onboarding/index.js';
|
|
11
|
+
export { discoverSources } from './onboarding/discover.js';
|
|
12
|
+
export * from './jobs/index.js';
|
|
13
|
+
export * from './projection/index.js';
|
|
14
|
+
export * from './agents/index.js';
|
|
15
|
+
export { AppService, CallerContext, MemoryDetail, DoctorReport, ScopeSelection } from './interfaces/app-service.js';
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @carloswon/cairn-memory 库入口:聚合核心公共 API,供以库方式消费的用户 import。
|
|
3
|
+
* CLI / MCP 入口请使用 bin(cairn / cairn-mcp)或 dist 下的对应文件。
|
|
4
|
+
*/
|
|
5
|
+
// 核心:类型、作用域、错误、哈希、ID、时间、秘密扫描
|
|
6
|
+
export * from './core/index.js';
|
|
7
|
+
export { scanText, maskText, assertClean } from './core/secrets.js';
|
|
8
|
+
// 存储:打开、迁移、备份、各仓储
|
|
9
|
+
export * from './store/index.js';
|
|
10
|
+
// 检索与导出
|
|
11
|
+
export * from './retrieval/index.js';
|
|
12
|
+
// 治理:候选计划与幂等应用
|
|
13
|
+
export * from './governance/index.js';
|
|
14
|
+
// 首次初始化:发现、快照导入、分批
|
|
15
|
+
export * from './onboarding/index.js';
|
|
16
|
+
export { discoverSources } from './onboarding/discover.js';
|
|
17
|
+
// 后台任务
|
|
18
|
+
export * from './jobs/index.js';
|
|
19
|
+
// 投影与宿主配置
|
|
20
|
+
export * from './projection/index.js';
|
|
21
|
+
export * from './agents/index.js';
|
|
22
|
+
// 应用服务(CLI 与 MCP 共用的规则实现);AddMemoryInput 与 store 仓储重名,只导出无冲突成员
|
|
23
|
+
export { AppService } from './interfaces/app-service.js';
|
|
24
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6BAA6B;AAC7B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEpE,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,cAAc,sBAAsB,CAAC;AAErC,eAAe;AACf,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB;AACnB,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO;AACP,cAAc,iBAAiB,CAAC;AAEhC,UAAU;AACV,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAA6D,MAAM,6BAA6B,CAAC"}
|