@backthread/extractor 0.1.0

package/dist/infra/types.d.ts

@@ -0,0 +1,151 @@
+import type { EdgeKind, InfraModuleKind, NodeProvenance } from '../types.js';
+/**
+ * A discovery surface for one infra provider. Implementations live next to
+ * their parser (e.g. scripts/ingest/infra/cf/, scripts/ingest/infra/supabase/).
+ *
+ * `detect()` is cheap — a file-existence check (does `wrangler.toml` exist?
+ * does `supabase/config.toml` exist?). It runs first against every registered
+ * adapter, and only `detect()`-positive adapters get `extract()`-ed.
+ *
+ * `extract()` is deterministic parsing — read the config, walk its
+ * declarations, emit nodes/edges. The LLM never enters this path; the only
+ * LLM-touched layer is `classificationsNeeded` (queued for  to label).
+ */
+export interface InfraAdapter {
+    readonly name: string;
+    detect(repoDir: string): Promise<boolean>;
+    extract(repoDir: string): Promise<InfraGraph>;
+    /**
+     * does this adapter read application SOURCE (not just config/IaC)?
+     *
+     * Most adapters parse only config/IaC files (wrangler.toml, .tf), so the
+     * diff-driven hosted walk (container.ts) can safely CARRY their graph across
+     * a checkpoint whose diff touched no infra-config path. But a source-grep
+     * adapter (Supabase greps `.from(`/`.auth`/… in `.ts`/`.tsx`/…; Vercel reads
+     * App-Router route handlers, `pages/api` files, and `middleware.ts`) derives
+     * nodes/edges from ordinary source — so a `supabase.from(...)` added in plain
+     * `src` MUST force an infra re-extract, or the carried graph goes stale.
+     *
+     * An adapter that scans source declares `scansSourcePath(p)` returning true
+     * for any repo-relative path whose CONTENT it greps/reads. The relevance
+     * gate (relevance.ts) ORs these predicates (for the adapters whose detect()
+     * is positive on the current tree) into its carry/re-extract decision.
+     * Config-only adapters omit it and keep the carry optimization untouched.
+     *
+     * Returns true ⇒ "a change to this path could change my output" → re-extract.
+     */
+    scansSourcePath?(path: string): boolean;
+}
+/**
+ * An infra node. Mirrors the code-side Module from src/types but lives in
+ * its own namespace until the merge step joins them — keeps the contracts
+ * decoupled while /8/9 land in parallel.
+ *
+ * `id` is unique WITHIN the emitting adapter's output. The registry's merge
+ * step uses (adapter, id) as the natural key, then prefixes external-facing
+ * ids with the adapter name (e.g. `cloudflare:queues_consumer:ingest-jobs`)
+ * so cross-adapter merges don't collide on common short names like 'main'.
+ */
+export interface InfraNode {
+    id: string;
+    label: string;
+    kind: InfraModuleKind;
+    /**
+     * Where this classification came from. The merge step uses this to resolve
+     * conflicts: `declared` wins over `inferred` wins over `llm-classified`.
+     * If two adapters both `declared` the same node, the first-registered
+     * adapter (= more-specific provider, see registry.ts) wins.
+     */
+    provenance: NodeProvenance;
+    /**
+     * Adapter-specific shape — what config file declared this node, what
+     * binding name it carries inside wrangler.toml, the Terraform module
+     * path, etc. Not consumed by the renderer; useful for `view source`
+     * tooltips and debug dumps. Keep small (< ~500 bytes) so JSONB-tax stays
+     * negligible.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * repo-relative directory prefixes whose code THIS artifact deploys
+     * — the deployment-target signal read from IaaC config (a worker's config dir,
+     * a container's Dockerfile build context, a Pages/Vite SPA's source dir, a
+     * Supabase function's dir). Only DEPLOYABLE artifacts that run your own code
+     * set this (worker / static-site / container); datastores, queues, and
+     * external-apis don't run your code and leave it absent. The assemble step
+     * attributes each code module to the unit whose source root is the longest
+     * prefix of its files (`scripts/ingest/assemble/zones.ts`). Repo-relative,
+     * normalized (no leading `./`, no trailing `/`); survives the registry merge
+     * unprefixed (only ids are namespaced).
+     */
+    sourceRoots?: string[];
+}
+/**
+ * An infra-to-infra edge. Uses the same 8-verb EdgeKind taxonomy as the
+ * code graph — there is no separate "infra edge kind." A CF Worker
+ * `writes` to a D1 Datastore the same way an internal `users` service
+ * `writes` to a `db` module. The merge step zips these into the unified
+ * graph the renderer reads.
+ *
+ * `source`/`target` may also reference CODE modules (post-merge), so the
+ * type stays string rather than InfraNode['id']. `mergeInfraGraphs` does NOT
+ * reject unresolved endpoints — an endpoint that isn't a known infra node is
+ * left untouched as a cross-graph-join hint (a Terraform `depends_on` may
+ * legitimately point at a code module the join step binds later). Once the
+ * full id space is known, `validateMergedGraph` (registry.ts) flags any
+ * endpoint that still doesn't resolve — that's the validation gate, not merge.
+ */
+export interface InfraEdge {
+    source: string;
+    target: string;
+    kind: EdgeKind;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Resource-types the adapter found but does NOT know how to classify into
+ * an InfraModuleKind on its own. The registry collects these from every
+ * adapter, dedupes, and runs them through 's classifyResourceTypes()
+ * before merging — so the final InfraGraph has every node's `kind`
+ * decided by either the adapter (declared) or the LLM cache
+ * (llm-classified).
+ *
+ * Adapters with a tight static mapping (CF: `wrangler.toml` `[[queues]]`
+ * → `queue`) emit nothing here. Adapters parsing open-ended IaC (Terraform
+ * HCL with arbitrary `resource "aws_*"` blocks) emit one entry per unique
+ * unclassified `(provider, resource_type)` pair.
+ */
+export interface ClassificationRef {
+    provider: string;
+    resourceType: string;
+    /**
+     * The InfraNode.id this classification will populate once resolved. The
+     * registry rewrites the corresponding node's `kind` + `provenance` after
+     * returns.
+     */
+    forNodeId: string;
+}
+/**
+ * One adapter's view of the repo's infrastructure. The registry's
+ * `mergeInfraGraphs` consumes an array of these.
+ */
+export interface InfraGraph {
+    /** Absolute repo dir the graph was extracted from (provenance). */
+    root: string;
+    /** Mirror of the producing adapter's `name`. */
+    adapter: string;
+    nodes: InfraNode[];
+    edges: InfraEdge[];
+    classificationsNeeded: ClassificationRef[];
+}
+/**
+ * The output of merging every adapter's InfraGraph into one. Same shape as
+ * InfraGraph minus the per-adapter `adapter` field; nodes/edges carry their
+ * adapter-prefixed ids.
+ */
+export interface MergedInfraGraph {
+    root: string;
+    nodes: InfraNode[];
+    edges: InfraEdge[];
+    /** Pass-through to the  classifier; populated nodes update in-place. */
+    classificationsNeeded: ClassificationRef[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/infra/types.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAKrB;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAKD;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB;;;;;OAKG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,wEAAwE;IACxE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;CAC5C"}

package/dist/infra/types.js

@@ -0,0 +1,14 @@
+// the InfraAdapter contract.
+//
+// Mirrors the GraphExtractor seam (/325) on the code-extraction side:
+// every infra-discovery surface targets this normalized shape, and every
+// downstream layer ( salience scoring,  ELK layout, the diagram
+// renderer) consumes the merged InfraGraph + code NormalizedGraph as one.
+// New providers (Vercel, Fly, Render, OpenTofu, AWS-native, GCP-native;
+// tracked under ) are an ADDITIVE adapter, never a reshape.
+//
+// Why interface-only here:  /  /  implement the three v0
+// adapters (CF, Supabase, Terraform); 's 10 expansion children
+// implement everything else. Freezing this contract before those land
+// keeps the parallel-agent fan-out safe.
+//# sourceMappingURL=types.js.map

package/dist/infra/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/infra/types.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AACzE,gEAAgE;AAChE,0EAA0E;AAC1E,wEAAwE;AACxE,4DAA4D;AAC5D,EAAE;AACF,yDAAyD;AACzD,+DAA+D;AAC/D,sEAAsE;AACtE,yCAAyC"}

package/dist/infra/vercel/vercel-parse.d.ts

@@ -0,0 +1,70 @@
+export interface VercelConfig {
+    /** From vercel.json `framework` field */
+    framework?: string;
+    /** From vercel.json `regions` array (strings like 'iad1') */
+    regions?: string[];
+    /** Per-function overrides: key = route glob e.g. "api/large.js" */
+    functions?: Record<string, VercelFunctionConfig>;
+    /** Cron schedules: each entry names a path the cron invokes */
+    crons?: VercelCronConfig[];
+    /** Rewrites array (for annotation / metadata only, not topology) */
+    rewrites?: VercelRewrite[];
+    /** Headers array (for annotation only) */
+    headers?: VercelHeader[];
+}
+export interface VercelFunctionConfig {
+    runtime?: string;
+    memory?: number;
+    maxDuration?: number;
+    regions?: string[];
+}
+export interface VercelCronConfig {
+    path: string;
+    schedule: string;
+}
+export interface VercelRewrite {
+    source: string;
+    destination: string;
+}
+export interface VercelHeader {
+    source: string;
+    headers?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+export interface PackageInfo {
+    name?: string;
+    /** True if any of the known Vercel-deployable framework deps are present */
+    detectedFramework?: FrameworkName;
+    /** True if `vercel` or `@vercel/*` packages appear in deps/devDeps */
+    hasVercelDep: boolean;
+}
+export type FrameworkName = 'next' | 'nuxt' | 'sveltekit' | 'astro' | 'remix';
+/**
+ * The output mode from next.config.*:
+ *   'export'     → purely static (SSG / export output; no serverless)
+ *   'standalone' → serverless with a self-contained server bundle
+ *   'serverless' → legacy Next.js serverless mode
+ *   undefined    → not set / could not parse (default Vercel serverless)
+ */
+export type NextOutputMode = 'export' | 'standalone' | 'serverless' | undefined;
+/**
+ * Parse a vercel.json (JSONC-tolerant). Returns an empty object if the text
+ * is blank or unparseable — callers rely on graceful degradation.
+ */
+export declare function parseVercelJson(text: string): VercelConfig;
+/**
+ * Parse package.json to extract the app name, framework, and Vercel dep presence.
+ * Tolerates malformed or empty inputs without throwing.
+ */
+export declare function parsePackageJson(text: string): PackageInfo;
+export declare function parseNextConfigOutputMode(text: string): NextOutputMode;
+export declare function routeFileToPath(repoRelPath: string): string;
+/**
+ * Derive a human-readable label from a route path.
+ *   /api/users/[id] → "api/users/[id]"
+ *   /              → "middleware"
+ */
+export declare function routePathToLabel(routePath: string, isMiddleware?: boolean): string;
+//# sourceMappingURL=vercel-parse.d.ts.map

package/dist/infra/vercel/vercel-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-parse.d.ts","sourceRoot":"","sources":["../../../src/infra/vercel/vercel-parse.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACjD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,sEAAsE;IACtE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAKhF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2D1D;AAgBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CA8B1D;AAcD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAatE;AAYD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAsB3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,MAAM,CAGhF"}

package/dist/infra/vercel/vercel-parse.js

@@ -0,0 +1,194 @@
+// Vercel config + route parsing utilities.
+//
+// Pure parsing functions separated from fs IO so they can be unit-tested with
+// inline inputs without a real repo. Handles:
+//   - vercel.json  → functions, crons, regions, rewrites, headers, framework
+//   - package.json → framework detection, app name, Vercel-related deps
+//   - next.config.*  → output mode detection (static / standalone / serverless)
+//   - API route file paths → route path derivation
+//
+// Dependency-free (no npm deps beyond what's already vendored). Reuses
+// parseJsonc from the cloudflare adapter for JSON-with-comments/trailing-comma
+// tolerance.
+import { parseJsonc } from '../cloudflare/wrangler-parse.js';
+// ---------------------------------------------------------------------------
+// vercel.json parser.
+/**
+ * Parse a vercel.json (JSONC-tolerant). Returns an empty object if the text
+ * is blank or unparseable — callers rely on graceful degradation.
+ */
+export function parseVercelJson(text) {
+    if (!text.trim())
+        return {};
+    let raw;
+    try {
+        raw = parseJsonc(text);
+    }
+    catch {
+        throw new Error(`vercel.json: invalid JSON — ${text.slice(0, 80)}`);
+    }
+    const out = {};
+    if (typeof raw.framework === 'string')
+        out.framework = raw.framework;
+    if (Array.isArray(raw.regions)) {
+        out.regions = raw.regions.filter((r) => typeof r === 'string');
+    }
+    if (raw.functions && typeof raw.functions === 'object' && !Array.isArray(raw.functions)) {
+        out.functions = {};
+        for (const [key, val] of Object.entries(raw.functions)) {
+            if (!val || typeof val !== 'object')
+                continue;
+            const v = val;
+            const fc = {};
+            if (typeof v.runtime === 'string')
+                fc.runtime = v.runtime;
+            if (typeof v.memory === 'number')
+                fc.memory = v.memory;
+            if (typeof v.maxDuration === 'number')
+                fc.maxDuration = v.maxDuration;
+            if (Array.isArray(v.regions))
+                fc.regions = v.regions.filter((r) => typeof r === 'string');
+            out.functions[key] = fc;
+        }
+    }
+    if (Array.isArray(raw.crons)) {
+        out.crons = raw.crons.flatMap((c) => {
+            if (!c || typeof c !== 'object')
+                return [];
+            const cc = c;
+            if (typeof cc.path !== 'string' || typeof cc.schedule !== 'string')
+                return [];
+            return [{ path: cc.path, schedule: cc.schedule }];
+        });
+    }
+    if (Array.isArray(raw.rewrites)) {
+        out.rewrites = raw.rewrites.flatMap((r) => {
+            if (!r || typeof r !== 'object')
+                return [];
+            const rr = r;
+            if (typeof rr.source !== 'string' || typeof rr.destination !== 'string')
+                return [];
+            return [{ source: rr.source, destination: rr.destination }];
+        });
+    }
+    if (Array.isArray(raw.headers)) {
+        out.headers = raw.headers.flatMap((h) => {
+            if (!h || typeof h !== 'object')
+                return [];
+            const hh = h;
+            if (typeof hh.source !== 'string')
+                return [];
+            return [{ source: hh.source }];
+        });
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// package.json parser.
+const FRAMEWORK_DEPS = {
+    next: 'next',
+    nuxt: 'nuxt',
+    '@nuxt/core': 'nuxt',
+    '@sveltejs/kit': 'sveltekit',
+    astro: 'astro',
+    '@remix-run/react': 'remix',
+    '@remix-run/node': 'remix',
+    '@remix-run/server-runtime': 'remix',
+};
+/**
+ * Parse package.json to extract the app name, framework, and Vercel dep presence.
+ * Tolerates malformed or empty inputs without throwing.
+ */
+export function parsePackageJson(text) {
+    if (!text.trim())
+        return { hasVercelDep: false };
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`package.json: invalid JSON`);
+    }
+    const info = { hasVercelDep: false };
+    if (typeof raw.name === 'string' && raw.name)
+        info.name = raw.name;
+    const allDeps = {
+        ...(raw.dependencies ?? {}),
+        ...(raw.devDependencies ?? {}),
+        ...(raw.peerDependencies ?? {}),
+    };
+    for (const [dep, framework] of Object.entries(FRAMEWORK_DEPS)) {
+        if (dep in allDeps) {
+            info.detectedFramework = framework;
+            break;
+        }
+    }
+    info.hasVercelDep = Object.keys(allDeps).some((dep) => dep === 'vercel' || dep.startsWith('@vercel/'));
+    return info;
+}
+// ---------------------------------------------------------------------------
+// next.config.* output-mode heuristic.
+//
+// We deliberately do NOT execute or import the config file (security +
+// complexity). A light regex over the raw text is sufficient for the
+// common patterns:
+//   output: 'export'      → static export
+//   output: "standalone"  → standalone server bundle
+//   output: 'serverless'  → legacy serverless mode
+// Any other value (including "undefined" / absent) maps to `undefined` (the
+// default Vercel serverless/ISR behaviour).
+export function parseNextConfigOutputMode(text) {
+    // Strip line comments (// ...) and block comments (/* ... */) before
+    // matching, so a commented-out `// output: 'export'` is not picked up as
+    // the active output mode.
+    const stripped = text
+        .replace(/\/\*[\s\S]*?\*\//g, '') // block comments
+        .replace(/\/\/[^\n]*/g, ''); // line comments
+    const m = stripped.match(/\boutput\s*:\s*['"]([^'"]+)['"]/);
+    if (!m)
+        return undefined;
+    const val = m[1];
+    if (val === 'export' || val === 'standalone' || val === 'serverless')
+        return val;
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// API route file-path → route path derivation.
+//
+// Vercel/Next.js conventions:
+//   pages/api/users/[id].ts  → /api/users/[id]
+//   app/api/users/route.ts   → /api/users
+//   middleware.ts            → / (edge middleware, intercepts all routes)
+//
+// The returned routePath is the canonical URL-path string used as the node id.
+export function routeFileToPath(repoRelPath) {
+    // Normalise path separators.
+    const p = repoRelPath.replace(/\\/g, '/');
+    // middleware.ts / middleware.js at the root (or inside src/).
+    if (/^(?:src\/)?middleware\.[jt]sx?$/.test(p))
+        return '/';
+    // pages/api/** → /api/...
+    const pagesApi = p.match(/^(?:src\/)?pages\/api\/(.+)\.[jt]sx?$/);
+    if (pagesApi) {
+        return `/api/${pagesApi[1]}`;
+    }
+    // app/**/route.ts → derive path from directory
+    const appRoute = p.match(/^(?:src\/)?app\/(.+?)\/route\.[jt]sx?$/);
+    if (appRoute) {
+        // Strip trailing /route if the segment is literally "route"
+        return `/${appRoute[1]}`;
+    }
+    // Fallback: return the path as-is (caller will use it as an id).
+    return `/${p}`;
+}
+/**
+ * Derive a human-readable label from a route path.
+ *   /api/users/[id] → "api/users/[id]"
+ *   /              → "middleware"
+ */
+export function routePathToLabel(routePath, isMiddleware = false) {
+    if (isMiddleware || routePath === '/')
+        return 'middleware';
+    return routePath.replace(/^\//, '');
+}
+//# sourceMappingURL=vercel-parse.js.map

package/dist/infra/vercel/vercel-parse.js.map

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

package/dist/infra/vercel/vercel.d.ts

@@ -0,0 +1,30 @@
+import type { InfraAdapter, InfraGraph } from '../types.js';
+import { type VercelConfig, type PackageInfo, type NextOutputMode } from './vercel-parse.js';
+export interface VercelProjectInputs {
+    /** Absolute path of this deployment root within the repo. */
+    projectDir: string;
+    /** Repo-relative path to vercel.json (or undefined if absent). */
+    vercelJsonPath?: string;
+    /** Parsed vercel.json (if present and valid). */
+    vercelConfig?: VercelConfig;
+    /** Parsed package.json (if present and valid). */
+    packageInfo?: PackageInfo;
+    /** Output mode from next.config.* (if present). */
+    nextOutputMode?: NextOutputMode;
+    /** Repo-relative paths to API route files. */
+    routeFiles: string[];
+    /**
+     * does `<projectDir>/src` exist? Used as the app's source-root
+     * fallback when the project sits at the repo root (so we never emit '' — a
+     * catch-all that swallows sibling units), mirroring the netlify base→root guard.
+     */
+    srcExists?: boolean;
+}
+/**
+ * Build an InfraGraph from already-collected Vercel project inputs.
+ * Separated from fs IO so it can be unit-tested with synthetic inputs.
+ */
+export declare function buildVercelGraph(inputs: VercelProjectInputs[], root: string): InfraGraph;
+export declare function vercelScansSourcePath(path: string): boolean;
+export declare const vercelAdapter: InfraAdapter;
+//# sourceMappingURL=vercel.d.ts.map

package/dist/infra/vercel/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/infra/vercel/vercel.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,YAAY,EAAa,UAAU,EAAa,MAAM,aAAa,CAAC;AAElF,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AA8I3B,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kDAAkD;IAClD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mDAAmD;IACnD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAwFD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAoKxF;AAmFD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM3D;AAKD,eAAO,MAAM,aAAa,EAAE,YA4C3B,CAAC"}