@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.
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +13 -0
- package/package.json +1 -1
- package/references/contracts/a2ui-mcp-surface.md +2 -2
- package/skills/a2ui-maintenance/SKILL.md +5 -5
- package/skills/a2ui-maintenance/references/anti-patterns.md +2 -2
- package/skills/a2ui-maintenance/references/chunk-authoring.md +2 -2
- package/skills/a2ui-maintenance/references/eval-diagnostics.md +3 -3
- package/skills/a2ui-maintenance/references/format-extension-decisions.md +1 -1
- package/skills/a2ui-maintenance/references/mcp-pipeline-ops.md +5 -5
- package/skills/a2ui-maintenance/references/mcp-tool-reference.md +3 -3
- package/skills/a2ui-maintenance/references/pipeline-overview.md +18 -18
- package/skills/a2ui-maintenance/references/semantic-fail-lifting.md +2 -2
- package/skills/a2ui-maintenance/references/strategy-engines.md +2 -2
- package/skills/a2ui-maintenance/references/zettel-calibration.md +2 -2
- package/skills/gen-ui-review/references/corpus-html-patterns.md +1 -1
- package/skills/gen-ui-review/references/loop-protocol.md +1 -1
- package/skills/llm-client-maintenance/SKILL.md +4 -4
- package/skills/llm-client-maintenance/references/adapter-contract.md +3 -3
- package/skills/llm-client-maintenance/references/add-a-provider.md +5 -5
- package/skills/llm-client-maintenance/references/bridge-facade.md +2 -2
- package/skills/llm-client-maintenance/references/browser-proxy-boundary.md +2 -2
- package/skills/llm-client-maintenance/references/model-registry.md +2 -2
- package/skills/llm-client-maintenance/references/streaming-sse.md +2 -2
- package/skills/package-release/SKILL.md +6 -6
- package/skills/package-release/references/cut-procedure.md +5 -90
- package/skills/package-release/references/gates-catalog.md +4 -4
- package/skills/package-release/references/independent-package-release.md +2 -2
- package/skills/package-release/references/recovery-paths.md +2 -2
- package/skills/package-release/scripts/bump.mjs +31 -28
- package/skills/package-release/scripts/insert-stub.mjs +1 -1
- package/skills/package-release/scripts/package-paths.mjs +34 -50
- package/skills/package-release/scripts/release-pack.mjs +12 -5
- package/skills/package-release/scripts/tag-lockstep.mjs +1 -1
- package/skills/primitive-authoring/references/common-gotchas.md +1 -1
- package/skills/primitive-authoring/references/llm-bridge.md +12 -12
- package/skills/primitive-authoring/references/module-promotion.md +2 -2
- package/skills/site-deployment/SKILL.md +2 -2
- package/skills/site-deployment/references/deploy-playbooks.md +8 -8
- 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
|