@adia-ai/a2ui-mcp 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -11,6 +11,16 @@ zettel strategies.
 
 _No pending changes._
 
+## [0.4.4] - 2026-05-12
+
+### Changed — fragment-retirement follow-through (§37, 2026-05-12)
+
+- **`mcp/server.js` — `get_fragment` tool removed; `zettel_stats` simplified.** Companion to `@adia-ai/a2ui-compose@[Unreleased]` retiring `corpus/fragments/`. Removed imports, boot logs, and the engine description block that referenced fragments. Net: -31 lines across server.js.
+- **`mcp/scripts/smoke-zettel.mjs` — retired (37 lines).** Smoke depended on the removed fragment library; replaced functionally by `mcp/scripts/smoke-engine-registry.mjs` (engine path) and `scripts/test-chunks.mjs` (zettel composition path).
+- **`mcp/scripts/test-chunks.mjs` — 1-line tweak.** Threshold adjustment for the post-§40 annotated-chunk world.
+
+See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutting arc narrative.
+
 ## [0.4.3] - 2026-05-11
 
 ### Ride-along (no source changes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-mcp",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "AdiaUI A2UI MCP server. Exposes the compose engine over MCP with an engine selector for monolithic + zettel strategies.",
   "type": "module",
   "bin": {

package/scripts/test-chunks.mjs

@@ -3,7 +3,7 @@
  * Smoke test for the gen-UI chunk MCP tools.
  *
  * Tests search_chunks / get_chunk / lookup_chunk against known chunks
- * harvested from site/pages/* and corpus/exemplars/*.
+ * harvested from site/pages/*, apps/*, playgrounds/*, and catalog/*.
  *
  * Wired into:
  *   - npm run smoke:chunks

package/server.js

@@ -43,16 +43,13 @@ import { getPattern, searchPatterns, getAllPatterns } from '../retrieval/pattern
 import { getAntiPatterns, checkAllAntiPatterns } from '../retrieval/anti-patterns.js';
 import { assembleContext } from '../retrieval/context-assembler.js';
 
-// ── Zettel (fragment-graph) engine ──
+// ── Zettel (composition) engine ──
 import {
   loadAll as loadZettelCorpus,
-  getFragment as getZettelFragment,
   getComposition as getZettelComposition,
-  getAllFragments as getAllZettelFragments,
   getAllCompositions as getAllZettelCompositions,
-  searchAll as searchZettelAll,
   getGraph as getZettelGraph,
-} from '../compose/strategies/zettel/fragment-library.js';
+} from '../compose/strategies/zettel/composition-library.js';
 import {
   resolveComposition as resolveZettelComposition,
   templateToMessages as zettelTemplateToMessages,
@@ -63,7 +60,7 @@ import {
 // Bootstrap zettel corpus alongside the monolithic pattern library
 const _zettelBoot = loadZettelCorpus();
 console.error(
-  `[adiaui-mcp] zettel corpus: ${_zettelBoot.fragmentCount} fragments, ${_zettelBoot.compositionCount} compositions`,
+  `[adiaui-mcp] zettel corpus: ${_zettelBoot.compositionCount} compositions`,
 );
 
 // ── Gen-UI training-chunk corpus ──
@@ -491,22 +488,13 @@ server.resource(
   }
 );
 
-// ── Zettel-only tools (fragment-graph inspection) ────────────────────────
-
-server.tool(
-  'get_fragment',
-  'Fetch a fragment (A2UI chunk + metadata + slots + backlinks) by name. Zettel-only.',
-  { name: z.string() },
-  async ({ name }) => {
-    const f = getZettelFragment(name);
-    if (!f) return { content: [{ type: 'text', text: `Fragment not found: ${name}` }], isError: true };
-    return { content: [{ type: 'text', text: JSON.stringify(f, null, 2) }] };
-  },
-);
+// ── Zettel composition-inspection tools ────────────────────────────────
+// (Fragment-inspection tools retired in §37; fragments no longer exist as
+// a separate corpus class. Compositions are now flat A2UI templates.)
 
 server.tool(
   'get_composition',
-  'Fetch a composition by name. Returns the fragment-referencing template (not yet resolved). Zettel-only.',
+  'Fetch a composition by name. Returns the flat A2UI template (compositions are pre-inlined; no $fragment refs). Zettel-only.',
   { name: z.string() },
   async ({ name }) => {
     const c = getZettelComposition(name);
@@ -517,7 +505,7 @@ server.tool(
 
 server.tool(
   'resolve_composition',
-  'Expand a composition into a flat A2UI template ($fragment refs resolved, slot bindings applied). Returns both the template and updateComponents messages. Zettel-only.',
+  'Return the flat A2UI template + updateComponents messages for a composition. Zettel-only. (Pre-inlined since §37 — `resolve` is now a defensive copy + strip pass.)',
   { name: z.string() },
   async ({ name }) => {
     const c = getZettelComposition(name);
@@ -535,31 +523,25 @@ server.tool(
 
 server.tool(
   'get_graph',
-  'Return the full backlink graph — fragments with their used_by lists, compositions with their uses_fragments lists. Use this to answer: what uses this fragment? what fragments does this composition depend on? Zettel-only.',
+  'Return the composition catalog. Zettel-only. (Backlinks to fragments retired in §37; only composition nodes remain.)',
   {},
   async () => ({ content: [{ type: 'text', text: JSON.stringify(getZettelGraph(), null, 2) }] }),
 );
 
 server.tool(
   'zettel_stats',
-  'Zettel corpus stats — fragment/composition counts, top fragments by leverage, orphans.',
+  'Zettel corpus stats — composition count + average node count. (Fragment stats retired in §37.)',
   {},
   async () => {
-    const frags = getAllZettelFragments();
     const comps = getAllZettelCompositions();
-    const byLeverage = [...frags]
-      .sort((a, b) => (b.metrics?.leverage || 0) - (a.metrics?.leverage || 0))
-      .slice(0, 10)
-      .map((f) => ({ name: f.name, leverage: f.metrics?.leverage || 0, used_by: (f.links?.used_by || []).length }));
-    const orphans = frags.filter((f) => !(f.links?.used_by || []).length).map((f) => f.name);
+    const totalNodes = comps.reduce((s, c) => s + (c.template?.length || 0), 0);
     return {
       content: [{
         type: 'text',
         text: JSON.stringify({
-          fragments: frags.length,
           compositions: comps.length,
-          top_leverage: byLeverage,
-          orphans,
+          avg_nodes_per_composition: comps.length ? Math.round(totalNodes / comps.length) : 0,
+          total_nodes: totalNodes,
         }, null, 2),
       }],
     };
@@ -683,7 +665,7 @@ async function main() {
   const catalog = await getCatalog();
   const patterns = getAllPatterns();
   const traits = getTraits();
-  console.error(`AdiaUI MCP Server running (${catalog.totalTypes} components, ${patterns.length} patterns, ${traits.length} traits, ${_zettelBoot.fragmentCount} zettel fragments, ${_zettelBoot.compositionCount} compositions)`);
+  console.error(`AdiaUI MCP Server running (${catalog.totalTypes} components, ${patterns.length} patterns, ${traits.length} traits, ${_zettelBoot.compositionCount} compositions)`);
 }
 
 main().catch(console.error);

package/scripts/smoke-zettel.mjs

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-/** Smoke test: load library, resolve login-form, print resolved template. */
-import { loadAll, getAllFragments, getAllCompositions, searchAll, getGraph, getComposition } from './fragment-library.js';
-import { resolveComposition } from './composer.js';
-
-const boot = loadAll();
-console.log('boot:', boot);
-
-console.log('\n=== Fragments ===');
-for (const f of getAllFragments()) console.log(` - ${f.name} [${f.semantic_role}]`);
-
-console.log('\n=== Compositions ===');
-for (const c of getAllCompositions()) console.log(` - ${c.name} (${c.domain})`);
-
-console.log('\n=== Search: "login" ===');
-console.log(searchAll('login form password', { limit: 5 }));
-
-console.log('\n=== Search: "card header title" ===');
-console.log(searchAll('card header title', { limit: 5 }));
-
-console.log('\n=== Resolve login-form ===');
-const comp = getComposition('login-form');
-const resolved = resolveComposition(comp);
-console.log(`resolved ${resolved.length} nodes:`);
-for (const n of resolved) {
-  const kids = n.children ? `→[${n.children.join(',')}]` : '';
-  const text = n.textContent ? ` "${n.textContent}"` : '';
-  const label = n.label ? ` label="${n.label}"` : '';
-  console.log(`  ${n.id.padEnd(20)} ${n.component}${label}${text} ${kids}`);
-}
-
-console.log('\n=== Graph ===');
-const g = getGraph();
-console.log('fragments with usage:');
-for (const f of g.fragments) {
-  if (f.used_by.length) console.log(`  ${f.name} ← ${f.used_by.map(u => u.name).join(', ')}`);
-}