@zenalexa/unicli 0.217.3 → 0.218.0

package/dist/engine/verify-row-shape.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @owner   src/engine/verify-row-shape.ts
+ * @does    Detect "silent column drops" — adapter declares columns the data never populates.
+ * @needs   none
+ * @feeds   src/cli.ts (unicli test post-run check), src/commands/lint.ts (future audit gate)
+ * @breaks  A column declared in YAML but absent in every row is a contract violation; surface as a structured warning. Treats `false`/`0`/`[]`/`{}` as POPULATED (formatter renders them as visible values); only `undefined`, `null`, and the empty string "" count as drops.
+ */
+export interface RowShapeReport {
+    /** declared columns the data never populated with a non-null value */
+    dropped: string[];
+    /** declared columns at least one row populated */
+    populated: string[];
+    /** true when results are non-array, items are non-object, or no columns declared */
+    skipped: boolean;
+}
+export declare function verifyRowShape(results: unknown, declaredColumns: readonly string[] | undefined): RowShapeReport;
+//# sourceMappingURL=verify-row-shape.d.ts.map

package/dist/engine/verify-row-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-row-shape.d.ts","sourceRoot":"","sources":["../../src/engine/verify-row-shape.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC7C,cAAc,CAuBhB"}

package/dist/engine/verify-row-shape.js

@@ -0,0 +1,36 @@
+/**
+ * @owner   src/engine/verify-row-shape.ts
+ * @does    Detect "silent column drops" — adapter declares columns the data never populates.
+ * @needs   none
+ * @feeds   src/cli.ts (unicli test post-run check), src/commands/lint.ts (future audit gate)
+ * @breaks  A column declared in YAML but absent in every row is a contract violation; surface as a structured warning. Treats `false`/`0`/`[]`/`{}` as POPULATED (formatter renders them as visible values); only `undefined`, `null`, and the empty string "" count as drops.
+ */
+const EMPTY = { dropped: [], populated: [], skipped: true };
+export function verifyRowShape(results, declaredColumns) {
+    if (!declaredColumns || declaredColumns.length === 0)
+        return EMPTY;
+    if (!Array.isArray(results) || results.length === 0)
+        return EMPTY;
+    const dropped = [];
+    const populated = [];
+    for (const col of declaredColumns) {
+        let seen = false;
+        for (const row of results) {
+            if (row == null || typeof row !== "object" || Array.isArray(row))
+                continue;
+            const value = row[col];
+            if (value === undefined || value === null)
+                continue;
+            if (typeof value === "string" && value.length === 0)
+                continue;
+            seen = true;
+            break;
+        }
+        if (seen)
+            populated.push(col);
+        else
+            dropped.push(col);
+    }
+    return { dropped, populated, skipped: false };
+}
+//# sourceMappingURL=verify-row-shape.js.map

package/dist/engine/verify-row-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-row-shape.js","sourceRoot":"","sources":["../../src/engine/verify-row-shape.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,KAAK,GAAmB,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAE5E,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,eAA8C;IAE9C,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAElE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC9D,SAAS;YACX,MAAM,KAAK,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC9D,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM;QACR,CAAC;QACD,IAAI,IAAI;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YACzB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC"}

package/dist/fast-path/handlers/adapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Fast-path adapter-level handlers — adapter-dry-run / adapter-policy-gate /
+ * site-help.
+ *
+ * These intercept `unicli <site> <cmd> ...` BEFORE Commander loads the full
+ * adapter tree, either to render a dry-run plan, gate on permission policy,
+ * or print site-level help. Each returns true if the fast path consumed the
+ * call.
+ */
+import type { ParsedArgv } from "../parsed-argv.js";
+import { type Io } from "../render.js";
+export declare function handleAdapterDryRun(parsed: ParsedArgv, io: Io): boolean;
+export declare function handleAdapterPolicyGate(parsed: ParsedArgv, io: Io): boolean;
+export declare function handleSiteHelp(parsed: ParsedArgv, io: Io): boolean;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/fast-path/handlers/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/fast-path/handlers/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAEL,KAAK,EAAE,EAGR,MAAM,cAAc,CAAC;AAEtB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CA6DvE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CA4F3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAgClE"}

package/dist/fast-path/handlers/adapter.js

@@ -0,0 +1,169 @@
+/**
+ * Fast-path adapter-level handlers — adapter-dry-run / adapter-policy-gate /
+ * site-help.
+ *
+ * These intercept `unicli <site> <cmd> ...` BEFORE Commander loads the full
+ * adapter tree, either to render a dry-run plan, gate on permission policy,
+ * or print site-level help. Each returns true if the fast path consumed the
+ * call.
+ */
+import { resolveOperationAdapterPath, resolveOperationTargetSurface, } from "../../engine/operation-policy.js";
+import { defaultErrorNextActions } from "../../output/next-actions.js";
+import { format, detectFormat } from "../../output/formatter.js";
+import { ExitCode } from "../../types.js";
+import { readManifest } from "../manifest.js";
+import { evaluateManifestOperationPolicy } from "../policy.js";
+import { emitStderrAndExit, isHelpToken, resolveDryRunArgs, } from "../render.js";
+export function handleAdapterDryRun(parsed, io) {
+    if (!parsed.command || !parsed.dryRun || parsed.rest.length === 0) {
+        return false;
+    }
+    const manifest = readManifest();
+    const info = manifest.sites[parsed.command];
+    if (!info)
+        return false;
+    const [cmdName, ...tokens] = parsed.rest;
+    if (!cmdName || cmdName === "help" || cmdName.startsWith("-"))
+        return false;
+    const command = info.commands.find((candidate) => candidate.name === cmdName);
+    if (!command)
+        return false;
+    const startedAt = Date.now();
+    const args = resolveDryRunArgs(command.args, tokens);
+    if (!args)
+        return false;
+    const adapterType = command.type ?? info.commands[0]?.type ?? "web-api";
+    const targetSurface = resolveOperationTargetSurface({
+        adapterType,
+        targetSurface: command.target_surface,
+    });
+    const adapterPath = resolveOperationAdapterPath(parsed.command, cmdName, command.adapter_path);
+    const operationPolicy = evaluateManifestOperationPolicy({
+        parsed,
+        io,
+        site: parsed.command,
+        commandName: cmdName,
+        command,
+        adapterType,
+        targetSurface,
+        adapterPath,
+        startedAt,
+    });
+    if (!operationPolicy)
+        return true;
+    io.stdout(JSON.stringify({
+        command: `${parsed.command}.${cmdName}`,
+        adapter_type: adapterType,
+        strategy: command.strategy ?? "public",
+        args,
+        args_source: tokens.length > 0 ? "shell" : "defaults",
+        operation_policy: operationPolicy,
+        trace_id: `fast-${Date.now().toString(36)}`,
+        surface: "cli",
+        target_surface: targetSurface,
+        pipeline_steps: command.pipeline_steps ?? 0,
+        adapter_path: adapterPath,
+    }, null, 2));
+    return true;
+}
+export function handleAdapterPolicyGate(parsed, io) {
+    if (!parsed.command || parsed.dryRun || parsed.rest.length === 0) {
+        return false;
+    }
+    const [cmdName] = parsed.rest;
+    if (!cmdName || cmdName === "help" || cmdName.startsWith("-"))
+        return false;
+    if (parsed.rest.slice(1).some(isHelpToken))
+        return false;
+    const startedAt = Date.now();
+    const manifest = readManifest();
+    const info = manifest.sites[parsed.command];
+    if (!info)
+        return false;
+    const command = info.commands.find((candidate) => candidate.name === cmdName);
+    if (!command)
+        return false;
+    const adapterType = command.type ?? info.commands[0]?.type ?? "web-api";
+    const targetSurface = resolveOperationTargetSurface({
+        adapterType,
+        targetSurface: command.target_surface,
+    });
+    const adapterPath = resolveOperationAdapterPath(parsed.command, cmdName, command.adapter_path);
+    const operationPolicy = evaluateManifestOperationPolicy({
+        parsed,
+        io,
+        site: parsed.command,
+        commandName: cmdName,
+        command,
+        adapterType,
+        targetSurface,
+        adapterPath,
+        startedAt,
+    });
+    if (!operationPolicy)
+        return true;
+    if (operationPolicy.enforcement !== "needs_approval" &&
+        operationPolicy.enforcement !== "deny") {
+        return false;
+    }
+    const isDenyRule = operationPolicy.enforcement === "deny";
+    const ruleId = operationPolicy.deny_rule?.id ?? "unknown";
+    const ruleReason = operationPolicy.deny_rule?.reason ?? "permission rule matched";
+    emitStderrAndExit(io, format([], command.columns, detectFormat(parsed.format), {
+        command: `${parsed.command}.${cmdName}`,
+        duration_ms: Date.now() - startedAt,
+        surface: targetSurface,
+        error: {
+            code: "permission_denied",
+            message: isDenyRule
+                ? `permission rule "${ruleId}" denies ${operationPolicy.effect}: ${ruleReason}`
+                : `permission profile "${operationPolicy.profile}" requires approval for ${operationPolicy.effect}`,
+            adapter_path: adapterPath,
+            step: 0,
+            suggestion: operationPolicy.approval_hint ??
+                (isDenyRule
+                    ? "edit or remove the matching permission rule"
+                    : "rerun with --yes or use --permission-profile open"),
+            retryable: false,
+            alternatives: isDenyRule
+                ? [
+                    `unicli --dry-run ${parsed.command} ${cmdName}`,
+                    "edit ~/.unicli/permission-rules.json",
+                ]
+                : [
+                    `unicli --dry-run ${parsed.command} ${cmdName}`,
+                    `unicli --yes --permission-profile ${operationPolicy.profile} ${parsed.command} ${cmdName}`,
+                    `unicli --permission-profile open ${parsed.command} ${cmdName}`,
+                ],
+        },
+        next_actions: defaultErrorNextActions(parsed.command, cmdName, "permission_denied"),
+    }), ExitCode.AUTH_REQUIRED);
+    return true;
+}
+export function handleSiteHelp(parsed, io) {
+    const wantsHelp = parsed.rest.length === 0 || parsed.rest.every(isHelpToken);
+    if (!parsed.command || !wantsHelp)
+        return false;
+    const manifest = readManifest();
+    const info = manifest.sites[parsed.command];
+    if (!info)
+        return false;
+    const commandWidth = Math.max(7, ...info.commands.map((command) => command.name.length));
+    const lines = [
+        `Usage: unicli ${parsed.command} [options] [command]`,
+        "",
+        `Commands for ${parsed.command}`,
+        "",
+        "Options:",
+        "  -h, --help".padEnd(commandWidth + 6) + "display help for command",
+        "",
+        "Commands:",
+    ];
+    for (const command of info.commands) {
+        lines.push(`  ${command.name.padEnd(commandWidth)}  ${command.description ?? ""}`.trimEnd());
+    }
+    lines.push(`  ${"help [command]".padEnd(commandWidth)}  display help for command`);
+    io.stdout(lines.join("\n"));
+    return true;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/fast-path/handlers/adapter.js.map

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

package/dist/fast-path/handlers/discovery.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fast-path discovery handlers — list / search / describe / repair.
+ *
+ * These respond to the agent surface from the manifest alone, with no
+ * Commander tree or adapter loader involvement. Each returns true if the
+ * fast path took ownership of the call, false to fall through.
+ */
+import type { ParsedArgv } from "../parsed-argv.js";
+import { type Io } from "../render.js";
+export declare function handleList(parsed: ParsedArgv, io: Io): boolean;
+export declare function handleSearch(parsed: ParsedArgv, io: Io): boolean;
+export declare function handleDescribe(parsed: ParsedArgv, io: Io): boolean;
+export declare function handleRepair(parsed: ParsedArgv, io: Io): boolean;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/fast-path/handlers/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/fast-path/handlers/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAKL,KAAK,EAAE,EAER,MAAM,cAAc,CAAC;AAEtB,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CA8D9D;AAsBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CA+DhE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CA2HlE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CA4DhE"}

package/dist/fast-path/handlers/discovery.js

@@ -0,0 +1,280 @@
+/**
+ * Fast-path discovery handlers — list / search / describe / repair.
+ *
+ * These respond to the agent surface from the manifest alone, with no
+ * Commander tree or adapter loader involvement. Each returns true if the
+ * fast path took ownership of the call, false to fall through.
+ */
+import { search } from "../../discovery/search.js";
+import { buildMacosDynamicCommands, discoverMacosDynamicData, dynamicMacosDiscoveryEnabled, } from "../../discovery/macos-dynamic.js";
+import { buildDefaultConfig } from "../../engine/repair/config.js";
+import { resolveOperationAdapterPath, resolveOperationTargetSurface, } from "../../engine/operation-policy.js";
+import { readManifest } from "../manifest.js";
+import { evaluateManifestOperationPolicy } from "../policy.js";
+import { argsToJsonSchema, buildChannels, buildExample, emit, summarizeArgs, } from "../render.js";
+export function handleList(parsed, io) {
+    const startedAt = Date.now();
+    let siteFilter;
+    let typeFilter;
+    for (let i = 0; i < parsed.rest.length; i += 1) {
+        const arg = parsed.rest[i];
+        if (arg === "--site") {
+            siteFilter = parsed.rest[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--site=")) {
+            siteFilter = arg.slice("--site=".length);
+            continue;
+        }
+        if (arg === "--type") {
+            typeFilter = parsed.rest[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--type=")) {
+            typeFilter = arg.slice("--type=".length);
+            continue;
+        }
+        return false;
+    }
+    const manifest = readManifest();
+    const rows = Object.entries(manifest.sites)
+        .flatMap(([site, info]) => info.commands.map((command) => {
+        const strategy = command.strategy ?? "public";
+        const tags = [];
+        if (strategy !== "public")
+            tags.push("[auth]");
+        if (command.quarantined === true)
+            tags.push("[quarantined]");
+        return {
+            site,
+            command: command.name,
+            description: command.description ?? "",
+            type: command.type ?? "web-api",
+            auth: tags.join(" "),
+        };
+    }))
+        .concat(dynamicListRows())
+        .filter((row) => !siteFilter || row.site.includes(siteFilter))
+        .filter((row) => !typeFilter || row.type === typeFilter)
+        .sort((a, b) => a.site.localeCompare(b.site) || a.command.localeCompare(b.command));
+    emit(io, rows, ["site", "command", "description", "type", "auth"], parsed.format, "core.list", startedAt);
+    return true;
+}
+function dynamicListRows() {
+    if (!dynamicMacosDiscoveryEnabled())
+        return [];
+    return Object.values(buildMacosDynamicCommands(discoverMacosDynamicData())).map((command) => ({
+        site: "macos",
+        command: command.name,
+        description: command.description ?? "",
+        type: "desktop",
+        auth: "",
+    }));
+}
+export function handleSearch(parsed, io) {
+    const startedAt = Date.now();
+    let limit = 8;
+    let category;
+    const queryParts = [];
+    for (let i = 0; i < parsed.rest.length; i += 1) {
+        const arg = parsed.rest[i];
+        if (arg === "-n" || arg === "--limit") {
+            limit = parseInt(parsed.rest[i + 1] ?? "", 10) || 8;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--limit=")) {
+            limit = parseInt(arg.slice("--limit=".length), 10) || 8;
+            continue;
+        }
+        if (arg === "--category") {
+            category = parsed.rest[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--category=")) {
+            category = arg.slice("--category=".length);
+            continue;
+        }
+        queryParts.push(arg);
+    }
+    const query = queryParts.join(" ");
+    if (!query && !category) {
+        io.stderr("Usage: unicli search <query>  or  unicli search --category <cat>");
+        process.exitCode = 2;
+        return true;
+    }
+    const effectiveQuery = category ? `${category} ${query}`.trim() : query;
+    const results = search(effectiveQuery, limit);
+    if (results.length === 0) {
+        io.stderr(`No commands found for: ${effectiveQuery}`);
+        process.exitCode = 66;
+        return true;
+    }
+    const rows = results.map((result) => ({
+        command: `${result.site} ${result.command}`,
+        description: result.description || `${result.command} for ${result.site}`,
+        score: result.score,
+        category: result.category,
+        usage: result.usage,
+    }));
+    emit(io, rows, ["command", "description", "score", "usage"], parsed.format, "core.search", startedAt);
+    return true;
+}
+export function handleDescribe(parsed, io) {
+    const startedAt = Date.now();
+    const manifest = readManifest();
+    const [site, cmdName] = parsed.rest;
+    if (!site) {
+        const sites = Object.entries(manifest.sites).map(([name, info]) => ({
+            name,
+            display_name: name,
+            type: info.commands[0]?.type ?? "web-api",
+            strategy: info.commands[0]?.strategy ?? "public",
+            commands_count: info.commands.length,
+            description: "",
+        }));
+        io.stdout(JSON.stringify({ sites, total: sites.length }, null, 2));
+        return true;
+    }
+    const info = manifest.sites[site];
+    if (!info) {
+        io.stdout(JSON.stringify({ error: `unknown site: ${site}` }, null, 2));
+        process.exitCode = 64;
+        return true;
+    }
+    if (!cmdName) {
+        const commands = info.commands.map((command) => ({
+            name: command.name,
+            description: command.description ?? "",
+            quarantined: command.quarantined === true,
+            strategy: command.strategy ?? "public",
+            auth: (command.strategy ?? "public") !== "public",
+            browser: command.browser === true,
+            args: summarizeArgs(command.args),
+        }));
+        io.stdout(JSON.stringify({
+            site,
+            display_name: site,
+            type: info.commands[0]?.type ?? "web-api",
+            strategy: info.commands[0]?.strategy ?? "public",
+            commands,
+        }, null, 2));
+        return true;
+    }
+    const command = info.commands.find((candidate) => candidate.name === cmdName);
+    if (!command) {
+        io.stdout(JSON.stringify({ error: `unknown command: ${site} ${cmdName}` }, null, 2));
+        process.exitCode = 64;
+        return true;
+    }
+    const adapterType = command.type ?? info.commands[0]?.type ?? "web-api";
+    const targetSurface = resolveOperationTargetSurface({
+        adapterType,
+        targetSurface: command.target_surface,
+    });
+    const adapterPath = resolveOperationAdapterPath(site, cmdName, command.adapter_path);
+    const operationPolicy = evaluateManifestOperationPolicy({
+        parsed,
+        io,
+        site,
+        commandName: cmdName,
+        command,
+        adapterType,
+        targetSurface,
+        adapterPath,
+        startedAt,
+    });
+    if (!operationPolicy)
+        return true;
+    io.stdout(JSON.stringify({
+        command: `unicli ${site} ${cmdName}`,
+        description: command.description ?? "",
+        quarantined: command.quarantined === true,
+        strategy: command.strategy ?? "public",
+        auth: (command.strategy ?? "public") !== "public",
+        browser: command.browser === true,
+        target_surface: targetSurface,
+        adapter_path: adapterPath,
+        operation_policy: operationPolicy,
+        args_schema: argsToJsonSchema(command.args ?? []),
+        example_stdin: buildExample(command.args ?? []),
+        channels: buildChannels(site, cmdName, command.args ?? []),
+        next_actions: [
+            {
+                command: `unicli ${site} ${cmdName} --dry-run`,
+                description: "Preview the resolved argument bag and pipeline plan",
+            },
+            {
+                command: `unicli ${site} ${cmdName}`,
+                description: "Run the command (shell channel)",
+                params: {
+                    note: {
+                        description: "For payloads with quotes/emoji/JSON, pipe stdin-JSON instead.",
+                    },
+                },
+            },
+            {
+                command: `unicli repair ${site} ${cmdName}`,
+                description: "If the command fails due to upstream drift",
+            },
+        ],
+    }, null, 2));
+    return true;
+}
+export function handleRepair(parsed, io) {
+    const startedAt = Date.now();
+    let dryRun = parsed.dryRun;
+    let max = 20;
+    let timeout = 90;
+    const positionals = [];
+    for (let i = 0; i < parsed.rest.length; i += 1) {
+        const arg = parsed.rest[i];
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "--max") {
+            max = parseInt(parsed.rest[i + 1] ?? "", 10) || 20;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--max=")) {
+            max = parseInt(arg.slice("--max=".length), 10) || 20;
+            continue;
+        }
+        if (arg === "--timeout") {
+            timeout = parseInt(parsed.rest[i + 1] ?? "", 10) || 90;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--timeout=")) {
+            timeout = parseInt(arg.slice("--timeout=".length), 10) || 90;
+            continue;
+        }
+        if (arg.startsWith("-"))
+            return false;
+        positionals.push(arg);
+    }
+    if (!dryRun)
+        return false;
+    const [site, command] = positionals;
+    if (!site)
+        return false;
+    const config = buildDefaultConfig(site, command);
+    config.maxIterations = max;
+    config.timeout = timeout * 1000;
+    emit(io, {
+        mode: "dry-run",
+        site,
+        command: command ?? null,
+        config: {
+            ...config,
+            metricPattern: config.metricPattern.source,
+        },
+    }, undefined, parsed.format, "repair.run", startedAt);
+    return true;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/fast-path/handlers/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/fast-path/handlers/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,IAAI,EAEJ,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,EAAM;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,UAA8B,CAAC;IACnC,IAAI,UAA8B,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;SACxC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC9C,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,QAAQ,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;SACrB,CAAC;IACJ,CAAC,CAAC,CACH;SACA,MAAM,CAAC,eAAe,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC;SACvD,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CACrE,CAAC;IAEJ,IAAI,CACF,EAAE,EACF,IAAI,EACJ,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAClD,MAAM,CAAC,MAAM,EACb,WAAW,EACX,SAAS,CACV,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe;IAOtB,IAAI,CAAC,4BAA4B,EAAE;QAAE,OAAO,EAAE,CAAC;IAE/C,OAAO,MAAM,CAAC,MAAM,CAClB,yBAAyB,CAAC,wBAAwB,EAAE,CAAC,CACtD,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,EAAE;KACT,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAkB,EAAE,EAAM;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAA4B,CAAC;IACjC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACzB,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxB,EAAE,CAAC,MAAM,CACP,kEAAkE,CACnE,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,EAAE,CAAC,MAAM,CAAC,0BAA0B,cAAc,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE;QAC3C,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,OAAO,QAAQ,MAAM,CAAC,IAAI,EAAE;QACzE,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC,CAAC;IAEJ,IAAI,CACF,EAAE,EACF,IAAI,EACJ,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,EAC5C,MAAM,CAAC,MAAM,EACb,aAAa,EACb,SAAS,CACV,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,EAAM;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IAEpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAClE,IAAI;YACJ,YAAY,EAAE,IAAI;YAClB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,SAAS;YACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,QAAQ;YAChD,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YACpC,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC,CAAC;QACJ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;YACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ;YACtC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,QAAQ;YACjD,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;YACjC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC,CAAC;QACJ,EAAE,CAAC,MAAM,CACP,IAAI,CAAC,SAAS,CACZ;YACE,IAAI;YACJ,YAAY,EAAE,IAAI;YAClB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,SAAS;YACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,QAAQ;YAChD,QAAQ;SACT,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,EAAE,CAAC,MAAM,CACP,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oBAAoB,IAAI,IAAI,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAC1E,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,SAAS,CAAC;IACxE,MAAM,aAAa,GAAG,6BAA6B,CAAC;QAClD,WAAW;QACX,aAAa,EAAE,OAAO,CAAC,cAAc;KACtC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,2BAA2B,CAC7C,IAAI,EACJ,OAAO,EACP,OAAO,CAAC,YAAY,CACrB,CAAC;IACF,MAAM,eAAe,GAAG,+BAA+B,CAAC;QACtD,MAAM;QACN,EAAE;QACF,IAAI;QACJ,WAAW,EAAE,OAAO;QACpB,OAAO;QACP,WAAW;QACX,aAAa;QACb,WAAW;QACX,SAAS;KACV,CAAC,CAAC;IACH,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAElC,EAAE,CAAC,MAAM,CACP,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,UAAU,IAAI,IAAI,OAAO,EAAE;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;QACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ;QACtC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,QAAQ;QACjD,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;QACjC,cAAc,EAAE,aAAa;QAC7B,YAAY,EAAE,WAAW;QACzB,gBAAgB,EAAE,eAAe;QACjC,WAAW,EAAE,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QACjD,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/C,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1D,YAAY,EAAE;YACZ;gBACE,OAAO,EAAE,UAAU,IAAI,IAAI,OAAO,YAAY;gBAC9C,WAAW,EAAE,qDAAqD;aACnE;YACD;gBACE,OAAO,EAAE,UAAU,IAAI,IAAI,OAAO,EAAE;gBACpC,WAAW,EAAE,iCAAiC;gBAC9C,MAAM,EAAE;oBACN,IAAI,EAAE;wBACJ,WAAW,EACT,+DAA+D;qBAClE;iBACF;aACF;YACD;gBACE,OAAO,EAAE,iBAAiB,IAAI,IAAI,OAAO,EAAE;gBAC3C,WAAW,EAAE,4CAA4C;aAC1D;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAkB,EAAE,EAAM;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YACnD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YACrD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YACvD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,CAAC,aAAa,GAAG,GAAG,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IAEhC,IAAI,CACF,EAAE,EACF;QACE,IAAI,EAAE,SAAS;QACf,IAAI;QACJ,OAAO,EAAE,OAAO,IAAI,IAAI;QACxB,MAAM,EAAE;YACN,GAAG,MAAM;YACT,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM;SAC3C;KACF,EACD,SAAS,EACT,MAAM,CAAC,MAAM,EACb,YAAY,EACZ,SAAS,CACV,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/fast-path/manifest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Generated manifest reader — the discovery-only fast path consumes
+ * `dist/manifest.json` instead of loading every adapter through Commander.
+ *
+ * Keep this module side-effect free: the entry decides whether absence of
+ * the manifest is fatal or simply means "no fast path; fall through to the
+ * full Commander tree".
+ */
+import type { TargetSurface } from "../types.js";
+export type ManifestArg = {
+    name: string;
+    type?: "str" | "int" | "float" | "bool";
+    default?: unknown;
+    required?: boolean;
+    positional?: boolean;
+    choices?: string[];
+    description?: string;
+    format?: string;
+    "x-unicli-kind"?: string;
+    "x-unicli-accepts"?: string[];
+};
+export type ManifestCommand = {
+    name: string;
+    description?: string;
+    strategy?: string;
+    type?: string;
+    domain?: string;
+    base?: string;
+    browser?: boolean;
+    quarantined?: boolean;
+    args?: ManifestArg[];
+    columns?: string[];
+    pipeline_steps?: number;
+    adapter_path?: string;
+    target_surface?: TargetSurface;
+};
+export type Manifest = {
+    version: string;
+    sites: Record<string, {
+        category?: string;
+        commands: ManifestCommand[];
+    }>;
+};
+export declare function manifestPath(): string;
+export declare function readManifest(): Manifest;
+export declare function isMissingManifestError(error: unknown): boolean;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/fast-path/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/fast-path/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CACX,MAAM,EACN;QACE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;KAC7B,CACF,CAAC;CACH,CAAC;AAEF,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9D"}