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.
- package/CHANGELOG.md +27 -0
- package/README.md +3 -3
- package/README.zh-CN.md +3 -3
- package/TEAM.md +86 -86
- package/dist/cli/index.js +5199 -4726
- package/dist/cli/index.js.map +1 -1
- package/dist/index.js +428 -49
- package/dist/index.js.map +1 -1
- package/dist/maintenance-runner.js +97 -18
- package/dist/maintenance-runner.js.map +1 -1
- package/dist/memcode-runtime/CHANGELOG.md +27 -0
- package/dist/sdk.js +428 -49
- package/dist/sdk.js.map +1 -1
- package/docs/1.2.4-PERSISTENT-MEMORY-DELIVERY.md +86 -0
- package/docs/AGENT_OPERATOR_PLAYBOOK.md +13 -1
- package/docs/API_REFERENCE.md +13 -3
- package/docs/DESIGN_DECISIONS.md +357 -357
- package/docs/dev-log/progress.txt +60 -9
- package/package.json +1 -1
- package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
- package/src/audit/index.ts +156 -156
- package/src/cli/capability-map.ts +1 -1
- package/src/cli/command-guide.ts +4 -1
- package/src/cli/commands/agent-integrations.ts +5 -1
- package/src/cli/commands/audit-list.ts +89 -89
- package/src/cli/commands/background.ts +659 -659
- package/src/cli/commands/codegraph.ts +1 -1
- package/src/cli/commands/context.ts +9 -1
- package/src/cli/commands/formation.ts +48 -48
- package/src/cli/commands/git-hook-install.ts +111 -111
- package/src/cli/commands/handoff.ts +54 -54
- 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 +66 -66
- 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 +82 -82
- package/src/cli/commands/message.ts +104 -104
- package/src/cli/commands/poll.ts +58 -58
- 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 +118 -118
- package/src/cli/commands/resume.ts +31 -0
- package/src/cli/commands/serve-shared.ts +118 -118
- package/src/cli/commands/session.ts +15 -7
- package/src/cli/commands/skills.ts +114 -114
- package/src/cli/commands/task.ts +167 -167
- package/src/cli/commands/transfer.ts +47 -47
- 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/Sidebar.tsx +179 -179
- package/src/cli/tui/index.ts +41 -41
- package/src/cli/tui/markdown-render.tsx +371 -371
- package/src/cli/tui/session-service.ts +3 -2
- 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 +54 -1
- package/src/codegraph/task-lens.ts +29 -0
- package/src/compact/token-budget.ts +89 -74
- package/src/config/toml-loader.ts +9 -5
- package/src/dashboard/project-classification.ts +64 -64
- 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/hooks/handler.ts +127 -66
- package/src/hooks/installers/index.ts +5 -4
- package/src/hooks/official-skills.ts +6 -4
- package/src/hooks/pattern-detector.ts +173 -173
- package/src/hooks/rules/memorix-agent-rules.md +9 -7
- package/src/hooks/significance-filter.ts +250 -250
- package/src/knowledge/context-assembly.ts +4 -1
- package/src/knowledge/workset.ts +89 -1
- 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/disclosure-policy.ts +135 -135
- 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/secret-filter.ts +79 -79
- package/src/memory/session.ts +158 -9
- 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 +343 -343
- 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/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 +299 -299
- 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 +144 -10
- package/src/skills/mini-skills.ts +386 -386
- package/src/store/bun-sqlite-compat.ts +118 -15
- package/src/store/chat-store.ts +119 -119
- package/src/store/graph-store.ts +249 -249
- package/src/store/mini-skill-store.ts +349 -349
- 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/sqlite-db.ts +3 -3
- package/src/team/event-bus.ts +76 -76
- package/src/team/file-locks.ts +173 -173
- package/src/team/handoff.ts +161 -161
- package/src/team/messages.ts +203 -203
- package/src/team/poll.ts +132 -132
- package/src/team/tasks.ts +211 -211
- 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,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
|
|
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;
|