codymaster 4.1.4 → 4.4.1

package/skills/cm-ux-master/scripts/pro_stubs.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+"""
+MasterDesign Agent — Pro Feature Stubs (Free Tier)
+
+Provides stub functions for all Pro features that display upgrade banners.
+When users call Pro features without a license, they see what they're
+missing and how to upgrade — the most powerful FOMO mechanism.
+
+Usage:
+    python3 pro_stubs.py token_mapper
+    python3 pro_stubs.py design_doc
+    python3 pro_stubs.py project_registry
+    python3 pro_stubs.py harvest_session
+    python3 pro_stubs.py semi_mcp_bridge
+"""
+import sys
+import os
+
+sys.path.insert(0, os.path.dirname(__file__))
+from license import require_pro
+
+
+PRO_FEATURES = {
+    "token_mapper": {
+        "name": "Token Mapper",
+        "description": "Map 80+ harvested tokens → Semi Design CSS variables, Figma Tokens Studio JSON, and human-readable markdown summary.",
+        "example": (
+            "python3 scripts/token_mapper.py -i harvest.json --project myapp\n"
+            "  → output/myapp/semi-theme-override.css\n"
+            "  → output/myapp/figma-tokens.json\n"
+            "  → output/myapp/token-summary.md"
+        ),
+    },
+    "design_doc": {
+        "name": "Design Doc Generator",
+        "description": "Generate a beautiful, self-contained HTML documentation page with interactive color swatches, typography specimens, component previews, and dark mode toggle.",
+        "example": (
+            "python3 scripts/design_doc_generator.py --project myapp --open\n"
+            "  → output/myapp/design-system.html (single-file, shareable)"
+        ),
+    },
+    "project_registry": {
+        "name": "Multi-Project Registry",
+        "description": "Manage multiple harvested design systems. Track pages scanned, auto-merge harvests, maintain project manifests.",
+        "example": (
+            "python3 scripts/project_registry.py --create 'MyApp' --url https://myapp.com\n"
+            "python3 scripts/project_registry.py --list\n"
+            "python3 scripts/project_registry.py --add-harvest myapp -i harvest.json"
+        ),
+    },
+    "harvest_session": {
+        "name": "Multi-Harvest Merge",
+        "description": "Merge harvests from multiple pages using voting/frequency strategies. Calculate confidence scores for each design token.",
+        "example": (
+            "python3 scripts/harvest_session.py page1.json page2.json page3.json \\\n"
+            "  -o merged.json --confidence"
+        ),
+    },
+    "semi_mcp_bridge": {
+        "name": "Semi MCP Bridge",
+        "description": "Map harvested UI patterns to Semi Design components. Auto-detect layout types (sidebar, dashboard, form, table, card-grid) and generate React templates with correct Semi components.",
+        "example": (
+            "from semi_mcp_bridge import build_harvest_bundle\n"
+            "bundle = build_harvest_bundle(harvest_data, semi_tokens)"
+        ),
+    },
+}
+
+
+def show_feature_stub(feature_key: str):
+    """Show detailed stub for a specific Pro feature."""
+    feature = PRO_FEATURES.get(feature_key)
+    if not feature:
+        print(f"Unknown feature: {feature_key}")
+        print(f"Available: {', '.join(PRO_FEATURES.keys())}")
+        return
+
+    # Check license first
+    if require_pro(feature["name"]):
+        print(f"✅ {feature['name']} is available! Run the actual script.")
+        return
+
+    # Show what they're missing
+    print(f"  📋 {feature['description']}")
+    print()
+    print(f"  Example usage:")
+    for line in feature["example"].split("\n"):
+        print(f"    {line}")
+    print()
+
+
+def show_all_features():
+    """Show overview of all Pro features."""
+    print()
+    print("┌──────────────────────────────────────────────────────┐")
+    print("│           MasterDesign Agent Pro — Feature Overview            │")
+    print("├──────────────────────────────────────────────────────┤")
+    
+    for key, feature in PRO_FEATURES.items():
+        print(f"│  🔒 {feature['name']:<46}│")
+        # Wrap description
+        desc = feature["description"]
+        while desc:
+            chunk = desc[:48]
+            desc = desc[48:]
+            print(f"│     {chunk:<47}│")
+    
+    print("├──────────────────────────────────────────────────────┤")
+    print("│  → https://ux-master.dev/pro                         │")
+    print("│  One-time payment. Lifetime access.                   │")
+    print("│  All future updates included.                         │")
+    print("└──────────────────────────────────────────────────────┘")
+    print()
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2 or sys.argv[1] in ("--help", "-h", "all"):
+        show_all_features()
+    else:
+        show_feature_stub(sys.argv[1])

package/skills/cm-ux-master/scripts/project_registry.py

@@ -0,0 +1,217 @@
+#!/usr/bin/env python3
+"""
+Project Registry — Manages multiple harvested design systems.
+
+Each project lives in output/<slug>/ with:
+  ├── manifest.json        # Project metadata + pages scanned
+  ├── harvest-raw.json     # Merged raw harvest
+  ├── semi-theme-override.css
+  ├── figma-tokens.json
+  └── design-system.html   # Doc site (Enhancement 3)
+"""
+import json
+import os
+import re
+import shutil
+from datetime import datetime, timezone
+from pathlib import Path
+
+
+OUTPUT_DIR = Path(__file__).parent.parent / "output"
+
+
+def slugify(name: str) -> str:
+    """Convert project name to URL-safe slug."""
+    slug = name.lower().strip()
+    slug = re.sub(r'[^a-z0-9\s-]', '', slug)
+    slug = re.sub(r'[\s-]+', '-', slug)
+    return slug.strip('-')
+
+
+class ProjectRegistry:
+    """Manages multiple harvested design systems."""
+
+    def __init__(self, output_dir: Path = None):
+        self.output_dir = output_dir or OUTPUT_DIR
+        self.output_dir.mkdir(parents=True, exist_ok=True)
+
+    def create(self, name: str, url: str) -> dict:
+        """Create a new project. Returns ProjectInfo dict."""
+        slug = slugify(name)
+        project_dir = self.output_dir / slug
+        project_dir.mkdir(parents=True, exist_ok=True)
+
+        manifest = {
+            "name": name,
+            "slug": slug,
+            "url": url,
+            "created_at": datetime.now(timezone.utc).isoformat(),
+            "updated_at": datetime.now(timezone.utc).isoformat(),
+            "pages": [],
+            "harvest_count": 0,
+        }
+
+        self._write_manifest(slug, manifest)
+        return manifest
+
+    def get(self, slug: str) -> dict:
+        """Get project info by slug. Returns None if not found."""
+        manifest_path = self.output_dir / slug / "manifest.json"
+        if not manifest_path.exists():
+            return None
+        with open(manifest_path, "r") as f:
+            return json.load(f)
+
+    def list_all(self) -> list:
+        """List all registered projects."""
+        projects = []
+        if not self.output_dir.exists():
+            return projects
+        for entry in sorted(self.output_dir.iterdir()):
+            if entry.is_dir():
+                manifest_path = entry / "manifest.json"
+                if manifest_path.exists():
+                    with open(manifest_path, "r") as f:
+                        projects.append(json.load(f))
+        return projects
+
+    def add_page_harvest(self, slug: str, page_harvest: dict) -> dict:
+        """Add a page harvest to a project. Returns updated manifest."""
+        manifest = self.get(slug)
+        if manifest is None:
+            raise ValueError(f"Project '{slug}' not found")
+
+        # Track page URL
+        page_url = page_harvest.get("meta", {}).get("url", "unknown")
+        page_entry = {
+            "url": page_url,
+            "timestamp": page_harvest.get("meta", {}).get("timestamp", ""),
+            "title": page_harvest.get("meta", {}).get("title", ""),
+        }
+        manifest["pages"].append(page_entry)
+        manifest["harvest_count"] = len(manifest["pages"])
+        manifest["updated_at"] = datetime.now(timezone.utc).isoformat()
+
+        # Save raw harvest for this page
+        harvests_dir = self.output_dir / slug / "harvests"
+        harvests_dir.mkdir(exist_ok=True)
+        harvest_file = harvests_dir / f"page-{manifest['harvest_count']}.json"
+        with open(harvest_file, "w") as f:
+            json.dump(page_harvest, f, indent=2, ensure_ascii=False)
+
+        # Merge all harvests into single harvest-raw.json
+        merged = self._merge_project_harvests(slug)
+        merged_path = self.output_dir / slug / "harvest-raw.json"
+        with open(merged_path, "w") as f:
+            json.dump(merged, f, indent=2, ensure_ascii=False)
+
+        self._write_manifest(slug, manifest)
+        return manifest
+
+    def delete(self, slug: str) -> bool:
+        """Delete a project directory. Returns True if deleted."""
+        project_dir = self.output_dir / slug
+        if not project_dir.exists():
+            return False
+        shutil.rmtree(project_dir)
+        return True
+
+    def get_project_dir(self, slug: str) -> Path:
+        """Get the output directory path for a project."""
+        return self.output_dir / slug
+
+    def get_merged_harvest(self, slug: str) -> dict:
+        """Get the merged harvest data for a project."""
+        merged_path = self.output_dir / slug / "harvest-raw.json"
+        if not merged_path.exists():
+            return None
+        with open(merged_path, "r") as f:
+            return json.load(f)
+
+    def _write_manifest(self, slug: str, manifest: dict):
+        """Write manifest.json to project directory."""
+        manifest_path = self.output_dir / slug / "manifest.json"
+        with open(manifest_path, "w") as f:
+            json.dump(manifest, f, indent=2, ensure_ascii=False)
+
+    def _merge_project_harvests(self, slug: str) -> dict:
+        """Merge all page harvests into a single consolidated harvest."""
+        harvests_dir = self.output_dir / slug / "harvests"
+        if not harvests_dir.exists():
+            return {}
+
+        harvests = []
+        for f in sorted(harvests_dir.glob("page-*.json")):
+            with open(f, "r") as fp:
+                harvests.append(json.load(fp))
+
+        if not harvests:
+            return {}
+        if len(harvests) == 1:
+            return harvests[0]
+
+        # Use harvest_session.merge_harvests if available
+        try:
+            from harvest_session import merge_harvests
+            return merge_harvests(harvests)
+        except ImportError:
+            # Fallback: use last harvest
+            return harvests[-1]
+
+
+# ============ CLI ============
+
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Project Registry — Manage design system projects")
+    parser.add_argument("--create", metavar="NAME", help="Create a new project")
+    parser.add_argument("--url", default="", help="Project source URL (used with --create)")
+    parser.add_argument("--list", action="store_true", help="List all projects")
+    parser.add_argument("--get", metavar="SLUG", help="Get project info")
+    parser.add_argument("--delete", metavar="SLUG", help="Delete a project")
+    parser.add_argument("--add-harvest", metavar="SLUG", help="Add harvest to project")
+    parser.add_argument("--input", "-i", help="Input JSON file (used with --add-harvest)")
+
+    args = parser.parse_args()
+    registry = ProjectRegistry()
+
+    if args.create:
+        info = registry.create(args.create, args.url)
+        print(f"[OK] Created project '{info['slug']}' at output/{info['slug']}/")
+        print(json.dumps(info, indent=2))
+
+    elif args.list:
+        projects = registry.list_all()
+        if not projects:
+            print("No projects found.")
+        else:
+            print(f"Found {len(projects)} project(s):\n")
+            for p in projects:
+                pages = p.get("harvest_count", 0)
+                print(f"  [{p['slug']}] {p['name']} — {pages} page(s) — {p['url']}")
+
+    elif args.get:
+        info = registry.get(args.get)
+        if info:
+            print(json.dumps(info, indent=2))
+        else:
+            print(f"Project '{args.get}' not found.")
+
+    elif args.delete:
+        if registry.delete(args.delete):
+            print(f"[OK] Deleted project '{args.delete}'")
+        else:
+            print(f"Project '{args.delete}' not found.")
+
+    elif args.add_harvest:
+        if not args.input:
+            print("Error: --input/-i required with --add-harvest")
+        else:
+            with open(args.input, "r") as f:
+                harvest = json.load(f)
+            manifest = registry.add_page_harvest(args.add_harvest, harvest)
+            print(f"[OK] Added harvest #{manifest['harvest_count']} to '{args.add_harvest}'")
+
+    else:
+        parser.print_help()

package/skills/cm-ux-master/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+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')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['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)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))