@12ui/design 0.2.66 → 0.2.67

package/dist/cli-capabilities.js

@@ -1,6 +1,5 @@
-import { HEDGE_QUERY_LENGTH_LIMIT } from './reference-search-mode.js';
 import { BRANCH_PAGE_CONCURRENCY_DEFAULT, CONVERSION_DURATION_HINTS, OPERATION_DURATION_HINTS, } from './cli-progress.js';
-import { MAX_CONCEPT_CHARACTERS } from './concept-input.js';
+import { HEDGE_QUERY_LENGTH_LIMIT } from './reference-search-mode.js';
 import { CONVERSION_MODELS } from './conversion-models.js';
 import { CLI_CONVERSION_OUTPUTS, CONVERSION_OUTPUT_MEDIA_TYPES, } from './conversion-outputs.js';
 import { MAX_IMAGE_OUTPUT_WIDTH } from './image-output-width.js';
@@ -14,9 +13,32 @@ export const CLI_CAPABILITIES = {
         CONVERSION_OUTPUT_MEDIA_TYPES.layerdoc,
     ],
     outputs: CLI_CONVERSION_OUTPUTS,
-    outputDescription: '`12ui convert <image> --output html` writes both LayerDoc and responsive HTML through the'
-        + ' fused conversion path. `12ui convert <conversion-id> --output <comma-separated-formats>`'
-        + ' derives requested formats concurrently into --out-dir; only responsive html is metered.',
+    outputDescription: 'convert --output html selects local Codex or hosted API before dispatch. Local HTML has no LayerDoc;'
+        + ' API HTML writes LayerDoc and responsive HTML. Hosted conversion IDs derive comma-separated formats.',
+    conversionEngines: {
+        values: ['auto', 'codex', 'api'],
+        default: 'auto',
+        environment: 'TWELVE_UI_ENGINE',
+        localOutputs: ['html'],
+        failurePolicy: 'Never silently retry a local failure through API; resume uses the recorded engine.',
+    },
+    localConversion: {
+        command: '12ui convert <image> --output html --engine codex',
+        imageBackends: ['external', 'native'],
+        defaultImageBackend: { withNonblankOpenaiApiKey: 'external', otherwise: 'native' },
+        imageBackendPolicy: 'Choose once for a new run; explicit choices and saved runs remain fixed. Explicit external requires OPENAI_API_KEY before planner execution.',
+        nativeLayerDoc: false,
+    },
+    projectApply: {
+        command: '12ui improve <url> --target <image> --repo <directory> --apply',
+        withoutTarget: 'Draft candidates, require an explicit pick, then edit the actual project locally.',
+        withoutApply: 'Hosted implementation kit; does not edit project source.',
+    },
+    localExport: {
+        command: '12ui export <run-dir|output-dir> --output <format> --out-dir <directory>',
+        outputs: ['assets', 'png', 'jpg', 'webp', 'pdf', 'react'],
+        react: 'Whole-page JSX, CSS, and assets; not a functional application.',
+    },
     imageModels: CONVERSION_MODELS,
     imageOutputWidth: {
         flag: '--width',
@@ -24,28 +46,13 @@ export const CLI_CAPABILITIES = {
         maximum: MAX_IMAGE_OUTPUT_WIDTH,
         description: 'Set the native output canvas width by proportionally resizing image input up or down.',
     },
-    /**
-     * The one input limit a caller hits before it can spend anything, and the one
-     * that has to be knowable BEFORE the value is written: `draft` and `branch
-     * execute` measure the brief with the service's own normalization and
-     * refuse over-length text locally, having bought nothing.
-     *
-     * This entry used to carry a `whyItIsShort` field asserting that long concepts
-     * produce worse screens. The 2026-08-16 blind A/B behind the 1200 raise
-     * (`labs/concept-cap-2026-08-16`) measured no such effect, so the field is gone
-     * rather than reworded — a capabilities payload is read by agents as fact, and
-     * a refuted claim there is worse than no claim.
-     */
+    // User briefs retain their complete normalized text.
     concept: {
         flags: ['--concept', '--concept-file'],
         commands: ['12ui draft', '12ui branch execute'],
         minimumCharacters: 1,
-        maximumCharacters: MAX_CONCEPT_CHARACTERS,
         counted: 'code points, after every run of whitespace collapses to one space',
-        description: 'The brief: product, audience, and what the surface must cover. Measured client-side against'
-            + ' the same limit the service enforces, so an over-length brief is refused before any call'
-            + ' and nothing is bought. Say what the surface must cover and leave the visual decisions'
-            + ' to the model.',
+        description: 'The brief: product, audience, and what the surface must cover. Concept text has no character limit.'
     },
     draftCorpusQuery: {
         flag: '--corpus-query',
@@ -164,7 +171,7 @@ export const CLI_CAPABILITIES = {
         labelSchema: ['navigate', 'dropdown', 'modal', 'none'],
         labelSpend: 'one low-effort product-provider call per screen',
         precedence: 'deterministic navigation applies; dropdowns bind only from three or more distinct labeled options',
-        hardGates: ['branch.plan.json', 'semantic viewport section ids'],
+        hardGates: ['branch.plan.json', 'semantic viewport section ids or verified local-page identity'],
     },
 };
 //# sourceMappingURL=cli-capabilities.js.map

package/dist/cli-capabilities.js.map

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

package/dist/cli-codex-readiness.d.ts

@@ -0,0 +1,11 @@
+/** Non-inference checks against only the selected binary and authentication home. */
+export declare function probeCodexReadiness(options?: {
+    codexBin?: string;
+    codexHome?: string;
+}): Promise<{
+    ready: boolean;
+    reason: string;
+    codexBin: string;
+    codexHome: string;
+}>;
+//# sourceMappingURL=cli-codex-readiness.d.ts.map

package/dist/cli-codex-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-codex-readiness.d.ts","sourceRoot":"","sources":["../src/cli-codex-readiness.ts"],"names":[],"mappings":"AAoBA,qFAAqF;AACrF,wBAAsB,mBAAmB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC;IAC1G,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;CACrE,CAAC,CAiCD"}

package/dist/cli-codex-readiness.js

@@ -0,0 +1,72 @@
+import { execFile } from 'node:child_process';
+import { constants } from 'node:fs';
+import { access, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+// Keep aligned with codex-conversion/src/codex/arguments.mjs.
+const requiredExecFlags = [
+    '--ignore-user-config', '--ignore-rules', '--strict-config', '--cd',
+    '--skip-git-repo-check', '--sandbox', '--model', '--config', '--enable',
+    '--disable', '--json', '--color', '--output-last-message', '--image', '--output-schema',
+];
+function inspect(binary, args, env) {
+    return new Promise((resolve, reject) => {
+        execFile(binary, args, { env, encoding: 'utf8', timeout: 30_000, maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => error ? reject(error) : resolve(`${stdout}\n${stderr}`));
+    });
+}
+/** Non-inference checks against only the selected binary and authentication home. */
+export async function probeCodexReadiness(options = {}) {
+    const codexBin = options.codexBin ?? 'codex';
+    const codexHome = path.resolve(options.codexHome ?? process.env.CODEX_HOME ?? path.join(homedir(), '.codex'));
+    const result = (ready, reason) => ({ ready, reason, codexBin, codexHome });
+    // Match the runtime's subscription environment: no provider API credentials.
+    const env = { CODEX_HOME: codexHome };
+    for (const key of ['PATH', 'HOME', 'TMPDIR', 'TEMP', 'TMP', 'LANG', 'LC_ALL', 'SYSTEMROOT']) {
+        if (process.env[key])
+            env[key] = process.env[key];
+    }
+    try {
+        await inspect(codexBin, ['--version'], env);
+    }
+    catch {
+        return result(false, 'Codex CLI could not run. Install Codex on PATH or pass --codex-bin with a working executable.');
+    }
+    try {
+        await access(path.join(codexHome, 'auth.json'), constants.R_OK);
+    }
+    catch {
+        return result(false, 'Selected Codex home has no readable auth.json. Run codex login with this CODEX_HOME, or select your authenticated home with --codex-home.');
+    }
+    try {
+        const login = await inspect(codexBin, ['login', 'status'], env);
+        if (!login.includes('Logged in using ChatGPT')) {
+            return result(false, 'Codex conversion requires ChatGPT authentication. Run codex login with the selected CODEX_HOME; API-key login is not supported.');
+        }
+    }
+    catch {
+        return result(false, 'Codex login status failed. Run codex login with the selected CODEX_HOME and retry.');
+    }
+    try {
+        const help = await inspect(codexBin, ['exec', '--help'], env);
+        const missing = requiredExecFlags.filter(flag => !new RegExp(`${flag}(?=[\\s=,]|$)`).test(help));
+        if (missing.length)
+            return result(false, `Codex CLI lacks required conversion flags: ${missing.join(', ')}. Update Codex or select a compatible executable with --codex-bin.`);
+    }
+    catch {
+        return result(false, 'Codex exec --help failed. Update Codex or select a compatible executable with --codex-bin.');
+    }
+    try {
+        const cache = JSON.parse(await readFile(path.join(codexHome, 'models_cache.json'), 'utf8'));
+        const models = cache?.models;
+        const available = Array.isArray(models) && models.some(model => model?.slug === 'gpt-6-astra'
+            && Array.isArray(model.supported_reasoning_levels)
+            && model.supported_reasoning_levels.some((level) => level?.effort === 'low'));
+        if (!available)
+            return result(false, 'The selected Codex model cache does not list gpt-6-astra with low reasoning. Refresh Codex model availability for this ChatGPT account, then retry.');
+    }
+    catch {
+        return result(false, 'Selected Codex home has no readable, valid models_cache.json. Open Codex with this CODEX_HOME to refresh its model cache, then retry.');
+    }
+    return result(true, 'Codex CLI, ChatGPT login, required flags, and cached gpt-6-astra low availability are ready.');
+}
+//# sourceMappingURL=cli-codex-readiness.js.map

package/dist/cli-codex-readiness.js.map

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

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

@@ -0,0 +1,11 @@
+import { type CliFlags } from './cli-arguments.js';
+export declare const LOCAL_CONVERSION_FLAGS: Set<string>;
+export declare const localConversionDirectory: (source: string, flags: CliFlags) => string;
+/** Only explicitly requested options belong in flags; defaults must not imply hosted intent. */
+export declare function chooseConversionEngine({ source, flags, runDir }: {
+    source: string;
+    flags: CliFlags;
+    runDir?: string;
+}): Promise<import("./cli-engine.js").EngineSelection>;
+export declare function assertApiConversionFlags(flags: CliFlags): void;
+//# sourceMappingURL=cli-conversion-engine.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli-conversion-engine.js

@@ -0,0 +1,26 @@
+import path from 'node:path';
+import { stat } from 'node:fs/promises';
+import { stringFlag } from './cli-arguments.js';
+import { selectEngine } from './cli-engine.js';
+import { readLocalRecord } from './cli-local-record.js';
+import { CliRefusal } from './cli-refusal.js';
+export const LOCAL_CONVERSION_FLAGS = new Set(['engine', 'codex-bin', 'codex-home', 'output', 'out-dir', 'image-backend', 'clean-assets', 'timeout-ms', 'reasoning', 'json', 'quiet']);
+export const localConversionDirectory = (source, flags) => path.resolve(stringFlag(flags, 'out-dir') ?? path.join(path.dirname(path.resolve(source)), path.parse(source).name + '-12ui'));
+/** Only explicitly requested options belong in flags; defaults must not imply hosted intent. */
+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 selection = await selectEngine(flags, supported, saved ? 'codex' : hosted ? 'api' : undefined);
+    if (selection.engine === 'api')
+        assertApiConversionFlags(flags);
+    return selection;
+}
+export function assertApiConversionFlags(flags) {
+    const unsupported = ['image-backend', 'clean-assets', 'reasoning'].filter(key => flags[key] !== undefined);
+    if (unsupported.length)
+        throw new CliRefusal(`${unsupported.map(key => '--' + key).join(', ')} require the Codex engine. Remove these options for API work or configure Codex and use --engine codex.`, 'local_arguments');
+}
+//# sourceMappingURL=cli-conversion-engine.js.map

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

@@ -0,0 +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"}

package/dist/cli-conversion-receipt.d.ts

@@ -0,0 +1,28 @@
+export interface LocalConversionReceipt {
+    schemaVersion: 1;
+    engine: 'codex';
+    status: string;
+    runDir: string;
+    source: {
+        path: string;
+        sha256: string;
+    };
+    settings: Record<string, string>;
+    artifacts: Array<{
+        path: string;
+        sha256?: string;
+    }>;
+    entrypoint?: string;
+    manifest?: string;
+    availableOutputs: string[];
+    nativeLayerDoc: false;
+}
+export declare const receiptPath: (runDir: string) => string;
+export declare function prepareConversionReceipt(args: {
+    source: string;
+    runDir: string;
+    settings: Record<string, string>;
+}): Promise<LocalConversionReceipt>;
+export declare function readConversionReceipt(runDir: string): Promise<LocalConversionReceipt | undefined>;
+export declare function updateConversionReceipt(runDir: string, status?: string): Promise<LocalConversionReceipt | undefined>;
+//# sourceMappingURL=cli-conversion-receipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-conversion-receipt.d.ts","sourceRoot":"","sources":["../src/cli-conversion-receipt.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAClE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3E,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,KAAK,CAAC;CAC3F;AAKD,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,MAAwD,CAAC;AAEtG,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAQ1J;AACD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAavG;AAWD,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CA0C1H"}

package/dist/cli-conversion-receipt.js

@@ -0,0 +1,130 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { readFile, realpath, rename, stat, unlink, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
+const digest = (v) => typeof v === 'string' && /^[a-f0-9]{64}$/u.test(v);
+const object = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const missing = (e) => object(e) && ['ENOENT', 'ENOTDIR'].includes(String(e.code));
+export const receiptPath = (runDir) => `${path.resolve(runDir)}.12ui-conversion.json`;
+export async function prepareConversionReceipt(args) {
+    const receipt = {
+        schemaVersion: 1, engine: 'codex', status: 'prepared', runDir: path.resolve(args.runDir),
+        source: { path: path.resolve(args.source), sha256: hash(await readFile(args.source)) },
+        settings: { ...args.settings }, artifacts: [], availableOutputs: [], nativeLayerDoc: false,
+    };
+    await writeFile(receiptPath(args.runDir), `${JSON.stringify(receipt, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+    return receipt;
+}
+export async function readConversionReceipt(runDir) {
+    let v;
+    try {
+        v = JSON.parse(await readFile(receiptPath(runDir), 'utf8'));
+    }
+    catch (e) {
+        if (missing(e))
+            return undefined;
+        throw e;
+    }
+    if (!object(v) || v.schemaVersion !== 1 || v.engine !== 'codex' || v.runDir !== path.resolve(runDir)
+        || typeof v.status !== 'string' || v.nativeLayerDoc !== false || !object(v.source)
+        || typeof v.source.path !== 'string' || !digest(v.source.sha256) || !object(v.settings)
+        || !Object.values(v.settings).every(x => typeof x === 'string') || !Array.isArray(v.artifacts)
+        || !v.artifacts.every(x => object(x) && typeof x.path === 'string' && (x.sha256 === undefined || digest(x.sha256)))
+        || !Array.isArray(v.availableOutputs) || !v.availableOutputs.every(x => typeof x === 'string')
+        || (v.entrypoint !== undefined && typeof v.entrypoint !== 'string')
+        || (v.manifest !== undefined && typeof v.manifest !== 'string'))
+        throw new Error('Invalid local conversion receipt');
+    return v;
+}
+function relativeFile(v) {
+    if (typeof v !== 'string' || !v || path.isAbsolute(v) || v.includes('\\') || v.includes('\0')
+        || v.includes(':') || v.split('/').some(x => !x || x === '..' || x === '.'))
+        throw new Error('Unsafe conversion manifest path');
+    return v;
+}
+async function containedFile(root, relative) {
+    const file = path.join(root, relative);
+    const actual = await realpath(file);
+    if (!actual.startsWith(`${root}${path.sep}`) || !(await stat(actual)).isFile())
+        throw new Error('Unsafe conversion manifest file');
+    return file;
+}
+export async function updateConversionReceipt(runDir, status) {
+    const existing = await readConversionReceipt(runDir);
+    if (!existing)
+        return undefined;
+    const receipt = { ...existing, artifacts: [], availableOutputs: [] };
+    delete receipt.entrypoint;
+    delete receipt.manifest;
+    if (status === undefined) {
+        try {
+            const result = JSON.parse(await readFile(path.join(runDir, 'result.json'), 'utf8'));
+            if (object(result) && typeof result.status === 'string')
+                status = result.status;
+        }
+        catch (e) {
+            if (!missing(e))
+                throw e;
+        }
+    }
+    receipt.status = status ?? existing.status;
+    const manifestPath = path.resolve(runDir, 'output/manifest.json');
+    let bytes;
+    try {
+        bytes = await readFile(manifestPath);
+    }
+    catch (e) {
+        if (!missing(e))
+            throw e;
+    }
+    if (bytes) {
+        const manifest = JSON.parse(bytes.toString('utf8'));
+        if (!object(manifest) || !Array.isArray(manifest.files))
+            throw new Error('Invalid conversion manifest');
+        if (!object(manifest.source) || !digest(manifest.source.sha256)
+            || manifest.source.sha256 !== receipt.source.sha256)
+            throw new Error('Conversion manifest source hash mismatch');
+        const entrypoint = relativeFile(manifest.entrypoint);
+        if (!/\.html?$/iu.test(entrypoint))
+            throw new Error('Conversion manifest requires an HTML entrypoint');
+        const root = await realpath(path.resolve(runDir));
+        const outputRoot = await realpath(path.join(root, 'output'));
+        if (!outputRoot.startsWith(`${root}${path.sep}`))
+            throw new Error('Unsafe conversion output directory');
+        await containedFile(outputRoot, 'manifest.json');
+        const seen = new Set();
+        for (const item of manifest.files) {
+            if (!object(item) || !digest(item.sha256))
+                throw new Error('Invalid conversion manifest file hash');
+            const relative = relativeFile(item.path);
+            if (seen.has(relative))
+                throw new Error('Duplicate conversion manifest file');
+            seen.add(relative);
+            const file = await containedFile(outputRoot, relative);
+            const sha256 = hash(await readFile(file));
+            if (sha256 !== item.sha256)
+                throw new Error(`Conversion artifact hash mismatch: ${relative}`);
+            receipt.artifacts.push({ path: path.resolve(runDir, 'output', relative), sha256 });
+        }
+        if (!seen.has(entrypoint))
+            throw new Error('Conversion entrypoint missing from manifest files');
+        receipt.entrypoint = path.resolve(runDir, 'output', entrypoint);
+        receipt.manifest = manifestPath;
+        receipt.artifacts.push({ path: manifestPath, sha256: hash(bytes) });
+        receipt.availableOutputs = ['html', 'assets', 'png', 'jpg', 'webp', 'pdf', 'react'];
+    }
+    const destination = receiptPath(runDir);
+    const temporary = `${destination}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(receipt, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+        await rename(temporary, destination);
+    }
+    catch {
+        console.error('Warning: could not persist the updated conversion receipt. Verified artifacts remain available.');
+    }
+    finally {
+        await unlink(temporary).catch(() => undefined);
+    }
+    return receipt;
+}
+//# sourceMappingURL=cli-conversion-receipt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-conversion-receipt.js","sourceRoot":"","sources":["../src/cli-conversion-receipt.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,CAuqBd,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;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"}

package/dist/cli-convert-command.js

@@ -14,7 +14,7 @@ import { isCliConversionOutput, } from './conversion-outputs.js';
 import { recordConvertedImageReceipt } from './conversion-receipt.js';
 import { materializeResponsiveAlternative } from './responsive-alternative-materializer.js';
 import { readConversionRecovery, writeConversionRecovery, } from './conversion-recovery.js';
-import { isPendingConversionStatus, readConversionStatus, wrongConversionOutputRefusal, } from './conversion-status-contract.js';
+import { isPendingConversionStatus, readConversionStatusObservation, wrongConversionOutputRefusal, } from './conversion-status-contract.js';
 import { normalizeOptionalIdempotencyKey } from './idempotency-key.js';
 import { classifyLocalConversionInput, createInputForLocalFile, defaultConversionOutputPath, } from './local-conversion-input.js';
 import { normalizeImageOutputWidth, parseImageOutputWidth, } from './image-output-width.js';
@@ -870,9 +870,13 @@ export const runConversionCommand = async (command, flags, journal, dependencies
     const exportDisposition = exportResult
         ? responsiveAlternativeDisposition(exportResult)
         : null;
+    const exportObservation = exportResult ? null : await readConversionStatusObservation(client, exportOperationId);
     const exportStatus = exportResult
         ? exportDisposition ? 'failed' : 'succeeded'
-        : await readConversionStatus(client, exportOperationId);
+        : exportObservation.status;
+    const exportReadDetail = exportObservation?.readError
+        ? `Status read ${exportObservation.readError.kind === 'http' ? `returned HTTP ${exportObservation.readError.status}` : 'was unavailable'}: ${exportObservation.readError.message}`
+        : undefined;
     const pending = isPendingConversionStatus(exportStatus);
     const collect = `12ui resume ${exportOperationId} --output html --out <file>`;
     const report = {
@@ -891,6 +895,7 @@ export const runConversionCommand = async (command, flags, journal, dependencies
                 id: exportOperationId,
                 output: 'html',
                 status: exportStatus,
+                ...(exportObservation?.readError ? { readError: exportObservation.readError } : {}),
                 ...(pending ? { nextAction: collect } : { error: exportError }),
             },
     };
@@ -958,7 +963,7 @@ export const runConversionCommand = async (command, flags, journal, dependencies
                 {
                     name: 'responsive html',
                     state: exportStatus,
-                    ...(exportError ? { note: exportError } : {}),
+                    ...((exportObservation?.readError?.message || exportError) ? { note: exportObservation?.readError?.message || exportError || undefined } : {}),
                 },
             ],
             spend: spendLine,
@@ -975,8 +980,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}.`
-                : `Conversion ${created.id} succeeded and was written to ${outFile}, but its responsive HTML`
-                    + ` export ${exportOperationId} did not: ${exportError}`);
+                : 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}.`
+                    : `Conversion ${created.id} succeeded and was written to ${outFile}, but its responsive HTML`
+                        + ` export ${exportOperationId} did not: ${exportError}`);
     }
 };
 //# sourceMappingURL=cli-convert-command.js.map