@zenalexa/unicli 0.217.0 → 0.218.0

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":"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"}

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"}

package/dist/fast-path/manifest.js

@@ -0,0 +1,32 @@
+/**
+ * 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 { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export function manifestPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, "manifest.json"),
+        join(here, "..", "dist", "manifest.json"),
+        join(here, "..", "..", "dist", "manifest.json"),
+    ];
+    const found = candidates.find((candidate) => existsSync(candidate));
+    if (!found) {
+        throw new Error("Missing dist/manifest.json. Run: npm run build:manifest");
+    }
+    return found;
+}
+export function readManifest() {
+    return JSON.parse(readFileSync(manifestPath(), "utf8"));
+}
+export function isMissingManifestError(error) {
+    return (error instanceof Error &&
+        error.message.includes("Missing dist/manifest.json"));
+}
+//# sourceMappingURL=manifest.js.map

package/dist/fast-path/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/fast-path/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA2CzC,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;KAChD,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,CAAa,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CACrD,CAAC;AACJ,CAAC"}

package/dist/fast-path/parsed-argv.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The parsed-argv shape consumed by every fast-path handler. Lives in its
+ * own file so handlers do not have to take a circular import on the entry.
+ */
+import type { OutputFormat } from "../types.js";
+export type ParsedArgv = {
+    command?: string;
+    rest: string[];
+    format?: OutputFormat;
+    dryRun: boolean;
+    permissionProfile?: string;
+    yes: boolean;
+    rememberApproval: boolean;
+    record: boolean;
+};
+//# sourceMappingURL=parsed-argv.d.ts.map

package/dist/fast-path/parsed-argv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-argv.d.ts","sourceRoot":"","sources":["../../src/fast-path/parsed-argv.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/fast-path/parsed-argv.js

@@ -0,0 +1,6 @@
+/**
+ * The parsed-argv shape consumed by every fast-path handler. Lives in its
+ * own file so handlers do not have to take a circular import on the entry.
+ */
+export {};
+//# sourceMappingURL=parsed-argv.js.map

package/dist/fast-path/parsed-argv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-argv.js","sourceRoot":"","sources":["../../src/fast-path/parsed-argv.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,25 @@
+/**
+ * Operation-policy gate evaluation for the fast path.
+ *
+ * Wraps `engine/operation-policy.ts` with the manifest-driven inputs needed
+ * by `describe`, `--dry-run`, and pre-execution policy gates. On configuration
+ * errors, prints a structured envelope and exits with USAGE_ERROR.
+ */
+import { type OperationPolicy } from "../engine/operation-policy.js";
+import { type TargetSurface } from "../types.js";
+import type { ManifestCommand } from "./manifest.js";
+import type { ParsedArgv } from "./parsed-argv.js";
+import { type Io } from "./render.js";
+export declare function hasStoredApproval(key: string): boolean;
+export declare function evaluateManifestOperationPolicy(input: {
+    parsed: ParsedArgv;
+    io: Io;
+    site: string;
+    commandName: string;
+    command: ManifestCommand;
+    adapterType: string;
+    targetSurface: TargetSurface;
+    adapterPath: string;
+    startedAt: number;
+}): OperationPolicy | null;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/fast-path/policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,EAAqB,MAAM,aAAa,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsBtD;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,MAAM,EAAE,UAAU,CAAC;IACnB,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,eAAe,GAAG,IAAI,CAmEzB"}

package/dist/fast-path/policy.js

@@ -0,0 +1,96 @@
+/**
+ * Operation-policy gate evaluation for the fast path.
+ *
+ * Wraps `engine/operation-policy.ts` with the manifest-driven inputs needed
+ * by `describe`, `--dry-run`, and pre-execution policy gates. On configuration
+ * errors, prints a structured envelope and exits with USAGE_ERROR.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { createApprovalStore, isStoredApproval, } from "../engine/approval-store.js";
+import { evaluateOperationPolicy, InvalidPermissionProfileError, } from "../engine/operation-policy.js";
+import { applyDenyRuleToPolicy, findDenyRuleForPolicySync, PermissionRulesConfigError, } from "../engine/permission-rules.js";
+import { defaultErrorNextActions } from "../output/next-actions.js";
+import { format, detectFormat } from "../output/formatter.js";
+import { ExitCode } from "../types.js";
+import { emitStderrAndExit } from "./render.js";
+export function hasStoredApproval(key) {
+    const store = createApprovalStore();
+    if (!existsSync(store.path))
+        return false;
+    try {
+        const raw = readFileSync(store.path, "utf-8");
+        const lines = raw.split(/\r?\n/);
+        for (let i = lines.length - 1; i >= 0; i -= 1) {
+            const line = lines[i];
+            if (line.trim().length === 0)
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                if (isStoredApproval(entry) && entry.key === key) {
+                    return entry.decision === "allow";
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+export function evaluateManifestOperationPolicy(input) {
+    try {
+        const policyInput = {
+            site: input.site,
+            command: input.commandName,
+            description: input.command.description,
+            adapterType: input.adapterType,
+            targetSurface: input.targetSurface,
+            strategy: input.command.strategy,
+            domain: input.command.domain,
+            base: input.command.base,
+            browser: input.command.browser === true,
+            args: input.command.args,
+            profile: input.parsed.permissionProfile,
+            approved: input.parsed.yes,
+        };
+        const policy = evaluateOperationPolicy(policyInput);
+        const denyRule = findDenyRuleForPolicySync(policy);
+        if (denyRule)
+            return applyDenyRuleToPolicy(policy, denyRule);
+        if (policy.enforcement === "needs_approval" &&
+            hasStoredApproval(policy.approval_memory.key)) {
+            return evaluateOperationPolicy({
+                ...policyInput,
+                approvalSource: "memory",
+            });
+        }
+        return policy;
+    }
+    catch (error) {
+        if (!(error instanceof InvalidPermissionProfileError ||
+            error instanceof PermissionRulesConfigError)) {
+            throw error;
+        }
+        emitStderrAndExit(input.io, format([], input.command.columns, detectFormat(input.parsed.format), {
+            command: `${input.site}.${input.commandName}`,
+            duration_ms: Date.now() - input.startedAt,
+            surface: input.targetSurface,
+            error: {
+                code: "invalid_input",
+                message: error.message,
+                adapter_path: input.adapterPath,
+                step: 0,
+                suggestion: error instanceof PermissionRulesConfigError
+                    ? error.suggestion
+                    : "use one of: open, confirm, locked",
+                retryable: false,
+            },
+            next_actions: defaultErrorNextActions(input.site, input.commandName, "invalid_input"),
+        }), ExitCode.USAGE_ERROR);
+        return null;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/fast-path/policy.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * Argv tokenisation, schema generation, and envelope rendering helpers
+ * shared by every fast-path handler.
+ *
+ * Pure utilities only — no manifest or policy IO. Handlers compose these
+ * with `manifest.ts` and `policy.ts`.
+ */
+import { type OutputFormat } from "../types.js";
+import type { ManifestArg } from "./manifest.js";
+export type Io = {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+};
+export declare const DEFAULT_IO: Io;
+export declare function emitStderrAndExit(io: Io, text: string, code: number): void;
+export declare function isOutputFormat(value: string): value is OutputFormat;
+export declare function isHelpToken(value: string): boolean;
+export declare function jsonSchemaType(type: ManifestArg["type"]): string;
+export declare function argsToJsonSchema(args: ManifestArg[]): Record<string, unknown>;
+export declare function buildExample(args: ManifestArg[]): Record<string, unknown>;
+export declare function buildChannels(site: string, command: string, args: ManifestArg[]): Record<string, string>;
+export declare function summarizeArgs(args?: ManifestArg[]): Array<Record<string, unknown>>;
+export declare function coerceArgValue(value: unknown, type: ManifestArg["type"]): unknown;
+export declare function resolveDryRunArgs(schema: ManifestArg[] | undefined, tokens: string[]): Record<string, unknown> | null;
+export declare function emit(io: Io, data: unknown[] | Record<string, unknown>, columns: string[] | undefined, fmt: OutputFormat | undefined, command: string, startedAt: number): void;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/fast-path/render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,EAAE,GAAG;IACf,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,EAGxB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CASnE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAWhE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B7E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB;AAED,wBAAgB,aAAa,CAC3B,IAAI,GAAE,WAAW,EAAO,GACvB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOhC;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,OAAO,CAeT;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EAAE,YAAK,EAC1B,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgDhC;AAED,wBAAgB,IAAI,CAClB,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAQN"}