@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

package/pipeline/skills/figma-ios/figma-to-component/scripts/phase2-finalize.py

@@ -1,228 +0,0 @@
-#!/usr/bin/env python3
-"""Phase 2 finalization: builds component-utilities.json from JSON sidecars, registers, writes _index.md.
-
-Usage:
-    python3 phase2-finalize.py \
-        --artifact-path /path/to/artifacts \
-        --node-id '9047:386' \
-        --file-key 'ps4xrJzhn7WNbfkZs895Bi' \
-        --component-name 'AvatarMembership'
-
-Reads:
-    pass2/utility_identifiers.json  (from 2A)
-    pass2/utility_localization.json (from 2B)
-    pass2/utility_accessibility.json (from 2C)
-    pass2/utility_analytics.json    (from 2D)
-
-Writes:
-    pass2/component-utilities.json
-    pass2/_index.md
-
-Also:
-    Registers via FigmaRegistryUtility utility-register
-
-Outputs JSON summary to stdout for orchestrator consumption.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import subprocess
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-SCRIPT_DIR = Path(__file__).parent
-REPO_ROOT = SCRIPT_DIR.parent.parent.parent.parent
-CONFIG_PKG = REPO_ROOT / "{repos.packagesContainer}" / "Packages" / "{project.slug}-common"
-CLI_BINARY = CONFIG_PKG / ".build" / "debug" / "FigmaRegistryUtility"
-
-ISO_DATE = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
-DATE_SHORT = datetime.now(timezone.utc).strftime("%Y-%m-%d")
-
-
-def ensure_cli():
-    """Build CLI if binary doesn't exist."""
-    if not CLI_BINARY.exists():
-        print("  Building FigmaRegistryUtility...", file=sys.stderr)
-        subprocess.run(
-            ["swift", "build", "--product", "FigmaRegistryUtility"],
-            cwd=str(CONFIG_PKG), capture_output=True, timeout=120
-        )
-
-
-def read_json_sidecar(path: Path, fallback_key: str) -> list:
-    """Read a JSON sidecar file. Returns the array for fallback_key, or [] if missing/empty."""
-    if not path.exists():
-        print(f"  [warn] {path.name} not found  -  using empty array", file=sys.stderr)
-        return []
-    try:
-        with open(path) as f:
-            data = json.load(f)
-        return data.get(fallback_key, [])
-    except (json.JSONDecodeError, KeyError) as e:
-        print(f"  [warn] {path.name} parse error: {e}  -  using empty array", file=sys.stderr)
-        return []
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Phase 2 finalization script")
-    parser.add_argument("--artifact-path", required=True, help="Path to artifact directory")
-    parser.add_argument("--node-id", required=True, help="Figma node ID (e.g., 9047:386)")
-    parser.add_argument("--file-key", required=True, help="Figma file key")
-    parser.add_argument("--component-name", required=True, help="Component name")
-    args = parser.parse_args()
-
-    ap = Path(args.artifact_path)
-    pass2 = ap / "pass2"
-
-    # --- GATE 1: COLLECT --- verify markdown artifacts exist
-    md_files = [
-        "utility_identifiers.md",
-        "utility_localization.md",
-        "utility_accessibility.md",
-        "utility_analytics.md",
-    ]
-    missing_md = [f for f in md_files if not (pass2 / f).exists()]
-    if missing_md:
-        print(json.dumps({
-            "status": "error",
-            "error": f"Missing markdown artifacts: {', '.join(missing_md)}",
-        }))
-        sys.exit(1)
-
-    # --- GATE 2: READ JSON SIDECARS ---
-    testing_ids = read_json_sidecar(pass2 / "utility_identifiers.json", "testingIdentifiers")
-    loc_keys = read_json_sidecar(pass2 / "utility_localization.json", "localizationKeys")
-    a11y_keys = read_json_sidecar(pass2 / "utility_accessibility.json", "accessibilityKeys")
-    analytics = read_json_sidecar(pass2 / "utility_analytics.json", "analyticsEvents")
-
-    # --- GATE 3: BUILD component-utilities.json ---
-    utilities = {
-        "nodeId": args.node_id,
-        "componentName": {
-            "ios": args.component_name,
-            "android": args.component_name,
-        },
-        "codeConnect": {
-            "ios": False,
-            "android": False,
-        },
-        "confluence": {
-            "page": None,
-            "ios": None,
-            "android": None,
-        },
-        "fileKey": args.file_key,
-        "lastUpdated": ISO_DATE,
-        "updatedBy": "ios",
-        "testingIdentifiers": testing_ids,
-        "localizationKeys": loc_keys,
-        "accessibilityKeys": a11y_keys,
-        "analyticsEvents": analytics,
-    }
-
-    utils_path = pass2 / "component-utilities.json"
-    with open(utils_path, "w") as f:
-        json.dump(utilities, f, indent=2, ensure_ascii=False)
-    print(f"  component-utilities.json written", file=sys.stderr)
-
-    # --- GATE 4: REGISTER ---
-    ensure_cli()
-    registry_ok = False
-    try:
-        result = subprocess.run(
-            [str(CLI_BINARY), "utility-register",
-             "--node-id", args.node_id,
-             "--input", str(utils_path.resolve())],
-            capture_output=True, text=True, timeout=30,
-            cwd=str(CONFIG_PKG)
-        )
-        registry_ok = result.returncode == 0
-        if registry_ok:
-            print(f"  Registry updated", file=sys.stderr)
-        else:
-            print(f"  [warn] Registry update failed: {result.stderr.strip()}", file=sys.stderr)
-    except (subprocess.TimeoutExpired, FileNotFoundError) as e:
-        print(f"  [warn] Registry update failed: {e}", file=sys.stderr)
-
-    # --- GATE 5: REGENERATE KEY INDICES ---
-    # Regenerate localization-keys.txt and accessibility-keys.txt from merged data
-    for system_name, merged_filename, index_filename in [
-        ("localization", "localization-data-merged.json", "localization-keys.txt"),
-        ("accessibility", "accessibility-data-merged.json", "accessibility-keys.txt"),
-    ]:
-        base = CONFIG_PKG / "Shared" / "Localization"
-        if system_name == "localization":
-            merged_path = base / "LocalizationStrings" / merged_filename
-            index_path = base / "LocalizationStrings" / "Metadata" / index_filename
-        else:
-            merged_path = base / "AccessibilityStrings" / merged_filename
-            index_path = base / "AccessibilityStrings" / "Metadata" / index_filename
-
-        if merged_path.exists():
-            try:
-                with open(merged_path) as f:
-                    merged_data = json.load(f)
-                keys = sorted(merged_data.keys())
-                with open(index_path, "w") as f:
-                    f.write("\n".join(keys) + "\n")
-                print(f"  {index_filename} regenerated ({len(keys)} keys)", file=sys.stderr)
-            except Exception as e:
-                print(f"  [warn] {index_filename} regeneration failed: {e}", file=sys.stderr)
-
-    # --- GATE 6: WRITE _index.md ---
-    index_content = f"""# Pass 2  -  Utility Files Output
-
-Component: {args.component_name}
-Generated: {ISO_DATE}
-
-## Files
-
-| File | Description | Phase |
-|------|-------------|-------|
-| `pass1/screenshot.png` | PNG screenshot of component | Phase 1 |
-| `pass1/screenshots/` | Variant screenshots (if multi-variant) | Phase 1 |
-| `pass1/screenshot_response.md` | Visual description | Phase 1 |
-| `pass1/metadata_response.xml` | Layer hierarchy (XML) | Phase 1 |
-| `pass1/design_context_response.json` | Generated code + structure | Phase 1 |
-| `pass1/design_context_assets.txt` | Asset download URLs | Phase 1 |
-| `pass1/variable_defs_response.json` | Design tokens / variables | Phase 1 |
-| `pass1/component_properties.json` | Variant properties, booleans, text slots | Phase 1 |
-| `pass1/code_connect_map_response.json` | Existing Code Connect mappings | Phase 1 |
-| `pass2/utility_identifiers.json` | Testing identifiers (structured) | Phase 2A |
-| `pass2/utility_identifiers.md` | Testing identifiers (documentation) | Phase 2A |
-| `pass2/utility_localization.json` | Localization keys (structured) | Phase 2B |
-| `pass2/utility_localization.md` | Localization keys (documentation) | Phase 2B |
-| `pass2/utility_accessibility.json` | Accessibility keys (structured) | Phase 2C |
-| `pass2/utility_accessibility.md` | Accessibility keys (documentation) | Phase 2C |
-| `pass2/utility_analytics.json` | Analytics event definitions (structured) | Phase 2D |
-| `pass2/utility_analytics.md` | Analytics event definitions (documentation) | Phase 2D |
-| `pass2/component-utilities.json` | Registry data (cross-platform index) | Phase 2 |
-
-## Read Instructions
-
-Phase 3 (Data Analysis): read this file, then read ALL listed files above.
-Phase 3 produces pass3/ which serves as the consolidation point for Phases 4-7.
-"""
-
-    with open(pass2 / "_index.md", "w") as f:
-        f.write(index_content)
-    print(f"  _index.md written", file=sys.stderr)
-
-    # --- OUTPUT: summary JSON to stdout ---
-    summary = {
-        "status": "ok",
-        "testing": len(testing_ids),
-        "localization": len(loc_keys),
-        "accessibility": len(a11y_keys),
-        "analytics": len(analytics),
-        "registry": registry_ok,
-    }
-    print(json.dumps(summary))
-
-
-if __name__ == "__main__":
-    main()