@n-dx/core 0.1.0

package/packages/sourcevision/dist/cli/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * Sourcevision CLI
+ *
+ * Commands:
+ *   init               - Initialize .sourcevision/ in current project
+ *   analyze [dir]      - Run analysis pipeline
+ *   serve [dir]        - Start local viewer server
+ *   validate [dir]     - Validate .sourcevision/ output files
+ *   export-pdf [dir]   - Export analysis as a PDF report
+ *   pr-markdown [dir]  - Regenerate PR markdown in .sourcevision/
+ *   git-credential-helper - Interactive GitHub credential setup helper
+ *   mcp [dir]          - Start MCP server for AI tool integration
+ */
+import { resolve } from "node:path";
+import { usage } from "./commands/constants.js";
+import { showCommandHelp } from "./help.js";
+import { cmdInit } from "./commands/init.js";
+import { cmdReset } from "./commands/reset.js";
+import { cmdAnalyze } from "./commands/analyze.js";
+import { cmdValidate } from "./commands/validate.js";
+import { cmdExportPdf } from "./commands/export-pdf.js";
+import { cmdGitCredentialHelper } from "./commands/git-credential-helper.js";
+import { cmdPrMarkdown } from "./commands/pr-markdown.js";
+import { cmdWorkspace } from "./commands/workspace.js";
+import { CLIError, handleCLIError, requireSvDir } from "./errors.js";
+import { setQuiet } from "./output.js";
+import { formatTypoSuggestion } from "@n-dx/llm-client";
+const args = process.argv.slice(2);
+const command = args[0];
+// ── arg parsing & dispatch ──────────────────────────────────────────────────
+let port = 3117;
+let quiet = false;
+let help = false;
+let outputPath;
+const passthrough = [];
+for (const a of args.slice(1)) {
+    if (a.startsWith("--port=")) {
+        port = parseInt(a.split("=")[1], 10);
+    }
+    else if (a.startsWith("--output=") || a.startsWith("-o=")) {
+        outputPath = a.split("=").slice(1).join("=");
+    }
+    else if (a === "--quiet" || a === "-q") {
+        quiet = true;
+    }
+    else if (a === "--help" || a === "-h") {
+        help = true;
+    }
+    else if (a.startsWith("--phase=") || a.startsWith("--only=") || a === "--fast" || a === "--full" || a === "--deep") {
+        passthrough.push(a);
+    }
+}
+setQuiet(quiet);
+// First non-flag arg after command is the target dir
+const targetArg = args.slice(1).find((a) => !a.startsWith("-"));
+async function cmdServe(dir, port) {
+    const absDir = resolve(dir);
+    const { startServe } = await import("./serve.js");
+    await startServe(absDir, port);
+}
+async function cmdMcp(dir) {
+    const absDir = resolve(dir);
+    const { startMcpServer } = await import("./mcp.js");
+    await startMcpServer(absDir);
+}
+// Commands that require .sourcevision/ to exist
+const NEEDS_SV_DIR = new Set(["serve", "validate", "reset", "pr-markdown", "mcp"]);
+try {
+    // Show help: per-command help when --help/-h is given with a command,
+    // else top-level usage.
+    if (help && command && command !== "--help" && command !== "-h") {
+        if (!showCommandHelp(command)) {
+            usage();
+        }
+        process.exit(0);
+    }
+    if (command && NEEDS_SV_DIR.has(command)) {
+        requireSvDir(resolve(targetArg || "."));
+    }
+    switch (command) {
+        case "init":
+            cmdInit(targetArg || ".");
+            break;
+        case "analyze":
+            await cmdAnalyze(targetArg || ".", passthrough);
+            break;
+        case "serve":
+            await cmdServe(targetArg || ".", port);
+            break;
+        case "validate":
+            cmdValidate(targetArg || ".");
+            break;
+        case "reset":
+            cmdReset(targetArg || ".");
+            break;
+        case "export-pdf":
+            await cmdExportPdf(targetArg || ".", { output: outputPath });
+            break;
+        case "pr-markdown":
+            await cmdPrMarkdown(targetArg || ".");
+            break;
+        case "git-credential-helper":
+            cmdGitCredentialHelper();
+            break;
+        case "workspace":
+            cmdWorkspace(targetArg || ".", args.slice(1));
+            break;
+        case "mcp":
+            await cmdMcp(targetArg || ".");
+            break;
+        case "--help":
+        case "-h":
+        case undefined:
+            usage();
+            break;
+        default: {
+            const SV_COMMANDS = ["init", "analyze", "serve", "validate", "reset", "export-pdf", "pr-markdown", "git-credential-helper", "mcp", "workspace"];
+            const typoHint = formatTypoSuggestion(command, SV_COMMANDS, "sourcevision ");
+            throw new CLIError(`Unknown command: ${command}`, typoHint ?? "Run 'sourcevision --help' to see available commands.");
+        }
+    }
+}
+catch (err) {
+    handleCLIError(err);
+}
+//# sourceMappingURL=index.js.map

package/packages/sourcevision/dist/cli/index.js.map

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

package/packages/sourcevision/dist/cli/mcp.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP (Model Context Protocol) server for Sourcevision.
+ * Exposes codebase analysis data via MCP protocol (stdio or HTTP).
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createSourcevisionMcpServer(targetDir: string): McpServer;
+/**
+ * Start the Sourcevision MCP server over stdio (for `sv mcp <dir>` CLI command).
+ *
+ * This is the original entry point preserved for backward compatibility.
+ * For HTTP or other transports, use {@link createSourcevisionMcpServer} instead.
+ */
+export declare function startMcpServer(targetDir: string): Promise<void>;

package/packages/sourcevision/dist/cli/mcp.js

@@ -0,0 +1,433 @@
+/**
+ * MCP (Model Context Protocol) server for Sourcevision.
+ * Exposes codebase analysis data via MCP protocol (stdio or HTTP).
+ */
+import { readFileSync, writeFileSync, existsSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { DATA_FILES } from "../schema/data-files.js";
+import { generateContext } from "../analyzers/context.js";
+import { deriveNextSteps } from "../analyzers/next-steps.js";
+import { SV_DIR, TOOL_VERSION } from "../constants.js";
+function loadData(targetDir) {
+    const svDir = join(targetDir, SV_DIR);
+    const data = {
+        manifest: null,
+        inventory: null,
+        imports: null,
+        classifications: null,
+        zones: null,
+        components: null,
+    };
+    const modules = [
+        { key: "manifest", file: DATA_FILES.manifest },
+        { key: "inventory", file: DATA_FILES.inventory },
+        { key: "imports", file: DATA_FILES.imports },
+        { key: "classifications", file: DATA_FILES.classifications },
+        { key: "zones", file: DATA_FILES.zones },
+        { key: "components", file: DATA_FILES.components },
+    ];
+    for (const mod of modules) {
+        const filePath = join(svDir, mod.file);
+        if (existsSync(filePath)) {
+            try {
+                data[mod.key] = JSON.parse(readFileSync(filePath, "utf-8"));
+            }
+            catch {
+                // Skip unparseable files
+            }
+        }
+    }
+    return data;
+}
+/**
+ * Create a configured Sourcevision MCP server without connecting a transport.
+ *
+ * Returns the McpServer instance with all tools and resources registered.
+ * The caller is responsible for connecting a transport (stdio, HTTP, etc.):
+ *
+ * ```ts
+ * // Stdio (CLI usage)
+ * const server = await createSourcevisionMcpServer(dir);
+ * await server.connect(new StdioServerTransport());
+ *
+ * // HTTP (web server usage)
+ * const server = await createSourcevisionMcpServer(dir);
+ * const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID() });
+ * await server.connect(transport);
+ * ```
+ */
+/** Return manifest.json mtime (ms), or 0 on error. */
+function manifestMtime(svDir) {
+    try {
+        return statSync(join(svDir, DATA_FILES.manifest)).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+export function createSourcevisionMcpServer(targetDir) {
+    const context = createMcpContext(targetDir);
+    const server = new McpServer({ name: "sourcevision", version: TOOL_VERSION });
+    registerMcpTools(server, context);
+    registerMcpResources(server, context);
+    return server;
+}
+function createMcpContext(targetDir) {
+    const absDir = resolve(targetDir);
+    const svDir = join(absDir, SV_DIR);
+    let cachedData = loadData(absDir);
+    let cachedMtime = manifestMtime(svDir);
+    return {
+        absDir,
+        freshData: () => {
+            const mtime = manifestMtime(svDir);
+            if (mtime !== cachedMtime) {
+                cachedData = loadData(absDir);
+                cachedMtime = mtime;
+            }
+            return cachedData;
+        },
+        invalidateCache: () => {
+            cachedMtime = 0;
+        },
+    };
+}
+function setArchetypeOverride(absDir, path, archetype) {
+    const configPath = join(absDir, ".n-dx.json");
+    let config = {};
+    if (existsSync(configPath)) {
+        try {
+            config = JSON.parse(readFileSync(configPath, "utf-8"));
+        }
+        catch {
+            // Start fresh if corrupted
+        }
+    }
+    if (!config.sourcevision)
+        config.sourcevision = {};
+    const sv = config.sourcevision;
+    if (!sv.archetypes)
+        sv.archetypes = {};
+    const archetypes = sv.archetypes;
+    if (!archetypes.overrides)
+        archetypes.overrides = {};
+    const overrides = archetypes.overrides;
+    overrides[path] = archetype;
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+// ── Tool registration groups ─────────────────────────────────────────
+// Each function registers a cohesive group of related MCP tools.
+function registerOverviewTools(server, context) {
+    server.tool("get_overview", "Get project summary statistics. Good starting point when the user asks about the project or its architecture.", {}, () => {
+        const data = context.freshData();
+        if (!data.manifest || !data.inventory) {
+            return { content: [{ type: "text", text: "No analysis data available. Run 'sourcevision analyze' first." }] };
+        }
+        const summary = {
+            project: data.manifest.targetPath.split("/").pop(),
+            git: [data.manifest.gitBranch, data.manifest.gitSha?.slice(0, 7)].filter(Boolean).join(" @ ") || null,
+            files: data.inventory.summary.totalFiles,
+            lines: data.inventory.summary.totalLines,
+            languages: data.inventory.summary.byLanguage,
+            importEdges: data.imports?.summary.totalEdges ?? 0,
+            externalPackages: data.imports?.summary.totalExternal ?? 0,
+            circulars: data.imports?.summary.circularCount ?? 0,
+            zones: data.zones?.zones.length ?? 0,
+            classifications: data.classifications ? data.classifications.summary : null,
+            components: data.components?.summary.totalComponents ?? 0,
+            routeModules: data.components?.summary.totalRouteModules ?? 0,
+            serverRoutes: data.components?.summary.totalServerRoutes ?? 0,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+    });
+    server.tool("get_next_steps", "Get prioritized list of what to work on next based on analysis findings. Use when planning work or looking for improvement opportunities.", {
+        priority: z.string().optional().describe("Filter by priority: high, medium, low"),
+        limit: z.number().optional().describe("Max results (default 10)"),
+    }, ({ priority, limit }) => {
+        const data = context.freshData();
+        if (!data.zones) {
+            return { content: [{ type: "text", text: "No zones data available." }] };
+        }
+        let steps = deriveNextSteps(data.zones);
+        if (priority) {
+            steps = steps.filter((s) => s.priority === priority);
+        }
+        const maxResults = limit ?? 10;
+        steps = steps.slice(0, maxResults);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ steps, total: steps.length }, null, 2),
+                }],
+        };
+    });
+}
+function registerZoneTools(server, context) {
+    server.tool("get_zone", "Get details for a specific zone. Use to understand architectural context before making changes to files in a zone.", { id: z.string().describe("Zone ID") }, ({ id }) => {
+        const data = context.freshData();
+        if (!data.zones) {
+            return { content: [{ type: "text", text: "No zones data available." }] };
+        }
+        const zone = data.zones.zones.find((z) => z.id === id);
+        if (!zone) {
+            const available = data.zones.zones.map((z) => z.id).join(", ");
+            return { content: [{ type: "text", text: `Zone "${id}" not found. Available: ${available}` }] };
+        }
+        const findings = (data.zones.findings ?? []).filter((f) => f.scope === id);
+        const crossings = data.zones.crossings.filter((c) => c.fromZone === id || c.toZone === id);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ ...zone, findings, crossings }, null, 2),
+                }],
+        };
+    });
+    server.tool("get_findings", "Get analysis findings (anti-patterns, suggestions, observations). Check before modifying code in an area to see known issues.", {
+        type: z.string().optional().describe("Filter by type: observation, pattern, relationship, anti-pattern, suggestion"),
+        severity: z.string().optional().describe("Filter by severity: info, warning, critical"),
+    }, ({ type, severity }) => {
+        const data = context.freshData();
+        let findings = data.zones?.findings ?? [];
+        if (type) {
+            findings = findings.filter((f) => f.type === type);
+        }
+        if (severity) {
+            findings = findings.filter((f) => f.severity === severity);
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ findings, total: findings.length }, null, 2),
+                }],
+        };
+    });
+}
+function registerFileTools(server, context) {
+    server.tool("get_file_info", "Get inventory entry, zone, and imports for a file. Use before modifying a file to understand its role and dependencies.", { path: z.string().describe("File path (relative to project root)") }, ({ path }) => {
+        const data = context.freshData();
+        const file = data.inventory?.files.find((f) => f.path === path);
+        if (!file) {
+            return { content: [{ type: "text", text: `File "${path}" not found in inventory.` }] };
+        }
+        const zone = data.zones?.zones.find((z) => z.files.includes(path));
+        const classification = data.classifications?.files.find((c) => c.path === path);
+        const importsFrom = data.imports?.edges.filter((e) => e.from === path) ?? [];
+        const importedBy = data.imports?.edges.filter((e) => e.to === path) ?? [];
+        const component = data.components?.components.find((c) => c.file === path);
+        const routeModule = data.components?.routeModules.find((m) => m.file === path);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        file,
+                        archetype: classification?.archetype ?? null,
+                        zone: zone ? { id: zone.id, name: zone.name } : null,
+                        importsFrom,
+                        importedBy,
+                        component: component ?? null,
+                        routeModule: routeModule ?? null,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool("search_files", "Search the file inventory by path, role, or language. Use to find files related to a feature or module.", {
+        query: z.string().describe("Search string to match against file paths"),
+        role: z.string().optional().describe("Filter by role: source, test, config, docs, etc."),
+        language: z.string().optional().describe("Filter by language"),
+    }, ({ query, role, language }) => {
+        const data = context.freshData();
+        if (!data.inventory) {
+            return { content: [{ type: "text", text: "No inventory data available." }] };
+        }
+        let files = data.inventory.files;
+        if (query) {
+            const q = query.toLowerCase();
+            files = files.filter((f) => f.path.toLowerCase().includes(q));
+        }
+        if (role) {
+            files = files.filter((f) => f.role === role);
+        }
+        if (language) {
+            const lang = language.toLowerCase();
+            files = files.filter((f) => f.language.toLowerCase() === lang);
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        files: files.slice(0, 50),
+                        total: files.length,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool("get_imports", "Get import graph edges, optionally filtered to a specific file. Use to trace dependencies and understand coupling between modules.", { file: z.string().optional().describe("Filter to imports from/to this file") }, ({ file }) => {
+        const data = context.freshData();
+        if (!data.imports) {
+            return { content: [{ type: "text", text: "No imports data available." }] };
+        }
+        let edges = data.imports.edges;
+        if (file) {
+            edges = edges.filter((e) => e.from === file || e.to === file);
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        edges: edges.slice(0, 100),
+                        total: edges.length,
+                        circulars: data.imports.summary.circulars,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+function registerClassificationTools(server, context) {
+    server.tool("get_classifications", "Get file archetype classifications (e.g., utility, entrypoint, route-handler). Use to understand file roles across the codebase.", {
+        archetype: z.string().optional().describe("Filter by archetype ID (e.g., utility, entrypoint, route-handler)"),
+        path: z.string().optional().describe("Filter by file path substring"),
+    }, ({ archetype, path }) => {
+        const data = context.freshData();
+        if (!data.classifications) {
+            return { content: [{ type: "text", text: "No classifications data available. Run 'sourcevision analyze' first." }] };
+        }
+        let files = data.classifications.files;
+        if (archetype) {
+            files = files.filter((f) => f.archetype === archetype);
+        }
+        if (path) {
+            const q = path.toLowerCase();
+            files = files.filter((f) => f.path.toLowerCase().includes(q));
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        archetypes: data.classifications.archetypes.map((a) => ({ id: a.id, name: a.name })),
+                        files: files.slice(0, 50),
+                        total: files.length,
+                        summary: data.classifications.summary,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool("set_file_archetype", "Override the archetype classification for a file (persists to .n-dx.json). Use when the automatic classification is wrong.", {
+        path: z.string().describe("File path (relative to project root)"),
+        archetype: z.string().describe("Archetype ID to assign (e.g., utility, route-handler, entrypoint)"),
+    }, ({ path, archetype }) => {
+        const data = context.freshData();
+        const file = data.inventory?.files.find((f) => f.path === path);
+        if (!file) {
+            return { content: [{ type: "text", text: `File "${path}" not found in inventory.` }] };
+        }
+        const validArchetypes = data.classifications?.archetypes.map((a) => a.id) ?? [];
+        if (validArchetypes.length > 0 && !validArchetypes.includes(archetype)) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Unknown archetype "${archetype}". Valid archetypes: ${validArchetypes.join(", ")}`,
+                    }],
+            };
+        }
+        setArchetypeOverride(context.absDir, path, archetype);
+        context.invalidateCache();
+        return {
+            content: [{
+                    type: "text",
+                    text: `Set archetype override: "${path}" → "${archetype}". Run 'sourcevision analyze' to apply.`,
+                }],
+        };
+    });
+}
+function registerComponentTools(server, context) {
+    server.tool("get_route_tree", "Get the route structure (pages, API routes, layouts). Use when working on routing or navigation.", {}, () => {
+        const data = context.freshData();
+        if (!data.components) {
+            return { content: [{ type: "text", text: "No components data available." }] };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        routeTree: data.components.routeTree,
+                        routeModules: data.components.routeModules,
+                        serverRoutes: data.components.serverRoutes,
+                        conventions: data.components.summary.routeConventions,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+function registerMcpTools(server, context) {
+    registerOverviewTools(server, context);
+    registerZoneTools(server, context);
+    registerFileTools(server, context);
+    registerClassificationTools(server, context);
+    registerComponentTools(server, context);
+}
+function registerMcpResources(server, context) {
+    server.resource("summary", "sourcevision://summary", { description: "Condensed codebase context (CONTEXT.md)" }, () => {
+        const data = context.freshData();
+        if (!data.manifest || !data.inventory || !data.imports || !data.zones) {
+            return {
+                contents: [{
+                        uri: "sourcevision://summary",
+                        mimeType: "text/markdown",
+                        text: "No analysis data available.",
+                    }],
+            };
+        }
+        const contextText = generateContext(data.manifest, data.inventory, data.imports, data.zones, data.components, data.classifications);
+        return {
+            contents: [{
+                    uri: "sourcevision://summary",
+                    mimeType: "text/markdown",
+                    text: contextText,
+                }],
+        };
+    });
+    server.resource("zones", "sourcevision://zones", { description: "Zone analysis data" }, () => {
+        const data = context.freshData();
+        return {
+            contents: [{
+                    uri: "sourcevision://zones",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data.zones ?? { zones: [], crossings: [], unzoned: [] }, null, 2),
+                }],
+        };
+    });
+    server.resource("routes", "sourcevision://routes", { description: "Route tree data" }, () => {
+        const data = context.freshData();
+        return {
+            contents: [{
+                    uri: "sourcevision://routes",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data.components
+                        ? { routeTree: data.components.routeTree, routeModules: data.components.routeModules, serverRoutes: data.components.serverRoutes }
+                        : { routeTree: [], routeModules: [], serverRoutes: [] }, null, 2),
+                }],
+        };
+    });
+}
+/**
+ * Start the Sourcevision MCP server over stdio (for `sv mcp <dir>` CLI command).
+ *
+ * This is the original entry point preserved for backward compatibility.
+ * For HTTP or other transports, use {@link createSourcevisionMcpServer} instead.
+ */
+export async function startMcpServer(targetDir) {
+    const absDir = resolve(targetDir);
+    const svDir = join(absDir, SV_DIR);
+    if (!existsSync(svDir)) {
+        console.error(`No .sourcevision/ directory found in: ${absDir}`);
+        console.error("Run 'sourcevision analyze' first.");
+        process.exit(1);
+    }
+    const server = createSourcevisionMcpServer(absDir);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp.js.map

package/packages/sourcevision/dist/cli/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAWvD,SAAS,QAAQ,CAAC,SAAiB;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,IAAI,GAAqB;QAC7B,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,IAAI;QACrB,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,IAAI;KACjB,CAAC;IAEF,MAAM,OAAO,GAAyD;QACpE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;QAC9C,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE;QAChD,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE;QAC5C,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,CAAC,eAAe,EAAE;QAC5D,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE;QACxC,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE;KACnD,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACF,IAA2C,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAChE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAChC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,sDAAsD;AACtD,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9E,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD,SAAS,gBAAgB,CAAC,SAAiB;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEvC,OAAO;QACL,MAAM;QACN,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;gBAC1B,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9B,WAAW,GAAG,KAAK,CAAC;YACtB,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,eAAe,EAAE,GAAG,EAAE;YACpB,WAAW,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,IAAY,EAAE,SAAiB;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,MAAM,GAA4B,EAAE,CAAC;IACzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;IACnD,MAAM,EAAE,GAAG,MAAM,CAAC,YAAuC,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,UAAU;QAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,EAAE,CAAC,UAAqC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,SAAS;QAAE,UAAU,CAAC,SAAS,GAAG,EAAE,CAAC;IACrD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAmC,CAAC;IACjE,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAE5B,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,wEAAwE;AACxE,iEAAiE;AAEjE,SAAS,qBAAqB,CAAC,MAAiB,EAAE,OAAmB;IACnE,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,+GAA+G,EAAE,EAAE,EAAE,GAAG,EAAE;QACpJ,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+DAA+D,EAAE,CAAC,EAAE,CAAC;QAChH,CAAC;QAED,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE;YAClD,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI;YACrG,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU;YACxC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU;YACxC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU;YAC5C,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;YAClD,gBAAgB,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC;YAC1D,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC;YACnD,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;YACpC,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC3E,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,eAAe,IAAI,CAAC;YACzD,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;YAC7D,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;SAC9D,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,2IAA2I,EAC3I;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KAClE,EACD,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC;QAED,IAAI,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE,CAAC;QAC/B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAEnC,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC9D,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAiB,EAAE,OAAmB;IAC/D,MAAM,CAAC,IAAI,CACT,UAAU,EACV,oHAAoH,EACpH,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,EACtC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,2BAA2B,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;QAClG,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAC5C,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAChE,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,+HAA+H,EAC/H;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;QACpH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KACxF,EACD,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC;QAE1C,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpE,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAiB,EAAE,OAAmB;IAC/D,MAAM,CAAC,IAAI,CACT,eAAe,EACf,yHAAyH,EACzH,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EAAE,EACrE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACX,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,2BAA2B,EAAE,CAAC,EAAE,CAAC;QACzF,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAE/E,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,IAAI;wBACJ,SAAS,EAAE,cAAc,EAAE,SAAS,IAAI,IAAI;wBAC5C,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;wBACpD,WAAW;wBACX,UAAU;wBACV,SAAS,EAAE,SAAS,IAAI,IAAI;wBAC5B,WAAW,EAAE,WAAW,IAAI,IAAI;qBACjC,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,yGAAyG,EACzG;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACxF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KAC/D,EACD,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,EAAE,CAAC;QAC/E,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC9B,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YACpC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;wBACzB,KAAK,EAAE,KAAK,CAAC,MAAM;qBACpB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,oIAAoI,EACpI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EAC/E,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACX,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,EAAE,CAAC;QAC7E,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAC/B,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;wBAC1B,KAAK,EAAE,KAAK,CAAC,MAAM;wBACnB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS;qBAC1C,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAiB,EAAE,OAAmB;IACzE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,kIAAkI,EAClI;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;QAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KACtE,EACD,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sEAAsE,EAAE,CAAC,EAAE,CAAC;QACvH,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7B,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;wBACpF,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;wBACzB,KAAK,EAAE,KAAK,CAAC,MAAM;wBACnB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO;qBACtC,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,4HAA4H,EAC5H;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACjE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;KACpG,EACD,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,2BAA2B,EAAE,CAAC,EAAE,CAAC;QACzF,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAChF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB,SAAS,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC1F,CAAC;aACH,CAAC;QACJ,CAAC;QAED,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACtD,OAAO,CAAC,eAAe,EAAE,CAAC;QAE1B,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4BAA4B,IAAI,QAAQ,SAAS,yCAAyC;iBACjG,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAiB,EAAE,OAAmB;IACpE,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,kGAAkG,EAAE,EAAE,EAAE,GAAG,EAAE;QACzI,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS;wBACpC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY;wBAC1C,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY;wBAC1C,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB;qBACtD,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAiB,EAAE,OAAmB;IAC9D,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAiB,EAAE,OAAmB;IAClE,MAAM,CAAC,QAAQ,CACb,SAAS,EACT,wBAAwB,EACxB,EAAE,WAAW,EAAE,yCAAyC,EAAE,EAC1D,GAAG,EAAE;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACtE,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,wBAAwB;wBAC7B,QAAQ,EAAE,eAAe;wBACzB,IAAI,EAAE,6BAA6B;qBACpC,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,eAAe,CACjC,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,CACrB,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,wBAAwB;oBAC7B,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,WAAW;iBAClB,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,OAAO,EACP,sBAAsB,EACtB,EAAE,WAAW,EAAE,oBAAoB,EAAE,EACrC,GAAG,EAAE;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,sBAAsB;oBAC3B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvF,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,QAAQ,EACR,uBAAuB,EACvB,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAClC,GAAG,EAAE;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,uBAAuB;oBAC5B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,IAAI,CAAC,UAAU;wBACb,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE;wBAClI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EACzD,IAAI,EACJ,CAAC,CACF;iBACF,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,yCAAyC,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/packages/sourcevision/dist/cli/output.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CLI output control — supports --quiet mode for scripting.
+ *
+ * Re-exports the shared foundation primitives from @n-dx/llm-client.
+ * All existing consumers import from this file — the re-export preserves
+ * their import paths while consolidating the implementation.
+ */
+export { setQuiet, isQuiet, info, result } from "@n-dx/llm-client";
+export interface Spinner {
+    /** Update the spinner message while it's running. */
+    update(message: string): void;
+    /** Stop the spinner and print a final message. */
+    stop(finalMessage?: string): void;
+}
+/**
+ * Start an animated progress spinner in the terminal.
+ * Suppressed in quiet mode or non-TTY environments (falls back to a single info line).
+ */
+export declare function startSpinner(message: string): Spinner;