@0xprathamesh/why-cli 1.1.1

package/dist/core/command-intelligence.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeCommand = analyzeCommand;
+exports.resolveExecutionMode = resolveExecutionMode;
+const LONG_RUNNING_ACTIONS = new Set(["start", "dev", "watch", "serve", "preview"]);
+const SHELL_BUILTINS = new Set(["cd", "alias", "export", "source", ".", "unset"]);
+const HIGH_RISK_GIT_ACTIONS = new Set(["push", "rebase", "reset", "clean"]);
+const MEDIUM_RISK_GIT_ACTIONS = new Set(["add", "commit", "merge", "checkout", "switch", "restore", "pull", "init"]);
+const DRY_RUN_CAPABLE_GIT_ACTIONS = new Set(["add", "push"]);
+function normalizeExecutable(value) {
+    return (value ?? "").trim().toLowerCase();
+}
+function riskForGitAction(action) {
+    if (HIGH_RISK_GIT_ACTIONS.has(action)) {
+        return action === "reset" || action === "clean" ? "critical" : "high";
+    }
+    if (MEDIUM_RISK_GIT_ACTIONS.has(action)) {
+        return "medium";
+    }
+    return "low";
+}
+function analyzeCommand(commandArgs) {
+    const executable = normalizeExecutable(commandArgs[0]);
+    const action = normalizeExecutable(commandArgs[1]);
+    if (!executable) {
+        return {
+            family: "unknown",
+            executable: "",
+            action: "none",
+            intentLabel: "Unknown",
+            risk: "low",
+            mutatesState: false,
+            touchesRemote: false,
+            supportsSimulation: false,
+            likelyLongRunning: false,
+            interactive: false,
+            reasons: ["No executable was provided."],
+        };
+    }
+    if (SHELL_BUILTINS.has(executable)) {
+        return {
+            family: "shell",
+            executable,
+            action: executable,
+            intentLabel: "Shell Builtin",
+            risk: "low",
+            mutatesState: executable === "cd",
+            touchesRemote: false,
+            supportsSimulation: false,
+            likelyLongRunning: false,
+            interactive: false,
+            unsupportedReason: executable === "cd"
+                ? "`cd` is a shell builtin, so why-cli cannot change the working directory of your parent terminal session."
+                : `\`${executable}\` is a shell builtin and must run in the current shell to have its normal effect.`,
+            reasons: [`${executable} is a shell builtin, not a normal standalone executable.`],
+        };
+    }
+    if (executable === "git") {
+        const risk = riskForGitAction(action);
+        const mutatesState = risk !== "low";
+        const touchesRemote = action === "push" || action === "pull" || action === "fetch";
+        const reasons = [
+            `Git action detected: ${action || "status"}.`,
+            mutatesState ? "This command can change repository state." : "This looks read-only.",
+        ];
+        if (touchesRemote) {
+            reasons.push("This command may interact with a remote repository.");
+        }
+        return {
+            family: "git",
+            executable,
+            action: action || "status",
+            intentLabel: touchesRemote ? "Remote Git Operation" : mutatesState ? "Repository Mutation" : "Repository Inspection",
+            risk,
+            mutatesState,
+            touchesRemote,
+            supportsSimulation: DRY_RUN_CAPABLE_GIT_ACTIONS.has(action) || action === "commit",
+            likelyLongRunning: false,
+            interactive: false,
+            reasons,
+        };
+    }
+    if (executable === "npm" || executable === "pnpm" || executable === "yarn") {
+        const mutatingAction = new Set(["install", "add", "remove", "publish", "upgrade"]);
+        const touchesRemote = action === "publish";
+        const mutatesState = mutatingAction.has(action);
+        const risk = action === "publish" ? "high" : mutatesState ? "medium" : "low";
+        return {
+            family: executable,
+            executable,
+            action: action || "run",
+            intentLabel: action === "publish" ? "Package Release" : mutatesState ? "Dependency Change" : "Package Script / Inspection",
+            risk,
+            mutatesState,
+            touchesRemote,
+            supportsSimulation: action === "publish" || action === "install" || action === "add",
+            likelyLongRunning: LONG_RUNNING_ACTIONS.has(action),
+            interactive: false,
+            reasons: [
+                `Package manager command detected: ${executable} ${action || ""}`.trim(),
+                mutatesState ? "This command may change dependencies or release artifacts." : "This looks read-only or script-oriented.",
+            ],
+        };
+    }
+    if (executable === "python" || executable === "python3") {
+        return {
+            family: "python",
+            executable,
+            action: action || "script",
+            intentLabel: "Python Execution",
+            risk: "low",
+            mutatesState: false,
+            touchesRemote: false,
+            supportsSimulation: false,
+            likelyLongRunning: action === "script" || action === "-i" || action === "",
+            interactive: commandArgs.length === 1,
+            reasons: ["Python execution detected. why-cli can analyze failures after execution."],
+        };
+    }
+    if (executable === "node" || executable === "npx") {
+        return {
+            family: "node",
+            executable,
+            action: action || "script",
+            intentLabel: executable === "npx" ? "Node Tool Execution" : "Node.js Execution",
+            risk: "low",
+            mutatesState: false,
+            touchesRemote: false,
+            supportsSimulation: false,
+            likelyLongRunning: commandArgs.some((value) => LONG_RUNNING_ACTIONS.has(normalizeExecutable(value))),
+            interactive: false,
+            reasons: ["Node.js execution detected. why-cli will run it directly and analyze any failures."],
+        };
+    }
+    if (executable === "sh" || executable === "bash" || executable === "zsh") {
+        return {
+            family: "shell",
+            executable,
+            action: action || "script",
+            intentLabel: "Shell Script Execution",
+            risk: "high",
+            mutatesState: true,
+            touchesRemote: /\b(push|publish|deploy|scp|rsync)\b/.test(commandArgs.join(" ")),
+            supportsSimulation: false,
+            likelyLongRunning: commandArgs.some((value) => LONG_RUNNING_ACTIONS.has(normalizeExecutable(value))),
+            interactive: false,
+            reasons: ["Shell script execution can bundle multiple actions, so why-cli treats it as higher risk."],
+        };
+    }
+    if (["rm", "mv", "cp", "mkdir", "rmdir", "touch", "cat", "ls", "pwd", "echo", "whoami"].includes(executable)) {
+        const readOnlyCommands = new Set(["cat", "ls", "pwd", "echo", "whoami"]);
+        const supportsSimulationCommands = new Set(["rm", "mv", "cp", "mkdir", "rmdir", "touch", "cat", "ls", "pwd", "echo", "whoami"]);
+        const mutatesState = !readOnlyCommands.has(executable);
+        const risk = executable === "rm" ? "critical" : mutatesState ? "medium" : "low";
+        return {
+            family: "system",
+            executable,
+            action: executable,
+            intentLabel: mutatesState ? "Filesystem Mutation" : "Filesystem Inspection",
+            risk,
+            mutatesState,
+            touchesRemote: false,
+            supportsSimulation: supportsSimulationCommands.has(executable),
+            likelyLongRunning: false,
+            interactive: false,
+            reasons: [
+                mutatesState
+                    ? `${executable} changes local filesystem state.`
+                    : `${executable} is a read-only local shell command.`,
+            ],
+        };
+    }
+    return {
+        family: "unknown",
+        executable,
+        action: action || executable,
+        intentLabel: "Generic Command Execution",
+        risk: "low",
+        mutatesState: false,
+        touchesRemote: false,
+        supportsSimulation: false,
+        likelyLongRunning: commandArgs.some((value) => LONG_RUNNING_ACTIONS.has(normalizeExecutable(value))),
+        interactive: false,
+        reasons: ["Unknown command type. why-cli will execute it directly unless you force simulation."],
+    };
+}
+function resolveExecutionMode(requestedMode, intent) {
+    if (requestedMode !== "auto") {
+        return requestedMode;
+    }
+    if (intent.mutatesState || intent.touchesRemote || intent.risk === "high" || intent.risk === "critical") {
+        return "simulate";
+    }
+    return "run";
+}
+//# sourceMappingURL=command-intelligence.js.map

package/dist/core/command-intelligence.js.map

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

package/dist/core/env.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEnv = loadEnv;
+exports.resolveEnvAlias = resolveEnvAlias;
+exports.getGlobalConfigDir = getGlobalConfigDir;
+exports.getGlobalEnvPath = getGlobalEnvPath;
+exports.serializeConfig = serializeConfig;
+exports.writeGlobalConfig = writeGlobalConfig;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const ENV_FILENAMES = [".env.local", ".env"];
+function parseEnvLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+        return null;
+    }
+    const exportPrefix = trimmed.startsWith("export ") ? trimmed.slice(7) : trimmed;
+    const separatorIndex = exportPrefix.indexOf("=");
+    if (separatorIndex <= 0) {
+        return null;
+    }
+    const key = exportPrefix.slice(0, separatorIndex).trim();
+    let value = exportPrefix.slice(separatorIndex + 1).trim();
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+    }
+    value = value.replace(/\\n/g, "\n");
+    return key ? [key, value] : null;
+}
+function parseEnvFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, "utf8");
+    const entries = content
+        .split(/\r?\n/)
+        .map(parseEnvLine)
+        .filter((entry) => entry !== null);
+    return Object.fromEntries(entries);
+}
+function candidateDirectories(cwd) {
+    const directories = [];
+    let current = path_1.default.resolve(cwd);
+    while (true) {
+        directories.push(current);
+        const parent = path_1.default.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    const home = process.env.HOME;
+    if (home) {
+        directories.push(home);
+        directories.push(path_1.default.join(home, ".config", "why-cli"));
+    }
+    return [...new Set(directories)];
+}
+function loadEnv(cwd) {
+    for (const directory of candidateDirectories(cwd)) {
+        for (const filename of ENV_FILENAMES) {
+            const candidate = path_1.default.join(directory, filename);
+            if ((0, fs_1.existsSync)(candidate)) {
+                const values = parseEnvFile(candidate);
+                for (const [key, value] of Object.entries(values)) {
+                    if (!process.env[key]) {
+                        process.env[key] = value;
+                    }
+                }
+                return {
+                    filePath: candidate,
+                    values,
+                };
+            }
+        }
+    }
+    return {
+        values: {},
+    };
+}
+function resolveEnvAlias(names) {
+    for (const name of names) {
+        const value = process.env[name];
+        if (value && value.trim()) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+function getGlobalConfigDir() {
+    const home = process.env.HOME ?? process.cwd();
+    return path_1.default.join(home, ".config", "why-cli");
+}
+function getGlobalEnvPath() {
+    return path_1.default.join(getGlobalConfigDir(), ".env");
+}
+function serializeConfig(config) {
+    const lines = [
+        `WHY_PROVIDER=${config.provider ?? "auto"}`,
+        `OPENAI_API_KEY=${config.openaiApiKey ?? ""}`,
+        `OPENAI_MODEL=${config.openaiModel ?? "gpt-4.1"}`,
+        `OPENAI_BASE_URL=${config.openaiBaseUrl ?? "https://api.openai.com/v1"}`,
+        `OLLAMA_HOST=${config.ollamaHost ?? "http://127.0.0.1:11434"}`,
+        `OLLAMA_MODEL=${config.ollamaModel ?? "gemma3:4b"}`,
+        `WHY_SKILL=${config.skill ?? "debug,fix"}`,
+    ];
+    return `${lines.join("\n")}\n`;
+}
+function writeGlobalConfig(config) {
+    const dir = getGlobalConfigDir();
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    const filePath = getGlobalEnvPath();
+    (0, fs_1.writeFileSync)(filePath, serializeConfig(config), "utf8");
+    return filePath;
+}
+//# sourceMappingURL=env.js.map

package/dist/core/env.js.map

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

package/dist/core/error-parser.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInterruptedError = createInterruptedError;
+exports.parseError = parseError;
+function createInterruptedError(command, signal) {
+    const signalLabel = signal ?? "SIGINT";
+    return {
+        category: "interrupted",
+        headline: "Command interrupted",
+        summary: `The command \`${command}\` was interrupted by ${signalLabel}.`,
+        evidence: [`Interrupted by ${signalLabel}`],
+        suggestions: ["Re-run the command when you are ready, or add `--stream` for live interactive output."],
+        firstErrorLine: `Interrupted by ${signalLabel}`,
+        fileReferences: [],
+        stackFrames: [],
+        signals: ["interrupted"],
+    };
+}
+function cleanLines(value) {
+    return value
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+}
+function takeUnique(values, limit = 5) {
+    return [...new Set(values)].slice(0, limit);
+}
+function detectCategory(combined, signals) {
+    if (/ENOENT|command not found|not recognized as an internal or external command/i.test(combined)) {
+        return "missing-command";
+    }
+    if (/EACCES|EPERM|permission denied/i.test(combined)) {
+        return "permissions";
+    }
+    if (/ECONNREFUSED|ENOTFOUND|ETIMEDOUT|fetch failed|network|socket hang up/i.test(combined)) {
+        return "network";
+    }
+    if (/Traceback \(most recent call last\):|ModuleNotFoundError|ImportError|SyntaxError:/i.test(combined)) {
+        return "python";
+    }
+    if (/TS\d{4}|typescript/i.test(combined)) {
+        return "typescript";
+    }
+    if (/npm error|npm ERR!|pnpm|yarn error|Missing script:/i.test(combined)) {
+        return "package-manager";
+    }
+    if (/ReferenceError|TypeError|SyntaxError|Cannot find module|UnhandledPromiseRejection/i.test(combined)) {
+        return "runtime";
+    }
+    if (signals.includes("stack-trace")) {
+        return "runtime";
+    }
+    return "unknown";
+}
+function detectSignals(lines, combined) {
+    const signals = [];
+    if (/error|failed|exception|fatal|panic/i.test(combined)) {
+        signals.push("error-keyword");
+    }
+    if (lines.some((line) => /^\s*at\s.+/.test(line) || /^at\s.+/.test(line))) {
+        signals.push("stack-trace");
+    }
+    if (/[A-Za-z0-9_./-]+\.(ts|tsx|js|jsx|py|go|rs|java|json|yml|yaml)\(\d+,\d+\)/i.test(combined)) {
+        signals.push("file-location");
+    }
+    if (/Missing script:/i.test(combined)) {
+        signals.push("missing-script");
+    }
+    if (/not a git repository/i.test(combined)) {
+        signals.push("not-a-repository");
+    }
+    if (/--dry-run|dry run|simulation/i.test(combined)) {
+        signals.push("dry-run-context");
+    }
+    if (/timed out|timeout/i.test(combined)) {
+        signals.push("timeout");
+    }
+    return takeUnique(signals);
+}
+function extractFirstErrorLine(lines) {
+    return lines.find((line) => /error|exception|fatal|panic|failed|ENOENT|EACCES|EPERM/i.test(line)) ?? lines[0];
+}
+function extractFileReferences(combined) {
+    const matches = [
+        ...combined.matchAll(/([A-Za-z0-9_./-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|json|yml|yaml))(?::\d+|(?:\(\d+,\d+\)))?/g),
+    ].map((match) => match[1]);
+    return takeUnique(matches, 8);
+}
+function extractStackFrames(lines) {
+    return takeUnique(lines.filter((line) => /^at\s.+/.test(line) || /^\s*at\s.+/.test(line)), 5);
+}
+function extractEvidence(lines, firstErrorLine) {
+    const prioritized = [
+        ...(firstErrorLine ? [firstErrorLine] : []),
+        ...lines.filter((line) => /error|exception|fatal|panic|ENOENT|EACCES|EPERM|Missing script:/i.test(line)),
+        ...lines.filter((line) => /[A-Za-z0-9_./-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|json|yml|yaml)\(\d+,\d+\)/i.test(line)),
+    ];
+    return takeUnique(prioritized.length > 0 ? prioritized : lines.slice(0, 3), 4);
+}
+function buildFallbackSuggestions(category, signals) {
+    const suggestions = [
+        "Start with the first concrete error line instead of later noisy output.",
+        "Re-run with `--stream` for live logs or `--json` for structured output.",
+    ];
+    if (signals.includes("file-location")) {
+        suggestions.push("Open the referenced file and fix the earliest reported location first.");
+    }
+    if (signals.includes("stack-trace")) {
+        suggestions.push("Follow the first stack frame that points into your own code.");
+    }
+    if (signals.includes("missing-script")) {
+        suggestions.push("Run `npm run` to list available scripts, then use the correct one.");
+    }
+    if (category === "missing-command") {
+        suggestions.push("Check that the executable exists on PATH or run it through your package manager.");
+    }
+    if (category === "network") {
+        suggestions.push("Check whether the target service, host, or local server is reachable.");
+    }
+    return takeUnique(suggestions, 4);
+}
+function buildHeadline(category, firstErrorLine) {
+    switch (category) {
+        case "missing-command":
+            return "Missing executable";
+        case "permissions":
+            return "Permission problem";
+        case "network":
+            return "Network or service failure";
+        case "typescript":
+            return "TypeScript failure";
+        case "package-manager":
+            return "Package manager failure";
+        case "python":
+            return "Python failure";
+        case "runtime":
+            return "Runtime failure";
+        default:
+            return firstErrorLine ? "Command failed" : "No output from command";
+    }
+}
+function buildSummary(command, exitCode, firstErrorLine) {
+    if (firstErrorLine) {
+        return firstErrorLine;
+    }
+    return `The command \`${command}\` exited${exitCode === null ? "" : ` with code ${exitCode}`}.`;
+}
+function parseError(command, stdout, stderr, exitCode) {
+    const combined = `${stderr}\n${stdout}`.trim();
+    const lines = cleanLines(combined);
+    const signals = detectSignals(lines, combined);
+    const firstErrorLine = extractFirstErrorLine(lines);
+    const category = detectCategory(combined, signals);
+    const headline = buildHeadline(category, firstErrorLine);
+    const summary = buildSummary(command, exitCode, firstErrorLine);
+    const fileReferences = extractFileReferences(combined);
+    const stackFrames = extractStackFrames(lines);
+    const evidence = extractEvidence(lines, firstErrorLine);
+    const suggestions = buildFallbackSuggestions(category, signals);
+    return {
+        category,
+        summary,
+        headline,
+        evidence,
+        suggestions,
+        firstErrorLine,
+        fileReferences,
+        stackFrames,
+        signals,
+    };
+}
+//# sourceMappingURL=error-parser.js.map

package/dist/core/error-parser.js.map

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

package/dist/core/process.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runProcess = runProcess;
+const child_process_1 = require("child_process");
+async function runProcess(commandArgs, options) {
+    const [file, ...args] = commandArgs;
+    if (!file) {
+        throw new Error("No executable was provided.");
+    }
+    const startedAt = Date.now();
+    let stdout = "";
+    let stderr = "";
+    let timedOut = false;
+    const streamedOutput = options.streamOutput ?? false;
+    let child;
+    try {
+        child = (0, child_process_1.spawn)(file, args, {
+            cwd: options.cwd,
+            env: process.env,
+        });
+    }
+    catch (error) {
+        const message = error.message;
+        return {
+            command: commandArgs.join(" "),
+            commandArgs,
+            cwd: options.cwd,
+            stdout,
+            stderr: message,
+            durationMs: Date.now() - startedAt,
+            exitCode: null,
+            signal: null,
+            ok: false,
+            timedOut,
+            streamedOutput,
+            started: false,
+        };
+    }
+    if (options.inheritStdin && process.stdin.isTTY) {
+        process.stdin.resume();
+        process.stdin.pipe(child.stdin);
+    }
+    const forwardSignal = (signal) => {
+        if (!child.killed) {
+            child.kill(signal);
+        }
+    };
+    const handleSigint = () => {
+        forwardSignal("SIGINT");
+    };
+    const handleSigterm = () => {
+        forwardSignal("SIGTERM");
+    };
+    process.once("SIGINT", handleSigint);
+    process.once("SIGTERM", handleSigterm);
+    child.stdout.on("data", (chunk) => {
+        const text = chunk.toString();
+        stdout += text;
+        options.onStdout?.(text);
+    });
+    child.stderr.on("data", (chunk) => {
+        const text = chunk.toString();
+        stderr += text;
+        options.onStderr?.(text);
+    });
+    const timeout = options.timeoutMs
+        ? setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, options.timeoutMs)
+        : undefined;
+    return new Promise((resolve) => {
+        child.on("error", (error) => {
+            if (timeout) {
+                clearTimeout(timeout);
+            }
+            resolve({
+                command: commandArgs.join(" "),
+                commandArgs,
+                cwd: options.cwd,
+                stdout,
+                stderr: error.message,
+                durationMs: Date.now() - startedAt,
+                exitCode: null,
+                signal: null,
+                ok: false,
+                timedOut,
+                streamedOutput,
+                started: true,
+            });
+        });
+        child.on("close", (exitCode, signal) => {
+            process.removeListener("SIGINT", handleSigint);
+            process.removeListener("SIGTERM", handleSigterm);
+            if (options.inheritStdin && process.stdin.isTTY) {
+                process.stdin.unpipe(child.stdin);
+            }
+            if (timeout) {
+                clearTimeout(timeout);
+            }
+            resolve({
+                command: commandArgs.join(" "),
+                commandArgs,
+                cwd: options.cwd,
+                stdout,
+                stderr,
+                durationMs: Date.now() - startedAt,
+                exitCode,
+                signal,
+                ok: exitCode === 0 && !timedOut,
+                timedOut,
+                streamedOutput,
+                started: true,
+            });
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/core/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/core/process.ts"],"names":[],"mappings":";;AA2BA,gCA4HC;AAvJD,iDAAsE;AA2B/D,KAAK,UAAU,UAAU,CAAC,WAAqB,EAAE,OAA0B;IAChF,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACrD,IAAI,KAAqC,CAAC;IAE1C,IAAI,CAAC;QACH,KAAK,GAAG,IAAA,qBAAK,EAAC,IAAI,EAAE,IAAI,EAAE;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAI,KAAe,CAAC,OAAO,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YAC9B,WAAW;YACX,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM;YACN,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,EAAE,EAAE,KAAK;YACT,QAAQ;YACR,cAAc;YACd,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAEvC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS;QAC/B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,IAAI,OAAO,CAAmB,CAAC,OAAO,EAAE,EAAE;QAC/C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YAED,OAAO,CAAC;gBACN,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC9B,WAAW;gBACX,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM;gBACN,MAAM,EAAG,KAAe,CAAC,OAAO;gBAChC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,EAAE,EAAE,KAAK;gBACT,QAAQ;gBACR,cAAc;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACrC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChD,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YAED,OAAO,CAAC;gBACN,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC9B,WAAW;gBACX,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM;gBACN,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,QAAQ;gBACR,MAAM;gBACN,EAAE,EAAE,QAAQ,KAAK,CAAC,IAAI,CAAC,QAAQ;gBAC/B,QAAQ;gBACR,cAAc;gBACd,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}