memorix 1.2.2 → 1.2.4

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 (163) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +3 -3
  3. package/README.zh-CN.md +3 -3
  4. package/TEAM.md +86 -86
  5. package/dist/cli/index.js +5199 -4726
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/index.js +428 -49
  8. package/dist/index.js.map +1 -1
  9. package/dist/maintenance-runner.js +97 -18
  10. package/dist/maintenance-runner.js.map +1 -1
  11. package/dist/memcode-runtime/CHANGELOG.md +27 -0
  12. package/dist/sdk.js +428 -49
  13. package/dist/sdk.js.map +1 -1
  14. package/docs/1.2.4-PERSISTENT-MEMORY-DELIVERY.md +86 -0
  15. package/docs/AGENT_OPERATOR_PLAYBOOK.md +13 -1
  16. package/docs/API_REFERENCE.md +13 -3
  17. package/docs/DESIGN_DECISIONS.md +357 -357
  18. package/docs/dev-log/progress.txt +60 -9
  19. package/package.json +1 -1
  20. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  21. package/src/audit/index.ts +156 -156
  22. package/src/cli/capability-map.ts +1 -1
  23. package/src/cli/command-guide.ts +4 -1
  24. package/src/cli/commands/agent-integrations.ts +5 -1
  25. package/src/cli/commands/audit-list.ts +89 -89
  26. package/src/cli/commands/background.ts +659 -659
  27. package/src/cli/commands/codegraph.ts +1 -1
  28. package/src/cli/commands/context.ts +9 -1
  29. package/src/cli/commands/formation.ts +48 -48
  30. package/src/cli/commands/git-hook-install.ts +111 -111
  31. package/src/cli/commands/handoff.ts +54 -54
  32. package/src/cli/commands/hooks-status.ts +63 -63
  33. package/src/cli/commands/ingest-commit.ts +153 -153
  34. package/src/cli/commands/ingest-image.ts +66 -66
  35. package/src/cli/commands/ingest-log.ts +180 -180
  36. package/src/cli/commands/ingest.ts +44 -44
  37. package/src/cli/commands/integrate-shared.ts +15 -15
  38. package/src/cli/commands/lock.ts +82 -82
  39. package/src/cli/commands/message.ts +104 -104
  40. package/src/cli/commands/poll.ts +58 -58
  41. package/src/cli/commands/purge-all-memory.ts +85 -85
  42. package/src/cli/commands/purge-project-memory.ts +83 -83
  43. package/src/cli/commands/reasoning.ts +118 -118
  44. package/src/cli/commands/resume.ts +31 -0
  45. package/src/cli/commands/serve-shared.ts +118 -118
  46. package/src/cli/commands/session.ts +15 -7
  47. package/src/cli/commands/skills.ts +114 -114
  48. package/src/cli/commands/task.ts +167 -167
  49. package/src/cli/commands/transfer.ts +47 -47
  50. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  51. package/src/cli/index.ts +3 -1
  52. package/src/cli/tui/ChatView.tsx +234 -234
  53. package/src/cli/tui/CommandBar.tsx +312 -312
  54. package/src/cli/tui/ContextRail.tsx +118 -118
  55. package/src/cli/tui/HeaderBar.tsx +72 -72
  56. package/src/cli/tui/LogoBanner.tsx +51 -51
  57. package/src/cli/tui/Sidebar.tsx +179 -179
  58. package/src/cli/tui/index.ts +41 -41
  59. package/src/cli/tui/markdown-render.tsx +371 -371
  60. package/src/cli/tui/session-service.ts +3 -2
  61. package/src/cli/tui/use-mouse.ts +157 -157
  62. package/src/cli/tui/useNavigation.ts +56 -56
  63. package/src/cli/update-checker.ts +211 -211
  64. package/src/cli/version.ts +7 -7
  65. package/src/cli/workbench.ts +1 -1
  66. package/src/codegraph/auto-context.ts +54 -1
  67. package/src/codegraph/task-lens.ts +29 -0
  68. package/src/compact/token-budget.ts +89 -74
  69. package/src/config/toml-loader.ts +9 -5
  70. package/src/dashboard/project-classification.ts +64 -64
  71. package/src/embedding/fastembed-provider.ts +142 -142
  72. package/src/embedding/transformers-provider.ts +111 -111
  73. package/src/git/extractor.ts +209 -209
  74. package/src/git/hooks-path.ts +85 -85
  75. package/src/hooks/handler.ts +127 -66
  76. package/src/hooks/installers/index.ts +5 -4
  77. package/src/hooks/official-skills.ts +6 -4
  78. package/src/hooks/pattern-detector.ts +173 -173
  79. package/src/hooks/rules/memorix-agent-rules.md +9 -7
  80. package/src/hooks/significance-filter.ts +250 -250
  81. package/src/knowledge/context-assembly.ts +4 -1
  82. package/src/knowledge/workset.ts +89 -1
  83. package/src/llm/memory-manager.ts +328 -328
  84. package/src/llm/provider.ts +885 -885
  85. package/src/llm/quality.ts +248 -248
  86. package/src/memory/attribution-guard.ts +249 -249
  87. package/src/memory/disclosure-policy.ts +135 -135
  88. package/src/memory/entity-extractor.ts +197 -197
  89. package/src/memory/formation/evaluate.ts +217 -217
  90. package/src/memory/formation/extract.ts +361 -361
  91. package/src/memory/formation/index.ts +417 -417
  92. package/src/memory/formation/resolve.ts +344 -344
  93. package/src/memory/formation/types.ts +315 -315
  94. package/src/memory/freshness.ts +122 -122
  95. package/src/memory/graph.ts +197 -197
  96. package/src/memory/refs.ts +94 -94
  97. package/src/memory/secret-filter.ts +79 -79
  98. package/src/memory/session.ts +158 -9
  99. package/src/multimodal/image-loader.ts +143 -143
  100. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  101. package/src/orchestrate/adapters/claude.ts +111 -111
  102. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  103. package/src/orchestrate/adapters/codex.ts +41 -41
  104. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  105. package/src/orchestrate/adapters/gemini.ts +42 -42
  106. package/src/orchestrate/adapters/index.ts +73 -73
  107. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  108. package/src/orchestrate/adapters/opencode.ts +47 -47
  109. package/src/orchestrate/adapters/spawn-helper.ts +286 -286
  110. package/src/orchestrate/adapters/types.ts +77 -77
  111. package/src/orchestrate/capability-router.ts +284 -284
  112. package/src/orchestrate/context-compact.ts +188 -188
  113. package/src/orchestrate/cost-tracker.ts +219 -219
  114. package/src/orchestrate/error-recovery.ts +191 -191
  115. package/src/orchestrate/evidence.ts +140 -140
  116. package/src/orchestrate/ledger.ts +110 -110
  117. package/src/orchestrate/memorix-bridge.ts +343 -343
  118. package/src/orchestrate/output-budget.ts +80 -80
  119. package/src/orchestrate/permission.ts +152 -152
  120. package/src/orchestrate/pipeline-trace.ts +131 -131
  121. package/src/orchestrate/prompt-builder.ts +155 -155
  122. package/src/orchestrate/ring-buffer.ts +37 -37
  123. package/src/orchestrate/task-graph.ts +389 -389
  124. package/src/orchestrate/worktree.ts +232 -232
  125. package/src/project/aliases.ts +374 -374
  126. package/src/project/detector.ts +268 -268
  127. package/src/rules/adapters/claude-code.ts +99 -99
  128. package/src/rules/adapters/codex.ts +97 -97
  129. package/src/rules/adapters/copilot.ts +124 -124
  130. package/src/rules/adapters/cursor.ts +114 -114
  131. package/src/rules/adapters/kiro.ts +126 -126
  132. package/src/rules/adapters/trae.ts +56 -56
  133. package/src/rules/adapters/windsurf.ts +83 -83
  134. package/src/rules/syncer.ts +235 -235
  135. package/src/sdk.ts +299 -299
  136. package/src/search/intent-detector.ts +289 -289
  137. package/src/search/query-expansion.ts +52 -52
  138. package/src/server/formation-timeout.ts +27 -27
  139. package/src/server.ts +144 -10
  140. package/src/skills/mini-skills.ts +386 -386
  141. package/src/store/bun-sqlite-compat.ts +118 -15
  142. package/src/store/chat-store.ts +119 -119
  143. package/src/store/graph-store.ts +249 -249
  144. package/src/store/mini-skill-store.ts +349 -349
  145. package/src/store/persistence-json.ts +212 -212
  146. package/src/store/persistence.ts +291 -291
  147. package/src/store/project-affinity.ts +195 -195
  148. package/src/store/sqlite-db.ts +3 -3
  149. package/src/team/event-bus.ts +76 -76
  150. package/src/team/file-locks.ts +173 -173
  151. package/src/team/handoff.ts +161 -161
  152. package/src/team/messages.ts +203 -203
  153. package/src/team/poll.ts +132 -132
  154. package/src/team/tasks.ts +211 -211
  155. package/src/workspace/mcp-adapters/codex.ts +191 -191
  156. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  157. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  158. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  159. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  160. package/src/workspace/mcp-adapters/trae.ts +134 -134
  161. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  162. package/src/workspace/sanitizer.ts +60 -60
  163. package/src/workspace/workflow-sync.ts +131 -131
@@ -9,85 +9,85 @@
9
9
  * Set MEMORIX_AUTO_UPDATE=install to opt into silent background install.
10
10
  * Disable via MEMORIX_AUTO_UPDATE=off.
11
11
  */
12
-
13
- import { execFile } from 'node:child_process';
14
- import type { ExecFileException } from 'node:child_process';
15
- import { readFile, writeFile, mkdir } from 'node:fs/promises';
16
- import { join } from 'node:path';
17
- import { homedir } from 'node:os';
18
- import { getCliVersion } from './version.js';
19
-
20
- const PACKAGE_NAME = 'memorix';
21
- const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
22
- const DEFAULT_AUTO_UPDATE_TIMEOUT_MS = 5 * 60 * 1000;
23
- const MIN_AUTO_UPDATE_TIMEOUT_MS = 5_000;
24
- const MAX_AUTO_UPDATE_TIMEOUT_MS = 30 * 60 * 1000;
25
- const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
26
- const CACHE_DIR = join(homedir(), '.memorix');
27
- const CACHE_FILE = join(CACHE_DIR, 'update-check.json');
28
-
12
+
13
+ import { execFile } from 'node:child_process';
14
+ import type { ExecFileException } from 'node:child_process';
15
+ import { readFile, writeFile, mkdir } from 'node:fs/promises';
16
+ import { join } from 'node:path';
17
+ import { homedir } from 'node:os';
18
+ import { getCliVersion } from './version.js';
19
+
20
+ const PACKAGE_NAME = 'memorix';
21
+ const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
22
+ const DEFAULT_AUTO_UPDATE_TIMEOUT_MS = 5 * 60 * 1000;
23
+ const MIN_AUTO_UPDATE_TIMEOUT_MS = 5_000;
24
+ const MAX_AUTO_UPDATE_TIMEOUT_MS = 30 * 60 * 1000;
25
+ const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
26
+ const CACHE_DIR = join(homedir(), '.memorix');
27
+ const CACHE_FILE = join(CACHE_DIR, 'update-check.json');
28
+
29
29
  export interface UpdateCache {
30
- lastCheck: number;
31
- latestVersion: string;
32
- lastAutoUpdate?: number;
33
- lastAutoUpdateStatus?: 'success' | 'failed';
34
- lastAutoUpdateError?: string;
35
- lastAutoUpdateTimedOut?: boolean;
36
- lastAutoUpdateExitCode?: number | null;
37
- lastAutoUpdateSignal?: string | null;
38
- lastAutoUpdateTimeoutMs?: number;
39
- updatedFrom?: string;
40
- updatedTo?: string;
30
+ lastCheck: number;
31
+ latestVersion: string;
32
+ lastAutoUpdate?: number;
33
+ lastAutoUpdateStatus?: 'success' | 'failed';
34
+ lastAutoUpdateError?: string;
35
+ lastAutoUpdateTimedOut?: boolean;
36
+ lastAutoUpdateExitCode?: number | null;
37
+ lastAutoUpdateSignal?: string | null;
38
+ lastAutoUpdateTimeoutMs?: number;
39
+ updatedFrom?: string;
40
+ updatedTo?: string;
41
41
  }
42
42
 
43
43
  export type AutoUpdateMode = 'off' | 'notify' | 'install';
44
-
45
- /**
46
- * Get the current installed version from package.json.
47
- */
48
- export function getCurrentVersion(): string {
49
- try {
50
- return getCliVersion();
51
- } catch {
52
- return '0.0.0';
53
- }
54
- }
55
-
56
- /**
57
- * Compare two semver strings. Returns true if remote > local.
58
- */
59
- export function isNewer(remote: string, local: string): boolean {
60
- const r = remote.split('.').map(Number);
61
- const l = local.split('.').map(Number);
62
- for (let i = 0; i < 3; i++) {
63
- if ((r[i] ?? 0) > (l[i] ?? 0)) return true;
64
- if ((r[i] ?? 0) < (l[i] ?? 0)) return false;
65
- }
66
- return false;
67
- }
68
-
69
- /**
70
- * Read the update check cache. Exported for doctor/status display.
71
- */
72
- export async function readCache(): Promise<UpdateCache | null> {
73
- try {
74
- const data = await readFile(CACHE_FILE, 'utf-8');
75
- return JSON.parse(data);
76
- } catch {
77
- return null;
78
- }
79
- }
80
-
81
- /**
82
- * Write the update check cache.
83
- */
84
- async function writeCache(cache: UpdateCache): Promise<void> {
85
- try {
86
- await mkdir(CACHE_DIR, { recursive: true });
87
- await writeFile(CACHE_FILE, JSON.stringify(cache, null, 2), 'utf-8');
88
- } catch { /* silent */ }
89
- }
90
-
44
+
45
+ /**
46
+ * Get the current installed version from package.json.
47
+ */
48
+ export function getCurrentVersion(): string {
49
+ try {
50
+ return getCliVersion();
51
+ } catch {
52
+ return '0.0.0';
53
+ }
54
+ }
55
+
56
+ /**
57
+ * Compare two semver strings. Returns true if remote > local.
58
+ */
59
+ export function isNewer(remote: string, local: string): boolean {
60
+ const r = remote.split('.').map(Number);
61
+ const l = local.split('.').map(Number);
62
+ for (let i = 0; i < 3; i++) {
63
+ if ((r[i] ?? 0) > (l[i] ?? 0)) return true;
64
+ if ((r[i] ?? 0) < (l[i] ?? 0)) return false;
65
+ }
66
+ return false;
67
+ }
68
+
69
+ /**
70
+ * Read the update check cache. Exported for doctor/status display.
71
+ */
72
+ export async function readCache(): Promise<UpdateCache | null> {
73
+ try {
74
+ const data = await readFile(CACHE_FILE, 'utf-8');
75
+ return JSON.parse(data);
76
+ } catch {
77
+ return null;
78
+ }
79
+ }
80
+
81
+ /**
82
+ * Write the update check cache.
83
+ */
84
+ async function writeCache(cache: UpdateCache): Promise<void> {
85
+ try {
86
+ await mkdir(CACHE_DIR, { recursive: true });
87
+ await writeFile(CACHE_FILE, JSON.stringify(cache, null, 2), 'utf-8');
88
+ } catch { /* silent */ }
89
+ }
90
+
91
91
  /**
92
92
  * Parse MEMORIX_AUTO_UPDATE into an explicit mode.
93
93
  * Default: notify-only.
@@ -99,105 +99,105 @@ function parseAutoUpdateMode(raw: string | undefined): AutoUpdateMode {
99
99
  if (env === 'install' || env === 'true' || env === '1') return 'install';
100
100
  return 'notify';
101
101
  }
102
-
103
- function parseAutoUpdateTimeoutMs(raw: string | undefined): number {
104
- const value = raw?.trim();
105
- if (!value) return DEFAULT_AUTO_UPDATE_TIMEOUT_MS;
106
- const parsed = Number(value);
107
- if (!Number.isFinite(parsed)) return DEFAULT_AUTO_UPDATE_TIMEOUT_MS;
108
- return Math.max(MIN_AUTO_UPDATE_TIMEOUT_MS, Math.min(MAX_AUTO_UPDATE_TIMEOUT_MS, Math.floor(parsed)));
109
- }
110
-
111
- function describeAutoUpdateFailure(error: ExecFileException, timeoutMs: number): {
112
- message: string;
113
- timedOut: boolean;
114
- exitCode: number | null;
115
- signal: string | null;
116
- } {
117
- const timedOut = /timed out/i.test(error.message);
118
- const exitCode = typeof error.code === 'number' ? error.code : null;
119
- const signal = typeof error.signal === 'string' ? error.signal : null;
120
- const details: string[] = [];
121
- if (timedOut) details.push(`timeout ${timeoutMs}ms`);
122
- if (exitCode !== null) details.push(`exit code ${exitCode}`);
123
- if (signal) details.push(`signal ${signal}`);
124
- return {
125
- message: details.length > 0 ? `${error.message} (${details.join(', ')})` : error.message,
126
- timedOut,
127
- exitCode,
128
- signal,
129
- };
130
- }
131
-
132
- /**
133
- * Fetch the latest version from npm registry.
134
- * Uses native https to avoid dependencies. Timeout: 5s.
135
- */
136
- async function fetchLatestVersion(): Promise<string | null> {
137
- try {
138
- const { default: https } = await import('node:https');
139
- return new Promise((resolve) => {
140
- const req = https.get(REGISTRY_URL, { timeout: 5000 }, (res) => {
141
- if (res.statusCode !== 200) { resolve(null); return; }
142
- let body = '';
143
- res.on('data', (chunk: Buffer) => { body += chunk.toString(); });
144
- res.on('end', () => {
145
- try {
146
- const data = JSON.parse(body);
147
- resolve(data.version ?? null);
148
- } catch { resolve(null); }
149
- });
150
- });
151
- req.on('error', () => resolve(null));
152
- req.on('timeout', () => { req.destroy(); resolve(null); });
153
- });
154
- } catch {
155
- return null;
156
- }
157
- }
158
-
159
- /**
160
- * Silently install the latest version in the background.
161
- * Writes result to the cache file so doctor/status can report it.
162
- */
163
- function installUpdateInBackground(targetVersion: string, currentVersion: string, cache: UpdateCache): void {
164
- try {
165
- const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
166
- const timeoutMs = parseAutoUpdateTimeoutMs(process.env.MEMORIX_AUTO_UPDATE_TIMEOUT_MS);
167
- const child = execFile(
168
- npmCmd,
169
- ['install', '-g', `${PACKAGE_NAME}@${targetVersion}`],
170
- { timeout: timeoutMs },
171
- async (error) => {
172
- const failure = error ? describeAutoUpdateFailure(error, timeoutMs) : null;
173
- const updatedCache: UpdateCache = {
174
- ...cache,
175
- lastAutoUpdate: Date.now(),
176
- updatedFrom: currentVersion,
177
- updatedTo: targetVersion,
178
- lastAutoUpdateStatus: error ? 'failed' : 'success',
179
- lastAutoUpdateError: failure?.message,
180
- lastAutoUpdateTimedOut: failure?.timedOut,
181
- lastAutoUpdateExitCode: failure?.exitCode,
182
- lastAutoUpdateSignal: failure?.signal,
183
- lastAutoUpdateTimeoutMs: timeoutMs,
184
- };
185
- await writeCache(updatedCache);
186
- if (error) {
187
- console.error(`[memorix] Auto-update failed: ${failure?.message ?? error.message}`);
188
- } else {
189
- console.error(`[memorix] Auto-updated to v${targetVersion} — restart to apply`);
190
- }
191
- },
192
- );
193
- // Unref so the child process doesn't prevent the main process from exiting
194
- child.unref();
195
- } catch (err) {
196
- console.error(`[memorix] Auto-update spawn failed:`, (err as Error)?.message ?? err);
197
- }
198
- }
199
-
200
- /**
102
+
103
+ function parseAutoUpdateTimeoutMs(raw: string | undefined): number {
104
+ const value = raw?.trim();
105
+ if (!value) return DEFAULT_AUTO_UPDATE_TIMEOUT_MS;
106
+ const parsed = Number(value);
107
+ if (!Number.isFinite(parsed)) return DEFAULT_AUTO_UPDATE_TIMEOUT_MS;
108
+ return Math.max(MIN_AUTO_UPDATE_TIMEOUT_MS, Math.min(MAX_AUTO_UPDATE_TIMEOUT_MS, Math.floor(parsed)));
109
+ }
110
+
111
+ function describeAutoUpdateFailure(error: ExecFileException, timeoutMs: number): {
112
+ message: string;
113
+ timedOut: boolean;
114
+ exitCode: number | null;
115
+ signal: string | null;
116
+ } {
117
+ const timedOut = /timed out/i.test(error.message);
118
+ const exitCode = typeof error.code === 'number' ? error.code : null;
119
+ const signal = typeof error.signal === 'string' ? error.signal : null;
120
+ const details: string[] = [];
121
+ if (timedOut) details.push(`timeout ${timeoutMs}ms`);
122
+ if (exitCode !== null) details.push(`exit code ${exitCode}`);
123
+ if (signal) details.push(`signal ${signal}`);
124
+ return {
125
+ message: details.length > 0 ? `${error.message} (${details.join(', ')})` : error.message,
126
+ timedOut,
127
+ exitCode,
128
+ signal,
129
+ };
130
+ }
131
+
132
+ /**
133
+ * Fetch the latest version from npm registry.
134
+ * Uses native https to avoid dependencies. Timeout: 5s.
135
+ */
136
+ async function fetchLatestVersion(): Promise<string | null> {
137
+ try {
138
+ const { default: https } = await import('node:https');
139
+ return new Promise((resolve) => {
140
+ const req = https.get(REGISTRY_URL, { timeout: 5000 }, (res) => {
141
+ if (res.statusCode !== 200) { resolve(null); return; }
142
+ let body = '';
143
+ res.on('data', (chunk: Buffer) => { body += chunk.toString(); });
144
+ res.on('end', () => {
145
+ try {
146
+ const data = JSON.parse(body);
147
+ resolve(data.version ?? null);
148
+ } catch { resolve(null); }
149
+ });
150
+ });
151
+ req.on('error', () => resolve(null));
152
+ req.on('timeout', () => { req.destroy(); resolve(null); });
153
+ });
154
+ } catch {
155
+ return null;
156
+ }
157
+ }
158
+
159
+ /**
160
+ * Silently install the latest version in the background.
161
+ * Writes result to the cache file so doctor/status can report it.
162
+ */
163
+ function installUpdateInBackground(targetVersion: string, currentVersion: string, cache: UpdateCache): void {
164
+ try {
165
+ const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
166
+ const timeoutMs = parseAutoUpdateTimeoutMs(process.env.MEMORIX_AUTO_UPDATE_TIMEOUT_MS);
167
+ const child = execFile(
168
+ npmCmd,
169
+ ['install', '-g', `${PACKAGE_NAME}@${targetVersion}`],
170
+ { timeout: timeoutMs },
171
+ async (error) => {
172
+ const failure = error ? describeAutoUpdateFailure(error, timeoutMs) : null;
173
+ const updatedCache: UpdateCache = {
174
+ ...cache,
175
+ lastAutoUpdate: Date.now(),
176
+ updatedFrom: currentVersion,
177
+ updatedTo: targetVersion,
178
+ lastAutoUpdateStatus: error ? 'failed' : 'success',
179
+ lastAutoUpdateError: failure?.message,
180
+ lastAutoUpdateTimedOut: failure?.timedOut,
181
+ lastAutoUpdateExitCode: failure?.exitCode,
182
+ lastAutoUpdateSignal: failure?.signal,
183
+ lastAutoUpdateTimeoutMs: timeoutMs,
184
+ };
185
+ await writeCache(updatedCache);
186
+ if (error) {
187
+ console.error(`[memorix] Auto-update failed: ${failure?.message ?? error.message}`);
188
+ } else {
189
+ console.error(`[memorix] Auto-updated to v${targetVersion} — restart to apply`);
190
+ }
191
+ },
192
+ );
193
+ // Unref so the child process doesn't prevent the main process from exiting
194
+ child.unref();
195
+ } catch (err) {
196
+ console.error(`[memorix] Auto-update spawn failed:`, (err as Error)?.message ?? err);
197
+ }
198
+ }
199
+
200
+ /**
201
201
  * Run the background update check.
202
202
  *
203
203
  * Call this fire-and-forget from entry points (serve-http, TUI).
@@ -215,32 +215,32 @@ export async function checkForUpdates(): Promise<void> {
215
215
 
216
216
  const cache = await readCache();
217
217
  const now = Date.now();
218
-
219
- // Rate limit: skip if checked within the last 24 hours
220
- if (cache && (now - cache.lastCheck) < CHECK_INTERVAL_MS) {
221
- return;
222
- }
223
-
224
- const latestVersion = await fetchLatestVersion();
225
- if (!latestVersion) return;
226
-
227
- const currentVersion = getCurrentVersion();
228
-
229
- // Update cache with check timestamp
230
- const updatedCache: UpdateCache = {
231
- lastCheck: now,
232
- latestVersion,
233
- lastAutoUpdate: cache?.lastAutoUpdate,
234
- lastAutoUpdateStatus: cache?.lastAutoUpdateStatus,
235
- lastAutoUpdateError: cache?.lastAutoUpdateError,
236
- lastAutoUpdateTimedOut: cache?.lastAutoUpdateTimedOut,
237
- lastAutoUpdateExitCode: cache?.lastAutoUpdateExitCode,
238
- lastAutoUpdateSignal: cache?.lastAutoUpdateSignal,
239
- lastAutoUpdateTimeoutMs: cache?.lastAutoUpdateTimeoutMs,
240
- updatedFrom: cache?.updatedFrom,
241
- updatedTo: cache?.updatedTo,
242
- };
243
- await writeCache(updatedCache);
218
+
219
+ // Rate limit: skip if checked within the last 24 hours
220
+ if (cache && (now - cache.lastCheck) < CHECK_INTERVAL_MS) {
221
+ return;
222
+ }
223
+
224
+ const latestVersion = await fetchLatestVersion();
225
+ if (!latestVersion) return;
226
+
227
+ const currentVersion = getCurrentVersion();
228
+
229
+ // Update cache with check timestamp
230
+ const updatedCache: UpdateCache = {
231
+ lastCheck: now,
232
+ latestVersion,
233
+ lastAutoUpdate: cache?.lastAutoUpdate,
234
+ lastAutoUpdateStatus: cache?.lastAutoUpdateStatus,
235
+ lastAutoUpdateError: cache?.lastAutoUpdateError,
236
+ lastAutoUpdateTimedOut: cache?.lastAutoUpdateTimedOut,
237
+ lastAutoUpdateExitCode: cache?.lastAutoUpdateExitCode,
238
+ lastAutoUpdateSignal: cache?.lastAutoUpdateSignal,
239
+ lastAutoUpdateTimeoutMs: cache?.lastAutoUpdateTimeoutMs,
240
+ updatedFrom: cache?.updatedFrom,
241
+ updatedTo: cache?.updatedTo,
242
+ };
243
+ await writeCache(updatedCache);
244
244
 
245
245
  if (isNewer(latestVersion, currentVersion)) {
246
246
  if (mode === 'install') {
@@ -254,12 +254,12 @@ export async function checkForUpdates(): Promise<void> {
254
254
  }
255
255
  } catch {
256
256
  // Entire update check is best-effort — never crash the caller
257
- }
258
- }
259
-
260
- // ── Test helpers (exported for testing only) ──────────────────
261
-
262
- /** @internal */
257
+ }
258
+ }
259
+
260
+ // ── Test helpers (exported for testing only) ──────────────────
261
+
262
+ /** @internal */
263
263
  export const _testing = {
264
264
  CACHE_FILE,
265
265
  CHECK_INTERVAL_MS,
@@ -268,8 +268,8 @@ export const _testing = {
268
268
  parseAutoUpdateTimeoutMs,
269
269
  describeAutoUpdateFailure,
270
270
  fetchLatestVersion,
271
- installUpdateInBackground,
272
- writeCache,
273
- isNewer,
274
- getCurrentVersion,
275
- };
271
+ installUpdateInBackground,
272
+ writeCache,
273
+ isNewer,
274
+ getCurrentVersion,
275
+ };
@@ -1,7 +1,7 @@
1
- import pkg from '../../package.json';
2
-
3
- export function getCliVersion(): string {
4
- return typeof __MEMORIX_VERSION__ !== 'undefined'
5
- ? __MEMORIX_VERSION__
6
- : pkg.version;
7
- }
1
+ import pkg from '../../package.json';
2
+
3
+ export function getCliVersion(): string {
4
+ return typeof __MEMORIX_VERSION__ !== 'undefined'
5
+ ? __MEMORIX_VERSION__
6
+ : pkg.version;
7
+ }
@@ -5,4 +5,4 @@
5
5
  * Kept for backward-compat: `import { startWorkbench } from './workbench.js'`
6
6
  */
7
7
 
8
- export { startWorkbench } from './tui/index.js';
8
+ export { startWorkbench } from './tui/index.js';
@@ -1,9 +1,11 @@
1
1
  import { existsSync, statSync } from 'node:fs';
2
2
  import path from 'node:path';
3
+ import { truncateToTokenBudget } from '../compact/token-budget.js';
3
4
  import { getResolvedConfig } from '../config/resolved-config.js';
4
5
  import { buildTaskWorkset, type TaskWorkset, type WorksetCaution } from '../knowledge/workset.js';
5
6
  import type { ContextDeliveryTarget } from '../knowledge/context-assembly.js';
6
- import type { ProjectInfo } from '../types.js';
7
+ import { sanitizeCredentials } from '../memory/secret-filter.js';
8
+ import type { ObservationReader, ProjectInfo } from '../types.js';
7
9
  import { backfillMissingObservationCodeRefs, type CodeRefBackfillResult } from './binder.js';
8
10
  import { collectCurrentProjectFacts, formatGitFact, type CurrentProjectFacts } from './current-facts.js';
9
11
  import { refreshProjectLite } from './lite-provider.js';
@@ -21,7 +23,10 @@ import {
21
23
  } from './project-context.js';
22
24
  import { CodeGraphStore } from './store.js';
23
25
  import { isEligibleForAutomaticDelivery } from '../memory/admission.js';
26
+ import { getSessionResumeBrief, type SessionResumeBrief } from '../memory/session.js';
27
+ import { initSessionStore } from '../store/session-store.js';
24
28
  import {
29
+ isContinuationTask,
25
30
  lensPathCandidates,
26
31
  lensVerificationHints,
27
32
  rankLensPaths,
@@ -50,6 +55,8 @@ export interface AutoProjectContext {
50
55
  explain: ProjectContextExplain;
51
56
  refresh: AutoContextRefreshResult;
52
57
  providerQuality: CodeGraphProviderQuality;
58
+ /** Present only when the caller asked to continue prior work. */
59
+ continuation?: SessionResumeBrief;
53
60
  workset: TaskWorkset;
54
61
  }
55
62
 
@@ -123,6 +130,10 @@ export async function buildAutoProjectContext(input: {
123
130
  maxFileBytes?: number;
124
131
  /** Test-only injection point; production uses the bounded local runner. */
125
132
  externalRunner?: ExternalCodeGraphRunner;
133
+ /** Reader used when continuation retrieval loads session and durable memory evidence. */
134
+ reader?: ObservationReader;
135
+ /** Auto detects continuation language; always is used by the explicit resume path. */
136
+ continuation?: 'auto' | 'always' | 'never';
126
137
  /**
127
138
  * When supplied, a needed refresh is queued instead of running in this
128
139
  * request. MCP and hook callers use this to keep their response path fast.
@@ -135,6 +146,8 @@ export async function buildAutoProjectContext(input: {
135
146
  const now = input.now ?? new Date();
136
147
  const task = input.task?.trim();
137
148
  const lens = resolveTaskLens(task);
149
+ const continuationRequested = input.continuation === 'always'
150
+ || (input.continuation !== 'never' && isContinuationTask(task));
138
151
  const codegraphConfig = getResolvedConfig({ projectRoot: input.project.rootPath }).codegraph;
139
152
  const exclude = input.exclude ?? codegraphConfig.excludePatterns;
140
153
  const maxFileBytes = input.maxFileBytes ?? codegraphConfig.maxFileBytes;
@@ -278,6 +291,14 @@ export async function buildAutoProjectContext(input: {
278
291
  if (externalCaution) {
279
292
  runtimeCautions.push({ kind: 'external-codegraph-fallback', message: externalCaution });
280
293
  }
294
+ // Project Context is also used by lightweight callers that have not touched
295
+ // session APIs yet. Initialize only when continuation was requested so a
296
+ // normal Workset remains independent of session persistence.
297
+ let continuation: SessionResumeBrief | undefined;
298
+ if (continuationRequested) {
299
+ await initSessionStore(input.dataDir);
300
+ continuation = await getSessionResumeBrief(input.project.id, task, input.reader);
301
+ }
281
302
  const workset = await buildTaskWorkset({
282
303
  projectId: input.project.id,
283
304
  dataDir: input.dataDir,
@@ -287,6 +308,7 @@ export async function buildAutoProjectContext(input: {
287
308
  ...(externalOutline ? { semanticCode: externalOutline } : {}),
288
309
  providerQuality,
289
310
  currentFacts: worksetFactLines(currentFacts),
311
+ ...(continuation ? { continuation } : {}),
290
312
  codeState: codeStateLine(overview),
291
313
  reliableMemory: sourceSets.reliableSources
292
314
  .slice(0, lens.sourceLimit)
@@ -340,6 +362,7 @@ export async function buildAutoProjectContext(input: {
340
362
  explain,
341
363
  refresh,
342
364
  providerQuality,
365
+ ...(continuationRequested && workset.continuation ? { continuation: workset.continuation } : {}),
343
366
  workset,
344
367
  };
345
368
  }
@@ -350,6 +373,13 @@ function formatLanguages(overview: ProjectContextOverview): string {
350
373
  : 'none indexed yet';
351
374
  }
352
375
 
376
+ function compactContinuationText(text: string, budget: number): string {
377
+ return truncateToTokenBudget(
378
+ sanitizeCredentials(text).replace(/\s+/g, ' ').trim(),
379
+ budget,
380
+ );
381
+ }
382
+
353
383
  function codeStateLine(overview: ProjectContextOverview): string {
354
384
  const snapshot = overview.code.latestSnapshot;
355
385
  if (!snapshot) return '- Code state: no completed snapshot yet';
@@ -533,6 +563,29 @@ export function formatAutoProjectContextSummary(context: AutoProjectContext): st
533
563
  : '- none yet',
534
564
  );
535
565
 
566
+ const continuation = context.workset.continuation;
567
+ if (continuation?.previousSession || continuation?.memories.length) {
568
+ lines.push('', 'Resume from prior work');
569
+ if (continuation.previousSession) {
570
+ const session = continuation.previousSession;
571
+ const source = [session.agent, session.endedAt ? session.endedAt.slice(0, 10) : undefined]
572
+ .filter(Boolean)
573
+ .join(', ');
574
+ lines.push(
575
+ '- Previous session' + (source ? ` (${source})` : '') + ': '
576
+ + compactContinuationText(session.summary, 44),
577
+ );
578
+ }
579
+ for (const memory of continuation.memories.slice(0, 3)) {
580
+ const detail = memory.detail ? ': ' + compactContinuationText(memory.detail, 20) : '';
581
+ lines.push(
582
+ '- #' + memory.id + ' ' + memory.type + ': '
583
+ + compactContinuationText(memory.title, 18)
584
+ + detail,
585
+ );
586
+ }
587
+ }
588
+
536
589
  return lines.join('\n');
537
590
  }
538
591
 
@@ -121,6 +121,7 @@ const KEYWORDS: Record<Exclude<TaskLensId, 'general'>, string[]> = {
121
121
  'fail',
122
122
  'failing',
123
123
  'fix',
124
+ 'fixing',
124
125
  'issue',
125
126
  'regression',
126
127
  'repro',
@@ -139,6 +140,22 @@ const KEYWORDS: Record<Exclude<TaskLensId, 'general'>, string[]> = {
139
140
  test: ['coverage', 'fixture', 'smoke', 'spec', 'test', 'tests', 'testing', 'vitest', '测试'],
140
141
  };
141
142
 
143
+ // Continuation is a delivery intent, not a task lens. A request can both resume
144
+ // prior work and be a bugfix, feature, or release task, so callers keep the
145
+ // normal lens and add a bounded prior-work projection separately.
146
+ const CONTINUATION_KEYWORDS = [
147
+ 'continue',
148
+ 'resume',
149
+ 'pick up',
150
+ 'carry on',
151
+ 'previous session',
152
+ '继续',
153
+ '接手',
154
+ '恢复',
155
+ '延续',
156
+ '上次会话',
157
+ ];
158
+
142
159
  const LENS_PRIORITY: Exclude<TaskLensId, 'general'>[] = [
143
160
  'bugfix',
144
161
  'release',
@@ -229,6 +246,18 @@ export function resolveTaskLens(task?: string): TaskLens {
229
246
  return best.score > 0 ? LENSES[best.id] : LENSES.general;
230
247
  }
231
248
 
249
+ /**
250
+ * Detect when the caller is asking to continue existing work. This stays
251
+ * separate from task-lens routing so "continue fixing the timeout" remains a
252
+ * bugfix, while still receiving a compact prior-work brief.
253
+ */
254
+ export function isContinuationTask(task?: string): boolean {
255
+ const normalized = (task ?? '').trim().toLowerCase();
256
+ return normalized.length > 0 && CONTINUATION_KEYWORDS.some((keyword) =>
257
+ containsTaskKeyword(normalized, keyword),
258
+ );
259
+ }
260
+
232
261
  function pathKindScore(path: string, lens: TaskLens): number {
233
262
  const normalized = normalizePath(path).toLowerCase();
234
263
  const name = normalized.split('/').pop() ?? normalized;