codesift-mcp 0.5.30 → 0.8.2

package/dist/tools/yii3-migration-tools.js

@@ -0,0 +1,440 @@
+/**
+ * Yii3 migration audit (M4) — decision-support tool.
+ *
+ * Inventories Yii2-specific API usage across a codebase and projects an
+ * effort estimate so the team can choose between staying on Yii 2.0.49+
+ * with PHP 8 vs migrating to Yii3. The tool is grep-style by design: it
+ * does not try to understand semantics, only to count call sites by
+ * category and surface the highest-leverage blockers.
+ *
+ * Every category maps a Yii2 idiom to its Yii3 equivalent and assigns a
+ * severity + per-call effort estimate. The aggregated effort_estimate
+ * gives a rough hours-low/hours-high range. Severity reflects how hard
+ * the migration is, NOT how dangerous the current code is.
+ *
+ * Out of scope:
+ *   - Vendor / third-party packages (we strip vendor/ paths before scan).
+ *   - Semantic disambiguation (e.g. `Yii::$app->db` is service-locator
+ *     even when the property is dynamically resolved at runtime — we
+ *     don't try to detect that).
+ *   - Migration plans for non-Yii frameworks (Laravel/Symfony).
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// Effort tariff
+// ---------------------------------------------------------------------------
+const EFFORT_HOURS = {
+    // [low_estimate, high_estimate] hours per call site.
+    // Calibrated against common Yii2→Yii3 retrospectives. The low end assumes
+    // a team that has migrated similar code before; high end assumes greenfield.
+    trivial: [0.05, 0.15],
+    small: [0.25, 0.75],
+    medium: [1, 3],
+    large: [4, 12],
+};
+// ---------------------------------------------------------------------------
+// Category catalog (21 categories)
+// ---------------------------------------------------------------------------
+const CATEGORIES = [
+    {
+        category: "service-locator",
+        severity: "critical",
+        description: "Yii::$app->X service locator access — every call site needs DI ctor injection in Yii3.",
+        yii3_replacement: "Inject the service via constructor (e.g. `public function __construct(private Connection $db)`).",
+        effort_per_call: "small",
+        patterns: [
+            // Catches both Yii::$app->X and \Yii::$app->X. Excludes the more
+            // specific subcategories below by NOT matching their well-known
+            // property names — those land in their own buckets.
+            /\\?\bYii::\$app->(?!request\b|response\b|session\b|user\b|urlManager\b|authManager\b|queue\b|view\b|controller\b|errorHandler\b|id\b|params\b|language\b|name\b|homeUrl\b|formatter\b|i18n\b)([a-zA-Z_][\w]*)/g,
+        ],
+    },
+    {
+        category: "object-factory",
+        severity: "high",
+        description: "Yii::createObject() factory — Yii3 uses a PSR-11 container directly.",
+        yii3_replacement: "Resolve via Yii3 DI: `$container->get(ClassName::class)`. Most call sites can become constructor injection.",
+        effort_per_call: "small",
+        patterns: [/\\?\bYii::createObject\s*\(/g],
+    },
+    {
+        category: "aliases",
+        severity: "high",
+        description: "Yii::getAlias / Yii::setAlias path-alias system — Yii3 has a dedicated Aliases service.",
+        yii3_replacement: "Inject `Yiisoft\\Aliases\\Aliases` and use its API.",
+        effort_per_call: "small",
+        patterns: [/\\?\bYii::(?:getAlias|setAlias)\s*\(/g],
+    },
+    {
+        category: "i18n",
+        severity: "high",
+        description: "Yii::t() translation calls — Yii3 uses a TranslatorInterface injected per consumer.",
+        yii3_replacement: "Inject `Yiisoft\\Translator\\TranslatorInterface`. Message files migrate to PO/PHP arrays per package.",
+        effort_per_call: "trivial",
+        patterns: [/\\?\bYii::t\s*\(/g],
+    },
+    {
+        category: "logger",
+        severity: "high",
+        description: "Yii::error / Yii::info / Yii::warning / Yii::trace — Yii3 uses PSR-3 LoggerInterface.",
+        yii3_replacement: "Inject `Psr\\Log\\LoggerInterface` and call `$logger->info(...)`, `$logger->error(...)`.",
+        effort_per_call: "trivial",
+        patterns: [/\\?\bYii::(?:error|info|warning|trace|debug|beginProfile|endProfile)\s*\(/g],
+    },
+    {
+        category: "application-props",
+        severity: "medium",
+        description: "Yii::$app->id / params / language / homeUrl / name — Yii3 splits these across several services.",
+        yii3_replacement: "Read via dedicated service (Application name / Aliases / Translator locale / Params service).",
+        effort_per_call: "trivial",
+        patterns: [
+            /\\?\bYii::\$app->(?:id|params|language|homeUrl|name|formatter|i18n)\b/g,
+        ],
+    },
+    {
+        category: "module",
+        severity: "critical",
+        description: "Class extends yii\\base\\Module — Yii3 has no module concept; flatten to packages or use DI scopes.",
+        yii3_replacement: "Convert each module into a Composer package or restructure into namespaces with their own DI bindings.",
+        effort_per_call: "large",
+        patterns: [
+            /\bextends\s+(?:\\?yii\\base\\Module|Module)\b/g,
+        ],
+    },
+    {
+        category: "request",
+        severity: "high",
+        description: "Yii::$app->request->X — replace with PSR-7 ServerRequestInterface.",
+        yii3_replacement: "Inject `Psr\\Http\\Message\\ServerRequestInterface` (or a Yii Request decorator).",
+        effort_per_call: "small",
+        patterns: [/\\?\bYii::\$app->request->/g],
+    },
+    {
+        category: "response",
+        severity: "high",
+        description: "Yii::$app->response->X — replace with PSR-7 ResponseFactoryInterface.",
+        yii3_replacement: "Inject `Psr\\Http\\Message\\ResponseFactoryInterface` and return `ResponseInterface`.",
+        effort_per_call: "small",
+        patterns: [/\\?\bYii::\$app->response->/g],
+    },
+    {
+        category: "session",
+        severity: "medium",
+        description: "Yii::$app->session->X — Yii3 has a session package with its own interface.",
+        yii3_replacement: "Inject `Yiisoft\\Session\\SessionInterface` (or PSR-15 session middleware).",
+        effort_per_call: "trivial",
+        patterns: [/\\?\bYii::\$app->session->/g],
+    },
+    {
+        category: "user-identity",
+        severity: "high",
+        description: "Yii::$app->user->identity / id / isGuest / can — auth shape differs in Yii3.",
+        yii3_replacement: "Inject `Yiisoft\\Auth\\IdentityInterface` (or a project-specific identity service) + RBAC package.",
+        effort_per_call: "small",
+        patterns: [/\\?\bYii::\$app->user->/g],
+    },
+    {
+        category: "active-record",
+        severity: "critical",
+        description: "ActiveRecord (yii\\db\\ActiveRecord) — Yii3 has no AR core. Pick Cycle ORM or yiisoft/active-record.",
+        yii3_replacement: "Cycle ORM (preferred for new code) or `yiisoft/active-record` (closer to Yii2 API).",
+        effort_per_call: "medium",
+        patterns: [
+            /\bextends\s+(?:\\?yii\\db\\ActiveRecord|ActiveRecord)\b/g,
+        ],
+    },
+    {
+        category: "validators",
+        severity: "high",
+        description: "Yii2 rules() validation array — Yii3 uses `yiisoft/validator` with attributes or rule objects.",
+        yii3_replacement: "Replace `rules()` with attribute-based validation (`#[Required, Email]`) or a Validator service.",
+        effort_per_call: "small",
+        // Heuristic: a `rules()` method that returns an array. We count one per
+        // class that defines such a method. False positives possible if a class
+        // unrelated to Yii2 has its own rules().
+        patterns: [
+            /\bpublic\s+function\s+rules\s*\(\s*\)\s*(?::\s*array\s*)?\{/g,
+        ],
+    },
+    {
+        category: "form-model",
+        severity: "high",
+        description: "Form models extending yii\\base\\Model with load() + validate() — Yii3 has `yiisoft/form-model`.",
+        yii3_replacement: "Migrate to `yiisoft/form-model`. The `load()`/`validate()` lifecycle moves to FormModelInterface.",
+        effort_per_call: "small",
+        patterns: [
+            /\bextends\s+(?:\\?yii\\base\\Model|Model)\b(?!\\)/g,
+            /->load\s*\(\s*Yii::\$app->request->post\s*\(\s*\)\s*\)/g,
+        ],
+    },
+    {
+        category: "widgets",
+        severity: "high",
+        description: "Yii2 widgets (GridView, ActiveForm, Pjax, ListView) — Yii3 splits widgets into separate packages and some are gone.",
+        yii3_replacement: "Per widget: use `yiisoft/yii-bootstrap5`, `yiisoft/yii-gridview`, `yiisoft/form` or rewrite as Twig/Vue components.",
+        effort_per_call: "medium",
+        patterns: [
+            /\b(?:GridView|ActiveForm|Pjax|ListView|DetailView|Breadcrumbs|Menu|LinkPager)::(?:widget|begin)\s*\(/g,
+        ],
+    },
+    {
+        category: "view",
+        severity: "high",
+        description: "$this->render() / $this->layout — Yii3 has a yii-view package with a different lifecycle.",
+        yii3_replacement: "Inject `Yiisoft\\View\\ViewInterface`. `$this->layout` becomes view parameters/decorators.",
+        effort_per_call: "small",
+        patterns: [
+            /\$this->render(?:Partial|Ajax|AsJson|File)?\s*\(/g,
+            /\$this->layout\s*=/g,
+        ],
+    },
+    {
+        category: "url-manager",
+        severity: "high",
+        description: "Yii::$app->urlManager / urlManager rules in config — Yii3 uses a Router package + attribute-based routes.",
+        yii3_replacement: "Migrate `urlManager` rules to `yiisoft/router` + per-action `#[Route]` attributes.",
+        effort_per_call: "medium",
+        patterns: [
+            /\\?\bYii::\$app->urlManager->/g,
+            /[\'\"]urlManager[\'\"]\s*=>\s*\[/g,
+        ],
+    },
+    {
+        category: "console",
+        severity: "high",
+        description: "Console controllers extending yii\\console\\Controller — Yii3 console uses Symfony Console.",
+        yii3_replacement: "Rewrite each console controller as a `Symfony\\Component\\Console\\Command\\Command` subclass.",
+        effort_per_call: "medium",
+        patterns: [
+            /\bextends\s+(?:\\?yii\\console\\Controller|Controller)\b/g,
+        ],
+    },
+    {
+        category: "migrations",
+        severity: "low",
+        description: "Migrations extending yii\\db\\Migration — Yii3 has `yiisoft/db-migration` with similar API.",
+        yii3_replacement: "Largely API-compatible. Migrate base class import; bulk-replace `extends Migration` with the new namespace.",
+        effort_per_call: "trivial",
+        patterns: [
+            /\bextends\s+(?:\\?yii\\db\\Migration|Migration)\b/g,
+        ],
+    },
+    {
+        category: "queue",
+        severity: "medium",
+        description: "Yii::$app->queue / yii\\queue\\Queue — Yii3 has `yiisoft/queue` (or use Symfony Messenger).",
+        yii3_replacement: "Rewrite jobs to implement Yii3 queue's MessageInterface or Symfony Messenger handlers.",
+        effort_per_call: "small",
+        patterns: [
+            /\\?\bYii::\$app->queue\b/g,
+            /\bextends\s+(?:\\?yii\\queue\\)/g,
+            /\bimplements\s+(?:\\?yii\\queue\\JobInterface|JobInterface)\b/g,
+        ],
+    },
+    {
+        category: "rbac",
+        severity: "high",
+        description: "Yii::$app->authManager (createPermission/createRole/add/addChild) and ->can() — Yii3 uses yiisoft/rbac.",
+        yii3_replacement: "Migrate seed migrations to `yiisoft/rbac` Manager API. ->can() becomes `Manager::userHasPermission()`.",
+        effort_per_call: "medium",
+        // Yii2 RBAC seed migrations universally alias the manager into a local
+        // variable (`$auth = Yii::$app->authManager;`) and then call
+        // `$auth->createRole/createPermission/add/addChild` — so we can't rely
+        // on a single combined regex. We catch:
+        //   1. The aliased read itself (any reference to `Yii::$app->authManager`)
+        //   2. RBAC builder method names (createRole/createPermission/add/addChild/
+        //      assign/revoke/getRole/getPermission/checkAccess)
+        //   3. The runtime check `Yii::$app->user->can(...)`.
+        patterns: [
+            /\\?\bYii::\$app->authManager\b/g,
+            /->(?:createRole|createPermission|addChild|assign|revoke|getRole|getPermission|checkAccess)\s*\(/g,
+            /\\?\bYii::\$app->user->can\s*\(/g,
+        ],
+    },
+];
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+const VENDOR_RE = /(^|\/)(?:vendor|node_modules|runtime|tests\/_data)(\/|$)/;
+const SAMPLE_LIMIT = 5;
+export async function yii3MigrationAudit(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const sampleLimit = options?.max_samples_per_category ?? SAMPLE_LIMIT;
+    const includeVendor = options?.include_vendor ?? false;
+    const filePattern = options?.file_pattern;
+    // Pick PHP files under non-vendor paths. The CodeIndex tracks .php under
+    // many roots; we just filter here so callers don't need to pre-trim.
+    const phpFiles = index.files.filter((f) => {
+        if (!f.path.endsWith(".php"))
+            return false;
+        if (!includeVendor && VENDOR_RE.test(f.path))
+            return false;
+        if (filePattern && !f.path.includes(filePattern))
+            return false;
+        return true;
+    });
+    // One bucket per category; we keep raw counts + first N samples and
+    // collapse to the public CategoryFinding shape at the end.
+    const buckets = new Map();
+    for (const cat of CATEGORIES) {
+        buckets.set(cat.category, { count: 0, samples: [], files: new Set() });
+    }
+    // Read every file once, run all 21 categories against the same source
+    // string. This is much faster than 21 separate scans (one fs read vs N).
+    const readResults = await Promise.allSettled(phpFiles.map(async (f) => ({
+        path: f.path,
+        content: await readFile(join(index.root, f.path), "utf-8"),
+    })));
+    for (const r of readResults) {
+        if (r.status !== "fulfilled")
+            continue;
+        const { path, content } = r.value;
+        for (const cat of CATEGORIES) {
+            const b = buckets.get(cat.category);
+            for (const pat of cat.patterns) {
+                // Each regex must be /g; we manually reset lastIndex so categories
+                // don't poison each other across patterns. The catalog above is
+                // /g everywhere — this is a guard for future additions.
+                pat.lastIndex = 0;
+                let m;
+                while ((m = pat.exec(content)) !== null) {
+                    b.count++;
+                    b.files.add(path);
+                    if (b.samples.length < sampleLimit) {
+                        const line = countLinesUntil(content, m.index);
+                        const snippet = extractLineAt(content, m.index);
+                        b.samples.push({ file: path, line, snippet });
+                    }
+                }
+            }
+        }
+    }
+    // Roll up
+    const byCategory = CATEGORIES.map((cat) => {
+        const b = buckets.get(cat.category);
+        return {
+            category: cat.category,
+            severity: cat.severity,
+            count: b.count,
+            effort_per_call: cat.effort_per_call,
+            description: cat.description,
+            yii3_replacement: cat.yii3_replacement,
+            sample_files: b.samples,
+        };
+    })
+        .filter((f) => f.count > 0)
+        .sort((a, b) => {
+        const sevOrder = {
+            critical: 0,
+            high: 1,
+            medium: 2,
+            low: 3,
+        };
+        return (sevOrder[a.severity] - sevOrder[b.severity] || b.count - a.count);
+    });
+    const bySeverity = {
+        critical: 0,
+        high: 0,
+        medium: 0,
+        low: 0,
+    };
+    let totalCalls = 0;
+    let hoursLow = 0;
+    let hoursHigh = 0;
+    for (const f of byCategory) {
+        bySeverity[f.severity] += f.count;
+        totalCalls += f.count;
+        const [lo, hi] = EFFORT_HOURS[f.effort_per_call];
+        hoursLow += f.count * lo;
+        hoursHigh += f.count * hi;
+    }
+    // Blockers: critical-severity categories with non-trivial volume.
+    // The threshold is intentionally high — a Yii3 migration is always going
+    // to require some manual rework; we only flag the categories that would
+    // dominate the schedule.
+    const blockers = [];
+    for (const f of byCategory) {
+        if (f.severity !== "critical")
+            continue;
+        if (f.count < 10)
+            continue;
+        const fileCount = buckets.get(f.category).files.size;
+        blockers.push({
+            category: f.category,
+            reason: `${f.count} call sites in ${fileCount} files — ${f.description}`,
+            related_files_count: fileCount,
+        });
+    }
+    // Decision signal — coarse heuristic for the executive summary.
+    let decisionSignal;
+    if (blockers.length === 0 && totalCalls < 500) {
+        decisionSignal = "consider-yii3";
+    }
+    else if (blockers.length === 0 && totalCalls < 2000) {
+        decisionSignal = "consider-yii3";
+    }
+    else if (blockers.length <= 2 && totalCalls < 5000) {
+        decisionSignal = "high-effort-yii3";
+    }
+    else if (blockers.length >= 3 || totalCalls >= 5000) {
+        decisionSignal = "blocked";
+    }
+    else {
+        decisionSignal = "stay-on-yii2";
+    }
+    // Composer-derived metadata — best-effort.
+    const composerMeta = await readComposerMeta(index.root);
+    return {
+        repo,
+        scanned_files: phpFiles.length,
+        total_call_sites: totalCalls,
+        by_category: byCategory,
+        by_severity: bySeverity,
+        blockers,
+        effort_estimate: {
+            hours_low: Math.round(hoursLow),
+            hours_high: Math.round(hoursHigh),
+            note: "Per-call estimates from CategoryDefinition.effort_per_call. Real " +
+                "migrations take 2-4× longer due to integration tests, edge cases, " +
+                "and team learning curve. Treat the high bound as a floor.",
+        },
+        decision_signal: decisionSignal,
+        yii_version_detected: composerMeta.yiiVersion,
+        php_version_required: composerMeta.phpRequirement,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function countLinesUntil(source, idx) {
+    let line = 1;
+    for (let i = 0; i < idx; i++) {
+        if (source.charCodeAt(i) === 10)
+            line++;
+    }
+    return line;
+}
+function extractLineAt(source, idx) {
+    const start = source.lastIndexOf("\n", idx) + 1;
+    const end = source.indexOf("\n", idx);
+    const line = source.slice(start, end === -1 ? source.length : end);
+    return line.trim().slice(0, 200);
+}
+async function readComposerMeta(root) {
+    try {
+        const raw = await readFile(join(root, "composer.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const requires = parsed.require ?? {};
+        const yiiVersion = requires["yiisoft/yii2"] ?? null;
+        const phpRequirement = requires.php ?? null;
+        return { yiiVersion, phpRequirement };
+    }
+    catch {
+        return { yiiVersion: null, phpRequirement: null };
+    }
+}
+//# sourceMappingURL=yii3-migration-tools.js.map

package/dist/tools/yii3-migration-tools.js.map

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

package/dist/types.d.ts

@@ -147,6 +147,10 @@ export interface TextMatch {
     context_before?: string[];
     context_after?: string[];
     containing_symbol?: ContainingSymbol;
+    /** Set when the search aborted on a wall-clock cap. The single returned match
+     * carries the hint so agents see actionable guidance instead of a hang. */
+    truncated?: boolean;
+    hint?: string;
 }
 export interface TextMatchGroup {
     file: string;
@@ -181,7 +185,7 @@ export interface ImpactResult {
 }
 export interface EmbeddingMeta {
     model: string;
-    provider: "voyage" | "openai" | "ollama";
+    provider: "voyage" | "openai" | "ollama" | "local";
     dimensions: number;
     symbol_count: number;
     updated_at: number;

package/dist/types.d.ts.map

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

package/dist/utils/constant-file-pattern.d.ts

@@ -1,6 +1,8 @@
 /**
  * Match indexed file paths against `resolve_constant_value` `file_pattern`.
- * Prefers exact or suffix matches; avoids loose substring false positives on short patterns.
+ * Prefers exact, suffix, or path-segment matches. The slash-free substring fallback
+ * requires a path-segment boundary (so `pattern="core"` matches `src/core/x.ts`
+ * but not `src/scoreboard.ts`).
  */
 export declare function matchesConstantFilePattern(file: string, pattern: string | undefined): boolean;
 //# sourceMappingURL=constant-file-pattern.d.ts.map

package/dist/utils/constant-file-pattern.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constant-file-pattern.d.ts","sourceRoot":"","sources":["../../src/utils/constant-file-pattern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAe7F"}
+{"version":3,"file":"constant-file-pattern.d.ts","sourceRoot":"","sources":["../../src/utils/constant-file-pattern.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAgB7F"}

package/dist/utils/constant-file-pattern.js

@@ -1,6 +1,8 @@
 /**
  * Match indexed file paths against `resolve_constant_value` `file_pattern`.
- * Prefers exact or suffix matches; avoids loose substring false positives on short patterns.
+ * Prefers exact, suffix, or path-segment matches. The slash-free substring fallback
+ * requires a path-segment boundary (so `pattern="core"` matches `src/core/x.ts`
+ * but not `src/scoreboard.ts`).
  */
 export function matchesConstantFilePattern(file, pattern) {
     if (!pattern)
@@ -20,8 +22,8 @@ export function matchesConstantFilePattern(file, pattern) {
     const lastSeg = f.split("/").pop() ?? f;
     if (lastSeg === p)
         return true;
-    if (p.length >= 4)
-        return f.includes(p);
-    return false;
+    // Pattern without slash: require a full path-segment match somewhere in `f`
+    // so we never match arbitrary substrings of unrelated names.
+    return f.split("/").includes(p);
 }
 //# sourceMappingURL=constant-file-pattern.js.map

package/dist/utils/constant-file-pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"constant-file-pattern.js","sourceRoot":"","sources":["../../src/utils/constant-file-pattern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,OAA2B;IAClF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7B,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;IACzC,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"constant-file-pattern.js","sourceRoot":"","sources":["../../src/utils/constant-file-pattern.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,OAA2B;IAClF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7B,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;IACzC,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,6DAA6D;IAC7D,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/heritage-edges.d.ts

@@ -0,0 +1,29 @@
+import type { CodeIndex } from "../types.js";
+export interface HeritageFileEdge {
+    from: string;
+    to: string;
+    kind: "extends" | "implements";
+}
+/** Counts of heritage refs that could not be turned into a file edge.
+ * `ambiguous`: simple name matched 2+ declarations (collision).
+ * `unresolved`: simple name matched no declared type. */
+export interface HeritageResolutionStats {
+    ambiguous: number;
+    unresolved: number;
+}
+/**
+ * Best-effort module-level edges from symbol `extends` / `implements`.
+ * Resolves each referenced type name to a file only when exactly one
+ * declaration (class / interface / type alias) with that simple name exists.
+ *
+ * Returns the edge list and a `stats` block counting heritage refs that could
+ * not be resolved (ambiguous: 2+ declarations with same simple name; unresolved:
+ * no declared type with that name) so callers can surface the gap instead of
+ * silently dropping edges.
+ */
+export declare function collectHeritageFileEdgesWithStats(index: CodeIndex): {
+    edges: HeritageFileEdge[];
+    stats: HeritageResolutionStats;
+};
+export declare function collectHeritageFileEdges(index: CodeIndex): HeritageFileEdge[];
+//# sourceMappingURL=heritage-edges.d.ts.map

package/dist/utils/heritage-edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heritage-edges.d.ts","sourceRoot":"","sources":["../../src/utils/heritage-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAKzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;CAChC;AAED;;yDAEyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqDD;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,SAAS,GAAG;IACnE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAoCA;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,EAAE,CAE7E"}