swallowkit 1.0.0-beta.55 → 1.0.0-beta.57

package/dist/core/verify/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Verify — 生成後の検証チェックを実行し、機械可読な結果を返す。
+ *
+ * 提供チェック:
+ * - structure:  プロジェクト構造規約 (validateProject)
+ * - drift:      生成物と現在状態の乖離 (detectDrift)
+ * - typecheck:  TypeScript 型チェック (tsc --noEmit / typecheck script)
+ * - build/lint/test: package.json scripts に同名 script がある場合のみ実行 (なければ skip)
+ * - custom:     swallowkit.config の verify.checks で定義されたプロジェクト固有チェック
+ *
+ * 既定実行セットは structure/drift/typecheck + custom。build/lint/test は --checks で明示指定。
+ */
+import { DriftFinding } from "../project/drift";
+import { ProjectViolation } from "../project/validation";
+import { CustomVerifyCheck } from "../../types";
+export type VerifyCheckStatus = "pass" | "fail" | "skip" | "error";
+export interface VerifyCheckEvidence {
+    command?: string;
+    exitCode?: number;
+    violations?: ProjectViolation[];
+    findings?: DriftFinding[];
+    logTail?: string[];
+}
+export interface VerifyCheckResult {
+    id: string;
+    title: string;
+    status: VerifyCheckStatus;
+    durationMs: number;
+    fixable: boolean;
+    evidence: VerifyCheckEvidence;
+    suggestedActions: string[];
+}
+export interface VerifySummary {
+    passed: number;
+    failed: number;
+    skipped: number;
+    errors: number;
+    /** true = すべてのチェックが pass または skip */
+    done: boolean;
+}
+export interface VerifyResult {
+    checks: VerifyCheckResult[];
+    summary: VerifySummary;
+    verifiedAt: string;
+}
+export declare const AVAILABLE_VERIFY_CHECKS: readonly ["structure", "drift", "typecheck", "build", "lint", "test"];
+export type VerifyCheckId = (typeof AVAILABLE_VERIFY_CHECKS)[number];
+/** 既定で実行される built-in チェック。build/lint/test は明示指定時のみ。 */
+export declare const DEFAULT_VERIFY_CHECKS: readonly ["structure", "drift", "typecheck"];
+/** swallowkit.config の verify.checks を projectRoot 基準で静かに読み込む。 */
+export declare function loadCustomVerifyChecks(projectRoot: string): CustomVerifyCheck[];
+export declare function runVerify(checkIds?: string[], projectRoot?: string): Promise<VerifyResult>;
+export interface FailureExplanation {
+    checkId: string;
+    title: string;
+    status: VerifyCheckStatus;
+    verifiedAt: string;
+    evidence: VerifyCheckEvidence;
+    suggestedActions: string[];
+}
+export declare function explainVerifyFailure(lastVerify: VerifyResult, checkId?: string): FailureExplanation[];
+//# sourceMappingURL=index.d.ts.map

package/dist/core/verify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/verify/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAe,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAmB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,uBAAuB,uEAAwE,CAAC;AAC7G,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,8CAA+C,CAAC;AAkNlF,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAoB/E;AAaD,wBAAsB,SAAS,CAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,YAAY,CAAC,CAiDvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,YAAY,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,kBAAkB,EAAE,CAmBtB"}

package/dist/core/verify/index.js

@@ -0,0 +1,343 @@
+"use strict";
+/**
+ * Verify — 生成後の検証チェックを実行し、機械可読な結果を返す。
+ *
+ * 提供チェック:
+ * - structure:  プロジェクト構造規約 (validateProject)
+ * - drift:      生成物と現在状態の乖離 (detectDrift)
+ * - typecheck:  TypeScript 型チェック (tsc --noEmit / typecheck script)
+ * - build/lint/test: package.json scripts に同名 script がある場合のみ実行 (なければ skip)
+ * - custom:     swallowkit.config の verify.checks で定義されたプロジェクト固有チェック
+ *
+ * 既定実行セットは structure/drift/typecheck + custom。build/lint/test は --checks で明示指定。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_VERIFY_CHECKS = exports.AVAILABLE_VERIFY_CHECKS = void 0;
+exports.loadCustomVerifyChecks = loadCustomVerifyChecks;
+exports.runVerify = runVerify;
+exports.explainVerifyFailure = explainVerifyFailure;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const config_1 = require("../config");
+const drift_1 = require("../project/drift");
+const state_1 = require("../project/state");
+const validation_1 = require("../project/validation");
+const package_manager_1 = require("../../utils/package-manager");
+exports.AVAILABLE_VERIFY_CHECKS = ["structure", "drift", "typecheck", "build", "lint", "test"];
+/** 既定で実行される built-in チェック。build/lint/test は明示指定時のみ。 */
+exports.DEFAULT_VERIFY_CHECKS = ["structure", "drift", "typecheck"];
+async function runStructureCheck(projectRoot) {
+    const startedAt = Date.now();
+    try {
+        const result = await (0, validation_1.validateProject)(projectRoot);
+        const errors = result.violations.filter((violation) => violation.severity === "error");
+        return {
+            id: "structure",
+            title: "Project structure conventions",
+            status: errors.length === 0 ? "pass" : "fail",
+            durationMs: Date.now() - startedAt,
+            fixable: true,
+            evidence: { violations: result.violations },
+            suggestedActions: errors.length === 0
+                ? []
+                : errors.map((violation) => violation.suggestedFix ?? violation.message),
+        };
+    }
+    catch (error) {
+        return {
+            id: "structure",
+            title: "Project structure conventions",
+            status: "error",
+            durationMs: Date.now() - startedAt,
+            fixable: false,
+            evidence: { logTail: [error instanceof Error ? error.message : String(error)] },
+            suggestedActions: ["Run this command inside a SwallowKit project root."],
+        };
+    }
+}
+async function runDriftCheck(projectRoot) {
+    const startedAt = Date.now();
+    try {
+        const result = await (0, drift_1.detectDrift)(projectRoot);
+        const errors = result.findings.filter((finding) => finding.severity === "error");
+        return {
+            id: "drift",
+            title: "Generated artifact drift",
+            status: errors.length === 0 ? "pass" : "fail",
+            durationMs: Date.now() - startedAt,
+            fixable: true,
+            evidence: { findings: result.findings },
+            suggestedActions: errors.map((finding) => finding.repairAction),
+        };
+    }
+    catch (error) {
+        return {
+            id: "drift",
+            title: "Generated artifact drift",
+            status: "error",
+            durationMs: Date.now() - startedAt,
+            fixable: false,
+            evidence: { logTail: [error instanceof Error ? error.message : String(error)] },
+            suggestedActions: [],
+        };
+    }
+}
+function tailLines(text, count) {
+    return text
+        .split(/\r?\n/)
+        .filter((line) => line.trim().length > 0)
+        .slice(-count);
+}
+function runCommandCheck(projectRoot, spec) {
+    const startedAt = Date.now();
+    const commandLabel = [spec.command, ...spec.args].join(" ").trim();
+    try {
+        const result = (0, child_process_1.spawnSync)(spec.command, spec.args, {
+            cwd: projectRoot,
+            shell: true,
+            encoding: "utf-8",
+            timeout: spec.timeoutMs ?? 5 * 60 * 1000,
+        });
+        const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
+        const exitCode = typeof result.status === "number" ? result.status : -1;
+        if (result.error) {
+            return {
+                id: spec.id,
+                title: spec.title,
+                status: "error",
+                durationMs: Date.now() - startedAt,
+                fixable: false,
+                evidence: { command: commandLabel, logTail: [result.error.message] },
+                suggestedActions: [`Ensure "${commandLabel}" can run in this project.`],
+            };
+        }
+        return {
+            id: spec.id,
+            title: spec.title,
+            status: exitCode === 0 ? "pass" : "fail",
+            durationMs: Date.now() - startedAt,
+            fixable: true,
+            evidence: {
+                command: commandLabel,
+                exitCode,
+                logTail: tailLines(output, 50),
+            },
+            suggestedActions: exitCode === 0 ? [] : [spec.failAction],
+        };
+    }
+    catch (error) {
+        return {
+            id: spec.id,
+            title: spec.title,
+            status: "error",
+            durationMs: Date.now() - startedAt,
+            fixable: false,
+            evidence: { command: commandLabel, logTail: [error instanceof Error ? error.message : String(error)] },
+            suggestedActions: [],
+        };
+    }
+}
+function readPackageScripts(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, "package.json");
+    if (!fs.existsSync(packageJsonPath))
+        return {};
+    try {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+        return pkg.scripts ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function runTypecheckCheck(projectRoot) {
+    const startedAt = Date.now();
+    if (!fs.existsSync(path.join(projectRoot, "tsconfig.json"))) {
+        return {
+            id: "typecheck",
+            title: "TypeScript type check",
+            status: "skip",
+            durationMs: Date.now() - startedAt,
+            fixable: false,
+            evidence: { logTail: ["tsconfig.json not found; skipping typecheck."] },
+            suggestedActions: [],
+        };
+    }
+    const scripts = readPackageScripts(projectRoot);
+    let command;
+    let args;
+    if (typeof scripts.typecheck === "string") {
+        const pm = (0, package_manager_1.detectFromProject)(projectRoot);
+        command = (0, package_manager_1.getCommands)(pm).name;
+        args = ["run", "typecheck"];
+    }
+    else {
+        command = "npx";
+        args = ["tsc", "--noEmit"];
+    }
+    return runCommandCheck(projectRoot, {
+        id: "typecheck",
+        title: "TypeScript type check",
+        command,
+        args,
+        failAction: "Fix the TypeScript errors listed in evidence.logTail, then re-run verify.",
+    });
+}
+const SCRIPT_CHECK_TITLES = {
+    build: "Project build",
+    lint: "Lint",
+    test: "Test suite",
+};
+function runScriptCheck(projectRoot, scriptName) {
+    const startedAt = Date.now();
+    const scripts = readPackageScripts(projectRoot);
+    const title = SCRIPT_CHECK_TITLES[scriptName];
+    if (typeof scripts[scriptName] !== "string") {
+        return {
+            id: scriptName,
+            title,
+            status: "skip",
+            durationMs: Date.now() - startedAt,
+            fixable: false,
+            evidence: { logTail: [`No "${scriptName}" script in package.json; skipping.`] },
+            suggestedActions: [],
+        };
+    }
+    const pm = (0, package_manager_1.detectFromProject)(projectRoot);
+    return runCommandCheck(projectRoot, {
+        id: scriptName,
+        title,
+        command: (0, package_manager_1.getCommands)(pm).name,
+        args: ["run", scriptName],
+        timeoutMs: 10 * 60 * 1000,
+        failAction: `Fix the ${scriptName} failures listed in evidence.logTail, then re-run verify.`,
+    });
+}
+const CUSTOM_CHECK_ID = /^[a-z][a-z0-9-]*$/;
+/** swallowkit.config の verify.checks を projectRoot 基準で静かに読み込む。 */
+function loadCustomVerifyChecks(projectRoot) {
+    const configNames = ["swallowkit.config.json", "swallowkit.config.js", ".swallowkitrc.json"];
+    for (const name of configNames) {
+        const configPath = path.join(projectRoot, name);
+        if (!fs.existsSync(configPath))
+            continue;
+        try {
+            const checks = (0, config_1.loadConfig)(configPath, false, true).verify?.checks ?? [];
+            return checks.filter((check) => typeof check?.id === "string" &&
+                CUSTOM_CHECK_ID.test(check.id) &&
+                !exports.AVAILABLE_VERIFY_CHECKS.includes(check.id) &&
+                typeof check.command === "string" &&
+                check.command.trim().length > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+function runCustomCheck(projectRoot, check) {
+    return runCommandCheck(projectRoot, {
+        id: check.id,
+        title: check.title ?? `Custom check: ${check.id}`,
+        command: check.command,
+        args: [],
+        timeoutMs: check.timeoutMs,
+        failAction: `Fix the failures reported by "${check.command}", then re-run verify.`,
+    });
+}
+async function runVerify(checkIds, projectRoot = process.cwd()) {
+    const customChecks = loadCustomVerifyChecks(projectRoot);
+    const customIds = customChecks.map((check) => check.id);
+    const availableIds = [...exports.AVAILABLE_VERIFY_CHECKS, ...customIds];
+    const requested = (checkIds && checkIds.length > 0
+        ? checkIds
+        : [...exports.DEFAULT_VERIFY_CHECKS, ...customIds]).map((id) => id.trim()).filter(Boolean);
+    const unknown = requested.filter((id) => !availableIds.includes(id));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown verify check(s): ${unknown.join(", ")}. Available checks: ${availableIds.join(", ")}`);
+    }
+    const checks = [];
+    for (const id of requested) {
+        if (id === "structure") {
+            checks.push(await runStructureCheck(projectRoot));
+        }
+        else if (id === "drift") {
+            checks.push(await runDriftCheck(projectRoot));
+        }
+        else if (id === "typecheck") {
+            checks.push(runTypecheckCheck(projectRoot));
+        }
+        else if (id === "build" || id === "lint" || id === "test") {
+            checks.push(runScriptCheck(projectRoot, id));
+        }
+        else {
+            const custom = customChecks.find((check) => check.id === id);
+            if (custom)
+                checks.push(runCustomCheck(projectRoot, custom));
+        }
+    }
+    const summary = {
+        passed: checks.filter((check) => check.status === "pass").length,
+        failed: checks.filter((check) => check.status === "fail").length,
+        skipped: checks.filter((check) => check.status === "skip").length,
+        errors: checks.filter((check) => check.status === "error").length,
+        done: checks.every((check) => check.status === "pass" || check.status === "skip"),
+    };
+    const result = {
+        checks,
+        summary,
+        verifiedAt: new Date().toISOString(),
+    };
+    (0, state_1.saveLastVerifyState)(result, projectRoot);
+    return result;
+}
+function explainVerifyFailure(lastVerify, checkId) {
+    const targets = checkId
+        ? lastVerify.checks.filter((check) => check.id === checkId)
+        : lastVerify.checks.filter((check) => check.status === "fail" || check.status === "error");
+    if (checkId && targets.length === 0) {
+        throw new Error(`Unknown check "${checkId}" in the last verify result. Available: ${lastVerify.checks.map((check) => check.id).join(", ")}`);
+    }
+    return targets.map((check) => ({
+        checkId: check.id,
+        title: check.title,
+        status: check.status,
+        verifiedAt: lastVerify.verifiedAt,
+        evidence: check.evidence,
+        suggestedActions: check.suggestedActions,
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/core/verify/index.js.map

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

package/dist/machine/contracts.d.ts

@@ -1,11 +1,19 @@
+export type MachineOperationStatus = "complete" | "in-progress" | "blocked" | "requires-human" | "unsafe" | "failed";
+export interface MachineNextAction {
+    command: string;
+    description: string;
+}
 export interface MachineSuccessResponse<TData> {
     ok: true;
     command: string;
+    status?: MachineOperationStatus;
+    nextActions?: MachineNextAction[];
     data: TData;
 }
 export interface MachineErrorResponse {
     ok: false;
     command: string;
+    status?: MachineOperationStatus;
     error: {
         code: string;
         message: string;

package/dist/machine/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/machine/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB,CAAC,KAAK;IAC3C,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,MAAM,eAAe,CAAC,KAAK,IAAI,sBAAsB,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/machine/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,aAAa,GACb,SAAS,GACT,gBAAgB,GAChB,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK;IAC3C,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,IAAI,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,MAAM,eAAe,CAAC,KAAK,IAAI,sBAAsB,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC"}

package/dist/machine/errors.d.ts

@@ -1,8 +1,11 @@
+import type { MachineOperationStatus } from "./contracts";
 export declare class MachineCommandError extends Error {
     readonly code: string;
     readonly details?: unknown;
-    constructor(code: string, message: string, details?: unknown);
+    readonly status?: MachineOperationStatus;
+    constructor(code: string, message: string, details?: unknown, status?: MachineOperationStatus);
 }
+export declare function resolveMachineErrorStatus(error: unknown): MachineOperationStatus;
 export declare function toMachineError(error: unknown): {
     code: string;
     message: string;

package/dist/machine/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/machine/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAM7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAqBnG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/machine/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;gBAE7B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,sBAAsB;CAO9F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAKhF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAqBnG"}

package/dist/machine/errors.js

@@ -1,16 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MachineCommandError = void 0;
+exports.resolveMachineErrorStatus = resolveMachineErrorStatus;
 exports.toMachineError = toMachineError;
 class MachineCommandError extends Error {
-    constructor(code, message, details) {
+    constructor(code, message, details, status) {
         super(message);
         this.name = "MachineCommandError";
         this.code = code;
         this.details = details;
+        this.status = status;
     }
 }
 exports.MachineCommandError = MachineCommandError;
+function resolveMachineErrorStatus(error) {
+    if (error instanceof MachineCommandError && error.status) {
+        return error.status;
+    }
+    return "failed";
+}
 function toMachineError(error) {
     if (error instanceof MachineCommandError) {
         return {

package/dist/machine/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/machine/errors.ts"],"names":[],"mappings":";;;AAYA,wCAqBC;AAjCD,MAAa,mBAAoB,SAAQ,KAAK;IAI5C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,kDAUC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/machine/errors.ts"],"names":[],"mappings":";;;AAgBA,8DAKC;AAED,wCAqBC;AA1CD,MAAa,mBAAoB,SAAQ,KAAK;IAK5C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB,EAAE,MAA+B;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAZD,kDAYC;AAED,SAAgB,yBAAyB,CAAC,KAAc;IACtD,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}

package/dist/machine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machine/index.ts"],"names":[],"mappings":"AAwJA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAExD;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machine/index.ts"],"names":[],"mappings":"AAmhBA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAExD;AAsBD,wBAAsB,aAAa,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ChF"}