design-brain-memory 0.2.0

package/README.md

@@ -0,0 +1,167 @@
+# design-brain-memory
+
+A relational markdown design brain that uses **Agent Browser CLI** for capture and supports **bring-your-own LLM** via base URL + API key.
+
+## What it does
+
+- Capture inspirations from URLs and screenshots.
+- Extract colors, typography, components, motion, layout, CSS variables.
+- Add responsive coverage via multiple viewports.
+- Capture interaction state signals (`hover`, `focus`, `active`) from runtime + CSS rules.
+- Capture journey steps by click-through exploration.
+- Build version lineage (`fingerprint`, `version`, `supersedes`, diffs).
+- Store everything in `.design-brain/` (markdown + graph CSV).
+- Query with `search` (keyword) and `ask` (semantic; optional LLM).
+
+## Install
+
+```bash
+npm install -g design-brain-memory
+agent-browser install
+```
+
+Install directly from GitHub:
+
+```bash
+npm install -g github:design-brain/design-brain
+```
+
+## Install as a skill
+
+```bash
+design-brain-memory install-skill
+```
+
+or
+
+```bash
+npx -y skills add design-brain/design-brain
+```
+
+`ingest` will also suggest this once in interactive terminals.
+
+## Bring your own LLM
+
+Set once:
+
+```bash
+export DESIGN_BRAIN_LLM_BASE_URL="https://api.openai.com/v1"
+export DESIGN_BRAIN_LLM_API_KEY="<your-api-key>"
+export DESIGN_BRAIN_LLM_MODEL="gpt-4o-mini"
+```
+
+Or pass per command:
+
+```bash
+--llm-base-url <url> --llm-api-key <key> --llm-model <model>
+```
+
+Any OpenAI-compatible endpoint works.
+
+## Commands
+
+### Initialize
+
+```bash
+design-brain-memory init --root /path/to/workspace
+```
+
+### Ingest URL inspiration
+
+```bash
+design-brain-memory ingest \
+  --project checkout-redesign \
+  --project-name "Checkout Redesign" \
+  --url https://stripe.com \
+  --name "Stripe checkout inspiration" \
+  --inspiration "Button hierarchy + neutral surfaces" \
+  --journey-steps 4 \
+  --viewport desktop=1440x1200 tablet=1024x1366 mobile=390x844 \
+  --tags payments,checkout,cta
+```
+
+### Ingest screenshot inspiration
+
+```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 "Shipped card-based checkout with clear primary CTA" \
+  --inspired-by inspo-stripe-checkout-1234abcd \
+  --artifact-url https://app.example.com/checkout \
+  --tags shipped,frontend
+```
+
+### Search
+
+```bash
+design-brain-memory search --query "button hierarchy" --project checkout-redesign
+```
+
+### Ask
+
+```bash
+design-brain-memory ask --query "What CTA patterns repeated across inspirations?" --project checkout-redesign
+```
+
+### Reindex
+
+```bash
+design-brain-memory reindex
+```
+
+### Prompt control
+
+Use `-y` / `--yes` to skip interactive prompts in local scripts and CI.
+
+## Output structure
+
+```
+.design-brain/
+├── README.md
+├── database.json
+├── graph/
+│   ├── entities.csv
+│   └── relations.csv
+├── assets/
+│   └── <project-id>/*.png
+└── projects/
+    └── <project-id>/
+        ├── README.md
+        ├── index.md
+        ├── inspirations/*.md
+        ├── outcomes/*.md
+        └── tokens/
+            ├── colors.md
+            ├── typography.md
+            ├── components.md
+            ├── motion.md
+            └── layout.md
+```
+
+## Retrieval examples
+
+```bash
+rg "supersedes|inspired_by" .design-brain/graph/relations.csv
+rg "Interaction States|Responsive Coverage" .design-brain/projects
+rg "fingerprint" .design-brain/projects/*/inspirations/*.md
+```
+
+## Notes
+
+- Browser usage follows Agent Browser CLI patterns from the upstream README (`open`, `set viewport`, `snapshot`, `click`, `hover`, `focus`, `eval`, `screenshot`, `back`, `close`).
+- If `agent-browser` is not globally installed, the CLI falls back to `npx agent-browser`.
+
+## Credits
+
+- Built on top of [Agent Browser CLI](https://github.com/vercel-labs/agent-browser) by Vercel Labs.

package/dist/agentBrowser.d.ts

@@ -0,0 +1,9 @@
+export interface AgentBrowserJsonResponse {
+    success: boolean;
+    data: Record<string, unknown>;
+    error: string | null;
+}
+export declare function runAgentBrowserJson(args: string[], options?: {
+    session?: string;
+    cwd?: string;
+}): Promise<AgentBrowserJsonResponse>;

package/dist/agentBrowser.js

@@ -0,0 +1,96 @@
+import { spawn, spawnSync } from 'node:child_process';
+let cachedRunner = null;
+function canExecute(command, args) {
+    const result = spawnSync(command, args, {
+        stdio: 'ignore',
+        env: {
+            ...process.env,
+            NPM_CONFIG_UPDATE_NOTIFIER: 'false',
+            npm_config_update_notifier: 'false',
+        },
+    });
+    return result.status === 0;
+}
+function resolveRunner() {
+    if (cachedRunner) {
+        return cachedRunner;
+    }
+    const fromEnv = process.env.DESIGN_BRAIN_AGENT_BROWSER_BIN;
+    if (fromEnv && canExecute(fromEnv, ['--version'])) {
+        cachedRunner = { command: fromEnv, prefixArgs: [] };
+        return cachedRunner;
+    }
+    if (canExecute('agent-browser', ['--version'])) {
+        cachedRunner = { command: 'agent-browser', prefixArgs: [] };
+        return cachedRunner;
+    }
+    cachedRunner = { command: 'npx', prefixArgs: ['--yes', 'agent-browser'] };
+    return cachedRunner;
+}
+function parseJsonFromOutput(stdout) {
+    const lines = stdout
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+        const line = lines[i];
+        if (!line.startsWith('{') || !line.endsWith('}')) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            if (typeof parsed.success === 'boolean') {
+                return parsed;
+            }
+        }
+        catch {
+            // keep searching
+        }
+    }
+    throw new Error(`Failed to parse Agent Browser JSON response. Output:\n${stdout}`);
+}
+export async function runAgentBrowserJson(args, options = {}) {
+    const runner = resolveRunner();
+    const finalArgs = [
+        ...runner.prefixArgs,
+        ...(options.session ? ['--session', options.session] : []),
+        '--json',
+        ...args,
+    ];
+    return new Promise((resolve, reject) => {
+        const child = spawn(runner.command, finalArgs, {
+            cwd: options.cwd,
+            env: {
+                ...process.env,
+                NPM_CONFIG_UPDATE_NOTIFIER: 'false',
+                npm_config_update_notifier: 'false',
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (error) => {
+            reject(error);
+        });
+        child.on('close', (code) => {
+            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));
+            }
+        });
+    });
+}
+//# sourceMappingURL=agentBrowser.js.map

package/dist/agentBrowser.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { Command } from 'commander';
+import { askBrain, initBrain, ingestInspiration, recordOutcome, reindexBrain, searchBrain, } from './commands.js';
+import { shouldSkipPrompts } from './interactive.js';
+import { resolveLlmConfig } from './llm.js';
+import { getDefaultSkillRepo, installSkill, maybePromptSkillInstall } from './skillPrompt.js';
+function toStringList(value) {
+    if (!value) {
+        return [];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => item.split(',')).map((item) => item.trim()).filter(Boolean);
+    }
+    return value.split(',').map((item) => item.trim()).filter(Boolean);
+}
+function parseInteger(value, defaultValue) {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : defaultValue;
+}
+function parseViewports(values) {
+    if (!values || values.length === 0) {
+        return undefined;
+    }
+    const parsed = values
+        .flatMap((value) => value.split(','))
+        .map((item) => item.trim())
+        .filter(Boolean)
+        .map((item, index) => {
+        const [label, size] = item.includes('=') ? item.split('=') : [`vp${index + 1}`, item];
+        const [widthRaw, heightRaw] = size.split('x');
+        const width = Number.parseInt(widthRaw, 10);
+        const height = Number.parseInt(heightRaw, 10);
+        if (!Number.isFinite(width) || !Number.isFinite(height)) {
+            throw new Error(`Invalid viewport format: ${item}. Use label=1440x1200.`);
+        }
+        return { label: label.trim(), width, height };
+    });
+    return parsed.length > 0 ? parsed : undefined;
+}
+async function main() {
+    const program = new Command();
+    program
+        .name('design-brain-memory')
+        .description('Relational markdown design memory powered by Agent Browser CLI')
+        .version('0.2.0')
+        .option('-y, --yes', 'Skip interactive prompts');
+    program
+        .command('init')
+        .description('Initialize .design-brain in the given workspace')
+        .option('--root <dir>', 'Workspace root', process.cwd())
+        .action(async (options) => {
+        await initBrain(path.resolve(options.root));
+        console.log(`Initialized design brain at ${path.resolve(options.root, '.design-brain')}`);
+    });
+    program
+        .command('ingest')
+        .description('Ingest a URL or screenshot into a project design wiki')
+        .requiredOption('--project <project>', 'Project ID/slug')
+        .option('--project-name <name>', 'Readable project name')
+        .option('--project-description <text>', 'Project description shown in the wiki')
+        .option('--url <url>', 'Website URL inspiration source')
+        .option('--screenshot <path>', 'Local screenshot inspiration source')
+        .option('--name <name>', 'Record name')
+        .option('--notes <notes>', 'Freeform notes about why it matters')
+        .option('--inspiration <text>', 'Summary of what this source inspired')
+        .option('--tags <tags...>', 'Tags list (repeat or comma-separated)')
+        .option('--journey-steps <n>', 'How many click-through journey steps to capture', '3')
+        .option('--viewport <viewports...>', 'Responsive viewports: desktop=1440x1200,mobile=390x844')
+        .option('--llm-base-url <url>', 'OpenAI-compatible LLM base URL')
+        .option('--llm-api-key <key>', 'LLM API key')
+        .option('--llm-model <model>', 'LLM model id')
+        .option('--llm-timeout-ms <ms>', 'LLM timeout in milliseconds', '30000')
+        .option('--root <dir>', 'Workspace root', process.cwd())
+        .option('--no-visuals', 'Skip SVG visual generation')
+        .action(async (options) => {
+        const llm = resolveLlmConfig({
+            baseUrl: options.llmBaseUrl,
+            apiKey: options.llmApiKey,
+            model: options.llmModel,
+            timeoutMs: parseInteger(options.llmTimeoutMs, 30000),
+        });
+        const result = await ingestInspiration({
+            rootDir: path.resolve(options.root),
+            project: options.project,
+            projectName: options.projectName,
+            projectDescription: options.projectDescription,
+            url: options.url,
+            screenshot: options.screenshot,
+            name: options.name,
+            notes: options.notes,
+            inspirationSummary: options.inspiration,
+            tags: toStringList(options.tags),
+            llm,
+            journeySteps: parseInteger(options.journeySteps, 3),
+            responsiveViewports: parseViewports(options.viewport),
+            skipVisuals: !options.visuals,
+        });
+        console.log(`Captured inspiration ${result.inspirationId} in project ${result.projectId}`);
+        const globalOptions = program.opts();
+        await maybePromptSkillInstall(shouldSkipPrompts(Boolean(globalOptions.yes)));
+    });
+    program
+        .command('outcome')
+        .description('Record what the team built and link it to inspirations')
+        .requiredOption('--project <project>', 'Project ID/slug')
+        .requiredOption('--title <title>', 'Outcome title')
+        .requiredOption('--description <description>', 'Outcome description')
+        .option('--artifact-url <url>', 'Deployed link, Figma link, or PR URL')
+        .option('--inspired-by <ids...>', 'Linked inspiration IDs')
+        .option('--tags <tags...>', 'Tags list (repeat or comma-separated)')
+        .option('--root <dir>', 'Workspace root', process.cwd())
+        .action(async (options) => {
+        const result = await recordOutcome({
+            rootDir: path.resolve(options.root),
+            project: options.project,
+            title: options.title,
+            description: options.description,
+            inspiredBy: toStringList(options.inspiredBy),
+            artifactUrl: options.artifactUrl,
+            tags: toStringList(options.tags),
+        });
+        console.log(`Recorded outcome ${result.outcomeId} in project ${result.projectId}`);
+    });
+    program
+        .command('search')
+        .description('Keyword search over relational design memory')
+        .requiredOption('--query <text>', 'Search query')
+        .option('--project <project>', 'Filter to project')
+        .option('--limit <n>', 'Max results', '10')
+        .option('--json', 'Output as JSON', false)
+        .option('--root <dir>', 'Workspace root', process.cwd())
+        .action(async (options) => {
+        const results = await searchBrain({
+            rootDir: path.resolve(options.root),
+            query: options.query,
+            project: options.project,
+            limit: parseInteger(options.limit, 10),
+        });
+        if (options.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        if (results.length === 0) {
+            console.log('No matches found.');
+            return;
+        }
+        for (const result of results) {
+            console.log(`[${result.type}] ${result.projectId}/${result.id} :: ${result.title} (score=${result.score})`);
+            console.log(`  ${result.snippet}`);
+        }
+    });
+    program
+        .command('ask')
+        .description('Ask a design question against the design brain')
+        .requiredOption('--query <text>', 'Question')
+        .option('--project <project>', 'Filter to project')
+        .option('--limit <n>', 'Context result count', '8')
+        .option('--llm-base-url <url>', 'OpenAI-compatible LLM base URL')
+        .option('--llm-api-key <key>', 'LLM API key')
+        .option('--llm-model <model>', 'LLM model id')
+        .option('--llm-timeout-ms <ms>', 'LLM timeout in milliseconds', '30000')
+        .option('--root <dir>', 'Workspace root', process.cwd())
+        .action(async (options) => {
+        const llm = resolveLlmConfig({
+            baseUrl: options.llmBaseUrl,
+            apiKey: options.llmApiKey,
+            model: options.llmModel,
+            timeoutMs: parseInteger(options.llmTimeoutMs, 30000),
+        });
+        const result = await askBrain({
+            rootDir: path.resolve(options.root),
+            query: options.query,
+            project: options.project,
+            limit: parseInteger(options.limit, 8),
+            llm,
+        });
+        console.log(result.answer);
+        if (result.matches.length > 0) {
+            console.log('\nSources:');
+            for (const match of result.matches.slice(0, 8)) {
+                console.log(`- [${match.type}] ${match.projectId}/${match.id}: ${match.title}`);
+            }
+        }
+    });
+    program
+        .command('install-skill')
+        .description('Install Design Brain skill into your local skills registry')
+        .option('--repo <repo>', 'Skill repository override', getDefaultSkillRepo())
+        .action(async (options) => {
+        const installed = installSkill(options.repo);
+        if (!installed) {
+            throw new Error(`Skill install failed. Try manually: npx -y skills add ${options.repo}`);
+        }
+        console.log(`Installed skill from ${options.repo}`);
+    });
+    program
+        .command('reindex')
+        .description('Regenerate markdown wiki and relation graph from database.json')
+        .option('--root <dir>', 'Workspace root', process.cwd())
+        .option('--no-visuals', 'Skip SVG visual generation')
+        .action(async (options) => {
+        await reindexBrain(path.resolve(options.root), !options.visuals);
+        console.log(`Reindexed ${path.resolve(options.root, '.design-brain')}`);
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,27 @@
+import type { IngestOptions, LlmConfig, OutcomeOptions } from './types.js';
+export declare function initBrain(rootDir: string): Promise<void>;
+export declare function ingestInspiration(options: IngestOptions): Promise<{
+    projectId: string;
+    inspirationId: string;
+}>;
+export declare function recordOutcome(options: OutcomeOptions): Promise<{
+    projectId: string;
+    outcomeId: string;
+}>;
+export declare function reindexBrain(rootDir: string, skipVisuals?: boolean): Promise<void>;
+export declare function searchBrain(params: {
+    rootDir: string;
+    query: string;
+    project?: string;
+    limit?: number;
+}): Promise<import("./query.js").SearchResult[]>;
+export declare function askBrain(params: {
+    rootDir: string;
+    query: string;
+    project?: string;
+    limit?: number;
+    llm?: LlmConfig;
+}): Promise<{
+    answer: string;
+    matches: import("./query.js").SearchResult[];
+}>;