lokuma-cli 1.3.5 → 1.3.7

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/assets/design.py

@@ -106,6 +106,20 @@ def _post(endpoint: str, payload: dict) -> dict:
         sys.exit(1)
 
 
+# ─────────────────────────────────────────────
+# Image reminder (appended to every recommendation)
+# ─────────────────────────────────────────────
+
+IMAGE_REMINDER = (
+    "\n\n---\n"
+    "> **Image requirement:** Always include real images when generating UI. "
+    "Use high-quality placeholder sources such as Unsplash (`https://source.unsplash.com/...`) "
+    "or Picsum (`https://picsum.photos/...`). "
+    "Every hero section, card, and media slot must have an actual `<img>` tag or CSS background image. "
+    "Do not leave image areas empty, use placeholder boxes, or skip images entirely."
+)
+
+
 # ─────────────────────────────────────────────
 # Output formatting
 # ─────────────────────────────────────────────
@@ -114,11 +128,50 @@ def _format_output(result: dict, fmt: str) -> str:
     if "error" in result:
         return f"Error: {result['error']}"
 
-    # design-system response (has "output" key for ascii/markdown)
+    # ── Print low-balance warning if present ──────────────────────────────────
+    warning = result.get("warning")
+    if warning:
+        print(f"\n⚠️  {warning}\n", file=sys.stderr)
+
+    # ── New /v1/design response: domains + recommendation ─────────────────────
+    if "recommendation" in result:
+        if fmt == "json":
+            return json.dumps(result, indent=2, ensure_ascii=False)
+
+        lines = []
+        project = result.get("project_name")
+        if project:
+            lines.append(f"# {project}\n")
+
+        # Per-domain matches summary
+        domains = result.get("domains", {})
+        if domains:
+            lines.append("## Domain Matches\n")
+            for domain, data in domains.items():
+                match = data.get("match", {}) if isinstance(data, dict) else {}
+                # pick a representative label from the match
+                label = (
+                    match.get("name") or match.get("Font Pairing Name") or
+                    match.get("Pattern Name") or match.get("Product Type") or
+                    match.get("Category") or match.get("family") or
+                    next(iter(match.values()), "") if match else ""
+                )
+                lines.append(f"- **{domain}**: {label}")
+            lines.append("")
+
+        # Main recommendation
+        lines.append(result["recommendation"])
+
+        # Append image reminder
+        lines.append(IMAGE_REMINDER)
+
+        return "\n".join(lines)
+
+    # ── Legacy: design-system response (has "output" key) ────────────────────
     if "output" in result:
-        return result["output"]
+        return result["output"] + IMAGE_REMINDER
 
-    # design-system json response
+    # ── Legacy: design-system json response ──────────────────────────────────
     if "design_system" in result:
         ds = result["design_system"]
         if fmt == "json":
@@ -134,13 +187,13 @@ def _format_output(result: dict, fmt: str) -> str:
             else:
                 lines.append(str(data))
             lines.append("")
-        return "\n".join(lines)
+        return "\n".join(lines) + IMAGE_REMINDER
 
-    # multi-domain response
+    # ── Legacy: multi-domain response ────────────────────────────────────────
     if result.get("strategy") == "multi":
         if fmt == "json":
             return json.dumps(result, indent=2, ensure_ascii=False)
-        lines = [f"## Lokuma Design Results\n"]
+        lines = ["## Lokuma Design Results\n"]
         for r in result.get("results", []):
             domain = r.get("domain", "")
             lines.append(f"### {domain.title()}")
@@ -149,9 +202,9 @@ def _format_output(result: dict, fmt: str) -> str:
                     f"{k}: {str(v)[:100]}" for k, v in list(row.items())[:4]
                 ))
             lines.append("")
-        return "\n".join(lines)
+        return "\n".join(lines) + IMAGE_REMINDER
 
-    # single-domain response
+    # ── Legacy: single-domain response ───────────────────────────────────────
     if fmt == "json":
         return json.dumps(result, indent=2, ensure_ascii=False)
 
@@ -165,7 +218,7 @@ def _format_output(result: dict, fmt: str) -> str:
                 v = v[:300] + "..."
             lines.append(f"- **{key}:** {v}")
         lines.append("")
-    return "\n".join(lines)
+    return "\n".join(lines) + IMAGE_REMINDER
 
 
 # ─────────────────────────────────────────────

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.5",
+  "version": "1.3.7",
   "description": "CLI to install Lokuma design intelligence skill for AI coding assistants",
   "type": "module",
   "bin": {