@cstart/coldstart 2.0.0

package/dist/server/searcher.js

@@ -0,0 +1,146 @@
+/**
+ * Recall-engine resolution — which ripgrep runs `find`'s per-term scans.
+ *
+ * Preference order (fastest first):
+ *   1. COLDSTART_RG env var — explicit user override, never second-guessed
+ *   2. `rg` on PATH — the user's own ripgrep
+ *   3. bundled @vscode/ripgrep — regular dependency; npm installs the matching
+ *      platform subpackage (no install scripts, registry-only)
+ *   4. editor-app copies — VS Code and Cursor ship a ripgrep inside the app
+ *      bundle; the Claude Code binary IS ripgrep when invoked with argv0=rg
+ *
+ * Every candidate must answer `--version` with "ripgrep ..." before it wins.
+ * Probing costs a few process spawns and the answer is machine-global, so the
+ * winner is persisted in ~/.coldstart/searcher.json; later runs revalidate it
+ * with a stat instead of re-probing. A scan-time spawn failure calls
+ * invalidateRg() to drop the record and re-resolve once.
+ *
+ * No ripgrep at all → find.ts falls back to git grep → grep → pure-Node scan.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { homedir } from 'node:os';
+import { isAbsolute, join } from 'node:path';
+const CACHE_FILE = join(homedir(), '.coldstart', 'searcher.json');
+let _rg; // undefined = not yet resolved this process
+/** True iff `bin` runs and identifies itself as ripgrep. */
+function isRipgrep(bin, argv0) {
+    try {
+        const out = execFileSync(bin, ['--version'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 4000,
+            ...(argv0 ? { argv0 } : {}),
+        });
+        return out.startsWith('ripgrep');
+    }
+    catch {
+        return false;
+    }
+}
+function bundledRgPath() {
+    try {
+        const require = createRequire(import.meta.url);
+        const { rgPath } = require('@vscode/ripgrep');
+        return existsSync(rgPath) ? rgPath : null; // platform subpackage may be absent (--omit=optional)
+    }
+    catch {
+        return null;
+    }
+}
+/** Known in-app ripgrep locations, cheapest checks first. */
+function appCandidates() {
+    const out = [];
+    const sub = join('node_modules', '@vscode', 'ripgrep', 'bin', process.platform === 'win32' ? 'rg.exe' : 'rg');
+    if (process.platform === 'darwin') {
+        out.push({ bin: join('/Applications/Visual Studio Code.app/Contents/Resources/app', sub) });
+        out.push({ bin: join('/Applications/Cursor.app/Contents/Resources/app', sub) });
+    }
+    else if (process.platform === 'linux') {
+        out.push({ bin: join('/usr/share/code/resources/app', sub) });
+        out.push({ bin: join('/usr/share/cursor/resources/app', sub) });
+    }
+    else if (process.platform === 'win32' && process.env['LOCALAPPDATA']) {
+        out.push({ bin: join(process.env['LOCALAPPDATA'], 'Programs', 'Microsoft VS Code', 'resources', 'app', sub) });
+        out.push({ bin: join(process.env['LOCALAPPDATA'], 'Programs', 'cursor', 'resources', 'app', sub) });
+    }
+    // The Claude Code CLI embeds ripgrep and dispatches on argv[0].
+    out.push({ bin: 'claude', argv0: 'rg' });
+    return out;
+}
+function loadCached() {
+    try {
+        const raw = JSON.parse(readFileSync(CACHE_FILE, 'utf8'));
+        if (!raw.bin)
+            return null;
+        // Absolute paths get a cheap stat; bare names (PATH rg, claude) can only be
+        // trusted — a scan-time spawn failure invalidates them.
+        if (isAbsolute(raw.bin) && !existsSync(raw.bin))
+            return null;
+        return { bin: raw.bin, ...(raw.argv0 ? { argv0: raw.argv0 } : {}) };
+    }
+    catch {
+        return null;
+    }
+}
+function saveCached(rg) {
+    try {
+        mkdirSync(join(homedir(), '.coldstart'), { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify(rg));
+    }
+    catch {
+        /* cache is an optimization; resolution still works without it */
+    }
+}
+function probeAll() {
+    const env = process.env['COLDSTART_RG'];
+    if (env && isRipgrep(env))
+        return { bin: env };
+    if (isRipgrep('rg'))
+        return { bin: 'rg' };
+    const bundled = bundledRgPath();
+    if (bundled && isRipgrep(bundled))
+        return { bin: bundled };
+    for (const cand of appCandidates()) {
+        if (isAbsolute(cand.bin) && !existsSync(cand.bin))
+            continue;
+        if (isRipgrep(cand.bin, cand.argv0))
+            return cand;
+    }
+    return null;
+}
+/**
+ * Resolve the ripgrep to use, memoized per process and persisted across runs
+ * (CLI readers are a fresh process per call — without the disk record every
+ * `find` would pay the probe spawns). Returns null when no ripgrep exists.
+ */
+export function resolveRg() {
+    if (_rg !== undefined)
+        return _rg;
+    const env = process.env['COLDSTART_RG'];
+    if (env) {
+        _rg = isRipgrep(env) ? { bin: env } : probeAll(); // env always wins over the disk record
+        if (_rg)
+            saveCached(_rg);
+        return _rg;
+    }
+    const cached = loadCached();
+    if (cached)
+        return (_rg = cached);
+    _rg = probeAll();
+    if (_rg)
+        saveCached(_rg);
+    return _rg;
+}
+/** Drop the memo + disk record after a scan-time spawn failure, forcing a fresh probe. */
+export function invalidateRg() {
+    _rg = undefined;
+    try {
+        rmSync(CACHE_FILE, { force: true });
+    }
+    catch {
+        /* ignore */
+    }
+}
+//# sourceMappingURL=searcher.js.map

package/dist/server/searcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searcher.js","sourceRoot":"","sources":["../../src/server/searcher.ts"],"names":[],"mappings":"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"}

package/dist/server/tools.d.ts

@@ -0,0 +1,17 @@
+import type { CodebaseIndex } from '../types.js';
+export declare function handleFind(index: CodebaseIndex, params: {
+    query?: string;
+    domain_filter?: string;
+}): Promise<{
+    __rawText?: string;
+    error?: string;
+}>;
+type GsView = 'full' | 'symbols' | 'imports' | 'importers' | 'callers';
+export declare function handleGetStructure(index: CodebaseIndex, params: {
+    file_path: string;
+    match?: string;
+    view?: GsView;
+    symbol?: string;
+}): object;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/server/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/server/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAA2B,MAAM,aAAa,CAAC;AAuF1E,wBAAsB,UAAU,CAC9B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjD;AAKD,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAmBvE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,MAAM,CAsZR"}