@12ui/design 0.2.11 → 0.2.13

package/dist/image-generation-resume.d.ts

@@ -0,0 +1,36 @@
+import { type ImageGenerationAttempt } from './image-generation-evidence.js';
+/**
+ * What a resume is allowed to do with one candidate, decided only from durable
+ * evidence. The single invariant every disposition serves: a resume may finish
+ * delivering work that was already bought, and may start work that provably was
+ * not, but it may never buy the same candidate twice.
+ */
+export type ImageGenerationResumeDisposition = 
+/** PNG and evidence are already in their destination. Nothing to do, nothing to buy. */
+'materialized'
+/** The paid bytes are already on disk in staging. Move them into place; no provider call. */
+ | 'stageable'
+/** Provably unbilled, or billed under a key the provider itself deduplicates. */
+ | 'redispatchable'
+/** Billed and lost, with no free way to ask for it again. Refuse rather than re-buy. */
+ | 'unrecoverable';
+export type ImageGenerationResumeState = {
+    candidateId?: string;
+    outputPath: string;
+    attemptFile: string;
+    disposition: ImageGenerationResumeDisposition;
+    reason: string;
+    attempt?: ImageGenerationAttempt;
+};
+export declare const classifyImageGenerationResume: (args: {
+    outputPath: string;
+    candidateId?: string;
+}) => Promise<ImageGenerationResumeState>;
+export declare const resumeStateSummary: (states: readonly ImageGenerationResumeState[]) => {
+    materialized: number;
+    stageable: number;
+    redispatchable: number;
+    unrecoverable: number;
+};
+export declare const describeResumeState: (state: ImageGenerationResumeState) => string;
+//# sourceMappingURL=image-generation-resume.d.ts.map

package/dist/image-generation-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation-resume.d.ts","sourceRoot":"","sources":["../src/image-generation-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAO/F;;;;;GAKG;AACH,MAAM,MAAM,gCAAgC;AAC1C,wFAAwF;AACtF,cAAc;AAChB,6FAA6F;GAC3F,WAAW;AACb,iFAAiF;GAC/E,gBAAgB;AAClB,wFAAwF;GACtF,eAAe,CAAC;AAEpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,gCAAgC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAU,MAAM;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,OAAO,CAAC,0BAA0B,CAuErC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,0BAA0B,EAAE,KAAG;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CAMtB,CAAC;AAEH,eAAO,MAAM,mBAAmB,GAAI,OAAO,0BAA0B,KAAG,MAEvE,CAAC"}

package/dist/image-generation-resume.js

@@ -0,0 +1,83 @@
+import { imageAttemptPath } from './image-generation-evidence.js';
+import { imageGenerationPathExists } from './image-generation-fs.js';
+import { imageGenerationStagedPaths, readImageGenerationAttemptFile, } from './image-generation-staging.js';
+export const classifyImageGenerationResume = async (args) => {
+    const attemptFile = imageAttemptPath(args.outputPath);
+    const staged = imageGenerationStagedPaths(args.outputPath);
+    const [outputExists, stagedOutputExists, finalAttempt, stagedAttempt] = await Promise.all([
+        imageGenerationPathExists(args.outputPath),
+        imageGenerationPathExists(staged.stagedOutputPath),
+        readImageGenerationAttemptFile(attemptFile),
+        readImageGenerationAttemptFile(staged.stagedAttemptFile),
+    ]);
+    const attempt = stagedAttempt ?? finalAttempt;
+    const base = {
+        ...(args.candidateId ? { candidateId: args.candidateId } : {}),
+        outputPath: args.outputPath,
+        attemptFile,
+        ...(attempt ? { attempt } : {}),
+    };
+    const stagingRemnant = stagedOutputExists || stagedAttempt !== undefined;
+    if (outputExists && finalAttempt && !stagingRemnant) {
+        return {
+            ...base,
+            disposition: 'materialized',
+            reason: 'the candidate and its evidence are already in place',
+        };
+    }
+    // Bytes on disk mean the call was already paid for and only delivery is
+    // outstanding — either the PNG is still staged, or it landed and its ledger
+    // entry did not.
+    if (stagedOutputExists || (outputExists && stagingRemnant)) {
+        return {
+            ...base,
+            disposition: 'stageable',
+            reason: 'the generated image is already on disk and only needs moving into place',
+        };
+    }
+    if (!attempt) {
+        return {
+            ...base,
+            disposition: 'redispatchable',
+            reason: 'no attempt evidence exists, so no provider call was ever reserved for it',
+        };
+    }
+    if (!attempt.providerStartedAt) {
+        return {
+            ...base,
+            disposition: 'redispatchable',
+            reason: 'the provider call was never started, so nothing was billed for it',
+        };
+    }
+    if (attempt.status === 'failed') {
+        return {
+            ...base,
+            disposition: 'unrecoverable',
+            reason: `the provider call failed after dispatch (${attempt.error ?? 'no recorded error'});`
+                + ' repeating it would be a second paid call',
+        };
+    }
+    if (attempt.providerIdempotencyEnforced) {
+        return {
+            ...base,
+            disposition: 'redispatchable',
+            reason: 'the provider enforces idempotency on the recorded key, so re-requesting the same'
+                + ' identity returns the same result without a second charge',
+        };
+    }
+    return {
+        ...base,
+        disposition: 'unrecoverable',
+        reason: `the ${attempt.provider} call was dispatched and its result was lost, and that provider`
+            + ' does not enforce idempotency on the recorded key, so re-requesting it would be a second'
+            + ' paid call; give this candidate a new output path and idempotency key to buy it again',
+    };
+};
+export const resumeStateSummary = (states) => ({
+    materialized: states.filter((state) => state.disposition === 'materialized').length,
+    stageable: states.filter((state) => state.disposition === 'stageable').length,
+    redispatchable: states.filter((state) => state.disposition === 'redispatchable').length,
+    unrecoverable: states.filter((state) => state.disposition === 'unrecoverable').length,
+});
+export const describeResumeState = (state) => (`${state.candidateId ?? state.outputPath}: ${state.disposition} — ${state.reason}`);
+//# sourceMappingURL=image-generation-resume.js.map

package/dist/image-generation-resume.js.map

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

package/dist/image-generation-run.d.ts

@@ -18,6 +18,7 @@ export type ImageGenerationResult = {
     model: ImageGenerationAttempt['model'];
     outputPath: string;
     outputSha256: string;
+    outputBytes: number;
     attemptFile: string;
     providerStartedAt: string;
     completedAt: string;
@@ -29,6 +30,16 @@ export declare const reserveImageGeneration: (args: {
     batch?: ImageGenerationAttempt["batch"];
     dependencies?: ImageGenerationDependencies;
 }) => Promise<ReservedImageGeneration>;
+/**
+ * Re-enter an existing candidate identity without minting a new ledger entry.
+ * The caller must already have proved, from that entry, that redispatching it
+ * cannot double-spend.
+ */
+export declare const resumeReservedImageGeneration: (args: {
+    request: PreparedImageGenerationRequest;
+    preflight: ImageProviderPreflight;
+    attempt: ImageGenerationAttempt;
+}) => ReservedImageGeneration;
 export declare const markImageGenerationDispatched: (reserved: ReservedImageGeneration, dependencies?: ImageGenerationDependencies) => Promise<void>;
 export declare const failImageGenerationBeforeDispatch: (reserved: ReservedImageGeneration, error: string, dependencies?: ImageGenerationDependencies) => Promise<void>;
 export declare const dispatchImageGeneration: (reserved: ReservedImageGeneration, dependencies?: ImageGenerationDependencies) => Promise<ImageGenerationResult>;

package/dist/image-generation-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-generation-run.d.ts","sourceRoot":"","sources":["../src/image-generation-run.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EAGd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,EAAE,OAAO,aAAa,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,4BAA4B,CAAC;CACrC,CAAC;AAMF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C,KAAG,OAAO,CAAC,uBAAuB,CAmClC,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,UAAU,uBAAuB,EACjC,eAAc,2BAAgC,KAC7C,OAAO,CAAC,IAAI,CAId,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,UAAU,uBAAuB,EACjC,OAAO,MAAM,EACb,eAAc,2BAAgC,KAC7C,OAAO,CAAC,IAAI,CAKd,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,UAAU,uBAAuB,EACjC,eAAc,2BAAgC,KAC7C,OAAO,CAAC,qBAAqB,CA6F/B,CAAC"}
+{"version":3,"file":"image-generation-run.d.ts","sourceRoot":"","sources":["../src/image-generation-run.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EAGd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,EAAE,OAAO,aAAa,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,4BAA4B,CAAC;CACrC,CAAC;AAMF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C,KAAG,OAAO,CAAC,uBAAuB,CAmClC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM;IAClD,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC,KAAG,uBAIF,CAAC;AAEH,eAAO,MAAM,6BAA6B,GACxC,UAAU,uBAAuB,EACjC,eAAc,2BAAgC,KAC7C,OAAO,CAAC,IAAI,CAId,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,UAAU,uBAAuB,EACjC,OAAO,MAAM,EACb,eAAc,2BAAgC,KAC7C,OAAO,CAAC,IAAI,CAKd,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,UAAU,uBAAuB,EACjC,eAAc,2BAAgC,KAC7C,OAAO,CAAC,qBAAqB,CAiG/B,CAAC"}

package/dist/image-generation-run.js

@@ -31,9 +31,9 @@ export const reserveImageGeneration = async (args) => {
         preparedAt: timestamp(dependencies),
         ...(args.batch ? { batch: args.batch } : {}),
     };
-    await writeImageGenerationAttempt(args.request.attemptFile, attempt, true).catch((error) => {
+    await writeImageGenerationAttempt(args.request.stagedAttemptFile, attempt, true).catch((error) => {
         if (error.code === 'EEXIST') {
-            throw new Error(`Image attempt evidence already exists at ${args.request.attemptFile}. Refusing to`
+            throw new Error(`Image attempt evidence already exists at ${args.request.stagedAttemptFile}. Refusing to`
                 + ' redispatch an ambiguous or completed request; inspect it and use a new output/'
                 + 'idempotency key.');
         }
@@ -41,22 +41,32 @@ export const reserveImageGeneration = async (args) => {
     });
     return { request: args.request, preflight: args.preflight, attempt };
 };
+/**
+ * Re-enter an existing candidate identity without minting a new ledger entry.
+ * The caller must already have proved, from that entry, that redispatching it
+ * cannot double-spend.
+ */
+export const resumeReservedImageGeneration = (args) => ({
+    request: args.request,
+    preflight: args.preflight,
+    attempt: { ...args.attempt, status: 'prepared', error: undefined },
+});
 export const markImageGenerationDispatched = async (reserved, dependencies = {}) => {
     reserved.attempt.status = 'dispatched';
     reserved.attempt.dispatchedAt = timestamp(dependencies);
-    await writeImageGenerationAttempt(reserved.request.attemptFile, reserved.attempt);
+    await writeImageGenerationAttempt(reserved.request.stagedAttemptFile, reserved.attempt);
 };
 export const failImageGenerationBeforeDispatch = async (reserved, error, dependencies = {}) => {
     reserved.attempt.status = 'failed';
     reserved.attempt.completedAt = timestamp(dependencies);
     reserved.attempt.error = error;
-    await writeImageGenerationAttempt(reserved.request.attemptFile, reserved.attempt);
+    await writeImageGenerationAttempt(reserved.request.stagedAttemptFile, reserved.attempt);
 };
 export const dispatchImageGeneration = async (reserved, dependencies = {}) => {
     const { request, preflight, attempt } = reserved;
     let providerRequestId;
     attempt.providerStartedAt = timestamp(dependencies);
-    await writeImageGenerationAttempt(request.attemptFile, attempt);
+    await writeImageGenerationAttempt(request.stagedAttemptFile, attempt);
     try {
         const agent = {
             agent_id: `12ui-image-${imageGenerationSha256(request.idempotencyKey).slice(0, 16)}`,
@@ -101,24 +111,28 @@ export const dispatchImageGeneration = async (reserved, dependencies = {}) => {
         });
         if (providerRequestId)
             attempt.providerRequestId = providerRequestId;
-        await writeImageGenerationAttempt(request.attemptFile, attempt);
+        await writeImageGenerationAttempt(request.stagedAttemptFile, attempt);
         if (captured.outcome.status === 'rejected')
             throw captured.outcome.reason;
         if (!Array.isArray(generated) || generated.length !== 1 || typeof generated[0] !== 'string') {
             throw new Error('Image provider did not return exactly one image');
         }
         const bytes = await generatedPngBytes(generated[0]);
-        await writeFile(request.outputPath, bytes, { flag: 'wx' });
+        // Staged, not delivered. The caller materializes every candidate together
+        // once the batch is terminal, so no directory listing can catch a
+        // half-written set of candidates.
+        await writeFile(request.stagedOutputPath, bytes, { flag: 'wx' });
         attempt.status = 'succeeded';
         attempt.completedAt = timestamp(dependencies);
         attempt.outputSha256 = imageGenerationSha256(bytes);
-        await writeImageGenerationAttempt(request.attemptFile, attempt);
+        await writeImageGenerationAttempt(request.stagedAttemptFile, attempt);
         return {
             ...(request.candidateId ? { candidateId: request.candidateId } : {}),
             provider: attempt.provider,
             model: attempt.model,
             outputPath: request.outputPath,
             outputSha256: attempt.outputSha256,
+            outputBytes: bytes.byteLength,
             attemptFile: request.attemptFile,
             providerStartedAt: attempt.providerStartedAt,
             completedAt: attempt.completedAt,
@@ -136,7 +150,7 @@ export const dispatchImageGeneration = async (reserved, dependencies = {}) => {
         attempt.status = 'failed';
         attempt.completedAt = timestamp(dependencies);
         attempt.error = imageGenerationErrorMessage(error);
-        await writeImageGenerationAttempt(request.attemptFile, attempt);
+        await writeImageGenerationAttempt(request.stagedAttemptFile, attempt);
         throw new Error(`Image generation failed after dispatch with ${attempt.provider}; no provider fallback`
             + ` was attempted. Evidence: ${request.attemptFile}. ${attempt.error}`, { cause: error });
     }

package/dist/image-generation-run.js.map

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

package/dist/image-generation-staging.d.ts

@@ -0,0 +1,25 @@
+import { type ImageGenerationAttempt } from './image-generation-evidence.js';
+export declare const IMAGE_STAGING_DIRECTORY_NAME = ".12ui-image-staging";
+export type ImageGenerationStagedPaths = {
+    stagingDirectory: string;
+    stagedOutputPath: string;
+    stagedAttemptFile: string;
+};
+export declare const imageGenerationStagedPaths: (outputPath: string) => ImageGenerationStagedPaths;
+export declare const ensureImageGenerationStaging: (outputPath: string) => Promise<void>;
+export declare const readStagedImageGenerationAttempt: (outputPath: string) => Promise<ImageGenerationAttempt | undefined>;
+export declare const readImageGenerationAttemptFile: (file: string) => Promise<ImageGenerationAttempt | undefined>;
+export type ImageGenerationMaterialization = {
+    outputPath: string;
+    attemptFile: string;
+    movedOutput: boolean;
+    movedAttempt: boolean;
+};
+/**
+ * Move one candidate's staged artifacts into their destination. The PNG lands
+ * before its evidence so that a crash between the two renames leaves the
+ * staged ledger in place, which is what lets a later resume prove the work was
+ * already paid for instead of buying it again.
+ */
+export declare const materializeImageGeneration: (outputPath: string) => Promise<ImageGenerationMaterialization>;
+//# sourceMappingURL=image-generation-staging.d.ts.map

package/dist/image-generation-staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation-staging.d.ts","sourceRoot":"","sources":["../src/image-generation-staging.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAW/F,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAElE,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,YAAY,MAAM,KAAG,0BAQ/D,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CAEnF,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAC3C,YAAY,MAAM,KACjB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAE5C,CAAC;AAEF,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,KACX,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAkB5C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,YAAY,MAAM,KACjB,OAAO,CAAC,8BAA8B,CA0BxC,CAAC"}

package/dist/image-generation-staging.js

@@ -0,0 +1,80 @@
+import { mkdir, readFile, rename, rmdir } from 'node:fs/promises';
+import path from 'node:path';
+import { imageGenerationPathExists } from './image-generation-fs.js';
+import { imageAttemptPath } from './image-generation-evidence.js';
+// Every in-flight candidate — its PNG bytes and its attempt ledger — is written
+// inside a hidden staging directory and moved into the destination directory
+// only once the batch is terminal. A caller listing the candidates directory
+// therefore never observes the half-written state that made eleven benchmark
+// runs declare failure roughly thirty seconds before valid candidates landed.
+//
+// The staging directory is a child of the destination directory on purpose:
+// same-directory renames are same-filesystem, so materialization is atomic and
+// can never fail with EXDEV the way a system-temp staging path could.
+export const IMAGE_STAGING_DIRECTORY_NAME = '.12ui-image-staging';
+export const imageGenerationStagedPaths = (outputPath) => {
+    const stagingDirectory = path.join(path.dirname(outputPath), IMAGE_STAGING_DIRECTORY_NAME);
+    const base = path.basename(outputPath);
+    return {
+        stagingDirectory,
+        stagedOutputPath: path.join(stagingDirectory, `${base}.part`),
+        stagedAttemptFile: path.join(stagingDirectory, `${base}.attempt.json`),
+    };
+};
+export const ensureImageGenerationStaging = async (outputPath) => {
+    await mkdir(imageGenerationStagedPaths(outputPath).stagingDirectory, { recursive: true });
+};
+export const readStagedImageGenerationAttempt = async (outputPath) => (readImageGenerationAttemptFile(imageGenerationStagedPaths(outputPath).stagedAttemptFile));
+export const readImageGenerationAttemptFile = async (file) => {
+    let source;
+    try {
+        source = await readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    try {
+        const value = JSON.parse(source);
+        if (typeof value !== 'object' || value === null)
+            return undefined;
+        return value;
+    }
+    catch {
+        // Unreadable evidence is still evidence that a request was reserved here.
+        // Callers must treat it as "something happened" rather than "nothing did",
+        // so surface a minimal record instead of pretending the file is absent.
+        return { status: 'dispatched' };
+    }
+};
+/**
+ * Move one candidate's staged artifacts into their destination. The PNG lands
+ * before its evidence so that a crash between the two renames leaves the
+ * staged ledger in place, which is what lets a later resume prove the work was
+ * already paid for instead of buying it again.
+ */
+export const materializeImageGeneration = async (outputPath) => {
+    const attemptFile = imageAttemptPath(outputPath);
+    const { stagingDirectory, stagedOutputPath, stagedAttemptFile } = (imageGenerationStagedPaths(outputPath));
+    let movedOutput = false;
+    let movedAttempt = false;
+    if (await imageGenerationPathExists(stagedOutputPath)) {
+        if (await imageGenerationPathExists(outputPath)) {
+            throw new Error(`Refusing to overwrite an existing candidate at ${outputPath} with staged bytes from`
+                + ` ${stagedOutputPath}; inspect both before continuing.`);
+        }
+        await rename(stagedOutputPath, outputPath);
+        movedOutput = true;
+    }
+    if (await imageGenerationPathExists(stagedAttemptFile)) {
+        await rename(stagedAttemptFile, attemptFile);
+        movedAttempt = true;
+    }
+    // Leave nothing behind once the last candidate in this directory is
+    // delivered. Anything still staged means work that is not delivered yet, and
+    // rmdir refuses a non-empty directory, so the check is the guarantee.
+    await rmdir(stagingDirectory).catch(() => undefined);
+    return { outputPath, attemptFile, movedOutput, movedAttempt };
+};
+//# sourceMappingURL=image-generation-staging.js.map

package/dist/image-generation-staging.js.map

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

package/dist/legacy-skill-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-skill-catalog.d.ts","sourceRoot":"","sources":["../src/legacy-skill-catalog.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,gHAYrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAChE,eAAO,MAAM,qBAAqB,yFAMxB,CAAC;AASX,eAAO,MAAM,mBAAmB,EAAE,SAAS,eAAe,EACuB,CAAC;AAqPlF,eAAO,MAAM,wBAAwB,GACnC,WAAW,MAAM,KAChB,OAAO,CAAC,MAAM,EAAE,CAiBlB,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,WAAW,MAAM,KAChB,OAAO,CAAC,SAAS,GAAG,YAAY,GAAG,SAAS,CAW9C,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,WAAW,MAAM,KAChB,OAAO,CAAC,SAAS,GAAG,YAAY,GAAG,SAAS,CAoB9C,CAAC"}
+{"version":3,"file":"legacy-skill-catalog.d.ts","sourceRoot":"","sources":["../src/legacy-skill-catalog.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,gHAYrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAChE,eAAO,MAAM,qBAAqB,yFAMxB,CAAC;AASX,eAAO,MAAM,mBAAmB,EAAE,SAAS,eAAe,EACuB,CAAC;AAmSlF,eAAO,MAAM,wBAAwB,GACnC,WAAW,MAAM,KAChB,OAAO,CAAC,MAAM,EAAE,CAiBlB,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,WAAW,MAAM,KAChB,OAAO,CAAC,SAAS,GAAG,YAAY,GAAG,SAAS,CAW9C,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,WAAW,MAAM,KAChB,OAAO,CAAC,SAAS,GAAG,YAAY,GAAG,SAAS,CAoB9C,CAAC"}

package/dist/legacy-skill-catalog.js

@@ -122,6 +122,25 @@ const variants = {
             'references/continuation-contract.md': '24ea3ab3906f04985572e5665206fef7a3390fa88d0480b8ecca271791ae6b5c',
             'references/selection-contract.md': '6a2b0a24fcb03495240dd15b63394d7b6de9d9c52eb411cd3ff1b02f3ba22578',
         },
+        // Fused convert+export guidance and realistic conversion durations.
+        {
+            'SKILL.md': '88e23da2f157153735eb21ae3d12edf5abffe115b3c8aeace0da7606a2609581',
+            'agents/openai.yaml': '543726a0ac4b976c897c95ce18324ed7610ae2b5f9584cc8b7b2e3df5c16980c',
+            'assets/large-logo.svg': 'bf877913dc00515b7f714a48851f9fdc6d42c4ca5ad4a1c7bc36d926c23f9b6d',
+            'assets/small-400px.png': '2c045201a83e54afe733e199af02ab8fbcdb9f50e6b3e0281078fdffca9b3b03',
+            'references/continuation-contract.md': '24ea3ab3906f04985572e5665206fef7a3390fa88d0480b8ecca271791ae6b5c',
+            'references/selection-contract.md': '6a2b0a24fcb03495240dd15b63394d7b6de9d9c52eb411cd3ff1b02f3ba22578',
+        },
+        // Batch completion sentinel and --resume, the recommended-candidate
+        // selection shape, and adopting the export as the deliverable page.
+        {
+            'SKILL.md': '5c3c51d9ce74408ccb0277e559ebadd8fd0d4b48f74272de864699ed68091dcb',
+            'agents/openai.yaml': '543726a0ac4b976c897c95ce18324ed7610ae2b5f9584cc8b7b2e3df5c16980c',
+            'assets/large-logo.svg': 'bf877913dc00515b7f714a48851f9fdc6d42c4ca5ad4a1c7bc36d926c23f9b6d',
+            'assets/small-400px.png': '2c045201a83e54afe733e199af02ab8fbcdb9f50e6b3e0281078fdffca9b3b03',
+            'references/continuation-contract.md': '24ea3ab3906f04985572e5665206fef7a3390fa88d0480b8ecca271791ae6b5c',
+            'references/selection-contract.md': '0d42af12cfe7f616a2eb036a4babfe28c4468843471a90c37ab970f48d8e11ed',
+        },
     ],
     'design-search': [
         {
@@ -186,6 +205,21 @@ const variants = {
             'assets/large-logo.svg': 'ddf9f51a8c9163d64bc19126fedbfdae050f3a7bad7cdf314efacd10dd7ff447',
             'assets/small-400px.png': '97817fa2d4e5f5ad1cac77bac925bafbdd04519621c5e45fd95c6a6ad5e846f7',
         },
+        // Fused `12ui convert --export html` and realistic conversion durations.
+        {
+            'SKILL.md': '2998fb5f868868e2d7f2004374d10217d6c95f4ef680e081bb34855aa0992dde',
+            'agents/openai.yaml': 'bbe5ed44c7f41920aaa92a86a06b18125f13b00ea67b100559358953986f9933',
+            'assets/large-logo.svg': 'ddf9f51a8c9163d64bc19126fedbfdae050f3a7bad7cdf314efacd10dd7ff447',
+            'assets/small-400px.png': '97817fa2d4e5f5ad1cac77bac925bafbdd04519621c5e45fd95c6a6ad5e846f7',
+        },
+        // The exported page is the deliverable, adapted and composed rather than
+        // mined for assets and re-authored.
+        {
+            'SKILL.md': 'a6ce44347192edb96862ec42f0a5f190ab6eef0dc76c1523606d6f163f8cb857',
+            'agents/openai.yaml': 'bbe5ed44c7f41920aaa92a86a06b18125f13b00ea67b100559358953986f9933',
+            'assets/large-logo.svg': 'ddf9f51a8c9163d64bc19126fedbfdae050f3a7bad7cdf314efacd10dd7ff447',
+            'assets/small-400px.png': '97817fa2d4e5f5ad1cac77bac925bafbdd04519621c5e45fd95c6a6ad5e846f7',
+        },
     ],
     // The one shipped design-create bundle (0.2.10), retained so 0.2.11 retires an
     // untouched installed copy when design-draft replaces it.

package/dist/legacy-skill-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-skill-catalog.js","sourceRoot":"","sources":["../src/legacy-skill-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"legacy-skill-catalog.js","sourceRoot":"","sources":["../src/legacy-skill-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,6EAA6E;AAC7E,wEAAwE;AACxE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,qBAAqB;IACrB,MAAM;IACN,cAAc;IACd,aAAa;IACb,4EAA4E;IAC5E,8EAA8E;IAC9E,8EAA8E;IAC9E,8EAA8E;IAC9E,gCAAgC;IAChC,eAAe;CACP,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ;IACR,eAAe;IACf,cAAc;IACd,eAAe;IACf,gBAAgB;CACR,CAAC;AAIX,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAA+B,kBAAkB;KAC9E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,qBAA2C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAElF,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA2B,EAAE,CAAC,CACnE,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC1D,CAAC;AAIF,MAAM,QAAQ,GAAwE;IACpF,oBAAoB,EAAE,CAAC;YACrB,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;SACzF,CAAC;IACF,qBAAqB,EAAE,CAAC;YACtB,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,gCAAgC,EAAE,kEAAkE;SACrG,CAAC;IACF,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kEAAkE;SAC/E;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EAAE,kEAAkE;YAC3F,uBAAuB,EAAE,kEAAkE;SAC5F;KACF;IACD,cAAc,EAAE;QACd;YACE,UAAU,EAAE,kEAAkE;SAC/E;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EAAE,kEAAkE;YAC3F,uBAAuB,EAAE,kEAAkE;SAC5F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;SACzF;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,kCAAkC,EAChC,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,kCAAkC,EAChC,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,kCAAkC,EAChC,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,qCAAqC,EACnC,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,qCAAqC,EACnC,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;QACA;YACC,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,qCAAqC,EACnC,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;QACD,oEAAoE;QACpE;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,qCAAqC,EACnC,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;QACD,oEAAoE;QACpE,oEAAoE;QACpE;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;YACpE,qCAAqC,EACnC,kEAAkE;YACpE,kCAAkC,EAChC,kEAAkE;SACrE;KACF;IACD,eAAe,EAAE;QACf;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;SACzF;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;KACF;IACD,cAAc,EAAE;QACd;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;KACF;IACD,eAAe,EAAE;QACf;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;KACF;IACD,gBAAgB,EAAE;QAChB;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;SACzF;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;QACD;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;QACD,yEAAyE;QACzE;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;QACD,yEAAyE;QACzE,oCAAoC;QACpC;YACE,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE;KACF;IACD,+EAA+E;IAC/E,0DAA0D;IAC1D,eAAe,EAAE,CAAC;YAChB,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;YACxF,uBAAuB,EACrB,kEAAkE;YACpE,wBAAwB,EACtB,kEAAkE;SACrE,CAAC;IACF,aAAa,EAAE,CAAC;YACd,UAAU,EAAE,kEAAkE;YAC9E,oBAAoB,EAAE,kEAAkE;SACzF,CAAC;CACH,CAAC;AAEF,MAAM,eAAe,GAAG,KAAK,EAAE,MAAc,EAAoB,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,KAAK,EAAE,IAAY,EAAE,QAAQ,GAAG,EAAE,EAAqB,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,KAAK,EAC/B,SAAiB,EACa,EAAE;IAChC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAA6B,EAAE,CAAC;QACpF,IAAI;QACJ,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KACtF,CAAC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,SAAiB,EACE,EAAE;IACrB,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YACrE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxB,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CACvD,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC,CAAC,IAAI,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAC9C,SAAiB,EAC8B,EAAE;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE;YAAE,OAAO,SAAS,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,+BAA+B,CAAC,SAAS,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,EAClD,SAAiB,EAC8B,EAAE;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE;YAAE,OAAO,SAAS,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,IAA2B,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC9F,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,YAAY,CAAC;IACrF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12ui/design",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "type": "module",
   "description": "The canonical 12UI CLI, SDK, MCP server, and visual interface design skills",
   "main": "dist/index.js",

package/skills/design/SKILL.md

@@ -177,11 +177,37 @@ from one host task: that tool path may queue them serially. Never retry a failed
 or ambiguous candidate, switch providers after dispatch, use cached samples, or
 leave generation in detached background work.
 
+Expect about **90 seconds** of blocking for four candidates. The command has not
+hung: never kill it, never background it, and never list the candidates
+directory to decide whether it worked. Nothing lands there until the batch is
+terminal, and then everything appears at once — the four PNGs, their attempt
+evidence, and `<run-dir>/candidates/generation.complete.json`. Poll that
+sentinel if you must poll anything. It is written only at a terminal state and
+records each candidate's status, sha256, and byte count; its absence means
+still running, never failed.
+
+If the command was interrupted, re-run the identical command with `--resume`. A
+resume delivers candidates that were already generated and re-requests only
+those the provider provably never billed, so it can never buy a candidate
+twice. It refuses a batch that already completed, and its refusal names the
+candidates already on disk — read those rather than generating again.
+
 ### 3. Select
 
-Inspect all candidates at original detail. Choose the best eligible direction
-for the brief, hierarchy, usability, personality, accessibility, feasibility,
-and ability to extend into the rest of the product.
+Inspect all candidates at original detail. Looking at them is not optional: your
+judgment is the channel through which anything the run could not compute gets
+into the decision.
+
+If the run indicates a recommended candidate, prefer it. Overriding the
+recommendation is legitimate and expected when the context warrants — an
+explicit user preference, a brief or steering directive the recommendation could
+not see, or a visible defect in the recommended image are all good reasons — and
+an override must state its reason. If no recommendation is indicated, select on
+the criteria below as usual.
+
+Choose the best eligible direction for the brief, hierarchy, usability,
+personality, accessibility, feasibility, and ability to extend into the rest of
+the product.
 
 Treat common model palettes as neutral, not evidence of quality. Neon lime on
 dark and orange on light should win only when the brief or paired reference
@@ -193,7 +219,10 @@ Write `<run-dir>/selection.json` using
 [the selection contract](references/selection-contract.md). Record exact
 prompts, original/prepared redesign-source paths and hashes, preserve/change contract, design mode,
 reference policy, corpus directions, candidate paths and hashes, winner,
-specific rejection reasons, and visible rationale.
+specific rejection reasons, and visible rationale. Record whether the
+recommendation was followed or overridden, and for an override the reason. When
+the flow also writes a `design-run.json`, record the same pair there, the reason
+under `selection_override_reason`, alongside its existing selection fields.
 
 ### 4. Extend and convert
 
@@ -217,6 +246,22 @@ generation overlaps the base conversion. Inspect every result before accepting
 it. Convert accepted continuation images concurrently with distinct stable
 idempotency keys; never retry or replace an ambiguous generation.
 
+Budget about 4 minutes per conversion at `--model standard`. When a surface also
+needs responsive HTML, ask for it in the same command with `--export html`
+rather than exporting afterwards — the export then overlaps the conversion and
+the pair costs about 5 minutes instead of about 8, at the same price. One
+blocking command replaces the create-then-poll-then-export sequence. Both
+commands block for those durations and stream progress; neither has hung.
+
+The exported HTML is the deliverable page. Adapt and compose it: keep its
+document, structure, classes, and anchor bindings, and build the surface around
+that document — routing, real copy, state, interactions, and the later sections
+the first-viewport prompt deliberately omitted. Do not mine the export for its
+images and re-author the markup: that discards the design you just chose and
+paid to convert, and the page lands back on generic defaults. Fix defects in the
+export's own markup. Rebuild from scratch only when the export cannot carry the
+surface at all, and report it explicitly when you do.
+
 For ordered viewports of one continuous page, use the conversion package API
 to preserve page order. Integrate independent web routes, app states, or mobile
 screens as separate surfaces. Record the run in `<run-dir>/continuations.json`
@@ -229,9 +274,11 @@ with the same idempotency key; do not convert another candidate as a shortcut.
 
 Inspect generated files before merging the smallest coherent set into the
 project. Preserve routing, components, tokens, accessibility, dependencies,
-and unrelated changes. Add the exact copy, interactions, responsive behavior,
-later sections, and routes intentionally omitted from the first-viewport prompt
-while extending the visual system from the winner and accepted continuations.
+and unrelated changes. The converted export goes in as the page; integration is
+adapting it to the project, not replacing it. Add the exact copy, interactions,
+responsive behavior, later sections, and routes intentionally omitted from the
+first-viewport prompt while extending the visual system from the winner and
+accepted continuations.
 
 Run focused checks, launch the real interface, exercise interactions, and
 compare it with the winner at the source viewport plus representative narrower