@tangle-network/browser-agent-driver 0.12.1 → 0.14.0

package/dist/design/audit/rubric/fragments/domain-ai.md

@@ -0,0 +1,19 @@
+---
+id: domain-ai
+title: AI / ML Products
+weight: high
+applies-when:
+  domain: [ai, ml, llm, agents]
+---
+
+AI / ML PRODUCT CRITERIA:
+
+- Demo prominence: working live demo > screenshots
+- Model differentiation: clear what makes this AI different (latency, quality, cost)
+- Streaming UI quality (for chat/agent products): smooth, no layout shifts, cancelable
+- Tool/function call visualization: when the agent uses tools, can the user see it?
+- Error recovery: model timeouts, content filters, rate limits — all handled gracefully
+- Conversation history: persistent, searchable, exportable
+- Token/cost transparency for paid usage
+- Safety messaging: where appropriate, present without being alarmist
+- Avoid excessive AI cliches (matrix rain, robot illustrations, generic gradients)

package/dist/design/audit/rubric/fragments/domain-crypto.md

@@ -0,0 +1,24 @@
+---
+id: domain-crypto
+title: Crypto / DeFi
+weight: high
+dimension: trust-signals
+applies-when:
+  domain: [crypto, defi, web3]
+  type: [marketing, saas-app, tool]
+---
+
+DeFi / CRYPTO CRITERIA — evaluate as a trader managing real money:
+
+- Trust signals: does the UI feel safe to connect a wallet to? Professional or sketchy?
+- Token displays: balances formatted correctly, right decimals, USD equivalents
+- Transaction clarity: clear what you're signing — amount, fees, slippage shown
+- Loading states: RPC calls are slow — proper indicators for balances, quotes, gas
+- Mobile responsiveness: most DeFi usage is mobile
+- Dark mode: most crypto apps use dark mode — sufficient contrast, visible borders
+- Error handling: RPC fails, wallet rejects, insufficient balance — all handled
+- Swap UX: token selection intuitive, address paste, price impact shown
+- Wallet connection: smooth flow, supported wallets clearly shown
+- Gas/fee transparency: estimates shown before confirmation
+
+CALIBRATION: Uniswap v4 / Aave v3 = 8. Average DEX = 5. Rug-pull-looking sites = 2.

package/dist/design/audit/rubric/fragments/domain-devtools.md

@@ -0,0 +1,21 @@
+---
+id: domain-devtools
+title: Developer Tools
+weight: high
+applies-when:
+  domain: [devtools, dev, infrastructure, api, sdk]
+---
+
+DEVELOPER TOOLS CRITERIA:
+
+- Code-first messaging: hero shows code, not abstract illustrations
+- Quickstart prominent: "get started in N minutes" with copyable command
+- API docs link visible
+- SDK support transparency: which languages, badges/logos
+- Pricing transparency: free tier clear, no "contact us"
+- GitHub stars, npm downloads, or similar credibility markers
+- Dark mode: developers prefer dark, must be excellent
+- Terminal aesthetics done well, not gimmicky
+- Real customer logos (other dev companies preferred)
+
+CALIBRATION: Vercel / Linear / Cursor / Stripe = 9. Average dev tool landing = 6. "Enterprise blockchain" sites = 3.

package/dist/design/audit/rubric/fragments/domain-fintech.md

@@ -0,0 +1,19 @@
+---
+id: domain-fintech
+title: Fintech / Financial Services
+weight: high
+dimension: trust-signals
+applies-when:
+  domain: [fintech, finance, banking, payments]
+---
+
+FINTECH-SPECIFIC CRITERIA:
+
+- Trust signals: security badges, compliance mentions (SOC2, PCI), institutional logos
+- Numerical precision: amounts with correct decimals, currency symbols, no truncation
+- Risk disclosure: fees, terms, warnings prominently shown
+- Conservative aesthetic: financial sites should feel substantial, not playful
+- Data tables: aligned columns, easy scanning, totals visible
+- Form validation: especially strict for money inputs (max digits, format)
+- Color use: green/red for money should follow market conventions (gain/loss)
+- Audit trail visibility: transaction history, statements, exports

package/dist/design/audit/rubric/fragments/maturity-prototype.md

@@ -0,0 +1,36 @@
+---
+id: maturity-prototype
+title: Prototype / Template Detection
+weight: high
+applies-when:
+  maturity: [prototype, mvp]
+  designSystem: [shadcn, mui, ant, chakra]
+---
+
+TEMPLATE-DETECTION CRITERIA — apply when this looks like an unmodified component-library app:
+
+The #1 sin of vibecoded / AI-generated apps is shipping unmodified component library defaults:
+- Default border-radius (6-8px shadcn, 4px MUI)
+- Default color palette (zinc/slate grays, blue-600 primary)
+- Default component spacing with no customization
+- Standard card shadows, stock empty states
+- "Looks like every other AI-generated app" = automatic 3-4 score
+
+HIERARCHY & INFORMATION ARCHITECTURE:
+- Is everything the same visual weight? (Common AI pattern: all cards same size)
+- Clear primary/secondary/tertiary action distinction?
+- Layout has purpose, or is it "centered column of cards"?
+
+DESIGN SYSTEM COHERENCE:
+- More than 3 distinct border-radius values = incoherent
+- Color palette: intentional limited (4-6) vs random accumulation
+- Spacing: 8px grid rhythm vs arbitrary per-component
+- Typography: deliberate scale with 3-4 sizes vs every component picking its own
+
+CRAFT SIGNALS (separates 7 from 9):
+- Custom icons or generic Lucide/Heroicons dump?
+- Micro-interactions: button feedback, page transitions, loading skeletons
+- Empty states: designed illustrations or "No data found" text?
+- Error states: helpful with recovery actions or raw error strings?
+
+CEILING: Unmodified template apps cap at 4 regardless of functionality. State this in the score reasoning.

package/dist/design/audit/rubric/fragments/type-blog.md

@@ -0,0 +1,22 @@
+---
+id: type-blog
+title: Blog / Article
+weight: medium
+applies-when:
+  type: [blog]
+---
+
+BLOG / ARTICLE CRITERIA — evaluate as a reader scanning then committing:
+
+- Reading line length: 65-75ch optimal
+- Type pairing: serif body or excellent sans, clear heading distinction
+- Line height: 1.5-1.7 for body text
+- Image usage: meaningful, not stock filler
+- Code blocks (if technical): syntax highlighting, copyable
+- Author byline + date prominent
+- Reading time estimate (helpful)
+- TOC or section nav for long articles
+- Related/next-article surface at the end
+- No autoplay video, no aggressive CTAs interrupting reading
+
+CALIBRATION: Stripe blog / Vercel blog / Substack flagships = 9. Medium = 6. WordPress defaults = 4.

package/dist/design/audit/rubric/fragments/type-docs.md

@@ -0,0 +1,23 @@
+---
+id: type-docs
+title: Technical Documentation
+weight: high
+dimension: readability
+applies-when:
+  type: [docs]
+---
+
+TECHNICAL DOCUMENTATION CRITERIA — evaluate as a developer trying to learn:
+
+- Reading line length: prose 65-75ch, never wider
+- Code blocks: syntax highlighting, copyable, language labels
+- Information architecture: clear section navigation, breadcrumbs, in-page TOC
+- Search affordance: prominent, fast, results relevant
+- Type hierarchy: H1/H2/H3 visually distinct, scannable
+- Inline code styling distinguishable from prose
+- Anchor links on headings for sharing
+- Dark mode toggle present and well-implemented
+- Performance: doc pages should load instantly (no JS-heavy frameworks for static content)
+- Cross-linking between related concepts
+
+CALIBRATION: Stripe Docs / Tailwind Docs / Vercel Docs = 9. Average dev docs = 5. Wall-of-text wikis = 3.

package/dist/design/audit/rubric/fragments/type-ecommerce.md

@@ -0,0 +1,23 @@
+---
+id: type-ecommerce
+title: E-commerce / Storefront
+weight: high
+dimension: conversion
+applies-when:
+  type: [ecommerce]
+---
+
+E-COMMERCE CRITERIA — evaluate as a shopper deciding to spend money:
+
+- Product imagery: high-resolution, multiple angles, zoom support
+- Price prominence and clarity (no hidden fees, currency obvious)
+- Add-to-cart affordance: obvious, immediate feedback
+- Trust signals: reviews, ratings, return policy, security badges
+- Filters/sort: discoverable, fast, persistent state
+- Cart accessibility: visible at all times, count badge
+- Checkout flow: single-page or stepped, progress visible, guest checkout option
+- Mobile-first: most ecommerce traffic is mobile
+- Performance: every second of load = ~2% conversion lost
+- Inventory state: clear "in stock" / "out of stock" / "limited"
+
+CALIBRATION: Apple / Allbirds / Glossier = 9. Generic Shopify themes = 5. Broken cart flows = 2.

package/dist/design/audit/rubric/fragments/type-marketing.md

@@ -0,0 +1,22 @@
+---
+id: type-marketing
+title: Marketing / Landing Page
+weight: high
+applies-when:
+  type: [marketing]
+---
+
+MARKETING / LANDING PAGE CRITERIA — evaluate as a potential customer deciding in 10 seconds:
+
+- Hero clarity: in 5 seconds, can I tell what this product does and who it's for?
+- Visual hierarchy: does the eye flow naturally from headline → subtext → CTA?
+- CTA prominence: is the primary call-to-action obvious and compelling?
+- Social proof: testimonials, logos, or metrics shown convincingly?
+- Headline typography impactful? Body text readable?
+- Imagery high quality and relevant, or stock-photo generic?
+- Whitespace — does the page breathe or feel cramped?
+- Mobile: hero and CTA work without scrolling on small viewports?
+- Performance perception: feels fast? Images optimized? No layout shift?
+- Footer: navigation complete, legal links present?
+
+CALIBRATION: Stripe / Linear / Vercel = 9. Average startup landing = 5. Template sites = 3.

package/dist/design/audit/rubric/fragments/type-saas-app.md

@@ -0,0 +1,20 @@
+---
+id: type-saas-app
+title: SaaS Application
+weight: high
+applies-when:
+  type: [saas-app, dashboard]
+---
+
+SaaS APPLICATION CRITERIA — evaluate as a paying customer would:
+
+- Information density: data presented efficiently without clutter?
+- Navigation: features findable in <3 clicks? Sidebar/nav intuitive?
+- Empty states: helpful onboarding prompts when there's no data?
+- Loading states: skeleton screens or spinners, or does content pop in?
+- Form design: inline validation, clear labels, logical tab order?
+- Dashboard layout: most important data prominent, card hierarchy clear?
+- Error states: actionable with clear recovery paths?
+- Pattern consistency: do buttons, inputs, modals follow the same patterns throughout?
+
+CALIBRATION: Linear / Notion / Figma = 9. Generic admin templates = 5. Broken CRUD = 3.

package/dist/design/audit/rubric/fragments/universal-calibration.md

@@ -0,0 +1,16 @@
+---
+id: universal-calibration
+title: Universal Calibration Anchor
+weight: critical
+applies-when:
+  universal: true
+---
+
+CALIBRATION — be ruthlessly honest:
+- 9-10: Only world-class design (Linear, Stripe, Vercel, Apple). Exceptional typography, spacing, micro-interactions. Coherent system, intentional decisions visible everywhere.
+- 7-8: Professional and polished. Clear design system. Minor inconsistencies tolerated if the whole feels coherent.
+- 5-6: Functional but generic. Default component libraries with light customization. Production-ready but uninspired.
+- 3-4: Noticeably broken or amateurish. Inconsistent spacing, clashing colors, poor hierarchy. Default templates with no investment.
+- 1-2: Unusable. Overlapping elements, unreadable text, broken layouts.
+
+Most production apps score 5-7. Very few deserve 8+. Do NOT grade on a curve.

package/dist/design/audit/rubric/fragments/universal-effort-anchor.md

@@ -0,0 +1,46 @@
+---
+id: universal-effort-anchor
+title: Effort & ROI Calibration
+weight: critical
+applies-when:
+  universal: true
+---
+
+EFFORT SCALE — when scoring `effort` on a finding, use these anchors:
+
+| Effort | Definition | Examples |
+|---|---|---|
+| 1 | Single CSS value change in a token or shared style | `--color-text: #4b5563`, `padding-bottom: 48px` |
+| 2 | Single component file edit | Update `Button.tsx` to add focus ring |
+| 3 | A few related component edits | Standardize 3 card components to one radius |
+| 4 | New design token + propagation | Add `--space-section`, replace 12 hardcoded values |
+| 5 | New shared component | Build a reusable `Stack` to fix layout drift |
+| 6 | Significant component refactor | Restructure `Sidebar` to support responsive collapse |
+| 7 | Section redesign | Hero rewrite with new copy hierarchy |
+| 8 | Multi-page layout change | Apply new grid container across routes |
+| 9 | Design system overhaul | New type scale + recolor + spacing rebuild |
+| 10 | Full app redesign | Greenfield rebuild |
+
+IMPACT SCALE — when scoring `impact` on a finding:
+
+| Impact | Definition |
+|---|---|
+| 1-2 | Pure nitpick. Most users wouldn't notice. |
+| 3-4 | Visible if you're looking. Polish detail. |
+| 5-6 | Noticeable on first scan. Affects perceived quality. |
+| 7-8 | Hurts trust or usability. Affects task success. |
+| 9-10 | Breaks the experience. WCAG failures, broken layouts, unreadable text. |
+
+BLAST SCALE — when assigning `blast`:
+
+| Blast | When |
+|---|---|
+| `page` | Only this page benefits from the fix |
+| `section` | A region of this page (hero, footer, sidebar) |
+| `component` | A shared component (`Card`, `Button`) — multiple pages benefit |
+| `system` | A design token, global style, or universal pattern — every page benefits |
+
+RANKING DISCIPLINE — assign these honestly:
+- A 5-second token change with system blast (e.g. fix the body text gray) should DOMINATE a 2-day visual polish refactor.
+- Don't inflate impact to make minor findings sound important. The user fixes the top-5; everything below 5 may never get touched.
+- A "small but everywhere" fix beats a "big but isolated" fix in ROI ranking — that's correct.

package/dist/design/audit/rubric/fragments/universal-foundation.md

@@ -0,0 +1,49 @@
+---
+id: universal-foundation
+title: Universal Design Foundation
+weight: critical
+applies-when:
+  universal: true
+---
+
+EVALUATION FRAMEWORK — score each area 1-10:
+
+1. LAYOUT & GRID
+   - Consistent grid system? What unit? (4px, 8px, etc.)
+   - Column alignment: do content blocks align to consistent edges?
+   - Container widths appropriate (prose 65-75ch, app fluid)?
+   - Z-index layering — any stacking issues, overlapping elements?
+   - Orphaned elements floating outside the grid?
+
+2. TYPOGRAPHY SYSTEM
+   - Type scale: count distinct font-size values. >5-6 suggests no scale.
+   - Line height: body 1.4-1.6, headings 1.1-1.3. Flag violations.
+   - Letter spacing: headings often need negative tracking (-0.01 to -0.03em).
+   - Font pairing: max 2 families. Flag 3+.
+   - Long-form text wider than 75ch harms readability.
+
+3. SPACING & RHYTHM
+   - Grid adherence: % of spacing values that are multiples of the base unit
+   - Vertical rhythm: are section gaps consistent?
+   - Component internal spacing: consistent padding within similar components?
+   - Whitespace ratio: enough breathing room or cramped?
+
+4. COMPONENT CONSISTENCY
+   - Button variants: how many distinct button styles? Intentional or accidental?
+   - Input styling: consistent border, focus ring, label position?
+   - Card patterns: same border-radius, shadow, padding?
+   - Border radius count: >3 distinct values = incoherent
+   - Shadow system: consistent elevation scale or random drops?
+
+5. INTERACTION DESIGN
+   - Hover states present and meaningful?
+   - Visible focus indicators for keyboard nav?
+   - Active/pressed feedback?
+   - Transition timing 150-300ms with appropriate easing?
+   - Loading states: skeleton, spinner, or content pop-in?
+
+6. VISUAL POLISH
+   - Pixel precision — anything off by 1px?
+   - Image quality on retina displays?
+   - Icon set consistency — all from one family or mixed?
+   - Empty/error states: designed or browser-default?

package/dist/design/audit/rubric/loader.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Rubric loader — reads markdown fragments with YAML frontmatter, composes
+ * a rubric from the set whose `applies-when` predicates match a classification.
+ *
+ * Adding a new rubric: drop a markdown file in `fragments/` (or in
+ * `~/.bad/rubrics/` for user fragments). No code changes required.
+ */
+import type { PageClassification, RubricFragment, ComposedRubric } from '../types.js';
+/**
+ * Parse a markdown fragment file into a RubricFragment.
+ * Frontmatter format:
+ *   ---
+ *   id: foo
+ *   title: Foo
+ *   weight: high
+ *   applies-when:
+ *     type: [marketing]
+ *     domain: [fintech]
+ *   ---
+ *   body markdown...
+ */
+export declare function parseFragment(filePath: string): RubricFragment;
+/**
+ * Load all fragments from a directory. Recursive subdirs ignored — fragments are flat.
+ */
+export declare function loadFragments(dir?: string): RubricFragment[];
+/**
+ * Predicate evaluator. Returns true if the fragment applies to the classification.
+ *
+ * Universal fragments always apply.
+ * Type/domain/maturity/designSystem predicates are AND-combined: all listed
+ * fields must match. Within a field, the classification value must be in the
+ * fragment's allowed set.
+ */
+export declare function fragmentApplies(fragment: RubricFragment, classification: PageClassification): boolean;
+/**
+ * Compose a rubric from a classification.
+ *
+ * @param classification - the page classification
+ * @param fragments - all loaded fragments (defaults to builtin)
+ * @param userFragmentsDir - optional path to user-supplied fragments
+ */
+export declare function composeRubric(classification: PageClassification, fragments?: RubricFragment[], userFragmentsDir?: string): ComposedRubric;
+/**
+ * Compose a rubric from an explicit profile name (for `--profile` override).
+ * Loads only the matching type fragment + universal fragments.
+ */
+export declare function composeRubricFromProfile(profile: string, fragmentsOverride?: RubricFragment[]): ComposedRubric;
+//# sourceMappingURL=loader.d.ts.map

package/dist/design/audit/rubric/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/rubric/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EAEf,MAAM,aAAa,CAAA;AAYpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAiB9D;AAkED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAA8B,GAAG,cAAc,EAAE,CAMnF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,kBAAkB,GACjC,OAAO,CA4BT;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,kBAAkB,EAClC,SAAS,CAAC,EAAE,cAAc,EAAE,EAC5B,gBAAgB,CAAC,EAAE,MAAM,GACxB,cAAc,CAgChB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,cAAc,EAAE,GACnC,cAAc,CAsBhB"}

package/dist/design/audit/rubric/loader.js

@@ -0,0 +1,216 @@
+/**
+ * Rubric loader — reads markdown fragments with YAML frontmatter, composes
+ * a rubric from the set whose `applies-when` predicates match a classification.
+ *
+ * Adding a new rubric: drop a markdown file in `fragments/` (or in
+ * `~/.bad/rubrics/` for user fragments). No code changes required.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const BUILTIN_FRAGMENTS_DIR = path.join(__dirname, 'fragments');
+const WEIGHT_ORDER = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+/**
+ * Parse a markdown fragment file into a RubricFragment.
+ * Frontmatter format:
+ *   ---
+ *   id: foo
+ *   title: Foo
+ *   weight: high
+ *   applies-when:
+ *     type: [marketing]
+ *     domain: [fintech]
+ *   ---
+ *   body markdown...
+ */
+export function parseFragment(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match) {
+        throw new Error(`fragment ${filePath} missing YAML frontmatter`);
+    }
+    const [, frontmatter, body] = match;
+    const meta = parseMinimalYaml(frontmatter);
+    return {
+        id: String(meta.id ?? path.basename(filePath, '.md')),
+        title: String(meta.title ?? meta.id ?? 'Untitled'),
+        weight: meta.weight ?? 'medium',
+        appliesWhen: meta['applies-when'] ?? {},
+        body: body.trim(),
+        ...(meta.dimension ? { dimension: String(meta.dimension) } : {}),
+    };
+}
+/**
+ * Minimal YAML parser — supports the subset our frontmatter uses:
+ *   key: value
+ *   key: [a, b, c]
+ *   key:
+ *     subkey: [a, b]
+ *
+ * Avoids pulling in a full YAML dep for ~50 lines of config.
+ */
+function parseMinimalYaml(text) {
+    const lines = text.split('\n');
+    const result = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line.trim() || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const topMatch = line.match(/^([a-zA-Z][\w-]*):\s*(.*)$/);
+        if (!topMatch) {
+            i++;
+            continue;
+        }
+        const [, key, valueRaw] = topMatch;
+        const value = valueRaw.trim();
+        if (value === '') {
+            // Nested object — collect indented lines
+            const nested = {};
+            i++;
+            while (i < lines.length && (lines[i].startsWith('  ') || lines[i].trim() === '')) {
+                if (!lines[i].trim()) {
+                    i++;
+                    continue;
+                }
+                const nm = lines[i].match(/^\s+([a-zA-Z][\w-]*):\s*(.*)$/);
+                if (nm) {
+                    nested[nm[1]] = parseScalarOrList(nm[2].trim());
+                }
+                i++;
+            }
+            result[key] = nested;
+        }
+        else {
+            result[key] = parseScalarOrList(value);
+            i++;
+        }
+    }
+    return result;
+}
+function parseScalarOrList(value) {
+    if (value.startsWith('[') && value.endsWith(']')) {
+        return value
+            .slice(1, -1)
+            .split(',')
+            .map(s => s.trim())
+            .filter(Boolean);
+    }
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    return value;
+}
+/**
+ * Load all fragments from a directory. Recursive subdirs ignored — fragments are flat.
+ */
+export function loadFragments(dir = BUILTIN_FRAGMENTS_DIR) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter(f => f.endsWith('.md'))
+        .map(f => parseFragment(path.join(dir, f)));
+}
+/**
+ * Predicate evaluator. Returns true if the fragment applies to the classification.
+ *
+ * Universal fragments always apply.
+ * Type/domain/maturity/designSystem predicates are AND-combined: all listed
+ * fields must match. Within a field, the classification value must be in the
+ * fragment's allowed set.
+ */
+export function fragmentApplies(fragment, classification) {
+    const w = fragment.appliesWhen;
+    if (w.universal)
+        return true;
+    if (w.type && w.type.length > 0) {
+        if (!w.type.includes(classification.type))
+            return false;
+    }
+    if (w.domain && w.domain.length > 0) {
+        const domainMatch = w.domain.some(d => classification.domain.toLowerCase().includes(d.toLowerCase()));
+        if (!domainMatch)
+            return false;
+    }
+    if (w.maturity && w.maturity.length > 0) {
+        if (!w.maturity.includes(classification.maturity))
+            return false;
+    }
+    if (w.designSystem && w.designSystem.length > 0) {
+        if (!w.designSystem.includes(classification.designSystem))
+            return false;
+    }
+    // If at least one predicate field was set and all matched, apply.
+    // If NO predicates were set and not universal, don't apply (be conservative).
+    const hasPredicate = !!w.type?.length ||
+        !!w.domain?.length ||
+        !!w.maturity?.length ||
+        !!w.designSystem?.length;
+    return hasPredicate;
+}
+/**
+ * Compose a rubric from a classification.
+ *
+ * @param classification - the page classification
+ * @param fragments - all loaded fragments (defaults to builtin)
+ * @param userFragmentsDir - optional path to user-supplied fragments
+ */
+export function composeRubric(classification, fragments, userFragmentsDir) {
+    const all = [
+        ...(fragments ?? loadFragments(BUILTIN_FRAGMENTS_DIR)),
+        ...(userFragmentsDir ? loadFragments(userFragmentsDir) : []),
+    ];
+    const matched = all
+        .filter(f => fragmentApplies(f, classification))
+        .sort((a, b) => WEIGHT_ORDER[a.weight] - WEIGHT_ORDER[b.weight]);
+    const body = matched
+        .map(f => `## ${f.title}\n\n${f.body}`)
+        .join('\n\n---\n\n');
+    // Calibration is the universal-calibration fragment if loaded; otherwise
+    // a sensible default.
+    const calFragment = matched.find(f => f.id === 'universal-calibration');
+    const calibration = calFragment?.body ??
+        'Score 1-10. Most production apps score 5-7. Only world-class deserves 8+. Be honest.';
+    // Custom dimensions contributed by fragments (deduped, preserves order)
+    const dimensions = Array.from(new Set(matched.map(f => f.dimension).filter((d) => Boolean(d))));
+    return {
+        fragments: matched,
+        body,
+        calibration,
+        dimensions,
+    };
+}
+/**
+ * Compose a rubric from an explicit profile name (for `--profile` override).
+ * Loads only the matching type fragment + universal fragments.
+ */
+export function composeRubricFromProfile(profile, fragmentsOverride) {
+    const all = fragmentsOverride ?? loadFragments(BUILTIN_FRAGMENTS_DIR);
+    const wanted = new Set([
+        `type-${profile}`,
+        'universal-foundation',
+        'universal-calibration',
+    ]);
+    const matched = all
+        .filter(f => wanted.has(f.id))
+        .sort((a, b) => WEIGHT_ORDER[a.weight] - WEIGHT_ORDER[b.weight]);
+    const body = matched.map(f => `## ${f.title}\n\n${f.body}`).join('\n\n---\n\n');
+    const calFragment = matched.find(f => f.id === 'universal-calibration');
+    const calibration = calFragment?.body ??
+        'Score 1-10. Most production apps score 5-7. Only world-class deserves 8+. Be honest.';
+    const dimensions = Array.from(new Set(matched.map(f => f.dimension).filter((d) => Boolean(d))));
+    return { fragments: matched, body, calibration, dimensions };
+}
+//# sourceMappingURL=loader.js.map

package/dist/design/audit/rubric/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../src/design/audit/rubric/loader.ts"],"names":[],"mappings":"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"}