codesift-mcp 0.9.0 → 0.9.10

package/dist/register-tool-groups/astro.js

@@ -0,0 +1,302 @@
+import { z, lazySchema } from "./shared.js";
+import { getCodeIndex, astroAnalyzeIslands, astroHydrationAudit, astroRouteMap, astroActionsAudit, astroAudit, astroConfigAnalyze, astroContentCollections, astroMiddlewareAudit, astroSessionsAudit, astroDbAudit, astroEnvValidator, astroImageAudit, astroSvgComponents, astroMigrationCheck } from "./deps.js";
+export const ASTRO_TOOL_ENTRIES = [
+    // --- Astro tools ---
+    { order: 4132, definition: {
+            name: "astro_analyze_islands",
+            category: "analysis",
+            searchHint: "astro islands client hydration directives framework",
+            description: "Analyze Astro islands (client:* directives) in a repo. Finds all interactive components with hydration directives, lists server islands with fallback status, and optionally generates optimization recommendations.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                path_prefix: z.string().optional().describe("Only scan files under this path prefix"),
+                include_recommendations: z.boolean().default(true).describe("Include optimization recommendations (default: true)"),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                if (args.path_prefix != null)
+                    opts.path_prefix = args.path_prefix;
+                if (args.include_recommendations != null)
+                    opts.include_recommendations = args.include_recommendations;
+                return await astroAnalyzeIslands(opts);
+            },
+        } },
+    { order: 4150, definition: {
+            name: "astro_hydration_audit",
+            category: "analysis",
+            searchHint: "astro hydration audit anti-patterns client load",
+            description: "Audit Astro hydration usage for anti-patterns such as client:load on heavy components, missing client directives, or suboptimal hydration strategies. Returns issues grouped by severity with a letter grade.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                severity: z.enum(["all", "warnings", "errors"]).default("all").describe("Filter issues by severity (default: all)"),
+                path_prefix: z.string().optional().describe("Only scan files under this path prefix"),
+                fail_on: z.enum(["error", "warning", "info"]).optional().describe("Set exit_code gate: 'error' exits 1 on any errors; 'warning' exits 2 on warnings; 'info' exits 2 on info or warnings"),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                if (args.severity != null)
+                    opts.severity = args.severity;
+                if (args.path_prefix != null)
+                    opts.path_prefix = args.path_prefix;
+                if (args.fail_on != null)
+                    opts.fail_on = args.fail_on;
+                return await astroHydrationAudit(opts);
+            },
+        } },
+    { order: 4170, definition: {
+            name: "astro_route_map",
+            category: "navigation",
+            searchHint: "astro routes pages endpoints file-based routing",
+            description: "Map all Astro routes (pages + API endpoints) discovered from the file-based routing structure. Returns routes with type, dynamic params, and handler symbols. Supports json/tree/table output formats.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                include_endpoints: z.boolean().default(true).describe("Include API endpoint routes (default: true)"),
+                output_format: z.enum(["json", "tree", "table"]).default("json").describe("Output format: json | tree | table (default: json)"),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                if (args.include_endpoints != null)
+                    opts.include_endpoints = args.include_endpoints;
+                if (args.output_format != null)
+                    opts.output_format = args.output_format;
+                return await astroRouteMap(opts);
+            },
+        } },
+    { order: 4188, definition: {
+            name: "astro_config_analyze",
+            category: "analysis",
+            searchHint: "astro config integrations adapter output mode",
+            description: "Analyze an Astro project's configuration file (astro.config.mjs/ts/js). Extracts output mode (static/server/hybrid), adapter, integrations, site URL, and base path. Identifies dynamic/unresolved config.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+            })),
+            handler: async (args) => {
+                const index = await getCodeIndex(args.repo ?? "");
+                if (!index)
+                    throw new Error("Repository not found — run index_folder first");
+                return await astroConfigAnalyze({ project_root: index.root });
+            },
+        } },
+    { order: 4202, definition: {
+            name: "astro_actions_audit",
+            category: "analysis",
+            searchHint: "astro actions defineAction zod refine passthrough multipart file enctype audit",
+            description: "Audit Astro Actions (src/actions/index.ts) for 6 known anti-patterns (AA01-AA06): missing handler return, top-level .refine() (Astro issue #11641), .passthrough() usage (issue #11693), File schema without multipart form, server-side invocation via actions.xxx(), and client calls to unknown actions. Returns issues grouped by severity with an A/B/C/D score.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                severity: z.enum(["all", "warnings", "errors"]).default("all").describe("Filter issues by severity (default: all)"),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                if (args.severity != null)
+                    opts.severity = args.severity;
+                return await astroActionsAudit(opts);
+            },
+        } },
+    { order: 4218, definition: {
+            name: "astro_content_collections",
+            category: "analysis",
+            searchHint: "astro content collections defineCollection zod schema reference glob loader frontmatter",
+            description: "Parse an Astro content collections config (src/content.config.ts or legacy src/content/config.ts), extract each collection's loader + Zod schema fields, build a reference() graph, and optionally validate entry frontmatter against required fields.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                validate_entries: z.boolean().default(true).describe("Validate entry frontmatter against required schema fields (default: true)"),
+            })),
+            handler: async (args) => {
+                const index = await getCodeIndex(args.repo ?? "");
+                if (!index)
+                    throw new Error("Repository not found — run index_folder first");
+                const opts = { project_root: index.root };
+                if (args.validate_entries != null)
+                    opts.validate_entries = args.validate_entries;
+                return await astroContentCollections(opts);
+            },
+        } },
+    { order: 4235, definition: {
+            name: "astro_audit",
+            category: "analysis",
+            searchHint: "astro meta audit full health check score gates recommendations islands hydration routes config actions content migration patterns workspace monorepo",
+            description: "One-call Astro project health check: runs all 7 Astro tools + 13 Astro patterns in parallel, returns unified {score, gates, sections, recommendations}. Pass workspace=<name|path> in monorepos to scope to a single workspace.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                workspace: z.string().optional().describe("Monorepo workspace name or path. Scopes the audit to that workspace."),
+                skip: z.array(z.string()).optional().describe("Sections to skip: config, hydration, routes, actions, content, migration, patterns"),
+            })),
+            handler: async (args) => {
+                const { resolveWorkspaceScope } = await import("../tools/workspace-scope-helper.js");
+                const scope = await resolveWorkspaceScope(args.repo ?? "", args.workspace, "astro");
+                if ("error" in scope) {
+                    return { error: scope.error, input: scope.input, available: scope.available };
+                }
+                const opts = {};
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                if (args.skip != null)
+                    opts.skip = args.skip;
+                if (scope.rootPaths.length > 0) {
+                    opts.file_pattern = `${scope.rootPaths[0]}/**`;
+                }
+                return await astroAudit(opts);
+            },
+        } },
+    // --- Astro 5 sub-tools (Task 12). Discoverable via describe_tools — NOT in CORE. ---
+    { order: 4262, definition: {
+            name: "astro_middleware",
+            category: "analysis",
+            searchHint: "astro middleware onRequest sequence guards routes protected auth flows",
+            description: "Parses src/middleware.ts (or .js) — detects onRequest exports, sequence(...) ordering, and guard if-blocks lacking redirect/throw/return Response. Issue codes MW00–MW03.",
+            schema: lazySchema(() => ({
+                project_root: z.string().optional().describe("Absolute path to project root (default: auto-detected)"),
+                repo: z.string().optional(),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.project_root != null)
+                    opts.project_root = args.project_root;
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                return await astroMiddlewareAudit(opts);
+            },
+        } },
+    { order: 4278, definition: {
+            name: "astro_sessions",
+            category: "analysis",
+            searchHint: "astro sessions experimental session adapter compatibility node vercel cloudflare",
+            description: "Astro 5 Sessions API audit. Detects Astro.session.* / context.session.* usage; cross-checks experimental.session config + adapter compatibility. Issue codes SE01–SE04.",
+            schema: lazySchema(() => ({
+                project_root: z.string().optional(),
+                repo: z.string().optional(),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.project_root != null)
+                    opts.project_root = args.project_root;
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                return await astroSessionsAudit(opts);
+            },
+        } },
+    { order: 4294, definition: {
+            name: "astro_db_audit",
+            category: "analysis",
+            searchHint: "astro db defineTable schema columns foreign key index n+1 query loop",
+            description: "Astro DB audit. Parses db/config.ts defineTable schemas; detects N+1 query patterns (db.select inside loops via AST), missing FK indexes (per-table scoped), reference cycles. Codes DB00–DB04.",
+            schema: lazySchema(() => ({
+                project_root: z.string().optional(),
+                repo: z.string().optional(),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.project_root != null)
+                    opts.project_root = args.project_root;
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                return await astroDbAudit(opts);
+            },
+        } },
+    { order: 4310, definition: {
+            name: "astro_env_validator",
+            category: "analysis",
+            searchHint: "astro env envField schema astro:env client server context import.meta.env",
+            description: "Astro 5 astro:env validator. Parses env.schema (envField) and cross-checks against import.meta.env + astro:env/{client,server} imports. Codes EV01–EV04.",
+            schema: lazySchema(() => ({
+                project_root: z.string().optional(),
+                repo: z.string().optional(),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.project_root != null)
+                    opts.project_root = args.project_root;
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                return await astroEnvValidator(opts);
+            },
+        } },
+    { order: 4326, definition: {
+            name: "astro_image_audit",
+            category: "analysis",
+            searchHint: "astro image img alt accessibility Picture astro:assets getImage optimization",
+            description: "Scans .astro pages for image usage: raw <img> vs <Image>/<Picture>, missing/empty alt attributes, getImage() without astro:assets import. Codes IM01–IM04.",
+            schema: lazySchema(() => ({
+                project_root: z.string().optional(),
+                repo: z.string().optional(),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.project_root != null)
+                    opts.project_root = args.project_root;
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                return await astroImageAudit(opts);
+            },
+        } },
+    { order: 4342, definition: {
+            name: "astro_svg_components",
+            category: "analysis",
+            searchHint: "astro svg component import legacy ?component native astro 5",
+            description: "Detects *.svg?component imports, tracks per-file usage, flags legacy ?component on Astro 5+, surfaces PascalCase tags used without imports. Codes SV01–SV03.",
+            schema: lazySchema(() => ({
+                project_root: z.string().optional(),
+                repo: z.string().optional(),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.project_root != null)
+                    opts.project_root = args.project_root;
+                if (args.repo != null)
+                    opts.repo = args.repo;
+                return await astroSvgComponents(opts);
+            },
+        } },
+    // --- Astro v6 migration check ---
+    { order: 4929, definition: {
+            name: "astro_migration_check",
+            category: "analysis",
+            searchHint: "astro v6 migration upgrade breaking changes compatibility check AM01 AM10 content collections ViewTransitions",
+            description: "Scan an Astro project for v5→v6 breaking changes. Detects 10 issues (AM01–AM10): removed APIs (Astro.glob, emitESMImage), component renames (ViewTransitions→ClientRouter), content collection config changes, Node.js version requirements, Zod 4 deprecations, hybrid output mode, and removed integrations (@astrojs/lit). Returns a migration report with per-issue effort estimates.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                target_version: z.enum(["6"]).optional().describe("Target Astro version (default: '6')"),
+            })),
+            handler: async (args) => {
+                const mcArgs = {};
+                if (args.repo != null)
+                    mcArgs.repo = args.repo;
+                if (args.target_version != null)
+                    mcArgs.target_version = args.target_version;
+                const result = await astroMigrationCheck(mcArgs);
+                const lines = [];
+                lines.push(`ASTRO MIGRATION CHECK: v${result.current_version ?? "unknown"} → v${result.target_version}`);
+                lines.push(`Issues: ${result.summary.total_issues} | Estimated: ${result.summary.estimated_migration_hours}`);
+                if (Object.keys(result.summary.by_effort).length > 0) {
+                    const effortStr = Object.entries(result.summary.by_effort)
+                        .map(([k, v]) => `${v}×${k}`)
+                        .join(", ");
+                    lines.push(`Effort: ${effortStr}`);
+                }
+                if (result.breaking_changes.length === 0) {
+                    lines.push("\n✓ No v6 breaking changes detected.");
+                }
+                else {
+                    lines.push("");
+                    for (const issue of result.breaking_changes) {
+                        const sev = issue.severity === "error" ? "✗" : issue.severity === "warning" ? "⚠" : "ℹ";
+                        lines.push(`${sev} ${issue.code} [${issue.category}] — ${issue.message}`);
+                        lines.push(`  effort: ${issue.effort} | files: ${issue.files.slice(0, 3).join(", ")}${issue.files.length > 3 ? ` +${issue.files.length - 3} more` : ""}`);
+                        if (issue.migration_guide)
+                            lines.push(`  guide: ${issue.migration_guide}`);
+                    }
+                }
+                return lines.join("\n");
+            },
+        } },
+];
+//# sourceMappingURL=astro.js.map

package/dist/register-tool-groups/astro.js.map

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

package/dist/register-tool-groups/core/index.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinitionEntry } from "../shared.js";
+export declare const CORE_INDEX_TOOL_ENTRIES: ToolDefinitionEntry[];
+//# sourceMappingURL=index.d.ts.map

package/dist/register-tool-groups/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/register-tool-groups/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoF,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI1I,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,EAwFxD,CAAC"}

package/dist/register-tool-groups/core/index.js

@@ -0,0 +1,96 @@
+import { z, zBool, lazySchema, OutputSchemas, detectAutoLoadToolsCached, enableToolByName } from "../shared.js";
+import { indexFolder, indexFile, indexRepo, listAllRepos, invalidateCache } from "../deps.js";
+import { zJsonArray } from "./schema.js";
+export const CORE_INDEX_TOOL_ENTRIES = [
+    // --- Indexing ---
+    { order: 1154, definition: {
+            name: "index_folder",
+            category: "indexing",
+            searchHint: "index local folder directory project parse symbols",
+            description: "Index a local folder, extracting symbols and building the search index",
+            schema: lazySchema(() => ({
+                path: z.string().describe("Absolute path to the folder to index"),
+                incremental: zBool().describe("Only re-index changed files"),
+                include_paths: z.union([
+                    z.array(z.string().trim().min(1)),
+                    zJsonArray(z.string().trim().min(1)),
+                ]).optional().describe("Glob patterns to include. Can be passed as JSON string."),
+                max_files: z.number().int().positive().optional().describe("Cap on files indexed. Default 50000 (or CODESIFT_MAX_FILES env). Walker stops at this count and returns partial results — protects against OOM on huge repos. Use include_paths to scope instead of raising this for large vendored trees."),
+                watch: zBool().describe("Whether to set up a chokidar file watcher for incremental updates after indexing. Default true. Pass false for bulk/CI indexing scenarios — file watchers consume system file descriptors (1+ per repo on macOS FSEvents); indexing many repos with watchers active can exhaust the system file table (ENFILE)."),
+            })),
+            handler: async (args) => {
+                const result = await indexFolder(args.path, {
+                    incremental: args.incremental,
+                    include_paths: args.include_paths,
+                    max_files: args.max_files,
+                    watch: args.watch,
+                });
+                // Auto-enable framework tools based on indexed path (not CWD)
+                try {
+                    const toEnable = await detectAutoLoadToolsCached(args.path);
+                    for (const name of toEnable)
+                        enableToolByName(name);
+                }
+                catch { /* best-effort — non-fatal */ }
+                return result;
+            },
+        } },
+    { order: 1181, definition: {
+            name: "index_repo",
+            category: "indexing",
+            searchHint: "clone remote git repository index",
+            description: "Clone and index a remote git repository",
+            schema: lazySchema(() => ({
+                url: z.string().describe("Git clone URL"),
+                branch: z.string().optional().describe("Branch to checkout"),
+                include_paths: z.union([
+                    z.array(z.string().trim().min(1)),
+                    zJsonArray(z.string().trim().min(1)),
+                ]).optional().describe("Glob patterns to include. Can be passed as JSON string."),
+            })),
+            handler: (args) => indexRepo(args.url, {
+                branch: args.branch,
+                include_paths: args.include_paths,
+            }),
+        } },
+    { order: 1196, definition: {
+            name: "list_repos",
+            category: "indexing",
+            searchHint: "list indexed repositories repos available",
+            outputSchema: OutputSchemas.repoList,
+            description: "List indexed repos. Only needed for multi-repo discovery — single-repo tools auto-resolve from CWD. Set compact=false for full metadata.",
+            schema: lazySchema(() => ({
+                compact: zBool().describe("true=names only (default), false=full metadata"),
+                name_contains: z.string().optional().describe("Filter repos by name substring (case-insensitive). E.g. 'tgm' matches 'local/tgm-panel'"),
+            })),
+            handler: (args) => {
+                const opts = {
+                    compact: args.compact ?? true,
+                };
+                if (args.name_contains)
+                    opts.name_contains = args.name_contains;
+                return listAllRepos(opts);
+            },
+        } },
+    { order: 1214, definition: {
+            name: "invalidate_cache",
+            category: "indexing",
+            searchHint: "clear cache invalidate re-index refresh",
+            description: "Clear the index cache for a repository, forcing full re-index on next use",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+            })),
+            handler: (args) => invalidateCache(args.repo),
+        } },
+    { order: 1225, definition: {
+            name: "index_file",
+            category: "indexing",
+            searchHint: "re-index single file update incremental",
+            description: "Re-index a single file after editing. Auto-finds repo, skips if unchanged.",
+            schema: lazySchema(() => ({
+                path: z.string().describe("Absolute path to the file to re-index"),
+            })),
+            handler: (args) => indexFile(args.path),
+        } },
+];
+//# sourceMappingURL=index.js.map

package/dist/register-tool-groups/core/index.js.map

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

package/dist/register-tool-groups/core/meta.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinitionEntry } from "../shared.js";
+export declare const CORE_META_TOOL_ENTRIES: ToolDefinitionEntry[];
+//# sourceMappingURL=meta.d.ts.map

package/dist/register-tool-groups/core/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/register-tool-groups/core/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAIpF,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EA2LvD,CAAC"}

package/dist/register-tool-groups/core/meta.js

@@ -0,0 +1,180 @@
+import { z, zBool, zNum, lazySchema } from "../shared.js";
+import { detectCommunities, assembleContext, getKnowledgeMap, diffOutline, changedSymbols, generateClaudeMd, dispatchFormatter } from "../deps.js";
+import { zJsonArray } from "./schema.js";
+export const CORE_META_TOOL_ENTRIES = [
+    { order: 1902, definition: {
+            name: "detect_communities",
+            cacheable: true,
+            category: "architecture",
+            searchHint: "community detection clusters modules Louvain import graph boundaries",
+            description: "Louvain community detection on import graph. Discovers module boundaries.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                focus: z.string().optional().describe("Path substring to filter files (e.g. 'src/lib')"),
+                resolution: zNum().describe("Louvain resolution: higher = more smaller communities, lower = fewer larger (default: 1.0)"),
+                output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (graph diagram)"),
+            })),
+            handler: async (args) => {
+                const result = await detectCommunities(args.repo, args.focus, args.resolution, args.output_format);
+                return dispatchFormatter("detect_communities", result);
+            },
+        } },
+    { order: 1924, definition: {
+            name: "find_circular_deps",
+            cacheable: true,
+            category: "architecture",
+            searchHint: "circular dependency cycle import loop detection",
+            description: "Detect circular dependencies in the import graph via DFS. Returns file-level cycles.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
+                max_cycles: zNum().describe("Maximum cycles to report (default: 50)"),
+            })),
+            handler: async (args) => {
+                const { findCircularDeps } = await import("../../tools/graph-tools.js");
+                const opts = {};
+                if (args.file_pattern != null)
+                    opts.file_pattern = args.file_pattern;
+                if (args.max_cycles != null)
+                    opts.max_cycles = args.max_cycles;
+                const result = await findCircularDeps(args.repo, opts);
+                if (result.cycles.length === 0) {
+                    return `No circular dependencies found (scanned ${result.total_files} files, ${result.total_edges} edges)`;
+                }
+                const lines = [`${result.cycles.length} circular dependencies found (${result.total_files} files, ${result.total_edges} edges):\n`];
+                for (const c of result.cycles) {
+                    lines.push(`  ${c.cycle.join(" → ")}`);
+                }
+                return lines.join("\n");
+            },
+        } },
+    { order: 1950, definition: {
+            name: "check_boundaries",
+            category: "architecture",
+            searchHint: "boundary rules architecture enforcement imports CI gate hexagonal onion",
+            description: "Check architecture boundary rules against imports. Path substring matching.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                rules: z.union([
+                    z.array(z.object({
+                        from: z.string().describe("Path substring matching source files (e.g. 'src/domain')"),
+                        cannot_import: z.array(z.string()).optional().describe("Path patterns that matched files must NOT import"),
+                        can_only_import: z.array(z.string()).optional().describe("Path patterns that matched files may ONLY import (allowlist)"),
+                    })),
+                    zJsonArray(z.object({
+                        from: z.string().trim().min(1),
+                        cannot_import: z.array(z.string().trim().min(1)).optional(),
+                        can_only_import: z.array(z.string().trim().min(1)).optional(),
+                    })),
+                ]).describe("Array of boundary rules to check. JSON string OK."),
+                file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
+            })),
+            handler: async (args) => {
+                const { checkBoundaries } = await import("../../tools/boundary-tools.js");
+                return checkBoundaries(args.repo, args.rules, { file_pattern: args.file_pattern });
+            },
+        } },
+    { order: 1976, definition: {
+            name: "classify_roles",
+            category: "architecture",
+            searchHint: "classify roles entry core utility dead leaf symbol architecture",
+            description: "Classify symbol roles (entry/core/utility/dead/leaf) by call graph connectivity.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
+                include_tests: zBool().describe("Include test files (default: false)"),
+                top_n: zNum().describe("Maximum number of symbols to return (default: 100)"),
+            })),
+            handler: async (args) => {
+                const { classifySymbolRoles } = await import("../../tools/graph-tools.js");
+                const result = await classifySymbolRoles(args.repo, {
+                    file_pattern: args.file_pattern,
+                    include_tests: args.include_tests,
+                    top_n: args.top_n,
+                });
+                return dispatchFormatter("classify_roles", result);
+            },
+        } },
+    // --- Context & knowledge ---
+    { order: 1999, definition: {
+            name: "assemble_context",
+            category: "context",
+            searchHint: "assemble context token budget L0 L1 L2 L3 source signatures summaries",
+            description: "Assemble code context within token budget. L0=source, L1=signatures, L2=files, L3=dirs.",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                query: z.string().describe("Natural language query describing what context is needed"),
+                token_budget: zNum().describe("Maximum tokens for the assembled context"),
+                level: z.enum(["L0", "L1", "L2", "L3"]).optional().describe("L0=source (default), L1=signatures, L2=files, L3=dirs"),
+                rerank: zBool().describe("Rerank results using cross-encoder model for improved relevance (requires @huggingface/transformers)"),
+            })),
+            handler: async (args) => {
+                const result = await assembleContext(args.repo, args.query, args.token_budget, args.level, args.rerank);
+                return dispatchFormatter("assemble_context", result);
+            },
+        } },
+    { order: 2022, definition: {
+            name: "get_knowledge_map",
+            category: "context",
+            searchHint: "knowledge map module dependency graph architecture overview mermaid",
+            description: "Get the module dependency map showing how files and directories relate",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                focus: z.string().optional().describe("Focus on a specific module or directory"),
+                depth: zNum().describe("Maximum depth of the dependency graph"),
+                output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (dependency diagram)"),
+            })),
+            handler: async (args) => {
+                const result = await getKnowledgeMap(args.repo, args.focus, args.depth, args.output_format);
+                return dispatchFormatter("get_knowledge_map", result);
+            },
+        } },
+    // --- Diff ---
+    { order: 2040, definition: {
+            name: "diff_outline",
+            category: "diff",
+            searchHint: "diff outline structural changes git refs compare",
+            description: "Get a structural outline of what changed between two git refs",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                since: z.string().describe("Git ref to compare from"),
+                until: z.string().optional().describe("Git ref to compare to (defaults to HEAD)"),
+            })),
+            handler: async (args) => {
+                const result = await diffOutline(args.repo, args.since, args.until);
+                return dispatchFormatter("diff_outline", result);
+            },
+        } },
+    { order: 2055, definition: {
+            name: "changed_symbols",
+            category: "diff",
+            searchHint: "changed symbols added modified removed git diff",
+            description: "List symbols that were added, modified, or removed between two git refs",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                since: z.string().describe("Git ref to compare from"),
+                until: z.string().optional().describe("Git ref to compare to (defaults to HEAD)"),
+                include_diff: zBool().describe("Include unified diff per changed file (truncated to 500 chars)"),
+            })),
+            handler: async (args) => {
+                const opts = {};
+                if (args.include_diff === true)
+                    opts.include_diff = true;
+                const result = await changedSymbols(args.repo, args.since, args.until, opts);
+                return dispatchFormatter("changed_symbols", result);
+            },
+        } },
+    // --- Generation ---
+    { order: 2075, definition: {
+            name: "generate_claude_md",
+            category: "reporting",
+            searchHint: "generate CLAUDE.md project summary documentation",
+            description: "Generate a CLAUDE.md project summary file from the repository index",
+            schema: lazySchema(() => ({
+                repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+                output_path: z.string().optional().describe("Custom output file path"),
+            })),
+            handler: (args) => generateClaudeMd(args.repo, args.output_path),
+        } },
+];
+//# sourceMappingURL=meta.js.map