@caddis/cli 0.0.0 → 0.2.0

package/bundles/antigravity-plugin/skills/draw-io/references/layout-guidelines.md

@@ -0,0 +1,142 @@
+# Layout Guidelines
+
+## Grouping Principles
+
+### Hierarchy Structure
+```text
+Cloud Provider (outermost)
+├── VPC / Virtual Network
+│   ├── Public Subnet
+│   │   └── Load Balancer, NAT Gateway
+│   └── Private Subnet
+│       └── Application Servers, Databases
+├── Object Storage (S3, Blob, GCS)
+├── Monitoring (CloudWatch, Monitor)
+└── Other Services
+```
+
+### Grouping Rules
+- Security boundaries (DMZ, private, management)
+- Service tiers (frontend, backend, data)
+- Team ownership (team A, team B)
+
+## Flow Directions
+
+### Left-to-Right (Preferred)
+```text
+[Data Source] → [Processing] → [Storage] → [Analysis]
+```
+**Use for:** ETL pipelines, request-response, sequential processing
+
+### Top-to-Bottom (Alternative)
+```text
+[User/Client]
+     ↓
+[Load Balancer]
+     ↓
+[Application]
+     ↓
+[Database]
+```
+**Use for:** User-facing architectures, hierarchical systems
+
+### Hub-and-Spoke
+```text
+    [Service A]
+         ↓
+  [Central Hub] ← [Service C]
+         ↓
+    [Service B]
+```
+**Use for:** API gateway, message bus, service mesh
+
+## Line Types
+
+| Flow Type | Line Style | Use Case |
+|-----------|------------|----------|
+| Data Flow | Solid line | Read/write operations |
+| Data Ingestion | Dashed line | Data import |
+| Control Flow | Dotted line | Management/config |
+| Event Flow | Wavy line | Event-driven |
+
+## Common Patterns
+
+### Three-Tier
+```text
+[Presentation] → [Business Logic] → [Data Access] → [Database]
+```
+
+### Microservices
+```text
+[API Gateway] → [Service A] → [DB A]
+             → [Service B] → [DB B]
+             → [Service C] → [Cache]
+```
+
+### Event-Driven
+```text
+[Producer] → [Event Bus] → [Consumer A]
+                        → [Consumer B]
+```
+
+### Serverless
+```text
+[API Gateway] → [Lambda] → [DynamoDB]
+```
+
+## Visual Clarity Rules
+
+### Spacing
+- **Standard gap**: 100px between elements
+- **Frame margins**: 30px minimum from boundaries
+- **Arrow clearance**: 20px from labels
+
+### Alignment
+- Align elements horizontally or vertically
+- Match center coordinates for alignment
+- Use consistent icon sizes (78x78px standard)
+
+### Labels
+- Position near elements
+- Avoid overlaps
+- Use consistent font (18px+ for presentations)
+- Include units where applicable
+
+## Color Usage
+
+Don't rely on color alone - use with patterns/labels:
+- **Blue**: Standard services
+- **Green**: Success/healthy
+- **Red**: Errors/critical
+- **Yellow**: Warnings
+- **Gray**: Disabled/infrastructure
+
+Ensure WCAG AA contrast (4.5:1 minimum)
+
+## Diagram Types
+
+| Type | Purpose | Include | Audience |
+|------|---------|---------|----------|
+| Context | System boundaries | External actors, system boundary | Executive |
+| System | Main components | Services, databases, flows | Architects |
+| Component | Technical details | APIs, integrations, tech choices | Developers |
+| Deployment | Infrastructure | VPCs, regions, networks | DevOps |
+| Sequence | Time-based interactions | Request/response pairs | Developers |
+
+## Anti-Patterns
+
+### ❌ DON'T:
+- Cross arrows unnecessarily
+- Use tiny fonts (< 14px)
+- Overcrowd diagrams
+- Mix abstraction levels
+- Use vague labels
+- Forget to label arrows
+
+### ✓ DO:
+- Keep diagrams focused
+- Use consistent spacing
+- Label everything clearly
+- Align elements
+- Include legends
+- Version your diagrams

package/bundles/antigravity-plugin/skills/draw-io/references/troubleshooting.md

@@ -0,0 +1,118 @@
+# Troubleshooting Guide
+
+## PNG Not Generated
+
+**Symptoms:** Script runs but no .png file created
+
+**Solutions:**
+1. Check if drawio CLI is installed:
+   ```bash
+   drawio --version
+   ```
+   
+2. Install if missing:
+   - macOS: `brew install drawio`
+   - Linux: Download from https://github.com/jgraph/drawio-desktop/releases
+   - Windows: Download from https://www.drawio.com/
+
+3. Check file permissions:
+   ```bash
+   ls -l your-diagram.drawio
+   chmod 644 your-diagram.drawio  # If needed
+   ```
+
+4. Verify .drawio file is valid XML:
+   ```bash
+   xmllint --noout your-diagram.drawio
+   ```
+
+## Elements Overlapping in PNG
+
+**Symptoms:** Diagram looks good in draw.io app but elements overlap in PNG
+
+**Solutions:**
+1. Open .drawio in text editor
+2. Check arrow placement - arrows must be after title, before other elements:
+   ```xml
+   <mxCell id="title" .../>     <!-- First -->
+   <mxCell id="arrow1" .../>    <!-- Arrows next -->
+   <mxCell id="box1" .../>      <!-- Elements last -->
+   ```
+3. Verify element z-order (elements later in file appear on top)
+4. Adjust coordinates to create spacing
+5. Re-export and verify
+
+## Text Cut Off or Wrapped
+
+**Symptoms:** Labels truncated or broken into multiple lines unexpectedly
+
+**Solutions:**
+1. Calculate required width:
+   - English: chars × 10px + 20px padding
+   - Example: "Application Server" (18 chars) = 180px + 20px = 200px
+
+2. Update width in mxGeometry:
+   ```xml
+   <mxGeometry x="140" y="60" width="200" height="40" />
+   ```
+
+3. For multi-line text, increase height proportionally
+
+## Script Permission Denied
+
+**Symptoms:** `bash: permission denied: convert-drawio-to-png.sh`
+
+**Solutions:**
+```bash
+# Make script executable
+chmod +x scripts/convert-drawio-to-png.sh
+
+# Or run with bash explicitly
+bash scripts/convert-drawio-to-png.sh diagram.drawio
+```
+
+## AWS Icon Not Found
+
+**Symptoms:** Search script returns no results
+
+**Solutions:**
+1. Check spelling:
+   ```bash
+   python scripts/find_aws_icon.py lambda
+   ```
+
+2. Try partial match:
+   ```bash
+   python scripts/find_aws_icon.py compute
+   ```
+
+3. List all available icons:
+   ```bash
+   python scripts/find_aws_icon.py --list-all
+   ```
+
+4. Some newer services may not be in aws4 icon set
+
+## Transparent Background Not Working
+
+**Symptoms:** PNG has white background despite `-t` flag
+
+**Solutions:**
+1. Remove background attribute from mxGraphModel:
+   ```xml
+   <!-- Remove this line -->
+   <mxGraphModel background="#ffffff" ...>
+   
+   <!-- Keep page="0" -->
+   <mxGraphModel page="0" ...>
+   ```
+
+2. Ensure `-t` flag is used in conversion:
+   ```bash
+   drawio -x -f png -s 2 -t -o output.png input.drawio
+   ```
+
+3. Check drawio CLI version (should be v20+):
+   ```bash
+   drawio --version
+   ```

package/bundles/antigravity-plugin/skills/draw-io/references/workflows.md

@@ -0,0 +1,103 @@
+# Workflow Examples
+
+## Example 1: Create AWS Architecture Diagram
+
+```bash
+# 1. Create diagram file
+touch aws-architecture.drawio
+
+# 2. Find required AWS icons
+python scripts/find_aws_icon.py ec2
+python scripts/find_aws_icon.py rds
+python scripts/find_aws_icon.py lambda
+
+# 3. Edit diagram in draw.io app or as XML
+# Add: VPC boundary, subnets, services with icons
+
+# 4. Convert to PNG
+bash scripts/convert-drawio-to-png.sh aws-architecture.drawio
+
+# 5. Verify output
+open aws-architecture.drawio.png  # macOS
+```
+
+## Example 2: Fix Overlapping Elements
+
+```bash
+# 1. Identify issue
+open diagram.drawio.png
+
+# 2. Edit XML
+vim diagram.drawio
+
+# 3. Calculate and align element centers
+# Box 1: y=100, height=80 → center = 140
+# Box 2: Adjust to y=120, height=40 → center = 140
+
+# 4. Move arrows to back layer (after title in XML)
+
+# 5. Regenerate PNG
+bash scripts/convert-drawio-to-png.sh diagram.drawio
+
+# 6. Verify fix
+open diagram.drawio.png
+```
+
+## Example 3: Batch Convert Multiple Diagrams
+
+```bash
+# Convert all diagrams in directory
+bash scripts/convert-drawio-to-png.sh diagrams/*.drawio
+
+# Or use find
+find . -name "*.drawio" -type f -exec \
+  bash scripts/convert-drawio-to-png.sh {} \;
+```
+
+## Example 4: Progressive Disclosure Architecture Set
+
+```bash
+# Create staged diagrams for complex system
+touch 01-context.drawio        # External view (users, external systems)
+touch 02-system.drawio         # Main components (services, databases)
+touch 03-component.drawio      # Technical details (APIs, integrations)
+touch 04-deployment.drawio     # Infrastructure (VPCs, regions, AZs)
+
+# Edit each diagram appropriately for its audience
+
+# Convert all
+bash scripts/convert-drawio-to-png.sh 0*.drawio
+```
+
+## Example 5: CI/CD Integration
+
+Add to `.github/workflows/diagrams.yml`:
+
+```yaml
+name: Generate Diagrams
+
+on: [push]
+
+jobs:
+  convert:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      
+      - name: Install drawio
+        run: |
+          wget https://github.com/jgraph/drawio-desktop/releases/download/v21.6.5/drawio-amd64-21.6.5.deb
+          sudo apt install ./drawio-amd64-21.6.5.deb
+      
+      - name: Convert diagrams
+        run: |
+          find . -name "*.drawio" -exec drawio -x -f png -s 2 -t -o {}.png {} \;
+      
+      - name: Commit PNGs
+        run: |
+          git config user.name github-actions
+          git config user.email github-actions@github.com
+          git add "*.png"
+          git commit -m "Auto-generate diagram PNGs" || echo "No changes"
+          git push
+```

package/bundles/antigravity-plugin/skills/draw-io/scripts/convert-drawio-to-png.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+set -e
+
+# Convert .drawio files to .drawio.png
+generated_files=()
+
+for drawio in "$@"; do
+  png="${drawio%.drawio}.drawio.png"
+  echo "Converting $drawio to $png..."
+
+  # drawio CLI export to PNG with 2x scale for high quality
+  if ! drawio -x -f png -s 2 -t -o "$png" "$drawio" 2>/dev/null; then
+    echo "✗ drawio PNG export failed for $drawio" >&2
+    continue
+  fi
+
+  generated_files+=("$png")
+  echo "✓ Generated $png"
+done
+
+# Stage all generated files at once to avoid index.lock conflicts
+if [ ${#generated_files[@]} -gt 0 ]; then
+  git add "${generated_files[@]}"
+  echo "Staged ${#generated_files[@]} file(s)"
+fi

package/bundles/antigravity-plugin/skills/draw-io/scripts/find_aws_icon.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+"""AWS アイコン検索スクリプト
+
+references/aws-icons.md からサービス名でアイコン情報を検索する。
+トークン効率を向上させるため、必要な情報のみを抽出する。
+
+Usage:
+    python find_aws_icon.py <service_name>
+    python find_aws_icon.py ec2
+    python find_aws_icon.py lambda
+    python find_aws_icon.py s3
+"""
+
+import re
+import sys
+from pathlib import Path
+
+
+def load_icon_data() -> dict[str, str]:
+    """aws-icons.md からアイコンデータを読み込む"""
+    icons = {}
+    script_dir = Path(__file__).parent
+    aws_icons_path = script_dir.parent / "references" / "aws-icons.md"
+
+    if not aws_icons_path.exists():
+        return icons
+
+    content = aws_icons_path.read_text(encoding="utf-8")
+
+    # テーブル行からサービス名と resIcon を抽出
+    # | Amazon EC2 | mxgraph.aws4.ec2 |
+    pattern = r"\|\s*([^|]+?)\s*\|\s*(mxgraph\.aws4\.[a-z0-9_]+)\s*\|"
+    for match in re.finditer(pattern, content):
+        service_name = match.group(1).strip()
+        res_icon = match.group(2).strip()
+        icons[service_name.lower()] = {
+            "name": service_name,
+            "resIcon": res_icon,
+        }
+
+    return icons
+
+
+def search_icon(query: str) -> list[dict]:
+    """クエリに一致するアイコンを検索"""
+    icons = load_icon_data()
+    query_lower = query.lower()
+    results = []
+
+    for key, data in icons.items():
+        if query_lower in key or query_lower in data["resIcon"]:
+            results.append(data)
+
+    return results
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python find_aws_icon.py <service_name>")
+        print("Example: python find_aws_icon.py ec2")
+        sys.exit(1)
+
+    query = sys.argv[1]
+    results = search_icon(query)
+
+    if not results:
+        print(f"No icons found for: {query}")
+        sys.exit(1)
+
+    print(f"Found {len(results)} icon(s) for '{query}':\n")
+    for result in results:
+        print(f"Service: {result['name']}")
+        print(f"resIcon: {result['resIcon']}")
+        print(f"Style: shape=mxgraph.aws4.resourceIcon;resIcon={result['resIcon']};")
+        print()
+
+
+if __name__ == "__main__":
+    main()