@adia-ai/adia-ui-forge 0.8.37 → 0.8.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +13 -0
  3. package/package.json +1 -1
  4. package/references/contracts/a2ui-mcp-surface.md +2 -2
  5. package/skills/a2ui-maintenance/SKILL.md +5 -5
  6. package/skills/a2ui-maintenance/references/anti-patterns.md +2 -2
  7. package/skills/a2ui-maintenance/references/chunk-authoring.md +2 -2
  8. package/skills/a2ui-maintenance/references/eval-diagnostics.md +3 -3
  9. package/skills/a2ui-maintenance/references/format-extension-decisions.md +1 -1
  10. package/skills/a2ui-maintenance/references/mcp-pipeline-ops.md +5 -5
  11. package/skills/a2ui-maintenance/references/mcp-tool-reference.md +3 -3
  12. package/skills/a2ui-maintenance/references/pipeline-overview.md +18 -18
  13. package/skills/a2ui-maintenance/references/semantic-fail-lifting.md +2 -2
  14. package/skills/a2ui-maintenance/references/strategy-engines.md +2 -2
  15. package/skills/a2ui-maintenance/references/zettel-calibration.md +2 -2
  16. package/skills/gen-ui-review/references/corpus-html-patterns.md +1 -1
  17. package/skills/gen-ui-review/references/loop-protocol.md +1 -1
  18. package/skills/llm-client-maintenance/SKILL.md +4 -4
  19. package/skills/llm-client-maintenance/references/adapter-contract.md +3 -3
  20. package/skills/llm-client-maintenance/references/add-a-provider.md +5 -5
  21. package/skills/llm-client-maintenance/references/bridge-facade.md +2 -2
  22. package/skills/llm-client-maintenance/references/browser-proxy-boundary.md +2 -2
  23. package/skills/llm-client-maintenance/references/model-registry.md +2 -2
  24. package/skills/llm-client-maintenance/references/streaming-sse.md +2 -2
  25. package/skills/package-release/SKILL.md +6 -6
  26. package/skills/package-release/references/cut-procedure.md +5 -90
  27. package/skills/package-release/references/gates-catalog.md +4 -4
  28. package/skills/package-release/references/independent-package-release.md +2 -2
  29. package/skills/package-release/references/recovery-paths.md +2 -2
  30. package/skills/package-release/scripts/bump.mjs +31 -28
  31. package/skills/package-release/scripts/insert-stub.mjs +1 -1
  32. package/skills/package-release/scripts/package-paths.mjs +34 -50
  33. package/skills/package-release/scripts/release-pack.mjs +12 -5
  34. package/skills/package-release/scripts/tag-lockstep.mjs +1 -1
  35. package/skills/primitive-authoring/references/common-gotchas.md +1 -1
  36. package/skills/primitive-authoring/references/llm-bridge.md +12 -12
  37. package/skills/primitive-authoring/references/module-promotion.md +2 -2
  38. package/skills/site-deployment/SKILL.md +2 -2
  39. package/skills/site-deployment/references/deploy-playbooks.md +8 -8
  40. package/skills/site-docs-authoring/intent.md +1 -1
@@ -119,7 +119,7 @@ The "stripped" consumer. Same structural change minus persistence.
119
119
 
120
120
  ### Phase 4 — Migrate the chunk corpus
121
121
 
122
- The harvested training-corpus chunk (`packages/a2ui/corpus/chunks/<name>.json`) embeds the consumer's HTML as an escaped string. Update it so the LLM sees the new authoring shape.
122
+ The harvested training-corpus chunk (`packages/gen-ui/a2ui/corpus/chunks/<name>.json`) embeds the consumer's HTML as an escaped string. Update it so the LLM sees the new authoring shape.
123
123
 
124
124
  1. **Preferred** — re-run the harvester:
125
125
 
@@ -144,7 +144,7 @@ The harvested training-corpus chunk (`packages/a2ui/corpus/chunks/<name>.json`)
144
144
  3. **Defensive grep across all chunks** for the legacy markers:
145
145
 
146
146
  ```bash
147
- grep -l 'id="<old-id>"' packages/a2ui/corpus/chunks/*.json
147
+ grep -l 'id="<old-id>"' packages/gen-ui/a2ui/corpus/chunks/*.json
148
148
  ```
149
149
 
150
150
  4. **Gotcha — hand-edit + later re-harvest** — if you used the fallback (step 2) AND a peer later adds your consumer's directory to harvester SOURCES, the next `harvest:chunks` run will overwrite your hand-edit with the live consumer HTML. Usually that's _good_ (the re-harvest captures the live state, including any post-edit consumer updates), but diff before assuming. Concrete example: theme-panel's `playground-app-shell.json` was hand-edited, then re-harvested after `playgrounds/` was added to SOURCES — the re-harvest captured the `<aside-ui>` → `<admin-sidebar>` bespoke conversion that the hand-edit missed.
@@ -88,9 +88,9 @@ delete-adjudication classes.
88
88
  1. Build from clean, fully-merged `main`. In a fresh worktree,
89
89
  `npm run build -w @adia-ai/llm` runs **before** `build:site` — llm compiles
90
90
  at publish time and its outputs are gitignored, so without it
91
- `/packages/llm/index.js` 404s and component registration breaks site-wide
91
+ `/packages/llm/core/index.js` 404s and component registration breaks site-wide
92
92
  (found live 2026-06-09).
93
- 2. Dry-run `rsync -azni --delete --exclude='packages/a2ui/corpus/feedback/'`
93
+ 2. Dry-run `rsync -azni --delete --exclude='packages/gen-ui/a2ui/corpus/feedback/'`
94
94
  and bucket **every** `*deleting` line into a known-safe class; any
95
95
  unexplained served-content delete aborts the deploy. The exclude protects
96
96
  prod-only runtime-written files (feedback logs wiped 2026-06-10).
@@ -129,8 +129,8 @@ itself is unavailable.
129
129
  ```
130
130
  The `llm` package **compiles its JS at publish time** and its outputs are
131
131
  **gitignored** — so a fresh worktree (or any tree that hasn't published llm
132
- locally) has no `packages/llm/index.js`, `build:site` copies nothing, and
133
- **`/packages/llm/index.js` 404s on the deployed site → component registration
132
+ locally) has no `packages/llm/core/index.js`, `build:site` copies nothing, and
133
+ **`/packages/llm/core/index.js` 404s on the deployed site → component registration
134
134
  breaks on every `/site/components/*` page** (the docs components reference it). Found
135
135
  **live 2026-06-09**; the **0-delete dry-run proved it had never been deployed** (the
136
136
  file was absent on the server, so there was nothing to delete — not a regression, a
@@ -145,22 +145,22 @@ itself is unavailable.
145
145
  deploy gaps). After any package add/rename, check `site.mjs` before deploying.
146
146
  2. **Dry-run first, and adjudicate every delete — BEFORE the real rsync, never after:**
147
147
  ```sh
148
- rsync -azni --delete --exclude='packages/a2ui/corpus/feedback/' \
148
+ rsync -azni --delete --exclude='packages/gen-ui/a2ui/corpus/feedback/' \
149
149
  dist/ <host>.exe.xyz:/srv/<app>/dist/ # -n simulates · -i itemizes
150
150
  ```
151
151
  - **Exclude server-side runtime-written paths.** Some files exist ONLY on prod —
152
152
  written by the running service at runtime, never present in a local build — so
153
153
  `--delete` wipes them on every deploy. Known class on ui-kit:
154
- `packages/a2ui/corpus/feedback/*.jsonl` (the gen-UI canvas training-feedback log).
154
+ `packages/gen-ui/a2ui/corpus/feedback/*.jsonl` (the gen-UI canvas training-feedback log).
155
155
  Found **live 2026-06-10** (the deploy deleted the day's feedback log; restored from
156
156
  the pre-deploy snapshot). Carry the same `--exclude` list on BOTH the dry-run and
157
157
  the real rsync; when a new runtime-written path appears, add it here.
158
158
  - `*deleting` lines = files removed from prod. Bucket **every one** into a known-safe
159
159
  class; **abort if any served-content delete is unexplained.** Safe classes seen on
160
160
  ui-kit: gallery review artifacts (`apps/genui/.../review/cycle-*/`), stale
161
- `packages/a2ui/retrieval/` + eval reports, **content-hash-rotated** CodeMirror
161
+ `packages/gen-ui/a2ui/retrieval/` + eval reports, **content-hash-rotated** CodeMirror
162
162
  chunks (`code/{chunk,dist}-<hash>.js` — old hash deleted, new hash sent = rotation,
163
- not loss), restructured `packages/llm/*.js` dist copies, `node_modules/`
163
+ not loss), restructured `packages/llm/core/*.js` dist copies, `node_modules/`
164
164
  symlink-farm dirs, and refactor-orphaned app files. None are served HTML.
165
165
  - **Don't panic at the send count.** A fresh local build never mtime-aligns with the
166
166
  remote, so `rsync -a` flags ~every file as a send (`<f..t` = mtime-only touch). Only
@@ -176,7 +176,7 @@ itself is unavailable.
176
176
  mutating in place. Restore with `rm -rf dist && mv dist.bak-<date> dist`.
177
177
  4. **Deploy** (the dry-run, minus `-n` — SAME excludes):
178
178
  ```sh
179
- rsync -az --delete --exclude='packages/a2ui/corpus/feedback/' \
179
+ rsync -az --delete --exclude='packages/gen-ui/a2ui/corpus/feedback/' \
180
180
  dist/ <host>.exe.xyz:/srv/<app>/dist/
181
181
  ```
182
182
  5. **Verify the FILE, not the route.** A SPA returns `200` + the app shell for *any*
@@ -205,7 +205,7 @@ itself is unavailable.
205
205
  >
206
206
  > **The one exception — `@adia-ai/llm` (2026-06-09):** llm is NOT a source-tree
207
207
  > component; it **builds its JS at publish** (gitignored outputs), so `build:site` copies
208
- > nothing for it in a fresh worktree and `/packages/llm/index.js` 404s → component
208
+ > nothing for it in a fresh worktree and `/packages/llm/core/index.js` 404s → component
209
209
  > registration breaks site-wide. Run `npm run build -w @adia-ai/llm` **before** `build:site`
210
210
  > (step 1 above). This is exactly why step 5 render-checks a **`/site/components/*`** page,
211
211
  > not just a fixture file — the 404 is invisible to file-presence and to the SPA shell.
@@ -49,7 +49,7 @@ before they start typing.
49
49
 
50
50
  ## fences
51
51
  - NOT for `packages/web-components/components/*/*.examples.html` component demo pages (primitive-authoring)
52
- - NOT for `site/pages/examples/**`, `site/pages/gen-ui/**`, `packages/a2ui/corpus/exemplars/**` — pure primitive-composition training-harvest surfaces with their own no-style-block rule (`composition-and-examples.md`, a2ui-maintenance)
52
+ - NOT for `site/pages/examples/**`, `site/pages/gen-ui/**`, `packages/gen-ui/a2ui/corpus/exemplars/**` — pure primitive-composition training-harvest surfaces with their own no-style-block rule (`composition-and-examples.md`, a2ui-maintenance)
53
53
  - NOT for the A2UI generation pipeline itself, chunk corpus, or MCP tools (a2ui-maintenance)
54
54
 
55
55
  ## assertions