@mdvp/cli 1.3.0

package/cli.mjs

@@ -0,0 +1,349 @@
+#!/usr/bin/env node
+import { homedir } from "os"
+import { readFileSync, writeFileSync, mkdirSync } from "fs"
+import { get, request } from "https"
+import { createInterface } from "readline"
+
+const API = "https://designsense.tixo-digital.workers.dev"
+const CONFIG_DIR = `${homedir()}/.mdvp`
+const CONFIG_FILE = `${CONFIG_DIR}/config.json`
+const VERSION = "1.2.0"
+
+const CATS = {
+  spacing: "Spacing", typography: "Typography", color: "Color",
+  components: "Components", modernity: "Modernity", originality: "Originality",
+  html_quality: "HTML Quality", visual_polish: "Visual Polish",
+  sophistication: "Sophistication", readability: "Readability",
+  ux_patterns: "UX Patterns", contentDepth: "Content Depth",
+}
+
+const R = "\x1b[0m"
+const DIM = "\x1b[2m"
+const BOLD = "\x1b[1m"
+const RED = "\x1b[31m"
+const GREEN = "\x1b[32m"
+const YELLOW = "\x1b[33m"
+
+const scoreColor = (s) => s >= 80 ? GREEN : s >= 60 ? YELLOW : RED
+const bar = (s) => "█".repeat(Math.round(s / 10)) + "░".repeat(10 - Math.round(s / 10))
+const parseDomain = (s) => s.replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/.*$/, "")
+
+function loadConfig() {
+  try { return JSON.parse(readFileSync(CONFIG_FILE, "utf8")) } catch { return {} }
+}
+
+function saveConfig(data) {
+  mkdirSync(CONFIG_DIR, { recursive: true })
+  writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2))
+}
+
+function apiGet(path) {
+  return new Promise((resolve, reject) => {
+    get(`${API}${path}`, { headers: { Accept: "application/json" } }, (res) => {
+      let body = ""
+      res.on("data", (c) => (body += c))
+      res.on("end", () => {
+        try { resolve(JSON.parse(body)) }
+        catch { reject(new Error(`Invalid JSON: ${body.slice(0, 200)}`)) }
+      })
+    }).on("error", reject)
+  })
+}
+
+function apiPost(path, data, apiKey, baseUrl = API) {
+  return new Promise((resolve, reject) => {
+    const body = JSON.stringify(data)
+    const req = request(`${baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...(apiKey ? { "x-api-key": apiKey } : {}),
+      },
+    }, (res) => {
+      let resp = ""
+      res.on("data", (c) => (resp += c))
+      res.on("end", () => {
+        try { resolve(JSON.parse(resp)) }
+        catch { reject(new Error(`Invalid JSON: ${resp.slice(0, 200)}`)) }
+      })
+    })
+    req.on("error", reject)
+    req.write(body)
+    req.end()
+  })
+}
+
+async function cmdAudit(domain, { json }) {
+  domain = parseDomain(domain)
+  process.stderr.write(`${DIM}fetching ${domain}...${R}\n`)
+  const data = await apiGet(`/dataset?limit=800`)
+  const site = (data.sites ?? []).find((s) => s.id === domain)
+  if (!site) {
+    if (json) { console.log(JSON.stringify({ error: "not_in_dataset", domain }, null, 2)); process.exit(1) }
+    console.error(`${RED}not in dataset: ${domain}${R}\n${DIM}run: npx mdvp submit ${domain}${R}`)
+    process.exit(1)
+  }
+  const bd = site.scores?.breakdown ?? []
+  if (json) {
+    console.log(JSON.stringify({
+      id: site.id, url: site.url, grade: site.grade,
+      overall_score: site.overall_score, label: site.label,
+      scores: { overall: site.overall_score, grade: site.grade, breakdown: Object.fromEntries(bd.map((b) => [b.c, b.s])) },
+    }, null, 2))
+    return
+  }
+  console.log(`\n${BOLD}${site.id}${R}  ${scoreColor(site.overall_score)}${site.grade}  ${site.overall_score}/100${R}  ${DIM}${site.label}${R}\n`)
+  for (const cat of Object.keys(CATS)) {
+    const s = bd.find((b) => b.c === cat)?.s ?? 0
+    console.log(`  ${CATS[cat].padEnd(16)}  ${scoreColor(s)}${bar(s)}${R}  ${s}`)
+  }
+  const sorted = [...bd].sort((a, b) => a.s - b.s).slice(0, 3)
+  console.log(`\n${DIM}Lowest: ${sorted.map((i) => `${CATS[i.c] ?? i.c} (${i.s})`).join(" · ")}${R}\n`)
+}
+
+async function cmdCompare(da, db) {
+  ;[da, db] = [da, db].map(parseDomain)
+  const sites = (await apiGet(`/dataset?limit=800`)).sites ?? []
+  const a = sites.find((s) => s.id === da)
+  const b = sites.find((s) => s.id === db)
+  if (!a) { console.error(`${RED}not found: ${da}${R}`); process.exit(1) }
+  if (!b) { console.error(`${RED}not found: ${db}${R}`); process.exit(1) }
+  const bda = Object.fromEntries((a.scores?.breakdown ?? []).map((x) => [x.c, x.s]))
+  const bdb = Object.fromEntries((b.scores?.breakdown ?? []).map((x) => [x.c, x.s]))
+  console.log(`\n  ${"Category".padEnd(16)}  ${da.slice(0, 14).padEnd(14)}  ${db.slice(0, 14).padEnd(14)}  Δ`)
+  console.log(`  ${"─".repeat(16)}  ${"─".repeat(14)}  ${"─".repeat(14)}  ─────`)
+  console.log(`  ${"Overall".padEnd(16)}  ${String(a.overall_score).padEnd(14)}  ${String(b.overall_score).padEnd(14)}  ${b.overall_score - a.overall_score > 0 ? "+" : ""}${b.overall_score - a.overall_score}`)
+  for (const cat of Object.keys(CATS)) {
+    const va = bda[cat] ?? 0, vb = bdb[cat] ?? 0, diff = vb - va
+    const c = diff > 5 ? GREEN : diff < -5 ? RED : DIM
+    console.log(`  ${(CATS[cat] ?? cat).padEnd(16)}  ${String(va).padEnd(14)}  ${String(vb).padEnd(14)}  ${c}${diff > 0 ? "+" : ""}${diff}${R}`)
+  }
+  console.log()
+}
+
+async function cmdTop(n, worst) {
+  const sites = (await apiGet(`/dataset?limit=800`)).sites ?? []
+  const sorted = (worst ? sites.sort((a, b) => a.overall_score - b.overall_score) : sites.sort((a, b) => b.overall_score - a.overall_score)).slice(0, n)
+  console.log(`\n  ${"#".padEnd(4)}  ${"Domain".padEnd(28)}  ${"Score".padEnd(6)}  Grade  Label`)
+  console.log(`  ${"─".repeat(4)}  ${"─".repeat(28)}  ${"─".repeat(6)}  ─────  ─────────`)
+  for (const [i, s] of sorted.entries()) {
+    console.log(`  ${String(i + 1).padEnd(4)}  ${s.id.padEnd(28)}  ${scoreColor(s.overall_score)}${String(s.overall_score).padEnd(6)}${R}  ${s.grade.padEnd(5)}  ${s.label}`)
+  }
+  console.log()
+}
+
+async function cmdLogin() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+  return new Promise((resolve) => {
+    rl.question(`${BOLD}MDVP API Key${R} (from mdvp.tixo-digital.workers.dev): `, (key) => {
+      rl.close()
+      key = key.trim()
+      if (!key.startsWith("ds_")) { console.error(`${RED}Invalid key — must start with ds_${R}`); process.exit(1) }
+      saveConfig({ apiKey: key })
+      console.log(`${DIM}Saved to ~/.mdvp/config.json${R}\n${BOLD}Logged in.${R} Try: npx mdvp audit stripe.com`)
+      resolve()
+    })
+  })
+}
+
+async function cmdBalance({ json, apiKey }) {
+  if (!apiKey) { console.error(`${RED}No API key. Run: npx mdvp login${R}`); process.exit(1) }
+  const d = await new Promise((resolve, reject) => {
+    get(`${API}/token/balance`, { headers: { Accept: "application/json", "x-api-key": apiKey } }, (res) => {
+      let body = ""
+      res.on("data", (c) => (body += c))
+      res.on("end", () => resolve(JSON.parse(body)))
+    }).on("error", reject)
+  })
+  if (json) { console.log(JSON.stringify(d, null, 2)); return }
+  console.log(`\n  Key:      ${d.token}\n  Balance:  $${d.balance_usd}\n  Credits:  ${d.credits_remaining} audits remaining\n`)
+}
+
+const ASCII = `
+  ███╗   ███╗██████╗ ██╗   ██╗██████╗
+  ████╗ ████║██╔══██╗██║   ██║██╔══██╗
+  ██╔████╔██║██║  ██║██║   ██║██████╔╝
+  ██║╚██╔╝██║██║  ██║╚██╗ ██╔╝██╔═══╝
+  ██║ ╚═╝ ██║██████╔╝ ╚████╔╝ ██║
+  ╚═╝     ╚═╝╚═════╝   ╚═══╝  ╚═╝`
+
+const HELP = `${DIM}${ASCII}${R}
+${DIM}  Machine Design Vision Protocol  v${VERSION}${R}
+
+${BOLD}Audit${R}
+  audit <domain>              Score a website
+  audit <domain> --json       Output as JSON
+  compare <a> <b>             Compare two sites side by side
+  top [n]                     Top-scored sites (default 10)
+  worst [n]                   Lowest-scored sites
+  label <label>               Filter by label (premium/good/vibecoded/bad)
+  stats                       Dataset statistics
+
+${BOLD}Account${R}
+  login                       Save your API key
+  balance                     Check credit balance
+  submit <domain>             Submit URL for crawl (1 credit)
+  submit <domain> --local     Submit to local crawler node instead
+
+${BOLD}Crawler${R}
+  hire                        Become a crawler node (downloads + runs worker)
+  hire --daemon               Run crawler in background
+  hire --tabs=4               Run with 4 parallel tabs
+  apply                       Same as hire
+  serve                       Same as hire (global by default)
+  serve --local               Run local-only crawler node
+
+${BOLD}Flags${R}
+  --json                      Output as JSON
+  --local                     Use local crawler (http://localhost:7227)
+  --daemon  -d                Run in background (hire/serve only)
+  --tabs=N                    Parallel tabs for crawler
+
+${BOLD}Examples${R}
+  npx mdvp audit stripe.com
+  npx mdvp audit stripe.com --json | jq .overall_score
+  npx mdvp compare figma.com linear.app
+  npx mdvp submit myapp.com
+  npx mdvp submit myapp.com --local
+  npx mdvp hire --daemon --tabs=4
+  curl -fsSL ${API}/hire.sh | bash -s -- -d
+
+${BOLD}Web${R}  https://mdvp.tixo-digital.workers.dev
+${BOLD}Docs${R} https://mdvp.tixo-digital.workers.dev/docs
+`
+
+async function cmdHire(opts) {
+  const { daemon, tabs, local } = opts
+  const { execSync, spawn } = await import("child_process")
+  const { existsSync } = await import("fs")
+  const dir = `${homedir()}/.mdvp/crawler`
+
+  console.log(`${DIM}${ASCII}${R}\n`)
+  console.log(`${BOLD}Hiring as crawler node...${R}`)
+
+  process.stderr.write(`${DIM}Downloading worker from ${API}...${R}\n`)
+  mkdirSync(dir, { recursive: true })
+
+  const workerUrl = `${API}/crawler-worker.mjs`
+  const extractUrl = `${API}/extract.js`
+
+  await new Promise((res, rej) => {
+    const { writeFileSync } = { writeFileSync }
+    get(workerUrl, { headers: { Accept: "text/plain" } }, (r) => {
+      let body = ""
+      r.on("data", (c) => (body += c))
+      r.on("end", () => {
+        writeFileSync(`${dir}/crawler-worker.mjs`, body)
+        res()
+      })
+    }).on("error", rej)
+  }).catch(() => process.stderr.write(`${DIM}Could not download worker, using local copy${R}\n`))
+
+  await new Promise((res) => {
+    get(extractUrl, { headers: { Accept: "text/plain" } }, (r) => {
+      let body = ""
+      r.on("data", (c) => (body += c))
+      r.on("end", () => {
+        try { writeFileSync(`${dir}/extract.js`, body) } catch {}
+        res()
+      })
+    }).on("error", () => res())
+  })
+
+  if (!existsSync(`${dir}/package.json`)) {
+    writeFileSync(`${dir}/package.json`, '{"type":"module"}')
+  }
+
+  const apiUrl = local ? "http://localhost:7227" : API
+  const nodeId = `mdvp-${Math.random().toString(36).slice(2, 8)}`
+  const env = { ...process.env, NODE_ID: nodeId, TABS: String(tabs || 2), API_URL: apiUrl }
+
+  if (daemon) {
+    const { openSync } = await import("fs")
+    const log = `${dir}/worker-${process.pid}.log`
+    const out = openSync(log, "a")
+    const child = spawn("node", [`${dir}/crawler-worker.mjs`], {
+      env, cwd: dir, detached: true, stdio: ["ignore", out, out],
+    })
+    child.unref()
+    console.log(`${GREEN}Worker started in background${R}`)
+    console.log(`  PID: ${child.pid}`)
+    console.log(`  Log: ${log}`)
+    console.log(`  Stop: kill ${child.pid}`)
+    console.log(`  Node: ${nodeId}`)
+  } else {
+    console.log(`${GREEN}Starting crawler node ${nodeId}${R} (Ctrl+C to stop)\n`)
+    const child = spawn("node", [`${dir}/crawler-worker.mjs`], {
+      env, cwd: dir, stdio: "inherit",
+    })
+    await new Promise((res) => child.on("exit", res))
+  }
+}
+
+async function cmdSubmit(domain, opts) {
+  const { apiKey, local } = opts
+  if (!apiKey) { console.error(`${RED}No API key. Run: npx mdvp login${R}`); process.exit(1) }
+  domain = parseDomain(domain)
+  const targetApi = local ? "http://localhost:7227" : API
+  process.stderr.write(`${DIM}submitting ${domain} → ${local ? "local" : "global"} crawler...${R}\n`)
+  const d = await apiPost("/crawl/submit", { domain, url: `https://${domain}` }, apiKey, targetApi)
+  if (d.error) { console.error(`${RED}Error: ${d.error}${R}`); process.exit(1) }
+  console.log(`\n  ${BOLD}Submitted!${R} ${domain} added to crawl queue.`)
+  console.log(`  ${DIM}Results in ~60s. Check: npx mdvp audit ${domain}${R}\n`)
+}
+
+async function main() {
+  const argv = process.argv.slice(2)
+  const flags = new Set(argv.filter((a) => a.startsWith("--") && !a.includes("=")))
+  const flagValues = Object.fromEntries(argv.filter((a) => a.includes("=")).map((a) => a.replace("--", "").split("=")))
+  const positional = argv.filter((a) => !a.startsWith("--"))
+  const [cmd, arg1, arg2] = positional
+  const cfg = loadConfig()
+  const opts = {
+    json: flags.has("--json") || flags.has("--raw"),
+    apiKey: cfg.apiKey ?? null,
+    local: flags.has("--local"),
+    daemon: flags.has("--daemon") || flags.has("-d"),
+    tabs: parseInt(flagValues.tabs || "2") || 2,
+  }
+
+  if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+    console.log(HELP)
+  } else if (cmd === "login") {
+    await cmdLogin()
+  } else if (cmd === "audit" && arg1) {
+    await cmdAudit(arg1, opts)
+  } else if (cmd === "submit" && arg1) {
+    await cmdSubmit(arg1, opts)
+  } else if (cmd === "balance") {
+    await cmdBalance(opts)
+  } else if (cmd === "compare" && arg1 && arg2) {
+    await cmdCompare(arg1, arg2)
+  } else if (cmd === "top") {
+    await cmdTop(parseInt(arg1 || "10") || 10, false)
+  } else if (cmd === "worst") {
+    await cmdTop(parseInt(arg1 || "10") || 10, true)
+  } else if (cmd === "stats") {
+    const d = await apiGet("/dataset/stats")
+    if (opts.json) { console.log(JSON.stringify(d, null, 2)); return }
+    console.log(`\n  Total sites:   ${d.totalSites}\n  Average score: ${d.averageScore}\n`)
+  } else if (cmd === "hire" || cmd === "apply" || cmd === "serve") {
+    await cmdHire(opts)
+  } else if (cmd === "label" && arg1) {
+    const sites = (await apiGet(`/dataset?limit=800`)).sites ?? []
+    const filtered = sites.filter((s) => s.label === arg1).sort((a, b) => b.overall_score - a.overall_score).slice(0, 20)
+    if (!filtered.length) { console.error(`No sites with label: ${arg1}`); process.exit(1) }
+    console.log(`\n  ${filtered.length} sites · label=${arg1}\n`)
+    for (const s of filtered) console.log(`  ${s.id.padEnd(28)}  ${scoreColor(s.overall_score)}${s.overall_score}${R}  ${s.grade}`)
+    console.log()
+  } else {
+    console.error(`Unknown command: ${cmd}\nRun 'npx mdvp help' for usage.`)
+    process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error(`${RED}Error: ${err.message}${R}`)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@mdvp/cli",
+  "version": "1.3.0",
+  "description": "Machine Design Vision Protocol \u2014 gives agents eyes to understand design quality",
+  "bin": {
+    "mdvp": "./cli.mjs"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "design",
+    "audit",
+    "cli",
+    "ux",
+    "mdvp",
+    "machine-design"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tixo/mdvp.git"
+  },
+  "homepage": "https://mdvp.tixo-digital.workers.dev",
+  "license": "MIT"
+}