From d0f05233e634aff3e32f297975efa2acca46d0a4 Mon Sep 17 00:00:00 2001 From: Mike Long Date: Fri, 16 Oct 2026 22:15:38 -0700 Subject: [PATCH 1/2] Restore requested JudgmentKit masthead copy --- scripts/verify-public-release.mjs | 7 ++++--- site/build-site.mjs | 7 ++++--- tests/site-local-server.test.mjs | 2 +- tests/site.test.mjs | 11 ++++++----- 4 files changed, 15 insertions(+), 12 deletions(-) diff --git a/scripts/verify-public-release.mjs b/scripts/verify-public-release.mjs index 93b9acd..0ee86d6 100644 --- a/scripts/verify-public-release.mjs +++ b/scripts/verify-public-release.mjs @@ -1168,9 +1168,10 @@ async function verifyPublicRoutes(baseUrl, options = {}) { assertIncludes( home.text, [ - "Judgment before components.", - "Guide interface design with your AI agent.", - "JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions.", + "The judgment layer for AI-generated UI", + "Stop AI from building the wrong interface.", + "A design system tells an agent how interface elements should look and behave. JudgmentKit tells it which interface the user’s work requires, what should stay hidden, and what must be repaired.", + "

Use JudgmentKit’s design system—or bring your own.

", "Keep the interface in the language of the work.", 'class="homepage-scene"', 'class="family-problem-row"', diff --git a/site/build-site.mjs b/site/build-site.mjs index 4f9f84d..df11f34 100755 --- a/site/build-site.mjs +++ b/site/build-site.mjs @@ -5906,9 +5906,10 @@ export function renderHomepage({ homepageFilmEnabled = HOMEPAGE_FILM_ENABLED } =
-

Judgment before components.

-

Guide interface design with your AI agent.

-

JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions.

+

The judgment layer for AI-generated UI

+

Stop AI from building the wrong interface.

+

A design system tells an agent how interface elements should look and behave. JudgmentKit tells it which interface the user’s work requires, what should stay hidden, and what must be repaired.

+

Use JudgmentKit’s design system—or bring your own.

See a screen repaired Explore examples diff --git a/tests/site-local-server.test.mjs b/tests/site-local-server.test.mjs index 0865ba3..806dce5 100644 --- a/tests/site-local-server.test.mjs +++ b/tests/site-local-server.test.mjs @@ -714,7 +714,7 @@ try { ); assert.match(main, /^\s*
]*>/); assert.match(main, /aria-labelledby="homepage-title"/); - assert.match(main, /

Guide interface design with your AI agent\.<\/h1>/); + assert.match(main, /

Stop AI from building the wrong interface\.<\/h1>/); assert.equal((main.match(/([\s\S]*?)<\/ol>/)?.[1] ?? ""; const workflow = main.match(/
    ([\s\S]*?)<\/ol>/)?.[1] ?? ""; diff --git a/tests/site.test.mjs b/tests/site.test.mjs index a43e998..ed457b9 100644 --- a/tests/site.test.mjs +++ b/tests/site.test.mjs @@ -733,13 +733,14 @@ assert.ok(homepage.includes("[data-section-rail-menu]")); assert.ok(homepage.includes('class="site-shell homepage-section-shell"')); assert.ok(homepage.includes("[data-surfaces-primary-menu-button]")); assert.equal(homepage.includes("[data-surfaces-system-menu-button]"), false); -assert.ok(homepageHeroCopy.includes("Judgment before components.")); -assert.ok(homepageHeroCopy.includes("Guide interface design with your AI agent.")); -assert.ok(homepageHeroCopy.includes("JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions.")); -assert.ok(homepage.includes('name="description" content="JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions."'), "metadata must carry the same bounded promise"); +assert.ok(homepageHeroCopy.includes("The judgment layer for AI-generated UI")); +assert.ok(homepageHeroCopy.includes("Stop AI from building the wrong interface.")); +assert.ok(homepageHeroCopy.includes("A design system tells an agent how interface elements should look and behave. JudgmentKit tells it which interface the user’s work requires, what should stay hidden, and what must be repaired.")); +assert.ok(homepageHeroCopy.includes("

    Use JudgmentKit’s design system—or bring your own.

    ")); +assert.ok(homepage.includes('name="description" content="JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions."'), "preserve the existing metadata during the requested masthead-only restoration"); assert.ok(homepage.includes('

    Guide interface design with your AI agent.

    ')); assert.doesNotMatch(homepageMain, /choose the right interface|before the work ships|one short loop|Where AI goes wrong/); -assert.equal((homepageHeroCopy.match(/ Date: Fri, 16 Oct 2026 22:27:14 -0700 Subject: [PATCH 2/2] Align masthead copy provenance with requested restoration --- specs/site-homepage-copy.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/specs/site-homepage-copy.md b/specs/site-homepage-copy.md index 201b55e..2239eda 100644 --- a/specs/site-homepage-copy.md +++ b/specs/site-homepage-copy.md @@ -2,11 +2,16 @@ The homepage describes JudgmentKit’s interface guidance and contract checks. The [website family copy contract](website-family-copy.md) governs public copy and metadata alongside [the layout contract](website-family-layout.md). The shared composition reference is https://www.surfaces.systems/, reviewed on October 16, 2026 at 1280 × 720 and 390 × 844. Main content must stay at or below 220 words; there is no minimum. +Mike requested the masthead wording below be restored from `site/build-site.mjs` at `231a50acc3aa39a1d72df009f24cbca8bbc2cd93`, lines 5902–5905. The restored masthead is an intentional masthead-only exception to the newer copy guidance. The current lens artwork, family layout, page and social titles, metadata, footer and remaining copy are preserved. + | Homepage text | First-party source | Claim scope | | --- | --- | --- | -| Judgment before components. | README.md:16–24 | Activity and interaction choices precede component choices. | -| Guide interface design with your AI agent. | docs/product-claims-and-evidence.md:17–19; VISION.md:31 | Guidance and checks, with the caller’s agent retaining execution. Also used in the footer. | -| JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions. | docs/product-claims-and-evidence.md:17–19; src/index.mjs:23229–23257 | Describes returned guidance and review results. Also used in homepage metadata. | +| The judgment layer for AI-generated UI | Prior masthead at `231a50acc3aa39a1d72df009f24cbca8bbc2cd93:site/build-site.mjs:5902`; owner-requested restoration | Restored positioning copy. | +| Stop AI from building the wrong interface. | Prior masthead at `231a50acc3aa39a1d72df009f24cbca8bbc2cd93:site/build-site.mjs:5903`; owner-requested restoration | Restored headline; no new outcome measurements are asserted. | +| A design system tells an agent how interface elements should look and behave. JudgmentKit tells it which interface the user’s work requires, what should stay hidden, and what must be repaired. | Prior masthead at `231a50acc3aa39a1d72df009f24cbca8bbc2cd93:site/build-site.mjs:5904`; owner-requested restoration | Restored lead describing the intended interaction and disclosure role. | +| Use JudgmentKit’s design system—or bring your own. | Prior masthead at `231a50acc3aa39a1d72df009f24cbca8bbc2cd93:site/build-site.mjs:5905`; owner-requested restoration | Restored emphasized support line, rendered as `

    …

    `. | +| Guide interface design with your AI agent. | docs/product-claims-and-evidence.md:17–19; VISION.md:31 | Preserved footer copy; guidance and checks, with the caller’s agent retaining execution. | +| JudgmentKit gives your AI agent interaction guidance, implementation checks, and repair instructions. | docs/product-claims-and-evidence.md:17–19; src/index.mjs:23229–23257 | Preserved homepage metadata describing returned guidance and review results. | | See a screen repaired; Explore examples | /value/; /examples/ | Selected curated repair artifacts and illustrative examples, not live generation. | | Risks to check; Keep the interface in the language of the work. | docs/agent-usage-contract.md:42; README.md:11–13 | A review instruction, not a claim that every table, form or button is wrong. | | Internal record labels; The user has to translate database terms into their own work. | docs/agent-usage-contract.md:42; tests/ui-generation-handoff.test.mjs:4525–4541 | Names the mismatch when source vocabulary obscures the intended activity. | @@ -26,4 +31,4 @@ The Value page labels selected curated refund artifacts and declared contract ch Docs uses “First use” without a measured time estimate. Its Quickstart states that hosted requests leave the machine and points to the existing [authorization and privacy guidance](../packages/agent-skill/judgmentkit-hosted-mcp/SKILL.md#authorization-and-privacy) for sanitized, local or self-hosted inputs. The remaining instructions distinguish contract acceptance from observed user task completion. Artifact Inspector remains proposed and `review_required` where trusted interactive attestation is unavailable. -The hero retains one eyebrow, one heading, one supporting sentence and exactly two actions. The lower page retains one three-item problem row and one five-step workflow. Historical reports, captured examples, reference specimens, artwork and CSS remain unchanged. The adversarial audit and corrections are recorded in the task’s `copy-adversarial/judgmentkit-audit.md`. +The hero retains one eyebrow, one heading, one lead, one emphasized support line and exactly two actions. The lower page retains one three-item problem row and one five-step workflow. Historical reports, captured examples, reference specimens, artwork and CSS remain unchanged. The adversarial audit and corrections are recorded in the task’s `copy-adversarial/judgmentkit-audit.md`.