@radicool/throughline 0.22.0 → 0.24.0

package/README.md

@@ -73,7 +73,7 @@ Everything above was created during a single working session and synced directly
 
 | | |
 |---|---|
-| **A supported agent** | Required — [Claude Code](https://docs.claude.com/en/docs/claude-code) (native plugin), or **Cursor**, **Codex**, or any **AGENTS.md**-aware agent via `npx @radicool/throughline@0.22.0 init`. |
+| **A supported agent** | Required — [Claude Code](https://docs.claude.com/en/docs/claude-code) (native plugin), or **Cursor**, **Codex**, or any **AGENTS.md**-aware agent via `npx @radicool/throughline@0.24.0 init`. |
 | **Figma** | Required, **desktop app** (the browser version causes connection errors). **Professional plan or higher recommended** — multi-mode variables (Light/Dark, brand themes) need it. |
 | **Figma access token** | Optional — only for the few Figma calls the Desktop Bridge can't make, like reading a published library. Without it, you work through the bridge alone. The setup skill walks you through it; your token stays yours and is never shared in chat. |
 | **GitHub** (or similar) | Optional — only when you're ready to graduate to a real remote repo with PRs and CI. |
@@ -114,9 +114,9 @@ Update anytime with `/plugin marketplace update throughline-marketplace`.
 Run the installer in your project — it stamps in the skills, the reference docs, the scripts, and the Figma MCP config for your tool:
 
 ```
-npx @radicool/throughline@0.22.0 init --target=cursor    # → .cursor/rules + .cursor/mcp.json
-npx @radicool/throughline@0.22.0 init --target=codex      # → prompts/ + AGENTS.md index + codex-mcp.toml
-npx @radicool/throughline@0.22.0 init --target=generic    # → skills/ + AGENTS.md index
+npx @radicool/throughline@0.24.0 init --target=cursor    # → .cursor/rules + .cursor/mcp.json
+npx @radicool/throughline@0.24.0 init --target=codex      # → prompts/ + AGENTS.md index + codex-mcp.toml
+npx @radicool/throughline@0.24.0 init --target=generic    # → skills/ + AGENTS.md index
 ```
 
 It's safe to re-run (it merges `AGENTS.md` and `.cursor/mcp.json` non-destructively) and stages everything the skills read into `.throughline/`. Then open the `figma-environment-setup` skill/rule/prompt for your tool to begin. For Codex, add the printed `codex-mcp.toml` block to your Codex config to enable Figma access.
@@ -212,7 +212,7 @@ Future improvements and planned capabilities. Have a request? **[Open an issue](
 - **Deeper Code Connect coverage** — richer Figma-to-code mappings as more plans support it.
 - **Expanded component starters** — a larger foundational kit out of the box.
 - **Richer status & auditing** — more from `/design-system-status`, including drift detection between Figma and code.
-- **Built-in accessibility checks** — the color half is shipped. Eight semantic text-on-surface pairs are checked against WCAG AA's 4.5:1 when tokens are created in Figma, and derived again from the token source when they sync to code — in every mode, so a system that clears in light and fails in dark fails. A failing pair stops the build rather than warning. Components are checked too: on web frameworks, a Figma build stops when a focus state has no visible ring, and in JSX code the adherence gate is built to fail an icon-only button with no accessible name and a status badge that relies on color alone — proven by unit tests. The one real app it has run on had almost nothing for it to check, so it hasn't caught a bug in the wild yet. Still ahead: focus-ring contrast (WCAG's 3:1 for non-text).
+- **Built-in accessibility checks** — the color half is shipped. Eight semantic text-on-surface pairs are checked against WCAG AA's 4.5:1 when tokens are created in Figma, and derived again from the token source when they sync to code — in every mode, so a system that clears in light and fails in dark fails. A failing pair stops the build rather than warning. Components are checked too: on web frameworks, a Figma build stops when a focus state has no visible ring, and in JSX code the adherence gate is built to fail an icon-only button with no accessible name and a status badge that relies on color alone — proven by unit tests. A Figma build also stops when a focus ring falls below WCAG's 3:1 against a surface the architect names for it, in any mode. The one real app it has run on had almost nothing for it to check, so it hasn't caught a bug in the wild yet.
 - **Token fan-out to more platforms** — the DTCG token source is platform-neutral, and web targets are in daily use. Every target is **validated per build, not assumed**: `tokens:validate-output` checks generated output against its source, native Swift and Kotlin as well as web CSS, because the stock transforms have been measured emitting wrong-but-compiling values. iOS/Swift is a curated adapter whose Style Dictionary configuration ships as tested code, and Android/Kotlin uses the same configuration through the Tier 2 protocol. JavaScript theme output (MUI, a Tailwind v3 config) isn't checked yet.
 - **Native component code generation** — producing a SwiftUI view or a Compose composable the way Storybook components are produced for React. This does not exist yet; it is a separate, larger effort than token fan-out, and the two were previously described as one roadmap item.
 

package/adapters/codex/prompts/component-builder.md

@@ -173,8 +173,16 @@ deterministic naming):
   re-screenshot) **and its "Post-build audit (REQUIRED before handoff)"
   read-back checklist** (container type, auto layout, bound variables,
   deterministic names) before the checkpoint. When you build inline, with no
-  `figma-executor`, that includes item 9's `focus-indicator` check: a miss stops
-  the build, as it would for the executor.
+  `figma-executor`, run `.throughline/references/figma-checks.md` the
+  way the executor does: `'spec'` mode before the first write and `'built'` mode
+  in the self-verify loop, with `EXPECT` built from your own matrix. You are the
+  architect here, so you name `controlLayer` yourself for a wrapped control (an
+  Input with a label or helper text), and `surfaces` yourself: the colour-variable
+  names of the page surfaces the component sits on. A `fail` on the
+  `focus-indicator` check stops the build, as it would for the executor. A `fail`
+  on `focus-contrast` stops it too, naming its detail. A ring below 3:1 is fixed by
+  a token value, so don't change a variable or swap the ring to another one to make
+  it pass; a surface the file doesn't have is a wrong name in `surfaces`.
 
 Checkpoint after each component: show all variants, confirm before the next.
 
@@ -362,8 +370,8 @@ any component built with the toggle + manual-swap fallback is listed in
 component-builder --subject <Name> --entry <tmp>.json`. Build `<tmp>.json` with
 `at` (an ISO timestamp you supply), `changed` (what was built), the attested checks `structural-read-back`,
 `state-baseline` and `figma-name` from what the `figma-executor` returned (or
-what your inline read-back found), `focus-indicator` when that check ran and
-passed (not when it was skipped),
+what your inline read-back found), `focus-indicator` and `focus-contrast`
+each when that check ran and passed (not when it was skipped),
 `review` when a reviewer ran, `screenshot` when one was captured, and
 `advancedBecause`. The entry shape is
 `.throughline/references/proof-bundle.md` — don't restate it here. Write

package/adapters/cursor/.cursor/rules/component-builder.mdc

@@ -177,8 +177,16 @@ deterministic naming):
   re-screenshot) **and its "Post-build audit (REQUIRED before handoff)"
   read-back checklist** (container type, auto layout, bound variables,
   deterministic names) before the checkpoint. When you build inline, with no
-  `figma-executor`, that includes item 9's `focus-indicator` check: a miss stops
-  the build, as it would for the executor.
+  `figma-executor`, run `.throughline/references/figma-checks.md` the
+  way the executor does: `'spec'` mode before the first write and `'built'` mode
+  in the self-verify loop, with `EXPECT` built from your own matrix. You are the
+  architect here, so you name `controlLayer` yourself for a wrapped control (an
+  Input with a label or helper text), and `surfaces` yourself: the colour-variable
+  names of the page surfaces the component sits on. A `fail` on the
+  `focus-indicator` check stops the build, as it would for the executor. A `fail`
+  on `focus-contrast` stops it too, naming its detail. A ring below 3:1 is fixed by
+  a token value, so don't change a variable or swap the ring to another one to make
+  it pass; a surface the file doesn't have is a wrong name in `surfaces`.
 
 Checkpoint after each component: show all variants, confirm before the next.
 
@@ -366,8 +374,8 @@ any component built with the toggle + manual-swap fallback is listed in
 component-builder --subject <Name> --entry <tmp>.json`. Build `<tmp>.json` with
 `at` (an ISO timestamp you supply), `changed` (what was built), the attested checks `structural-read-back`,
 `state-baseline` and `figma-name` from what the `figma-executor` returned (or
-what your inline read-back found), `focus-indicator` when that check ran and
-passed (not when it was skipped),
+what your inline read-back found), `focus-indicator` and `focus-contrast`
+each when that check ran and passed (not when it was skipped),
 `review` when a reviewer ran, `screenshot` when one was captured, and
 `advancedBecause`. The entry shape is
 `.throughline/references/proof-bundle.md` — don't restate it here. Write

package/adapters/generic/skills/component-builder/SKILL.md

@@ -173,8 +173,16 @@ deterministic naming):
   re-screenshot) **and its "Post-build audit (REQUIRED before handoff)"
   read-back checklist** (container type, auto layout, bound variables,
   deterministic names) before the checkpoint. When you build inline, with no
-  `figma-executor`, that includes item 9's `focus-indicator` check: a miss stops
-  the build, as it would for the executor.
+  `figma-executor`, run `.throughline/references/figma-checks.md` the
+  way the executor does: `'spec'` mode before the first write and `'built'` mode
+  in the self-verify loop, with `EXPECT` built from your own matrix. You are the
+  architect here, so you name `controlLayer` yourself for a wrapped control (an
+  Input with a label or helper text), and `surfaces` yourself: the colour-variable
+  names of the page surfaces the component sits on. A `fail` on the
+  `focus-indicator` check stops the build, as it would for the executor. A `fail`
+  on `focus-contrast` stops it too, naming its detail. A ring below 3:1 is fixed by
+  a token value, so don't change a variable or swap the ring to another one to make
+  it pass; a surface the file doesn't have is a wrong name in `surfaces`.
 
 Checkpoint after each component: show all variants, confirm before the next.
 
@@ -362,8 +370,8 @@ any component built with the toggle + manual-swap fallback is listed in
 component-builder --subject <Name> --entry <tmp>.json`. Build `<tmp>.json` with
 `at` (an ISO timestamp you supply), `changed` (what was built), the attested checks `structural-read-back`,
 `state-baseline` and `figma-name` from what the `figma-executor` returned (or
-what your inline read-back found), `focus-indicator` when that check ran and
-passed (not when it was skipped),
+what your inline read-back found), `focus-indicator` and `focus-contrast`
+each when that check ran and passed (not when it was skipped),
 `review` when a reviewer ran, `screenshot` when one was captured, and
 `advancedBecause`. The entry shape is
 `.throughline/references/proof-bundle.md` — don't restate it here. Write

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radicool/throughline",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Build a complete design system end to end — author in Figma, sync tokens to code, generate Storybook. Usable from Claude Code, Cursor, Codex, or any AGENTS.md agent.",
   "type": "module",
   "bin": {