@n-dx/core 0.1.0

package/packages/sourcevision/dist/analyzers/route-detection.js

@@ -0,0 +1,316 @@
+/**
+ * Route detection for React Router v7 / Remix.
+ * File-based route pattern parsing, config-based route parsing,
+ * and route tree construction.
+ */
+import { join, relative, extname } from "node:path";
+import { existsSync } from "node:fs";
+import ts from "typescript";
+import { toPosix } from "../util/paths.js";
+// ── Known convention export names ──────────────────────────────────────────
+export const ROUTE_EXPORT_NAMES = new Set([
+    "loader",
+    "action",
+    "meta",
+    "links",
+    "headers",
+    "ErrorBoundary",
+    "shouldRevalidate",
+    "handle",
+    "HydrateFallback",
+]);
+// ── parseFileRoutePattern ───────────────────────────────────────────────────
+export function parseFileRoutePattern(filePath, routesDir) {
+    // filePath should be relative to routesDir
+    let rel = toPosix(relative(routesDir, filePath));
+    if (rel.startsWith(".."))
+        return null;
+    // Remove extension
+    const ext = extname(rel);
+    rel = rel.slice(0, -ext.length);
+    // Handle index routes
+    if (rel === "_index" || rel === "index")
+        return "/";
+    // Split on dots (Remix flat-file convention: a.b.c → /a/b/c)
+    const dotSegments = rel.split(".");
+    // Remove trailing "_index" segment (e.g. users._index → /users)
+    if (dotSegments[dotSegments.length - 1] === "_index") {
+        dotSegments.pop();
+    }
+    const pathSegments = [];
+    let isLayout = false;
+    for (let i = 0; i < dotSegments.length; i++) {
+        let seg = dotSegments[i];
+        // Leading underscore = pathless layout (e.g. _auth → no path segment)
+        if (seg.startsWith("_") && i === 0) {
+            isLayout = true;
+            continue;
+        }
+        // Trailing underscore escape: $id_ means the param doesn't create nesting
+        if (seg.endsWith("_") && seg.length > 1) {
+            seg = seg.slice(0, -1);
+        }
+        // Dynamic segments: $param → :param
+        if (seg.startsWith("$")) {
+            if (seg === "$") {
+                // Splat/catch-all
+                pathSegments.push("*");
+            }
+            else {
+                const paramName = seg.slice(1);
+                pathSegments.push(`:${paramName}`);
+            }
+            continue;
+        }
+        // Optional segments: ($param) → :param?
+        if (seg.startsWith("(") && seg.endsWith(")")) {
+            const inner = seg.slice(1, -1);
+            if (inner.startsWith("$")) {
+                pathSegments.push(`:${inner.slice(1)}?`);
+            }
+            else {
+                pathSegments.push(inner);
+            }
+            continue;
+        }
+        // Splat catch-all: [...] → *
+        if (seg === "[...]") {
+            pathSegments.push("*");
+            continue;
+        }
+        pathSegments.push(seg);
+    }
+    if (isLayout && pathSegments.length === 0) {
+        return null; // pathless layout has no route pattern of its own
+    }
+    return "/" + pathSegments.join("/");
+}
+// ── buildRouteTree ──────────────────────────────────────────────────────────
+export function buildRouteTree(routeModules) {
+    // Build parent→children map
+    const childrenOf = new Map();
+    for (const mod of routeModules) {
+        const parent = mod.parentLayout;
+        if (!childrenOf.has(parent))
+            childrenOf.set(parent, []);
+        childrenOf.get(parent).push(mod);
+    }
+    const cmp = (a, b) => a.routePattern < b.routePattern ? -1 : a.routePattern > b.routePattern ? 1 : 0;
+    function buildNodes(parentFile) {
+        const children = childrenOf.get(parentFile) || [];
+        const nodes = [];
+        for (const m of children) {
+            if (m.routePattern !== null) {
+                // Routed module — becomes a tree node with its own children
+                nodes.push({
+                    file: m.file,
+                    routePattern: m.routePattern,
+                    children: buildNodes(m.file).sort(cmp),
+                });
+            }
+            else {
+                // Pathless layout (null pattern) — promote its children to this level
+                nodes.push(...buildNodes(m.file));
+            }
+        }
+        return nodes.sort(cmp);
+    }
+    return buildNodes(null);
+}
+// ── React Router v7 config-based routes ─────────────────────────────────────
+/**
+ * Search for a routes.ts config file used by React Router v7 config-based routing.
+ * Returns the file path (relative to targetDir) and the app directory, or null.
+ */
+export function findRoutesConfig(targetDir) {
+    const candidates = [
+        { file: "app/routes.ts", appDir: "app" },
+        { file: "app/routes.tsx", appDir: "app" },
+        { file: "routes.ts", appDir: "." },
+        { file: "routes.tsx", appDir: "." },
+        { file: "src/routes.ts", appDir: "src" },
+        { file: "src/routes.tsx", appDir: "src" },
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(join(targetDir, candidate.file))) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Parse a React Router v7 routes.ts config file and return RouteModule[] or null.
+ *
+ * Returns null if:
+ * - No default export found
+ * - Default export is a flatRoutes() call (should fall back to file-based)
+ * - Parse fails entirely
+ *
+ * Handles: route(), index(), layout(), ...prefix(), satisfies/as wrappers.
+ */
+export function parseRoutesConfig(sourceText, configDir) {
+    const sf = ts.createSourceFile("routes.ts", sourceText, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    // Find default export expression
+    let defaultExpr = null;
+    for (const stmt of sf.statements) {
+        // export default [...]
+        if (ts.isExportAssignment(stmt) && !stmt.isExportEquals) {
+            defaultExpr = stmt.expression;
+            break;
+        }
+        // export default function / export default class (not array — skip)
+    }
+    if (!defaultExpr)
+        return null;
+    // Unwrap `satisfies RouteConfig` or `as RouteConfig`
+    while (ts.isSatisfiesExpression(defaultExpr) ||
+        ts.isAsExpression(defaultExpr)) {
+        defaultExpr = defaultExpr.expression;
+    }
+    // If it's a call expression, check for flatRoutes()
+    if (ts.isCallExpression(defaultExpr)) {
+        const callee = defaultExpr.expression;
+        const calleeName = ts.isIdentifier(callee) ? callee.text
+            : ts.isPropertyAccessExpression(callee) && ts.isIdentifier(callee.name) ? callee.name.text
+                : "";
+        if (calleeName === "flatRoutes")
+            return null;
+        // Other call expressions — can't parse
+        return null;
+    }
+    // Must be an array literal
+    if (!ts.isArrayLiteralExpression(defaultExpr))
+        return null;
+    const modules = [];
+    function resolveFilePath(file) {
+        return configDir === "." ? file : toPosix(join(configDir, file));
+    }
+    function processElements(elements, parentLayout, prefixPath) {
+        for (const el of elements) {
+            // Handle ...prefix("path", [...]) — SpreadElement
+            if (ts.isSpreadElement(el)) {
+                const spreadExpr = el.expression;
+                if (ts.isCallExpression(spreadExpr)) {
+                    const callee = spreadExpr.expression;
+                    const name = ts.isIdentifier(callee) ? callee.text : "";
+                    if (name === "prefix" && spreadExpr.arguments.length >= 2) {
+                        const pathArg = spreadExpr.arguments[0];
+                        const childrenArg = spreadExpr.arguments[1];
+                        if (ts.isStringLiteral(pathArg) && ts.isArrayLiteralExpression(childrenArg)) {
+                            const combinedPrefix = prefixPath
+                                ? prefixPath + "/" + pathArg.text
+                                : pathArg.text;
+                            processElements(childrenArg.elements, parentLayout, combinedPrefix);
+                        }
+                    }
+                }
+                continue;
+            }
+            if (!ts.isCallExpression(el))
+                continue;
+            const callee = el.expression;
+            const fnName = ts.isIdentifier(callee) ? callee.text : "";
+            if (fnName === "route" && el.arguments.length >= 2) {
+                // route(path, file, children?)
+                const pathArg = el.arguments[0];
+                const fileArg = el.arguments[1];
+                if (!ts.isStringLiteral(pathArg) || !ts.isStringLiteral(fileArg))
+                    continue;
+                let pattern = pathArg.text;
+                if (prefixPath) {
+                    pattern = prefixPath + "/" + pattern;
+                }
+                if (!pattern.startsWith("/")) {
+                    pattern = "/" + pattern;
+                }
+                const filePath = resolveFilePath(fileArg.text);
+                modules.push({
+                    file: filePath,
+                    routePattern: pattern,
+                    exports: [],
+                    parentLayout,
+                    isLayout: false,
+                    isIndex: false,
+                });
+                // Process children if present — children nest under this route
+                if (el.arguments.length >= 3) {
+                    const childrenArg = el.arguments[2];
+                    if (ts.isArrayLiteralExpression(childrenArg)) {
+                        processElements(childrenArg.elements, filePath, prefixPath);
+                    }
+                }
+            }
+            else if (fnName === "index" && el.arguments.length >= 1) {
+                // index(file)
+                const fileArg = el.arguments[0];
+                if (!ts.isStringLiteral(fileArg))
+                    continue;
+                let pattern = "/";
+                if (prefixPath) {
+                    pattern = "/" + prefixPath;
+                }
+                const filePath = resolveFilePath(fileArg.text);
+                modules.push({
+                    file: filePath,
+                    routePattern: pattern,
+                    exports: [],
+                    parentLayout,
+                    isLayout: false,
+                    isIndex: true,
+                });
+            }
+            else if (fnName === "layout" && el.arguments.length >= 2) {
+                // layout(file, children)
+                const fileArg = el.arguments[0];
+                const childrenArg = el.arguments[1];
+                if (!ts.isStringLiteral(fileArg))
+                    continue;
+                const filePath = resolveFilePath(fileArg.text);
+                modules.push({
+                    file: filePath,
+                    routePattern: null,
+                    exports: [],
+                    parentLayout,
+                    isLayout: true,
+                    isIndex: false,
+                });
+                if (ts.isArrayLiteralExpression(childrenArg)) {
+                    processElements(childrenArg.elements, filePath, prefixPath);
+                }
+            }
+            // Skip unrecognized call expressions
+        }
+    }
+    processElements(defaultExpr.elements, null, null);
+    return modules;
+}
+// ── findRoutesDir ───────────────────────────────────────────────────────────
+export function findRoutesDir(targetDir, files) {
+    // Check common conventions
+    const candidates = [
+        "app/routes",
+        "src/routes",
+        "routes",
+    ];
+    for (const candidate of candidates) {
+        const full = join(targetDir, candidate);
+        if (existsSync(full)) {
+            return candidate;
+        }
+    }
+    // Fallback: look for files that match route patterns
+    // Skip paths under test/fixture directories — those are test fixtures, not app routes
+    const testSegments = new Set(["test", "tests", "fixtures", "__tests__", "__fixtures__"]);
+    for (const file of files) {
+        const parts = file.split("/");
+        const routesIdx = parts.indexOf("routes");
+        if (routesIdx >= 0) {
+            const pathBeforeRoutes = parts.slice(0, routesIdx);
+            if (pathBeforeRoutes.some(seg => testSegments.has(seg)))
+                continue;
+            return parts.slice(0, routesIdx + 1).join("/");
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=route-detection.js.map

package/packages/sourcevision/dist/analyzers/route-detection.js.map

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

package/packages/sourcevision/dist/analyzers/server-route-detection.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Server-side API route detection.
+ *
+ * Detects HTTP route handlers from:
+ * 1. JSDoc/comment annotations with "METHOD /path" patterns
+ * 2. Express/Hono/Koa-style method calls: app.get("/path", handler)
+ * 3. Manual routing patterns: if (method === "GET" && path === "...")
+ */
+import type { ServerRoute, ServerRouteGroup, Inventory, Classifications } from "../schema/index.js";
+export declare function extractRoutesFromComments(sourceText: string, filePath: string): ServerRoute[];
+/**
+ * Detect routes from framework-style method calls:
+ *   app.get("/path", handler)
+ *   router.post("/path", handler)
+ *   app.route("/prefix", subRouter)
+ */
+export declare function extractRoutesFromFrameworkCalls(sourceText: string, filePath: string): ServerRoute[];
+/**
+ * Try to detect a route prefix from the file, looking for patterns like:
+ *   const PREFIX = "/api/rex/"
+ *   const REX_PREFIX = "/api/rex/"
+ */
+export declare function detectRoutePrefix(sourceText: string): string | null;
+/**
+ * Try to detect the exported handler function name.
+ *   export function handleRexRoute(...)
+ *   export function rexRoutes(...)
+ *   export default function(...)
+ */
+export declare function detectHandlerName(sourceText: string): string | null;
+/**
+ * Detect server-side API routes across the project.
+ * Returns route groups (one per file that defines routes).
+ */
+export declare function detectServerRoutes(targetDir: string, inventory: Inventory, classifications?: Classifications | null): Promise<ServerRouteGroup[]>;

package/packages/sourcevision/dist/analyzers/server-route-detection.js

@@ -0,0 +1,210 @@
+/**
+ * Server-side API route detection.
+ *
+ * Detects HTTP route handlers from:
+ * 1. JSDoc/comment annotations with "METHOD /path" patterns
+ * 2. Express/Hono/Koa-style method calls: app.get("/path", handler)
+ * 3. Manual routing patterns: if (method === "GET" && path === "...")
+ */
+import { readFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+import ts from "typescript";
+import { buildClassificationMap } from "./classify.js";
+const VALID_METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"]);
+const PARSEABLE = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
+// HTTP method names used in framework-style chaining: app.get(), router.post(), etc.
+const FRAMEWORK_METHOD_NAMES = new Set(["get", "post", "put", "patch", "delete", "options", "head"]);
+// ── JSDoc extraction ────────────────────────────────────────────────────────
+/**
+ * Extract routes from JSDoc/block comments matching patterns like:
+ *   GET   /api/rex/prd           — description
+ *   POST  /api/rex/items         — description
+ *   PATCH /api/rex/items/:id     — description
+ */
+const JSDOC_ROUTE_RE = /^\s*\*?\s*(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD)\s+(\/\S+)/gm;
+export function extractRoutesFromComments(sourceText, filePath) {
+    const routes = [];
+    const seen = new Set();
+    // Match block comments (/** ... */ or /* ... */)
+    const blockCommentRe = /\/\*[\s\S]*?\*\//g;
+    let match;
+    while ((match = blockCommentRe.exec(sourceText)) !== null) {
+        const comment = match[0];
+        let routeMatch;
+        JSDOC_ROUTE_RE.lastIndex = 0;
+        while ((routeMatch = JSDOC_ROUTE_RE.exec(comment)) !== null) {
+            const method = routeMatch[1];
+            // Strip trailing description markers (em-dash/en-dash preceded by space)
+            // but NOT hyphens within path segments (e.g., smart-add-preview)
+            const path = routeMatch[2].replace(/\s+[—–].*$/, "").trim();
+            const key = `${method} ${path}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                routes.push({ file: filePath, method, path });
+            }
+        }
+    }
+    return routes;
+}
+// ── Framework pattern detection (Express/Hono/Koa) ──────────────────────────
+/**
+ * Detect routes from framework-style method calls:
+ *   app.get("/path", handler)
+ *   router.post("/path", handler)
+ *   app.route("/prefix", subRouter)
+ */
+export function extractRoutesFromFrameworkCalls(sourceText, filePath) {
+    const sf = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, extname(filePath) === ".tsx" || extname(filePath) === ".jsx"
+        ? ts.ScriptKind.TSX
+        : extname(filePath) === ".ts"
+            ? ts.ScriptKind.TS
+            : ts.ScriptKind.JS);
+    const routes = [];
+    const seen = new Set();
+    function visit(node) {
+        // app.get("/path", handler) or router.post("/path", handler)
+        if (ts.isCallExpression(node) &&
+            ts.isPropertyAccessExpression(node.expression) &&
+            ts.isIdentifier(node.expression.name) &&
+            FRAMEWORK_METHOD_NAMES.has(node.expression.name.text) &&
+            node.arguments.length >= 1) {
+            const methodName = node.expression.name.text.toUpperCase();
+            if (VALID_METHODS.has(methodName)) {
+                const firstArg = node.arguments[0];
+                // Only accept string literals starting with "/" — excludes
+                // URLSearchParams.get("key"), Map.get("key"), etc.
+                if (ts.isStringLiteral(firstArg) && firstArg.text.startsWith("/")) {
+                    const path = firstArg.text;
+                    const key = `${methodName} ${path}`;
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        routes.push({ file: filePath, method: methodName, path });
+                    }
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sf);
+    return routes;
+}
+// ── Prefix detection ────────────────────────────────────────────────────────
+/**
+ * Try to detect a route prefix from the file, looking for patterns like:
+ *   const PREFIX = "/api/rex/"
+ *   const REX_PREFIX = "/api/rex/"
+ */
+export function detectRoutePrefix(sourceText) {
+    const prefixRe = /(?:const|let)\s+\w*(?:PREFIX|prefix|Prefix)\w*\s*=\s*["'](\/[^"']+)["']/;
+    const match = sourceText.match(prefixRe);
+    return match ? match[1] : null;
+}
+/**
+ * Try to detect the exported handler function name.
+ *   export function handleRexRoute(...)
+ *   export function rexRoutes(...)
+ *   export default function(...)
+ */
+export function detectHandlerName(sourceText) {
+    const handlerRe = /export\s+(?:async\s+)?function\s+(handle\w+Route\w*|\w+Routes?\w*)\s*\(/;
+    const match = sourceText.match(handlerRe);
+    return match ? match[1] : null;
+}
+// ── Main detection ──────────────────────────────────────────────────────────
+/**
+ * Heuristic: should we scan this file for server routes?
+ * Checks filename patterns and file content indicators.
+ */
+function isLikelyRouteFile(filePath, role, archetypeMap) {
+    if (role === "test" || role === "config" || role === "docs")
+        return false;
+    // Check archetype classification first
+    if (archetypeMap?.size) {
+        const archetype = archetypeMap.get(filePath);
+        if (archetype === "route-handler")
+            return true;
+    }
+    const lower = filePath.toLowerCase();
+    // File named routes-*.ts or routes/*.ts or router.ts
+    if (/(?:^|\/)routes?[-./]/.test(lower))
+        return true;
+    if (/(?:^|\/)router\.[tj]sx?$/.test(lower))
+        return true;
+    // File in a "routes" or "api" directory
+    if (/(?:^|\/)(?:routes|api)\//.test(lower))
+        return true;
+    return false;
+}
+/**
+ * Detect server-side API routes across the project.
+ * Returns route groups (one per file that defines routes).
+ */
+export async function detectServerRoutes(targetDir, inventory, classifications) {
+    const groups = [];
+    const archetypeMap = buildClassificationMap(classifications);
+    // Find candidate files
+    const candidates = inventory.files.filter((f) => {
+        const ext = extname(f.path).toLowerCase();
+        return PARSEABLE.has(ext) && isLikelyRouteFile(f.path, f.role, archetypeMap);
+    });
+    for (const file of candidates) {
+        const fullPath = join(targetDir, file.path);
+        let sourceText;
+        try {
+            sourceText = await readFile(fullPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        // Try JSDoc extraction first (most reliable for well-documented APIs)
+        let routes = extractRoutesFromComments(sourceText, file.path);
+        // Also try framework pattern detection
+        const frameworkRoutes = extractRoutesFromFrameworkCalls(sourceText, file.path);
+        // Merge: JSDoc routes are authoritative, framework routes fill gaps
+        const seen = new Set(routes.map(r => `${r.method} ${r.path}`));
+        for (const fr of frameworkRoutes) {
+            const key = `${fr.method} ${fr.path}`;
+            if (!seen.has(key)) {
+                routes.push(fr);
+                seen.add(key);
+            }
+        }
+        if (routes.length === 0)
+            continue;
+        const prefix = detectRoutePrefix(sourceText) ?? inferPrefix(routes);
+        const handler = detectHandlerName(sourceText) ?? undefined;
+        groups.push({
+            file: file.path,
+            prefix,
+            handler,
+            routes: routes.sort((a, b) => {
+                const mc = a.method.localeCompare(b.method);
+                return mc !== 0 ? mc : a.path.localeCompare(b.path);
+            }),
+        });
+    }
+    return groups.sort((a, b) => a.file.localeCompare(b.file));
+}
+/** Infer a common prefix from a set of routes. */
+function inferPrefix(routes) {
+    if (routes.length === 0)
+        return "/";
+    const paths = routes.map(r => r.path);
+    // Find longest common prefix
+    let prefix = paths[0];
+    for (let i = 1; i < paths.length; i++) {
+        while (!paths[i].startsWith(prefix)) {
+            const lastSlash = prefix.lastIndexOf("/");
+            if (lastSlash <= 0)
+                return "/";
+            prefix = prefix.slice(0, lastSlash + 1);
+        }
+    }
+    // Ensure prefix ends with /
+    if (!prefix.endsWith("/")) {
+        const lastSlash = prefix.lastIndexOf("/");
+        prefix = lastSlash > 0 ? prefix.slice(0, lastSlash + 1) : "/";
+    }
+    return prefix;
+}
+//# sourceMappingURL=server-route-detection.js.map

package/packages/sourcevision/dist/analyzers/server-route-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-route-detection.js","sourceRoot":"","sources":["../../src/analyzers/server-route-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AACpG,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E,qFAAqF;AACrF,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAErG,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,cAAc,GAClB,gEAAgE,CAAC;AAEnE,MAAM,UAAU,yBAAyB,CAAC,UAAkB,EAAE,QAAgB;IAC5E,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,iDAAiD;IACjD,MAAM,cAAc,GAAG,mBAAmB,CAAC;IAC3C,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,UAAkC,CAAC;QACvC,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC;QAE7B,OAAO,CAAC,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAe,CAAC;YAC3C,yEAAyE;YACzE,iEAAiE;YACjE,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAAkB,EAClB,QAAgB;IAEhB,MAAM,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAC5B,QAAQ,EACR,UAAU,EACV,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM;QAC1D,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG;QACnB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK;YAC3B,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE;YAClB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CACvB,CAAC;IAEF,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,SAAS,KAAK,CAAC,IAAa;QAC1B,6DAA6D;QAC7D,IACE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACzB,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC;YAC9C,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACrC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACrD,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,EAC1B,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3D,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACnC,2DAA2D;gBAC3D,mDAAmD;gBACnD,IAAI,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;oBAC3B,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC;oBACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACd,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAwB,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,QAAQ,GAAG,yEAAyE,CAAC;IAC3F,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,SAAS,GAAG,yEAAyE,CAAC;IAC5F,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAgB,EAAE,IAAY,EAAE,YAAyC;IAClG,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1E,uCAAuC;IACvC,IAAI,YAAY,EAAE,IAAI,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,SAAS,KAAK,eAAe;YAAE,OAAO,IAAI,CAAC;IACjD,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,qDAAqD;IACrD,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,wCAAwC;IACxC,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,SAAoB,EACpB,eAAwC;IAExC,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAE7D,uBAAuB;IACvB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,sEAAsE;QACtE,IAAI,MAAM,GAAG,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9D,uCAAuC;QACvC,MAAM,eAAe,GAAG,+BAA+B,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/E,oEAAoE;QACpE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/D,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAElC,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;QAE3D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM;YACN,OAAO;YACP,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBAC5C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,kDAAkD;AAClD,SAAS,WAAW,CAAC,MAAqB;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,6BAA6B;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,SAAS,IAAI,CAAC;gBAAE,OAAO,GAAG,CAAC;YAC/B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,4BAA4B;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/packages/sourcevision/dist/analyzers/token-usage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Token usage tracking utilities for sourcevision analyze.
+ * Mirrors the pattern from rex's analyze token tracking.
+ */
+import type { TokenUsage, AnalyzeTokenUsage } from "../schema/index.js";
+/** Create an empty AnalyzeTokenUsage accumulator. */
+export declare function emptyAnalyzeTokenUsage(): AnalyzeTokenUsage;
+/** Accumulate a single call's token usage into the aggregate. */
+export declare function accumulateTokenUsage(aggregate: AnalyzeTokenUsage, usage?: TokenUsage): void;
+/** Format token usage for display. Returns empty string when no tokens were used. */
+export declare function formatTokenUsage(usage: AnalyzeTokenUsage): string;

package/packages/sourcevision/dist/analyzers/token-usage.js

@@ -0,0 +1,41 @@
+/**
+ * Token usage tracking utilities for sourcevision analyze.
+ * Mirrors the pattern from rex's analyze token tracking.
+ */
+/** Create an empty AnalyzeTokenUsage accumulator. */
+export function emptyAnalyzeTokenUsage() {
+    return { calls: 0, inputTokens: 0, outputTokens: 0 };
+}
+/** Accumulate a single call's token usage into the aggregate. */
+export function accumulateTokenUsage(aggregate, usage) {
+    aggregate.calls++;
+    if (!usage)
+        return;
+    aggregate.inputTokens += usage.input;
+    aggregate.outputTokens += usage.output;
+    if (usage.cacheCreationInput) {
+        aggregate.cacheCreationInputTokens =
+            (aggregate.cacheCreationInputTokens ?? 0) + usage.cacheCreationInput;
+    }
+    if (usage.cacheReadInput) {
+        aggregate.cacheReadInputTokens =
+            (aggregate.cacheReadInputTokens ?? 0) + usage.cacheReadInput;
+    }
+}
+/** Format token usage for display. Returns empty string when no tokens were used. */
+export function formatTokenUsage(usage) {
+    if (usage.calls === 0 || (usage.inputTokens === 0 && usage.outputTokens === 0)) {
+        return "";
+    }
+    const total = usage.inputTokens + usage.outputTokens;
+    const parts = [
+        `${total.toLocaleString()} tokens`,
+        `(${usage.inputTokens.toLocaleString()} in`,
+        `/ ${usage.outputTokens.toLocaleString()} out)`,
+    ];
+    if (usage.calls > 1) {
+        parts.push(`across ${usage.calls} LLM calls`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=token-usage.js.map

package/packages/sourcevision/dist/analyzers/token-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.js","sourceRoot":"","sources":["../../src/analyzers/token-usage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qDAAqD;AACrD,MAAM,UAAU,sBAAsB;IACpC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAClC,SAA4B,EAC5B,KAAkB;IAElB,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,SAAS,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC;IACrC,SAAS,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;IACvC,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,SAAS,CAAC,wBAAwB;YAChC,CAAC,SAAS,CAAC,wBAAwB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,SAAS,CAAC,oBAAoB;YAC5B,CAAC,SAAS,CAAC,oBAAoB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;IACjE,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC;IACrD,MAAM,KAAK,GAAG;QACZ,GAAG,KAAK,CAAC,cAAc,EAAE,SAAS;QAClC,IAAI,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK;QAC3C,KAAK,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO;KAChD,CAAC;IAEF,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}