codesift-mcp 0.3.0 → 0.4.0

package/dist/tools/hilt-tools.js

@@ -0,0 +1,258 @@
+/**
+ * Hilt DI graph tools.
+ *
+ * Build a dependency graph from indexed Kotlin symbols by scanning for Hilt
+ * annotations (@HiltViewModel, @AndroidEntryPoint, @Module, @Provides, @Binds)
+ * and matching each @Inject constructor parameter type against a provider
+ * method that returns that type.
+ *
+ * Index-only (no filesystem rescan) — operates on whatever the Kotlin
+ * extractor already surfaced. Requires the extractor to populate
+ * `decorators` on class/method symbols (added in Wave 2 Task 3).
+ */
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// Annotation helpers
+// ---------------------------------------------------------------------------
+const ENTRY_ANNOTATIONS = {
+    HiltViewModel: "HiltViewModel",
+    HiltAndroidApp: "HiltAndroidApp",
+    AndroidEntryPoint: "AndroidEntryPoint",
+};
+function hasAnnotation(sym, name) {
+    if (sym.decorators && sym.decorators.includes(name))
+        return true;
+    // Fallback: scan source header for @Annotation (word-bounded so
+    // @HiltViewModelExtra does not match @HiltViewModel).
+    const head = sym.source?.slice(0, 400);
+    if (!head)
+        return false;
+    return new RegExp(`@${name}\\b`).test(head);
+}
+function firstMatchingAnnotation(sym, annotations) {
+    for (const [name, kind] of Object.entries(annotations)) {
+        if (hasAnnotation(sym, name))
+            return kind;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Dependency parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse constructor parameter types from the source of a Hilt entry-point
+ * class. Matches `@Inject constructor(...)` and extracts the type of each
+ * parameter.
+ *
+ * Handles:
+ *   - val/var prefix, private modifier
+ *   - nullable types (String?)
+ *   - generic types (List<User>, Map<K, V>)
+ *   - assisted inject parameters (for now just returns all param types)
+ */
+function parseInjectedDependencies(sym) {
+    const src = sym.source;
+    if (!src)
+        return [];
+    // Match `@Inject constructor(PARAMS)` — params can span multiple lines.
+    const match = /@Inject\s+constructor\s*\(([\s\S]*?)\)/.exec(src);
+    if (!match)
+        return [];
+    const paramList = match[1].trim();
+    if (!paramList)
+        return [];
+    // Split on top-level commas only (don't split inside generic brackets).
+    const params = splitTopLevelCommas(paramList);
+    const types = [];
+    for (const raw of params) {
+        const param = raw.trim();
+        if (!param)
+            continue;
+        // Strip modifiers: private, val, var, @Assisted, @Named("x"), etc.
+        const withoutModifiers = param
+            .replace(/@\w+(?:\([^)]*\))?\s+/g, "")
+            .replace(/\b(?:private|public|internal|protected|val|var)\s+/g, "");
+        // Expect `name: Type` — split on the first colon.
+        const colonIdx = withoutModifiers.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const typeText = withoutModifiers.slice(colonIdx + 1).trim();
+        // Strip trailing `?` for nullable, default value ` = ...`, and
+        // optional trailing comma.
+        const cleanType = typeText
+            .replace(/\s*=\s*[\s\S]*$/, "") // drop default values
+            .replace(/,$/, "")
+            .trim();
+        // Use the root type name (strip generic parameters for matching).
+        const rootType = cleanType.replace(/<[\s\S]*$/, "").replace(/\?$/, "").trim();
+        if (rootType)
+            types.push(rootType);
+    }
+    return types;
+}
+function splitTopLevelCommas(text) {
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === "<" || ch === "(" || ch === "[")
+            depth++;
+        else if (ch === ">" || ch === ")" || ch === "]")
+            depth--;
+        else if (ch === "," && depth === 0) {
+            parts.push(text.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(text.slice(start));
+    return parts;
+}
+// ---------------------------------------------------------------------------
+// Provider parsing
+// ---------------------------------------------------------------------------
+/**
+ * Extract the return type from a provider method signature.
+ *
+ *   "(): UserRepository"                     → "UserRepository"
+ *   "(impl: UserRepositoryImpl): UserRepository" → "UserRepository"
+ *   "(): List<User>"                         → "List"
+ */
+function parseProviderReturnType(sym) {
+    const sig = sym.signature;
+    if (!sig)
+        return null;
+    // The return type sits after the last `):`.
+    const idx = sig.lastIndexOf("):");
+    if (idx === -1)
+        return null;
+    const rawReturn = sig.slice(idx + 2).trim();
+    const rootType = rawReturn.replace(/<[\s\S]*$/, "").replace(/\?$/, "").trim();
+    return rootType || null;
+}
+// ---------------------------------------------------------------------------
+// Graph builder
+// ---------------------------------------------------------------------------
+export async function buildHiltGraph(repo) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const viewModels = [];
+    const entryPoints = [];
+    const modules = [];
+    // First pass — classify classes as entry points or modules.
+    // Track modules by id so we can attach providers in the second pass.
+    const modulesById = new Map();
+    for (const sym of index.symbols) {
+        if (sym.kind !== "class" && sym.kind !== "interface")
+            continue;
+        const entryKind = firstMatchingAnnotation(sym, ENTRY_ANNOTATIONS);
+        if (entryKind) {
+            const entry = {
+                name: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                kind: entryKind,
+                dependencies: parseInjectedDependencies(sym),
+            };
+            if (entryKind === "HiltViewModel") {
+                viewModels.push(entry);
+            }
+            else {
+                entryPoints.push(entry);
+            }
+            continue;
+        }
+        if (hasAnnotation(sym, "Module")) {
+            const mod = {
+                name: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                providers: [],
+            };
+            modules.push(mod);
+            modulesById.set(sym.id, mod);
+        }
+    }
+    // Second pass — attach provider methods to their parent modules.
+    for (const sym of index.symbols) {
+        if (sym.kind !== "method" && sym.kind !== "function")
+            continue;
+        if (!sym.parent)
+            continue;
+        const module = modulesById.get(sym.parent);
+        if (!module)
+            continue;
+        let providerKind = null;
+        if (hasAnnotation(sym, "Provides"))
+            providerKind = "provides";
+        else if (hasAnnotation(sym, "Binds"))
+            providerKind = "binds";
+        if (!providerKind)
+            continue;
+        const returnType = parseProviderReturnType(sym);
+        if (!returnType)
+            continue;
+        module.providers.push({
+            name: sym.name,
+            file: sym.file,
+            start_line: sym.start_line,
+            kind: providerKind,
+            provides: returnType,
+        });
+    }
+    // Build edge table — map provider type → {method, module}.
+    const providerIndex = new Map();
+    for (const module of modules) {
+        for (const provider of module.providers) {
+            if (!providerIndex.has(provider.provides)) {
+                providerIndex.set(provider.provides, { provider, module });
+            }
+        }
+    }
+    const edges = [];
+    for (const entry of [...viewModels, ...entryPoints]) {
+        for (const dep of entry.dependencies) {
+            const provider = providerIndex.get(dep);
+            const edge = { from: entry.name, to: dep };
+            if (provider) {
+                edge.provided_by = provider.provider.name;
+                edge.module = provider.module.name;
+            }
+            edges.push(edge);
+        }
+    }
+    return { view_models: viewModels, entry_points: entryPoints, modules, edges };
+}
+export async function traceHiltGraph(repo, className, options) {
+    const graph = await buildHiltGraph(repo);
+    const depth = options?.depth ?? 1;
+    const root = graph.view_models.find((v) => v.name === className) ??
+        graph.entry_points.find((e) => e.name === className);
+    if (!root) {
+        throw new Error(`"${className}" is not a Hilt entry point (missing @HiltViewModel / @HiltAndroidApp / @AndroidEntryPoint annotation).`);
+    }
+    const dependencies = root.dependencies.map((dep) => {
+        const edge = graph.edges.find((e) => e.from === className && e.to === dep);
+        const node = { name: dep };
+        if (edge?.provided_by)
+            node.provided_by = edge.provided_by;
+        if (edge?.module)
+            node.module = edge.module;
+        if (!edge?.provided_by)
+            node.unresolved = true;
+        return node;
+    });
+    return {
+        root: {
+            name: root.name,
+            kind: root.kind,
+            file: root.file,
+            start_line: root.start_line,
+        },
+        dependencies,
+        depth,
+    };
+}
+//# sourceMappingURL=hilt-tools.js.map

package/dist/tools/hilt-tools.js.map

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

package/dist/tools/hono-analyze-app.d.ts

@@ -0,0 +1,48 @@
+/**
+ * analyze_hono_app — complete Hono application overview.
+ *
+ * Returns routes grouped by method/scope, middleware map, context variables,
+ * OpenAPI status, RPC exports (with slow-pattern detection), runtime,
+ * and env bindings in one call.
+ *
+ * Spec: docs/specs/2026-04-10-hono-framework-intelligence-spec.md (Task 17)
+ */
+import type { HonoAppModel } from "../parser/extractors/hono-model.js";
+export interface AnalyzeHonoAppResult {
+    framework?: "hono";
+    runtime?: HonoAppModel["runtime"];
+    entry_file?: string;
+    routes?: {
+        total: number;
+        by_method: Record<string, number>;
+        by_mount: Record<string, number>;
+    };
+    middleware?: {
+        total_chains: number;
+        by_scope: Record<string, number>;
+        third_party: string[];
+    };
+    context_vars?: Array<{
+        name: string;
+        set_count: number;
+        get_count: number;
+        is_env_binding: boolean;
+    }>;
+    openapi?: {
+        enabled: boolean;
+        route_count: number;
+    };
+    rpc_exports?: Array<{
+        name: string;
+        shape: "full_app" | "route_group";
+        is_slow_pattern: boolean;
+        file: string;
+    }>;
+    env_bindings?: string[];
+    extraction_status?: "complete" | "partial";
+    skip_reasons?: Record<string, number>;
+    files_used_count?: number;
+    error?: string;
+}
+export declare function analyzeHonoApp(repo: string, entryFile?: string, forceRefresh?: boolean): Promise<AnalyzeHonoAppResult>;
+//# sourceMappingURL=hono-analyze-app.d.ts.map

package/dist/tools/hono-analyze-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-analyze-app.d.ts","sourceRoot":"","sources":["../../src/tools/hono-analyze-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,oCAAoC,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,UAAU,GAAG,aAAa,CAAC;QAClC,eAAe,EAAE,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAmF/B"}

package/dist/tools/hono-analyze-app.js

@@ -0,0 +1,102 @@
+/**
+ * analyze_hono_app — complete Hono application overview.
+ *
+ * Returns routes grouped by method/scope, middleware map, context variables,
+ * OpenAPI status, RPC exports (with slow-pattern detection), runtime,
+ * and env bindings in one call.
+ *
+ * Spec: docs/specs/2026-04-10-hono-framework-intelligence-spec.md (Task 17)
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { honoCache } from "../cache/hono-cache.js";
+import { HonoExtractor } from "../parser/extractors/hono.js";
+import { detectFrameworks } from "../utils/framework-detect.js";
+import { join } from "node:path";
+export async function analyzeHonoApp(repo, entryFile, forceRefresh) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        return { error: `Repository "${repo}" not found` };
+    }
+    const frameworks = detectFrameworks(index);
+    if (!frameworks.has("hono")) {
+        return { error: "No Hono app detected in this repo" };
+    }
+    const resolvedEntry = entryFile ?? resolveHonoEntryFile(index);
+    if (!resolvedEntry) {
+        return { error: "No Hono app entry file found" };
+    }
+    if (forceRefresh) {
+        honoCache.clear(repo);
+    }
+    let model;
+    try {
+        model = await honoCache.get(repo, resolvedEntry, new HonoExtractor());
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { error: `Failed to parse Hono app: ${msg}` };
+    }
+    // Routes grouped by method and mount prefix
+    const byMethod = {};
+    const byMount = {};
+    for (const route of model.routes) {
+        byMethod[route.method] = (byMethod[route.method] ?? 0) + 1;
+        const segments = route.path.split("/").filter(Boolean);
+        const mountKey = segments.length >= 2 ? `/${segments[0]}/${segments[1]}` : `/${segments[0] ?? ""}`;
+        byMount[mountKey] = (byMount[mountKey] ?? 0) + 1;
+    }
+    // Middleware grouped by scope, third-party list
+    const byScope = {};
+    const thirdParty = new Set();
+    for (const mc of model.middleware_chains) {
+        byScope[mc.scope] = (byScope[mc.scope] ?? 0) + mc.entries.length;
+        for (const entry of mc.entries) {
+            if (entry.is_third_party)
+                thirdParty.add(entry.name);
+        }
+    }
+    return {
+        framework: "hono",
+        runtime: model.runtime,
+        entry_file: model.entry_file,
+        routes: {
+            total: model.routes.length,
+            by_method: byMethod,
+            by_mount: byMount,
+        },
+        middleware: {
+            total_chains: model.middleware_chains.length,
+            by_scope: byScope,
+            third_party: [...thirdParty].sort(),
+        },
+        context_vars: model.context_vars.map((cv) => ({
+            name: cv.name,
+            set_count: cv.set_points.length,
+            get_count: cv.get_points.length,
+            is_env_binding: cv.is_env_binding,
+        })),
+        openapi: {
+            enabled: model.openapi_routes.length > 0,
+            route_count: model.openapi_routes.length,
+        },
+        rpc_exports: model.rpc_exports.map((r) => ({
+            name: r.export_name,
+            shape: r.shape,
+            is_slow_pattern: r.shape === "full_app",
+            file: r.file,
+        })),
+        env_bindings: model.env_bindings,
+        extraction_status: model.extraction_status,
+        skip_reasons: model.skip_reasons,
+        files_used_count: model.files_used.length,
+    };
+}
+function resolveHonoEntryFile(index) {
+    for (const sym of index.symbols) {
+        if (sym.source && /new\s+(?:Hono|OpenAPIHono)\s*(?:<[^>]*>)?\s*\(/.test(sym.source)) {
+            return join(index.root, sym.file);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=hono-analyze-app.js.map

package/dist/tools/hono-analyze-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-analyze-app.js","sourceRoot":"","sources":["../../src/tools/hono-analyze-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAwCjC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,SAAkB,EAClB,YAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,eAAe,IAAI,aAAa,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,KAAmB,CAAC;IACxB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,6BAA6B,GAAG,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,4CAA4C;IAC5C,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAqB,EAAE,CAAC;QAChD,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,gDAAgD;IAChD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACzC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,cAAc;gBAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC1B,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,OAAO;SAClB;QACD,UAAU,EAAE;YACV,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,MAAM;YAC5C,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE;SACpC;QACD,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM;YAC/B,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM;YAC/B,cAAc,EAAE,EAAE,CAAC,cAAc;SAClC,CAAC,CAAC;QACH,OAAO,EAAE;YACP,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YACxC,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM;SACzC;QACD,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,CAAC,CAAC,WAAW;YACnB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,KAAK,KAAK,UAAU;YACvC,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC;QACH,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAG7B;IACC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,MAAM,IAAI,gDAAgD,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/hono-api-contract.d.ts

@@ -0,0 +1,22 @@
+/**
+ * extract_api_contract — infer OpenAPI-like API contract from Hono app.
+ *
+ * Uses explicit createRoute() definitions where available, falls back to
+ * inferring from regular routes (method + path + optional validators).
+ *
+ * Spec: docs/specs/2026-04-10-hono-framework-intelligence-spec.md (Task 19)
+ */
+export type ContractFormat = "openapi" | "summary";
+export interface ApiContractResult {
+    format?: ContractFormat;
+    paths?: Record<string, Record<string, unknown>>;
+    summary?: Array<{
+        path: string;
+        method: string;
+        source: "explicit" | "inferred";
+        file: string;
+    }>;
+    error?: string;
+}
+export declare function extractApiContract(repo: string, entryFile?: string, format?: ContractFormat): Promise<ApiContractResult>;
+//# sourceMappingURL=hono-api-contract.d.ts.map

package/dist/tools/hono-api-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-api-contract.d.ts","sourceRoot":"","sources":["../../src/tools/hono-api-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,cAA0B,GACjC,OAAO,CAAC,iBAAiB,CAAC,CA0D5B"}

package/dist/tools/hono-api-contract.js

@@ -0,0 +1,80 @@
+/**
+ * extract_api_contract — infer OpenAPI-like API contract from Hono app.
+ *
+ * Uses explicit createRoute() definitions where available, falls back to
+ * inferring from regular routes (method + path + optional validators).
+ *
+ * Spec: docs/specs/2026-04-10-hono-framework-intelligence-spec.md (Task 19)
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { honoCache } from "../cache/hono-cache.js";
+import { HonoExtractor } from "../parser/extractors/hono.js";
+import { detectFrameworks } from "../utils/framework-detect.js";
+import { join } from "node:path";
+export async function extractApiContract(repo, entryFile, format = "openapi") {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        return { error: `Repository "${repo}" not found` };
+    const frameworks = detectFrameworks(index);
+    if (!frameworks.has("hono"))
+        return { error: "No Hono app detected" };
+    const resolved = entryFile ?? resolveHonoEntryFile(index);
+    if (!resolved)
+        return { error: "No Hono entry file found" };
+    let model;
+    try {
+        model = await honoCache.get(repo, resolved, new HonoExtractor());
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { error: `Failed to parse: ${msg}` };
+    }
+    if (format === "summary") {
+        const summary = [];
+        for (const route of model.routes) {
+            summary.push({
+                path: route.path,
+                method: route.method,
+                source: route.openapi_route_id ? "explicit" : "inferred",
+                file: route.file,
+            });
+        }
+        return { format, summary };
+    }
+    // OpenAPI 3.1 format
+    const paths = {};
+    // Explicit createRoute() definitions
+    for (const oar of model.openapi_routes) {
+        const pathKey = oar.path;
+        if (!paths[pathKey])
+            paths[pathKey] = {};
+        paths[pathKey][oar.method.toLowerCase()] = {
+            parameters: [],
+            responses: oar.response_schemas,
+            "x-hono-source": "createRoute",
+        };
+    }
+    // Inferred from regular routes
+    for (const route of model.routes) {
+        if (route.openapi_route_id)
+            continue; // already covered above
+        const pathKey = route.path;
+        if (!paths[pathKey])
+            paths[pathKey] = {};
+        paths[pathKey][route.method.toLowerCase()] = {
+            responses: { "200": { description: "Success (inferred)" } },
+            "x-hono-source": "inferred",
+            "x-hono-file": route.file,
+        };
+    }
+    return { format, paths };
+}
+function resolveHonoEntryFile(index) {
+    for (const sym of index.symbols) {
+        if (sym.source && /new\s+(?:Hono|OpenAPIHono)\s*(?:<[^>]*>)?\s*\(/.test(sym.source)) {
+            return join(index.root, sym.file);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=hono-api-contract.js.map

package/dist/tools/hono-api-contract.js.map

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

package/dist/tools/hono-conditional-middleware.d.ts

@@ -0,0 +1,27 @@
+/**
+ * trace_conditional_middleware — lists middleware that is applied under a
+ * runtime condition (e.g., basicAuth only for non-GET methods). Consumes
+ * the applied_when data populated by HonoExtractor Phase 2 T4.
+ *
+ * Use case: audit_hono_security was producing false positives on conditional
+ * auth wrappers in inline middleware arrows. This tool surfaces the gated
+ * middleware so operators can verify the gating is correct.
+ *
+ * Spec: docs/specs/2026-04-11-hono-phase-2-plan.md (T7)
+ */
+import type { ConditionalApplication } from "../parser/extractors/hono-model.js";
+export interface ConditionalMiddlewareEntry {
+    scope: string;
+    middleware_name: string;
+    condition_type: ConditionalApplication["condition_type"];
+    condition_text: string;
+    file: string;
+    line: number;
+}
+export interface ConditionalMiddlewareResult {
+    entries?: ConditionalMiddlewareEntry[];
+    total?: number;
+    error?: string;
+}
+export declare function traceConditionalMiddleware(repo: string, scopeFilter?: string): Promise<ConditionalMiddlewareResult>;
+//# sourceMappingURL=hono-conditional-middleware.d.ts.map

package/dist/tools/hono-conditional-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-conditional-middleware.d.ts","sourceRoot":"","sources":["../../src/tools/hono-conditional-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,2BAA2B,CAAC,CAmCtC"}

package/dist/tools/hono-conditional-middleware.js

@@ -0,0 +1,62 @@
+/**
+ * trace_conditional_middleware — lists middleware that is applied under a
+ * runtime condition (e.g., basicAuth only for non-GET methods). Consumes
+ * the applied_when data populated by HonoExtractor Phase 2 T4.
+ *
+ * Use case: audit_hono_security was producing false positives on conditional
+ * auth wrappers in inline middleware arrows. This tool surfaces the gated
+ * middleware so operators can verify the gating is correct.
+ *
+ * Spec: docs/specs/2026-04-11-hono-phase-2-plan.md (T7)
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { honoCache } from "../cache/hono-cache.js";
+import { HonoExtractor } from "../parser/extractors/hono.js";
+import { detectFrameworks } from "../utils/framework-detect.js";
+import { join } from "node:path";
+export async function traceConditionalMiddleware(repo, scopeFilter) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        return { error: `Repository "${repo}" not found` };
+    const frameworks = detectFrameworks(index);
+    if (!frameworks.has("hono"))
+        return { error: "No Hono app detected" };
+    const entryFile = resolveHonoEntryFile(index);
+    if (!entryFile)
+        return { error: "No Hono app entry file found" };
+    let model;
+    try {
+        model = await honoCache.get(repo, entryFile, new HonoExtractor());
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { error: `Failed to parse: ${msg}` };
+    }
+    const entries = [];
+    for (const chain of model.middleware_chains) {
+        if (scopeFilter && chain.scope !== scopeFilter)
+            continue;
+        for (const entry of chain.entries) {
+            if (!entry.applied_when)
+                continue;
+            entries.push({
+                scope: chain.scope,
+                middleware_name: entry.name,
+                condition_type: entry.applied_when.condition_type,
+                condition_text: entry.applied_when.condition_text,
+                file: entry.file,
+                line: entry.line,
+            });
+        }
+    }
+    return { entries, total: entries.length };
+}
+function resolveHonoEntryFile(index) {
+    for (const sym of index.symbols) {
+        if (sym.source && /new\s+(?:Hono|OpenAPIHono)\s*(?:<[^>]*>)?\s*\(/.test(sym.source)) {
+            return join(index.root, sym.file);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=hono-conditional-middleware.js.map

package/dist/tools/hono-conditional-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-conditional-middleware.js","sourceRoot":"","sources":["../../src/tools/hono-conditional-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkBjC,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAY,EACZ,WAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,eAAe,IAAI,aAAa,EAAE,CAAC;IAE/D,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAEtE,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IAEjE,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5C,IAAI,WAAW,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW;YAAE,SAAS;QACzD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,YAAY;gBAAE,SAAS;YAClC,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,eAAe,EAAE,KAAK,CAAC,IAAI;gBAC3B,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,cAAc;gBACjD,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,cAAc;gBACjD,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,oBAAoB,CAAC,KAG7B;IACC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,MAAM,IAAI,gDAAgD,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}