design-brain-memory 0.9.3 → 0.9.5

package/README.md

@@ -0,0 +1,273 @@
+# design-brain-memory
+
+A persistent design knowledge system that captures inspiration from websites and screenshots, extracts reusable patterns, and builds a grep-friendly markdown knowledge graph.
+
+Built on [Agent Browser CLI](https://github.com/vercel-labs/agent-browser) for headless capture. No external LLM required — bring your own optionally for semantic enrichment.
+
+## Features
+
+- **Capture** — Extract colors, typography, components, motion, layout, and CSS variables from any URL or screenshot
+- **Knowledge system** — Three-space architecture (self / notes / ops) with pattern, decision, and principle notes
+- **Processing pipeline** — Extract → Synthesize → Evolve → Verify with queue tracking
+- **Tailwind export** — Generate `tailwind.config.js` from captured design tokens with auto-named colors from CSS variables
+- **Visual catalog** — SVG palette, component, typography, and layout visualizations per capture
+- **Component isolation** — Grouped JSON tokens by component kind (button, card, navigation, etc.)
+- **Version lineage** — Fingerprint-based versioning with diffs between captures
+- **Responsive coverage** — Capture at multiple viewports in a single pass
+- **Interaction states** — Hover, focus, and active state extraction from runtime CSS
+- **Journey capture** — Click-through exploration with per-step snapshots
+- **Ripgrep-friendly** — Flat markdown files with YAML frontmatter, wiki links, and CSV relation graph
+
+## Install
+
+```bash
+npm install -g design-brain-memory
+agent-browser install
+```
+
+## Quick Start
+
+```bash
+# Initialize the knowledge system
+design-brain-memory init --root .
+
+# Capture a website
+design-brain-memory ingest \
+  --project my-project \
+  --url https://stripe.com \
+  --name "Stripe Homepage" \
+  --tags fintech,payments
+
+# Search with ripgrep
+rg "button|card" .design-brain/notes/patterns/
+rg "#533AFD" .design-brain/
+
+# Or use the built-in search
+design-brain-memory search --query "button hierarchy"
+
+# Export Tailwind config
+design-brain-memory export --project my-project --format tailwind
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Create `.design-brain/` with knowledge system directories |
+| `ingest` | Capture inspiration from a URL or screenshot |
+| `outcome` | Record a design outcome linked to inspirations |
+| `search` | Keyword search across the brain |
+| `ask` | Semantic search (requires LLM config) |
+| `install-skill` | Install the Design Brain coding-agent skill |
+| `reindex` | Regenerate markdown, visuals, and relation graph from `database.json` |
+| `export` | Export tokens (`tailwind`, `style-dictionary`, or `css-in-js`) |
+| `compare` | Compare two captures or version diff |
+| `batch` | Batch capture from a URL list file |
+| `moodboard` | Generate HTML + PNG visual moodboard |
+| `trends` | Detect design trends across captures |
+| `scorecard` | Audit codebase against captured design tokens |
+| `component-graph` | Generate component relationship graph for a project |
+| `review` | Generate design review checklist from captures and optional code scan |
+| `name-tokens` | Preview human-readable token names |
+| `wiki` | Generate wiki pages with project and shared context |
+| `graph` | Generate interactive knowledge graph HTML |
+| `context` | Generate AI-consumable context file (Claude/Cursor) |
+| `writing-style` | Analyze writing style patterns from captures |
+| `system-diff` | Diff design systems across projects or over time |
+| `taste` | Build a taste profile from multiple URLs/domains |
+
+### Ingest
+
+```bash
+design-brain-memory ingest \
+  --project checkout-redesign \
+  --project-name "Checkout Redesign" \
+  --url https://stripe.com \
+  --name "Stripe checkout inspiration" \
+  --tags payments,checkout,cta \
+  --journey-steps 4 \
+  --viewport desktop=1440x1200 tablet=1024x1366 mobile=390x844
+```
+
+From a screenshot:
+
+```bash
+design-brain-memory ingest \
+  --project checkout-redesign \
+  --screenshot ./screens/inspo-hero.png \
+  --name "Hero screenshot" \
+  --tags hero,landing
+```
+
+### Record Outcome
+
+```bash
+design-brain-memory outcome \
+  --project checkout-redesign \
+  --title "v1 shipped" \
+  --description "Card-based checkout with clear primary CTA" \
+  --inspired-by inspo-stripe-checkout-1234abcd \
+  --tags shipped,frontend
+```
+
+## Knowledge System
+
+The brain organizes knowledge across five spaces:
+
+```
+.design-brain/
+├── self/                          # Agent identity and methodology
+│   ├── identity.md
+│   └── methodology.md
+├── notes/                         # Knowledge graph
+│   ├── patterns/*.md              # Reusable design patterns
+│   ├── decisions/*.md             # Design decisions with rationale
+│   ├── principles/*.md            # Cross-project principles
+│   └── mocs/                      # Maps of Content
+│       ├── hub.md
+│       ├── color-systems.md
+│       ├── typography.md
+│       ├── components.md
+│       ├── layout.md
+│       ├── motion.md
+│       └── brand.md
+├── ops/                           # Operations
+│   ├── queue/*.yaml               # Processing pipeline queue
+│   ├── sessions/*.md              # Session activity logs
+│   └── maintenance.md             # Health signals
+├── projects/                      # Raw captures
+│   └── <project>/
+│       ├── README.md
+│       ├── inspirations/*.md
+│       ├── outcomes/*.md
+│       ├── tokens/                # Aggregated design tokens
+│       ├── visuals/*.svg          # SVG visual catalog
+│       └── tailwind.config.js     # Generated Tailwind config
+└── graph/                         # Relation graph
+    ├── entities.csv
+    └── relations.csv
+```
+
+### Note Schema
+
+All notes use YAML frontmatter:
+
+```yaml
+---
+type: pattern | decision | principle
+title: "Descriptive title"
+sources: ["[[inspo-id]]"]
+domains: [web, brand, mobile, design-systems]
+tags: [relevant, tags]
+confidence: emerging | established | canonical
+created: 2026-02-18
+updated: 2026-02-18
+---
+```
+
+### Processing Pipeline
+
+```
+Capture → Extract → Synthesize → Evolve → Verify
+```
+
+1. **Capture** — Ingest inspiration, create queue entry
+2. **Extract** — Generate pattern and decision notes from capture data
+3. **Synthesize** — Find connections, add wiki links, update MOCs
+4. **Evolve** — Update older notes with new evidence, upgrade confidence
+5. **Verify** — Check schema compliance, link health, MOC coverage
+
+## Retrieval
+
+Designed for ripgrep:
+
+```bash
+# Find patterns by keyword
+rg "button|card|navigation" .design-brain/notes/patterns/
+
+# Find canonical patterns
+rg "confidence: canonical" .design-brain/notes/
+
+# Search by color hex
+rg "#533AFD" .design-brain/
+
+# Query the relation graph
+rg "has_inspiration|inspired_by" .design-brain/graph/relations.csv
+
+# Find notes linked to a specific capture
+rg "inspo-stripe" .design-brain/notes/
+```
+
+## Claude Code Plugin
+
+design-brain ships as a Claude Code plugin with slash commands and hooks:
+Current plugin command coverage includes:
+
+| Command | Description |
+|---------|-------------|
+| `/db-capture` | Capture inspiration from URL or screenshot |
+| `/db-extract` | Extract patterns and decisions from captures |
+| `/db-synthesize` | Find connections, update MOCs |
+| `/db-evolve` | Backward pass — update older notes |
+| `/db-verify` | Schema and link health check |
+| `/db-pipeline` | Run all pipeline phases |
+| `/db-next` | Show next pending queue item |
+| `/db-search` | Ripgrep search across the brain |
+| `/db-ask` | Ask semantic design questions with cited sources |
+| `/db-stats` | Vault metrics and health report |
+| `/db-export` | Export tokens (Tailwind, Style Dictionary, CSS-in-JS) |
+| `/db-compare` | Compare two captures or version diff |
+| `/db-batch` | Batch capture from URL list file |
+| `/db-moodboard` | Generate visual moodboard |
+| `/db-trends` | Detect design trends across captures |
+| `/db-scorecard` | Audit codebase against captured tokens |
+| `/db-component-graph` | Generate component relationship graph |
+| `/db-review` | Generate design review checklist |
+| `/db-name-tokens` | Preview semantic token names |
+| `/db-system-diff` | Diff systems over time or across projects |
+| `/db-context` | Generate AI-ready context markdown |
+| `/db-wiki` | Generate project + shared wiki pages |
+| `/db-graph` | Generate interactive graph visualization |
+| `/db-writing-style` | Analyze UI writing style patterns |
+| `/db-taste` | Build a taste profile from multiple inspirations |
+
+### Hooks
+
+| Event | Action |
+|-------|--------|
+| SessionStart | Load identity context, queue status, maintenance signals |
+| PostToolUse (Write) | Validate note frontmatter schema |
+| Stop | Log session activity summary |
+
+## Optional: LLM Enrichment
+
+For semantic search and richer capture summaries, configure any OpenAI-compatible endpoint:
+
+```bash
+export DESIGN_BRAIN_LLM_BASE_URL="https://api.openai.com/v1"
+export DESIGN_BRAIN_LLM_API_KEY="<your-key>"
+export DESIGN_BRAIN_LLM_MODEL="gpt-4o-mini"
+```
+
+Or pass per command: `--llm-base-url <url> --llm-api-key <key> --llm-model <model>`
+
+Not required for core functionality.
+
+## Packaging & Publish
+
+```bash
+npm login --auth-type=web
+npm run release:check
+npm publish --access public
+```
+
+`release:check` runs a clean build, tests, and `npm pack --dry-run` to verify publish contents.
+
+## Requirements
+
+- Node.js 20+
+- [Agent Browser CLI](https://github.com/vercel-labs/agent-browser) (`agent-browser install`)
+
+## License
+
+MIT

package/dist/agentBrowser.d.ts

@@ -7,5 +7,4 @@ export declare function runAgentBrowserJson(args: string[], options?: {
     session?: string;
     cwd?: string;
     headed?: boolean;
-    timeoutMs?: number;
 }): Promise<AgentBrowserJsonResponse>;

package/dist/agentBrowser.js

@@ -49,20 +49,16 @@ function parseJsonFromOutput(stdout) {
     }
     throw new Error(`Failed to parse Agent Browser JSON response. Output:\n${stdout}`);
 }
-const DEFAULT_TIMEOUT_MS = 60_000;
 export async function runAgentBrowserJson(args, options = {}) {
     const runner = resolveRunner();
-    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const finalArgs = [
         ...runner.prefixArgs,
-        ...(options.session ? ['--session', options.session] : []),
         ...(options.headed ? ['--headed'] : []),
+        ...(options.session ? ['--session', options.session] : []),
         '--json',
         ...args,
     ];
     return new Promise((resolve, reject) => {
-        let settled = false;
-        let timer;
         const child = spawn(runner.command, finalArgs, {
             cwd: options.cwd,
             env: {
@@ -74,18 +70,6 @@ export async function runAgentBrowserJson(args, options = {}) {
         });
         let stdout = '';
         let stderr = '';
-        function settle(fn) {
-            if (settled)
-                return;
-            settled = true;
-            if (timer)
-                clearTimeout(timer);
-            fn();
-        }
-        timer = setTimeout(() => {
-            child.kill('SIGKILL');
-            settle(() => reject(new Error(`agent-browser timed out after ${timeoutMs}ms: ${args.join(' ')}`)));
-        }, timeoutMs);
         child.stdout.on('data', (chunk) => {
             stdout += chunk.toString();
         });
@@ -93,22 +77,20 @@ export async function runAgentBrowserJson(args, options = {}) {
             stderr += chunk.toString();
         });
         child.on('error', (error) => {
-            settle(() => reject(error));
+            reject(error);
         });
         child.on('close', (code) => {
-            settle(() => {
-                if (code !== 0) {
-                    reject(new Error(`agent-browser command failed (${code}): ${stderr || stdout}`));
-                    return;
-                }
-                try {
-                    resolve(parseJsonFromOutput(stdout));
-                }
-                catch (error) {
-                    const details = stderr ? `${error.message}\n${stderr}` : error.message;
-                    reject(new Error(details));
-                }
-            });
+            if (code !== 0) {
+                reject(new Error(`agent-browser command failed (${code}): ${stderr || stdout}`));
+                return;
+            }
+            try {
+                resolve(parseJsonFromOutput(stdout));
+            }
+            catch (error) {
+                const details = stderr ? `${error.message}\n${stderr}` : error.message;
+                reject(new Error(details));
+            }
         });
     });
 }

package/dist/agentBrowser.js.map

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

package/dist/aggregate.d.ts

@@ -0,0 +1,9 @@
+import type { ColorToken, ComponentToken, InspirationRecord, MotionToken, TypographyToken } from './types.js';
+export declare function aggregateColors(records: InspirationRecord[]): ColorToken[];
+export declare function aggregateTypography(records: InspirationRecord[]): TypographyToken[];
+export declare function aggregateComponents(records: InspirationRecord[]): Array<ComponentToken & {
+    count: number;
+}>;
+export declare function aggregateMotion(records: InspirationRecord[]): Array<MotionToken & {
+    count: number;
+}>;

package/dist/aggregate.js

@@ -0,0 +1,53 @@
+export function aggregateColors(records) {
+    const map = new Map();
+    for (const record of records) {
+        for (const color of record.analysis.colors) {
+            const existing = map.get(color.hex) ?? { hex: color.hex, count: 0, samples: [] };
+            existing.count += color.count;
+            for (const sample of color.samples) {
+                if (existing.samples.length < 6 && !existing.samples.includes(sample)) {
+                    existing.samples.push(sample);
+                }
+            }
+            map.set(color.hex, existing);
+        }
+    }
+    return [...map.values()].sort((a, b) => b.count - a.count).slice(0, 40);
+}
+export function aggregateTypography(records) {
+    const map = new Map();
+    for (const record of records) {
+        for (const token of record.analysis.typography) {
+            const key = `${token.fontFamily}|${token.fontSize}|${token.fontWeight}|${token.lineHeight}`;
+            const existing = map.get(key) ?? { ...token, count: 0 };
+            existing.count += token.count;
+            map.set(key, existing);
+        }
+    }
+    return [...map.values()].sort((a, b) => b.count - a.count).slice(0, 60);
+}
+export function aggregateComponents(records) {
+    const map = new Map();
+    for (const record of records) {
+        for (const token of record.analysis.components) {
+            const key = `${token.kind}|${token.tag}|${token.selector}`;
+            const existing = map.get(key) ?? { ...token, count: 0 };
+            existing.count += 1;
+            map.set(key, existing);
+        }
+    }
+    return [...map.values()].sort((a, b) => b.count - a.count).slice(0, 120);
+}
+export function aggregateMotion(records) {
+    const map = new Map();
+    for (const record of records) {
+        for (const token of record.analysis.motion) {
+            const key = `${token.selector}|${token.transition}|${token.animation}|${token.transform}`;
+            const existing = map.get(key) ?? { ...token, count: 0 };
+            existing.count += 1;
+            map.set(key, existing);
+        }
+    }
+    return [...map.values()].sort((a, b) => b.count - a.count).slice(0, 140);
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/aggregate.js.map

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

package/dist/batch.d.ts

@@ -0,0 +1,16 @@
+export interface BatchEntry {
+    url: string;
+    name?: string;
+    tags: string[];
+}
+export declare function parseBatchFile(content: string): BatchEntry[];
+export declare function batchCapture(params: {
+    rootDir: string;
+    project: string;
+    filePath: string;
+    skipVisuals: boolean;
+}): Promise<{
+    total: number;
+    succeeded: number;
+    failed: string[];
+}>;

package/dist/batch.js

@@ -0,0 +1,44 @@
+import fs from 'fs-extra';
+import { ingestInspiration } from './commands.js';
+export function parseBatchFile(content) {
+    return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith('#'))
+        .map((line) => {
+        const parts = line.split('\t');
+        const url = parts[0].trim();
+        const name = parts[1]?.trim() || undefined;
+        const tags = parts[2] ? parts[2].split(',').map((t) => t.trim()).filter(Boolean) : [];
+        return { url, name, tags };
+    });
+}
+export async function batchCapture(params) {
+    const content = await fs.readFile(params.filePath, 'utf-8');
+    const entries = parseBatchFile(content);
+    const failed = [];
+    let succeeded = 0;
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        const label = entry.name || entry.url;
+        console.log(`[${i + 1}/${entries.length}] Capturing ${label}...`);
+        try {
+            await ingestInspiration({
+                rootDir: params.rootDir,
+                project: params.project,
+                url: entry.url,
+                name: entry.name,
+                tags: entry.tags,
+                skipVisuals: params.skipVisuals,
+            });
+            succeeded++;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(`  Failed: ${msg}`);
+            failed.push(entry.url);
+        }
+    }
+    return { total: entries.length, succeeded, failed };
+}
+//# sourceMappingURL=batch.js.map

package/dist/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../src/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQlD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAC1D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAKlC;IACC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,eAAe,KAAK,KAAK,CAAC,CAAC;QAElE,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC;gBACtB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;YACH,SAAS,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC"}