@12ui/design 0.2.53 → 0.2.55

package/dist/improve-conversion-stage.d.ts

@@ -0,0 +1,28 @@
+import { runConversionCommand } from './cli-convert-command.js';
+import type { ImproveOptions } from './improve-options.js';
+import { type ImproveCommandDependencies } from './improve-stage-shared.js';
+import type { RunJournalNotes } from './run-journal.js';
+import { type ImproveRecord } from './improve-workspace.js';
+export declare const runImproveConversion: (args: {
+    input: string;
+    outDir: string;
+    output: "html" | "html_fixed" | "layerdoc";
+    model?: ImproveRecord["conversionModel"];
+    responsiveQuality?: ImproveRecord["responsiveQuality"];
+    timeoutMs?: number;
+    key: string;
+    runner: typeof runConversionCommand;
+    journal?: RunJournalNotes;
+}) => Promise<{
+    artifacts: string[];
+    purchaseIds: string[];
+    runIds: string[];
+}>;
+export declare const runImproveConvertStage: (args: {
+    record: ImproveRecord;
+    options: ImproveOptions;
+    dependencies: ImproveCommandDependencies;
+    price: number;
+    freshConversionNonce?: string;
+}) => Promise<ImproveRecord>;
+//# sourceMappingURL=improve-conversion-stage.d.ts.map

package/dist/improve-conversion-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-conversion-stage.d.ts","sourceRoot":"","sources":["../src/improve-conversion-stage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAahE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnG,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,oBAAoB,CAAC;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,KAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAoC3E,CAAC;AA6CF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,KAAG,OAAO,CAAC,aAAa,CAqIxB,CAAC"}

package/dist/improve-conversion-stage.js

@@ -0,0 +1,214 @@
+import { copyFile, cp, readFile, stat } from 'node:fs/promises';
+import sharp from 'sharp';
+import { runConversionCommand } from './cli-convert-command.js';
+import { CliRefusal } from './cli-refusal.js';
+import { prepareOutputDirectory } from './cli-output-paths.js';
+import { fixedImproveHtml, improveConversionIdFromText, improveErrorText, IMPROVE_RESPONSIVE_TIMEOUT_MS, prepareImproveTargetAttempt, recordedImproveConversionId, responsiveFallbackReason, } from './improve-convert-resilience.js';
+import { canvasOfDoc } from './improve-layerdoc-diff.js';
+import { improveSha256, noteImproveStage, } from './improve-stage-shared.js';
+import { readImproveRecord, writeImproveRecord } from './improve-workspace.js';
+export const runImproveConversion = async (args) => {
+    const artifacts = [];
+    const purchaseIds = [];
+    const runIds = [];
+    const collector = {
+        note: (facts) => {
+            artifacts.push(...(facts.artifacts ?? []));
+            purchaseIds.push(...(facts.purchased ?? []));
+            if (facts.runId)
+                runIds.push(facts.runId);
+            args.journal?.note(facts);
+        },
+        heartbeat: (progress) => { args.journal?.heartbeat(progress); },
+    };
+    const flags = {
+        output: args.output,
+        ...(args.model ? { model: args.model } : {}),
+        ...(args.responsiveQuality ? { 'responsive-quality': args.responsiveQuality } : {}),
+        ...(args.timeoutMs === undefined ? {} : { 'timeout-ms': String(args.timeoutMs) }),
+        'out-dir': args.outDir,
+        'idempotency-key': args.key,
+        quiet: true,
+    };
+    try {
+        await args.runner(['convert', args.input], flags, collector, { writeResult: () => undefined });
+    }
+    catch (error) {
+        throw new ImproveConvertAttemptError(error, {
+            artifacts: [...new Set(artifacts)],
+            purchaseIds: [...new Set(purchaseIds)],
+            runIds: [...new Set(runIds)],
+        });
+    }
+    return {
+        artifacts: [...new Set(artifacts)],
+        purchaseIds: [...new Set(purchaseIds)],
+        runIds: [...new Set(runIds)],
+    };
+};
+class ImproveConvertAttemptError extends Error {
+    attempt;
+    constructor(error, attempt) {
+        super(improveErrorText(error), { cause: error });
+        this.name = 'ImproveConvertAttemptError';
+        this.attempt = attempt;
+    }
+}
+const recordFreshConversion = async (args) => {
+    const durable = await readImproveRecord(args.options.paths.record) ?? args.record;
+    const abandonedId = await recordedImproveConversionId(durable);
+    const abandonedConversions = [...(durable.abandonedConversions ?? [])];
+    if (abandonedId && !abandonedConversions.some((entry) => entry.id === abandonedId)) {
+        abandonedConversions.push({
+            id: abandonedId,
+            abandonedAt: new Date().toISOString(),
+            reason: 'fresh requested after recorded conversion remained unavailable',
+        });
+        (args.dependencies.warn ?? console.warn)(`[fresh] convert: abandoning recorded conversion ${abandonedId}; requesting a new purchase`);
+    }
+    const record = {
+        ...durable,
+        ...(abandonedConversions.length > 0 ? { abandonedConversions } : {}),
+        convert: undefined,
+        plan: undefined,
+        stages: Object.fromEntries(Object.entries(durable.stages).filter(([stage]) => !['convert', 'plan'].includes(stage))),
+    };
+    await writeImproveRecord(args.options.paths.record, record);
+    return record;
+};
+export const runImproveConvertStage = async (args) => {
+    if (args.record.convert && !args.options.fresh)
+        return noteImproveStage({
+            record: args.record, stage: 'convert', priceCeilingUsd: args.price, replayed: true, write: true,
+        });
+    if (!args.record.pick && !args.record.target)
+        throw new Error('Cannot convert before pick');
+    await prepareOutputDirectory(args.options.paths.targetDir);
+    if (args.record.target?.kind === 'layerdoc') {
+        const bytes = await readFile(args.record.target.value);
+        canvasOfDoc(JSON.parse(bytes.toString('utf8')));
+        await copyFile(args.record.target.value, args.options.paths.targetLayerDoc);
+        const assetSource = `${args.record.target.value}.assets`;
+        if ((await stat(assetSource).catch(() => undefined))?.isDirectory()) {
+            await cp(assetSource, `${args.options.paths.targetLayerDoc}.assets`, { recursive: true });
+        }
+        let record = {
+            ...args.record,
+            target: { ...args.record.target, sha256: improveSha256(bytes) },
+            convert: {
+                layerDoc: args.options.paths.targetLayerDoc,
+                html: '',
+                layout: 'document',
+                artifacts: [args.options.paths.targetLayerDoc],
+                purchaseIds: [],
+            },
+        };
+        record = await noteImproveStage({
+            record, stage: 'convert', priceCeilingUsd: args.price, replayed: false, write: false,
+        });
+        await writeImproveRecord(args.options.paths.record, record);
+        return record;
+    }
+    let recordBeforeConvert = args.options.fresh
+        ? await recordFreshConversion(args)
+        : args.record;
+    let input = args.record.pick?.imagePath;
+    let inputSha = args.record.pick?.sha256;
+    if (args.record.target?.kind === 'image') {
+        const bytes = await readFile(args.record.target.value);
+        const image = sharp(bytes, { animated: false, failOn: 'warning' });
+        const metadata = await image.metadata();
+        if (!metadata.width || !metadata.height || !['png', 'jpeg', 'webp'].includes(metadata.format ?? '')) {
+            throw new CliRefusal('--target image is not a usable PNG, JPEG, or WebP', 'improve_target_invalid');
+        }
+        await image.png().toFile(args.options.paths.winnerImage);
+        input = args.options.paths.winnerImage;
+        inputSha = improveSha256(bytes);
+        recordBeforeConvert = { ...recordBeforeConvert, target: { ...args.record.target, sha256: inputSha } };
+    }
+    if (!input || !inputSha)
+        throw new Error('Improve has no design image to convert');
+    const targetIdentity = improveSha256(Buffer.from(`${inputSha}:${args.record.conversionModel}:${args.options.responsiveQuality}`)).slice(0, 32);
+    const baseKey = `improve-target:v2:${targetIdentity}`;
+    const key = args.options.fresh
+        ? `${baseKey}:fresh:${args.freshConversionNonce}`
+        : baseKey;
+    const transaction = await prepareImproveTargetAttempt(args.options.paths.targetDir);
+    try {
+        const converted = await runImproveConversion({
+            input,
+            outDir: args.options.paths.targetDir,
+            output: 'html',
+            model: args.record.conversionModel,
+            responsiveQuality: args.options.responsiveQuality,
+            timeoutMs: IMPROVE_RESPONSIVE_TIMEOUT_MS,
+            key,
+            runner: args.dependencies.runConvert ?? runConversionCommand,
+            journal: args.dependencies.journal,
+        }).catch(async (error) => {
+            const attempt = error instanceof ImproveConvertAttemptError
+                ? error.attempt
+                : { artifacts: [], purchaseIds: [], runIds: [] };
+            const warning = responsiveFallbackReason(error);
+            const sourceConversionId = attempt.runIds[0]
+                ?? improveConversionIdFromText(improveErrorText(error));
+            const layerDocPresent = (await stat(args.options.paths.targetLayerDoc).catch(() => undefined))?.isFile();
+            const assetsPresent = (await stat(`${args.options.paths.targetLayerDoc}.assets`).catch(() => undefined))?.isDirectory();
+            if (!warning || !sourceConversionId || !layerDocPresent || !assetsPresent)
+                throw error;
+            (args.dependencies.warn ?? console.warn)(`Responsive HTML was unavailable; deriving fixed-layout HTML free from ${sourceConversionId}`);
+            const fixed = await runImproveConversion({
+                input: sourceConversionId,
+                outDir: args.options.paths.targetDir,
+                output: 'html_fixed',
+                key: `improve-fixed:v1:${sourceConversionId}`,
+                runner: args.dependencies.runConvert ?? runConversionCommand,
+                journal: args.dependencies.journal,
+            });
+            const fixedOutput = await fixedImproveHtml(args.options.paths.targetDir);
+            args.dependencies.journal?.note({ degradations: ['improve_fixed_layout_fallback'] });
+            return {
+                artifacts: [...new Set([
+                        ...attempt.artifacts,
+                        ...fixed.artifacts,
+                        args.options.paths.targetLayerDoc,
+                        `${args.options.paths.targetLayerDoc}.assets`,
+                        fixedOutput.html,
+                        fixedOutput.assets,
+                    ])],
+                purchaseIds: [...new Set([...attempt.purchaseIds, ...fixed.purchaseIds])],
+                runIds: [...new Set([sourceConversionId, ...attempt.runIds, ...fixed.runIds])],
+                fallback: { html: fixedOutput.html, warning },
+            };
+        });
+        const html = 'fallback' in converted ? converted.fallback.html : args.options.paths.targetHtml;
+        for (const expected of [args.options.paths.targetLayerDoc, html]) {
+            if (!(await stat(expected).catch(() => undefined))?.isFile()) {
+                throw new Error(`Improve conversion completed without ${expected}`);
+            }
+        }
+        let record = {
+            ...recordBeforeConvert,
+            convert: {
+                layerDoc: args.options.paths.targetLayerDoc,
+                html,
+                layout: 'fallback' in converted ? 'fixed' : 'responsive',
+                ...(converted.runIds[0] ? { sourceConversionId: converted.runIds[0] } : {}),
+                ...('fallback' in converted ? { responsiveWarning: converted.fallback.warning } : {}),
+                artifacts: converted.artifacts,
+                purchaseIds: converted.purchaseIds,
+            },
+        };
+        record = await noteImproveStage({
+            record, stage: 'convert', priceCeilingUsd: args.price, replayed: false, write: false,
+        });
+        await writeImproveRecord(args.options.paths.record, record);
+        await transaction.commit();
+        return record;
+    }
+    catch (error) {
+        await transaction.restore();
+        throw error;
+    }
+};
+//# sourceMappingURL=improve-conversion-stage.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { ImproveRecord } from './improve-workspace.js';
+export declare const IMPROVE_RESPONSIVE_TIMEOUT_MS: number;
+export declare const IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS = 30000;
+export declare const improveErrorText: (error: unknown) => string;
+export declare const isImproveTemporarilyUnavailable: (error: unknown) => boolean;
+export declare const retryImproveTemporarilyUnavailable: <T>(args: {
+    stage: string;
+    action: () => Promise<T>;
+    sleep?: (milliseconds: number) => Promise<void>;
+    warn?: (line: string) => void;
+}) => Promise<T>;
+export declare const improveConversionIdFromText: (value: string) => string | undefined;
+export declare const recordedImproveConversionId: (record: ImproveRecord) => Promise<string | undefined>;
+export declare const responsiveFallbackReason: (error: unknown) => string | undefined;
+export declare const fixedImproveHtml: (targetDir: string) => Promise<{
+    html: string;
+    assets: string;
+}>;
+export declare const prepareImproveTargetAttempt: (targetDir: string) => Promise<{
+    commit: () => Promise<void>;
+    restore: () => Promise<void>;
+}>;
+//# sourceMappingURL=improve-convert-resilience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve-convert-resilience.d.ts","sourceRoot":"","sources":["../src/improve-convert-resilience.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,6BAA6B,QAA0C,CAAC;AACrF,eAAO,MAAM,4CAA4C,QAAS,CAAC;AAKnE,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,MAOjD,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,OAAO,OAAO,KAAG,OAEhE,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAAU,CAAC,EAAE,MAAM;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,KAAG,OAAO,CAAC,CAAC,CAaZ,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,SAIpE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,QAAQ,aAAa,KACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAc5B,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAYlE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAUA,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC;IAC5E,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAiBA,CAAC"}

package/dist/improve-convert-resilience.js

@@ -0,0 +1,102 @@
+import { mkdir, rename, rm, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { CONVERSION_DURATION_HINTS } from './cli-progress.js';
+import { derivedOutputFilePath } from './cli-conversion-output-directory.js';
+import { readRunJournal } from './run-journal.js';
+export const IMPROVE_RESPONSIVE_TIMEOUT_MS = CONVERSION_DURATION_HINTS.fused * 1_000;
+export const IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS = 30_000;
+const RESPONSIVE_PARTIAL_FAILURE = 'could not be completed for every required viewport size';
+const UUID = /[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}/iu;
+export const improveErrorText = (error) => {
+    const detail = error;
+    return [
+        error instanceof Error ? error.message : String(error),
+        typeof detail?.stdout === 'string' ? detail.stdout : undefined,
+        typeof detail?.stderr === 'string' ? detail.stderr : undefined,
+    ].filter((part) => Boolean(part)).join('\n');
+};
+export const isImproveTemporarilyUnavailable = (error) => (improveErrorText(error).toLowerCase().includes('temporarily unavailable'));
+export const retryImproveTemporarilyUnavailable = async (args) => {
+    try {
+        return await args.action();
+    }
+    catch (error) {
+        if (!isImproveTemporarilyUnavailable(error))
+            throw error;
+        (args.warn ?? console.warn)(`[retry] ${args.stage}: temporarily unavailable; retrying once after 30s`);
+        await (args.sleep ?? ((milliseconds) => new Promise((resolve) => {
+            setTimeout(resolve, milliseconds);
+        })))(IMPROVE_TEMPORARY_UNAVAILABLE_RETRY_DELAY_MS);
+        return args.action();
+    }
+};
+export const improveConversionIdFromText = (value) => {
+    const keyed = /(?:(?:"id"|"run_id")\s*:\s*"|conversion(?:\s+id)?[^0-9a-f]*)([0-9a-f-]{36})/iu
+        .exec(value)?.[1];
+    return keyed ?? UUID.exec(value)?.[0];
+};
+export const recordedImproveConversionId = async (record) => {
+    if (record.convert?.sourceConversionId && UUID.test(record.convert.sourceConversionId)) {
+        return record.convert.sourceConversionId;
+    }
+    const purchase = record.convert?.purchaseIds.find((id) => UUID.test(id));
+    if (purchase)
+        return purchase;
+    const journal = await readRunJournal({ workspace: record.runDir });
+    const targetLayerDoc = path.join(record.runDir, 'target', 'winner.layerdoc.json');
+    for (const entry of [...journal.entries].reverse()) {
+        if (entry.run_id
+            && UUID.test(entry.run_id)
+            && entry.writes?.includes(targetLayerDoc))
+            return entry.run_id;
+    }
+    return undefined;
+};
+export const responsiveFallbackReason = (error) => {
+    if (isImproveTemporarilyUnavailable(error))
+        return undefined;
+    const text = improveErrorText(error);
+    const normalized = text.toLowerCase();
+    if (normalized.includes(RESPONSIVE_PARTIAL_FAILURE)
+        || /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.';
+    }
+    return undefined;
+};
+export const fixedImproveHtml = async (targetDir) => {
+    const html = derivedOutputFilePath(targetDir, 'html_fixed');
+    const assets = `${html}.assets`;
+    if (!(await stat(html).catch(() => undefined))?.isFile()) {
+        throw new Error(`Fixed-layout derivation completed without ${html}`);
+    }
+    if (!(await stat(assets).catch(() => undefined))?.isDirectory()) {
+        throw new Error(`Fixed-layout derivation completed without ${assets}`);
+    }
+    return { html: path.resolve(html), assets: path.resolve(assets) };
+};
+export const prepareImproveTargetAttempt = async (targetDir) => {
+    const backupDir = `${targetDir}.previous`;
+    const targetExists = Boolean(await stat(targetDir).catch(() => undefined));
+    const backupExists = Boolean(await stat(backupDir).catch(() => undefined));
+    if (backupExists) {
+        if (!targetExists)
+            await rename(backupDir, targetDir);
+        else
+            await rm(backupDir, { recursive: true, force: true });
+    }
+    if (await stat(targetDir).catch(() => undefined))
+        await rename(targetDir, backupDir);
+    await mkdir(targetDir, { recursive: true });
+    return {
+        commit: async () => rm(backupDir, { recursive: true, force: true }),
+        restore: async () => {
+            await rm(targetDir, { recursive: true, force: true });
+            if (await stat(backupDir).catch(() => undefined))
+                await rename(backupDir, targetDir);
+        },
+    };
+};
+//# sourceMappingURL=improve-convert-resilience.js.map

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

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

package/dist/improve-delivery-stages.d.ts

@@ -0,0 +1,10 @@
+import type { ImproveOptions } from './improve-options.js';
+import { type ImproveCommandDependencies } from './improve-stage-shared.js';
+import { type ImproveRecord } from './improve-workspace.js';
+export declare const runImprovePlanStage: (args: {
+    record: ImproveRecord;
+    options: ImproveOptions;
+    dependencies: ImproveCommandDependencies;
+    price: number;
+}) => Promise<ImproveRecord>;
+//# sourceMappingURL=improve-delivery-stages.d.ts.map

package/dist/improve-delivery-stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-delivery-stages.d.ts","sourceRoot":"","sources":["../src/improve-delivery-stages.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA6FhF,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,aAAa,CA6DxB,CAAC"}

package/dist/improve-delivery-stages.js

@@ -0,0 +1,160 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { runConversionCommand } from './cli-convert-command.js';
+import { prepareOutputDirectory } from './cli-output-paths.js';
+import { runImproveConversion } from './improve-conversion-stage.js';
+import { writeImproveDomDiff } from './improve-dom-diff.js';
+import { evaluateImproveGate } from './improve-dom-gate.js';
+import { normalizeLayerDoc } from './improve-dom-scale.js';
+import { canvasOfDoc, diffLayerDocs, flattenLayerDoc } from './improve-layerdoc-diff.js';
+import { writeImproveAnnotatedPlan } from './improve-plan-annotator.js';
+import { renderLayerChanges } from './improve-plan-render.js';
+import { noteImproveStage, } from './improve-stage-shared.js';
+import { writeImproveRecord } from './improve-workspace.js';
+const syntheticLayerDiff = (beforeDoc, targetDoc) => {
+    const beforeCanvas = canvasOfDoc(beforeDoc);
+    const targetCanvas = canvasOfDoc(targetDoc);
+    const normalizedBefore = normalizeLayerDoc(beforeDoc);
+    const normalizedTarget = normalizeLayerDoc(targetDoc, beforeCanvas.width / targetCanvas.width);
+    const beforeLeaves = flattenLayerDoc(normalizedBefore);
+    const targetLeaves = flattenLayerDoc(normalizedTarget);
+    const result = diffLayerDocs(normalizedBefore, normalizedTarget);
+    const coverage = result.meta.plausibleMatchedCount / Math.max(beforeLeaves.length, 1);
+    return {
+        result,
+        beforeLeaves,
+        targetLeaves,
+        beforeCanvas,
+        targetCanvas,
+        lengthScale: beforeCanvas.width / targetCanvas.width,
+        domCoverage: coverage,
+        designCoverage: result.meta.plausibleMatchedCount / Math.max(targetLeaves.length, 1),
+        gate: evaluateImproveGate(1, 0),
+        markdown: '',
+    };
+};
+const writeImagePlan = async (args) => {
+    const targetDoc = JSON.parse(await readFile(args.options.paths.targetLayerDoc, 'utf8'));
+    let record = args.record;
+    let computed;
+    let mode;
+    const artifacts = [];
+    if (args.record.planSourceConvert) {
+        if (!record.sourceConvert) {
+            await prepareOutputDirectory(args.options.paths.sourceConversionDir);
+            const source = await runImproveConversion({
+                input: args.options.paths.sourceImage,
+                outDir: args.options.paths.sourceConversionDir,
+                output: 'layerdoc',
+                model: record.conversionModel,
+                key: `improve-source:v1:${record.capture?.sha256}:${record.conversionModel}`,
+                runner: args.dependencies.runConvert ?? runConversionCommand,
+                journal: args.dependencies.journal,
+            });
+            const sourceLayerDoc = path.join(args.options.paths.sourceConversionDir, 'source.layerdoc.json');
+            record = { ...record, sourceConvert: { layerDoc: sourceLayerDoc, ...source } };
+            await writeImproveRecord(args.options.paths.record, record);
+        }
+        const beforeDoc = JSON.parse(await readFile(record.sourceConvert.layerDoc, 'utf8'));
+        computed = syntheticLayerDiff(beforeDoc, targetDoc);
+        mode = 'layerdoc-anchored';
+        const diffPath = path.join(args.options.paths.planDir, 'diff.json');
+        const changesPath = path.join(args.options.paths.planDir, 'changes.md');
+        await Promise.all([
+            writeFile(diffPath, `${JSON.stringify({
+                generatedAt: new Date().toISOString(), before: record.sourceConvert.layerDoc,
+                after: args.options.paths.targetLayerDoc, mode, ...computed.result,
+            }, null, 2)}\n`, 'utf8'),
+            writeFile(changesPath, renderLayerChanges({
+                result: computed.result,
+                beforePath: record.sourceConvert.layerDoc,
+                targetPath: args.options.paths.targetLayerDoc,
+                beforeDoc,
+                targetDoc,
+            }), 'utf8'),
+        ]);
+        artifacts.push(diffPath, changesPath);
+    }
+    else {
+        const empty = { version: 2, canvas: canvasOfDoc(targetDoc), layers: [] };
+        computed = syntheticLayerDiff(empty, targetDoc);
+        mode = 'unanchored';
+        const diffPath = path.join(args.options.paths.planDir, 'diff.json');
+        const changesPath = path.join(args.options.paths.planDir, 'changes.md');
+        await Promise.all([
+            writeFile(diffPath, `${JSON.stringify({
+                generatedAt: new Date().toISOString(), mode, after: args.options.paths.targetLayerDoc,
+                note: 'Target-only plan; no source conversion was purchased.', ...computed.result,
+            }, null, 2)}\n`, 'utf8'),
+            writeFile(changesPath, '# Target-only improve plan\n\nNo source conversion was purchased. Every target element is an unanchored implementation specification.\n', 'utf8'),
+        ]);
+        artifacts.push(diffPath, changesPath);
+    }
+    return { computed, mode, artifacts, record };
+};
+export const runImprovePlanStage = async (args) => {
+    if (args.record.plan)
+        return noteImproveStage({
+            record: args.record, stage: 'plan', priceCeilingUsd: args.price, replayed: true, write: true,
+        });
+    if (!args.record.convert)
+        throw new Error('Cannot plan before convert');
+    await mkdir(args.options.paths.planDir, { recursive: true });
+    const targetDoc = JSON.parse(await readFile(args.options.paths.targetLayerDoc, 'utf8'));
+    let record = args.record;
+    let mode;
+    let gate;
+    let artifacts;
+    if (args.options.input.kind === 'url') {
+        const diff = await writeImproveDomDiff({
+            beforePath: args.options.paths.currentDomDoc,
+            targetPath: args.options.paths.targetLayerDoc,
+            outDir: args.options.paths.planDir,
+        });
+        mode = 'dom-anchored';
+        gate = diff.gate.passed ? 'passed' : 'blocked';
+        artifacts = [...diff.artifacts];
+        if (diff.gate.passed) {
+            const annotated = await writeImproveAnnotatedPlan({
+                computed: diff,
+                targetDoc,
+                targetPath: args.options.paths.targetLayerDoc,
+                outDir: args.options.paths.planDir,
+                ...(args.record.repo ? { repo: args.record.repo } : {}),
+                mode,
+            });
+            artifacts.push(...annotated.artifacts);
+        }
+    }
+    else {
+        const imagePlan = await writeImagePlan({ record, options: args.options, dependencies: args.dependencies });
+        record = imagePlan.record;
+        mode = imagePlan.mode;
+        gate = 'not-applicable';
+        artifacts = [...imagePlan.artifacts];
+        const annotated = await writeImproveAnnotatedPlan({
+            computed: imagePlan.computed,
+            targetDoc,
+            targetPath: args.options.paths.targetLayerDoc,
+            outDir: args.options.paths.planDir,
+            mode,
+        });
+        artifacts.push(...annotated.artifacts);
+    }
+    record = {
+        ...record,
+        plan: {
+            mode,
+            gate,
+            artifacts: [...new Set(artifacts)],
+            ...(record.sourceConvert ? { sourceLayerDoc: record.sourceConvert.layerDoc } : {}),
+            purchaseIds: record.sourceConvert?.purchaseIds ?? [],
+        },
+    };
+    record = await noteImproveStage({
+        record, stage: 'plan', priceCeilingUsd: args.price, replayed: false, write: false,
+    });
+    await writeImproveRecord(args.options.paths.record, record);
+    return record;
+};
+//# sourceMappingURL=improve-delivery-stages.js.map

package/dist/improve-delivery-stages.js.map

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

package/dist/improve-dom-anchor.d.ts

@@ -0,0 +1,18 @@
+import type { ImpliedPaddingDelta, LayerBox, LayerDiffMatch, LayerLeaf } from './improve-layerdoc-types.js';
+export declare const selectorLabel: (leaf: LayerLeaf | undefined) => string;
+export declare const containment: (inner: LayerBox | undefined, outer: LayerBox | undefined) => number;
+export declare const confidentMatches: (matched: readonly LayerDiffMatch[], before: readonly LayerLeaf[], after: readonly LayerLeaf[], minimumIou?: number) => Set<number>;
+export declare const insertionAnchor: (box: LayerBox, before: readonly LayerLeaf[]) => {
+    container: number;
+    after?: number;
+    before?: number;
+};
+export declare const impliedPaddingDeltas: (matched: readonly LayerDiffMatch[], before: readonly LayerLeaf[], after: readonly LayerLeaf[], canvas: {
+    width: number;
+    height: number;
+}, confident: ReadonlySet<number>) => Map<number, ImpliedPaddingDelta[]>;
+export declare const domPx: (box: LayerBox | undefined, canvas: {
+    width: number;
+    height: number;
+}) => LayerBox | undefined;
+//# sourceMappingURL=improve-dom-anchor.d.ts.map

package/dist/improve-dom-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-dom-anchor.d.ts","sourceRoot":"","sources":["../src/improve-dom-anchor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,SAAS,EACV,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,GAAG,SAAS,KAAG,MAQ3D,CAAC;AAIF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,GAAG,SAAS,EAAE,OAAO,QAAQ,GAAG,SAAS,KAAG,MAKtF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,SAAS,SAAS,cAAc,EAAE,EAClC,QAAQ,SAAS,SAAS,EAAE,EAC5B,OAAO,SAAS,SAAS,EAAE,EAC3B,mBAAgB,KACf,GAAG,CAAC,MAAM,CAcZ,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,KAAK,QAAQ,EACb,QAAQ,SAAS,SAAS,EAAE,KAC3B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CA6BtD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,SAAS,cAAc,EAAE,EAClC,QAAQ,SAAS,SAAS,EAAE,EAC5B,OAAO,SAAS,SAAS,EAAE,EAC3B,QAAQ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,WAAW,WAAW,CAAC,MAAM,CAAC,KAC7B,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,CA0CnC,CAAC;AAEF,eAAO,MAAM,KAAK;;;0BAAgB,CAAC"}