@carloswon/cairn-memory 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +81 -0
- package/LICENSE +21 -0
- package/README.md +158 -2
- package/dist/src/agents/adapters.d.ts +82 -0
- package/dist/src/agents/adapters.js +209 -0
- package/dist/src/agents/adapters.js.map +1 -0
- package/dist/src/agents/config.d.ts +82 -0
- package/dist/src/agents/config.js +603 -0
- package/dist/src/agents/config.js.map +1 -0
- package/dist/src/agents/cordisPatch.d.ts +89 -0
- package/dist/src/agents/cordisPatch.js +201 -0
- package/dist/src/agents/cordisPatch.js.map +1 -0
- package/dist/src/agents/index.d.ts +2 -0
- package/dist/src/agents/index.js +3 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/core/errors.d.ts +36 -0
- package/dist/src/core/errors.js +74 -0
- package/dist/src/core/errors.js.map +1 -0
- package/dist/src/core/hash.d.ts +14 -0
- package/dist/src/core/hash.js +48 -0
- package/dist/src/core/hash.js.map +1 -0
- package/dist/src/core/ids.d.ts +10 -0
- package/dist/src/core/ids.js +41 -0
- package/dist/src/core/ids.js.map +1 -0
- package/dist/src/core/index.d.ts +6 -0
- package/dist/src/core/index.js +7 -0
- package/dist/src/core/index.js.map +1 -0
- package/dist/src/core/scope.d.ts +78 -0
- package/dist/src/core/scope.js +181 -0
- package/dist/src/core/scope.js.map +1 -0
- package/dist/src/core/secrets.d.ts +13 -0
- package/dist/src/core/secrets.js +122 -0
- package/dist/src/core/secrets.js.map +1 -0
- package/dist/src/core/time.d.ts +7 -0
- package/dist/src/core/time.js +18 -0
- package/dist/src/core/time.js.map +1 -0
- package/dist/src/core/types.d.ts +139 -0
- package/dist/src/core/types.js +30 -0
- package/dist/src/core/types.js.map +1 -0
- package/dist/src/governance/apply.d.ts +64 -0
- package/dist/src/governance/apply.js +160 -0
- package/dist/src/governance/apply.js.map +1 -0
- package/dist/src/governance/archive.d.ts +29 -0
- package/dist/src/governance/archive.js +52 -0
- package/dist/src/governance/archive.js.map +1 -0
- package/dist/src/governance/dedup.d.ts +21 -0
- package/dist/src/governance/dedup.js +23 -0
- package/dist/src/governance/dedup.js.map +1 -0
- package/dist/src/governance/index.d.ts +16 -0
- package/dist/src/governance/index.js +17 -0
- package/dist/src/governance/index.js.map +1 -0
- package/dist/src/governance/propose.d.ts +78 -0
- package/dist/src/governance/propose.js +150 -0
- package/dist/src/governance/propose.js.map +1 -0
- package/dist/src/index.d.ts +15 -0
- package/dist/src/index.js +24 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/interfaces/app-service.d.ts +292 -0
- package/dist/src/interfaces/app-service.js +743 -0
- package/dist/src/interfaces/app-service.js.map +1 -0
- package/dist/src/interfaces/cli/main.d.ts +2 -0
- package/dist/src/interfaces/cli/main.js +854 -0
- package/dist/src/interfaces/cli/main.js.map +1 -0
- package/dist/src/interfaces/console/assets/page.d.ts +18 -0
- package/dist/src/interfaces/console/assets/page.js +39 -0
- package/dist/src/interfaces/console/assets/page.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
- package/dist/src/interfaces/console/assets/ui-css.js +119 -0
- package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
- package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
- package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
- package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
- package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
- package/dist/src/interfaces/console/assets/url-state.js +45 -0
- package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
- package/dist/src/interfaces/console/export.d.ts +46 -0
- package/dist/src/interfaces/console/export.js +84 -0
- package/dist/src/interfaces/console/export.js.map +1 -0
- package/dist/src/interfaces/console/model.d.ts +372 -0
- package/dist/src/interfaces/console/model.js +731 -0
- package/dist/src/interfaces/console/model.js.map +1 -0
- package/dist/src/interfaces/console/review-store.d.ts +142 -0
- package/dist/src/interfaces/console/review-store.js +342 -0
- package/dist/src/interfaces/console/review-store.js.map +1 -0
- package/dist/src/interfaces/console/security.d.ts +76 -0
- package/dist/src/interfaces/console/security.js +105 -0
- package/dist/src/interfaces/console/security.js.map +1 -0
- package/dist/src/interfaces/console/server.d.ts +45 -0
- package/dist/src/interfaces/console/server.js +476 -0
- package/dist/src/interfaces/console/server.js.map +1 -0
- package/dist/src/interfaces/console/suggestions.d.ts +112 -0
- package/dist/src/interfaces/console/suggestions.js +511 -0
- package/dist/src/interfaces/console/suggestions.js.map +1 -0
- package/dist/src/interfaces/console/text.d.ts +4 -0
- package/dist/src/interfaces/console/text.js +18 -0
- package/dist/src/interfaces/console/text.js.map +1 -0
- package/dist/src/interfaces/mcp/server.d.ts +4 -0
- package/dist/src/interfaces/mcp/server.js +480 -0
- package/dist/src/interfaces/mcp/server.js.map +1 -0
- package/dist/src/jobs/index.d.ts +6 -0
- package/dist/src/jobs/index.js +7 -0
- package/dist/src/jobs/index.js.map +1 -0
- package/dist/src/jobs/remote.d.ts +42 -0
- package/dist/src/jobs/remote.js +34 -0
- package/dist/src/jobs/remote.js.map +1 -0
- package/dist/src/jobs/worker.d.ts +67 -0
- package/dist/src/jobs/worker.js +169 -0
- package/dist/src/jobs/worker.js.map +1 -0
- package/dist/src/onboarding/auto.d.ts +88 -0
- package/dist/src/onboarding/auto.js +399 -0
- package/dist/src/onboarding/auto.js.map +1 -0
- package/dist/src/onboarding/batches.d.ts +103 -0
- package/dist/src/onboarding/batches.js +219 -0
- package/dist/src/onboarding/batches.js.map +1 -0
- package/dist/src/onboarding/discover.d.ts +54 -0
- package/dist/src/onboarding/discover.js +369 -0
- package/dist/src/onboarding/discover.js.map +1 -0
- package/dist/src/onboarding/import.d.ts +69 -0
- package/dist/src/onboarding/import.js +279 -0
- package/dist/src/onboarding/import.js.map +1 -0
- package/dist/src/onboarding/index.d.ts +24 -0
- package/dist/src/onboarding/index.js +22 -0
- package/dist/src/onboarding/index.js.map +1 -0
- package/dist/src/onboarding/judgement.d.ts +50 -0
- package/dist/src/onboarding/judgement.js +121 -0
- package/dist/src/onboarding/judgement.js.map +1 -0
- package/dist/src/onboarding/policy.d.ts +86 -0
- package/dist/src/onboarding/policy.js +249 -0
- package/dist/src/onboarding/policy.js.map +1 -0
- package/dist/src/projection/brief.d.ts +112 -0
- package/dist/src/projection/brief.js +200 -0
- package/dist/src/projection/brief.js.map +1 -0
- package/dist/src/projection/index.d.ts +1 -0
- package/dist/src/projection/index.js +2 -0
- package/dist/src/projection/index.js.map +1 -0
- package/dist/src/projection/markdown.d.ts +82 -0
- package/dist/src/projection/markdown.js +313 -0
- package/dist/src/projection/markdown.js.map +1 -0
- package/dist/src/retrieval/export.d.ts +80 -0
- package/dist/src/retrieval/export.js +215 -0
- package/dist/src/retrieval/export.js.map +1 -0
- package/dist/src/retrieval/index.d.ts +5 -0
- package/dist/src/retrieval/index.js +6 -0
- package/dist/src/retrieval/index.js.map +1 -0
- package/dist/src/retrieval/search.d.ts +37 -0
- package/dist/src/retrieval/search.js +294 -0
- package/dist/src/retrieval/search.js.map +1 -0
- package/dist/src/store/archives.d.ts +94 -0
- package/dist/src/store/archives.js +135 -0
- package/dist/src/store/archives.js.map +1 -0
- package/dist/src/store/audit.d.ts +57 -0
- package/dist/src/store/audit.js +131 -0
- package/dist/src/store/audit.js.map +1 -0
- package/dist/src/store/backup.d.ts +36 -0
- package/dist/src/store/backup.js +90 -0
- package/dist/src/store/backup.js.map +1 -0
- package/dist/src/store/blocks.d.ts +64 -0
- package/dist/src/store/blocks.js +104 -0
- package/dist/src/store/blocks.js.map +1 -0
- package/dist/src/store/conflicts.d.ts +52 -0
- package/dist/src/store/conflicts.js +112 -0
- package/dist/src/store/conflicts.js.map +1 -0
- package/dist/src/store/db.d.ts +44 -0
- package/dist/src/store/db.js +162 -0
- package/dist/src/store/db.js.map +1 -0
- package/dist/src/store/device.d.ts +46 -0
- package/dist/src/store/device.js +111 -0
- package/dist/src/store/device.js.map +1 -0
- package/dist/src/store/index.d.ts +14 -0
- package/dist/src/store/index.js +15 -0
- package/dist/src/store/index.js.map +1 -0
- package/dist/src/store/memories.d.ts +133 -0
- package/dist/src/store/memories.js +442 -0
- package/dist/src/store/memories.js.map +1 -0
- package/dist/src/store/migrate.d.ts +32 -0
- package/dist/src/store/migrate.js +87 -0
- package/dist/src/store/migrate.js.map +1 -0
- package/dist/src/store/open.d.ts +53 -0
- package/dist/src/store/open.js +203 -0
- package/dist/src/store/open.js.map +1 -0
- package/dist/src/store/outbox.d.ts +65 -0
- package/dist/src/store/outbox.js +137 -0
- package/dist/src/store/outbox.js.map +1 -0
- package/dist/src/store/plans.d.ts +137 -0
- package/dist/src/store/plans.js +243 -0
- package/dist/src/store/plans.js.map +1 -0
- package/dist/src/store/schema.d.ts +46 -0
- package/dist/src/store/schema.js +544 -0
- package/dist/src/store/schema.js.map +1 -0
- package/dist/src/store/scopes.d.ts +44 -0
- package/dist/src/store/scopes.js +220 -0
- package/dist/src/store/scopes.js.map +1 -0
- package/dist/src/store/write-guard.d.ts +10 -0
- package/dist/src/store/write-guard.js +10 -0
- package/dist/src/store/write-guard.js.map +1 -0
- package/dist/src/sync/apply.d.ts +24 -0
- package/dist/src/sync/apply.js +130 -0
- package/dist/src/sync/apply.js.map +1 -0
- package/dist/src/sync/cryptoutil.d.ts +86 -0
- package/dist/src/sync/cryptoutil.js +339 -0
- package/dist/src/sync/cryptoutil.js.map +1 -0
- package/dist/src/sync/events.d.ts +69 -0
- package/dist/src/sync/events.js +78 -0
- package/dist/src/sync/events.js.map +1 -0
- package/dist/src/sync/obs-store.d.ts +41 -0
- package/dist/src/sync/obs-store.js +325 -0
- package/dist/src/sync/obs-store.js.map +1 -0
- package/dist/src/sync/orchestrate.d.ts +37 -0
- package/dist/src/sync/orchestrate.js +84 -0
- package/dist/src/sync/orchestrate.js.map +1 -0
- package/dist/src/sync/pull.d.ts +24 -0
- package/dist/src/sync/pull.js +150 -0
- package/dist/src/sync/pull.js.map +1 -0
- package/dist/src/sync/push.d.ts +19 -0
- package/dist/src/sync/push.js +227 -0
- package/dist/src/sync/push.js.map +1 -0
- package/dist/src/sync/syncd-store.d.ts +31 -0
- package/dist/src/sync/syncd-store.js +92 -0
- package/dist/src/sync/syncd-store.js.map +1 -0
- package/dist/src/sync/vault.d.ts +37 -0
- package/dist/src/sync/vault.js +53 -0
- package/dist/src/sync/vault.js.map +1 -0
- package/docs/cairn-security.md +267 -0
- package/docs/cairn-usage.md +919 -0
- package/package.json +71 -4
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
|
|
2
|
+
import { homedir } from 'node:os';
|
|
3
|
+
/** 掩码占位符:稳定、不可逆、能看出"这里原本有内容"。 */
|
|
4
|
+
export const MASK_CHAR = '•';
|
|
5
|
+
export function contentView(text, opts = {}) {
|
|
6
|
+
const length = text.length;
|
|
7
|
+
const hashPrefix = (opts.hash ?? hashOf(text)).slice(0, 12);
|
|
8
|
+
if (opts.masked === true) {
|
|
9
|
+
return { masked: true, text: null, length, hashPrefix, truncated: false };
|
|
10
|
+
}
|
|
11
|
+
const max = opts.maxChars ?? 0;
|
|
12
|
+
if (max > 0 && length > max) {
|
|
13
|
+
return { masked: false, text: text.slice(0, max), length, hashPrefix, truncated: true };
|
|
14
|
+
}
|
|
15
|
+
return { masked: false, text, length, hashPrefix, truncated: false };
|
|
16
|
+
}
|
|
17
|
+
/** 掩码块的可读形式(HTML 渲染与 stdout 提示共用)。 */
|
|
18
|
+
export function maskBlock(view) {
|
|
19
|
+
return `${MASK_CHAR.repeat(Math.min(12, Math.max(3, Math.ceil(view.length / 40))))} (${view.length} 字符, #${view.hashPrefix})`;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* 来源标识脱敏:把本机绝对路径折叠成 ~ 相对形式。
|
|
23
|
+
* 目的是不泄漏用户名与目录结构,不是隐藏"它来自哪个文件"。
|
|
24
|
+
*/
|
|
25
|
+
export function sanitizeLabel(label) {
|
|
26
|
+
if (label == null)
|
|
27
|
+
return null;
|
|
28
|
+
let out = label;
|
|
29
|
+
const home = homedir();
|
|
30
|
+
if (home && home.length > 2) {
|
|
31
|
+
out = out.split(home).join('~');
|
|
32
|
+
out = out.split(home.replace(/\\/g, '/')).join('~');
|
|
33
|
+
}
|
|
34
|
+
// 兜底:任何残留的 x:\Users\<name> 或 /home/<name> 形式
|
|
35
|
+
out = out.replace(/[A-Za-z]:\\Users\\[^\\/]+/g, '~');
|
|
36
|
+
out = out.replace(/\/home\/[^/]+/g, '~');
|
|
37
|
+
out = out.replace(/\/Users\/[^/]+/g, '~');
|
|
38
|
+
return out;
|
|
39
|
+
}
|
|
40
|
+
/** 路径型字段的导出脱敏:与 sanitizeLabel 同义,语义化别名供 D8 使用。 */
|
|
41
|
+
export const sanitizePath = sanitizeLabel;
|
|
42
|
+
/** 会话令牌:256 位随机,十六进制。一次性(进程生命周期)。 */
|
|
43
|
+
export function newToken() {
|
|
44
|
+
return randomBytes(32).toString('hex');
|
|
45
|
+
}
|
|
46
|
+
/** 定长时间比较,避免按字节提前返回泄漏令牌前缀。 */
|
|
47
|
+
export function tokenEquals(a, b) {
|
|
48
|
+
if (typeof a !== 'string' || typeof b !== 'string')
|
|
49
|
+
return false;
|
|
50
|
+
const ba = Buffer.from(a, 'utf8');
|
|
51
|
+
const bb = Buffer.from(b, 'utf8');
|
|
52
|
+
if (ba.length !== bb.length)
|
|
53
|
+
return false;
|
|
54
|
+
return timingSafeEqual(ba, bb);
|
|
55
|
+
}
|
|
56
|
+
const SAFE_METHODS = new Set(['GET', 'HEAD']);
|
|
57
|
+
/**
|
|
58
|
+
* 请求守卫。判定顺序刻意固定:Host → Origin → 令牌,
|
|
59
|
+
* 这样"非回环 Host"永远不会先被令牌校验掩盖,诊断信息稳定可复现。
|
|
60
|
+
*/
|
|
61
|
+
export function guardRequest(input, policy) {
|
|
62
|
+
const host = (input.host ?? '').toLowerCase();
|
|
63
|
+
if (!policy.allowedHosts.map((h) => h.toLowerCase()).includes(host)) {
|
|
64
|
+
return { ok: false, status: 403, reason: 'host_not_allowed' };
|
|
65
|
+
}
|
|
66
|
+
const fetchSite = (input.secFetchSite ?? '').toLowerCase();
|
|
67
|
+
if (fetchSite === 'cross-site') {
|
|
68
|
+
return { ok: false, status: 403, reason: 'cross_site_blocked' };
|
|
69
|
+
}
|
|
70
|
+
if (input.origin != null && input.origin.length > 0) {
|
|
71
|
+
const origin = input.origin.toLowerCase();
|
|
72
|
+
if (!policy.allowedOrigins.map((o) => o.toLowerCase()).includes(origin)) {
|
|
73
|
+
return { ok: false, status: 403, reason: 'origin_not_allowed' };
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
if (!SAFE_METHODS.has(input.method.toUpperCase())) {
|
|
77
|
+
// 写方法必须带 Origin 或至少不能缺失令牌;缺令牌一律 401。
|
|
78
|
+
if (!tokenEquals(input.token, policy.token)) {
|
|
79
|
+
return { ok: false, status: 401, reason: 'token_missing_or_invalid' };
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
else if (!tokenEquals(input.token, policy.token)) {
|
|
83
|
+
// 读也需要令牌:否则同机任意页面可 dragnet 全库。
|
|
84
|
+
return { ok: false, status: 401, reason: 'token_missing_or_invalid' };
|
|
85
|
+
}
|
|
86
|
+
return { ok: true };
|
|
87
|
+
}
|
|
88
|
+
/** 响应头:不缓存 + 不嗅探 + 禁止被嵌入 + 严格 CSP(内联资源需 'unsafe-inline')。 */
|
|
89
|
+
export function baseHeaders(contentType) {
|
|
90
|
+
return {
|
|
91
|
+
'Content-Type': contentType,
|
|
92
|
+
'Cache-Control': 'no-store, no-cache, must-revalidate, max-age=0',
|
|
93
|
+
Pragma: 'no-cache',
|
|
94
|
+
'X-Content-Type-Options': 'nosniff',
|
|
95
|
+
'X-Frame-Options': 'DENY',
|
|
96
|
+
'Referrer-Policy': 'no-referrer',
|
|
97
|
+
'Content-Security-Policy': "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-ancestors 'none'",
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
/** 写操作额外要求的头集合(配合 guardRequest 使用)。 */
|
|
101
|
+
export const WRITE_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
|
|
102
|
+
function hashOf(text) {
|
|
103
|
+
return createHash('sha256').update(text, 'utf8').digest('hex');
|
|
104
|
+
}
|
|
105
|
+
//# sourceMappingURL=security.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../../src/interfaces/console/security.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { CairnStore } from '../../store/open.js';
|
|
2
|
+
import { ProposedItem } from '../../governance/propose.js';
|
|
3
|
+
/**
|
|
4
|
+
* 本地回环控制台服务(design D2/D3/D6)。
|
|
5
|
+
*
|
|
6
|
+
* 三条硬约束:
|
|
7
|
+
* 1. 只绑 127.0.0.1;不提供 --host 之类的放开开关。
|
|
8
|
+
* 2. 读路径使用独立的**只读连接**(`openStore({ readOnly: true })`),
|
|
9
|
+
* 仓储层的写守卫会把任何误写拒为 E_READONLY。写路由才惰性打开可写服务,
|
|
10
|
+
* 因此"只浏览"这个动作在数据目录层面确实零写入。
|
|
11
|
+
* 3. 日志只记方法、路径(去掉 query,防止令牌进日志)与状态码,绝不记正文。
|
|
12
|
+
*/
|
|
13
|
+
export interface ConsoleServerOptions {
|
|
14
|
+
home?: string;
|
|
15
|
+
/** 0 = 让系统分配;默认先试 7767,占用则回退随机。 */
|
|
16
|
+
port?: number;
|
|
17
|
+
/** 测试注入固定令牌;生产一律随机。 */
|
|
18
|
+
token?: string;
|
|
19
|
+
/** 页面上显示的警示横幅。 */
|
|
20
|
+
banners?: string[];
|
|
21
|
+
}
|
|
22
|
+
export interface ConsoleServerHandle {
|
|
23
|
+
url: string;
|
|
24
|
+
/** 带令牌的完整 URL(打印给用户的那一行)。 */
|
|
25
|
+
tokenUrl: string;
|
|
26
|
+
token: string;
|
|
27
|
+
port: number;
|
|
28
|
+
host: string;
|
|
29
|
+
close(): Promise<void>;
|
|
30
|
+
}
|
|
31
|
+
export declare function startConsoleServer(opts?: ConsoleServerOptions): Promise<ConsoleServerHandle>;
|
|
32
|
+
/** CLI 退出码语义 → HTTP 状态码。E_NOT_FOUND 单独抬到 404,不跟着 failure 走 500。 */
|
|
33
|
+
export declare function statusForError(e: unknown): number;
|
|
34
|
+
/**
|
|
35
|
+
* 把页面提交的草稿归一化成计划候选(design D5)。
|
|
36
|
+
*
|
|
37
|
+
* 页面**不回传正文**:摘要模式下它手里根本没有全文,短文模式回传也只是多一次
|
|
38
|
+
* 搬运与一次被篡改的机会。所以这里按 `itemId` 从 import_item 取权威原文,
|
|
39
|
+
* 页面只表达"我对哪条、想做什么动作"。
|
|
40
|
+
*
|
|
41
|
+
* 动作词表也不同:页面用面向人的 promote/merge/keep_both/skip,
|
|
42
|
+
* 计划层用 opHint 的 add/merge/keep_both/skip。转换集中在这一处,
|
|
43
|
+
* 免得两边各写一遍、然后某一侧悄悄少了一个动作。
|
|
44
|
+
*/
|
|
45
|
+
export declare function normalizeProposedItems(store: CairnStore, raw: Record<string, unknown>[]): ProposedItem[];
|
|
@@ -0,0 +1,476 @@
|
|
|
1
|
+
import { createServer } from 'node:http';
|
|
2
|
+
import { existsSync } from 'node:fs';
|
|
3
|
+
import { AppService } from '../app-service.js';
|
|
4
|
+
import { defaultHome, openStore, resolvePaths } from '../../store/open.js';
|
|
5
|
+
import { CairnError, err, exitCodeFor, isCairnError } from '../../core/errors.js';
|
|
6
|
+
import { buildModel, buildImportRows, listArchiveItems, memoryDetail } from './model.js';
|
|
7
|
+
import { baseHeaders, guardRequest, newToken } from './security.js';
|
|
8
|
+
import { renderShell } from './assets/page.js';
|
|
9
|
+
import { computeInbox, computeSuggestions } from './suggestions.js';
|
|
10
|
+
import { reviewPackForBatch, reviewSubmit, readReviews } from './review-store.js';
|
|
11
|
+
import { promotedPredicate } from '../../onboarding/batches.js';
|
|
12
|
+
import { listPolicies } from '../../onboarding/policy.js';
|
|
13
|
+
import { revokeByPolicy, runAutoOnboarding } from '../../onboarding/auto.js';
|
|
14
|
+
const DEFAULT_PORT = 7767;
|
|
15
|
+
const MAX_BODY_BYTES = 2 * 1024 * 1024;
|
|
16
|
+
export async function startConsoleServer(opts = {}) {
|
|
17
|
+
const home = opts.home;
|
|
18
|
+
const paths = resolvePaths(home ?? defaultHome());
|
|
19
|
+
if (!existsSync(paths.dbPath)) {
|
|
20
|
+
throw err('E_IO', `数据目录尚未初始化(${paths.dbPath} 不存在):请先运行 cairn init`);
|
|
21
|
+
}
|
|
22
|
+
const token = opts.token ?? newToken();
|
|
23
|
+
const readStore = openStore({ home, readOnly: true });
|
|
24
|
+
// 写路径惰性打开:只浏览时不触碰 meta/device 表。
|
|
25
|
+
// 一旦打开就保持到服务关闭——按请求开关会引入"关闭后仍被复用"的悬空句柄,
|
|
26
|
+
// 而且重复 open 会反复迁移/校验 schema,代价远高于常驻一个连接。
|
|
27
|
+
let writeService = null;
|
|
28
|
+
const getWriteService = () => {
|
|
29
|
+
if (writeService == null)
|
|
30
|
+
writeService = AppService.open(home);
|
|
31
|
+
return writeService;
|
|
32
|
+
};
|
|
33
|
+
let boundPort = 0;
|
|
34
|
+
const state = { origin: '', allowedHosts: [], allowedOrigins: [] };
|
|
35
|
+
const server = createServer((req, res) => {
|
|
36
|
+
void handle(req, res).catch((e) => {
|
|
37
|
+
writeJson(res, 500, { ok: false, error: { code: 'E_INTERNAL', message: '控制台内部错误' } });
|
|
38
|
+
logRequest(req, 500);
|
|
39
|
+
void e;
|
|
40
|
+
});
|
|
41
|
+
});
|
|
42
|
+
async function handle(req, res) {
|
|
43
|
+
const rawUrl = req.url ?? '/';
|
|
44
|
+
const u = new URL(rawUrl, 'http://127.0.0.1');
|
|
45
|
+
const queryToken = u.searchParams.get('t') ?? undefined;
|
|
46
|
+
const headerToken = header(req, 'x-cairn-token');
|
|
47
|
+
const verdict = guardRequest({
|
|
48
|
+
method: req.method ?? 'GET',
|
|
49
|
+
host: header(req, 'host'),
|
|
50
|
+
origin: header(req, 'origin'),
|
|
51
|
+
secFetchSite: header(req, 'sec-fetch-site'),
|
|
52
|
+
token: headerToken ?? queryToken,
|
|
53
|
+
}, { token, allowedHosts: state.allowedHosts, allowedOrigins: state.allowedOrigins });
|
|
54
|
+
if (!verdict.ok) {
|
|
55
|
+
writeJson(res, verdict.status, { ok: false, error: { code: 'E_FORBIDDEN', message: verdict.reason } });
|
|
56
|
+
logRequest(req, verdict.status);
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
const path = u.pathname.replace(/\/+$/, '') || '/';
|
|
60
|
+
if (path === '/') {
|
|
61
|
+
const html = renderShell({
|
|
62
|
+
title: 'cairn 控制台',
|
|
63
|
+
subtitle: `本地回环 · ${state.origin} · 只读预览 + 工作台`,
|
|
64
|
+
banners: opts.banners,
|
|
65
|
+
});
|
|
66
|
+
res.writeHead(200, baseHeaders('text/html; charset=utf-8'));
|
|
67
|
+
res.end(html);
|
|
68
|
+
logRequest(req, 200);
|
|
69
|
+
return;
|
|
70
|
+
}
|
|
71
|
+
if (!path.startsWith('/api')) {
|
|
72
|
+
writeJson(res, 404, { ok: false, error: { code: 'E_NOT_FOUND', message: '未知路径' } });
|
|
73
|
+
logRequest(req, 404);
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
try {
|
|
77
|
+
const data = await route(path, u, req, readStore, getWriteService);
|
|
78
|
+
writeJson(res, 200, { ok: true, data });
|
|
79
|
+
logRequest(req, 200);
|
|
80
|
+
}
|
|
81
|
+
catch (e) {
|
|
82
|
+
const { status, body } = toHttpError(e);
|
|
83
|
+
writeJson(res, status, body);
|
|
84
|
+
logRequest(req, status);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
async function route(path, u, req, store, getWriter) {
|
|
88
|
+
const method = (req.method ?? 'GET').toUpperCase();
|
|
89
|
+
const q = u.searchParams;
|
|
90
|
+
const mode = ((q.get('mode') ?? 'brief') === 'full' ? 'full' : 'brief');
|
|
91
|
+
const redact = q.get('redact') !== '0';
|
|
92
|
+
if (method === 'GET') {
|
|
93
|
+
if (path === '/api/status') {
|
|
94
|
+
const model = buildModel(store, { mode: 'brief', redact });
|
|
95
|
+
return {
|
|
96
|
+
generatedAt: model.generatedAt,
|
|
97
|
+
home: model.home,
|
|
98
|
+
schemaVersion: model.schemaVersion,
|
|
99
|
+
counts: model.counts,
|
|
100
|
+
sync: model.sync,
|
|
101
|
+
notes: model.notes,
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
if (path === '/api/scopes') {
|
|
105
|
+
return buildModel(store, { mode: 'brief', redact }).scopes;
|
|
106
|
+
}
|
|
107
|
+
if (path === '/api/memories') {
|
|
108
|
+
const model = buildModel(store, {
|
|
109
|
+
mode,
|
|
110
|
+
redact,
|
|
111
|
+
q: q.get('q') ?? undefined,
|
|
112
|
+
scopeIds: listParam(q.get('scope')),
|
|
113
|
+
statuses: listParam(q.get('status')),
|
|
114
|
+
kinds: listParam(q.get('kind')),
|
|
115
|
+
});
|
|
116
|
+
const limit = clampInt(q.get('limit'), 1, 2000, 500);
|
|
117
|
+
return {
|
|
118
|
+
total: model.memories.length,
|
|
119
|
+
shown: Math.min(limit, model.memories.length),
|
|
120
|
+
mode,
|
|
121
|
+
redacted: redact,
|
|
122
|
+
memories: model.memories.slice(0, limit),
|
|
123
|
+
scopes: model.scopes,
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
if (path.startsWith('/api/memories/')) {
|
|
127
|
+
const id = decodeURIComponent(path.slice('/api/memories/'.length));
|
|
128
|
+
if (id.length === 0)
|
|
129
|
+
throw err('E_VALIDATION', '缺少记忆 id');
|
|
130
|
+
return memoryDetail(store, id, { mode, redact });
|
|
131
|
+
}
|
|
132
|
+
if (path === '/api/archives') {
|
|
133
|
+
return buildModel(store, { mode: 'brief', redact }).archives;
|
|
134
|
+
}
|
|
135
|
+
if (/^\/api\/archives\/[^/]+\/items$/.test(path)) {
|
|
136
|
+
const archiveId = decodeURIComponent(path.split('/')[3] ?? '');
|
|
137
|
+
const stateParam = q.get('state');
|
|
138
|
+
const scanState = stateParam === 'clean' || stateParam === 'blocked' || stateParam === 'pending' ? stateParam : undefined;
|
|
139
|
+
return listArchiveItems(store, archiveId, {
|
|
140
|
+
mode,
|
|
141
|
+
redact,
|
|
142
|
+
scanState,
|
|
143
|
+
offset: clampInt(q.get('offset'), 0, 1_000_000, 0),
|
|
144
|
+
limit: clampInt(q.get('limit'), 1, 500, 100),
|
|
145
|
+
});
|
|
146
|
+
}
|
|
147
|
+
if (path === '/api/batches') {
|
|
148
|
+
return buildModel(store, { mode: 'brief', redact }).batches;
|
|
149
|
+
}
|
|
150
|
+
if (path.startsWith('/api/batches/')) {
|
|
151
|
+
const batchId = decodeURIComponent(path.slice('/api/batches/'.length));
|
|
152
|
+
const exists = Number(store.db.scalar('SELECT COUNT(*) AS n FROM import_item WHERE batch_id = ?', batchId) ?? 0);
|
|
153
|
+
if (exists === 0)
|
|
154
|
+
throw err('E_NOT_FOUND', `批次不存在: ${batchId}`);
|
|
155
|
+
const progress = store.db.get(`SELECT COUNT(*) AS total,
|
|
156
|
+
SUM(CASE WHEN i.scan_state='clean' THEN 1 ELSE 0 END) AS clean,
|
|
157
|
+
SUM(CASE WHEN i.scan_state='blocked' THEN 1 ELSE 0 END) AS blocked
|
|
158
|
+
FROM import_item i WHERE i.batch_id = ?`, batchId);
|
|
159
|
+
const promoted = Number(store.db.scalar(`SELECT COUNT(*) AS n FROM import_item i WHERE i.batch_id = ?
|
|
160
|
+
AND ${promotedPredicate('i').exists}`, batchId) ?? 0);
|
|
161
|
+
const total = Number(progress?.['total'] ?? 0);
|
|
162
|
+
const clean = Number(progress?.['clean'] ?? 0);
|
|
163
|
+
const blocked = Number(progress?.['blocked'] ?? 0);
|
|
164
|
+
return {
|
|
165
|
+
batchId,
|
|
166
|
+
progress: { batchId, total, clean, blocked, promoted, remaining: Math.max(0, clean - promoted) },
|
|
167
|
+
suggestions: computeSuggestions(store, { batchId, redact }),
|
|
168
|
+
aiReviews: readReviews(store, { batchId }),
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
if (path === '/api/imports') {
|
|
172
|
+
return buildImportRows(store);
|
|
173
|
+
}
|
|
174
|
+
if (path === '/api/policies') {
|
|
175
|
+
// 只列出"可签名与哈希前缀",不吐策略正文:页面需要的只是选一个能用的,
|
|
176
|
+
// 具体阈值由 CLI 签发时决定,在页面上改阈值等于绕过签发。
|
|
177
|
+
return listPolicies(store.paths.home).map((p) => ({
|
|
178
|
+
id: p.spec.id,
|
|
179
|
+
policyHashPrefix: p.policyHash.slice(0, 8),
|
|
180
|
+
signedAt: p.signedAt,
|
|
181
|
+
signedVia: p.signedVia,
|
|
182
|
+
revoked: p.revokedAt != null,
|
|
183
|
+
note: p.spec.note,
|
|
184
|
+
allowedScopes: p.spec.allowedScopes,
|
|
185
|
+
maxSensitivity: p.spec.maxSensitivity,
|
|
186
|
+
allowCreate: p.spec.allowCreate,
|
|
187
|
+
minConfidence: p.spec.minConfidence,
|
|
188
|
+
}));
|
|
189
|
+
}
|
|
190
|
+
if (path === '/api/plans') {
|
|
191
|
+
const model = buildModel(store, { mode: 'brief', redact });
|
|
192
|
+
return { plans: model.plans, approvals: model.approvals };
|
|
193
|
+
}
|
|
194
|
+
if (path.startsWith('/api/plans/')) {
|
|
195
|
+
const id = decodeURIComponent(path.slice('/api/plans/'.length));
|
|
196
|
+
const model = buildModel(store, { mode: 'brief', redact });
|
|
197
|
+
const plan = model.plans.find((p) => p.id === id);
|
|
198
|
+
if (!plan)
|
|
199
|
+
throw err('E_NOT_FOUND', `计划不存在: ${id}`);
|
|
200
|
+
return plan;
|
|
201
|
+
}
|
|
202
|
+
if (path === '/api/reviews') {
|
|
203
|
+
const batchId = q.get('batch') ?? undefined;
|
|
204
|
+
const itemId = q.get('item') ?? undefined;
|
|
205
|
+
return {
|
|
206
|
+
rule: computeSuggestions(store, { batchId, itemId, redact }),
|
|
207
|
+
ai: readReviews(store, { batchId, itemId }),
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
if (path === '/api/inbox') {
|
|
211
|
+
return computeInbox(store, {
|
|
212
|
+
redact,
|
|
213
|
+
limit: clampInt(q.get('limit'), 1, 500, 100),
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
if (path === '/api/sync/status') {
|
|
217
|
+
return buildModel(store, { mode: 'brief', redact }).sync;
|
|
218
|
+
}
|
|
219
|
+
throw err('E_NOT_FOUND', `未知 API 路径: ${path}`);
|
|
220
|
+
}
|
|
221
|
+
if (method === 'POST') {
|
|
222
|
+
const body = await readJsonBody(req);
|
|
223
|
+
if (path === '/api/reviews/run') {
|
|
224
|
+
const batchId = typeof body['batchId'] === 'string' ? body['batchId'] : undefined;
|
|
225
|
+
const suggestions = computeSuggestions(store, { batchId, redact: false });
|
|
226
|
+
return { runId: `rule_${Date.now()}`, count: suggestions.items.length, items: suggestions.items };
|
|
227
|
+
}
|
|
228
|
+
if (path === '/api/reviews/pack') {
|
|
229
|
+
const writer = getWriter();
|
|
230
|
+
return await reviewPackForBatch(writer.store, {
|
|
231
|
+
batchId: typeof body['batchId'] === 'string' ? body['batchId'] : undefined,
|
|
232
|
+
outFile: typeof body['outFile'] === 'string' ? body['outFile'] : undefined,
|
|
233
|
+
maxCharsPerItem: typeof body['maxCharsPerItem'] === 'number' ? body['maxCharsPerItem'] : undefined,
|
|
234
|
+
});
|
|
235
|
+
}
|
|
236
|
+
if (path === '/api/reviews/import') {
|
|
237
|
+
const writer = getWriter();
|
|
238
|
+
const items = Array.isArray(body['items']) ? body['items'] : [];
|
|
239
|
+
return reviewSubmit(writer.store, { items, producer: 'webui', model: typeof body['model'] === 'string' ? body['model'] : null });
|
|
240
|
+
}
|
|
241
|
+
if (path === '/api/plans') {
|
|
242
|
+
const writer = getWriter();
|
|
243
|
+
const raw = Array.isArray(body['items']) ? body['items'] : [];
|
|
244
|
+
return writer.proposeForBatch({
|
|
245
|
+
batchId: typeof body['batchId'] === 'string' ? body['batchId'] : undefined,
|
|
246
|
+
items: normalizeProposedItems(store, raw),
|
|
247
|
+
proposedBy: 'webui',
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
if (path === '/api/onboarding/auto') {
|
|
251
|
+
// 页面只能"用一把已经签好的钥匙",不能自己配钥匙:
|
|
252
|
+
// 这里只接受 policyId,策略内容永远来自 <home>/policy/<id>.json。
|
|
253
|
+
const writer = getWriter();
|
|
254
|
+
const policyId = typeof body['policyId'] === 'string' ? body['policyId'].trim() : '';
|
|
255
|
+
if (policyId.length === 0)
|
|
256
|
+
throw err('E_VALIDATION', '缺少 policyId');
|
|
257
|
+
return runAutoOnboarding(writer.store, {
|
|
258
|
+
policyId,
|
|
259
|
+
batchId: typeof body['batchId'] === 'string' && body['batchId'].length > 0 ? body['batchId'] : undefined,
|
|
260
|
+
dryRun: body['dryRun'] === true,
|
|
261
|
+
redo: body['redo'] === true,
|
|
262
|
+
});
|
|
263
|
+
}
|
|
264
|
+
if (path === '/api/onboarding/revoke') {
|
|
265
|
+
const writer = getWriter();
|
|
266
|
+
const policyId = typeof body['policyId'] === 'string' ? body['policyId'].trim() : '';
|
|
267
|
+
if (policyId.length === 0)
|
|
268
|
+
throw err('E_VALIDATION', '缺少 policyId');
|
|
269
|
+
return revokeByPolicy(writer.store, policyId, {
|
|
270
|
+
batchId: typeof body['batchId'] === 'string' && body['batchId'].length > 0 ? body['batchId'] : undefined,
|
|
271
|
+
});
|
|
272
|
+
}
|
|
273
|
+
const approveMatch = /^\/api\/plans\/([^/]+)\/approve$/.exec(path);
|
|
274
|
+
if (approveMatch) {
|
|
275
|
+
const planId = decodeURIComponent(approveMatch[1]);
|
|
276
|
+
const prefix = typeof body['planHashPrefix'] === 'string' ? body['planHashPrefix'] : '';
|
|
277
|
+
const writer = getWriter();
|
|
278
|
+
const plan = writer.store.plans.requireById(planId);
|
|
279
|
+
// 页内要求重抄哈希前 8 位:这是"让审批者读一遍"的唯一机械约束。
|
|
280
|
+
if (prefix.trim().toLowerCase() !== plan.planHash.slice(0, 8).toLowerCase()) {
|
|
281
|
+
throw err('E_VALIDATION', '计划哈希前缀不匹配:请核对页面上显示的 8 位哈希后重试');
|
|
282
|
+
}
|
|
283
|
+
return writer.approve(planId, { channel: 'webui' });
|
|
284
|
+
}
|
|
285
|
+
const applyMatch = /^\/api\/plans\/([^/]+)\/apply$/.exec(path);
|
|
286
|
+
if (applyMatch) {
|
|
287
|
+
const planId = decodeURIComponent(applyMatch[1]);
|
|
288
|
+
const approvalId = typeof body['approvalId'] === 'string' ? body['approvalId'] : '';
|
|
289
|
+
if (approvalId.length === 0)
|
|
290
|
+
throw err('E_VALIDATION', '缺少 approvalId');
|
|
291
|
+
return getWriter().applyPlan(planId, approvalId);
|
|
292
|
+
}
|
|
293
|
+
if (path === '/api/sync/push' || path === '/api/sync/pull') {
|
|
294
|
+
const writer = getWriter();
|
|
295
|
+
const out = path.endsWith('push') ? await writer.syncPushCmd() : await writer.syncPullCmd();
|
|
296
|
+
return out ?? { pushed: false, note: '没有待上行任务' };
|
|
297
|
+
}
|
|
298
|
+
throw err('E_NOT_FOUND', `未知 API 路径: ${path}`);
|
|
299
|
+
}
|
|
300
|
+
throw err('E_VALIDATION', `不支持的 HTTP 方法: ${method}(读用 GET,写用 POST)`);
|
|
301
|
+
}
|
|
302
|
+
// 端口绑定:优先指定端口,被占用则退到系统分配(design D2/待决项 1)。
|
|
303
|
+
const desired = opts.port ?? DEFAULT_PORT;
|
|
304
|
+
boundPort = await listen(server, desired).catch(async (e) => {
|
|
305
|
+
if (desired !== 0)
|
|
306
|
+
return listen(server, 0);
|
|
307
|
+
throw e;
|
|
308
|
+
});
|
|
309
|
+
const port = boundPort;
|
|
310
|
+
const host = '127.0.0.1';
|
|
311
|
+
state.origin = `http://${host}:${port}`;
|
|
312
|
+
state.allowedHosts = [`${host}:${port}`, `localhost:${port}`];
|
|
313
|
+
state.allowedOrigins = [`http://${host}:${port}`, `http://localhost:${port}`];
|
|
314
|
+
return {
|
|
315
|
+
url: state.origin + '/',
|
|
316
|
+
tokenUrl: `${state.origin}/?t=${token}`,
|
|
317
|
+
token,
|
|
318
|
+
port,
|
|
319
|
+
host,
|
|
320
|
+
close: async () => {
|
|
321
|
+
readStore.close();
|
|
322
|
+
writeService?.close();
|
|
323
|
+
writeService = null;
|
|
324
|
+
await new Promise((resolve) => server.close(() => resolve()));
|
|
325
|
+
},
|
|
326
|
+
};
|
|
327
|
+
}
|
|
328
|
+
function listen(server, port) {
|
|
329
|
+
return new Promise((resolve, reject) => {
|
|
330
|
+
const onError = (e) => {
|
|
331
|
+
server.removeListener('listening', onListening);
|
|
332
|
+
reject(e);
|
|
333
|
+
};
|
|
334
|
+
const onListening = () => {
|
|
335
|
+
server.removeListener('error', onError);
|
|
336
|
+
const addr = server.address();
|
|
337
|
+
resolve(typeof addr === 'object' && addr != null ? addr.port : port);
|
|
338
|
+
};
|
|
339
|
+
server.once('error', onError);
|
|
340
|
+
server.once('listening', onListening);
|
|
341
|
+
server.listen(port, '127.0.0.1');
|
|
342
|
+
});
|
|
343
|
+
}
|
|
344
|
+
function header(req, name) {
|
|
345
|
+
const v = req.headers[name];
|
|
346
|
+
if (Array.isArray(v))
|
|
347
|
+
return v[0];
|
|
348
|
+
return v;
|
|
349
|
+
}
|
|
350
|
+
function listParam(v) {
|
|
351
|
+
if (v == null || v.trim().length === 0)
|
|
352
|
+
return [];
|
|
353
|
+
return v
|
|
354
|
+
.split(',')
|
|
355
|
+
.map((s) => s.trim())
|
|
356
|
+
.filter((s) => s.length > 0);
|
|
357
|
+
}
|
|
358
|
+
function clampInt(v, min, max, fallback) {
|
|
359
|
+
if (v == null)
|
|
360
|
+
return fallback;
|
|
361
|
+
const n = Number(v);
|
|
362
|
+
if (!Number.isFinite(n))
|
|
363
|
+
return fallback;
|
|
364
|
+
return Math.min(max, Math.max(min, Math.trunc(n)));
|
|
365
|
+
}
|
|
366
|
+
async function readJsonBody(req) {
|
|
367
|
+
const chunks = [];
|
|
368
|
+
let size = 0;
|
|
369
|
+
for await (const chunk of req) {
|
|
370
|
+
const buf = chunk;
|
|
371
|
+
size += buf.length;
|
|
372
|
+
if (size > MAX_BODY_BYTES)
|
|
373
|
+
throw err('E_VALIDATION', '请求体过大(上限 2 MB)');
|
|
374
|
+
chunks.push(buf);
|
|
375
|
+
}
|
|
376
|
+
if (chunks.length === 0)
|
|
377
|
+
return {};
|
|
378
|
+
let parsed;
|
|
379
|
+
try {
|
|
380
|
+
parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
|
|
381
|
+
}
|
|
382
|
+
catch {
|
|
383
|
+
throw err('E_VALIDATION', '请求体不是合法 JSON');
|
|
384
|
+
}
|
|
385
|
+
if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
386
|
+
throw err('E_VALIDATION', '请求体必须是 JSON 对象');
|
|
387
|
+
}
|
|
388
|
+
return parsed;
|
|
389
|
+
}
|
|
390
|
+
function writeJson(res, status, payload) {
|
|
391
|
+
if (res.headersSent)
|
|
392
|
+
return;
|
|
393
|
+
res.writeHead(status, baseHeaders('application/json; charset=utf-8'));
|
|
394
|
+
res.end(JSON.stringify(payload));
|
|
395
|
+
}
|
|
396
|
+
/** CLI 退出码语义 → HTTP 状态码。E_NOT_FOUND 单独抬到 404,不跟着 failure 走 500。 */
|
|
397
|
+
export function statusForError(e) {
|
|
398
|
+
if (!isCairnError(e))
|
|
399
|
+
return 500;
|
|
400
|
+
if (e.code === 'E_NOT_FOUND')
|
|
401
|
+
return 404;
|
|
402
|
+
switch (exitCodeFor(e.code)) {
|
|
403
|
+
case 2:
|
|
404
|
+
return 400;
|
|
405
|
+
case 3:
|
|
406
|
+
return 403;
|
|
407
|
+
case 4:
|
|
408
|
+
return 409;
|
|
409
|
+
case 5:
|
|
410
|
+
return 503;
|
|
411
|
+
default:
|
|
412
|
+
return 500;
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
function toHttpError(e) {
|
|
416
|
+
if (e instanceof CairnError) {
|
|
417
|
+
return { status: statusForError(e), body: { ok: false, error: e.toJSON() } };
|
|
418
|
+
}
|
|
419
|
+
const message = e?.message ?? '未知错误';
|
|
420
|
+
return { status: 500, body: { ok: false, error: { code: 'E_INTERNAL', message } } };
|
|
421
|
+
}
|
|
422
|
+
/**
|
|
423
|
+
* 把页面提交的草稿归一化成计划候选(design D5)。
|
|
424
|
+
*
|
|
425
|
+
* 页面**不回传正文**:摘要模式下它手里根本没有全文,短文模式回传也只是多一次
|
|
426
|
+
* 搬运与一次被篡改的机会。所以这里按 `itemId` 从 import_item 取权威原文,
|
|
427
|
+
* 页面只表达"我对哪条、想做什么动作"。
|
|
428
|
+
*
|
|
429
|
+
* 动作词表也不同:页面用面向人的 promote/merge/keep_both/skip,
|
|
430
|
+
* 计划层用 opHint 的 add/merge/keep_both/skip。转换集中在这一处,
|
|
431
|
+
* 免得两边各写一遍、然后某一侧悄悄少了一个动作。
|
|
432
|
+
*/
|
|
433
|
+
export function normalizeProposedItems(store, raw) {
|
|
434
|
+
const OP_MAP = {
|
|
435
|
+
add: 'add',
|
|
436
|
+
promote: 'add',
|
|
437
|
+
merge: 'merge',
|
|
438
|
+
keep_both: 'keep_both',
|
|
439
|
+
skip: 'skip',
|
|
440
|
+
};
|
|
441
|
+
return raw.map((it, index) => {
|
|
442
|
+
const itemId = typeof it['itemId'] === 'string' && it['itemId'].length > 0 ? it['itemId'] : undefined;
|
|
443
|
+
const opRaw = typeof it['opHint'] === 'string' ? it['opHint'] : typeof it['opType'] === 'string' ? it['opType'] : '';
|
|
444
|
+
const opHint = OP_MAP[opRaw];
|
|
445
|
+
const kindRaw = typeof it['kind'] === 'string' ? it['kind'] : 'fact';
|
|
446
|
+
let content = typeof it['content'] === 'string' ? it['content'] : '';
|
|
447
|
+
if (content.trim().length === 0) {
|
|
448
|
+
if (itemId == null) {
|
|
449
|
+
throw err('E_VALIDATION', `第 ${index + 1} 项缺少 itemId:页面只能对已导入条目提计划`);
|
|
450
|
+
}
|
|
451
|
+
const row = store.db.get('SELECT content, scan_state FROM import_item WHERE id = ?', itemId);
|
|
452
|
+
if (row == null)
|
|
453
|
+
throw err('E_NOT_FOUND', `第 ${index + 1} 项的条目不存在: ${itemId}`);
|
|
454
|
+
if (String(row['scan_state']) === 'blocked') {
|
|
455
|
+
// 原文在导入时已被替换成占位符,物理上取不回来——不能假装能纳入计划。
|
|
456
|
+
throw err('E_VALIDATION', `第 ${index + 1} 项在导入时被拦截,原文未入库,无法纳入计划`);
|
|
457
|
+
}
|
|
458
|
+
content = String(row['content']);
|
|
459
|
+
}
|
|
460
|
+
return {
|
|
461
|
+
itemId,
|
|
462
|
+
content,
|
|
463
|
+
kind: kindRaw,
|
|
464
|
+
opHint,
|
|
465
|
+
targetMemoryId: typeof it['targetMemoryId'] === 'string' ? it['targetMemoryId'] : undefined,
|
|
466
|
+
reason: typeof it['reason'] === 'string' ? it['reason'] : undefined,
|
|
467
|
+
};
|
|
468
|
+
});
|
|
469
|
+
}
|
|
470
|
+
/** 日志只保留方法、路径与状态码;query 一律剔除(其中可能有令牌)。 */ function logRequest(req, status) {
|
|
471
|
+
const raw = req.url ?? '/';
|
|
472
|
+
const at = raw.indexOf('?');
|
|
473
|
+
const path = at >= 0 ? raw.slice(0, at) : raw;
|
|
474
|
+
process.stderr.write(`[cairn-ui] ${req.method ?? 'GET'} ${path} ${status}\n`);
|
|
475
|
+
}
|
|
476
|
+
//# sourceMappingURL=server.js.map
|