@zbigniewsobiecki/squint 1.0.0

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from '@oclif/core';
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from '@oclif/core';
+
+await execute({ dir: import.meta.url });

package/dist/commands/_shared/db-helper.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from '@oclif/core';
+import { IndexDatabase } from '../../db/database.js';
+/**
+ * Resolve the database path from the flag value.
+ * If no explicit path is given, walk up from CWD to find .squint.db.
+ */
+export declare function resolveDbPath(dbPath: string | undefined, command: Command): string;
+/**
+ * Open a database, checking that it exists first.
+ * Throws Command.error() if the database doesn't exist or can't be opened.
+ */
+export declare function openDatabase(dbPath: string | undefined, command: Command): Promise<IndexDatabase>;
+/**
+ * Execute a function with a database connection, ensuring it's closed afterward.
+ * Combines database opening and try/finally pattern.
+ */
+export declare function withDatabase<T>(dbPath: string | undefined, command: Command, fn: (db: IndexDatabase) => Promise<T>): Promise<T>;
+//# sourceMappingURL=db-helper.d.ts.map

package/dist/commands/_shared/db-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-helper.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/db-helper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAmBrD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAYlF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBvG;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/commands/_shared/db-helper.js

@@ -0,0 +1,72 @@
+import fs from 'node:fs';
+import fsPromises from 'node:fs/promises';
+import path from 'node:path';
+import chalk from 'chalk';
+import { IndexDatabase } from '../../db/database.js';
+const DB_NAME = '.squint.db';
+/**
+ * Walk up from CWD looking for a .squint.db file.
+ * Returns the absolute path if found, null otherwise.
+ */
+function findDatabase() {
+    let dir = process.cwd();
+    while (true) {
+        const candidate = path.join(dir, DB_NAME);
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null; // reached filesystem root
+        dir = parent;
+    }
+}
+/**
+ * Resolve the database path from the flag value.
+ * If no explicit path is given, walk up from CWD to find .squint.db.
+ */
+export function resolveDbPath(dbPath, command) {
+    if (dbPath)
+        return path.resolve(dbPath);
+    const found = findDatabase();
+    if (!found) {
+        command.error(chalk.red('No .squint.db found in current directory or any parent.\n' +
+            "Run 'squint parse <directory>' first, or specify -d <path>."));
+    }
+    return found;
+}
+/**
+ * Open a database, checking that it exists first.
+ * Throws Command.error() if the database doesn't exist or can't be opened.
+ */
+export async function openDatabase(dbPath, command) {
+    const resolvedPath = resolveDbPath(dbPath, command);
+    // Check if database exists
+    try {
+        await fsPromises.access(resolvedPath);
+    }
+    catch {
+        command.error(chalk.red(`Database file "${resolvedPath}" does not exist.\nRun 'squint parse <directory>' first to create an index.`));
+    }
+    // Open database
+    try {
+        return new IndexDatabase(resolvedPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        command.error(chalk.red(`Failed to open database: ${message}`));
+    }
+}
+/**
+ * Execute a function with a database connection, ensuring it's closed afterward.
+ * Combines database opening and try/finally pattern.
+ */
+export async function withDatabase(dbPath, command, fn) {
+    const db = await openDatabase(dbPath, command);
+    try {
+        return await fn(db);
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=db-helper.js.map

package/dist/commands/_shared/db-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-helper.js","sourceRoot":"","sources":["../../../src/commands/_shared/db-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,YAAY,CAAC;AAE7B;;;GAGG;AACH,SAAS,YAAY;IACnB,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,CAAC,0BAA0B;QAC3D,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,OAAgB;IACxE,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,2DAA2D;YACzD,6DAA6D,CAChE,CACF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B,EAAE,OAAgB;IAC7E,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpD,2BAA2B;IAC3B,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,kBAAkB,YAAY,6EAA6E,CAC5G,CACF,CAAC;IACJ,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC;QACH,OAAO,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0B,EAC1B,OAAgB,EAChB,EAAqC;IAErC,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/commands/_shared/flags.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared flag definitions for consistent CLI experience across commands.
+ */
+export declare const LlmFlags: {
+    model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    'show-llm-requests': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    'show-llm-responses': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+};
+export declare const SharedFlags: {
+    database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    symbolName: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    symbolId: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    symbolFile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    aspect: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+};
+//# sourceMappingURL=flags.d.ts.map

package/dist/commands/_shared/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/flags.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;CAOpB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;CA6BvB,CAAC"}

package/dist/commands/_shared/flags.js

@@ -0,0 +1,38 @@
+import { Flags } from '@oclif/core';
+/**
+ * Shared flag definitions for consistent CLI experience across commands.
+ */
+export const LlmFlags = {
+    model: Flags.string({ char: 'm', description: 'LLM model alias', default: 'openrouter:google/gemini-2.5-flash' }),
+    'dry-run': Flags.boolean({ description: 'Show results without persisting', default: false }),
+    force: Flags.boolean({ description: 'Re-run even if data already exists', default: false }),
+    verbose: Flags.boolean({ description: 'Show detailed progress', default: false }),
+    'show-llm-requests': Flags.boolean({ description: 'Show full LLM request prompts', default: false }),
+    'show-llm-responses': Flags.boolean({ description: 'Show full LLM responses', default: false }),
+};
+export const SharedFlags = {
+    database: Flags.string({
+        char: 'd',
+        description: 'Path to the index database',
+    }),
+    symbolName: Flags.string({
+        char: 'n',
+        description: 'Symbol name',
+    }),
+    symbolId: Flags.integer({
+        description: 'Symbol ID',
+    }),
+    symbolFile: Flags.string({
+        char: 'f',
+        description: 'Disambiguate by file path',
+    }),
+    json: Flags.boolean({
+        description: 'Output as JSON',
+        default: false,
+    }),
+    aspect: Flags.string({
+        char: 'a',
+        description: 'Metadata aspect key',
+    }),
+};
+//# sourceMappingURL=flags.js.map

package/dist/commands/_shared/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/commands/_shared/flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IACjH,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5F,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3F,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjF,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpG,oBAAoB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;CAChG,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,4BAA4B;KAC1C,CAAC;IAEF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,aAAa;KAC3B,CAAC;IAEF,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;QACtB,WAAW,EAAE,WAAW;KACzB,CAAC;IAEF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,2BAA2B;KACzC,CAAC;IAEF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,qBAAqB;KACnC,CAAC;CACH,CAAC"}

package/dist/commands/_shared/index.d.ts

@@ -0,0 +1,6 @@
+export { openDatabase, withDatabase, resolveDbPath } from './db-helper.js';
+export { SymbolResolver, type ResolvedSymbol, type ResolvedSymbolWithDetails } from './symbol-resolver.js';
+export { SharedFlags, LlmFlags } from './flags.js';
+export { outputJsonOrPlain, truncate, tableSeparator, formatLineNumber } from './output.js';
+export { readSourceLines, readSourceAsString, readAllLines } from './source-reader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/_shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/commands/_shared/index.js

@@ -0,0 +1,6 @@
+export { openDatabase, withDatabase, resolveDbPath } from './db-helper.js';
+export { SymbolResolver } from './symbol-resolver.js';
+export { SharedFlags, LlmFlags } from './flags.js';
+export { outputJsonOrPlain, truncate, tableSeparator, formatLineNumber } from './output.js';
+export { readSourceLines, readSourceAsString, readAllLines } from './source-reader.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/_shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/_shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAuD,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/commands/_shared/output.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from '@oclif/core';
+/**
+ * Output data as JSON or plain text based on the json flag.
+ * @param command The command instance (for this.log)
+ * @param json Whether to output as JSON
+ * @param data The data to output (for JSON mode)
+ * @param plainFn Function to call for plain text output
+ */
+export declare function outputJsonOrPlain<T>(command: Command, json: boolean, data: T, plainFn: () => void): void;
+/**
+ * Truncate a string to a maximum length, adding ellipsis if truncated.
+ */
+export declare function truncate(str: string, maxLen: number): string;
+/**
+ * Create a horizontal separator line.
+ */
+export declare function tableSeparator(width: number, char?: string): string;
+/**
+ * Format a line number with consistent width padding.
+ */
+export declare function formatLineNumber(line: number, width?: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/commands/_shared/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAMxG;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAEhE"}

package/dist/commands/_shared/output.js

@@ -0,0 +1,36 @@
+/**
+ * Output data as JSON or plain text based on the json flag.
+ * @param command The command instance (for this.log)
+ * @param json Whether to output as JSON
+ * @param data The data to output (for JSON mode)
+ * @param plainFn Function to call for plain text output
+ */
+export function outputJsonOrPlain(command, json, data, plainFn) {
+    if (json) {
+        command.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        plainFn();
+    }
+}
+/**
+ * Truncate a string to a maximum length, adding ellipsis if truncated.
+ */
+export function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return `${str.slice(0, maxLen - 3)}...`;
+}
+/**
+ * Create a horizontal separator line.
+ */
+export function tableSeparator(width, char = '─') {
+    return char.repeat(width);
+}
+/**
+ * Format a line number with consistent width padding.
+ */
+export function formatLineNumber(line, width = 5) {
+    return String(line).padStart(width, ' ');
+}
+//# sourceMappingURL=output.js.map

package/dist/commands/_shared/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/commands/_shared/output.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAAgB,EAAE,IAAa,EAAE,IAAO,EAAE,OAAmB;IAChG,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAc;IAClD,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAI,GAAG,GAAG;IACtD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC;IACtD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC"}

package/dist/commands/_shared/source-reader.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Read specific lines from a source file.
+ * @param filePath Path to the source file
+ * @param start Start line (1-based, inclusive)
+ * @param end End line (1-based, inclusive)
+ * @returns Array of source lines, or ['<source code not available>'] on error
+ */
+export declare function readSourceLines(filePath: string, start: number, end: number): Promise<string[]>;
+/**
+ * Read specific lines from a source file as a single string.
+ * @param filePath Path to the source file
+ * @param start Start line (1-based, inclusive)
+ * @param end End line (1-based, inclusive)
+ * @returns Source code string, or '<source code not available>' on error
+ */
+export declare function readSourceAsString(filePath: string, start: number, end: number): Promise<string>;
+/**
+ * Read all lines from a source file.
+ * @param filePath Path to the source file
+ * @returns Array of all source lines, or empty array on error
+ */
+export declare function readAllLines(filePath: string): Promise<string[]>;
+//# sourceMappingURL=source-reader.d.ts.map

package/dist/commands/_shared/source-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-reader.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/source-reader.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASrG;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtG;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOtE"}

package/dist/commands/_shared/source-reader.js

@@ -0,0 +1,45 @@
+import fs from 'node:fs/promises';
+/**
+ * Read specific lines from a source file.
+ * @param filePath Path to the source file
+ * @param start Start line (1-based, inclusive)
+ * @param end End line (1-based, inclusive)
+ * @returns Array of source lines, or ['<source code not available>'] on error
+ */
+export async function readSourceLines(filePath, start, end) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const lines = content.split('\n');
+        // Convert to 0-based indexing for array access
+        return lines.slice(start - 1, end);
+    }
+    catch {
+        return ['<source code not available>'];
+    }
+}
+/**
+ * Read specific lines from a source file as a single string.
+ * @param filePath Path to the source file
+ * @param start Start line (1-based, inclusive)
+ * @param end End line (1-based, inclusive)
+ * @returns Source code string, or '<source code not available>' on error
+ */
+export async function readSourceAsString(filePath, start, end) {
+    const lines = await readSourceLines(filePath, start, end);
+    return lines.join('\n');
+}
+/**
+ * Read all lines from a source file.
+ * @param filePath Path to the source file
+ * @returns Array of all source lines, or empty array on error
+ */
+export async function readAllLines(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return content.split('\n');
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=source-reader.js.map

package/dist/commands/_shared/source-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-reader.js","sourceRoot":"","sources":["../../../src/commands/_shared/source-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAa,EAAE,GAAW;IAChF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,+CAA+C;QAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAa,EAAE,GAAW;IACnF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/_shared/symbol-resolver.d.ts

@@ -0,0 +1,35 @@
+import type { Command } from '@oclif/core';
+import type { IndexDatabase } from '../../db/database.js';
+export interface ResolvedSymbol {
+    id: number;
+}
+export interface ResolvedSymbolWithDetails {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    endLine: number;
+    isExported: boolean;
+}
+/**
+ * Utility class for resolving symbols by name, ID, or file path.
+ * Handles disambiguation when multiple symbols match.
+ */
+export declare class SymbolResolver {
+    private db;
+    private command;
+    constructor(db: IndexDatabase, command: Command);
+    /**
+     * Resolve a symbol with interactive disambiguation.
+     * Shows disambiguation options and returns null if user needs to specify more.
+     * Throws Command.error() if symbol is not found.
+     */
+    resolve(name?: string, id?: number, filePath?: string, flagPrefix?: string): ResolvedSymbol | null;
+    /**
+     * Resolve a symbol silently (for batch operations).
+     * Returns null if not found or ambiguous, without printing errors.
+     */
+    resolveSilent(name?: string, id?: number, filePath?: string): ResolvedSymbolWithDetails | null;
+}
+//# sourceMappingURL=symbol-resolver.d.ts.map

package/dist/commands/_shared/symbol-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-resolver.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/symbol-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,OAAO;gBADP,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,OAAO;IAG1B;;;;OAIG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAsDlG;;;OAGG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;CAqC/F"}

package/dist/commands/_shared/symbol-resolver.js

@@ -0,0 +1,102 @@
+import path from 'node:path';
+import chalk from 'chalk';
+/**
+ * Utility class for resolving symbols by name, ID, or file path.
+ * Handles disambiguation when multiple symbols match.
+ */
+export class SymbolResolver {
+    db;
+    command;
+    constructor(db, command) {
+        this.db = db;
+        this.command = command;
+    }
+    /**
+     * Resolve a symbol with interactive disambiguation.
+     * Shows disambiguation options and returns null if user needs to specify more.
+     * Throws Command.error() if symbol is not found.
+     */
+    resolve(name, id, filePath, flagPrefix) {
+        const prefix = flagPrefix ?? '';
+        const idFlag = prefix ? `--${prefix}-id` : '--id';
+        const fileFlag = prefix ? `--${prefix}-file` : '--file';
+        const nameRequiredMsg = prefix ? `--${prefix} or ${idFlag} is required` : 'Symbol name is required';
+        // Direct ID lookup
+        if (id !== undefined) {
+            const def = this.db.definitions.getById(id);
+            if (!def) {
+                this.command.error(chalk.red(`No definition found with ID ${id}`));
+            }
+            return { id };
+        }
+        // Name lookup
+        if (!name) {
+            this.command.error(chalk.red(nameRequiredMsg));
+        }
+        let matches = this.db.definitions.getAllByName(name);
+        if (matches.length === 0) {
+            this.command.error(chalk.red(`No symbol found with name "${name}"`));
+        }
+        // Filter by file if specified
+        if (filePath) {
+            const resolvedPath = path.resolve(filePath);
+            const relativePath = this.db.toRelativePath(resolvedPath);
+            matches = matches.filter((m) => m.filePath === relativePath || m.filePath === resolvedPath || m.filePath.endsWith(filePath));
+            if (matches.length === 0) {
+                this.command.error(chalk.red(`No symbol "${name}" found in file "${filePath}"`));
+            }
+        }
+        // Disambiguation needed
+        if (matches.length > 1) {
+            this.command.log(chalk.yellow(`Multiple symbols found with name "${name}":`));
+            this.command.log('');
+            for (const match of matches) {
+                this.command.log(`  ${chalk.cyan(idFlag)} ${match.id}\t${match.kind}\t${match.filePath}:${match.line}`);
+            }
+            this.command.log('');
+            this.command.log(chalk.gray(`Use ${idFlag} or ${fileFlag} to disambiguate`));
+            return null;
+        }
+        return { id: matches[0].id };
+    }
+    /**
+     * Resolve a symbol silently (for batch operations).
+     * Returns null if not found or ambiguous, without printing errors.
+     */
+    resolveSilent(name, id, filePath) {
+        // Direct ID lookup
+        if (id !== undefined) {
+            const def = this.db.definitions.getById(id);
+            if (!def)
+                return null;
+            return {
+                id: def.id,
+                name: def.name,
+                kind: def.kind,
+                filePath: def.filePath,
+                line: def.line,
+                endLine: def.endLine,
+                isExported: def.isExported,
+            };
+        }
+        // Name lookup
+        if (!name)
+            return null;
+        let matches = this.db.definitions.getAllByName(name);
+        if (matches.length === 0)
+            return null;
+        // Filter by file if specified
+        if (filePath) {
+            const resolvedPath = path.resolve(filePath);
+            const relativePath = this.db.toRelativePath(resolvedPath);
+            matches = matches.filter((m) => m.filePath === relativePath || m.filePath === resolvedPath || m.filePath.endsWith(filePath));
+            if (matches.length === 0)
+                return null;
+        }
+        // Ambiguous
+        if (matches.length > 1)
+            return null;
+        return matches[0];
+    }
+}
+//# sourceMappingURL=symbol-resolver.js.map

package/dist/commands/_shared/symbol-resolver.js.map

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

package/dist/commands/browse.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Browse extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'no-open': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private openBrowser;
+}
+//# sourceMappingURL=browse.d.ts.map

package/dist/commands/browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,OAAgB,WAAW,SAA0D;IAErF,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;MAWnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAwEjC,OAAO,CAAC,WAAW;CAmBpB"}

package/dist/commands/browse.js

@@ -0,0 +1,106 @@
+import { exec } from 'node:child_process';
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { createServer, startServer } from '../web/server.js';
+import { SharedFlags, openDatabase, resolveDbPath } from './_shared/index.js';
+export default class Browse extends Command {
+    static description = 'Launch interactive code browser for indexed database';
+    static examples = [
+        '<%= config.bin %> browse',
+        '<%= config.bin %> browse -d ./my-index.db',
+        '<%= config.bin %> browse -p 8080',
+        '<%= config.bin %> browse --no-open',
+    ];
+    static flags = {
+        database: SharedFlags.database,
+        port: Flags.integer({
+            char: 'p',
+            description: 'Server port',
+            default: 3000,
+        }),
+        'no-open': Flags.boolean({
+            description: 'Do not automatically open browser',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Browse);
+        // Open database
+        const dbPathResolved = resolveDbPath(flags.database, this);
+        this.log(chalk.blue(`Opening database: ${dbPathResolved}`));
+        const db = await openDatabase(flags.database, this);
+        // Get stats to verify database is valid
+        try {
+            const stats = db.getStats();
+            this.log(chalk.gray(`  ${stats.files} files, ${stats.definitions} definitions, ${stats.imports} imports, ${stats.usages} usages`));
+        }
+        catch (error) {
+            db.close();
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(chalk.red(`Database appears to be invalid or empty: ${message}`));
+        }
+        // Ensure module color indices are assigned (idempotent, runs migration if needed)
+        try {
+            db.modules.assignColorIndices();
+        }
+        catch {
+            // Modules table may not exist yet — safe to ignore
+        }
+        // Create and start server
+        const port = flags.port;
+        const server = createServer(db, port);
+        try {
+            await startServer(server, port);
+        }
+        catch (error) {
+            db.close();
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('EADDRINUSE')) {
+                this.error(chalk.red(`Port ${port} is already in use. Try a different port with -p <port>`));
+            }
+            this.error(chalk.red(`Failed to start server: ${message}`));
+        }
+        const url = `http://localhost:${port}`;
+        this.log(chalk.green.bold(`\nServer running at ${url}`));
+        this.log(chalk.gray('Press Ctrl+C to stop\n'));
+        // Open browser unless --no-open flag is set
+        if (!flags['no-open']) {
+            this.openBrowser(url);
+        }
+        // Handle graceful shutdown
+        const shutdown = () => {
+            this.log(chalk.blue('\nShutting down...'));
+            server.close(() => {
+                db.close();
+                this.log(chalk.green('Server stopped.'));
+                process.exit(0);
+            });
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        // Keep the process running
+        await new Promise(() => {
+            // Never resolves - waits for SIGINT/SIGTERM
+        });
+    }
+    openBrowser(url) {
+        const platform = process.platform;
+        let command;
+        if (platform === 'darwin') {
+            command = `open "${url}"`;
+        }
+        else if (platform === 'win32') {
+            command = `start "" "${url}"`;
+        }
+        else {
+            // Linux and others
+            command = `xdg-open "${url}"`;
+        }
+        exec(command, (error) => {
+            if (error) {
+                this.log(chalk.yellow(`Could not open browser automatically. Please open ${url} manually.`));
+            }
+        });
+    }
+}
+//# sourceMappingURL=browse.js.map

package/dist/commands/browse.js.map

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