@nichollasf/ai-kit 1.0.1

package/dist/cli.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { realpathSync } from "node:fs";
+import { createInterface } from "node:readline/promises";
+import { pathToFileURL } from "node:url";
+import { HARNESS_NAMES, ROLE_NAMES, normalizeSelection, } from "./catalog.js";
+import { AiKitError, runCommand, } from "./installer.js";
+const HELP = `Usage: ai-kit [command] [options]
+
+No command opens the interactive project installer.
+  add, init   Install packaged archetypes (init is an alias)
+  list        List archetypes, pinned bindings and harness presets
+  update      Update intact owned artifacts; migrate v1/v2
+  check       Check structural integrity and local readiness
+  uninstall   Remove intact owned artifacts only
+
+  --harnesses <list>   codex,claude-code,opencode; required non-interactively
+  --archetypes <list>  Individual roles (see list)
+  --primary <role>    Select the standalone main role in an incomplete team
+  --team              Select the complete seven-role team (default)
+  --target <path>     Existing project directory (default: cwd)
+  --method <method>   symlink (default) or copy; no silent fallback
+  --route <route>     check only: gpt (default) or claude in OpenCode
+  -y, --yes           Use explicit selections without prompting
+  --dry-run          Validate and describe changes; zero writes
+  -h, --help         Show help
+
+update retains the installed selection unless flags replace it.
+No global installation, arbitrary models, harness installation or credentials.
+`;
+export function parseArguments(args, cwd = process.cwd()) {
+    let command = "add";
+    let seen = false;
+    let help = false;
+    let yes = false;
+    let team = false;
+    const options = { target: cwd };
+    const selections = new Set();
+    const commands = ["add", "init", "list", "update", "check", "uninstall"];
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (commands.includes(arg)) {
+            if (seen)
+                throw new AiKitError("Only one command may be specified.", 2);
+            command = arg;
+            seen = true;
+            continue;
+        }
+        if (arg === "-h" || arg === "--help") {
+            help = true;
+            continue;
+        }
+        if (arg === "-y" || arg === "--yes") {
+            yes = true;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            options.dryRun = true;
+            continue;
+        }
+        if (arg === "--team") {
+            team = true;
+            continue;
+        }
+        if ([
+            "--harnesses",
+            "--archetypes",
+            "--target",
+            "--method",
+            "--route",
+            "--primary",
+        ].includes(arg)) {
+            if (selections.has(arg))
+                throw new AiKitError(`Repeated option: ${arg}`, 2);
+            selections.add(arg);
+            const value = args[++index];
+            if (!value || value.startsWith("-"))
+                throw new AiKitError(`${arg} requires a value.`, 2);
+            if (arg === "--target")
+                options.target = value;
+            if (arg === "--harnesses")
+                options.harnesses = value.split(",");
+            if (arg === "--archetypes")
+                options.archetypes = value.split(",");
+            if (arg === "--primary") {
+                if (!ROLE_NAMES.includes(value))
+                    throw new AiKitError("Unknown primary archetype.", 2);
+                options.primary = value;
+            }
+            if (arg === "--method") {
+                if (value !== "symlink" && value !== "copy")
+                    throw new AiKitError("--method must be symlink or copy.", 2);
+                options.method = value;
+            }
+            if (arg === "--route") {
+                if (value !== "gpt" && value !== "claude")
+                    throw new AiKitError("--route must be gpt or claude.", 2);
+                options.route = value;
+            }
+            continue;
+        }
+        throw new AiKitError(`Unknown argument: ${arg}`, 2);
+    }
+    if (team && options.archetypes)
+        throw new AiKitError("Choose --team or --archetypes.", 2);
+    if (team)
+        options.archetypes = [...ROLE_NAMES];
+    if (options.harnesses?.some((h) => !HARNESS_NAMES.includes(h)) ||
+        options.harnesses?.length === 0)
+        throw new AiKitError("Unknown harness; use codex,claude-code,opencode.", 2);
+    if (options.archetypes?.some((r) => !ROLE_NAMES.includes(r)))
+        throw new AiKitError("Unknown archetype; run list.", 2);
+    if (options.route && command !== "check")
+        throw new AiKitError("--route is supported only by check.", 2);
+    if (!["add", "init", "update"].includes(command) &&
+        (options.harnesses ||
+            options.archetypes ||
+            options.method ||
+            options.primary))
+        throw new AiKitError("Selection flags apply only to add/init/update.", 2);
+    return { command, options, yes, help };
+}
+export async function wizard(options, question, log) {
+    log("ai-kit — project archetype catalog");
+    const harnessText = options.harnesses?.join(",") ??
+        (await question("Harnesses: codex,claude-code,opencode [codex]: "));
+    const rolesText = options.archetypes?.join(",") ??
+        (await question(`Archetypes: team or comma-separated names (${ROLE_NAMES.join(",")}) [team]: `));
+    const method = options.method ??
+        ((await question("Method: symlink or copy [symlink]: ")).trim() ||
+            "symlink");
+    const selection = normalizeSelection({
+        ...(options.primary ? { primary: options.primary } : {}),
+        harnesses: (harnessText.trim() || "codex")
+            .split(",")
+            .map((x) => x.trim()),
+        archetypes: !rolesText.trim() || rolesText.trim() === "team"
+            ? [...ROLE_NAMES]
+            : rolesText.split(",").map((x) => x.trim()),
+        method: method,
+    });
+    log(`Target: ${options.target}\nHarnesses: ${selection.harnesses.join(", ")}\nArchetypes: ${selection.archetypes.join(", ")}\nMethod: ${selection.method}`);
+    if (selection.archetypes.length !== ROLE_NAMES.length) {
+        log("Individual selection: orchestration is disabled.");
+        if (!selection.primary && selection.archetypes.length > 1) {
+            const primary = (await question(`Standalone main role [${selection.archetypes[0]}]: `)).trim() || selection.archetypes[0];
+            selection.primary = primary;
+            normalizeSelection(selection);
+        }
+    }
+    if (selection.archetypes.length !== ROLE_NAMES.length)
+        log(`Primary: ${selection.primary ?? selection.archetypes[0]}`);
+    const answer = (await question(options.dryRun
+        ? "Preview this installation? [Y/n]: "
+        : "Install this selection? [Y/n]: "))
+        .trim()
+        .toLowerCase();
+    if (answer && !["y", "yes"].includes(answer)) {
+        log("Cancelled; no changes made.");
+        return undefined;
+    }
+    return { ...options, ...selection };
+}
+async function main() {
+    if (Number(process.versions.node.split(".")[0]) < 20)
+        throw new AiKitError("ai-kit requires Node.js 20 or newer.", 2);
+    const parsed = parseArguments(process.argv.slice(2));
+    if (parsed.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    let options = parsed.options;
+    if (["add", "init"].includes(parsed.command) &&
+        !options.harnesses &&
+        !parsed.yes &&
+        process.stdin.isTTY &&
+        process.stdout.isTTY) {
+        const reader = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        try {
+            const selected = await wizard(options, (prompt) => reader.question(prompt), (line) => process.stdout.write(`${line}\n`));
+            if (!selected)
+                return;
+            options = selected;
+        }
+        finally {
+            reader.close();
+        }
+    }
+    process.exitCode = await runCommand(parsed.command, options);
+}
+if (process.argv[1] &&
+    import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
+    main().catch((error) => {
+        process.stderr.write(`ERROR: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = error instanceof AiKitError ? error.exitCode : 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,2 @@
+import { type LoadedCatalog, type Selection } from "./catalog.js";
+export declare function diagnose(target: string, loaded: LoadedCatalog, selection: Selection, route: "gpt" | "claude", log: (message: string) => void): Promise<number>;

package/dist/diagnostics.js

@@ -0,0 +1,301 @@
+import { spawnSync, spawn } from "node:child_process";
+import path from "node:path";
+import { getBinding, materialize, } from "./catalog.js";
+function external(binary, target, args) {
+    const result = spawnSync(binary, args, {
+        cwd: target,
+        encoding: "utf8",
+        timeout: 20_000,
+        maxBuffer: 8 * 1024 * 1024,
+    });
+    return {
+        ok: result.status === 0 && !result.error,
+        output: (result.stdout ?? "").replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, ""),
+    };
+}
+function json(text) {
+    const offsets = [text.indexOf("{"), text.indexOf("[")].filter((n) => n >= 0);
+    if (!offsets.length)
+        throw new Error("No JSON response.");
+    return JSON.parse(text.slice(Math.min(...offsets)));
+}
+// Initialize the CLI's official SDK transport, then request local-only context
+// estimates. No user message, model invocation, auth request or tool call is sent.
+// Do not request get_settings: real personal settings may contain secret env vars.
+function claudeProbe(binary, target) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(binary, [
+            "--setting-sources",
+            "project",
+            "--strict-mcp-config",
+            "--settings",
+            '{"disableAllHooks":true}',
+            "--print",
+            "--input-format",
+            "stream-json",
+            "--output-format",
+            "stream-json",
+            "--verbose",
+            "--no-session-persistence",
+        ], {
+            cwd: target,
+            env: {
+                ...process.env,
+                CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1",
+                DISABLE_AUTOUPDATER: "1",
+            },
+            stdio: ["pipe", "pipe", "ignore"],
+        });
+        let settled = false, buffer = "";
+        let initialized;
+        const timer = setTimeout(() => finish(), 20_000);
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            child.kill();
+            if (result)
+                resolve(result);
+            else
+                reject(new Error("Claude project discovery unavailable."));
+        };
+        const send = (request_id, request) => child.stdin.write(`${JSON.stringify({ type: "control_request", request_id, request })}\n`);
+        child.on("error", () => finish());
+        child.on("exit", () => finish());
+        child.stdin.on("error", () => finish());
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            buffer += chunk;
+            if (buffer.length > 8 * 1024 * 1024) {
+                finish();
+                return;
+            }
+            let newline;
+            while ((newline = buffer.indexOf("\n")) >= 0) {
+                const line = buffer.slice(0, newline);
+                buffer = buffer.slice(newline + 1);
+                if (!line.trim())
+                    continue;
+                try {
+                    const message = JSON.parse(line);
+                    if (message.type !== "control_response")
+                        continue;
+                    const reply = message.response;
+                    if (reply?.subtype !== "success" || !reply.response) {
+                        finish();
+                        return;
+                    }
+                    if (reply.request_id === "initialize") {
+                        // Account/auth data is deliberately neither inspected nor retained.
+                        initialized = {
+                            agents: reply.response.agents,
+                            commands: reply.response.commands,
+                            models: reply.response.models,
+                        };
+                        send("context", {
+                            subtype: "get_context_usage",
+                            detail: "summary",
+                        });
+                    }
+                    else if (reply.request_id === "context") {
+                        finish({
+                            ...initialized,
+                            ...(typeof reply.response.model === "string"
+                                ? { model: reply.response.model }
+                                : {}),
+                        });
+                    }
+                }
+                catch {
+                    finish();
+                    return;
+                }
+            }
+        });
+        send("initialize", { subtype: "initialize", hooks: null });
+    });
+}
+function taskPermission(agent, name) {
+    return agent.permission
+        ?.filter((rule) => (rule.permission === "task" || rule.permission === "*") &&
+        (rule.pattern === "*" || rule.pattern === name))
+        .at(-1)?.action;
+}
+export async function diagnose(target, loaded, selection, route, log) {
+    let ready = true;
+    const report = (ok, message) => {
+        if (!ok)
+            ready = false;
+        log(`[${ok ? "OK" : "WARN"}] Availability: ${message}`);
+    };
+    const binaries = {
+        codex: process.env.AI_KIT_CODEX_BIN ?? "codex",
+        "claude-code": process.env.AI_KIT_CLAUDE_BIN ?? "claude",
+        opencode: process.env.AI_KIT_OPENCODE_BIN ?? "opencode",
+    };
+    for (const harness of selection.harnesses) {
+        const binary = binaries[harness];
+        const version = external(binary, target, ["--version"]);
+        if (!version.ok) {
+            report(false, `${harness} CLI unavailable; installation remains usable after installing that harness.`);
+            continue;
+        }
+        const versionNumber = version.output.match(/\d+\.\d+\.\d+/)?.[0] ?? "unknown";
+        report(true, `${harness} CLI ${versionNumber}.`);
+        if (harness === "codex") {
+            report(versionNumber === "0.154.0", "Codex adapter capability baseline is 0.154.0.");
+            const models = external(binary, target, ["debug", "models", "--bundled"]);
+            try {
+                const entries = json(models.output).models;
+                for (const role of selection.archetypes) {
+                    const binding = getBinding(loaded.catalog, role, "codex");
+                    const id = loaded.catalog.models[binding.model].harnesses.codex;
+                    const entry = entries.find((e) => e.slug === id);
+                    report(Boolean(entry &&
+                        binding.supportedEfforts.every((e) => entry.supported_reasoning_levels.some((v) => v.effort === e))), `Codex ${role}: ${id} and catalog efforts ${binding.supportedEfforts.join(", ")}.`);
+                }
+            }
+            catch {
+                report(false, "Codex bundled model/effort capabilities could not be verified.");
+            }
+            // doctor --json is explicitly redacted. config/read is intentionally not
+            // used: 0.154.0 includes unredacted MCP env/header values in that response.
+            const doctor = external(binary, target, ["doctor", "--json"]);
+            try {
+                const checks = json(doctor.output).checks;
+                const health = checks["config.load"];
+                const source = materialize(loaded, selection).find((asset) => asset.path === ".agents/generated/codex/config.toml");
+                const expectedModel = /^model = "([^"]+)"/m.exec(source?.content.toString("utf8") ?? "")?.[1];
+                report(Boolean(health &&
+                    health.status !== "fail" &&
+                    health.details?.model === expectedModel), "Codex redacted doctor reports a parsed configuration and the expected main model.");
+                report(health?.details?.["startup warnings"] === undefined ||
+                    health.details["startup warnings"] === "0", "Codex has no configuration startup warnings.");
+                report(checks["auth.credentials"]?.status === "ok", "Codex local authentication entry reported by redacted doctor; remote acceptance is not tested.");
+            }
+            catch {
+                report(false, "Codex redacted configuration/authentication health could not be verified.");
+            }
+            report(false, "Codex effective project trust, per-agent effort and personal overrides remain unverified: this CLI has no validated narrow configuration API. Raw config/read is skipped to avoid reading secret-bearing settings.");
+        }
+        else if (harness === "opencode") {
+            const models = external(binary, target, ["models"]);
+            const available = new Set(models.output.split(/\r?\n/).map((s) => s.trim()));
+            for (const candidate of ["gpt", "claude"]) {
+                const required = [
+                    ...new Set(selection.archetypes.map((role) => {
+                        const binding = getBinding(loaded.catalog, role, "opencode", candidate);
+                        return loaded.catalog.models[binding.model].harnesses.opencode;
+                    })),
+                ];
+                const missing = required.filter((id) => !available.has(id));
+                if (candidate !== route) {
+                    log(missing.length
+                        ? `[WARN] Availability: optional OpenCode ${candidate} route unavailable: ${missing.join(", ")}; selected ${route} route unchanged.`
+                        : `[INFO] Availability: optional OpenCode ${candidate} route models listed; selected ${route} route unchanged.`);
+                }
+                else
+                    report(models.ok && !missing.length, `OpenCode selected ${candidate} route ${missing.length ? `unavailable: ${missing.join(", ")}` : "models listed"}; no fallback.`);
+            }
+            report(versionNumber === "1.18.30", "OpenCode adapter capability baseline is 1.18.30.");
+            const profiles = materialize(loaded, selection).filter((asset) => asset.path.startsWith(".agents/generated/opencode/agents/") &&
+                asset.path.endsWith(".md"));
+            const profileNames = profiles.map((asset) => path.posix.basename(asset.path, ".md"));
+            const routed = profiles.filter((asset) => asset.content
+                .toString("utf8")
+                .includes(`model: "${route === "gpt" ? "openai" : "anthropic"}/`));
+            for (const profile of routed) {
+                const name = path.posix.basename(profile.path, ".md");
+                const role = [...selection.archetypes]
+                    .sort((a, b) => b.length - a.length)
+                    .find((candidate) => name === candidate || name.startsWith(`${candidate}-`));
+                const content = profile.content.toString("utf8");
+                const model = /^model: "([^"]+)"/m.exec(content)?.[1];
+                try {
+                    const result = external(binary, target, ["debug", "agent", name]);
+                    const agent = json(result.output);
+                    const expectedEffort = /^(?:reasoningEffort|effort): ([a-z]+)$/m.exec(content)?.[1];
+                    const resolvedEffort = agent.options?.[route === "gpt" ? "reasoningEffort" : "effort"];
+                    const isMain = role === "orchestrator" && selection.archetypes.length === 7;
+                    const delegation = isMain
+                        ? agent.mode === "primary" &&
+                            agent.tools?.task === true &&
+                            taskPermission(agent, "unmanaged-worker") === "deny" &&
+                            profileNames
+                                .filter((profile) => !profile.startsWith("orchestrator"))
+                                .every((profile) => taskPermission(agent, profile) === "allow")
+                        : taskPermission(agent, "unmanaged-worker") === "deny" &&
+                            agent.tools?.task === false;
+                    const readOnly = !["researcher", "reviewer", "orchestrator"].includes(role) ||
+                        (agent.tools?.write !== true &&
+                            agent.tools?.edit !== true &&
+                            agent.tools?.bash === false &&
+                            agent.permission
+                                ?.filter((rule) => (rule.permission === "edit" || rule.permission === "*") &&
+                                rule.pattern === "*")
+                                .at(-1)?.action === "deny");
+                    report(Boolean(result.ok &&
+                        `${agent.model?.providerID}/${agent.model?.modelID}` ===
+                            model &&
+                        resolvedEffort === expectedEffort &&
+                        delegation &&
+                        readOnly), `OpenCode ${name}: native model, effort and delegation/write tools resolved.`);
+                }
+                catch {
+                    report(false, `OpenCode ${name}: native discovery/capabilities could not be verified.`);
+                }
+            }
+            const auth = external(binary, target, ["auth", "list"]);
+            // The native auth list exposes provider names and counts, never key values.
+            const provider = route === "gpt"
+                ? /\bOpenAI\b|\bOPENAI_API_KEY\b/i
+                : /\bAnthropic\b|\bANTHROPIC_API_KEY\b/i;
+            report(auth.ok && provider.test(auth.output), `OpenCode ${route} provider has a local authentication entry (remote acceptance is not tested).`);
+            log("[INFO] Behavioral: OpenCode task scopes, at most four workers, plan approval and independent review remain instructions; model and tool execution were not exercised.");
+            log(`[INFO] Scope: OpenCode readiness applies to explicit --agent ${selection.archetypes.length === 7 ? (route === "gpt" ? "orchestrator" : "orchestrator-claude") : (selection.primary ?? selection.archetypes[0]) + (route === "claude" ? "-claude" : "")}; ambient default_agent overrides are not inspected because raw configuration can contain credentials.`);
+        }
+        else {
+            const auth = external(binary, target, ["auth", "status", "--json"]);
+            try {
+                const status = json(auth.output);
+                report(auth.ok && status.loggedIn === true, "Claude Code authentication status; no credential contents are displayed.");
+            }
+            catch {
+                report(false, "Claude Code authentication status is unverified; run claude auth status.");
+            }
+            report(versionNumber === "2.1.265", "Claude Code adapter capability baseline is 2.1.265.");
+            try {
+                const probe = await claudeProbe(binary, target);
+                for (const role of selection.archetypes) {
+                    const binding = getBinding(loaded.catalog, role, "claude-code");
+                    const id = loaded.catalog.models[binding.model].harnesses["claude-code"];
+                    const agent = probe.agents.find((candidate) => candidate.name === role);
+                    report(agent?.model === id, `Claude Code ${role}: project profile discovered on ${id}.`);
+                    const capability = probe.models.find((model) => model.resolvedModel?.replace(/\[1m\]$/, "") === id);
+                    report(Boolean(capability &&
+                        (binding.effortSupport === "unsupported"
+                            ? !capability.supportsEffort
+                            : binding.supportedEfforts.every((effort) => capability.supportedEffortLevels?.includes(effort)))), `Claude Code ${id}: account model/effort capability reported by the CLI.`);
+                }
+                const mainRole = selection.archetypes.length === 7
+                    ? "orchestrator"
+                    : (selection.primary ?? selection.archetypes[0]);
+                const main = getBinding(loaded.catalog, mainRole, "claude-code");
+                report(probe.model?.replace(/\[1m\]$/, "") ===
+                    loaded.catalog.models[main.model].harnesses["claude-code"], `Claude Code main ${mainRole} model resolved in project-only settings mode.`);
+                for (const name of ["ai-kit-task-routing", "ai-kit-model-calibration"])
+                    report(probe.commands.some((command) => command.name === name), `Claude Code native skill ${name} discovered.`);
+            }
+            catch {
+                report(false, "Claude Code native project discovery/capabilities could not be verified without a model call.");
+            }
+            log("[INFO] Behavioral: Claude verification uses project settings with hooks/MCP disabled; actual tool execution, personal overrides, plan approval and independent review are not exercised. Run with --setting-sources project to use the verified settings scope.");
+        }
+    }
+    log(ready
+        ? "[OK] Environment ready for the selected routes."
+        : "[WARN] Environment readiness is not established; see availability diagnostics above.");
+    return ready ? 0 : 4;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,WAAW,GAGZ,MAAM,cAAc,CAAC;AAEtB,SAAS,QAAQ,CAAC,MAAc,EAAE,MAAc,EAAE,IAAc;IAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE;QACrC,GAAG,EAAE,MAAM;QACX,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;KAC3B,CAAC,CAAC;IACH,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;QACxC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC;AACD,SAAS,IAAI,CAAC,IAAY;IACxB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAYD,+EAA+E;AAC/E,mFAAmF;AACnF,mFAAmF;AACnF,SAAS,WAAW,CAAC,MAAc,EAAE,MAAc;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CACjB,MAAM,EACN;YACE,mBAAmB;YACnB,SAAS;YACT,qBAAqB;YACrB,YAAY;YACZ,0BAA0B;YAC1B,SAAS;YACT,gBAAgB;YAChB,aAAa;YACb,iBAAiB;YACjB,aAAa;YACb,WAAW;YACX,0BAA0B;SAC3B,EACD;YACE,GAAG,EAAE,MAAM;YACX,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,wCAAwC,EAAE,GAAG;gBAC7C,mBAAmB,EAAE,GAAG;aACzB;YACD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CACF,CAAC;QACF,IAAI,OAAO,GAAG,KAAK,EACjB,MAAM,GAAG,EAAE,CAAC;QACd,IAAI,WAAwB,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,CAAC,MAAoB,EAAE,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,CAAC;;gBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,UAAkB,EAAE,OAAgC,EAAE,EAAE,CACpE,KAAK,CAAC,KAAK,CAAC,KAAK,CACf,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,IAAI,CACxE,CAAC;QACJ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;gBACpC,MAAM,EAAE,CAAC;gBACT,OAAO;YACT,CAAC;YACD,IAAI,OAAe,CAAC;YACpB,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACtC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;oBAAE,SAAS;gBAC3B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAO9B,CAAC;oBACF,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB;wBAAE,SAAS;oBAClD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;oBAC/B,IAAI,KAAK,EAAE,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;wBACpD,MAAM,EAAE,CAAC;wBACT,OAAO;oBACT,CAAC;oBACD,IAAI,KAAK,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;wBACtC,oEAAoE;wBACpE,WAAW,GAAG;4BACZ,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAA+B;4BACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAmC;4BAC5D,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAA+B;yBACvD,CAAC;wBACF,IAAI,CAAC,SAAS,EAAE;4BACd,OAAO,EAAE,mBAAmB;4BAC5B,MAAM,EAAE,SAAS;yBAClB,CAAC,CAAC;oBACL,CAAC;yBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC1C,MAAM,CAAC;4BACL,GAAG,WAAW;4BACd,GAAG,CAAC,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,QAAQ;gCAC1C,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE;gCACjC,CAAC,CAAC,EAAE,CAAC;yBACR,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,EAAE,CAAC;oBACT,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AASD,SAAS,cAAc,CACrB,KAAoB,EACpB,IAAY;IAEZ,OAAO,KAAK,CAAC,UAAU;QACrB,EAAE,MAAM,CACN,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;QACvD,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAClD;SACA,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;AACpB,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,MAAqB,EACrB,SAAoB,EACpB,KAAuB,EACvB,GAA8B;IAE9B,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,MAAM,MAAM,GAAG,CAAC,EAAW,EAAE,OAAe,EAAE,EAAE;QAC9C,IAAI,CAAC,EAAE;YAAE,KAAK,GAAG,KAAK,CAAC;QACvB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,mBAAmB,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO;QAC9C,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,QAAQ;QACxD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,UAAU;KACxD,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,CACJ,KAAK,EACL,GAAG,OAAO,8EAA8E,CACzF,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,aAAa,GACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAC1D,MAAM,CAAC,IAAI,EAAE,GAAG,OAAO,QAAQ,aAAa,GAAG,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,MAAM,CACJ,aAAa,KAAK,SAAS,EAC3B,+CAA+C,CAChD,CAAC;YACF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;YAC1E,IAAI,CAAC;gBACH,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,CAAC,MAAM,CAMnB,CAAC,MAAM,CAAC;gBACT,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;oBACxC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,SAAS,CAAC,KAAM,CAAC;oBAClE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;oBACjD,MAAM,CACJ,OAAO,CACL,KAAK;wBACH,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,KAAK,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAC7D,CACJ,EACD,SAAS,IAAI,KAAK,EAAE,wBAAwB,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnF,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CACJ,KAAK,EACL,gEAAgE,CACjE,CAAC;YACJ,CAAC;YACD,yEAAyE;YACzE,4EAA4E;YAC5E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,CAAC,MAAM,CAMnB,CAAC,MAAM,CAAC;gBACT,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;gBACrC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,CAChD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,qCAAqC,CAChE,CAAC;gBACF,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAC9C,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACvC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACP,MAAM,CACJ,OAAO,CACL,MAAM;oBACJ,MAAM,CAAC,MAAM,KAAK,MAAM;oBACxB,MAAM,CAAC,OAAO,EAAE,KAAK,KAAK,aAAa,CAC1C,EACD,mFAAmF,CACpF,CAAC;gBACF,MAAM,CACJ,MAAM,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,KAAK,SAAS;oBACjD,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,GAAG,EAC5C,8CAA8C,CAC/C,CAAC;gBACF,MAAM,CACJ,MAAM,CAAC,kBAAkB,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3C,gGAAgG,CACjG,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CACJ,KAAK,EACL,2EAA2E,CAC5E,CAAC;YACJ,CAAC;YACD,MAAM,CACJ,KAAK,EACL,oNAAoN,CACrN,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAClD,CAAC;YACF,KAAK,MAAM,SAAS,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAU,EAAE,CAAC;gBACnD,MAAM,QAAQ,GAAG;oBACf,GAAG,IAAI,GAAG,CACR,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;wBAChC,MAAM,OAAO,GAAG,UAAU,CACxB,MAAM,CAAC,OAAO,EACd,IAAI,EACJ,UAAU,EACV,SAAS,CACV,CAAC;wBACF,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,SAAS,CAAC,QAAS,CAAC;oBACnE,CAAC,CAAC,CACH;iBACF,CAAC;gBACF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC5D,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;oBACxB,GAAG,CACD,OAAO,CAAC,MAAM;wBACZ,CAAC,CAAC,0CAA0C,SAAS,uBAAuB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,mBAAmB;wBACpI,CAAC,CAAC,0CAA0C,SAAS,kCAAkC,KAAK,mBAAmB,CAClH,CAAC;gBACJ,CAAC;;oBACC,MAAM,CACJ,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAC5B,qBAAqB,SAAS,UAAU,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,gBAAgB,CAChI,CAAC;YACN,CAAC;YACD,MAAM,CACJ,aAAa,KAAK,SAAS,EAC3B,kDAAkD,CACnD,CAAC;YACF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,MAAM,CACpD,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,oCAAoC,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC7B,CAAC;YACF,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CACvC,CAAC;YACF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,KAAK,CAAC,OAAO;iBACV,QAAQ,CAAC,MAAM,CAAC;iBAChB,QAAQ,CAAC,WAAW,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CACpE,CAAC;YACF,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtD,MAAM,IAAI,GAAG,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC;qBACnC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;qBACnC,IAAI,CACH,CAAC,SAAS,EAAE,EAAE,CACZ,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CACxD,CAAC;gBACL,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACtD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;oBAClE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAkB,CAAC;oBACnD,MAAM,cAAc,GAAG,yCAAyC,CAAC,IAAI,CACnE,OAAO,CACR,EAAE,CAAC,CAAC,CAAC,CAAC;oBACP,MAAM,cAAc,GAClB,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAClE,MAAM,MAAM,GACV,IAAI,KAAK,cAAc,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;oBAC/D,MAAM,UAAU,GAAG,MAAM;wBACvB,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;4BACxB,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI;4BAC1B,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,MAAM;4BACpD,YAAY;iCACT,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;iCACxD,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;wBACnE,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,MAAM;4BACpD,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC;oBAChC,MAAM,QAAQ,GACZ,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAC1D,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;4BAC1B,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI;4BAC1B,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,KAAK;4BAC3B,KAAK,CAAC,UAAU;gCACd,EAAE,MAAM,CACN,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;gCACvD,IAAI,CAAC,OAAO,KAAK,GAAG,CACvB;iCACA,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;oBAClC,MAAM,CACJ,OAAO,CACL,MAAM,CAAC,EAAE;wBACP,GAAG,KAAK,CAAC,KAAK,EAAE,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;4BAClD,KAAK;wBACP,cAAc,KAAK,cAAc;wBACjC,UAAU;wBACV,QAAQ,CACX,EACD,YAAY,IAAI,6DAA6D,CAC9E,CAAC;gBACJ,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CACJ,KAAK,EACL,YAAY,IAAI,wDAAwD,CACzE,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACxD,4EAA4E;YAC5E,MAAM,QAAQ,GACZ,KAAK,KAAK,KAAK;gBACb,CAAC,CAAC,gCAAgC;gBAClC,CAAC,CAAC,sCAAsC,CAAC;YAC7C,MAAM,CACJ,IAAI,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EACrC,YAAY,KAAK,+EAA+E,CACjG,CAAC;YACF,GAAG,CACD,uKAAuK,CACxK,CAAC;YACF,GAAG,CACD,gEAAgE,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,wGAAwG,CAChW,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAA2B,CAAC;gBAC3D,MAAM,CACJ,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EACnC,0EAA0E,CAC3E,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CACJ,KAAK,EACL,0EAA0E,CAC3E,CAAC;YACJ,CAAC;YACD,MAAM,CACJ,aAAa,KAAK,SAAS,EAC3B,qDAAqD,CACtD,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAChD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;oBACxC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;oBAChE,MAAM,EAAE,GACN,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,SAAS,CAAC,aAAa,CAAE,CAAC;oBAClE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAC7B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CACvC,CAAC;oBACF,MAAM,CACJ,KAAK,EAAE,KAAK,KAAK,EAAE,EACnB,eAAe,IAAI,mCAAmC,EAAE,GAAG,CAC5D,CAAC;oBACF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAClC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,CAC9D,CAAC;oBACF,MAAM,CACJ,OAAO,CACL,UAAU;wBACR,CAAC,OAAO,CAAC,aAAa,KAAK,aAAa;4BACtC,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc;4BAC5B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CACxC,UAAU,CAAC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,CACnD,CAAC,CACT,EACD,eAAe,EAAE,wDAAwD,CAC1E,CAAC;gBACJ,CAAC;gBACD,MAAM,QAAQ,GACZ,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;oBAC/B,CAAC,CAAC,cAAc;oBAChB,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC;gBACtD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;gBACjE,MAAM,CACJ,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;oBACjC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,SAAS,CAAC,aAAa,CAAC,EAC7D,oBAAoB,QAAQ,gDAAgD,CAC7E,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;oBACpE,MAAM,CACJ,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,EACvD,4BAA4B,IAAI,cAAc,CAC/C,CAAC;YACN,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CACJ,KAAK,EACL,+FAA+F,CAChG,CAAC;YACJ,CAAC;YACD,GAAG,CACD,iQAAiQ,CAClQ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,GAAG,CACD,KAAK;QACH,CAAC,CAAC,iDAAiD;QACnD,CAAC,CAAC,sFAAsF,CAC3F,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/installer.d.ts

@@ -0,0 +1,18 @@
+import { type HarnessName, type RoleName, type Method } from "./catalog.js";
+export type CommandName = "add" | "init" | "list" | "update" | "check" | "uninstall";
+export interface RunOptions {
+    target: string;
+    dryRun?: boolean;
+    packageRoot?: string;
+    log?: (message: string) => void;
+    harnesses?: HarnessName[];
+    archetypes?: RoleName[];
+    method?: Method;
+    primary?: RoleName;
+    route?: "gpt" | "claude";
+}
+export declare class AiKitError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function runCommand(command: CommandName, options: RunOptions): Promise<number>;