@lightward/mechanic-cli 0.1.1 → 0.1.4

package/README.md

@@ -38,6 +38,8 @@ Install from npm:
 npm install -g @lightward/mechanic-cli
 ```
 
+In interactive terminals, Mechanic occasionally checks npm and prints the update command when a newer CLI is available.
+
 ## Quick Start
 
 Create an API token in Mechanic:
@@ -60,20 +62,30 @@ Pull existing Mechanic tasks into local JSON files:
 mechanic tasks pull
 ```
 
+To start from scratch instead, create a new blank local task. This writes a
+starter JSON file and matching helper directory. You can use this in any
+initialized CLI project; it does not require a fresh repository:
+
+```bash
+mechanic tasks new order-tagger
+```
+
 For most Liquid or documentation edits, unbundle one task into helper files,
 edit those files, then bundle the helper directory back into its canonical JSON
 file. The JSON file remains the deployable source of truth; the helper directory
-is the comfortable editing view beside it.
+is the comfortable editing view beside it. Tasks created with `tasks new`
+already have both files, so you can start editing the helper directory
+immediately.
 
 ```bash
-mechanic tasks unbundle tasks/order-tagger.json
+mechanic tasks unbundle order-tagger
 # edit tasks/order-tagger/script.liquid, docs.md, or task.json
-mechanic tasks bundle tasks/order-tagger.json
+mechanic tasks bundle order-tagger
 mechanic tasks status
-mechanic tasks preview tasks/order-tagger.json
-mechanic tasks diff tasks/order-tagger.json
-mechanic tasks publish tasks/order-tagger.json --dry-run
-mechanic tasks publish tasks/order-tagger.json
+mechanic tasks preview order-tagger
+mechanic tasks diff order-tagger
+mechanic tasks publish order-tagger --dry-run
+mechanic tasks publish order-tagger
 ```
 
 For normal setup, paste the token into the masked prompt or run
@@ -102,8 +114,9 @@ mechanic auth logout
 mechanic github init [--force]
 mechanic shop status [--json]
 mechanic tasks list [--verbose] [--json]
+mechanic tasks new <name> [--force] [--json]
 mechanic tasks open <task>
-mechanic tasks status [task] [--remote] [--json]
+mechanic tasks status [task] [--local] [--json]
 mechanic tasks pull [--force]
 mechanic tasks pull <task> [--force]
 mechanic tasks pull --all [--force]
@@ -113,38 +126,61 @@ mechanic tasks diff --all [--exit-code] [--json]
 mechanic tasks publish <task> [--force] [--dry-run] [--json]
 mechanic tasks publish --all [--force] [--dry-run] [--json]
 mechanic tasks unbundle <task> [--out <dir>] [--json]
-mechanic tasks bundle <dir|file> [--out <file>] [--json]
-mechanic tasks validate <file|dir> [--json]
+mechanic tasks bundle <task|dir|file> [--out <file>] [--json]
+mechanic tasks validate <task|dir> [--json]
 ```
 
-Most task commands accept a `<task>` selector. A task selector can be a local
-JSON file, a helper directory, a linked remote task ID, or a unique local task
-slug:
+Most task commands accept a `<task>` selector. In day-to-day use, prefer the
+short local task slug:
+
+```bash
+mechanic tasks preview order-tagger
+```
+
+The CLI also accepts a full task JSON path, matching helper directory, or linked
+remote task ID:
 
 ```bash
 mechanic tasks preview tasks/order-tagger.json
 mechanic tasks preview tasks/order-tagger
-mechanic tasks preview order-tagger
 mechanic tasks preview 171578bf-79e2-46af-857a-dbd71c6b7b2b
 ```
 
 The local file is the working copy. The remote task ID is the Mechanic app's
 address for that task. `tasks list` shows linked local files when the CLI knows
-them. If a short selector matches more than one local file, the CLI asks for the
-full file path.
+them. If a short slug matches more than one local file, the CLI asks for the
+full file path; that is the main reason to use `tasks/<name>.json` directly.
+
+Task names and local file names are related, but they are not the same identity.
+When the CLI first pulls or creates a task, it uses the task name to choose a
+readable local slug like `order-tagger`, which becomes `tasks/order-tagger.json`.
+After that, the remote task ID stored in `.mechanic/links.json` is the sync
+identity. If you rename the task in Mechanic, the next pull keeps the existing
+local file name and updates the `name` field inside the JSON. If you rename the
+local JSON file or helper directory by hand, the CLI treats that as a new local
+slug and the task may appear unlinked. Keep local filenames stable unless you
+also intentionally update `.mechanic/links.json` and verify with `tasks status`
+and `tasks publish --dry-run`.
 
 `tasks pull` pulls every task when you run it without arguments. Pass a task
 selector when you only want one task. `tasks diff` and `tasks publish` operate
 on one task when you pass a selector. They operate on every task only when you
 explicitly pass `--all`.
 
+`tasks new` creates a new blank local starter task. It writes both
+`tasks/<slug>.json` and `tasks/<slug>/`, so you can edit the helper files first
+and bundle them into the JSON file before publishing. It can be used any time in
+an initialized CLI project, and it refuses to overwrite existing local task files
+unless you pass `--force`. It does not create anything in Mechanic until you run
+`tasks publish`; new published tasks are created disabled.
+
 `shop status` shows the current Mechanic run queue for the configured shop:
 running runs, waiting runs, queue lag, and the largest backlog groups by task,
 action, and event topic.
 
-`tasks status` shows whether local task JSON files are linked to remote Mechanic
-tasks and ready to publish. It is local-only by default; add `--remote` to check
-whether linked remote tasks are unchanged, locally changed, or conflicted.
+`tasks status` shows whether local task JSON files are linked, ready to publish,
+and in sync with their remote Mechanic tasks. Use `--local` when you only want
+the fast offline check for JSON validity, link state, and helper-folder drift.
 Add `--json` when an editor integration needs task readiness, link state, and
 remote sync state without parsing table output.
 
@@ -165,21 +201,22 @@ or enabling the task.
 
 `tasks publish` sends local task JSON back to Mechanic.
 
-`tasks publish --dry-run` validates the selected files, checks for unbundled
-helper changes, fetches linked remote tasks, checks unlinked files against
-existing remote task names, and prints what would create, update, stay
-unchanged, or conflict. It does not write to Mechanic, `.mechanic/links.json`,
-or local task JSON. New tasks created by `tasks publish` are created disabled;
-review and enable them in Mechanic when they are ready to run.
+`tasks publish --dry-run` is a publish preflight. It checks whether publishing
+would be safe, including helper-folder drift, linked remote task changes, and
+unlinked files that look like existing remote tasks. It then prints what would
+create, update, stay unchanged, or stop as a conflict. It does not write to
+Mechanic, `.mechanic/links.json`, or local task JSON. New tasks created by
+`tasks publish` are created disabled; review and enable them in Mechanic when
+they are ready to run.
 
 For automation or editor integrations, add `--json` to `tasks list`, `tasks
 status`, `tasks diff`, `tasks validate`, `tasks bundle`, `tasks unbundle`,
 `tasks publish`, or `shop status`.
 
 `tasks unbundle` and `tasks bundle` operate on one task at a time. By default,
-`mechanic tasks unbundle tasks/order-tagger.json` writes to
-`tasks/order-tagger/`, and `mechanic tasks bundle tasks/order-tagger.json`
-writes back to `tasks/order-tagger.json`.
+`mechanic tasks unbundle order-tagger` writes to `tasks/order-tagger/`, and
+`mechanic tasks bundle order-tagger` writes back to `tasks/order-tagger.json`.
+You can pass the full JSON path when you want to be explicit.
 
 When a task has `subscriptions_template`, the editable helper file is
 `subscriptions.liquid`. Mechanic renders that template into `subscriptions`, so
@@ -207,8 +244,7 @@ open a task explicitly. Use `--app-url` or `MECHANIC_APP_URL` if your shop uses
 a non-production Shopify app alias.
 
 Use `mechanic tasks open <task>` to open a task in the Mechanic app from its
-remote ID, linked local task JSON file, helper directory, or unique local task
-slug.
+local task slug, linked local task JSON file, helper directory, or remote ID.
 
 ## Advanced: GitHub Actions Task Workflows
 
@@ -322,7 +358,7 @@ inside JSON is unpleasant. The helper workflow splits a task into separate
 editable files:
 
 ```bash
-mechanic tasks unbundle tasks/order-tagger.json --out order-tagger
+mechanic tasks unbundle order-tagger --out order-tagger
 ```
 
 `tasks unbundle` also accepts the same local task selectors as preview, diff,
@@ -330,6 +366,7 @@ and publish:
 
 ```bash
 mechanic tasks unbundle order-tagger
+mechanic tasks unbundle tasks/order-tagger.json
 mechanic tasks unbundle tasks/order-tagger
 mechanic tasks unbundle 171578bf-79e2-46af-857a-dbd71c6b7b2b
 ```
@@ -347,14 +384,15 @@ order-tagger/
 After editing, bundle the helper directory back to canonical JSON:
 
 ```bash
-mechanic tasks bundle tasks/order-tagger.json
-mechanic tasks validate tasks/order-tagger.json
+mechanic tasks bundle order-tagger
+mechanic tasks validate order-tagger
 ```
 
-`tasks bundle` accepts either side of the pair. `mechanic tasks bundle
-tasks/order-tagger` writes `tasks/order-tagger.json`, and `mechanic tasks bundle
-tasks/order-tagger.json` reads `tasks/order-tagger/` and writes back to that JSON
-file.
+`tasks bundle` accepts the local task slug or either side of the pair.
+`mechanic tasks bundle order-tagger` and `mechanic tasks bundle
+tasks/order-tagger` both write `tasks/order-tagger.json`. `mechanic tasks bundle
+tasks/order-tagger.json` reads `tasks/order-tagger/` and writes back to that
+JSON file.
 
 When unbundling, helper files are written only for string fields. `null` fields
 stay in `task.json`, and stale helper files for non-string fields are removed.

package/dist/base-command.d.ts

@@ -2,6 +2,7 @@ import { Command } from "@oclif/core";
 import { MechanicClient } from "./client.js";
 import type { Project } from "./types.js";
 export declare abstract class BaseCommand extends Command {
+    protected finally(error: Error | undefined): Promise<void>;
     loadProject(): Promise<Project>;
     clientForProject(project: Project): Promise<MechanicClient>;
     verifiedClientForProject(project: Project): Promise<MechanicClient>;

package/dist/base-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAM,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,8BAAsB,WAAY,SAAQ,OAAO;IACzC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAO3D,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAMnE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAenC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3B,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7B,eAAe,IAAI,MAAM;IAQzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;CAgB9B"}
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAM,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,8BAAsB,WAAY,SAAQ,OAAO;cACtB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBnE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ3D,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAMnE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAenC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3B,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7B,eAAe,IAAI,MAAM;IAQzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;CAgB9B"}

package/dist/base-command.js

@@ -5,13 +5,28 @@ import { requireToken } from "./auth.js";
 import { MechanicClient } from "./client.js";
 import { loadProject, taskAdminUrl } from "./config.js";
 import { CliError } from "./errors.js";
+import { getUpdateNotice, shouldCheckForUpdates } from "./update-check.js";
 export class BaseCommand extends Command {
+    async finally(error) {
+        await super.finally(error);
+        if (error || !shouldCheckForUpdates(this.argv)) {
+            return;
+        }
+        const notice = await getUpdateNotice();
+        if (!notice) {
+            return;
+        }
+        this.log("");
+        this.log(`${this.color("yellow", "Update available")} Mechanic CLI ${this.muted(notice.currentVersion)} -> ${this.success(notice.latestVersion)}`);
+        this.log(`Update with: ${this.taskName("npm install -g @lightward/mechanic-cli")}`);
+    }
     async loadProject() {
         return loadProject(process.cwd());
     }
     async clientForProject(project) {
         return new MechanicClient({
             baseUrl: project.apiBaseUrl,
+            expectedShopDomain: project.shopDomain,
             token: await requireToken(project.shopDomain),
         });
     }
@@ -24,7 +39,7 @@ export class BaseCommand extends Command {
         const verification = await client.verifyAuth();
         const verifiedShopDomain = verification.shop?.shopify_domain;
         if (verifiedShopDomain !== project.shopDomain) {
-            throw new CliError(`API token belongs to ${verifiedShopDomain || "an unknown shop"}, but mechanic.json is configured for ${project.shopDomain}.`, 2);
+            throw new CliError("API token does not match this Mechanic CLI project. Use a token for the shop in mechanic.json, or re-run mechanic init for the intended shop.", 2);
         }
     }
     accent(text) {

package/dist/client.d.ts

@@ -17,9 +17,11 @@ export type AuthVerification = {
 };
 export declare class MechanicClient {
     readonly baseUrl: string;
+    readonly expectedShopDomain?: string;
     readonly token: string;
-    constructor({ baseUrl, token }: {
+    constructor({ baseUrl, expectedShopDomain, token }: {
         baseUrl: string;
+        expectedShopDomain?: string;
         token: string;
     });
     request<T>(pathname: string, options?: RequestOptions): Promise<T>;

package/dist/client.d.ts.map

@@ -1 +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"}
+{"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,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAM7G,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAgD5E,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

@@ -87,9 +87,11 @@ function apiErrorMessage(response, parsed) {
 }
 export class MechanicClient {
     baseUrl;
+    expectedShopDomain;
     token;
-    constructor({ baseUrl, token }) {
+    constructor({ baseUrl, expectedShopDomain, token }) {
         this.baseUrl = baseUrl;
+        this.expectedShopDomain = expectedShopDomain;
         this.token = token;
     }
     async request(pathname, options = {}) {
@@ -106,6 +108,7 @@ export class MechanicClient {
                         Accept: "application/json",
                         Authorization: `Bearer ${this.token}`,
                         "User-Agent": USER_AGENT,
+                        ...(this.expectedShopDomain ? { "X-Mechanic-Shop-Domain": this.expectedShopDomain } : {}),
                         ...(options.body === undefined ? {} : { "Content-Type": "application/json" }),
                         ...(options.headers || {}),
                     },

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

@@ -1 +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"}
+{"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;IA4BpB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CASxC"}

package/dist/commands/auth/login.js

@@ -14,14 +14,18 @@ export default class AuthLogin extends BaseCommand {
         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 client = new MechanicClient({
+            baseUrl: project.apiBaseUrl,
+            expectedShopDomain: project.shopDomain,
+            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}.`);
+            throw new CliError("API token does not match this Mechanic CLI project. Use a token for the shop in mechanic.json.", 2);
         }
         await saveToken(project.shopDomain, token);
         this.log(`${this.success("Stored")} API token for ${this.accent(project.shopDomain)}`);

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

@@ -1 +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"}
+{"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;IAoH1B,WAAW,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;CAUpD"}

package/dist/commands/doctor.js

@@ -60,14 +60,16 @@ export default class Doctor extends BaseCommand {
                 const verifiedDomain = verification.shop?.shopify_domain;
                 verifiedShopMatches = verifiedDomain === project.shopDomain;
                 addRow("Token shop", verifiedShopMatches ? "ok" : "fail", verifiedDomain
-                    ? `${verifiedDomain}${verifiedShopMatches ? "" : ` does not match ${project.shopDomain}`}`
+                    ? (verifiedShopMatches ? project.shopDomain : "API token does not match this project")
                     : "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);
+                if (verifiedShopMatches) {
+                    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) {

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

@@ -1 +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"}
+{"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;CAoE3B"}

package/dist/commands/init.js

@@ -28,14 +28,18 @@ export default class Init extends BaseCommand {
             : null);
         let storedToken = false;
         if (token) {
-            const client = new MechanicClient({ baseUrl: normalizeApiBaseUrl(flags["api-base-url"]), token });
+            const client = new MechanicClient({
+                baseUrl: normalizeApiBaseUrl(flags["api-base-url"]),
+                expectedShopDomain: flags.shop,
+                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}.`);
+                throw new CliError("API token does not match the requested shop. Check --shop or use a token for that shop.", 2);
             }
         }
         const project = await initProject(process.cwd(), flags.shop, flags["api-base-url"], flags["app-url"], Boolean(flags.force));
@@ -61,11 +65,13 @@ export default class Init extends BaseCommand {
             this.log(`  ${this.taskName("mechanic auth login")}`);
         }
         this.log(`  ${this.taskName("mechanic tasks pull")}`);
+        this.log("  or, to start from scratch:");
+        this.log(`  ${this.taskName("mechanic tasks new <task-slug>")}`);
         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.taskName("mechanic tasks preview <task-slug>")}`);
+        this.log(`  ${this.taskName("mechanic tasks diff <task-slug>")}`);
+        this.log(`  ${this.taskName("mechanic tasks publish <task-slug> --dry-run")}`);
+        this.log(`  ${this.taskName("mechanic tasks publish <task-slug>")}`);
         this.log("");
         this.log(this.lightwardAiLine());
     }

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

@@ -1 +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"}
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/bundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASpD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,OAAO,SAA+D;IACtF,OAAgB,WAAW,SAAqG;IAChI,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAOnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAgCZ,kBAAkB;CAuEjC"}

package/dist/commands/tasks/bundle.js

@@ -3,17 +3,21 @@ 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";
+import { bundleTask, displayTaskPath, resolveTaskSelector } from "../../tasks.js";
+function looksLikeTaskPath(input) {
+    return input.includes("/") || input.includes("\\") || input.toLowerCase().endsWith(".json");
+}
 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 description = "Bundle one local task slug or editable helper task directory into one canonical task JSON file.";
     static examples = [
+        "$ mechanic tasks bundle order-tagger",
         "$ mechanic tasks bundle tasks/order-tagger",
         "$ mechanic tasks bundle tasks/order-tagger.json",
-        "$ mechanic tasks bundle tasks/order-tagger --out tasks/order-tagger.json",
+        "$ mechanic tasks bundle order-tagger --out tasks/order-tagger.json",
     ];
     static args = {
-        dir: Args.string({ required: false, description: "Helper task directory, or its matching task JSON file." }),
+        dir: Args.string({ required: false, description: "Local task slug, helper task directory, or matching task JSON file." }),
     };
     static flags = {
         json: Flags.boolean({
@@ -30,7 +34,7 @@ export default class TasksBundle extends BaseCommand {
                 "Choose one helper task directory to bundle.",
                 "",
                 "Example:",
-                "  mechanic tasks bundle tasks/order-tagger",
+                "  mechanic tasks bundle order-tagger",
                 "",
                 "By default this writes to tasks/order-tagger.json. Use --out <file> to choose another task JSON file.",
             ].join("\n"), 2);
@@ -59,6 +63,34 @@ export default class TasksBundle extends BaseCommand {
                 outputDisplay: out || `${input}.json`,
             };
         }
+        if (!looksLikeTaskPath(input)) {
+            let project = null;
+            try {
+                project = await this.loadProject();
+            }
+            catch (error) {
+                if (!(error instanceof CliError) || !error.message.startsWith("No mechanic.json found")) {
+                    throw error;
+                }
+            }
+            if (project) {
+                const selector = await resolveTaskSelector(project, input, { allowHelperDir: true });
+                const filePath = selector.file ? path.resolve(selector.file) : null;
+                const helperPath = selector.helperDir
+                    ? path.resolve(selector.helperDir)
+                    : filePath?.replace(/\.json$/i, "");
+                if (helperPath && await pathExists(path.join(helperPath, "task.json"))) {
+                    const outputPath = out
+                        ? path.resolve(out)
+                        : filePath || `${helperPath}.json`;
+                    return {
+                        dirPath: helperPath,
+                        inputDisplay: displayTaskPath(project, helperPath),
+                        outputDisplay: displayTaskPath(project, outputPath),
+                    };
+                }
+            }
+        }
         if (!input.toLowerCase().endsWith(".json")) {
             return {
                 dirPath: inputPath,

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

@@ -1 +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"}
+{"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;CAoH3B"}

package/dist/commands/tasks/diff.js

@@ -6,7 +6,7 @@ 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." }),
+        file: Args.string({ required: false, description: "Local task slug, task file, helper directory, or linked task ID." }),
     };
     static flags = {
         all: Flags.boolean({ description: "Diff every task JSON file in this project." }),
@@ -86,7 +86,7 @@ export default class TasksDiff extends BaseCommand {
             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.`), "");
+                    section.push(this.color("yellow", "Remote changed since your last pull."), this.muted("Showing what would change if your local file replaced the current Mechanic task."), this.muted("Diff legend: - current Mechanic, + local file."), this.muted(`Run "mechanic tasks pull ${link.remote_id}" to keep the Mechanic version, or use --force only if the local file should win.`), "");
                 }
                 if (diff) {
                     section.push(diff);

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/tasks/new.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAwCpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,OAAgB,OAAO,SAAoC;IAC3D,OAAgB,WAAW,SAAiJ;IAC5K,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA0CZ,kBAAkB;CA2BjC"}