@lightward/mechanic-cli 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import type { JsonObject, ShopStatusResponse, TaskEnvelope, TaskListResponse, TaskPreviewResponse } from "./types.js";
+export declare const USER_AGENT: string;
+type RequestOptions = {
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+    retry?: boolean;
+};
+export type AuthVerification = {
+    shop: {
+        shopify_domain: string;
+    };
+    api_token?: {
+        name?: string | null;
+        created_by?: string | null;
+    };
+};
+export declare class MechanicClient {
+    readonly baseUrl: string;
+    readonly token: string;
+    constructor({ baseUrl, token }: {
+        baseUrl: string;
+        token: string;
+    });
+    request<T>(pathname: string, options?: RequestOptions): Promise<T>;
+    verifyAuth(): Promise<AuthVerification>;
+    getShopStatus(): Promise<ShopStatusResponse>;
+    listTasks(): Promise<TaskListResponse>;
+    getTask(id: string): Promise<TaskEnvelope>;
+    previewTask(task: JsonObject, id?: string): Promise<TaskPreviewResponse>;
+    previewRemoteTask(id: string): Promise<TaskPreviewResponse>;
+    createTask(task: JsonObject, idempotencyKey?: string): Promise<TaskEnvelope>;
+    updateTask(id: string, body: {
+        task: JsonObject;
+        previous_content_hash?: string;
+        force?: boolean;
+    }): Promise<TaskEnvelope>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKtH,eAAO,MAAM,UAAU,QAAkD,CAAC;AAE1E,KAAK,cAAc,GAAG;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE;QACJ,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;CACH,CAAC;AAwGF,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAK5D,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IA+C5E,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAIvC,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI5C,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAItC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1C,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IASxE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAM3D,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ5E,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAM3H"}

package/dist/client.js

@@ -0,0 +1,172 @@
+import { createRequire } from "node:module";
+import { CliError, HttpError } from "./errors.js";
+import { stableStringify } from "./json.js";
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json");
+export const USER_AGENT = `MechanicCLI/${packageJson.version || "0.0.0"}`;
+function sleep(milliseconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliseconds);
+    });
+}
+function parseBody(text) {
+    if (!text) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { raw: text };
+    }
+}
+function retryDelayMilliseconds(response, attempt) {
+    const retryAfter = response.headers.get("retry-after");
+    if (retryAfter) {
+        const parsedSeconds = Number.parseFloat(retryAfter);
+        if (Number.isFinite(parsedSeconds) && parsedSeconds >= 0) {
+            return parsedSeconds * 1000;
+        }
+        const parsedDate = Date.parse(retryAfter);
+        if (Number.isFinite(parsedDate)) {
+            return Math.max(parsedDate - Date.now(), 0);
+        }
+    }
+    return 250 * (2 ** (attempt - 1));
+}
+function retryAfterMessage(response) {
+    const retryAfter = response.headers.get("retry-after");
+    if (!retryAfter) {
+        return null;
+    }
+    const seconds = Number.parseFloat(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return `Try again in ${Math.ceil(seconds)} seconds.`;
+    }
+    const date = Date.parse(retryAfter);
+    if (Number.isFinite(date)) {
+        return `Try again after ${new Date(date).toISOString()}.`;
+    }
+    return null;
+}
+function networkErrorMessage(error) {
+    const cause = error && typeof error === "object" && "cause" in error
+        ? error.cause
+        : undefined;
+    if (cause instanceof Error && cause.message) {
+        return cause.message;
+    }
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return String(error);
+}
+function apiErrorMessage(response, parsed) {
+    const body = parsed;
+    const serverMessage = body?.error?.message || body?.message;
+    switch (response.status) {
+        case 401:
+            return [
+                "Mechanic API rejected the API token.",
+                "Set MECHANIC_API_TOKEN or run \"mechanic auth login\" with a valid API token for this shop.",
+            ].join("\n");
+        case 403:
+            return [
+                "Mechanic API denied this request.",
+                "Check that the API token belongs to an installed, active Mechanic shop with access to this API.",
+            ].join("\n");
+        case 429:
+            return [
+                "Mechanic API rate limit exceeded.",
+                retryAfterMessage(response),
+                serverMessage,
+            ].filter(Boolean).join("\n");
+        default:
+            return serverMessage || `HTTP ${response.status}`;
+    }
+}
+export class MechanicClient {
+    baseUrl;
+    token;
+    constructor({ baseUrl, token }) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+    }
+    async request(pathname, options = {}) {
+        const method = options.method || "GET";
+        const retry = options.retry ?? method === "GET";
+        const maxAttempts = retry ? 4 : 1;
+        for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+            const url = new URL(pathname, this.baseUrl);
+            let response;
+            try {
+                response = await fetch(url, {
+                    method,
+                    headers: {
+                        Accept: "application/json",
+                        Authorization: `Bearer ${this.token}`,
+                        "User-Agent": USER_AGENT,
+                        ...(options.body === undefined ? {} : { "Content-Type": "application/json" }),
+                        ...(options.headers || {}),
+                    },
+                    body: options.body === undefined ? undefined : stableStringify(options.body),
+                });
+            }
+            catch (error) {
+                throw new CliError([
+                    `Could not reach Mechanic API at ${url.origin}.`,
+                    "Check that mechanic.json api_base_url points at the API you want to use.",
+                    "For dev, re-run mechanic init with --api-base-url <your public API host> --force, or set MECHANIC_API_BASE_URL.",
+                    `Network error: ${networkErrorMessage(error)}`,
+                ].join("\n"));
+            }
+            const parsed = parseBody(await response.text());
+            if (response.ok) {
+                return parsed;
+            }
+            if (retry && [429, 503].includes(response.status) && attempt < maxAttempts) {
+                await sleep(retryDelayMilliseconds(response, attempt));
+                continue;
+            }
+            throw new HttpError(apiErrorMessage(response, parsed), response.status, parsed);
+        }
+        throw new HttpError("Request failed", 0, null);
+    }
+    verifyAuth() {
+        return this.request("/v1/auth/verify");
+    }
+    getShopStatus() {
+        return this.request("/v1/shop/status");
+    }
+    listTasks() {
+        return this.request("/v1/tasks");
+    }
+    getTask(id) {
+        return this.request(`/v1/tasks/${encodeURIComponent(id)}`);
+    }
+    previewTask(task, id) {
+        const pathname = id ? `/v1/tasks/${encodeURIComponent(id)}/preview` : "/v1/tasks/preview";
+        return this.request(pathname, {
+            method: "POST",
+            body: { task },
+        });
+    }
+    previewRemoteTask(id) {
+        return this.request(`/v1/tasks/${encodeURIComponent(id)}/preview`, {
+            method: "POST",
+        });
+    }
+    createTask(task, idempotencyKey) {
+        return this.request("/v1/tasks", {
+            method: "POST",
+            headers: idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined,
+            body: { task },
+        });
+    }
+    updateTask(id, body) {
+        return this.request(`/v1/tasks/${encodeURIComponent(id)}`, {
+            method: "PUT",
+            body,
+        });
+    }
+}

package/dist/commands/auth/login.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from "../../base-command.js";
+export default class AuthLogin extends BaseCommand {
+    static description: string;
+    static flags: {
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    promptForToken(): Promise<string>;
+}
+//# sourceMappingURL=login.d.ts.map

package/dist/commands/auth/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/login.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,WAAW,SAA4C;IAEvE,OAAgB,KAAK;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBpB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CASxC"}

package/dist/commands/auth/login.js

@@ -0,0 +1,36 @@
+import { Flags } from "@oclif/core";
+import { promptForToken, saveToken } from "../../auth.js";
+import { BaseCommand } from "../../base-command.js";
+import { MechanicClient } from "../../client.js";
+import { CliError } from "../../errors.js";
+export default class AuthLogin extends BaseCommand {
+    static description = "Store and verify a Mechanic API token.";
+    static flags = {
+        token: Flags.string({
+            description: "Mechanic API token for controlled automation. Prefer MECHANIC_API_TOKEN or the masked prompt.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AuthLogin);
+        const token = flags.token || process.env.MECHANIC_API_TOKEN || (await this.promptForToken());
+        const project = await this.loadProject();
+        const client = new MechanicClient({ baseUrl: project.apiBaseUrl, token });
+        const verification = await client.verifyAuth();
+        const verifiedDomain = verification.shop?.shopify_domain;
+        if (!verifiedDomain) {
+            throw new CliError("Token verification did not return a shop domain.");
+        }
+        if (verifiedDomain !== project.shopDomain) {
+            throw new CliError(`Token belongs to ${verifiedDomain}, but this project is configured for ${project.shopDomain}.`);
+        }
+        await saveToken(project.shopDomain, token);
+        this.log(`${this.success("Stored")} API token for ${this.accent(project.shopDomain)}`);
+    }
+    async promptForToken() {
+        const token = await promptForToken();
+        if (!token) {
+            throw new CliError("API token cannot be blank.");
+        }
+        return token;
+    }
+}

package/dist/commands/auth/logout.d.ts

@@ -0,0 +1,6 @@
+import { BaseCommand } from "../../base-command.js";
+export default class AuthLogout extends BaseCommand {
+    static description: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=logout.d.ts.map

package/dist/commands/auth/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/logout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,WAAW,SAA4D;IAEjF,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAK3B"}

package/dist/commands/auth/logout.js

@@ -0,0 +1,10 @@
+import { deleteToken } from "../../auth.js";
+import { BaseCommand } from "../../base-command.js";
+export default class AuthLogout extends BaseCommand {
+    static description = "Remove the stored Mechanic API token for this project.";
+    async run() {
+        const project = await this.loadProject();
+        await deleteToken(project.shopDomain);
+        this.log(`${this.color("yellow", "Removed")} API token for ${this.accent(project.shopDomain)}`);
+    }
+}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand } from "../base-command.js";
+export default class Doctor extends BaseCommand {
+    static description: string;
+    run(): Promise<void>;
+    statusLabel(status: "ok" | "warn" | "fail"): string;
+}
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiBjD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,OAAgB,WAAW,SAA2E;IAEhG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAkH1B,WAAW,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;CAUpD"}

package/dist/commands/doctor.js

@@ -0,0 +1,106 @@
+import fs from "node:fs/promises";
+import { requireToken } from "../auth.js";
+import { BaseCommand } from "../base-command.js";
+import { MechanicClient } from "../client.js";
+import { CliError } from "../errors.js";
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function isDirectory(pathname) {
+    try {
+        return (await fs.stat(pathname)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export default class Doctor extends BaseCommand {
+    static description = "Check local Mechanic CLI project configuration, auth, and API access.";
+    async run() {
+        const rows = [["Check", "Status", "Details"]];
+        let failed = false;
+        let project = null;
+        const addRow = (check, status, details = "") => {
+            if (status === "fail")
+                failed = true;
+            rows.push([
+                check,
+                this.statusLabel(status),
+                details,
+            ]);
+        };
+        try {
+            project = await this.loadProject();
+            addRow("Project", "ok", `${project.shopDomain} via ${project.apiBaseUrl}`);
+        }
+        catch (error) {
+            addRow("Project", "fail", errorMessage(error));
+            this.table(rows);
+            throw new CliError("Doctor found failed checks.", 2);
+        }
+        addRow("Tasks directory", await isDirectory(project.tasksDir) ? "ok" : "fail", project.tasksDirName);
+        const linkCount = Object.keys(project.links.tasks).length;
+        addRow("Task links", linkCount > 0 ? "ok" : "warn", linkCount === 1 ? "1 linked task" : `${linkCount} linked tasks`);
+        let token = null;
+        try {
+            token = await requireToken(project.shopDomain);
+            addRow("API token", "ok", process.env.MECHANIC_API_TOKEN?.trim() ? "MECHANIC_API_TOKEN" : "stored token");
+        }
+        catch (error) {
+            addRow("API token", "fail", errorMessage(error));
+        }
+        let verifiedShopMatches = false;
+        if (token) {
+            const client = new MechanicClient({
+                baseUrl: project.apiBaseUrl,
+                token,
+            });
+            try {
+                const verification = await client.verifyAuth();
+                const verifiedDomain = verification.shop?.shopify_domain;
+                verifiedShopMatches = verifiedDomain === project.shopDomain;
+                addRow("Token shop", verifiedShopMatches ? "ok" : "fail", verifiedDomain
+                    ? `${verifiedDomain}${verifiedShopMatches ? "" : ` does not match ${project.shopDomain}`}`
+                    : "API did not return a shop domain");
+                const tokenDetails = [
+                    verification.api_token?.name,
+                    verification.api_token?.created_by ? `created by ${verification.api_token.created_by}` : null,
+                ].filter(Boolean).join(", ");
+                if (tokenDetails) {
+                    addRow("Token identity", "ok", tokenDetails);
+                }
+            }
+            catch (error) {
+                addRow("Token shop", "fail", errorMessage(error));
+            }
+        }
+        if (token && verifiedShopMatches) {
+            const client = new MechanicClient({
+                baseUrl: project.apiBaseUrl,
+                token,
+            });
+            try {
+                const response = await client.listTasks();
+                const taskCount = response.tasks.length;
+                addRow("Task API", "ok", taskCount === 1 ? "1 remote task" : `${taskCount} remote tasks`);
+            }
+            catch (error) {
+                addRow("Task API", "fail", errorMessage(error));
+            }
+        }
+        this.table(rows);
+        if (failed) {
+            throw new CliError("Doctor found failed checks.", 2);
+        }
+    }
+    statusLabel(status) {
+        switch (status) {
+            case "ok":
+                return this.success("ok");
+            case "warn":
+                return this.color("yellow", "warn");
+            case "fail":
+                return this.color("red", "fail");
+        }
+    }
+}

package/dist/commands/github/init.d.ts

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

package/dist/commands/github/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/github/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,OAAO,SAA4E;IACnG,OAAgB,WAAW,SAAiH;IAE5I,OAAgB,KAAK;;MAEnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2C3B"}

package/dist/commands/github/init.js

@@ -0,0 +1,50 @@
+import path from "node:path";
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { CliError } from "../../errors.js";
+import { ensureDir, pathExists, writeText } from "../../fs.js";
+import { githubWorkflowFiles } from "../../github-workflows.js";
+export default class GithubInit extends BaseCommand {
+    static summary = "Create GitHub Actions workflows for single-shop Mechanic task updates.";
+    static description = "Create validation, manual deploy, and pull-from-app GitHub Actions workflows for this Mechanic CLI project.";
+    static flags = {
+        force: Flags.boolean({ description: "Overwrite existing Mechanic GitHub workflow files." }),
+    };
+    async run() {
+        const { flags } = await this.parse(GithubInit);
+        const project = await this.loadProject();
+        const workflowFiles = githubWorkflowFiles();
+        const existingFiles = [];
+        for (const workflowFile of workflowFiles) {
+            const filePath = path.join(project.cwd, workflowFile.path);
+            if (await pathExists(filePath)) {
+                existingFiles.push(workflowFile.path);
+            }
+        }
+        if (existingFiles.length > 0 && !flags.force) {
+            throw new CliError([
+                "Mechanic GitHub workflow files already exist:",
+                ...existingFiles.map((filePath) => `- ${filePath}`),
+                "",
+                "Re-run with --force to overwrite them.",
+            ].join("\n"), 2);
+        }
+        const rows = [["Workflow", "Path"]];
+        for (const workflowFile of workflowFiles) {
+            const filePath = path.join(project.cwd, workflowFile.path);
+            await ensureDir(path.dirname(filePath));
+            await writeText(filePath, workflowFile.contents);
+            rows.push([
+                this.success(flags.force && existingFiles.includes(workflowFile.path) ? "overwritten" : "created"),
+                this.taskName(workflowFile.path),
+            ]);
+        }
+        this.table(rows);
+        this.log("");
+        this.log("Next steps:");
+        this.log(`  ${this.accent("gh secret set MECHANIC_API_TOKEN")}`);
+        this.log("  Paste a Mechanic API token for the shop in mechanic.json when prompted.");
+        this.log("  Commit mechanic.json, .mechanic/links.json, tasks/, .prettierignore, and .github/workflows/.");
+        this.log("  The pull-from-app workflow is manual by default; add a schedule later if you want automatic sync PRs.");
+    }
+}

package/dist/commands/help.d.ts

@@ -0,0 +1,7 @@
+import { BaseCommand } from "../base-command.js";
+export default class HelpCommand extends BaseCommand {
+    static description: string;
+    static strict: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,WAAW,SAAsC;IACjE,OAAgB,MAAM,UAAS;IAEzB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAI3B"}

package/dist/commands/help.js

@@ -0,0 +1,10 @@
+import { Help } from "@oclif/core";
+import { BaseCommand } from "../base-command.js";
+export default class HelpCommand extends BaseCommand {
+    static description = "Show help for Mechanic commands.";
+    static strict = false;
+    async run() {
+        await new Help(this.config).showHelp(this.argv);
+        this.log(this.lightwardAiLine());
+    }
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from "../base-command.js";
+export default class Init extends BaseCommand {
+    static description: string;
+    static flags: {
+        shop: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "api-base-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "app-url": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AASjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,KAAK;;;;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6D3B"}

package/dist/commands/init.js

@@ -0,0 +1,72 @@
+import { Flags } from "@oclif/core";
+import { canPromptForToken, promptForToken, saveToken } from "../auth.js";
+import { BaseCommand } from "../base-command.js";
+import { MechanicClient } from "../client.js";
+import { DEFAULT_API_BASE_URL, ensureMechanicPrettierIgnore, initProject, normalizeApiBaseUrl } from "../config.js";
+import { CliError } from "../errors.js";
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export default class Init extends BaseCommand {
+    static description = "Initialize a Mechanic CLI task sync project.";
+    static flags = {
+        shop: Flags.string({ required: true, description: "Shopify shop domain for this project." }),
+        "api-base-url": Flags.string({ description: "Mechanic API base URL.", default: DEFAULT_API_BASE_URL }),
+        "app-url": Flags.string({ description: "Mechanic embedded app root URL for clickable task links." }),
+        force: Flags.boolean({ description: "Overwrite existing mechanic.json while preserving task links." }),
+        token: Flags.string({
+            description: "Mechanic API token for controlled automation. Prefer MECHANIC_API_TOKEN or the masked prompt.",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Init);
+        const token = flags.token || process.env.MECHANIC_API_TOKEN || (canPromptForToken()
+            ? await promptForToken({
+                allowBlank: true,
+                prompt: "Mechanic API token (leave blank to add it later): ",
+            })
+            : null);
+        let storedToken = false;
+        if (token) {
+            const client = new MechanicClient({ baseUrl: normalizeApiBaseUrl(flags["api-base-url"]), token });
+            const verification = await client.verifyAuth();
+            const verifiedDomain = verification.shop?.shopify_domain;
+            if (!verifiedDomain) {
+                throw new CliError("Token verification did not return a shop domain.");
+            }
+            if (verifiedDomain !== flags.shop) {
+                throw new CliError(`Token belongs to ${verifiedDomain}, but this project is configured for ${flags.shop}.`);
+            }
+        }
+        const project = await initProject(process.cwd(), flags.shop, flags["api-base-url"], flags["app-url"], Boolean(flags.force));
+        try {
+            if (await ensureMechanicPrettierIgnore(process.cwd())) {
+                this.log(`${this.success("Updated")} .prettierignore for Mechanic Liquid files`);
+            }
+        }
+        catch (error) {
+            this.warn(`Could not update .prettierignore: ${errorMessage(error)}`);
+        }
+        if (token) {
+            await saveToken(project.shopDomain, token);
+            storedToken = true;
+        }
+        this.log(`${this.success("Initialized")} ${this.accent("Mechanic")} CLI project for ${this.accent(flags.shop)}`);
+        if (storedToken) {
+            this.log(`${this.success("Stored")} API token for ${this.accent(project.shopDomain)}`);
+        }
+        this.log("");
+        this.log("Next steps:");
+        if (!storedToken) {
+            this.log(`  ${this.taskName("mechanic auth login")}`);
+        }
+        this.log(`  ${this.taskName("mechanic tasks pull")}`);
+        this.log(`  ${this.taskName("mechanic tasks status")}`);
+        this.log(`  ${this.taskName("mechanic tasks preview tasks/<task>.json")}`);
+        this.log(`  ${this.taskName("mechanic tasks diff tasks/<task>.json")}`);
+        this.log(`  ${this.taskName("mechanic tasks publish tasks/<task>.json --dry-run")}`);
+        this.log(`  ${this.taskName("mechanic tasks publish tasks/<task>.json")}`);
+        this.log("");
+        this.log(this.lightwardAiLine());
+    }
+}

package/dist/commands/shop/status.d.ts

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

package/dist/commands/shop/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/shop/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAkDpD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAgB,OAAO,SAA4D;IACnF,OAAgB,WAAW,SAAyF;IAEpH,OAAgB,KAAK;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoG3B"}