@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 @@
|
|
|
1
|
+
{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../../src/projection/brief.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from './markdown.js';
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/projection/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import type { CairnStore } from '../store/open.js';
|
|
2
|
+
/**
|
|
3
|
+
* 受管 Markdown 投影(tasks 7.x)。
|
|
4
|
+
*
|
|
5
|
+
* 标记约定:
|
|
6
|
+
* 起始 `<!-- cairn:begin block="<blockId>" revision="<n>" -->`
|
|
7
|
+
* 结束 `<!-- cairn:end block="<blockId>" -->`
|
|
8
|
+
*
|
|
9
|
+
* 不变量:
|
|
10
|
+
* - 只改动受管区块内部字节;区块外内容逐字节保留(含未知换行风格)。
|
|
11
|
+
* - upsert 幂等:内容未变 → changed=false 且文件字节不动。
|
|
12
|
+
* - remove 同时清理安装时加入的分隔空行,其余部分逐字节保留。
|
|
13
|
+
* - 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(已存在则不覆盖)。
|
|
14
|
+
* - 写入先落同目录临时文件再 rename(原子替换)。
|
|
15
|
+
*/
|
|
16
|
+
/** 默认受管区块 ID(router 入口统一使用,保证 plan/apply/disable 一致)。 */
|
|
17
|
+
export declare const DEFAULT_BLOCK_ID = "cairn-memory";
|
|
18
|
+
export declare const BACKUP_SUFFIX = ".cairn-backup";
|
|
19
|
+
export declare function beginMarker(blockId: string, revision: number): string;
|
|
20
|
+
export declare function endMarker(blockId: string): string;
|
|
21
|
+
/** 渲染一个受管区块(含起止标记与内部正文)。 */
|
|
22
|
+
export declare function renderBlock(content: string, revision: number, blockId: string): string;
|
|
23
|
+
/** 防回环探测:导入/发现层据此跳过受管文件,不做任何解析。 */
|
|
24
|
+
export declare function hasCairnMarker(text: string): boolean;
|
|
25
|
+
/**
|
|
26
|
+
* 把区块写入文本:无块 → 追加(保证前面恰好一个空行分隔);
|
|
27
|
+
* 有块 → 整体替换并 revision+1;内容未变 → changed=false 且 revision 不变。
|
|
28
|
+
*
|
|
29
|
+
* options.revisionSeed:文件中无块但库里有历史记录时的 revision 续号
|
|
30
|
+
* (新 revision = seed + 1;不传则从 1 开始)。
|
|
31
|
+
*/
|
|
32
|
+
export declare function upsertBlockInText(text: string, blockId: string, newContent: string, options?: {
|
|
33
|
+
revisionSeed?: number;
|
|
34
|
+
}): {
|
|
35
|
+
output: string;
|
|
36
|
+
changed: boolean;
|
|
37
|
+
hadBlock: boolean;
|
|
38
|
+
revision: number;
|
|
39
|
+
};
|
|
40
|
+
/**
|
|
41
|
+
* 从文本移除区块:删除区块本体,并回收安装时加入的前置分隔空行
|
|
42
|
+
* (只回收紧邻区块的那一个空行,用户自己加的空行/内容全部保留)。
|
|
43
|
+
* 区块外其余字节逐字节保留。
|
|
44
|
+
*/
|
|
45
|
+
export declare function removeBlockFromText(text: string, blockId: string): {
|
|
46
|
+
output: string;
|
|
47
|
+
changed: boolean;
|
|
48
|
+
hadBlock: boolean;
|
|
49
|
+
};
|
|
50
|
+
export interface GenerateProjectionResult {
|
|
51
|
+
changed: boolean;
|
|
52
|
+
revision: number;
|
|
53
|
+
/** 本次实际使用的备份文件路径(未新建备份时为既有记录或 null)。 */
|
|
54
|
+
backupPath: string | null;
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* 生成受管投影:读文件(不存在 → '')→ upsert → 有变化才写。
|
|
58
|
+
* 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(仅首次,不覆盖)。
|
|
59
|
+
* 库记录 revision 取现有块标记 / 库记录 + 1。
|
|
60
|
+
*/
|
|
61
|
+
export declare function generateProjection(store: CairnStore, input: {
|
|
62
|
+
targetPath: string;
|
|
63
|
+
content: string;
|
|
64
|
+
blockId?: string;
|
|
65
|
+
agentId: string;
|
|
66
|
+
}): Promise<GenerateProjectionResult>;
|
|
67
|
+
export interface DisableProjectionResult {
|
|
68
|
+
removed: boolean;
|
|
69
|
+
restoredOriginal: boolean;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* 停用受管投影:
|
|
73
|
+
* - 当前文件移除区块后与备份原始文件一致 → 直接整文件恢复备份字节(restoredOriginal=true);
|
|
74
|
+
* - 否则(用户有其他修改)只移除受管区块,其余修改保留;
|
|
75
|
+
* - 任何情况下都 markRemoved + 审计(不写正文)。
|
|
76
|
+
*/
|
|
77
|
+
export declare function disableProjection(store: CairnStore, input: {
|
|
78
|
+
targetPath: string;
|
|
79
|
+
blockId?: string;
|
|
80
|
+
}): Promise<DisableProjectionResult>;
|
|
81
|
+
/** 供 config 模块复用的整文件哈希。 */
|
|
82
|
+
export declare function fileHash(buf: Buffer): string;
|
|
@@ -0,0 +1,313 @@
|
|
|
1
|
+
import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { dirname } from 'node:path';
|
|
3
|
+
import { err } from '../core/errors.js';
|
|
4
|
+
import { sha256Hex } from '../core/hash.js';
|
|
5
|
+
/**
|
|
6
|
+
* 受管 Markdown 投影(tasks 7.x)。
|
|
7
|
+
*
|
|
8
|
+
* 标记约定:
|
|
9
|
+
* 起始 `<!-- cairn:begin block="<blockId>" revision="<n>" -->`
|
|
10
|
+
* 结束 `<!-- cairn:end block="<blockId>" -->`
|
|
11
|
+
*
|
|
12
|
+
* 不变量:
|
|
13
|
+
* - 只改动受管区块内部字节;区块外内容逐字节保留(含未知换行风格)。
|
|
14
|
+
* - upsert 幂等:内容未变 → changed=false 且文件字节不动。
|
|
15
|
+
* - remove 同时清理安装时加入的分隔空行,其余部分逐字节保留。
|
|
16
|
+
* - 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(已存在则不覆盖)。
|
|
17
|
+
* - 写入先落同目录临时文件再 rename(原子替换)。
|
|
18
|
+
*/
|
|
19
|
+
/** 默认受管区块 ID(router 入口统一使用,保证 plan/apply/disable 一致)。 */
|
|
20
|
+
export const DEFAULT_BLOCK_ID = 'cairn-memory';
|
|
21
|
+
export const BACKUP_SUFFIX = '.cairn-backup';
|
|
22
|
+
const BEGIN_PREFIX = '<!-- cairn:begin block="';
|
|
23
|
+
const END_MARKER_PREFIX = '<!-- cairn:end block="';
|
|
24
|
+
/** blockId 进入标记文本与正则,只允许安全字符。 */
|
|
25
|
+
const BLOCK_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
|
|
26
|
+
function assertBlockId(blockId) {
|
|
27
|
+
if (typeof blockId !== 'string' || !BLOCK_ID_RE.test(blockId)) {
|
|
28
|
+
throw err('E_VALIDATION', `非法 blockId: ${JSON.stringify(blockId)}(仅允许字母数字与 . _ -,长度 1-64)`);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
function assertBlockContent(content) {
|
|
32
|
+
if (typeof content !== 'string') {
|
|
33
|
+
throw err('E_VALIDATION', '区块内容必须是字符串');
|
|
34
|
+
}
|
|
35
|
+
if (/cairn:(begin|end)/i.test(content)) {
|
|
36
|
+
throw err('E_VALIDATION', '区块内容不得包含 cairn:begin / cairn:end 标记(防嵌套与解析歧义)');
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
export function beginMarker(blockId, revision) {
|
|
40
|
+
return `${BEGIN_PREFIX}${blockId}" revision="${revision}" -->`;
|
|
41
|
+
}
|
|
42
|
+
export function endMarker(blockId) {
|
|
43
|
+
return `${END_MARKER_PREFIX}${blockId}" -->`;
|
|
44
|
+
}
|
|
45
|
+
/** 渲染一个受管区块(含起止标记与内部正文)。 */
|
|
46
|
+
export function renderBlock(content, revision, blockId) {
|
|
47
|
+
assertBlockId(blockId);
|
|
48
|
+
assertBlockContent(content);
|
|
49
|
+
if (!Number.isInteger(revision) || revision < 0) {
|
|
50
|
+
throw err('E_VALIDATION', `非法 revision: ${revision}`);
|
|
51
|
+
}
|
|
52
|
+
return `${beginMarker(blockId, revision)}\n${content}\n${endMarker(blockId)}`;
|
|
53
|
+
}
|
|
54
|
+
function escapeRe(s) {
|
|
55
|
+
return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
56
|
+
}
|
|
57
|
+
function findBeginMatches(text, blockId) {
|
|
58
|
+
// revision 允许缺省(外来/手写标记按 0 处理,下一次写入从 1 开始)
|
|
59
|
+
const re = new RegExp(`^<!-- cairn:begin block="${escapeRe(blockId)}"(?: revision="(\\d+)")? -->[ \\t]*\\r?$`, 'gm');
|
|
60
|
+
const out = [];
|
|
61
|
+
for (let m = re.exec(text); m !== null; m = re.exec(text)) {
|
|
62
|
+
const markerStart = m.index;
|
|
63
|
+
const lineStart = text.lastIndexOf('\n', markerStart) + 1;
|
|
64
|
+
out.push({
|
|
65
|
+
lineStart,
|
|
66
|
+
markerEnd: markerStart + m[0].length,
|
|
67
|
+
revision: m[1] ? Number.parseInt(m[1], 10) : 0,
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
return out;
|
|
71
|
+
}
|
|
72
|
+
function findEndMatch(text, blockId, from) {
|
|
73
|
+
const re = new RegExp(`^<!-- cairn:end block="${escapeRe(blockId)}" -->[ \\t]*\\r?$`, 'gm');
|
|
74
|
+
re.lastIndex = from;
|
|
75
|
+
const m = re.exec(text);
|
|
76
|
+
if (m === null)
|
|
77
|
+
return null;
|
|
78
|
+
return { start: m.index, end: m.index + m[0].length };
|
|
79
|
+
}
|
|
80
|
+
function countEndMarkers(text, blockId) {
|
|
81
|
+
const re = new RegExp(`^<!-- cairn:end block="${escapeRe(blockId)}" -->[ \\t]*\\r?$`, 'gm');
|
|
82
|
+
let n = 0;
|
|
83
|
+
while (re.exec(text) !== null)
|
|
84
|
+
n += 1;
|
|
85
|
+
return n;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* 定位区块跨度;重复或不平衡标记按 M0 矩阵约定拒绝(E_VALIDATION)。
|
|
89
|
+
* 未找到时返回 null。
|
|
90
|
+
*/
|
|
91
|
+
function findBlockSpan(text, blockId) {
|
|
92
|
+
const begins = findBeginMatches(text, blockId);
|
|
93
|
+
const endCount = countEndMarkers(text, blockId);
|
|
94
|
+
if (begins.length > 1) {
|
|
95
|
+
throw err('E_VALIDATION', `目标文件中存在 ${begins.length} 个重复的受管区块标记(block=${blockId}),拒绝处理`);
|
|
96
|
+
}
|
|
97
|
+
if (begins.length === 0) {
|
|
98
|
+
if (endCount > 0) {
|
|
99
|
+
throw err('E_VALIDATION', `目标文件存在孤立的 cairn:end 标记(block=${blockId}),标记不平衡,拒绝处理`);
|
|
100
|
+
}
|
|
101
|
+
return null;
|
|
102
|
+
}
|
|
103
|
+
const begin = begins[0];
|
|
104
|
+
if (endCount !== 1) {
|
|
105
|
+
throw err('E_VALIDATION', `受管区块标记不平衡(block=${blockId}):起始 1 个、结束 ${endCount} 个,拒绝处理`);
|
|
106
|
+
}
|
|
107
|
+
const end = findEndMatch(text, blockId, begin.markerEnd);
|
|
108
|
+
if (end === null) {
|
|
109
|
+
throw err('E_VALIDATION', `受管区块缺少结束标记(block=${blockId}),拒绝处理`);
|
|
110
|
+
}
|
|
111
|
+
return { start: begin.lineStart, end: end.end, revision: begin.revision };
|
|
112
|
+
}
|
|
113
|
+
/** 防回环探测:导入/发现层据此跳过受管文件,不做任何解析。 */
|
|
114
|
+
export function hasCairnMarker(text) {
|
|
115
|
+
return /<!--\s*cairn:(begin|end)\b/.test(text);
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* 把区块写入文本:无块 → 追加(保证前面恰好一个空行分隔);
|
|
119
|
+
* 有块 → 整体替换并 revision+1;内容未变 → changed=false 且 revision 不变。
|
|
120
|
+
*
|
|
121
|
+
* options.revisionSeed:文件中无块但库里有历史记录时的 revision 续号
|
|
122
|
+
* (新 revision = seed + 1;不传则从 1 开始)。
|
|
123
|
+
*/
|
|
124
|
+
export function upsertBlockInText(text, blockId, newContent, options = {}) {
|
|
125
|
+
assertBlockId(blockId);
|
|
126
|
+
assertBlockContent(newContent);
|
|
127
|
+
const span = findBlockSpan(text, blockId);
|
|
128
|
+
if (span === null) {
|
|
129
|
+
const revision = (options.revisionSeed ?? 0) + 1;
|
|
130
|
+
const block = renderBlock(newContent, revision, blockId);
|
|
131
|
+
const base = text.replace(/(?:\r?\n)+$/, '');
|
|
132
|
+
const output = base === '' ? `${block}\n` : `${base}\n\n${block}\n`;
|
|
133
|
+
return { output, changed: true, hadBlock: false, revision };
|
|
134
|
+
}
|
|
135
|
+
const spanText = text.slice(span.start, span.end);
|
|
136
|
+
const current = renderBlock(newContent, span.revision, blockId);
|
|
137
|
+
if (spanText === current) {
|
|
138
|
+
return { output: text, changed: false, hadBlock: true, revision: span.revision };
|
|
139
|
+
}
|
|
140
|
+
const nextRevision = span.revision + 1;
|
|
141
|
+
const output = text.slice(0, span.start) + renderBlock(newContent, nextRevision, blockId) + text.slice(span.end);
|
|
142
|
+
return { output, changed: true, hadBlock: true, revision: nextRevision };
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* 从文本移除区块:删除区块本体,并回收安装时加入的前置分隔空行
|
|
146
|
+
* (只回收紧邻区块的那一个空行,用户自己加的空行/内容全部保留)。
|
|
147
|
+
* 区块外其余字节逐字节保留。
|
|
148
|
+
*/
|
|
149
|
+
export function removeBlockFromText(text, blockId) {
|
|
150
|
+
assertBlockId(blockId);
|
|
151
|
+
const span = findBlockSpan(text, blockId);
|
|
152
|
+
if (span === null) {
|
|
153
|
+
return { output: text, changed: false, hadBlock: false };
|
|
154
|
+
}
|
|
155
|
+
// 回收安装时加入的分隔空行:起始标记的上一行若为空行则一并移除
|
|
156
|
+
let start = span.start;
|
|
157
|
+
const before = text.slice(0, span.start);
|
|
158
|
+
const sepMatch = /(?:^|\r?\n)([ \t]*\r?\n)$/.exec(before);
|
|
159
|
+
if (sepMatch !== null && sepMatch[1] !== undefined) {
|
|
160
|
+
start -= sepMatch[1].length;
|
|
161
|
+
}
|
|
162
|
+
const end = span.end;
|
|
163
|
+
// 结束标记行自身的换行随区块一起移除
|
|
164
|
+
const suffixStart = skipNewline(text, end);
|
|
165
|
+
const head = text.slice(0, start);
|
|
166
|
+
let tail = text.slice(suffixStart);
|
|
167
|
+
if (head === '') {
|
|
168
|
+
// 区块原本位于文件最前:清理残留的前导空行
|
|
169
|
+
tail = tail.replace(/^(?:\r?\n)+/, '');
|
|
170
|
+
}
|
|
171
|
+
const output = head + tail;
|
|
172
|
+
return { output, changed: true, hadBlock: true };
|
|
173
|
+
}
|
|
174
|
+
function skipNewline(text, at) {
|
|
175
|
+
if (text[at] === '\r' && text[at + 1] === '\n')
|
|
176
|
+
return at + 2;
|
|
177
|
+
if (text[at] === '\n')
|
|
178
|
+
return at + 1;
|
|
179
|
+
return at;
|
|
180
|
+
}
|
|
181
|
+
/** 从已存的 startMarker 里解析 revision(库记录续号用)。 */
|
|
182
|
+
function parseRevisionFromMarker(marker) {
|
|
183
|
+
if (!marker)
|
|
184
|
+
return 0;
|
|
185
|
+
const m = /revision="(\d+)"/.exec(marker);
|
|
186
|
+
return m && m[1] ? Number.parseInt(m[1], 10) : 0;
|
|
187
|
+
}
|
|
188
|
+
async function readFileOrNull(path) {
|
|
189
|
+
try {
|
|
190
|
+
return await readFile(path);
|
|
191
|
+
}
|
|
192
|
+
catch (e) {
|
|
193
|
+
const code = e.code;
|
|
194
|
+
if (code === 'ENOENT')
|
|
195
|
+
return null;
|
|
196
|
+
throw err('E_CONFIG_IO', `读取文件失败: ${path}(${code ?? '未知错误'})`);
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
async function writeFileAtomic(path, data) {
|
|
200
|
+
await mkdir(dirname(path), { recursive: true });
|
|
201
|
+
const tmp = `${path}.cairn-tmp-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
|
|
202
|
+
try {
|
|
203
|
+
await writeFile(tmp, data);
|
|
204
|
+
await rename(tmp, path);
|
|
205
|
+
}
|
|
206
|
+
catch (e) {
|
|
207
|
+
await rm(tmp, { force: true }).catch(() => undefined);
|
|
208
|
+
throw err('E_CONFIG_IO', `原子写入失败: ${path}(${e.message})`);
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
/**
|
|
212
|
+
* 生成受管投影:读文件(不存在 → '')→ upsert → 有变化才写。
|
|
213
|
+
* 首次写入前把原始字节备份到 targetPath + '.cairn-backup'(仅首次,不覆盖)。
|
|
214
|
+
* 库记录 revision 取现有块标记 / 库记录 + 1。
|
|
215
|
+
*/
|
|
216
|
+
export async function generateProjection(store, input) {
|
|
217
|
+
const blockId = input.blockId ?? DEFAULT_BLOCK_ID;
|
|
218
|
+
assertBlockId(blockId);
|
|
219
|
+
assertBlockContent(input.content);
|
|
220
|
+
if (typeof input.targetPath !== 'string' || input.targetPath.length === 0) {
|
|
221
|
+
throw err('E_VALIDATION', 'targetPath 不能为空');
|
|
222
|
+
}
|
|
223
|
+
if (typeof input.agentId !== 'string' || input.agentId.length === 0) {
|
|
224
|
+
throw err('E_VALIDATION', 'agentId 不能为空');
|
|
225
|
+
}
|
|
226
|
+
const original = await readFileOrNull(input.targetPath);
|
|
227
|
+
const text = original !== null ? original.toString('utf8') : '';
|
|
228
|
+
const existingRow = store.blocks.get(input.targetPath, blockId);
|
|
229
|
+
const seedRevision = existingRow ? parseRevisionFromMarker(existingRow.startMarker) : 0;
|
|
230
|
+
const result = upsertBlockInText(text, blockId, input.content, { revisionSeed: seedRevision });
|
|
231
|
+
// 幂等:内容未变且库里有记录 → 不写文件、不动库
|
|
232
|
+
if (!result.changed && existingRow) {
|
|
233
|
+
return { changed: false, revision: result.revision, backupPath: existingRow.backupPath };
|
|
234
|
+
}
|
|
235
|
+
const backupPath = input.targetPath + BACKUP_SUFFIX;
|
|
236
|
+
let backupToRecord = existingRow?.backupPath ?? null;
|
|
237
|
+
if (result.changed) {
|
|
238
|
+
if (original !== null) {
|
|
239
|
+
// 仅首次写入前备份原始字节;备份已存在则不覆盖
|
|
240
|
+
if (!(await backupExists(backupPath))) {
|
|
241
|
+
await writeFileAtomic(backupPath, original);
|
|
242
|
+
}
|
|
243
|
+
backupToRecord = backupPath;
|
|
244
|
+
}
|
|
245
|
+
await writeFileAtomic(input.targetPath, Buffer.from(result.output, 'utf8'));
|
|
246
|
+
}
|
|
247
|
+
const row = store.blocks.upsert({
|
|
248
|
+
targetPath: input.targetPath,
|
|
249
|
+
blockId,
|
|
250
|
+
agentId: input.agentId,
|
|
251
|
+
content: input.content,
|
|
252
|
+
startMarker: beginMarker(blockId, result.revision),
|
|
253
|
+
endMarker: endMarker(blockId),
|
|
254
|
+
...(backupToRecord ? { backupPath: backupToRecord } : {}),
|
|
255
|
+
});
|
|
256
|
+
return { changed: result.changed, revision: result.revision, backupPath: row.backupPath };
|
|
257
|
+
}
|
|
258
|
+
/** 备份是否已存在(仅区分 ENOENT,其他 IO 错误如实抛出)。 */
|
|
259
|
+
async function backupExists(path) {
|
|
260
|
+
try {
|
|
261
|
+
await stat(path);
|
|
262
|
+
return true;
|
|
263
|
+
}
|
|
264
|
+
catch (e) {
|
|
265
|
+
if (e.code === 'ENOENT')
|
|
266
|
+
return false;
|
|
267
|
+
throw err('E_CONFIG_IO', `检查备份文件失败: ${path}(${e.code ?? '未知错误'})`);
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* 停用受管投影:
|
|
272
|
+
* - 当前文件移除区块后与备份原始文件一致 → 直接整文件恢复备份字节(restoredOriginal=true);
|
|
273
|
+
* - 否则(用户有其他修改)只移除受管区块,其余修改保留;
|
|
274
|
+
* - 任何情况下都 markRemoved + 审计(不写正文)。
|
|
275
|
+
*/
|
|
276
|
+
export async function disableProjection(store, input) {
|
|
277
|
+
const blockId = input.blockId ?? DEFAULT_BLOCK_ID;
|
|
278
|
+
assertBlockId(blockId);
|
|
279
|
+
if (typeof input.targetPath !== 'string' || input.targetPath.length === 0) {
|
|
280
|
+
throw err('E_VALIDATION', 'targetPath 不能为空');
|
|
281
|
+
}
|
|
282
|
+
const row = store.blocks.get(input.targetPath, blockId);
|
|
283
|
+
const current = await readFileOrNull(input.targetPath);
|
|
284
|
+
let removed = false;
|
|
285
|
+
let restoredOriginal = false;
|
|
286
|
+
if (current !== null) {
|
|
287
|
+
const currentText = current.toString('utf8');
|
|
288
|
+
const removal = removeBlockFromText(currentText, blockId);
|
|
289
|
+
removed = removal.changed;
|
|
290
|
+
const backupPath = row?.backupPath ?? input.targetPath + BACKUP_SUFFIX;
|
|
291
|
+
const backup = await readFileOrNull(backupPath);
|
|
292
|
+
if (backup !== null && removal.output === backup.toString('utf8')) {
|
|
293
|
+
// 用户未做其他修改:整文件恢复原始字节
|
|
294
|
+
await writeFileAtomic(input.targetPath, backup);
|
|
295
|
+
restoredOriginal = true;
|
|
296
|
+
// 备份字节已完整还原,备份文件完成使命(删除失败不影响结论)
|
|
297
|
+
await rm(backupPath, { force: true }).catch(() => undefined);
|
|
298
|
+
}
|
|
299
|
+
else if (removal.changed && removal.output !== currentText) {
|
|
300
|
+
await writeFileAtomic(input.targetPath, Buffer.from(removal.output, 'utf8'));
|
|
301
|
+
}
|
|
302
|
+
}
|
|
303
|
+
if (row) {
|
|
304
|
+
store.blocks.markRemoved(row.id);
|
|
305
|
+
}
|
|
306
|
+
store.audit.record('config', 'projection_removed', { type: 'managed_block', id: blockId }, { targetPath: input.targetPath, removed, restoredOriginal, hadRecord: row !== null });
|
|
307
|
+
return { removed, restoredOriginal };
|
|
308
|
+
}
|
|
309
|
+
/** 供 config 模块复用的整文件哈希。 */
|
|
310
|
+
export function fileHash(buf) {
|
|
311
|
+
return sha256Hex(buf);
|
|
312
|
+
}
|
|
313
|
+
//# sourceMappingURL=markdown.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/projection/markdown.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { CairnStore } from '../store/open.js';
|
|
2
|
+
import { ScopeQuery } from '../core/scope.js';
|
|
3
|
+
import { EvidenceRecord, MemoryRecord, MemoryStatus, RevisionRecord } from '../core/types.js';
|
|
4
|
+
/**
|
|
5
|
+
* 导出(spec scoped-retrieval:与检索同一边界)。
|
|
6
|
+
*
|
|
7
|
+
* - 所有行逐行过 scopeAllowsRead;scopeIds 白名单同样生效且必须存在。
|
|
8
|
+
* - 【硬性】tombstoned 正文绝不进入 memories[],只以 hash+审计字段进入 tombstones[];
|
|
9
|
+
* superseded 记忆同理完全不进导出。
|
|
10
|
+
* - 每条 memory 携带库字段 contentHash(基于规范化正文),重复导入可幂等。
|
|
11
|
+
* - 只读:本函数不写库。
|
|
12
|
+
*/
|
|
13
|
+
export interface ExportInput {
|
|
14
|
+
query: ScopeQuery;
|
|
15
|
+
/** 可选作用域白名单;为空数组时不过滤 scope。 */
|
|
16
|
+
scopeIds?: string[];
|
|
17
|
+
/** 默认 ['active'];tombstoned/superseded 仍然禁止。 */
|
|
18
|
+
statuses?: MemoryStatus[];
|
|
19
|
+
format: 'json' | 'markdown';
|
|
20
|
+
/** true 时附带 import_item(仅 scan_state='clean')。 */
|
|
21
|
+
includeArchives?: boolean;
|
|
22
|
+
}
|
|
23
|
+
export interface ExportCounts {
|
|
24
|
+
memories: number;
|
|
25
|
+
revisions: number;
|
|
26
|
+
evidence: number;
|
|
27
|
+
archives?: number;
|
|
28
|
+
}
|
|
29
|
+
export interface ExportOutput {
|
|
30
|
+
payload: string;
|
|
31
|
+
counts: ExportCounts;
|
|
32
|
+
}
|
|
33
|
+
export interface ExportScopeInfo {
|
|
34
|
+
id: string;
|
|
35
|
+
preset: string;
|
|
36
|
+
syncPolicy: string;
|
|
37
|
+
projectId: string | null;
|
|
38
|
+
deviceId: string;
|
|
39
|
+
agentId: string;
|
|
40
|
+
}
|
|
41
|
+
export interface ExportRelationInfo {
|
|
42
|
+
id: string;
|
|
43
|
+
fromMemoryId: string;
|
|
44
|
+
toMemoryId: string;
|
|
45
|
+
relationType: string;
|
|
46
|
+
}
|
|
47
|
+
export interface ExportMemoryEntry extends MemoryRecord {
|
|
48
|
+
revisions: RevisionRecord[];
|
|
49
|
+
evidence: EvidenceRecord[];
|
|
50
|
+
relations: ExportRelationInfo[];
|
|
51
|
+
}
|
|
52
|
+
export interface ExportTombstone {
|
|
53
|
+
memoryId: string;
|
|
54
|
+
contentHash: string;
|
|
55
|
+
forgottenAt: string;
|
|
56
|
+
reason: string | null;
|
|
57
|
+
forgottenBy: string;
|
|
58
|
+
}
|
|
59
|
+
export interface ExportArchiveItem {
|
|
60
|
+
itemIndex: number;
|
|
61
|
+
content: string;
|
|
62
|
+
contentHash: string;
|
|
63
|
+
sourceRef: string | null;
|
|
64
|
+
}
|
|
65
|
+
export interface ExportArchive {
|
|
66
|
+
id: string;
|
|
67
|
+
batchId: string;
|
|
68
|
+
parser: string;
|
|
69
|
+
items: ExportArchiveItem[];
|
|
70
|
+
}
|
|
71
|
+
export interface ExportDoc {
|
|
72
|
+
format: 'cairn-export';
|
|
73
|
+
version: 1;
|
|
74
|
+
exportedAt: string;
|
|
75
|
+
scopes: ExportScopeInfo[];
|
|
76
|
+
memories: ExportMemoryEntry[];
|
|
77
|
+
tombstones: ExportTombstone[];
|
|
78
|
+
archives?: ExportArchive[];
|
|
79
|
+
}
|
|
80
|
+
export declare function exportData(store: CairnStore, input: ExportInput): ExportOutput;
|