@reqvire-org/ads 0.0.0-stage → 0.3.0

package/docs/CHANGELOG.md

@@ -0,0 +1,106 @@
+# Changelog
+
+## Unreleased
+
+- Rebrand the tool as ADS — Agentic Design System: `@reqvire-org/ads`, the `ads`
+  CLI, `ads_*` MCP tools, `ads://` resources and `ads-*` skills. Keep project
+  `design-system/`, `@ds`, token prefixes, `ds.config.json` and `.ds/` conventions.
+- Add opt-in guarded MCP editing: send only a Git unified diff for one ADS-owned
+  unit, including its colocated scenarios and fixtures. Discover ownership with
+  `ads_units`; read bounded source ranges. Reject peer-unit changes, unrelated
+  public re-exports, malformed or mismatched patches. Cover foundation, guides,
+  original branding/fonts and project configuration/registered guard extensions.
+  Accept Git binary patches and patch-file references to keep bytes out of context.
+- Validate reconstructed files in a temporary project copy with core guards,
+  registered Oxlint and project checks before writing. Reject concurrent edits,
+  cancelled checks and source-writing validators; preserve original Git tracking
+  checks, regenerate branding and refresh previews after acceptance. Accepted
+  configuration changes replace the shared compiler without disconnecting MCP.
+- Mark the mutation tool as a model-only write and enforce App tool visibility in
+  both browser hosts. Update prompts, skills and documentation for the unit workflow.
+
+## 0.3.0
+
+- Align protocol errors for invalid skill/directory/cursor and expired asset
+  requests; notify resource discovery when a published asset catalogue changes.
+  Keep source-discovery caches for build-only changes.
+- Replace the MCP explorer's long build-status line with compact state counts
+  and expandable per-preview details, with failures first.
+
+- Publish one shared preview dependency graph for React and native Preact. The
+  reusable `ui://ads/preview` App loads selected scenario modules, extracted CSS,
+  fonts and worker assets through MCP resources, with content verification and
+  native ESM sharing. Heavy dynamic imports remain lazy.
+- Preserve the showcase App across selections and successful source updates.
+  Mount/unmount adapters own scenario cleanup; failed validation/builds retain
+  a visibly stale view. Successful caches survive unchanged watcher restarts.
+- Keep all project execution and styling inside the App iframe. Both local hosts
+  use a separate-origin sandbox proxy and the standard Apps lifecycle. The
+  showcase no longer uses a direct-artifact shortcut or custom ready message.
+- Add resource integrity, retained revisions, recovery, lazy dependency, worker,
+  framework and sandbox tests. Update architecture, MCP/setup guides, skills
+  and the bundled empty starter. Existing HTML adapters remain supported until
+  a project explicitly configures `mcp.previewManifest`.
+
+Migration: use the starter graph compiler and mount/unmount adapter, keep the
+configured `framework` consistent with JSX, and add
+`mcp.previewManifest: ".ds/preview/manifest.json"`. Production builds and owned
+UI APIs do not change. External hosts require resource forwarding and the App
+CSP capabilities documented in [MCP.md](MCP.md#host-boundary-and-compatibility).
+
+## 0.2.0
+
+- Add `ads init --framework react|preact`, persist and reuse the explicit choice,
+  reject conflicting saved/JSX settings before writes, and generate native hook
+  imports for the selected foundation scenario. Existing configs without the
+  field remain readable; their next init requires the flag once.
+- Add a stdio MCP server with public UI/token inspection, checks, workflow prompts,
+  packaged skill resources, native Skills discovery for newer clients, and
+  experimental Apps. One managed project compiler supplies previews and reports
+  build revisions, diagnostics, failures and recovery.
+- Introduce independently mountable scenarios with colocated fixtures. Components
+  and patterns keep their scenarios beside the owner; larger scenarios live under
+  `design-system/composition/`. Filename-derived IDs and one discovered registry
+  connect the regular showcase and individual MCP previews.
+- Add token scenarios to that same registry/compiler/App pipeline. Token fixtures
+  and sample patterns are project-owned; the tool contains no project token list
+  or visual sample templates. Missing token coverage, invented references and
+  unreachable claimed coverage fail `ads check` and the project build. The empty
+  starter includes a foundation-value scenario without components or patterns.
+- Replace the Mocks section with Composition. Public renderable UI now needs a
+  registered scenario with reachable public render references, including unused
+  exports. Runtime imports/re-exports of colocated scenarios and fixtures fail.
+- Reject direct global networking in ADS implementations and scenarios while
+  preserving injected services, lazy implementation imports and workers.
+- Update architecture, setup documentation, the empty starter and all five skills.
+  Add a checkout-only MCP explorer for real Apps, resources, tools, prompts,
+  skills, notifications and build diagnostics.
+- Ship the showcase as a minimal shell, modern HTTP MCP client and Apps host.
+  `ads mcp` starts the website alongside stdio; `ads showcase` supports browser-only
+  use. Both transports share the compiler. Notifications refresh menus and
+  automatically reload successful active previews; errors mark retained output stale.
+  Four sections share aligned branding/pane collapse, theme switching, direct
+  URLs and retained selections; project browser page files are no longer required.
+- Mount selected compiled Apps directly in the built-in showcase. Build updates
+  retain source discovery caches, and preview compilers run architecture gates
+  once per source change alongside compilation. Both must succeed before a
+  preview becomes current. Token value and elevation samples keep long names and
+  computed values readable.
+
+- Support React and native Preact JSX/factories and DOM/CSS prop guards. Convert
+  the checkout's working example to native Preact 11 with signals for token review;
+  keep the React starter and receiving projects' runtime choices.
+- Share a content-validated preview cache and scheduler across project compiler
+  adapters. Reuse successful outputs across restarts, rebuild changed dependencies,
+  prioritize the selected preview and preserve failure/revision reporting.
+- Split the leaf App bridge and exclude unused browser diagnostic language packs
+  while retaining the official MCP Apps SDK and protocol/schema validation.
+
+Migration: move entries/fixtures beside their owners (or into `composition/`)
+and add static metadata plus independently mountable defaults. Add token entries
+with explicit fixture names and reachable coverage for every foundation token;
+existing projects fail the new coverage gates until those entries are supplied.
+Configure the
+project compiler, use `ads_status.showcaseUrl` or `ads showcase`, and retire the
+project browser/page catalogue. Legacy custom pages/grouped Apps remain supported
+while migrating. Production source and optimization remain project-owned.