@12ui/design 0.2.54 → 0.2.56

package/dist/improve-conversion-stage.js

@@ -0,0 +1,381 @@
+import { copyFile, cp, readFile, stat } from 'node:fs/promises';
+import sharp from 'sharp';
+import { runConversionCommand } from './cli-convert-command.js';
+import { CliRefusal } from './cli-refusal.js';
+import { prepareOutputDirectory } from './cli-output-paths.js';
+import { fixedImproveHtml, improveConversionIdFromText, improveConvertRetryKey, improveConvertStallCount, improveConvertStallExhausted, improveConvertStallReason, improveConvertStallRetryAllowed, improveErrorText, improveStalled, IMPROVE_CONVERT_STALL_ATTEMPTS, IMPROVE_FRESH_ABANDON_REASON, prepareImproveTargetAttempt, resetImproveTargetAttempt, responsiveFallbackReason, } from './improve-convert-resilience.js';
+import { improveFreshConversionKey, noteImproveConversionAttemptId, openImproveConversionAttempt, settleImproveConversionAttempt, startImproveConversionAttempt, } from './improve-conversion-attempts.js';
+import { canvasOfDoc } from './improve-layerdoc-diff.js';
+import { abandonImproveConversion, abandonImproveConversions, noteAbandonedAttempts, withoutImproveStages, } from './improve-reset.js';
+import { improveSha256, noteImproveStage, } from './improve-stage-shared.js';
+import { readImproveRecord, writeImproveRecord } from './improve-workspace.js';
+export const runImproveConversion = async (args) => {
+    const artifacts = [];
+    const purchaseIds = [];
+    const runIds = [];
+    const collector = {
+        note: (facts) => {
+            artifacts.push(...(facts.artifacts ?? []));
+            purchaseIds.push(...(facts.purchased ?? []));
+            if (facts.runId) {
+                if (!runIds.includes(facts.runId))
+                    args.onConversionId?.(facts.runId);
+                runIds.push(facts.runId);
+            }
+            args.journal?.note(facts);
+        },
+        heartbeat: (progress) => { args.journal?.heartbeat(progress); },
+    };
+    const flags = {
+        output: args.output,
+        ...(args.model ? { model: args.model } : {}),
+        ...(args.responsiveQuality ? { 'responsive-quality': args.responsiveQuality } : {}),
+        ...(args.timeoutMs === undefined ? {} : { 'timeout-ms': String(args.timeoutMs) }),
+        'out-dir': args.outDir,
+        'idempotency-key': args.key,
+        quiet: true,
+    };
+    try {
+        await args.runner(['convert', args.input], flags, collector, { writeResult: () => undefined });
+    }
+    catch (error) {
+        throw new ImproveConvertAttemptError(error, {
+            artifacts: [...new Set(artifacts)],
+            purchaseIds: [...new Set(purchaseIds)],
+            runIds: [...new Set(runIds)],
+        });
+    }
+    return {
+        artifacts: [...new Set(artifacts)],
+        purchaseIds: [...new Set(purchaseIds)],
+        runIds: [...new Set(runIds)],
+    };
+};
+class ImproveConvertAttemptError extends Error {
+    attempt;
+    constructor(error, attempt) {
+        super(improveErrorText(error), { cause: error });
+        this.name = 'ImproveConvertAttemptError';
+        this.attempt = attempt;
+    }
+}
+/**
+ * `--fresh` re-buys ONE conversion of the SAME settled winner under a new
+ * idempotency key. Capture, draft and pick stay settled and are not redrawn —
+ * `--redraw` is the flag for that.
+ */
+const recordFreshConversion = async (args) => {
+    const durable = await readImproveRecord(args.options.paths.record) ?? args.record;
+    const abandoned = await abandonImproveConversion({
+        record: durable,
+        reason: IMPROVE_FRESH_ABANDON_REASON,
+        warn: args.dependencies.warn ?? ((line) => { console.warn(line); }),
+    });
+    const record = withoutImproveStages(abandoned.record, ['convert', 'plan']);
+    await writeImproveRecord(args.options.paths.record, record);
+    return record;
+};
+export const runImproveConvertStage = async (args) => {
+    if (args.record.convert && !args.options.fresh)
+        return noteImproveStage({
+            record: args.record, stage: 'convert', priceCeilingUsd: args.price, replayed: true, write: true,
+        });
+    if (!args.record.pick && !args.record.target)
+        throw new Error('Cannot convert before pick');
+    await prepareOutputDirectory(args.options.paths.targetDir);
+    if (args.record.target?.kind === 'layerdoc') {
+        const bytes = await readFile(args.record.target.value);
+        canvasOfDoc(JSON.parse(bytes.toString('utf8')));
+        await copyFile(args.record.target.value, args.options.paths.targetLayerDoc);
+        const assetSource = `${args.record.target.value}.assets`;
+        if ((await stat(assetSource).catch(() => undefined))?.isDirectory()) {
+            await cp(assetSource, `${args.options.paths.targetLayerDoc}.assets`, { recursive: true });
+        }
+        let record = {
+            ...args.record,
+            target: { ...args.record.target, sha256: improveSha256(bytes) },
+            convert: {
+                layerDoc: args.options.paths.targetLayerDoc,
+                html: '',
+                layout: 'document',
+                artifacts: [args.options.paths.targetLayerDoc],
+                purchaseIds: [],
+            },
+        };
+        record = await noteImproveStage({
+            record, stage: 'convert', priceCeilingUsd: args.price, replayed: false, write: false,
+        });
+        await writeImproveRecord(args.options.paths.record, record);
+        return record;
+    }
+    let recordBeforeConvert = args.options.fresh
+        ? await recordFreshConversion(args)
+        : args.record;
+    let input = args.record.pick?.imagePath;
+    let inputSha = args.record.pick?.sha256;
+    if (args.record.target?.kind === 'image') {
+        const bytes = await readFile(args.record.target.value);
+        const image = sharp(bytes, { animated: false, failOn: 'warning' });
+        const metadata = await image.metadata();
+        if (!metadata.width || !metadata.height || !['png', 'jpeg', 'webp'].includes(metadata.format ?? '')) {
+            throw new CliRefusal('--target image is not a usable PNG, JPEG, or WebP', 'improve_target_invalid');
+        }
+        await image.png().toFile(args.options.paths.winnerImage);
+        input = args.options.paths.winnerImage;
+        inputSha = improveSha256(bytes);
+        recordBeforeConvert = { ...recordBeforeConvert, target: { ...args.record.target, sha256: inputSha } };
+    }
+    if (!input || !inputSha)
+        throw new Error('Improve has no design image to convert');
+    const targetIdentity = improveSha256(Buffer.from(`${inputSha}:${args.record.conversionModel}:${args.options.responsiveQuality}`)).slice(0, 32);
+    const baseKey = `improve-target:v2:${targetIdentity}`;
+    // How many conversions of this winner the kit has already bought and
+    // abandoned to a stall, and which of them to wait on now. A resume
+    // re-attaches to the NEWEST one — it is bought, it is still running, and it
+    // is the only way to get anything back for it — instead of rebuilding the
+    // base key and waiting out the whole bound on the first, oldest, already
+    // declared-dead conversion.
+    let bought = args.options.fresh ? 0 : improveConvertStallCount(recordBeforeConvert);
+    let index = Math.max(1, bought);
+    // WHICH CONVERSION THIS INVOCATION IS ABOUT TO WAIT ON. The attempt ledger
+    // decides, because it holds the exact key: a `--fresh` or retry attempt that
+    // was stopped mid-flight is reachable only through the key it was dispatched
+    // under, and the derived stall key below cannot express a nonce. Without it,
+    // `--from convert` rebuilt the base key, the server's dedupe handed back the
+    // older recorded conversion, and the fresh one kept running and kept billing
+    // with nothing able to collect it. The derived key stays the fallback for
+    // kits written before the ledger.
+    //
+    // Only an attempt minted for THIS winner counts: every recorded key is the
+    // base key plus a suffix, so the prefix is what says the conversion behind it
+    // is of the design this run is converting. A redraw or a re-pick already
+    // closes its attempts (`abandonImproveConversions`); this is the second lock
+    // on that door, because re-attaching to a conversion of a discarded design
+    // would deliver the wrong page and read as a replay.
+    const open = args.options.fresh ? undefined : openImproveConversionAttempt(recordBeforeConvert);
+    const resumed = open?.key.startsWith(`${baseKey}:`) ? open : undefined;
+    const nonce = args.freshConversionNonce;
+    if (args.options.fresh && !nonce) {
+        throw new Error('improve --fresh needs a per-invocation conversion nonce, so the conversion it dispatches'
+            + ' can be recorded and resumed rather than orphaned');
+    }
+    const key = args.options.fresh && nonce
+        ? improveFreshConversionKey(baseKey, nonce)
+        : resumed?.key ?? (index === 1 ? baseKey : improveConvertRetryKey(baseKey, index));
+    // The transaction is taken ONCE, outside the retry: a second
+    // `prepareImproveTargetAttempt` while the first backup exists would delete
+    // the previous good target instead of preserving it.
+    const transaction = await prepareImproveTargetAttempt(args.options.paths.targetDir);
+    const warn = args.dependencies.warn ?? ((line) => { console.warn(line); });
+    try {
+        // The hosted id joins its key on the record as soon as the conversion
+        // reports one, so a reader of `improve.json` alone can say which conversion
+        // a recorded key bought. Only ledger attempts have anywhere to put it, so
+        // the ordinary base-key path writes nothing extra. The writes are chained
+        // and drained before the stage writes the record itself: a stamp landing
+        // after the settled record would write a record that has no convert block.
+        let pendingLedgerWrite = Promise.resolve();
+        const rememberConversionId = (attemptKey, id) => {
+            const noted = noteImproveConversionAttemptId(recordBeforeConvert, {
+                key: attemptKey,
+                conversionId: id,
+            });
+            if (noted === recordBeforeConvert)
+                return;
+            recordBeforeConvert = noted;
+            pendingLedgerWrite = pendingLedgerWrite
+                .then(async () => writeImproveRecord(args.options.paths.record, recordBeforeConvert))
+                .catch((error) => {
+                warn(`[ledger] convert: could not record conversion ${id} against its key:`
+                    + ` ${improveErrorText(error)}`);
+            });
+        };
+        const attemptConversion = async (attemptKey) => runImproveConversion({
+            input,
+            outDir: args.options.paths.targetDir,
+            output: 'html',
+            model: args.record.conversionModel,
+            responsiveQuality: args.options.responsiveQuality,
+            timeoutMs: args.options.convertStallSeconds * 1_000,
+            key: attemptKey,
+            runner: args.dependencies.runConvert ?? runConversionCommand,
+            journal: args.dependencies.journal,
+            onConversionId: (id) => { rememberConversionId(attemptKey, id); },
+        }).catch(async (error) => {
+            const attempt = error instanceof ImproveConvertAttemptError
+                ? error.attempt
+                : { artifacts: [], purchaseIds: [], runIds: [] };
+            const warning = responsiveFallbackReason(error);
+            const sourceConversionId = attempt.runIds[0]
+                ?? improveConversionIdFromText(improveErrorText(error));
+            const layerDocPresent = (await stat(args.options.paths.targetLayerDoc).catch(() => undefined))?.isFile();
+            const assetsPresent = (await stat(`${args.options.paths.targetLayerDoc}.assets`).catch(() => undefined))?.isDirectory();
+            if (!warning || !sourceConversionId || !layerDocPresent || !assetsPresent)
+                throw error;
+            (args.dependencies.warn ?? console.warn)(`Responsive HTML was unavailable; deriving fixed-layout HTML free from ${sourceConversionId}`);
+            // The derivation is free, not unbounded. Passing no timeout dropped it
+            // through to waitForOperation's twenty-minute default while the docs
+            // promised `--convert-stall-seconds` bounds the conversion wait, so a
+            // wedged derivation hung the run for twenty minutes with no STALL.md —
+            // the pipedrive shape, on the one path the reader was told was bounded.
+            const fixed = await runImproveConversion({
+                input: sourceConversionId,
+                outDir: args.options.paths.targetDir,
+                output: 'html_fixed',
+                timeoutMs: args.options.convertStallSeconds * 1_000,
+                key: `improve-fixed:v1:${sourceConversionId}`,
+                runner: args.dependencies.runConvert ?? runConversionCommand,
+                journal: args.dependencies.journal,
+            });
+            const fixedOutput = await fixedImproveHtml(args.options.paths.targetDir);
+            args.dependencies.journal?.note({ degradations: ['improve_fixed_layout_fallback'] });
+            return {
+                artifacts: [...new Set([
+                        ...attempt.artifacts,
+                        ...fixed.artifacts,
+                        args.options.paths.targetLayerDoc,
+                        `${args.options.paths.targetLayerDoc}.assets`,
+                        fixedOutput.html,
+                        fixedOutput.assets,
+                    ])],
+                purchaseIds: [...new Set([...attempt.purchaseIds, ...fixed.purchaseIds])],
+                runIds: [...new Set([sourceConversionId, ...attempt.runIds, ...fixed.runIds])],
+                fallback: { html: fixedOutput.html, warning },
+            };
+        });
+        // ONE retry, and only for the stall with nothing to derive: the wait ended,
+        // no LayerDoc reached disk, so no fixed-layout fallback is possible and the
+        // stage has nothing at all. The guard is the LayerDoc on disk rather than
+        // the error text — if the conversion delivered, re-dispatching is pure
+        // waste of a second paid conversion.
+        //
+        // What is actually guaranteed, stated exactly: the default bound is twice
+        // the model's typical wall (see improveConvertStallDefaultSeconds), and an
+        // explicit --convert-stall-seconds is refused below one typical wall. So
+        // the retry sits outside the median by construction and inside no measured
+        // healthy population — nobody has measured P(convert half > bound | healthy)
+        // on the fused population, so it is a bound, not a proof.
+        //
+        // The budget belongs to the KIT, not to this process. Both the retry's
+        // identity and its count come from the durable ledgers, so a resume
+        // attaches to the conversion the retry actually dispatched instead of to
+        // the first, known-stalled one, and a kit that has already retried refuses
+        // to buy a third rather than dispatching one per resume forever.
+        let converted;
+        let convertedKey;
+        const retries = bought === 0 && improveConvertStallRetryAllowed(args.record.conversionModel)
+            ? IMPROVE_CONVERT_STALL_ATTEMPTS - 1
+            : 0;
+        // Why an attempt is being dispatched, which is what the ledger records it
+        // as. A resume of a recorded attempt re-declares the reason it was opened
+        // with and dedupes to a no-op; the plain base key is not recorded at all.
+        const dispatchReason = (attempt) => {
+            if (attempt > 0)
+                return 'stall-retry';
+            if (args.options.fresh)
+                return 'fresh';
+            return resumed?.reason ?? (index === 1 ? undefined : 'stall-retry');
+        };
+        for (let attempt = 0; attempt <= retries; attempt += 1) {
+            const attemptKey = attempt === 0 ? key : improveConvertRetryKey(key, index);
+            // BEFORE THE DISPATCH, because a conversion nothing wrote down before it
+            // started is a conversion a stop cannot leave resumable. `--fresh` also
+            // walks away here from whatever attempt this kit still had open: it is
+            // buying a replacement for it, and an attempt left open would send the
+            // next resume back to the run this one supersedes.
+            const reason = dispatchReason(attempt);
+            if (reason) {
+                const started = startImproveConversionAttempt(recordBeforeConvert, {
+                    key: attemptKey,
+                    reason,
+                    ...(args.options.fresh ? { supersedes: IMPROVE_FRESH_ABANDON_REASON } : {}),
+                });
+                if (started.record !== recordBeforeConvert) {
+                    recordBeforeConvert = noteAbandonedAttempts({
+                        record: started.record,
+                        attempts: started.superseded,
+                        reason: IMPROVE_FRESH_ABANDON_REASON,
+                        warn,
+                    });
+                    await writeImproveRecord(args.options.paths.record, recordBeforeConvert);
+                }
+            }
+            try {
+                converted = await attemptConversion(attemptKey);
+                convertedKey = attemptKey;
+                await pendingLedgerWrite;
+                break;
+            }
+            catch (error) {
+                await pendingLedgerWrite;
+                const layerDocPresent = (await stat(args.options.paths.targetLayerDoc)
+                    .catch(() => undefined))?.isFile();
+                if (layerDocPresent || !improveStalled(error))
+                    throw error;
+                // The stalled attempt knows its own id even when the record does not:
+                // nothing settled, so `recordedImproveConversionId` has nowhere to look.
+                const stalledId = (error instanceof ImproveConvertAttemptError
+                    ? error.attempt.runIds[0]
+                    : undefined) ?? improveConversionIdFromText(improveErrorText(error));
+                // The attempt ledger closes with the conversion, by key: the run this
+                // key reaches is dead, and a later resume must not rebuild it.
+                const abandoned = await abandonImproveConversions({
+                    record: recordBeforeConvert,
+                    reason: improveConvertStallReason(args.options.convertStallSeconds),
+                    ...(stalledId ? { id: stalledId } : {}),
+                    warn,
+                });
+                recordBeforeConvert = abandoned.record;
+                await writeImproveRecord(args.options.paths.record, recordBeforeConvert);
+                // The ledger is the source of truth, and it cannot record a stall whose
+                // id nothing reported. Taking the larger of the two keeps the next key
+                // distinct in that case without ever going backwards.
+                bought = Math.max(bought + 1, improveConvertStallCount(recordBeforeConvert));
+                index = bought + 1;
+                if (attempt >= retries) {
+                    throw improveConvertStallExhausted({
+                        seconds: args.options.convertStallSeconds,
+                        bought,
+                        model: args.record.conversionModel,
+                        cause: error,
+                    });
+                }
+                args.dependencies.journal?.note({ degradations: ['improve_convert_stall_retry'] });
+                warn(`[stall] convert: nothing materialized in ${args.options.convertStallSeconds}s;`
+                    + ' dispatching one fresh conversion of the same winner');
+                await resetImproveTargetAttempt(args.options.paths.targetDir);
+            }
+        }
+        if (!converted)
+            throw new Error('Improve conversion ended without a result');
+        const html = converted.fallback ? converted.fallback.html : args.options.paths.targetHtml;
+        for (const expected of [args.options.paths.targetLayerDoc, html]) {
+            if (!(await stat(expected).catch(() => undefined))?.isFile()) {
+                throw new Error(`Improve conversion completed without ${expected}`);
+            }
+        }
+        let record = settleImproveConversionAttempt({
+            ...recordBeforeConvert,
+            convert: {
+                layerDoc: args.options.paths.targetLayerDoc,
+                html,
+                layout: converted.fallback ? 'fixed' : 'responsive',
+                ...(converted.runIds[0] ? { sourceConversionId: converted.runIds[0] } : {}),
+                ...(converted.fallback ? { responsiveWarning: converted.fallback.warning } : {}),
+                artifacts: converted.artifacts,
+                purchaseIds: converted.purchaseIds,
+            },
+        }, { ...(convertedKey === undefined ? {} : { key: convertedKey }) });
+        record = await noteImproveStage({
+            record, stage: 'convert', priceCeilingUsd: args.price, replayed: false, write: false,
+        });
+        await writeImproveRecord(args.options.paths.record, record);
+        await transaction.commit();
+        return record;
+    }
+    catch (error) {
+        await transaction.restore();
+        throw error;
+    }
+};
+//# sourceMappingURL=improve-conversion-stage.js.map

package/dist/improve-conversion-stage.js.map

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

package/dist/improve-convert-resilience.d.ts

@@ -0,0 +1,148 @@
+import type { ConversionModel } from './conversion-models.js';
+import type { ImproveRecord } from './improve-workspace.js';
+/**
+ * The fused median. It is what the wait was before a retry existed, and it is
+ * still the lower end of the default below.
+ *
+ * The premise that this bound did not cover `materializing_assets` does not
+ * survive the code: `waitForOperation` applies the deadline over the whole poll
+ * loop, stage-agnostic. Pipedrive is not a counter-example either — its
+ * conversion entered that stage about fifty minutes BEFORE the bound shipped,
+ * on 0.2.54.
+ */
+export declare const IMPROVE_RESPONSIVE_TIMEOUT_MS: number;
+export declare const IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS = 30000;
+/** At most one extra conversion, and only on a stall with nothing to derive. */
+export declare const IMPROVE_CONVERT_STALL_ATTEMPTS = 2;
+/**
+ * The floor `--convert-stall-seconds` refuses below: the conversion's own
+ * typical wall for the model in play. A bound inside the typical window would
+ * make the retry fire on a healthy run and buy the same design twice.
+ *
+ * `pro` has no measured hint of its own, so it borrows the standard wall and
+ * pays for that borrowing below: no automatic retry until somebody measures it.
+ */
+export declare const improveConvertStallFloorSeconds: (model: ConversionModel) => number;
+/**
+ * The DEFAULT bound, which used to be the fused median alone — 300s against a
+ * standard conversion's own 240s typical wall, a ratio of 1.25. That is inside
+ * the healthy population by any reading, and it stopped being free the moment
+ * the stall bought a second conversion: a healthy-but-above-median convert half
+ * would cost double, and nothing measures P(convert half > 300s | healthy).
+ *
+ * So the default now obeys the rule the floor states: twice the model's typical
+ * wall, or the fused median, whichever is larger. Standard 480s, fast 300s. An
+ * explicit `--convert-stall-seconds` is still allowed down to the floor — a
+ * caller who wants the tighter bound can ask for it and owns the consequence.
+ */
+export declare const improveConvertStallDefaultSeconds: (model: ConversionModel) => number;
+/**
+ * Whether the automatic retry may fire for this model.
+ *
+ * The retry's whole justification is that the bound sits outside the model's
+ * typical window, so it cannot fire on healthy work. `pro` has no measured
+ * typical wall — `CONVERSION_DURATION_HINTS` carries `convert` and
+ * `convertFast` and nothing else — so for pro that justification does not
+ * exist, and buying a second pro conversion on an unmeasured guess is the
+ * blind fix the study-first doctrine forbids. Pro stalls the way it did before
+ * the retry shipped: STALL.md, terminal event, recovery commands.
+ */
+export declare const improveConvertStallRetryAllowed: (model: ConversionModel) => boolean;
+/** The reason every stall abandonment carries, and the prefix that counts them. */
+export declare const IMPROVE_CONVERT_STALL_REASON = "convert stalled";
+/** The reason `--fresh` writes when it rotates the base key away from a conversion. */
+export declare const IMPROVE_FRESH_ABANDON_REASON = "fresh requested after recorded conversion remained unavailable";
+export declare const improveConvertStallReason: (seconds: number) => string;
+/**
+ * How many conversions this KIT has already bought and abandoned to a stall.
+ *
+ * The retry used to be bounded per process and keyed on `randomUUID()`, so
+ * nothing about it survived the invocation: on the resume STALL.md asks for,
+ * attempt 1 rebuilt the deterministic base key, the server's dedupe attached it
+ * to the FIRST, known-stalled conversion, and the run waited out the whole bound
+ * on a run it had already declared dead before dispatching a third under
+ * another random key. Counting the durable abandonments makes the retry's
+ * identity reproducible across invocations and makes the bound a property of
+ * the kit rather than of one shell.
+ *
+ * The attempt ledger is counted alongside them, and the larger wins: a stall
+ * whose conversion never reported an id cannot be abandoned by id, so counting
+ * abandonments alone read that spend as zero and let the next resume buy
+ * another retry, and the one after that, forever.
+ */
+export declare const improveConvertStallCount: (record: ImproveRecord) => number;
+/**
+ * The idempotency key of the Nth conversion dispatched under one attempt key.
+ * The first is the key itself — the base key, or the `--fresh` key this
+ * invocation is spending — and every later one is derived from the count of
+ * stalls that preceded it, so two invocations of the same kit compute the same
+ * key for the same conversion even with no ledger to read.
+ */
+export declare const improveConvertRetryKey: (key: string, index: number) => string;
+/** Why the resume reaches the conversion it reaches. */
+export type ImproveResumeReason = 'settled' | 'fresh' | 'stall-retry' | 'fresh-rotated-away';
+/** The id is absent when the attempt is recorded but never reported one. */
+export type ImproveResumeConversion = {
+    id?: string;
+    reason: ImproveResumeReason;
+};
+/**
+ * The conversion a `--from convert` resume will attach to, read off the record.
+ *
+ * A resume never names an id. It rebuilds an idempotency key and the server's
+ * dedupe decides which conversion that key reaches, so this reads the key rules
+ * above backwards:
+ * - a settled convert block: the stage replays and buys nothing;
+ * - an open attempt in the ledger: the resume rebuilds the exact key that
+ *   attempt was dispatched under, whether `--fresh` or the stall retry minted
+ *   it, and lands back on the conversion it is still waiting for;
+ * - a kit that abandoned conversions to a stall with no ledger to read (one
+ *   written before the ledger existed): `improveConvertRetryKey` reaches the
+ *   newest of them, which is also what the base key reaches when only one was
+ *   abandoned;
+ * - a kit whose base-key conversion `--fresh` rotated away from, again with no
+ *   ledger: the resume rebuilds that base key and lands back on it.
+ *
+ * `fresh-rotated-away` is the only reading that leaves a conversion nothing can
+ * reach, and it now belongs to pre-ledger kits alone. The ledger is what ended
+ * it: the nonce is on the record before the conversion is dispatched.
+ */
+export declare const improveResumeConversion: (record: ImproveRecord) => ImproveResumeConversion | undefined;
+/**
+ * The end of the line: this kit has spent every conversion the stall budget
+ * allows. It reads as a stall so the terminal event, `plan/STALL.md` and the
+ * recovery commands are all written exactly as a first stall's are.
+ */
+export declare const improveConvertStallExhausted: (args: {
+    seconds: number;
+    bought: number;
+    model: ConversionModel;
+    cause: unknown;
+}) => Error;
+export declare const improveErrorText: (error: unknown) => string;
+export declare const isImproveTemporarilyUnavailable: (error: unknown) => boolean;
+export declare const retryImproveTemporarilyUnavailable: <T>(args: {
+    stage: string;
+    action: () => Promise<T>;
+    sleep?: (milliseconds: number) => Promise<void>;
+    warn?: (line: string) => void;
+}) => Promise<T>;
+export declare const improveStalled: (error: unknown) => boolean;
+export declare const improveConversionIdFromText: (value: string) => string | undefined;
+export declare const recordedImproveConversionId: (record: ImproveRecord) => Promise<string | undefined>;
+export declare const responsiveFallbackReason: (error: unknown) => string | undefined;
+export declare const fixedImproveHtml: (targetDir: string) => Promise<{
+    html: string;
+    assets: string;
+}>;
+/**
+ * Clear the target directory between two attempts of the SAME transaction. The
+ * backup taken by `prepareImproveTargetAttempt` is untouched, so the previous
+ * good target is still recoverable; only the half-written attempt goes.
+ */
+export declare const resetImproveTargetAttempt: (targetDir: string) => Promise<void>;
+export declare const prepareImproveTargetAttempt: (targetDir: string) => Promise<{
+    commit: () => Promise<void>;
+    restore: () => Promise<void>;
+}>;
+//# sourceMappingURL=improve-convert-resilience.d.ts.map

package/dist/improve-convert-resilience.d.ts.map

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