@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,790 @@
1
+ #!/usr/bin/env node
2
+ import { AppService, ExitCode } from '../app-service.js';
3
+ import { CairnError, isCairnError } from '../../core/errors.js';
4
+ import { HOST_ADAPTERS, resolveDshHome, setDshProfile } from '../../agents/adapters.js';
5
+ import { planAgentConfig, applyAgentConfig, planSignature, doctorAgentConfig, uninstallAgentConfig, } from '../../agents/config.js';
6
+ import { backupDatabase, restoreFromBackup } from '../../store/backup.js';
7
+ import { openStore } from '../../store/open.js';
8
+ import { startConsoleServer } from '../console/server.js';
9
+ import { exportConsoleHtml, normalizePersonalName } from '../console/export.js';
10
+ import { readReviews, reviewPackForBatch, reviewSubmit } from '../console/review-store.js';
11
+ import { judgementFromFlags } from '../../onboarding/judgement.js';
12
+ import { loadPolicy, listPolicies, revokePolicy, signPolicy } from '../../onboarding/policy.js';
13
+ import { revokeByPolicy, runAutoOnboarding } from '../../onboarding/auto.js';
14
+ import { join } from 'node:path';
15
+ /** 取值型标志;其余 --flag 一律按布尔处理,避免吞掉位置参数。 */
16
+ const VALUE_FLAGS = new Set([
17
+ 'home', 'kind', 'scope', 'scope-id', 'project', 'project-name', 'agent', 'agent-id', 'ttl-days',
18
+ 'expires', 'status', 'limit', 'out', 'format', 'reason', 'host', 'home-root', 'project-root', 'dsh-profile', 'dsh-profile',
19
+ 'mode', 'plan-file', 'mcp-command', 'mcp-args', 'max', 'expected-revision', 'approval', 'ttl',
20
+ 'home-dir', 'agent-kind', 'source-kind', 'proposed-by', 'items-file', 'batch', 'provider',
21
+ 'endpoint', 'bucket', 'prefix', 'base-url', 'recovery-file', 'port', 'input', 'item', 'export',
22
+ 'policy', 'file', 'id', 'scopes', 'max-sensitivity', 'min-confidence', 'note', 'items',
23
+ ]);
24
+ function parseArgs(argv) {
25
+ const flags = {};
26
+ const positional = [];
27
+ for (let i = 0; i < argv.length; i++) {
28
+ const a = argv[i] ?? '';
29
+ if (a.startsWith('--')) {
30
+ const eq = a.indexOf('=');
31
+ if (eq > 0) {
32
+ flags[a.slice(2, eq)] = a.slice(eq + 1);
33
+ }
34
+ else {
35
+ const key = a.slice(2);
36
+ if (VALUE_FLAGS.has(key)) {
37
+ const next = argv[i + 1];
38
+ if (next != null && !next.startsWith('--')) {
39
+ flags[key] = next;
40
+ i++;
41
+ }
42
+ else {
43
+ flags[key] = true;
44
+ }
45
+ }
46
+ else {
47
+ flags[key] = true;
48
+ }
49
+ }
50
+ }
51
+ else {
52
+ positional.push(a);
53
+ }
54
+ }
55
+ return { flags, positional };
56
+ }
57
+ function throwUsage(message) {
58
+ throw new CairnError('E_VALIDATION', message);
59
+ }
60
+ function str(flags, key) {
61
+ const v = flags[key];
62
+ return typeof v === 'string' ? v : undefined;
63
+ }
64
+ function out(payload, flags) {
65
+ if (flags['json']) {
66
+ console.log(JSON.stringify(payload, null, 2));
67
+ }
68
+ else if (typeof payload === 'string') {
69
+ console.log(payload);
70
+ }
71
+ else {
72
+ console.log(JSON.stringify(payload, null, 2));
73
+ }
74
+ }
75
+ function diag(message) {
76
+ process.stderr.write(`[cairn] ${message}\n`);
77
+ }
78
+ function scopeSelectionFrom(flags) {
79
+ const preset = str(flags, 'scope');
80
+ if (!preset && !str(flags, 'scope-id'))
81
+ return undefined;
82
+ return {
83
+ preset,
84
+ scopeId: str(flags, 'scope-id'),
85
+ projectId: str(flags, 'project'),
86
+ projectName: str(flags, 'project-name'),
87
+ agentId: str(flags, 'agent'),
88
+ ttlDays: flags['ttl-days'] != null ? Number(flags['ttl-days']) : undefined,
89
+ };
90
+ }
91
+ const AGENT_KINDS = Object.keys(HOST_ADAPTERS);
92
+ async function main() {
93
+ const argv = process.argv.slice(2);
94
+ const { flags, positional } = parseArgs(argv);
95
+ const command = positional[0] ?? 'help';
96
+ const args = positional.slice(1);
97
+ const home = str(flags, 'home');
98
+ if (str(flags, 'agent-id')) {
99
+ process.env['CAIRN_AGENT_ID'] = str(flags, 'agent-id');
100
+ }
101
+ const json = flags['json'] === true;
102
+ // 不需要打开 store 的命令
103
+ if (command === 'help' || flags['help'] === true) {
104
+ out(HELP, flags);
105
+ return;
106
+ }
107
+ // ui 全程只读:连 AppService 都不打开,确保"只看一眼"在数据目录层面零写入。
108
+ if (command === 'ui') {
109
+ await runUi(flags, home);
110
+ return;
111
+ }
112
+ const service = AppService.open(home);
113
+ try {
114
+ switch (command) {
115
+ case 'init': {
116
+ const d = service.doctor();
117
+ out({ initialized: true, home: d.home, device: d.device.id, schemaVersion: d.schemaVersion, problems: d.problems }, flags);
118
+ diag('数据目录就绪。下一步:cairn add "..." 或 cairn discover 查看可导入来源。');
119
+ break;
120
+ }
121
+ case 'add': {
122
+ const content = args.join(' ');
123
+ if (!content)
124
+ throw new CairnError('E_VALIDATION', '用法: cairn add "内容" [--kind fact] [--scope ...] [--judgement keep|skip|merge_into:<id> --confidence high|medium|low --rationale "..."] [--dedupe merge|keep_both]');
125
+ const r = service.addMemory({
126
+ content,
127
+ kind: str(flags, 'kind'),
128
+ sensitivity: flags['sensitive'] === true ? 'sensitive' : 'normal',
129
+ expiresAt: str(flags, 'expires') ?? null,
130
+ scope: scopeSelectionFrom(flags),
131
+ }, { judgement: judgementFromFlags(flags) });
132
+ if (r.action === 'skip') {
133
+ out({ skipped: true, basis: r.basis, note: '按判断未写入;判断是建议,需要写入可去掉 --judgement skip' }, flags);
134
+ break;
135
+ }
136
+ const m = r.memory;
137
+ out({
138
+ id: m.id,
139
+ status: m.status,
140
+ authority: m.authority,
141
+ kind: m.kind,
142
+ scopeId: m.scopeId,
143
+ action: r.action,
144
+ basis: r.basis,
145
+ duplicateOf: r.duplicateOf,
146
+ }, flags);
147
+ break;
148
+ }
149
+ case 'search': {
150
+ const text = args.join(' ');
151
+ if (!text)
152
+ throw new CairnError('E_VALIDATION', '用法: cairn search "关键词"');
153
+ const includeExpired = flags['include-expired'] === true;
154
+ const statuses = str(flags, 'status') ? [str(flags, 'status')] : undefined;
155
+ const scopeId = str(flags, 'scope-id');
156
+ const r = service.search({
157
+ text,
158
+ query: { deviceId: service.caller.deviceId, agentId: service.caller.agentId, projectId: str(flags, 'project') ?? null },
159
+ scopeIds: scopeId ? [scopeId] : undefined,
160
+ statuses,
161
+ includeExpired,
162
+ limit: flags['limit'] != null ? Number(flags['limit']) : undefined,
163
+ });
164
+ if (json) {
165
+ out(r, flags);
166
+ }
167
+ else {
168
+ diag(`matchedBy=${r.matchedBy}${r.degraded ? ' (degraded)' : ''} 共 ${r.results.length} 条`);
169
+ for (const hit of r.results) {
170
+ const tags = [
171
+ hit.memory.status,
172
+ hit.memory.authority,
173
+ hit.unverifiableImport ? 'imported_unverified' : null,
174
+ hit.expired ? 'expired' : null,
175
+ hit.conflictId ? `conflict:${hit.conflictId.slice(0, 8)}` : null,
176
+ ].filter(Boolean).join(',');
177
+ console.log(`- [${hit.memory.id.slice(0, 8)}] (${tags}) ${hit.memory.content.slice(0, 120)}`);
178
+ }
179
+ }
180
+ break;
181
+ }
182
+ case 'show': {
183
+ if (!args[0])
184
+ throw new CairnError('E_VALIDATION', '用法: cairn show <id>');
185
+ out(service.showMemory(args[0]), flags);
186
+ break;
187
+ }
188
+ case 'forget': {
189
+ if (!args[0])
190
+ throw new CairnError('E_VALIDATION', '用法: cairn forget <id> [--reason "..."]');
191
+ const m = service.forgetMemory(args[0], str(flags, 'reason') ?? null);
192
+ out({ id: m.id, status: m.status }, flags);
193
+ break;
194
+ }
195
+ case 'archive': {
196
+ if (!args[0])
197
+ throw new CairnError('E_VALIDATION', '用法: cairn archive <id>');
198
+ const m = service.archiveMemory(args[0]);
199
+ out({ id: m.id, status: m.status }, flags);
200
+ break;
201
+ }
202
+ case 'update': {
203
+ const id = args[0];
204
+ const content = args.slice(1).join(' ');
205
+ if (!id || !content)
206
+ throw new CairnError('E_VALIDATION', '用法: cairn update <id> "新内容"');
207
+ const r = service.reviseMemory(id, content, { reason: str(flags, 'reason'), expectedCurrentRevisionId: str(flags, 'expected-revision') });
208
+ out({ id: r.memory.id, revisionId: r.revision.id, seq: r.revision.seq, status: r.memory.status }, flags);
209
+ break;
210
+ }
211
+ case 'export': {
212
+ const r = service.export({
213
+ query: { deviceId: service.caller.deviceId, agentId: service.caller.agentId, projectId: str(flags, 'project') ?? null },
214
+ scopeIds: str(flags, 'scope-id') ? [str(flags, 'scope-id')] : undefined,
215
+ format: str(flags, 'format') ?? 'json',
216
+ includeArchives: flags['include-archives'] === true,
217
+ });
218
+ const outFile = str(flags, 'out');
219
+ if (outFile) {
220
+ const { writeFileSync } = await import('node:fs');
221
+ writeFileSync(outFile, r.payload, 'utf8');
222
+ out({ written: outFile, counts: r.counts }, flags);
223
+ }
224
+ else if (json) {
225
+ // payload 本身就是文档文本;--json 下原样输出(避免双重编码)
226
+ console.log(r.payload);
227
+ }
228
+ else {
229
+ out(r.payload, flags);
230
+ }
231
+ break;
232
+ }
233
+ case 'backup': {
234
+ const target = str(flags, 'out') ?? join(service.store.paths.backupsDir, `cairn-backup-${Date.now()}.db`);
235
+ const b = backupDatabase(service.store.db, target);
236
+ out(b, flags);
237
+ break;
238
+ }
239
+ case 'restore': {
240
+ const backupPath = args[0];
241
+ if (!backupPath)
242
+ throw new CairnError('E_VALIDATION', '用法: cairn restore <backup.db> [--home <dir>]');
243
+ service.close();
244
+ const { resolvePaths } = await import('../../store/open.js');
245
+ const paths = resolvePaths(home ?? (process.env['CAIRN_HOME'] ?? ''));
246
+ restoreFromBackup(backupPath, paths.dbPath);
247
+ out({ restored: true, dbPath: paths.dbPath }, flags);
248
+ return;
249
+ }
250
+ case 'doctor': {
251
+ const d = service.doctor();
252
+ if (str(flags, 'host')) {
253
+ const agentKind = str(flags, 'host');
254
+ const dr = await doctorAgentConfig(service.store, {
255
+ agentKind,
256
+ homeRoot: str(flags, 'home-root') ?? home ?? service.store.paths.home,
257
+ projectRoot: str(flags, 'project-root') ?? process.cwd(),
258
+ });
259
+ out({ ...d, agent: dr }, flags);
260
+ }
261
+ else {
262
+ out(d, flags);
263
+ }
264
+ break;
265
+ }
266
+ case 'worker': {
267
+ const sub = args[0] ?? 'run-once';
268
+ if (sub !== 'run-once')
269
+ throw new CairnError('E_VALIDATION', '用法: cairn worker run-once [--max N]');
270
+ const s = await service.workerRunOnce({ max: flags['max'] != null ? Number(flags['max']) : undefined });
271
+ out(s, flags);
272
+ break;
273
+ }
274
+ case 'status': {
275
+ out(service.status(), flags);
276
+ break;
277
+ }
278
+ case 'vault': {
279
+ const sub = args[0];
280
+ if (sub === 'init-remote') {
281
+ const provider = str(flags, 'provider');
282
+ if (provider !== 'obs' && provider !== 'syncd')
283
+ throw new CairnError('E_VALIDATION', '用法: cairn vault init-remote --provider obs|syncd [--endpoint URL --bucket B --prefix cairn/] [--base-url URL]');
284
+ const r = service.vaultInitRemote({
285
+ provider,
286
+ obs: provider === 'obs' ? {
287
+ endpoint: str(flags, 'endpoint') ?? 'https://obs.cn-east-3.myhuaweicloud.com',
288
+ bucket: str(flags, 'bucket') ?? throwUsage('--bucket 必填'),
289
+ prefix: str(flags, 'prefix') ?? 'cairn/',
290
+ } : undefined,
291
+ syncd: provider === 'syncd' ? { baseUrl: str(flags, 'base-url') ?? throwUsage('--base-url 必填') } : undefined,
292
+ });
293
+ out({ vaultId: r.vault.vaultId, provider: r.vault.provider, recovery: r.recovery, warning: '恢复材料请抄写到安全位置;密钥丢失 = 云端数据不可恢复' }, flags);
294
+ }
295
+ else if (sub === 'status') {
296
+ out(service.vaultStatus(), flags);
297
+ }
298
+ else if (sub === 'import-key') {
299
+ const file = str(flags, 'recovery-file');
300
+ if (!file)
301
+ throw new CairnError('E_VALIDATION', '用法: cairn vault import-key --recovery-file <material.txt>');
302
+ const { readFileSync } = await import('node:fs');
303
+ service.vaultImportKey(readFileSync(file, 'utf8').trim());
304
+ out({ imported: true }, flags);
305
+ }
306
+ else if (sub === 'export-key') {
307
+ const recovery = service.vaultExportKey();
308
+ out({ recovery, warning: '不要提交到任何仓库或发送给他人;密钥丢失 = 云端数据不可恢复' }, flags);
309
+ }
310
+ else {
311
+ throw new CairnError('E_VALIDATION', '用法: cairn vault init-remote|status|export-key');
312
+ }
313
+ break;
314
+ }
315
+ case 'sync': {
316
+ const sub = args[0];
317
+ if (sub === 'push') {
318
+ const r = await service.syncPushCmd();
319
+ out(r ?? { pushed: false, note: '没有待上行任务' }, flags);
320
+ }
321
+ else if (sub === 'pull') {
322
+ out(await service.syncPullCmd(), flags);
323
+ }
324
+ else {
325
+ throw new CairnError('E_VALIDATION', '用法: cairn sync push|pull');
326
+ }
327
+ break;
328
+ }
329
+ case 'device': {
330
+ const sub = args[0] ?? 'status';
331
+ if (sub === 're-enroll') {
332
+ const r = service.store.reEnroll();
333
+ out({ newDeviceId: r.identity.deviceId, oldDeviceId: r.old.deviceId, note: '旧身份已暂停;新身份已注册并恢复写入' }, flags);
334
+ }
335
+ else if (sub === 'status') {
336
+ out({ deviceId: service.store.identity.deviceId, ...service.store.cloneCheck }, flags);
337
+ }
338
+ else {
339
+ throw new CairnError('E_VALIDATION', '用法: cairn device status | device re-enroll');
340
+ }
341
+ break;
342
+ }
343
+ case 'agent': {
344
+ const sub = args[0];
345
+ const agentKind = str(flags, 'host');
346
+ if (sub === 'apply') {
347
+ const planFile = str(flags, 'plan-file');
348
+ if (!planFile)
349
+ throw new CairnError('E_VALIDATION', '用法: cairn agent apply --plan-file <plan.json>(plan 命令的完整 JSON 输出,含 signature)');
350
+ const { readFileSync } = await import('node:fs');
351
+ const parsed = JSON.parse(readFileSync(planFile, 'utf8'));
352
+ const r = await applyAgentConfig(service.store, { plan: parsed.plan, signature: parsed.signature });
353
+ out(r, flags);
354
+ break;
355
+ }
356
+ if (!agentKind || !AGENT_KINDS.includes(agentKind)) {
357
+ throw new CairnError('E_VALIDATION', `用法: cairn agent plan|doctor|uninstall --host ${AGENT_KINDS.join('|')},或 agent apply --plan-file <file>`);
358
+ }
359
+ // DSH 的数据根与用户主目录是两个概念:显式 --home-root → DSH_HOME → 报错(不回退 ~/.dsh)。
360
+ setDshProfile(str(flags, 'dsh-profile') ?? null);
361
+ const homeRoot = agentKind === 'dsh'
362
+ ? resolveDshHome(str(flags, 'home-root') ?? home)
363
+ : (str(flags, 'home-root') ?? home ?? service.store.paths.home);
364
+ const projectRoot = str(flags, 'project-root') ?? process.cwd();
365
+ const mode = (str(flags, 'mode') ?? 'router');
366
+ if (sub === 'plan') {
367
+ const plan = await planAgentConfig(service.store, {
368
+ agentKind, homeRoot, projectRoot, mode,
369
+ mcpCommand: flags['mcp-command'] ? { command: str(flags, 'mcp-command'), args: (str(flags, 'mcp-args') ?? '').split(' ').filter(Boolean) } : undefined,
370
+ });
371
+ out({ plan, signature: planSignature(plan) }, flags);
372
+ }
373
+ else if (sub === 'doctor') {
374
+ out(await doctorAgentConfig(service.store, { agentKind, homeRoot, projectRoot }), flags);
375
+ }
376
+ else if (sub === 'uninstall') {
377
+ out(await uninstallAgentConfig(service.store, { agentKind, homeRoot, projectRoot }), flags);
378
+ }
379
+ else {
380
+ throw new CairnError('E_VALIDATION', '用法: cairn agent plan|apply|doctor|uninstall');
381
+ }
382
+ break;
383
+ }
384
+ case 'uninstall': {
385
+ // 全局卸载:只移除本产品安装记录对应的宿主条目;数据库保留(由用户另行决定)
386
+ const results = [];
387
+ for (const kind of AGENT_KINDS) {
388
+ const r = await uninstallAgentConfig(service.store, {
389
+ agentKind: kind,
390
+ homeRoot: str(flags, 'home-root') ?? home ?? service.store.paths.home,
391
+ projectRoot: str(flags, 'project-root') ?? process.cwd(),
392
+ });
393
+ results.push({ host: kind, ...r });
394
+ }
395
+ out({ removed: results, database: '已保留;如需删除请手动移除数据目录(可先 cairn export 备份)' }, flags);
396
+ break;
397
+ }
398
+ case 'review': {
399
+ const sub = args[0] ?? 'list';
400
+ if (sub === 'pack') {
401
+ const r = reviewPackForBatch(service.store, {
402
+ batchId: str(flags, 'batch'),
403
+ outFile: str(flags, 'out'),
404
+ });
405
+ out(r, flags);
406
+ diag(`复核包已写入 ${r.outFile}`);
407
+ diag('下一步:把该文件交给当前 Agent 会话逐条判断,产出 { runId, items:[{itemId,action,reason,targetMemoryId}] },再 cairn review submit --input <file>');
408
+ diag('注意:这一步会把条目正文交给模型读取;范围与字符量见上面的 itemCount / totalChars。');
409
+ }
410
+ else if (sub === 'submit') {
411
+ const input = str(flags, 'input');
412
+ if (!input)
413
+ throw new CairnError('E_VALIDATION', '用法: cairn review submit --input <reviews.json>({ items: [...] })');
414
+ const { readFileSync } = await import('node:fs');
415
+ const parsed = JSON.parse(readFileSync(input, 'utf8'));
416
+ const items = Array.isArray(parsed.items) ? parsed.items : Array.isArray(parsed) ? parsed : [];
417
+ const r = reviewSubmit(service.store, {
418
+ items,
419
+ producer: str(flags, 'proposed-by') ?? 'cli',
420
+ model: parsed.model ?? null,
421
+ runId: parsed.runId,
422
+ });
423
+ out(r, flags);
424
+ }
425
+ else if (sub === 'list') {
426
+ out(readReviews(service.store, { batchId: str(flags, 'batch'), itemId: str(flags, 'item') }), flags);
427
+ }
428
+ else {
429
+ throw new CairnError('E_VALIDATION', '用法: cairn review pack|submit|list [--batch] [--out] [--input]');
430
+ }
431
+ break;
432
+ }
433
+ case 'discover': {
434
+ const homeDir = str(flags, 'home-dir') ?? home ?? service.store.paths.home;
435
+ const projectRoots = str(flags, 'project-root') ? [str(flags, 'project-root')] : undefined;
436
+ const sources = await service.discover({ homeDir, projectRoots });
437
+ out(sources, flags);
438
+ diag(`发现 ${sources.length} 个来源(仅元数据,未读取任何正文)。`);
439
+ break;
440
+ }
441
+ case 'import': {
442
+ const paths = args;
443
+ if (paths.length === 0)
444
+ throw new CairnError('E_VALIDATION', '用法: cairn import <文件...> [--agent-kind claude-code]');
445
+ const agentKind = str(flags, 'agent-kind') ?? 'manual';
446
+ const results = [];
447
+ let lastBatch = null;
448
+ for (const p of paths) {
449
+ const r = await service.importFromPath({ sourcePath: p, agentKind, sourceKind: str(flags, 'source-kind') ?? 'markdown' });
450
+ lastBatch = r.batchId;
451
+ results.push({ source: p, ...r.outcome });
452
+ }
453
+ out({ imported: results, batchId: lastBatch }, flags);
454
+ diag(`已建立本地档案(imported_unverified + local_only,不上行)。后续: cairn onboarding next --batch ${lastBatch}`);
455
+ break;
456
+ }
457
+ case 'onboarding': {
458
+ const sub = args[0] ?? 'status';
459
+ const batchId = str(flags, 'batch') ?? service.activeBatchId();
460
+ if (sub === 'status') {
461
+ if (!batchId) {
462
+ out({ activeBatch: null, note: '没有待整理批次' }, flags);
463
+ }
464
+ else {
465
+ out({ ...service.batchStatus(batchId) }, flags);
466
+ }
467
+ }
468
+ else if (sub === 'next') {
469
+ if (!batchId)
470
+ throw new CairnError('E_VALIDATION', '没有待整理批次;请先 cairn import');
471
+ const chunk = service.batchChunk(batchId, flags['limit'] != null ? Number(flags['limit']) : 10);
472
+ out({ batchId, items: chunk }, flags);
473
+ diag('把以下条目交给当前 Agent 生成 add/merge/keep_both/skip 建议,然后 cairn plan create。');
474
+ }
475
+ else if (sub === 'auto') {
476
+ const policyId = str(flags, 'policy');
477
+ if (!policyId) {
478
+ throw new CairnError('E_VALIDATION', '用法: cairn onboarding auto --policy <id> [--batch <id>] [--scope ...] [--dry-run] [--redo] [--items a,b]');
479
+ }
480
+ const itemList = str(flags, 'items');
481
+ const r = runAutoOnboarding(service.store, {
482
+ policyId,
483
+ batchId: str(flags, 'batch'),
484
+ scope: scopeSelectionFrom(flags),
485
+ dryRun: flags['dry-run'] === true,
486
+ // --redo:已晋升的条目也重新判;--items:只处理点名的几条(同样视为显式重做)。
487
+ redo: flags['redo'] === true,
488
+ itemIds: itemList != null ? itemList.split(',').map((s) => s.trim()).filter((s) => s.length > 0) : undefined,
489
+ });
490
+ out(r, flags);
491
+ diag(`策略 ${r.policyId}(${r.policyHashPrefix}):自动 ${r.auto} 条 / 人工 ${r.manual} 条;` +
492
+ `应用 ${r.applied}、跳过 ${r.skipped}、失败 ${r.failed}`);
493
+ if (r.dryRun)
494
+ diag('这是 dry-run:没有写入任何记忆。去掉 --dry-run 才会真正应用。');
495
+ if (!r.balanced) {
496
+ throw new CairnError('E_INTERNAL', `汇总不自洽:applied ${r.applied} + skipped ${r.skipped} + failed ${r.failed} + manual ${r.manual} ≠ total ${r.totalItems}`);
497
+ }
498
+ if (r.applied === 0 && r.skipped > 0 && r.failed === 0) {
499
+ diag('全部跳过:通常是内容已全部在库中(已并入或已存在),这是正常结局;要重新判一遍加 --redo。');
500
+ }
501
+ if (r.manual > 0) {
502
+ const top = Object.entries(r.byCondition).sort((a, b) => b[1] - a[1]).slice(0, 3);
503
+ diag(`转人工的首要原因:${top.map(([k, v]) => `${k} ${v} 条`).join('、') || '无'}(用 cairn ui 查看明细)`);
504
+ }
505
+ }
506
+ else if (sub === 'skipped') {
507
+ // 已跳过的条目:从待处理队列出队,但仍可查(本次变更的核心取舍)。
508
+ if (!batchId)
509
+ throw new CairnError('E_VALIDATION', '没有批次;请用 --batch <id> 指定');
510
+ const limit = flags['limit'] != null ? Number(flags['limit']) : 200;
511
+ const items = service.batchSkipped(batchId, limit);
512
+ out({ batchId, count: items.length, items }, flags);
513
+ diag('这些条目已判为不采用,不再计入待处理;要用新结论重判,加 --redo 重新整理。');
514
+ }
515
+ else if (sub === 'revoke') {
516
+ // 撤销"结果"与撤销"授权"是两件事:
517
+ // policy revoke → 这把钥匙作废,不能再用于未来的自动整理
518
+ // onboarding revoke → 把已经写进去的记忆转墓碑,回滚这次整理
519
+ const policyId = str(flags, 'policy') ?? args[1];
520
+ if (!policyId) {
521
+ throw new CairnError('E_VALIDATION', '用法: cairn onboarding revoke --policy <id> [--batch <id>]');
522
+ }
523
+ const r = revokeByPolicy(service.store, policyId, { batchId: str(flags, 'batch') });
524
+ out(r, flags);
525
+ diag(`已撤销 ${r.tombstoned} 条记忆(转墓碑,不物理删除,修订与来源仍在)。撤销是粘的:普通重跑不会把它们写回来,要重做须 --redo。`);
526
+ }
527
+ else {
528
+ throw new CairnError('E_VALIDATION', '用法: cairn onboarding status|next|auto|skipped|revoke [--batch <id>] [--policy <id>] [--dry-run] [--redo]');
529
+ }
530
+ break;
531
+ }
532
+ case 'policy': {
533
+ const sub = args[0] ?? 'list';
534
+ if (sub === 'sign') {
535
+ const file = str(flags, 'file');
536
+ let raw;
537
+ if (file) {
538
+ const { readFileSync } = await import('node:fs');
539
+ raw = JSON.parse(readFileSync(file, 'utf8'));
540
+ }
541
+ else {
542
+ const id = str(flags, 'id');
543
+ if (!id) {
544
+ throw new CairnError('E_VALIDATION', '用法: cairn policy sign --file <policy.json> [--force];或 cairn policy sign --id <名字> --scopes a,b [--max-sensitivity normal|sensitive] [--min-confidence 0-1] [--allow-create] [--require-ai-agreement] [--note 备注] [--force]');
545
+ }
546
+ // 命令行拼装时保持保守默认:不新建、不因"没判断"就放行。
547
+ raw = {
548
+ id,
549
+ allowedScopes: (str(flags, 'scopes') ?? '').split(',').map((x) => x.trim()).filter(Boolean),
550
+ maxSensitivity: str(flags, 'max-sensitivity') ?? 'normal',
551
+ requireAiAgreement: flags['require-ai-agreement'] === true,
552
+ allowCreate: flags['allow-create'] === true,
553
+ minConfidence: flags['min-confidence'] != null ? Number(str(flags, 'min-confidence')) : 0.6,
554
+ note: str(flags, 'note') ?? '',
555
+ };
556
+ }
557
+ const signed = signPolicy(service.store.paths.home, raw, { via: 'cli', force: flags['force'] === true });
558
+ out({ id: signed.spec.id, policyHash: signed.policyHash, signedAt: signed.signedAt, via: signed.signedVia, spec: signed.spec }, flags);
559
+ diag(`策略 ${signed.spec.id} 已签发,哈希 ${signed.policyHash.slice(0, 8)}。改动策略内容后必须重新签发。`);
560
+ }
561
+ else if (sub === 'list') {
562
+ out(listPolicies(service.store.paths.home), flags);
563
+ }
564
+ else if (sub === 'show') {
565
+ const id = args[1] ?? str(flags, 'id');
566
+ if (!id)
567
+ throw new CairnError('E_VALIDATION', '用法: cairn policy show <id>');
568
+ out(loadPolicy(service.store.paths.home, id), flags);
569
+ }
570
+ else if (sub === 'revoke') {
571
+ const id = args[1] ?? str(flags, 'id');
572
+ if (!id)
573
+ throw new CairnError('E_VALIDATION', '用法: cairn policy revoke <id>');
574
+ const r = revokePolicy(service.store.paths.home, id);
575
+ out({ id: r.spec.id, revokedAt: r.revokedAt }, flags);
576
+ diag(`策略 ${id} 已撤销:这把钥匙不能再用于 onboarding auto;它已经写进去的记忆不受影响,要回滚结果请用 cairn onboarding revoke --policy ${id}。`);
577
+ }
578
+ else {
579
+ throw new CairnError('E_VALIDATION', '用法: cairn policy sign|list|show|revoke');
580
+ }
581
+ break;
582
+ }
583
+ case 'plan': {
584
+ const sub = args[0];
585
+ if (sub === 'create') {
586
+ const itemsFile = str(flags, 'items-file');
587
+ if (!itemsFile)
588
+ throw new CairnError('E_VALIDATION', '用法: cairn plan create --items-file <items.json>(ProposedItem 数组)');
589
+ const { readFileSync } = await import('node:fs');
590
+ const items = JSON.parse(readFileSync(itemsFile, 'utf8'));
591
+ const r = service.proposeForBatch({ batchId: str(flags, 'batch'), items, proposedBy: str(flags, 'proposed-by') ?? 'cli' });
592
+ out(r, flags);
593
+ diag(`计划 ${r.plan.id} 已创建(awaiting_approval)。请审阅后执行: cairn approve ${r.plan.id}`);
594
+ }
595
+ else if (sub === 'show' || sub === 'list') {
596
+ if (sub === 'show') {
597
+ if (!args[1])
598
+ throw new CairnError('E_VALIDATION', '用法: cairn plan show <plan-id>');
599
+ out(service.planSummary(args[1]), flags);
600
+ }
601
+ else {
602
+ const rows = service.store.db.all("SELECT id, status, item_count AS itemCount, created_at AS createdAt FROM onboarding_plan ORDER BY created_at DESC LIMIT 20");
603
+ out(rows, flags);
604
+ }
605
+ }
606
+ else {
607
+ throw new CairnError('E_VALIDATION', '用法: cairn plan create|show|list');
608
+ }
609
+ break;
610
+ }
611
+ case 'approve': {
612
+ if (!args[0])
613
+ throw new CairnError('E_VALIDATION', '用法: cairn approve <plan-id>');
614
+ const summary = service.planSummary(args[0]);
615
+ diag(`计划状态: ${summary.plan.status},操作统计: ${JSON.stringify(summary.counts)}`);
616
+ diag('批准即签发一次性、30 分钟有效的 approval_id;计划此后任何变化都会使其失效。');
617
+ const r = service.approve(args[0], { ttlMs: flags['ttl'] != null ? Number(flags['ttl']) * 1000 : undefined });
618
+ out(r, flags);
619
+ diag(`应用: cairn apply ${args[0]} --approval ${r.approvalId}`);
620
+ break;
621
+ }
622
+ case 'apply': {
623
+ const planId = args[0];
624
+ const approvalId = str(flags, 'approval');
625
+ if (!planId || !approvalId)
626
+ throw new CairnError('E_VALIDATION', '用法: cairn apply <plan-id> --approval <approval-id>');
627
+ const r = service.applyPlan(planId, approvalId);
628
+ out(r, flags);
629
+ break;
630
+ }
631
+ default:
632
+ throw new CairnError('E_VALIDATION', `未知命令: ${command}(见 cairn help)`);
633
+ }
634
+ }
635
+ finally {
636
+ service.close();
637
+ }
638
+ }
639
+ /**
640
+ * `cairn ui`:只读打开。全流程不构造 AppService,因此"只看一眼"不会写 meta/device。
641
+ *
642
+ * 两种形态共用同一套装配层与前端资源,差异只在传输方式:
643
+ * - 默认:回环 HTTP 服务(工作台,可审批/同步);
644
+ * - `--export`:单文件 HTML(预览,纯只读,可双击打开或离线分享)。
645
+ */
646
+ async function runUi(flags, home) {
647
+ const exportTarget = str(flags, 'export');
648
+ const redact = flags['redact'] === true;
649
+ if (exportTarget != null) {
650
+ const store = openStore({ home, readOnly: true });
651
+ try {
652
+ const outFile = normalizePersonalName(exportTarget);
653
+ const r = exportConsoleHtml(store, { outFile, redact });
654
+ out({
655
+ written: r.outFile,
656
+ bytes: r.bytes,
657
+ counts: r.counts,
658
+ redacted: r.redacted,
659
+ degradedItems: r.degradedItems,
660
+ warnings: r.warnings,
661
+ }, flags);
662
+ // 三层告知的第 3 层:stdout。前两层是文件名后缀与文件头警示。
663
+ if (!r.redacted) {
664
+ diag(`产物含明文本地记忆(${r.counts.memories} 条记忆 / ${r.counts.items} 条快照条目,${r.bytes} 字节):请勿外传;需要外发请加 --redact。`);
665
+ }
666
+ else {
667
+ diag('已按 --redact 输出:sensitive 记忆正文已掩码。');
668
+ }
669
+ for (const w of r.warnings)
670
+ diag(w);
671
+ }
672
+ finally {
673
+ store.close();
674
+ }
675
+ return;
676
+ }
677
+ const portFlag = str(flags, 'port');
678
+ const port = portFlag != null ? Number(portFlag) : undefined;
679
+ if (port != null && (!Number.isInteger(port) || port < 0 || port > 65535)) {
680
+ throw new CairnError('E_VALIDATION', '--port 必须是 0-65535 的整数');
681
+ }
682
+ const handle = await startConsoleServer({ home, port });
683
+ if (flags['json'] === true) {
684
+ console.log(JSON.stringify({ url: handle.url, tokenUrl: handle.tokenUrl, port: handle.port, host: handle.host }, null, 2));
685
+ }
686
+ else {
687
+ console.log(`控制台已启动:${handle.tokenUrl}`);
688
+ console.log('令牌随进程一次性有效;按 Ctrl+C 停止服务。');
689
+ }
690
+ const noOpen = flags['no-open'] === true;
691
+ if (!noOpen)
692
+ openBrowser(handle.tokenUrl);
693
+ await new Promise((resolve) => {
694
+ const stop = () => {
695
+ process.off('SIGINT', stop);
696
+ process.off('SIGTERM', stop);
697
+ void handle.close().then(() => resolve());
698
+ };
699
+ process.on('SIGINT', stop);
700
+ process.on('SIGTERM', stop);
701
+ });
702
+ }
703
+ /** best-effort 打开浏览器:失败不影响服务可用,用户可复制 stdout 里的 URL。 */
704
+ function openBrowser(url) {
705
+ void (async () => {
706
+ try {
707
+ const { spawn } = await import('node:child_process');
708
+ const cmd = process.platform === 'win32' ? 'cmd' : process.platform === 'darwin' ? 'open' : 'xdg-open';
709
+ const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
710
+ const child = spawn(cmd, args, { detached: true, stdio: 'ignore', windowsHide: true });
711
+ child.on('error', () => {
712
+ /* 无浏览器环境:URL 已在 stdout */
713
+ });
714
+ child.unref();
715
+ }
716
+ catch {
717
+ /* 同上 */
718
+ }
719
+ })();
720
+ }
721
+ const HELP = `Cairn — 个人、多设备、多 Agent 的本地优先记忆主权层
722
+
723
+ 用法: cairn <command> [args] [options]
724
+
725
+ 命令:
726
+ init 初始化数据目录并执行首次体检
727
+ discover 元数据发现(不读正文) [--home-dir] [--project-root]
728
+ import <文件...> 不可变快照导入(imported_unverified + local_only) [--agent-kind]
729
+ onboarding status|next|auto 分批进度与待整理条目 [--batch] [--limit]
730
+ skipped: 查看已跳过条目(出队但可查)[--batch] [--limit]
731
+ auto: 按已签发策略自动整理 [--policy <id>] [--dry-run] [--redo] [--items a,b]
732
+ revoke: 回滚某策略写进去的记忆(转墓碑)[--policy <id>] [--batch <id>]
733
+ add "内容" 显式新增记忆 [--kind] [--scope] [--project] [--sensitive]
734
+ [--judgement keep|skip|merge_into:<id> --confidence --rationale]
735
+ search "关键词" 作用域约束检索 [--status] [--scope-id] [--include-expired]
736
+ show <id> 记忆详情(修订/证据/冲突)
737
+ update <id> "新内容" 用户更正(新修订,历史保留)
738
+ forget <id> 遗忘(可审计 tombstone) [--reason]
739
+ archive <id> 归档
740
+ export 导出 [--format json|markdown] [--out FILE] [--include-archives]
741
+ plan create|show|list 治理计划(create 需 --items-file,零写入)
742
+ approve <plan-id> 本地签发一次性审批(绑定 plan_hash,30 分钟有效)
743
+ apply <plan-id> --approval X 消费审批并幂等应用计划
744
+ review pack|submit|list 双层建议的复核包与写回 [--batch] [--out] [--input]
745
+ policy sign|list|show|revoke 自动整理策略(签发只在终端或本机控制台)[--file] [--id] [--force]
746
+ ui 只读控制台(回环 HTTP;端口默认 7767,占用则随机)
747
+ [--port N] [--no-open] [--export <file.html>] [--redact]
748
+ vault init-remote|status|export-key|import-key 云同步 vault(OBS / 自建 syncd)
749
+ sync push|pull 加密同步上行 / 下行(详见 docs/cairn-sync.md)
750
+ backup / restore 一致性备份与恢复
751
+ doctor 健康检查 [--host <agent>](诚实分级,无模型无云端核心可用)
752
+ status 库状态摘要
753
+ worker run-once 处理一轮后台任务 [--max N](默认不安装任何 hook)
754
+ device status|re-enroll 设备身份与克隆恢复
755
+ agent plan|apply|doctor|uninstall --host <agent> 宿主配置管理(plan 零写入);--host dsh 用于 DeepSeek Harness(Cordis 插件树,可加 --dsh-profile)
756
+ uninstall 移除所有本产品宿主配置(数据库保留)
757
+
758
+ 全局选项:
759
+ --home <dir> 数据目录(默认 ~/.cairn;测试用 CAIRN_HOME)
760
+ --json 机器可读输出(stdout 仅结果;诊断走 stderr)
761
+ --agent-id <id> 调用方 Agent 身份(默认 cli)
762
+
763
+ 退出码: 0 成功; 1 故障; 2 用法/校验; 3 被治理拒绝; 4 状态冲突; 5 环境不可用`;
764
+ export async function runCli() {
765
+ try {
766
+ await main();
767
+ }
768
+ catch (e) {
769
+ if (isCairnError(e)) {
770
+ if (process.argv.includes('--json')) {
771
+ console.log(JSON.stringify({ error: e.toJSON() }, null, 2));
772
+ }
773
+ else {
774
+ process.stderr.write(`[cairn] ${e.message}\n`);
775
+ if (e.details)
776
+ process.stderr.write(`[cairn] 详情: ${JSON.stringify(e.details)}\n`);
777
+ }
778
+ process.exitCode = e.exitCode;
779
+ }
780
+ else {
781
+ process.stderr.write(`[cairn] 未预期错误: ${e.stack ?? String(e)}\n`);
782
+ process.exitCode = ExitCode.failure;
783
+ }
784
+ }
785
+ }
786
+ // 直接执行时运行(被测试导入时不自动执行)
787
+ if (process.argv[1] != null && /cli[\\/]main\.(js|ts)$/.test(process.argv[1].replace(/\\/g, '/'))) {
788
+ void runCli();
789
+ }
790
+ //# sourceMappingURL=main.js.map