seer-mcp 0.1.0

package/dist/indexer/boundaries.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * v10 — Monorepo package/service boundary detection.
+ *
+ * Source signals (in priority order — earlier sources win on overlap):
+ *   1. Nested manifest files:
+ *      - package.json (npm/yarn/pnpm workspaces)
+ *      - pyproject.toml
+ *      - Cargo.toml
+ *      - go.mod
+ *      - composer.json
+ *   2. Workspace-declared globs:
+ *      - package.json:workspaces
+ *      - pnpm-workspace.yaml
+ *      - turbo.json / nx.json pipelines
+ *      - go.work
+ *      - Cargo workspace members (parent Cargo.toml [workspace])
+ *   3. Convention fallback:
+ *      - packages/<name>/
+ *      - services/<name>/
+ *      - apps/<name>/
+ *      - libs/<name>/
+ *
+ * Each detected boundary owns a contiguous subtree of files. The TRUE root
+ * is the deepest manifest/glob root — so `packages/core/src/lib/foo.ts`
+ * belongs to `packages/core/` if a package.json sits there.
+ *
+ * Boundary `label` is derived from the manifest name (`@scope/pkg` → `pkg`,
+ * etc.) when present, else from the root_rel_path segment.
+ *
+ * Boundary dependencies come from cross-boundary call/import/service edges
+ * aggregated across resolved graphs. Strictly advisory — never gates anything.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBoundaries = buildBoundaries;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Detect boundaries by walking the workspace once for manifests + convention
+ * fallback, then assigning each indexed file to the deepest matching
+ * boundary root.
+ */
+function buildBoundaries(workspace, store) {
+    const absRoot = path_1.default.resolve(workspace);
+    // Discover manifest hits.
+    const hits = discoverManifests(absRoot);
+    // Also seed convention-based hits when no manifest matches a directory.
+    seedConventionRoots(absRoot, hits);
+    // Materialize hits as boundary defs. De-dup by relRoot — manifest wins
+    // over convention.
+    const byRel = new Map();
+    for (const h of hits) {
+        const prev = byRel.get(h.relRoot);
+        if (!prev || rank(h) > rank(prev))
+            byRel.set(h.relRoot, h);
+    }
+    const sortedHits = Array.from(byRel.values()).sort((a, b) => b.relRoot.length - a.relRoot.length || (a.relRoot < b.relRoot ? -1 : 1));
+    // Assign every indexed file to the deepest matching hit.
+    const files = store.listFiles();
+    const fileToHit = new Map();
+    for (const f of files) {
+        let assigned = null;
+        const rel = normalizePath(f.relPath);
+        for (const h of sortedHits) {
+            const root = h.relRoot;
+            if (root === '' || root === '.')
+                continue;
+            if (rel === root || rel.startsWith(root + '/')) {
+                assigned = h;
+                break;
+            }
+        }
+        fileToHit.set(f.id, assigned);
+    }
+    // Build boundary list (only include hits that own at least one file).
+    const boundariesByRoot = new Map();
+    const definitions = [];
+    let nextIndex = 0;
+    for (const h of sortedHits) {
+        const def = {
+            label: h.label, kind: h.kind, rootRelPath: h.relRoot,
+            manifestPath: h.manifestPath || null, ecosystem: h.ecosystem,
+            fileIds: [],
+        };
+        boundariesByRoot.set(h.relRoot, { ...def, _index: nextIndex });
+        nextIndex++;
+    }
+    for (const [fileId, hit] of fileToHit) {
+        if (!hit)
+            continue;
+        const b = boundariesByRoot.get(hit.relRoot);
+        if (!b)
+            continue;
+        b.fileIds.push(fileId);
+    }
+    // Drop empty boundaries (e.g. convention `services/` parent with no files).
+    for (const b of boundariesByRoot.values()) {
+        if (b.fileIds.length === 0)
+            continue;
+        definitions.push({
+            label: b.label, kind: b.kind, rootRelPath: b.rootRelPath,
+            manifestPath: b.manifestPath, ecosystem: b.ecosystem, fileIds: b.fileIds,
+        });
+    }
+    // Re-index after dropping.
+    const indexByRoot = new Map();
+    definitions.forEach((d, i) => indexByRoot.set(d.rootRelPath, i));
+    // Build boundary→boundary edges from the resolved file-call / file-import /
+    // service-link graphs.
+    const edges = aggregateBoundaryEdges(store, fileToHit, indexByRoot);
+    let orphan = 0;
+    for (const [_id, h] of fileToHit)
+        if (!h)
+            orphan++;
+    return { boundaries: definitions, edges, orphanFiles: orphan };
+}
+function rank(h) {
+    // Manifest > convention.
+    return h.kind === 'convention' ? 0 : 1;
+}
+function aggregateBoundaryEdges(store, fileToHit, indexByRoot) {
+    const buckets = new Map();
+    const lookup = (fileId) => {
+        const h = fileToHit.get(fileId) ?? null;
+        if (!h)
+            return null;
+        const idx = indexByRoot.get(h.relRoot);
+        return idx == null ? null : idx;
+    };
+    const push = (from, to, kind, weight) => {
+        if (from === to)
+            return;
+        const key = `${from}|${to}|${kind}`;
+        const existing = buckets.get(key);
+        if (existing)
+            existing.weight += weight;
+        else
+            buckets.set(key, { fromIndex: from, toIndex: to, kind, weight });
+    };
+    for (const e of store.fileCallEdgeWeights()) {
+        const a = lookup(e.from);
+        const b = lookup(e.to);
+        if (a != null && b != null)
+            push(a, b, 'call', e.weight);
+    }
+    for (const e of store.fileImportEdgeWeights()) {
+        const a = lookup(e.from);
+        const b = lookup(e.to);
+        if (a != null && b != null)
+            push(a, b, 'import', e.weight);
+    }
+    try {
+        for (const e of store.fileServiceLinkEdgeWeights()) {
+            const a = lookup(e.from);
+            const b = lookup(e.to);
+            if (a != null && b != null)
+                push(a, b, 'service', e.weight);
+        }
+    }
+    catch { /* */ }
+    return Array.from(buckets.values()).sort((a, b) => a.fromIndex - b.fromIndex || a.toIndex - b.toIndex || (a.kind < b.kind ? -1 : 1));
+}
+// ── Manifest discovery ──────────────────────────────────────────────────
+function discoverManifests(absRoot) {
+    const hits = [];
+    // Skip dirs that never own boundaries.
+    const SKIP = new Set([
+        'node_modules', '.git', 'dist', 'build', 'out', '.next', '.nuxt',
+        'target', 'obj', '.gradle', '__pycache__', '.cache', '.idea',
+        '.vs', '.seer',
+    ]);
+    function walk(absDir, relDir, depth) {
+        if (depth > 6)
+            return; // bound recursion — boundaries beyond ~6 levels are rare
+        let entries;
+        try {
+            entries = fs_1.default.readdirSync(absDir);
+        }
+        catch {
+            return;
+        }
+        const fileSet = new Set(entries);
+        let claimed = false;
+        // package.json — may declare workspaces.
+        if (fileSet.has('package.json')) {
+            const manifestRel = relDir === '' ? 'package.json' : `${relDir}/package.json`;
+            try {
+                const pkg = JSON.parse(fs_1.default.readFileSync(path_1.default.join(absDir, 'package.json'), 'utf8'));
+                const label = derivePackageName(pkg, relDir);
+                const isRoot = Array.isArray(pkg.workspaces) || (pkg.workspaces && Array.isArray(pkg.workspaces.packages));
+                hits.push({
+                    relRoot: relDir,
+                    manifestPath: manifestRel,
+                    label,
+                    kind: isRoot ? 'workspace-root' : 'package',
+                    ecosystem: 'npm',
+                });
+                claimed = true;
+            }
+            catch { /* */ }
+        }
+        // pyproject.toml
+        if (fileSet.has('pyproject.toml')) {
+            const manifestRel = relDir === '' ? 'pyproject.toml' : `${relDir}/pyproject.toml`;
+            hits.push({
+                relRoot: relDir,
+                manifestPath: manifestRel,
+                label: derivePyProjectLabel(absDir, relDir),
+                kind: 'package',
+                ecosystem: 'pypi',
+            });
+            claimed = true;
+        }
+        // Cargo.toml
+        if (fileSet.has('Cargo.toml')) {
+            const manifestRel = relDir === '' ? 'Cargo.toml' : `${relDir}/Cargo.toml`;
+            hits.push({
+                relRoot: relDir,
+                manifestPath: manifestRel,
+                label: deriveCargoLabel(absDir, relDir),
+                kind: 'package',
+                ecosystem: 'cargo',
+            });
+            claimed = true;
+        }
+        // go.mod
+        if (fileSet.has('go.mod')) {
+            const manifestRel = relDir === '' ? 'go.mod' : `${relDir}/go.mod`;
+            hits.push({
+                relRoot: relDir,
+                manifestPath: manifestRel,
+                label: deriveGoModuleLabel(absDir, relDir),
+                kind: 'package',
+                ecosystem: 'go',
+            });
+            claimed = true;
+        }
+        // composer.json
+        if (fileSet.has('composer.json')) {
+            const manifestRel = relDir === '' ? 'composer.json' : `${relDir}/composer.json`;
+            hits.push({
+                relRoot: relDir,
+                manifestPath: manifestRel,
+                label: path_1.default.basename(relDir || '.'),
+                kind: 'package',
+                ecosystem: 'composer',
+            });
+            claimed = true;
+        }
+        void claimed;
+        // Recurse into subdirectories. Always recurse if THIS level didn't
+        // declare a non-root package — that's how packages/<x> work — but DO
+        // recurse anyway through workspace-root or convention dirs.
+        for (const entry of entries) {
+            if (SKIP.has(entry))
+                continue;
+            const abs = path_1.default.join(absDir, entry);
+            let st;
+            try {
+                st = fs_1.default.statSync(abs);
+            }
+            catch {
+                continue;
+            }
+            if (!st.isDirectory())
+                continue;
+            const sub = relDir === '' ? entry : `${relDir}/${entry}`;
+            walk(abs, sub, depth + 1);
+        }
+    }
+    walk(absRoot, '', 0);
+    return hits;
+}
+function seedConventionRoots(absRoot, hits) {
+    // For each <conventionDir>/<sub>/ that exists and isn't already a manifest
+    // root, register a fallback boundary so services/* / packages/* still get
+    // surfaced even without a manifest.
+    const conventionDirs = [
+        { dir: 'services', kind: 'service' },
+        { dir: 'packages', kind: 'package' },
+        { dir: 'apps', kind: 'app' },
+        { dir: 'libs', kind: 'lib' },
+    ];
+    const existingRoots = new Set(hits.map(h => h.relRoot));
+    for (const c of conventionDirs) {
+        const abs = path_1.default.join(absRoot, c.dir);
+        if (!fs_1.default.existsSync(abs))
+            continue;
+        let entries;
+        try {
+            entries = fs_1.default.readdirSync(abs);
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const subAbs = path_1.default.join(abs, e);
+            try {
+                if (!fs_1.default.statSync(subAbs).isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const rel = `${c.dir}/${e}`;
+            if (existingRoots.has(rel))
+                continue;
+            hits.push({
+                relRoot: rel,
+                manifestPath: '',
+                label: e,
+                kind: c.kind,
+                ecosystem: null,
+            });
+        }
+    }
+}
+function derivePackageName(pkg, relDir) {
+    const name = (pkg && pkg.name && typeof pkg.name === 'string') ? pkg.name : null;
+    if (!name)
+        return path_1.default.basename(relDir || '.');
+    // Strip @scope/
+    const m = /^@[^/]+\/(.+)$/.exec(name);
+    return m ? m[1] : name;
+}
+function derivePyProjectLabel(absDir, relDir) {
+    try {
+        const text = fs_1.default.readFileSync(path_1.default.join(absDir, 'pyproject.toml'), 'utf8');
+        const m = /^\s*name\s*=\s*['"]([^'"]+)['"]/m.exec(text);
+        if (m)
+            return m[1];
+    }
+    catch { /* */ }
+    return path_1.default.basename(relDir || '.');
+}
+function deriveCargoLabel(absDir, relDir) {
+    try {
+        const text = fs_1.default.readFileSync(path_1.default.join(absDir, 'Cargo.toml'), 'utf8');
+        // Capture [package].name; skip [workspace] sections.
+        const pkgSection = /^\s*\[package\][\s\S]*?(?=^\s*\[)/m.exec(text)?.[0] ?? text;
+        const m = /^\s*name\s*=\s*['"]([^'"]+)['"]/m.exec(pkgSection);
+        if (m)
+            return m[1];
+    }
+    catch { /* */ }
+    return path_1.default.basename(relDir || '.');
+}
+function deriveGoModuleLabel(absDir, relDir) {
+    try {
+        const text = fs_1.default.readFileSync(path_1.default.join(absDir, 'go.mod'), 'utf8');
+        const m = /^\s*module\s+([^\s]+)/m.exec(text);
+        if (m) {
+            // Take the last path segment.
+            return path_1.default.basename(m[1]);
+        }
+    }
+    catch { /* */ }
+    return path_1.default.basename(relDir || '.');
+}
+function normalizePath(p) {
+    return p.replace(/\\/g, '/');
+}
+//# sourceMappingURL=boundaries.js.map

package/dist/indexer/boundaries.js.map

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

package/dist/indexer/churn.d.ts

@@ -0,0 +1,15 @@
+import { Store } from '../db/store.js';
+export interface ChurnResult {
+    filesAnalyzed: number;
+    filesWithChurn: number;
+    headSha: string | null;
+    elapsedMs: number;
+}
+/**
+ * File-level git churn pass — populates `file_churn` for every indexed file.
+ * Independent of the symbol-history pass: file churn is cheap (~one git log
+ * over the whole repo) and useful on its own as a "what's risky to edit"
+ * signal even before the per-symbol history pass.
+ */
+export declare function collectChurn(repoRoot: string, store: Store): Promise<ChurnResult>;
+//# sourceMappingURL=churn.d.ts.map

package/dist/indexer/churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.d.ts","sourceRoot":"","sources":["../../src/indexer/churn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CAyCvF"}

package/dist/indexer/churn.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectChurn = collectChurn;
+const git_js_1 = require("./git.js");
+/**
+ * File-level git churn pass — populates `file_churn` for every indexed file.
+ * Independent of the symbol-history pass: file churn is cheap (~one git log
+ * over the whole repo) and useful on its own as a "what's risky to edit"
+ * signal even before the per-symbol history pass.
+ */
+async function collectChurn(repoRoot, store) {
+    const start = Date.now();
+    if (!(0, git_js_1.isGitRepo)(repoRoot)) {
+        return { filesAnalyzed: 0, filesWithChurn: 0, headSha: null, elapsedMs: Date.now() - start };
+    }
+    const files = store.listFiles();
+    if (files.length === 0) {
+        return { filesAnalyzed: 0, filesWithChurn: 0, headSha: (0, git_js_1.gitHeadSha)(repoRoot), elapsedMs: Date.now() - start };
+    }
+    const churn = await (0, git_js_1.collectFileChurn)(repoRoot, files.map(f => f.path));
+    let withChurn = 0;
+    // Normalize path comparison the same way collectFileChurn does internally.
+    const norm = (p) => {
+        const n = p.replace(/\\/g, '/');
+        return process.platform === 'win32' ? n.toLowerCase() : n;
+    };
+    const churnByNorm = new Map();
+    for (const [k, v] of churn)
+        churnByNorm.set(norm(k), v);
+    for (const f of files) {
+        const stats = churnByNorm.get(norm(f.path));
+        if (!stats || stats.commitCount === 0)
+            continue;
+        store.upsertFileChurn(f.id, stats.commitCount, stats.lastCommitSha, stats.lastCommitAt, stats.topAuthor, stats.secondAuthor);
+        withChurn++;
+    }
+    // Stamp git_index_state with HEAD so detect_changes can compute "since
+    // last index" diffs.
+    const head = (0, git_js_1.gitHeadSha)(repoRoot);
+    const remote = (0, git_js_1.gitRemoteUrl)(repoRoot);
+    store.setGitIndexState(repoRoot, head, remote);
+    return {
+        filesAnalyzed: files.length,
+        filesWithChurn: withChurn,
+        headSha: head,
+        elapsedMs: Date.now() - start,
+    };
+}
+//# sourceMappingURL=churn.js.map

package/dist/indexer/churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.js","sourceRoot":"","sources":["../../src/indexer/churn.ts"],"names":[],"mappings":";;AAgBA,oCAyCC;AAxDD,qCAAiF;AASjF;;;;;GAKG;AACI,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAY;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC,IAAA,kBAAS,EAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,IAAA,mBAAU,EAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/G,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,IAAA,yBAAgB,EAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,2EAA2E;IAC3E,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE;QACjC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwC,CAAC;IACpE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK;QAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAExD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC;YAAE,SAAS;QAChD,KAAK,CAAC,eAAe,CACnB,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,YAAY,EAChE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CACpC,CAAC;QACF,SAAS,EAAE,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,qBAAqB;IACrB,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAE/C,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;KAC9B,CAAC;AACJ,CAAC"}

package/dist/indexer/classify.d.ts

@@ -0,0 +1,9 @@
+import type { FileClassification } from '../db/store.js';
+/**
+ * Compute classification flags for a discovered file. The role precedence is
+ * vendor → generated → test → project. Vendor wins over generated because a
+ * generated file inside a vendor tree is still vendored code we don't own;
+ * the `is_generated` flag remains true so users can still query for it.
+ */
+export declare function classifyFile(relativePath: string): FileClassification;
+//# sourceMappingURL=classify.d.ts.map

package/dist/indexer/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/indexer/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAY,MAAM,gBAAgB,CAAC;AAuEnE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAkBrE"}

package/dist/indexer/classify.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyFile = classifyFile;
+/**
+ * Classify a discovered file path as project-owned, vendored, generated, or
+ * test. The result is stored on `files.role` and used to keep PageRank,
+ * top-symbol queries, and search defaults focused on first-party code while
+ * still letting users opt into vendored/generated results explicitly.
+ *
+ * Conservative defaults — when in doubt, return 'project' so we don't quietly
+ * hide first-party code. The patterns here are kept tight on purpose; broader
+ * heuristics (e.g. "anything inside a directory called `lib`") would cause
+ * too many false positives across the polyglot scale-test corpus.
+ *
+ * The function works purely on the relative path string; no filesystem
+ * access. That keeps it cheap to call once per discovered file in the
+ * indexer hot loop.
+ */
+// Vendored dependency directories at any nesting depth. The discovery layer
+// already excludes most of these from the glob, but a few make it through
+// (e.g. project-local copies of small utilities placed under `lib/vendor/`).
+// We still tag those that get past discovery so the stored classification is
+// useful even on unusual repo layouts.
+const VENDOR_DIR_PATTERNS = [
+    /(^|[\\/])vendor[\\/]/i,
+    /(^|[\\/])vendored[\\/]/i,
+    /(^|[\\/])third[_-]?party[\\/]/i,
+    /(^|[\\/])external[\\/]/i,
+    /(^|[\\/])node_modules[\\/]/i,
+    /(^|[\\/])bower_components[\\/]/i,
+    // Common engine-specific vendored locations.
+    /(^|[\\/])Engine[\\/]Source[\\/]ThirdParty[\\/]/i,
+];
+// Generated boilerplate. Filename patterns covering protobuf, Unreal header
+// tool, gRPC, gqlgen, and a handful of common code-generators. We also tag
+// files that live under a `generated/` directory since most projects put
+// emitter output there.
+const GENERATED_DIR_PATTERNS = [
+    /(^|[\\/])generated[\\/]/i,
+    /(^|[\\/])Generated[\\/]/, // Unreal Engine convention
+    /(^|[\\/])\.next[\\/]/,
+    /(^|[\\/])\.nuxt[\\/]/,
+    /(^|[\\/])__generated__[\\/]/,
+];
+const GENERATED_FILENAME_PATTERNS = [
+    /\.generated\.[a-z]+$/i,
+    /\.gen\.[a-z]+$/i,
+    /\.pb\.[a-z]+$/i, // protobuf .pb.go / .pb.h / .pb.ts
+    /\.pb\.go$/,
+    /_pb\.[a-z]+$/i, // gqlgen / Python grpc style
+    /\.min\.(js|css)$/i,
+    /\.bundle\.js$/i,
+];
+// Test directories — exposed for completeness even though we don't yet use
+// the 'test' role to filter anywhere. Future work: surface test files in
+// `seer_behavior` as a behavioral contract.
+const TEST_DIR_PATTERNS = [
+    /(^|[\\/])tests?[\\/]/i,
+    /(^|[\\/])__tests__[\\/]/,
+    /(^|[\\/])spec[\\/]/i,
+];
+const TEST_FILENAME_PATTERNS = [
+    /\.test\.[a-z]+$/i,
+    /\.spec\.[a-z]+$/i,
+    /_test\.[a-z]+$/i, // Go convention: foo_test.go
+];
+/**
+ * Compute classification flags for a discovered file. The role precedence is
+ * vendor → generated → test → project. Vendor wins over generated because a
+ * generated file inside a vendor tree is still vendored code we don't own;
+ * the `is_generated` flag remains true so users can still query for it.
+ */
+function classifyFile(relativePath) {
+    const isVendor = VENDOR_DIR_PATTERNS.some(p => p.test(relativePath)) ? 1 : 0;
+    const isGenerated = (GENERATED_DIR_PATTERNS.some(p => p.test(relativePath)) ||
+        GENERATED_FILENAME_PATTERNS.some(p => p.test(relativePath))) ? 1 : 0;
+    const isTest = (TEST_DIR_PATTERNS.some(p => p.test(relativePath)) ||
+        TEST_FILENAME_PATTERNS.some(p => p.test(relativePath)));
+    let role;
+    if (isVendor)
+        role = 'vendor';
+    else if (isGenerated)
+        role = 'generated';
+    else if (isTest)
+        role = 'test';
+    else
+        role = 'project';
+    return { role, isVendor: isVendor, isGenerated: isGenerated };
+}
+//# sourceMappingURL=classify.js.map

package/dist/indexer/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/indexer/classify.ts"],"names":[],"mappings":";;AA6EA,oCAkBC;AA7FD;;;;;;;;;;;;;;GAcG;AAEH,4EAA4E;AAC5E,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,uCAAuC;AACvC,MAAM,mBAAmB,GAAG;IAC1B,uBAAuB;IACvB,yBAAyB;IACzB,gCAAgC;IAChC,yBAAyB;IACzB,6BAA6B;IAC7B,iCAAiC;IACjC,6CAA6C;IAC7C,iDAAiD;CAClD,CAAC;AAEF,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,wBAAwB;AACxB,MAAM,sBAAsB,GAAG;IAC7B,0BAA0B;IAC1B,yBAAyB,EAAY,2BAA2B;IAChE,sBAAsB;IACtB,sBAAsB;IACtB,6BAA6B;CAC9B,CAAC;AAEF,MAAM,2BAA2B,GAAG;IAClC,uBAAuB;IACvB,iBAAiB;IACjB,gBAAgB,EAAqB,mCAAmC;IACxE,WAAW;IACX,eAAe,EAAsB,6BAA6B;IAClE,mBAAmB;IACnB,gBAAgB;CACjB,CAAC;AAEF,2EAA2E;AAC3E,yEAAyE;AACzE,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG;IACxB,uBAAuB;IACvB,yBAAyB;IACzB,qBAAqB;CACtB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB,EAAoB,6BAA6B;CACnE,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,YAAoB;IAC/C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,CAClB,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtD,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAC5D,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACV,MAAM,MAAM,GAAG,CACb,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjD,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CACvD,CAAC;IAEF,IAAI,IAAc,CAAC;IACnB,IAAI,QAAQ;QAAE,IAAI,GAAG,QAAQ,CAAC;SACzB,IAAI,WAAW;QAAE,IAAI,GAAG,WAAW,CAAC;SACpC,IAAI,MAAM;QAAE,IAAI,GAAG,MAAM,CAAC;;QAC1B,IAAI,GAAG,SAAS,CAAC;IAEtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAiB,EAAE,WAAW,EAAE,WAAoB,EAAE,CAAC;AAClF,CAAC"}