foundry-design 0.2.0-beta.21 → 0.2.0-beta.23

package/README.md

@@ -10,7 +10,9 @@ Design Branches keeps parallel visual directions isolated inside one local sessi
 
 Foundry is distributed through npm, so testers do not need GitHub access.
 
-> **Current beta release:** `0.2.0-beta.21`. After publication, both npm `latest` and `beta` resolve to this release.
+> **Current beta release:** `0.2.0-beta.23`. For an exact-version install, use `foundry-design@0.2.0-beta.23`.
+
+The redesigned workspace now opens by default. Existing `ui=next` links continue to work; append `ui=legacy` to the workspace URL only when you need the previous interface for compatibility.
 
 Full documentation is available at [withfoundry.ai](https://withfoundry.ai).
 
@@ -141,10 +143,10 @@ If an npm mirror or existing `npx` cache reports an old tag, bypass it with a te
 
 ```bash
 FOUNDRY_NPX_CACHE="$(mktemp -d)"
-npx --yes --prefer-online --registry=https://registry.npmjs.org --cache "$FOUNDRY_NPX_CACHE" --package=foundry-design@0.2.0-beta.21 foundry-design
+npx --yes --prefer-online --registry=https://registry.npmjs.org --cache "$FOUNDRY_NPX_CACHE" --package=foundry-design@0.2.0-beta.23 foundry-design
 ```
 
-The beta supports Node.js 20 or newer. Read the [local-first safety model](https://withfoundry.ai/#safety) before using it with sensitive work.
+The CLI supports Node.js 20.9 or newer. Repository development and the framework compatibility fixtures require Node.js 20.19 or newer. Read the [local-first safety model](https://withfoundry.ai/#safety) before using it with sensitive work.
 
 ## Agent plugin
 
@@ -158,7 +160,7 @@ Foundry remains local-first. Installing the plugin does not create an account, e
 
 ### Cursor one-click connection
 
-[Add the Foundry MCP bridge to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=foundry-design-control&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIi0tcHJlZmVyLW9ubGluZSIsImZvdW5kcnktZGVzaWduLW1jcC1zZXJ2ZXJAMC4yLjAtYmV0YS4yMSJdLCJlbnYiOnsiRk9VTkRSWV9ERVNJR05fUlVOVElNRV9VUkwiOiJodHRwOi8vMTI3LjAuMC4xOjQzODcifX0%3D), then run `npx foundry-design` inside the project. The repository's Cursor plugin additionally bundles the Foundry skill and session-start hook for marketplace distribution.
+[Add the Foundry MCP bridge to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=foundry-design-control&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIi0tcHJlZmVyLW9ubGluZSIsImZvdW5kcnktZGVzaWduLW1jcC1zZXJ2ZXJAMC4yLjAtYmV0YS4yMyJdLCJlbnYiOnsiRk9VTkRSWV9ERVNJR05fUlVOVElNRV9VUkwiOiJodHRwOi8vMTI3LjAuMC4xOjQzODcifX0%3D), then run `npx foundry-design` inside the project. The repository's Cursor plugin additionally bundles the Foundry skill and session-start hook for marketplace distribution.
 
 ## Current capabilities
 

package/dist/delivery-capture.d.ts

@@ -0,0 +1,8 @@
+import { type ChangeContext, type DesignChange, type VisualScreen } from 'foundry-design-protocol';
+import type { DeliveryCaptureRequest, DeliveryCaptureResult, DeliveryEvidenceRequest } from 'foundry-design-runtime';
+/** Reads one runtime-indexed capture, never a client-supplied file or arbitrary screenshot. */
+export declare function readDeliveryEvidence({ projectRoot, evidence, }: DeliveryEvidenceRequest): Promise<Uint8Array>;
+export declare function deliveryCaptureScreen(input: DeliveryCaptureRequest, change: DesignChange, context: ChangeContext): VisualScreen;
+/** A reviewed Apply is the only caller. Fresh contexts never install the overlay or replay drafts. */
+export declare function captureDeliveryEvidence(input: DeliveryCaptureRequest): Promise<DeliveryCaptureResult>;
+//# sourceMappingURL=delivery-capture.d.ts.map

package/dist/delivery-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-capture.d.ts","sourceRoot":"","sources":["../src/delivery-capture.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAOhC,+FAA+F;AAC/F,wBAAsB,oBAAoB,CAAC,EACzC,WAAW,EACX,QAAQ,GACT,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0C/C;AAsBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,GACrB,YAAY,CAmFd;AA4BD,sGAAsG;AACtG,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA6EhC"}

package/dist/delivery-capture.js

@@ -0,0 +1,234 @@
+import { execFile } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+import { constants } from 'node:fs';
+import { lstat, mkdir, open, realpath } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { promisify } from 'node:util';
+import { chromium } from 'playwright';
+import sharp from 'sharp';
+import { visualScreenSchema, } from 'foundry-design-protocol';
+import { captureVisualScreen, UnsupportedVisualContextError, validateVisualUrl, } from './visual-check-capture.js';
+/** Reads one runtime-indexed capture, never a client-supplied file or arbitrary screenshot. */
+export async function readDeliveryEvidence({ projectRoot, evidence, }) {
+    const capture = evidence.capture;
+    if (!capture?.sha256 ||
+        !capture.conditions ||
+        !['before', 'rebuilt'].includes(capture.phase) ||
+        !/^\.foundry\/sessions\/delivery-evidence\/(before|rebuilt)-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.png$/.test(evidence.path) ||
+        !evidence.path.split('/').at(-1)?.startsWith(`${capture.phase}-`))
+        throw new Error('Evidence is not a trusted source capture.');
+    const root = await realpath(projectRoot);
+    let file = root;
+    const parts = evidence.path.split('/');
+    for (const [index, part] of parts.entries()) {
+        file = join(file, part);
+        const stat = await lstat(file);
+        if (stat.isSymbolicLink() || (index < parts.length - 1 ? !stat.isDirectory() : !stat.isFile()))
+            throw new Error('Evidence paths must remain inside the project capture directory.');
+    }
+    if ((await realpath(file)) !== file)
+        throw new Error('Evidence path changed during validation.');
+    const handle = await open(file, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const stat = await handle.stat();
+        if (!stat.isFile() || stat.size > 20 * 1024 * 1024)
+            throw new Error('Evidence image exceeds the safe size limit.');
+        const png = await handle.readFile();
+        if (createHash('sha256').update(png).digest('hex') !== capture.sha256)
+            throw new Error('Evidence image does not match its recorded digest.');
+        const metadata = await sharp(png, { limitInputPixels: 40_000_000 }).metadata();
+        const scale = capture.conditions.deviceScaleFactor;
+        if (metadata.format !== 'png' ||
+            metadata.width !== capture.viewport.width * scale ||
+            metadata.height !== capture.viewport.height * scale)
+            throw new Error('Evidence image does not match its recorded viewport.');
+        return png;
+    }
+    finally {
+        await handle.close();
+    }
+}
+function themeHook(id, graph) {
+    if (id === 'current' || id === 'system')
+        return undefined;
+    const theme = graph?.themes?.find((candidate) => candidate.id === id);
+    if (!theme?.selector)
+        throw new UnsupportedVisualContextError(`Theme ${id} has no indexed root selector.`);
+    const attribute = /^(html|body|:root)?\[([a-z-]+)=["']?([^"'\]]+)["']?\]$/.exec(theme.selector);
+    if (attribute && (!theme.attribute || theme.attribute === attribute[2]))
+        return {
+            selector: attribute[1] || 'html',
+            attribute: attribute[2],
+            value: theme.value ?? attribute[3],
+        };
+    const className = /^(html|body|:root)?\.([a-zA-Z_-][\w-]*)$/.exec(theme.selector);
+    if (className)
+        return { selector: className[1] || 'html', attribute: 'class', value: className[2] };
+    throw new UnsupportedVisualContextError(`Theme ${id} does not expose a supported root attribute or class hook.`);
+}
+export function deliveryCaptureScreen(input, change, context) {
+    if (!input.changeSet.context.targetUrl)
+        throw new UnsupportedVisualContextError('No product preview URL is configured.');
+    const url = validateVisualUrl(input.changeSet.context.targetUrl);
+    const selector = typeof change.target.locator.selector === 'string'
+        ? change.target.locator.selector
+        : typeof change.target.locator.foundryId === 'string'
+            ? `[data-foundry-id=${JSON.stringify(change.target.locator.foundryId)}]`
+            : undefined;
+    if (!selector)
+        throw new UnsupportedVisualContextError('Reviewed target has no browser selector.');
+    const breakpoint = input.designGraph?.breakpoints?.find((candidate) => candidate.id === context.breakpoint);
+    const viewport = context.breakpoint === 'current'
+        ? input.changeSet.context.viewport
+        : breakpoint && {
+            width: breakpoint.width,
+            height: breakpoint.height ?? input.changeSet.context.viewport?.height,
+        };
+    if (!viewport?.width || !viewport.height)
+        throw new UnsupportedVisualContextError(`Breakpoint ${context.breakpoint} has no recorded dimensions.`);
+    let selectedTheme = context.theme;
+    let state = 'current';
+    let stateHook;
+    if (context.state !== 'current') {
+        const authored = input.designGraph?.states?.find((candidate) => candidate.id === context.state);
+        if (!authored)
+            throw new UnsupportedVisualContextError(`State ${context.state} is not indexed.`);
+        if (authored.pseudoStates?.length)
+            throw new UnsupportedVisualContextError(`State ${context.state} needs pseudo-state replay; no visual capture was fabricated.`);
+        if (authored.reducedMotion === false)
+            throw new UnsupportedVisualContextError(`State ${context.state} requires motion; the still-image capture uses reduced motion.`);
+        if (authored.viewport &&
+            (authored.viewport.width !== viewport.width || authored.viewport.height !== viewport.height))
+            throw new UnsupportedVisualContextError(`State ${context.state} has different authored dimensions.`);
+        if (authored.theme) {
+            if (!['current', 'system', authored.theme].includes(selectedTheme))
+                throw new UnsupportedVisualContextError('Authored state and requested theme conflict.');
+            selectedTheme = authored.theme;
+        }
+        for (const [key, value] of Object.entries(authored.query ?? {}))
+            url.searchParams.set(key, value);
+        const variants = Object.entries(authored.variant ?? {});
+        if (variants.length > 1)
+            throw new UnsupportedVisualContextError(`State ${context.state} has multiple variant axes; no partial capture was retained.`);
+        if (variants[0]) {
+            const [property, value] = variants[0];
+            state = context.state;
+            stateHook = {
+                selector,
+                attribute: `data-${property.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`,
+                value: String(value),
+            };
+        }
+    }
+    validateVisualUrl(url.toString());
+    return visualScreenSchema.parse({
+        version: 1,
+        name: 'delivery-capture',
+        url: url.toString(),
+        viewport,
+        theme: ['current', 'system'].includes(selectedTheme) ? 'current' : selectedTheme,
+        state,
+        themeHook: themeHook(selectedTheme, input.designGraph),
+        stateHook,
+        targets: [selector],
+        masks: [],
+    });
+}
+async function ignoredCaptureDirectory(projectRoot) {
+    const root = await realpath(projectRoot);
+    const local = '.foundry/sessions/delivery-evidence';
+    const { stdout } = await promisify(execFile)('git', ['check-ignore', '--', `${local}/capture.png`], { cwd: root, timeout: 2500 });
+    if (!stdout.trim())
+        throw new Error('Delivery evidence needs the ignored .foundry/sessions folder created by setup.');
+    let directory = root;
+    for (const part of local.split('/')) {
+        directory = join(directory, part);
+        const stat = await lstat(directory).catch((error) => {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        });
+        if (stat?.isSymbolicLink() || (stat && !stat.isDirectory()))
+            throw new Error('Delivery evidence directory must be a local project directory.');
+        if (!stat)
+            await mkdir(directory);
+    }
+    return directory;
+}
+/** A reviewed Apply is the only caller. Fresh contexts never install the overlay or replay drafts. */
+export async function captureDeliveryEvidence(input) {
+    const result = { screenshots: [], unavailable: [] };
+    if (input.signal.aborted)
+        return { screenshots: [], unavailable: ['Visual capture was cancelled.'] };
+    const root = await realpath(input.changeSet.context.projectRoot);
+    const directory = await ignoredCaptureDirectory(root);
+    const browser = await chromium.launch({ headless: true, timeout: 8000 });
+    const abort = () => {
+        void browser.close().catch(() => { });
+    };
+    input.signal.addEventListener('abort', abort, { once: true });
+    try {
+        const seen = new Set();
+        for (const change of input.changeSet.changes) {
+            for (const breakpoint of change.contextSet.breakpoints)
+                for (const theme of change.contextSet.themes)
+                    for (const state of change.contextSet.states) {
+                        const context = { breakpoint, theme, state };
+                        const key = JSON.stringify([change.target.id, context]);
+                        if (seen.has(key))
+                            continue;
+                        seen.add(key);
+                        const label = `${change.target.label}: ${breakpoint} / ${theme} / ${state}`;
+                        if (input.signal.aborted) {
+                            result.unavailable.push(`${label}: capture time limit reached.`);
+                            continue;
+                        }
+                        try {
+                            const screen = deliveryCaptureScreen(input, change, context);
+                            const path = join(directory, `${input.phase}-${randomUUID()}.png`);
+                            const captured = await captureVisualScreen(browser, screen, root, path);
+                            const geometry = captured.geometry[0];
+                            if (captured.geometry.length !== 1 ||
+                                !geometry ||
+                                geometry.width <= 0 ||
+                                geometry.height <= 0 ||
+                                geometry.x >= screen.viewport.width ||
+                                geometry.y >= screen.viewport.height ||
+                                geometry.x + geometry.width <= 0 ||
+                                geometry.y + geometry.height <= 0)
+                                throw new UnsupportedVisualContextError('Reviewed target does not resolve to one visible rendered element.');
+                            result.screenshots.push({
+                                label: `${input.phase === 'before' ? 'Source before Apply' : 'Verified rebuilt source'} · ${label}`,
+                                path: relative(root, path).split(sep).join('/'),
+                                createdAt: captured.createdAt,
+                                capture: {
+                                    version: 1,
+                                    phase: input.phase,
+                                    context,
+                                    viewport: screen.viewport,
+                                    sourceRevision: input.revision,
+                                    applyRunId: input.applyRunId,
+                                    targetId: change.target.id,
+                                    sha256: captured.screenshotHash,
+                                    conditions: {
+                                        motion: captured.motion,
+                                        browser: captured.browser,
+                                        platform: captured.platform,
+                                        deviceScaleFactor: captured.deviceScaleFactor,
+                                    },
+                                },
+                            });
+                        }
+                        catch (error) {
+                            result.unavailable.push(`${input.phase} ${label}: ${error instanceof Error ? error.message : 'capture unavailable'}`);
+                        }
+                    }
+        }
+        return result;
+    }
+    finally {
+        input.signal.removeEventListener('abort', abort);
+        await browser.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=delivery-capture.js.map

package/dist/delivery-capture.js.map

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

package/dist/delivery-export.d.ts

@@ -1,4 +1,5 @@
 import type { DeliveryRecord } from 'foundry-design-protocol';
+export { matchingDeliveryCaptures } from 'foundry-design-protocol';
 import { type StoredSession } from 'foundry-design-runtime';
 export interface DeliveryExportManifest {
     format: 'foundry.delivery-export';
@@ -20,7 +21,8 @@ export declare class DeliveryExportConflictError extends Error {
     readonly documentationPageIds: string[];
     constructor(conflictingPaths: string[], documentationPageIds: string[]);
 }
-export declare function renderPortableDeliveryJson(record: DeliveryRecord, projectRoot: string): string;
+export declare function renderPortableDeliveryJson(record: DeliveryRecord, projectRoot: string, session?: Pick<StoredSession, 'applyRuns'>): string;
+export declare function renderEngineeringBrief(session: StoredSession, record: DeliveryRecord): string;
 export declare function deliveryExportFiles(session: StoredSession, record: DeliveryRecord): Map<string, string>;
 export declare function resolveManagedDeliveryPath(outputRoot: string, relativePath: string): string;
 export declare function writeRepositoryDeliveryExport(outputRoot: string, session: StoredSession, record: DeliveryRecord, now?: string): Promise<DeliveryExportManifest>;

package/dist/delivery-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-export.d.ts","sourceRoot":"","sources":["../src/delivery-export.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,kBAAkB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;gBAE5B,gBAAgB,EAAE,MAAM,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE;CAQvE;AAqBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM9F;AA+DD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,cAAc,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAwDrB;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAc3F;AAwBD,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,cAAc,EACtB,GAAG,SAA2B,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAsDjC"}
+{"version":3,"file":"delivery-export.d.ts","sourceRoot":"","sources":["../src/delivery-export.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,kBAAkB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;gBAE5B,gBAAgB,EAAE,MAAM,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE;CAQvE;AAqBD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GACzC,MAAM,CAeR;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CA+G7F;AA+ED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,cAAc,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyErB;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAc3F;AAuFD,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,cAAc,EACtB,GAAG,SAA2B,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAoEjC"}

package/dist/delivery-export.js

@@ -1,6 +1,9 @@
 import { createHash } from 'node:crypto';
 import { access, lstat, mkdir, readFile, writeFile } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { dirname, extname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import sharp from 'sharp';
+import { engineeringVerification, matchingDeliveryCaptures } from 'foundry-design-protocol';
+export { matchingDeliveryCaptures } from 'foundry-design-protocol';
 import { renderDeliveryMarkdown, sanitizeDeliveryText, } from 'foundry-design-runtime';
 export class DeliveryExportConflictError extends Error {
     conflictingPaths;
@@ -28,12 +31,98 @@ function sanitizeJsonValue(value, projectRoot) {
 function safeJson(value, projectRoot) {
     return `${JSON.stringify(sanitizeJsonValue(value, projectRoot), null, 2)}\n`;
 }
-export function renderPortableDeliveryJson(record, projectRoot) {
-    return JSON.stringify(sanitizeJsonValue({ format: 'foundry.delivery-record', version: 1, record }, projectRoot), null, 2);
+export function renderPortableDeliveryJson(record, projectRoot, session) {
+    const run = session?.applyRuns.find((item) => item.id === record.applyRunId);
+    return JSON.stringify(sanitizeJsonValue({
+        format: 'foundry.delivery-record',
+        version: 1,
+        record,
+        reviewedChangeSet: run?.reviewedChangeSet,
+    }, projectRoot), null, 2);
+}
+export function renderEngineeringBrief(session, record) {
+    const root = session.changeSet.context.projectRoot;
+    const safe = (value) => sanitizeDeliveryText(value, root)
+        .replace(/\|/g, '\\|')
+        .replace(/[\r\n]+/g, ' ');
+    const value = (input) => safe(typeof input === 'string' ? input : (JSON.stringify(input) ?? 'unknown'));
+    const run = session.applyRuns.find((item) => item.id === record.applyRunId);
+    const reviewed = run?.reviewedChangeSet;
+    const changes = reviewed?.changes.filter((change) => record.changeIds.includes(change.id)) ?? [];
+    const lines = [
+        renderDeliveryMarkdown({ ...record, verificationResults: [] }, root),
+        'The coverage below is checked against the frozen request and current Apply attempt.',
+        '',
+        '## Reviewed implementation contract',
+        '',
+    ];
+    if (!reviewed)
+        lines.push('The frozen reviewed contract is unavailable in this older record. Exact edits and complete context verification cannot be reconstructed.', '');
+    else {
+        lines.push('| Target / property | Before | Requested | Source | Context | Verification |', '| --- | --- | --- | --- | --- | --- |');
+        for (const change of changes) {
+            const mapping = change.mappingCandidates.find((item) => item.id === change.selectedMappingId) ??
+                (change.mappingCandidates.length === 1 ? change.mappingCandidates[0] : undefined);
+            const source = mapping?.source ?? change.target.source;
+            for (const breakpoint of change.contextSet.breakpoints)
+                for (const theme of change.contextSet.themes)
+                    for (const state of change.contextSet.states) {
+                        const verification = engineeringVerification(record, run, change, {
+                            breakpoint,
+                            theme,
+                            state,
+                        });
+                        const result = verification.result;
+                        const outcome = verification.status === 'passed'
+                            ? 'Passed'
+                            : verification.status === 'failed'
+                                ? 'Failed'
+                                : 'Untested';
+                        lines.push(`| ${safe(change.target.label)} / ${safe(change.property)} | ${value(change.before)} | ${value(change.after)} | ${source ? safe(`${source.file}${source.line ? `:${source.line}` : ''}`) : 'Mapping unavailable'} | ${safe(`${breakpoint} / ${theme} / ${state}`)} | ${outcome}${result ? `: rendered ${value(result.rendered)}` : ''}${verification.reason ? ` (${safe(verification.reason)})` : ''} |`);
+                    }
+        }
+        if (!changes.length)
+            lines.push('| No matching changes in the frozen contract | | | | | Untested |');
+        lines.push('');
+    }
+    lines.push('## Execution provenance', '', `- Reviewed source revision: ${safe(record.baselineRevision ?? 'Unavailable')}`, `- Applied source revision: ${safe(record.appliedRevision ?? 'Unavailable')}`, `- Apply run: ${safe(record.applyRunId)}`, `- Design graph revision: ${safe(record.designGraphRevision ?? 'Unavailable')}`, `- Narrative origin: ${record.narrativeSource}`, '');
+    if (record.blockers.length)
+        lines.push('## Unresolved blockers', '', ...record.blockers.map((item) => `- ${safe(item)}`), '');
+    const pairs = matchingDeliveryCaptures(record);
+    lines.push('## Visual evidence', '');
+    if (record.captureIssues?.length)
+        lines.push(...record.captureIssues.map((issue) => `- Capture unavailable: ${safe(issue)}`), '');
+    if (!pairs.length)
+        lines.push('No matching before/rebuilt image pair is recorded. Existing references are not proof of a visual comparison.', '');
+    for (const pair of pairs) {
+        const context = pair.after.capture;
+        lines.push(`### ${safe(`${context.context.breakpoint} / ${context.context.theme} / ${context.context.state}`)} · ${context.viewport.width} × ${context.viewport.height}`, '', `Before: ${safe(pair.before.path)}`, '', `Rebuilt: ${safe(pair.after.path)}`, '');
+    }
+    for (const evidence of record.evidence) {
+        const phase = evidence.capture?.phase === 'preview'
+            ? 'Temporary preview'
+            : evidence.capture?.phase === 'rebuilt'
+                ? 'Rebuilt capture (see provenance)'
+                : evidence.capture?.phase === 'before'
+                    ? 'Before source change'
+                    : 'Unclassified reference';
+        lines.push(`- ${phase}: ${safe(evidence.label)} — ${safe(evidence.path)} (${safe(evidence.createdAt)})`);
+    }
+    if (!record.validationResults.length)
+        lines.push('', 'No validation results are recorded.');
+    if (!record.verificationResults.length)
+        lines.push('', 'No rendered verification results are recorded.');
+    return `${lines.join('\n')}\n`;
 }
 function historyMarkdown(session, projectRoot) {
     const safe = (value) => sanitizeDeliveryText(value, projectRoot);
     const lines = ['# Foundry design history', ''];
+    for (const milestone of session.deliveryMilestones) {
+        const entries = session.designHistory.filter((entry) => milestone.entryIds.includes(entry.id));
+        lines.push(`## Milestone: ${safe(milestone.name)} (${milestone.status})`, '', safe(milestone.summary), '', ...entries.map((entry) => `- ${safe(entry.title)}: ${safe(entry.summary)} (${safe(entry.deliveryRecordId)})`), '');
+        if (milestone.entryIds.length > entries.length)
+            lines.push('Some milestone entries are unavailable in this session.', '');
+    }
     if (!session.designHistory.length)
         lines.push('No verified delivery records yet.', '');
     for (const entry of session.designHistory) {
@@ -84,20 +173,35 @@ export function deliveryExportFiles(session, record) {
     const files = new Map();
     const recordId = deliveryIdentifier(record.id);
     const safe = (value) => sanitizeDeliveryText(value, root);
-    addManagedFile(files, `docs/foundry/handoffs/${recordId}.md`, `${renderDeliveryMarkdown(record, root)}\n`);
-    addManagedFile(files, `docs/foundry/handoffs/${recordId}.json`, safeJson({ format: 'foundry.delivery-record', version: 1, record }, root));
+    addManagedFile(files, `docs/foundry/handoffs/${recordId}.md`, renderEngineeringBrief(session, record));
+    addManagedFile(files, `docs/foundry/handoffs/${recordId}.json`, `${renderPortableDeliveryJson(record, root, session)}\n`);
     addManagedFile(files, `docs/foundry/handoffs/${recordId}.pr.md`, [
         `# ${safe(record.title)}`,
         '',
         safe(record.summary),
         '',
+        '## Intent',
+        '',
+        safe(record.intent),
+        '',
+        '## Affected source and contexts',
+        '',
+        ...record.affectedFiles.map((file) => `- ${safe(file)}`),
+        ...record.contexts.map((context) => `- ${safe(context.breakpoint)} / ${safe(context.theme)} / ${safe(context.state)}`),
+        '',
+        '## Risks and unresolved questions',
+        '',
+        ...[...record.risks, ...record.questions, ...record.blockers].map((item) => `- ${safe(item)}`),
+        '',
         '## Validation',
         '',
         ...record.validationResults.map((item) => `- [${item.passed ? 'x' : ' '}] ${safe(item.name)}${item.summary ? `: ${safe(item.summary)}` : ''}`),
         '',
         '## Rendered verification',
         '',
-        ...record.verificationResults.map((item) => `- [${item.passed ? 'x' : ' '}] ${safe(item.property)}${item.context ? ` (${safe(item.context.breakpoint)} / ${safe(item.context.theme)} / ${safe(item.context.state)})` : ''}${item.reason ? `: ${safe(item.reason)}` : ''}`),
+        'See the engineering brief for exact request, claim and context coverage. Raw pass flags alone are not treated as proof.',
+        '',
+        `Complete engineering brief: ${recordId}.md`,
         '',
     ].join('\n'));
     for (const page of session.documentationPages)
@@ -146,6 +250,60 @@ async function assertNoSymlinkTraversal(root, target) {
         }
     }
 }
+async function bundledDeliveryEvidence(projectRoot, record) {
+    const files = new Map();
+    const attachments = [];
+    const candidates = [
+        ...new Set([
+            ...record.evidence.map((item) => item.path),
+            ...record.verificationResults
+                .map((item) => item.screenshotPath)
+                .filter((item) => Boolean(item)),
+        ]),
+    ];
+    for (const [index, source] of candidates.entries()) {
+        try {
+            const target = resolve(projectRoot, source);
+            const inside = relative(projectRoot, target);
+            if (!inside || inside === '..' || inside.startsWith(`..${sep}`) || isAbsolute(inside))
+                throw new Error('Evidence is outside the project and was not copied.');
+            await assertNoSymlinkTraversal(projectRoot, target);
+            const extension = extname(target).toLowerCase();
+            if (!['.png', '.jpg', '.jpeg', '.webp'].includes(extension))
+                throw new Error('Only PNG, JPEG and WebP evidence can be bundled.');
+            const stat = await lstat(target);
+            if (!stat.isFile() || stat.size > 20 * 1024 * 1024)
+                throw new Error('Evidence is not a supported image file below 20 MB.');
+            const content = await readFile(target);
+            const metadata = await sharp(content).metadata();
+            if (!['png', 'jpeg', 'webp'].includes(metadata.format ?? ''))
+                throw new Error('Evidence file content is not a supported image.');
+            const provenance = record.evidence.find((item) => item.path === source)?.capture;
+            const scale = provenance?.conditions?.deviceScaleFactor ?? 1;
+            if (provenance &&
+                (metadata.width !== Math.round(provenance.viewport.width * scale) ||
+                    metadata.height !== Math.round(provenance.viewport.height * scale)))
+                throw new Error('Image dimensions do not match the recorded capture viewport.');
+            const expected = record.evidence.find((item) => item.path === source)?.capture?.sha256;
+            const contentHash = sha256(content);
+            if (expected && expected !== contentHash)
+                throw new Error('Evidence hash no longer matches the capture provenance.');
+            const path = `docs/foundry/assets/${deliveryIdentifier(record.id)}-${index}${extension}`;
+            files.set(path, content);
+            attachments.push({ source, status: 'bundled', path, sha256: contentHash });
+        }
+        catch (error) {
+            attachments.push({
+                source,
+                status: 'unavailable',
+                reason: error.code === 'ENOENT'
+                    ? 'Evidence file is not present in the project.'
+                    : String(error.message),
+            });
+        }
+    }
+    return { files, attachments };
+}
 export async function writeRepositoryDeliveryExport(outputRoot, session, record, now = new Date().toISOString()) {
     const root = resolve(outputRoot);
     const manifestPath = resolveManagedDeliveryPath(root, 'docs/foundry/manifest.json');
@@ -154,7 +312,13 @@ export async function writeRepositoryDeliveryExport(outputRoot, session, record,
         ? JSON.parse(await readFile(manifestPath, 'utf8'))
         : undefined;
     const priorHashes = new Map(previous?.files.map((file) => [file.path, file.sha256]) ?? []);
-    const files = deliveryExportFiles(session, record);
+    const files = new Map(deliveryExportFiles(session, record));
+    const bundled = await bundledDeliveryEvidence(session.changeSet.context.projectRoot, record);
+    for (const [path, content] of bundled.files)
+        files.set(path, content);
+    files.set(`docs/foundry/assets/${deliveryIdentifier(record.id)}.json`, safeJson({ screenshots: record.evidence, attachments: bundled.attachments }, session.changeSet.context.projectRoot));
+    const handoffPath = `docs/foundry/handoffs/${deliveryIdentifier(record.id)}.md`;
+    files.set(handoffPath, `${files.get(handoffPath)}\n## Bundled image files\n\n${bundled.attachments.length ? bundled.attachments.map((item) => (item.status === 'bundled' ? `- [${sanitizeDeliveryText(item.source, session.changeSet.context.projectRoot)}](../assets/${item.path.split('/').pop()}) · SHA-256 ${item.sha256}` : `- Unavailable: ${sanitizeDeliveryText(item.source, session.changeSet.context.projectRoot)}. ${sanitizeDeliveryText(item.reason ?? '', session.changeSet.context.projectRoot)}`)).join('\n') : 'No image files are referenced.'}\n`);
     const documentationPages = documentationExports(session);
     const targets = new Map();
     for (const relativePath of files.keys()) {
@@ -167,7 +331,7 @@ export async function writeRepositoryDeliveryExport(outputRoot, session, record,
         const target = targets.get(relativePath);
         if (!(await exists(target)))
             continue;
-        const actualHash = sha256(await readFile(target, 'utf8'));
+        const actualHash = sha256(await readFile(target));
         const managedHash = priorHashes.get(relativePath);
         if ((managedHash && actualHash !== managedHash) ||
             (!managedHash && actualHash !== sha256(content))) {