codesift-mcp 0.5.30 → 0.8.2

package/dist/tools/yii3-attribute-candidates-tools.js

@@ -0,0 +1,301 @@
+/**
+ * Yii3 attribute conversion candidates (M2).
+ *
+ * Yii3 is natively PHP 8 attribute-based. The mechanical mapping from
+ * Yii2 array-config idioms to Yii3 attributes is well-defined, but
+ * applying it across thousands of files is the bottleneck for any
+ * Yii2→Yii3 migration. This tool surfaces every site that's a candidate
+ * for the conversion + a proposed attribute form, capped by sample limit
+ * so the consumer can triage at their own pace.
+ *
+ * Conversions covered:
+ *
+ *   behaviors-to-attributes
+ *     behaviors() returning an array with TimestampBehavior /
+ *     BlameableBehavior / SluggableBehavior / etc → #[Behavior(class)] on
+ *     the class. We surface the entire behaviors() body in `current_form`
+ *     so the auditor sees the array-shape that needs conversion.
+ *
+ *   rules-to-attributes
+ *     rules() returning array of [['field'], 'validator'] tuples →
+ *     #[Required], #[Email], #[StringLength(min: 1)] on the property.
+ *     Each tuple becomes one or more proposed attributes.
+ *
+ *   urlmanager-rule-to-route
+ *     'GET api/users/<id>' => 'user/view' (in urlManager rules) →
+ *     #[Route(method: 'GET', path: '/api/users/{id}')] on the controller
+ *     action. We resolve the controller/action target from the rule's
+ *     right side. {param} placeholders are emitted but type constraints
+ *     are dropped (Yii2 supports inline regex like <id:\\d+>; Yii3 uses
+ *     route attributes like #[Route('/{id<int>}')]).
+ *
+ * Output shape:
+ *   - candidates[]    — flat list of all conversions
+ *   - by_rule[]       — grouped + sample-capped, sorted by count desc
+ *   - summary         — total + per-rule counts
+ *
+ * Like M1, this tool never auto-applies. Each candidate ships:
+ *   current_form         (the source as written today)
+ *   suggested_replacement (the attribute equivalent)
+ *   confidence           ("high" | "medium" | "low")
+ *   blockers[]           (string reasons the conversion may be unsafe —
+ *                         e.g. "rule references a Closure validator that
+ *                         can't be lifted to an attribute")
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+const VENDOR_RE = /(^|\/)(?:vendor|node_modules|runtime|tests\/_data)(\/|$)/;
+const SAMPLE_LIMIT = 5;
+export async function findYii3AttributeCandidates(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const sampleLimit = options?.max_samples_per_rule ?? SAMPLE_LIMIT;
+    const includeVendor = options?.include_vendor ?? false;
+    const filePattern = options?.file_pattern;
+    const ruleFilter = options?.rules ? new Set(options.rules) : null;
+    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;
+    });
+    const candidates = [];
+    // Symbol-level rules use the index directly.
+    if (!ruleFilter || ruleFilter.has("behaviors-to-attributes")) {
+        findBehaviorsToAttributes(index, candidates);
+    }
+    if (!ruleFilter || ruleFilter.has("rules-to-attributes")) {
+        findRulesToAttributes(index, candidates);
+    }
+    // File-level rule (urlmanager-rule-to-route) reads config files directly.
+    if (!ruleFilter || ruleFilter.has("urlmanager-rule-to-route")) {
+        await Promise.all(phpFiles
+            .filter((f) => /config\/(?:web|main|api|backend|frontend|common)(?:[-_][\w-]+)?\.php$/.test(f.path))
+            .map(async (f) => {
+            let content;
+            try {
+                content = await readFile(join(index.root, f.path), "utf-8");
+            }
+            catch {
+                return;
+            }
+            findUrlManagerRules(content, f.path, candidates);
+        }));
+    }
+    // Group + cap.
+    const byRuleMap = new Map();
+    for (const c of candidates) {
+        if (!byRuleMap.has(c.rule_id))
+            byRuleMap.set(c.rule_id, []);
+        byRuleMap.get(c.rule_id).push(c);
+    }
+    const byRule = [...byRuleMap.entries()]
+        .map(([rule_id, list]) => ({
+        rule_id,
+        count: list.length,
+        samples: list.slice(0, sampleLimit),
+    }))
+        .sort((a, b) => b.count - a.count);
+    return {
+        repo,
+        scanned_files: phpFiles.length,
+        total_candidates: candidates.length,
+        by_rule: byRule,
+        candidates,
+    };
+}
+// ---------------------------------------------------------------------------
+// Rule: behaviors() → #[Behavior(...)]
+// ---------------------------------------------------------------------------
+function findBehaviorsToAttributes(index, out) {
+    const behaviorsMethods = index.symbols.filter((s) => s.kind === "method" &&
+        s.name === "behaviors" &&
+        s.file.endsWith(".php") &&
+        s.source &&
+        !VENDOR_RE.test(s.file));
+    for (const m of behaviorsMethods) {
+        const src = m.source;
+        // Pull the body's `return [ ... ];` block. We don't try to walk
+        // every key; instead we count the entries that look like behavior
+        // class references and surface the whole body for the auditor.
+        const returnMatch = /return\s*\[([\s\S]*?)\]\s*;/.exec(src);
+        if (!returnMatch)
+            continue;
+        const body = returnMatch[1];
+        // Detect behavior classes — anything ending in "Behavior".
+        const behaviorRe = /([A-Z][\w]*Behavior)(?:::class|['"])/g;
+        const found = new Set();
+        let bm;
+        while ((bm = behaviorRe.exec(body)) !== null) {
+            found.add(bm[1]);
+        }
+        if (found.size === 0)
+            continue;
+        const blockers = [];
+        if (/=>\s*function\s*\(/.test(body)) {
+            blockers.push("behavior config contains closure — review manually");
+        }
+        const list = [...found];
+        out.push({
+            rule_id: "behaviors-to-attributes",
+            file: m.file,
+            line: m.start_line,
+            current_form: `behaviors() with ${list.length} entr${list.length === 1 ? "y" : "ies"}: ${list.join(", ")}`,
+            suggested_replacement: list
+                .map((b) => `#[Behavior(${b}::class)]`)
+                .join(" "),
+            confidence: blockers.length > 0 ? "medium" : "high",
+            blockers,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Rule: rules() → #[Required], #[Email], etc.
+// ---------------------------------------------------------------------------
+const VALIDATOR_TO_ATTRIBUTE = {
+    required: "Required",
+    email: "Email",
+    string: "StringLength",
+    integer: "IntegerValue",
+    number: "NumericValue",
+    url: "Url",
+    boolean: "BooleanValue",
+    date: "Date",
+    in: "InRange",
+    match: "RegexMatch",
+    unique: "Unique",
+    exist: "Exist",
+    default: "DefaultValue",
+    filter: "Callback",
+    safe: "Safe",
+};
+function findRulesToAttributes(index, out) {
+    const rulesMethods = index.symbols.filter((s) => s.kind === "method" &&
+        s.name === "rules" &&
+        s.file.endsWith(".php") &&
+        s.source &&
+        !VENDOR_RE.test(s.file));
+    for (const m of rulesMethods) {
+        const src = m.source;
+        const returnMatch = /return\s*\[([\s\S]*?)\]\s*;/.exec(src);
+        if (!returnMatch)
+            continue;
+        const body = returnMatch[1];
+        // Each rule is a tuple [['field' | ['field1', ...]], 'validator', …].
+        // We capture the first two positional arguments per tuple.
+        const tupleRe = /\[\s*(?:\[([^\]]+)\]|['"]([\w-]+)['"])\s*,\s*['"]([\w-]+)['"]/g;
+        const seen = new Map();
+        let tm;
+        while ((tm = tupleRe.exec(body)) !== null) {
+            const fields = (tm[1] ?? tm[2] ?? "")
+                .split(",")
+                .map((x) => x.trim().replace(/^['"]|['"]$/g, ""))
+                .filter(Boolean);
+            const validator = tm[3];
+            for (const f of fields) {
+                if (!seen.has(f))
+                    seen.set(f, new Set());
+                seen.get(f).add(validator);
+            }
+        }
+        if (seen.size === 0)
+            continue;
+        const blockers = [];
+        if (/=>\s*function\s*\(/.test(body)) {
+            blockers.push("rule references a closure validator — manual conversion");
+        }
+        for (const [field, validators] of seen.entries()) {
+            const attrs = [];
+            for (const v of validators) {
+                const mapped = VALIDATOR_TO_ATTRIBUTE[v];
+                if (mapped)
+                    attrs.push(`#[${mapped}]`);
+                else
+                    attrs.push(`#[Validator('${v}')]`);
+            }
+            out.push({
+                rule_id: "rules-to-attributes",
+                file: m.file,
+                line: m.start_line,
+                current_form: `rules() entry for $${field}: ${[...validators].join(", ")}`,
+                suggested_replacement: `${attrs.join(" ")} public mixed \$${field};`,
+                confidence: validators.size === 1 && VALIDATOR_TO_ATTRIBUTE[[...validators][0]] ? "high" : "medium",
+                blockers: [...blockers],
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Rule: urlManager rules → #[Route(...)]
+// ---------------------------------------------------------------------------
+function findUrlManagerRules(content, file, out) {
+    // Match `'GET api/users/<id>' => 'user/view'` style entries. Yii2
+    // urlManager also accepts unverbed forms ('home' => 'site/index'); we
+    // capture both. The right side is `controller/action[/sub]`.
+    const ruleRe = /['"](?:(GET|POST|PUT|DELETE|PATCH)\s+)?([^'"]+)['"]\s*=>\s*['"]([\w\/-]+)['"]/g;
+    let m;
+    while ((m = ruleRe.exec(content)) !== null) {
+        const verb = m[1] ?? null;
+        const pattern = m[2];
+        const target = m[3];
+        const line = countLines(content, m.index);
+        // Skip non-route contexts: rules() entries, validation messages, etc.
+        // Best heuristic: target must contain a "/" (controller/action shape).
+        if (!target.includes("/"))
+            continue;
+        // Reject obvious false positives: 'class' => 'app\\X' (FQCN target).
+        if (/\\/.test(target))
+            continue;
+        // Convert <param> and <param:regex> placeholders to Yii3 {param}.
+        // Regex constraints are dropped — Yii3 has its own attribute syntax.
+        const path = "/" +
+            pattern.replace(/<(\w+)(?::[^>]+)?>/g, "{$1}").replace(/^\//, "");
+        const targetSegments = target.split("/");
+        const action = targetSegments[targetSegments.length - 1];
+        const controller = targetSegments.slice(0, -1).join("/");
+        const blockers = [];
+        if (/<\w+:/.test(pattern)) {
+            blockers.push("rule has inline regex constraint — re-encode with Yii3 typed route");
+        }
+        if (target.split("/").length > 2) {
+            blockers.push("rule targets a module — verify Yii3 module mapping");
+        }
+        const verbDecl = verb ? `method: '${verb}'` : "";
+        const replacement = `#[Route(${[verbDecl, `path: '${path}'`].filter(Boolean).join(", ")})]\npublic function action${pascalize(action)}() { … }`;
+        out.push({
+            rule_id: "urlmanager-rule-to-route",
+            file,
+            line,
+            current_form: `'${verb ? verb + " " : ""}${pattern}' => '${target}'`,
+            suggested_replacement: `// On ${controller}Controller::action${pascalize(action)}:\n${replacement}`,
+            confidence: blockers.length === 0 ? "high" : "medium",
+            blockers,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function pascalize(s) {
+    return s
+        .split(/[-_]/)
+        .map((p) => (p.length > 0 ? p[0].toUpperCase() + p.slice(1) : ""))
+        .join("");
+}
+function countLines(source, idx) {
+    let line = 1;
+    for (let i = 0; i < idx; i++) {
+        if (source.charCodeAt(i) === 10)
+            line++;
+    }
+    return line;
+}
+//# sourceMappingURL=yii3-attribute-candidates-tools.js.map

package/dist/tools/yii3-attribute-candidates-tools.js.map

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

package/dist/tools/yii3-migration-tools.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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).
+ */
+export type Yii3MigrationCategoryName = "service-locator" | "object-factory" | "aliases" | "i18n" | "logger" | "application-props" | "module" | "request" | "response" | "session" | "user-identity" | "active-record" | "validators" | "form-model" | "widgets" | "view" | "url-manager" | "console" | "migrations" | "queue" | "rbac";
+export type Severity = "critical" | "high" | "medium" | "low";
+export type EffortBucket = "trivial" | "small" | "medium" | "large";
+export interface CategoryDefinition {
+    category: Yii3MigrationCategoryName;
+    severity: Severity;
+    description: string;
+    yii3_replacement: string;
+    effort_per_call: EffortBucket;
+    /** One or more regexes; a file is counted once per match. The regex must
+     *  be globally flagged so we can iterate matches in a single source pass. */
+    patterns: RegExp[];
+}
+export interface CategoryFinding {
+    category: Yii3MigrationCategoryName;
+    severity: Severity;
+    count: number;
+    effort_per_call: EffortBucket;
+    description: string;
+    yii3_replacement: string;
+    /** First few file:line:snippet triples — capped to keep output tight. */
+    sample_files: Array<{
+        file: string;
+        line: number;
+        snippet: string;
+    }>;
+}
+export interface Yii3MigrationAudit {
+    repo: string;
+    scanned_files: number;
+    total_call_sites: number;
+    by_category: CategoryFinding[];
+    by_severity: Record<Severity, number>;
+    blockers: Array<{
+        category: Yii3MigrationCategoryName;
+        reason: string;
+        related_files_count: number;
+    }>;
+    effort_estimate: {
+        hours_low: number;
+        hours_high: number;
+        note: string;
+    };
+    decision_signal: "stay-on-yii2" | "consider-yii3" | "high-effort-yii3" | "blocked";
+    yii_version_detected: string | null;
+    php_version_required: string | null;
+}
+export declare function yii3MigrationAudit(repo: string, options?: {
+    file_pattern?: string;
+    max_samples_per_category?: number;
+    include_vendor?: boolean;
+}): Promise<Yii3MigrationAudit>;
+//# sourceMappingURL=yii3-migration-tools.d.ts.map

package/dist/tools/yii3-migration-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yii3-migration-tools.d.ts","sourceRoot":"","sources":["../../src/tools/yii3-migration-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,MAAM,MAAM,yBAAyB,GACjC,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,GACT,MAAM,GACN,QAAQ,GACR,mBAAmB,GACnB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,SAAS,GACT,eAAe,GACf,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,MAAM,GACN,aAAa,GACb,SAAS,GACT,YAAY,GACZ,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,YAAY,CAAC;IAC9B;iFAC6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,YAAY,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,YAAY,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,yBAAyB,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,eAAe,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,eAAe,EACX,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,SAAS,CAAC;IACd,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAqSD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GACA,OAAO,CAAC,kBAAkB,CAAC,CA2J7B"}