clast-ai 0.1.2 → 0.2.0

package/bench/bench.mjs

@@ -0,0 +1,98 @@
+// Benchmark: cold index, warm rescan and query latency on real repositories.
+//
+//   npm run build
+//   node bench/bench.mjs <dir-with-repos> [repo-name ...]
+//
+// Each sub-directory of <dir-with-repos> is treated as one repository. The
+// benchmark uses its own database file (.clast/bench.db) so it never touches
+// a real index. Output is a Markdown table.
+
+import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+process.env.CLAST_DB_PATH = '.clast/bench.db';
+process.env.UV_THREADPOOL_SIZE ??= '16';
+
+const { Clast } = await import('../dist/engine.js');
+const { ToolContext } = await import('../dist/tools/context.js');
+const { search, getContext, callGraph } = await import('../dist/tools/search.js');
+const { overview, references } = await import('../dist/tools/explore.js');
+
+const base = resolve(process.argv[2] ?? '.bench/repos');
+const only = new Set(process.argv.slice(3));
+const repos = readdirSync(base).filter(
+  name => statSync(join(base, name)).isDirectory() && (only.size === 0 || only.has(name))
+);
+
+const ms = n => (n < 10 ? n.toFixed(1) : Math.round(n).toString());
+
+async function time(fn) {
+  const t = performance.now();
+  await fn();
+  return performance.now() - t;
+}
+
+/** Median of several runs of an async function, in ms. */
+async function median(fn, runs = 5) {
+  const samples = [];
+  for (let i = 0; i < runs; i++) samples.push(await time(fn));
+  samples.sort((a, b) => a - b);
+  return samples[Math.floor(samples.length / 2)];
+}
+
+const rows = [];
+for (const name of repos) {
+  const root = join(base, name);
+  for (const suffix of ['', '-wal', '-shm']) rmSync(join(root, '.clast', 'bench.db' + suffix), { force: true });
+
+  let clast = new Clast(root);
+  const cold = await clast.indexer.indexAll();
+  const stats = clast.db.stats();
+  clast.close();
+
+  // Warm start: new process state, nothing changed on disk.
+  clast = new Clast(root);
+  const warm = await clast.indexer.indexAll();
+  const ctx = new ToolContext(clast);
+
+  // Pick a real, well-connected symbol to query: the most called function / method.
+  const busiest = clast.db.get(
+    `SELECT s.name AS name, s.qname AS qname, COUNT(*) AS n FROM calls c
+     JOIN names nm ON nm.id = c.name_id JOIN symbols s ON s.name = nm.name
+     WHERE s.kind IN ('function', 'method') AND length(s.name) > 6
+     GROUP BY s.name HAVING COUNT(DISTINCT s.id) = 1 ORDER BY n DESC LIMIT 1`
+  );
+  const target = busiest?.qname ?? 'main';
+  const word = busiest?.name ?? 'main';
+
+  const tSearch = await median(() => search(ctx, { query: word }));
+  const tText = await median(() => search(ctx, { query: 'parse config file' }));
+  const tSymbol = await median(() => getContext(ctx, { name: target }));
+  const tCallers = await median(() => callGraph(ctx, { name: target, direction: 'callers', depth: 2 }));
+  const tRefs = await median(() => references(ctx, { name: word }));
+  const tOverview = await time(() => overview(ctx, {}));
+
+  const dbFile = join(root, '.clast', 'bench.db');
+  const dbMb = existsSync(dbFile) ? statSync(dbFile).size / 1e6 : 0;
+  clast.close();
+  for (const suffix of ['', '-wal', '-shm']) rmSync(dbFile + suffix, { force: true });
+
+  rows.push({
+    name, files: stats.files, symbols: stats.symbols, calls: stats.calls,
+    cold: cold.durationMs, workers: cold.workers, warm: warm.durationMs, dbMb,
+    tSearch, tText, tSymbol, tCallers, tRefs, tOverview, target,
+  });
+  console.error(`${name}: cold ${cold.durationMs}ms, warm ${warm.durationMs}ms`);
+}
+
+rows.sort((a, b) => b.files - a.files);
+console.log('| repo | files | symbols | call edges | cold index | warm rescan | db size | search (name) | search (words) | symbol + callers/callees | callers depth 2 | references | overview |');
+console.log('|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|');
+for (const r of rows) {
+  console.log(
+    `| ${r.name} | ${r.files} | ${r.symbols} | ${r.calls} | ${(r.cold / 1000).toFixed(1)} s | ${ms(r.warm)} ms | ` +
+      `${r.dbMb.toFixed(0)} MB | ${ms(r.tSearch)} ms | ${ms(r.tText)} ms | ${ms(r.tSymbol)} ms | ${ms(r.tCallers)} ms | ` +
+      `${ms(r.tRefs)} ms | ${ms(r.tOverview)} ms |`
+  );
+}
+console.log(`\nNode ${process.version}, ${process.platform} ${process.arch}. Query times are medians of 5 in-process runs on the most-called function of each repo.`);

package/bench/resolution.mjs

@@ -0,0 +1,75 @@
+// Diagnostic: how well does call resolution do on real repositories?
+//
+//   npm run build
+//   node bench/resolution.mjs <dir-with-repos> [repo-name ...]
+//
+// For a random sample of call sites per repository it reports how the
+// resolver classified them:
+//   resolved   - linked to one definition with confidence
+//   name-only  - a candidate was found but could not be confirmed ("?")
+//   unknown    - a member call on a receiver whose type could not be determined
+//   external   - no definition in the project (library / runtime / builtin)
+
+import { readdirSync, rmSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+process.env.CLAST_DB_PATH = '.clast/bench.db';
+process.env.UV_THREADPOOL_SIZE ??= '16';
+
+const { Clast } = await import('../dist/engine.js');
+const { Resolver } = await import('../dist/query/resolve.js');
+
+const base = resolve(process.argv[2] ?? '.bench/repos');
+const only = new Set(process.argv.slice(3));
+const repos = readdirSync(base).filter(
+  name => statSync(join(base, name)).isDirectory() && (only.size === 0 || only.has(name))
+);
+const SAMPLE = 4000;
+
+const rows = [];
+for (const name of repos) {
+  const root = join(base, name);
+  for (const suffix of ['', '-wal', '-shm']) rmSync(join(root, '.clast', 'bench.db' + suffix), { force: true });
+  const clast = new Clast(root);
+  await clast.indexer.indexAll();
+  const db = clast.db;
+  const resolver = new Resolver(db);
+  const total = db.get(`SELECT COUNT(*) AS n FROM calls`).n;
+  const sample = db.all(
+    `SELECT c.rowid AS id, n.name, c.file_id, c.caller_id, c.receiver, c.rtype, c.via, c.argc, f.path, f.lang
+     FROM calls c JOIN names n ON n.id = c.name_id JOIN files f ON f.id = c.file_id
+     WHERE c.rowid IN (SELECT rowid FROM calls ORDER BY random() LIMIT ?)`,
+    SAMPLE
+  );
+  const count = { resolved: 0, nameOnly: 0, unknown: 0, external: 0 };
+  const member = { resolved: 0, nameOnly: 0, unknown: 0, external: 0, n: 0 };
+  for (const row of sample) {
+    const caller = row.caller_id !== null ? db.symbolById(row.caller_id) ?? null : null;
+    const site = { fileId: row.file_id, path: row.path, lang: row.lang, receiver: row.receiver, rtype: row.rtype, via: row.via, argc: row.argc, caller };
+    const res = resolver.resolve(row.name, site);
+    let kind;
+    if (res.candidates.length) kind = res.confident ? 'resolved' : 'nameOnly';
+    else kind = resolver.isOpaqueReceiver(site) && resolver.candidates(row.name).length ? 'unknown' : 'external';
+    count[kind]++;
+    if (row.receiver) {
+      member[kind]++;
+      member.n++;
+    }
+  }
+  clast.close();
+  for (const suffix of ['', '-wal', '-shm']) rmSync(join(root, '.clast', 'bench.db' + suffix), { force: true });
+  rows.push({ name, total, n: sample.length, count, member });
+  console.error(`${name}: done`);
+}
+
+const pct = (a, b) => (b ? ((100 * a) / b).toFixed(0) + '%' : '-');
+rows.sort((a, b) => b.total - a.total);
+console.log('| repo | call edges | resolved | name-only "?" | unknown receiver | external | member calls: resolved / unknown |');
+console.log('|---|---:|---:|---:|---:|---:|---:|');
+for (const r of rows) {
+  console.log(
+    `| ${r.name} | ${r.total} | ${pct(r.count.resolved, r.n)} | ${pct(r.count.nameOnly, r.n)} | ${pct(r.count.unknown, r.n)} | ` +
+      `${pct(r.count.external, r.n)} | ${pct(r.member.resolved, r.member.n)} / ${pct(r.member.unknown, r.member.n)} |`
+  );
+}
+console.log(`\nSample: up to ${SAMPLE} random call sites per repository. "external" includes calls into libraries and language builtins, which no index of the project alone can resolve.`);

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+// More I/O threads: the startup scan stats every source file, which is the
+// dominant warm-start cost. Must be set before the first async fs call.
+process.env.UV_THREADPOOL_SIZE ??= '16';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Clast } from './engine.js';
+import { SourceParser } from './parser/index.js';
+import { ToolContext } from './tools/context.js';
+import { callGraph, getContext, hierarchy, search } from './tools/search.js';
+import { changes, fileSummary, grep, overview, references, reindex, status } from './tools/explore.js';
+import { impact, unused } from './tools/impact.js';
+import { stats } from './tools/stats.js';
+import { VERSION } from './version.js';
+const HELP = `clast-ai ${VERSION} - code index for LLM agents
+
+usage: clast-ai [command] [args] [--root <dir>]
+
+  (no command), serve        run the MCP server on stdio (what Claude Code launches)
+  index [--force]            build / update the index
+  status                     index statistics
+  overview [path]            repository map
+  outline <path>             file or directory outline
+  search <query...>          ranked symbol search   [--kind k] [--path p] [--lang l] [--limit n]
+  symbol <name...>           source + callers + callees of a symbol   [--path p] [--max-lines n] [--no-body]
+  callers <name>             who calls it   [--depth n] [--limit n] [--within path] [--no-tests|--tests] [--uncertain]
+  callees <name>             what it calls  [--depth n] [--limit n]
+  hierarchy <name>           supertypes / subtypes / overrides   [--depth n] [--limit n] [--within path]
+  refs <name>                all references to an identifier   [--path p] [--limit n]
+  grep <pattern>             text search with enclosing symbols   [--regex] [--path p] [--limit n]
+  changes [base]             symbols touched by the git diff and their impact
+  impact <name>              what must change with it, who reaches it, which tests to run   [--depth n] [--limit n]
+  unused [path]              dead code   [--kind k] [--lang l] [--limit n] [--no-exported]
+  stats [what] [name]        exact counts: inventory | symbols | subtypes | calls | text | imports | endpoints | database
+                             [--kind k] [--on receiver] [--path p] [--lang l] [--group-by g] [--depth n] [--limit n] [--tests]
+  parse <file> [--json]      debug: show what the extractor produces for a file
+  ast <file>                 debug: dump the tree-sitter syntax tree
+
+Query commands refresh the index incrementally first (skip with --no-scan).`;
+const CLI_NAMES = {
+    clast_search: 'clast-ai search',
+    clast_get_context: 'clast-ai symbol',
+    clast_call_graph: 'clast-ai callers / callees',
+    clast_references: 'clast-ai refs',
+    clast_hierarchy: 'clast-ai hierarchy',
+    clast_file_summary: 'clast-ai outline',
+    clast_overview: 'clast-ai overview',
+    clast_grep: 'clast-ai grep',
+    clast_changes: 'clast-ai changes',
+    clast_stats: 'clast-ai stats',
+    clast_impact: 'clast-ai impact',
+    clast_unused: 'clast-ai unused',
+    clast_reindex: 'clast-ai index',
+    clast_status: 'clast-ai status',
+};
+const BOOLEAN_FLAGS = new Set([
+    'force', 'json', 'regex', 'no-body', 'no-scan', 'no-tests', 'tests', 'uncertain', 'help', 'version', 'all', 'no-exported',
+]);
+function parseArgs(argv) {
+    const positional = [];
+    const flags = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith('--')) {
+            const eq = a.indexOf('=');
+            if (eq !== -1)
+                flags.set(a.slice(2, eq), a.slice(eq + 1));
+            else if (BOOLEAN_FLAGS.has(a.slice(2)) || i + 1 >= argv.length)
+                flags.set(a.slice(2), true);
+            else
+                flags.set(a.slice(2), argv[++i]);
+        }
+        else if (a === '-h')
+            flags.set('help', true);
+        else
+            positional.push(a);
+    }
+    return { positional, flags };
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const cmd = argv[0] && !argv[0].startsWith('-') ? argv[0] : undefined;
+    const { positional, flags } = parseArgs(cmd ? argv.slice(1) : argv);
+    const str = (k) => {
+        const v = flags.get(k);
+        return typeof v === 'string' ? v : undefined;
+    };
+    const num = (k) => {
+        const v = str(k);
+        return v !== undefined && /^\d+$/.test(v) ? Number(v) : undefined;
+    };
+    if (flags.has('version'))
+        return void console.log(VERSION);
+    if (flags.has('help') || cmd === 'help')
+        return void console.log(HELP);
+    if (cmd === undefined || cmd === 'serve') {
+        if (str('root'))
+            process.env.CLAST_PROJECT_DIR = resolve(str('root'));
+        const { startServer } = await import('./server/index.js');
+        await startServer();
+        return;
+    }
+    if (cmd === 'parse' || cmd === 'ast') {
+        const file = positional[0];
+        if (!file)
+            throw new Error(`usage: clast-ai ${cmd} <file>`);
+        const source = readFileSync(file, 'utf-8');
+        const parser = new SourceParser();
+        if (cmd === 'ast')
+            return void console.log(await parser.dumpTree(file, source));
+        const ex = await parser.extract(file, source);
+        if (!ex)
+            throw new Error('unsupported file type');
+        if (flags.has('json'))
+            return void console.log(JSON.stringify(ex, null, 1));
+        for (const s of ex.symbols) {
+            console.log(`${String(s.startLine).padStart(5)}-${String(s.endLine).padEnd(5)} ${s.kind.padEnd(11)} ${s.qname}` +
+                `${s.exported ? ' [exported]' : ''}\n${' '.repeat(12)}sig: ${s.signature}` +
+                (s.doc ? `\n${' '.repeat(12)}doc: ${s.doc.split('\n')[0]}` : ''));
+        }
+        console.log(`\ncalls (${ex.calls.length}):`);
+        for (const c of ex.calls) {
+            const caller = c.caller >= 0 ? ex.symbols[c.caller].qname : '<file>';
+            console.log(`  ${caller} -> ${c.receiver ? c.receiver + '.' : ''}${c.name} @${c.line}${c.count > 1 ? ' x' + c.count : ''}`);
+        }
+        console.log(`\nimports (${ex.imports.length}):`);
+        for (const i of ex.imports)
+            console.log(`  ${i.source} {${i.names.join(', ')}} @${i.line}`);
+        console.log(`\nheritage (${ex.heritage.length}):`);
+        for (const h of ex.heritage)
+            console.log(`  ${ex.symbols[h.symbol].qname} ${h.kind} ${h.name}`);
+        console.log(`\nidentifiers: ${ex.occ.length} distinct, parse errors: ${ex.hadError}`);
+        return;
+    }
+    const root = resolve(str('root') ?? process.env.CLAST_PROJECT_DIR ?? process.cwd());
+    const clast = new Clast(root);
+    const ctx = new ToolContext(clast);
+    try {
+        if (cmd === 'index') {
+            const target = positional[0];
+            if (target) {
+                // Convenience: `clast-ai index <dir>` indexes another directory.
+                clast.close();
+                const other = new Clast(resolve(target));
+                const octx = new ToolContext(other);
+                console.log(await reindex(octx, { force: flags.has('force') }));
+                other.close();
+                return;
+            }
+            console.log(await reindex(ctx, { force: flags.has('force') }));
+            return;
+        }
+        if (!flags.has('no-scan'))
+            await clast.indexer.indexAll();
+        const includeTests = flags.has('no-tests') ? false : flags.has('tests') ? true : undefined;
+        let out;
+        switch (cmd) {
+            case 'status':
+                out = await status(ctx);
+                break;
+            case 'overview':
+            case 'map':
+                out = await overview(ctx, { path: positional[0] });
+                break;
+            case 'outline':
+            case 'file':
+                out = await fileSummary(ctx, { path: positional[0] ?? '.', members: flags.has('all') ? 'all' : 'auto' });
+                break;
+            case 'search':
+                out = await search(ctx, {
+                    query: positional.join(' '), kind: str('kind'), path: str('path'), lang: str('lang'), limit: num('limit'),
+                });
+                break;
+            case 'symbol':
+            case 'context':
+                out = await getContext(ctx, {
+                    name: positional, path: str('path'), maxLines: num('max-lines'), includeBody: !flags.has('no-body'),
+                });
+                break;
+            case 'callers':
+            case 'callees':
+            case 'graph':
+                out = await callGraph(ctx, {
+                    name: positional[0] ?? '', path: str('path'),
+                    direction: cmd === 'graph' ? 'both' : cmd,
+                    depth: num('depth'), limit: num('limit'), includeTests, within: str('within'), uncertain: flags.has('uncertain'),
+                });
+                break;
+            case 'hierarchy':
+            case 'types':
+                out = await hierarchy(ctx, {
+                    name: positional[0] ?? '', path: str('path'), depth: num('depth'), limit: num('limit'), within: str('within'),
+                    direction: str('direction'),
+                });
+                break;
+            case 'refs':
+            case 'references':
+                out = await references(ctx, { name: positional[0] ?? '', path: str('path'), limit: num('limit'), includeTests });
+                break;
+            case 'grep':
+                out = await grep(ctx, {
+                    pattern: positional.join(' '), regex: flags.has('regex'), path: str('path'), lang: str('lang'),
+                    limit: num('limit'), includeTests,
+                });
+                break;
+            case 'changes':
+                out = await changes(ctx, { base: positional[0] });
+                break;
+            case 'impact':
+                out = await impact(ctx, { name: positional.join(' '), path: str('path'), depth: num('depth'), limit: num('limit') });
+                break;
+            case 'unused':
+            case 'dead':
+                out = await unused(ctx, {
+                    path: positional[0] ?? str('path'), lang: str('lang'), kind: str('kind'), limit: num('limit'),
+                    exported: flags.has('no-exported') ? false : undefined,
+                });
+                break;
+            case 'stats':
+            case 'count': {
+                const WHATS = ['inventory', 'symbols', 'subtypes', 'calls', 'text', 'imports', 'endpoints', 'database'];
+                const hasWhat = WHATS.includes(positional[0] ?? '');
+                out = await stats(ctx, {
+                    what: hasWhat ? positional[0] : undefined,
+                    name: (hasWhat ? positional.slice(1) : positional).join(' ') || undefined,
+                    kind: str('kind'), on: str('on'), path: str('path'), lang: str('lang'),
+                    groupBy: str('group-by'), depth: num('depth'), limit: num('limit'),
+                    includeTests: includeTests === true,
+                });
+                break;
+            }
+            default:
+                console.error(`unknown command: ${cmd}\n\n${HELP}`);
+                process.exitCode = 1;
+                return;
+        }
+        // Tool hints name MCP tools; say the same thing in CLI terms here.
+        console.log(out
+            .replace(/clast_[a-z_]+/g, t => CLI_NAMES[t] ?? t)
+            .replace(/\buncertain=true\b/g, '--uncertain')
+            .replace(/\bincludeTests=true\b/g, '--tests')
+            .replace(/\braise maxLines\b/g, 'raise --max-lines'));
+        if (out.startsWith('error:'))
+            process.exitCode = 1;
+    }
+    finally {
+        try {
+            clast.close();
+        }
+        catch { /* closed above */ }
+    }
+}
+main().catch(err => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config/defaults.d.ts

@@ -1,7 +1,18 @@
 export interface ClastConfig {
+    /** Language ids to index. Empty = all supported languages. */
     languages: string[];
+    /** Directory / file names (or gitignore-style patterns) to skip. */
     ignoredPaths: string[];
+    /** Honour .gitignore files (root and nested). */
+    respectGitignore: boolean;
+    /** Index location, relative to the project root unless absolute. */
     dbPath: string;
+    /** Files larger than this many bytes are skipped (generated / vendored blobs). */
+    maxFileSize: number;
+    /** Safety cap on the number of source files indexed (e.g. when started in a home directory). */
+    maxFiles: number;
+    /** Parser worker threads for bulk indexing. 0 = auto, 1 = no workers. */
+    workers: number;
     llm: {
         endpoint: string;
         model: string;
@@ -13,7 +24,6 @@ export interface ClastConfig {
         debounceMs: number;
         enabled: boolean;
     };
-    maxBodySize: number;
 }
+export declare const DEFAULT_IGNORED: string[];
 export declare const DEFAULT_CONFIG: ClastConfig;
-//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.js

@@ -1,33 +1,41 @@
+export const DEFAULT_IGNORED = [
+    'node_modules',
+    '.git',
+    '.hg',
+    '.svn',
+    'dist',
+    'build',
+    'out',
+    '__pycache__',
+    '.venv',
+    'venv',
+    '.clast',
+    'vendor',
+    'target',
+    '.next',
+    '.nuxt',
+    'coverage',
+    '.idea',
+    '.vscode-test',
+    '.gradle',
+    '.tox',
+    '.mypy_cache',
+    '.pytest_cache',
+    'bower_components',
+    'Pods',
+    '*.min.js',
+    '*.min.css',
+    '*.bundle.js',
+    '*.d.ts.map',
+];
 export const DEFAULT_CONFIG = {
-    languages: [
-        'typescript',
-        'javascript',
-        'python',
-        'java',
-        'csharp',
-        'go',
-        'rust',
-        'c',
-        'cpp',
-        'ruby',
-        'php',
-    ],
-    ignoredPaths: [
-        'node_modules',
-        '.git',
-        'dist',
-        'build',
-        'out',
-        '__pycache__',
-        '.venv',
-        'venv',
-        '.clast',
-        'vendor',
-        'target',
-        '.next',
-        'coverage',
-    ],
-    dbPath: '.clast/clast.db',
+    languages: [],
+    ignoredPaths: DEFAULT_IGNORED,
+    respectGitignore: true,
+    dbPath: '.clast/index.db',
+    maxFileSize: 1_000_000,
+    maxFiles: 150_000,
+    workers: 0,
     llm: {
         endpoint: 'http://localhost:11434/v1',
         model: '',
@@ -36,9 +44,8 @@ export const DEFAULT_CONFIG = {
         alwaysGenerate: false,
     },
     watch: {
-        debounceMs: 300,
+        debounceMs: 200,
         enabled: true,
     },
-    maxBodySize: 2000,
 };
 //# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,SAAS,EAAE;QACT,YAAY;QACZ,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,IAAI;QACJ,MAAM;QACN,GAAG;QACH,KAAK;QACL,MAAM;QACN,KAAK;KACN;IACD,YAAY,EAAE;QACZ,cAAc;QACd,MAAM;QACN,MAAM;QACN,OAAO;QACP,KAAK;QACL,aAAa;QACb,OAAO;QACP,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,UAAU;KACX;IACD,MAAM,EAAE,iBAAiB;IACzB,GAAG,EAAE;QACH,QAAQ,EAAE,2BAA2B;QACrC,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,KAAK;KACtB;IACD,KAAK,EAAE;QACL,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,IAAI;KACd;IACD,WAAW,EAAE,IAAI;CAClB,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc;IACd,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,aAAa;IACb,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,UAAU;IACV,OAAO;IACP,cAAc;IACd,SAAS;IACT,MAAM;IACN,aAAa;IACb,eAAe;IACf,kBAAkB;IAClB,MAAM;IACN,UAAU;IACV,WAAW;IACX,aAAa;IACb,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,IAAI;IACtB,MAAM,EAAE,iBAAiB;IACzB,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,CAAC;IACV,GAAG,EAAE;QACH,QAAQ,EAAE,2BAA2B;QACrC,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,KAAK;KACtB;IACD,KAAK,EAAE;QACL,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,IAAI;KACd;CACF,CAAC"}

package/dist/config/index.d.ts

@@ -1,5 +1,5 @@
 import { type ClastConfig } from './defaults.js';
 export type { ClastConfig } from './defaults.js';
+export declare function parseConfig(raw: unknown): ClastConfig;
 export declare function loadConfig(projectRoot: string): ClastConfig;
 export declare function resolveDbPath(projectRoot: string, config: ClastConfig): string;
-//# sourceMappingURL=index.d.ts.map

package/dist/config/index.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { isAbsolute, join } from 'node:path';
 import { DEFAULT_CONFIG } from './defaults.js';
 const LlmConfigSchema = z.object({
     endpoint: z.string().default(DEFAULT_CONFIG.llm.endpoint),
@@ -10,39 +10,51 @@ const LlmConfigSchema = z.object({
     alwaysGenerate: z.boolean().default(DEFAULT_CONFIG.llm.alwaysGenerate),
 });
 const WatchConfigSchema = z.object({
-    debounceMs: z.number().int().min(50).max(5000).default(DEFAULT_CONFIG.watch.debounceMs),
+    debounceMs: z.number().int().min(20).max(5000).default(DEFAULT_CONFIG.watch.debounceMs),
     enabled: z.boolean().default(DEFAULT_CONFIG.watch.enabled),
 });
 const ClastConfigSchema = z.object({
     languages: z.array(z.string()).default(DEFAULT_CONFIG.languages),
     ignoredPaths: z.array(z.string()).default(DEFAULT_CONFIG.ignoredPaths),
+    respectGitignore: z.boolean().default(DEFAULT_CONFIG.respectGitignore),
     dbPath: z.string().default(DEFAULT_CONFIG.dbPath),
+    maxFileSize: z.number().int().min(1000).max(100_000_000).default(DEFAULT_CONFIG.maxFileSize),
+    maxFiles: z.number().int().min(100).max(5_000_000).default(DEFAULT_CONFIG.maxFiles),
+    workers: z.number().int().min(0).max(64).default(DEFAULT_CONFIG.workers),
     llm: LlmConfigSchema.default(DEFAULT_CONFIG.llm),
     watch: WatchConfigSchema.default(DEFAULT_CONFIG.watch),
-    maxBodySize: z.number().int().min(100).max(50000).default(DEFAULT_CONFIG.maxBodySize),
 });
+export function parseConfig(raw) {
+    return ClastConfigSchema.parse(raw ?? {});
+}
 export function loadConfig(projectRoot) {
     const candidates = [
         join(projectRoot, 'clast.config.json'),
         join(projectRoot, '.claude', 'clast.config.json'),
     ];
     for (const candidate of candidates) {
-        if (existsSync(candidate)) {
-            try {
-                const raw = JSON.parse(readFileSync(candidate, 'utf-8'));
-                return ClastConfigSchema.parse(raw);
-            }
-            catch (err) {
-                console.error(`[clast] Failed to parse config at ${candidate}:`, err);
-            }
+        if (!existsSync(candidate))
+            continue;
+        try {
+            const raw = JSON.parse(readFileSync(candidate, 'utf-8'));
+            // The pre-0.2 default pointed at a sql.js database; never reuse that file name.
+            if (raw && raw.dbPath === '.clast/clast.db')
+                delete raw.dbPath;
+            return parseConfig(raw);
+        }
+        catch (err) {
+            console.error(`[clast] Ignoring invalid config at ${candidate}: ${err instanceof Error ? err.message : err}`);
         }
     }
-    return ClastConfigSchema.parse({});
+    return parseConfig({});
 }
 export function resolveDbPath(projectRoot, config) {
-    if (config.dbPath.startsWith('/') || config.dbPath.match(/^[a-zA-Z]:\\/)) {
+    // CLAST_DB_PATH overrides the configured location (useful for CI caches and experiments).
+    const override = process.env.CLAST_DB_PATH;
+    if (override)
+        return override === ':memory:' || isAbsolute(override) ? override : join(projectRoot, override);
+    if (config.dbPath === ':memory:' || isAbsolute(config.dbPath))
         return config.dbPath;
-    }
     return join(projectRoot, config.dbPath);
 }
 //# sourceMappingURL=index.js.map