@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.
Files changed (222) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +158 -2
  4. package/dist/src/agents/adapters.d.ts +82 -0
  5. package/dist/src/agents/adapters.js +209 -0
  6. package/dist/src/agents/adapters.js.map +1 -0
  7. package/dist/src/agents/config.d.ts +82 -0
  8. package/dist/src/agents/config.js +603 -0
  9. package/dist/src/agents/config.js.map +1 -0
  10. package/dist/src/agents/cordisPatch.d.ts +89 -0
  11. package/dist/src/agents/cordisPatch.js +201 -0
  12. package/dist/src/agents/cordisPatch.js.map +1 -0
  13. package/dist/src/agents/index.d.ts +2 -0
  14. package/dist/src/agents/index.js +3 -0
  15. package/dist/src/agents/index.js.map +1 -0
  16. package/dist/src/core/errors.d.ts +36 -0
  17. package/dist/src/core/errors.js +74 -0
  18. package/dist/src/core/errors.js.map +1 -0
  19. package/dist/src/core/hash.d.ts +14 -0
  20. package/dist/src/core/hash.js +48 -0
  21. package/dist/src/core/hash.js.map +1 -0
  22. package/dist/src/core/ids.d.ts +10 -0
  23. package/dist/src/core/ids.js +41 -0
  24. package/dist/src/core/ids.js.map +1 -0
  25. package/dist/src/core/index.d.ts +6 -0
  26. package/dist/src/core/index.js +7 -0
  27. package/dist/src/core/index.js.map +1 -0
  28. package/dist/src/core/scope.d.ts +78 -0
  29. package/dist/src/core/scope.js +181 -0
  30. package/dist/src/core/scope.js.map +1 -0
  31. package/dist/src/core/secrets.d.ts +13 -0
  32. package/dist/src/core/secrets.js +122 -0
  33. package/dist/src/core/secrets.js.map +1 -0
  34. package/dist/src/core/time.d.ts +7 -0
  35. package/dist/src/core/time.js +18 -0
  36. package/dist/src/core/time.js.map +1 -0
  37. package/dist/src/core/types.d.ts +133 -0
  38. package/dist/src/core/types.js +30 -0
  39. package/dist/src/core/types.js.map +1 -0
  40. package/dist/src/governance/apply.d.ts +64 -0
  41. package/dist/src/governance/apply.js +160 -0
  42. package/dist/src/governance/apply.js.map +1 -0
  43. package/dist/src/governance/dedup.d.ts +21 -0
  44. package/dist/src/governance/dedup.js +23 -0
  45. package/dist/src/governance/dedup.js.map +1 -0
  46. package/dist/src/governance/index.d.ts +16 -0
  47. package/dist/src/governance/index.js +17 -0
  48. package/dist/src/governance/index.js.map +1 -0
  49. package/dist/src/governance/propose.d.ts +78 -0
  50. package/dist/src/governance/propose.js +150 -0
  51. package/dist/src/governance/propose.js.map +1 -0
  52. package/dist/src/index.d.ts +15 -0
  53. package/dist/src/index.js +24 -0
  54. package/dist/src/index.js.map +1 -0
  55. package/dist/src/interfaces/app-service.d.ts +242 -0
  56. package/dist/src/interfaces/app-service.js +614 -0
  57. package/dist/src/interfaces/app-service.js.map +1 -0
  58. package/dist/src/interfaces/cli/main.d.ts +2 -0
  59. package/dist/src/interfaces/cli/main.js +790 -0
  60. package/dist/src/interfaces/cli/main.js.map +1 -0
  61. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  62. package/dist/src/interfaces/console/assets/page.js +39 -0
  63. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  65. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  66. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  68. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  69. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  71. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  72. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  73. package/dist/src/interfaces/console/export.d.ts +46 -0
  74. package/dist/src/interfaces/console/export.js +84 -0
  75. package/dist/src/interfaces/console/export.js.map +1 -0
  76. package/dist/src/interfaces/console/model.d.ts +372 -0
  77. package/dist/src/interfaces/console/model.js +731 -0
  78. package/dist/src/interfaces/console/model.js.map +1 -0
  79. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  80. package/dist/src/interfaces/console/review-store.js +342 -0
  81. package/dist/src/interfaces/console/review-store.js.map +1 -0
  82. package/dist/src/interfaces/console/security.d.ts +76 -0
  83. package/dist/src/interfaces/console/security.js +105 -0
  84. package/dist/src/interfaces/console/security.js.map +1 -0
  85. package/dist/src/interfaces/console/server.d.ts +45 -0
  86. package/dist/src/interfaces/console/server.js +476 -0
  87. package/dist/src/interfaces/console/server.js.map +1 -0
  88. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  89. package/dist/src/interfaces/console/suggestions.js +511 -0
  90. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  91. package/dist/src/interfaces/console/text.d.ts +4 -0
  92. package/dist/src/interfaces/console/text.js +18 -0
  93. package/dist/src/interfaces/console/text.js.map +1 -0
  94. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  95. package/dist/src/interfaces/mcp/server.js +412 -0
  96. package/dist/src/interfaces/mcp/server.js.map +1 -0
  97. package/dist/src/jobs/index.d.ts +6 -0
  98. package/dist/src/jobs/index.js +7 -0
  99. package/dist/src/jobs/index.js.map +1 -0
  100. package/dist/src/jobs/remote.d.ts +42 -0
  101. package/dist/src/jobs/remote.js +34 -0
  102. package/dist/src/jobs/remote.js.map +1 -0
  103. package/dist/src/jobs/worker.d.ts +67 -0
  104. package/dist/src/jobs/worker.js +169 -0
  105. package/dist/src/jobs/worker.js.map +1 -0
  106. package/dist/src/onboarding/auto.d.ts +88 -0
  107. package/dist/src/onboarding/auto.js +399 -0
  108. package/dist/src/onboarding/auto.js.map +1 -0
  109. package/dist/src/onboarding/batches.d.ts +103 -0
  110. package/dist/src/onboarding/batches.js +219 -0
  111. package/dist/src/onboarding/batches.js.map +1 -0
  112. package/dist/src/onboarding/discover.d.ts +54 -0
  113. package/dist/src/onboarding/discover.js +369 -0
  114. package/dist/src/onboarding/discover.js.map +1 -0
  115. package/dist/src/onboarding/import.d.ts +69 -0
  116. package/dist/src/onboarding/import.js +279 -0
  117. package/dist/src/onboarding/import.js.map +1 -0
  118. package/dist/src/onboarding/index.d.ts +24 -0
  119. package/dist/src/onboarding/index.js +22 -0
  120. package/dist/src/onboarding/index.js.map +1 -0
  121. package/dist/src/onboarding/judgement.d.ts +50 -0
  122. package/dist/src/onboarding/judgement.js +121 -0
  123. package/dist/src/onboarding/judgement.js.map +1 -0
  124. package/dist/src/onboarding/policy.d.ts +86 -0
  125. package/dist/src/onboarding/policy.js +249 -0
  126. package/dist/src/onboarding/policy.js.map +1 -0
  127. package/dist/src/projection/brief.d.ts +77 -0
  128. package/dist/src/projection/brief.js +111 -0
  129. package/dist/src/projection/brief.js.map +1 -0
  130. package/dist/src/projection/index.d.ts +1 -0
  131. package/dist/src/projection/index.js +2 -0
  132. package/dist/src/projection/index.js.map +1 -0
  133. package/dist/src/projection/markdown.d.ts +82 -0
  134. package/dist/src/projection/markdown.js +313 -0
  135. package/dist/src/projection/markdown.js.map +1 -0
  136. package/dist/src/retrieval/export.d.ts +80 -0
  137. package/dist/src/retrieval/export.js +215 -0
  138. package/dist/src/retrieval/export.js.map +1 -0
  139. package/dist/src/retrieval/index.d.ts +5 -0
  140. package/dist/src/retrieval/index.js +6 -0
  141. package/dist/src/retrieval/index.js.map +1 -0
  142. package/dist/src/retrieval/search.d.ts +37 -0
  143. package/dist/src/retrieval/search.js +294 -0
  144. package/dist/src/retrieval/search.js.map +1 -0
  145. package/dist/src/store/archives.d.ts +94 -0
  146. package/dist/src/store/archives.js +135 -0
  147. package/dist/src/store/archives.js.map +1 -0
  148. package/dist/src/store/audit.d.ts +26 -0
  149. package/dist/src/store/audit.js +48 -0
  150. package/dist/src/store/audit.js.map +1 -0
  151. package/dist/src/store/backup.d.ts +36 -0
  152. package/dist/src/store/backup.js +90 -0
  153. package/dist/src/store/backup.js.map +1 -0
  154. package/dist/src/store/blocks.d.ts +64 -0
  155. package/dist/src/store/blocks.js +104 -0
  156. package/dist/src/store/blocks.js.map +1 -0
  157. package/dist/src/store/conflicts.d.ts +52 -0
  158. package/dist/src/store/conflicts.js +112 -0
  159. package/dist/src/store/conflicts.js.map +1 -0
  160. package/dist/src/store/db.d.ts +44 -0
  161. package/dist/src/store/db.js +162 -0
  162. package/dist/src/store/db.js.map +1 -0
  163. package/dist/src/store/device.d.ts +46 -0
  164. package/dist/src/store/device.js +111 -0
  165. package/dist/src/store/device.js.map +1 -0
  166. package/dist/src/store/index.d.ts +14 -0
  167. package/dist/src/store/index.js +15 -0
  168. package/dist/src/store/index.js.map +1 -0
  169. package/dist/src/store/memories.d.ts +101 -0
  170. package/dist/src/store/memories.js +378 -0
  171. package/dist/src/store/memories.js.map +1 -0
  172. package/dist/src/store/migrate.d.ts +32 -0
  173. package/dist/src/store/migrate.js +86 -0
  174. package/dist/src/store/migrate.js.map +1 -0
  175. package/dist/src/store/open.d.ts +53 -0
  176. package/dist/src/store/open.js +177 -0
  177. package/dist/src/store/open.js.map +1 -0
  178. package/dist/src/store/outbox.d.ts +65 -0
  179. package/dist/src/store/outbox.js +137 -0
  180. package/dist/src/store/outbox.js.map +1 -0
  181. package/dist/src/store/plans.d.ts +137 -0
  182. package/dist/src/store/plans.js +243 -0
  183. package/dist/src/store/plans.js.map +1 -0
  184. package/dist/src/store/schema.d.ts +34 -0
  185. package/dist/src/store/schema.js +527 -0
  186. package/dist/src/store/schema.js.map +1 -0
  187. package/dist/src/store/scopes.d.ts +44 -0
  188. package/dist/src/store/scopes.js +220 -0
  189. package/dist/src/store/scopes.js.map +1 -0
  190. package/dist/src/store/write-guard.d.ts +10 -0
  191. package/dist/src/store/write-guard.js +10 -0
  192. package/dist/src/store/write-guard.js.map +1 -0
  193. package/dist/src/sync/apply.d.ts +24 -0
  194. package/dist/src/sync/apply.js +130 -0
  195. package/dist/src/sync/apply.js.map +1 -0
  196. package/dist/src/sync/cryptoutil.d.ts +86 -0
  197. package/dist/src/sync/cryptoutil.js +339 -0
  198. package/dist/src/sync/cryptoutil.js.map +1 -0
  199. package/dist/src/sync/events.d.ts +69 -0
  200. package/dist/src/sync/events.js +78 -0
  201. package/dist/src/sync/events.js.map +1 -0
  202. package/dist/src/sync/obs-store.d.ts +41 -0
  203. package/dist/src/sync/obs-store.js +325 -0
  204. package/dist/src/sync/obs-store.js.map +1 -0
  205. package/dist/src/sync/orchestrate.d.ts +37 -0
  206. package/dist/src/sync/orchestrate.js +84 -0
  207. package/dist/src/sync/orchestrate.js.map +1 -0
  208. package/dist/src/sync/pull.d.ts +24 -0
  209. package/dist/src/sync/pull.js +150 -0
  210. package/dist/src/sync/pull.js.map +1 -0
  211. package/dist/src/sync/push.d.ts +19 -0
  212. package/dist/src/sync/push.js +227 -0
  213. package/dist/src/sync/push.js.map +1 -0
  214. package/dist/src/sync/syncd-store.d.ts +31 -0
  215. package/dist/src/sync/syncd-store.js +92 -0
  216. package/dist/src/sync/syncd-store.js.map +1 -0
  217. package/dist/src/sync/vault.d.ts +37 -0
  218. package/dist/src/sync/vault.js +53 -0
  219. package/dist/src/sync/vault.js.map +1 -0
  220. package/docs/cairn-security.md +254 -0
  221. package/docs/cairn-usage.md +821 -0
  222. 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 };