@tyroneross/navgator 0.2.2 → 0.10.0

package/dist/enrich/fetchers.js

@@ -0,0 +1,111 @@
+/**
+ * Vendored, dependency-free upstream version fetchers for NavGator.
+ *
+ * Self-contained: uses the global `fetch` (Node ≥18) — no axios, no api-registry
+ * import. These are the ONLY network calls in the enrichment fold, and they run
+ * exclusively on the freshness path (refreshExternal / the external-resolver
+ * agent), never inside scan(). The engine stays offline and deterministic.
+ *
+ * Equivalent to api-registry/src/http.ts's fetchers, re-implemented here so
+ * NavGator carries no cross-plugin dependency.
+ */
+const UA = { 'User-Agent': 'navgator-external-resolver' };
+const TIMEOUT_MS = 8000;
+async function getJson(url, headers = {}) {
+    try {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), TIMEOUT_MS);
+        const res = await fetch(url, { headers: { ...UA, ...headers }, signal: ctrl.signal });
+        clearTimeout(t);
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null; // network failure → caller marks node unresolved
+    }
+}
+/** npm: latest dist-tag + publish time. */
+export async function fetchNpmLatest(pkg) {
+    const data = (await getJson(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`));
+    if (!data?.['dist-tags']?.latest)
+        return null;
+    const version = data['dist-tags'].latest;
+    return {
+        version,
+        released_at: data.time?.[version],
+        docs_url: data.homepage,
+        repo_url: data.repository?.url?.replace(/^git\+/, '').replace(/\.git$/, ''),
+    };
+}
+/** PyPI: latest version + release date. */
+export async function fetchPypiLatest(pkg) {
+    const data = (await getJson(`https://pypi.org/pypi/${encodeURIComponent(pkg)}/json`));
+    const version = data?.info?.version;
+    if (!version)
+        return null;
+    const files = data?.releases?.[version];
+    return {
+        version,
+        released_at: files?.[0]?.upload_time_iso_8601,
+        docs_url: data?.info?.project_urls?.['Documentation'] ??
+            data?.info?.project_urls?.['Homepage'] ??
+            data?.info?.home_page,
+        repo_url: data?.info?.project_urls?.['Source'] ?? data?.info?.project_urls?.['Repository'],
+    };
+}
+/**
+ * GitHub Releases: latest tag + publish date for `owner/repo`.
+ * Used for spm/cargo/go nodes that expose versions via tags, not a registry.
+ * Honors GITHUB_TOKEN when present to avoid the 60/hr unauthenticated limit.
+ */
+export async function fetchGitHubLatest(ownerRepo) {
+    const headers = process.env['GITHUB_TOKEN']
+        ? { Authorization: `Bearer ${process.env['GITHUB_TOKEN']}` }
+        : {};
+    const data = (await getJson(`https://api.github.com/repos/${ownerRepo}/releases/latest`, headers));
+    if (!data?.tag_name)
+        return null;
+    return {
+        version: data.tag_name.replace(/^v/, ''),
+        released_at: data.published_at,
+        docs_url: data.html_url,
+        repo_url: `https://github.com/${ownerRepo}`,
+    };
+}
+/**
+ * crates.io: the highest stable version, falling back to the newest when a
+ * crate has only prereleases. crates.io returns 403 without a User-Agent, which
+ * `getJson` already sends.
+ */
+export async function fetchCratesLatest(pkg) {
+    const data = (await getJson(`https://crates.io/api/v1/crates/${encodeURIComponent(pkg)}`));
+    const crate = data?.crate;
+    if (!crate)
+        return null;
+    const version = crate.max_stable_version || crate.newest_version;
+    if (!version)
+        return null;
+    return {
+        version,
+        released_at: crate.updated_at,
+        docs_url: crate.documentation ?? `https://docs.rs/${pkg}`,
+        repo_url: crate.repository,
+    };
+}
+/** Dispatch by ecosystem. `ref` is a package name, or owner/repo for github. */
+export async function fetchLatest(registry, ref) {
+    switch (registry) {
+        case 'npm':
+            return fetchNpmLatest(ref);
+        case 'pypi':
+            return fetchPypiLatest(ref);
+        case 'github':
+            return fetchGitHubLatest(ref);
+        case 'cargo':
+            return fetchCratesLatest(ref);
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=fetchers.js.map

package/dist/enrich/fetchers.js.map

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

package/dist/entry-points.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Where execution starts.
+ *
+ * Reachability is only as good as the set of roots it starts from, and the
+ * original root set was written for an application: node types `api-endpoint` /
+ * `worker` / `cron` / `xcode-target`, Apple names (`AppDelegate`, `ContentView`,
+ * `SceneDelegate`), and a fallback that treats every `infra` or `external`
+ * component as a root. A TypeScript CLI or library has none of those. Measured
+ * on NavGator's own graph before this module existed: 12 roots, every one of
+ * them from the `infra`/`external` fallback, with a combined out-degree of 17.
+ * External package nodes are graph *sinks* — edges point at them, never out of
+ * them — so the traversal reached 16 of 521 components and `transitively-dead`
+ * reported 425 of 451 project components, about 94%. That is not a finding, it
+ * is the rule failing to find the front door.
+ *
+ * So this module asks the package what its entry points are instead of guessing
+ * from names. The npm manifest already declares them (`bin`, `main`, `module`,
+ * `exports`, `browser`), the scripts block names every file the project's own
+ * tooling runs, and the framework conventions the scanner already resolves
+ * (Next.js `app/` and `pages/` routes) are entry points by definition. Tests and
+ * config files are roots for the same structural reason: nothing imports them.
+ *
+ * **Both kinds of error are unbounded, and they are not symmetric.** A root
+ * seeds a BFS, so getting one wrong moves a whole transitive closure, in either
+ * direction:
+ *
+ *   - A MISSED root reports its entire subtree as dead. That is the failure
+ *     above: 425 findings, all noise, and the rule reads as broken.
+ *   - A SPURIOUS root silently suppresses its entire subtree. Measured on a
+ *     constructed graph: one stale migration script moved from `src/` into
+ *     `bin/` took 7 findings to 0.
+ *
+ * An earlier version of this comment claimed a spurious root "costs at most one
+ * missed dead component" and used that to justify admitting broad conventions.
+ * That was wrong, and the conventions have since been narrowed on the corrected
+ * basis — `hooks/` and `tools/` were dropped for colliding with library
+ * directories, and the Next.js router patterns were anchored to an app root.
+ *
+ * The remaining tie-break still favours admitting a root, because a missed root
+ * produces visible noise a reader will investigate while a spurious one produces
+ * silence nobody notices. That is a reason to keep the root set AUDITABLE, which
+ * is what `EntryPointResult.counts` and `.manifests` are for, not a licence to
+ * admit anything ambiguous.
+ *
+ * Detection is pure with respect to the graph, except for reading `package.json`
+ * files under the project root. No network, no child processes.
+ */
+import type { ArchitectureComponent } from './types.js';
+/** Why a component was treated as a root. Reported so a root is auditable. */
+export type EntryPointSource = 'component-type' | 'name-pattern' | 'tag' | 'infra-layer' | 'package-entry' | 'package-script' | 'package-file' | 'framework-route' | 'test-file' | 'tooling-config' | 'executable-dir';
+export interface EntryPointResult {
+    /** component_id of every root. */
+    ids: Set<string>;
+    /** component_id -> the source that admitted it. First match wins. */
+    reasons: Map<string, EntryPointSource>;
+    /** How many roots each source contributed. */
+    counts: Partial<Record<EntryPointSource, number>>;
+    /** package.json files actually read. */
+    manifests: string[];
+    /**
+     * Manifests that existed but could not be read or parsed. Reported because an
+     * unreadable manifest shrinks the root set back toward the pre-fix failure,
+     * and a shrunken root set is otherwise invisible.
+     */
+    manifest_errors: string[];
+    /** Declared paths pulled out of those manifests, before resolution. */
+    declared: string[];
+}
+export interface EntryPointOptions {
+    /**
+     * Root to resolve manifests against. Defaults to `process.cwd()`, matching
+     * `loadCustomRules`. Manifest reading is skipped when the directory does not
+     * exist, so a synthetic graph simply gets the graph-only sources.
+     */
+    projectRoot?: string;
+    /** Skip filesystem access entirely (graph-derived roots only). */
+    skipManifests?: boolean;
+}
+/** Every file path a component claims, normalised to project-relative POSIX form. */
+export declare function entryCandidatePaths(component: ArchitectureComponent, projectRoot?: string): string[];
+/**
+ * Classify a path against the convention table. Exported so the conventions are
+ * testable without constructing a component graph.
+ */
+export declare function classifyPathConvention(filePath: string): EntryPointSource | null;
+interface DeclaredPath {
+    target: string;
+    source: EntryPointSource;
+}
+/**
+ * Pull declared entry paths out of one parsed package.json. `dir` is the
+ * manifest's directory relative to the project root, so a workspace manifest
+ * yields project-relative targets.
+ */
+export declare function declaredEntryPaths(manifest: unknown, dir?: string): DeclaredPath[];
+/**
+ * Every path a declared target might be authored at. A manifest points at build
+ * output (`dist/cli/index.js`); the graph holds source (`src/cli/index.ts`).
+ */
+export declare function resolveDeclaredTarget(target: string): string[];
+/**
+ * Resolve the root set for a component graph. Declared manifest entries are
+ * matched first so their (more specific) reason survives on shared components.
+ */
+export declare function detectEntryPoints(components: ArchitectureComponent[], options?: EntryPointOptions): EntryPointResult;
+export {};
+//# sourceMappingURL=entry-points.d.ts.map

package/dist/entry-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-points.d.ts","sourceRoot":"","sources":["../src/entry-points.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,cAAc,GACd,KAAK,GACL,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,WAAW,GACX,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAoFD,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,EAAE,CAKV;AAWD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAKhF;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,YAAY,EAAE,CA+D9E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB9D;AA4DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAoFlB"}

package/dist/entry-points.js

@@ -0,0 +1,394 @@
+/**
+ * Where execution starts.
+ *
+ * Reachability is only as good as the set of roots it starts from, and the
+ * original root set was written for an application: node types `api-endpoint` /
+ * `worker` / `cron` / `xcode-target`, Apple names (`AppDelegate`, `ContentView`,
+ * `SceneDelegate`), and a fallback that treats every `infra` or `external`
+ * component as a root. A TypeScript CLI or library has none of those. Measured
+ * on NavGator's own graph before this module existed: 12 roots, every one of
+ * them from the `infra`/`external` fallback, with a combined out-degree of 17.
+ * External package nodes are graph *sinks* — edges point at them, never out of
+ * them — so the traversal reached 16 of 521 components and `transitively-dead`
+ * reported 425 of 451 project components, about 94%. That is not a finding, it
+ * is the rule failing to find the front door.
+ *
+ * So this module asks the package what its entry points are instead of guessing
+ * from names. The npm manifest already declares them (`bin`, `main`, `module`,
+ * `exports`, `browser`), the scripts block names every file the project's own
+ * tooling runs, and the framework conventions the scanner already resolves
+ * (Next.js `app/` and `pages/` routes) are entry points by definition. Tests and
+ * config files are roots for the same structural reason: nothing imports them.
+ *
+ * **Both kinds of error are unbounded, and they are not symmetric.** A root
+ * seeds a BFS, so getting one wrong moves a whole transitive closure, in either
+ * direction:
+ *
+ *   - A MISSED root reports its entire subtree as dead. That is the failure
+ *     above: 425 findings, all noise, and the rule reads as broken.
+ *   - A SPURIOUS root silently suppresses its entire subtree. Measured on a
+ *     constructed graph: one stale migration script moved from `src/` into
+ *     `bin/` took 7 findings to 0.
+ *
+ * An earlier version of this comment claimed a spurious root "costs at most one
+ * missed dead component" and used that to justify admitting broad conventions.
+ * That was wrong, and the conventions have since been narrowed on the corrected
+ * basis — `hooks/` and `tools/` were dropped for colliding with library
+ * directories, and the Next.js router patterns were anchored to an app root.
+ *
+ * The remaining tie-break still favours admitting a root, because a missed root
+ * produces visible noise a reader will investigate while a spurious one produces
+ * silence nobody notices. That is a reason to keep the root set AUDITABLE, which
+ * is what `EntryPointResult.counts` and `.manifests` are for, not a licence to
+ * admit anything ambiguous.
+ *
+ * Detection is pure with respect to the graph, except for reading `package.json`
+ * files under the project root. No network, no child processes.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/** Component types that are entry points by their own definition. */
+const ENTRY_POINT_TYPES = new Set([
+    'api-endpoint',
+    'worker',
+    'cron',
+    'xcode-target',
+]);
+/** Names that mean "application launch point" on Apple and Android platforms. */
+const ENTRY_POINT_NAME_PATTERN = /App$|AppDelegate|@main|ContentView|SceneDelegate|(?:^|[/\\.:#\s_-])Main(?:$|[/\\.:#\s_-])/i;
+const ENTRY_POINT_TAGS = new Set([
+    'entrypoint',
+    'route',
+    'navigation-root',
+]);
+/**
+ * Path shapes that are roots without anything importing them. Ordered: the
+ * first match wins, so the more specific patterns come first.
+ */
+const PATH_CONVENTIONS = [
+    // Test runners discover these; no source file imports them.
+    ['test-file', /(^|\/)__tests__\//],
+    ['test-file', /(^|\/)tests?\//],
+    ['test-file', /\.(test|spec)\.[cm]?[jt]sx?$/],
+    // Next.js routers. Anchored to an app root — `<root>/`, `<workspace>/`, or
+    // either plus `src/` — because that is where Next.js actually looks. Matching
+    // `app/` or `pages/` at ANY depth admits `web/components/pages/Landing.tsx`
+    // and `src/lib/pages/Profile.tsx`, which are ordinary components, and an
+    // entry-point source that admits ordinary components makes dead code there
+    // unreportable.
+    [
+        'framework-route',
+        /^(?:[^/]+\/)?(?:src\/)?app\/(?:.*\/)?(?:page|layout|route|template|default|error|global-error|not-found|loading)\.[cm]?[jt]sx?$/,
+    ],
+    // Pages router: every file under it is addressable as a route.
+    ['framework-route', /^(?:[^/]+\/)?(?:src\/)?pages\/.*\.[cm]?[jt]sx?$/],
+    // Next.js loads these by fixed name at the app root.
+    ['framework-route', /^(?:[^/]+\/)?(?:src\/)?(?:middleware|instrumentation)\.[cm]?[jt]s$/],
+    // Loaded by a tool (vitest, next, tailwind, postcss, eslint), not imported.
+    ['tooling-config', /(^|\/)[\w.-]*\.config\.[cm]?[jt]sx?$/],
+    // Run directly by a human or by CI.
+    //
+    // `scripts/` and `bin/` only. `hooks/` and `tools/` were here and were removed
+    // after measurement: `hooks/` is the near-universal React custom-hook
+    // convention and was admitting 16 library modules in this repo alone
+    // (`web/hooks/`, `web/lib/hooks/`), and `tools/` is just as often a library
+    // directory. Depth-anchoring does not separate them — `web/hooks/` sits one
+    // segment deep exactly like a workspace's `packages/api/scripts/`. An
+    // entry-point source that admits ordinary library code makes dead code in that
+    // directory permanently invisible, which is the failure this module exists to
+    // fix, pointed the other way.
+    ['executable-dir', /(^|\/)(scripts|bin)\//],
+];
+/** Extensions a declared `.js` path may actually be authored in. */
+const SOURCE_EXTENSIONS = [
+    '.ts',
+    '.tsx',
+    '.mts',
+    '.cts',
+    '.jsx',
+    '.js',
+    '.mjs',
+    '.cjs',
+];
+/** Compiled-output directories a declared path may point into. */
+const OUTPUT_DIR_PATTERN = /^(dist|build|lib|out)\//;
+const NESTED_OUTPUT_DIR_PATTERN = /^(.*?\/)(dist|build|lib|out)\/(.*)$/;
+/** A token inside an npm script that looks like a path to a code file. */
+const SCRIPT_PATH_TOKEN = /^[A-Za-z0-9_.@][A-Za-z0-9_.@/-]*\.[cm]?[jt]sx?$/;
+/** Cap on manifests read, so a repo full of packages cannot turn this into a walk. */
+const MAX_MANIFESTS = 32;
+/** Nesting cap on the `exports` condition map. */
+const EXPORTS_MAX_DEPTH = 8;
+/** Every file path a component claims, normalised to project-relative POSIX form. */
+export function entryCandidatePaths(component, projectRoot) {
+    const raw = [...(component.source?.config_files ?? [])];
+    const metaFile = component.metadata?.['file'];
+    if (typeof metaFile === 'string')
+        raw.push(metaFile);
+    return raw.map((p) => normalizePath(p, projectRoot));
+}
+function normalizePath(filePath, projectRoot) {
+    let out = filePath.replace(/\\/g, '/');
+    if (projectRoot) {
+        const root = projectRoot.replace(/\\/g, '/').replace(/\/+$/, '');
+        if (root && out.startsWith(`${root}/`))
+            out = out.slice(root.length + 1);
+    }
+    return out.replace(/^\.\//, '').replace(/^\/+/, '');
+}
+/**
+ * Classify a path against the convention table. Exported so the conventions are
+ * testable without constructing a component graph.
+ */
+export function classifyPathConvention(filePath) {
+    for (const [source, pattern] of PATH_CONVENTIONS) {
+        if (pattern.test(filePath))
+            return source;
+    }
+    return null;
+}
+/**
+ * Pull declared entry paths out of one parsed package.json. `dir` is the
+ * manifest's directory relative to the project root, so a workspace manifest
+ * yields project-relative targets.
+ */
+export function declaredEntryPaths(manifest, dir = '') {
+    if (!manifest || typeof manifest !== 'object')
+        return [];
+    const pkg = manifest;
+    const out = [];
+    const add = (value, source) => {
+        if (typeof value !== 'string' || value.length === 0)
+            return;
+        if (value.includes('*'))
+            return;
+        const rel = value.replace(/^\.\//, '');
+        if (rel.startsWith('/') || rel.split('/').includes('..'))
+            return;
+        out.push({ target: dir ? `${dir}/${rel}` : rel, source });
+    };
+    // The published API surface.
+    add(pkg['main'], 'package-entry');
+    add(pkg['module'], 'package-entry');
+    add(pkg['browser'], 'package-entry');
+    if (typeof pkg['bin'] === 'string')
+        add(pkg['bin'], 'package-entry');
+    else if (pkg['bin'] && typeof pkg['bin'] === 'object') {
+        for (const value of Object.values(pkg['bin'])) {
+            add(value, 'package-entry');
+        }
+    }
+    // Depth-capped: `exports` is arbitrary nested JSON from a file this code did
+    // not write, and an unbounded walk over it is a stack-overflow surface for no
+    // benefit — real condition maps are two or three levels deep.
+    const walkExports = (node, depth) => {
+        if (depth > EXPORTS_MAX_DEPTH)
+            return;
+        if (typeof node === 'string')
+            add(node, 'package-entry');
+        else if (node && typeof node === 'object') {
+            for (const [key, value] of Object.entries(node)) {
+                // `types` points at a .d.ts; it declares no runtime entry.
+                if (key === 'types')
+                    continue;
+                walkExports(value, depth + 1);
+            }
+        }
+    };
+    walkExports(pkg['exports'], 0);
+    // Every file the project's own tooling runs. `npm run mcp` -> `node
+    // dist/mcp/server.js` is the only declaration that `src/mcp/server.ts` is an
+    // entry point at all; nothing imports it.
+    if (pkg['scripts'] && typeof pkg['scripts'] === 'object') {
+        for (const command of Object.values(pkg['scripts'])) {
+            if (typeof command !== 'string')
+                continue;
+            for (const token of command.split(/[\s'"`;=(),]+/)) {
+                if (SCRIPT_PATH_TOKEN.test(token))
+                    add(token, 'package-script');
+            }
+        }
+    }
+    // Explicitly named files in the publish allowlist. A file listed there that
+    // nothing imports still ships, so it is part of the package surface —
+    // `web/server.cjs` is spawned as a child process, an edge no import graph
+    // carries. Directory entries are skipped: they would admit whole trees.
+    if (Array.isArray(pkg['files'])) {
+        for (const entry of pkg['files']) {
+            if (typeof entry !== 'string')
+                continue;
+            if (!/\.[A-Za-z0-9]+$/.test(entry))
+                continue;
+            add(entry, 'package-file');
+        }
+    }
+    return out;
+}
+/**
+ * Every path a declared target might be authored at. A manifest points at build
+ * output (`dist/cli/index.js`); the graph holds source (`src/cli/index.ts`).
+ */
+export function resolveDeclaredTarget(target) {
+    const bases = new Set([target]);
+    bases.add(target.replace(OUTPUT_DIR_PATTERN, ''));
+    bases.add(`src/${target.replace(OUTPUT_DIR_PATTERN, '')}`);
+    const nested = target.match(NESTED_OUTPUT_DIR_PATTERN);
+    if (nested) {
+        bases.add(`${nested[1]}${nested[3]}`);
+        bases.add(`${nested[1]}src/${nested[3]}`);
+    }
+    const out = new Set(bases);
+    for (const base of bases) {
+        const stem = base.replace(/\.[cm]?[jt]sx?$/, '');
+        for (const ext of SOURCE_EXTENSIONS) {
+            out.add(`${stem}${ext}`);
+            out.add(`${stem}/index${ext}`);
+        }
+    }
+    return [...out];
+}
+/**
+ * Directories holding a package.json worth reading: the project root plus each
+ * distinct `metadata.origin_root` the multi-stack scan recorded. Anything that
+ * escapes the project root is dropped rather than followed.
+ */
+function manifestDirs(components, projectRoot) {
+    const dirs = new Set(['']);
+    for (const component of components) {
+        const origin = component.metadata?.['origin_root'];
+        if (typeof origin !== 'string' || origin.length === 0)
+            continue;
+        const rel = normalizePath(origin, projectRoot);
+        if (rel.startsWith('/') || rel.split('/').includes('..'))
+            continue;
+        dirs.add(rel);
+        if (dirs.size >= MAX_MANIFESTS)
+            break;
+    }
+    return [...dirs];
+}
+/**
+ * Read one manifest, refusing to leave the project root.
+ *
+ * Containment is checked against REAL paths, not lexical ones. A lexical prefix
+ * compare passes a symlink inside the root that points outside it, so the
+ * "anything that escapes is dropped" guarantee above would have been false for
+ * exactly the case a repo is most likely to contain — a convenience link to a
+ * sibling checkout.
+ *
+ * `absent` and `unreadable` are distinct results. An absent manifest is the
+ * normal case for most directories; an unreadable or malformed one silently
+ * shrinks the root set back toward the pre-fix failure, so it is counted and
+ * reported rather than swallowed.
+ */
+function readManifest(projectRoot, dir) {
+    const manifestPath = path.resolve(projectRoot, dir, 'package.json');
+    if (!fs.existsSync(manifestPath))
+        return { status: 'absent' };
+    let realManifest;
+    let realRoot;
+    try {
+        realManifest = fs.realpathSync(manifestPath);
+        realRoot = fs.realpathSync(path.resolve(projectRoot));
+    }
+    catch {
+        return { status: 'unreadable' };
+    }
+    if (realManifest !== realRoot && !realManifest.startsWith(`${realRoot}${path.sep}`)) {
+        return { status: 'absent' };
+    }
+    try {
+        return { status: 'ok', manifest: JSON.parse(fs.readFileSync(realManifest, 'utf-8')) };
+    }
+    catch {
+        return { status: 'unreadable' };
+    }
+}
+/**
+ * Resolve the root set for a component graph. Declared manifest entries are
+ * matched first so their (more specific) reason survives on shared components.
+ */
+export function detectEntryPoints(components, options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const reasons = new Map();
+    const declared = [];
+    const manifests = [];
+    const manifestErrors = [];
+    const idsByPath = new Map();
+    for (const component of components) {
+        for (const filePath of entryCandidatePaths(component, projectRoot)) {
+            const list = idsByPath.get(filePath);
+            if (list)
+                list.push(component.component_id);
+            else
+                idsByPath.set(filePath, [component.component_id]);
+        }
+    }
+    if (!options.skipManifests) {
+        for (const dir of manifestDirs(components, projectRoot)) {
+            const read = readManifest(projectRoot, dir);
+            if (read.status === 'absent')
+                continue;
+            const label = dir ? `${dir}/package.json` : 'package.json';
+            if (read.status === 'unreadable') {
+                manifestErrors.push(label);
+                continue;
+            }
+            manifests.push(label);
+            for (const { target, source } of declaredEntryPaths(read.manifest, dir)) {
+                declared.push(target);
+                for (const candidate of resolveDeclaredTarget(target)) {
+                    for (const id of idsByPath.get(candidate) ?? []) {
+                        if (!reasons.has(id))
+                            reasons.set(id, source);
+                    }
+                }
+            }
+        }
+    }
+    for (const component of components) {
+        if (reasons.has(component.component_id))
+            continue;
+        if (ENTRY_POINT_TYPES.has(component.type)) {
+            reasons.set(component.component_id, 'component-type');
+            continue;
+        }
+        if (ENTRY_POINT_NAME_PATTERN.test(component.name)) {
+            reasons.set(component.component_id, 'name-pattern');
+            continue;
+        }
+        if (component.tags?.some((tag) => ENTRY_POINT_TAGS.has(tag))) {
+            reasons.set(component.component_id, 'tag');
+            continue;
+        }
+        let matched = null;
+        for (const filePath of entryCandidatePaths(component, projectRoot)) {
+            matched = classifyPathConvention(filePath);
+            if (matched)
+                break;
+        }
+        if (matched) {
+            reasons.set(component.component_id, matched);
+            continue;
+        }
+        // Kept from the original rule: infra and external nodes are not code this
+        // project is asked to keep alive. They are sinks, so admitting them costs
+        // almost nothing, but removing them would newly flag whatever they touch.
+        if (component.role.layer === 'infra' || component.role.layer === 'external') {
+            reasons.set(component.component_id, 'infra-layer');
+        }
+    }
+    const counts = {};
+    for (const source of reasons.values()) {
+        counts[source] = (counts[source] ?? 0) + 1;
+    }
+    return {
+        ids: new Set(reasons.keys()),
+        reasons,
+        counts,
+        manifests,
+        manifest_errors: manifestErrors,
+        declared,
+    };
+}
+//# sourceMappingURL=entry-points.js.map

package/dist/entry-points.js.map

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