@adia-ai/a2ui-retrieval 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -9,6 +9,37 @@ _Nothing yet._
 
 ---
 
+## [0.2.2] - 2026-05-02
+
+**Lockstep cut + `detectReferences` brand-only filter.** All 8 published `@adia-ai/*` packages bump 0.2.1 → 0.2.2 per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
+
+### Changed
+
+- `version`: `0.2.1` → `0.2.2`.
+- `dependencies["@adia-ai/a2ui-corpus"]`: `^0.2.0` (covers `0.2.2`).
+- `dependencies["@adia-ai/a2ui-utils"]`: `^0.2.0` (covers `0.2.2`).
+- `authoring/web-research.js` is the surface that gained the EXPLICIT/IMPLICIT pattern split; no other retrieval subdirs touched.
+
+### Fixed — `detectReferences` brand-only filter (2026-05-02)
+
+`authoring/web-research.js` regex patterns were capturing generic nouns as brand references. For the intent `"tier pricing page"`, the pattern `\b(\w+)\s+(?:pricing|dashboard|landing|login|settings|profile)\s+page\b` captured `"tier"` and seeded a research query for `"tier pricing UI design components"` — useless, since `"tier"` is a generic noun, not a brand reference.
+
+Fix: split `REFERENCE_PATTERNS` into two tiers by signal strength:
+
+- **`EXPLICIT_PATTERNS`** — the surrounding language declares the captured token IS a brand reference (`"like X"`, `"X-style"`, `"similar to X"`, `"clone X"`). Captures accepted as references.
+- **`IMPLICIT_PATTERNS`** — the surrounding language is a UI-shape verb (`"X pricing page"`). Captures accepted ONLY if in `KNOWN_REFERENCES` (Stripe, Notion, Figma, …); generic nouns dropped.
+
+Verified:
+- `"tier pricing page"` → no refs (was: `["tier"]`)
+- `"fancy pricing page"` → no refs
+- `"Stripe pricing page"` → `["stripe"]` ✓
+- `"Notion-style sidebar"` → `["notion"]` ✓
+- `"like Figma"` → `["figma"]` ✓
+
+Per memory `feedback_panel_label_reliability.md`. Companion fix in `@adia-ai/a2ui-compose` Unreleased (generator.js panel emissions). Both surfaces feed the same reasoning-panel deception class — five distinct bugs caught + fixed in commit `9986c71e`.
+
+---
+
 ## [0.2.1] - 2026-05-02
 
 **Lockstep cut.** 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.

package/authoring/web-research.js

@@ -13,8 +13,25 @@
 
 // ── Reference detection ──────────────────────────────────────────────────
 
-/** Patterns that indicate the user is referencing a specific product/design */
-const REFERENCE_PATTERNS = [
+/**
+ * Patterns split by signal strength:
+ *
+ *   EXPLICIT_PATTERNS — the surrounding language declares the captured
+ *     token IS a brand reference ("like X", "X-style", "similar to X").
+ *     The capture is accepted as a reference even if not in KNOWN_REFERENCES.
+ *
+ *   IMPLICIT_PATTERNS — the surrounding language is a UI-shape verb
+ *     ("X pricing page"); the capture COULD be a brand or COULD be a
+ *     generic noun. Accept ONLY if in KNOWN_REFERENCES, otherwise drop.
+ *
+ * Splitting this way fixes the 2026-05-02 bug where "tier pricing page"
+ * extracted "tier" as a reference and seeded a research query for it. The
+ * regex was working as designed — `\w+ pricing page` captures the prefix
+ * word — but a generic noun like "tier" or "subscription" or "fancy"
+ * isn't a brand reference, so research and downstream prompt enrichment
+ * shouldn't act on it.
+ */
+const EXPLICIT_PATTERNS = [
   /\blike\s+(\w[\w\s]*?)(?:\s*['']s|\s+style|\s+design|\s*$)/i,
   /\b(\w[\w\s]*?)[\s-]style\b/i,
   /\b(\w[\w\s]*?)[\s-]inspired\b/i,
@@ -22,6 +39,9 @@ const REFERENCE_PATTERNS = [
   /\bbased\s+on\s+(\w[\w\s]*?)(?:\s|$|,)/i,
   /\bcopy\s+(\w[\w\s]*?)(?:\s|$|,)/i,
   /\bclone\s+(\w[\w\s]*?)(?:\s|$|,)/i,
+];
+
+const IMPLICIT_PATTERNS = [
   /\b(\w+)\s+(?:pricing|dashboard|landing|login|settings|profile)\s+page\b/i,
 ];
 
@@ -44,12 +64,11 @@ export function detectReferences(intent) {
   const references = [];
   const lower = intent.toLowerCase();
 
-  // Pattern matching
-  for (const pattern of REFERENCE_PATTERNS) {
+  // Explicit-signal patterns — accept the capture as a reference.
+  for (const pattern of EXPLICIT_PATTERNS) {
     const match = intent.match(pattern);
     if (match) {
       let ref = (match[1] || '').trim();
-      // Strip leading articles
       ref = ref.replace(/^(the|a|an)\s+/i, '');
       if (ref && ref.length > 1 && ref.length < 30) {
         references.push(ref);
@@ -57,6 +76,19 @@ export function detectReferences(intent) {
     }
   }
 
+  // Implicit-signal patterns — gate by KNOWN_REFERENCES so generic nouns
+  // ("tier", "fancy", "simple") don't get treated as brands.
+  for (const pattern of IMPLICIT_PATTERNS) {
+    const match = intent.match(pattern);
+    if (match) {
+      let ref = (match[1] || '').trim();
+      ref = ref.replace(/^(the|a|an)\s+/i, '');
+      if (ref && ref.length > 1 && ref.length < 30 && KNOWN_REFERENCES.has(ref.toLowerCase())) {
+        references.push(ref);
+      }
+    }
+  }
+
   // Direct brand name detection (only as whole words)
   for (const brand of KNOWN_REFERENCES) {
     const re = new RegExp(`\\b${brand}\\b`, 'i');
@@ -65,7 +97,9 @@ export function detectReferences(intent) {
     }
   }
 
-  // Filter out non-brand captures (e.g., "inspired" from "X-inspired")
+  // Filter out non-brand captures from the explicit patterns — words like
+  // "inspired" can sneak through when the intent is "X-inspired" with no
+  // X (e.g. "is this AI-inspired?"). Belt and suspenders.
   const NON_BRANDS = new Set(['inspired', 'style', 'based', 'like', 'similar', 'the']);
   for (let i = references.length - 1; i >= 0; i--) {
     if (NON_BRANDS.has(references[i].toLowerCase())) references.splice(i, 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-retrieval",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "AdiaUI A2UI retrieval layer — catalog lookup, intent classification, domain routing, pattern + anti-pattern matching, clarity + context assembly. Consumed by the compose engine and any A2UI-protocol tooling that needs to reason about user intent against the catalog.",
   "type": "module",
   "main": "./index.js",