@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.
Files changed (225) hide show
  1. package/CHANGELOG.md +81 -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 +139 -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/archive.d.ts +29 -0
  44. package/dist/src/governance/archive.js +52 -0
  45. package/dist/src/governance/archive.js.map +1 -0
  46. package/dist/src/governance/dedup.d.ts +21 -0
  47. package/dist/src/governance/dedup.js +23 -0
  48. package/dist/src/governance/dedup.js.map +1 -0
  49. package/dist/src/governance/index.d.ts +16 -0
  50. package/dist/src/governance/index.js +17 -0
  51. package/dist/src/governance/index.js.map +1 -0
  52. package/dist/src/governance/propose.d.ts +78 -0
  53. package/dist/src/governance/propose.js +150 -0
  54. package/dist/src/governance/propose.js.map +1 -0
  55. package/dist/src/index.d.ts +15 -0
  56. package/dist/src/index.js +24 -0
  57. package/dist/src/index.js.map +1 -0
  58. package/dist/src/interfaces/app-service.d.ts +292 -0
  59. package/dist/src/interfaces/app-service.js +743 -0
  60. package/dist/src/interfaces/app-service.js.map +1 -0
  61. package/dist/src/interfaces/cli/main.d.ts +2 -0
  62. package/dist/src/interfaces/cli/main.js +854 -0
  63. package/dist/src/interfaces/cli/main.js.map +1 -0
  64. package/dist/src/interfaces/console/assets/page.d.ts +18 -0
  65. package/dist/src/interfaces/console/assets/page.js +39 -0
  66. package/dist/src/interfaces/console/assets/page.js.map +1 -0
  67. package/dist/src/interfaces/console/assets/ui-css.d.ts +11 -0
  68. package/dist/src/interfaces/console/assets/ui-css.js +119 -0
  69. package/dist/src/interfaces/console/assets/ui-css.js.map +1 -0
  70. package/dist/src/interfaces/console/assets/ui-js.d.ts +14 -0
  71. package/dist/src/interfaces/console/assets/ui-js.js +1098 -0
  72. package/dist/src/interfaces/console/assets/ui-js.js.map +1 -0
  73. package/dist/src/interfaces/console/assets/url-state.d.ts +9 -0
  74. package/dist/src/interfaces/console/assets/url-state.js +45 -0
  75. package/dist/src/interfaces/console/assets/url-state.js.map +1 -0
  76. package/dist/src/interfaces/console/export.d.ts +46 -0
  77. package/dist/src/interfaces/console/export.js +84 -0
  78. package/dist/src/interfaces/console/export.js.map +1 -0
  79. package/dist/src/interfaces/console/model.d.ts +372 -0
  80. package/dist/src/interfaces/console/model.js +731 -0
  81. package/dist/src/interfaces/console/model.js.map +1 -0
  82. package/dist/src/interfaces/console/review-store.d.ts +142 -0
  83. package/dist/src/interfaces/console/review-store.js +342 -0
  84. package/dist/src/interfaces/console/review-store.js.map +1 -0
  85. package/dist/src/interfaces/console/security.d.ts +76 -0
  86. package/dist/src/interfaces/console/security.js +105 -0
  87. package/dist/src/interfaces/console/security.js.map +1 -0
  88. package/dist/src/interfaces/console/server.d.ts +45 -0
  89. package/dist/src/interfaces/console/server.js +476 -0
  90. package/dist/src/interfaces/console/server.js.map +1 -0
  91. package/dist/src/interfaces/console/suggestions.d.ts +112 -0
  92. package/dist/src/interfaces/console/suggestions.js +511 -0
  93. package/dist/src/interfaces/console/suggestions.js.map +1 -0
  94. package/dist/src/interfaces/console/text.d.ts +4 -0
  95. package/dist/src/interfaces/console/text.js +18 -0
  96. package/dist/src/interfaces/console/text.js.map +1 -0
  97. package/dist/src/interfaces/mcp/server.d.ts +4 -0
  98. package/dist/src/interfaces/mcp/server.js +480 -0
  99. package/dist/src/interfaces/mcp/server.js.map +1 -0
  100. package/dist/src/jobs/index.d.ts +6 -0
  101. package/dist/src/jobs/index.js +7 -0
  102. package/dist/src/jobs/index.js.map +1 -0
  103. package/dist/src/jobs/remote.d.ts +42 -0
  104. package/dist/src/jobs/remote.js +34 -0
  105. package/dist/src/jobs/remote.js.map +1 -0
  106. package/dist/src/jobs/worker.d.ts +67 -0
  107. package/dist/src/jobs/worker.js +169 -0
  108. package/dist/src/jobs/worker.js.map +1 -0
  109. package/dist/src/onboarding/auto.d.ts +88 -0
  110. package/dist/src/onboarding/auto.js +399 -0
  111. package/dist/src/onboarding/auto.js.map +1 -0
  112. package/dist/src/onboarding/batches.d.ts +103 -0
  113. package/dist/src/onboarding/batches.js +219 -0
  114. package/dist/src/onboarding/batches.js.map +1 -0
  115. package/dist/src/onboarding/discover.d.ts +54 -0
  116. package/dist/src/onboarding/discover.js +369 -0
  117. package/dist/src/onboarding/discover.js.map +1 -0
  118. package/dist/src/onboarding/import.d.ts +69 -0
  119. package/dist/src/onboarding/import.js +279 -0
  120. package/dist/src/onboarding/import.js.map +1 -0
  121. package/dist/src/onboarding/index.d.ts +24 -0
  122. package/dist/src/onboarding/index.js +22 -0
  123. package/dist/src/onboarding/index.js.map +1 -0
  124. package/dist/src/onboarding/judgement.d.ts +50 -0
  125. package/dist/src/onboarding/judgement.js +121 -0
  126. package/dist/src/onboarding/judgement.js.map +1 -0
  127. package/dist/src/onboarding/policy.d.ts +86 -0
  128. package/dist/src/onboarding/policy.js +249 -0
  129. package/dist/src/onboarding/policy.js.map +1 -0
  130. package/dist/src/projection/brief.d.ts +112 -0
  131. package/dist/src/projection/brief.js +200 -0
  132. package/dist/src/projection/brief.js.map +1 -0
  133. package/dist/src/projection/index.d.ts +1 -0
  134. package/dist/src/projection/index.js +2 -0
  135. package/dist/src/projection/index.js.map +1 -0
  136. package/dist/src/projection/markdown.d.ts +82 -0
  137. package/dist/src/projection/markdown.js +313 -0
  138. package/dist/src/projection/markdown.js.map +1 -0
  139. package/dist/src/retrieval/export.d.ts +80 -0
  140. package/dist/src/retrieval/export.js +215 -0
  141. package/dist/src/retrieval/export.js.map +1 -0
  142. package/dist/src/retrieval/index.d.ts +5 -0
  143. package/dist/src/retrieval/index.js +6 -0
  144. package/dist/src/retrieval/index.js.map +1 -0
  145. package/dist/src/retrieval/search.d.ts +37 -0
  146. package/dist/src/retrieval/search.js +294 -0
  147. package/dist/src/retrieval/search.js.map +1 -0
  148. package/dist/src/store/archives.d.ts +94 -0
  149. package/dist/src/store/archives.js +135 -0
  150. package/dist/src/store/archives.js.map +1 -0
  151. package/dist/src/store/audit.d.ts +57 -0
  152. package/dist/src/store/audit.js +131 -0
  153. package/dist/src/store/audit.js.map +1 -0
  154. package/dist/src/store/backup.d.ts +36 -0
  155. package/dist/src/store/backup.js +90 -0
  156. package/dist/src/store/backup.js.map +1 -0
  157. package/dist/src/store/blocks.d.ts +64 -0
  158. package/dist/src/store/blocks.js +104 -0
  159. package/dist/src/store/blocks.js.map +1 -0
  160. package/dist/src/store/conflicts.d.ts +52 -0
  161. package/dist/src/store/conflicts.js +112 -0
  162. package/dist/src/store/conflicts.js.map +1 -0
  163. package/dist/src/store/db.d.ts +44 -0
  164. package/dist/src/store/db.js +162 -0
  165. package/dist/src/store/db.js.map +1 -0
  166. package/dist/src/store/device.d.ts +46 -0
  167. package/dist/src/store/device.js +111 -0
  168. package/dist/src/store/device.js.map +1 -0
  169. package/dist/src/store/index.d.ts +14 -0
  170. package/dist/src/store/index.js +15 -0
  171. package/dist/src/store/index.js.map +1 -0
  172. package/dist/src/store/memories.d.ts +133 -0
  173. package/dist/src/store/memories.js +442 -0
  174. package/dist/src/store/memories.js.map +1 -0
  175. package/dist/src/store/migrate.d.ts +32 -0
  176. package/dist/src/store/migrate.js +87 -0
  177. package/dist/src/store/migrate.js.map +1 -0
  178. package/dist/src/store/open.d.ts +53 -0
  179. package/dist/src/store/open.js +203 -0
  180. package/dist/src/store/open.js.map +1 -0
  181. package/dist/src/store/outbox.d.ts +65 -0
  182. package/dist/src/store/outbox.js +137 -0
  183. package/dist/src/store/outbox.js.map +1 -0
  184. package/dist/src/store/plans.d.ts +137 -0
  185. package/dist/src/store/plans.js +243 -0
  186. package/dist/src/store/plans.js.map +1 -0
  187. package/dist/src/store/schema.d.ts +46 -0
  188. package/dist/src/store/schema.js +544 -0
  189. package/dist/src/store/schema.js.map +1 -0
  190. package/dist/src/store/scopes.d.ts +44 -0
  191. package/dist/src/store/scopes.js +220 -0
  192. package/dist/src/store/scopes.js.map +1 -0
  193. package/dist/src/store/write-guard.d.ts +10 -0
  194. package/dist/src/store/write-guard.js +10 -0
  195. package/dist/src/store/write-guard.js.map +1 -0
  196. package/dist/src/sync/apply.d.ts +24 -0
  197. package/dist/src/sync/apply.js +130 -0
  198. package/dist/src/sync/apply.js.map +1 -0
  199. package/dist/src/sync/cryptoutil.d.ts +86 -0
  200. package/dist/src/sync/cryptoutil.js +339 -0
  201. package/dist/src/sync/cryptoutil.js.map +1 -0
  202. package/dist/src/sync/events.d.ts +69 -0
  203. package/dist/src/sync/events.js +78 -0
  204. package/dist/src/sync/events.js.map +1 -0
  205. package/dist/src/sync/obs-store.d.ts +41 -0
  206. package/dist/src/sync/obs-store.js +325 -0
  207. package/dist/src/sync/obs-store.js.map +1 -0
  208. package/dist/src/sync/orchestrate.d.ts +37 -0
  209. package/dist/src/sync/orchestrate.js +84 -0
  210. package/dist/src/sync/orchestrate.js.map +1 -0
  211. package/dist/src/sync/pull.d.ts +24 -0
  212. package/dist/src/sync/pull.js +150 -0
  213. package/dist/src/sync/pull.js.map +1 -0
  214. package/dist/src/sync/push.d.ts +19 -0
  215. package/dist/src/sync/push.js +227 -0
  216. package/dist/src/sync/push.js.map +1 -0
  217. package/dist/src/sync/syncd-store.d.ts +31 -0
  218. package/dist/src/sync/syncd-store.js +92 -0
  219. package/dist/src/sync/syncd-store.js.map +1 -0
  220. package/dist/src/sync/vault.d.ts +37 -0
  221. package/dist/src/sync/vault.js +53 -0
  222. package/dist/src/sync/vault.js.map +1 -0
  223. package/docs/cairn-security.md +267 -0
  224. package/docs/cairn-usage.md +919 -0
  225. package/package.json +71 -4
@@ -0,0 +1,78 @@
1
+ /**
2
+ * 作用域是统一策略对象,不是标签集合(design D4)。
3
+ * 预设只是构造器;写入、检索、详情、导出、投影与 outbox 构造
4
+ * 必须调用同一组判定入口,禁止各入口自行解释作用域。
5
+ */
6
+ export type SyncPolicy = 'local_only' | 'encrypted';
7
+ export type ReadPolicy = 'all_agents' | 'allowlist';
8
+ export type RetentionPolicy = 'permanent' | 'ttl' | 'lru' | 'session';
9
+ export type ProjectionPolicy = 'none' | 'allowlist';
10
+ export declare const SCOPE_PRESETS: readonly ["personal-global", "device-local", "project-global", "project-device", "agent-private", "session-ephemeral", "custom"];
11
+ export type ScopePresetName = (typeof SCOPE_PRESETS)[number];
12
+ export type ScopeKind = 'personal' | 'project' | 'agent' | 'device' | 'custom';
13
+ /** 逻辑作用域描述(构造/校验用;存储映射在 store 层)。 */
14
+ export interface ScopeSpec {
15
+ preset: ScopePresetName;
16
+ scopeKind: ScopeKind;
17
+ /** 自定义空间名称;custom 必填,其余为展示名。 */
18
+ spaceName: string;
19
+ projectId: string | null;
20
+ /** 'all' 或具体设备 ID;device 类作用域必须是具体设备。 */
21
+ deviceId: string;
22
+ /** 'all' 或具体 Agent ID。 */
23
+ agentId: string;
24
+ syncPolicy: SyncPolicy;
25
+ readPolicy: ReadPolicy;
26
+ /** 读取 allowlist:readPolicy 为 allowlist 时生效。 */
27
+ readAllowlist: string[];
28
+ retentionPolicy: RetentionPolicy;
29
+ projectionPolicy: ProjectionPolicy;
30
+ sensitivity: 'normal' | 'sensitive';
31
+ ttlDays: number | null;
32
+ }
33
+ export interface ScopeRow {
34
+ id: string;
35
+ spaceId: string;
36
+ preset: ScopePresetName;
37
+ scopeKind: ScopeKind;
38
+ projectId: string | null;
39
+ deviceId: string;
40
+ agentId: string;
41
+ syncPolicy: SyncPolicy;
42
+ readPolicy: ReadPolicy;
43
+ readAllowlist: string[];
44
+ retentionPolicy: RetentionPolicy;
45
+ projectionPolicy: ProjectionPolicy;
46
+ sensitivity: 'normal' | 'sensitive';
47
+ ttlDays: number | null;
48
+ builtin: boolean;
49
+ }
50
+ /** 读取请求方的身份三元组;所有读取入口都必须提供。 */
51
+ export interface ScopeQuery {
52
+ deviceId: string;
53
+ agentId: string;
54
+ projectId?: string | null;
55
+ }
56
+ export declare function personalGlobal(): ScopeSpec;
57
+ export declare function deviceLocal(deviceId: string): ScopeSpec;
58
+ export declare function projectGlobal(projectId: string, projectName: string): ScopeSpec;
59
+ export declare function projectDevice(projectId: string, projectName: string, deviceId: string): ScopeSpec;
60
+ export declare function agentPrivate(agentId: string, opts?: {
61
+ syncPolicy?: SyncPolicy;
62
+ }): ScopeSpec;
63
+ export declare function sessionEphemeral(ttlDays: number): ScopeSpec;
64
+ /**
65
+ * 自定义空间:默认 local_only、默认不向所有 Agent 放宽(构想 §7.4)。
66
+ * 调用方必须显式扩大范围;不提供任意表达式语言。
67
+ */
68
+ export declare function customSpace(spaceName: string, opts?: Partial<ScopeSpec>): ScopeSpec;
69
+ export declare function validateScopeSpec(spec: ScopeSpec): void;
70
+ /**
71
+ * 读取判定。项目作用域只对同一逻辑项目可见;设备/Agent 维度按绑定匹配。
72
+ * 注意:不允许通过替代入口绕过(spec scoped-retrieval)。
73
+ */
74
+ export declare function scopeAllowsRead(scope: Pick<ScopeRow, 'deviceId' | 'agentId' | 'projectId' | 'readPolicy' | 'readAllowlist'>, query: ScopeQuery): boolean;
75
+ /** 上行判定:只有 encrypted 作用域可以生成上行任务。 */
76
+ export declare function scopeAllowsUpstream(scope: Pick<ScopeRow, 'syncPolicy'>): boolean;
77
+ /** local_only / 设备限定内容是否被物理排除于上行之外。 */
78
+ export declare function isPhysicallyLocal(scope: Pick<ScopeRow, 'syncPolicy' | 'deviceId'>): boolean;
@@ -0,0 +1,181 @@
1
+ /**
2
+ * 作用域是统一策略对象,不是标签集合(design D4)。
3
+ * 预设只是构造器;写入、检索、详情、导出、投影与 outbox 构造
4
+ * 必须调用同一组判定入口,禁止各入口自行解释作用域。
5
+ */
6
+ import { err } from './errors.js';
7
+ export const SCOPE_PRESETS = [
8
+ 'personal-global',
9
+ 'device-local',
10
+ 'project-global',
11
+ 'project-device',
12
+ 'agent-private',
13
+ 'session-ephemeral',
14
+ 'custom',
15
+ ];
16
+ // ---------------------------------------------------------------------------
17
+ // 预设构造器(构想 §7.3)
18
+ // ---------------------------------------------------------------------------
19
+ export function personalGlobal() {
20
+ return base('personal-global', 'personal', 'personal', {
21
+ deviceId: 'all',
22
+ agentId: 'all',
23
+ syncPolicy: 'encrypted',
24
+ readPolicy: 'all_agents',
25
+ retentionPolicy: 'permanent',
26
+ });
27
+ }
28
+ export function deviceLocal(deviceId) {
29
+ if (deviceId === 'all')
30
+ throw err('E_SCOPE_INVALID', 'device-local 作用域必须绑定具体设备');
31
+ return base('device-local', 'device', 'device-local', {
32
+ deviceId,
33
+ agentId: 'all',
34
+ syncPolicy: 'local_only',
35
+ readPolicy: 'all_agents',
36
+ retentionPolicy: 'permanent',
37
+ });
38
+ }
39
+ export function projectGlobal(projectId, projectName) {
40
+ return base('project-global', 'project', projectName, {
41
+ projectId,
42
+ deviceId: 'all',
43
+ agentId: 'all',
44
+ syncPolicy: 'encrypted',
45
+ readPolicy: 'all_agents',
46
+ retentionPolicy: 'permanent',
47
+ });
48
+ }
49
+ export function projectDevice(projectId, projectName, deviceId) {
50
+ if (deviceId === 'all')
51
+ throw err('E_SCOPE_INVALID', 'project-device 作用域必须绑定具体设备');
52
+ return base('project-device', 'project', projectName, {
53
+ projectId,
54
+ deviceId,
55
+ agentId: 'all',
56
+ syncPolicy: 'local_only',
57
+ readPolicy: 'all_agents',
58
+ retentionPolicy: 'permanent',
59
+ });
60
+ }
61
+ export function agentPrivate(agentId, opts) {
62
+ return base('agent-private', 'agent', `agent:${agentId}`, {
63
+ deviceId: 'all',
64
+ agentId,
65
+ syncPolicy: opts?.syncPolicy ?? 'local_only',
66
+ readPolicy: 'allowlist',
67
+ readAllowlist: [agentId],
68
+ retentionPolicy: 'permanent',
69
+ });
70
+ }
71
+ export function sessionEphemeral(ttlDays) {
72
+ return base('session-ephemeral', 'personal', 'session', {
73
+ deviceId: 'all',
74
+ agentId: 'all',
75
+ syncPolicy: 'local_only',
76
+ readPolicy: 'all_agents',
77
+ retentionPolicy: 'ttl',
78
+ ttlDays,
79
+ });
80
+ }
81
+ /**
82
+ * 自定义空间:默认 local_only、默认不向所有 Agent 放宽(构想 §7.4)。
83
+ * 调用方必须显式扩大范围;不提供任意表达式语言。
84
+ */
85
+ export function customSpace(spaceName, opts) {
86
+ const spec = base('custom', 'custom', spaceName, {
87
+ deviceId: 'all',
88
+ agentId: 'all',
89
+ syncPolicy: 'local_only',
90
+ readPolicy: 'all_agents',
91
+ retentionPolicy: 'permanent',
92
+ ...opts,
93
+ });
94
+ return spec;
95
+ }
96
+ function base(preset, scopeKind, spaceName, fields) {
97
+ return {
98
+ preset,
99
+ scopeKind,
100
+ spaceName,
101
+ projectId: null,
102
+ deviceId: 'all',
103
+ agentId: 'all',
104
+ syncPolicy: 'local_only',
105
+ readPolicy: 'all_agents',
106
+ readAllowlist: [],
107
+ retentionPolicy: 'permanent',
108
+ projectionPolicy: 'none',
109
+ sensitivity: 'normal',
110
+ ttlDays: null,
111
+ ...fields,
112
+ };
113
+ }
114
+ // ---------------------------------------------------------------------------
115
+ // 校验
116
+ // ---------------------------------------------------------------------------
117
+ const CUSTOM_SPACE_NAME_RE = /^[\p{L}\p{N}][\p{L}\p{N} ._-]{0,63}$/u;
118
+ export function validateScopeSpec(spec) {
119
+ const problems = [];
120
+ if (spec.scopeKind === 'project' && !spec.projectId) {
121
+ problems.push('project 作用域必须绑定 projectId');
122
+ }
123
+ if (spec.scopeKind === 'custom') {
124
+ if (!CUSTOM_SPACE_NAME_RE.test(spec.spaceName)) {
125
+ problems.push(`自定义空间名称非法: ${JSON.stringify(spec.spaceName)}(1-64 字符,字母/数字/空格/._-)`);
126
+ }
127
+ if (spec.syncPolicy === 'encrypted' && spec.sensitivity === 'sensitive') {
128
+ problems.push('sensitive 空间不允许启用加密同步(默认 local_only)');
129
+ }
130
+ }
131
+ // 物理边界:设备绑定作用域永远不可上行(spec memory-store / 构想 §7.5)
132
+ if (spec.deviceId !== 'all' && spec.syncPolicy !== 'local_only') {
133
+ problems.push('设备绑定作用域的 syncPolicy 必须是 local_only');
134
+ }
135
+ if (spec.syncPolicy === 'encrypted' && spec.deviceId !== 'all') {
136
+ problems.push('encrypted 同步要求 device 为 all');
137
+ }
138
+ if (spec.retentionPolicy === 'ttl' && (spec.ttlDays == null || spec.ttlDays <= 0)) {
139
+ problems.push('retention ttl 必须提供正整数 ttlDays');
140
+ }
141
+ if (spec.sensitivity === 'sensitive' && spec.syncPolicy !== 'local_only') {
142
+ problems.push('sensitive 作用域必须 local_only(首版保守规则)');
143
+ }
144
+ if (spec.readPolicy === 'allowlist' && spec.readAllowlist.length === 0) {
145
+ problems.push('readPolicy allowlist 必须提供 readAllowlist');
146
+ }
147
+ if (problems.length > 0) {
148
+ throw err('E_SCOPE_INVALID', `作用域校验失败: ${problems.join('; ')}`, { problems });
149
+ }
150
+ }
151
+ // ---------------------------------------------------------------------------
152
+ // 统一判定入口:检索、详情、导出、投影、outbox 共用
153
+ // ---------------------------------------------------------------------------
154
+ /**
155
+ * 读取判定。项目作用域只对同一逻辑项目可见;设备/Agent 维度按绑定匹配。
156
+ * 注意:不允许通过替代入口绕过(spec scoped-retrieval)。
157
+ */
158
+ export function scopeAllowsRead(scope, query) {
159
+ if (scope.readPolicy === 'allowlist' && !scope.readAllowlist.includes(query.agentId)) {
160
+ return false;
161
+ }
162
+ if (scope.deviceId !== 'all' && scope.deviceId !== query.deviceId) {
163
+ return false;
164
+ }
165
+ if (scope.agentId !== 'all' && scope.agentId !== query.agentId) {
166
+ return false;
167
+ }
168
+ if (scope.projectId != null && (query.projectId ?? null) !== scope.projectId) {
169
+ return false;
170
+ }
171
+ return true;
172
+ }
173
+ /** 上行判定:只有 encrypted 作用域可以生成上行任务。 */
174
+ export function scopeAllowsUpstream(scope) {
175
+ return scope.syncPolicy === 'encrypted';
176
+ }
177
+ /** local_only / 设备限定内容是否被物理排除于上行之外。 */
178
+ export function isPhysicallyLocal(scope) {
179
+ return scope.syncPolicy === 'local_only' || scope.deviceId !== 'all';
180
+ }
181
+ //# sourceMappingURL=scope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/core/scope.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { SecretScanResult } from './types.js';
2
+ /** 扫描文本中的疑似秘密与提示注入。findings 不含原文,仅 masked 与位置。 */
3
+ export declare function scanText(text: string): SecretScanResult;
4
+ /** 供报告使用的打码切片(与 findings.masked 同策略)。 */
5
+ export declare function maskText(text: string, f: {
6
+ start: number;
7
+ end: number;
8
+ }): string;
9
+ /**
10
+ * 断言文本可进入 Agent 批次 / 存储 / 投影 / outbox。
11
+ * 抛出的 CairnError 只含 kind/rule/位置摘要,绝不回显秘密原文。
12
+ */
13
+ export declare function assertClean(text: string, context: string): void;
@@ -0,0 +1,122 @@
1
+ import { err } from './errors.js';
2
+ const KEYWORDS = /(api[_-]?key|apikey|secret|token|password|passwd|pwd|credential|auth|令牌|密钥|密码|凭据|访问令牌|私密)/i;
3
+ const PLACEHOLDER = /^(<[^>]+>|\$\{[^}]*\}|\{\{[^}]*\}\}|x{8,}|\*+|…+|your[_-].*|my[_-].*|example.*|dummy.*|fake.*|test[_-]?key.*|<your-password>|changeme|placeholder.*)$/i;
4
+ const RULES = [
5
+ { kind: 'private_key', re: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----|-----BEGIN OPENSSH PRIVATE KEY-----/g },
6
+ { kind: 'aws_access_key_id', re: /\bAKIA[0-9A-Z]{16}\b/g },
7
+ { kind: 'aws_secret_access_key', re: /\b(?=[A-Za-z0-9/+=]{40}\b)(?![A-Za-z0-9]*AKIA)[A-Za-z0-9/+=]{40}\b/g, requiresKeyword: true },
8
+ { kind: 'github_token', re: /\b(?:ghp|gho|ghu|ghs|ghr)_[A-Za-z0-9]{36,255}\b|\bgithub_pat_[A-Za-z0-9_]{22,255}\b/g },
9
+ { kind: 'jwt', re: /\beyJ[A-Za-z0-9_-]{5,}\.[A-Za-z0-9_-]{5,}\.[A-Za-z0-9_-]{5,}\b/g },
10
+ { kind: 'bearer_token', re: /\b(?:Bearer|bearer)\s+[A-Za-z0-9._~+/=-]{16,}\b/g },
11
+ {
12
+ kind: 'generic_api_key',
13
+ re: /\b(?:sk|pk|rk)[-_][A-Za-z0-9_-]{16,}\b|\b(?:api[_-]?key|apikey|access[_-]?token|secret[_-]?key|client[_-]?secret|private[_-]?token)["']?\s*[:=]\s*["']([A-Za-z0-9._~+/=-]{12,})["']|(?:访问令牌|访问密钥|api密钥|接口密钥)["']?\s*[:=:]\s*["']([A-Za-z0-9._~+/=-]{12,})["']/gi,
14
+ },
15
+ {
16
+ kind: 'password_assignment',
17
+ re: /\b(?:password|passwd|pwd|secret|token)["']?\s*[:=]\s*["']([^"'\s{}]{6,})["']|(?:密码|口令)["']?\s*[:=:]\s*["']?([^"'\s{}]{6,})["']?/gi,
18
+ },
19
+ {
20
+ kind: 'connection_string',
21
+ re: /\b(?:postgres(?:ql)?|mysql|mongodb(?:\+srv)?|redis|amqp|mssql):\/\/[^\s:/@]+:([^\s@/]{3,})@[^\s]+/gi,
22
+ },
23
+ ];
24
+ const INJECTION_RULES = [
25
+ {
26
+ kind: 'ignore_instructions',
27
+ rule: 'ignore_previous_instructions',
28
+ re: /忽略(?:之前|上述|前面|以上)(?:的)?(?:所有|全部|任何)?(?:系统)?(?:指令|提示|规则)|无视(?:之前|上述)(?:的)?(?:指令|规则)|ignore\s+(?:all\s+)?(?:previous|prior|above)\s+(?:instructions|prompts?|rules?)|disregard\s+(?:all\s+)?(?:previous|prior)\s+instructions/i,
29
+ },
30
+ {
31
+ kind: 'exfiltrate_memory',
32
+ rule: 'exfiltrate_all_memories',
33
+ re: /(?:把|将|请|帮我|替我).{0,10}(?:全部|所有|整个|完整)?(?:记忆|库|数据|秘密|凭据|密钥|口令|secret|secrets).{0,8}(?:导出|上传|发送|输出|泄露|外传|打印)(?!功能|入口|按钮|命令|模块|脚本|面板)|(?:导出|上传|发送|输出|泄露|打印).{0,6}(?:全部|所有|整个|完整)?(?:记忆|库|数据|秘密|凭据|密钥|口令|secret|secrets)|export\s+(?:all|the\s+entire)\s+(?:memor|data|vault)|dump\s+all\s+memor/i,
34
+ },
35
+ {
36
+ kind: 'escalate_scope',
37
+ rule: 'escalate_scope_or_permissions',
38
+ re: /(?:扩大|提升|放宽|修改).{0,4}(?:作用域|权限|同步范围|scope)|(?:作用域|权限|同步范围).{0,6}(?:扩大|提升|放宽)|(?:升为|改成|变为)个人公共|escalate\s+(?:scope|permissions?)|broaden\s+the\s+scope|grant\s+yourself\s+permission/i,
39
+ },
40
+ {
41
+ kind: 'role_override',
42
+ rule: 'role_override',
43
+ re: /(?:从现在起|现在)你是|你现在(?:是|当|做)|(?:你)是一个(?:新的)?(?:系统|管理员|root)|ignore\s+your\s+(?:role|persona)|you\s+are\s+now\s+(?:a|an|the)\s+(?:system|admin|root|developer)|扮演(?:系统|管理员|root)/i,
44
+ },
45
+ {
46
+ kind: 'fake_approval',
47
+ rule: 'fake_user_approval',
48
+ re: /用户(?:已经|已|已經)(?:同意|确认|批准|授权)|(?:用户|他|她)(?:已|已经)确认过了|user\s+(?:has\s+)?(?:already\s+)?(?:confirmed|approved)|treat\s+(?:this|it)\s+as\s+(?:user\s+)?(?:approved|confirmed)/i,
49
+ },
50
+ ];
51
+ function mask(raw) {
52
+ const s = raw.trim();
53
+ if (s.length <= 4)
54
+ return '***';
55
+ return `${s.slice(0, 2)}***${s.slice(-2)}`;
56
+ }
57
+ function isPlaceholder(v) {
58
+ return PLACEHOLDER.test(v.trim()) || /^(A-Z{3,})$/.test(v.trim()) === true && v === v.toUpperCase() && v.length <= 12;
59
+ }
60
+ /** 扫描文本中的疑似秘密与提示注入。findings 不含原文,仅 masked 与位置。 */
61
+ export function scanText(text) {
62
+ const findings = [];
63
+ const injectionFindings = [];
64
+ for (const rule of RULES) {
65
+ rule.re.lastIndex = 0;
66
+ let m;
67
+ while ((m = rule.re.exec(text)) != null) {
68
+ const raw = (m[1] ?? m[0]);
69
+ if (raw.length === 0)
70
+ continue;
71
+ if (rule.requiresKeyword) {
72
+ const lineStart = text.lastIndexOf('\n', m.index) + 1;
73
+ const lineEnd = text.indexOf('\n', m.index);
74
+ const line = text.slice(lineStart, lineEnd === -1 ? undefined : lineEnd);
75
+ if (!KEYWORDS.test(line))
76
+ continue;
77
+ }
78
+ if (isPlaceholder(raw))
79
+ continue;
80
+ findings.push({ kind: rule.kind, start: m.index, end: m.index + m[0].length, masked: mask(raw) });
81
+ if (m.index === rule.re.lastIndex)
82
+ rule.re.lastIndex++;
83
+ }
84
+ }
85
+ for (const rule of INJECTION_RULES) {
86
+ rule.re.lastIndex = 0;
87
+ let m;
88
+ while ((m = rule.re.exec(text)) != null) {
89
+ // 去重:同一 kind 已有更早命中则跳过(只报最具体一条)
90
+ if (injectionFindings.some((f) => f.kind === rule.kind))
91
+ break;
92
+ injectionFindings.push({ kind: rule.kind, start: m.index, end: m.index + m[0].length, rule: rule.rule });
93
+ if (m.index === rule.re.lastIndex)
94
+ rule.re.lastIndex++;
95
+ }
96
+ }
97
+ return { findings, injectionFindings, clean: findings.length === 0 && injectionFindings.length === 0 };
98
+ }
99
+ /** 供报告使用的打码切片(与 findings.masked 同策略)。 */
100
+ export function maskText(text, f) {
101
+ return mask(text.slice(f.start, f.end));
102
+ }
103
+ /**
104
+ * 断言文本可进入 Agent 批次 / 存储 / 投影 / outbox。
105
+ * 抛出的 CairnError 只含 kind/rule/位置摘要,绝不回显秘密原文。
106
+ */
107
+ export function assertClean(text, context) {
108
+ const r = scanText(text);
109
+ if (!r.clean) {
110
+ if (r.findings.length > 0) {
111
+ throw err('E_SECRET_DETECTED', `${context}: 检测到疑似秘密,已阻断(不回显原文)`, {
112
+ context,
113
+ findings: r.findings.map((f) => ({ kind: f.kind, masked: f.masked, start: f.start, end: f.end })),
114
+ });
115
+ }
116
+ throw err('E_INJECTION_SUSPECTED', `${context}: 检测到疑似提示注入指令,已阻断`, {
117
+ context,
118
+ findings: r.injectionFindings.map((f) => ({ kind: f.kind, rule: f.rule, start: f.start, end: f.end })),
119
+ });
120
+ }
121
+ }
122
+ //# sourceMappingURL=secrets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../../src/core/secrets.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /** ISO-8601 UTC(毫秒精度,'Z' 结尾)——数据库统一时间形态。 */
2
+ export declare function nowIso(): string;
3
+ export declare function toIso(d: Date): string;
4
+ export declare function isoPlusMs(iso: string, ms: number): string;
5
+ export declare function isExpired(expiresAt: string | null | undefined, at?: string): boolean;
6
+ /** 加法解析天数;非法输入由调用方校验。 */
7
+ export declare function daysToMs(days: number): number;
@@ -0,0 +1,18 @@
1
+ /** ISO-8601 UTC(毫秒精度,'Z' 结尾)——数据库统一时间形态。 */
2
+ export function nowIso() {
3
+ return new Date().toISOString();
4
+ }
5
+ export function toIso(d) {
6
+ return d.toISOString();
7
+ }
8
+ export function isoPlusMs(iso, ms) {
9
+ return new Date(new Date(iso).getTime() + ms).toISOString();
10
+ }
11
+ export function isExpired(expiresAt, at = nowIso()) {
12
+ return expiresAt != null && expiresAt <= at;
13
+ }
14
+ /** 加法解析天数;非法输入由调用方校验。 */
15
+ export function daysToMs(days) {
16
+ return days * 24 * 60 * 60 * 1000;
17
+ }
18
+ //# sourceMappingURL=time.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/core/time.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,CAAO;IAC3B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,EAAU;IAC/C,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAoC,EAAE,KAAa,MAAM,EAAE;IACnF,OAAO,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACpC,CAAC"}
@@ -0,0 +1,139 @@
1
+ /** Cairn 领域类型——所有模块共享的唯一事实源。 */
2
+ export declare const MEMORY_KINDS: readonly ["instruction", "preference", "fact", "decision", "episode", "procedure", "environment", "lesson"];
3
+ export type MemoryKind = (typeof MEMORY_KINDS)[number];
4
+ export declare const MEMORY_STATUSES: readonly ["candidate", "active", "conflicted", "superseded", "archived", "tombstoned"];
5
+ export type MemoryStatus = (typeof MEMORY_STATUSES)[number];
6
+ export declare const AUTHORITIES: readonly ["user_explicit", "user_confirmed", "agent_inferred", "imported_unverified"];
7
+ export type Authority = (typeof AUTHORITIES)[number];
8
+ /** 敏感度:normal / sensitive 可入库;blocked 是扫描结论,拒绝入库(触发器兜底)。 */
9
+ export type Sensitivity = 'normal' | 'sensitive';
10
+ export interface EvidenceInput {
11
+ evidenceKind: 'message_range' | 'file_ref' | 'import_ref' | 'url' | 'tool_output' | 'user_statement';
12
+ sourceAgent?: string;
13
+ sessionId?: string;
14
+ importArchiveId?: string;
15
+ locator?: string;
16
+ excerptHash?: string;
17
+ trustLevel: 'authoritative' | 'user_supplied' | 'third_party' | 'untrusted';
18
+ }
19
+ export interface AddMemoryInput {
20
+ kind: MemoryKind;
21
+ content: string;
22
+ scopeId: string;
23
+ authority: Authority;
24
+ createdBy: string;
25
+ confidence?: number;
26
+ sourceAgent?: string | null;
27
+ sourceSessionId?: string | null;
28
+ sourceImportBatchId?: string | null;
29
+ sourceMessageRange?: string | null;
30
+ evidence?: EvidenceInput[];
31
+ observedAt?: string | null;
32
+ validFrom?: string | null;
33
+ validTo?: string | null;
34
+ expiresAt?: string | null;
35
+ sensitivity?: Sensitivity;
36
+ /** 重要度 1-5(值不值占用注入预算);NULL 表示未判断,读取侧按 3 处理。 */
37
+ importance?: number | null;
38
+ }
39
+ export interface MemoryRecord {
40
+ id: string;
41
+ ownerId: string;
42
+ kind: MemoryKind;
43
+ content: string;
44
+ normalizedContent: string;
45
+ scopeId: string;
46
+ status: MemoryStatus;
47
+ authority: Authority;
48
+ confidence: number;
49
+ sourceAgent: string | null;
50
+ sourceSessionId: string | null;
51
+ sourceImportBatchId: string | null;
52
+ sourceMessageRange: string | null;
53
+ observedAt: string;
54
+ validFrom: string | null;
55
+ validTo: string | null;
56
+ lastVerifiedAt: string | null;
57
+ lastUsedAt: string | null;
58
+ expiresAt: string | null;
59
+ /** 重要度 1-5;NULL = 未判断(排序按 3 处理)。 */
60
+ importance: number | null;
61
+ /** 被主动请求次数(自动注入不计)。 */
62
+ usageCount: number;
63
+ sensitivity: Sensitivity;
64
+ currentRevisionId: string | null;
65
+ contentHash: string;
66
+ createdBy: string;
67
+ createdAt: string;
68
+ updatedAt: string;
69
+ }
70
+ export interface RevisionRecord {
71
+ id: string;
72
+ memoryId: string;
73
+ seq: number;
74
+ parentRevisionIds: string[];
75
+ content: string;
76
+ contentHash: string;
77
+ scopeId: string;
78
+ status: MemoryStatus;
79
+ authority: Authority;
80
+ author: string;
81
+ deviceId: string;
82
+ reason: string | null;
83
+ createdAt: string;
84
+ }
85
+ export interface EvidenceRecord {
86
+ id: string;
87
+ memoryId: string;
88
+ revisionId: string | null;
89
+ evidenceKind: EvidenceInput['evidenceKind'];
90
+ sourceAgent: string | null;
91
+ sessionId: string | null;
92
+ importArchiveId: string | null;
93
+ locator: string | null;
94
+ excerptHash: string | null;
95
+ trustLevel: EvidenceInput['trustLevel'];
96
+ createdAt: string;
97
+ }
98
+ export declare const RELATION_TYPES: readonly ["supersedes", "contradicts", "related_to"];
99
+ export type RelationType = (typeof RELATION_TYPES)[number];
100
+ export interface SearchResultRecord {
101
+ memory: MemoryRecord;
102
+ /** 命中通道:fts(索引)或 like(有界回退) */
103
+ matchedBy: 'fts' | 'like';
104
+ score: number;
105
+ /** 未解决冲突 id(当 memory.status === 'conflicted') */
106
+ conflictId?: string;
107
+ /** 未验证导入不得显示为用户确认事实(spec agent-onboarding) */
108
+ unverifiableImport: boolean;
109
+ expired: boolean;
110
+ }
111
+ export type SecretKind = 'private_key' | 'aws_access_key_id' | 'aws_secret_access_key' | 'github_token' | 'generic_api_key' | 'bearer_token' | 'jwt' | 'password_assignment' | 'connection_string';
112
+ export interface SecretFinding {
113
+ kind: SecretKind;
114
+ /** 匹配在原文中的位置;报告仅保留类型与位置摘要,不回显正文。 */
115
+ start: number;
116
+ end: number;
117
+ /** 打码摘要:只暴露首尾各 2 字符,中间用 *** 代替。 */
118
+ masked: string;
119
+ }
120
+ export type InjectionKind = 'ignore_instructions' | 'exfiltrate_memory' | 'escalate_scope' | 'role_override' | 'fake_approval';
121
+ export interface InjectionFinding {
122
+ kind: InjectionKind;
123
+ start: number;
124
+ end: number;
125
+ /** 命中的规则名(不含正文)。 */
126
+ rule: string;
127
+ }
128
+ export interface SecretScanResult {
129
+ findings: SecretFinding[];
130
+ injectionFindings: InjectionFinding[];
131
+ clean: boolean;
132
+ }
133
+ /**
134
+ * 秘密/注入扫描器契约。任何进入 Agent 批次、计划应用、投影或 outbox
135
+ * 的不可信文本都必须先经过本入口(memory-governance spec)。
136
+ */
137
+ export interface SecretScanner {
138
+ scan(text: string): SecretScanResult;
139
+ }
@@ -0,0 +1,30 @@
1
+ /** Cairn 领域类型——所有模块共享的唯一事实源。 */
2
+ // ---------------------------------------------------------------------------
3
+ // 记忆本体
4
+ // ---------------------------------------------------------------------------
5
+ export const MEMORY_KINDS = [
6
+ 'instruction',
7
+ 'preference',
8
+ 'fact',
9
+ 'decision',
10
+ 'episode',
11
+ 'procedure',
12
+ 'environment',
13
+ 'lesson',
14
+ ];
15
+ export const MEMORY_STATUSES = [
16
+ 'candidate',
17
+ 'active',
18
+ 'conflicted',
19
+ 'superseded',
20
+ 'archived',
21
+ 'tombstoned',
22
+ ];
23
+ export const AUTHORITIES = [
24
+ 'user_explicit',
25
+ 'user_confirmed',
26
+ 'agent_inferred',
27
+ 'imported_unverified',
28
+ ];
29
+ export const RELATION_TYPES = ['supersedes', 'contradicts', 'related_to'];
30
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,YAAY;IACZ,MAAM;IACN,UAAU;IACV,SAAS;IACT,WAAW;IACX,aAAa;IACb,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,YAAY;CACJ,CAAC;AAGX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,qBAAqB;CACb,CAAC;AAmGX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC"}