foundry-design-web-adapter 0.2.0-beta.1 → 0.2.0-beta.10

package/README.md

@@ -4,35 +4,82 @@ Foundry is a local-first precision design workbench for Codex, Cursor, and Claud
 
 ## Beta installation
 
-Foundry `0.2.0-beta.1` is the first shareable beta. From the project you want to inspect, run:
+Foundry is distributed through npm, so testers do not need GitHub access.
+
+> **Current public beta:** `0.2.0-beta.10`. Both npm `latest` and `beta` point to the same tested release. Use the unqualified command below for normal installation.
+
+Full documentation is available at [withfoundry.ai](https://withfoundry.ai).
+
+### Recommended: one command
+
+Open a terminal in the project, or ask Codex, Cursor, or Claude Code to run:
+
+```bash
+npx foundry-design
+```
+
+That command detects the project and active coding agent, installs or safely updates Foundry, repairs the shared agent connection, validates its integration, starts the project when needed, and opens the visual session. Before changing local configuration, Foundry prints the exact CLI and MCP bridge versions it will use. On the first installation only, restart the coding agent once so it can load the shared MCP connection. A reviewed batch can be queued before the restart and will be claimed when the agent reconnects.
+
+After the restart, reopen the same project folder and ask:
+
+```text
+Start Foundry for this project and keep listening for Apply with agent requests.
+```
+
+That is the normal workflow. Foundry resumes the most recent session for the current source revision and keeps all review and apply state local.
+
+### Manual installation
+
+From the first project you want to inspect, run:
 
 ```bash
-npx foundry-design@beta setup
+npx foundry-design setup --global
+```
+
+For later projects, keep the shared agent connection and install only the development adapter:
+
+```bash
+npx foundry-design setup --agent none
+```
+
+Then restart the coding agent, reopen the same project folder, and ask:
+
+```text
+Start Foundry for this project and keep listening for Apply with agent requests.
 ```
 
-Setup detects the platform, framework, package manager, development command, and installed coding agents. It previews every file it will manage, adds development-only instrumentation for supported web frameworks, configures the selected MCP clients, and records a reversible install manifest.
+You do not need to run a second terminal command when the agent starts Foundry for you. Apply requests remain queued safely when the agent is offline. Run `npx foundry-design doctor --repair` if the connection or generated integration needs repair.
 
-Then start a session with:
+Update an existing installation with:
 
 ```bash
-npx foundry-design@beta start
+npx foundry-design update
 ```
 
-Foundry reuses an available project server or starts the detected development command, launches the loopback runtime, and opens an authenticated visual preview. Remove only Foundry-managed integration with:
+The updater refreshes checksum-matched Foundry files, agent connections, and skill bundles. It preserves and reports files changed since setup, validates the project, and rolls back the update if Foundry introduces a TypeScript or lint failure. Restart the coding agent after updating.
+
+Remove only Foundry-managed integration with:
 
 ```bash
-npx foundry-design@beta uninstall
+npx foundry-design uninstall
 ```
 
 Supported automatic web integration currently includes Next.js App Router, Vite, and plain HTML. Generic web, SwiftUI, and React Native projects receive explicit setup guidance when a safe automatic edit is not available.
 
-Codex, Cursor, and Claude Code users can alternatively install the bundled plugin from this repository. The plugin contains the Foundry skill and MCP server definition, so project setup uses `--agent none` and does not create duplicate MCP configuration.
+The npm setup above is the public beta installation path and includes the same portable skill and MCP connection used by the agent plugin bundle.
+
+If an npm mirror or existing `npx` cache reports an old tag, bypass it with a temporary cache and the exact current release:
+
+```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.10 foundry-design
+```
 
-The beta supports Node.js 20 or newer. Read [Privacy](PRIVACY.md), [Security](SECURITY.md), and the [beta changelog](CHANGELOG.md) before using it with sensitive work.
+The beta supports Node.js 20 or newer. Read the [local-first safety model](https://withfoundry.ai/#safety) before using it with sensitive work.
 
 ## Agent plugin
 
-The portable plugin lives at `plugins/foundry-design-control`. The repository also includes marketplace manifests for Codex, Cursor, and Claude-compatible plugin import. Once installed, ask your agent:
+The portable plugin lives at `plugins/foundry-design-control`. The repository also includes marketplace manifests for Codex, Cursor, and Claude-compatible plugin import. Until public marketplace review is complete, `setup --global` installs the same reusable skill and MCP connection from npm without requiring source-repository access. Once installed, ask your agent:
 
 ```text
 Start Foundry for this project.
@@ -42,7 +89,8 @@ Foundry remains local-first. Installing the plugin does not create an account, e
 
 ## Current capabilities
 
-- Measured browser selection with overlap cycling, parent/child traversal, hover previews, and an isolated Shadow DOM inspector
+- A dedicated local design workspace with a live product canvas, equal Layers and Inspector docks, and a direct-overlay fallback when a product blocks framing
+- Measured browser selection with overlap cycling, parent/child traversal, hover previews, and isolated Shadow DOM canvas instrumentation
 - A searchable, collapsible, virtualized live layer hierarchy with mapped-source context, Shadow DOM traversal, drag reordering, and selection persistence across HMR
 - Multi-selection, measured spacing annotations, sibling-aware resize snapping, keyboard nudging, alignment, distribution, and preview undo/redo
 - A revisioned local design graph for CSS tokens, components, Storybook variants, breakpoints, themes, states, and motion presets
@@ -54,9 +102,11 @@ Foundry remains local-first. Installing the plugin does not create an account, e
 - Design Health scans for contrast, overflow and clipping, touch targets, accessible names, reduced-motion coverage, and project spacing consistency, with evidence, intentional-issue ignores, and safe corrections routed into review
 - An in-app state workbench with real viewport frames, theme switching, forced interaction states, motion controls, and contextual verification
 - Persistent, coalescing change ledger with JSON and consolidated prompt export
-- Compact in-preview review with editable approved batches and unresolved-target blocking
+- Center-workspace review with editable approved batches, grouped targets, and unresolved-target blocking
 - Persistent Apply with agent runs across Codex, Cursor, and Claude Code through MCP
+- Leased agent handoffs that safely return abandoned or interrupted claims to the queue
 - Live source, rebuild, validation, retry, and rendered-verification progress
+- Rendered verification that resumes after refresh and does not depend on Review remaining open
 - Local MCP bridge for agent access
 - Debug adapters for web, SwiftUI, and React Native on iOS Simulator
 - Verification records that compare requested and rendered values
@@ -90,7 +140,7 @@ The runtime binds to `127.0.0.1:4387`. Inspector preview changes remain temporar
 - `packages/react-native-adapter`: React Native debug bridge
 - `packages/mcp-server`: agent tools backed by the runtime
 - `packages/swiftui-adapter`: Swift package for inspectable SwiftUI views
-- `apps/inspector`: session dashboard and review surface
+- `apps/inspector`: authenticated local design workspace, canvas shell, and review surface
 - `examples/web-fixture`: end-to-end browser fixture
 
 ## Safety model

package/THIRD_PARTY_NOTICES.md

@@ -1,26 +1,26 @@
 # Third-party notices
 
-## Lucide Icons
+## Keyline Icons
 
-Foundry Design Control uses icons from Lucide, available at https://lucide.dev/.
+Foundry Design Control uses icons from [Keyline Icons](https://icon-sets.iconify.design/keyline-icons/), distributed through Iconify's `@iconify-icons/keyline-icons` package.
 
-ISC License
+Keyline Icons is licensed under the MIT License.
 
-Copyright (c) 2026 Lucide Icons and Contributors
+Copyright (c) 2026 Keyline Icons
 
-Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
----
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-The following Lucide icons are derived from the Feather project:
+## beUI File Tree
 
-airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+The Foundry Layers interaction adapts motion and keyboard-navigation patterns from the [beUI File Tree](https://beui.dev/components/motion/file-tree).
 
-The MIT License (MIT) (for the icons listed above)
+beUI is licensed under the MIT License.
 
-Copyright (c) 2013-present Cole Bemis
+Copyright (c) 2026 Saurabh Chauhan
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: