@lbroth/rothunter 1.0.0-rc.1

package/dist/graph/entry-points.js

@@ -0,0 +1,282 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// Entry-point heuristics: package.json main/module/bin/exports, conventional
+// filenames (index/main/cli, scripts/, bin/), tests, framework routes (Next,
+// SvelteKit, Astro). Workspace-relative POSIX paths.
+/**
+ * Decide whether the workspace at `root` describes a published npm
+ * library. Heuristic: top-level `package.json` has a name + version,
+ * is NOT marked private, AND declares one of the standard package
+ * entry fields (main / module / exports / bin). When this is true,
+ * downstream consumers can import individual files and dead-export
+ * verdicts need to lean toward FALSE-POSITIVE for any symbol that
+ * looks like a utility / config / type-surface helper.
+ */
+export function isPublishedLibrary(root) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
+        if (typeof pkg.name !== 'string' || pkg.name.length === 0)
+            return false;
+        if (typeof pkg.version !== 'string' || pkg.version.length === 0)
+            return false;
+        if (pkg.private === true)
+            return false;
+        return (typeof pkg.main === 'string' ||
+            typeof pkg.module === 'string' ||
+            pkg.exports != null ||
+            pkg.bin != null);
+    }
+    catch {
+        return false;
+    }
+}
+export function discoverEntryPoints(workspaceRoot, knownFiles) {
+    const entries = new Set();
+    addPackageJsonEntries(workspaceRoot, entries);
+    // Walk nested package.json files (monorepo workspaces — `packages/foo/
+    // package.json`, `apps/bar/package.json`, etc.). Each one's scripts /
+    // main / bin / exports field names entry points in its own subtree.
+    // Walked via direct fs scan rather than `knownFiles` because package.json
+    // is not parsed by the TS parser and never appears in the file set.
+    for (const pkgDir of findNestedPackageDirs(workspaceRoot)) {
+        addPackageJsonEntries(pkgDir, entries, workspaceRoot);
+    }
+    for (const file of knownFiles) {
+        if (matchesConvention(file))
+            entries.add(file);
+    }
+    return entries;
+}
+/**
+ * Filesystem walk for every directory containing a `package.json`
+ * below `root`. Skips `node_modules`, dot-directories, and common
+ * build / cache outputs to keep the walk bounded. Returns absolute
+ * paths (consumed by `addPackageJsonEntries`).
+ */
+function findNestedPackageDirs(root) {
+    const out = [];
+    const SKIP_DIRS = new Set([
+        'node_modules', 'dist', 'build', 'out', 'coverage', '.git',
+        '.next', '.nuxt', '.svelte-kit', '.turbo', '.cache', '.parcel-cache',
+        '.vite', 'tmp', 'temp',
+    ]);
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let dirents;
+        try {
+            dirents = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of dirents) {
+            if (e.isDirectory()) {
+                if (e.name.startsWith('.') && e.name !== '.')
+                    continue;
+                if (SKIP_DIRS.has(e.name))
+                    continue;
+                stack.push(path.join(dir, e.name));
+            }
+            else if (e.isFile() && e.name === 'package.json' && dir !== root) {
+                out.push(dir);
+            }
+        }
+    }
+    return out;
+}
+const ENTRY_FILENAMES = new Set([
+    'index.ts',
+    'index.tsx',
+    'main.ts',
+    'main.tsx',
+    'cli.ts',
+    'mcp-server.ts',
+    'server.ts',
+]);
+/** Patterns that indicate a file is conventionally an entry point or a test harness. */
+function matchesConvention(file) {
+    const posix = file.split(path.sep).join('/');
+    const basename = path.basename(posix);
+    if (ENTRY_FILENAMES.has(basename))
+        return true;
+    if (/^scripts\//.test(posix))
+        return true;
+    if (/^bin\//.test(posix))
+        return true;
+    if (/(^|\/)__tests__\//.test(posix))
+        return true;
+    if (/(^|\/)__fixtures__\//.test(posix))
+        return true;
+    if (/(^|\/)__mocks__\//.test(posix))
+        return true;
+    if (/(^|\/)tests\//.test(posix))
+        return true;
+    if (/(^|\/)test\//.test(posix))
+        return true;
+    if (/(^|\/)e2e\//.test(posix))
+        return true;
+    // Standalone demos / runnable examples — never imported, but invoked
+    // directly via `tsx examples/foo.ts`. Real-world FP on nullpii's
+    // examples/01-basic.ts etc.
+    if (/(^|\/)examples\//.test(posix))
+        return true;
+    if (/(^|\/)demo\//.test(posix))
+        return true;
+    if (/(^|\/)benchmarks?\//.test(posix))
+        return true;
+    // Workspace-level config files at the root — `vitest.config.ts`,
+    // `jest.config.ts`, `vite.config.ts`, `playwright.config.ts`, etc.
+    if (/^[^/]*\.config\.(ts|tsx|mts|cts)$/.test(posix))
+        return true;
+    if (/\.(test|spec)\.(ts|tsx)$/.test(posix))
+        return true;
+    // ---- Next.js (pages-router + app-router) --------------------------------
+    if (/(^|\/)pages\//.test(posix))
+        return true;
+    // app/ files: match both the un-nested case (`app/layout.tsx`, `app/page.tsx`)
+    // AND nested route segments (`app/users/[id]/page.tsx`).
+    if (/(^|\/)(src\/)?app\/(.*\/)?(page|route|layout|loading|error|template|not-found|head|default|global-error)\.(ts|tsx)$/.test(posix))
+        return true;
+    if (basename === 'middleware.ts' || basename === 'middleware.tsx')
+        return true;
+    if (basename === 'instrumentation.ts' || basename === 'instrumentation-client.ts')
+        return true;
+    // ---- SvelteKit / Remix / Astro -------------------------------------------
+    if (/(^|\/)routes\//.test(posix))
+        return true;
+    if (/(^|\/)src\/pages\//.test(posix))
+        return true;
+    if (/(^|\/)app\/routes\//.test(posix))
+        return true;
+    // ---- Serverless handlers ------------------------------------------------
+    // Vercel /api, Netlify functions, AWS SAM/CDK Lambda layouts, OpenNext.
+    if (/(^|\/)api\//.test(posix) && /\.(ts|tsx)$/.test(posix))
+        return true;
+    if (/(^|\/)netlify\/(functions|edge-functions)\//.test(posix))
+        return true;
+    if (/(^|\/)functions\//.test(posix))
+        return true;
+    if (/(^|\/)src\/functions\//.test(posix))
+        return true;
+    if (/(^|\/)handlers\//.test(posix))
+        return true;
+    if (/(^|\/)src\/handlers\//.test(posix))
+        return true;
+    if (/(^|\/)src\/lambdas?\//.test(posix))
+        return true;
+    if (/(^|\/)lambdas?\//.test(posix))
+        return true;
+    // Cloudflare Workers, Deno, Bun single-file conventions.
+    if (basename === 'mod.ts')
+        return true;
+    if (basename === 'worker.ts' || basename === 'worker.tsx')
+        return true;
+    // ---- AWS CDK / IaC entrypoints ------------------------------------------
+    if (/(^|\/)(bin|infra|cdk)\//.test(posix) && /\.(ts|tsx)$/.test(posix))
+        return true;
+    if (/\.stack\.(ts|tsx)$/.test(posix))
+        return true;
+    return false;
+}
+function addPackageJsonEntries(pkgRoot, entries, 
+/**
+ * Workspace root for emitting workspace-relative paths. Defaults to
+ * `pkgRoot` for the top-level case; nested package.json files pass
+ * the original workspace root so resolved files stay relative to it.
+ */
+workspaceRoot = pkgRoot) {
+    const pkgPath = path.join(pkgRoot, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return;
+    let pkg;
+    try {
+        pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    }
+    catch {
+        return;
+    }
+    pushIfFile(pkgRoot, pkg.main, entries, workspaceRoot);
+    pushIfFile(pkgRoot, pkg.module, entries, workspaceRoot);
+    pushIfFile(pkgRoot, pkg.types, entries, workspaceRoot);
+    const bin = pkg.bin;
+    if (typeof bin === 'string')
+        pushIfFile(pkgRoot, bin, entries, workspaceRoot);
+    else if (bin && typeof bin === 'object') {
+        for (const v of Object.values(bin))
+            pushIfFile(pkgRoot, v, entries, workspaceRoot);
+    }
+    const exportsField = pkg.exports;
+    if (exportsField && typeof exportsField === 'object') {
+        walkExports(pkgRoot, exportsField, entries, workspaceRoot);
+    }
+    // `scripts` field: dev runners (`tsx watch src/dev.ts`), one-off
+    // scripts (`node scripts/seed.ts`), build steps that compile a file
+    // directly — each names a real file in the workspace that should
+    // count as an entry point. Without this, every server `dev.ts` /
+    // worker / migration script reads as dead-module.
+    const scripts = pkg.scripts;
+    if (scripts && typeof scripts === 'object') {
+        for (const v of Object.values(scripts)) {
+            if (typeof v === 'string')
+                extractScriptFileRefs(pkgRoot, v, entries, workspaceRoot);
+        }
+    }
+}
+/**
+ * Walk a package.json script command and extract every workspace-
+ * relative file path that looks like a source-file argument. Matches
+ * tokens ending in `.ts` / `.tsx` / `.mts` / `.cts` / `.js` / `.mjs` /
+ * `.cjs` and runs them through the same `pushIfFile` resolver as
+ * `main` / `bin` / `exports` so `dist/foo.js` → `src/foo.ts` swapping
+ * still works.
+ *
+ * Heuristic: extract via word boundary on whitespace, `&&`, `||`, `;`,
+ * `|`. Skip flag-shaped tokens (`--config=foo.ts`) — they're tooling
+ * config, not entry points the tool walks.
+ */
+function extractScriptFileRefs(pkgRoot, cmd, out, workspaceRoot) {
+    const tokens = cmd.split(/[\s&|;]+/).filter(Boolean);
+    for (const tok of tokens) {
+        if (tok.startsWith('-'))
+            continue;
+        if (tok.startsWith('"') || tok.startsWith("'"))
+            continue;
+        // Strip leading `./` / `node:` / shell expansion artifacts.
+        const cleaned = tok.replace(/^\.\/+/, '').replace(/[)"';]+$/, '');
+        if (!/\.(?:ts|tsx|mts|cts|js|mjs|cjs)$/i.test(cleaned))
+            continue;
+        pushIfFile(pkgRoot, cleaned, out, workspaceRoot);
+    }
+}
+function walkExports(pkgRoot, node, out, workspaceRoot) {
+    if (typeof node === 'string') {
+        pushIfFile(pkgRoot, node, out, workspaceRoot);
+        return;
+    }
+    for (const v of Object.values(node)) {
+        if (typeof v === 'string')
+            pushIfFile(pkgRoot, v, out, workspaceRoot);
+        else if (v && typeof v === 'object')
+            walkExports(pkgRoot, v, out, workspaceRoot);
+    }
+}
+function pushIfFile(pkgRoot, value, out, workspaceRoot) {
+    if (typeof value !== 'string')
+        return;
+    // Resolve package.json paths (often `dist/index.js`) back to the source by
+    // swapping `dist/` → `src/` and `.js` → `.ts` — a common build convention.
+    const candidates = [
+        value,
+        value.replace(/^\.?\/?dist\//, 'src/').replace(/\.js$/, '.ts'),
+        value.replace(/\.js$/, '.ts'),
+    ];
+    for (const c of candidates) {
+        const abs = path.resolve(pkgRoot, c);
+        if (fs.existsSync(abs) && fs.statSync(abs).isFile()) {
+            out.add(path.relative(workspaceRoot, abs));
+            return;
+        }
+    }
+}
+//# sourceMappingURL=entry-points.js.map

package/dist/graph/entry-points.js.map

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

package/dist/graph/handler-conventions.d.ts

@@ -0,0 +1,2 @@
+export declare function isHandlerConventionFile(file: string): boolean;
+//# sourceMappingURL=handler-conventions.d.ts.map

package/dist/graph/handler-conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-conventions.d.ts","sourceRoot":"","sources":["../../src/graph/handler-conventions.ts"],"names":[],"mappings":"AAiBA,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO7D"}

package/dist/graph/handler-conventions.js

@@ -0,0 +1,26 @@
+import * as path from 'node:path';
+// Files in dirs where runtimes load handlers via explicit config (CDK/SAM/SST,
+// netlify.toml, serverless): src/handlers, src/lambdas, src/functions, netlify/
+// functions, etc. Auto-routed paths (pages/api, app/api/.../route) excluded —
+// those are wired by filesystem convention, handled by entry-points.ts.
+const HANDLER_DIR_PATTERNS = [
+    /(^|\/)src\/handlers\//,
+    /(^|\/)src\/lambdas?\//,
+    /(^|\/)src\/functions\//,
+    /(^|\/)handlers\//,
+    /(^|\/)lambdas?\//,
+    /(^|\/)functions\//,
+    /(^|\/)netlify\/(functions|edge-functions)\//,
+];
+export function isHandlerConventionFile(file) {
+    const posix = file.split(path.sep).join('/');
+    // Skip ambient declarations / story files — never handlers.
+    if (/\.d\.ts$/.test(posix))
+        return false;
+    if (/\.(test|spec)\.(ts|tsx)$/.test(posix))
+        return false;
+    if (!/\.(ts|tsx)$/.test(posix))
+        return false;
+    return HANDLER_DIR_PATTERNS.some((re) => re.test(posix));
+}
+//# sourceMappingURL=handler-conventions.js.map

package/dist/graph/handler-conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-conventions.js","sourceRoot":"","sources":["../../src/graph/handler-conventions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,wEAAwE;AAExE,MAAM,oBAAoB,GAAa;IACrC,uBAAuB;IACvB,uBAAuB;IACvB,wBAAwB;IACxB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,6CAA6C;CAC9C,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/graph/iac-entries.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveIacEntryFiles(workspaceRoot: string, files: ReadonlyArray<string>): Set<string>;
+//# sourceMappingURL=iac-entries.d.ts.map

package/dist/graph/iac-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iac-entries.d.ts","sourceRoot":"","sources":["../../src/graph/iac-entries.ts"],"names":[],"mappings":"AAOA,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,GAAG,CAAC,MAAM,CAAC,CAcb"}

package/dist/graph/iac-entries.js

@@ -0,0 +1,123 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { Project, SyntaxKind } from 'ts-morph';
+// IaC entry-point walker. Picks up CDK / SST / serverless constructs:
+// NodejsFunction, lambda.Function, sst.Function, sst.Api routes, bundle({...}).
+// Reads `entry` / `handler` / `code` strings → workspace-relative paths.
+export function resolveIacEntryFiles(workspaceRoot, files) {
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        skipFileDependencyResolution: true,
+    });
+    for (const rel of files) {
+        project.addSourceFileAtPathIfExists(path.join(workspaceRoot, rel));
+    }
+    const out = new Set();
+    for (const sf of project.getSourceFiles()) {
+        walkFile(workspaceRoot, sf, out);
+    }
+    return out;
+}
+const ENTRY_PROPERTY_NAMES = new Set(['entry', 'handler', 'code', 'entrypoint']);
+/**
+ * Scan a single TypeScript source file for IaC construct entry strings.
+ * Emits each resolved workspace-relative target into `accumulator`.
+ */
+function walkFile(workspaceRoot, sourceFile, accumulator) {
+    const sourceFileDir = path.dirname(sourceFile.getFilePath());
+    // Walk every object-literal expression and inspect properties whose name is
+    // a known IaC entry property. We don't try to scope this to NewExpression
+    // ancestry — that adds complexity for little gain. False positives here
+    // simply mean "this string was treated as an entry point" which is the safe
+    // direction (entry points get *protected* by the dead-module detector).
+    for (const obj of sourceFile.getDescendantsOfKind(SyntaxKind.ObjectLiteralExpression)) {
+        for (const prop of obj.getProperties()) {
+            if (prop.getKind() !== SyntaxKind.PropertyAssignment)
+                continue;
+            // PropertyAssignment has .getName() and .getInitializer() on ts-morph wrapper.
+            const pa = prop;
+            const name = pa.getName();
+            if (!ENTRY_PROPERTY_NAMES.has(name))
+                continue;
+            const init = pa.getInitializer();
+            if (!init)
+                continue;
+            // Accept plain string literals and template literals with no interpolation.
+            const k = init.getKind();
+            if (k !== SyntaxKind.StringLiteral && k !== SyntaxKind.NoSubstitutionTemplateLiteral)
+                continue;
+            const raw = init.getLiteralText();
+            // `handler: 'src/handlers/foo.handler'` — strip the trailing export name.
+            // For AWS Lambda the convention is `<file>.<exportedFn>`; we want the
+            // file, not the export.
+            const filePart = raw.replace(/\.[A-Za-z_$][\w$]*$/, '');
+            const resolved = resolveEntryString(workspaceRoot, sourceFileDir, filePart);
+            if (resolved)
+                accumulator.add(resolved);
+        }
+    }
+    // SST / Serverless `routes: { 'GET /foo': 'src/routes/foo.handler' }` — pick
+    // string values whose lexical position is a value in a routes-shaped object.
+    for (const obj of sourceFile.getDescendantsOfKind(SyntaxKind.ObjectLiteralExpression)) {
+        const parent = obj.getParent();
+        const parentName = inferPropertyOwnerName(parent);
+        if (parentName !== 'routes')
+            continue;
+        for (const prop of obj.getProperties()) {
+            if (prop.getKind() !== SyntaxKind.PropertyAssignment)
+                continue;
+            const pa = prop;
+            const init = pa.getInitializer();
+            if (!init)
+                continue;
+            const k = init.getKind();
+            if (k !== SyntaxKind.StringLiteral && k !== SyntaxKind.NoSubstitutionTemplateLiteral)
+                continue;
+            const raw = init.getLiteralText();
+            const filePart = raw.replace(/\.[A-Za-z_$][\w$]*$/, '');
+            const resolved = resolveEntryString(workspaceRoot, sourceFileDir, filePart);
+            if (resolved)
+                accumulator.add(resolved);
+        }
+    }
+}
+/** Walk up the parent chain looking for the PropertyAssignment that holds this object literal. */
+function inferPropertyOwnerName(node) {
+    let cur = node;
+    for (let i = 0; cur && i < 4; i++) {
+        if (cur.getKind && cur.getKind() === SyntaxKind.PropertyAssignment && cur.getName) {
+            return cur.getName();
+        }
+        cur = cur.getParent ? cur.getParent() : undefined;
+    }
+    return undefined;
+}
+/**
+ * Resolve a CDK/SST entry string to a workspace-relative file path. The
+ * string is typically project-relative (`src/handlers/foo.ts`) but may be
+ * relative to the file declaring the construct (`./foo.ts`).
+ */
+function resolveEntryString(workspaceRoot, sourceFileDir, raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    const candidates = [];
+    const isRelative = trimmed.startsWith('.') || trimmed.startsWith('/');
+    if (isRelative) {
+        candidates.push(path.resolve(sourceFileDir, trimmed));
+    }
+    // Project-relative form is by far the most common in CDK projects.
+    candidates.push(path.resolve(workspaceRoot, trimmed));
+    candidates.push(path.resolve(workspaceRoot, 'src', trimmed));
+    const extensions = ['', '.ts', '.tsx', '/index.ts', '/index.tsx'];
+    for (const base of candidates) {
+        for (const ext of extensions) {
+            const abs = `${base}${ext}`;
+            if (fs.existsSync(abs) && fs.statSync(abs).isFile()) {
+                return path.relative(workspaceRoot, abs);
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=iac-entries.js.map

package/dist/graph/iac-entries.js.map

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

package/dist/graph/import-graph.d.ts

@@ -0,0 +1,48 @@
+import { type TsconfigPaths } from './tsconfig-paths.js';
+/**
+ * File-level import graph.
+ *
+ * A directed edge `a → b` means "file a imports something from file b". The
+ * graph is used by the dead-module detector to find files unreachable from
+ * any entry point.
+ *
+ * Edges and node identities are workspace-relative POSIX paths so the graph
+ * is stable across machines and easy to serialise.
+ */
+export interface ImportGraph {
+    /** All workspace files known to the graph. */
+    nodes: Set<string>;
+    /** Outgoing edges keyed by source file. */
+    outgoing: Map<string, Set<string>>;
+    /** Incoming edges keyed by target file. */
+    incoming: Map<string, Set<string>>;
+}
+export interface ImportRecord {
+    /** Source file (workspace-relative). */
+    source: string;
+    /** Logical workspace name of the source file in multi-workspace mode. */
+    sourceWorkspace?: string;
+    /** Resolved target file (workspace-relative) if the specifier resolved to a workspace path, else null. */
+    target: string | null;
+    /** Workspace name of the resolved target when the import crossed a workspace boundary. */
+    targetWorkspace?: string;
+    /** Raw specifier as written in the import (e.g. `'./utils'`, `'fs'`, `'@org/pkg'`). */
+    specifier: string;
+    /** Named imports (`import { a, b as c }` → ['a', 'c']). Aliases recorded as the local name. */
+    namedImports: string[];
+    /** Default import local name (`import Foo from ...`). */
+    defaultImport?: string;
+    /** Namespace alias (`import * as ns from ...`). When set, every export of the target is consumed. */
+    namespaceAlias?: string;
+    /** True when this record came from `export ... from '...'` (re-export). */
+    isReExport: boolean;
+    /** True for `export * from '...'` — every export of the target propagates. */
+    isStarReExport: boolean;
+    /** Original exported names mentioned in the re-export (`export { a as b } from` → ['a']). */
+    reExportNames?: string[];
+}
+export declare function buildImportGraph(records: ImportRecord[]): ImportGraph;
+export declare function resolveImport(workspaceRoot: string, sourceFile: string, specifier: string, tsconfigPaths?: TsconfigPaths | null): string | null;
+/** BFS reachability from a set of entry-point files. Returns the reachable set. */
+export declare function reachableFrom(graph: ImportGraph, entryPoints: Iterable<string>): Set<string>;
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/graph/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/graph/import-graph.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0GAA0G;IAC1G,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW,CAarE;AAUD,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,GACnC,MAAM,GAAG,IAAI,CAuCf;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAoB5F"}

package/dist/graph/import-graph.js

@@ -0,0 +1,86 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { resolveTsconfigAlias } from './tsconfig-paths.js';
+export function buildImportGraph(records) {
+    const nodes = new Set();
+    const outgoing = new Map();
+    const incoming = new Map();
+    for (const r of records) {
+        nodes.add(r.source);
+        if (!r.target)
+            continue;
+        nodes.add(r.target);
+        addEdge(outgoing, r.source, r.target);
+        addEdge(incoming, r.target, r.source);
+    }
+    return { nodes, outgoing, incoming };
+}
+function addEdge(map, from, to) {
+    const s = map.get(from) ?? new Set();
+    s.add(to);
+    map.set(from, s);
+}
+// Resolve TS import specifier → workspace-relative path, or null for
+// node_modules / virtual. Tries relative, absolute, then tsconfig paths aliases.
+export function resolveImport(workspaceRoot, sourceFile, specifier, tsconfigPaths) {
+    const sourceAbs = path.isAbsolute(sourceFile)
+        ? sourceFile
+        : path.join(workspaceRoot, sourceFile);
+    // Relative + absolute path resolution path.
+    if (specifier.startsWith('.') || specifier.startsWith('/')) {
+        const baseDir = path.dirname(sourceAbs);
+        const target = specifier.startsWith('/')
+            ? specifier
+            : path.resolve(baseDir, specifier);
+        const candidates = [
+            target,
+            `${target}.ts`,
+            `${target}.tsx`,
+            path.join(target, 'index.ts'),
+            path.join(target, 'index.tsx'),
+            `${target}.d.ts`,
+            path.join(target, 'index.d.ts'),
+        ];
+        if (target.endsWith('.js')) {
+            candidates.push(target.slice(0, -3) + '.ts', target.slice(0, -3) + '.tsx');
+        }
+        for (const c of candidates) {
+            if (fs.existsSync(c) && fs.statSync(c).isFile()) {
+                return path.relative(workspaceRoot, c);
+            }
+        }
+        return null;
+    }
+    // Bare specifier: try tsconfig path aliases (`@/foo`, `~/bar`, `@app/lib`).
+    if (tsconfigPaths) {
+        const hit = resolveTsconfigAlias(tsconfigPaths, specifier);
+        if (hit)
+            return path.relative(workspaceRoot, hit);
+    }
+    return null;
+}
+/** BFS reachability from a set of entry-point files. Returns the reachable set. */
+export function reachableFrom(graph, entryPoints) {
+    const reachable = new Set();
+    const queue = [];
+    for (const e of entryPoints) {
+        if (graph.nodes.has(e) && !reachable.has(e)) {
+            reachable.add(e);
+            queue.push(e);
+        }
+    }
+    while (queue.length > 0) {
+        const cur = queue.shift();
+        const out = graph.outgoing.get(cur);
+        if (!out)
+            continue;
+        for (const next of out) {
+            if (reachable.has(next))
+                continue;
+            reachable.add(next);
+            queue.push(next);
+        }
+    }
+    return reachable;
+}
+//# sourceMappingURL=import-graph.js.map

package/dist/graph/import-graph.js.map

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

package/dist/graph/monorepo-detect.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceConfig } from '../config.js';
+export declare function discoverMonorepoWorkspaces(repoRoot: string): WorkspaceConfig[] | null;
+//# sourceMappingURL=monorepo-detect.d.ts.map

package/dist/graph/monorepo-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-detect.d.ts","sourceRoot":"","sources":["../../src/graph/monorepo-detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,IAAI,CAoFrF"}