@12ui/design 0.2.69 → 0.2.71

package/SKILL.md

@@ -28,7 +28,7 @@ dispatch paid work when it is absent, rejected, or times out.
 Use `12ui` when it is available on `PATH`. Otherwise invoke the pinned CLI that
 the plugin's `open-design.json` MCP entry uses:
 
-    npx -y @12ui/design@0.2.69 <command> ...
+    npx -y @12ui/design@0.2.71 <command> ...
 
 Run `12ui auth status --json` (or its pinned `npx` equivalent) before the paid
 preflight. A desktop user can authenticate with `12ui auth login`; a headless

package/dist/cli-conversion-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-conversion-engine.d.ts","sourceRoot":"","sources":["../src/cli-conversion-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI/D,eAAO,MAAM,sBAAsB,aAAyI,CAAC;AAC7K,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,EAAE,OAAO,QAAQ,KAAG,MAAoI,CAAC;AAChN,gGAAgG;AAChG,wBAAsB,sBAAsB,CAAC,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,EAAE;IAAC,MAAM,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,QAAQ,CAAC;IAAA,MAAM,CAAC,EAAC,MAAM,CAAA;CAAC,sDAShH;AACD,wBAAgB,wBAAwB,CAAC,KAAK,EAAC,QAAQ,GAAG,IAAI,CAG7D"}
+{"version":3,"file":"cli-conversion-engine.d.ts","sourceRoot":"","sources":["../src/cli-conversion-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI/D,eAAO,MAAM,sBAAsB,aAAyI,CAAC;AAC7K,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,EAAE,OAAO,QAAQ,KAAG,MAAoI,CAAC;AAChN,gGAAgG;AAChG,wBAAsB,sBAAsB,CAAC,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,EAAE;IAAC,MAAM,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,QAAQ,CAAC;IAAA,MAAM,CAAC,EAAC,MAAM,CAAA;CAAC,sDAmBhH;AACD,wBAAgB,wBAAwB,CAAC,KAAK,EAAC,QAAQ,GAAG,IAAI,CAG7D"}

package/dist/cli-conversion-engine.js

@@ -11,8 +11,18 @@ export async function chooseConversionEngine({ source, flags, runDir }) {
     const directory = runDir ?? localConversionDirectory(source, flags);
     const saved = await readLocalRecord(directory);
     const hosted = !saved && await stat(path.join(directory, 'journal.jsonl')).catch(() => null);
-    const image = /\.(png|jpe?g|webp)$/iu.test(source) && (await stat(source).catch(() => null))?.isFile();
-    const supported = Boolean(image && stringFlag(flags, 'output') === 'html' && Object.keys(flags).every(key => LOCAL_CONVERSION_FLAGS.has(key)));
+    const requested = stringFlag(flags, 'engine') ?? process.env.TWELVE_UI_ENGINE ?? 'auto';
+    const unsupported = Object.keys(flags).filter(key => !LOCAL_CONVERSION_FLAGS.has(key));
+    if (!saved && !hosted && requested === 'codex' && unsupported.length) {
+        throw new CliRefusal(`${unsupported.map(key => '--' + key).join(', ')} cannot be used with the Codex conversion engine. Remove these options for local HTML. Local work is identified by its saved run directory; recover it with 12ui resume <local-run-dir>.`, 'engine_unsupported');
+    }
+    const imagePath = /\.(png|jpe?g|webp)$/iu.test(source);
+    const image = imagePath && (await stat(source).catch(() => null))?.isFile();
+    const localOptions = stringFlag(flags, 'output') === 'html' && unsupported.length === 0;
+    if (!saved && !hosted && imagePath && !image && localOptions && ['auto', 'codex'].includes(requested)) {
+        throw new CliRefusal(`Source image is missing or is not a readable regular file: ${path.resolve(source)}`, 'conversion_source_invalid');
+    }
+    const supported = Boolean(image && localOptions);
     const selection = await selectEngine(flags, supported, saved ? 'codex' : hosted ? 'api' : undefined);
     if (selection.engine === 'api')
         assertApiConversionFlags(flags);

package/dist/cli-conversion-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-conversion-engine.js","sourceRoot":"","sources":["../src/cli-conversion-engine.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAiB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAC,WAAW,EAAC,YAAY,EAAC,QAAQ,EAAC,SAAS,EAAC,eAAe,EAAC,cAAc,EAAC,YAAY,EAAC,WAAW,EAAC,MAAM,EAAC,OAAO,CAAC,CAAC,CAAC;AAC7K,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAE,KAAe,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAC,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,GAAC,OAAO,CAAC,CAAC,CAAC;AAChN,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAgD;IAChH,MAAM,SAAS,GAAC,MAAM,IAAI,wBAAwB,CAAC,MAAM,EAAC,KAAK,CAAC,CAAC;IACjE,MAAM,KAAK,GAAC,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAC,CAAC,KAAK,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,GAAE,EAAE,CAAA,IAAI,CAAC,CAAC;IACxF,MAAM,KAAK,GAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAE,EAAE,CAAA,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACnG,MAAM,SAAS,GAAC,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,EAAC,QAAQ,CAAC,KAAG,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA,EAAE,CAAA,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxI,MAAM,SAAS,GAAC,MAAM,YAAY,CAAC,KAAK,EAAC,SAAS,EAAC,KAAK,CAAA,CAAC,CAAA,OAAO,CAAA,CAAC,CAAA,MAAM,CAAA,CAAC,CAAA,KAAK,CAAA,CAAC,CAAA,SAAS,CAAC,CAAC;IACzF,IAAG,SAAS,CAAC,MAAM,KAAG,KAAK;QAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC;AAClB,CAAC;AACD,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACtD,MAAM,WAAW,GAAC,CAAC,eAAe,EAAC,cAAc,EAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA,EAAE,CAAA,KAAK,CAAC,GAAG,CAAC,KAAG,SAAS,CAAC,CAAC;IACnG,IAAG,WAAW,CAAC,MAAM;QAAC,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAA,EAAE,CAAA,IAAI,GAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,yGAAyG,EAAC,iBAAiB,CAAC,CAAC;AACrN,CAAC"}
+{"version":3,"file":"cli-conversion-engine.js","sourceRoot":"","sources":["../src/cli-conversion-engine.ts"],"names":[],"mappings":"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"}

package/dist/cli-conversion-recovery-advice.d.ts

@@ -0,0 +1,35 @@
+import { type ConversionOperation, type TwelveUiConversionClient, type TerminalConversionStatus } from './conversion-client.js';
+import type { TerminalArtifactReport } from './cli-progress.js';
+import { type ObservedConversionStatus } from './conversion-status-contract.js';
+export declare const terminalConversionOperation: (error: unknown) => (ConversionOperation & {
+    status: TerminalConversionStatus;
+}) | null;
+export declare const terminalConversionStatus: (error: unknown) => TerminalConversionStatus | null;
+export declare const conversionRecoveryAdvice: (args: {
+    conversionId: string;
+    terminalStatus: TerminalConversionStatus | null;
+    resumeCommand: string;
+}) => string;
+export type LinkedExportRecoveryState = {
+    id: string;
+    status: ObservedConversionStatus;
+    readError?: string;
+};
+export declare const describeTerminalRecovery: (args: {
+    client: Pick<TwelveUiConversionClient, "getConversion">;
+    error: unknown;
+    conversionId: string;
+    fallbackExportId?: string;
+    resumeCommand: string;
+    parentArtifact?: Pick<TerminalArtifactReport, "name" | "path">;
+    linkedArtifact?: Pick<TerminalArtifactReport, "name" | "path">;
+}) => Promise<{
+    terminalOperation: (ConversionOperation & {
+        status: TerminalConversionStatus;
+    }) | null;
+    terminalStatus: TerminalConversionStatus | null;
+    linkedExport?: LinkedExportRecoveryState;
+    artifacts?: TerminalArtifactReport[];
+    next: string;
+}>;
+//# sourceMappingURL=cli-conversion-recovery-advice.d.ts.map

package/dist/cli-conversion-recovery-advice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-conversion-recovery-advice.d.ts","sourceRoot":"","sources":["../src/cli-conversion-recovery-advice.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAEzC,eAAO,MAAM,2BAA2B,GACtC,OAAO,OAAO,KACb,CAAC,mBAAmB,GAAG;IAAE,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC,GAAG,IAEjE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,wBAAwB,GAAG,IAEpF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB,KAAG,MASH,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,eAAe,CAAC,CAAC;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/D,cAAc,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAChE,KAAG,OAAO,CAAC;IACV,iBAAiB,EAAE,CAAC,mBAAmB,GAAG;QAAE,MAAM,EAAE,wBAAwB,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACvF,cAAc,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAwDA,CAAC"}

package/dist/cli-conversion-recovery-advice.js

@@ -0,0 +1,72 @@
+import { ConversionTerminalError, } from './conversion-client.js';
+import { readConversionStatusObservation, } from './conversion-status-contract.js';
+export const terminalConversionOperation = (error) => (error instanceof ConversionTerminalError ? error.operation : null);
+export const terminalConversionStatus = (error) => (terminalConversionOperation(error)?.status ?? null);
+export const conversionRecoveryAdvice = (args) => {
+    if (args.terminalStatus === 'failed') {
+        return `contact 12ui support with conversion ID ${args.conversionId};`
+            + ' resume only collects a purchase and cannot restart a terminal failure';
+    }
+    if (args.terminalStatus === 'expired') {
+        return `conversion ${args.conversionId} has expired; start a new conversion if you still need the result`;
+    }
+    return `${args.resumeCommand}; collection is free until the purchase expires`;
+};
+export const describeTerminalRecovery = async (args) => {
+    const terminalOperation = terminalConversionOperation(args.error);
+    const terminalStatus = terminalOperation?.status ?? null;
+    let linkedExport;
+    if (terminalOperation && terminalOperation.id === args.conversionId) {
+        const exportId = terminalOperation.export?.conversion_id ?? args.fallbackExportId;
+        if (exportId) {
+            const observation = await readConversionStatusObservation(args.client, exportId);
+            linkedExport = {
+                id: exportId,
+                status: observation.status,
+                ...(observation.readError ? { readError: observation.readError.message } : {}),
+            };
+        }
+    }
+    let next = conversionRecoveryAdvice({
+        conversionId: terminalOperation?.id ?? args.conversionId,
+        terminalStatus,
+        resumeCommand: args.resumeCommand,
+    });
+    if (linkedExport) {
+        if (linkedExport.status === 'succeeded' || linkedExport.status === 'queued' || linkedExport.status === 'running') {
+            next += `; linked responsive export ${linkedExport.id} is ${linkedExport.status}`
+                + `; collect it with 12ui resume ${linkedExport.id} --output html --out ${args.linkedArtifact?.path ?? '<file>'}`;
+        }
+        else if (linkedExport.status === 'unknown') {
+            next += `; linked responsive export ${linkedExport.id} could not be read, so its state is unknown`;
+        }
+        else {
+            next += `; linked responsive export ${linkedExport.id} is ${linkedExport.status}`;
+        }
+    }
+    const artifacts = terminalOperation && terminalOperation.id === args.conversionId && args.parentArtifact
+        ? [
+            { ...args.parentArtifact, state: terminalOperation.status },
+            ...(args.linkedArtifact
+                ? [{
+                        ...args.linkedArtifact,
+                        name: args.linkedArtifact.name ?? 'responsive html',
+                        state: !linkedExport || linkedExport.status === 'unknown'
+                            ? 'unknown — linked export was not read'
+                            : ['succeeded', 'queued', 'running'].includes(linkedExport.status)
+                                ? `${linkedExport.status} — not collected`
+                                : linkedExport.status,
+                        ...(linkedExport?.readError ? { note: linkedExport.readError } : {}),
+                    }]
+                : []),
+        ]
+        : undefined;
+    return {
+        terminalOperation,
+        terminalStatus,
+        ...(linkedExport ? { linkedExport } : {}),
+        ...(artifacts ? { artifacts } : {}),
+        next,
+    };
+};
+//# sourceMappingURL=cli-conversion-recovery-advice.js.map

package/dist/cli-conversion-recovery-advice.js.map

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

package/dist/cli-convert-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-convert-command.d.ts","sourceRoot":"","sources":["../src/cli-convert-command.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AA8B5E,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;GAIG;AAEH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAOxD,CAAC;AAqHF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,MAIpD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,wBAAwB,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,KAAG,MAYH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,KAAG,MAMH,CAAC;AAsLF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,QAAQ,EACf,SAAS,eAAe,EACxB,eAAc;IACZ,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,KACL,OAAO,CAAC,IAAI,CA8qBd,CAAC"}
+{"version":3,"file":"cli-convert-command.d.ts","sourceRoot":"","sources":["../src/cli-convert-command.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAmC5E,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;GAIG;AAEH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAOxD,CAAC;AAqHF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,MAIpD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,wBAAwB,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,KAAG,MAYH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,KAAG,MAMH,CAAC;AAyLF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,QAAQ,EACf,SAAS,eAAe,EACxB,eAAc;IACZ,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,KACL,OAAO,CAAC,IAAI,CA2xBd,CAAC"}

package/dist/cli-convert-command.js

@@ -8,7 +8,8 @@ import { runConversionDerivation } from './cli-conversion-derivation.js';
 import { CONVERSION_DURATION_HINTS, createLongRunningProgress, } from './cli-progress.js';
 import { refuseUsage, usage, usageRefusal } from './cli-usage.js';
 import { readConversionConfig } from './config.js';
-import { TwelveUiConversionClient, } from './conversion-client.js';
+import { TwelveUiConversionClient, ConversionTerminalError, } from './conversion-client.js';
+import { conversionRecoveryAdvice, describeTerminalRecovery, } from './cli-conversion-recovery-advice.js';
 import { isConversionModel } from './conversion-models.js';
 import { isCliConversionOutput, } from './conversion-outputs.js';
 import { recordConvertedImageReceipt } from './conversion-receipt.js';
@@ -201,10 +202,13 @@ const outputPathForRecovery = async (artifact, overrideDirectory) => prepareOutp
     : artifact.outFile);
 const completedOperation = async (args) => {
     const current = await args.client.getConversion(args.id);
-    if (current.status === 'succeeded') {
+    if (current.status === 'succeeded' || current.responsive_alternative) {
         args.onProgress?.(current);
         return current;
     }
+    if (current.status === 'failed' || current.status === 'expired') {
+        throw new ConversionTerminalError({ ...current, status: current.status });
+    }
     return await args.client.waitForConversion(current.id, {
         expiresAt: current.expires_at,
         ...(args.timeoutMs === undefined ? {} : { timeoutMs: args.timeoutMs }),
@@ -431,9 +435,19 @@ export const runConversionCommand = async (command, flags, journal, dependencies
                 });
             }
             catch (error) {
-                progress.finish('stopped', {
+                const recoveryReport = await describeTerminalRecovery({
+                    client, error, conversionId,
+                    resumeCommand: `re-run 12ui resume ${conversionId}`,
+                    parentArtifact: { name: recovery.conversion.output, path: shownPath(recovery.conversion.outFile) },
+                    ...(recovery.linkedExport ? {
+                        fallbackExportId: recovery.linkedExport.conversionId,
+                        linkedArtifact: { name: 'responsive html', path: shownPath(recovery.linkedExport.outFile) },
+                    } : {}),
+                });
+                progress.finish(recoveryReport.terminalStatus ? 'failed' : 'stopped', {
                     detail: error instanceof Error ? error.message : String(error),
-                    next: `re-run 12ui resume ${conversionId}; collection is free until the purchase expires`,
+                    artifacts: recoveryReport.artifacts,
+                    next: recoveryReport.next,
                 });
                 throw error;
             }
@@ -475,6 +489,11 @@ export const runConversionCommand = async (command, flags, journal, dependencies
         const current = await client.getConversion(conversionId).catch((error) => {
             progress.finish('stopped', {
                 detail: error instanceof Error ? error.message : String(error),
+                next: conversionRecoveryAdvice({
+                    conversionId,
+                    terminalStatus: null,
+                    resumeCommand: `re-run 12ui resume ${conversionId} --output ${requestedOutput} --out ${resolvedOutFile}`,
+                }),
             });
             throw error;
         });
@@ -492,10 +511,13 @@ export const runConversionCommand = async (command, flags, journal, dependencies
         }
         let completed;
         try {
-            if (current.status === 'succeeded') {
+            if (current.status === 'succeeded' || current.responsive_alternative) {
                 reportConversion(progress, current, `collecting ${requestedOutput}`);
                 completed = current;
             }
+            else if (current.status === 'failed' || current.status === 'expired') {
+                throw new ConversionTerminalError({ ...current, status: current.status });
+            }
             else {
                 completed = await client.waitForConversion(current.id, {
                     expiresAt: current.expires_at,
@@ -504,20 +526,47 @@ export const runConversionCommand = async (command, flags, journal, dependencies
                 });
             }
         }
+        catch (error) {
+            const savedLinkedExport = current.export
+                ? (await readConversionRecovery(conversionId))?.linkedExport
+                : undefined;
+            const recoveryReport = await describeTerminalRecovery({
+                client, error, conversionId,
+                resumeCommand: `re-run 12ui resume ${conversionId} --output ${requestedOutput} --out ${resolvedOutFile}`,
+                parentArtifact: { name: current.output, path: resolvedOutFile },
+                ...(current.export ? {
+                    fallbackExportId: current.export.conversion_id,
+                    linkedArtifact: { name: 'responsive html', ...(savedLinkedExport ? { path: savedLinkedExport.outFile } : {}) },
+                } : {}),
+            });
+            progress.finish(recoveryReport.terminalStatus ? 'failed' : 'stopped', {
+                detail: error instanceof Error ? error.message : String(error),
+                artifacts: recoveryReport.artifacts,
+                next: recoveryReport.next,
+            });
+            throw error;
+        }
+        let downloaded;
+        try {
+            downloaded = await downloadCompletedConversion({
+                client,
+                operation: completed,
+                output: requestedOutput,
+                outFile: resolvedOutFile,
+            });
+        }
         catch (error) {
             progress.finish('stopped', {
                 detail: error instanceof Error ? error.message : String(error),
-                next: `re-run 12ui resume ${conversionId} --output ${requestedOutput} --out ${resolvedOutFile};`
-                    + ' collection is free until the purchase expires',
+                artifacts: [{ name: requestedOutput, state: 'succeeded — not collected', path: resolvedOutFile }],
+                next: conversionRecoveryAdvice({
+                    conversionId,
+                    terminalStatus: null,
+                    resumeCommand: `re-run 12ui resume ${conversionId} --output ${requestedOutput} --out ${resolvedOutFile}`,
+                }),
             });
             throw error;
         }
-        const downloaded = await downloadCompletedConversion({
-            client,
-            operation: completed,
-            output: requestedOutput,
-            outFile: resolvedOutFile,
-        });
         journal.note({ runId: completed.id, artifacts: [resolvedOutFile] });
         let linkedExport;
         if (completed.output === 'layerdoc' && completed.export?.conversion_id) {
@@ -749,10 +798,14 @@ export const runConversionCommand = async (command, flags, journal, dependencies
         : ''}`);
     let operation;
     try {
-        if (created.status === 'succeeded') {
+        if (created.status === 'succeeded' || created.responsive_alternative) {
             reportConversion(progress, created);
             operation = created;
         }
+        else if (created.status === 'failed' || created.status === 'expired') {
+            reportConversion(progress, created);
+            throw new ConversionTerminalError({ ...created, status: created.status });
+        }
         else {
             operation = await client.waitForConversion(created.id, {
                 expiresAt: created.expires_at,
@@ -763,17 +816,23 @@ export const runConversionCommand = async (command, flags, journal, dependencies
     }
     catch (error) {
         const detail = error instanceof Error ? error.message : String(error);
-        progress.finish('stopped', {
-            detail: `conversion ${created.id} did not settle: ${detail}`,
-            ...(exportOperationId && exportOutFile
-                ? {
-                    artifacts: [
-                        { name: output, state: 'not collected' },
-                        { name: 'responsive html', state: 'unknown — the linked export was not read' },
-                    ],
-                    next: `12ui resume ${created.id} recovers both halves without re-buying`,
-                }
-                : { next: `12ui resume ${created.id} recovers the purchase without re-buying` }),
+        const recoveryReport = await describeTerminalRecovery({
+            client, error, conversionId: created.id,
+            resumeCommand: exportOperationId
+                ? `12ui resume ${created.id} recovers both halves without re-buying`
+                : `12ui resume ${created.id} recovers the purchase without re-buying`,
+            parentArtifact: { name: output, path: outFile },
+            ...(exportOperationId && exportOutFile ? {
+                fallbackExportId: exportOperationId,
+                linkedArtifact: { name: 'responsive html', path: exportOutFile },
+            } : {}),
+        });
+        progress.finish(recoveryReport.terminalStatus ? 'failed' : 'stopped', {
+            detail: recoveryReport.terminalStatus
+                ? `conversion ${created.id} is ${recoveryReport.terminalStatus}: ${detail}`
+                : `conversion ${created.id} did not settle: ${detail}`,
+            artifacts: recoveryReport.artifacts,
+            next: recoveryReport.next,
         });
         throw new Error(`Conversion ${created.id} failed: ${detail}`, { cause: error });
     }
@@ -791,7 +850,22 @@ export const runConversionCommand = async (command, flags, journal, dependencies
             ...(quiet ? {} : { warn: (message) => process.stderr.write(`${message}\n`) }),
         });
     }
-    const result = await downloadCompletedConversion({ client, operation, output, outFile });
+    let result;
+    try {
+        result = await downloadCompletedConversion({ client, operation, output, outFile });
+    }
+    catch (error) {
+        progress.finish('stopped', {
+            detail: error instanceof Error ? error.message : String(error),
+            artifacts: [{ name: output, state: 'succeeded — not collected', path: outFile }],
+            next: conversionRecoveryAdvice({
+                conversionId: created.id,
+                terminalStatus: null,
+                resumeCommand: `12ui resume ${created.id}`,
+            }),
+        });
+        throw error;
+    }
     journal.note({ artifacts: [outFile] });
     if (!exportOperationId || !exportOutFile) {
         const disposition = responsiveAlternativeDisposition(result);
@@ -879,16 +953,35 @@ export const runConversionCommand = async (command, flags, journal, dependencies
         : undefined;
     const pending = isPendingConversionStatus(exportStatus);
     const collect = `12ui resume ${exportOperationId} --output html --out <file>`;
-    const report = {
-        ...result,
-        nextAction: layerDocStateAction({
+    const collectToOutput = `12ui resume ${exportOperationId} --output html --out ${exportOutFile}`;
+    const terminalExportStatus = !exportResult
+        && (exportStatus === 'failed' || exportStatus === 'expired')
+        ? exportStatus
+        : null;
+    const nextAction = exportResult
+        ? layerDocStateAction({
             outFile,
             linkedExport: {
                 id: exportOperationId,
                 status: exportStatus,
-                ...(exportResult ? { outFile: exportOutFile } : {}),
+                outFile: exportOutFile,
             },
-        }),
+        })
+        : terminalExportStatus
+            ? conversionRecoveryAdvice({
+                conversionId: exportOperationId,
+                terminalStatus: terminalExportStatus,
+                resumeCommand: collectToOutput,
+            })
+            : exportStatus === 'succeeded' || exportStatus === 'unknown'
+                ? `Responsive export ${exportOperationId} is ${exportStatus}; collect the existing export with ${collectToOutput}`
+                : layerDocStateAction({
+                    outFile,
+                    linkedExport: { id: exportOperationId, status: exportStatus },
+                });
+    const report = {
+        ...result,
+        nextAction,
         export: exportResult
             ? { ...exportResult, status: exportStatus }
             : {
@@ -955,7 +1048,32 @@ export const runConversionCommand = async (command, flags, journal, dependencies
             next: `the purchase stays collectable until ${created.expires_at}`,
         });
     }
+    else if (exportStatus === 'succeeded' || exportStatus === 'unknown') {
+        progress.finish('stopped', {
+            detail: exportStatus === 'succeeded'
+                ? `the linked responsive export succeeded but collection did not complete: ${exportError}`
+                : `the linked responsive export state could not be read: ${exportReadDetail ?? exportError}`,
+            artifacts: [
+                layerdocRow,
+                {
+                    name: 'responsive html',
+                    state: exportStatus === 'succeeded' ? 'succeeded — not collected' : 'unknown — not collected',
+                    path: exportOutFile,
+                    ...((exportObservation?.readError?.message || exportError)
+                        ? { note: exportObservation?.readError?.message || exportError || undefined }
+                        : {}),
+                },
+            ],
+            spend: spendLine,
+            next: `${collectToOutput}; collection is free until the purchase expires`,
+        });
+    }
     else {
+        const next = conversionRecoveryAdvice({
+            conversionId: exportOperationId,
+            terminalStatus: terminalExportStatus,
+            resumeCommand: collectToOutput,
+        });
         progress.finish('failed', {
             detail: `the linked responsive export ${exportOperationId} ${exportStatus}`,
             artifacts: [
@@ -967,7 +1085,7 @@ export const runConversionCommand = async (command, flags, journal, dependencies
                 },
             ],
             spend: spendLine,
-            next: `render a fixed page free from the document: 12ui convert ${outFile} --output html_fixed`,
+            next,
         });
     }
     writeResultWithSummary(report, writeResult);
@@ -980,10 +1098,10 @@ export const runConversionCommand = async (command, flags, journal, dependencies
                 ? `Conversion ${created.id} succeeded and was written to ${outFile}, but responsive export`
                     + ` ${exportOperationId} failed with ${responsiveAlternativeLabel(exportDisposition)};`
                     + ` coverage is recorded in ${exportResult.artifactManifest.manifestFile}.`
-                : exportStatus === 'unknown'
-                    ? `Conversion ${created.id} succeeded and was written to ${outFile}. Responsive HTML export ${exportOperationId} has an unknown state. ${exportReadDetail ?? exportError}. Keep this purchase and collect the same export when the read issue is resolved: ${collect}.`
+                : exportStatus === 'succeeded' || exportStatus === 'unknown'
+                    ? `Conversion ${created.id} succeeded and was written to ${outFile}. Responsive HTML export ${exportOperationId} is ${exportStatus} and was not collected. Use ${collectToOutput}; this collects the existing purchase.`
                     : `Conversion ${created.id} succeeded and was written to ${outFile}, but its responsive HTML`
-                        + ` export ${exportOperationId} did not: ${exportError}`);
+                        + ` export ${exportOperationId} is ${exportStatus}: ${exportError}. ${nextAction}`);
     }
 };
 //# sourceMappingURL=cli-convert-command.js.map