memorix 1.1.7 → 1.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +22 -0
- package/CLAUDE.md +6 -1
- package/README.md +21 -0
- package/README.zh-CN.md +21 -0
- package/TEAM.md +86 -86
- package/dist/cli/index.js +852 -214
- package/dist/cli/index.js.map +1 -1
- package/dist/dashboard/static/index.html +201 -201
- package/dist/dashboard/static/style.css +3584 -3584
- package/dist/index.js +129 -62
- package/dist/index.js.map +1 -1
- package/dist/memcode-runtime/CHANGELOG.md +22 -0
- package/dist/memcode-runtime/package.json +4 -4
- package/dist/sdk.js +129 -62
- package/dist/sdk.js.map +1 -1
- package/docs/AGENT_OPERATOR_PLAYBOOK.md +18 -0
- package/docs/API_REFERENCE.md +2 -0
- package/docs/CONFIGURATION.md +18 -0
- package/docs/DESIGN_DECISIONS.md +357 -357
- package/docs/SETUP.md +10 -0
- package/docs/dev-log/progress.txt +23 -30
- package/package.json +1 -1
- package/src/audit/index.ts +156 -156
- package/src/cli/commands/agent-integrations.ts +623 -0
- package/src/cli/commands/audit-list.ts +89 -89
- package/src/cli/commands/background.ts +659 -659
- package/src/cli/commands/cleanup.ts +255 -255
- package/src/cli/commands/codegraph.ts +4 -0
- package/src/cli/commands/config-get.ts +9 -2
- package/src/cli/commands/doctor.ts +26 -0
- package/src/cli/commands/formation.ts +48 -48
- package/src/cli/commands/git-hook-install.ts +111 -111
- package/src/cli/commands/handoff.ts +66 -66
- package/src/cli/commands/hooks-status.ts +63 -63
- package/src/cli/commands/ingest-commit.ts +153 -153
- package/src/cli/commands/ingest-image.ts +73 -73
- package/src/cli/commands/ingest-log.ts +180 -180
- package/src/cli/commands/ingest.ts +44 -44
- package/src/cli/commands/integrate-shared.ts +15 -15
- package/src/cli/commands/lock.ts +96 -96
- package/src/cli/commands/message.ts +121 -121
- package/src/cli/commands/poll.ts +70 -70
- package/src/cli/commands/purge-all-memory.ts +85 -85
- package/src/cli/commands/purge-project-memory.ts +83 -83
- package/src/cli/commands/reasoning.ts +132 -132
- package/src/cli/commands/repair.ts +60 -0
- package/src/cli/commands/retention.ts +108 -108
- package/src/cli/commands/serve-shared.ts +118 -118
- package/src/cli/commands/setup.ts +3 -3
- package/src/cli/commands/skills.ts +123 -123
- package/src/cli/commands/task.ts +192 -192
- package/src/cli/commands/transfer.ts +73 -73
- package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
- package/src/cli/index.ts +3 -1
- package/src/cli/tui/ChatView.tsx +234 -234
- package/src/cli/tui/CommandBar.tsx +312 -312
- package/src/cli/tui/ContextRail.tsx +118 -118
- package/src/cli/tui/HeaderBar.tsx +72 -72
- package/src/cli/tui/LogoBanner.tsx +51 -51
- package/src/cli/tui/Panels.tsx +632 -632
- package/src/cli/tui/Sidebar.tsx +179 -179
- package/src/cli/tui/chat-service.ts +742 -742
- package/src/cli/tui/data.ts +547 -547
- package/src/cli/tui/index.ts +41 -41
- package/src/cli/tui/markdown-render.tsx +371 -371
- package/src/cli/tui/theme.ts +178 -178
- package/src/cli/tui/use-mouse.ts +157 -157
- package/src/cli/tui/useNavigation.ts +56 -56
- package/src/cli/update-checker.ts +211 -211
- package/src/cli/version.ts +7 -7
- package/src/cli/workbench.ts +1 -1
- package/src/codegraph/auto-context.ts +6 -0
- package/src/codegraph/context-pack.ts +7 -6
- package/src/codegraph/exclude.ts +47 -0
- package/src/codegraph/lite-provider.ts +5 -24
- package/src/codegraph/project-context.ts +13 -15
- package/src/compact/token-budget.ts +74 -74
- package/src/config/behavior.ts +59 -59
- package/src/config/resolved-config.ts +6 -0
- package/src/config/toml-loader.ts +4 -0
- package/src/config/yaml-loader.ts +7 -0
- package/src/dashboard/project-classification.ts +64 -64
- package/src/dashboard/static/index.html +201 -201
- package/src/dashboard/static/style.css +3584 -3584
- package/src/embedding/fastembed-provider.ts +142 -142
- package/src/embedding/transformers-provider.ts +111 -111
- package/src/git/extractor.ts +209 -209
- package/src/git/hooks-path.ts +85 -85
- package/src/git/noise-filter.ts +210 -210
- package/src/hooks/installers/index.ts +4 -4
- package/src/hooks/official-skills.ts +1 -1
- package/src/hooks/pattern-detector.ts +173 -173
- package/src/hooks/rules/memorix-agent-rules.md +2 -2
- package/src/hooks/significance-filter.ts +250 -250
- package/src/llm/memory-manager.ts +328 -328
- package/src/llm/provider.ts +885 -885
- package/src/llm/quality.ts +248 -248
- package/src/memory/attribution-guard.ts +249 -249
- package/src/memory/auto-relations.ts +107 -107
- package/src/memory/consolidation.ts +302 -302
- package/src/memory/disclosure-policy.ts +141 -141
- package/src/memory/entity-extractor.ts +197 -197
- package/src/memory/formation/evaluate.ts +217 -217
- package/src/memory/formation/extract.ts +361 -361
- package/src/memory/formation/index.ts +417 -417
- package/src/memory/formation/resolve.ts +344 -344
- package/src/memory/formation/types.ts +315 -315
- package/src/memory/freshness.ts +122 -122
- package/src/memory/graph.ts +197 -197
- package/src/memory/refs.ts +94 -94
- package/src/memory/retention.ts +433 -433
- package/src/memory/secret-filter.ts +79 -79
- package/src/memory/session.ts +523 -523
- package/src/multimodal/image-loader.ts +143 -143
- package/src/orchestrate/adapters/claude-stream.ts +192 -192
- package/src/orchestrate/adapters/claude.ts +111 -111
- package/src/orchestrate/adapters/codex-stream.ts +134 -134
- package/src/orchestrate/adapters/codex.ts +41 -41
- package/src/orchestrate/adapters/gemini-stream.ts +166 -166
- package/src/orchestrate/adapters/gemini.ts +42 -42
- package/src/orchestrate/adapters/index.ts +73 -73
- package/src/orchestrate/adapters/opencode-stream.ts +143 -143
- package/src/orchestrate/adapters/opencode.ts +47 -47
- package/src/orchestrate/adapters/spawn-helper.ts +286 -286
- package/src/orchestrate/adapters/types.ts +77 -77
- package/src/orchestrate/capability-router.ts +284 -284
- package/src/orchestrate/context-compact.ts +188 -188
- package/src/orchestrate/cost-tracker.ts +219 -219
- package/src/orchestrate/error-recovery.ts +191 -191
- package/src/orchestrate/evidence.ts +140 -140
- package/src/orchestrate/ledger.ts +110 -110
- package/src/orchestrate/memorix-bridge.ts +380 -380
- package/src/orchestrate/output-budget.ts +80 -80
- package/src/orchestrate/permission.ts +152 -152
- package/src/orchestrate/pipeline-trace.ts +131 -131
- package/src/orchestrate/prompt-builder.ts +155 -155
- package/src/orchestrate/ring-buffer.ts +37 -37
- package/src/orchestrate/task-graph.ts +389 -389
- package/src/orchestrate/verify-gate.ts +219 -219
- package/src/orchestrate/worktree.ts +232 -232
- package/src/project/aliases.ts +374 -374
- package/src/project/detector.ts +268 -268
- package/src/rules/adapters/claude-code.ts +99 -99
- package/src/rules/adapters/codex.ts +97 -97
- package/src/rules/adapters/copilot.ts +124 -124
- package/src/rules/adapters/cursor.ts +114 -114
- package/src/rules/adapters/kiro.ts +126 -126
- package/src/rules/adapters/trae.ts +56 -56
- package/src/rules/adapters/windsurf.ts +83 -83
- package/src/rules/syncer.ts +235 -235
- package/src/sdk.ts +327 -327
- package/src/search/intent-detector.ts +289 -289
- package/src/search/query-expansion.ts +52 -52
- package/src/server/formation-timeout.ts +27 -27
- package/src/server.ts +3 -0
- package/src/skills/mini-skills.ts +386 -386
- package/src/store/chat-store.ts +119 -119
- package/src/store/file-lock.ts +100 -100
- package/src/store/graph-store.ts +249 -249
- package/src/store/mini-skill-store.ts +349 -349
- package/src/store/obs-store.ts +255 -255
- package/src/store/orama-store.ts +15 -8
- package/src/store/persistence-json.ts +212 -212
- package/src/store/persistence.ts +291 -291
- package/src/store/project-affinity.ts +195 -195
- package/src/store/session-store.ts +259 -259
- package/src/store/sqlite-store.ts +339 -339
- package/src/team/event-bus.ts +76 -76
- package/src/team/file-locks.ts +173 -173
- package/src/team/handoff.ts +167 -167
- package/src/team/messages.ts +203 -203
- package/src/team/poll.ts +132 -132
- package/src/team/tasks.ts +211 -211
- package/src/wiki/generator.ts +237 -237
- package/src/wiki/knowledge-graph.ts +334 -334
- package/src/wiki/types.ts +85 -85
- package/src/workspace/mcp-adapters/codex.ts +191 -191
- package/src/workspace/mcp-adapters/copilot.ts +105 -105
- package/src/workspace/mcp-adapters/cursor.ts +53 -53
- package/src/workspace/mcp-adapters/kiro.ts +64 -64
- package/src/workspace/mcp-adapters/opencode.ts +123 -123
- package/src/workspace/mcp-adapters/trae.ts +134 -134
- package/src/workspace/mcp-adapters/windsurf.ts +91 -91
- package/src/workspace/sanitizer.ts +60 -60
- 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
|
+
};
|
package/src/cli/version.ts
CHANGED
|
@@ -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
|
+
}
|
package/src/cli/workbench.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { existsSync, statSync } from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
|
+
import { getResolvedConfig } from '../config/resolved-config.js';
|
|
3
4
|
import type { ProjectInfo } from '../types.js';
|
|
4
5
|
import { backfillMissingObservationCodeRefs, type CodeRefBackfillResult } from './binder.js';
|
|
5
6
|
import { collectCurrentProjectFacts, type CurrentProjectFacts } from './current-facts.js';
|
|
@@ -100,11 +101,13 @@ export async function buildAutoProjectContext(input: {
|
|
|
100
101
|
refresh?: AutoContextRefreshMode;
|
|
101
102
|
maxAgeMs?: number;
|
|
102
103
|
now?: Date;
|
|
104
|
+
exclude?: string[];
|
|
103
105
|
}): Promise<AutoProjectContext> {
|
|
104
106
|
const refreshMode = input.refresh ?? 'auto';
|
|
105
107
|
const now = input.now ?? new Date();
|
|
106
108
|
const task = input.task?.trim();
|
|
107
109
|
const lens = resolveTaskLens(task);
|
|
110
|
+
const exclude = input.exclude ?? getResolvedConfig({ projectRoot: input.project.rootPath }).codegraph.excludePatterns;
|
|
108
111
|
const store = new CodeGraphStore();
|
|
109
112
|
await store.init(input.dataDir);
|
|
110
113
|
|
|
@@ -126,6 +129,7 @@ export async function buildAutoProjectContext(input: {
|
|
|
126
129
|
const indexed = await indexProjectLite({
|
|
127
130
|
projectId: input.project.id,
|
|
128
131
|
projectRoot: input.project.rootPath,
|
|
132
|
+
exclude,
|
|
129
133
|
});
|
|
130
134
|
store.replaceProjectIndex(input.project.id, indexed);
|
|
131
135
|
const backfill = await backfillMissingObservationCodeRefs(
|
|
@@ -147,11 +151,13 @@ export async function buildAutoProjectContext(input: {
|
|
|
147
151
|
project: input.project,
|
|
148
152
|
store,
|
|
149
153
|
observations: input.observations,
|
|
154
|
+
exclude,
|
|
150
155
|
});
|
|
151
156
|
const explain = buildProjectContextExplain({
|
|
152
157
|
project: input.project,
|
|
153
158
|
store,
|
|
154
159
|
observations: input.observations,
|
|
160
|
+
exclude,
|
|
155
161
|
});
|
|
156
162
|
|
|
157
163
|
return {
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { evaluateCodeRefFreshness } from './freshness.js';
|
|
2
2
|
import type { CodeFile, CodeRefStatus, CodeSymbol, ObservationCodeRef } from './types.js';
|
|
3
3
|
import type { CodeGraphStore } from './store.js';
|
|
4
|
+
import { isCodeGraphExcludedPath } from './exclude.js';
|
|
4
5
|
|
|
5
6
|
export interface ContextPackMemory {
|
|
6
7
|
id: number;
|
|
@@ -52,6 +53,7 @@ export interface AssembleContextPackInput {
|
|
|
52
53
|
files: CodeFile[];
|
|
53
54
|
symbols: CodeSymbol[];
|
|
54
55
|
suggestedVerification?: string[];
|
|
56
|
+
exclude?: string[];
|
|
55
57
|
}
|
|
56
58
|
|
|
57
59
|
function uniq<T>(items: T[]): T[] {
|
|
@@ -68,10 +70,6 @@ function timestampOf(observation: ContextPackObservation): number {
|
|
|
68
70
|
return Date.parse(observation.updatedAt ?? observation.createdAt ?? '') || 0;
|
|
69
71
|
}
|
|
70
72
|
|
|
71
|
-
function isGeneratedPath(path: string): boolean {
|
|
72
|
-
return /(^|\/)(dist|build|coverage|\.next|\.turbo|node_modules)\//i.test(path.replace(/\\/g, '/'));
|
|
73
|
-
}
|
|
74
|
-
|
|
75
73
|
function relevanceScore(observation: ContextPackObservation, taskTokens: string[]): number {
|
|
76
74
|
if (taskTokens.length === 0) return 0;
|
|
77
75
|
const title = observation.title.toLowerCase();
|
|
@@ -133,6 +131,7 @@ export function assembleContextPackForTask(input: {
|
|
|
133
131
|
observations: ContextPackObservation[];
|
|
134
132
|
limit?: number;
|
|
135
133
|
suggestedVerification?: string[];
|
|
134
|
+
exclude?: string[];
|
|
136
135
|
}): ContextPack {
|
|
137
136
|
const selected = selectRelevantObservations(input.observations, input.task, input.limit ?? 20);
|
|
138
137
|
const refs = selected.flatMap(obs => input.store.listObservationRefs(input.projectId, obs.id));
|
|
@@ -147,6 +146,7 @@ export function assembleContextPackForTask(input: {
|
|
|
147
146
|
files,
|
|
148
147
|
symbols,
|
|
149
148
|
suggestedVerification: input.suggestedVerification,
|
|
149
|
+
exclude: input.exclude,
|
|
150
150
|
});
|
|
151
151
|
}
|
|
152
152
|
|
|
@@ -168,6 +168,7 @@ export function assembleContextPack(input: AssembleContextPackInput): ContextPac
|
|
|
168
168
|
|
|
169
169
|
const file = ref.fileId ? files.get(ref.fileId) : undefined;
|
|
170
170
|
const symbol = ref.symbolId ? symbols.get(ref.symbolId) : undefined;
|
|
171
|
+
if (file && isCodeGraphExcludedPath(file.path, input.exclude)) continue;
|
|
171
172
|
const freshness = evaluateCodeRefFreshness(ref, file, symbol);
|
|
172
173
|
|
|
173
174
|
if (freshness.status === 'current') {
|
|
@@ -243,8 +244,8 @@ export function buildContextPackPrompt(pack: ContextPack): string {
|
|
|
243
244
|
const reliableMemories = pack.memories.filter(memory => memory.status === 'current');
|
|
244
245
|
const unboundMemories = pack.memories.filter(memory => memory.status === 'unbound');
|
|
245
246
|
const lines: string[] = ['## Task', pack.task, '', '## Reliable Memories'];
|
|
246
|
-
const visibleCodeFacts = pack.codeFacts.filter(fact => !
|
|
247
|
-
const visibleSuggestedReads = pack.suggestedReads.filter(path => !
|
|
247
|
+
const visibleCodeFacts = pack.codeFacts.filter(fact => !isCodeGraphExcludedPath(fact.path)).slice(0, 5);
|
|
248
|
+
const visibleSuggestedReads = pack.suggestedReads.filter(path => !isCodeGraphExcludedPath(path)).slice(0, 5);
|
|
248
249
|
|
|
249
250
|
if (reliableMemories.length === 0) lines.push('- none');
|
|
250
251
|
for (const memory of reliableMemories) {
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
export const DEFAULT_CODEGRAPH_EXCLUDES = [
|
|
2
|
+
'node_modules/**',
|
|
3
|
+
'dist/**',
|
|
4
|
+
'build/**',
|
|
5
|
+
'coverage/**',
|
|
6
|
+
'.next/**',
|
|
7
|
+
'.turbo/**',
|
|
8
|
+
'.git/**',
|
|
9
|
+
'.tmp/**',
|
|
10
|
+
'.worktrees/**',
|
|
11
|
+
'.claude/worktrees/**',
|
|
12
|
+
];
|
|
13
|
+
|
|
14
|
+
export function normalizeCodeGraphExcludePatterns(exclude?: string[]): string[] {
|
|
15
|
+
return [...new Set([
|
|
16
|
+
...DEFAULT_CODEGRAPH_EXCLUDES,
|
|
17
|
+
...(exclude ?? []).map(pattern => pattern.trim()).filter(Boolean),
|
|
18
|
+
])];
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export function isCodeGraphExcludedPath(path: string, exclude?: string[]): boolean {
|
|
22
|
+
const normalized = normalizeCodePath(path);
|
|
23
|
+
return normalizeCodeGraphExcludePatterns(exclude).some((pattern) => matchesPattern(normalized, normalizeCodePath(pattern)));
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function normalizeCodePath(path: string): string {
|
|
27
|
+
return path.replace(/\\/g, '/').replace(/^\.\/+/, '');
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function matchesPattern(path: string, pattern: string): boolean {
|
|
31
|
+
if (pattern.endsWith('/**')) {
|
|
32
|
+
const base = pattern.slice(0, -3);
|
|
33
|
+
if (base.startsWith('**/')) {
|
|
34
|
+
const suffix = base.slice(3);
|
|
35
|
+
return path === suffix || path.endsWith(`/${suffix}`) || path.includes(`/${suffix}/`);
|
|
36
|
+
}
|
|
37
|
+
if (!base.includes('/')) {
|
|
38
|
+
return path === base || path.startsWith(`${base}/`) || path.includes(`/${base}/`);
|
|
39
|
+
}
|
|
40
|
+
return path === base || path.startsWith(`${base}/`);
|
|
41
|
+
}
|
|
42
|
+
if (pattern.startsWith('**/')) {
|
|
43
|
+
const suffix = pattern.slice(3);
|
|
44
|
+
return path === suffix || path.endsWith(`/${suffix}`);
|
|
45
|
+
}
|
|
46
|
+
return path === pattern || path.startsWith(`${pattern}/`);
|
|
47
|
+
}
|