zugzbot 1.0.18 → 1.0.19

package/.opencode/tools/sdd_design.ts

@@ -0,0 +1,303 @@
+import { tool } from "@opencode-ai/plugin"
+import fs from "fs"
+import path from "path"
+import { execSync } from "child_process"
+
+// Helper to safely resolve root directory (avoiding OpenCode bug where worktree is '/' in non-git repos)
+const getRoot = (context: any) => {
+  if (context?.directory && context.directory !== "/") return context.directory;
+  if (context?.worktree && context.worktree !== "/") return context.worktree;
+  if (context?.cwd && context.cwd !== "/") return context.cwd;
+  return process.cwd();
+};
+
+// Curated subset of brands with HTML+CSS interactive previews.
+export const RECOMMENDED_BRANDS: Record<string, { id: string; name: string; category: string; vibe: string }[]> = {
+  saas: [
+    { id: "supabase", name: "Supabase", category: "saas", vibe: "Open-source Firebase alternative, dark-mode-first, dense data UI" },
+    { id: "linear.app", name: "Linear", category: "saas", vibe: "Issue tracking premium, ultra-fast keyboard-first, monochrome" },
+    { id: "vercel", name: "Vercel", category: "saas", vibe: "Vercel/Next.js native, mono+geist font, gradient accents" },
+    { id: "raycast", name: "Raycast", category: "saas", vibe: "Productivity launcher, sharp corners, command-bar UX" },
+    { id: "posthog", name: "PostHog", category: "saas", vibe: "Product analytics, orange accent, fun playful tone" },
+  ],
+  fintech: [
+    { id: "stripe", name: "Stripe", category: "fintech", vibe: "Premium payments, gradient brand, dense docs" },
+    { id: "revolut", name: "Revolut", category: "fintech", vibe: "Neobank, dark+violet, large numbers" },
+    { id: "wise", name: "Wise", category: "fintech", vibe: "Cross-border money, bright green, friendly tone" },
+    { id: "toss", name: "Toss", category: "fintech", vibe: "Korean super-app, blue primary, imperative microcopy" },
+  ],
+  ecommerce: [
+    { id: "airbnb", name: "Airbnb", category: "ecommerce", vibe: "Travel marketplace, coral accent, photographic" },
+    { id: "apple", name: "Apple", category: "ecommerce", vibe: "Hardware store, ultra-minimal, SF Pro typography" },
+    { id: "nike", name: "Nike", category: "ecommerce", vibe: "Athletic brand, black+volt, UPPERCASE bold, flat" },
+    { id: "shopify", name: "Shopify", category: "ecommerce", vibe: "E-commerce platform, green primary, merchant-focused" },
+  ],
+  consumer: [
+    { id: "spotify", name: "Spotify", category: "consumer", vibe: "Music streaming, green+dark, immersive cards" },
+    { id: "figma", name: "Figma", category: "consumer", vibe: "Design tool, multi-color, playful professional" },
+    { id: "notion", name: "Notion", category: "consumer", vibe: "Productivity, minimal, document-first" },
+  ],
+}
+
+// Tool: sdd_select_design
+export const select_design = tool({
+  description: "Copia fielmente el archivo DESIGN.md y sus ejemplos y recursos interactivos asociados desde el catálogo original de oh-my-design a la carpeta .openspec/ del proyecto.",
+  args: {
+    brandId: tool.schema.string().describe("ID exacto del diseño en oh-my-design (ej: 'linear.app', 'vercel', 'stripe')")
+  },
+  async execute(args, context) {
+    const root = getRoot(context)
+    const brandId = args.brandId.trim()
+    const sourceDir = path.resolve(root, ".opencode/oh-my-design/design-md", brandId)
+
+    if (!fs.existsSync(sourceDir)) {
+      // Try resolving with substring match if not found exactly
+      const catalogDir = path.resolve(root, ".opencode/oh-my-design/design-md")
+      if (fs.existsSync(catalogDir)) {
+        const brands = fs.readdirSync(catalogDir)
+        const match = brands.find(b => b.toLowerCase() === brandId.toLowerCase() || b.toLowerCase().includes(brandId.toLowerCase()))
+        if (match && match !== brandId) {
+          return selectDesignHelper(match, context)
+        }
+      }
+      return JSON.stringify({
+        status: "ERROR",
+        message: `No se encontró el directorio de diseño para la marca "${brandId}" en ${sourceDir}`
+      }, null, 2)
+    }
+
+    return selectDesignHelper(brandId, context)
+  }
+})
+
+// Helper extracted to allow substring-match recursion without `this.execute` typing issues.
+async function selectDesignHelper(brandId: string, context: any) {
+    const root = getRoot(context)
+    const sourceDir = path.resolve(root, ".opencode/oh-my-design/design-md", brandId)
+    const targetDir = path.resolve(root, ".openspec")
+
+    if (!fs.existsSync(sourceDir)) {
+      return JSON.stringify({
+        status: "ERROR",
+        message: `No se encontró el directorio de diseño para la marca "${brandId}" en ${sourceDir}`
+      }, null, 2)
+    }
+
+    // 1. Copy accompanying files (HTML previews, README, DESIGN.md, etc.) to a brand subfolder in .openspec
+    const targetBrandDir = path.join(targetDir, "design-assets", brandId)
+    if (!fs.existsSync(targetBrandDir)) {
+      fs.mkdirSync(targetBrandDir, { recursive: true })
+    }
+
+    const copiedFiles: string[] = []
+    const sourceDesign = path.join(sourceDir, "DESIGN.md")
+    if (!fs.existsSync(sourceDesign)) {
+      return JSON.stringify({
+        status: "ERROR",
+        message: `No se encontró el archivo DESIGN.md en la ruta origen: ${sourceDesign}`
+      }, null, 2)
+    }
+
+    const files = fs.readdirSync(sourceDir)
+    for (const file of files) {
+      if (file.startsWith(".")) continue
+      const srcFile = path.join(sourceDir, file)
+      const dstFile = path.join(targetBrandDir, file)
+      if (fs.statSync(srcFile).isFile()) {
+        fs.copyFileSync(srcFile, dstFile)
+        copiedFiles.push(file)
+      }
+    }
+
+    // 2. Overwrite .openspec/DESIGN.md so that opencode.json static references always resolve and agents get the active design guidelines
+    const legacyDesign = path.join(targetDir, "DESIGN.md")
+    try {
+      fs.copyFileSync(sourceDesign, legacyDesign)
+    } catch (e) {
+      /* ignore */
+    }
+
+    return JSON.stringify({
+      status: "SUCCESS",
+      message: `Diseño "${brandId}" copiado a la ruta canónica .openspec/design-assets/${brandId}/ y actualizado en .openspec/DESIGN.md`,
+      copiedFiles,
+      designAssetsDir: path.relative(root, targetBrandDir),
+      canonicalDesignPath: path.relative(root, path.join(targetBrandDir, "DESIGN.md")),
+    }, null, 2)
+}
+
+// Tool: sdd_list_design_recommendations
+export const list_design_recommendations = tool({
+  description: "Devuelve una lista curada y corta de marcas de diseño recomendadas (con assets HTML+CSS interactivos), filtrada por categoría de uso. Reemplaza 3-4 llamadas a oh-my-design_list_references en F0.",
+  args: {
+    use_case: tool.schema.enum(["saas", "fintech", "ecommerce", "consumer", "all"]).default("all").describe("Categoría del proyecto para filtrar marcas relevantes"),
+    max_per_category: tool.schema.number().default(3).describe("Máximo de marcas a devolver por categoría"),
+  },
+  async execute(args, context) {
+    const useCase = args.use_case
+    const maxPer = Math.max(1, Math.min(args.max_per_category || 3, 6))
+
+    if (useCase === "all") {
+      const result: Record<string, any[]> = {}
+      for (const cat of Object.keys(RECOMMENDED_BRANDS)) {
+        result[cat] = RECOMMENDED_BRANDS[cat].slice(0, maxPer)
+      }
+      return JSON.stringify({
+        status: "SUCCESS",
+        message: `Recomendaciones de diseño curadas (top ${maxPer} por categoría)`,
+        recommendations: result,
+        note: "Estas marcas tienen preview.html/preview-dark.html en .opencode/oh-my-design/design-md/. Para marcas adicionales usa oh-my-design_list_references.",
+      }, null, 2)
+    }
+
+    const list = RECOMMENDED_BRANDS[useCase] || []
+    return JSON.stringify({
+      status: "SUCCESS",
+      message: `Recomendaciones de diseño para use_case="${useCase}"`,
+      recommendations: { [useCase]: list.slice(0, maxPer) },
+      note: "Estas marcas tienen preview.html/preview-dark.html en .opencode/oh-my-design/design-md/.",
+    }, null, 2)
+  }
+})
+
+// Tool: sdd_apply_brand_tokens
+export const apply_brand_tokens = tool({
+  description: "Inyecta tokens de diseño de marca (colores, tipografía, radius) en src/app/globals.css preservando las variables shadcn (--color-border, --color-background, etc.). Usar en F2 cuando se necesite aplicar el tema de marca.",
+  args: {
+    tokens: tool.schema.string().describe("JSON stringificado con {colors: {...}, typography: {...}, radius: {...}} extraído de contract.json design.tokens"),
+  },
+  async execute(args, context) {
+    const root = getRoot(context)
+    const globalsPath = path.resolve(root, "src/app/globals.css")
+
+    if (!fs.existsSync(globalsPath)) {
+      return JSON.stringify({
+        status: "ERROR",
+        message: `No se encontró src/app/globals.css. Ejecuta primero el bootstrap de nextjs-shadcn.`,
+      }, null, 2)
+    }
+
+    let brandTokens: any
+    try {
+      brandTokens = JSON.parse(args.tokens)
+    } catch (e) {
+      return JSON.stringify({
+        status: "ERROR",
+        message: `tokens no es JSON válido: ${(e as Error).message}`,
+      }, null, 2)
+    }
+
+    const colors = brandTokens.colors || {}
+    const typography = brandTokens.typography?.family || {}
+    const radius = brandTokens.radius || {}
+
+    // Build the brand CSS variables block. Preserves shadcn vars.
+    const brandVarLines: string[] = []
+    for (const [k, v] of Object.entries(colors)) {
+      const safeName = String(k).replace(/[^a-zA-Z0-9-]/g, "-").toLowerCase()
+      brandVarLines.push(`  --color-brand-${safeName}: ${v};`)
+    }
+    if (typography.sans) {
+      brandVarLines.push(`  --font-sans: ${typography.sans};`)
+      brandVarLines.push(`  --font-heading: ${typography.sans};`)
+    }
+    for (const [k, v] of Object.entries(radius)) {
+      brandVarLines.push(`  --radius-${k}: ${v}px;`)
+    }
+
+    const brandBlock = `/* Brand tokens (injected by sdd_apply_brand_tokens) */
+@theme inline {
+${brandVarLines.join("\n")}
+}
+`
+
+    let css = fs.readFileSync(globalsPath, "utf8")
+
+    // Remove any previous brand block to keep this idempotent.
+    css = css.replace(/\/\* Brand tokens[\s\S]*?\}\s*\n/g, "")
+
+    // Append at the end. Existing shadcn @theme inline block remains untouched.
+    css = css.trimEnd() + "\n\n" + brandBlock
+
+    fs.writeFileSync(globalsPath, css, "utf8")
+
+    return JSON.stringify({
+      status: "SUCCESS",
+      message: `Inyectados ${brandVarLines.length} tokens de marca en src/app/globals.css (preservando variables shadcn)`,
+      globalsPath: path.relative(root, globalsPath),
+      brandVariables: brandVarLines.length,
+    }, null, 2)
+  }
+})
+
+// Tool: sdd_validate_lucide_icons_batch
+export const validate_lucide_icons_batch = tool({
+  description: "Valida un lote de nombres de iconos de Lucide React de forma rápida e idempotente. Si node_modules/lucide-react existe, verifica contra los exports reales; de lo contrario, valida contra un listado estático de los iconos más comunes.",
+  args: {
+    icons: tool.schema.array(tool.schema.string()).describe("Lista de nombres de iconos a validar (ej: ['Sun', 'Moon', 'Plus'])"),
+  },
+  async execute(args, context) {
+    const root = getRoot(context)
+    const results: Record<string, { valid: boolean; source: string }> = {}
+    
+    // Lista de iconos comunes como fallback
+    const commonIcons = new Set([
+      "Sun", "Moon", "Plus", "Trash2", "History", "Clock", "Calculator", "User", "Settings", 
+      "Home", "ChevronLeft", "ChevronRight", "ChevronUp", "ChevronDown", "Search", "X", "Check", 
+      "Edit", "Menu", "LogOut", "LogIn", "Lock", "Mail", "Phone", "MapPin", "Calendar", "Upload", 
+      "Download", "ExternalLink", "Eye", "EyeOff", "AlertCircle", "CheckCircle", "Info", "HelpCircle", 
+      "Bell", "Share2", "Copy", "File", "Folder", "Image", "Video", "Music", "Play", "Pause", 
+      "Server", "Database", "Terminal", "Code", "Grid", "List", "Filter", "Heart", "Star", 
+      "ArrowRight", "ArrowLeft", "ArrowUp", "ArrowDown", "RefreshCw", "Send", "Activity", "Briefcase", 
+      "Camera", "Cloud", "Compass", "Cpu", "CreditCard", "DollarSign", "DownloadCloud", "Edit2", "Edit3", 
+      "FileText", "Gift", "Globe", "Hash", "Key", "Laptop", "Map", "MessageCircle", "MessageSquare", 
+      "Mic", "Monitor", "Package", "Paperclip", "Percent", "Power", "Printer", "Radio", "RotateCcw", 
+      "Save", "Scissors", "Shield", "ShoppingBag", "ShoppingCart", "Slider", "Sliders", "Smartphone", 
+      "Speaker", "Tablet", "Tag", "Target", "ThumbsUp", "ThumbsDown", "ToggleLeft", "ToggleRight", 
+      "Trash", "TrendingUp", "TrendingDown", "Truck", "Tv", "Type", "Umbrella", "Unlock", "UploadCloud", 
+      "Users", "Volume2", "VolumeX", "Wifi", "Wind", "Zap"
+    ])
+
+    let hasNodeModules = false
+    let exportsList: Set<string> | null = null
+
+    // Intentar buscar lucide-react en node_modules
+    const lucidePath = path.resolve(root, "node_modules/lucide-react")
+    if (fs.existsSync(lucidePath)) {
+      try {
+        const nodeScript = `
+          const lucide = require('lucide-react');
+          console.log(JSON.stringify(Object.keys(lucide)));
+        `
+        const output = execSync(`node -e "${nodeScript.replace(/"/g, '\\"')}"`, { cwd: root, stdio: "pipe" }).toString()
+        const keys = JSON.parse(output)
+        exportsList = new Set(keys)
+        hasNodeModules = true
+      } catch (e) {
+        // Fallback
+      }
+    }
+
+    for (const icon of args.icons) {
+      if (hasNodeModules && exportsList) {
+        results[icon] = {
+          valid: exportsList.has(icon),
+          source: "node_modules/lucide-react"
+        }
+      } else {
+        const isPascalCase = /^[A-Z][a-zA-Z0-9]*$/.test(icon)
+        const inCommon = commonIcons.has(icon)
+        results[icon] = {
+          valid: inCommon || isPascalCase,
+          source: inCommon ? "static_common_list" : "pascal_case_fallback"
+        }
+      }
+    }
+
+    return JSON.stringify({
+      status: "SUCCESS",
+      validatedAt: new Date().toISOString(),
+      results
+    }, null, 2)
+  }
+})

package/.opencode/tools/sdd_docker.ts

@@ -0,0 +1,254 @@
+import { tool } from "@opencode-ai/plugin"
+import fs from "fs"
+import path from "path"
+import { execSync } from "child_process"
+
+// Helper to safely resolve root directory (avoiding OpenCode bug where worktree is '/' in non-git repos)
+const getRoot = (context: any) => {
+  if (context?.directory && context.directory !== "/") return context.directory;
+  if (context?.worktree && context.worktree !== "/") return context.worktree;
+  if (context?.cwd && context.cwd !== "/") return context.cwd;
+  return process.cwd();
+};
+
+// Tool: sdd_clean_docker_environment
+export const clean_docker_environment = tool({
+  description: "Limpia de forma agresiva y segura el entorno de Docker: remueve contenedores detenidos, imágenes huérfanas/dangling creadas por compilaciones fallidas, y redes no utilizadas. Se debe ejecutar antes de desplegar un nuevo contenedor para liberar recursos y evitar colisiones.",
+  args: {},
+  async execute(args, context) {
+    const results: Record<string, string> = {}
+    try {
+      results.containers = execSync("docker container prune -f", { encoding: "utf8" }).toString().trim()
+    } catch (e: any) {
+      results.containers = `Error: ${e.message}`
+    }
+
+    try {
+      results.images = execSync("docker image prune -f", { encoding: "utf8" }).toString().trim()
+    } catch (e: any) {
+      results.images = `Error: ${e.message}`
+    }
+
+    try {
+      results.networks = execSync("docker network prune -f", { encoding: "utf8" }).toString().trim()
+    } catch (e: any) {
+      results.networks = `Error: ${e.message}`
+    }
+
+    return JSON.stringify({
+      status: "SUCCESS",
+      message: "Entorno de Docker limpiado de forma segura y exitosa.",
+      details: results
+    }, null, 2)
+  }
+})
+
+// Tool: sdd_generate_dockerfile
+export const generate_dockerfile = tool({
+  description: "Genera Dockerfile multi-stage, .dockerignore y docker-compose.yml optimizados a partir del stack del proyecto (nextjs|fastapi|agnostic). Detecta package manager desde package.json.",
+  args: {
+    stack: tool.schema.enum(["nextjs", "fastapi", "agnostic"]).describe("Stack del proyecto"),
+    port: tool.schema.number().default(3000).describe("Puerto de la aplicación"),
+  },
+  async execute(args, context) {
+    const root = getRoot(context)
+
+    if (args.stack === "agnostic") {
+      const dockerfileAg = `FROM node:20-alpine
+WORKDIR /app
+COPY . .
+RUN npm install --prefer-offline || true
+CMD ["node", "src/index.js"]
+`
+      const filesWritten: string[] = []
+      let content = dockerfileAg
+      let targetName = "src/index.js"
+      if (fs.existsSync(path.resolve(root, "src/main.py"))) {
+        content = `FROM python:3.11-slim
+WORKDIR /app
+COPY . .
+RUN pip install -r requirements.txt || true
+CMD ["python", "src/main.py"]
+`
+        targetName = "src/main.py"
+      }
+      
+      const fullPath = path.resolve(root, "Dockerfile")
+      fs.writeFileSync(fullPath, content, "utf8")
+      filesWritten.push("Dockerfile")
+      
+      return JSON.stringify({
+        status: "SUCCESS",
+        message: `Docker artifacts generados de forma agnóstica para el script de entrada: ${targetName}`,
+        filesWritten
+      }, null, 2)
+    }
+
+    if (args.stack === "nextjs") {
+      const specsDir = path.resolve(root, ".openspec/specs")
+      let filesAffected: string[] = []
+      
+      const p = "npm"
+      let pm = "npm"
+      let installCmd = "npm ci --frozen-lockfile"
+      let buildCmd = "npm run build"
+      if (fs.existsSync(path.resolve(root, "pnpm-lock.yaml"))) {
+        pm = "pnpm"
+        installCmd = "pnpm install --frozen-lockfile"
+        buildCmd = "pnpm build"
+      } else if (fs.existsSync(path.resolve(root, "yarn.lock"))) {
+        pm = "yarn"
+        installCmd = "yarn install --frozen-lockfile"
+        buildCmd = "yarn build"
+      }
+
+      const nodeImage = "node:20-alpine"
+
+      const dockerfile = `# Stage 1: Dependencias
+FROM ${nodeImage} AS deps
+WORKDIR /app
+COPY package.json ${pm === "npm" ? "package-lock.json* " : pm === "pnpm" ? "pnpm-lock.yaml* " : "yarn.lock* "}./
+RUN ${installCmd}
+
+# Stage 2: Constructor
+FROM ${nodeImage} AS builder
+WORKDIR /app
+RUN corepack enable || true
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN ${buildCmd}
+
+# Stage 3: Ejecutor
+FROM ${nodeImage} AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN addgroup --system --gid 1001 nodejs \
+ && adduser --system --uid 1001 nextjs \
+ && mkdir -p public
+
+COPY --from=builder /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+EXPOSE ${args.port}
+ENV PORT=${args.port}
+ENV HOSTNAME="0.0.0.0"
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=30s --retries=3 \
+  CMD node -e "require('http').get('http://localhost:${args.port}', (r) => { process.exit(r.statusCode === 200 ? 0 : 1) }).on('error', () => process.exit(1))"
+
+CMD ["node", "server.js"]
+`
+
+      const dockerignore = `node_modules
+.next
+.git
+.opencode
+.openspec
+.env*
+*.md
+vitest.config.ts
+*.test.ts
+*.spec.ts
+coverage
+playwright-report
+test-results
+`
+
+      const compose = `services:
+  web:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "${args.port}:${args.port}"
+    environment:
+      - NODE_ENV=production
+      - NEXT_TELEMETRY_DISABLED=1
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "node", "-e", "require('http').get('http://localhost:${args.port}', (r) => { process.exit(r.statusCode === 200 ? 0 : 1) }).on('error', () => process.exit(1))"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+`
+
+      const filesWritten: string[] = []
+      for (const [name, content] of [
+        ["Dockerfile", dockerfile],
+        [".dockerignore", dockerignore],
+        ["docker-compose.yml", compose],
+      ] as const) {
+        const fullPath = path.resolve(root, name)
+        fs.writeFileSync(fullPath, content, "utf8")
+        filesWritten.push(path.relative(root, fullPath))
+      }
+
+      return JSON.stringify({
+        status: "SUCCESS",
+        message: `Docker artifacts generados (${pm}, ${nodeImage}, puerto ${args.port})`,
+        filesWritten,
+        packageManager: pm,
+        nodeImage,
+      }, null, 2)
+    }
+
+    // fastapi path
+    const dockerfilePy = `FROM python:3.11-slim
+WORKDIR /app
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+ && rm -rf /var/lib/apt/lists/*
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY src/ ./src/
+EXPOSE ${args.port}
+CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "${args.port}"]
+`
+    const dockerignorePy = `__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+.git
+.opencode
+.openspec
+.pytest_cache/
+tests/
+`
+    const composePy = `services:
+  api:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "${args.port}:${args.port}"
+    environment:
+      - ENV=production
+    restart: unless-stopped
+`
+    const filesWritten: string[] = []
+    for (const [name, content] of [
+      ["Dockerfile", dockerfilePy],
+      [".dockerignore", dockerignorePy],
+      ["docker-compose.yml", composePy],
+    ] as const) {
+      const fullPath = path.resolve(root, name)
+      fs.writeFileSync(fullPath, content, "utf8")
+      filesWritten.push(path.relative(root, fullPath))
+    }
+
+    return JSON.stringify({
+      status: "SUCCESS",
+      message: `Docker artifacts generados para FastAPI (puerto ${args.port})`,
+      filesWritten,
+    }, null, 2)
+  }
+})