@12ui/design 0.2.55 → 0.2.57

package/dist/improve-plan-annotator.js

@@ -1,42 +1,10 @@
 import { mkdir, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { buildImproveAddedElementSpecs } from './improve-added-specs.js';
-import { selectorLabel } from './improve-dom-anchor.js';
-import { formatImproveSourceHint, indexImproveSourceRepo, resolveImproveSourceHint, } from './improve-source-hints.js';
+import { readImproveKitAssets } from './improve-kit-assets.js';
+import { renderImproveAnnotatedPlan, } from './improve-plan-annotated-render.js';
+import { indexImproveSourceRepo, resolveImproveSourceHint, } from './improve-source-hints.js';
 import { buildImproveTokenPatch } from './improve-token-patch.js';
-const renderAnnotatedPlan = (args) => {
-    const lines = [
-        '# Annotated implementation plan', '',
-        `- Mode: **${args.mode}**`,
-        `- Coverage: ${(args.computed.domCoverage * 100).toFixed(1)}% before-side; ${(args.computed.designCoverage * 100).toFixed(1)}% target-side`,
-        `- Source repository: ${args.repo ? `\`${args.repo}\`` : 'not supplied; file hints are unresolved'}`, '',
-        '## Tokens — apply once', '',
-        '- Apply `token-patch.css` through the existing global token or theme entry point.',
-    ];
-    if (args.tokenPatch.tokens.length === 0) {
-        lines.push('- No recurring CSS-capable delta reached the two-node threshold.');
-    }
-    else {
-        lines.push(...args.tokenPatch.tokens.map((token) => (`- \`${token.name}: ${token.value}\` — ${token.count} matched changes; selectors: ${token.selectors.join(', ')}.`)));
-    }
-    lines.push('', '## Matched changes', '');
-    const changed = args.entries.filter((entry) => entry.changed || (entry.impliedPadding?.length ?? 0) > 0);
-    lines.push(...(changed.length > 0 ? changed.map((entry) => {
-        const leaf = args.computed.beforeLeaves[entry.beforeIndex];
-        const changes = [
-            ...entry.deltas.map((delta) => `${delta.field} ${JSON.stringify(delta.before)}→${JSON.stringify(delta.after)}`),
-            ...(entry.impliedPadding ?? []).map((delta) => `${delta.field} ${delta.before}px→${delta.after}px (${delta.basis})`),
-        ];
-        return `- ${selectorLabel(leaf)} — ${formatImproveSourceHint(entry.sourceHint)}: ${changes.join(', ')}`;
-    }) : ['_No actionable matched changes._']));
-    lines.push('', '## Added elements — full target specs', '');
-    if (args.addedSpecs.length === 0)
-        lines.push('_None._');
-    else
-        args.addedSpecs.forEach((spec) => lines.push(spec.markdown, ''));
-    lines.push('## Implementation guardrails', '', '- Preserve all real content, data, and controls. Do not fabricate product features or copy.', '- In Tailwind v4, verify arbitrary custom-property forms against the installed compiler before using them.', '- Quote CSS `url(...)` values when paths contain punctuation or whitespace.', '- Update the page content-security policy before introducing any data URI.', '- Implement silently. Log only adapted or skipped items and the reason.', '');
-    return lines.join('\n');
-};
 export const writeImproveAnnotatedPlan = async (args) => {
     await mkdir(args.outDir, { recursive: true });
     const sourceIndex = args.repo ? indexImproveSourceRepo(args.repo) : { files: [] };
@@ -45,24 +13,32 @@ export const writeImproveAnnotatedPlan = async (args) => {
         sourceHint: resolveImproveSourceHint(args.computed.beforeLeaves[entry.beforeIndex], sourceIndex, args.computed.beforeLeaves),
     }));
     const tokenPatch = buildImproveTokenPatch(entries, args.computed.beforeLeaves, args.computed.targetLeaves);
-    const addedSpecs = await buildImproveAddedElementSpecs({
-        targetDoc: args.targetDoc,
-        designPath: args.targetPath,
-        normalizedTarget: args.computed.targetLeaves,
-        before: args.computed.beforeLeaves,
-        canvas: args.computed.beforeCanvas,
-        diff: args.computed.result,
-        outDir: args.outDir,
-    });
+    const [addedSpecs, index] = await Promise.all([
+        buildImproveAddedElementSpecs({
+            targetDoc: args.targetDoc,
+            designPath: args.targetPath,
+            normalizedTarget: args.computed.targetLeaves,
+            before: args.computed.beforeLeaves,
+            canvas: args.computed.beforeCanvas,
+            diff: args.computed.result,
+            outDir: args.outDir,
+        }),
+        readImproveKitAssets({
+            runDir: path.dirname(args.outDir),
+            layerDocPath: args.targetPath,
+            document: args.targetDoc,
+        }),
+    ]);
     const planPath = path.join(args.outDir, 'plan-annotated.md');
     const tokenPath = path.join(args.outDir, 'token-patch.css');
     await Promise.all([
         writeFile(tokenPath, tokenPatch.css, 'utf8'),
-        writeFile(planPath, renderAnnotatedPlan({
+        writeFile(planPath, renderImproveAnnotatedPlan({
             computed: args.computed,
             entries,
             tokenPatch,
             addedSpecs,
+            index,
             ...(args.repo ? { repo: args.repo } : {}),
             mode: args.mode,
         }), 'utf8'),
@@ -70,6 +46,7 @@ export const writeImproveAnnotatedPlan = async (args) => {
     return {
         planPath,
         tokenPath,
+        fonts: tokenPatch.fontLoads,
         artifacts: [
             planPath,
             tokenPath,

package/dist/improve-plan-annotator.js.map

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

package/dist/improve-raster-layers-section.d.ts

@@ -0,0 +1,21 @@
+import { type ImproveRasterLayer } from './improve-kit-assets.js';
+/**
+ * "Raster layers to carry" — the section that has to come first.
+ *
+ * A hero can be a single raster plate. When it is, the only correct action is
+ * to copy that file into the repository and reference it; a lane that reads
+ * thirty token lines before it reaches the hero has already started drawing
+ * gradients. So this renders ahead of tokens in the plan, and it is also the
+ * one section a stalled run can still emit from a LayerDoc alone.
+ *
+ * "Never skip one" binds every line it prints, so an alternate backdrop — a
+ * plate the README says to use only if its layer is omitted — is filtered out
+ * here rather than contradicted two files apart.
+ */
+export declare const IMPROVE_RASTER_SECTION_TITLE = "Raster layers to carry";
+export declare const renderImproveRasterLayers: (args: {
+    layers: readonly ImproveRasterLayer[];
+    /** Where the layer lands in the page, when the diff anchored it to a selector. */
+    placement?: (layer: ImproveRasterLayer) => string | undefined;
+}) => string[];
+//# sourceMappingURL=improve-raster-layers-section.d.ts.map

package/dist/improve-raster-layers-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-raster-layers-section.d.ts","sourceRoot":"","sources":["../src/improve-raster-layers-section.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAErE,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAC9C,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtC,kFAAkF;IAClF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,GAAG,SAAS,CAAC;CAC/D,KAAG,MAAM,EAkCT,CAAC"}

package/dist/improve-raster-layers-section.js

@@ -0,0 +1,45 @@
+import { formatImproveBounds, improveCarriedRasterLayers, isImproveAlternateBackdrop, } from './improve-kit-assets.js';
+/**
+ * "Raster layers to carry" — the section that has to come first.
+ *
+ * A hero can be a single raster plate. When it is, the only correct action is
+ * to copy that file into the repository and reference it; a lane that reads
+ * thirty token lines before it reaches the hero has already started drawing
+ * gradients. So this renders ahead of tokens in the plan, and it is also the
+ * one section a stalled run can still emit from a LayerDoc alone.
+ *
+ * "Never skip one" binds every line it prints, so an alternate backdrop — a
+ * plate the README says to use only if its layer is omitted — is filtered out
+ * here rather than contradicted two files apart.
+ */
+export const IMPROVE_RASTER_SECTION_TITLE = 'Raster layers to carry';
+export const renderImproveRasterLayers = (args) => {
+    const lines = [
+        `## ${IMPROVE_RASTER_SECTION_TITLE}`,
+        '',
+        'Copy each file into the repository and reference it at its bounds.'
+            + ' Never redraw one of these in CSS, and never skip one.',
+        '',
+    ];
+    const layers = improveCarriedRasterLayers(args.layers);
+    if (layers.length === 0) {
+        lines.push('_The target LayerDoc declares no raster layer._', '');
+        return lines;
+    }
+    for (const layer of layers) {
+        const placement = args.placement?.(layer);
+        lines.push(`- **${layer.kind}** — ${layer.name}${layer.hero ? ' (hero imagery)' : ''}`, layer.asset
+            ? `  - Asset: \`${layer.asset.file}\` — ${layer.asset.roleLabel}`
+            : '  - Asset: declared by the LayerDoc but not present in this kit; resume the run before coding.', `  - Bounds: ${formatImproveBounds(layer.bounds)}`, `  - Place at: ${placement ?? 'new element — place it at the bounds above'}`, ...(() => {
+            const alternates = layer.alternates.filter((asset) => !isImproveAlternateBackdrop(asset));
+            return alternates.length > 0
+                ? [`  - Also available: ${alternates
+                        .map((asset) => `\`${asset.file}\` (${asset.roleLabel})`)
+                        .join(', ')} — pick one resolution.`]
+                : [];
+        })());
+    }
+    lines.push('');
+    return lines;
+};
+//# sourceMappingURL=improve-raster-layers-section.js.map

package/dist/improve-raster-layers-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-raster-layers-section.js","sourceRoot":"","sources":["../src/improve-raster-layers-section.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAErE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAIzC,EAAY,EAAE;IACb,MAAM,KAAK,GAAG;QACZ,MAAM,4BAA4B,EAAE;QACpC,EAAE;QACF,oEAAoE;cAClE,wDAAwD;QAC1D,EAAE;KACH,CAAC;IACF,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,iDAAiD,EAAE,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CACR,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,EAC3E,KAAK,CAAC,KAAK;YACT,CAAC,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE;YACjE,CAAC,CAAC,gGAAgG,EACpG,eAAe,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAClD,iBAAiB,SAAS,IAAI,4CAA4C,EAAE,EAC5E,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1F,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC1B,CAAC,CAAC,CAAC,uBAAuB,UAAU;yBACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,SAAS,GAAG,CAAC;yBACxD,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC;gBACvC,CAAC,CAAC,EAAE,CAAC;QACT,CAAC,CAAC,EAAE,CACL,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/improve-reset.d.ts

@@ -0,0 +1,122 @@
+import { type ImproveConversionAttempt } from './improve-conversion-attempts.js';
+import { type ImproveRecord, type ImproveStage } from './improve-workspace.js';
+/**
+ * What improve throws away, and what it writes down before it does.
+ *
+ * Three paths discard work that was already dispatched — `--fresh`, the
+ * asset-stage stall retry, and a re-pick that changes the winner — and each one
+ * used to discard it a slightly different way. They now share this module, so
+ * the ownership rule is stated once: a conversion the CLI walks away from is
+ * recorded in `improve.json` by id, with the reason, before anything is
+ * deleted.
+ *
+ * THE MONEY TRUTH, stated plainly because the opposite reading is tempting.
+ * The hosted conversion API has no cancel or abort verb: `GET
+ * /api/v1/convert/{id}` is the whole item surface, and the one DELETE on the
+ * family hides a history row for a principal. So the CLI cannot stop an
+ * abandoned run, and stopping the poll saves nothing — the polls are free
+ * authenticated reads. The abandoned conversion runs to completion server-side
+ * and bills either way. What actually saves money is not dispatching a
+ * conversion nobody chose, which is why `--pick` is now required before the
+ * convert stage. Everything here is bookkeeping so the owner can SEE what was
+ * paid for and dropped.
+ */
+export type ImproveAbandonedConversion = NonNullable<ImproveRecord['abandonedConversions']>[number];
+/** Append one abandonment, deduped by id — two writers can name the same run. */
+export declare const noteAbandonedConversion: (record: ImproveRecord, entry: ImproveAbandonedConversion) => ImproveRecord;
+/** One wording for "this kit walked away from a conversion that keeps billing". */
+export declare const abandonedConversionLine: (args: {
+    id: string;
+    reason: string;
+}) => string;
+/**
+ * Record the conversion this record is about to stop caring about, if the run
+ * ever told us its id. It may not have: a stall before the first status read
+ * leaves `improve.json` with no convert block and the journal with no run id,
+ * and the kit has to be able to say "a conversion may still be running; its id
+ * was not recorded" rather than implying nothing was bought.
+ */
+export declare const abandonImproveConversion: (args: {
+    record: ImproveRecord;
+    reason: string;
+    /** The id the caller already holds — an attempt's run id, say. */
+    id?: string;
+    warn?: (line: string) => void;
+}) => Promise<{
+    record: ImproveRecord;
+    id?: string;
+}>;
+/**
+ * Attempts a caller has already closed in `conversionAttempts` also belong in
+ * `abandonedConversions` — the ledger the owner reads for what is still billing
+ * — whenever the kit ever learned their id. An attempt that never reported one
+ * is recorded by key alone, which is the honest record: there is nothing to name.
+ */
+export declare const noteAbandonedAttempts: (args: {
+    record: ImproveRecord;
+    attempts: readonly ImproveConversionAttempt[];
+    reason: string;
+    warn?: (line: string) => void;
+}) => ImproveRecord;
+/**
+ * The same abandonment, extended to every attempt the kit still had open.
+ *
+ * A path that discards the WINNER — a redraw, a re-pick, a stall — discards the
+ * conversions of it too, and those are recorded by key in `conversionAttempts`
+ * (`improve-conversion-attempts.ts`) as well as by id here. Leaving one open
+ * would point the next resume at a conversion of a design nobody chose.
+ *
+ * `--fresh` is deliberately NOT a caller: it closes the attempt it replaces at
+ * dispatch, where the key it is about to use is known and can be spared. Doing
+ * it here instead would close that same key on the stage replay the
+ * temporarily-unavailable retry performs.
+ */
+export declare const abandonImproveConversions: (args: {
+    record: ImproveRecord;
+    reason: string;
+    id?: string;
+    warn?: (line: string) => void;
+}) => Promise<{
+    record: ImproveRecord;
+    id?: string;
+}>;
+/**
+ * What the owner has to be able to SEE: every conversion this kit paid for and
+ * walked away from, by id, with why. There is no cancel, so each of these is
+ * still running and still billing somewhere.
+ */
+export declare const improveAbandonedLines: (record: ImproveRecord) => string[];
+/** Drop the named stages from the record and from its settlement ledger. */
+export declare const withoutImproveStages: (record: ImproveRecord, stages: readonly ImproveStage[]) => ImproveRecord;
+/**
+ * What a redraw is allowed to change about the draw it is replacing. Only the
+ * fields the caller passed explicitly appear here: a redraw that quietly reset
+ * `--candidates` to the default because the flag was absent would buy a
+ * different draw than the one asked for.
+ */
+export type ImproveRedraw = Partial<Pick<ImproveRecord, 'direction' | 'concept' | 'candidates' | 'retain' | 'retainFlag'>>;
+export declare const REDRAW_ABANDON_REASON = "redraw discarded the draw this conversion was made from";
+/**
+ * `--redraw`: buy a whole new draw of candidates from the same capture.
+ *
+ * `--fresh` rotates the conversion key and nothing else — it re-buys ONE
+ * conversion of the same settled winner. A caller who wanted different
+ * candidates had no flag at all, and `--fresh` was the nearest-looking one. The
+ * old draw is renamed rather than deleted: a reader may still want the
+ * candidate they were about to pick, and a destroyed directory cannot be got
+ * back for the price of a rename.
+ *
+ * This was the fourth path that walked away from paid work and the only one
+ * that did not write it down: it removed `target/` while
+ * `convert.sourceConversionId` was still in hand, so a settled conversion the
+ * kit had bought vanished from the ledger the module header above declares.
+ */
+export declare const resetImproveDraw: (args: {
+    record: ImproveRecord;
+    draw?: ImproveRedraw;
+    warn?: (line: string) => void;
+}) => Promise<{
+    record: ImproveRecord;
+    abandonedId?: string;
+}>;
+//# sourceMappingURL=improve-reset.d.ts.map

package/dist/improve-reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-reset.d.ts","sourceRoot":"","sources":["../src/improve-reset.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpG,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,aAAa,EACrB,OAAO,0BAA0B,KAChC,aAKF,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAG,MAE9E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,KAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAUjD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,KAAG,aAUW,CAAC;AAEhB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,KAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAUjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,aAAa,KAAG,MAAM,EAQnE,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,EACrB,QAAQ,SAAS,YAAY,EAAE,KAC9B,aASD,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CACjC,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC,CACtF,CAAC;AAEF,eAAO,MAAM,qBAAqB,4DAA4D,CAAC;AAE/F;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAU,MAAM;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,KAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAsB1D,CAAC"}

package/dist/improve-reset.js

@@ -0,0 +1,141 @@
+import { rename, rm, stat } from 'node:fs/promises';
+import { abandonImproveConversionAttempts, } from './improve-conversion-attempts.js';
+import { recordedImproveConversionId } from './improve-convert-resilience.js';
+import { improvePaths } from './improve-workspace.js';
+/** Append one abandonment, deduped by id — two writers can name the same run. */
+export const noteAbandonedConversion = (record, entry) => {
+    const abandoned = [...(record.abandonedConversions ?? [])];
+    if (abandoned.some((existing) => existing.id === entry.id))
+        return record;
+    abandoned.push(entry);
+    return { ...record, abandonedConversions: abandoned };
+};
+/** One wording for "this kit walked away from a conversion that keeps billing". */
+export const abandonedConversionLine = (args) => (`[abandon] convert: ${args.reason}; conversion ${args.id} keeps running and keeps billing`);
+/**
+ * Record the conversion this record is about to stop caring about, if the run
+ * ever told us its id. It may not have: a stall before the first status read
+ * leaves `improve.json` with no convert block and the journal with no run id,
+ * and the kit has to be able to say "a conversion may still be running; its id
+ * was not recorded" rather than implying nothing was bought.
+ */
+export const abandonImproveConversion = async (args) => {
+    const id = args.id ?? await recordedImproveConversionId(args.record);
+    if (!id)
+        return { record: args.record };
+    const record = noteAbandonedConversion(args.record, {
+        id,
+        abandonedAt: new Date().toISOString(),
+        reason: args.reason,
+    });
+    if (record !== args.record)
+        args.warn?.(abandonedConversionLine({ id, reason: args.reason }));
+    return { record, id };
+};
+/**
+ * Attempts a caller has already closed in `conversionAttempts` also belong in
+ * `abandonedConversions` — the ledger the owner reads for what is still billing
+ * — whenever the kit ever learned their id. An attempt that never reported one
+ * is recorded by key alone, which is the honest record: there is nothing to name.
+ */
+export const noteAbandonedAttempts = (args) => args.attempts.reduce((carried, attempt) => {
+    if (!attempt.conversionId)
+        return carried;
+    const reason = attempt.abandonedReason ?? args.reason;
+    const noted = noteAbandonedConversion(carried, {
+        id: attempt.conversionId,
+        abandonedAt: attempt.abandonedAt ?? new Date().toISOString(),
+        reason,
+    });
+    if (noted !== carried)
+        args.warn?.(abandonedConversionLine({ id: attempt.conversionId, reason }));
+    return noted;
+}, args.record);
+/**
+ * The same abandonment, extended to every attempt the kit still had open.
+ *
+ * A path that discards the WINNER — a redraw, a re-pick, a stall — discards the
+ * conversions of it too, and those are recorded by key in `conversionAttempts`
+ * (`improve-conversion-attempts.ts`) as well as by id here. Leaving one open
+ * would point the next resume at a conversion of a design nobody chose.
+ *
+ * `--fresh` is deliberately NOT a caller: it closes the attempt it replaces at
+ * dispatch, where the key it is about to use is known and can be spared. Doing
+ * it here instead would close that same key on the stage replay the
+ * temporarily-unavailable retry performs.
+ */
+export const abandonImproveConversions = async (args) => {
+    const abandoned = await abandonImproveConversion(args);
+    const closed = abandonImproveConversionAttempts(abandoned.record, { reason: args.reason });
+    const record = noteAbandonedAttempts({
+        record: closed.record,
+        attempts: closed.abandoned,
+        reason: args.reason,
+        ...(args.warn ? { warn: args.warn } : {}),
+    });
+    return { record, ...(abandoned.id ? { id: abandoned.id } : {}) };
+};
+/**
+ * What the owner has to be able to SEE: every conversion this kit paid for and
+ * walked away from, by id, with why. There is no cancel, so each of these is
+ * still running and still billing somewhere.
+ */
+export const improveAbandonedLines = (record) => {
+    const abandoned = record.abandonedConversions ?? [];
+    if (abandoned.length === 0)
+        return [];
+    return [
+        `- Abandoned ${abandoned.length} conversion${abandoned.length === 1 ? '' : 's'}`
+            + ' (each keeps running and keeps billing; there is no cancel):',
+        ...abandoned.map((entry) => `  - \`${entry.id}\` — ${entry.reason}`),
+    ];
+};
+/** Drop the named stages from the record and from its settlement ledger. */
+export const withoutImproveStages = (record, stages) => ({
+    ...record,
+    ...(stages.includes('draft') ? { draft: undefined } : {}),
+    ...(stages.includes('pick') ? { pick: undefined } : {}),
+    ...(stages.includes('convert') ? { convert: undefined } : {}),
+    ...(stages.includes('plan') ? { plan: undefined } : {}),
+    stages: Object.fromEntries(Object.entries(record.stages).filter(([stage]) => !stages.includes(stage))),
+});
+export const REDRAW_ABANDON_REASON = 'redraw discarded the draw this conversion was made from';
+/**
+ * `--redraw`: buy a whole new draw of candidates from the same capture.
+ *
+ * `--fresh` rotates the conversion key and nothing else — it re-buys ONE
+ * conversion of the same settled winner. A caller who wanted different
+ * candidates had no flag at all, and `--fresh` was the nearest-looking one. The
+ * old draw is renamed rather than deleted: a reader may still want the
+ * candidate they were about to pick, and a destroyed directory cannot be got
+ * back for the price of a rename.
+ *
+ * This was the fourth path that walked away from paid work and the only one
+ * that did not write it down: it removed `target/` while
+ * `convert.sourceConversionId` was still in hand, so a settled conversion the
+ * kit had bought vanished from the ledger the module header above declares.
+ */
+export const resetImproveDraw = async (args) => {
+    const paths = improvePaths(args.record.runDir);
+    const abandoned = await abandonImproveConversions({
+        record: args.record,
+        reason: REDRAW_ABANDON_REASON,
+        ...(args.warn ? { warn: args.warn } : {}),
+    });
+    const previous = `${paths.candidatesDir}.previous`;
+    if (await stat(paths.candidatesDir).catch(() => undefined)) {
+        await rm(previous, { recursive: true, force: true });
+        await rename(paths.candidatesDir, previous);
+    }
+    await Promise.all([
+        rm(paths.winnerImage, { force: true }),
+        rm(paths.targetDir, { recursive: true, force: true }),
+        rm(paths.planDir, { recursive: true, force: true }),
+    ]);
+    const carried = withoutImproveStages(abandoned.record, ['draft', 'pick', 'convert', 'plan']);
+    return {
+        record: { ...carried, ...args.draw },
+        ...(abandoned.id ? { abandonedId: abandoned.id } : {}),
+    };
+};
+//# sourceMappingURL=improve-reset.js.map

package/dist/improve-reset.js.map

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

package/dist/improve-run-summary.d.ts

@@ -0,0 +1,35 @@
+import { type ImproveKitAssetIndex } from './improve-kit-assets.js';
+import { type ImproveKitStatus } from './improve-kit-status.js';
+import type { ImproveOptions } from './improve-options.js';
+import { type ImproveRecord, type ImproveStage } from './improve-workspace.js';
+/**
+ * What a run prints when the draw is ready and nobody has chosen.
+ *
+ * This is the whole point of the dispatch-discipline change, so it has to leave
+ * the reader with two things and nothing else: where the candidates are, and
+ * the one command that continues from here. It is a finished run, not a
+ * failure — the stages that were asked for and could run, ran.
+ */
+export declare const awaitingImprovePick: (args: {
+    record: ImproveRecord;
+    options: Pick<ImproveOptions, "paths" | "input">;
+}) => string;
+export declare const renderImproveRunSummary: (args: {
+    record: ImproveRecord;
+    status: ImproveKitStatus;
+    index: ImproveKitAssetIndex;
+}) => string;
+export declare const buildImproveRunSummary: (args: {
+    record: ImproveRecord;
+    requestedTo?: ImproveStage;
+}) => Promise<string>;
+/**
+ * Put the summary AFTER the failure text.
+ *
+ * `cli.ts` prints `error.message` last, so a summary written to stdout before
+ * the throw leaves the reader's final line as the error rather than
+ * "Next: read <kit>/README.md" — which is the line the summary exists to
+ * leave there. Carrying it in the message is what keeps the order right.
+ */
+export declare const improveStallErrorWithSummary: (error: unknown, summary: string) => unknown;
+//# sourceMappingURL=improve-run-summary.d.ts.map

package/dist/improve-run-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-run-summary.d.ts","sourceRoot":"","sources":["../src/improve-run-summary.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAmE7F;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;CAClD,KAAG,MAeH,CAAC;AAmBF,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAuCH,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,KAAG,OAAO,CAAC,MAAM,CAUjB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GAAI,OAAO,OAAO,EAAE,SAAS,MAAM,KAAG,OAM9E,CAAC"}