@newpeak/barista-cli 0.1.131 → 0.1.132

package/skills/barista-cli/scripts/search.py

@@ -0,0 +1,194 @@
+#!/usr/bin/env python3
+"""
+search.py — Barista CLI 意图搜索
+
+AI agent 通过此脚本根据用户意图查询相关命令。
+SKILL.md 指导 AI 在需要查找命令时调用此脚本。
+
+用法：
+  python3 search.py "<query>" [--domain <domain>] [--format text|json] [--max N]
+
+示例：
+  python3 search.py "采购订单"
+  python3 search.py "创建入库单" --domain liberica
+  python3 search.py "subscription" --domain arabica
+  python3 search.py "invoice" --domain arabica.invoices
+"""
+
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Any
+
+
+def load_data() -> dict[str, Any]:
+    """Load commands data from JSON or YAML file."""
+    script_dir = Path(__file__).resolve().parent
+    data_dir = script_dir.parent / "data"
+
+    json_path = data_dir / "commands.json"
+    yaml_path = data_dir / "commands.yaml"
+
+    if json_path.exists():
+        with open(json_path, "r", encoding="utf-8") as f:
+            return json.load(f)
+
+    if yaml_path.exists():
+        try:
+            import yaml as yaml_lib
+            with open(yaml_path, "r", encoding="utf-8") as f:
+                return yaml_lib.safe_load(f)
+        except ImportError:
+            # Fallback: parse YAML lines manually (basic)
+            return fallback_to_json(yaml_path)
+
+    sys.stderr.write("❌ No commands data found. Run 'npm run generate-skills-data' first.\n")
+    sys.exit(1)
+
+
+def fallback_to_json(yaml_path: Path) -> dict[str, Any]:
+    """Fallback to JSON when PyYAML is not installed."""
+    sys.stderr.write("⚠️  PyYAML not installed. Install with: pip install pyyaml\n")
+    sys.stderr.write("   Falling back to JSON format (if available).\n")
+    json_path = yaml_path.with_suffix(".json")
+    if json_path.exists():
+        with open(json_path, "r", encoding="utf-8") as f:
+            return json.load(f)
+    return {"global": {}, "liberica": {}, "arabica": {}}
+
+
+def flatten_commands(data: dict[str, Any]) -> list[dict[str, Any]]:
+    """Flatten nested command structure into a searchable list."""
+    results = []
+    for service in ["global", "liberica", "arabica"]:
+        svc_data = data.get(service, {})
+        for module_name, module in svc_data.items():
+            group = module.get("group", "")
+            for cmd_name, cmd in module.get("commands", {}).items():
+                desc = cmd.get("description", "")
+                options = cmd.get("options", [])
+                results.append({
+                    "service": service,
+                    "module": module_name,
+                    "group": group,
+                    "action": cmd_name,
+                    "description": desc,
+                    "options": options,
+                    # For relevance scoring
+                    "keywords": f"{module_name} {cmd_name} {group} {desc} {service}".lower(),
+                })
+    return results
+
+
+def search(flat: list[dict[str, Any]], query: str, domain: str = "", max_results: int = 10) -> list[dict[str, Any]]:
+    """Search commands by keyword matching with relevance scoring."""
+    query_lower = query.lower()
+    query_words = [w for w in query_lower.split() if len(w) > 1]
+
+    if not query_words:
+        return []
+
+    scored = []
+    for cmd in flat:
+        # Domain filter
+        if domain:
+            domain_lower = domain.lower()
+            if domain_lower == "liberica" and cmd["service"] != "liberica":
+                continue
+            if domain_lower == "arabica" and cmd["service"] != "arabica":
+                continue
+            if domain_lower.startswith("liberica."):
+                mod = domain_lower[len("liberica."):]
+                if cmd["module"] != mod and not cmd["module"].startswith(mod + "/"):
+                    continue
+            if domain_lower.startswith("arabica."):
+                mod = domain_lower[len("arabica."):]
+                if cmd["module"] != mod:
+                    continue
+
+        # Relevance scoring
+        keywords = cmd["keywords"]
+        score = 0
+        matched_words = []
+
+        for word in query_words:
+            if word in keywords:
+                score += 3
+                matched_words.append(word)
+            # Partial match (substring)
+            elif any(word in kw_part for kw_part in keywords.split()):
+                score += 1
+                matched_words.append(word)
+
+        # Boost exact module match
+        if query_lower == cmd["module"]:
+            score += 5
+        if query_lower == cmd["action"]:
+            score += 3
+        # Boost description match priority
+        if any(w in cmd["description"].lower() for w in query_words):
+            score += 2
+
+        if score > 0:
+            scored.append((score, cmd))
+
+    # Sort by score descending
+    scored.sort(key=lambda x: -x[0])
+    return [cmd for _, cmd in scored[:max_results]]
+
+
+def format_text(results: list[dict[str, Any]]) -> str:
+    """Format results as human-readable text."""
+    if not results:
+        return "No matching commands found."
+
+    lines = []
+    last_service = ""
+    last_group = ""
+
+    for r in results:
+        if r["service"] != last_service:
+            lines.append(f"[{r['service'].upper()}]")
+            last_service = r["service"]
+            last_group = ""
+
+        if r["group"] != last_group:
+            lines.append(f"  {r['group']}:")
+            last_group = r["group"]
+
+        opts = ""
+        if r["options"]:
+            opts = " [" + ", ".join(str(o) for o in r["options"]) + "]"
+        desc = f" — {r['description']}" if r["description"] else ""
+        lines.append(f"    barista {r['service']} {r['module']} {r['action']}{opts}{desc}")
+
+    lines.append("")
+    lines.append(f"({len(results)} commands found)")
+    return "\n".join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Barista CLI command search")
+    parser.add_argument("query", help="Search query (user intent)")
+    parser.add_argument("--domain", default="",
+                        help="Filter by domain (liberica, arabica, liberica.purchase-orders, etc.)")
+    parser.add_argument("--format", choices=["text", "json"], default="text",
+                        help="Output format")
+    parser.add_argument("--max", type=int, default=10,
+                        help="Maximum results (default: 10)")
+
+    args = parser.parse_args()
+
+    data = load_data()
+    flat = flatten_commands(data)
+    results = search(flat, args.query, args.domain, args.max)
+
+    if args.format == "json":
+        print(json.dumps({"success": True, "data": {"items": results}}, indent=2, ensure_ascii=False))
+    else:
+        print(format_text(results))
+
+
+if __name__ == "__main__":
+    main()

package/skills/barista-cli/skill.json

@@ -0,0 +1,17 @@
+{
+  "name": "barista-cli",
+  "displayName": "Barista CLI",
+  "version": "0.1.0",
+  "description": "AI agent skill for operating Barista CLI — bridge AI assistants to Liberica production management SaaS and Arabica subscription platform. Covers 70+ Liberica modules (employees, materials, inventory, production, BOM, quality, finance, HR, teams) and 7 Arabica modules (plans, subscription, orders, invoices, enterprises).",
+  "author": "Newpeak Technology",
+  "license": "MIT",
+  "homepage": "https://gitlab.newpeaksh.com/coffee/coffee-barista-cli",
+  "repository": "https://gitlab.newpeaksh.com/coffee/coffee-barista-cli.git",
+  "platforms": ["claude", "cursor", "windsurf", "copilot", "kiro", "roocode", "codex", "qoder", "gemini", "trae", "opencode", "continue", "droid"],
+  "install": "npx @newpeak/barista-cli skills install --ai {{platform}}",
+  "keywords": ["barista", "cli", "liberica", "arabica", "production-management", "saas", "erp", "enterprise"],
+  "metadata": {
+    "dataSource": "auto-generated from src/commands/",
+    "search": "barista skills query <intent> or python3 scripts/search.py"
+  }
+}