@12ui/design 0.2.55 → 0.2.57

package/dist/improve-kit-readme.js

@@ -1,32 +1,288 @@
 import { writeFile } from 'node:fs/promises';
 import path from 'node:path';
-export const writeImproveReadme = async (record) => {
-    const readme = path.join(record.runDir, 'README.md');
+import { IMPROVE_ASSET_ROLE_COPY, IMPROVE_SCRIM_MAX_OPACITY_PCT, improveFrameMappingLine, readImproveKitAssets, } from './improve-kit-assets.js';
+import { IMPROVE_AWAITING_PICK_RULE, IMPROVE_NO_APPROXIMATION_RULE, improveAwaitingPick, improveRecoveryLine, improveStageStatusLine, readImproveKitStatus, } from './improve-kit-status.js';
+import { improveCapturedUrlLine } from './improve-capture-redirect.js';
+import { improveKitIgnoreStatusLine } from './improve-kit-ignore.js';
+import { improveAbandonedLines } from './improve-reset.js';
+import { improvePaths } from './improve-workspace.js';
+/**
+ * The kit's front door.
+ *
+ * It used to open with the directory anatomy, which answers a question nobody
+ * had. What two lanes actually needed, and did not get, was: did this run
+ * finish, what are these PNGs, and which of them must never be thrown away.
+ * Those three answers now come first, and the anatomy comes last.
+ */
+/** The file-name shape a reader sees, per role, in the order the glossary reads best. */
+const ROLE_GLOSSARY = [
+    { role: 'clean-plate', pattern: 'clean-N' },
+    { role: 'cutout', pattern: 'cutout-N' },
+    { role: 'upscaled-plate', pattern: 'upscaled-plate-N' },
+    { role: 'upscaled-region', pattern: 'upscaled-region-N' },
+    { role: 'source-crop', pattern: 'crop-N' },
+];
+/**
+ * One sentence, wherever a resolved `plan/STALL.md` sits under this README.
+ *
+ * Freshdesk shipped a settled plan whose README said "settled" and whose
+ * STALL.md said "INCOMPLETE — no plan"; nothing in the kit said which was
+ * current (F21). The file is replaced when the stage settles, and the README
+ * says what it now is instead of pointing at it as a live stall.
+ */
+const improveResolvedStallLines = (status) => (status.present.stallResolved
+    ? ['', '`plan/STALL.md` records an earlier stall in this kit that has since resolved.'
+            + ' The plan and target here are current.']
+    : []);
+const statusSection = (args) => {
+    const lines = ['## Status', ''];
+    lines.push(...args.status.stages.map((stage) => `- ${improveStageStatusLine(stage)}`));
+    lines.push(`- Target: ${args.status.targetMode}`);
+    // The page this kit is actually about, whenever it is not the page that was
+    // asked for (F27). It goes in the status block, above everything a reader
+    // would otherwise act on, because every artifact below describes it.
+    const captured = improveCapturedUrlLine(args.record);
+    if (captured)
+        lines.push(`- ${captured}`);
+    // Where the kit sits relative to the repository being improved, because a
+    // committed kit is 100 MB of paid artifacts in someone's history (F17).
+    const ignore = improveKitIgnoreStatusLine(args.record.kitIgnore);
+    if (ignore)
+        lines.push(`- ${ignore}`);
+    lines.push(...improveAbandonedLines(args.record));
+    if (args.status.complete) {
+        lines.push('', ...(args.status.gateBlocked
+            ? ['The coverage gate blocked the anchored plan: `plan/GATE.md` replaced `plan-annotated.md`'
+                    + ' and `token-patch.css`. Read `plan/GATE.md` before touching code; the target, its assets'
+                    + ' and the raster layers it names are all still here.']
+            : args.record.convert?.layout === 'fixed'
+                // The event, not just the outcome (F8): a lane that watched a silent
+                // wait needs the kit to confirm the responsive export stalled, and
+                // `plan/STALL.md` is where the timings and the collect-it-later
+                // command live.
+                ? ['Responsive export stalled; the plan was built from the fixed-layout fallback.'
+                        + ' The target HTML is fixed-layout, not responsive, and the LayerDoc and its assets'
+                        + ' are the full-quality source of truth.',
+                    ...(args.status.present.stall
+                        ? ['', 'See `plan/STALL.md` for what stalled, how long it waited, and how to collect'
+                                + ' the responsive export later if it completes.']
+                        : [])]
+                // A complete kit that still has a STALL.md stalled once and then
+                // settled. Saying only "the kit is complete" left the reader to
+                // adjudicate this README against a file that said INCOMPLETE (F21).
+                : ['Every requested stage settled. The kit is complete.',
+                    ...improveResolvedStallLines(args.status)]), '');
+        return lines;
+    }
+    lines.push('', `This kit is INCOMPLETE: ${args.status.missing.join(', ')}.`, ...(args.status.present.stall && !args.status.present.stallResolved
+        ? ['', 'See `plan/STALL.md` for what the run was waiting on.']
+        : improveResolvedStallLines(args.status)), '', 
+    // A never-picked kit has one recovery, and it is not a resume: heading it
+    // "the first resumes" over a single `--from pick` line reads as a stall.
+    ...(improveAwaitingPick(args.record)
+        ? [IMPROVE_AWAITING_PICK_RULE, '', 'Recovery — pick a candidate; convert and plan run from there:']
+        : ['Recovery, in order — the first resumes and replays every settled stage:']), '', ...args.status.recovery.map(improveRecoveryLine), '', IMPROVE_NO_APPROXIMATION_RULE, '');
+    return lines;
+};
+const startHere = (args) => {
+    const design = path.relative(args.record.runDir, args.status.designImage);
+    const hasAssets = args.index.assets.length > 0;
+    // A gate block deletes the two files steps 3 and 4 name. Sending a reader to
+    // them is how a kit gets abandoned with its assets unread.
+    const planSteps = args.status.gateBlocked
+        ? ['3. Read `plan/GATE.md`. It says why no selector-anchored plan was emitted, and what to'
+                + ' re-capture; the raster layers it lists are still the design.']
+        : [
+            '3. Apply `plan/token-patch.css` once, at the token layer, not per element.',
+            '4. Work `plan/plan-annotated.md` in its own order: raster layers, then matched changes,'
+                + ' then added elements.',
+        ];
+    const frame = args.record.capture
+        ? { width: args.record.capture.width, height: args.record.capture.height }
+        : args.record.viewport;
+    return [
+        '## Start here',
+        '',
+        ...(args.status.complete
+            ? []
+            : [args.status.gateBlocked
+                    ? 'Run the recovery above first: the steps below assume a target this kit has not finished.'
+                    : improveAwaitingPick(args.record)
+                        ? 'Pick a candidate first (command above); steps 2 to 4 need the target that the pick produces.'
+                        : hasAssets
+                            ? 'Run the recovery above first: steps 3 and 4 need a plan this kit does not have yet.'
+                            : 'Run the recovery above first: steps 2 to 4 need a target this kit does not have yet.', '']),
+        // The frame a bound belongs to, before the first step that places anything:
+        // a lane read these percentages as `winner.png` pixels and placed short.
+        improveFrameMappingLine({
+            ...(frame ? { frame } : {}),
+            ...(args.index.canvas ? { design: args.index.canvas } : {}),
+        }),
+        '',
+        // A never-picked kit has no winner, so `design` is the capture. Calling
+        // that "the design" is the same wrong turn the recovery block used to make.
+        improveAwaitingPick(args.record)
+            ? '1. Open the candidate PNGs in `candidates/` and pick one (command above).'
+                + ' `capture/source.png` is the page as it is today, not the design.'
+            : args.status.designKind === 'layerdoc'
+                ? `1. Open \`${design}\`. The supplied target document is the design.`
+                : `1. Open \`${design}\`. It is the design.`,
+        '2. Copy the files the assets table below marks ship into the repository;'
+            + ' the rest are references and alternates.',
+        ...planSteps,
+        `${args.status.gateBlocked ? '4' : '5'}. Before committing, screenshot the page and put it`
+            + ` beside \`${design}\`.`,
+        '',
+    ];
+};
+const assetRow = (asset) => {
+    const role = `${asset.roleLabel}${asset.hero ? ' — hero imagery' : ''}`;
+    const layer = asset.layer ? `${asset.layer.kind} — ${asset.layer.name}` : 'whole design';
+    const bounds = asset.bounds
+        ? `${asset.bounds.width.toFixed(1)}% × ${asset.bounds.height.toFixed(1)}%`
+            + ` at ${asset.bounds.x.toFixed(1)}%, ${asset.bounds.y.toFixed(1)}%`
+        : 'full canvas';
+    const instruction = asset.present
+        ? asset.instruction
+        : `${asset.instruction} (declared by the manifest but missing from this kit)`;
+    return `| \`${asset.file}\` | ${asset.ship} | ${role} | ${layer} | ${bounds} | ${instruction} |`;
+};
+const assetsSection = (args) => {
+    const design = path.relative(args.record.runDir, args.status.designImage);
     const lines = [
-        '# 12ui improve kit', '',
-        `Input: ${record.input.kind} \`${record.input.value}\``,
-        `Picked candidate: ${record.pick?.slot ?? (record.target ? 'bring-your-own target' : 'not yet picked')}`, '',
-        '## Anatomy', '',
-        '- `improve.json` is the durable stage, purchase, price-ceiling, and replay record.',
-        `- ${record.input.kind === 'url' ? '`capture/` and `current.domdoc.json` hold the screenshot and selector-verified DOM extraction.' : '`source.png` is the normalized source screenshot.'}`,
-        '- `candidates/` keeps every generated option and its draft record; `winner.png` is the explicit image target.',
-        '- `target/` holds the target LayerDoc, responsive HTML when generated, and extracted assets.',
-        '- `plan/` holds the diff, implementation plan, token patch, added-element assets, or `GATE.md` when anchoring was unsafe.', '',
-        ...(record.convert?.layout === 'fixed' ? [
-            '## Fixed-layout target', '',
-            `- Warning: ${record.convert.responsiveWarning ?? 'Responsive HTML was unavailable.'}`,
-            '- The target HTML is a fixed-layout fallback derived free from the successful LayerDoc conversion. It is not a responsive deliverable; the LayerDoc remains valid for planning.', '',
-        ] : []),
-        '## Next', '',
-        '- Treat the target HTML when present and `target/winner.layerdoc.json` as the visual source of truth.',
-        '- Apply the plan in the owning repository, then verify behavior and screenshots there. This kit never applies code.',
-        '- Re-run from `pick` with another `--pick` slot to reuse capture and candidates; settled paid stages replay.', '',
-        '## Guardrails', '',
-        '- Preserve all real content, data, and controls; invent nothing.',
-        '- Do not describe emptiness or thin content as a defect: that phrasing can invite fabricated UI.',
-        '- Verify Tailwind v4 arbitrary custom-property syntax, quote CSS `url(...)` values, and update CSP before introducing data URIs.', '',
+        '## Assets: what each file is',
+        '',
+        ...ROLE_GLOSSARY.map(({ role, pattern }) => `- ${IMPROVE_ASSET_ROLE_COPY[role].label}`
+            + ` (\`${pattern}\`): ${IMPROVE_ASSET_ROLE_COPY[role].instruction}`),
+        `- \`${design}\`: ${IMPROVE_ASSET_ROLE_COPY.design.instruction}`,
+        // F30: the single `currentColor` file the plan used to write rendered black
+        // in every external form this README recommends.
+        '- Icons (`plan/assets/added-*.svg`): reference `<name>.svg` — it carries the design\'s'
+            + ' declared colour and is safe as an `<img>`, `background-image`, or `url()`; its'
+            + ' `<name>-inline.svg` sibling paints with `currentColor` and is for inlining in the markup'
+            + ' or masking with a token colour.',
+        '',
     ];
-    await writeFile(readme, lines.join('\n'), 'utf8');
-    return readme;
+    if (args.index.assets.length === 0) {
+        lines.push(args.status.present.layerDoc
+            ? 'This kit has a LayerDoc but no extracted assets yet. Resume before coding.'
+            : 'This kit has no extracted assets yet. Resume before coding.', '');
+    }
+    else {
+        lines.push('Ordered by how much of the canvas the layer covers.', '', 'Ship means copy this file into the repository. An alternate resolution is the same layer at'
+            + ' another size — pick one. An alternate backdrop is the same plate with a further layer'
+            + ' removed as well — it is the background only if you omit that layer. A reference is read,'
+            + ' never shipped.', '', 'Plates and cutouts come out at full resolution and run over a megabyte. Pick one resolution'
+            + ' per layer and optimise the PNG — or convert it to WebP where the repository already uses'
+            + ' one — before committing. Keep the filename stem so the plan still matches.', '', '| File | Ship | Role | Layer | Bounds | What to do with it |', '| --- | --- | --- | --- | --- | --- |', `| \`${design}\` | reference only | winner.png — hero imagery | whole design |`
+            + ` 100.0% × 100.0% at 0.0%, 0.0% | ${IMPROVE_ASSET_ROLE_COPY.design.instruction} |`, ...args.index.assets.map(assetRow), '');
+    }
+    // Only the carrier a layer actually ships is a must-keep; the upscaled twin is
+    // an alternative resolution, and naming it here would contradict "ship one".
+    const heroes = args.index.rasterLayers
+        .filter((layer) => layer.hero && layer.asset)
+        .map((layer) => layer.asset);
+    lines.push('### Never discard', '', `- \`${design}\`.`, args.index.assets.length > 0
+        ? '- Every cutout and plate this table names.'
+        : '- Every cutout and plate the kit extracts once the run completes.', ...heroes.map((asset) => `  - Hero imagery: \`${asset.file}\` (${asset.roleLabel}).`), '- All real content, data, controls, routes, and tests.', '', `Scrims over a plate stay light (at most ${IMPROVE_SCRIM_MAX_OPACITY_PCT}% opacity), and the plan`
+        + ' must say why one is used.', '');
+    return lines;
+};
+const guardrails = () => [
+    '## Guardrails',
+    '',
+    '- Preserve all real content, data, and controls; invent nothing.',
+    '- Do not describe emptiness or thin content as a defect: that phrasing can invite fabricated UI.',
+    '- Verify Tailwind v4 arbitrary custom-property syntax, quote CSS `url(...)` values, and update CSP before introducing data URIs.',
+    '- Never use the raw candidate PNG as a shipped asset; ship the extracted cutouts and plates.',
+    '- Never scrim imagery away. A heavy overlay is a fidelity defect, not a readability fix.',
+    '- Do not add decoration the design does not contain.',
+    '',
+];
+const anatomy = (record) => [
+    '## Anatomy',
+    '',
+    '- `improve.json` is the durable stage, purchase, price-ceiling, and replay record.',
+    `- ${record.input.kind === 'url'
+        ? '`capture/` and `current.domdoc.json` hold the screenshot and selector-verified DOM extraction.'
+        : '`source.png` is the normalized source screenshot.'}`,
+    '- `candidates/` keeps every generated option and its draft record; `winner.png` is the explicit image target.',
+    '- `target/` holds the target LayerDoc, responsive HTML when generated, and extracted assets.',
+    '- `plan/` holds the diff, implementation plan, token patch, added-element assets, `GATE.md` when anchoring was unsafe, or `STALL.md` when a stage did not settle.',
+    '',
+    '## Replay',
+    '',
+    '- Apply the plan in the owning repository, then verify behavior and screenshots there. This kit never applies code.',
+    '- Re-run from `pick` with another `--pick` slot to reuse capture and candidates; settled paid stages replay.',
+    // A magic-link triple is a live credential and this file sits in the working
+    // tree (F31), so the kit says what it holds and what a re-capture needs.
+    ...(record.bootstrap.length > 0
+        ? ['- This kit captured with `--bootstrap`. `improve.json` keeps only the redacted triple'
+                + ` (${record.bootstrap.map((value) => `\`${value}\``).join(', ')}) and its sha256 — the live`
+                + ' value, session token included, is stored nowhere. A re-capture needs `--bootstrap` passed'
+                + ' again.']
+        : []),
+    '',
+];
+/**
+ * The design's font, and whose job it is to load it (F23).
+ *
+ * `plan/token-patch.css` used to open with a hosted Google Fonts `@import`,
+ * and this README makes applying that patch step 3 of "Start here" — so the
+ * one step a lane is told to apply wholesale was also the step that added a
+ * third-party network dependency to a repository that declared none. The patch
+ * names the family; loading it is the repository's own decision.
+ */
+const fontsSection = (record) => {
+    const fonts = record.plan?.fonts ?? [];
+    if (fonts.length === 0)
+        return [];
+    return [
+        '## Fonts',
+        '',
+        ...fonts.map(({ family, weights }) => (`- ${family} (weights ${weights.join(', ')}). \`plan/token-patch.css\` declares it as a`
+            + ' token and imports nothing. Load the family the way this repository already loads fonts'
+            + ' — self-host it, or add it to the existing loader — or keep the current family and skip'
+            + ' the token.')),
+        '',
+    ];
+};
+const fixedLayoutSection = (record) => (record.convert?.layout === 'fixed'
+    ? [
+        '## Fixed-layout target',
+        '',
+        `- Warning: ${record.convert.responsiveWarning ?? 'Responsive HTML was unavailable.'}`,
+        '- The target HTML is a fixed-layout fallback derived free from the successful LayerDoc conversion. It is not a responsive deliverable; the LayerDoc remains valid for planning.',
+        '',
+    ]
+    : []);
+export const renderImproveReadme = (args) => [
+    '# 12ui improve kit',
+    '',
+    `Input: ${args.record.input.kind} \`${args.record.input.value}\``,
+    // Which candidate this kit was built from, and why that one: it is only
+    // ever an explicit --pick now, or a supplied target. Nothing is guessed.
+    `Picked candidate: ${args.record.pick
+        ? `${args.record.pick.slot} — chosen with --pick, and the target was converted from it`
+        : args.record.target
+            ? 'bring-your-own target'
+            : 'not yet picked — nothing has been converted'}`,
+    '',
+    ...statusSection(args),
+    ...startHere(args),
+    ...assetsSection(args),
+    ...guardrails(),
+    ...fontsSection(args.record),
+    ...fixedLayoutSection(args.record),
+    ...anatomy(args.record),
+].join('\n');
+export const writeImproveReadme = async (record, context = {}) => {
+    const paths = improvePaths(record.runDir);
+    const [status, index] = await Promise.all([
+        readImproveKitStatus({ record, ...(context.requestedTo ? { requestedTo: context.requestedTo } : {}) }),
+        readImproveKitAssets({ runDir: record.runDir, layerDocPath: paths.targetLayerDoc }),
+    ]);
+    await writeFile(paths.readme, renderImproveReadme({ record, status, index }), 'utf8');
+    return paths.readme;
 };
 //# sourceMappingURL=improve-kit-readme.js.map

package/dist/improve-kit-readme.js.map

@@ -1 +1 @@
-{"version":3,"file":"improve-kit-readme.js","sourceRoot":"","sources":["../src/improve-kit-readme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,MAAqB,EAAmB,EAAE;IACjF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG;QACZ,oBAAoB,EAAE,EAAE;QACxB,UAAU,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI;QACvD,qBAAqB,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE;QAC5G,YAAY,EAAE,EAAE;QAChB,oFAAoF;QACpF,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,gGAAgG,CAAC,CAAC,CAAC,mDAAmD,EAAE;QAC3L,+GAA+G;QAC/G,8FAA8F;QAC9F,2HAA2H,EAAE,EAAE;QAC/H,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC;YACvC,wBAAwB,EAAE,EAAE;YAC5B,cAAc,MAAM,CAAC,OAAO,CAAC,iBAAiB,IAAI,kCAAkC,EAAE;YACtF,iLAAiL,EAAE,EAAE;SACtL,CAAC,CAAC,CAAC,EAAE,CAAC;QACP,SAAS,EAAE,EAAE;QACb,uGAAuG;QACvG,qHAAqH;QACrH,8GAA8G,EAAE,EAAE;QAClH,eAAe,EAAE,EAAE;QACnB,kEAAkE;QAClE,kGAAkG;QAClG,kIAAkI,EAAE,EAAE;KACvI,CAAC;IACF,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"improve-kit-readme.js","sourceRoot":"","sources":["../src/improve-kit-readme.ts"],"names":[],"mappings":"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"}

package/dist/improve-kit-stall.d.ts

@@ -0,0 +1,113 @@
+import { type ImproveKitAssetIndex } from './improve-kit-assets.js';
+import { type ImproveKitStatus } from './improve-kit-status.js';
+import { type ImproveResumeConversion } from './improve-convert-resilience.js';
+import { type RunJournalEntry } from './run-journal.js';
+import { type ImproveRecord, type ImproveStage } from './improve-workspace.js';
+/**
+ * A run that ran out of patience, a run somebody killed, and a run that
+ * recovered read differently.
+ *
+ * `fallback` is the third: the responsive export stalled and improve derived
+ * fixed-layout HTML free from the settled LayerDoc, so the kit is complete and
+ * the plan was built — but something DID stall, and F8 (wave-2, 2026-09-03)
+ * found that nothing said so anywhere a lane looks. No STALL.md exists in any
+ * of the six wave-2 kits, including the two that fell back. A recovered run is
+ * not a clean run, and this file is where the difference gets written down.
+ */
+export type ImproveStallKind = 'stalled' | 'stopped' | 'fallback';
+export type ImproveStallFacts = {
+    stage: ImproveStage;
+    kind: ImproveStallKind;
+    hostedRunId?: string;
+    waitedSeconds?: number;
+    typicalSeconds?: number;
+    /** The published bound the wait ran against, when the caller knows it. */
+    boundSeconds?: number;
+    serviceStage?: string;
+    /** The conversion the first recovery command will attach to, if the kit knows one. */
+    resume?: ImproveResumeConversion;
+    reason: string;
+};
+/**
+ * What the run was waiting on, from the journal it kept writing plus the error
+ * that ended the local process. The journal is authoritative for elapsed time
+ * because the error text carries none.
+ */
+export declare const collectImproveStallFacts: (args: {
+    record: ImproveRecord;
+    stage: ImproveStage;
+    error: unknown;
+    kind?: ImproveStallKind;
+    /**
+     * A journal the caller has already read. The terminal-event path runs on a
+     * signal that may be followed by SIGKILL after a short grace, so it reads the
+     * journal exactly once and shares it rather than reading it twice before the
+     * end line is on disk.
+     */
+    entries?: readonly RunJournalEntry[];
+    /**
+     * This invocation still had a stage in flight when it ended, so the record's
+     * `convert` block is about an EARLIER conversion — `--fresh` clears convert
+     * from the DURABLE record inside the stage, and the in-memory copy a stop
+     * handler holds is only reassigned when that stage RETURNS. The journal is
+     * then the only truthful source for the hosted run: its newest paid line is
+     * this process's own heartbeat, and no end line for this invocation exists
+     * yet. Reading the record instead put an abandoned conversion's id and its
+     * 216s age on the pipedrive kit's end line while the live one was 75s old.
+     */
+    inFlight?: boolean;
+}) => Promise<ImproveStallFacts>;
+export declare const renderImproveStall: (args: {
+    record: ImproveRecord;
+    facts: ImproveStallFacts;
+    status: ImproveKitStatus;
+    index: ImproveKitAssetIndex;
+}) => string;
+/**
+ * The same file, for the run that recovered.
+ *
+ * The facts come off the durable record rather than out of an error, because
+ * there is no error: the responsive export stalled, the free derivation took
+ * over, and the run went on to build a plan. A kit written before
+ * `responsiveStall` existed records the fallback but not its timings, so this
+ * writes what it has and never invents a number.
+ */
+export declare const writeImproveFallbackStall: (args: {
+    record: ImproveRecord;
+    requestedTo?: ImproveStage;
+}) => Promise<string | undefined>;
+/**
+ * The stall this kit recorded is over, so the file that recorded it stops
+ * saying the kit is INCOMPLETE (F21).
+ *
+ * Freshdesk's `--from convert` resume settled at 18:56:41Z and wrote a whole
+ * plan; the `plan/STALL.md` from 18:48:17Z survived beside it, still saying
+ * "this run was stopped", "no plan", and "resume or convert first" — directly
+ * contradicting the README above it, which said the plan was settled. A reader
+ * opening that kit cold got two mutually exclusive statuses and no way to tell
+ * which was current.
+ *
+ * The file is REPLACED rather than deleted: it is the durable record that this
+ * kit stalled once, which is worth keeping, and a README that links to it must
+ * not link to nothing. Its mtime is when the stall was written, which is the
+ * one timestamp neither the record nor the journal keeps.
+ */
+export declare const resolveImproveStall: (args: {
+    record: ImproveRecord;
+    status: ImproveKitStatus;
+    now?: Date;
+}) => Promise<string | undefined>;
+/**
+ * Write `plan/STALL.md`, creating `plan/` when the plan stage never ran.
+ * Returns the file so the caller can journal it as an artifact.
+ */
+export declare const writeImproveStallReport: (args: {
+    record: ImproveRecord;
+    stage: ImproveStage;
+    error: unknown;
+    requestedTo?: ImproveStage;
+    kind?: ImproveStallKind;
+    /** See `collectImproveStallFacts`: the hosted run then comes from the journal. */
+    inFlight?: boolean;
+}) => Promise<string>;
+//# sourceMappingURL=improve-kit-stall.d.ts.map

package/dist/improve-kit-stall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-kit-stall.d.ts","sourceRoot":"","sources":["../src/improve-kit-stall.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAe7F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,iBAAiB,CAgC5B,CAAC;AA6EF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,oBAAoB,CAAC;CAC7B,KAAG,MAoEH,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAyB7B,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAgC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,MAAM;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAoBjB,CAAC"}