@lightward/mechanic-cli 0.1.1 → 0.1.4

package/dist/commands/tasks/new.js

@@ -0,0 +1,104 @@
+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 { displayTaskPath, taskPath, taskSlug, unbundleTask, writeTaskFilePath } from "../../tasks.js";
+function taskNameFromInput(input) {
+    const cleaned = input.trim().replace(/\s+/g, " ");
+    if (cleaned.includes(" ")) {
+        return cleaned;
+    }
+    return taskSlug(cleaned)
+        .split("-")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+function starterTask(name) {
+    return {
+        halt_action_run_sequence_on_error: false,
+        name,
+        docs: "",
+        options: {},
+        perform_action_runs_in_sequence: false,
+        preview_event_definitions: [],
+        script: [
+            "{% comment %}",
+            "  Start writing your Mechanic task here.",
+            "{% endcomment %}",
+            "",
+            '{% log message: "Hello from Mechanic" %}',
+            "",
+        ].join("\n"),
+        subscriptions_template: "mechanic/user/text\n",
+        tags: [],
+    };
+}
+export default class TasksNew extends BaseCommand {
+    static summary = "Create a new blank local task.";
+    static description = "Create one blank local starter task JSON file and its matching editable helper directory. Nothing is created in Mechanic until you publish.";
+    static examples = [
+        "$ mechanic tasks new order-tagger",
+        "$ mechanic tasks new \"Order tagger\"",
+    ];
+    static args = {
+        name: Args.string({ required: true, description: "Task name or slug for the new local task." }),
+    };
+    static flags = {
+        force: Flags.boolean({ description: "Overwrite the local starter task JSON file and helper directory files." }),
+        json: Flags.boolean({ description: "Print created paths as JSON for agents, scripts, or editor integrations." }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TasksNew);
+        const project = await this.loadProject();
+        const requestedName = args.name.trim();
+        if (!requestedName) {
+            throw new CliError("Task name cannot be blank.", 2);
+        }
+        const slug = taskSlug(requestedName);
+        const name = taskNameFromInput(requestedName);
+        const filePath = taskPath(project, slug);
+        const helperDir = filePath.replace(/\.json$/i, "");
+        await this.checkExistingPaths(project, filePath, helperDir, Boolean(flags.force));
+        await writeTaskFilePath(filePath, starterTask(name));
+        await unbundleTask(filePath, helperDir);
+        const fileDisplay = displayTaskPath(project, filePath);
+        const helperDisplay = displayTaskPath(project, helperDir);
+        if (flags.json) {
+            this.outputJson({
+                ok: true,
+                name,
+                slug,
+                file: fileDisplay,
+                helper_dir: helperDisplay,
+            });
+            return;
+        }
+        this.log(`Created ${this.taskName(fileDisplay)}`);
+        this.log(`Created ${this.taskName(helperDisplay)}`);
+        this.log("");
+        this.log("Next steps:");
+        this.log(`  edit ${this.taskName(displayTaskPath(project, path.join(helperDir, "script.liquid")))}`);
+        this.log(`  mechanic tasks preview ${this.taskName(slug)}`);
+        this.log(`  mechanic tasks bundle ${this.taskName(slug)}`);
+        this.log(`  mechanic tasks publish ${this.taskName(slug)}`);
+    }
+    async checkExistingPaths(project, filePath, helperDir, force) {
+        if (force) {
+            return;
+        }
+        const existing = [];
+        if (await pathExists(filePath)) {
+            existing.push(displayTaskPath(project, filePath));
+        }
+        if (await pathExists(helperDir)) {
+            existing.push(displayTaskPath(project, helperDir));
+        }
+        if (existing.length > 0) {
+            throw new CliError([
+                `${existing.join(" and ")} already exists.`,
+                "Choose another task name, or re-run with --force to overwrite the local starter files.",
+            ].join("\n"), 2);
+        }
+    }
+}

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

@@ -1 +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"}
+{"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,SAAgH;IAE3I,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

@@ -15,9 +15,9 @@ function openerCommand(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 description = "Open a remote Mechanic task by local task slug, task ID, linked local task JSON file, or helper directory.";
     static args = {
-        target: Args.string({ required: true, description: "Remote task ID, linked local task JSON file, helper directory, or unique local task slug." }),
+        target: Args.string({ required: true, description: "Local task slug, remote task ID, linked local task JSON file, or helper directory." }),
     };
     async taskIdForTarget(project, target) {
         const selector = await resolveTaskSelector(project, target, {

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

@@ -1,6 +1,7 @@
 import { BaseCommand } from "../../base-command.js";
 import type { MechanicClient } from "../../client.js";
 import type { JsonObject, Project, TaskPreviewResponse } from "../../types.js";
+type PreviewDiagnostic = NonNullable<TaskPreviewResponse["diagnostics"]>[number];
 type PreparedPreview = {
     label: string;
     slug?: string;
@@ -28,6 +29,9 @@ export default class TasksPreview extends BaseCommand {
     renderPreview(project: Project, prepared: PreparedPreview, response: TaskPreviewResponse, options: PreviewRenderOptions): void;
     renderVerboseDetails(response: TaskPreviewResponse): void;
     renderRunDetails(response: TaskPreviewResponse): void;
+    renderDiagnostics(response: TaskPreviewResponse, options: PreviewRenderOptions): void;
+    diagnosticSeverityLabel(severity: PreviewDiagnostic["severity"]): string;
+    diagnosticDetails(diagnostic: PreviewDiagnostic): string[];
     renderPreviewValue(label: string, value: unknown, indent: number): void;
     formatPreviewValue(value: unknown): string | null;
     runStatusLabel(ok: boolean | null): string;

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

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

package/dist/commands/tasks/preview.js

@@ -2,7 +2,7 @@ import { Args, Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
 import { HttpError, CliError } from "../../errors.js";
 import { pathExists } from "../../fs.js";
-import { displayTaskPath, readRawTaskFile, resolveTaskSelector, rawTaskFromHelperDir, taskForPush, unbundledHelperDirForTaskFile, validateTaskForPush, } from "../../tasks.js";
+import { displayTaskPath, readRawTaskFile, resolveTaskSelector, rawTaskFromHelperDir, taskForPush, slugFromTaskFile, unbundledHelperDirForTaskFile, validateTaskForPush, } from "../../tasks.js";
 function errorBodyAsPreview(body) {
     if (!body || typeof body !== "object") {
         return null;
@@ -18,7 +18,7 @@ export default class TasksPreview extends BaseCommand {
         "Use --remote to preview the current task already in Mechanic, or --json for agents, scripts, and CI.",
     ].join("\n");
     static args = {
-        target: Args.string({ required: true, description: "Task file, helper directory, linked task ID, or unique local task slug." }),
+        target: Args.string({ required: true, description: "Local task slug, task file, helper directory, or linked task ID." }),
     };
     static flags = {
         json: Flags.boolean({ description: "Print the raw preview response as JSON for agents or CI." }),
@@ -134,6 +134,7 @@ export default class TasksPreview extends BaseCommand {
         if (options.verbose) {
             this.renderVerboseDetails(response);
         }
+        this.renderDiagnostics(response, options);
         this.renderPermissions(response);
         if (response.status === "invalid") {
             this.renderValidationErrors(response);
@@ -217,6 +218,45 @@ export default class TasksPreview extends BaseCommand {
             this.table(rows);
         }
     }
+    renderDiagnostics(response, options) {
+        const diagnostics = response.diagnostics || [];
+        const visibleDiagnostics = options.verbose
+            ? diagnostics
+            : diagnostics.filter((diagnostic) => diagnostic.severity === "warning" || diagnostic.severity === "error");
+        if (visibleDiagnostics.length === 0) {
+            return;
+        }
+        this.log("");
+        this.log(this.accent("Notes"));
+        for (const diagnostic of visibleDiagnostics) {
+            const details = options.verbose ? this.diagnosticDetails(diagnostic) : [];
+            const suffix = details.length ? ` ${this.muted(`(${details.join(", ")})`)}` : "";
+            const code = options.verbose ? ` ${this.muted(`[${diagnostic.code}]`)}` : "";
+            this.log(`  ${this.diagnosticSeverityLabel(diagnostic.severity)}${code} ${diagnostic.message}${suffix}`);
+            if (options.verbose && diagnostic.docs_url) {
+                this.log(`    ${this.muted(`Docs: ${diagnostic.docs_url}`)}`);
+            }
+        }
+    }
+    diagnosticSeverityLabel(severity) {
+        switch (severity) {
+            case "error":
+                return this.color("red", "error");
+            case "warning":
+                return this.color("yellow", "warning");
+            case "info":
+                return this.muted("info");
+        }
+    }
+    diagnosticDetails(diagnostic) {
+        return [
+            diagnostic.event_topic ? `event ${diagnostic.event_topic}` : null,
+            typeof diagnostic.event_index === "number" ? `event #${diagnostic.event_index + 1}` : null,
+            typeof diagnostic.task_run_index === "number" ? `task run #${diagnostic.task_run_index + 1}` : null,
+            typeof diagnostic.action_run_index === "number" ? `action run #${diagnostic.action_run_index + 1}` : null,
+            diagnostic.action_type ? `action ${diagnostic.action_type}` : null,
+        ].filter((detail) => Boolean(detail));
+    }
     renderPreviewValue(label, value, indent) {
         const formatted = this.formatPreviewValue(value);
         if (!formatted) {
@@ -345,7 +385,7 @@ export default class TasksPreview extends BaseCommand {
             `${relativeFile} is out of date with ${relativeHelperDir}.`,
             "",
             "Bundle the helper directory before previewing this JSON file:",
-            `  mechanic tasks bundle ${relativeHelperDir}`,
+            `  mechanic tasks bundle ${slugFromTaskFile(filePath)}`,
         ].join("\n"), 2);
     }
     approvalHint(action) {

package/dist/commands/tasks/publish.js

@@ -5,7 +5,7 @@ export default class TasksPublish extends TasksPush {
     static summary = "Publish one local task to Mechanic.";
     static description = "Publish one local task to Mechanic, or use --all to publish 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." }),
+        file: Args.string({ required: false, description: "Local task slug, task file, helper directory, or linked task ID." }),
     };
     static flags = {
         all: Flags.boolean({ description: "Publish every task JSON file in this project." }),

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

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/pull.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAmBpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,OAAO,SAAmD;IAC1E,OAAgB,WAAW,SAAmI;IAE9J,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2F3B"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/pull.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAoBpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,OAAgB,OAAO,SAAmD;IAC1E,OAAgB,WAAW,SAAmI;IAE9J,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAsG3B"}

package/dist/commands/tasks/pull.js

@@ -6,12 +6,12 @@ import { pathExists } from "../../fs.js";
 import { contentHash } from "../../hash.js";
 import { stableStringify } from "../../json.js";
 import { CliError } from "../../errors.js";
-import { displayTaskPath, nextAvailableSlug, readRawTaskFile, resolveTaskSelector, taskForPush, taskPath, taskSlug, unbundledHelperDirForTaskFile, writeTaskFilePathAndRefreshHelper, } from "../../tasks.js";
+import { displayTaskPath, nextAvailableSlug, readRawTaskFile, resolveTaskSelector, slugFromTaskFile, taskForPush, taskPath, taskSlug, unbundledHelperDirForTaskFile, writeTaskFilePathAndRefreshHelper, } from "../../tasks.js";
 export default class TasksPull extends BaseCommand {
     static summary = "Pull remote tasks into local task JSON files.";
     static description = "Pull every remote task into local canonical task JSON files, or pass a task ID, linked file, or linked slug to pull one task.";
     static args = {
-        task: Args.string({ required: false, description: "Remote task ID, linked local task JSON file, or linked local task slug." }),
+        task: Args.string({ required: false, description: "Local task slug, remote task ID, or linked local task JSON file." }),
     };
     static flags = {
         all: Flags.boolean({ description: "Pull every remote task for this shop. This is the default when no task ID is passed." }),
@@ -45,13 +45,14 @@ export default class TasksPull extends BaseCommand {
                     if (helperDir) {
                         const relativeFile = displayTaskPath(project, filePath);
                         const relativeHelperDir = displayTaskPath(project, helperDir);
+                        const slug = slugFromTaskFile(filePath);
                         throw new CliError([
                             `${relativeFile} is out of date with ${relativeHelperDir}.`,
                             "",
                             "The helper directory has changes that are not bundled into the JSON file.",
                             "",
                             "Bundle first:",
-                            `  mechanic tasks bundle ${relativeHelperDir}`,
+                            `  mechanic tasks bundle ${slug}`,
                             "",
                             "Then pull:",
                             `  mechanic tasks pull ${envelope.id}`,
@@ -61,7 +62,9 @@ export default class TasksPull extends BaseCommand {
                     const remoteTaskForPull = taskForPush(envelope.task);
                     const localMatchesCurrentRemote = stableStringify(localTaskForPull) === stableStringify(remoteTaskForPull);
                     const localHash = contentHash(localTaskForPull);
-                    if (!localMatchesCurrentRemote && localHash !== link?.last_remote_content_hash) {
+                    const localMatchesLastWritten = (localHash === link?.last_remote_content_hash
+                        || localHash === link?.last_local_content_hash);
+                    if (!localMatchesCurrentRemote && !localMatchesLastWritten) {
                         throw new CliError([
                             `${displayTaskPath(project, filePath)} has local changes that would be overwritten.`,
                             `Run "mechanic tasks diff ${displayTaskPath(project, filePath)}" to review them.`,
@@ -71,7 +74,7 @@ export default class TasksPull extends BaseCommand {
                 }
             }
             await writeTaskFilePathAndRefreshHelper(filePath, envelope.task);
-            links = updateLink({ ...project, links }, slug, envelope.id, envelope.content_hash);
+            links = updateLink({ ...project, links }, slug, envelope.id, envelope.content_hash, contentHash(taskForPush(envelope.task)));
             await saveLinks(project, links);
             rows.push([
                 this.taskId(project, envelope.id),

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

@@ -18,6 +18,7 @@ type PushRow = {
     task_id: string | null;
     content_hash: string | null;
     details: string;
+    url?: string;
 };
 type CreateCollision = {
     remoteId: string;
@@ -54,6 +55,7 @@ export default class TasksPush extends BaseCommand {
         rows: PushRow[];
     }>;
     pushRowsToTable(project: Project, statusHeader: string, rows: PushRow[], label: (status: string) => string): string[][];
+    printCreatedTaskLinks(rows: PushRow[]): void;
     planLabel(plan: string): string;
 }
 export {};

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

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

package/dist/commands/tasks/push.js

@@ -1,8 +1,9 @@
 import { createHash } from "node:crypto";
 import { Args, Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
-import { linkForSlug, saveLinks, updateLink } from "../../config.js";
+import { linkForSlug, saveLinks, taskAdminUrl, updateLink } from "../../config.js";
 import { CliError } from "../../errors.js";
+import { contentHash } from "../../hash.js";
 import { stableStringify } from "../../json.js";
 import { displayTaskPath, remoteChangedSinceLastPull, remoteChangedSinceLastPullDetails, remoteChangedSinceLastPullMessage, selectedTaskFiles, readRawTaskFile, slugFromTaskFile, taskForPush, taskSlug, unbundledHelperDirForTaskFile, validateTaskForPush, writeTaskFilePathAndRefreshHelper, } from "../../tasks.js";
 function createTaskIdempotencyKey(shopDomain, slug) {
@@ -22,7 +23,7 @@ export default class TasksPush extends BaseCommand {
     static summary = "Publish one local task, or use --all to publish every local task.";
     static description = "Publish one local task to Mechanic, or use --all to publish every local task JSON file in this project.";
     static args = {
-        file: Args.string({ required: false, description: "Task file, helper directory, linked task ID, or unique local task slug." }),
+        file: Args.string({ required: false, description: "Local task slug, task file, helper directory, or linked task ID." }),
     };
     static flags = {
         all: Flags.boolean({ description: "Publish every task JSON file in this project." }),
@@ -67,6 +68,7 @@ export default class TasksPush extends BaseCommand {
             return;
         }
         this.table(this.pushRowsToTable(project, "Action", rows, (status) => this.actionLabel(status)));
+        this.printCreatedTaskLinks(rows);
     }
     async publishTasks(project, preparation, force) {
         const client = await this.verifiedClientForProject(project);
@@ -80,7 +82,7 @@ export default class TasksPush extends BaseCommand {
             const link = linkForSlug({ ...project, links }, slug);
             if (!link) {
                 const created = await client.createTask(task, createTaskIdempotencyKey(project.shopDomain, slug));
-                links = updateLink({ ...project, links }, slug, created.id, created.content_hash);
+                links = updateLink({ ...project, links }, slug, created.id, created.content_hash, contentHash(taskForPush(created.task)));
                 await saveLinks(project, links);
                 await writeTaskFilePathAndRefreshHelper(file, created.task);
                 rows.push({
@@ -89,6 +91,7 @@ export default class TasksPush extends BaseCommand {
                     task_id: created.id,
                     content_hash: created.content_hash,
                     details: "created disabled; enable in Mechanic",
+                    url: taskAdminUrl(project, created.id),
                 });
                 continue;
             }
@@ -109,7 +112,7 @@ export default class TasksPush extends BaseCommand {
                 task,
                 ...(force ? { force: true } : { previous_content_hash: link.last_remote_content_hash }),
             });
-            links = updateLink({ ...project, links }, slug, updated.id, updated.content_hash);
+            links = updateLink({ ...project, links }, slug, updated.id, updated.content_hash, contentHash(taskForPush(updated.task)));
             await saveLinks(project, links);
             await writeTaskFilePathAndRefreshHelper(file, updated.task);
             rows.push({
@@ -118,6 +121,7 @@ export default class TasksPush extends BaseCommand {
                 task_id: updated.id,
                 content_hash: updated.content_hash,
                 details: "",
+                url: taskAdminUrl(project, updated.id),
             });
         }
         return rows;
@@ -249,10 +253,10 @@ export default class TasksPush extends BaseCommand {
                     "The helper directory has changes that are not bundled into the JSON file.",
                     "",
                     "Bundle first:",
-                    `  mechanic tasks bundle ${relativeHelperDir}`,
+                    `  mechanic tasks bundle ${slug}`,
                     "",
                     "Then publish:",
-                    `  mechanic tasks publish ${relativeFile}`,
+                    `  mechanic tasks publish ${slug}`,
                 ].join("\n");
                 if (!collectBlockedRows) {
                     throw new CliError(message, 2);
@@ -263,7 +267,7 @@ export default class TasksPush extends BaseCommand {
                     status: "blocked",
                     task_id: null,
                     content_hash: null,
-                    details: `bundle ${relativeHelperDir} first`,
+                    details: `bundle ${slug} first`,
                 });
                 continue;
             }
@@ -352,6 +356,17 @@ export default class TasksPush extends BaseCommand {
             ]),
         ];
     }
+    printCreatedTaskLinks(rows) {
+        const createdRows = rows.filter((row) => row.status === "created" && row.url);
+        if (createdRows.length === 0) {
+            return;
+        }
+        this.log("");
+        this.log(this.accent(createdRows.length === 1 ? "Open created task:" : "Open created tasks:"));
+        for (const row of createdRows) {
+            this.log(`  ${this.taskName(row.file)}  ${this.taskName(row.url || "")}`);
+        }
+    }
     planLabel(plan) {
         switch (plan) {
             case "would create":

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

@@ -15,7 +15,7 @@ export default class TasksStatus extends BaseCommand {
     };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        remote: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
     helperStatus(project: Project, file: string, task: JsonObject): Promise<HelperStatus>;

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAe9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1D,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAqBF,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAAuE;IAC9F,OAAgB,WAAW,SAA0H;IAErJ,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAsGpB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BrF,YAAY,CAChB,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GACnC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAejC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAgBnC"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAe9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1D,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAuBF,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAAwE;IAC/F,OAAgB,WAAW,SAA+Q;IAE1S,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAOnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAsHpB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BrF,YAAY,CAChB,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GACnC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAejC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAgBnC"}

package/dist/commands/tasks/status.js

@@ -5,22 +5,22 @@ import { linkForSlug } from "../../config.js";
 import { pathExists } from "../../fs.js";
 import { stableStringify } from "../../json.js";
 import { displayTaskPath, helperDirForTaskFile, readRawTaskFile, remoteChangedSinceLastPull, remoteChangedSinceLastPullDetails, selectedTaskFiles, slugFromTaskFile, taskForPush, unbundledHelperDirForTaskFile, validateTaskForPush, } from "../../tasks.js";
+const IMPLICIT_REMOTE_CHECK_LIMIT = 25;
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
 export default class TasksStatus extends BaseCommand {
-    static summary = "Show local task link, readiness, and optional remote sync status.";
-    static description = "Show whether local task files are linked, ready to publish, and optionally in sync with their remote Mechanic tasks.";
+    static summary = "Show whether local task files are ready and in sync with Mechanic.";
+    static description = `Show whether local task files are linked, ready to publish, and in sync with their remote Mechanic tasks. Repo-wide status checks remote state for up to ${IMPLICIT_REMOTE_CHECK_LIMIT} tasks; larger projects show local status only. Use --local to skip remote checks.`;
     static args = {
-        file: Args.string({ required: false, description: "Task file, helper directory, linked task ID, or unique local task slug. Defaults to every task JSON file." }),
+        file: Args.string({ required: false, description: "Local task slug, task file, helper directory, or linked task ID. Defaults to every task JSON file." }),
     };
     static flags = {
         json: Flags.boolean({
             description: "Print task status as JSON for agents, scripts, or editor integrations.",
         }),
-        remote: Flags.boolean({
-            char: "r",
-            description: "Check linked remote tasks and report no-change, local-change, or conflict state.",
+        local: Flags.boolean({
+            description: "Only check local files and links; do not call Mechanic.",
         }),
     };
     async run() {
@@ -29,6 +29,8 @@ export default class TasksStatus extends BaseCommand {
         const files = await selectedTaskFiles(project, args.file, !args.file);
         const statuses = [];
         let client = null;
+        const remoteSkippedForLimit = !flags.local && !args.file && files.length > IMPLICIT_REMOTE_CHECK_LIMIT;
+        const checkRemote = !flags.local && !remoteSkippedForLimit;
         const getClient = async () => {
             client ||= await this.verifiedClientForProject(project);
             return client;
@@ -64,9 +66,9 @@ export default class TasksStatus extends BaseCommand {
             if (helperStatus.details) {
                 details.push(helperStatus.details);
             }
-            const remote = flags.remote && task && !helperStatus.blocked
+            const remote = checkRemote && task && !helperStatus.blocked
                 ? await this.remoteStatus(link ? await getClient() : null, task, link)
-                : flags.remote ? { label: "skipped", details: undefined } : null;
+                : checkRemote ? { label: "skipped", details: undefined } : null;
             if (remote?.details) {
                 details.push(remote.details);
             }
@@ -86,14 +88,19 @@ export default class TasksStatus extends BaseCommand {
             });
         }
         if (flags.json) {
-            this.outputJson({
+            const output = {
                 shop_domain: project.shopDomain,
-                remote_checked: Boolean(flags.remote),
+                remote_checked: checkRemote,
                 tasks: statuses,
-            });
+            };
+            if (remoteSkippedForLimit) {
+                output.remote_skipped_reason = "too_many_tasks";
+                output.remote_check_limit = IMPLICIT_REMOTE_CHECK_LIMIT;
+            }
+            this.outputJson(output);
             return;
         }
-        const rows = flags.remote
+        const rows = checkRemote
             ? [["File", "Link", "Local", "Remote", "Task ID", "Details"]]
             : [["File", "Link", "Local", "Task ID", "Details"]];
         for (const status of statuses) {
@@ -102,12 +109,17 @@ export default class TasksStatus extends BaseCommand {
                 status.link.linked ? this.success("linked") : this.color("yellow", "unlinked"),
                 this.localLabel(status.local.label),
             ];
-            if (flags.remote) {
+            if (checkRemote) {
                 row.push(this.remoteLabel(status.remote?.label || "not checked"));
             }
             row.push(status.link.remote_id ? this.taskId(project, status.link.remote_id) : "--", status.details.join("; "));
             rows.push(row);
         }
+        if (remoteSkippedForLimit) {
+            this.log(this.color("yellow", `Skipped remote checks for ${files.length} tasks (limit ${IMPLICIT_REMOTE_CHECK_LIMIT}).`));
+            this.log(`Run "${this.taskName("mechanic tasks status <task>")}" to check one task's remote state.`);
+            this.log("");
+        }
         this.table(rows);
     }
     async helperStatus(project, file, task) {
@@ -121,7 +133,7 @@ export default class TasksStatus extends BaseCommand {
                 return {
                     label: "needs bundle",
                     blocked: true,
-                    details: `run mechanic tasks bundle ${displayTaskPath(project, driftDir)}`,
+                    details: `run mechanic tasks bundle ${slugFromTaskFile(file)}`,
                 };
             }
         }

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

@@ -1 +1 @@
-{"version":3,"file":"unbundle.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/unbundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAAkD;IACzE,OAAgB,WAAW,SAAiJ;IAC5K,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAOnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA+BZ,oBAAoB;CA2CnC"}
+{"version":3,"file":"unbundle.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/unbundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAAkD;IACzE,OAAgB,WAAW,SAA0I;IACrK,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAOnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA+BZ,oBAAoB;CA2CnC"}

package/dist/commands/tasks/unbundle.js

@@ -6,15 +6,15 @@ import { pathExists } from "../../fs.js";
 import { displayTaskPath, resolveTaskSelector, unbundleTask } from "../../tasks.js";
 export default class TasksUnbundle extends BaseCommand {
     static summary = "Unbundle one task into one helper directory.";
-    static description = "Unbundle one canonical task JSON file, linked task ID, helper directory, or unique local task slug into one editable helper task directory.";
+    static description = "Unbundle one local task slug, canonical task JSON file, linked task ID, or helper directory into one editable helper task directory.";
     static examples = [
-        "$ mechanic tasks unbundle tasks/order-tagger.json",
         "$ mechanic tasks unbundle order-tagger",
+        "$ mechanic tasks unbundle tasks/order-tagger.json",
         "$ mechanic tasks unbundle 171578bf-79e2-46af-857a-dbd71c6b7b2b",
-        "$ mechanic tasks unbundle tasks/order-tagger.json --out helpers/order-tagger",
+        "$ mechanic tasks unbundle order-tagger --out helpers/order-tagger",
     ];
     static args = {
-        file: Args.string({ required: false, description: "Task file, helper directory, linked task ID, or unique local task slug." }),
+        file: Args.string({ required: false, description: "Local task slug, task file, helper directory, or linked task ID." }),
     };
     static flags = {
         json: Flags.boolean({
@@ -31,7 +31,7 @@ export default class TasksUnbundle extends BaseCommand {
                 "Choose one task to unbundle.",
                 "",
                 "Example:",
-                "  mechanic tasks unbundle tasks/order-tagger.json",
+                "  mechanic tasks unbundle order-tagger",
                 "",
                 "By default this writes to tasks/order-tagger/. Use --out <dir> to choose another helper directory.",
             ].join("\n"), 2);

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

@@ -11,5 +11,6 @@ export default class TasksValidate extends BaseCommand {
     };
     run(): Promise<void>;
     validateTaskFile(file: string): Promise<ValidationResult>;
+    validateTaskDirectory(target: string): Promise<ValidationResult[]>;
 }
 //# sourceMappingURL=validate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/validate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAAgF;IACvG,OAAgB,WAAW,SAA0G;IAErI,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAchE"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/validate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAUxB,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,OAAO,SAA8D;IACrF,OAAgB,WAAW,SAAqH;IAEhJ,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAezD,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAgBzE"}