@lightward/mechanic-cli 0.1.0

package/dist/commands/shop/status.js

@@ -0,0 +1,138 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+function plural(value, singular, pluralized = `${singular}s`) {
+    return value === 1 ? singular : pluralized;
+}
+function formatCount(value) {
+    return typeof value === "number" ? value.toLocaleString() : "--";
+}
+function formatLag(milliseconds) {
+    if (milliseconds === null || milliseconds === undefined) {
+        return "--";
+    }
+    if (milliseconds <= 0) {
+        return "none";
+    }
+    const totalSeconds = Math.round(milliseconds / 1000);
+    if (totalSeconds < 60) {
+        return `${totalSeconds}s`;
+    }
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (totalMinutes < 60) {
+        return seconds ? `${totalMinutes}m ${seconds}s` : `${totalMinutes}m`;
+    }
+    const hours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    return minutes ? `${hours}h ${minutes}m` : `${hours}h`;
+}
+function queueSummary(status) {
+    const running = status.queue.running ?? 0;
+    const limit = status.queue.limit;
+    const waiting = status.queue.waiting ?? 0;
+    const runningText = limit === null || limit === undefined
+        ? `${formatCount(running)} running`
+        : `${formatCount(running)}/${formatCount(limit)} running`;
+    return `${runningText}, ${formatCount(waiting)} ${plural(waiting, "run")} waiting`;
+}
+export default class ShopStatus extends BaseCommand {
+    static summary = "Show current Mechanic queue and backlog for this shop.";
+    static description = "Show how many runs are running or waiting, plus the largest current backlog groups.";
+    static flags = {
+        json: Flags.boolean({
+            description: "Print shop status as JSON for agents, scripts, or editor integrations.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ShopStatus);
+        const project = await this.loadProject();
+        const client = await this.verifiedClientForProject(project);
+        const status = await client.getShopStatus();
+        const waiting = status.queue.waiting ?? 0;
+        if (flags.json) {
+            this.outputJson({
+                ...status,
+                queue_summary: queueSummary(status),
+                formatted_lag: {
+                    queue: formatLag(status.queue.oldest_waiting_ms),
+                    event_runs: formatLag(status.lag.event_run_ms),
+                    task_runs: formatLag(status.lag.task_run_ms),
+                    action_runs: formatLag(status.lag.action_run_ms),
+                },
+            });
+            return;
+        }
+        this.log(`${this.accent("Shop")} ${status.shop.shopify_domain}`);
+        this.log(`${this.accent("Queue")} ${queueSummary(status)}`);
+        this.log(`${this.accent("Queue lag")} ${formatLag(status.queue.oldest_waiting_ms)}`);
+        if (status.queue.partial) {
+            this.warn("Mechanic could not collect every queue statistic before the database timeout. Try again in a moment.");
+        }
+        this.log("");
+        this.table([
+            ["State", "Event runs", "Task runs", "Action runs"],
+            [
+                "Running",
+                formatCount(status.running.event_runs),
+                formatCount(status.running.task_runs),
+                formatCount(status.running.action_runs),
+            ],
+            [
+                "Waiting",
+                formatCount(status.backlog.event_runs),
+                formatCount(status.backlog.task_runs),
+                formatCount(status.backlog.action_runs),
+            ],
+        ]);
+        if (waiting === 0) {
+            this.log("");
+            this.log(this.success("No runs waiting."));
+            return;
+        }
+        this.log("");
+        this.log(this.accent("Lag by type"));
+        this.table([
+            ["Run type", "Lag"],
+            ["Event runs", formatLag(status.lag.event_run_ms)],
+            ["Task runs", formatLag(status.lag.task_run_ms)],
+            ["Action runs", formatLag(status.lag.action_run_ms)],
+        ]);
+        this.log("");
+        this.log(this.accent("Top waiting tasks"));
+        if (status.backlog.by_task.length === 0) {
+            this.log(this.muted("No task-run backlog."));
+        }
+        else {
+            this.table([
+                ["Task", "Waiting"],
+                ...status.backlog.by_task.map((row) => [
+                    this.taskName(row.task_name || row.task_id),
+                    formatCount(row.count),
+                ]),
+            ]);
+        }
+        if (status.backlog.by_action.length > 0) {
+            this.log("");
+            this.log(this.accent("Top waiting actions"));
+            this.table([
+                ["Action", "Task", "Waiting"],
+                ...status.backlog.by_action.map((row) => [
+                    row.action_type || "(unknown)",
+                    this.taskName(row.task_name || row.task_id),
+                    formatCount(row.count),
+                ]),
+            ]);
+        }
+        if (status.backlog.by_event_topic.length > 0) {
+            this.log("");
+            this.log(this.accent("Top waiting events"));
+            this.table([
+                ["Event topic", "Waiting"],
+                ...status.backlog.by_event_topic.map((row) => [
+                    row.event_topic || "(unknown)",
+                    formatCount(row.count),
+                ]),
+            ]);
+        }
+    }
+}

package/dist/commands/tasks/bundle.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../base-command.js";
+export default class TasksBundle extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        dir: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        out: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private resolveBundlePaths;
+}
+//# sourceMappingURL=bundle.d.ts.map

package/dist/commands/tasks/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/bundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAA+D;IACtF,OAAgB,WAAW,SAAkF;IAC7G,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAOnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAgCZ,kBAAkB;CAuCjC"}

package/dist/commands/tasks/bundle.js

@@ -0,0 +1,83 @@
+import { Args, Flags } from "@oclif/core";
+import path from "node:path";
+import { BaseCommand } from "../../base-command.js";
+import { CliError } from "../../errors.js";
+import { pathExists } from "../../fs.js";
+import { bundleTask } from "../../tasks.js";
+export default class TasksBundle extends BaseCommand {
+    static summary = "Bundle one helper task directory into one task JSON file.";
+    static description = "Bundle one editable helper task directory into one canonical task JSON file.";
+    static examples = [
+        "$ mechanic tasks bundle tasks/order-tagger",
+        "$ mechanic tasks bundle tasks/order-tagger.json",
+        "$ mechanic tasks bundle tasks/order-tagger --out tasks/order-tagger.json",
+    ];
+    static args = {
+        dir: Args.string({ required: false, description: "Helper task directory, or its matching task JSON file." }),
+    };
+    static flags = {
+        json: Flags.boolean({
+            description: "Print bundle result as JSON for agents, scripts, or editor integrations.",
+        }),
+        out: Flags.string({
+            description: "Output canonical task JSON file. Defaults to the helper directory path plus .json.",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TasksBundle);
+        if (!args.dir) {
+            throw new CliError([
+                "Choose one helper task directory to bundle.",
+                "",
+                "Example:",
+                "  mechanic tasks bundle tasks/order-tagger",
+                "",
+                "By default this writes to tasks/order-tagger.json. Use --out <file> to choose another task JSON file.",
+            ].join("\n"), 2);
+        }
+        const { dirPath, inputDisplay, outputDisplay } = await this.resolveBundlePaths(args.dir, flags.out);
+        const outputPath = path.resolve(outputDisplay);
+        await bundleTask(dirPath, outputPath);
+        if (flags.json) {
+            this.outputJson({
+                ok: true,
+                input: inputDisplay,
+                input_path: dirPath,
+                output: outputDisplay,
+                output_path: outputPath,
+            });
+            return;
+        }
+        this.log(`Bundled ${this.taskName(inputDisplay)} -> ${this.taskName(outputDisplay)}`);
+    }
+    async resolveBundlePaths(input, out) {
+        const inputPath = path.resolve(input);
+        if (await pathExists(path.join(inputPath, "task.json"))) {
+            return {
+                dirPath: inputPath,
+                inputDisplay: input,
+                outputDisplay: out || `${input}.json`,
+            };
+        }
+        if (!input.toLowerCase().endsWith(".json")) {
+            return {
+                dirPath: inputPath,
+                inputDisplay: input,
+                outputDisplay: out || `${input}.json`,
+            };
+        }
+        const helperInput = input.slice(0, -".json".length);
+        const helperPath = path.resolve(helperInput);
+        if (!(await pathExists(path.join(helperPath, "task.json")))) {
+            throw new CliError([
+                `No helper task directory found for ${this.taskName(input)}.`,
+                `Run "mechanic tasks unbundle ${this.taskName(input)}" first, then bundle again after editing.`,
+            ].join("\n"), 2);
+        }
+        return {
+            dirPath: helperPath,
+            inputDisplay: helperInput,
+            outputDisplay: out || input,
+        };
+    }
+}

package/dist/commands/tasks/diff.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from "../../base-command.js";
+export default class TasksDiff extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static args: {
+        file: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "exit-code": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    colorDiff(diff: string): string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/tasks/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAYpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,OAAO,SAA2D;IAClF,OAAgB,WAAW,SAA6G;IAExI,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;MAMnB;IAEF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA2BzB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmH3B"}

package/dist/commands/tasks/diff.js

@@ -0,0 +1,124 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { linkForSlug } from "../../config.js";
+import { diffTasks, displayTaskPath, readTaskFile, remoteChangedSinceLastPull, selectedTaskFiles, slugFromTaskFile, taskForPush, } from "../../tasks.js";
+export default class TasksDiff extends BaseCommand {
+    static summary = "Diff one task, or use --all to diff every local task.";
+    static description = "Compare one local task with its linked remote task, or use --all to compare every local task JSON file.";
+    static args = {
+        file: Args.string({ required: false, description: "Task file, helper directory, linked task ID, or unique local task slug." }),
+    };
+    static flags = {
+        all: Flags.boolean({ description: "Diff every task JSON file in this project." }),
+        "exit-code": Flags.boolean({ description: "Exit 1 when differences are found. Useful for CI." }),
+        json: Flags.boolean({
+            description: "Print diff results as JSON for agents, scripts, or editor integrations.",
+        }),
+    };
+    colorDiff(diff) {
+        return diff.split("\n").map((line) => {
+            if (line.startsWith("+") && !line.startsWith("+++")) {
+                return this.success(line);
+            }
+            if (line.startsWith("-") && !line.startsWith("---")) {
+                return this.color("red", line);
+            }
+            if (line.startsWith("#")) {
+                return this.accent(line);
+            }
+            if (line.startsWith("@@")
+                || line.startsWith("---")
+                || line.startsWith("+++")
+                || line.startsWith("Changed fields:")) {
+                return this.muted(line);
+            }
+            return line;
+        }).join("\n");
+    }
+    async run() {
+        const { args, flags } = await this.parse(TasksDiff);
+        const project = await this.loadProject();
+        const client = await this.verifiedClientForProject(project);
+        const files = await selectedTaskFiles(project, args.file, Boolean(flags.all));
+        const differences = [];
+        const results = [];
+        let hasFieldDifferences = false;
+        let hasRemoteChanges = false;
+        for (const file of files) {
+            const slug = slugFromTaskFile(file);
+            const link = linkForSlug(project, slug);
+            const relativeFile = displayTaskPath(project, file);
+            if (!link) {
+                results.push({
+                    file: relativeFile,
+                    slug,
+                    linked: false,
+                    remote_id: null,
+                    remote_changed: false,
+                    field_differences: false,
+                    diff: null,
+                    message: "Task is not linked to a remote task.",
+                });
+                differences.push(`# ${relativeFile}\nTask is not linked to a remote task.`);
+                continue;
+            }
+            const localTask = taskForPush(await readTaskFile(file));
+            const remote = await client.getTask(link.remote_id);
+            const remoteTask = taskForPush(remote.task);
+            const diff = diffTasks(localTask, remoteTask);
+            const remoteChanged = remoteChangedSinceLastPull(link, remote);
+            const hasDiff = Boolean(diff);
+            if (remoteChanged) {
+                hasRemoteChanges = true;
+            }
+            if (hasDiff) {
+                hasFieldDifferences = true;
+            }
+            results.push({
+                file: relativeFile,
+                slug,
+                linked: true,
+                remote_id: link.remote_id,
+                remote_changed: remoteChanged,
+                field_differences: hasDiff,
+                diff,
+            });
+            if (remoteChanged || diff) {
+                const section = [`# ${relativeFile}`];
+                if (remoteChanged) {
+                    section.push(this.color("yellow", "Remote changed since your last pull."), this.muted("Showing the current Mechanic task compared with your local file."), this.muted(`Run "mechanic tasks pull ${link.remote_id}" before publishing, or use --force only if the local file should win.`), "");
+                }
+                if (diff) {
+                    section.push(diff);
+                }
+                else {
+                    section.push("No field differences between the current remote task and your local file.");
+                }
+                differences.push(this.colorDiff(section.join("\n")));
+            }
+        }
+        if (flags.json) {
+            const differencesFound = results.some((result) => result.remote_changed || result.field_differences || !result.linked);
+            this.outputJson({
+                shop_domain: project.shopDomain,
+                differences_found: differencesFound,
+                field_differences_found: hasFieldDifferences,
+                remote_changes_found: hasRemoteChanges,
+                tasks: results,
+            });
+            if (flags["exit-code"] && differencesFound) {
+                process.exitCode = 1;
+            }
+            return;
+        }
+        if (differences.length === 0) {
+            this.log("No differences.");
+            return;
+        }
+        this.log(differences.join("\n\n"));
+        this.log(hasFieldDifferences ? "Differences found." : "Remote changes found.");
+        if (flags["exit-code"]) {
+            process.exitCode = 1;
+        }
+    }
+}

package/dist/commands/tasks/list.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from "../../base-command.js";
+export default class TasksList extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/tasks/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,OAAO,SAAkD;IACzE,OAAgB,WAAW,SAAsF;IAEjH,OAAgB,KAAK;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgD3B"}

package/dist/commands/tasks/list.js

@@ -0,0 +1,57 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { slugForRemoteId } from "../../config.js";
+export default class TasksList extends BaseCommand {
+    static summary = "List remote tasks without changing anything.";
+    static description = "List remote Mechanic tasks without pulling, publishing, or changing local files.";
+    static flags = {
+        json: Flags.boolean({
+            description: "Print task list as JSON for agents, scripts, or editor integrations.",
+        }),
+        verbose: Flags.boolean({
+            char: "v",
+            description: "Show sync hashes.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TasksList);
+        const project = await this.loadProject();
+        const client = await this.verifiedClientForProject(project);
+        const response = await client.listTasks();
+        if (flags.json) {
+            this.outputJson({
+                shop_domain: project.shopDomain,
+                tasks: (response.tasks || []).map((envelope) => {
+                    const slug = slugForRemoteId(project, envelope.id);
+                    const link = slug ? project.links.tasks[slug] : null;
+                    return {
+                        id: envelope.id,
+                        name: typeof envelope.task?.name === "string" ? envelope.task.name : "",
+                        updated_at: envelope.updated_at || null,
+                        content_hash: envelope.content_hash || null,
+                        linked: Boolean(link),
+                        slug: slug || null,
+                        file: link ? link.file || `${project.tasksDirName}/${slug}.json` : null,
+                    };
+                }),
+            });
+            return;
+        }
+        const rows = flags.verbose ? [["Name", "File", "Updated", "ID", "Hash"]] : [["Name", "File", "Updated", "ID"]];
+        for (const envelope of response.tasks || []) {
+            const slug = slugForRemoteId(project, envelope.id);
+            const link = slug ? project.links.tasks[slug] : null;
+            const row = [
+                this.taskName(String(envelope.task?.name || "")),
+                link ? this.taskName(link.file || `${project.tasksDirName}/${slug}.json`) : this.muted("--"),
+                this.muted(envelope.updated_at || ""),
+                this.taskId(project, envelope.id),
+            ];
+            if (flags.verbose) {
+                row.push(this.muted(envelope.content_hash || ""));
+            }
+            rows.push(row);
+        }
+        this.table(rows);
+    }
+}

package/dist/commands/tasks/open.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from "../../base-command.js";
+import type { Project } from "../../types.js";
+export default class TasksOpen extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    taskIdForTarget(project: Project, target: string): Promise<string>;
+    openUrl(url: string): Promise<void>;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=open.d.ts.map

package/dist/commands/tasks/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/open.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAc9C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,OAAO,SAAqC;IAC5D,OAAgB,WAAW,SAAuH;IAElJ,OAAgB,IAAI;;MAElB;IAEI,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBlE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB3B"}

package/dist/commands/tasks/open.js

@@ -0,0 +1,64 @@
+import { spawn } from "node:child_process";
+import { Args } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { taskAdminUrl } from "../../config.js";
+import { CliError } from "../../errors.js";
+import { displayTaskPath, resolveTaskSelector } from "../../tasks.js";
+function openerCommand(url) {
+    if (process.platform === "darwin") {
+        return { command: "open", args: [url] };
+    }
+    if (process.platform === "win32") {
+        return { command: "rundll32", args: ["url.dll,FileProtocolHandler", url] };
+    }
+    return { command: "xdg-open", args: [url] };
+}
+export default class TasksOpen extends BaseCommand {
+    static summary = "Open a remote task in Mechanic.";
+    static description = "Open a remote Mechanic task by task ID, linked local task JSON file, helper directory, or unique local task slug.";
+    static args = {
+        target: Args.string({ required: true, description: "Remote task ID, linked local task JSON file, helper directory, or unique local task slug." }),
+    };
+    async taskIdForTarget(project, target) {
+        const selector = await resolveTaskSelector(project, target, {
+            allowHelperDir: true,
+            allowRemoteId: true,
+        });
+        if (selector.remoteId) {
+            return selector.remoteId;
+        }
+        if (selector.file || selector.helperDir) {
+            throw new CliError(`${displayTaskPath(project, selector.helperDir || selector.file || target)} is not linked to a remote task. Pull or publish it first.`, 2);
+        }
+        throw new CliError(`No remote task ID found for ${target}.`, 2);
+    }
+    async openUrl(url) {
+        const opener = openerCommand(url);
+        await new Promise((resolve, reject) => {
+            const child = spawn(opener.command, opener.args, {
+                detached: true,
+                stdio: "ignore",
+            });
+            child.once("error", reject);
+            child.once("spawn", () => {
+                child.unref();
+                resolve();
+            });
+        });
+    }
+    async run() {
+        const { args } = await this.parse(TasksOpen);
+        const project = await this.loadProject();
+        const taskId = await this.taskIdForTarget(project, args.target);
+        const url = taskAdminUrl(project, taskId);
+        try {
+            await this.openUrl(url);
+            this.log(`Opened ${this.taskId(project, taskId)}`);
+        }
+        catch {
+            this.warn("Could not open a browser automatically.");
+            this.log(`Open ${this.taskId(project, taskId)} manually:`);
+        }
+        this.log(this.muted(url));
+    }
+}

package/dist/commands/tasks/preview.d.ts

@@ -0,0 +1,45 @@
+import { BaseCommand } from "../../base-command.js";
+import type { MechanicClient } from "../../client.js";
+import type { JsonObject, Project, TaskPreviewResponse } from "../../types.js";
+type PreparedPreview = {
+    label: string;
+    slug?: string;
+    task?: JsonObject;
+    remoteId?: string;
+};
+type PreviewRenderOptions = {
+    verbose: boolean;
+};
+export default class TasksPreview extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        remote: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    exitForStatus(response: TaskPreviewResponse): void;
+    preparePreview(project: Project, target: string, remote: boolean): Promise<PreparedPreview>;
+    requestPreview(client: MechanicClient, prepared: PreparedPreview, remote: boolean): Promise<TaskPreviewResponse>;
+    renderPreview(project: Project, prepared: PreparedPreview, response: TaskPreviewResponse, options: PreviewRenderOptions): void;
+    renderVerboseDetails(response: TaskPreviewResponse): void;
+    renderRunDetails(response: TaskPreviewResponse): void;
+    renderPreviewValue(label: string, value: unknown, indent: number): void;
+    formatPreviewValue(value: unknown): string | null;
+    runStatusLabel(ok: boolean | null): string;
+    renderPermissions(response: TaskPreviewResponse): void;
+    renderValidationErrors(response: TaskPreviewResponse): void;
+    previewTitle(prepared: PreparedPreview, response: TaskPreviewResponse): string;
+    sourceSummary(project: Project, prepared: PreparedPreview, response: TaskPreviewResponse): string;
+    uniqueScopes(scopes: string[]): string[];
+    validateLocalTask(task: JsonObject, label: string): void;
+    blockStaleHelperDir(project: Project, filePath: string, relativeFile: string, task: JsonObject): Promise<void>;
+    approvalHint(action: string): string;
+    statusLabel(status: TaskPreviewResponse["status"]): string;
+}
+export {};
+//# sourceMappingURL=preview.d.ts.map

package/dist/commands/tasks/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/preview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAYpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAWF,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,OAAgB,OAAO,SAAmD;IAC1E,OAAgB,WAAW,SAId;IAEb,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB1B,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAS5C,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IA0D3F,cAAc,CAClB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,mBAAmB,CAAC;IA4B/B,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,IAAI;IA+BP,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAuDzD,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IA+BrD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBvE,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAgBjD,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM;IAY1C,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IA4BtD,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAmB3D,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM;IAI9E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM;IA+BjG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAIxC,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWlD,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAapC,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,MAAM;CAU3D"}