@carloswon/cairn-memory 0.2.0 → 0.4.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 +50 -1
- package/dist/src/agents/config.d.ts +14 -1
- package/dist/src/agents/config.js +17 -3
- package/dist/src/agents/config.js.map +1 -1
- package/dist/src/core/types.d.ts +6 -0
- package/dist/src/core/types.js.map +1 -1
- package/dist/src/governance/apply.d.ts +4 -2
- package/dist/src/governance/apply.js +20 -0
- package/dist/src/governance/apply.js.map +1 -1
- 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/interfaces/app-service.d.ts +62 -1
- package/dist/src/interfaces/app-service.js +172 -6
- package/dist/src/interfaces/app-service.js.map +1 -1
- package/dist/src/interfaces/cli/main.js +88 -4
- package/dist/src/interfaces/cli/main.js.map +1 -1
- package/dist/src/interfaces/mcp/server.js +70 -2
- package/dist/src/interfaces/mcp/server.js.map +1 -1
- package/dist/src/projection/brief.d.ts +35 -0
- package/dist/src/projection/brief.js +96 -7
- package/dist/src/projection/brief.js.map +1 -1
- package/dist/src/store/audit.d.ts +31 -0
- package/dist/src/store/audit.js +83 -0
- package/dist/src/store/audit.js.map +1 -1
- package/dist/src/store/memories.d.ts +35 -3
- package/dist/src/store/memories.js +84 -20
- package/dist/src/store/memories.js.map +1 -1
- package/dist/src/store/migrate.js +2 -1
- package/dist/src/store/migrate.js.map +1 -1
- package/dist/src/store/open.js +28 -2
- package/dist/src/store/open.js.map +1 -1
- package/dist/src/store/schema.d.ts +12 -0
- package/dist/src/store/schema.js +17 -0
- package/dist/src/store/schema.js.map +1 -1
- package/dist/src/sync/backfill.d.ts +36 -0
- package/dist/src/sync/backfill.js +48 -0
- package/dist/src/sync/backfill.js.map +1 -0
- package/dist/src/sync/vault.d.ts +2 -1
- package/dist/src/sync/vault.js +2 -1
- package/dist/src/sync/vault.js.map +1 -1
- package/docs/cairn-security.md +267 -254
- package/docs/cairn-usage.md +919 -821
- package/package.json +4 -3
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
export const BACKFILL_DEFAULT_LIMIT = 500;
|
|
2
|
+
export function findUpstreamGap(store) {
|
|
3
|
+
return store.db
|
|
4
|
+
.all(`SELECT m.id AS memoryId, m.scope_id AS scopeId
|
|
5
|
+
FROM memory m JOIN scope s ON s.id = m.scope_id
|
|
6
|
+
WHERE m.status = 'active' AND s.sync_policy = 'encrypted' AND s.device_id = 'all'
|
|
7
|
+
AND NOT EXISTS (SELECT 1 FROM outbox_job j
|
|
8
|
+
WHERE j.job_type = 'sync_upstream' AND j.entity_id = m.id)
|
|
9
|
+
ORDER BY m.created_at, m.id`)
|
|
10
|
+
.map((r) => ({ memoryId: String(r.memoryId), scopeId: String(r.scopeId) }));
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* `apply=false` 只统计不写(默认只读)。写入全部经 `store.outbox.enqueue`:
|
|
14
|
+
* 作用域物理排除与 `scope_exclusion` 审计仍由它执行,这里不新增第二处判定。
|
|
15
|
+
*/
|
|
16
|
+
export function backfillUpstream(store, opts) {
|
|
17
|
+
const gap = findUpstreamGap(store);
|
|
18
|
+
const batch = gap.slice(0, opts.limit ?? BACKFILL_DEFAULT_LIMIT);
|
|
19
|
+
const report = { candidates: gap.length, enqueued: 0, existing: 0, excluded: 0, memoryIds: [] };
|
|
20
|
+
if (!opts.apply) {
|
|
21
|
+
report.memoryIds = batch.map((g) => g.memoryId);
|
|
22
|
+
return report;
|
|
23
|
+
}
|
|
24
|
+
store.db.transaction(() => {
|
|
25
|
+
for (const g of batch) {
|
|
26
|
+
const r = store.outbox.enqueue({
|
|
27
|
+
jobType: 'sync_upstream',
|
|
28
|
+
scopeId: g.scopeId,
|
|
29
|
+
entityType: 'memory',
|
|
30
|
+
entityId: g.memoryId,
|
|
31
|
+
payload: { op: 'memory_upsert', memoryId: g.memoryId },
|
|
32
|
+
idempotencyKey: `memory:${g.memoryId}`,
|
|
33
|
+
});
|
|
34
|
+
if (r.enqueued) {
|
|
35
|
+
report.enqueued++;
|
|
36
|
+
report.memoryIds.push(g.memoryId);
|
|
37
|
+
}
|
|
38
|
+
else if (r.reason === 'duplicate') {
|
|
39
|
+
report.existing++;
|
|
40
|
+
}
|
|
41
|
+
else {
|
|
42
|
+
report.excluded++;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
});
|
|
46
|
+
return report;
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=backfill.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/sync/backfill.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,KAAK,CAAC,EAAE;SACZ,GAAG,CACF;;;;;mCAK6B,CAC9B;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,IAAwC;IAC1F,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,sBAAsB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAmB,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAChH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACxB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC7B,OAAO,EAAE,eAAe;gBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;gBACtD,cAAc,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACpC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
package/dist/src/sync/vault.d.ts
CHANGED
|
@@ -26,12 +26,13 @@ export declare function saveVaultConfig(dataDir: string, cfg: Omit<VaultConfig,
|
|
|
26
26
|
/**
|
|
27
27
|
* 环境变量名约定(与 GITHUB_TOKEN 同模式,用户级注入):
|
|
28
28
|
* OBS: OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY(+ vault.json 的 endpoint/bucket/prefix)
|
|
29
|
-
* syncd: CAIRN_SYNCD_TOKEN
|
|
29
|
+
* syncd: CAIRN_SYNCD_TOKEN(凭据);CAIRN_SYNCD_URL(baseUrl 缺省值,命令行 --base-url 优先)
|
|
30
30
|
*/
|
|
31
31
|
export declare const ENV: {
|
|
32
32
|
readonly obsAk: "OBS_ACCESS_KEY_ID";
|
|
33
33
|
readonly obsSk: "OBS_SECRET_ACCESS_KEY";
|
|
34
34
|
readonly syncdToken: "CAIRN_SYNCD_TOKEN";
|
|
35
|
+
readonly syncdUrl: "CAIRN_SYNCD_URL";
|
|
35
36
|
};
|
|
36
37
|
/** 本变更首版同步的个人空间键(跨设备稳定标识;项目/自定义空间同步属后续边界)。 */
|
|
37
38
|
export declare const PERSONAL_SPACE_KEY = "personal-global";
|
package/dist/src/sync/vault.js
CHANGED
|
@@ -41,12 +41,13 @@ export function saveVaultConfig(dataDir, cfg) {
|
|
|
41
41
|
/**
|
|
42
42
|
* 环境变量名约定(与 GITHUB_TOKEN 同模式,用户级注入):
|
|
43
43
|
* OBS: OBS_ACCESS_KEY_ID / OBS_SECRET_ACCESS_KEY(+ vault.json 的 endpoint/bucket/prefix)
|
|
44
|
-
* syncd: CAIRN_SYNCD_TOKEN
|
|
44
|
+
* syncd: CAIRN_SYNCD_TOKEN(凭据);CAIRN_SYNCD_URL(baseUrl 缺省值,命令行 --base-url 优先)
|
|
45
45
|
*/
|
|
46
46
|
export const ENV = {
|
|
47
47
|
obsAk: 'OBS_ACCESS_KEY_ID',
|
|
48
48
|
obsSk: 'OBS_SECRET_ACCESS_KEY',
|
|
49
49
|
syncdToken: 'CAIRN_SYNCD_TOKEN',
|
|
50
|
+
syncdUrl: 'CAIRN_SYNCD_URL',
|
|
50
51
|
};
|
|
51
52
|
/** 本变更首版同步的个人空间键(跨设备稳定标识;项目/自定义空间同步属后续边界)。 */
|
|
52
53
|
export const PERSONAL_SPACE_KEY = 'personal-global';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../../src/sync/vault.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAmBzC,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAgB,CAAC;QAC/D,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpE,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAsE;IACrH,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;IAC5F,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,MAAM,GAAG,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAgB;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,MAAM,EAAE,EAAE;QACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;IACF,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,mBAAmB;IAC1B,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,mBAAmB;
|
|
1
|
+
{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../../src/sync/vault.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAmBzC,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAgB,CAAC;QAC/D,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpE,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAsE;IACrH,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;IAC5F,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,MAAM,GAAG,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,MAAM,GAAG,CAAC,MAAM,EAAE,uCAAuC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAgB;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,MAAM,EAAE,EAAE;QACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;IACF,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,mBAAmB;IAC1B,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,mBAAmB;IAC/B,QAAQ,EAAE,iBAAiB;CACnB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}
|