swallowkit 2.0.0-alpha.5 → 2.0.0-alpha.7

package/dist/core/operations/provision-deployment.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_PROVISION_WAIT_SECONDS = exports.DEFAULT_PROVISION_WAIT_SECONDS = exports.DEPLOYMENT_QUERY = void 0;
+exports.extractAzureErrors = extractAzureErrors;
+exports.deploymentId = deploymentId;
+exports.queryAzureDeployment = queryAzureDeployment;
+exports.waitForAzureDeployment = waitForAzureDeployment;
+exports.queryDeploymentOperationErrors = queryDeploymentOperationErrors;
+const azure_cli_1 = require("../../utils/azure-cli");
+const azure_diagnostics_1 = require("../../utils/azure-diagnostics");
+exports.DEPLOYMENT_QUERY = "{id:id,name:name,state:properties.provisioningState,correlationId:properties.correlationId,templateHash:properties.templateHash,timestamp:properties.timestamp,error:properties.error}";
+exports.DEFAULT_PROVISION_WAIT_SECONDS = 300;
+exports.MAX_PROVISION_WAIT_SECONDS = 3600;
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function extractAzureErrors(value, secretValues = []) {
+    const result = [];
+    const visit = (entry, depth) => {
+        if (depth > 8 || result.length >= 20)
+            return;
+        if (typeof entry === "string") {
+            try {
+                visit(JSON.parse(entry), depth + 1);
+            }
+            catch { /* Only structured Azure errors are projected. */ }
+            return;
+        }
+        const item = record(entry);
+        if (!item)
+            return;
+        if (typeof item.code === "string" && typeof item.message === "string") {
+            result.push({ code: (0, azure_diagnostics_1.redactAzureText)(item.code, secretValues).slice(0, 200), message: (0, azure_diagnostics_1.redactAzureText)(item.message, secretValues).slice(0, 2000) });
+        }
+        if (item.error)
+            visit(item.error, depth + 1);
+        if (Array.isArray(item.details))
+            item.details.forEach((detail) => visit(detail, depth + 1));
+    };
+    visit(value, 0);
+    return result;
+}
+function deploymentId(reference) {
+    return reference.id ?? `/subscriptions/${reference.subscription}/resourceGroups/${reference.resourceGroup}/providers/Microsoft.Resources/deployments/${reference.name}`;
+}
+async function queryAzureDeployment(reference, options = {}) {
+    const result = await (0, azure_cli_1.runAzCliAsync)([
+        "deployment", "group", "show", "--name", reference.name,
+        "--resource-group", reference.resourceGroup, "--subscription", reference.subscription,
+        "--query", exports.DEPLOYMENT_QUERY, "-o", "json",
+    ], { timeout: options.timeoutMs ?? 30000, signal: options.signal });
+    const diagnostic = (0, azure_diagnostics_1.azureCliDiagnostic)(result, "deployment-state", options.secretValues);
+    const unknown = (reason) => ({
+        state: "unknown", reference, reason, errors: [], diagnostic,
+    });
+    if (result.status !== 0 || result.failureKind) {
+        if (result.failureKind === "cancelled")
+            return unknown("cancelled");
+        return unknown(/DeploymentNotFound|ResourceGroupNotFound/i.test(`${result.stderr}\n${result.stdout}`) ? "not-found" : "query-failed");
+    }
+    if (result.stdoutTruncated)
+        return unknown("invalid-response");
+    let parsed;
+    try {
+        parsed = record(JSON.parse(result.stdout));
+    }
+    catch {
+        return unknown("invalid-response");
+    }
+    if (!parsed || typeof parsed.id !== "string" || typeof parsed.state !== "string" || typeof parsed.correlationId !== "string") {
+        return unknown("invalid-response");
+    }
+    if (parsed.id.toLowerCase() !== deploymentId(reference).toLowerCase()
+        || (reference.correlationId && parsed.correlationId !== reference.correlationId)
+        || (reference.templateHash && parsed.templateHash !== reference.templateHash)) {
+        return unknown("identity-changed");
+    }
+    if (reference.previousCorrelationId && parsed.correlationId === reference.previousCorrelationId) {
+        return unknown("not-yet-observed");
+    }
+    const states = {
+        accepted: "Accepted", running: "Running", creating: "Running", updating: "Running",
+        succeeded: "Succeeded", failed: "Failed", canceled: "Canceled", cancelled: "Canceled",
+    };
+    const state = states[parsed.state.toLowerCase()];
+    if (!state)
+        return unknown("invalid-response");
+    return {
+        state,
+        reference: {
+            ...reference,
+            id: parsed.id,
+            correlationId: parsed.correlationId,
+            ...(typeof parsed.templateHash === "string" ? { templateHash: parsed.templateHash } : {}),
+        },
+        errors: extractAzureErrors(parsed.error, options.secretValues),
+        diagnostic,
+    };
+}
+async function waitForAzureDeployment(reference, options) {
+    let observation;
+    do {
+        const remaining = options.deadline - Date.now();
+        // Even when the wait budget is exhausted, one bounded read can identify an accepted submission.
+        observation = await queryAzureDeployment(reference, {
+            timeoutMs: remaining > 0 ? Math.min(options.queryTimeoutMs ?? 30000, remaining) : options.queryTimeoutMs ?? 30000,
+            signal: options.signal,
+            secretValues: options.secretValues,
+        });
+        if (observation.state !== "unknown")
+            reference = observation.reference;
+        options.onObservation?.(observation);
+        if (observation.state === "Succeeded" || observation.state === "Failed" || observation.state === "Canceled")
+            return observation;
+        if (observation.state === "unknown" && observation.reason !== "not-yet-observed" && observation.reason !== "not-found")
+            return observation;
+        if (Date.now() >= options.deadline || options.signal?.aborted)
+            return observation;
+        await new Promise((resolve) => {
+            const done = () => {
+                clearTimeout(timer);
+                options.signal?.removeEventListener("abort", done);
+                resolve();
+            };
+            const timer = setTimeout(done, Math.min(options.pollIntervalMs ?? 5000, Math.max(options.deadline - Date.now(), 0)));
+            options.signal?.addEventListener("abort", done, { once: true });
+            if (options.signal?.aborted)
+                done();
+        });
+    } while (!options.signal?.aborted);
+    return observation;
+}
+async function queryDeploymentOperationErrors(reference, secretValues = [], signal) {
+    const result = await (0, azure_cli_1.runAzCliAsync)([
+        "deployment", "operation", "group", "list",
+        "--resource-group", reference.resourceGroup, "--name", reference.name, "--subscription", reference.subscription,
+        "--query", "[?properties.provisioningState=='Failed' || properties.provisioningState=='Canceled'].{error:properties.statusMessage}",
+        "-o", "json",
+    ], { timeout: 30000, signal });
+    const errors = [];
+    if (result.status === 0 && !result.failureKind && !result.stdoutTruncated) {
+        try {
+            const parsed = JSON.parse(result.stdout);
+            if (Array.isArray(parsed))
+                parsed.slice(0, 20).forEach((item) => errors.push(...extractAzureErrors(item, secretValues)));
+        }
+        catch { /* The separate diagnostic explicitly records an unreadable operations response. */ }
+    }
+    return { errors: errors.slice(0, 20), diagnostic: (0, azure_diagnostics_1.azureCliDiagnostic)(result, "deployment-operations", secretValues) };
+}
+//# sourceMappingURL=provision-deployment.js.map

package/dist/core/operations/provision-deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision-deployment.js","sourceRoot":"","sources":["../../../src/core/operations/provision-deployment.ts"],"names":[],"mappings":";;;AAmCA,gDAkBC;AAED,oCAEC;AAED,oDAgDC;AAED,wDAqCC;AAED,wEAkBC;AAtKD,qDAAsD;AACtD,qEAAwG;AAE3F,QAAA,gBAAgB,GAAG,wLAAwL,CAAC;AAC5M,QAAA,8BAA8B,GAAG,GAAG,CAAC;AACrC,QAAA,0BAA0B,GAAG,IAAK,CAAC;AA0BhD,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,IAAI,CAAC;AACxH,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc,EAAE,eAAkC,EAAE;IACrF,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,KAAa,EAAE,EAAE;QAC9C,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,iDAAiD,CAAC,CAAC;YACxG,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAA,mCAAe,EAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAA,mCAAe,EAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAK,CAAC,EAAE,CAAC,CAAC;QACtJ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC,CAAC;IACF,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,YAAY,CAAC,SAA8B;IACzD,OAAO,SAAS,CAAC,EAAE,IAAI,kBAAkB,SAAS,CAAC,YAAY,mBAAmB,SAAS,CAAC,aAAa,8CAA8C,SAAS,CAAC,IAAI,EAAE,CAAC;AAC1K,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,SAA8B,EAC9B,UAA0F,EAAE;IAE5F,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAa,EAAC;QACjC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI;QACvD,kBAAkB,EAAE,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE,SAAS,CAAC,YAAY;QACrF,SAAS,EAAE,wBAAgB,EAAE,IAAI,EAAE,MAAM;KAC1C,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,KAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAA,sCAAkB,EAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,CAAC,MAAuC,EAAyB,EAAE,CAAC,CAAC;QACnF,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU;KAC5D,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW;YAAE,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,OAAO,OAAO,CAAC,2CAA2C,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IACxI,CAAC;IACD,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/D,IAAI,MAAsC,CAAC;IAC3C,IAAI,CAAC;QAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAAC,CAAC;IACjG,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC7H,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;WAChE,CAAC,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,aAAa,CAAC;WAC7E,CAAC,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAChF,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,SAAS,CAAC,qBAAqB,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,qBAAqB,EAAE,CAAC;QAChG,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,MAAM,GAAmD;QAC7D,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS;QAClF,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU;KACtF,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK;QACL,SAAS,EAAE;YACT,GAAG,SAAS;YACZ,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,GAAG,CAAC,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1F;QACD,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC;QAC9D,UAAU;KACX,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,SAA8B,EAC9B,OAOC;IAED,IAAI,WAAkC,CAAC;IACvC,GAAG,CAAC;QACF,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAChD,gGAAgG;QAChG,WAAW,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE;YAClD,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,KAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,KAAM;YACnH,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QACH,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACvE,OAAO,CAAC,aAAa,EAAE,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,WAAW,CAAC,KAAK,KAAK,WAAW,IAAI,WAAW,CAAC,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO,WAAW,CAAC;QAChI,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,KAAK,kBAAkB,IAAI,WAAW,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QAC3I,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO,WAAW,CAAC;QAClF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACnD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,IAAK,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACtH,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,IAAI,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;IACnC,OAAO,WAAW,CAAC;AACrB,CAAC;AAEM,KAAK,UAAU,8BAA8B,CAAC,SAA8B,EAAE,eAAkC,EAAE,EAAE,MAAoB;IAI7I,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAa,EAAC;QACjC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;QAC1C,kBAAkB,EAAE,SAAS,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,CAAC,YAAY;QAC/G,SAAS,EAAE,wHAAwH;QACnI,IAAI,EAAE,MAAM;KACb,EAAE,EAAE,OAAO,EAAE,KAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC1E,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3H,CAAC;QAAC,MAAM,CAAC,CAAC,mFAAmF,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,IAAA,sCAAkB,EAAC,MAAM,EAAE,uBAAuB,EAAE,YAAY,CAAC,EAAE,CAAC;AACxH,CAAC"}

package/dist/core/operations/provision-operations.d.ts

@@ -1,14 +1,15 @@
 /**
  * Plan / Apply Provision — Azure プロビジョニングの事前計画と承認付き実行。
  *
- * - plan provision: ローカルの決定論的プリフライト(Bicep 解析・az CLI 有無)のみ。
- *   ネットワークアクセスや az login を必要とする操作は行わない。
- *   --what-if を明示した場合のみ az deployment group what-if を実行する。
+ * - plan provision: Bicep と Azure の現在の状態を確認する。リソースは変更しない。
  * - apply provision: 常に承認(--approve)必須。承認なしでは requires-human で停止する。
  * - 対話的な `swallowkit provision` は同じ計画をメモリ上で作成・表示し、確認後に
  *   executeProvisionPlan で同じ安全確認を経て実行する(計画ファイルは保存しない)。
  */
+import { AzureCliDiagnostic } from "../../utils/azure-diagnostics";
+import type { MachineNextAction, MachineOperationStatus } from "../../machine/contracts";
 import { InfraInspection } from "../project/infra";
+import { DeploymentObservation, DeploymentReference } from "./provision-deployment";
 import { MigrationManifest, MigrationState, ResolvedMigration } from "../project/migrations";
 export interface PlanProvisionOptions {
     resourceGroup: string;
@@ -20,8 +21,10 @@ export interface PlanProvisionOptions {
     adoptExisting?: boolean;
     baseline?: number;
     reconcile?: boolean;
+    /** Attach an existing, matching baseline deployment without submitting Bicep again. */
+    resumeDeployment?: string;
 }
-export type ProvisionMode = "offline" | "bootstrap" | "adoption-required" | "adopt" | "migrate" | "noop" | "reconcile";
+export type ProvisionMode = "offline" | "bootstrap" | "adoption-required" | "adopt" | "migrate" | "noop" | "reconcile" | "recover";
 interface ProvisionCommand {
     file: "az";
     args: string[];
@@ -53,6 +56,7 @@ export interface ProvisionPlanData {
     requiresApproval: true;
     fingerprints: Record<string, string | null>;
     baselineSnapshotChecksum?: string;
+    recoveryDeployment?: DeploymentReference;
 }
 /**
  * Builds the provision plan. Machine/MCP callers persist it for a later `apply provision --plan`;
@@ -64,17 +68,44 @@ export declare function planProvisionOperation(options: PlanProvisionOptions, pl
 export interface ApplyProvisionOptions {
     planId: string;
     approve?: boolean;
+    waitSeconds?: number;
 }
 export interface ApplyProvisionResult {
+    status: MachineOperationStatus;
+    outcome: "succeeded" | "in-progress" | "unknown" | "partial" | "failed";
+    runId: string;
     planId: string;
     resourceGroup: string;
     location: string;
     swaLocation: string;
     executedCommands: string[];
-    deploymentOutputs?: Record<string, unknown>;
     warnings: string[];
+    diagnostics: AzureCliDiagnostic[];
+    deployment?: DeploymentObservation;
+    nextActions: MachineNextAction[];
+    interrupted?: NodeJS.Signals;
+}
+export interface ProvisionRun {
+    schemaVersion: 1;
+    runId: string;
+    projectRoot: string;
+    plan: ProvisionPlanData;
+    cursor: number;
+    attemptedIndex?: number;
+    deployment?: DeploymentReference;
+    observation?: DeploymentObservation;
+    outcome: ApplyProvisionResult["outcome"];
+    executedCommands: string[];
+    warnings: string[];
+    diagnostics: AzureCliDiagnostic[];
+    updatedAt: string;
 }
 export declare const INTERACTIVE_PROVISION_RETRY_HINT = "Run \"swallowkit provision\" again to review the current state.";
+export declare function provisionNextActions(runId: string): MachineNextAction[];
+export declare function inspectProvisionOperation(options: {
+    planId: string;
+    waitSeconds?: number;
+}): Promise<ApplyProvisionResult>;
 export declare function applyProvisionOperation(options: ApplyProvisionOptions): Promise<ApplyProvisionResult>;
 /**
  * Runs an approved provision plan with every safety check: local files and Azure state must still
@@ -84,6 +115,9 @@ export declare function executeProvisionPlan(plan: ProvisionPlanData, options?:
     approve?: boolean;
     retryHint?: string;
     projectRoot?: string;
+    waitSeconds?: number;
+    signal?: AbortSignal;
+    pollIntervalMs?: number;
 }): Promise<ApplyProvisionResult>;
 export {};
 //# sourceMappingURL=provision-operations.d.ts.map

package/dist/core/operations/provision-operations.d.ts.map

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