zugzbot 1.0.21 → 1.0.22

package/.opencode/oh-my-design/packages/mcp/README.md

@@ -1,172 +0,0 @@
-# oh-my-design-mcp
-
-**Drop-in MCP server. 107 brand design systems. Zero AI calls. Free & open.**
-
-Give your coding agent (Claude Desktop, Cursor, Cline, Continue, Codex) instant access to a curated catalog of 107 brand DESIGN.md files — Toss, Stripe, Linear, Apple, Airbnb, Coupang, and 100 more — exposed as MCP resources, tools, and prompts.
-
-- **Local-only.** All data ships inside the npm tarball. No network calls at runtime. No API keys. No telemetry.
-- **Deterministic.** Tools are pure file reads + keyword search. Same input, same output.
-- **Drop-in.** One JSON snippet per IDE. `npx -y oh-my-design-mcp` and you're done.
-
-> Companion to the [oh-my-design](https://github.com/kwakseongjae/oh-my-design) CLI / skill suite. This server is the read-side; the CLI is the author-side.
-
----
-
-## Install
-
-### Claude Desktop
-
-Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
-
-```json
-{
-  "mcpServers": {
-    "oh-my-design": {
-      "command": "npx",
-      "args": ["-y", "oh-my-design-mcp"]
-    }
-  }
-}
-```
-
-Restart Claude Desktop. You should see `oh-my-design` in the MCP server list with 3 tools and 107 resources.
-
-### Cursor
-
-Edit `~/.cursor/mcp.json` (or use Settings → MCP):
-
-```json
-{
-  "mcpServers": {
-    "oh-my-design": {
-      "command": "npx",
-      "args": ["-y", "oh-my-design-mcp"]
-    }
-  }
-}
-```
-
-### Cline (VS Code extension)
-
-Open Cline settings → MCP Servers → Edit MCP Settings → add:
-
-```json
-{
-  "mcpServers": {
-    "oh-my-design": {
-      "command": "npx",
-      "args": ["-y", "oh-my-design-mcp"],
-      "disabled": false,
-      "autoApprove": ["list_references", "get_design_md", "search_by_vibe"]
-    }
-  }
-}
-```
-
-### Continue
-
-Edit `~/.continue/config.yaml`:
-
-```yaml
-mcpServers:
-  - name: oh-my-design
-    command: npx
-    args:
-      - "-y"
-      - "oh-my-design-mcp"
-```
-
-### Codex (OpenAI Codex CLI)
-
-Edit `~/.codex/config.toml`:
-
-```toml
-[mcp_servers.oh-my-design]
-command = "npx"
-args = ["-y", "oh-my-design-mcp"]
-```
-
-### Manual / debugging
-
-```bash
-npx -y oh-my-design-mcp --help
-npx -y oh-my-design-mcp --version
-npx -y oh-my-design-mcp           # starts stdio server, waits for JSON-RPC on stdin
-```
-
----
-
-## What it exposes
-
-### Tools
-
-| Tool              | Input                                                | Returns                                                          |
-| ----------------- | ---------------------------------------------------- | ---------------------------------------------------------------- |
-| `list_references` | `{ country?, category?, has_official_ds? }`          | `{ count, references: [{ id, name, displayName, country, category, primaryColor, hasOfficialDs }] }` |
-| `get_design_md`   | `{ id }`                                             | `{ id, frontmatter, content, sections }`                         |
-| `search_by_vibe`  | `{ description, limit? }`                            | `{ query, count, matches: [{ id, name, score, reasoning }] }`    |
-
-### Resources
-
-107 brand DESIGN.md files exposed at `design://<id>` — e.g. `design://toss`, `design://stripe`, `design://linear`, `design://apple`. Each resource is `text/markdown` and contains the canonical 15-section spec (Visual Theme, Color Palette, Typography, Components, …, Voice & Tone, Personas, Motion).
-
-### Prompts
-
-| Prompt            | Args                  | Effect                                                                                                |
-| ----------------- | --------------------- | ----------------------------------------------------------------------------------------------------- |
-| `design_from_ref` | `{ refId, task }`     | Returns a primed message instructing the agent to build `task` in the visual + verbal style of `refId`. Injects Visual Theme, Color, Typography, and Voice sections. |
-
----
-
-## Examples
-
-**1. Build something in a brand's style**
-
-> You: "Build a pricing page that looks like Toss."
->
-> Agent: *(calls `get_design_md` with `id="toss"`, reads the Color Palette + Typography + Components sections, then writes the page using `#3182f6` as the accent, Toss Product Sans for headings, and Toss's documented card patterns.)*
-
-**2. Discover by vibe**
-
-> You: "I want something that feels like a calm B2B fintech dashboard. Show me 3 options."
->
-> Agent: *(calls `search_by_vibe` with `description="calm B2B fintech dashboard", limit=3`, returns ranked matches like Toss, Stripe, Banksalad with reasoning, then asks which to use.)*
-
-**3. Audit / extract tokens**
-
-> You: "Pull Stripe's color tokens and motion principles into a JSON config for our app."
->
-> Agent: *(calls `get_design_md` with `id="stripe"`, parses the Color Palette and Motion sections, emits structured JSON.)*
-
----
-
-## How it compares
-
-| Feature                  | oh-my-design-mcp     | Refero MCP                       | Static GitHub collection   |
-| ------------------------ | -------------------- | -------------------------------- | -------------------------- |
-| Cost                     | **Free, MIT**        | Paid subscription                | Free                       |
-| Catalog                  | 107 curated brands   | 130k screens                     | Varies                     |
-| Format                   | Canonical DESIGN.md  | Screen images + metadata         | Raw / inconsistent         |
-| Runtime network          | **None**             | Required (API calls)             | None                       |
-| API keys                 | **None**             | Required                         | None                       |
-| Vibe search              | Keyword (deterministic) | Embedding-based                 | None                       |
-| Drop-in install          | `npx -y` one snippet | Account + key setup              | Manual clone / copy        |
-| Token tagging / sections | Yes (15 sections)    | Image-level only                 | Inconsistent               |
-
-We trade catalog breadth for **bundled, deterministic, offline access to a hand-curated, structured spec per brand.** Best paired with embedding-based image search (Refero) when you want both.
-
----
-
-## Roadmap
-
-- **v0.2** — embedding-based `search_by_vibe` (still local, using a small bundled model) + `extract_tokens` tool returning JSON token sets.
-- **v0.3** — additional resources for component examples + Figma-token export.
-- Bundled catalog grows with the upstream [oh-my-design](https://github.com/kwakseongjae/oh-my-design) repo.
-
----
-
-## License & credits
-
-MIT. © oh-my-design contributors. Brand names, logos, and DESIGN.md descriptions reference each brand's publicly published design system; usage as inspiration / interoperability per nominative fair use. File an issue to request removal of any brand.
-
-Source: <https://github.com/kwakseongjae/oh-my-design/tree/main/packages/mcp>

package/.opencode/oh-my-design/packages/mcp/__tests__/smoke.test.ts

@@ -1,64 +0,0 @@
-import { describe, it, expect, beforeAll } from 'vitest';
-import { loadAllReferences, getReference } from '../src/data.js';
-import { runListReferences } from '../src/tools/list-references.js';
-import { runGetDesignMd } from '../src/tools/get-design-md.js';
-import { runSearchByVibe } from '../src/tools/search-by-vibe.js';
-import { buildDesignFromRefPrompt } from '../src/prompts/design-from-ref.js';
-import { createServer } from '../src/server.js';
-
-describe('oh-my-design-mcp smoke', () => {
-  beforeAll(() => {
-    const refs = loadAllReferences();
-    if (refs.size === 0) {
-      throw new Error(
-        'data/references is empty — run `npm run sync-data` before tests',
-      );
-    }
-  });
-
-  it('loads bundled references', () => {
-    const refs = loadAllReferences();
-    expect(refs.size).toBeGreaterThanOrEqual(100);
-  });
-
-  it('list_references returns all + filters by country', async () => {
-    const all = await runListReferences({});
-    expect(all.count).toBeGreaterThanOrEqual(100);
-    const kr = await runListReferences({ country: 'KR' });
-    expect(kr.count).toBeGreaterThan(0);
-    expect(kr.references.every((r) => r.country?.toUpperCase() === 'KR')).toBe(true);
-  });
-
-  it('get_design_md returns full content + sections for toss', async () => {
-    const toss = getReference('toss');
-    expect(toss, 'toss reference must exist in bundle').toBeTruthy();
-    const out = await runGetDesignMd({ id: 'toss' });
-    expect(out.id).toBe('toss');
-    expect(out.content.length).toBeGreaterThan(500);
-    expect(out.sections.length).toBeGreaterThan(0);
-  });
-
-  it('get_design_md throws on unknown id', async () => {
-    await expect(runGetDesignMd({ id: 'definitely-not-a-brand' })).rejects.toThrow();
-  });
-
-  it('search_by_vibe finds fintech-ish brands', async () => {
-    const out = await runSearchByVibe({ description: 'calm fintech', limit: 5 });
-    expect(out.count).toBeGreaterThan(0);
-    const ids = out.matches.map((m) => m.id);
-    // toss is our reference fintech brand and is guaranteed in the bundle
-    expect(ids).toContain('toss');
-  });
-
-  it('design_from_ref prompt injects brand context', () => {
-    const text = buildDesignFromRefPrompt({ refId: 'toss', task: 'a pricing page' });
-    expect(text).toContain('Toss');
-    expect(text).toContain('pricing page');
-    expect(text.length).toBeGreaterThan(200);
-  });
-
-  it('server constructs without throwing', () => {
-    const s = createServer();
-    expect(s).toBeTruthy();
-  });
-});

package/.opencode/oh-my-design/packages/mcp/scripts/sync-data.mjs

@@ -1,38 +0,0 @@
-#!/usr/bin/env node
-// Copy web/references/<id>/DESIGN.md into packages/mcp/data/references/<id>/DESIGN.md
-// Runs at prepublish + build time. Output dir is gitignored.
-import { mkdir, readdir, readFile, writeFile, stat, rm } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PKG_ROOT = path.resolve(__dirname, '..');
-const REPO_ROOT = path.resolve(PKG_ROOT, '..', '..');
-const SRC = path.join(REPO_ROOT, 'web', 'references');
-const DEST = path.join(PKG_ROOT, 'data', 'references');
-
-async function main() {
-  if (!existsSync(SRC)) {
-    console.error(`[sync-data] source missing: ${SRC}`);
-    process.exit(1);
-  }
-  // wipe and recreate (keep .gitkeep at data/)
-  if (existsSync(DEST)) await rm(DEST, { recursive: true, force: true });
-  await mkdir(DEST, { recursive: true });
-
-  const entries = await readdir(SRC, { withFileTypes: true });
-  let copied = 0;
-  for (const ent of entries) {
-    if (!ent.isDirectory()) continue;
-    const designPath = path.join(SRC, ent.name, 'DESIGN.md');
-    if (!existsSync(designPath)) continue;
-    const dst = path.join(DEST, ent.name);
-    await mkdir(dst, { recursive: true });
-    const buf = await readFile(designPath);
-    await writeFile(path.join(dst, 'DESIGN.md'), buf);
-    copied++;
-  }
-  console.log(`[sync-data] copied ${copied} DESIGN.md files → ${path.relative(REPO_ROOT, DEST)}`);
-}
-main().catch((e) => { console.error(e); process.exit(1); });

package/.opencode/oh-my-design/packages/mcp/src/data.ts

@@ -1,178 +0,0 @@
-// Loads bundled DESIGN.md files from data/references/ at server init.
-// Fully offline, no network, no env vars.
-import { readFileSync, readdirSync, existsSync, statSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// dist/index.js → ../data/references  (post-build layout)
-// src/data.ts   → ../data/references  (dev/test layout)
-function resolveDataDir(): string {
-  const candidates = [
-    path.resolve(__dirname, '..', '..', '..', 'design-md'),
-    path.resolve(__dirname, '..', '..', '..', 'web', 'references'),
-    path.resolve(__dirname, '..', 'data', 'references'),
-    path.resolve(__dirname, '..', '..', 'data', 'references'),
-  ];
-  for (const c of candidates) {
-    if (existsSync(c) && statSync(c).isDirectory()) return c;
-  }
-  return candidates[0]!;
-}
-
-export const DATA_DIR = resolveDataDir();
-
-export interface Frontmatter {
-  id?: string;
-  name?: string;
-  displayName?: string;
-  country?: string;
-  category?: string;
-  homepage?: string;
-  primary_color?: string;
-  verified?: string;
-  omd?: string;
-  ds?: {
-    name?: string;
-    url?: string;
-    type?: string;
-    description?: string;
-  };
-  [k: string]: unknown;
-}
-
-export interface Reference {
-  id: string;
-  filePath: string;
-  raw: string;
-  frontmatter: Frontmatter;
-  body: string;
-  sections: string[];
-}
-
-// Minimal YAML frontmatter parser — handles flat key:value, quoted strings,
-// and one level of nested object (e.g. `ds:` with indented children).
-// Sufficient for our canonical DESIGN.md schema; we don't need full YAML.
-function parseFrontmatter(raw: string): { fm: Frontmatter; body: string } {
-  const m = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
-  if (!m) return { fm: {}, body: raw };
-  const block = m[1]!;
-  const body = m[2] ?? '';
-  const fm: Record<string, unknown> = {};
-  const lines = block.split(/\r?\n/);
-  let currentObjKey: string | null = null;
-  let currentObj: Record<string, unknown> | null = null;
-
-  const stripQuotes = (v: string) => {
-    const t = v.trim();
-    if ((t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'"))) {
-      return t.slice(1, -1);
-    }
-    return t;
-  };
-  const coerce = (v: string): unknown => {
-    const t = stripQuotes(v);
-    if (t === 'true') return true;
-    if (t === 'false') return false;
-    if (t === 'null' || t === '') return null;
-    return t;
-  };
-
-  for (const line of lines) {
-    if (!line.trim() || line.trim().startsWith('#')) continue;
-    // nested child line: starts with whitespace + "key: value"
-    if (/^\s+\S/.test(line) && currentObj) {
-      const cm = line.match(/^\s+([A-Za-z0-9_\-]+):\s*(.*)$/);
-      if (cm) {
-        currentObj[cm[1]!] = coerce(cm[2] ?? '');
-        continue;
-      }
-    }
-    // top-level
-    const tm = line.match(/^([A-Za-z0-9_\-]+):\s*(.*)$/);
-    if (!tm) continue;
-    const key = tm[1]!;
-    const rest = (tm[2] ?? '').trim();
-    if (rest === '') {
-      // start a nested object
-      currentObj = {};
-      currentObjKey = key;
-      fm[key] = currentObj;
-    } else {
-      fm[key] = coerce(rest);
-      currentObj = null;
-      currentObjKey = null;
-    }
-  }
-  void currentObjKey;
-  return { fm: fm as Frontmatter, body };
-}
-
-function extractSections(body: string): string[] {
-  const sections: string[] = [];
-  for (const line of body.split(/\r?\n/)) {
-    const m = line.match(/^##\s+(.+?)\s*$/);
-    if (m) sections.push(m[1]!);
-  }
-  return sections;
-}
-
-let cache: Map<string, Reference> | null = null;
-
-export function loadAllReferences(): Map<string, Reference> {
-  if (cache) return cache;
-  const map = new Map<string, Reference>();
-  if (!existsSync(DATA_DIR)) {
-    cache = map;
-    return map;
-  }
-  const ids = readdirSync(DATA_DIR, { withFileTypes: true })
-    .filter((e) => e.isDirectory())
-    .map((e) => e.name);
-  for (const id of ids) {
-    const filePath = path.join(DATA_DIR, id, 'DESIGN.md');
-    if (!existsSync(filePath)) continue;
-    const raw = readFileSync(filePath, 'utf8');
-    const { fm, body } = parseFrontmatter(raw);
-    const sections = extractSections(body);
-    map.set(id, {
-      id,
-      filePath,
-      raw,
-      frontmatter: fm,
-      body,
-      sections,
-    });
-  }
-  cache = map;
-  return map;
-}
-
-export function getReference(id: string): Reference | undefined {
-  return loadAllReferences().get(id);
-}
-
-export function listReferenceIds(): string[] {
-  return Array.from(loadAllReferences().keys()).sort();
-}
-
-export function getDisplayName(ref: Reference): string {
-  const fm = ref.frontmatter;
-  return (fm.displayName as string) || (fm.name as string) || ref.id;
-}
-
-export function hasOfficialDs(ref: Reference): boolean {
-  const ds = ref.frontmatter.ds;
-  return !!(ds && (ds.name || ds.url));
-}
-
-// Short summary = first non-empty paragraph in body (clipped).
-export function summarize(ref: Reference, max = 160): string {
-  const paras = ref.body.split(/\r?\n\r?\n/).map((p) => p.trim()).filter(Boolean);
-  // skip headings
-  const first = paras.find((p) => !p.startsWith('#'));
-  if (!first) return '';
-  const flat = first.replace(/\s+/g, ' ');
-  return flat.length > max ? flat.slice(0, max - 1) + '…' : flat;
-}

package/.opencode/oh-my-design/packages/mcp/src/index.ts

@@ -1,58 +0,0 @@
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
-import { listReferenceIds } from './data.js';
-
-function printHelp() {
-  // Brand count derived from the bundled corpus, never hardcoded, so the help
-  // text can't fossilize a stale number as the catalog grows. Falls back to
-  // "100+" if the data dir hasn't been synced yet (dev without `npm run build`).
-  const n = listReferenceIds().length;
-  const brands = n > 0 ? String(n) : '100+';
-  // Use stderr — stdout is reserved for the JSON-RPC stream.
-  process.stderr.write(
-    [
-      `${SERVER_NAME} v${SERVER_VERSION}`,
-      '',
-      `Drop-in MCP server exposing ${brands} brand design systems (DESIGN.md).`,
-      '',
-      'Usage:',
-      `  npx -y ${SERVER_NAME}            # start stdio MCP server (default)`,
-      `  npx -y ${SERVER_NAME} --help     # show this help`,
-      `  npx -y ${SERVER_NAME} --version  # print version`,
-      '',
-      'Tools:     list_references, get_design_md, search_by_vibe',
-      `Resources: design://<id>  (${brands} brands)`,
-      'Prompts:   design_from_ref',
-      '',
-      'Install in Claude Desktop, Cursor, Cline, Continue, or Codex — see README.',
-      '',
-    ].join('\n'),
-  );
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-  if (args.includes('--help') || args.includes('-h')) {
-    printHelp();
-    return;
-  }
-  if (args.includes('--version') || args.includes('-v')) {
-    process.stdout.write(`${SERVER_VERSION}\n`);
-    return;
-  }
-
-  const server = createServer();
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  // Log to stderr only — stdout is the JSON-RPC channel.
-  process.stderr.write(
-    `[${SERVER_NAME}] v${SERVER_VERSION} listening on stdio\n`,
-  );
-}
-
-main().catch((err) => {
-  process.stderr.write(
-    `[${SERVER_NAME}] fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`,
-  );
-  process.exit(1);
-});

package/.opencode/oh-my-design/packages/mcp/src/prompts/design-from-ref.ts

@@ -1,87 +0,0 @@
-import { z } from 'zod';
-import { getReference, getDisplayName } from '../data.js';
-
-export const designFromRefSchema = {
-  refId: z
-    .string()
-    .min(1)
-    .describe('Reference id (e.g. "toss", "stripe"). Use list_references to discover ids.'),
-  task: z
-    .string()
-    .min(1)
-    .describe('What to build, e.g. "a pricing page", "a settings screen", "an onboarding flow".'),
-};
-
-const InputSchema = z.object(designFromRefSchema);
-
-// Pull a labeled section by heading match (case-insensitive partial match).
-function extractSection(body: string, needle: string): string | null {
-  const lines = body.split(/\r?\n/);
-  const need = needle.toLowerCase();
-  let inSection = false;
-  let collected: string[] = [];
-  for (const line of lines) {
-    const h = line.match(/^##\s+(.+?)\s*$/);
-    if (h) {
-      if (inSection) break;
-      if (h[1]!.toLowerCase().includes(need)) {
-        inSection = true;
-        collected.push(`## ${h[1]}`);
-        continue;
-      }
-    }
-    if (inSection) collected.push(line);
-  }
-  const out = collected.join('\n').trim();
-  return out.length > 0 ? out : null;
-}
-
-export function buildDesignFromRefPrompt(input: z.infer<typeof InputSchema>) {
-  const ref = getReference(input.refId);
-  if (!ref) {
-    throw new Error(
-      `Unknown reference id "${input.refId}". Use list_references to discover available ids.`,
-    );
-  }
-  const name = getDisplayName(ref);
-  const fm = ref.frontmatter;
-  const sections: string[] = [];
-  for (const label of [
-    'Visual Theme',
-    'Color Palette',
-    'Typography',
-    'Voice',
-  ]) {
-    const s = extractSection(ref.body, label);
-    if (s) sections.push(s);
-  }
-  const fmLine = [
-    fm.country ? `country=${fm.country}` : null,
-    fm.category ? `category=${fm.category}` : null,
-    fm.primary_color ? `primary=${fm.primary_color}` : null,
-    fm.ds?.name ? `official-ds=${fm.ds.name}` : null,
-  ]
-    .filter(Boolean)
-    .join(' · ');
-
-  const text = [
-    `You are building UI in the visual + verbal style of **${name}** (${fmLine}).`,
-    '',
-    `Task: ${input.task}`,
-    '',
-    `Apply these brand rules strictly. Do not invent tokens — pull values from the spec below.`,
-    `When the task is ambiguous, default to the brand's documented patterns rather than generic Tailwind/Material defaults.`,
-    '',
-    '---',
-    '',
-    sections.length > 0
-      ? sections.join('\n\n')
-      : ref.raw.slice(0, 4000),
-    '',
-    '---',
-    '',
-    `If you need additional sections (Components, Layout, Motion, Personas), call the \`get_design_md\` tool with id="${ref.id}" to fetch the full spec.`,
-  ].join('\n');
-
-  return text;
-}