@lightward/mechanic-cli 0.1.1 → 0.1.4

package/dist/commands/tasks/validate.js

@@ -4,15 +4,18 @@ import path from "node:path";
 import { BaseCommand } from "../../base-command.js";
 import { CliError } from "../../errors.js";
 import { pathExists } from "../../fs.js";
-import { rawTaskFromHelperDir, readRawTaskFile, unbundledHelperDirForTaskFile, validateTask, } from "../../tasks.js";
+import { rawTaskFromHelperDir, readRawTaskFile, resolveTaskSelector, unbundledHelperDirForTaskFile, validateTask, } from "../../tasks.js";
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
+function looksLikeValidationPath(input) {
+    return path.isAbsolute(input) || input.endsWith(".json") || input.includes("/") || input.includes(path.sep);
+}
 export default class TasksValidate extends BaseCommand {
-    static summary = "Validate one task file, helper directory, or directory of task JSON files.";
-    static description = "Validate one canonical task JSON file, one helper task directory, or a directory of task JSON files.";
+    static summary = "Validate one local task or directory of task JSON files.";
+    static description = "Validate one local task slug, canonical task JSON file, helper task directory, or directory of task JSON files.";
     static args = {
-        target: Args.string({ required: true, description: "Task JSON file, helper dir, or directory of task JSON files." }),
+        target: Args.string({ required: true, description: "Local task slug, task JSON file, helper dir, or directory of task JSON files." }),
     };
     static flags = {
         json: Flags.boolean({
@@ -23,25 +26,30 @@ export default class TasksValidate extends BaseCommand {
         const { args, flags } = await this.parse(TasksValidate);
         const target = path.resolve(args.target);
         const results = [];
-        const stat = await fs.stat(target).catch((error) => {
-            throw new CliError(`Unable to access ${target}: ${errorMessage(error)}`, 2);
-        });
-        if (stat.isFile()) {
+        const stat = await fs.stat(target).catch(() => null);
+        if (stat?.isFile()) {
             results.push(await this.validateTaskFile(target));
         }
-        else if (await pathExists(path.join(target, "task.json"))) {
+        else if (stat?.isDirectory() && await pathExists(path.join(target, "task.json"))) {
             results.push(validateTask(await rawTaskFromHelperDir(target), target));
         }
+        else if (stat?.isDirectory()) {
+            results.push(...await this.validateTaskDirectory(target));
+        }
         else {
-            const entries = await fs.readdir(target, { withFileTypes: true }).catch((error) => {
-                throw new CliError(`Unable to read directory ${target}: ${errorMessage(error)}`, 2);
-            });
-            const files = entries
-                .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
-                .map((entry) => path.join(target, entry.name))
-                .sort();
-            for (const file of files) {
-                results.push(await this.validateTaskFile(file));
+            if (looksLikeValidationPath(args.target)) {
+                throw new CliError(`Unable to access ${target}: no such file or directory`, 2);
+            }
+            const project = await this.loadProject();
+            const selector = await resolveTaskSelector(project, args.target, { allowHelperDir: true });
+            if (selector.helperDir) {
+                results.push(validateTask(await rawTaskFromHelperDir(selector.helperDir), selector.helperDir));
+            }
+            else if (selector.file) {
+                results.push(await this.validateTaskFile(selector.file));
+            }
+            else {
+                throw new CliError(`No local task file or helper directory found for ${args.target}.`, 2);
             }
         }
         if (results.length === 0) {
@@ -75,4 +83,18 @@ export default class TasksValidate extends BaseCommand {
         }
         return result;
     }
+    async validateTaskDirectory(target) {
+        const entries = await fs.readdir(target, { withFileTypes: true }).catch((error) => {
+            throw new CliError(`Unable to read directory ${target}: ${errorMessage(error)}`, 2);
+        });
+        const files = entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+            .map((entry) => path.join(target, entry.name))
+            .sort();
+        const results = [];
+        for (const file of files) {
+            results.push(await this.validateTaskFile(file));
+        }
+        return results;
+    }
 }

package/dist/config.d.ts

@@ -11,5 +11,5 @@ export declare function loadProject(cwd?: string): Promise<Project>;
 export declare function saveLinks(project: Project, links: LinksFile): Promise<void>;
 export declare function linkForSlug(project: Project, slug: string): LinkEntry | null;
 export declare function slugForRemoteId(project: Project, remoteId: string): string | null;
-export declare function updateLink(project: Project, slug: string, remoteId: string, contentHash: string): LinksFile;
+export declare function updateLink(project: Project, slug: string, remoteId: string, contentHash: string, localContentHash?: string): LinksFile;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhF,eAAO,MAAM,oBAAoB,QAAkE,CAAC;AA0BpG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBzD;AA+BD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,SAA4B,GAAG,MAAM,CAG9F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,SAAuB,EACjC,MAAM,SAA4D,GACjE,cAAc,CAOhB;AAED,wBAAgB,UAAU,IAAI,SAAS,CAEtC;AAkED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BhF;AAED,wBAAsB,WAAW,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCvE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAW3G"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhF,eAAO,MAAM,oBAAoB,QAAkE,CAAC;AA0BpG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBzD;AA+BD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,SAA4B,GAAG,MAAM,CAG9F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,SAAuB,EACjC,MAAM,SAA4D,GACjE,cAAc,CAOhB;AAED,wBAAgB,UAAU,IAAI,SAAS,CAEtC;AAwED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BhF;AAED,wBAAsB,WAAW,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCvE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjF;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,MAAM,GACxB,SAAS,CAiBX"}

package/dist/config.js

@@ -91,11 +91,15 @@ function normalizeLinkEntry(slug, entry) {
     if (!entry || typeof entry !== "object" || !entry.remote_id || !entry.last_remote_content_hash) {
         return null;
     }
-    return [slug, {
-            file: entry.file || `${DEFAULT_TASKS_DIR}/${slug}.json`,
-            remote_id: entry.remote_id,
-            last_remote_content_hash: entry.last_remote_content_hash,
-        }];
+    const normalized = {
+        file: entry.file || `${DEFAULT_TASKS_DIR}/${slug}.json`,
+        remote_id: entry.remote_id,
+        last_remote_content_hash: entry.last_remote_content_hash,
+    };
+    if (typeof entry.last_local_content_hash === "string") {
+        normalized.last_local_content_hash = entry.last_local_content_hash;
+    }
+    return [slug, normalized];
 }
 function normalizeLegacyLinkEntry(slug, entry) {
     if (!entry || typeof entry !== "object" || !entry.task_id || !entry.last_remote_hash) {
@@ -213,15 +217,19 @@ export function linkForSlug(project, slug) {
 export function slugForRemoteId(project, remoteId) {
     return Object.entries(project.links.tasks).find(([, link]) => link.remote_id === remoteId)?.[0] || null;
 }
-export function updateLink(project, slug, remoteId, contentHash) {
+export function updateLink(project, slug, remoteId, contentHash, localContentHash) {
+    const entry = {
+        file: `${project.tasksDirName}/${slug}.json`,
+        remote_id: remoteId,
+        last_remote_content_hash: contentHash,
+    };
+    if (localContentHash && localContentHash !== contentHash) {
+        entry.last_local_content_hash = localContentHash;
+    }
     return {
         tasks: {
             ...project.links.tasks,
-            [slug]: {
-                file: `${project.tasksDirName}/${slug}.json`,
-                remote_id: remoteId,
-                last_remote_content_hash: contentHash,
-            },
+            [slug]: entry,
         },
     };
 }

package/dist/tasks.js

@@ -217,7 +217,7 @@ async function resolveExistingPathSelector(project, input, allowHelperDir) {
         }
         throw new CliError([
             `No canonical task JSON file found for helper directory ${displayTaskPath(project, candidate)}.`,
-            `Run "mechanic tasks bundle ${displayTaskPath(project, candidate)}" first.`,
+            `Run "mechanic tasks bundle ${taskSlug(path.basename(candidate))}" first.`,
         ].join("\n"), 2);
     }
     return null;
@@ -322,7 +322,7 @@ export function remoteChangedSinceLastPullDetails(force = false) {
     return force ? "remote changed since last pull; --force set" : "remote changed since last pull";
 }
 export function remoteChangedSinceLastPullMessage(relativeFile, remoteId) {
-    return `${relativeFile} has remote changes since the last pull. Run "mechanic tasks diff ${relativeFile}" to review, then "mechanic tasks pull ${remoteId}" to keep the remote version, or re-run with --force only if the local file should win.`;
+    return `${relativeFile} has changes in Mechanic since the last pull. Run "mechanic tasks diff ${relativeFile}" to review, then "mechanic tasks pull ${remoteId}" to keep the Mechanic version, or re-run with --force only if the local file should win.`;
 }
 export function taskForPush(task) {
     const { enabled: _enabled, id: _id, remote_id: _remoteId, ...payload } = task;

package/dist/types.d.ts

@@ -9,6 +9,7 @@ export type LinkEntry = {
     file: string;
     remote_id: string;
     last_remote_content_hash: string;
+    last_local_content_hash?: string;
 };
 export type LinksFile = {
     tasks: Record<string, LinkEntry>;
@@ -76,6 +77,17 @@ export type TaskPreviewResponse = {
         };
         warnings: string[];
     };
+    diagnostics?: Array<{
+        code: string;
+        severity: "info" | "warning" | "error";
+        message: string;
+        event_index?: number;
+        event_topic?: string | null;
+        task_run_index?: number;
+        action_run_index?: number;
+        action_type?: string | null;
+        docs_url?: string;
+    }>;
     events: Array<{
         topic: string;
         shopify_topic?: string | null;

package/dist/types.d.ts.map

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

package/dist/update-check.d.ts

@@ -0,0 +1,14 @@
+export type UpdateNotice = {
+    currentVersion: string;
+    latestVersion: string;
+};
+export type UpdateNoticeOptions = {
+    cachePath?: string;
+    currentVersion?: string;
+    fetchLatestVersion?: () => Promise<string | null>;
+    now?: Date;
+};
+export declare function isVersionNewer(candidate: string, current: string): boolean;
+export declare function getUpdateNotice(options?: UpdateNoticeOptions): Promise<UpdateNotice | null>;
+export declare function shouldCheckForUpdates(argv?: string[], env?: NodeJS.ProcessEnv, isTty?: boolean): boolean;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAsBF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA+B1E;AA2CD,wBAAsB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA8CrG;AAED,wBAAgB,qBAAqB,CACnC,IAAI,WAAwB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,KAAK,UAAgC,GACpC,OAAO,CAeT"}

package/dist/update-check.js

@@ -0,0 +1,136 @@
+import { createRequire } from "node:module";
+import { appConfigPath, readJson, writeJson } from "./fs.js";
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json");
+const PACKAGE_NAME = packageJson.name || "@lightward/mechanic-cli";
+const CURRENT_VERSION = packageJson.version || "0.0.0";
+const NPM_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(PACKAGE_NAME).replace("%40", "@")}/latest`;
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const NOTIFY_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 1500;
+function parseVersion(version) {
+    const [core, prerelease] = version.trim().replace(/^v/i, "").split("-", 2);
+    const parts = core.split(".");
+    if (parts.length < 2 || parts.length > 3 || parts.some((part) => !/^\d+$/.test(part))) {
+        return null;
+    }
+    const numbers = parts.map((part) => Number.parseInt(part, 10));
+    return {
+        numbers: [
+            numbers[0] || 0,
+            numbers[1] || 0,
+            numbers[2] || 0,
+        ],
+        prerelease: prerelease || null,
+    };
+}
+export function isVersionNewer(candidate, current) {
+    const candidateParts = parseVersion(candidate);
+    const currentParts = parseVersion(current);
+    if (!candidateParts || !currentParts) {
+        return false;
+    }
+    for (const index of [0, 1, 2]) {
+        if (candidateParts.numbers[index] > currentParts.numbers[index]) {
+            return true;
+        }
+        if (candidateParts.numbers[index] < currentParts.numbers[index]) {
+            return false;
+        }
+    }
+    if (!candidateParts.prerelease && currentParts.prerelease) {
+        return true;
+    }
+    if (candidateParts.prerelease && !currentParts.prerelease) {
+        return false;
+    }
+    return Boolean(candidateParts.prerelease
+        && currentParts.prerelease
+        && candidateParts.prerelease > currentParts.prerelease);
+}
+function millisecondsSince(value, now) {
+    if (!value) {
+        return Number.POSITIVE_INFINITY;
+    }
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? now.getTime() - parsed : Number.POSITIVE_INFINITY;
+}
+async function fetchLatestPackageVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const response = await fetch(NPM_LATEST_URL, {
+            headers: { Accept: "application/json" },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const body = await response.json();
+        return typeof body.version === "string" ? body.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function writeCache(cachePath, cache) {
+    try {
+        await writeJson(cachePath, cache);
+    }
+    catch {
+        // Update checks are best-effort and must never affect command behavior.
+    }
+}
+export async function getUpdateNotice(options = {}) {
+    const now = options.now || new Date();
+    const currentVersion = options.currentVersion || CURRENT_VERSION;
+    const cachePath = options.cachePath || appConfigPath("update-check.json");
+    const fetchLatestVersion = options.fetchLatestVersion || fetchLatestPackageVersion;
+    const cache = await readJson(cachePath, {}).catch(() => ({}));
+    const checkedRecently = millisecondsSince(cache.checked_at, now) < CHECK_INTERVAL_MS;
+    let cacheChanged = false;
+    let latestVersion = cache.latest_version || null;
+    if (!checkedRecently) {
+        const fetchedVersion = await fetchLatestVersion();
+        cache.checked_at = now.toISOString();
+        cacheChanged = true;
+        if (fetchedVersion) {
+            latestVersion = fetchedVersion;
+            cache.latest_version = fetchedVersion;
+        }
+    }
+    if (!latestVersion || !isVersionNewer(latestVersion, currentVersion)) {
+        if (cacheChanged) {
+            await writeCache(cachePath, cache);
+        }
+        return null;
+    }
+    const notifiedRecently = millisecondsSince(cache.last_notified_at, now) < NOTIFY_INTERVAL_MS;
+    if (notifiedRecently) {
+        if (cacheChanged) {
+            await writeCache(cachePath, cache);
+        }
+        return null;
+    }
+    cache.last_notified_at = now.toISOString();
+    await writeCache(cachePath, cache);
+    return {
+        currentVersion,
+        latestVersion,
+    };
+}
+export function shouldCheckForUpdates(argv = process.argv.slice(2), env = process.env, isTty = process.stdout.isTTY === true) {
+    if (!isTty) {
+        return false;
+    }
+    if (env.CI
+        || env.GITHUB_ACTIONS
+        || env.MECHANIC_SKIP_UPDATE_CHECK === "1"
+        || env.MECHANIC_UPDATE_CHECK === "0") {
+        return false;
+    }
+    return !argv.some((arg) => arg === "--json" || arg.startsWith("--json="));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightward/mechanic-cli",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Develop, preview, diff, and publish Mechanic Shopify automation tasks from local files",
   "type": "module",
   "keywords": [