@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/skills/figma-ios/figma-to-component/scripts/code-connect-data-gather.py

@@ -0,0 +1,184 @@
+#!/usr/bin/env python3
+"""
+Code Connect Data Gather — Fetches Figma component properties for standalone Code Connect publish.
+
+Calls Figma REST API to get component property definitions and writes
+pass1/component_properties.json in the same format Phase 1 produces.
+
+Usage:
+    python3 code-connect-data-gather.py \
+        --file-key "9ipBvrtsq9HlQ175B9k0wx" \
+        --node-id "2073:17454" \
+        --artifact-path "path/to/artifacts/"
+
+Exit 0 = success (prints JSON summary to stdout)
+Exit 1 = failure (prints JSON error to stdout)
+"""
+
+import argparse
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+from urllib.error import HTTPError, URLError
+from urllib.request import Request, urlopen
+
+
+def log(msg):
+    print(f"[cc-gather] {msg}", file=sys.stderr)
+
+
+def figma_get(endpoint, token):
+    """GET from Figma REST API."""
+    url = f"https://api.figma.com/v1/{endpoint}"
+    req = Request(url, headers={"X-Figma-Token": token})
+    with urlopen(req, timeout=30) as resp:
+        return json.loads(resp.read().decode())
+
+
+def get_figma_token():
+    """Resolve Figma REST API token from Keychain."""
+    try:
+        return subprocess.check_output(
+            ["security", "find-generic-password", "-a", os.environ["USER"],
+             "-s", "FIGMA_ACCESS_TOKEN", "-w"],
+            stderr=subprocess.DEVNULL,
+        ).decode().strip()
+    except (subprocess.CalledProcessError, KeyError):
+        return None
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Code Connect Data Gather")
+    parser.add_argument("--file-key", required=True)
+    parser.add_argument("--node-id", required=True)
+    parser.add_argument("--artifact-path", required=True)
+    parser.add_argument("--figma-token", default=None)
+    args = parser.parse_args()
+
+    token = args.figma_token or get_figma_token()
+    if not token:
+        print(json.dumps({"status": "HALT", "reason": "No Figma access token found"}))
+        sys.exit(1)
+
+    file_key = args.file_key
+    node_id = args.node_id
+
+    # Resolve artifact path
+    try:
+        repo_root = subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"],
+            stderr=subprocess.DEVNULL
+        ).decode().strip()
+    except subprocess.CalledProcessError:
+        repo_root = os.getcwd()
+
+    artifact_path = Path(args.artifact_path)
+    if not artifact_path.is_absolute():
+        artifact_path = Path(repo_root) / artifact_path
+
+    log(f"Code Connect Data Gather: node={node_id} file={file_key}")
+
+    # Fetch node data from Figma REST API
+    log("Fetching node data from Figma REST API...")
+    try:
+        data = figma_get(f"files/{file_key}/nodes?ids={node_id}", token)
+    except (URLError, HTTPError) as e:
+        print(json.dumps({"status": "HALT", "reason": f"Figma API error: {e}"}))
+        sys.exit(1)
+
+    node = (data.get("nodes") or {}).get(node_id, {}).get("document")
+    if not node:
+        print(json.dumps({"status": "HALT", "reason": "Node not found in Figma file"}))
+        sys.exit(1)
+
+    node_type = node.get("type", "UNKNOWN")
+    log(f"Node type: {node_type}")
+
+    # Extract component property definitions
+    comp_prop_defs = node.get("componentPropertyDefinitions", {})
+    is_component = node_type in ("COMPONENT", "COMPONENT_SET")
+
+    # Extract variant children info
+    children = node.get("children", [])
+    variants = []
+    for child in children:
+        if child.get("type") == "COMPONENT":
+            variants.append({
+                "id": child["id"],
+                "name": child.get("name", ""),
+            })
+
+    # Build properties list (same format as phase1-gather.py)
+    properties = []
+    for prop_name, prop_def in comp_prop_defs.items():
+        prop_type = prop_def.get("type", "UNKNOWN")
+        values = []
+        default_value = prop_def.get("defaultValue", "")
+
+        if prop_type == "VARIANT":
+            # Extract variant values from variantOptions
+            variant_options = prop_def.get("variantOptions", [])
+            values = variant_options if variant_options else []
+
+        prop = {
+            "name": prop_name,
+            "type": prop_type,
+            "figmaKey": prop_name,
+            "default": str(default_value),
+        }
+        if values:
+            prop["values"] = values
+
+        properties.append(prop)
+
+    # Build component_properties.json
+    dimensions = node.get("absoluteBoundingBox", {})
+    result = {
+        "componentName": node.get("name", "Unknown"),
+        "nodeId": node_id,
+        "fileKey": file_key,
+        "nodeType": node_type,
+        "variantCount": len(variants),
+        "dimensions": {
+            "width": dimensions.get("width", 0),
+            "height": dimensions.get("height", 0),
+        },
+        "properties": properties,
+        "layerSummary": [f"{node_type} > COMPONENT({len(variants)} variants)"] if variants else [node_type],
+        "variableBindingCount": 0,
+        "variableBindingSummary": [],
+        "assets": {
+            "svgCount": 0,
+            "screenshotCount": len(variants),
+            "fileList": [],
+        },
+        "hasExistingCodeConnect": False,
+        "isComponent": is_component,
+        "componentPropertyDefinitions": comp_prop_defs,
+    }
+
+    # Write to pass1/
+    pass1 = artifact_path / "pass1"
+    pass1.mkdir(parents=True, exist_ok=True)
+    out_path = pass1 / "component_properties.json"
+    with open(out_path, "w") as f:
+        json.dump(result, f, indent=2)
+
+    log(f"Written: {out_path}")
+    log(f"Properties: {len(properties)}, Variants: {len(variants)}, isComponent: {is_component}")
+
+    print(json.dumps({
+        "status": "COMPLETE",
+        "phase": "code-connect-data-gather",
+        "properties": len(properties),
+        "variants": len(variants),
+        "isComponent": is_component,
+        "strategy": "MAPPED_PROPERTIES" if (is_component and comp_prop_defs) else "STATIC_VALUES",
+        "artifacts": ["pass1/component_properties.json"],
+    }, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/pipeline/skills/figma-ios/figma-to-component/scripts/code-connect-publish.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+# code-connect-publish.sh — Resilient Code Connect publish wrapper
+#
+# Handles the case where stale .figma.swift files from OTHER components
+# cause validation failures that block the entire batch publish.
+#
+# Strategy: attempt publish → if exit 1 due to validation failures,
+# auto-exclude failing files → retry once → restore config.
+#
+# Usage: code-connect-publish.sh [--dry-run]
+#
+# Must be run from the uicomponents package root (where figma.config.json lives).
+# Requires FIGMA_ACCESS_TOKEN to be set.
+
+set -euo pipefail
+
+# ─── Config ───────────────────────────────────────────────────────────
+CONFIG="figma.config.json"
+BACKUP="${CONFIG}.bak"
+DRY_RUN_FLAG=""
+EXCLUDED_FILES=()
+
+if [[ "${1:-}" == "--dry-run" ]]; then
+    DRY_RUN_FLAG="--dry-run"
+    echo "[code-connect-publish] DRY RUN mode"
+fi
+
+# ─── Guards ───────────────────────────────────────────────────────────
+if [[ ! -f "$CONFIG" ]]; then
+    echo "[code-connect-publish] ERROR: $CONFIG not found. Run from uicomponents root." >&2
+    exit 1
+fi
+
+if [[ -z "${FIGMA_ACCESS_TOKEN:-}" ]]; then
+    echo "[code-connect-publish] ERROR: FIGMA_ACCESS_TOKEN not set." >&2
+    exit 1
+fi
+
+# ─── Cleanup trap ─────────────────────────────────────────────────────
+cleanup() {
+    if [[ -f "$BACKUP" ]]; then
+        cp "$BACKUP" "$CONFIG"
+        rm -f "$BACKUP"
+        echo "[code-connect-publish] Config restored from backup."
+    fi
+}
+trap cleanup EXIT INT TERM
+
+# ─── Publish function ─────────────────────────────────────────────────
+do_publish() {
+    local rc=0
+    npx @figma/code-connect@latest connect publish $DRY_RUN_FLAG 2>&1 || rc=$?
+    return $rc
+}
+
+# ─── Extract unique failing component names from output ───────────────
+# Input format: "Validation failed for ComponentName (https://...): error message"
+# Returns: unique component names, one per line
+parse_failing_components() {
+    local output="$1"
+    echo "$output" \
+        | grep -o 'Validation failed for [^(]*(' \
+        | sed 's/Validation failed for //; s/ *(//' \
+        | sort -u
+}
+
+# ─── Resolve component name → .figma.swift file path ─────────────────
+find_figma_swift_file() {
+    local name="$1"
+    find Sources -name "${name}.figma.swift" -type f 2>/dev/null | head -1
+}
+
+# ─── Add files to exclude list in figma.config.json ───────────────────
+add_excludes() {
+    python3 -c "
+import json, sys
+
+config_path = sys.argv[1]
+files_to_add = sys.argv[2:]
+
+with open(config_path) as f:
+    config = json.load(f)
+
+excludes = config.get('codeConnect', {}).get('exclude', [])
+added = []
+for fpath in files_to_add:
+    if fpath not in excludes:
+        excludes.append(fpath)
+        added.append(fpath)
+
+config['codeConnect']['exclude'] = excludes
+
+with open(config_path, 'w') as f:
+    json.dump(config, f, indent=2)
+    f.write('\n')
+
+for a in added:
+    print(f'  + {a}')
+" "$CONFIG" "$@"
+}
+
+# ─── Main ─────────────────────────────────────────────────────────────
+echo "[code-connect-publish] Attempt 1: publishing..."
+RC=0
+OUTPUT=$(do_publish) || RC=$?
+echo "$OUTPUT"
+
+if [[ $RC -eq 0 ]]; then
+    echo ""
+    echo "[code-connect-publish] SUCCESS on first attempt."
+    exit 0
+fi
+
+# Check for 403 (token issue) — no retry can fix this
+if echo "$OUTPUT" | grep -q "403"; then
+    echo ""
+    echo "[code-connect-publish] FATAL: 403 error detected. Token issue — cannot retry." >&2
+    exit 1
+fi
+
+# Parse failing component names
+FAILING_COMPONENTS=()
+while IFS= read -r line; do
+    [[ -n "$line" ]] && FAILING_COMPONENTS+=("$line")
+done < <(parse_failing_components "$OUTPUT")
+
+if [[ ${#FAILING_COMPONENTS[@]} -eq 0 ]]; then
+    echo ""
+    echo "[code-connect-publish] FATAL: Exit code 1 but no validation failures parsed from output." >&2
+    exit 1
+fi
+
+# Resolve component names to file paths
+FAILING_PATHS=()
+UNRESOLVED=()
+echo ""
+echo "[code-connect-publish] Found ${#FAILING_COMPONENTS[@]} failing component(s):"
+for comp in "${FAILING_COMPONENTS[@]}"; do
+    fpath=$(find_figma_swift_file "$comp")
+    if [[ -n "$fpath" ]]; then
+        FAILING_PATHS+=("$fpath")
+        echo "  x $comp -> $fpath"
+    else
+        UNRESOLVED+=("$comp")
+        echo "  ? $comp -> file not found (skipping)"
+    fi
+done
+
+if [[ ${#FAILING_PATHS[@]} -eq 0 ]]; then
+    echo ""
+    echo "[code-connect-publish] FATAL: Could not resolve any failing component to a .figma.swift file." >&2
+    exit 1
+fi
+
+EXCLUDED_FILES=("${FAILING_PATHS[@]}")
+
+# Backup config and add excludes
+echo ""
+echo "[code-connect-publish] Backing up $CONFIG -> $BACKUP"
+cp "$CONFIG" "$BACKUP"
+
+echo "[code-connect-publish] Adding ${#FAILING_PATHS[@]} exclude(s) to $CONFIG:"
+add_excludes "${FAILING_PATHS[@]}"
+
+# Retry
+echo ""
+echo "[code-connect-publish] Attempt 2: retrying with ${#FAILING_PATHS[@]} file(s) excluded..."
+RC=0
+OUTPUT=$(do_publish) || RC=$?
+echo "$OUTPUT"
+
+if [[ $RC -eq 0 ]]; then
+    echo ""
+    echo "[code-connect-publish] SUCCESS on retry."
+    echo ""
+    echo "WARNING: The following stale components were auto-excluded"
+    echo "from this publish. They need separate fixes:"
+    for f in "${EXCLUDED_FILES[@]}"; do
+        echo "  ! $f"
+    done
+    # Config restored by trap
+    exit 0
+else
+    echo ""
+    echo "[code-connect-publish] FATAL: Retry also failed with exit code $RC." >&2
+    # Config restored by trap
+    exit 1
+fi