lokuma-cli 1.3.4 → 1.3.6

package/README.md

@@ -68,7 +68,7 @@ Options:
 `lokuma-cli` installs two files into your project:
 
 1. **SKILL.md** — tells your AI assistant how to use Lokuma
-2. **search.py** — a lightweight cloud client that calls the Lokuma API
+2. **design.py** — a lightweight cloud client that calls the Lokuma API
 
 No local data files. No Python dependencies. Just set your API key and go.
 

package/dist/index.js

@@ -54,22 +54,22 @@ var AI_DISPLAY_NAMES = {
   all: "All assistants"
 };
 var AI_SKILL_PATHS = {
-  claude: { root: ".claude", skillMd: ".claude/skills/lokuma/SKILL.md", scriptPy: ".claude/skills/lokuma/scripts/search.py" },
-  cursor: { root: ".cursor", skillMd: ".cursor/rules/lokuma.mdc", scriptPy: ".cursor/rules/lokuma/scripts/search.py" },
-  windsurf: { root: ".windsurf", skillMd: ".windsurf/rules/lokuma.md", scriptPy: ".windsurf/rules/lokuma/scripts/search.py" },
-  copilot: { root: ".github", skillMd: ".github/instructions/lokuma.instructions.md", scriptPy: ".github/instructions/lokuma/scripts/search.py" },
-  kiro: { root: ".kiro", skillMd: ".kiro/steering/lokuma.md", scriptPy: ".kiro/steering/lokuma/scripts/search.py" },
-  roocode: { root: ".roo", skillMd: ".roo/rules/lokuma.md", scriptPy: ".roo/rules/lokuma/scripts/search.py" },
-  codex: { root: ".codex", skillMd: ".codex/instructions.md", scriptPy: ".codex/lokuma/scripts/search.py" },
-  qoder: { root: ".qoder", skillMd: ".qoder/rules/lokuma.md", scriptPy: ".qoder/rules/lokuma/scripts/search.py" },
-  gemini: { root: ".gemini", skillMd: ".gemini/GEMINI.md", scriptPy: ".gemini/lokuma/scripts/search.py" },
-  trae: { root: ".trae", skillMd: ".trae/rules/lokuma.md", scriptPy: ".trae/rules/lokuma/scripts/search.py" },
-  opencode: { root: ".opencode", skillMd: ".opencode/OPENCODE.md", scriptPy: ".opencode/lokuma/scripts/search.py" },
-  continue: { root: ".continue", skillMd: ".continue/lokuma/SKILL.md", scriptPy: ".continue/lokuma/scripts/search.py" },
-  codebuddy: { root: ".codebuddy", skillMd: ".codebuddy/lokuma/SKILL.md", scriptPy: ".codebuddy/lokuma/scripts/search.py" },
-  droid: { root: ".factory", skillMd: ".factory/skills/lokuma/SKILL.md", scriptPy: ".factory/skills/lokuma/scripts/search.py" },
+  claude: { root: ".claude", skillMd: ".claude/skills/lokuma/SKILL.md", scriptPy: ".claude/skills/lokuma/scripts/design.py" },
+  cursor: { root: ".cursor", skillMd: ".cursor/rules/lokuma.mdc", scriptPy: ".cursor/rules/lokuma/scripts/design.py" },
+  windsurf: { root: ".windsurf", skillMd: ".windsurf/rules/lokuma.md", scriptPy: ".windsurf/rules/lokuma/scripts/design.py" },
+  copilot: { root: ".github", skillMd: ".github/instructions/lokuma.instructions.md", scriptPy: ".github/instructions/lokuma/scripts/design.py" },
+  kiro: { root: ".kiro", skillMd: ".kiro/steering/lokuma.md", scriptPy: ".kiro/steering/lokuma/scripts/design.py" },
+  roocode: { root: ".roo", skillMd: ".roo/rules/lokuma.md", scriptPy: ".roo/rules/lokuma/scripts/design.py" },
+  codex: { root: ".codex", skillMd: ".codex/instructions.md", scriptPy: ".codex/lokuma/scripts/design.py" },
+  qoder: { root: ".qoder", skillMd: ".qoder/rules/lokuma.md", scriptPy: ".qoder/rules/lokuma/scripts/design.py" },
+  gemini: { root: ".gemini", skillMd: ".gemini/GEMINI.md", scriptPy: ".gemini/lokuma/scripts/design.py" },
+  trae: { root: ".trae", skillMd: ".trae/rules/lokuma.md", scriptPy: ".trae/rules/lokuma/scripts/design.py" },
+  opencode: { root: ".opencode", skillMd: ".opencode/OPENCODE.md", scriptPy: ".opencode/lokuma/scripts/design.py" },
+  continue: { root: ".continue", skillMd: ".continue/lokuma/SKILL.md", scriptPy: ".continue/lokuma/scripts/design.py" },
+  codebuddy: { root: ".codebuddy", skillMd: ".codebuddy/lokuma/SKILL.md", scriptPy: ".codebuddy/lokuma/scripts/design.py" },
+  droid: { root: ".factory", skillMd: ".factory/skills/lokuma/SKILL.md", scriptPy: ".factory/skills/lokuma/scripts/design.py" },
   // OpenClaw installs to a fixed absolute path (not relative to cwd)
-  openclaw: { root: "~/.openclaw/workspace/skills/lokuma", skillMd: "~/.openclaw/workspace/skills/lokuma/SKILL.md", scriptPy: "~/.openclaw/workspace/skills/lokuma/scripts/search.py" }
+  openclaw: { root: "~/.openclaw/workspace/skills/lokuma", skillMd: "~/.openclaw/workspace/skills/lokuma/SKILL.md", scriptPy: "~/.openclaw/workspace/skills/lokuma/scripts/design.py" }
 };
 
 // src/commands/init.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lokuma-cli",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "CLI to install Lokuma design intelligence skill for AI coding assistants",
   "type": "module",
   "bin": {

package/assets/search.py

@@ -1,229 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Lokuma Search - Cloud Client
-Calls the Lokuma cloud API to generate design intelligence.
-
-Usage:
-  python search.py "<natural language design request>" [--domain <domain>] [--max-results 3]
-  python search.py "<natural language design request>" --stack <stack>
-  python search.py "<natural language product/design brief>" --design-system [-p "Project Name"] [-f ascii|markdown|json]
-
-Examples:
-  python search.py "A meditation app for stressed professionals. Calm, premium, organic." --design-system -p "Still"
-  python search.py "Need a calm but premium color direction for a wellness app" --domain color
-  python search.py "Best landing page structure for an AI productivity SaaS that needs signups" --domain landing
-  python search.py "Navigation performance and gestures for a React Native app" --stack react-native
-
-Configuration:
-  Set LOKUMA_API_KEY environment variable (required):
-    export LOKUMA_API_KEY=lokuma_your_key_here
-
-  Optional overrides:
-    LOKUMA_API_URL=https://custom.endpoint.com   (default: official API)
-
-Domains: style, color, chart, landing, product, reasoning, ux, typography,
-         google-fonts, icons
-Stacks: react-native
-"""
-
-import argparse
-import json
-import os
-import sys
-import io
-import urllib.request
-import urllib.error
-from typing import Optional
-
-# Force UTF-8 output on Windows
-if sys.stdout.encoding and sys.stdout.encoding.lower() != "utf-8":
-    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8")
-if sys.stderr.encoding and sys.stderr.encoding.lower() != "utf-8":
-    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8")
-
-
-# ─────────────────────────────────────────────
-# Config
-# ─────────────────────────────────────────────
-
-API_BASE = os.environ.get("LOKUMA_API_URL", "https://api.lokuma.ai").rstrip("/")
-API_VERSION = "v1"
-_BASE = f"{API_BASE}/{API_VERSION}"
-
-
-def _get_api_key() -> str:
-    key = os.environ.get("LOKUMA_API_KEY", "").strip()
-    if not key:
-        print(
-            "Error: LOKUMA_API_KEY is not set.\n"
-            "Set it with:  export LOKUMA_API_KEY=lokuma_your_key_here",
-            file=sys.stderr,
-        )
-        sys.exit(1)
-    return key
-
-
-# ─────────────────────────────────────────────
-# HTTP client (stdlib only, zero deps)
-# ─────────────────────────────────────────────
-
-def _post(endpoint: str, payload: dict) -> dict:
-    """POST JSON payload to API endpoint, return parsed response."""
-    api_key = _get_api_key()
-    url = f"{_BASE}/{endpoint}"
-    data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
-
-    req = urllib.request.Request(
-        url,
-        data=data,
-        headers={
-            "Content-Type": "application/json",
-            "X-API-Key": api_key,
-            "User-Agent": "lokuma-skill/1.0",
-        },
-        method="POST",
-    )
-
-    try:
-        with urllib.request.urlopen(req, timeout=30) as resp:
-            body = resp.read().decode("utf-8")
-            return json.loads(body)
-    except urllib.error.HTTPError as e:
-        body = e.read().decode("utf-8", errors="replace")
-        try:
-            err = json.loads(body)
-            msg = err.get("error", body)
-        except Exception:
-            msg = body
-        if e.code == 401 or e.code == 403:
-            print(f"Error: Invalid or expired API key (HTTP {e.code})", file=sys.stderr)
-        else:
-            print(f"Error: API returned HTTP {e.code}: {msg}", file=sys.stderr)
-        sys.exit(1)
-    except urllib.error.URLError as e:
-        print(f"Error: Could not reach API at {url}: {e.reason}", file=sys.stderr)
-        sys.exit(1)
-    except json.JSONDecodeError as e:
-        print(f"Error: Invalid JSON response from API: {e}", file=sys.stderr)
-        sys.exit(1)
-
-
-# ─────────────────────────────────────────────
-# API wrappers
-# ─────────────────────────────────────────────
-
-def search(query: str, domain: Optional[str] = None, max_results: int = 3) -> dict:
-    payload = {"query": query, "max_results": max_results}
-    if domain:
-        payload["domain"] = domain
-    return _post("search", payload)
-
-
-def search_stack(query: str, stack: str, max_results: int = 3) -> dict:
-    return _post("search/stack", {"query": query, "stack": stack, "max_results": max_results})
-
-
-def design_system(query: str, project_name: Optional[str] = None, fmt: str = "ascii") -> dict:
-    payload = {"query": query, "format": fmt}
-    if project_name:
-        payload["project_name"] = project_name
-    return _post("design-system", payload)
-
-
-# ─────────────────────────────────────────────
-# Output formatting (mirrors original search.py)
-# ─────────────────────────────────────────────
-
-def format_search_output(result: dict) -> str:
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append("## Lokuma Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append("## Lokuma Search Results")
-        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
-
-    source = result.get("file") or result.get("source") or "cloud API"
-    output.append(f"**Source:** {source} | **Found:** {result.get('count', len(result.get('results', [])))} results\n")
-
-    for i, row in enumerate(result.get("results", []), 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if len(value_str) > 300:
-                value_str = value_str[:300] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-# ─────────────────────────────────────────────
-# CLI
-# ─────────────────────────────────────────────
-
-VALID_DOMAINS = [
-    "style", "color", "chart", "landing", "product", "reasoning", "ux",
-    "typography", "google-fonts", "icons",
-]
-VALID_STACKS = ["react-native"]
-
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="Lokuma Cloud Search",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog=__doc__,
-    )
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=VALID_DOMAINS, help="Search domain")
-    parser.add_argument("--stack", "-s", choices=VALID_STACKS, help="Stack-specific search")
-    parser.add_argument("--max-results", "-n", type=int, default=3, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output raw JSON")
-    # Design system flags
-    parser.add_argument("--design-system", "-ds", action="store_true",
-                        help="Generate complete design system")
-    parser.add_argument("--project-name", "-p", type=str, default=None,
-                        help="Project name for design system header")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown", "json"],
-                        default="ascii", help="Output format for design system")
-
-    args = parser.parse_args()
-
-    # ── Design system ──
-    if args.design_system:
-        fmt = args.format
-        result = design_system(args.query, args.project_name, fmt)
-        if args.json:
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        elif fmt == "json":
-            # Pretty-print the nested design_system dict
-            ds = result.get("design_system", result)
-            print(json.dumps(ds, indent=2, ensure_ascii=False))
-        else:
-            print(result.get("output", ""))
-        return
-
-    # ── Stack search ──
-    if args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_search_output(result))
-        return
-
-    # ── Domain search ──
-    result = search(args.query, args.domain, args.max_results)
-    if args.json:
-        print(json.dumps(result, indent=2, ensure_ascii=False))
-    else:
-        print(format_search_output(result))
-
-
-if __name__ == "__main__":
-    main()