codesift-mcp 0.3.0 → 0.4.0

package/dist/tools/legacy-hono-conventions.js

@@ -0,0 +1,152 @@
+/**
+ * Legacy regex-based Hono convention extractor.
+ * Preserved as a kill-switch fallback (CODESIFT_LEGACY_HONO=1) during
+ * the migration to the tree-sitter AST extractor.
+ *
+ * This file is a verbatim copy of the original regex functions from
+ * project-tools.ts as of 2026-04-10 (pre-AST migration).
+ *
+ * DO NOT MODIFY — this is the frozen legacy implementation.
+ * Delete after 2-week migration window per spec rollback strategy.
+ */
+function parseHonoCalls(source) {
+    const calls = [];
+    const lines = source.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        const useMatch = line.match(/app\.(use|route|get|post|put|delete|all)\s*\(\s*["']([^"']+)["']\s*,\s*(.+)/);
+        if (useMatch) {
+            const args = useMatch[3].trim().replace(/\);?\s*$/, "").trim();
+            calls.push({ type: useMatch[1], path: useMatch[2], args, line: lineNum });
+            continue;
+        }
+        const globalUseMatch = line.match(/app\.use\s*\(\s*["']\*["']\s*,\s*(.+)/);
+        if (globalUseMatch) {
+            const args = globalUseMatch[1].trim().replace(/\);?\s*$/, "").trim();
+            calls.push({ type: "use", path: "*", args, line: lineNum });
+            continue;
+        }
+        const inlineMatch = line.match(/app\.(get|post|put|delete)\s*\(\s*["']([^"']+)["']\s*,/);
+        if (inlineMatch) {
+            calls.push({ type: inlineMatch[1], path: inlineMatch[2], args: "(inline handler)", line: lineNum });
+        }
+    }
+    return calls;
+}
+function extractMiddlewareName(args) {
+    const funcCall = args.match(/^(\w+)\s*\(/);
+    if (funcCall)
+        return funcCall[1];
+    const simple = args.match(/^(\w+)$/);
+    if (simple)
+        return simple[1];
+    return null;
+}
+function extractRateLimit(args) {
+    const match = args.match(/rateLimit\s*\(\s*(\d+)\s*,\s*(\d+)\s*\)/);
+    if (match)
+        return { max: parseInt(match[1]), window: parseInt(match[2]) };
+    return null;
+}
+function inferScope(path) {
+    if (path === "*")
+        return "global";
+    if (path.includes("/admin"))
+        return "admin";
+    if (path.includes("/webhook"))
+        return "webhook";
+    if (path.includes("/health"))
+        return "health";
+    if (path.includes("/public") || path.includes("/contests") || path.includes("/translations") || path.includes("/r/"))
+        return "public";
+    const segments = path.split("/").filter(Boolean);
+    if (segments.length >= 2)
+        return segments[1];
+    return "root";
+}
+export function legacyExtractHonoConventions(source, filePath) {
+    const calls = parseHonoCalls(source);
+    const importMap = new Map();
+    for (const line of source.split("\n")) {
+        const defaultImport = line.match(/import\s+(\w+)\s+from\s+["']([^"']+)["']/);
+        if (defaultImport)
+            importMap.set(defaultImport[1], defaultImport[2]);
+        const namedImport = line.match(/import\s+\{([^}]+)\}\s+from\s+["']([^"']+)["']/);
+        if (namedImport) {
+            const names = namedImport[1].split(",").map((n) => n.trim().split(/\s+as\s+/).pop().trim());
+            for (const name of names)
+                importMap.set(name, namedImport[2]);
+        }
+    }
+    const middleware_chains = [];
+    const rate_limits = [];
+    const route_mounts = [];
+    const authGroups = {};
+    let auth_middleware = null;
+    const scopeChains = new Map();
+    const scopeMwSeen = new Map();
+    let globalOrder = 0;
+    const scopeOrders = new Map();
+    for (const call of calls) {
+        if (call.type === "use") {
+            const mwName = extractMiddlewareName(call.args);
+            const rl = extractRateLimit(call.args);
+            if (rl) {
+                rate_limits.push({ file: filePath, line: call.line, max: rl.max, window: rl.window, applied_to_path: call.path !== "*" ? call.path : null, method: null });
+            }
+            else if (mwName) {
+                const scope = call.path === "*" ? "global" : inferScope(call.path ?? "");
+                if (!scopeMwSeen.has(scope))
+                    scopeMwSeen.set(scope, new Set());
+                const seen = scopeMwSeen.get(scope);
+                if (!seen.has(mwName)) {
+                    seen.add(mwName);
+                    const currentOrder = scope === "global" ? ++globalOrder : (scopeOrders.set(scope, (scopeOrders.get(scope) ?? 0) + 1), scopeOrders.get(scope));
+                    if (!scopeChains.has(scope))
+                        scopeChains.set(scope, []);
+                    scopeChains.get(scope).push({ name: mwName, line: call.line, order: currentOrder });
+                }
+                if (/auth|clerk|jwt|session|passport/i.test(mwName)) {
+                    auth_middleware = mwName;
+                    const group = inferScope(call.path ?? "");
+                    if (!authGroups[group])
+                        authGroups[group] = { requires_auth: false, middleware: [] };
+                    authGroups[group].requires_auth = true;
+                    if (!authGroups[group].middleware.includes(mwName))
+                        authGroups[group].middleware.push(mwName);
+                }
+                else if (scope !== "global") {
+                    const group = scope;
+                    if (!authGroups[group])
+                        authGroups[group] = { requires_auth: false, middleware: [] };
+                    if (!authGroups[group].middleware.includes(mwName))
+                        authGroups[group].middleware.push(mwName);
+                }
+            }
+        }
+        else if (call.type === "route") {
+            const varName = call.args.trim();
+            route_mounts.push({ file: filePath, line: call.line, mount_path: call.path ?? "", imported_from: importMap.get(varName) ?? null, exported_as: varName });
+            const group = inferScope(call.path ?? "");
+            if (!authGroups[group])
+                authGroups[group] = { requires_auth: false, middleware: [] };
+        }
+    }
+    for (const [scope, chain] of scopeChains) {
+        middleware_chains.push({ scope, file: filePath, chain });
+    }
+    const routeGroups = new Set();
+    for (const mount of route_mounts)
+        routeGroups.add(inferScope(mount.mount_path));
+    for (const call of calls) {
+        if (call.type !== "use" && call.type !== "route" && call.path)
+            routeGroups.add(inferScope(call.path));
+    }
+    for (const group of routeGroups) {
+        if (!authGroups[group])
+            authGroups[group] = { requires_auth: false, middleware: [] };
+    }
+    return { middleware_chains, rate_limits, route_mounts, auth_patterns: { auth_middleware, groups: authGroups } };
+}
+//# sourceMappingURL=legacy-hono-conventions.js.map

package/dist/tools/legacy-hono-conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-hono-conventions.js","sourceRoot":"","sources":["../../src/tools/legacy-hono-conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,6EAA6E,CAAC,CAAC;QAC3G,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAChG,SAAS;QACX,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3E,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACzF,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAsB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5H,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACpE,IAAI,KAAK;QAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5C,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtI,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc,EAAE,QAAgB;IAC3E,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC7E,IAAI,aAAa;YAAE,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAE,EAAE,aAAa,CAAC,CAAC,CAAE,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACjF,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,EAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9F,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAsB,EAAE,CAAC;IAChD,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,YAAY,GAAsB,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAqE,EAAE,CAAC;IACxF,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2D,CAAC;IACvF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;IACnD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,EAAE,EAAE,CAAC;gBACP,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7J,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBACzE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACjB,MAAM,YAAY,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC;oBAC/I,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;wBAAE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACxD,WAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;gBACvF,CAAC;gBACD,IAAI,kCAAkC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBACpD,eAAe,GAAG,MAAM,CAAC;oBACzB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;oBAC1C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;wBAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;oBACrF,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC;oBACvC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAAE,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChG,CAAC;qBAAM,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,MAAM,KAAK,GAAG,KAAK,CAAC;oBACpB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;wBAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;oBACrF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAAE,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YACzJ,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACvF,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QACzC,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,YAAY;QAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI;YAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACvF,CAAC;IAED,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;AAClH,CAAC"}

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

@@ -0,0 +1,26 @@
+export interface MigrationLintFinding {
+    file: string;
+    line: number;
+    rule: string;
+    level: "warning" | "error";
+    message: string;
+    url?: string;
+}
+export interface MigrationLintResult {
+    squawk_version?: string;
+    squawk_installed: boolean;
+    files_checked: number;
+    findings: MigrationLintFinding[];
+    by_severity: {
+        error: number;
+        warning: number;
+    };
+    by_rule: Record<string, number>;
+    install_hint?: string;
+}
+export declare function migrationLint(repo: string, options?: {
+    migration_glob?: string;
+    excluded_rules?: string[];
+    pg_version?: string;
+}): Promise<MigrationLintResult>;
+//# sourceMappingURL=migration-lint-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-lint-tools.d.ts","sourceRoot":"","sources":["../../src/tools/migration-lint-tools.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAsDD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAiJ9B"}

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

@@ -0,0 +1,247 @@
+/**
+ * migration_lint — PostgreSQL migration anti-pattern detection.
+ *
+ * Thin wrapper around the squawk CLI (https://github.com/sbdchd/squawk).
+ * Finds migration SQL files in the index, runs squawk --reporter Json on them,
+ * and aggregates findings by severity/rule.
+ *
+ * squawk is an optional external dependency; if it is not on PATH this tool
+ * returns a friendly install hint rather than throwing.
+ */
+import { execFile } from "node:child_process";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+import { matchFilePattern } from "../utils/glob.js";
+// Default glob patterns covering common migration layouts.
+const DEFAULT_MIGRATION_GLOBS = [
+    "prisma/migrations/**/*.sql",
+    "migrations/**/*.sql",
+    "db/migrate/**/*.sql",
+    "drizzle/**/*.sql",
+];
+const INSTALL_HINT = "squawk not found. Install: brew install squawk OR cargo install squawk-cli OR https://github.com/sbdchd/squawk#installation";
+function runExecFile(cmd, args, opts) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, opts, (err, stdout, stderr) => {
+            // Default encoding is utf-8 so stdout/stderr are strings here.
+            const out = (stdout ?? "");
+            const errOut = (stderr ?? "");
+            if (err) {
+                // Attach stdout/stderr so the caller can still parse JSON output even
+                // when squawk exits non-zero (it exits non-zero when findings exist).
+                const withIO = err;
+                withIO.stdout = out;
+                withIO.stderr = errOut;
+                reject(err);
+                return;
+            }
+            resolve({ stdout: out, stderr: errOut });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+export async function migrationLint(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    // ---- 1. Find migration files in the index -------------------------------
+    const globs = options?.migration_glob
+        ? [options.migration_glob]
+        : DEFAULT_MIGRATION_GLOBS;
+    const migrationFiles = index.files
+        .filter((f) => globs.some((g) => matchFilePattern(f.path, g)))
+        .map((f) => f.path);
+    // No files — return an empty, non-error result.
+    if (migrationFiles.length === 0) {
+        return {
+            squawk_installed: true,
+            files_checked: 0,
+            findings: [],
+            by_severity: { error: 0, warning: 0 },
+            by_rule: {},
+        };
+    }
+    // ---- 2. Probe squawk --version to detect installation -------------------
+    let squawkVersion;
+    try {
+        const { stdout } = await runExecFile("squawk", ["--version"], {
+            maxBuffer: 1 << 20, // 1 MB
+            timeout: 5_000,
+        });
+        squawkVersion = stdout.trim() || undefined;
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            return {
+                squawk_installed: false,
+                files_checked: migrationFiles.length,
+                findings: [],
+                by_severity: { error: 0, warning: 0 },
+                by_rule: {},
+                install_hint: INSTALL_HINT,
+            };
+        }
+        // Some other problem (e.g. squawk crashed on --version). Treat as not
+        // usable but surface the hint so the agent can guide the user.
+        return {
+            squawk_installed: false,
+            files_checked: migrationFiles.length,
+            findings: [],
+            by_severity: { error: 0, warning: 0 },
+            by_rule: {},
+            install_hint: INSTALL_HINT,
+        };
+    }
+    // ---- 3. Build squawk CLI args ------------------------------------------
+    const cliArgs = ["--reporter", "Json"];
+    if (options?.pg_version) {
+        cliArgs.push("--pg-version", options.pg_version);
+    }
+    if (options?.excluded_rules && options.excluded_rules.length > 0) {
+        cliArgs.push("--exclude", options.excluded_rules.join(","));
+    }
+    // Pass absolute paths so squawk does not depend on CWD.
+    for (const relPath of migrationFiles) {
+        cliArgs.push(join(index.root, relPath));
+    }
+    // ---- 4. Run squawk ------------------------------------------------------
+    let stdout = "";
+    try {
+        const res = await runExecFile("squawk", cliArgs, {
+            maxBuffer: 32 * 1024 * 1024, // 32 MB
+            timeout: 60_000,
+        });
+        stdout = res.stdout;
+    }
+    catch (err) {
+        // squawk exits non-zero when there are findings — that's expected.
+        // The stdout is attached to the error by runExecFile.
+        const attached = err.stdout;
+        if (attached) {
+            stdout = attached;
+        }
+        else if (isEnoent(err)) {
+            return {
+                squawk_installed: false,
+                files_checked: migrationFiles.length,
+                findings: [],
+                by_severity: { error: 0, warning: 0 },
+                by_rule: {},
+                install_hint: INSTALL_HINT,
+            };
+        }
+        else {
+            // Surface a structured error result so agents can still reason about it.
+            const result = {
+                squawk_installed: true,
+                files_checked: migrationFiles.length,
+                findings: [],
+                by_severity: { error: 0, warning: 0 },
+                by_rule: {},
+            };
+            if (squawkVersion)
+                result.squawk_version = squawkVersion;
+            return result;
+        }
+    }
+    // ---- 5. Parse squawk JSON ----------------------------------------------
+    const raw = parseSquawkOutput(stdout);
+    const rootPrefix = index.root.endsWith("/") ? index.root : index.root + "/";
+    const findings = raw.map((r) => {
+        // Normalise file paths back to repo-relative when possible.
+        let filePath = r.file;
+        if (filePath.startsWith(rootPrefix)) {
+            filePath = filePath.slice(rootPrefix.length);
+        }
+        const level = String(r.level).toLowerCase() === "error" ? "error" : "warning";
+        const finding = {
+            file: filePath,
+            line: typeof r.line === "number" ? r.line : Number(r.line ?? 0) || 0,
+            rule: String(r.rule_name ?? r.rule ?? "unknown"),
+            level,
+            message: String(r.message ?? ""),
+        };
+        if (r.url)
+            finding.url = String(r.url);
+        return finding;
+    });
+    // ---- 6. Aggregate -------------------------------------------------------
+    const by_severity = { error: 0, warning: 0 };
+    const by_rule = {};
+    for (const f of findings) {
+        by_severity[f.level] += 1;
+        by_rule[f.rule] = (by_rule[f.rule] ?? 0) + 1;
+    }
+    const result = {
+        squawk_installed: true,
+        files_checked: migrationFiles.length,
+        findings,
+        by_severity,
+        by_rule,
+    };
+    if (squawkVersion)
+        result.squawk_version = squawkVersion;
+    return result;
+}
+/**
+ * squawk --reporter Json can emit either a single JSON array or one JSON
+ * object per line (NDJSON). We handle both.
+ */
+function parseSquawkOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return [];
+    // Try array first
+    if (trimmed.startsWith("[")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // fall through to NDJSON
+        }
+    }
+    // Try single object
+    if (trimmed.startsWith("{")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed))
+                return parsed;
+            if (parsed && typeof parsed === "object")
+                return [parsed];
+        }
+        catch {
+            // fall through to NDJSON
+        }
+    }
+    // NDJSON — one object per line
+    const results = [];
+    for (const line of trimmed.split(/\r?\n/)) {
+        const l = line.trim();
+        if (!l)
+            continue;
+        try {
+            const parsed = JSON.parse(l);
+            if (Array.isArray(parsed)) {
+                results.push(...parsed);
+            }
+            else if (parsed && typeof parsed === "object") {
+                results.push(parsed);
+            }
+        }
+        catch {
+            // Skip non-JSON lines (squawk sometimes prints a header/footer).
+        }
+    }
+    return results;
+}
+function isEnoent(err) {
+    return (!!err
+        && typeof err === "object"
+        && "code" in err
+        && err.code === "ENOENT");
+}
+//# sourceMappingURL=migration-lint-tools.js.map

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

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

package/dist/tools/model-tools.d.ts

@@ -0,0 +1,30 @@
+export interface ModelNode {
+    name: string;
+    file: string;
+    fields: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+export interface ModelEdge {
+    from: string;
+    to: string;
+    field: string;
+    relationship: "fk" | "o2o" | "m2m" | "relationship";
+}
+export interface ModelGraph {
+    models: ModelNode[];
+    edges: ModelEdge[];
+    framework: "django" | "sqlalchemy" | "unknown";
+}
+/**
+ * Extract ORM model relationships from a repository.
+ * Scans model classes for Django and SQLAlchemy relationship declarations.
+ */
+export declare function getModelGraph(repo: string, options?: {
+    file_pattern?: string;
+    output_format?: "json" | "mermaid";
+}): Promise<ModelGraph | {
+    mermaid: string;
+}>;
+//# sourceMappingURL=model-tools.d.ts.map

package/dist/tools/model-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-tools.d.ts","sourceRoot":"","sources":["../../src/tools/model-tools.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,cAAc,CAAC;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CAChD;AAiBD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,OAAO,CAAC,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmH3C"}

package/dist/tools/model-tools.js

@@ -0,0 +1,145 @@
+/**
+ * ORM model relationship graph extraction.
+ * Supports Django (ForeignKey, ManyToManyField, OneToOneField) and
+ * SQLAlchemy (relationship, ForeignKey Column).
+ */
+import { getCodeIndex } from "./index-tools.js";
+// Django relationship field patterns
+const DJANGO_FK_RE = /(\w+)\s*=\s*(?:models\.)?ForeignKey\s*\(\s*['"]?(\w+)['"]?/g;
+const DJANGO_O2O_RE = /(\w+)\s*=\s*(?:models\.)?OneToOneField\s*\(\s*['"]?(\w+)['"]?/g;
+const DJANGO_M2M_RE = /(\w+)\s*=\s*(?:models\.)?ManyToManyField\s*\(\s*['"]?(\w+)['"]?/g;
+// SQLAlchemy relationship patterns
+const SQLA_REL_RE = /(\w+)\s*=\s*relationship\s*\(\s*['"](\w+)['"]/g;
+const SQLA_FK_COL_RE = /(\w+)\s*=\s*Column\s*\([^)]*ForeignKey\s*\(\s*['"](\w+)\.(\w+)['"]/g;
+// Django field type extraction (non-relationship fields)
+const DJANGO_FIELD_RE = /(\w+)\s*=\s*(?:models\.)?(\w+Field)\s*\(/g;
+// SQLAlchemy Column type extraction
+const SQLA_COL_RE = /(\w+)\s*=\s*Column\s*\(\s*(\w+)/g;
+/**
+ * Extract ORM model relationships from a repository.
+ * Scans model classes for Django and SQLAlchemy relationship declarations.
+ */
+export async function getModelGraph(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const filePattern = options?.file_pattern;
+    // Find model classes — Python classes that look like ORM models.
+    // Strict detection: must have ORM-specific field patterns in source,
+    // not just a generic base class name like "Base" (which Flask uses).
+    const modelSymbols = index.symbols.filter((s) => {
+        if (s.kind !== "class")
+            return false;
+        if (!s.file.endsWith(".py"))
+            return false;
+        if (filePattern && !s.file.includes(filePattern))
+            return false;
+        const source = s.source ?? "";
+        // Strong Django signals: explicit models.Model import + Field types
+        const isDjangoModel = source.includes("models.Model")
+            || /models\.(CharField|IntegerField|ForeignKey|ManyToManyField|OneToOneField|DateTimeField|BooleanField|TextField)/.test(source);
+        // Strong SQLAlchemy signals: Column(Type) declaration or relationship()
+        const isSQLAlchemy = /=\s*Column\s*\(/.test(source)
+            || /=\s*relationship\s*\(/.test(source)
+            || /__tablename__\s*=/.test(source);
+        return isDjangoModel || isSQLAlchemy;
+    });
+    const models = [];
+    const edges = [];
+    let framework = "unknown";
+    for (const sym of modelSymbols) {
+        const source = sym.source ?? "";
+        const fields = [];
+        // Detect framework
+        if (source.includes("models.Model") || (source.includes("ForeignKey") && source.includes("on_delete"))) {
+            framework = "django";
+        }
+        else if (source.includes("Column(") || source.includes("relationship(")) {
+            framework = "sqlalchemy";
+        }
+        // Extract Django relationships
+        for (const [re, relType] of [
+            [DJANGO_FK_RE, "fk"],
+            [DJANGO_O2O_RE, "o2o"],
+            [DJANGO_M2M_RE, "m2m"],
+        ]) {
+            re.lastIndex = 0;
+            let match;
+            while ((match = re.exec(source)) !== null) {
+                const fieldName = match[1];
+                const targetModel = match[2];
+                edges.push({
+                    from: sym.name,
+                    to: targetModel,
+                    field: fieldName,
+                    relationship: relType,
+                });
+                fields.push({ name: fieldName, type: `${relType}(${targetModel})` });
+            }
+        }
+        // Extract SQLAlchemy relationships
+        SQLA_REL_RE.lastIndex = 0;
+        let relMatch;
+        while ((relMatch = SQLA_REL_RE.exec(source)) !== null) {
+            edges.push({
+                from: sym.name,
+                to: relMatch[2],
+                field: relMatch[1],
+                relationship: "relationship",
+            });
+            fields.push({ name: relMatch[1], type: `relationship(${relMatch[2]})` });
+        }
+        // Extract SQLAlchemy FK columns
+        SQLA_FK_COL_RE.lastIndex = 0;
+        let fkMatch;
+        while ((fkMatch = SQLA_FK_COL_RE.exec(source)) !== null) {
+            const targetTable = fkMatch[2];
+            // Convert table name to model name (best effort: capitalize)
+            const targetModel = targetTable.charAt(0).toUpperCase() + targetTable.slice(1);
+            edges.push({
+                from: sym.name,
+                to: targetModel,
+                field: fkMatch[1],
+                relationship: "fk",
+            });
+        }
+        // Extract non-relationship fields
+        DJANGO_FIELD_RE.lastIndex = 0;
+        let fieldMatch;
+        while ((fieldMatch = DJANGO_FIELD_RE.exec(source)) !== null) {
+            // Skip if already captured as a relationship
+            if (!fields.some((f) => f.name === fieldMatch[1])) {
+                fields.push({ name: fieldMatch[1], type: fieldMatch[2] });
+            }
+        }
+        SQLA_COL_RE.lastIndex = 0;
+        while ((fieldMatch = SQLA_COL_RE.exec(source)) !== null) {
+            if (!fields.some((f) => f.name === fieldMatch[1])) {
+                fields.push({ name: fieldMatch[1], type: fieldMatch[2] });
+            }
+        }
+        models.push({ name: sym.name, file: sym.file, fields });
+    }
+    const graph = { models, edges, framework };
+    if (options?.output_format === "mermaid") {
+        return { mermaid: graphToMermaid(graph) };
+    }
+    return graph;
+}
+function graphToMermaid(graph) {
+    const lines = ["erDiagram"];
+    for (const model of graph.models) {
+        lines.push(`  ${model.name} {`);
+        for (const field of model.fields) {
+            lines.push(`    ${field.type} ${field.name}`);
+        }
+        lines.push("  }");
+    }
+    for (const edge of graph.edges) {
+        const rel = edge.relationship === "m2m" ? "}o--o{" :
+            edge.relationship === "o2o" ? "||--||" : "||--o{";
+        lines.push(`  ${edge.from} ${rel} ${edge.to} : "${edge.field}"`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=model-tools.js.map

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

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