foundry-design-protocol 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/engineering-verification.d.ts

@@ -0,0 +1,11 @@
+import type { ApplyRun, ChangeContext, DeliveryRecord, DesignChange, VerificationResult } from './index.js';
+export declare function matchingDeliveryCaptures(record: DeliveryRecord): {
+    before: DeliveryRecord["evidence"][number];
+    after: DeliveryRecord["evidence"][number];
+}[];
+export declare function engineeringVerification(record: DeliveryRecord, run: ApplyRun | undefined, change: DesignChange, context: ChangeContext): {
+    status: 'passed' | 'failed' | 'untested';
+    result?: VerificationResult;
+    reason?: string;
+};
+//# sourceMappingURL=engineering-verification.d.ts.map

package/dist/engineering-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineering-verification.d.ts","sourceRoot":"","sources":["../src/engineering-verification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc;YAEnD,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;WACnC,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IAmC5C;AAwBD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,GACrB;IAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoE5F"}

package/dist/engineering-verification.js

@@ -0,0 +1,111 @@
+import { verificationValueMatches } from './verification-value.js';
+export function matchingDeliveryCaptures(record) {
+    const pairs = [];
+    for (const after of record.evidence) {
+        const proof = after.capture;
+        if (!proof ||
+            !proof.conditions ||
+            proof.phase !== 'rebuilt' ||
+            proof.applyRunId !== record.applyRunId ||
+            !record.appliedRevision ||
+            proof.sourceRevision !== record.appliedRevision)
+            continue;
+        const before = record.evidence.find((item) => {
+            const baseline = item.capture;
+            return (baseline?.phase === 'before' &&
+                baseline.conditions &&
+                baseline.conditions.motion === proof.conditions.motion &&
+                baseline.conditions.browser === proof.conditions.browser &&
+                baseline.conditions.platform === proof.conditions.platform &&
+                baseline.conditions.deviceScaleFactor === proof.conditions.deviceScaleFactor &&
+                baseline.targetId === proof.targetId &&
+                baseline.sourceRevision === record.baselineRevision &&
+                Boolean(record.baselineRevision) &&
+                baseline.viewport.width === proof.viewport.width &&
+                baseline.viewport.height === proof.viewport.height &&
+                baseline.context.breakpoint === proof.context.breakpoint &&
+                baseline.context.theme === proof.context.theme &&
+                baseline.context.state === proof.context.state);
+        });
+        if (before)
+            pairs.push({ before, after });
+    }
+    return pairs;
+}
+function exactValue(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (!left || !right || typeof left !== 'object' || typeof right !== 'object')
+        return false;
+    if (Array.isArray(left) || Array.isArray(right))
+        return (Array.isArray(left) &&
+            Array.isArray(right) &&
+            left.length === right.length &&
+            left.every((value, index) => exactValue(value, right[index])));
+    const a = Object.keys(left).sort();
+    const b = Object.keys(right).sort();
+    return (a.length === b.length &&
+        a.every((key, index) => key === b[index] &&
+            exactValue(left[key], right[key])));
+}
+export function engineeringVerification(record, run, change, context) {
+    if (!run ||
+        run.id !== record.applyRunId ||
+        !run.changeIds.includes(change.id) ||
+        !record.changeIds.includes(change.id))
+        return { status: 'untested', reason: 'No matching frozen Apply contract.' };
+    // Completion deliberately releases the active lease. Its acknowledged attempt
+    // remains frozen on the run and is the authority for historical evidence.
+    const completedAttempt = ['passed', 'needs_attention'].includes(run.state) &&
+        run.completedAt &&
+        Number.isFinite(Date.parse(run.completedAt))
+        ? run.applyResultClaimAttemptId
+        : undefined;
+    const claimAttempt = run.claimAttemptId ?? completedAttempt;
+    if (!claimAttempt ||
+        run.applyResultClaimAttemptId !== claimAttempt ||
+        !run.applyResultAcknowledgedAt ||
+        !['verifying', 'passed', 'needs_attention'].includes(run.state))
+        return {
+            status: 'untested',
+            reason: 'The current Apply attempt has no acknowledged verification lifecycle.',
+        };
+    const acknowledgedAt = Date.parse(run.applyResultAcknowledgedAt);
+    const results = record.verificationResults.filter((item) => item.changeId === change.id &&
+        item.property === change.property &&
+        item.applyRunId === run.id &&
+        item.claimAttemptId === claimAttempt &&
+        item.context &&
+        item.context.breakpoint === context.breakpoint &&
+        item.context.theme === context.theme &&
+        item.context.state === context.state &&
+        exactValue(item.requested, change.after) &&
+        Number.isFinite(Date.parse(item.verifiedAt)) &&
+        Date.parse(item.verifiedAt) >= acknowledgedAt);
+    const result = results.sort((a, b) => Date.parse(b.verifiedAt) - Date.parse(a.verifiedAt))[0];
+    if (!result)
+        return {
+            status: 'untested',
+            reason: 'No matching rendered evidence for this request and attempt.',
+        };
+    if (!result.passed)
+        return { status: 'failed', result };
+    if (!verificationValueMatches(change.property, result.rendered, change.after, change.unit))
+        return { status: 'failed', result, reason: 'Recorded pass contradicts the reviewed value.' };
+    if (!run.validationResults.length || run.validationResults.some((item) => !item.passed))
+        return { status: 'untested', result, reason: 'Source validation is missing or failed.' };
+    if (record.appliedRevision && run.appliedRevision !== record.appliedRevision)
+        return { status: 'untested', result, reason: 'Delivery and Apply source revisions differ.' };
+    if (change.target?.platform === 'web' &&
+        (!result.geometry ||
+            result.geometry.width <= 0 ||
+            result.geometry.height <= 0 ||
+            !result.evidence.length))
+        return {
+            status: 'untested',
+            result,
+            reason: 'Visible browser geometry and evidence are missing.',
+        };
+    return { status: 'passed', result };
+}
+//# sourceMappingURL=engineering-verification.js.map

package/dist/engineering-verification.js.map

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