@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,242 @@
|
|
|
1
|
+
import { CairnStore } from '../store/index.js';
|
|
2
|
+
import { ScopeRow } from '../core/scope.js';
|
|
3
|
+
import { MemoryRecord, MemoryKind, Authority, RevisionRecord, EvidenceRecord, EvidenceInput } from '../core/types.js';
|
|
4
|
+
import { ExitCode } from '../core/errors.js';
|
|
5
|
+
import { SearchInput, SearchOutput } from '../retrieval/search.js';
|
|
6
|
+
import { ExportInput, ExportOutput } from '../retrieval/export.js';
|
|
7
|
+
import { RunOnceSummary } from '../jobs/worker.js';
|
|
8
|
+
import { loadVaultConfig } from '../sync/vault.js';
|
|
9
|
+
import { ImportOutcome } from '../onboarding/import.js';
|
|
10
|
+
import { Judgement, WriteAction } from '../onboarding/judgement.js';
|
|
11
|
+
import { BatchProgress, BatchChunkItem } from '../onboarding/batches.js';
|
|
12
|
+
import type { SkippedItem } from '../onboarding/batches.js';
|
|
13
|
+
import { ProposedItem } from '../governance/propose.js';
|
|
14
|
+
import { ApplyReport } from '../governance/apply.js';
|
|
15
|
+
import { SourceCandidate } from '../onboarding/discover.js';
|
|
16
|
+
import { PlanRecord } from '../store/plans.js';
|
|
17
|
+
import { ImportSourceKind } from '../store/archives.js';
|
|
18
|
+
/**
|
|
19
|
+
* CLI 与 MCP 共用的应用服务(design D1):记忆规则只在这里实现一次。
|
|
20
|
+
* 秘密扫描在写入前执行;作用域由 store 层策略统一判定;
|
|
21
|
+
* 上行任务与本地写入同事务边界,失败只留下可重试状态。
|
|
22
|
+
*/
|
|
23
|
+
export interface ScopeSelection {
|
|
24
|
+
scopeId?: string;
|
|
25
|
+
preset?: 'personal-global' | 'project-global' | 'device-local' | 'project-device' | 'agent-private' | 'session-ephemeral';
|
|
26
|
+
projectId?: string;
|
|
27
|
+
projectName?: string;
|
|
28
|
+
agentId?: string;
|
|
29
|
+
ttlDays?: number;
|
|
30
|
+
}
|
|
31
|
+
export interface AddMemoryInput {
|
|
32
|
+
content: string;
|
|
33
|
+
kind?: MemoryKind;
|
|
34
|
+
authority?: Authority;
|
|
35
|
+
sensitivity?: 'normal' | 'sensitive';
|
|
36
|
+
expiresAt?: string | null;
|
|
37
|
+
sourceAgent?: string | null;
|
|
38
|
+
sourceSessionId?: string | null;
|
|
39
|
+
evidence?: EvidenceInput[];
|
|
40
|
+
scope?: ScopeSelection;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* 写入结果。`action` 说明实际发生了什么——调用方不该靠"有没有拿到 id"来猜
|
|
44
|
+
* 自己是新建了一条、并入了旧的一条、还是被判断拦下了。
|
|
45
|
+
*/
|
|
46
|
+
export interface AddMemoryOutcome {
|
|
47
|
+
action: WriteAction;
|
|
48
|
+
basis: string;
|
|
49
|
+
/** `skip` 为 null;其余为实际落库或被并入/晋升的记忆。 */
|
|
50
|
+
memory: MemoryRecord | null;
|
|
51
|
+
/** `merge` / `promote_candidate` 指向命中的既有记忆。 */
|
|
52
|
+
duplicateOf: string | null;
|
|
53
|
+
}
|
|
54
|
+
export interface CallerContext {
|
|
55
|
+
deviceId: string;
|
|
56
|
+
agentId: string;
|
|
57
|
+
/** user = 本地 CLI(数据主权者,全库可见);agent = MCP 调用方(受作用域约束)。 */
|
|
58
|
+
channel: 'user' | 'agent';
|
|
59
|
+
}
|
|
60
|
+
export interface MemoryDetail {
|
|
61
|
+
memory: MemoryRecord;
|
|
62
|
+
revisions: RevisionRecord[];
|
|
63
|
+
evidence: EvidenceRecord[];
|
|
64
|
+
relations: {
|
|
65
|
+
id: string;
|
|
66
|
+
fromMemoryId: string;
|
|
67
|
+
toMemoryId: string;
|
|
68
|
+
relationType: string;
|
|
69
|
+
}[];
|
|
70
|
+
openConflicts: {
|
|
71
|
+
id: string;
|
|
72
|
+
revisionAId: string;
|
|
73
|
+
revisionBId: string;
|
|
74
|
+
detectedAt: string;
|
|
75
|
+
}[];
|
|
76
|
+
tombstone: {
|
|
77
|
+
reason: string | null;
|
|
78
|
+
forgottenBy: string;
|
|
79
|
+
forgottenAt: string;
|
|
80
|
+
} | null;
|
|
81
|
+
scope: ScopeRow;
|
|
82
|
+
}
|
|
83
|
+
export interface DoctorReport {
|
|
84
|
+
ok: boolean;
|
|
85
|
+
home: string;
|
|
86
|
+
schemaVersion: number;
|
|
87
|
+
device: {
|
|
88
|
+
id: string;
|
|
89
|
+
enrollment: string;
|
|
90
|
+
cloned: boolean;
|
|
91
|
+
};
|
|
92
|
+
db: {
|
|
93
|
+
integrity: string;
|
|
94
|
+
foreignKeyViolations: number;
|
|
95
|
+
};
|
|
96
|
+
fts: {
|
|
97
|
+
ok: boolean;
|
|
98
|
+
note: string;
|
|
99
|
+
};
|
|
100
|
+
counts: {
|
|
101
|
+
memoryByStatus: Record<string, number>;
|
|
102
|
+
importArchives: number;
|
|
103
|
+
importItems: {
|
|
104
|
+
total: number;
|
|
105
|
+
clean: number;
|
|
106
|
+
blocked: number;
|
|
107
|
+
};
|
|
108
|
+
plansByStatus: Record<string, number>;
|
|
109
|
+
outboxByStatus: Record<string, number>;
|
|
110
|
+
openConflicts: number;
|
|
111
|
+
};
|
|
112
|
+
remote: 'not_configured' | 'configured_untested' | 'verified';
|
|
113
|
+
remoteProvider?: string;
|
|
114
|
+
model: 'not_configured';
|
|
115
|
+
problems: string[];
|
|
116
|
+
notes: string[];
|
|
117
|
+
}
|
|
118
|
+
export declare class AppService {
|
|
119
|
+
readonly store: CairnStore;
|
|
120
|
+
private constructor();
|
|
121
|
+
static open(home?: string): AppService;
|
|
122
|
+
close(): void;
|
|
123
|
+
get caller(): CallerContext;
|
|
124
|
+
resolveScope(sel: ScopeSelection | undefined): ScopeRow;
|
|
125
|
+
/**
|
|
126
|
+
* 显式写入。判断(`judgement`)是建议不是授权:它只能影响"这条值不值得记",
|
|
127
|
+
* 敏感度与作用域永远取自写入参数,不取自判断(design D10)。
|
|
128
|
+
*
|
|
129
|
+
* 查重在这里做,因为写入路径的重复不是判断出来的、是对比出来的。
|
|
130
|
+
*/
|
|
131
|
+
addMemory(input: AddMemoryInput, opts?: {
|
|
132
|
+
judgement?: Judgement | null;
|
|
133
|
+
}): AddMemoryOutcome;
|
|
134
|
+
reviseMemory(id: string, newContent: string, opts?: {
|
|
135
|
+
reason?: string;
|
|
136
|
+
expectedCurrentRevisionId?: string;
|
|
137
|
+
}): {
|
|
138
|
+
memory: MemoryRecord;
|
|
139
|
+
revision: RevisionRecord;
|
|
140
|
+
};
|
|
141
|
+
forgetMemory(id: string, reason: string | null): MemoryRecord;
|
|
142
|
+
archiveMemory(id: string): MemoryRecord;
|
|
143
|
+
showMemory(id: string): MemoryDetail;
|
|
144
|
+
/** MCP memory_propose:只生成候选,绝不静默成为高权威活动记忆(memory-governance spec)。 */
|
|
145
|
+
proposeCandidate(input: {
|
|
146
|
+
content: string;
|
|
147
|
+
kind?: MemoryKind;
|
|
148
|
+
evidence?: EvidenceInput[];
|
|
149
|
+
sourceSessionId?: string | null;
|
|
150
|
+
}): MemoryRecord;
|
|
151
|
+
search(input: SearchInput): SearchOutput;
|
|
152
|
+
export(input: ExportInput): ExportOutput;
|
|
153
|
+
findByContent(scopeId: string, text: string): MemoryRecord | null;
|
|
154
|
+
workerRunOnce(opts?: {
|
|
155
|
+
max?: number;
|
|
156
|
+
timeoutMs?: number;
|
|
157
|
+
}): Promise<RunOnceSummary>;
|
|
158
|
+
doctor(): DoctorReport;
|
|
159
|
+
vaultInitRemote(input: {
|
|
160
|
+
provider: 'obs' | 'syncd';
|
|
161
|
+
obs?: {
|
|
162
|
+
endpoint: string;
|
|
163
|
+
bucket: string;
|
|
164
|
+
prefix: string;
|
|
165
|
+
};
|
|
166
|
+
syncd?: {
|
|
167
|
+
baseUrl: string;
|
|
168
|
+
};
|
|
169
|
+
}): {
|
|
170
|
+
vault: ReturnType<typeof loadVaultConfig>;
|
|
171
|
+
recovery: string;
|
|
172
|
+
};
|
|
173
|
+
vaultStatus(): Record<string, unknown>;
|
|
174
|
+
vaultImportKey(recovery: string): void;
|
|
175
|
+
vaultExportKey(): string;
|
|
176
|
+
syncPushCmd(): Promise<unknown>;
|
|
177
|
+
syncPullCmd(): Promise<unknown>;
|
|
178
|
+
private requireSyncContext;
|
|
179
|
+
private markSyncOk;
|
|
180
|
+
status(): Record<string, unknown>;
|
|
181
|
+
/** 元数据发现:只列来源,不读正文(agent-onboarding spec)。 */
|
|
182
|
+
discover(opts: {
|
|
183
|
+
homeDir: string;
|
|
184
|
+
projectRoots?: string[];
|
|
185
|
+
}): Promise<SourceCandidate[]>;
|
|
186
|
+
/** 快照导入:不可变快照 + imported_unverified 档案,源文件不变,重复导入幂等。 */
|
|
187
|
+
importFromPath(input: {
|
|
188
|
+
sourcePath: string;
|
|
189
|
+
agentKind: string;
|
|
190
|
+
batchId?: string;
|
|
191
|
+
sourceKind?: ImportSourceKind;
|
|
192
|
+
}): Promise<{
|
|
193
|
+
outcome: ImportOutcome;
|
|
194
|
+
batchId: string;
|
|
195
|
+
}>;
|
|
196
|
+
/** 活跃批次:最后一个仍有待晋升条目的批次 id。 */
|
|
197
|
+
activeBatchId(): string | null;
|
|
198
|
+
batchStatus(batchId: string): BatchProgress;
|
|
199
|
+
batchChunk(batchId: string, limit: number): BatchChunkItem[];
|
|
200
|
+
/** 某批次的已跳过条目:出队但可查(本次变更的核心取舍)。 */
|
|
201
|
+
batchSkipped(batchId: string, limit?: number): SkippedItem[];
|
|
202
|
+
/** 由批次生成治理计划(Agent 建议 → 确定性管线),并标记对应条目来源。 */
|
|
203
|
+
proposeForBatch(input: {
|
|
204
|
+
batchId?: string;
|
|
205
|
+
items: ProposedItem[];
|
|
206
|
+
proposedBy: string;
|
|
207
|
+
scope?: ScopeSelection;
|
|
208
|
+
}): {
|
|
209
|
+
plan: PlanRecord;
|
|
210
|
+
planHash: string;
|
|
211
|
+
accepted: number;
|
|
212
|
+
rejected: {
|
|
213
|
+
itemId?: string;
|
|
214
|
+
reason: string;
|
|
215
|
+
findings: {
|
|
216
|
+
kind: string;
|
|
217
|
+
masked: string;
|
|
218
|
+
}[];
|
|
219
|
+
}[];
|
|
220
|
+
duplicates: {
|
|
221
|
+
itemId?: string;
|
|
222
|
+
duplicateOfMemoryId: string;
|
|
223
|
+
}[];
|
|
224
|
+
};
|
|
225
|
+
/** 本地可信审批通道(CLI approve / 控制台 webui):展示差异后由用户签发。 */
|
|
226
|
+
approve(planId: string, opts?: {
|
|
227
|
+
ttlMs?: number;
|
|
228
|
+
channel?: string;
|
|
229
|
+
}): {
|
|
230
|
+
approvalId: string;
|
|
231
|
+
expiresAt: string;
|
|
232
|
+
itemCount: number;
|
|
233
|
+
};
|
|
234
|
+
/** 应用治理计划(消费一次性审批),成功后把批次条目标记为已晋升。 */
|
|
235
|
+
applyPlan(planId: string, approvalId: string): {
|
|
236
|
+
report: ApplyReport;
|
|
237
|
+
batchId: string | null;
|
|
238
|
+
};
|
|
239
|
+
/** 计划差异预览(供 CLI approve 展示;不含正文的统计 + 每操作的类型/目标)。 */
|
|
240
|
+
planSummary(planId: string): unknown;
|
|
241
|
+
}
|
|
242
|
+
export { ExitCode };
|