@reqvire-org/ads 0.3.10 → 0.3.12

package/docs/MCP.md

@@ -15,6 +15,14 @@ The agent keeps its stdio connection; the browser connects to `/mcp` on the same
 runtime using HTTP and the current modern protocol. Both share the configured
 preview watcher and artifacts. Stdout remains exclusively JSON-RPC.
 
+Every registered preview uses `?scenario=<discovered-id>`, including token
+previews colocated under components or patterns. The client selects its section
+from the scenario's discovered `kind`, never from the ID's path prefix. Existing
+`?category=<id>` links remain accepted and normalize to `?scenario=`; an explicit
+`scenario` parameter takes precedence when both are present. `ads_show_tokens`
+keeps its `category` tool argument and returns the same canonical showcase link
+as `ads_show_scenario` for that ID.
+
 For browser-only work, run `ads showcase` inside the project. It starts the same
 runtime without stdio. `--port 4185` selects a port; otherwise the OS chooses an
 available one. For a stable address, add `"--port", "4191"` to the server's `args`
@@ -286,10 +294,23 @@ The same discovery covers the rest of the project ADS:
 | Unit | Scope |
 |------|-------|
 | `foundation` | Shared ADS entry styles and root helpers |
-| `documentation` | ADS guides/licenses and the project's README, GUIDE, MCP, Architecture and ADS Markdown guides |
+| `documentation` | ADS/project guides, shared credits and license notices, and `licenses/` text collections |
 | `assets/brand`, `assets/fonts`, other `assets/*` groups | Original SVG, image, font and other asset files |
 | `configuration` | `ds.config.json`, package/TypeScript/bundler/lint configuration, registered ADS guard modules, compiler/check entrypoints and their static local dependencies |
 
+The `documentation` manifest includes `filePolicy` for paths that can be created
+before they exist. One documentation patch can add `CREDITS.md`,
+`licenses/example.txt` and the required README links together. Conventional root
+`LICENSE`/`LICENCE`, `NOTICE`, `COPYING`, `COPYRIGHT` and `CREDITS` notices accept
+`.md`, `.txt`, or extensionless names, with optional `-`/`_` qualifiers. Shared
+`licenses/` collections may also live under `docs/`, `doc/`, or the configured ADS
+root. Their entries use `.md`/`.txt` or conventional extensionless notice names.
+Content must be UTF-8 without NUL bytes; Git patches preserve exact text, Unicode,
+line endings and final-newline state. Code/configuration, hidden/generated paths
+and peer-owned files retain their boundaries. A component's colocated notice stays
+in that component unit. Shared notices are listed as readable MCP resources, while
+workflow guide discovery omits provenance inventories. No asset unit is needed.
+
 Configuration ownership follows the project's registrations. It does not absorb
 components merely because a guard or compiler reads them. Guard registration,
 implementation, helpers and the associated check script can change together.
@@ -701,7 +722,18 @@ Tool summaries include the first three diagnostics per preview, capped at 1,000
 characters each, with counts and truncation flags; the build resource retains
 the complete bounded report.
 A watcher session separates revisions across restarts, and an artifact digest
-checks that the served output matches the reported successful build.
+checks that the served output matches the reported successful build. Each build
+captures a `sourceRevision` before compilation. Status reads compare that content
+digest with current project inputs; unchanged output cannot remain current after
+source changes. Such previews retain their last successful revision and output,
+but report `current: false`, `stale: true` and `ADS_PREVIEW_STALE_SOURCE` while
+awaiting the current build. Changes during compilation also invalidate success.
+
+Guarded single-owner edits and transactions explicitly invalidate the managed
+compiler after publication. Filesystem events provide fast updates; one-second
+input reconciliation recovers missed atomic replacements without touching source
+or restarting MCP. Keep the project compiler's ADS dependency and the MCP package
+updated together: older reports without source evidence cannot establish freshness.
 
 On each status transition MCP sends `notifications/resources/updated` to build
 resource subscribers. Legacy connections use `resources/subscribe`; modern

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reqvire-org/ads",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "type": "module",
   "description": "A design system your agent can see and shape. Your components. Your look. Your code.",
   "repository": {