@adia-ai/a2ui-mcp 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -9,7 +9,77 @@ zettel strategies.
 
 ## [Unreleased]
 
-_No pending changes._
+_Nothing yet._
+
+---
+
+## [0.2.1] - 2026-05-02
+
+**Lockstep cut + `report_issue` trigger phrases + scope-drift auto-fire on canvas-drift detection.** All 8 published `@adia-ai/*` packages bump 0.2.0 → 0.2.1 per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
+
+### Changed
+
+- `version`: `0.2.0` → `0.2.1`.
+- `dependencies["@adia-ai/a2ui-compose"]`: `^0.2.0` (covers `0.2.1`).
+- `dependencies["@adia-ai/a2ui-corpus"]`: `^0.2.0` (covers `0.2.1`).
+- `dependencies["@adia-ai/a2ui-utils"]`: `^0.2.0` (covers `0.2.1`).
+- `dependencies["@adia-ai/a2ui-retrieval"]`: `^0.2.0` (covers `0.2.1`).
+- `dependencies["@adia-ai/a2ui-validator"]`: `^0.2.0` (covers `0.2.1`).
+- `tools/synthesis.js` is the surface that gained the new behavior (auto-fire + trigger phrases below). `scripts/eval-compose-from-chunks.mjs` updated to load the holdout fixture from its new home in `@adia-ai/a2ui-corpus/evals/` (the file moved out of `evals/` here in this cut).
+- `evals/compose-from-chunks-holdout.jsonl` removed from this package; relocated to `packages/a2ui/corpus/evals/holdout-compose-from-chunks.jsonl` to live next to the corpus it tests.
+
+### Added — `report_issue` trigger phrases + sibling Markdown ticket (2026-05-02)
+
+`report_issue` tool description now lists explicit trigger phrases ("file a ticket", "save the trace", "report this as a bug", "track this regression", "open a ticket for this", and 9 more) so the LLM knows when to fire it without guessing. The default trace depth flipped from `'summary'` to `'full'` when `state_id` is provided — the high-resolution Markdown ticket is now the design intent.
+
+Tool return shape extended with `markdown_path` alongside the existing `path` (.json). The tool description instructs the LLM to surface BOTH paths to the user with a marker so a maintainer can navigate to either:
+
+```
+📋 Logged ticket `{issue_id}` ({severity} · owner: {suggested_owner})
+• Trace report: `{markdown_path}` ← human-readable
+• Raw JSON:     `{path}`           ← machine-readable
+```
+
+### Added — `compose_from_chunks` auto-fires `scope-drift` on canvas-drift detection (2026-05-02)
+
+When the composer's scope-drift gate (a2ui-compose) flags `result.scopeDrift.drift === true`, the MCP handler auto-fires a `scope-drift` issue with `trace: 'full'`, writing both the JSON ticket and the high-res Markdown report. Tool response also echoes `scopeDrift` so the calling agent can read the ratio + decide its next move. Closes the original MCP feedback's "next time canvas-drift happens, a ticket files itself" ask.
+
+## [0.2.0] - 2026-05-02
+
+**Lockstep cut + corpus caret-lock fix.** All 8 published `@adia-ai/*`
+packages now share one version, governed by
+[`docs/specs/package-architecture.md` § 15 (Versioning Policy)](../../../docs/specs/package-architecture.md#15-versioning-policy).
+
+This release **fixes a live shipping bug** in 0.1.3: the `dependencies`
+range `"@adia-ai/a2ui-corpus": "^0.0.6"` locked to *exactly* `0.0.6`
+under npm pre-1.0 semver, so every fresh `npm i @adia-ai/a2ui-mcp`
+since the corpus 0.0.7 cut was installing a stale corpus — missing the
+§§22-25 nav consolidation, the new chunks, and the catalog regen. The
+new range `^0.2.0` works correctly. Same class fixed for the other 4
+internal deps in this package.
+
+### Fixed
+
+- **`a2ui-mcp@0.1.3 → corpus@0.0.6` install bug.** The new `^0.2.0`
+  ranges resolve to the actually-current versions instead of the
+  caret-locked old ones. Consumers running `npx adiaui-mcp` from npm
+  now see the post-§§22-25 corpus + the post-rename component catalog.
+
+### Changed
+
+- `version`: `0.1.3` → `0.2.0`.
+- `dependencies["@adia-ai/a2ui-compose"]`: `^0.1.0` → `^0.2.0`.
+- `dependencies["@adia-ai/a2ui-retrieval"]`: `^0.0.1` → `^0.2.0`.
+- `dependencies["@adia-ai/a2ui-validator"]`: `^0.0.1` → `^0.2.0`.
+- `dependencies["@adia-ai/a2ui-corpus"]`: `^0.0.6` → `^0.2.0`.
+
+### No source changes
+
+`server.js`, tools, scripts, evals, personas — all byte-identical to
+0.1.3. The cut bumps version + the 4 internal dep ranges only.
+Consumers who want the substantive 0.1.3 work (`compose_from_chunks`
+eval runner + 20-intent hold-out set) get it via either 0.1.3 or
+0.2.0 — and 0.2.0 additionally installs the correct corpus version.
 
 ## [0.1.3] - 2026-05-02
 
@@ -421,12 +491,12 @@ before HTML is materialized.
 
 ### Added (engine internals)
 
-- `packages/a2ui/compose/engines/zettel/chunk-composer.js` —
+- `packages/a2ui/compose/strategies/zettel/chunk-composer.js` —
   HTML-string-level composer that walks a page chunk and substitutes
   each `data-chunk-slot` region with the bound block-level chunks'
   HTML. Companion `validatePlan()` checks slot names + chunk-kind
   contracts before composition.
-- `packages/a2ui/compose/engines/zettel/chunk-synthesizer.js` —
+- `packages/a2ui/compose/strategies/zettel/chunk-synthesizer.js` —
   LLM-driven mix-and-match composition; pre-searches the catalog,
   builds a prompt with a one-shot in-context example, validates the
   LLM's binding plan against the catalog, retries with feedback on
@@ -498,7 +568,7 @@ exposes A2UI generation tools over JSON-RPC.
 Initial version at the time the monorepo was established. Contains:
 
 - MCP server (`server.js`) exposing `generate_ui`, `search_patterns`, `lookup_component`, `resolve_composition`, `validate_schema`, and related tools.
-- Engine plugin API via in-process `registerEngine()` (see `packages/a2ui/compose/engines/registry.js`).
+- Engine plugin API via in-process `registerEngine()` (see `packages/a2ui/compose/strategies/registry.js`).
 - Smoke tests (`scripts/smoke-*.mjs`) for engine registration, merged generation, and end-to-end A2UI tests.
 - Eval harnesses (`scripts/test-evals.mjs`, `scripts/test-a2ui.mjs`, `scripts/eval-fix.mjs`) for corpus regression measurement.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-mcp",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "AdiaUI A2UI MCP server. Exposes the compose engine over MCP with an engine selector for monolithic + zettel strategies.",
   "type": "module",
   "bin": {
@@ -10,7 +10,6 @@
     "server.js",
     "tools/",
     "scripts/",
-    "evals/",
     "personas/",
     "README.md",
     "CHANGELOG.md"
@@ -27,10 +26,10 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@adia-ai/a2ui-compose": "^0.1.0",
-    "@adia-ai/a2ui-retrieval": "^0.0.1",
-    "@adia-ai/a2ui-validator": "^0.0.1",
-    "@adia-ai/a2ui-corpus": "^0.0.6",
+    "@adia-ai/a2ui-compose": "^0.2.0",
+    "@adia-ai/a2ui-retrieval": "^0.2.0",
+    "@adia-ai/a2ui-validator": "^0.2.0",
+    "@adia-ai/a2ui-corpus": "^0.2.0",
     "zod": "^3.24.0"
   }
 }

package/scripts/dogfood-test.mjs

@@ -1,7 +1,7 @@
 /**
  * Dogfood test: Run 20 diverse intents through A2UI instant mode.
  */
-const { generateUI } = await import('../../compose/engine/generator.js');
+const { generateUI } = await import('../../compose/core/generator.js');
 
 const intents = [
   'user registration form with name, email, password',

package/scripts/eval-chunk-synthesis.mjs

@@ -19,7 +19,7 @@
  */
 
 import '../../../../scripts/load-env.mjs';
-import { composeFromIntent } from '../../compose/engines/zettel/chunk-synthesizer.js';
+import { composeFromIntent } from '../../compose/strategies/zettel/chunk-synthesizer.js';
 import { createAdapter } from '../../compose/llm/llm-bridge.js';
 
 // Hold-out intents — chosen to NOT have a 1:1 chunk match (so synthesis path

package/scripts/eval-compose-from-chunks.mjs

@@ -3,7 +3,7 @@
  * eval-compose-from-chunks.mjs — Hold-out eval for the chunk-aware
  * synthesizer. Per `docs/specs/compose-from-chunks-eval.md`.
  *
- * Reads `packages/a2ui/mcp/evals/compose-from-chunks-holdout.jsonl`,
+ * Reads `packages/a2ui/corpus/evals/holdout-compose-from-chunks.jsonl`,
  * runs each intent through `composeFromIntent`, and emits a per-intent
  * + aggregate report.
  *
@@ -48,11 +48,11 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { composeFromIntent } from '../../compose/engines/zettel/chunk-synthesizer.js';
+import { composeFromIntent } from '../../compose/strategies/zettel/chunk-synthesizer.js';
 import { searchChunksAsync } from '../../corpus/scripts/chunk-library.js';
 
 const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../..');
-const HOLDOUT = path.join(REPO_ROOT, 'packages/a2ui/mcp/evals/compose-from-chunks-holdout.jsonl');
+const HOLDOUT = path.join(REPO_ROOT, 'packages/a2ui/corpus/evals/holdout-compose-from-chunks.jsonl');
 const PASS_THRESHOLD = 80;
 
 const args = process.argv.slice(2);

package/scripts/eval-diff.mjs

@@ -28,8 +28,8 @@ import { mkdir, writeFile } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { generateUI } from '../../compose/engine/generator.js';
-import { generateZettel } from '../../compose/engines/zettel/generator-adapter.js';
+import { generateUI } from '../../compose/core/generator.js';
+import { generateZettel } from '../../compose/strategies/zettel/generator-adapter.js';
 import { runHarnessV2 } from '../../compose/evals/harness.mjs';
 import { validateSemantics } from '../../validator/semantic/index.js';
 

package/scripts/eval-fix.mjs

@@ -50,7 +50,7 @@ const MAX_ITER = parseInt([...args].find(a => a.startsWith('--max-iter='))?.spli
 
 // ── Load modules ──
 
-const { generateUI } = await import('../../compose/engine/generator.js');
+const { generateUI } = await import('../../compose/core/generator.js');
 const { validateSchema } = await import('../../validator/validator.js');
 const { getPattern, searchPatterns } = await import('../../retrieval/pattern-library.js');
 const { createTicket, formatTicket, formatTicketList } = await import('../../../../.tickets/tickets.js');

package/scripts/eval-refine-synthesis.mjs

@@ -23,10 +23,10 @@ import '../../../../scripts/load-env.mjs';
 import {
   refineFromIntent,
   applyOps,
-} from '../../compose/engines/zettel/chunk-refiner.js';
-import { mintStateId } from '../../compose/engines/zettel/state-cache.js';
-import { createIssueAccumulator } from '../../compose/engines/zettel/issue-reporter.js';
-import { composeFromPlan } from '../../compose/engines/zettel/chunk-composer.js';
+} from '../../compose/strategies/zettel/chunk-refiner.js';
+import { mintStateId } from '../../compose/strategies/zettel/state-cache.js';
+import { createIssueAccumulator } from '../../compose/strategies/zettel/issue-reporter.js';
+import { composeFromPlan } from '../../compose/strategies/zettel/chunk-composer.js';
 import { listChunksByKind, getChunk } from '../../corpus/scripts/chunk-library.js';
 import { createAdapter } from '../../compose/llm/llm-bridge.js';
 

package/scripts/generate.mjs

@@ -34,7 +34,7 @@ const mode = flags.has('--thinking') ? 'thinking' : flags.has('--pro') ? 'pro' :
 const JSON_OUT = flags.has('--json');
 const HTML_OUT = flags.has('--html');
 
-const { generateUI, generateUIStream } = await import('../../compose/engine/generator.js');
+const { generateUI, generateUIStream } = await import('../../compose/core/generator.js');
 
 console.error(`Mode: ${mode} | Intent: "${intent}"`);
 console.error('─'.repeat(50));

package/scripts/multi-turn-test.mjs

@@ -13,7 +13,7 @@
  */
 
 import '../../../../scripts/load-env.mjs';
-import { generateUI } from '../../compose/engine/generator.js';
+import { generateUI } from '../../compose/core/generator.js';
 import { validateSchema } from '../../validator/validator.js';
 
 // ── Test scenarios ──────────────────────────────────────────────────

package/scripts/smoke-engine-registry.mjs

@@ -8,8 +8,8 @@
  *   - shape invariants hold on both paths
  */
 import '../../../../scripts/load-env.mjs';
-import { pick, listEngines, ENGINES } from '../../compose/engines/registry.js';
-import { generateUI } from '../../compose/engine/generator.js';
+import { pick, listEngines, ENGINES } from '../../compose/strategies/registry.js';
+import { generateUI } from '../../compose/core/generator.js';
 
 console.log('[smoke] engines registered:', listEngines().join(', '));
 

package/scripts/smoke-issues.mjs

@@ -8,8 +8,8 @@ import {
   attachTrace,
   createIssueAccumulator,
   AUTO_FIRE_POLICY,
-} from '../../compose/engines/zettel/issue-reporter.js';
-import { StateCache } from '../../compose/engines/zettel/state-cache.js';
+} from '../../compose/strategies/zettel/issue-reporter.js';
+import { StateCache } from '../../compose/strategies/zettel/state-cache.js';
 import { mkdtemp, readFile, rm, stat } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';

package/scripts/smoke-refine.mjs

@@ -7,13 +7,13 @@ import {
   applyOps,
   validateOps,
   opsToA2UI,
-} from '../../compose/engines/zettel/chunk-refiner.js';
+} from '../../compose/strategies/zettel/chunk-refiner.js';
 import {
   StateCache,
   mintStateId,
   mintNextStateId,
-} from '../../compose/engines/zettel/state-cache.js';
-import { createIssueAccumulator } from '../../compose/engines/zettel/issue-reporter.js';
+} from '../../compose/strategies/zettel/state-cache.js';
+import { createIssueAccumulator } from '../../compose/strategies/zettel/issue-reporter.js';
 import {
   getChunk,
   listChunksByKind,

package/scripts/smoke-register-engine.mjs

@@ -1,5 +1,5 @@
 // Smoke test for OD-5 plugin engine registry.
-import { registerEngine, unregisterEngine, pick, listEngines, ENGINES } from '../../compose/engines/registry.js';
+import { registerEngine, unregisterEngine, pick, listEngines, ENGINES } from '../../compose/strategies/registry.js';
 
 let pass = 0, fail = 0;
 const t = (label, ok, detail = '') => {

package/scripts/smoke-state-cache.mjs

@@ -7,7 +7,7 @@ import {
   mintNextStateId,
   getStateCache,
   resetStateCache,
-} from '../../compose/engines/zettel/state-cache.js';
+} from '../../compose/strategies/zettel/state-cache.js';
 
 let pass = 0, fail = 0;
 const t = (label, ok, detail = '') => {

package/scripts/smoke-synthesis.mjs

@@ -1,6 +1,6 @@
 // Direct test of zettel generator with LLM adapter — no HTTP server needed.
 import '../../../../scripts/load-env.mjs';
-import { generateZettel, clearSession, getTurns } from '../../compose/engines/zettel/generator-adapter.js';
+import { generateZettel, clearSession, getTurns } from '../../compose/strategies/zettel/generator-adapter.js';
 
 // Minimal Anthropic adapter inline (mirrors what server.js makes).
 function makeAdapter() {

package/scripts/test-a2ui.mjs

@@ -76,7 +76,7 @@ try {
 
 console.log('\n2. Pattern library');
 
-const { searchBlocks, listPatterns, lookupDomain } = await import('../../compose/engine/reference.js');
+const { searchBlocks, listPatterns, lookupDomain } = await import('../../compose/core/reference.js');
 
 const allPatterns = listPatterns();
 const withTemplates = allPatterns.filter(p => p.template && Array.isArray(p.template));
@@ -176,7 +176,7 @@ for (const intent of passTests) {
 
 console.log('\n4. Instant mode generation');
 
-const { generateUI } = await import('../../compose/engine/generator.js');
+const { generateUI } = await import('../../compose/core/generator.js');
 
 const instantTests = [
   { intent: 'login form', minComponents: 3 },
@@ -270,9 +270,9 @@ try {
 console.log('\n7. Multi-turn refinement (Phase A)');
 
 try {
-  const { StateCache, mintStateId, mintNextStateId } = await import('../../compose/engines/zettel/state-cache.js');
-  const { createIssueAccumulator } = await import('../../compose/engines/zettel/issue-reporter.js');
-  const { refineFromIntent, applyOps, opsToA2UI, validateOps } = await import('../../compose/engines/zettel/chunk-refiner.js');
+  const { StateCache, mintStateId, mintNextStateId } = await import('../../compose/strategies/zettel/state-cache.js');
+  const { createIssueAccumulator } = await import('../../compose/strategies/zettel/issue-reporter.js');
+  const { refineFromIntent, applyOps, opsToA2UI, validateOps } = await import('../../compose/strategies/zettel/chunk-refiner.js');
   const { listChunksByKind } = await import('../../corpus/scripts/chunk-library.js');
 
   // 7a. State cache + state-id chain

package/scripts/test-chunks.mjs

@@ -94,8 +94,8 @@ assert('lookup_chunk(article) finds dashboard-admin-page',
   articleChunks.some((c) => c.name === 'dashboard-admin-page'));
 
 // ── chunk-composer + chunk-synthesizer ──
-import { composeFromPlan, validatePlan } from '../../compose/engines/zettel/chunk-composer.js';
-import { composeFromIntent } from '../../compose/engines/zettel/chunk-synthesizer.js';
+import { composeFromPlan, validatePlan } from '../../compose/strategies/zettel/chunk-composer.js';
+import { composeFromIntent } from '../../compose/strategies/zettel/chunk-synthesizer.js';
 
 console.log('\n── validatePlan ──');
 

package/scripts/test-evals.mjs

@@ -42,7 +42,7 @@ if (ONLY) evalCases = evalCases.filter(e => String(e.id) === ONLY);
 
 // ── Load generator ──
 
-const { generateUI } = await import('../../compose/engine/generator.js');
+const { generateUI } = await import('../../compose/core/generator.js');
 const { validateSchema } = await import('../../validator/validator.js');
 
 // ── Scoring functions ──

package/scripts/visual-validate.mjs

@@ -22,7 +22,7 @@ const PRO = args.has('--pro');
 const OPEN = args.has('--open');
 const OUTPUT = join(__dirname, '..', 'visual-validation.html');
 
-const { generateUI } = await import('../../compose/engine/generator.js');
+const { generateUI } = await import('../../compose/core/generator.js');
 const { validateSchema } = await import('../../validator/validator.js');
 
 const TEST_INTENTS = [