@adia-ai/a2ui-compose 0.6.1 → 0.6.4

package/CHANGELOG.md

@@ -11,6 +11,32 @@ generator graph.
 
 _No pending changes._
 
+## [0.6.4] - 2026-05-18
+
+### v0.6.4 — Lockstep ride-along
+
+TS Phase 5: a2ui.schema.json schema-driven codegen (§359). No source changes in this package.
+
+
+
+## [0.6.3] - 2026-05-18
+
+### v0.6.3 — Phase 5 branded IDs
+
+`strategies/zettel/types.ts` adds `FragmentId`, `ChunkId`, `CompositionId` branded types.
+**No BREAKING changes.**
+
+
+
+## [0.6.2] - 2026-05-18
+
+### v0.6.2 — TS-MIG-001 closed
+
+`skipLibCheck: true` override removed from `tsconfig.json`. Phase 4 retrieval +
+mcp `.ts` sources provide real declarations. **No BREAKING changes.**
+
+
+
 ## [0.6.1] - 2026-05-18
 
 ### v0.6.1 §355 — TypeScript-first Phase 3: `@adia-ai/a2ui-compose` sources → `.ts`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-compose",
-  "version": "0.6.1",
+  "version": "0.6.4",
   "description": "AdiaUI A2UI compose engine \u2014 framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
   "type": "module",
   "exports": {

package/strategies/zettel/types.ts

@@ -0,0 +1,40 @@
+/**
+ * Zettel strategy — branded primitive ID types.
+ *
+ * Three distinct ID spaces coexist in the zettel strategy: fragment IDs,
+ * chunk IDs, and composition IDs. All are plain strings at runtime, but
+ * cross-contamination (passing a ChunkId where a FragmentId is expected)
+ * caused the v0.4.7 §72 regression. Branded types make that a compile error.
+ *
+ * Per migration plan §7.3 and spec §7.3: brand discipline is opt-in per
+ * ID type. We brand when two ID spaces of the same primitive type cross
+ * in the same function body. Internal helpers that never cross boundaries
+ * stay on plain `string`.
+ *
+ * No enums — `erasableSyntaxOnly` requires plain type aliases.
+ */
+
+/** Unique identifier for a retrieved fragment within the corpus. */
+export type FragmentId = string & { readonly __brand: 'FragmentId' };
+
+/** Unique identifier for a chunk in the chunk-library. */
+export type ChunkId = string & { readonly __brand: 'ChunkId' };
+
+/** Unique identifier for a composed composition record. */
+export type CompositionId = string & { readonly __brand: 'CompositionId' };
+
+/**
+ * Cast a plain string to FragmentId at a trust boundary.
+ * Only use at the point where an ID originates (e.g. reading from corpus JSON).
+ */
+export function asFragmentId(id: string): FragmentId {
+  return id as FragmentId;
+}
+
+export function asChunkId(id: string): ChunkId {
+  return id as ChunkId;
+}
+
+export function asCompositionId(id: string): CompositionId {
+  return id as CompositionId;
+}