memorix 1.1.7 → 1.1.8

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 (174) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/CLAUDE.md +6 -1
  3. package/README.md +21 -0
  4. package/README.zh-CN.md +21 -0
  5. package/TEAM.md +86 -86
  6. package/dist/cli/index.js +730 -150
  7. package/dist/cli/index.js.map +1 -1
  8. package/dist/dashboard/static/index.html +201 -201
  9. package/dist/dashboard/static/style.css +3584 -3584
  10. package/dist/index.js +15 -8
  11. package/dist/index.js.map +1 -1
  12. package/dist/memcode-runtime/CHANGELOG.md +13 -0
  13. package/dist/memcode-runtime/package.json +4 -4
  14. package/dist/sdk.js +15 -8
  15. package/dist/sdk.js.map +1 -1
  16. package/docs/AGENT_OPERATOR_PLAYBOOK.md +18 -0
  17. package/docs/DESIGN_DECISIONS.md +357 -357
  18. package/docs/SETUP.md +10 -0
  19. package/docs/dev-log/progress.txt +35 -26
  20. package/package.json +1 -1
  21. package/src/audit/index.ts +156 -156
  22. package/src/cli/commands/agent-integrations.ts +623 -0
  23. package/src/cli/commands/audit-list.ts +89 -89
  24. package/src/cli/commands/background.ts +659 -659
  25. package/src/cli/commands/cleanup.ts +255 -255
  26. package/src/cli/commands/doctor.ts +23 -0
  27. package/src/cli/commands/formation.ts +48 -48
  28. package/src/cli/commands/git-hook-install.ts +111 -111
  29. package/src/cli/commands/handoff.ts +66 -66
  30. package/src/cli/commands/hooks-status.ts +63 -63
  31. package/src/cli/commands/ingest-commit.ts +153 -153
  32. package/src/cli/commands/ingest-image.ts +73 -73
  33. package/src/cli/commands/ingest-log.ts +180 -180
  34. package/src/cli/commands/ingest.ts +44 -44
  35. package/src/cli/commands/integrate-shared.ts +15 -15
  36. package/src/cli/commands/lock.ts +96 -96
  37. package/src/cli/commands/message.ts +121 -121
  38. package/src/cli/commands/poll.ts +70 -70
  39. package/src/cli/commands/purge-all-memory.ts +85 -85
  40. package/src/cli/commands/purge-project-memory.ts +83 -83
  41. package/src/cli/commands/reasoning.ts +132 -132
  42. package/src/cli/commands/repair.ts +60 -0
  43. package/src/cli/commands/retention.ts +108 -108
  44. package/src/cli/commands/serve-shared.ts +118 -118
  45. package/src/cli/commands/setup.ts +3 -3
  46. package/src/cli/commands/skills.ts +123 -123
  47. package/src/cli/commands/task.ts +192 -192
  48. package/src/cli/commands/transfer.ts +73 -73
  49. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  50. package/src/cli/index.ts +3 -1
  51. package/src/cli/tui/ChatView.tsx +234 -234
  52. package/src/cli/tui/CommandBar.tsx +312 -312
  53. package/src/cli/tui/ContextRail.tsx +118 -118
  54. package/src/cli/tui/HeaderBar.tsx +72 -72
  55. package/src/cli/tui/LogoBanner.tsx +51 -51
  56. package/src/cli/tui/Panels.tsx +632 -632
  57. package/src/cli/tui/Sidebar.tsx +179 -179
  58. package/src/cli/tui/chat-service.ts +742 -742
  59. package/src/cli/tui/data.ts +547 -547
  60. package/src/cli/tui/index.ts +41 -41
  61. package/src/cli/tui/markdown-render.tsx +371 -371
  62. package/src/cli/tui/theme.ts +178 -178
  63. package/src/cli/tui/use-mouse.ts +157 -157
  64. package/src/cli/tui/useNavigation.ts +56 -56
  65. package/src/cli/update-checker.ts +211 -211
  66. package/src/cli/version.ts +7 -7
  67. package/src/cli/workbench.ts +1 -1
  68. package/src/codegraph/context-pack.ts +5 -1
  69. package/src/codegraph/lite-provider.ts +5 -1
  70. package/src/codegraph/project-context.ts +5 -1
  71. package/src/compact/token-budget.ts +74 -74
  72. package/src/config/behavior.ts +59 -59
  73. package/src/dashboard/project-classification.ts +64 -64
  74. package/src/dashboard/static/index.html +201 -201
  75. package/src/dashboard/static/style.css +3584 -3584
  76. package/src/embedding/fastembed-provider.ts +142 -142
  77. package/src/embedding/transformers-provider.ts +111 -111
  78. package/src/git/extractor.ts +209 -209
  79. package/src/git/hooks-path.ts +85 -85
  80. package/src/git/noise-filter.ts +210 -210
  81. package/src/hooks/installers/index.ts +4 -4
  82. package/src/hooks/official-skills.ts +1 -1
  83. package/src/hooks/pattern-detector.ts +173 -173
  84. package/src/hooks/rules/memorix-agent-rules.md +2 -2
  85. package/src/hooks/significance-filter.ts +250 -250
  86. package/src/llm/memory-manager.ts +328 -328
  87. package/src/llm/provider.ts +885 -885
  88. package/src/llm/quality.ts +248 -248
  89. package/src/memory/attribution-guard.ts +249 -249
  90. package/src/memory/auto-relations.ts +107 -107
  91. package/src/memory/consolidation.ts +302 -302
  92. package/src/memory/disclosure-policy.ts +141 -141
  93. package/src/memory/entity-extractor.ts +197 -197
  94. package/src/memory/formation/evaluate.ts +217 -217
  95. package/src/memory/formation/extract.ts +361 -361
  96. package/src/memory/formation/index.ts +417 -417
  97. package/src/memory/formation/resolve.ts +344 -344
  98. package/src/memory/formation/types.ts +315 -315
  99. package/src/memory/freshness.ts +122 -122
  100. package/src/memory/graph.ts +197 -197
  101. package/src/memory/refs.ts +94 -94
  102. package/src/memory/retention.ts +433 -433
  103. package/src/memory/secret-filter.ts +79 -79
  104. package/src/memory/session.ts +523 -523
  105. package/src/multimodal/image-loader.ts +143 -143
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/spawn-helper.ts +286 -286
  116. package/src/orchestrate/adapters/types.ts +77 -77
  117. package/src/orchestrate/capability-router.ts +284 -284
  118. package/src/orchestrate/context-compact.ts +188 -188
  119. package/src/orchestrate/cost-tracker.ts +219 -219
  120. package/src/orchestrate/error-recovery.ts +191 -191
  121. package/src/orchestrate/evidence.ts +140 -140
  122. package/src/orchestrate/ledger.ts +110 -110
  123. package/src/orchestrate/memorix-bridge.ts +380 -380
  124. package/src/orchestrate/output-budget.ts +80 -80
  125. package/src/orchestrate/permission.ts +152 -152
  126. package/src/orchestrate/pipeline-trace.ts +131 -131
  127. package/src/orchestrate/prompt-builder.ts +155 -155
  128. package/src/orchestrate/ring-buffer.ts +37 -37
  129. package/src/orchestrate/task-graph.ts +389 -389
  130. package/src/orchestrate/verify-gate.ts +219 -219
  131. package/src/orchestrate/worktree.ts +232 -232
  132. package/src/project/aliases.ts +374 -374
  133. package/src/project/detector.ts +268 -268
  134. package/src/rules/adapters/claude-code.ts +99 -99
  135. package/src/rules/adapters/codex.ts +97 -97
  136. package/src/rules/adapters/copilot.ts +124 -124
  137. package/src/rules/adapters/cursor.ts +114 -114
  138. package/src/rules/adapters/kiro.ts +126 -126
  139. package/src/rules/adapters/trae.ts +56 -56
  140. package/src/rules/adapters/windsurf.ts +83 -83
  141. package/src/rules/syncer.ts +235 -235
  142. package/src/sdk.ts +327 -327
  143. package/src/search/intent-detector.ts +289 -289
  144. package/src/search/query-expansion.ts +52 -52
  145. package/src/server/formation-timeout.ts +27 -27
  146. package/src/skills/mini-skills.ts +386 -386
  147. package/src/store/chat-store.ts +119 -119
  148. package/src/store/file-lock.ts +100 -100
  149. package/src/store/graph-store.ts +249 -249
  150. package/src/store/mini-skill-store.ts +349 -349
  151. package/src/store/obs-store.ts +255 -255
  152. package/src/store/persistence-json.ts +212 -212
  153. package/src/store/persistence.ts +291 -291
  154. package/src/store/project-affinity.ts +195 -195
  155. package/src/store/session-store.ts +259 -259
  156. package/src/store/sqlite-store.ts +339 -339
  157. package/src/team/event-bus.ts +76 -76
  158. package/src/team/file-locks.ts +173 -173
  159. package/src/team/handoff.ts +167 -167
  160. package/src/team/messages.ts +203 -203
  161. package/src/team/poll.ts +132 -132
  162. package/src/team/tasks.ts +211 -211
  163. package/src/wiki/generator.ts +237 -237
  164. package/src/wiki/knowledge-graph.ts +334 -334
  165. package/src/wiki/types.ts +85 -85
  166. package/src/workspace/mcp-adapters/codex.ts +191 -191
  167. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  168. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  169. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  170. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  171. package/src/workspace/mcp-adapters/trae.ts +134 -134
  172. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  173. package/src/workspace/sanitizer.ts +60 -60
  174. 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';
@@ -69,7 +69,11 @@ function timestampOf(observation: ContextPackObservation): number {
69
69
  }
70
70
 
71
71
  function isGeneratedPath(path: string): boolean {
72
- return /(^|\/)(dist|build|coverage|\.next|\.turbo|node_modules)\//i.test(path.replace(/\\/g, '/'));
72
+ const normalized = path.replace(/\\/g, '/');
73
+ return (
74
+ /(^|\/)(dist|build|coverage|\.next|\.turbo|node_modules|\.git|\.tmp|\.worktrees)(\/|$)/i.test(normalized) ||
75
+ /(^|\/)\.claude\/worktrees(\/|$)/i.test(normalized)
76
+ );
73
77
  }
74
78
 
75
79
  function relevanceScore(observation: ContextPackObservation, taskTokens: string[]): number {
@@ -198,7 +198,8 @@ function walk(root: string, exclude: string[], maxFiles: number): string[] {
198
198
  const rel = normalizeCodePath(relative(root, abs));
199
199
  if (isExcluded(rel, exclude)) continue;
200
200
  if (entry.isDirectory()) {
201
- if (entry.name === '.git' || entry.name === 'node_modules') continue;
201
+ if (entry.name === '.git' || entry.name === '.worktrees' || entry.name === '.tmp' || entry.name === 'node_modules') continue;
202
+ if (rel === '.claude/worktrees' || rel.startsWith('.claude/worktrees/')) continue;
202
203
  visit(abs);
203
204
  if (out.length >= maxFiles) return;
204
205
  continue;
@@ -297,6 +298,9 @@ export async function indexProjectLite(options: LiteIndexOptions): Promise<LiteI
297
298
  '.next/**',
298
299
  '.turbo/**',
299
300
  '.git/**',
301
+ '.tmp/**',
302
+ '.worktrees/**',
303
+ '.claude/worktrees/**',
300
304
  ];
301
305
  const maxFiles = options.maxFiles ?? 5000;
302
306
  const indexedAt = new Date().toISOString();
@@ -82,7 +82,11 @@ function normalizePath(path: string): string {
82
82
  }
83
83
 
84
84
  function isGeneratedPath(path: string): boolean {
85
- return /(^|\/)(dist|build|coverage|\.next|\.turbo|node_modules)\//i.test(normalizePath(path));
85
+ const normalized = normalizePath(path);
86
+ return (
87
+ /(^|\/)(dist|build|coverage|\.next|\.turbo|node_modules|\.git|\.tmp|\.worktrees)(\/|$)/i.test(normalized) ||
88
+ /(^|\/)\.claude\/worktrees(\/|$)/i.test(normalized)
89
+ );
86
90
  }
87
91
 
88
92
  function suggestedReadRank(path: string): number {