@selvakumaresra/specship 0.1.3 → 0.4.0

package/dist/search/query-utils.js

@@ -0,0 +1,380 @@
+"use strict";
+/**
+ * Search Query Utilities
+ *
+ * Shared module for search term extraction and scoring.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STOP_WORDS = void 0;
+exports.getStemVariants = getStemVariants;
+exports.extractSearchTerms = extractSearchTerms;
+exports.scorePathRelevance = scorePathRelevance;
+exports.isTestFile = isTestFile;
+exports.nameMatchBonus = nameMatchBonus;
+exports.kindBonus = kindBonus;
+exports.isDistinctiveIdentifier = isDistinctiveIdentifier;
+const path = __importStar(require("path"));
+/**
+ * Common stop words to filter from search queries.
+ * Includes generic English + code-specific noise words.
+ */
+exports.STOP_WORDS = new Set([
+    // English
+    'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'is', 'it', 'that', 'this', 'are', 'was',
+    'be', 'has', 'had', 'have', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'can', 'shall', 'not', 'no', 'all', 'each',
+    'every', 'how', 'what', 'where', 'when', 'who', 'which', 'why',
+    'i', 'me', 'my', 'we', 'our', 'you', 'your', 'he', 'she', 'they',
+    'show', 'give', 'tell',
+    'been', 'done', 'made', 'used', 'using', 'work', 'works', 'found',
+    'also', 'into', 'then', 'than', 'just', 'more', 'some', 'such',
+    'over', 'only', 'out', 'its', 'so', 'up', 'as', 'if',
+    'look', 'need', 'needs', 'want', 'happen', 'happens',
+    'affect', 'affected', 'break', 'breaks', 'failing',
+    'implemented', 'implement',
+    // Code-specific noise (avoid filtering common symbol names like get/set/add/build/find/list)
+    'code', 'file', 'files', 'function', 'method', 'class', 'type',
+    'fix', 'bug', 'called',
+]);
+/**
+ * Generate stem variants of a search term by removing common English suffixes.
+ * Used for FTS query expansion so "caching" also finds "cache", "eviction" finds "evict", etc.
+ * Stems are used as PREFIX matches in FTS, so they don't need to be perfect English words.
+ */
+function getStemVariants(term) {
+    const variants = new Set();
+    const t = term.toLowerCase();
+    // -ing: caching→cach/cache, handling→handl/handle, running→run
+    if (t.endsWith('ing') && t.length > 5) {
+        const base = t.slice(0, -3);
+        variants.add(base);
+        variants.add(base + 'e');
+        if (base.length >= 2 && base[base.length - 1] === base[base.length - 2]) {
+            variants.add(base.slice(0, -1));
+        }
+    }
+    // -tion/-sion: eviction→evict, expression→express
+    if ((t.endsWith('tion') || t.endsWith('sion')) && t.length > 5) {
+        variants.add(t.slice(0, -3));
+    }
+    // -ment: management→manage
+    if (t.endsWith('ment') && t.length > 6) {
+        variants.add(t.slice(0, -4));
+    }
+    // -ies: entries→entry
+    if (t.endsWith('ies') && t.length > 4) {
+        variants.add(t.slice(0, -3) + 'y');
+    }
+    // -es: processes→process, classes→class
+    else if (t.endsWith('es') && t.length > 4) {
+        variants.add(t.slice(0, -2));
+    }
+    // -s: errors→error (skip -ss endings like "class")
+    else if (t.endsWith('s') && !t.endsWith('ss') && t.length > 4) {
+        variants.add(t.slice(0, -1));
+    }
+    // -ed: handled→handle, propagated→propagate, carried→carry
+    if (t.endsWith('ed') && !t.endsWith('eed') && t.length > 4) {
+        variants.add(t.slice(0, -1));
+        variants.add(t.slice(0, -2));
+        if (t.endsWith('ied') && t.length > 5) {
+            variants.add(t.slice(0, -3) + 'y');
+        }
+    }
+    // -er: builder→build/builde, handler→handl/handle, getter→get
+    if (t.endsWith('er') && t.length > 4) {
+        const base = t.slice(0, -2);
+        variants.add(base);
+        variants.add(base + 'e');
+        if (base.length >= 2 && base[base.length - 1] === base[base.length - 2]) {
+            variants.add(base.slice(0, -1));
+        }
+    }
+    return [...variants].filter(v => v.length >= 3 && v !== t);
+}
+/**
+ * Extract meaningful search terms from a natural language query.
+ * Splits camelCase, PascalCase, snake_case, SCREAMING_SNAKE, and dot.notation
+ * into individual tokens before filtering.
+ *
+ * Preserves original compound identifiers (e.g., "scrapeLoop") alongside
+ * their split parts so that FTS can match both the full symbol name and
+ * individual words within it.
+ *
+ * Also generates stem variants (e.g., "caching"→"cache", "eviction"→"evict")
+ * so FTS prefix matching can find related code symbols.
+ */
+function extractSearchTerms(query, options) {
+    const includeStems = options?.stems !== false;
+    const tokens = new Set();
+    // First, extract and preserve compound identifiers before splitting
+    // CamelCase: scrapeLoop, UserService, getCallGraph
+    const compoundPattern = /\b([a-zA-Z][a-zA-Z0-9]*(?:[A-Z][a-z]+)+|[A-Z][a-z]+(?:[A-Z][a-z]*)+)\b/g;
+    let match;
+    while ((match = compoundPattern.exec(query)) !== null) {
+        if (match[1] && match[1].length >= 3) {
+            tokens.add(match[1].toLowerCase()); // preserve full compound: "scrapeloop"
+        }
+    }
+    // snake_case: scrape_loop, user_service
+    const snakePattern = /\b([a-zA-Z][a-zA-Z0-9]*(?:_[a-zA-Z0-9]+)+)\b/g;
+    while ((match = snakePattern.exec(query)) !== null) {
+        if (match[1] && match[1].length >= 3) {
+            tokens.add(match[1].toLowerCase());
+        }
+    }
+    // Split camelCase / PascalCase: "getUserName" → "get User Name"
+    const camelSplit = query
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+    // Replace underscores and dots with spaces (snake_case, dot.notation)
+    const normalised = camelSplit.replace(/[_.]+/g, ' ');
+    // Split on any non-alphanumeric character
+    const words = normalised.split(/[^a-zA-Z0-9]+/).filter(Boolean);
+    for (const word of words) {
+        const lower = word.toLowerCase();
+        if (lower.length < 3)
+            continue;
+        if (exports.STOP_WORDS.has(lower))
+            continue;
+        tokens.add(lower);
+    }
+    // Generate stem variants for broader FTS matching.
+    // "caching" → "cache" finds CacheBuilder; "eviction" → "evict" finds evictEntries.
+    // Also enables co-occurrence dampening by increasing term count above 1.
+    // Stems are skipped when scoring path relevance (stems inflate path scores).
+    if (includeStems) {
+        const stems = new Set();
+        for (const token of tokens) {
+            for (const variant of getStemVariants(token)) {
+                if (!tokens.has(variant) && !exports.STOP_WORDS.has(variant)) {
+                    stems.add(variant);
+                }
+            }
+        }
+        for (const stem of stems) {
+            tokens.add(stem);
+        }
+    }
+    return [...tokens];
+}
+/**
+ * Score path relevance to a query
+ * Higher score = more relevant path
+ */
+function scorePathRelevance(filePath, query) {
+    // Use base terms only — stem variants inflate path scores by generating
+    // many near-duplicate terms that all match the same path segments.
+    const terms = extractSearchTerms(query, { stems: false });
+    if (terms.length === 0)
+        return 0;
+    const pathLower = filePath.toLowerCase();
+    const fileName = path.basename(filePath).toLowerCase();
+    const dirName = path.dirname(filePath).toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+        // Exact filename match (strongest)
+        if (fileName.includes(term))
+            score += 10;
+        // Directory match
+        if (dirName.includes(term))
+            score += 5;
+        // General path match
+        else if (pathLower.includes(term))
+            score += 3;
+    }
+    // Deprioritize test files unless the query is explicitly about tests
+    const queryLower = query.toLowerCase();
+    const isTestQuery = queryLower.includes('test') || queryLower.includes('spec');
+    if (!isTestQuery && isTestFile(filePath)) {
+        score -= 15;
+    }
+    return score;
+}
+/**
+ * Check if a file path looks like a test file
+ */
+function isTestFile(filePath) {
+    const lower = filePath.toLowerCase();
+    const fileName = path.basename(filePath); // original case — needed for camelCase boundaries
+    const lowerName = fileName.toLowerCase();
+    // --- Filename patterns ---
+    if (lowerName.startsWith('test_') || // python: test_foo.py
+        lowerName.startsWith('test.') ||
+        // separator-delimited: foo_test.go, foo.test.ts, foo-spec.rb, bar_spec.py
+        /[._-](test|tests|spec|specs)\.[a-z0-9]+$/.test(lowerName) ||
+        // CamelCase suffix (Java/Kotlin/Swift/C#/Scala): FooTest.kt, BarTests.swift,
+        // BazSpec.scala, QuxTestCase.java. Capital-led so "latest.kt"/"manifest.kt"
+        // (lowercase "test") are NOT matched.
+        /(?:Test|Tests|TestCase|Tester|Spec|Specs)\.[A-Za-z0-9]+$/.test(fileName)) {
+        return true;
+    }
+    // --- Directory patterns ---
+    if (lower.includes('/tests/') || lower.includes('/test/') ||
+        lower.includes('/__tests__/') || lower.includes('/spec/') ||
+        lower.includes('/specs/') || lower.includes('/testlib/') ||
+        lower.includes('/testing/') ||
+        lower.startsWith('test/') || lower.startsWith('tests/') ||
+        lower.startsWith('spec/') || lower.startsWith('specs/') ||
+        // CamelCase test source-set dirs (Kotlin Multiplatform / Gradle / Xcode):
+        // jvmTest/, commonTest/, androidTest/, iosTest/, integrationTest/. Capital-led
+        // so "latest/" / "manifest/" are not matched.
+        /(?:^|\/)[A-Za-z0-9]*(?:Test|Tests|Spec)\//.test(filePath)) {
+        return true;
+    }
+    // Non-production directories: examples, samples, benchmarks, fixtures, demos.
+    // Check both mid-path (/integration/) and start-of-path (integration/) since
+    // file paths may be stored as relative paths without a leading slash.
+    return matchesNonProductionDir(lower);
+}
+/**
+ * Check if a path is in a non-production directory (integration, sample, example, etc.)
+ * Handles both absolute paths (/foo/integration/bar) and relative paths (integration/bar).
+ */
+function matchesNonProductionDir(lowerPath) {
+    const dirs = [
+        'integration', 'sample', 'samples', 'example', 'examples',
+        'fixture', 'fixtures', 'benchmark', 'benchmarks', 'demo', 'demos',
+    ];
+    for (const dir of dirs) {
+        if (lowerPath.includes('/' + dir + '/') || lowerPath.startsWith(dir + '/')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Bonus when a node's name matches the search query.
+ * Exact matches get the largest boost; prefix matches get smaller boosts.
+ * Multi-word queries also check individual term matches against the name.
+ */
+function nameMatchBonus(nodeName, query) {
+    const nameLower = nodeName.toLowerCase();
+    // Split query into word-level terms (handles "CacheBuilder build" → ["cache","builder","build"])
+    const rawTerms = query
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .split(/[\s_.\-]+/)
+        .map(t => t.toLowerCase())
+        .filter(t => t.length >= 2);
+    // Also keep original space-separated tokens for exact-term matching
+    const queryTokens = query.split(/\s+/).map(t => t.toLowerCase()).filter(t => t.length >= 2);
+    // Full query as a single token (for compound identifiers like "CacheBuilder")
+    const queryLower = query.replace(/[\s]+/g, '').toLowerCase();
+    // Exact match: query exactly equals the node name
+    if (nameLower === queryLower)
+        return 80;
+    // Exact match on a query token: "CacheBuilder build" and node name is "build"
+    if (queryTokens.length > 1 && queryTokens.includes(nameLower))
+        return 60;
+    // Name starts with query — scale by length ratio so "Pod"→"Pod" (exact, handled above)
+    // scores much higher than "Pod"→"PodGCControllerOptions" (ratio 0.125).
+    if (nameLower.startsWith(queryLower)) {
+        const ratio = queryLower.length / nameLower.length;
+        return Math.round(10 + 30 * ratio);
+    }
+    // All camelCase-split terms appear in the name
+    if (rawTerms.length > 1) {
+        const allMatch = rawTerms.every(t => nameLower.includes(t));
+        if (allMatch)
+            return 15;
+    }
+    // Name contains the full query as substring
+    if (nameLower.includes(queryLower))
+        return 10;
+    return 0;
+}
+/**
+ * Kind-based bonus for search ranking
+ * Functions and classes are typically more relevant than variables/imports
+ */
+function kindBonus(kind) {
+    const bonuses = {
+        function: 10,
+        method: 10,
+        class: 8,
+        interface: 9,
+        type_alias: 6,
+        struct: 6,
+        trait: 9,
+        enum: 5,
+        component: 8,
+        route: 9,
+        module: 4,
+        property: 3,
+        field: 3,
+        variable: 2,
+        constant: 3,
+        import: 1,
+        export: 1,
+        parameter: 0,
+        namespace: 4,
+        file: 0,
+        protocol: 9,
+        enum_member: 3,
+    };
+    return bonuses[kind] ?? 0;
+}
+/**
+ * Whether a query token looks like a code identifier the user deliberately typed
+ * (camelCase / PascalCase-with-internal-caps / snake_case / has a digit) rather
+ * than a plain dictionary word ("flat", "object", "screen").
+ *
+ * Used to decide whether an EXACT name match earns the "the user named this
+ * symbol" exemption from single-term dampening. A common English word that
+ * happens to exact-match an unrelated symbol — the query "flat object" matching
+ * a constant named `FLAT` — must NOT get that exemption, or the +exact-name
+ * bonus floats it to the top of a prose query on its own.
+ *
+ * Classifies the token AS THE USER TYPED IT, not the matched symbol's name:
+ * "flat" (lowercase, descriptive) is non-distinctive even though it matches
+ * `FLAT`. A leading-capital-only word ("Screen", "Zustand") is also treated as
+ * a plain word — sentence-start capitalization and proper nouns aren't reliable
+ * identifier signals.
+ */
+function isDistinctiveIdentifier(token) {
+    if (!token)
+        return false;
+    // snake_case / SCREAMING_SNAKE, or an embedded digit → a deliberate identifier.
+    if (/[_0-9]/.test(token))
+        return true;
+    // An uppercase letter anywhere AFTER the first char → a camelCase/PascalCase
+    // boundary (setLastEmail, OrgUserStore) or an acronym (REST, HTTP).
+    if (/[A-Z]/.test(token.slice(1)))
+        return true;
+    return false;
+}
+//# sourceMappingURL=query-utils.js.map

package/dist/search/query-utils.js.map

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

package/dist/server/cli.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * Standalone CLI entry for the specship HTTP server + Angular UI.
+ *
+ *   specship-desktop --project-root /path/to/project [--port 4242]
+ *
+ * When the bundled web UI is present, the same process serves the SPA at /
+ * and the API at /api/*. Pass `--no-web` to run headless (API only) or
+ * `--web-dir <path>` to point at a custom build.
+ *
+ * The JSONL ingest watcher is started inside `createServer()` by default —
+ * pass `--no-ingest` to disable.
+ */
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+import { createServer } from './server.js';
+function parseArgs() {
+    const envRoot = process.env.SPECSHIP_PROJECT_ROOT ?? process.env.SPECSHIP_PROJECT_ROOT ?? null;
+    const args = {
+        projectRoot: envRoot,
+        host: '127.0.0.1',
+        port: 4242,
+        ingest: true,
+        verbose: false,
+        webDir: null,
+        noWeb: false,
+        open: false,
+    };
+    const argv = process.argv.slice(2);
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--project-root' || a === '-p')
+            args.projectRoot = argv[++i] ?? args.projectRoot;
+        else if (a === '--port')
+            args.port = parseInt(argv[++i] ?? '4242', 10) || 4242;
+        else if (a === '--host')
+            args.host = argv[++i] ?? args.host;
+        else if (a === '--no-ingest')
+            args.ingest = false;
+        else if (a === '--verbose' || a === '-v')
+            args.verbose = true;
+        else if (a === '--web-dir')
+            args.webDir = argv[++i] ?? null;
+        else if (a === '--no-web')
+            args.noWeb = true;
+        else if (a === '--open')
+            args.open = true;
+        else if (a === '--help' || a === '-h') {
+            console.log(`Usage: specship-desktop [options]
+
+Options:
+  --project-root, -p <path>   Project root (default: $SPECSHIP_PROJECT_ROOT, $SPECSHIP_PROJECT_ROOT, or cwd)
+  --port <n>                  HTTP port (default: 4242)
+  --host <h>                  Bind host (default: 127.0.0.1)
+  --no-ingest                 Skip the in-process Claude JSONL transcript watcher
+  --web-dir <path>            Explicit path to a built Angular UI (index.html lives here)
+  --no-web                    Run headless — serve the API only, no SPA
+  --open                      Open the UI in the default browser once listening
+  --verbose, -v               Verbose logs`);
+            process.exit(0);
+        }
+    }
+    return args;
+}
+/**
+ * Locate the built Angular UI. Tries (in order):
+ *   1. Explicit --web-dir / env var
+ *   2. Sibling `public/web/` next to the running script (production layout)
+ *   3. Sibling `../web-ng/dist/web-ng/browser/` (monorepo dev layout)
+ *   4. Walk up looking for `packages/web-ng/dist/web-ng/browser/`
+ * Returns null when nothing is found — the server then runs API-only.
+ */
+function locateWebDir(explicit) {
+    const envDir = process.env.SPECSHIP_WEB_DIR ?? process.env.SPECSHIP_WEB_DIR;
+    const candidates = [];
+    if (explicit)
+        candidates.push(path.resolve(explicit));
+    if (envDir)
+        candidates.push(path.resolve(envDir));
+    // __dirname equivalent in ESM
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // Production layout: <pkg>/dist/cli.js, UI shipped at <pkg>/public/web/
+    candidates.push(path.resolve(here, '..', 'public', 'web'));
+    candidates.push(path.resolve(here, '..', '..', 'public', 'web'));
+    // Monorepo dev layout: packages/server/dist/cli.js → packages/web-ng/dist/web-ng/browser
+    candidates.push(path.resolve(here, '..', '..', 'web-ng', 'dist', 'web-ng', 'browser'));
+    candidates.push(path.resolve(here, '..', '..', '..', 'web-ng', 'dist', 'web-ng', 'browser'));
+    // Walk up from cwd looking for the monorepo layout (handy when run via npx
+    // inside a checkout).
+    let cur = process.cwd();
+    for (let depth = 0; depth < 6; depth++) {
+        candidates.push(path.join(cur, 'packages', 'web-ng', 'dist', 'web-ng', 'browser'));
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    for (const c of candidates) {
+        if (existsSync(path.join(c, 'index.html')))
+            return c;
+    }
+    return null;
+}
+function tryOpenInBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+    try {
+        spawn(cmd, [url], { detached: true, stdio: 'ignore', shell: process.platform === 'win32' }).unref();
+    }
+    catch {
+        // best-effort; ignore failure
+    }
+}
+async function main() {
+    const args = parseArgs();
+    const webDir = args.noWeb ? null : locateWebDir(args.webDir);
+    const handle = await createServer({
+        projectRoot: args.projectRoot ?? undefined,
+        host: args.host,
+        port: args.port,
+        ingest: args.ingest,
+        verbose: args.verbose,
+        webDir,
+    });
+    console.error(`[specship-desktop] listening on ${handle.url}`);
+    if (args.projectRoot) {
+        console.error(`[specship-desktop] project: ${args.projectRoot}`);
+    }
+    else {
+        console.error(`[specship-desktop] project: (none — pick one in the desktop UI)`);
+    }
+    if (webDir)
+        console.error(`[specship-desktop] UI:      ${webDir}`);
+    else
+        console.error(`[specship-desktop] UI:      (none — running headless)`);
+    if (args.ingest)
+        console.error(`[specship-desktop] Claude Code transcript ingest active`);
+    if (args.open)
+        tryOpenInBrowser(handle.url);
+    const shutdown = async () => {
+        console.error('[specship-desktop] shutting down');
+        await handle.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => { void shutdown(); });
+    process.on('SIGTERM', () => { void shutdown(); });
+}
+main().catch((err) => {
+    console.error('[specship-desktop] startup failed:', err);
+    process.exit(1);
+});

package/dist/server/index.js

@@ -0,0 +1,12 @@
+/**
+ * @selvakumaresra/specship-server — public API.
+ *
+ * Fastify-based HTTP layer that mirrors specship's MCP tools as REST so the
+ * SpecShip Desktop UI (and any other client) can drive the graph + spec
+ * layer + workflow engine + Claude Code analytics.
+ *
+ * Boots on 127.0.0.1 by default. Override via host / port options on
+ * `createServer()`. No auth by default — host bound to loopback. For
+ * remote access, generate + require a bearer token (TODO).
+ */
+export { createServer } from './server.js';

package/dist/server/ingest/index.js

@@ -0,0 +1,18 @@
+/**
+ * Server-local JSONL ingest. Lives inside @selvakumaresra/specship-server
+ * so the HTTP API has a single deploy unit — no separate package, no
+ * dependency wiring.
+ *
+ * Walks Claude Code's JSONL transcripts under `~/.claude/projects/` and
+ * writes parsed entries into specship's SQLite database so the analytics
+ * surfaces (Sessions, Heatmap, Costs, Compare, Tips) run sub-millisecond
+ * queries instead of re-parsing megabytes of JSONL per page load.
+ *
+ * Two entry points:
+ *   - `ingestAll(db)`     — one-shot pass, useful for CI / scripts.
+ *   - `startWatcher(db)`  — live tail; runs ingestAll once + on each FS event.
+ */
+export { ingestAll, listTranscriptFiles, decodeProjectSlug } from './ingestor.js';
+export { startWatcher } from './watcher.js';
+export { resolvePricing, computeCost, normalizeModelId } from './pricing.js';
+export { parseLine, summarizeToolInput, extractUserPrompt, toolResultLength } from './parser.js';