@backthread/extractor 0.1.0

package/dist/graph/python-stdlib.js

@@ -0,0 +1,53 @@
+// Python standard-library top-level module names — the analogue of the ts-morph
+// adapter's Node `isBuiltin` drop. stdlib imports are substrate, never
+// diagram nodes: when Pyright (NoAccessHost, no venv) leaves a bare import
+// unresolved AND the syntactic fallback finds no in-repo file, a top-level name in
+// this set is DROPPED (not emitted as an external), exactly as Node builtins are
+// dropped on the TS path. A first-party module that SHADOWS a stdlib name still
+// wins — it resolves to a repo file first (Pyright Local / syntactic fallback), so
+// this filter only ever sees genuinely-unresolved imports.
+//
+// Snapshot of `sys.stdlib_module_names` from CPython 3.12 (frozen; regenerate on a
+// Python major bump). A pure static list — the pipeline never runs Python.
+export const PYTHON_STDLIB = new Set([
+    '__future__', '_abc', '_aix_support', '_ast', '_asyncio', '_bisect', '_blake2', '_bz2',
+    '_codecs', '_codecs_cn', '_codecs_hk', '_codecs_iso2022', '_codecs_jp', '_codecs_kr',
+    '_codecs_tw', '_collections', '_collections_abc', '_compat_pickle', '_compression',
+    '_contextvars', '_crypt', '_csv', '_ctypes', '_curses', '_curses_panel', '_datetime', '_dbm',
+    '_decimal', '_elementtree', '_frozen_importlib', '_frozen_importlib_external', '_functools',
+    '_gdbm', '_hashlib', '_heapq', '_imp', '_io', '_json', '_locale', '_lsprof', '_lzma',
+    '_markupbase', '_md5', '_msi', '_multibytecodec', '_multiprocessing', '_opcode', '_operator',
+    '_osx_support', '_overlapped', '_pickle', '_posixshmem', '_posixsubprocess', '_py_abc',
+    '_pydatetime', '_pydecimal', '_pyio', '_pylong', '_queue', '_random', '_scproxy', '_sha1',
+    '_sha2', '_sha3', '_signal', '_sitebuiltins', '_socket', '_sqlite3', '_sre', '_ssl', '_stat',
+    '_statistics', '_string', '_strptime', '_struct', '_symtable', '_thread', '_threading_local',
+    '_tkinter', '_tokenize', '_tracemalloc', '_typing', '_uuid', '_warnings', '_weakref',
+    '_weakrefset', '_winapi', '_wmi', '_zoneinfo', 'abc', 'aifc', 'antigravity', 'argparse',
+    'array', 'ast', 'asyncio', 'atexit', 'audioop', 'base64', 'bdb', 'binascii', 'bisect',
+    'builtins', 'bz2', 'cProfile', 'calendar', 'cgi', 'cgitb', 'chunk', 'cmath', 'cmd', 'code',
+    'codecs', 'codeop', 'collections', 'colorsys', 'compileall', 'concurrent', 'configparser',
+    'contextlib', 'contextvars', 'copy', 'copyreg', 'crypt', 'csv', 'ctypes', 'curses',
+    'dataclasses', 'datetime', 'dbm', 'decimal', 'difflib', 'dis', 'doctest', 'email',
+    'encodings', 'ensurepip', 'enum', 'errno', 'faulthandler', 'fcntl', 'filecmp', 'fileinput',
+    'fnmatch', 'fractions', 'ftplib', 'functools', 'gc', 'genericpath', 'getopt', 'getpass',
+    'gettext', 'glob', 'graphlib', 'grp', 'gzip', 'hashlib', 'heapq', 'hmac', 'html', 'http',
+    'idlelib', 'imaplib', 'imghdr', 'importlib', 'inspect', 'io', 'ipaddress', 'itertools',
+    'json', 'keyword', 'lib2to3', 'linecache', 'locale', 'logging', 'lzma', 'mailbox', 'mailcap',
+    'marshal', 'math', 'mimetypes', 'mmap', 'modulefinder', 'msilib', 'msvcrt',
+    'multiprocessing', 'netrc', 'nis', 'nntplib', 'nt', 'ntpath', 'nturl2path', 'numbers',
+    'opcode', 'operator', 'optparse', 'os', 'ossaudiodev', 'pathlib', 'pdb', 'pickle',
+    'pickletools', 'pipes', 'pkgutil', 'platform', 'plistlib', 'poplib', 'posix', 'posixpath',
+    'pprint', 'profile', 'pstats', 'pty', 'pwd', 'py_compile', 'pyclbr', 'pydoc', 'pydoc_data',
+    'pyexpat', 'queue', 'quopri', 'random', 're', 'readline', 'reprlib', 'resource',
+    'rlcompleter', 'runpy', 'sched', 'secrets', 'select', 'selectors', 'shelve', 'shlex',
+    'shutil', 'signal', 'site', 'smtplib', 'sndhdr', 'socket', 'socketserver', 'spwd', 'sqlite3',
+    'sre_compile', 'sre_constants', 'sre_parse', 'ssl', 'stat', 'statistics', 'string',
+    'stringprep', 'struct', 'subprocess', 'sunau', 'symtable', 'sys', 'sysconfig', 'syslog',
+    'tabnanny', 'tarfile', 'telnetlib', 'tempfile', 'termios', 'textwrap', 'this', 'threading',
+    'time', 'timeit', 'tkinter', 'token', 'tokenize', 'tomllib', 'trace', 'traceback',
+    'tracemalloc', 'tty', 'turtle', 'turtledemo', 'types', 'typing', 'unicodedata', 'unittest',
+    'urllib', 'uu', 'uuid', 'venv', 'warnings', 'wave', 'weakref', 'webbrowser', 'winreg',
+    'winsound', 'wsgiref', 'xdrlib', 'xml', 'xmlrpc', 'zipapp', 'zipfile', 'zipimport', 'zlib',
+    'zoneinfo',
+]);
+//# sourceMappingURL=python-stdlib.js.map

package/dist/graph/python-stdlib.js.map

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

package/dist/graph/ts-morph-adapter.d.ts

@@ -0,0 +1,65 @@
+import { Project, type SourceFile } from 'ts-morph';
+import { type GraphExtractor, type NormalizedGraph } from './types.js';
+import { type FileRecord } from './file-graph.js';
+export declare function toId(root: string, absPath: string): string;
+/**
+ * Read + JSONC-parse the nearest tsconfig/jsconfig in `repoDir`, returning the
+ * config dir plus its raw compilerOptions baseUrl/paths — or undefined if none
+ * of the candidates declares either.
+ *
+ * tsconfig is JSONC, NOT strict JSON: it permits `//` + block comments AND
+ * trailing commas. A plain `JSON.parse` THROWS on a trailing comma, which
+ * silently dropped EVERY path alias on the very common real-world shape (e.g.
+ * Bluesky's `"paths": { "#/*": ["./src/*"], }`). We strip comments
+ * AND trailing commas before parsing. We do NOT follow `extends` chains (a
+ * deliberate non-goal — `paths` lives in the root tsconfig in practice; an
+ * inherited-only paths block degrades to no aliasing rather than misfiring).
+ * The FIRST candidate that declares baseUrl||paths wins (the config the TS
+ * compiler itself would load); a malformed candidate is skipped.
+ *
+ * Exported so the framework adapters (React-Native's alias reader) consume the
+ * SAME comment/comma tolerance — the central resolver and the adapters cannot
+ * drift on what counts as a parseable tsconfig.
+ */
+export declare function readTsconfigCompilerOptions(repoDir: string): {
+    dir: string;
+    baseUrl?: string;
+    paths?: Record<string, string[]>;
+} | undefined;
+/**
+ * Build the install-free extraction Project for `root` (tsconfig paths/baseUrl
+ * read fresh — so a config-invalidator re-seed picks up resolution changes).
+ * Resolution settings chosen to resolve BOTH extensionless and .js-suffixed
+ * relative imports against .ts sources, plus tsconfig path aliases — without
+ * any installed dependencies.
+ */
+export declare function buildExtractionProject(root: string): Project;
+/** Add every source file under `root` to the project (the adapter's glob). */
+export declare function addAllSourceFiles(project: Project, root: string): void;
+/**
+ * Extract ONE file's CHEAP half: loc/language, resolved internal import +
+ * re-export targets, and external packages — an AST walk of the top-level
+ * declarations + module resolution, NO type-checker symbol work. `calls` is
+ * left empty; extractFileCalls below fills it. The incremental engine uses
+ * this pass alone for files whose imports must re-resolve but whose call
+ * bindings provably didn't move.
+ *
+ * `internalIds` is the CURRENT tree's source-file id set — resolution outside
+ * it (e.g. a stray .d.ts) is ignored, matching the original batch behavior.
+ */
+export declare function extractFileImportsRecord(sf: SourceFile, root: string, internalIds: ReadonlySet<string>): FileRecord;
+/**
+ * The EXPENSIVE half: best-effort typed call edges — resolve each call
+ * target's symbol to its declaring source file via the type checker.
+ * Internal-only (externals already captured via imports). Wrapped defensively
+ * — without installed types some resolutions throw; we degrade to import-only
+ * edges rather than fail the extraction.
+ */
+export declare function extractFileCalls(sf: SourceFile, root: string, internalIds: ReadonlySet<string>): FileRecord['calls'];
+/** Both halves: the complete per-file extraction (imports + calls). */
+export declare function extractFileRecord(sf: SourceFile, root: string, internalIds: ReadonlySet<string>): FileRecord;
+export declare class TsMorphExtractor implements GraphExtractor {
+    readonly language = "typescript";
+    extract(repoDir: string): Promise<NormalizedGraph>;
+}
+//# sourceMappingURL=ts-morph-adapter.d.ts.map

package/dist/graph/ts-morph-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-morph-adapter.d.ts","sourceRoot":"","sources":["../../src/graph/ts-morph-adapter.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,OAAO,EAKP,KAAK,UAAU,EAEhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAsC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3G,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GACvD;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,GACnE,SAAS,CAqBZ;AAiCD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkB5D;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,UAAU,CA+CZ;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,UAAU,CAAC,OAAO,CAAC,CA6BrB;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,UAAU,CAI5G;AAUD,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,QAAQ,gBAAgB;IAE3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAiBzD"}

package/dist/graph/ts-morph-adapter.js

@@ -0,0 +1,265 @@
+// ts-morph (TS compiler API) extractor (/325) — the P3 structural adapter.
+//
+// INSTALL-FREE by design: we never `npm install` the target repo. Internal
+// imports/calls resolve from SOURCE (the clone's own files + its tsconfig
+// paths/baseUrl); anything that doesn't resolve internally is a bare specifier
+// → an EXTERNAL node. This is both a feature (we want externals as nodes, not
+// resolved into node_modules) and a safety property (no untrusted postinstall
+// scripts run). Plain-JS repos (no tsconfig) are handled with sane defaults.
+//
+// Stage A: the per-file extraction is factored into exported helpers
+// (buildExtractionProject / addAllSourceFiles / extractFileRecord) shared with
+// the diff-driven incremental engine (incremental.ts), so the batch and
+// incremental paths CANNOT drift — both produce FileRecords and assemble the
+// NormalizedGraph through graphFromState. The equivalence fixture test guards
+// this (full extract vs seed+patches must be identical).
+import { readFileSync, existsSync } from 'node:fs';
+import { relative, resolve, dirname } from 'node:path';
+import { isBuiltin } from 'node:module';
+import { Project, SyntaxKind, ModuleResolutionKind, ModuleKind, ScriptTarget, } from 'ts-morph';
+import { externalIdFor, isRelativeSpecifier } from './types.js';
+import { graphFromState, SOURCE_EXTENSIONS, EXCLUDE_DIRS, } from './file-graph.js';
+export function toId(root, absPath) {
+    return relative(root, absPath).split(/[\\/]/).join('/');
+}
+function languageOf(path) {
+    const m = path.match(/\.([cm]?[tj]sx?)$/);
+    return m ? m[1] : 'ts';
+}
+/**
+ * Read + JSONC-parse the nearest tsconfig/jsconfig in `repoDir`, returning the
+ * config dir plus its raw compilerOptions baseUrl/paths — or undefined if none
+ * of the candidates declares either.
+ *
+ * tsconfig is JSONC, NOT strict JSON: it permits `//` + block comments AND
+ * trailing commas. A plain `JSON.parse` THROWS on a trailing comma, which
+ * silently dropped EVERY path alias on the very common real-world shape (e.g.
+ * Bluesky's `"paths": { "#/*": ["./src/*"], }`). We strip comments
+ * AND trailing commas before parsing. We do NOT follow `extends` chains (a
+ * deliberate non-goal — `paths` lives in the root tsconfig in practice; an
+ * inherited-only paths block degrades to no aliasing rather than misfiring).
+ * The FIRST candidate that declares baseUrl||paths wins (the config the TS
+ * compiler itself would load); a malformed candidate is skipped.
+ *
+ * Exported so the framework adapters (React-Native's alias reader) consume the
+ * SAME comment/comma tolerance — the central resolver and the adapters cannot
+ * drift on what counts as a parseable tsconfig.
+ */
+export function readTsconfigCompilerOptions(repoDir) {
+    for (const name of ['tsconfig.json', 'tsconfig.base.json', 'jsconfig.json']) {
+        const p = resolve(repoDir, name);
+        if (!existsSync(p))
+            continue;
+        try {
+            const raw = readFileSync(p, 'utf8')
+                .replace(/\/\*[\s\S]*?\*\//g, '') // /* block comments */
+                .replace(/(^|[^:])\/\/.*$/gm, '$1') // // line comments (not the // in a URL)
+                .replace(/,(\s*[}\]])/g, '$1'); // trailing commas (JSONC allows; JSON.parse doesn't)
+            const json = JSON.parse(raw);
+            const co = json.compilerOptions ?? {};
+            if (co.baseUrl || co.paths) {
+                return { dir: dirname(p), baseUrl: co.baseUrl, paths: co.paths };
+            }
+        }
+        catch {
+            // Malformed candidate — try the next name, else fall through to undefined.
+        }
+    }
+    return undefined;
+}
+// Lightweight tsconfig read for path-alias resolution feeding the in-memory
+// extraction Project. Returns the ABSOLUTE baseUrl + alias paths.
+//
+// when `paths` is declared with NO `baseUrl`, the relative `./src/*`
+// targets must anchor on the tsconfig's OWN directory (the TS ≥4.1 implicit
+// base). An on-disk tsconfig gives the compiler that location for free; our
+// in-memory Project (compilerOptions only, no tsconfig path) does NOT, so
+// ts-morph mis-anchors the relative target and every aliased internal import
+// silently falls out as an EXTERNAL node — under-connecting the graph. We set
+// baseUrl to the config dir explicitly to recover the standard semantics.
+//
+// We anchor ONLY when there are actual alias entries: an explicit `baseUrl`, or
+// a NON-EMPTY `paths`. A bare `paths: {}` (no baseUrl) must stay baseUrl-less —
+// setting one would switch on baseUrl-relative resolution of *bare* specifiers
+// against the repo root (which TS ≥4.1 paths-without-baseUrl does NOT do), risking
+// a genuine external being mis-resolved as internal.
+function readTsconfigPaths(repoDir) {
+    const co = readTsconfigCompilerOptions(repoDir);
+    if (!co)
+        return {};
+    const hasAliases = co.paths != null && Object.keys(co.paths).length > 0;
+    const baseUrl = co.baseUrl
+        ? resolve(co.dir, co.baseUrl)
+        : hasAliases
+            ? co.dir // no baseUrl + non-empty paths → anchor on the tsconfig dir (TS ≥4.1)
+            : undefined;
+    return { baseUrl, paths: co.paths };
+}
+/**
+ * Build the install-free extraction Project for `root` (tsconfig paths/baseUrl
+ * read fresh — so a config-invalidator re-seed picks up resolution changes).
+ * Resolution settings chosen to resolve BOTH extensionless and .js-suffixed
+ * relative imports against .ts sources, plus tsconfig path aliases — without
+ * any installed dependencies.
+ */
+export function buildExtractionProject(root) {
+    const { baseUrl, paths } = readTsconfigPaths(root);
+    return new Project({
+        skipAddingFilesFromTsConfig: true,
+        skipFileDependencyResolution: true,
+        skipLoadingLibFiles: true,
+        compilerOptions: {
+            allowJs: true,
+            checkJs: false,
+            noEmit: true,
+            moduleResolution: ModuleResolutionKind.Bundler,
+            module: ModuleKind.ESNext,
+            target: ScriptTarget.ESNext,
+            allowImportingTsExtensions: true,
+            baseUrl,
+            paths,
+        },
+    });
+}
+/** Add every source file under `root` to the project (the adapter's glob). */
+export function addAllSourceFiles(project, root) {
+    const includeGlobs = [`${root}/**/*.{${SOURCE_EXTENSIONS.join(',')}}`];
+    const excludeGlobs = EXCLUDE_DIRS.map((d) => `!${root}/**/${d}/**`);
+    project.addSourceFilesAtPaths([...includeGlobs, ...excludeGlobs]);
+}
+/**
+ * Extract ONE file's CHEAP half: loc/language, resolved internal import +
+ * re-export targets, and external packages — an AST walk of the top-level
+ * declarations + module resolution, NO type-checker symbol work. `calls` is
+ * left empty; extractFileCalls below fills it. The incremental engine uses
+ * this pass alone for files whose imports must re-resolve but whose call
+ * bindings provably didn't move.
+ *
+ * `internalIds` is the CURRENT tree's source-file id set — resolution outside
+ * it (e.g. a stray .d.ts) is ignored, matching the original batch behavior.
+ */
+export function extractFileImportsRecord(sf, root, internalIds) {
+    const fromId = toId(root, sf.getFilePath());
+    const importWeights = new Map();
+    const externalWeights = new Map();
+    const reexports = new Set();
+    // Static import/export declarations → import edges. Internal when the
+    // specifier resolves to a project source file; bare unresolved specifier →
+    // external node.
+    const decls = [...sf.getImportDeclarations(), ...sf.getExportDeclarations()];
+    for (const decl of decls) {
+        const spec = decl.getModuleSpecifierValue();
+        if (!spec)
+            continue; // e.g. bare `export { x }` with no `from`
+        const resolved = decl.getModuleSpecifierSourceFile();
+        if (resolved) {
+            const toId_ = toId(root, resolved.getFilePath());
+            if (toId_ === fromId)
+                continue; // ignore self-references
+            if (internalIds.has(toId_)) {
+                importWeights.set(toId_, (importWeights.get(toId_) ?? 0) + 1);
+                // `export … from` — the re-export surface a change propagates through
+                // (the incremental engine's dependents closure follows these).
+                if (decl.getKind() === SyntaxKind.ExportDeclaration)
+                    reexports.add(toId_);
+            }
+            // resolved-but-outside-project (e.g. a .d.ts) → ignore
+        }
+        else if (!isRelativeSpecifier(spec) && !isBuiltin(spec)) {
+            // Builtins shortcut ( / , fixes ): Node builtins
+            // (`fs`, `node:fs`, `path`, `crypto`, …) are substrate, never diagram
+            // nodes. Dropping them at the source means they never become a graph
+            // external, never reach the LLM classifier, and never cost a token.
+            // `isBuiltin` matches both the bare (`fs`) and `node:`-prefixed
+            // (`node:fs`) forms, so the policy is uniform regardless of import style.
+            const ext = externalIdFor(spec);
+            const existing = externalWeights.get(ext.id);
+            if (existing)
+                existing.weight += 1;
+            else
+                externalWeights.set(ext.id, { specifier: ext.specifier, weight: 1 });
+        }
+        // unresolved relative specifier → skip (missing file / dynamic)
+    }
+    return {
+        loc: sf.getEndLineNumber(),
+        language: languageOf(fromId),
+        imports: [...importWeights].map(([to, weight]) => ({ to, weight })),
+        externals: [...externalWeights].map(([id, v]) => ({ id, specifier: v.specifier, weight: v.weight })),
+        calls: [],
+        reexports: [...reexports],
+    };
+}
+/**
+ * The EXPENSIVE half: best-effort typed call edges — resolve each call
+ * target's symbol to its declaring source file via the type checker.
+ * Internal-only (externals already captured via imports). Wrapped defensively
+ * — without installed types some resolutions throw; we degrade to import-only
+ * edges rather than fail the extraction.
+ */
+export function extractFileCalls(sf, root, internalIds) {
+    const callWeights = new Map();
+    try {
+        // CallExpression (`foo()`, `obj.method()`) AND NewExpression (`new Foo()`).
+        // adds instantiation: `new ServiceClass()` is a real
+        // runtime dependency, stronger evidence than a bare import, and gives the
+        // edge-kind LLM more non-import signal to label `calls` over coupling.
+        // Both node kinds expose getExpression(); method dispatch on a typed
+        // receiver resolves through the PropertyAccessExpression's symbol.
+        const sites = [
+            ...sf.getDescendantsOfKind(SyntaxKind.CallExpression),
+            ...sf.getDescendantsOfKind(SyntaxKind.NewExpression),
+        ];
+        for (const site of sites) {
+            const expr = site.getExpression();
+            if (!expr)
+                continue; // malformed `new` with no callee
+            const sym = symbolOf(expr);
+            const sdecls = sym?.getDeclarations() ?? [];
+            for (const d of sdecls) {
+                const declSf = d.getSourceFile();
+                if (declSf === sf)
+                    continue;
+                const toId_ = toId(root, declSf.getFilePath());
+                if (internalIds.has(toId_))
+                    callWeights.set(toId_, (callWeights.get(toId_) ?? 0) + 1);
+            }
+        }
+    }
+    catch {
+        // resolution unavailable for this file — import edges still stand
+    }
+    return [...callWeights].map(([to, weight]) => ({ to, weight }));
+}
+/** Both halves: the complete per-file extraction (imports + calls). */
+export function extractFileRecord(sf, root, internalIds) {
+    const rec = extractFileImportsRecord(sf, root, internalIds);
+    rec.calls = extractFileCalls(sf, root, internalIds);
+    return rec;
+}
+function symbolOf(expr) {
+    try {
+        return expr.getSymbol();
+    }
+    catch {
+        return undefined;
+    }
+}
+export class TsMorphExtractor {
+    language = 'typescript';
+    async extract(repoDir) {
+        const root = resolve(repoDir);
+        const project = buildExtractionProject(root);
+        addAllSourceFiles(project, root);
+        const sourceFiles = project.getSourceFiles();
+        const internalIds = new Set(sourceFiles.map((sf) => toId(root, sf.getFilePath())));
+        const files = {};
+        for (const sf of sourceFiles) {
+            files[toId(root, sf.getFilePath())] = extractFileRecord(sf, root, internalIds);
+        }
+        // headSha is irrelevant for a one-shot batch extract; graphFromState only
+        // reads the per-file records.
+        return graphFromState(root, { headSha: '', files });
+    }
+}
+//# sourceMappingURL=ts-morph-adapter.js.map

package/dist/graph/ts-morph-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-morph-adapter.js","sourceRoot":"","sources":["../../src/graph/ts-morph-adapter.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,EAAE;AACF,qEAAqE;AACrE,+EAA+E;AAC/E,wEAAwE;AACxE,6EAA6E;AAC7E,8EAA8E;AAC9E,yDAAyD;AAEzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,OAAO,EACP,UAAU,EACV,oBAAoB,EACpB,UAAU,EACV,YAAY,GAGb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAA6C,MAAM,YAAY,CAAC;AAC3G,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,GAEb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAe;IAChD,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAe;IAGzD,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,oBAAoB,EAAE,eAAe,CAAC,EAAE,CAAC;QAC5E,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;iBAChC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,uBAAuB;iBACxD,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,yCAAyC;iBAC5E,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,qDAAqD;YACvF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAE1B,CAAC;YACF,MAAM,EAAE,GAAG,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;YACtC,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBAC3B,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,qEAAqE;AACrE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,mFAAmF;AACnF,qDAAqD;AACrD,SAAS,iBAAiB,CAAC,OAAe;IAIxC,MAAM,EAAE,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO;QACxB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC;QAC7B,CAAC,CAAC,UAAU;YACV,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,sEAAsE;YAC/E,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,IAAI,OAAO,CAAC;QACjB,2BAA2B,EAAE,IAAI;QACjC,4BAA4B,EAAE,IAAI;QAClC,mBAAmB,EAAE,IAAI;QACzB,eAAe,EAAE;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,oBAAoB,CAAC,OAAO;YAC9C,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,MAAM,EAAE,YAAY,CAAC,MAAM;YAC3B,0BAA0B,EAAE,IAAI;YAChC,OAAO;YACP,KAAK;SACN;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,IAAY;IAC9D,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,UAAU,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IACpE,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAc,EACd,IAAY,EACZ,WAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAiD,CAAC;IACjF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,sEAAsE;IACtE,2EAA2E;IAC3E,iBAAiB;IACjB,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,SAAS,CAAC,0CAA0C;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,MAAM;gBAAE,SAAS,CAAC,yBAAyB;YACzD,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9D,sEAAsE;gBACtE,+DAA+D;gBAC/D,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,iBAAiB;oBAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5E,CAAC;YACD,uDAAuD;QACzD,CAAC;aAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,iDAAiD;YACjD,sEAAsE;YACtE,qEAAqE;YACrE,oEAAoE;YACpE,gEAAgE;YAChE,0EAA0E;YAC1E,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,QAAQ;gBAAE,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;;gBAC9B,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,gEAAgE;IAClE,CAAC;IAED,OAAO;QACL,GAAG,EAAE,EAAE,CAAC,gBAAgB,EAAE;QAC1B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,SAAS,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAc,EACd,IAAY,EACZ,WAAgC;IAEhC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,IAAI,CAAC;QACH,4EAA4E;QAC5E,qDAAqD;QACrD,0EAA0E;QAC1E,uEAAuE;QACvE,qEAAqE;QACrE,mEAAmE;QACnE,MAAM,KAAK,GAAG;YACZ,GAAG,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC,cAAc,CAAC;YACrD,GAAG,EAAE,CAAC,oBAAoB,CAAC,UAAU,CAAC,aAAa,CAAC;SACrD,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI;gBAAE,SAAS,CAAC,iCAAiC;YACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC;gBACjC,IAAI,MAAM,KAAK,EAAE;oBAAE,SAAS;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC/C,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;IACD,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,EAAc,EAAE,IAAY,EAAE,WAAgC;IAC9F,MAAM,GAAG,GAAG,wBAAwB,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC5D,GAAG,CAAC,KAAK,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,IAAU;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,gBAAgB;IAClB,QAAQ,GAAG,YAAY,CAAC;IAEjC,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC7C,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEjC,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3F,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACjF,CAAC;QAED,0EAA0E;QAC1E,8BAA8B;QAC9B,OAAO,cAAc,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/graph/types.d.ts

@@ -0,0 +1,37 @@
+export interface GraphFile {
+    id: string;
+    loc: number;
+    language: string;
+}
+export type EdgeKind = 'import' | 'call';
+export interface GraphEdge {
+    from: string;
+    to: string;
+    kind: EdgeKind;
+    external: boolean;
+    weight: number;
+}
+export interface ExternalNode {
+    id: string;
+    specifier: string;
+}
+export interface NormalizedGraph {
+    root: string;
+    files: GraphFile[];
+    edges: GraphEdge[];
+    externals: ExternalNode[];
+}
+export interface GraphExtractor {
+    readonly language: string;
+    extract(repoDir: string): Promise<NormalizedGraph>;
+}
+export declare function externalIdFor(specifier: string): {
+    id: string;
+    specifier: string;
+};
+export declare function isRelativeSpecifier(spec: string): boolean;
+export declare function pythonExternalIdFor(moduleName: string): {
+    id: string;
+    specifier: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACpD;AAKD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAYlF;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAUD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAGzF"}

package/dist/graph/types.js

@@ -0,0 +1,50 @@
+// The normalized graph interface (/325) — the pluggable seam of the
+// extraction architecture.
+//
+//   per-language extractor adapter → [NormalizedGraph] → clustering → LLM → DB
+//
+// EVERY extractor targets this shape and EVERY downstream layer (Louvain
+// clustering, LLM naming, persistence) consumes only this shape. That's what
+// makes multilingual support (P4: Python/Go/… adapters) ADDITIVE — a new
+// adapter, not a rewrite. Structure here is DERIVED deterministically; the LLM
+// never authors it (the locked /325 split).
+// Collapse a bare specifier to its package node id: `@scope/pkg/sub` →
+// `ext:@scope/pkg`, `pkg/sub` → `ext:pkg`. Strips Deno-style `jsr:`/`npm:`
+// registry prefixes (e.g. `jsr:@supabase/functions-js` → `ext:@supabase/functions-js`).
+export function externalIdFor(specifier) {
+    const bare = specifier.replace(/^(jsr:|npm:|node:)/, '');
+    const parts = bare.split('/');
+    const withVersion = bare.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0];
+    // Deno-style specifiers pin a version on the package itself
+    // (`npm:@supabase/supabase-js@2`, `npm:lodash@4`). Strip it so the node is the
+    // package, not the package+version — otherwise the `@2` is an invalid
+    // package-name char and the classifier's fail-loud boundary rejects it.
+    // The leading `@` of a scope is preserved; only a version `@` (after the name)
+    // is dropped.
+    const pkg = stripPackageVersion(withVersion);
+    return { id: `ext:${pkg}`, specifier: pkg };
+}
+// `@scope/name@1.2.3` → `@scope/name`; `lodash@4` → `lodash`.
+function stripPackageVersion(pkg) {
+    const m = pkg.startsWith('@')
+        ? pkg.match(/^(@[^/]+\/[^/@]+)/)
+        : pkg.match(/^([^/@]+)/);
+    return m ? m[1] : pkg;
+}
+// Is a module specifier internal (relative/absolute path) vs a bare package?
+export function isRelativeSpecifier(spec) {
+    return spec.startsWith('./') || spec.startsWith('../') || spec === '.' || spec === '..';
+}
+// Collapse a Python DOTTED module name to its distribution node id —
+// the analogue of externalIdFor for the Pyright adapter. Python imports are
+// dotted, not slash-separated: `sqlalchemy.orm` and `google.cloud.storage` both
+// belong to their TOP-LEVEL import package (`sqlalchemy`, `google`), mirroring how
+// `@scope/pkg/sub` collapses to `@scope/pkg` on the npm side. The top-level import
+// name (what appears in source) is used as the id; the import-name→PyPI-dist alias
+// (`cv2`→opencv-python, `yaml`→PyYAML) is a metadata-fetch concern, not a node id.
+// A relative import (leading dot) must NEVER reach here — it's always first-party.
+export function pythonExternalIdFor(moduleName) {
+    const top = moduleName.replace(/^\.+/, '').split('.')[0];
+    return { id: `ext:${top}`, specifier: top };
+}
+//# sourceMappingURL=types.js.map

package/dist/graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,2BAA2B;AAC3B,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,yEAAyE;AACzE,+EAA+E;AAC/E,4CAA4C;AA8C5C,uEAAuE;AACvE,2EAA2E;AAC3E,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClF,4DAA4D;IAC5D,+EAA+E;IAC/E,sEAAsE;IACtE,wEAAwE;IACxE,+EAA+E;IAC/E,cAAc;IACd,MAAM,GAAG,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AAC9C,CAAC;AAED,8DAA8D;AAC9D,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3B,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC;QAChC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACxB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;AAC1F,CAAC;AAED,qEAAqE;AACrE,4EAA4E;AAC5E,gFAAgF;AAChF,mFAAmF;AACnF,mFAAmF;AACnF,mFAAmF;AACnF,mFAAmF;AACnF,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+export { extract } from './extract.js';
+export type { ExtractOptions, ExtractResult } from './extract.js';
+export { EXTRACTOR_PACKAGE_VERSION } from './version.js';
+export { ShortSha, ModuleId, parseModuleKind, parseEdgeKind, coerceEdgeKind, INFRA_MODULE_KINDS, MODULE_KINDS, EDGE_KINDS, FORBIDDEN_EDGE_KINDS, } from './types.js';
+export type { ModuleKind, InfraModuleKind, NodeProvenance, PackageRole, EdgeKind, ForbiddenEdgeKind, Edge, } from './types.js';
+export { extractGraph, mergeGraphs } from './graph/extract.js';
+export { externalIdFor, isRelativeSpecifier, pythonExternalIdFor } from './graph/types.js';
+export type { GraphFile, GraphEdge, ExternalNode, NormalizedGraph, GraphExtractor, } from './graph/types.js';
+export { IncrementalExtractor } from './graph/incremental.js';
+export type { PatchMetrics } from './graph/incremental.js';
+export { SOURCE_EXTENSIONS, PYTHON_SOURCE_EXTENSIONS, EXCLUDE_DIRS, PYTHON_EXCLUDE_DIRS, isSourceFilePath, isConfigInvalidatorPath, EXTRACTOR_VERSION, graphFromState, classifyDiff, reexportClosure, computeCallPatchUnit, FILE_GRAPH_VERSION, serializeFileGraph, isValidFileRecord, deserializeFileGraph, diffFileGraphStates, } from './graph/file-graph.js';
+export type { SourceLang, FileEdgeRef, FileExternalRef, FileRecord, FileGraphState, DiffEntry, ClassifiedDiff, SerializedFileGraph, } from './graph/file-graph.js';
+export { listSourceFiles, detectRepoLanguage, detectRepoLanguages, graphLanguage, } from './graph/language.js';
+export { NOISE_CATEGORIES, NOISE_RULES, classifyNoise, filterNoise, summarizeNoise } from './graph/noise-filter.js';
+export type { NoiseCategory, NoiseRule, DroppedNoise } from './graph/noise-filter.js';
+export { crossLanguageApiEdges } from './graph/cross-language.js';
+export { clusterGraph, stabilizeModuleIds, detectGodNodes, betweenness, PackagePartitionCache, } from './cluster/louvain.js';
+export type { ClusteredModule, ModuleEdge, ClusterResult, ClusterOptions } from './cluster/louvain.js';
+export { isWorkspaceManifestPath, detectWorkspaceLayout } from './cluster/workspaces.js';
+export type { WorkspacePackage, WorkspaceLayout } from './cluster/workspaces.js';
+export { compileMatchers, slugify } from './cluster/overrides.js';
+export type { AssignRule, LabelOverride, OverrideMap } from './cluster/overrides.js';
+export { EXTERNAL_SUBSYSTEM_ID, DIR_SUBSYSTEM_PREFIX, PKG_SUBSYSTEM_PREFIX, DOMAIN_SUBSYSTEM_PREFIX, RESERVED_SUBSYSTEM_PREFIXES, bareSubsystemSlug, dominantTopLevelDir, humanizeDir, computeSubsystems, distinctSubsystems, } from './cluster/subsystem.js';
+export type { Subsystem } from './cluster/subsystem.js';
+export { moduleSignature, mintGroupId, namespaceModelIds, selectPending, buildFullModel, buildIncrementalModel, reconcileGroupIds, finalizeModel, groupToSubsystem, } from './cluster/domain-grouping.js';
+export type { DomainGroup, ModuleAssignment, GroupingModel, ProposedGroup, LlmGrouping, ModuleSignal, } from './cluster/domain-grouping.js';
+export { LAYER_NAMES, GATE_THRESHOLDS, isFrameworkSubsystemId, evaluateGroupingGate, } from './cluster/grouping-gate.js';
+export type { GateModule, GroupingGateResult } from './cluster/grouping-gate.js';
+export { detectFrameworkStack } from './framework/detect-step.js';
+export { contributeFrameworkGraph } from './framework/contribute-step.js';
+export type { FrameworkContributions } from './framework/contribute-step.js';
+export { registerFrameworkAdapter, listFrameworkAdapters, clearFrameworkAdapters, detectFrameworks, } from './framework/registry.js';
+export { registerBuiltinFrameworkAdapters } from './framework/register.js';
+export { analyzeOrmDataModel } from './framework/orm/orm.js';
+export type { OrmDataModel } from './framework/orm/orm.js';
+export type { FrameworkDetectContext, DetectMatch, FrameworkManifest, FrameworkClusterView, FrameworkContext, FrameworkGroup, FrameworkGroupingPrior, FrameworkEdge, RoleTag, FrameworkClassificationRef, FrameworkAdapter, } from './framework/types.js';
+export { extractInfra } from './infra/infra-step.js';
+export type { ResourceTypeRef, ResourceTypeResult, ResourceTypeClassifier, InfraStepResult, } from './infra/infra-step.js';
+export { registerInfraAdapter, listInfraAdapters, activeSourceScanners, clearInfraAdapters, runInfraAdapters, mergeInfraGraphs, validateMergedGraph, } from './infra/registry.js';
+export { registerBuiltinInfraAdapters } from './infra/register.js';
+export { isInfraRelevantPath, diffTouchesInfra, diffTouchesInfraWithSources } from './infra/relevance.js';
+export type { InfraAdapter, InfraNode, InfraEdge, ClassificationRef, InfraGraph, MergedInfraGraph, } from './infra/types.js';
+export { DEFAULT_BUDGET, enforceSourceBudget } from './safety.js';
+export type { SafetyBudget } from './safety.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,51 @@
+// @backthread/extractor — deterministic, install-free structural extraction for
+// TypeScript and Python codebases.
+//
+// Turns a working tree into a structural graph: modules (with kinds, god-node
+// flags, and path-derived subsystems), edges, communities, framework roles, and
+// infrastructure — with ZERO LLM, database, or network. AST via ts-morph (TS)
+// and Pyright's NoAccessHost (Python, pure-static, never executes repo code);
+// Louvain community detection; a framework-adapter fleet; and static
+// infra-config readers.
+//
+// The one-shot `extract()` is the convenience surface; every granular stage is
+// exported too, so a host can interleave its own steps (e.g. an incremental
+// diff-driven re-extract, or a warm-started cluster) between them.
+// ── Composed one-shot ──
+export { extract } from './extract.js';
+// ── Version (for the container↔CLI version-lockstep guard) ──
+export { EXTRACTOR_PACKAGE_VERSION } from './version.js';
+// ── Structural type vocabulary (the domain types) ──
+export { ShortSha, ModuleId, parseModuleKind, parseEdgeKind, coerceEdgeKind, INFRA_MODULE_KINDS, MODULE_KINDS, EDGE_KINDS, FORBIDDEN_EDGE_KINDS, } from './types.js';
+// ── Graph: AST → normalized code graph ──
+export { extractGraph, mergeGraphs } from './graph/extract.js';
+export { externalIdFor, isRelativeSpecifier, pythonExternalIdFor } from './graph/types.js';
+export { IncrementalExtractor } from './graph/incremental.js';
+export { SOURCE_EXTENSIONS, PYTHON_SOURCE_EXTENSIONS, EXCLUDE_DIRS, PYTHON_EXCLUDE_DIRS, isSourceFilePath, isConfigInvalidatorPath, EXTRACTOR_VERSION, graphFromState, classifyDiff, reexportClosure, computeCallPatchUnit, FILE_GRAPH_VERSION, serializeFileGraph, isValidFileRecord, deserializeFileGraph, diffFileGraphStates, } from './graph/file-graph.js';
+export { listSourceFiles, detectRepoLanguage, detectRepoLanguages, graphLanguage, } from './graph/language.js';
+export { NOISE_CATEGORIES, NOISE_RULES, classifyNoise, filterNoise, summarizeNoise } from './graph/noise-filter.js';
+export { crossLanguageApiEdges } from './graph/cross-language.js';
+// ── Cluster: Louvain → modules, god-nodes, subsystems ──
+export { clusterGraph, stabilizeModuleIds, detectGodNodes, betweenness, PackagePartitionCache, } from './cluster/louvain.js';
+export { isWorkspaceManifestPath, detectWorkspaceLayout } from './cluster/workspaces.js';
+export { compileMatchers, slugify } from './cluster/overrides.js';
+export { EXTERNAL_SUBSYSTEM_ID, DIR_SUBSYSTEM_PREFIX, PKG_SUBSYSTEM_PREFIX, DOMAIN_SUBSYSTEM_PREFIX, RESERVED_SUBSYSTEM_PREFIXES, bareSubsystemSlug, dominantTopLevelDir, humanizeDir, computeSubsystems, distinctSubsystems, } from './cluster/subsystem.js';
+export { moduleSignature, mintGroupId, namespaceModelIds, selectPending, buildFullModel, buildIncrementalModel, reconcileGroupIds, finalizeModel, groupToSubsystem, } from './cluster/domain-grouping.js';
+export { LAYER_NAMES, GATE_THRESHOLDS, isFrameworkSubsystemId, evaluateGroupingGate, } from './cluster/grouping-gate.js';
+// ── Framework adapters ──
+export { detectFrameworkStack } from './framework/detect-step.js';
+export { contributeFrameworkGraph } from './framework/contribute-step.js';
+export { registerFrameworkAdapter, listFrameworkAdapters, clearFrameworkAdapters, detectFrameworks, } from './framework/registry.js';
+export { registerBuiltinFrameworkAdapters } from './framework/register.js';
+// The ORM data-model analysis (entities + relationships) a host applies onto the
+// graph during assembly — the granular ORM surface, exported for hosts that
+// enrich the graph with ORM structure (e.g. the ingest container's assemble step).
+export { analyzeOrmDataModel } from './framework/orm/orm.js';
+// ── Infra adapters (static config reads only) ──
+export { extractInfra } from './infra/infra-step.js';
+export { registerInfraAdapter, listInfraAdapters, activeSourceScanners, clearInfraAdapters, runInfraAdapters, mergeInfraGraphs, validateMergedGraph, } from './infra/registry.js';
+export { registerBuiltinInfraAdapters } from './infra/register.js';
+export { isInfraRelevantPath, diffTouchesInfra, diffTouchesInfraWithSources } from './infra/relevance.js';
+// ── Safety: pre-extraction source-budget guard ──
+export { DEFAULT_BUDGET, enforceSourceBudget } from './safety.js';
+//# sourceMappingURL=index.js.map