codesift-mcp 0.13.1 → 0.15.0

package/dist/tools/cross-repo-contract-matcher.js

@@ -0,0 +1,134 @@
+/** Split a path into non-empty segments (splitting on "/"). */
+function pathSegments(path) {
+    return path.split("/").filter((s) => s.length > 0);
+}
+/** Compute the longest literal prefix of a normalised template path. */
+function templateLiteralHead(normalizedPath) {
+    const segs = pathSegments(normalizedPath);
+    const literalSegs = [];
+    for (const seg of segs) {
+        if (seg === "{param}")
+            break;
+        literalSegs.push(seg);
+    }
+    if (literalSegs.length === 0)
+        return "/";
+    return "/" + literalSegs.join("/") + "/";
+}
+/** Test whether a concrete path instantiates a normalised template path. */
+function instantiatesTemplate(concretePath, normalizedTemplate) {
+    const concSegs = pathSegments(concretePath);
+    const tmplSegs = pathSegments(normalizedTemplate);
+    if (concSegs.length !== tmplSegs.length)
+        return false;
+    for (let i = 0; i < tmplSegs.length; i++) {
+        const t = tmplSegs[i];
+        const c = concSegs[i];
+        if (t === "{param}") {
+            if (c.length === 0)
+                return false; // must match exactly one non-empty segment
+        }
+        else {
+            if (t !== c)
+                return false;
+        }
+    }
+    return true;
+}
+/** Match a Next.js catch-all while preserving the public `{param}` normal form. */
+function instantiatesProducer(concretePath, producer) {
+    const rawSegments = pathSegments(producer.path);
+    const catchAllIndex = rawSegments.findIndex((segment) => /^\[\.\.\.[^\]]+\]$/.test(segment) || /^\[\[\.\.\.[^\]]+\]\]$/.test(segment));
+    if (catchAllIndex === -1) {
+        return instantiatesTemplate(concretePath, producer.normalized_path);
+    }
+    // Next.js catch-all parameters are terminal. Fall back to the conservative
+    // fixed-width matcher if an extractor ever returns a different shape.
+    if (catchAllIndex !== rawSegments.length - 1) {
+        return instantiatesTemplate(concretePath, producer.normalized_path);
+    }
+    const concreteSegments = pathSegments(concretePath);
+    const templateSegments = pathSegments(producer.normalized_path);
+    const optional = rawSegments[catchAllIndex].startsWith("[[");
+    const minimumSegments = catchAllIndex + (optional ? 0 : 1);
+    if (concreteSegments.length < minimumSegments)
+        return false;
+    for (let index = 0; index < catchAllIndex; index++) {
+        const templateSegment = templateSegments[index];
+        if (templateSegment !== "{param}" && templateSegment !== concreteSegments[index])
+            return false;
+    }
+    return true;
+}
+/** Test whether a partial consumer URL prefix matches a template's literal head. */
+function matchesPartialPrefix(urlPrefix, normalizedTemplate) {
+    if (!urlPrefix)
+        return false;
+    if (pathSegments(urlPrefix).length === 0)
+        return false;
+    const head = templateLiteralHead(normalizedTemplate);
+    // Normalise: ensure both end with "/" for prefix comparison
+    const normPrefix = urlPrefix.endsWith("/") ? urlPrefix : urlPrefix + "/";
+    const normHead = head.endsWith("/") ? head : head + "/";
+    // The consumer prefix must equal or be a path-prefix of the template literal head
+    return normHead.startsWith(normPrefix) || normPrefix === normHead;
+}
+/**
+ * Match producer `RepoEndpoint[]` against consumer outbound calls (annotated with repo).
+ *
+ * Matching rules:
+ *   - Same HTTP method (case-insensitive, already uppercased by adapters)
+ *   - Cross-repo only (producer.repo !== consumer.repo)
+ *   - Non-partial consumer: concrete path INSTANTIATES the normalised template → "exact"
+ *   - Partial consumer: url_prefix is a path-prefix of the template's literal head → "partial"
+ *
+ * One consumer can match multiple producers (all reported).
+ * Multiple consumers can match one producer (all reported).
+ * Deduplication: identical (producer_repo, consumer_repo, consumer_file, line, path, method) → single entry.
+ */
+export function matchContracts(producers, consumers) {
+    const results = [];
+    const seen = new Set();
+    for (const p of producers) {
+        for (const c of consumers) {
+            // Cross-repo only
+            if (p.repo === c.repo)
+                continue;
+            // Method must match
+            if (p.method.toUpperCase() !== c.method.toUpperCase())
+                continue;
+            let confidence = null;
+            if (!c.partial) {
+                // Exact: concrete path must instantiate the normalised template
+                if (instantiatesProducer(c.url_prefix, p)) {
+                    confidence = "exact";
+                }
+            }
+            else {
+                // Partial: prefix must match template's literal head
+                if (matchesPartialPrefix(c.url_prefix, p.normalized_path)) {
+                    confidence = "partial";
+                }
+            }
+            if (confidence === null)
+                continue;
+            // Deduplication key
+            const key = `${p.repo}|${c.repo}|${c.file}|${c.line}|${p.normalized_path}|${c.method}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            results.push({
+                producer_repo: p.repo,
+                consumer_repo: c.repo,
+                method: c.method,
+                path: p.normalized_path,
+                consumer_file: c.file,
+                consumer_line: c.line,
+                confidence,
+            });
+        }
+    }
+    return results;
+}
+export { instantiatesTemplate, matchesPartialPrefix };
+//# sourceMappingURL=cross-repo-contract-matcher.js.map

package/dist/tools/cross-repo-contract-matcher.js.map

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

package/dist/tools/cross-repo-contract-resolver.d.ts

@@ -0,0 +1,9 @@
+import type { RepoContractData } from "./cross-repo-contract-types.js";
+/**
+ * Default repo resolver: real getCodeIndex → framework-detected producer
+ * extraction (hono/nest/nextjs adapters) + indexed-source outbound scan.
+ * Dynamic imports avoid a register-tools ↔ index-tools cycle at module load.
+ */
+declare function defaultRepoResolver(repo: string): Promise<RepoContractData>;
+export { defaultRepoResolver };
+//# sourceMappingURL=cross-repo-contract-resolver.d.ts.map

package/dist/tools/cross-repo-contract-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-repo-contract-resolver.d.ts","sourceRoot":"","sources":["../../src/tools/cross-repo-contract-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMvE;;;;GAIG;AACH,iBAAe,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyE1E;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/tools/cross-repo-contract-resolver.js

@@ -0,0 +1,86 @@
+import { adaptHonoContract, adaptNestInventory, adaptNextjsContract } from "./cross-repo-contract-adapters.js";
+import { extractOutboundCalls } from "./cross-repo-outbound-calls.js";
+/** Source extensions scanned for outbound consumer calls. */
+const CONSUMER_SOURCE_EXT = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cts", ".mts"]);
+/**
+ * Default repo resolver: real getCodeIndex → framework-detected producer
+ * extraction (hono/nest/nextjs adapters) + indexed-source outbound scan.
+ * Dynamic imports avoid a register-tools ↔ index-tools cycle at module load.
+ */
+async function defaultRepoResolver(repo) {
+    const { getCodeIndex } = await import("./index-tools.js");
+    const index = await getCodeIndex(repo);
+    if (!index)
+        return { producers: [], consumers: [], indexed: false };
+    const { detectFrameworks } = await import("../utils/framework-detect.js");
+    const frameworks = detectFrameworks(index);
+    // --- producers: run EVERY detected framework's extractor (a monorepo can
+    // serve Hono + NestJS + Next.js side by side — an else-if chain would drop
+    // all but the first). Each runs in its own try so one failure neither aborts
+    // the others nor hides itself (it surfaces a per-framework warning).
+    const producers = [];
+    const repoWarnings = [];
+    const producerJobs = [];
+    if (frameworks.has("hono")) {
+        producerJobs.push(["hono", async () => {
+                const { extractApiContract } = await import("./hono-api-contract.js");
+                return adaptHonoContract(repo, await extractApiContract(repo, undefined, "summary"));
+            }]);
+    }
+    if (frameworks.has("nestjs")) {
+        producerJobs.push(["nestjs", async () => {
+                const { nestRouteInventory } = await import("./nest-tools.js");
+                return adaptNestInventory(repo, await nestRouteInventory(repo));
+            }]);
+    }
+    if (frameworks.has("nextjs")) {
+        producerJobs.push(["nextjs", async () => {
+                const { nextjsApiContract } = await import("./nextjs-api-contract-tools.js");
+                return adaptNextjsContract(repo, await nextjsApiContract(repo));
+            }]);
+    }
+    for (const [fw, job] of producerJobs) {
+        try {
+            producers.push(...(await job()));
+        }
+        catch (err) {
+            // Surface so a genuine extraction failure is distinguishable from "no endpoints".
+            repoWarnings.push(`repo "${repo}" ${fw} producer extraction failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // --- consumers: scan indexed source files for outbound fetch/axios/got calls,
+    // in bounded-concurrency batches so a large repo does not serialize thousands
+    // of awaited readFile calls (CQ17 — avoids per-call latency stacking).
+    const { readFile } = await import("node:fs/promises");
+    const { join, extname } = await import("node:path");
+    const scanFiles = index.files.filter((fe) => CONSUMER_SOURCE_EXT.has(extname(fe.path)));
+    const consumers = [];
+    const CONSUMER_SCAN_CONCURRENCY = 16;
+    for (let b = 0; b < scanFiles.length; b += CONSUMER_SCAN_CONCURRENCY) {
+        const batch = scanFiles.slice(b, b + CONSUMER_SCAN_CONCURRENCY);
+        const scans = await Promise.all(batch.map(async (fe) => {
+            let src;
+            try {
+                src = await readFile(join(index.root, fe.path), "utf-8");
+            }
+            catch (err) {
+                return {
+                    calls: [],
+                    warning: `repo "${repo}" consumer scan failed for "${fe.path}": ${err instanceof Error ? err.message : String(err)}`,
+                };
+            }
+            return { calls: extractOutboundCalls(src, fe.path) };
+        }));
+        for (const scan of scans) {
+            if (scan.warning)
+                repoWarnings.push(scan.warning);
+            for (const call of scan.calls)
+                consumers.push({ ...call, repo });
+        }
+    }
+    return repoWarnings.length > 0
+        ? { producers, consumers, indexed: true, warnings: repoWarnings }
+        : { producers, consumers, indexed: true };
+}
+export { defaultRepoResolver };
+//# sourceMappingURL=cross-repo-contract-resolver.js.map

package/dist/tools/cross-repo-contract-resolver.js.map

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

package/dist/tools/cross-repo-contract-tools.d.ts

@@ -1,137 +1,14 @@
 /**
- * Cross-repo contract adapters (Task 12) and outbound HTTP call extractor (Task 13).
- *
- * Normalises endpoint shapes from Hono, NestJS, and Next.js into the shared
- * RepoEndpoint type so that the outbound extractor (T13) and matcher (T14)
- * can work against a single canonical form.
- *
- * extractOutboundCalls: lexer-based consumer-side outbound HTTP call extractor.
- * Supports fetch, axios.{get|post|put|patch|delete}, got.{get|post|put|patch|delete}.
- * Uses a single-pass state-machine lexer (cross-repo-outbound-lexer.ts) so calls
- * inside comments, string literals, template literals, and regex literals are never
- * falsely reported.
- */
-import type { RepoEndpoint, ContractMatch } from "../types.js";
-import type { ApiContractResult as HonoContractResult } from "./hono-api-contract.js";
-import type { NestRouteInventoryResult } from "./nest-tools.js";
-import type { ApiContractResult as NextjsContractResult } from "./nextjs-api-contract-tools.js";
-/**
- * Replace all path-parameter segments with the canonical `{param}` placeholder.
- *
- * Recognised styles:
- *   - Express / Hono   `:name`
- *   - OpenAPI / NestJS `{name}`
- *   - Next.js          `[name]`
- *   - Next.js catch-all `[...name]`
- *
- * Trailing slashes are stripped (except for a bare "/").
- * Method strings are UPPERCASED by callers; this function only handles paths.
- */
-export declare function normalizePathParams(path: string): string;
-/**
- * Adapt an `extractApiContract` result (Hono) into `RepoEndpoint[]`.
- *
- * Only the `summary` format carries the per-route list; `openapi` format and
- * missing/undefined summary both return [].
- */
-export declare function adaptHonoContract(repo: string, r: HonoContractResult): RepoEndpoint[];
-/**
- * Adapt a `nestRouteInventory` result into `RepoEndpoint[]`.
- *
- * `NestRouteEntry.file` is a required string field — the value is used as-is
- * (may be "" for entries where the controller file couldn't be resolved).
- */
-export declare function adaptNestInventory(repo: string, r: NestRouteInventoryResult): RepoEndpoint[];
-/**
- * Adapt a Next.js `ApiContractResult` into `RepoEndpoint[]`.
- *
- * `HandlerShape.method` is a single `HttpMethod` string per entry (Next.js
- * emits one handler per HTTP verb), so each handler maps to one RepoEndpoint.
- */
-export declare function adaptNextjsContract(repo: string, r: NextjsContractResult): RepoEndpoint[];
-/** A single detected outbound HTTP call from consumer source. */
-export interface OutboundCall {
-    /** The static URL prefix extracted from the call. Paths only — origin stripped. */
-    url_prefix: string;
-    /** HTTP method, uppercased. Defaults to "GET" when not detectable. */
-    method: string;
-    /** True when the URL contains a dynamic segment (template var, concat, path param). */
-    partial: boolean;
-    /** Source file path as provided to extractOutboundCalls. */
-    file: string;
-    /** 1-based line number of the call in the original (pre-strip) source. */
-    line: number;
-}
-/**
- * Match producer `RepoEndpoint[]` against consumer outbound calls (annotated with repo).
- *
- * Matching rules:
- *   - Same HTTP method (case-insensitive, already uppercased by adapters)
- *   - Cross-repo only (producer.repo !== consumer.repo)
- *   - Non-partial consumer: concrete path INSTANTIATES the normalised template → "exact"
- *   - Partial consumer: url_prefix is a path-prefix of the template's literal head → "partial"
- *
- * One consumer can match multiple producers (all reported).
- * Multiple consumers can match one producer (all reported).
- * Deduplication: identical (producer_repo, consumer_file, line, path, method) → single entry.
- */
-export declare function matchContracts(producers: RepoEndpoint[], consumers: Array<OutboundCall & {
-    repo: string;
-}>): ContractMatch[];
-/**
- * Extract all outbound HTTP calls from `source` (TypeScript/JavaScript).
- * Supports fetch, axios.METHOD, and got.METHOD patterns.
- *
- * Uses a single-pass state-machine lexer so calls inside comments, string
- * literals, template literals, and regex literals are never falsely reported
- * (fixes C3/C6).  Multi-line templates are handled naturally (C4).  Wide-
- * spaced string concatenation is detected via the lexer's nextCodeToken (C5).
- * Query-string and fragment stripping is done in extractUrlPrefix (C1).
- *
- * @param source - Raw source code.
- * @param file   - File path to embed in results (returned as-is).
- */
-export declare function extractOutboundCalls(source: string, file: string): OutboundCall[];
-/** Hard cap on repos processed per group (CQ6 — bounds cross-repo fan-out). */
-export declare const MAX_GROUP_REPOS = 20;
-/** Producer endpoints + consumer outbound calls resolved for one repo. */
-export interface RepoContractData {
-    producers: RepoEndpoint[];
-    consumers: Array<OutboundCall & {
-        repo: string;
-    }>;
-    /** False when the repo is not indexed — caller emits a warning and skips it. */
-    indexed: boolean;
-    /** Non-fatal per-repo notes (e.g. a producer extractor threw) surfaced to the caller. */
-    warnings?: string[];
-}
-/** Resolves one repo's producer + consumer contract data. Injectable for tests. */
-export type RepoResolver = (repo: string) => Promise<RepoContractData>;
-export interface GroupContractResult {
-    matches: ContractMatch[];
-    warnings: string[];
-    repos_processed: number;
-    error?: string;
-    /** Set by findEndpointConsumers: raw consumer calls hitting the queried path,
-     * INCLUDING consumers of endpoints with no producer in the group (external
-     * services). Without this, a consumer of an un-indexed producer is invisible. */
-    consumers_of_path?: Array<OutboundCall & {
-        repo: string;
-    }>;
-}
-export declare function matchGroupContracts(groupName: string, opts?: {
-    registryPath?: string;
-    resolver?: RepoResolver;
-}): Promise<GroupContractResult>;
-/**
- * Answer "who calls METHOD path" within a group. Returns producer↔consumer
- * `matches` for the endpoint AND `consumers_of_path` — every raw consumer call
- * hitting that path, INCLUDING calls to endpoints with no producer in the group
- * (an external/un-indexed service). Method is uppercased; the path is normalised
- * (`:id`/`{id}`/`[id]` → `{param}`) so any param style works.
- */
-export declare function findEndpointConsumers(groupName: string, method: string, path: string, opts?: {
-    registryPath?: string;
-    resolver?: RepoResolver;
-}): Promise<GroupContractResult>;
+ * Stable public facade for cross-repo contract analysis.
+ *
+ * The implementation is split by responsibility so consumers keep the
+ * historical module path without eagerly loading the registry or index tools.
+ */
+export { adaptHonoContract, adaptNestInventory, adaptNextjsContract, normalizePathParams, } from "./cross-repo-contract-adapters.js";
+export { findEndpointConsumers, matchGroupContracts } from "./cross-repo-contract-group.js";
+export { matchContracts } from "./cross-repo-contract-matcher.js";
+export { extractOutboundCalls } from "./cross-repo-outbound-calls.js";
+export type { OutboundCall } from "./cross-repo-outbound-calls.js";
+export { MAX_GROUP_REPOS } from "./cross-repo-contract-types.js";
+export type { GroupContractResult, RepoContractData, RepoResolver, } from "./cross-repo-contract-types.js";
 //# sourceMappingURL=cross-repo-contract-tools.d.ts.map

package/dist/tools/cross-repo-contract-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-repo-contract-tools.d.ts","sourceRoot":"","sources":["../../src/tools/cross-repo-contract-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cross-repo-contract-tools.d.ts","sourceRoot":"","sources":["../../src/tools/cross-repo-contract-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,GACb,MAAM,gCAAgC,CAAC"}