@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

package/pipeline/skills/figma-ios/figma-to-component/scripts/confluence-component-status.py

@@ -1,191 +0,0 @@
-#!/usr/bin/env python3
-"""
-Generates Component Implementation Status pages for the GitHub Wiki.
-
-Source of truth: component-catalog.json (from FigmaRegistryUtility catalog).
-
-IMPORTANT: No [[wiki links]]  -  GitHub resolves each one server-side,
-causing timeout on pages with 100+ links. Use plain text + code backticks.
-
-Splits output into 3 pages to stay under GitHub's rendering limit:
-  - ComponentImplementationStatus.md       (summary + index)
-  - ComponentImplementationStatus‐DSC.md   (Design System Core details)
-  - ComponentImplementationStatus‐MAC.md   (Mobile App Components details)
-
-Usage:
-    python3 confluence-component-status.py [--output path]
-"""
-
-import argparse
-import json
-import os
-import sys
-
-COMMON_BASES = [".", "{repos.common.path}"]
-
-SKIP_PREFIXES = ("MacOS", "SearchCursor", "IconInfoCursor", "Scrollbar", "ButtonScrollbar",
-                 "phosphor-icons", "AppDownloadMobile")
-
-FILE_LABELS = {
-    "Design System Core": "DSC",
-    "Mobile App Components": "MAC",
-}
-
-
-def find_catalog():
-    for base in COMMON_BASES:
-        path = os.path.join(base, "Shared/Figma/Generated/component-catalog.json")
-        if os.path.isfile(path):
-            return path
-    return None
-
-
-def status_of(comp):
-    name = comp.get("name", "")
-    for prefix in SKIP_PREFIXES:
-        if name.startswith(prefix):
-            return "skipped"
-    if comp.get("status", "") == "implemented":
-        return "implemented"
-    return "ready"
-
-
-def ios_name(comp):
-    cn = comp.get("componentName", {})
-    if isinstance(cn, dict):
-        return cn.get("ios") or comp.get("name", "")
-    if isinstance(cn, str) and cn:
-        return cn
-    return comp.get("name", "")
-
-
-def generate_all(catalog_path, wiki_dir):
-    with open(catalog_path) as f:
-        catalog = json.load(f)
-
-    target_files = [f for f in catalog.get("files", [])
-                    if f.get("fileLabel", "") in FILE_LABELS]
-
-    # Global counts
-    g_impl = g_ready = g_skip = 0
-    file_summaries = []
-
-    for fe in target_files:
-        label = fe.get("fileLabel", "")
-        short = FILE_LABELS.get(label, "")
-        f_impl = f_ready = f_skip = 0
-        page_rows = []
-
-        detail_lines = [
-            f"# {label}  -  Implementation Status",
-            "",
-            "[Back to summary](ComponentImplementationStatus)",
-            "",
-        ]
-
-        for pg in fe.get("pages", []):
-            comps = pg.get("components", [])
-            if not comps:
-                continue
-
-            impl = [c for c in comps if status_of(c) == "implemented"]
-            ready = [c for c in comps if status_of(c) == "ready"]
-            skipped = [c for c in comps if status_of(c) == "skipped"]
-            eff = len(comps) - len(skipped)
-
-            if eff == 0:
-                continue
-
-            f_impl += len(impl)
-            f_ready += len(ready)
-            f_skip += len(skipped)
-
-            page_name = pg.get("pageName", "")
-            page_rows.append((page_name, len(impl), eff))
-
-            # Detail page section
-            if impl:
-                detail_lines.append(f"### {page_name} ({len(impl)}/{eff})")
-                detail_lines.append("")
-                detail_lines.append("| Component | Swift |")
-                detail_lines.append("|-----------|-------|")
-                for c in sorted(impl, key=lambda x: x.get("name", "")):
-                    detail_lines.append(f"| {c['name']} | `{ios_name(c)}` |")
-                if ready:
-                    detail_lines.append("")
-                    detail_lines.append(f"*+ {len(ready)} ready*")
-                detail_lines.append("")
-            else:
-                detail_lines.append(f"**{page_name}**  -  0/{eff} ({len(ready)} ready)")
-                detail_lines.append("")
-
-        f_eff = f_impl + f_ready
-        g_impl += f_impl
-        g_ready += f_ready
-        g_skip += f_skip
-        file_summaries.append((label, short, f_impl, f_eff, page_rows))
-
-        # Write detail page
-        detail_path = os.path.join(wiki_dir, f"ComponentImplementationStatus-{short}.md")
-        with open(detail_path, "w") as f:
-            f.write("\n".join(detail_lines))
-        print(f"  {detail_path} ({len(detail_lines)} lines)")
-
-    # Summary page
-    g_eff = g_impl + g_ready
-    summary = [
-        "# Component Implementation Status",
-        "",
-        f"**iOS: {g_impl}/{g_eff}** implemented | {g_ready} ready | {g_skip} skipped",
-        "",
-        "---",
-        "",
-    ]
-
-    for label, short, f_impl, f_eff, page_rows in file_summaries:
-        pct = int(f_impl / f_eff * 100) if f_eff else 0
-        summary.append(f"## [{label}](ComponentImplementationStatus-{short})  -  {f_impl}/{f_eff} ({pct}%)")
-        summary.append("")
-        summary.append("| Section | Progress |")
-        summary.append("|---------|----------|")
-        for page_name, p_impl, p_eff in page_rows:
-            bar = "=" * min(p_impl, 20) if p_impl else ""
-            summary.append(f"| {page_name} | **{p_impl}**/{p_eff} {bar} |")
-        summary.append("")
-
-    summary_path = os.path.join(wiki_dir, "ComponentImplementationStatus.md")
-    with open(summary_path, "w") as f:
-        f.write("\n".join(summary))
-    print(f"  {summary_path} ({len(summary)} lines)")
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Generate wiki component status pages")
-    parser.add_argument("--output", help="Output directory (default: wiki submodule)")
-    args = parser.parse_args()
-
-    catalog_path = find_catalog()
-    if not catalog_path:
-        print("ERROR: component-catalog.json not found. Run: FigmaRegistryUtility catalog")
-        sys.exit(1)
-
-    if args.output:
-        wiki_dir = args.output
-    else:
-        for candidate in [
-            "{repos.wiki.path}",
-            "../{project.slug}-wiki",
-        ]:
-            if os.path.isdir(candidate):
-                wiki_dir = candidate
-                break
-        else:
-            wiki_dir = "."
-
-    print(f"Source: {catalog_path}")
-    generate_all(catalog_path, wiki_dir)
-    print("Done.")
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,420 +0,0 @@
-#!/usr/bin/env python3
-"""
-Confluence Data Gather  -  Lightweight artifact builder for standalone Confluence upload.
-
-Reads component source files (FIGMA.md, Swift, registry JSON, snapshots) and
-optionally fetches screenshots from Figma REST API to produce the same artifact
-structure that phase-7a expects.
-
-Used by /figma-confluence skill when full pipeline artifacts (pass1/pass2/pass3)
-don't exist.
-
-Usage:
-    python3 confluence-data-gather.py \
-        --file-key "9ipBvrtsq9HlQ175B9k0wx" \
-        --node-id "2073:17454" \
-        --artifact-path "path/to/artifacts/" \
-        --component-name "PackageBadge" \
-        --component-location "path/to/Sources/.../PackageBadge"
-
-Exit 0 = success (prints JSON summary to stdout)
-Exit 1 = failure (prints JSON error to stdout)
-"""
-
-import argparse
-import concurrent.futures
-import json
-import os
-import re
-import subprocess
-import sys
-from datetime import datetime
-from pathlib import Path
-from urllib.error import HTTPError, URLError
-from urllib.request import Request, urlopen
-
-
-# ─── Globals ─────────────────────────────────────────────────────────────────
-FIGMA_TOKEN = None
-FILE_KEY = None
-NODE_ID = None
-COMPONENT_NAME = None
-ARTIFACT_PATH = None
-COMPONENT_LOCATION = None
-REPO_ROOT = None
-
-def log(msg):
-    print(f"[confluence-gather] {msg}", file=sys.stderr)
-
-
-def figma_get(endpoint):
-    """GET from Figma REST API. Returns parsed JSON."""
-    url = f"https://api.figma.com/v1/{endpoint}"
-    req = Request(url, headers={"X-Figma-Token": FIGMA_TOKEN})
-    with urlopen(req, timeout=30) as resp:
-        return json.loads(resp.read().decode())
-
-
-def download_file(url, dest):
-    """Download a URL to a local file path."""
-    try:
-        req = Request(url)
-        with urlopen(req, timeout=60) as resp:
-            Path(dest).parent.mkdir(parents=True, exist_ok=True)
-            with open(dest, "wb") as f:
-                f.write(resp.read())
-        return True
-    except (URLError, HTTPError) as exc:
-        log(f"Download failed ({dest}): {exc}")
-        return False
-
-
-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
-
-
-# ─── Registry ────────────────────────────────────────────────────────────────
-
-def read_registry(node_id):
-    """Read component registry JSON from mobile-common."""
-    common_path = Path(REPO_ROOT) / "{repos.packagesContainer}" / "Packages" / "{project.slug}-common"
-    # Find by node ID
-    nid_file = node_id.replace(":", "-") + ".json"
-    registry_path = common_path / "Shared" / "Figma" / "Components" / nid_file
-    if registry_path.exists():
-        with open(registry_path) as f:
-            return json.load(f)
-    return {}
-
-
-# ─── FIGMA.md Parser ─────────────────────────────────────────────────────────
-
-def parse_figma_md(figma_md_path):
-    """Extract structured data from FIGMA.md."""
-    with open(figma_md_path) as f:
-        content = f.read()
-
-    data = {
-        "description": "",
-        "parameters": [],
-        "variant_mapping": [],
-        "usage_examples": [],
-        "notes": [],
-    }
-
-    # Description: first paragraph after the title
-    desc_match = re.search(r'\*\*Figma:\*\*.*?\n\*\*.*?\n\n---\n\n## Parameters', content, re.DOTALL)
-    # Try to get the component line
-    comp_match = re.search(r'\*\*Component:\*\*\s*`([^`]+)`', content)
-    if comp_match:
-        data["init_signature"] = comp_match.group(1)
-
-    # Parameters table
-    param_section = re.search(r'## Parameters\n\n\|.*?\n\|[-| ]+\n((?:\|.*\n)*)', content)
-    if param_section:
-        for line in param_section.group(1).strip().split('\n'):
-            cols = [c.strip().strip('`') for c in line.split('|')[1:-1]]
-            if len(cols) >= 4:
-                data["parameters"].append({
-                    "name": cols[0],
-                    "type": cols[1],
-                    "default": cols[2],
-                    "description": cols[3],
-                })
-
-    # Variant Mapping table
-    variant_section = re.search(r'## Variant Mapping\n\n\|.*?\n\|[-| ]+\n((?:\|.*\n)*)', content)
-    if variant_section:
-        for line in variant_section.group(1).strip().split('\n'):
-            cols = [c.strip().strip('`') for c in line.split('|')[1:-1]]
-            if len(cols) >= 3:
-                data["variant_mapping"].append({
-                    "property": cols[0],
-                    "value": cols[1],
-                    "code": cols[2],
-                })
-
-    # Usage examples
-    usage_section = re.search(r'## Usage\n\n```swift\n(.*?)```', content, re.DOTALL)
-    if usage_section:
-        data["usage_examples"] = [usage_section.group(1).strip()]
-
-    # Notes
-    notes_section = re.search(r'## Notes\n\n((?:- .*\n)*)', content)
-    if notes_section:
-        data["notes"] = [n.strip('- \n') for n in notes_section.group(1).strip().split('\n') if n.strip()]
-
-    return data
-
-
-# ─── Artifact Builders ───────────────────────────────────────────────────────
-
-def build_component_summary(registry, figma_md_data):
-    """Build component_summary.json from registry + FIGMA.md."""
-    variant_count = len([v for v in figma_md_data["variant_mapping"]
-                         if v["property"] == figma_md_data["variant_mapping"][0]["property"]])
-    return {
-        "componentName": COMPONENT_NAME,
-        "nodeId": NODE_ID,
-        "fileKey": FILE_KEY,
-        "nodeType": "COMPONENT_SET",
-        "variantCount": variant_count,
-        "properties": [
-            {"name": p["name"], "type": p["type"]}
-            for p in figma_md_data["parameters"]
-        ],
-        "hasExistingCodeConnect": Path(COMPONENT_LOCATION).joinpath(
-            f"{COMPONENT_NAME}.figma.swift").exists() if COMPONENT_LOCATION else False,
-    }
-
-
-def build_utility_files(registry, artifact_path):
-    """Build pass2/ utility JSON files from registry data."""
-    pass2 = Path(artifact_path) / "pass2"
-    pass2.mkdir(parents=True, exist_ok=True)
-
-    # Testing identifiers
-    identifiers = registry.get("testingIdentifiers", [])
-    with open(pass2 / "utility_identifiers.json", "w") as f:
-        json.dump({"testingIdentifiers": identifiers}, f, indent=2)
-
-    # Localization keys
-    loc_keys = registry.get("localizationKeys", [])
-    with open(pass2 / "utility_localization.json", "w") as f:
-        json.dump({"localizationKeys": loc_keys}, f, indent=2)
-
-    # Accessibility keys
-    a11y_keys = registry.get("accessibilityKeys", [])
-    with open(pass2 / "utility_accessibility.json", "w") as f:
-        json.dump({"accessibilityKeys": a11y_keys}, f, indent=2)
-
-    # Analytics events
-    analytics = registry.get("analyticsEvents", [])
-    with open(pass2 / "utility_analytics.json", "w") as f:
-        json.dump({"analyticsEvents": analytics}, f, indent=2)
-
-    # Write _index.md
-    with open(pass2 / "_index.md", "w") as f:
-        f.write("# Pass 2  -  Utility Artifacts (from registry)\n\n")
-        f.write(f"- Testing identifiers: {len(identifiers)}\n")
-        f.write(f"- Localization keys: {len(loc_keys)}\n")
-        f.write(f"- Accessibility keys: {len(a11y_keys)}\n")
-        f.write(f"- Analytics events: {len(analytics)}\n")
-
-    return {
-        "testing": len(identifiers),
-        "localization": len(loc_keys),
-        "accessibility": len(a11y_keys),
-        "analytics": len(analytics),
-    }
-
-
-def fetch_screenshots(artifact_path):
-    """Fetch main + variant screenshots from Figma REST API."""
-    pass1 = Path(artifact_path) / "pass1"
-    pass1.mkdir(parents=True, exist_ok=True)
-    screenshots_dir = pass1 / "screenshots"
-    screenshots_dir.mkdir(exist_ok=True)
-
-    screenshot_count = 0
-
-    # Main screenshot
-    log("Fetching main screenshot...")
-    try:
-        data = figma_get(f"images/{FILE_KEY}?ids={NODE_ID}&format=png&scale=2")
-        url = (data.get("images") or {}).get(NODE_ID)
-        if url and download_file(url, str(pass1 / "screenshot.png")):
-            screenshot_count += 1
-            log("Main screenshot saved")
-    except Exception as e:
-        log(f"Main screenshot failed: {e}")
-
-    # Variant screenshots  -  get node children
-    log("Fetching variant info...")
-    try:
-        node_data = figma_get(f"files/{FILE_KEY}/nodes?ids={NODE_ID}")
-        node = (node_data.get("nodes") or {}).get(NODE_ID, {}).get("document", {})
-        children = node.get("children", [])
-
-        if children:
-            # Batch fetch all variant images
-            variant_ids = [c["id"] for c in children if c.get("type") == "COMPONENT"]
-            if variant_ids:
-                ids_param = ",".join(variant_ids)
-                img_data = figma_get(f"images/{FILE_KEY}?ids={ids_param}&format=png&scale=2")
-                images = img_data.get("images", {})
-
-                variants_md_lines = ["# Variant Screenshots\n"]
-
-                for child in children:
-                    if child.get("type") != "COMPONENT":
-                        continue
-                    cid = child["id"]
-                    cname = child.get("name", cid).replace(", ", "_").replace("=", "_").replace(" ", "_")
-                    img_url = images.get(cid)
-                    if img_url:
-                        dest = screenshots_dir / f"{cname}.png"
-                        if download_file(img_url, str(dest)):
-                            screenshot_count += 1
-                            variants_md_lines.append(f"- {child.get('name', cid)}: {cname}.png")
-
-                with open(pass1 / "screenshots" / "variants.md", "w") as f:
-                    f.write("\n".join(variants_md_lines) + "\n")
-
-                log(f"Downloaded {screenshot_count - 1} variant screenshots")
-    except Exception as e:
-        log(f"Variant screenshots failed: {e}")
-
-    return screenshot_count
-
-
-def build_pass1_index(artifact_path, figma_md_data, screenshot_count):
-    """Write pass1/_index.md."""
-    pass1 = Path(artifact_path) / "pass1"
-    with open(pass1 / "_index.md", "w") as f:
-        f.write("# Pass 1  -  Data (from confluence-data-gather)\n\n")
-        f.write(f"- screenshot.png: {'present' if screenshot_count > 0 else 'missing'}\n")
-        f.write(f"- variant screenshots: {max(0, screenshot_count - 1)}\n")
-        f.write(f"- component_summary.json: present\n")
-
-
-def build_implementation_history(artifact_path, component_location):
-    """Write minimal IMPLEMENTATION_HISTORY.md if missing."""
-    hist_path = Path(artifact_path) / "IMPLEMENTATION_HISTORY.md"
-    if hist_path.exists():
-        return  # Don't overwrite existing
-    with open(hist_path, "w") as f:
-        f.write(f"# Implementation History: {COMPONENT_NAME}\n\n")
-        f.write(f"- Component: {COMPONENT_NAME}\n")
-        f.write(f"- Node ID: {NODE_ID}\n")
-        f.write(f"- File Key: {FILE_KEY}\n")
-        f.write(f"- Source Location: {component_location}\n")
-        f.write(f"- Artifact Location: {artifact_path}\n")
-        f.write(f"- Generated: {datetime.now().isoformat()}\n")
-        f.write(f"- Source: confluence-data-gather.py (standalone)\n")
-
-
-# ─── Main ────────────────────────────────────────────────────────────────────
-
-def main():
-    global FIGMA_TOKEN, FILE_KEY, NODE_ID, COMPONENT_NAME, ARTIFACT_PATH, COMPONENT_LOCATION, REPO_ROOT
-
-    parser = argparse.ArgumentParser(description="Confluence 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("--component-name", required=True)
-    parser.add_argument("--component-location", required=True)
-    parser.add_argument("--figma-token", default=None)
-    parser.add_argument("--skip-screenshots", action="store_true",
-                        help="Skip Figma API calls (use when screenshots already exist)")
-    args = parser.parse_args()
-
-    FILE_KEY = args.file_key
-    NODE_ID = args.node_id
-    ARTIFACT_PATH = args.artifact_path
-    COMPONENT_NAME = args.component_name
-    COMPONENT_LOCATION = args.component_location
-
-    # Resolve repo root
-    try:
-        REPO_ROOT = subprocess.check_output(
-            ["git", "rev-parse", "--show-toplevel"],
-            stderr=subprocess.DEVNULL
-        ).decode().strip()
-    except subprocess.CalledProcessError:
-        REPO_ROOT = os.getcwd()
-
-    # Resolve Figma token
-    FIGMA_TOKEN = args.figma_token or get_figma_token()
-    has_token = FIGMA_TOKEN is not None
-
-    log(f"Confluence Data Gather: {COMPONENT_NAME}  node={NODE_ID}  file={FILE_KEY}")
-    log(f"Figma token: {'available' if has_token else 'MISSING (screenshots will be skipped)'}")
-
-    # ── Read sources ──
-    registry = read_registry(NODE_ID)
-    if not registry:
-        log("WARNING: No registry JSON found  -  utility data will be empty")
-
-    figma_md_path = Path(COMPONENT_LOCATION) / "FIGMA.md"
-    if not figma_md_path.exists():
-        # Try relative to repo root
-        figma_md_path = Path(REPO_ROOT) / COMPONENT_LOCATION / "FIGMA.md"
-
-    if not figma_md_path.exists():
-        print(json.dumps({
-            "status": "HALT",
-            "reason": f"FIGMA.md not found at {figma_md_path}",
-        }))
-        sys.exit(1)
-
-    figma_md_data = parse_figma_md(str(figma_md_path))
-    log(f"FIGMA.md parsed: {len(figma_md_data['parameters'])} params, {len(figma_md_data['variant_mapping'])} variants")
-
-    # ── Build artifacts ──
-    artifact_abs = Path(REPO_ROOT) / ARTIFACT_PATH if not Path(ARTIFACT_PATH).is_absolute() else Path(ARTIFACT_PATH)
-    artifact_abs.mkdir(parents=True, exist_ok=True)
-
-    # pass1: screenshots
-    screenshot_count = 0
-    if has_token and not args.skip_screenshots:
-        screenshot_count = fetch_screenshots(str(artifact_abs))
-    else:
-        log("Skipping screenshot fetch")
-        # Check if screenshots already exist
-        pass1 = artifact_abs / "pass1"
-        if (pass1 / "screenshot.png").exists():
-            screenshot_count = 1
-            screenshots_dir = pass1 / "screenshots"
-            if screenshots_dir.exists():
-                screenshot_count += len(list(screenshots_dir.glob("*.png")))
-
-    # pass1: summary + index
-    pass1 = artifact_abs / "pass1"
-    pass1.mkdir(parents=True, exist_ok=True)
-    summary = build_component_summary(registry, figma_md_data)
-    with open(pass1 / "component_summary.json", "w") as f:
-        json.dump(summary, f, indent=2)
-    build_pass1_index(str(artifact_abs), figma_md_data, screenshot_count)
-
-    # pass2: utility files from registry
-    utility_counts = build_utility_files(registry, str(artifact_abs))
-
-    # IMPLEMENTATION_HISTORY.md
-    build_implementation_history(str(artifact_abs), COMPONENT_LOCATION)
-
-    # ── Output ──
-    result = {
-        "status": "COMPLETE",
-        "phase": "confluence-data-gather",
-        "screenshots": screenshot_count,
-        "utilities": utility_counts,
-        "artifacts": [
-            "pass1/screenshot.png",
-            "pass1/screenshots/",
-            "pass1/component_summary.json",
-            "pass1/_index.md",
-            "pass2/utility_identifiers.json",
-            "pass2/utility_localization.json",
-            "pass2/utility_accessibility.json",
-            "pass2/utility_analytics.json",
-            "pass2/_index.md",
-            "IMPLEMENTATION_HISTORY.md",
-        ],
-    }
-
-    print(json.dumps(result, indent=2))
-    log(f"COMPLETE: {screenshot_count} screenshots, {sum(utility_counts.values())} utility entries")
-
-
-if __name__ == "__main__":
-    main()

package/pipeline/skills/figma-ios/figma-to-component/scripts/confluence-page-ids.example.json

@@ -1,9 +0,0 @@
-{
-  "_comment": "Example confluence-page-ids registry. Copy to confluence-page-ids.json (gitignored) or to your project-local path and fill in real page IDs. Schema: flat map of 'Category/Subcategory' -> Confluence page ID string.",
-  "_root": "{ROOT_PAGE_ID}",
-  "Design System Core": "{PAGE_ID}",
-  "Design System Core/Button": "{PAGE_ID}",
-  "Mobile App Components": "{PAGE_ID}",
-  "Mobile App Components/Cards": "{PAGE_ID}",
-  "Visual Assets": "{PAGE_ID}"
-}