@12ui/design 0.2.57 → 0.2.58

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

@@ -1,5 +1,5 @@
 import type { ConversionModel } from './conversion-models.js';
-import type { ImproveRecord } from './improve-workspace.js';
+import type { ImproveRecord, ImproveResponsiveFallbackOutcome } 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.
@@ -21,17 +21,15 @@ export declare const IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS = 30000;
  */
 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 a bound that tight was dangerous
- * while a stall still bought a second conversion.
+ * The DEFAULT no-progress bound. The old 480s standard/pro wall was below all
+ * three measured tall landings (655s, 642s, 796s). The 240s standard typical
+ * wall gives the same 960s result as the measured maximum with 20% headroom:
+ * `ceil(796 * 1.2 / 60) * 60 = 960`, or four typical walls.
  *
- * The bound is 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. Nothing is re-bought when it passes
- * (`improveConvertStallHalted`), so the bound now only decides how long improve
- * waits before handing the conversion back to the operator.
+ * This is not an absolute completion deadline. The conversion client resets it
+ * whenever polling reports a live stage or active lane, so it only halts a
+ * conversion that shows no progress. Fast keeps its measured-table envelope
+ * (300s); pro shares standard because it has no model-specific wall.
  */
 export declare const improveConvertStallDefaultSeconds: (model: ConversionModel) => number;
 /** The reason a pre-F19 stall abandonment carries, and the prefix that counts them. */
@@ -87,8 +85,20 @@ export type ImproveResumeConversion = {
  * `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.
+ *
+ * `inFlight` disqualifies the FIRST reading, and only a caller still inside the
+ * convert stage may set it. Such a caller knows something the record cannot:
+ * whatever `convert` block it holds settled an EARLIER conversion, because this
+ * one has not returned. `--fresh` clears that block durably inside the stage, so
+ * the only way to still be reading it is a copy that predates the clear — and
+ * answering "settled" off it promises a stopped lane a free replay of a
+ * conversion it walked away from, while the one it is still paying for goes
+ * unnamed. Silence there is not a loss: `plan/STALL.md` names the hosted run and
+ * prints the `resume` that collects it either way.
  */
-export declare const improveResumeConversion: (record: ImproveRecord) => ImproveResumeConversion | undefined;
+export declare const improveResumeConversion: (record: ImproveRecord, context?: {
+    inFlight?: boolean;
+}) => ImproveResumeConversion | undefined;
 /**
  * The wait ended and improve stopped. It bought nothing (F19).
  *
@@ -121,7 +131,44 @@ export declare const retryImproveTemporarilyUnavailable: <T>(args: {
 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;
+/**
+ * How the responsive export ended. Three different events, three different
+ * sentences, and the kit has to name the right one (F34).
+ *
+ * - `server-failed` — the service reported the conversion `failed`. There is
+ *   nothing running and nothing to wait for; the reason is the service's own.
+ * - `incomplete-viewports` — it produced some viewports and not all of them.
+ * - `deadline` — it was STILL RUNNING when the bound expired. Only this one
+ *   may say "did not settle before the deadline", and only this one leaves a
+ *   conversion worth resuming later.
+ */
+export type ImproveResponsiveFallback = {
+    outcome: ImproveResponsiveFallbackOutcome;
+    /** The sentence improve.json, the README, STALL.md and the summary all carry. */
+    warning: string;
+};
+/**
+ * Why the run derived fixed-layout HTML instead — or `undefined` when the error
+ * is not about the responsive export at all, in which case it must keep
+ * throwing rather than be absorbed into a fallback.
+ *
+ * `serviceStage` is the newest stage the service reported over the wait. The
+ * mailchimp app kit is why it is a parameter: its journal records `failed` at
+ * 269s under a 480s bound, and the CLI — classifying on the error TEXT alone,
+ * which matched a "responsive html export … failed" phrase against a branch
+ * that wrote deadline wording — told the reader the export had overrun a
+ * deadline it never reached. A stage the service declares outranks any reading
+ * of prose.
+ */
+export declare const responsiveFallbackReason: (error: unknown, context?: {
+    serviceStage?: string;
+}) => ImproveResponsiveFallback | undefined;
+/**
+ * One word for what happened to the responsive export, so the summary headline,
+ * the run summary's detail line and `plan/STALL.md` cannot disagree with the
+ * sentence stored beside them.
+ */
+export declare const improveResponsiveOutcomeWord: (outcome: ImproveResponsiveFallbackOutcome | undefined) => string;
 export declare const fixedImproveHtml: (targetDir: string) => Promise<{
     html: string;
     assets: string;

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

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

package/dist/improve-convert-resilience.js

@@ -19,6 +19,16 @@ const UUID = /[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}/iu;
  */
 export const IMPROVE_RESPONSIVE_TIMEOUT_MS = CONVERSION_DURATION_HINTS.fused * 1_000;
 export const IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS = 30_000;
+/**
+ * Standard `convert --output html` walls from the 2026-09-03 tall-landing
+ * round: Crisp 655s, Airtable 642s, Calendly 796s. These are a compact
+ * population check beside the model table, not a promise that a live run must
+ * complete inside the result.
+ */
+const IMPROVE_TALL_STANDARD_WALLS_SECONDS = [655, 642, 796];
+const IMPROVE_TALL_WALL_MARGIN = 1.2;
+const roundUpToMinute = (seconds) => Math.ceil(seconds / 60) * 60;
+const improveTallStandardNoProgressBoundSeconds = () => roundUpToMinute(Math.max(...IMPROVE_TALL_STANDARD_WALLS_SECONDS) * IMPROVE_TALL_WALL_MARGIN);
 /**
  * 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
@@ -28,19 +38,19 @@ export const IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS = 30_000;
  */
 export const improveConvertStallFloorSeconds = (model) => (model === 'fast' ? CONVERSION_DURATION_HINTS.convertFast : CONVERSION_DURATION_HINTS.convert);
 /**
- * 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 a bound that tight was dangerous
- * while a stall still bought a second conversion.
+ * The DEFAULT no-progress bound. The old 480s standard/pro wall was below all
+ * three measured tall landings (655s, 642s, 796s). The 240s standard typical
+ * wall gives the same 960s result as the measured maximum with 20% headroom:
+ * `ceil(796 * 1.2 / 60) * 60 = 960`, or four typical walls.
  *
- * The bound is 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. Nothing is re-bought when it passes
- * (`improveConvertStallHalted`), so the bound now only decides how long improve
- * waits before handing the conversion back to the operator.
+ * This is not an absolute completion deadline. The conversion client resets it
+ * whenever polling reports a live stage or active lane, so it only halts a
+ * conversion that shows no progress. Fast keeps its measured-table envelope
+ * (300s); pro shares standard because it has no model-specific wall.
  */
-export const improveConvertStallDefaultSeconds = (model) => Math.max(IMPROVE_RESPONSIVE_TIMEOUT_MS / 1_000, 2 * improveConvertStallFloorSeconds(model));
+export const improveConvertStallDefaultSeconds = (model) => (model === 'fast'
+    ? Math.max(IMPROVE_RESPONSIVE_TIMEOUT_MS / 1_000, 2 * improveConvertStallFloorSeconds(model))
+    : Math.max(improveTallStandardNoProgressBoundSeconds(), 4 * improveConvertStallFloorSeconds(model)));
 /** The reason a pre-F19 stall abandonment carries, and the prefix that counts them. */
 export const IMPROVE_CONVERT_STALL_REASON = 'convert stalled';
 /** The reason `--fresh` writes when it rotates the base key away from a conversion. */
@@ -89,10 +99,20 @@ export const improveConvertRetryKey = (key, index) => (`${key}:stall:${index - 1
  * `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.
+ *
+ * `inFlight` disqualifies the FIRST reading, and only a caller still inside the
+ * convert stage may set it. Such a caller knows something the record cannot:
+ * whatever `convert` block it holds settled an EARLIER conversion, because this
+ * one has not returned. `--fresh` clears that block durably inside the stage, so
+ * the only way to still be reading it is a copy that predates the clear — and
+ * answering "settled" off it promises a stopped lane a free replay of a
+ * conversion it walked away from, while the one it is still paying for goes
+ * unnamed. Silence there is not a loss: `plan/STALL.md` names the hosted run and
+ * prints the `resume` that collects it either way.
  */
-export const improveResumeConversion = (record) => {
+export const improveResumeConversion = (record, context = {}) => {
     const settled = record.convert?.sourceConversionId;
-    if (settled && UUID.test(settled))
+    if (!context.inFlight && settled && UUID.test(settled))
         return { id: settled, reason: 'settled' };
     const open = openImproveConversionAttempt(record);
     if (open) {
@@ -136,7 +156,9 @@ export const improveConvertStallHalted = (args) => new Error(
     + ` --out-dir ${shellArg(path.join(args.runDir, 'target'))}\n\n`
     + 'plan/STALL.md names the same conversion and the same commands.'
     + ' Pass --fresh only to buy another one deliberately.', { cause: args.cause });
-const RESPONSIVE_PARTIAL_FAILURE = 'could not be completed for every required viewport size';
+// The one responsive shortfall that still fails: NO layout landed. A run that
+// landed at least one ships degraded, so improve never sees it as an error.
+const RESPONSIVE_NO_LAYOUT_FAILURE = 'no responsive layout could be produced';
 export const improveErrorText = (error) => {
     const detail = error;
     return [
@@ -169,7 +191,7 @@ export const retryImproveTemporarilyUnavailable = async (args) => {
  * has to be able to say which, and a stall must not overwrite a class the
  * journal could already read off the error — an HTTP status, a refusal code.
  */
-const STALL_TEXT = /timed out|timeout|deadline|did not settle|has not settled|not settled yet/iu;
+const STALL_TEXT = /timed out|timeout|deadline|did not settle|has not settled|not settled yet|stalled and recoverable/iu;
 export const improveStalled = (error) => {
     if (isCliRefusal(error) || isImproveTemporarilyUnavailable(error))
         return false;
@@ -200,20 +222,61 @@ export const recordedImproveConversionId = async (record) => {
     }
     return undefined;
 };
-export const responsiveFallbackReason = (error) => {
+/** The service's own words, reduced to one line the kit can print. */
+const serviceFailureDetail = (error) => {
+    const line = improveErrorText(error).split('\n').map((part) => part.trim()).find(Boolean);
+    if (!line)
+        return 'the service reported no reason';
+    return line.replace(/\.$/u, '');
+};
+/**
+ * Why the run derived fixed-layout HTML instead — or `undefined` when the error
+ * is not about the responsive export at all, in which case it must keep
+ * throwing rather than be absorbed into a fallback.
+ *
+ * `serviceStage` is the newest stage the service reported over the wait. The
+ * mailchimp app kit is why it is a parameter: its journal records `failed` at
+ * 269s under a 480s bound, and the CLI — classifying on the error TEXT alone,
+ * which matched a "responsive html export … failed" phrase against a branch
+ * that wrote deadline wording — told the reader the export had overrun a
+ * deadline it never reached. A stage the service declares outranks any reading
+ * of prose.
+ */
+export const responsiveFallbackReason = (error, context = {}) => {
     if (isImproveTemporarilyUnavailable(error))
         return undefined;
     const text = improveErrorText(error);
     const normalized = text.toLowerCase();
-    if (normalized.includes(RESPONSIVE_PARTIAL_FAILURE)
+    const failedServerSide = context.serviceStage === 'failed';
+    const noResponsiveLayout = normalized.includes(RESPONSIVE_NO_LAYOUT_FAILURE);
+    const aboutResponsive = noResponsiveLayout
         || /responsive html export[\s\S]*(?:did not|failed|running|timed out|deadline)/iu.test(text)
-        || /responsive[\s\S]*(?:timeout|timed out|deadline exceeded)/iu.test(text)) {
-        return normalized.includes(RESPONSIVE_PARTIAL_FAILURE)
-            ? 'Responsive HTML could not be completed for every required viewport size.'
-            : 'Responsive HTML did not settle before the improve stage deadline.';
+        || /responsive[\s\S]*(?:timeout|timed out|deadline exceeded)/iu.test(text);
+    if (!aboutResponsive && !failedServerSide)
+        return undefined;
+    if (noResponsiveLayout) {
+        return {
+            outcome: 'server-failed',
+            warning: 'No responsive layout could be produced for this design.',
+        };
     }
-    return undefined;
+    if (failedServerSide) {
+        return {
+            outcome: 'server-failed',
+            warning: `Responsive export failed server-side: ${serviceFailureDetail(error)}.`,
+        };
+    }
+    return {
+        outcome: 'deadline',
+        warning: 'Responsive HTML did not settle before the improve stage deadline.',
+    };
 };
+/**
+ * One word for what happened to the responsive export, so the summary headline,
+ * the run summary's detail line and `plan/STALL.md` cannot disagree with the
+ * sentence stored beside them.
+ */
+export const improveResponsiveOutcomeWord = (outcome) => (outcome === 'server-failed' ? 'failed server-side' : 'stalled');
 export const fixedImproveHtml = async (targetDir) => {
     const html = derivedOutputFilePath(targetDir, 'html_fixed');
     const assets = `${html}.assets`;

package/dist/improve-convert-resilience.js.map

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

package/dist/improve-core/concept-input.d.ts

@@ -0,0 +1,80 @@
+/**
+ * One place decides what a concept may be, because the service decides it once.
+ *
+ * `cleanText` in `workers/api/src/create/validation.ts` collapses every run of
+ * whitespace to a single space, trims, and then counts CODE POINTS. Over the
+ * limit is rejected with a 400; it is never truncated. Both `POST /api/v1/create`
+ * and the same route's `source: "build"` claim (what `12ui branch execute`
+ * calls) measure it that way, and the build claim spends a metered plan call
+ * the moment it is accepted.
+ *
+ * The CLI has to measure it identically in both directions. Counting the raw
+ * text would refuse a wrapped `--concept-file` the service would have taken,
+ * and not counting it at all is how `12ui create claim` used to put an
+ * over-length brief on the wire and learn the limit from a 400 (2026-08-12).
+ *
+ * A CAP NOBODY IS TOLD ABOUT REFUSES EVERY RUN. At 600 this one refused 21 of 21
+ * unprompted branch briefs across two trials (2026-08-13 and 2026-08-16) while
+ * appearing in no `--help` line and in no skill. Both halves of that were fixed,
+ * separately: the limit is now stated everywhere a caller reads before writing a
+ * brief — the `create claim` and `branch execute` usage lines, which `--help` and
+ * their usage refusals print; `12ui capabilities`; the command templates the
+ * skills and the CLI's own next-step hints hand over; and the refusal below —
+ * and the number first moved to 1200 on 2026-08-16 after a pre-registered blind
+ * A/B measured no quality difference between a skilful <=600 trim and the full
+ * brief (`labs/concept-cap-2026-08-16`; the owner raised it because forcing a
+ * trim costs agent tokens for nothing). The reasoning, the null result, and the
+ * open watch item live at `MAX_CREATE_CONCEPT_CHARACTERS` in
+ * workers/api/src/create/contract.ts.
+ *
+ * NOTHING HERE CLAIMS SHORT BRIEFS DESIGN BETTER. That claim used to ride in the
+ * refusal and the data refused to support it, so the refusal states the count,
+ * the limit, the trim, and where cut detail belongs — and stops there.
+ */
+/**
+ * Mirrors `MAX_CREATE_CONCEPT_CHARACTERS` (workers/api/src/create/contract.ts),
+ * which is the constant the service actually enforces. `concept-input.test.ts`
+ * reads that file and fails if the two drift, because a CLI that measures a
+ * DIFFERENT number either refuses work the service would take or puts an
+ * over-length brief on the wire. If it is ever raised, the worker deploys first.
+ */
+export declare const MAX_CONCEPT_CHARACTERS = 1485;
+/** Exactly the service's normalization, so client and server count one string. */
+export declare const normalizeConceptText: (value: string) => string;
+/** Code points, not UTF-16 units: one emoji is one character to the service. */
+export declare const conceptCharacterCount: (value: string) => number;
+export type ConceptInput = {
+    /** Raw text, straight from `--concept` or a `--concept-file` read. */
+    value: string;
+    /** How to name the flag pair in a refusal, e.g. `--concept`. */
+    flag: string;
+    /** One clause naming where the cut detail belongs instead. */
+    trimHint: string;
+};
+/**
+ * The one shape every over-length text refusal takes.
+ *
+ * A refusal that names only the cap is half a message: the writer knows the
+ * text is too long and still has to count it themselves. F7 (wave-2, 2026-09-03)
+ * cost two lanes their first command each on `--direction` for exactly that —
+ * the refusal named 693 and 1200 and neither of them was the length of what
+ * they had written. Every limited text flag now names the count, the limit, the
+ * trim, and that nothing was spent.
+ */
+export declare const conceptOverLimitMessage: (args: {
+    flag: string;
+    /** As the caller typed it, so a whitespace-collapse difference can be named. */
+    raw: string;
+    /** After {@link normalizeConceptText}: the string that would go on the wire. */
+    normalized: string;
+    limit: number;
+    trimHint: string;
+    /** Why this flag's limit is not the concept cap, when it is not. */
+    because?: string;
+}) => string;
+/**
+ * Normalize and measure before anything is sent. Returns the exact text the
+ * caller should submit, so what was measured is what goes on the wire.
+ */
+export declare const readConceptValue: (input: ConceptInput) => string;
+//# sourceMappingURL=concept-input.d.ts.map

package/dist/improve-core/concept-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-input.d.ts","sourceRoot":"","sources":["../../src/improve-core/concept-input.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAA4C,CAAC;AAElG,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,MAA2B,CAAC;AAElF,MAAM,MAAM,YAAY,GAAG;IACzB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,MAcH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,YAAY,KAAG,MAYtD,CAAC"}

package/dist/improve-core/concept-input.js

@@ -0,0 +1,92 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/improve-core by scripts/sync-improve-core.mjs.
+/**
+ * One place decides what a concept may be, because the service decides it once.
+ *
+ * `cleanText` in `workers/api/src/create/validation.ts` collapses every run of
+ * whitespace to a single space, trims, and then counts CODE POINTS. Over the
+ * limit is rejected with a 400; it is never truncated. Both `POST /api/v1/create`
+ * and the same route's `source: "build"` claim (what `12ui branch execute`
+ * calls) measure it that way, and the build claim spends a metered plan call
+ * the moment it is accepted.
+ *
+ * The CLI has to measure it identically in both directions. Counting the raw
+ * text would refuse a wrapped `--concept-file` the service would have taken,
+ * and not counting it at all is how `12ui create claim` used to put an
+ * over-length brief on the wire and learn the limit from a 400 (2026-08-12).
+ *
+ * A CAP NOBODY IS TOLD ABOUT REFUSES EVERY RUN. At 600 this one refused 21 of 21
+ * unprompted branch briefs across two trials (2026-08-13 and 2026-08-16) while
+ * appearing in no `--help` line and in no skill. Both halves of that were fixed,
+ * separately: the limit is now stated everywhere a caller reads before writing a
+ * brief — the `create claim` and `branch execute` usage lines, which `--help` and
+ * their usage refusals print; `12ui capabilities`; the command templates the
+ * skills and the CLI's own next-step hints hand over; and the refusal below —
+ * and the number first moved to 1200 on 2026-08-16 after a pre-registered blind
+ * A/B measured no quality difference between a skilful <=600 trim and the full
+ * brief (`labs/concept-cap-2026-08-16`; the owner raised it because forcing a
+ * trim costs agent tokens for nothing). The reasoning, the null result, and the
+ * open watch item live at `MAX_CREATE_CONCEPT_CHARACTERS` in
+ * workers/api/src/create/contract.ts.
+ *
+ * NOTHING HERE CLAIMS SHORT BRIEFS DESIGN BETTER. That claim used to ride in the
+ * refusal and the data refused to support it, so the refusal states the count,
+ * the limit, the trim, and where cut detail belongs — and stops there.
+ */
+/**
+ * Mirrors `MAX_CREATE_CONCEPT_CHARACTERS` (workers/api/src/create/contract.ts),
+ * which is the constant the service actually enforces. `concept-input.test.ts`
+ * reads that file and fails if the two drift, because a CLI that measures a
+ * DIFFERENT number either refuses work the service would take or puts an
+ * over-length brief on the wire. If it is ever raised, the worker deploys first.
+ */
+export const MAX_CONCEPT_CHARACTERS = 1485;
+/** Exactly the service's normalization, so client and server count one string. */
+export const normalizeConceptText = (value) => value.replace(/\s+/gu, ' ').trim();
+/** Code points, not UTF-16 units: one emoji is one character to the service. */
+export const conceptCharacterCount = (value) => [...value].length;
+/**
+ * The one shape every over-length text refusal takes.
+ *
+ * A refusal that names only the cap is half a message: the writer knows the
+ * text is too long and still has to count it themselves. F7 (wave-2, 2026-09-03)
+ * cost two lanes their first command each on `--direction` for exactly that —
+ * the refusal named 693 and 1200 and neither of them was the length of what
+ * they had written. Every limited text flag now names the count, the limit, the
+ * trim, and that nothing was spent.
+ */
+export const conceptOverLimitMessage = (args) => {
+    const length = conceptCharacterCount(args.normalized);
+    // The raw count is what the caller can see in their editor. Name the counted
+    // one when they differ, or the refusal looks like it is off by the newlines.
+    const measured = length === conceptCharacterCount(args.raw)
+        ? `${length} characters`
+        : `${length} characters once its whitespace collapses`;
+    return `${args.flag} is ${measured}; the limit is ${args.limit}.`
+        + ` Trim ${length - args.limit}.`
+        + (args.because ? ` ${args.because}` : '')
+        + ` ${args.trimHint}`
+        // No quality claim here. The blind A/B behind the 1200 raise found none, so
+        // the refusal says what to do and what it cost, which is nothing.
+        + ' Nothing was sent and nothing was bought.';
+};
+/**
+ * Normalize and measure before anything is sent. Returns the exact text the
+ * caller should submit, so what was measured is what goes on the wire.
+ */
+export const readConceptValue = (input) => {
+    const concept = normalizeConceptText(input.value);
+    if (!concept)
+        throw new Error(`${input.flag} must not be empty`);
+    const length = conceptCharacterCount(concept);
+    if (length <= MAX_CONCEPT_CHARACTERS)
+        return concept;
+    throw new Error(conceptOverLimitMessage({
+        flag: input.flag,
+        raw: input.value,
+        normalized: concept,
+        limit: MAX_CONCEPT_CHARACTERS,
+        trimHint: input.trimHint,
+    }));
+};
+//# sourceMappingURL=concept-input.js.map

package/dist/improve-core/concept-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-input.js","sourceRoot":"","sources":["../../src/improve-core/concept-input.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,uEAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAElG,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;AAWlF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAUvC,EAAU,EAAE;IACX,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,KAAK,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC;QACzD,CAAC,CAAC,GAAG,MAAM,aAAa;QACxB,CAAC,CAAC,GAAG,MAAM,2CAA2C,CAAC;IACzD,OAAO,GAAG,IAAI,CAAC,IAAI,OAAO,QAAQ,kBAAkB,IAAI,CAAC,KAAK,GAAG;UAC7D,SAAS,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG;UAC/B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;UACxC,IAAI,IAAI,CAAC,QAAQ,EAAE;QACrB,4EAA4E;QAC5E,kEAAkE;UAChE,2CAA2C,CAAC;AAClD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAmB,EAAU,EAAE;IAC9D,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,oBAAoB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,MAAM,IAAI,sBAAsB;QAAE,OAAO,OAAO,CAAC;IACrD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,KAAK,CAAC,KAAK;QAChB,UAAU,EAAE,OAAO;QACnB,KAAK,EAAE,sBAAsB;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC,CAAC;AACN,CAAC,CAAC"}

package/dist/improve-core/improve-added-specs.d.ts

@@ -0,0 +1,62 @@
+import type { ImproveDescribePath } from './improve-artifacts.js';
+import type { LayerDiffResult, LayerLeaf } from './improve-layerdoc-types.js';
+type HierarchyLeaf = {
+    leaf: LayerLeaf;
+    parentPath: string[];
+};
+export type AddedElementSpec = {
+    designIndex: number;
+    insertion: string;
+    markdown: string;
+    asset?: {
+        kind: string;
+        path?: string;
+        destination?: string;
+        resolvable: boolean;
+        /** How the named file may be used: an external file, or inline only (F30). */
+        usage?: 'img' | 'inline';
+        /** The `currentColor` sibling, when the icon has both variants. */
+        inline?: {
+            path: string;
+            destination: string;
+        };
+        /** One sentence naming which file goes where. */
+        colorNote?: string;
+    };
+};
+/**
+ * Resolving an extracted raster means looking at whatever the conversion left
+ * beside the target design — a manifest and a directory in the CLI, an asset
+ * index in the browser — so the lookup is injected and the core only decides
+ * which artifact ids to ask for, in which order, and what an unresolved one
+ * says in the plan.
+ */
+export type ImproveAssetResolver = (artifactIds: readonly string[]) => AddedElementSpec['asset'] | undefined;
+/** Flatten target leaves while retaining group ancestry for sibling placement. */
+export declare const flattenImproveHierarchy: (document: unknown) => HierarchyLeaf[];
+/** Preference order for the extracted artifact a plan should hand a coder. */
+export declare const improveArtifactIds: (leaf: LayerLeaf) => string[];
+/**
+ * Every target leaf the diff never matched, with the full specification a coder
+ * needs to build it: where it goes relative to a real selector, its complete
+ * typography and style map, and the asset it references. Inline `iconSvg` is
+ * materialized into the returned `files` map rather than written here, so the
+ * CLI and the browser produce the same bytes at the same relative path.
+ */
+export declare const buildImproveAddedElementSpecs: (args: {
+    targetDoc: unknown;
+    normalizedTarget: readonly LayerLeaf[];
+    before: readonly LayerLeaf[];
+    canvas: {
+        width: number;
+        height: number;
+    };
+    diff: LayerDiffResult;
+    describePath: ImproveDescribePath;
+    resolveAsset?: ImproveAssetResolver;
+}) => {
+    specs: AddedElementSpec[];
+    files: Record<string, string>;
+};
+export {};
+//# sourceMappingURL=improve-added-specs.d.ts.map

package/dist/improve-core/improve-added-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-added-specs.d.ts","sourceRoot":"","sources":["../../src/improve-core/improve-added-specs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE9E,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,8EAA8E;QAC9E,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;QACzB,mEAAmE;QACnE,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,iDAAiD;QACjD,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,WAAW,EAAE,SAAS,MAAM,EAAE,KAC3B,gBAAgB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;AAE3C,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,GAAI,UAAU,OAAO,KAAG,aAAa,EAexE,CAAC;AAmDF,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,KAAG,MAAM,EAe1D,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;IAClC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,KAAG;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAuE7D,CAAC"}