@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

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

@@ -1,141 +0,0 @@
-#!/usr/bin/env python3
-"""phase4-finalize.py  -  Post-Phase 4 registry update.
-
-Marks status.<platform>.implemented in the component registry JSON after
-Phase 4 writes the .swift (or .kt) source file. Uses content-hash to skip
-version bumps on byte-identical re-runs.
-
-Usage:
-    python3 phase4-finalize.py \\
-        --node-id 5:17752 \\
-        --component-name TurkishButton \\
-        --source-file /path/to/TurkishButton.swift \\
-        [--platform ios] \\
-        [--registry-dir /path/to/Shared/Figma/Components]
-
-Exit codes:
-    0  -  Success (registry updated, or no-op on byte-identical)
-    1  -  Error (bad JSON, missing required flag, etc.)
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-# Import the shared registry writer + issue-sync propagation helper
-sys.path.insert(0, str(Path(__file__).parent))
-from lib.registry_writer import set_implemented  # noqa: E402
-from lib.issue_sync_propagate import propagate_to_issue, should_skip_sync  # noqa: E402
-
-
-def find_repo_root() -> Path:
-    """Walk up from cwd to find .git directory. Falls back to cwd."""
-    p = Path.cwd()
-    while p != p.parent:
-        if (p / ".git").exists():
-            return p
-        p = p.parent
-    return Path.cwd()
-
-
-def default_registry_dir() -> Path:
-    return (
-        find_repo_root()
-        / "{repos.packagesContainer}"
-        / "Packages"
-        / "{project.slug}-common"
-        / "Shared"
-        / "Figma"
-        / "Components"
-    )
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Phase 4 finalize  -  update registry status.<platform>.implemented",
-    )
-    parser.add_argument("--node-id", required=True, help="Figma node ID (e.g. 5:17752)")
-    parser.add_argument("--component-name", required=True, help="PascalCase component name")
-    parser.add_argument(
-        "--source-file",
-        required=False,
-        help="Path to the .swift/.kt file written by Phase 4. If provided, content hashing "
-             "prevents spurious version bumps on byte-identical re-runs.",
-    )
-    parser.add_argument("--platform", default="ios", choices=["ios", "android"])
-    parser.add_argument(
-        "--registry-dir",
-        required=False,
-        help="Override registry directory (defaults to the {project.slug}-common path).",
-    )
-    parser.add_argument(
-        "--updater",
-        default="phase-4-view",
-        help="String recorded in the registry's updatedBy field.",
-    )
-    parser.add_argument(
-        "--no-sync",
-        action="store_true",
-        help="Skip the Projects V2 issue sync propagation step after the "
-             "registry write. Useful for tests, CI dry-runs, or when the "
-             "caller wants to batch-sync later.",
-    )
-    args = parser.parse_args()
-
-    registry_dir = Path(args.registry_dir) if args.registry_dir else default_registry_dir()
-
-    if not registry_dir.exists():
-        print(
-            f"ERROR: registry directory does not exist: {registry_dir}",
-            file=sys.stderr,
-        )
-        return 1
-
-    source_file = None
-    if args.source_file:
-        source_file = Path(args.source_file)
-        if not source_file.exists():
-            print(
-                f"ERROR: --source-file does not exist: {source_file}",
-                file=sys.stderr,
-            )
-            return 1
-
-    try:
-        impl_block = set_implemented(
-            registry_dir=registry_dir,
-            node_id=args.node_id,
-            platform=args.platform,
-            updater=args.updater,
-            source_file=source_file,
-        )
-    except (OSError, json.JSONDecodeError, ValueError) as e:
-        print(f"ERROR: {type(e).__name__}: {e}", file=sys.stderr)
-        return 1
-
-    node_id_dash = args.node_id.replace(":", "-")
-    registry_file = registry_dir / f"{node_id_dash}.json"
-    result = {
-        "status": "ok",
-        "action": "updated",
-        "file": str(registry_file),
-        "platform": args.platform,
-        "implemented": impl_block,
-    }
-
-    # Propagate to GitHub issue + Projects V2 board (non-fatal on failure).
-    if not args.no_sync and not should_skip_sync():
-        sync = propagate_to_issue(
-            node_id=args.node_id,
-            platform=args.platform,
-            registry_dir=registry_dir,
-        )
-        result["issue_sync"] = sync
-
-    print(json.dumps(result, indent=2, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

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

@@ -1,106 +0,0 @@
-#!/usr/bin/env python3
-"""phase5-finalize.py  -  Post-Phase 5 registry update.
-
-Marks status.<platform>.tested=true in the component registry JSON after
-Phase 5 test waves (ViewInspector, snapshot, unit) complete successfully.
-
-The flag is recorded against the current status.<platform>.implemented.version,
-so if Phase 4 later re-runs and bumps the impl version, `tested` goes yellow
-until Phase 5 re-runs or the user acknowledges via a no-op re-run.
-
-Usage:
-    python3 phase5-finalize.py \\
-        --node-id 5:17752 \\
-        [--platform ios] \\
-        [--registry-dir /path/to/Shared/Figma/Components]
-
-Exit codes:
-    0  -  Success
-    1  -  Error
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from lib.registry_writer import set_flag  # noqa: E402
-from lib.issue_sync_propagate import propagate_to_issue, should_skip_sync  # noqa: E402
-
-
-def find_repo_root() -> Path:
-    p = Path.cwd()
-    while p != p.parent:
-        if (p / ".git").exists():
-            return p
-        p = p.parent
-    return Path.cwd()
-
-
-def default_registry_dir() -> Path:
-    return (
-        find_repo_root()
-        / "{repos.packagesContainer}"
-        / "Packages"
-        / "{project.slug}-common"
-        / "Shared"
-        / "Figma"
-        / "Components"
-    )
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Phase 5 finalize  -  update registry status.<platform>.tested",
-    )
-    parser.add_argument("--node-id", required=True)
-    parser.add_argument("--platform", default="ios", choices=["ios", "android"])
-    parser.add_argument("--registry-dir", required=False)
-    parser.add_argument("--updater", default="phase-5-test")
-    parser.add_argument(
-        "--no-sync",
-        action="store_true",
-        help="Skip the Projects V2 issue sync propagation step after the registry write.",
-    )
-    args = parser.parse_args()
-
-    registry_dir = Path(args.registry_dir) if args.registry_dir else default_registry_dir()
-    if not registry_dir.exists():
-        print(f"ERROR: registry directory does not exist: {registry_dir}", file=sys.stderr)
-        return 1
-
-    try:
-        tested_block = set_flag(
-            registry_dir=registry_dir,
-            node_id=args.node_id,
-            platform=args.platform,
-            flag="tested",
-            updater=args.updater,
-        )
-    except (OSError, json.JSONDecodeError, ValueError) as e:
-        print(f"ERROR: {type(e).__name__}: {e}", file=sys.stderr)
-        return 1
-
-    node_id_dash = args.node_id.replace(":", "-")
-    result = {
-        "status": "ok",
-        "action": "updated",
-        "file": str(registry_dir / f"{node_id_dash}.json"),
-        "platform": args.platform,
-        "tested": tested_block,
-    }
-
-    if not args.no_sync and not should_skip_sync():
-        result["issue_sync"] = propagate_to_issue(
-            node_id=args.node_id,
-            platform=args.platform,
-            registry_dir=registry_dir,
-        )
-
-    print(json.dumps(result, indent=2, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

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

@@ -1,162 +0,0 @@
-#!/usr/bin/env python3
-"""phase6-finalize.py  -  Post-Phase 6 registry update.
-
-Marks status.<platform>.codeConnect=true in the component registry JSON
-after `figma connect publish` succeeds. Also mirrors to the legacy
-top-level `codeConnect.{ios,android}` field so the Confluence status
-dashboard and register-icons-codeconnect.py keep working unchanged.
-
-CLI interface is BACKWARD-COMPATIBLE with the prior version of this
-script so `.instructions/figma/figma-to-swiftui/phases/phase-6-code-connect.md`
-can keep calling it verbatim  -  only the internals changed.
-
-Usage:
-    python3 phase6-finalize.py \\
-        --node-id 5:17752 \\
-        --file-key ps4xrJzhn7WNbfkZs895Bi \\
-        --component-name TurkishButton \\
-        [--platform ios]
-
-Exit codes:
-    0  -  Success
-    1  -  Error
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from lib.registry_writer import set_flag  # noqa: E402
-from lib.issue_sync_propagate import propagate_to_issue, should_skip_sync  # noqa: E402
-
-
-def find_repo_root() -> Path:
-    p = Path.cwd()
-    while p != p.parent:
-        if (p / ".git").exists():
-            return p
-        p = p.parent
-    return Path.cwd()
-
-
-def default_registry_dir() -> Path:
-    return (
-        find_repo_root()
-        / "{repos.packagesContainer}"
-        / "Packages"
-        / "{project.slug}-common"
-        / "Shared"
-        / "Figma"
-        / "Components"
-    )
-
-
-def ensure_legacy_shell(
-    registry_file: Path,
-    node_id: str,
-    file_key: str,
-    component_name: str,
-    platform: str,
-) -> str:
-    """If the registry file is missing, create a minimal shell with the
-    legacy fields that downstream scripts (confluence-component-status.py,
-    register-icons-codeconnect.py) expect.
-
-    Returns 'created' or 'existed'.
-    """
-    if registry_file.exists():
-        return "existed"
-
-    initial = {
-        "nodeId": node_id,
-        "fileKey": file_key,
-        "componentName": {platform: component_name},
-        "codeConnect": {"ios": False, "android": False},
-        "confluence": {"page": None, "ios": None, "android": None},
-        "testingIdentifiers": [],
-        "localizationKeys": [],
-        "accessibilityKeys": [],
-        "analyticsEvents": [],
-    }
-    registry_file.parent.mkdir(parents=True, exist_ok=True)
-    registry_file.write_text(
-        json.dumps(initial, indent=2, ensure_ascii=False) + "\n",
-        encoding="utf-8",
-    )
-    return "created"
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Phase 6 finalize  -  update registry codeConnect flag",
-    )
-    parser.add_argument("--node-id", required=True)
-    parser.add_argument("--file-key", required=True)
-    parser.add_argument("--component-name", required=True)
-    parser.add_argument("--platform", default="ios", choices=["ios", "android"])
-    parser.add_argument("--registry-dir", required=False)
-    parser.add_argument("--updater", default="phase-6-code-connect")
-    parser.add_argument(
-        "--no-sync",
-        action="store_true",
-        help="Skip the Projects V2 issue sync propagation step after the registry write.",
-    )
-    args = parser.parse_args()
-
-    registry_dir = Path(args.registry_dir) if args.registry_dir else default_registry_dir()
-    if not registry_dir.exists():
-        print(f"ERROR: registry directory does not exist: {registry_dir}", file=sys.stderr)
-        return 1
-
-    node_id_dash = args.node_id.replace(":", "-")
-    registry_file = registry_dir / f"{node_id_dash}.json"
-
-    # Back-compat: create the legacy shell if the file is missing
-    try:
-        shell_action = ensure_legacy_shell(
-            registry_file=registry_file,
-            node_id=args.node_id,
-            file_key=args.file_key,
-            component_name=args.component_name,
-            platform=args.platform,
-        )
-    except OSError as e:
-        print(f"ERROR: failed to create registry shell: {e}", file=sys.stderr)
-        return 1
-
-    # Delegate actual write to the shared library
-    try:
-        cc_block = set_flag(
-            registry_dir=registry_dir,
-            node_id=args.node_id,
-            platform=args.platform,
-            flag="codeConnect",
-            updater=args.updater,
-        )
-    except (OSError, json.JSONDecodeError, ValueError) as e:
-        print(f"ERROR: {type(e).__name__}: {e}", file=sys.stderr)
-        return 1
-
-    result = {
-        "status": "ok",
-        "action": "updated" if shell_action == "existed" else "created",
-        "file": str(registry_file),
-        "platform": args.platform,
-        "codeConnect": cc_block,
-    }
-
-    if not args.no_sync and not should_skip_sync():
-        result["issue_sync"] = propagate_to_issue(
-            node_id=args.node_id,
-            platform=args.platform,
-            registry_dir=registry_dir,
-        )
-
-    print(json.dumps(result, indent=2, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

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

@@ -1,105 +0,0 @@
-#!/usr/bin/env python3
-"""phase7-finalize.py  -  Post-Phase 7 registry update.
-
-Marks status.<platform>.wiki=true in the component registry JSON after
-Phase 7 writes the wiki page for a component.
-
-Recorded against the current implemented.version, same yellow rule as
-tested/codeConnect.
-
-Usage:
-    python3 phase7-finalize.py \\
-        --node-id 5:17752 \\
-        [--platform ios] \\
-        [--registry-dir /path/to/Shared/Figma/Components]
-
-Exit codes:
-    0  -  Success
-    1  -  Error
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from lib.registry_writer import set_flag  # noqa: E402
-from lib.issue_sync_propagate import propagate_to_issue, should_skip_sync  # noqa: E402
-
-
-def find_repo_root() -> Path:
-    p = Path.cwd()
-    while p != p.parent:
-        if (p / ".git").exists():
-            return p
-        p = p.parent
-    return Path.cwd()
-
-
-def default_registry_dir() -> Path:
-    return (
-        find_repo_root()
-        / "{repos.packagesContainer}"
-        / "Packages"
-        / "{project.slug}-common"
-        / "Shared"
-        / "Figma"
-        / "Components"
-    )
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Phase 7 finalize  -  update registry status.<platform>.wiki",
-    )
-    parser.add_argument("--node-id", required=True)
-    parser.add_argument("--platform", default="ios", choices=["ios", "android"])
-    parser.add_argument("--registry-dir", required=False)
-    parser.add_argument("--updater", default="phase-7-wiki")
-    parser.add_argument(
-        "--no-sync",
-        action="store_true",
-        help="Skip the Projects V2 issue sync propagation step after the registry write.",
-    )
-    args = parser.parse_args()
-
-    registry_dir = Path(args.registry_dir) if args.registry_dir else default_registry_dir()
-    if not registry_dir.exists():
-        print(f"ERROR: registry directory does not exist: {registry_dir}", file=sys.stderr)
-        return 1
-
-    try:
-        wiki_block = set_flag(
-            registry_dir=registry_dir,
-            node_id=args.node_id,
-            platform=args.platform,
-            flag="wiki",
-            updater=args.updater,
-        )
-    except (OSError, json.JSONDecodeError, ValueError) as e:
-        print(f"ERROR: {type(e).__name__}: {e}", file=sys.stderr)
-        return 1
-
-    node_id_dash = args.node_id.replace(":", "-")
-    result = {
-        "status": "ok",
-        "action": "updated",
-        "file": str(registry_dir / f"{node_id_dash}.json"),
-        "platform": args.platform,
-        "wiki": wiki_block,
-    }
-
-    if not args.no_sync and not should_skip_sync():
-        result["issue_sync"] = propagate_to_issue(
-            node_id=args.node_id,
-            platform=args.platform,
-            registry_dir=registry_dir,
-        )
-
-    print(json.dumps(result, indent=2, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/pipeline/skills/figma-ios/figma-to-component/scripts/register-icons-codeconnect.py

@@ -1,179 +0,0 @@
-#!/usr/bin/env python3
-"""
-Register Figma Code-Connected icons in the component registry.
-
-Reads FIGMA_ICONS from generate_icons.py and resolves Swift names from
-UIAssetsGeneratedTokens.swift to set proper componentName values:
-  - ios:     "Image.{swiftName}"
-  - android: "Images.{swiftName}"
-
-Location: .instructions/figma/figma-to-swiftui/scripts/register-icons-codeconnect.py
-Usage:    python3 .instructions/figma/figma-to-swiftui/scripts/register-icons-codeconnect.py
-"""
-
-import json
-import os
-import re
-from datetime import date
-
-SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
-REPO_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, "..", "..", "..", ".."))
-CONFIG_PKG = os.path.join(
-    REPO_ROOT, "{repos.packagesContainer}", "Packages",
-    "{project.slug}-common"
-)
-REGISTRY_DIR = os.path.join(CONFIG_PKG, "Shared", "Figma", "Components")
-GENERATE_ICONS_PY = os.path.join(
-    CONFIG_PKG, "iOS", "Sources", "UIAssets", "CodeConnect", "generate_icons.py"
-)
-TOKENS_FILE = os.path.join(
-    CONFIG_PKG, "iOS", "Sources", "UIAssets", "Generated", "UIAssetsGeneratedTokens.swift"
-)
-
-FILE_KEY = "{FIGMA_FILE_KEY}"
-CONFLUENCE_PAGE = "{confluence.baseUrl}/display/{SPACE}/Custom+Icons"
-CONFLUENCE_PAGE_ID = "{CUSTOM_ICONS_PAGE_ID}"
-TODAY = date.today().isoformat()
-
-
-def build_swift_map(path):
-    """Parse UIAssetsGeneratedTokens.swift: rawValue → swiftName (CustomIcons only)."""
-    swift_map = {}
-    with open(path, "r") as f:
-        for line in f:
-            m = re.match(r'\s+case\s+(\w+)\s*=\s*"([^"]+)"', line)
-            if m:
-                swift_name, raw_value = m.group(1), m.group(2)
-                if "/" not in raw_value:
-                    swift_map[raw_value] = swift_name
-    return swift_map
-
-
-def parse_figma_icons(path):
-    """Parse FIGMA_ICONS list from generate_icons.py."""
-    with open(path, "r") as f:
-        content = f.read()
-
-    match = re.search(r'FIGMA_ICONS\s*=\s*\[(.*?)\]', content, re.DOTALL)
-    if not match:
-        raise ValueError("Could not find FIGMA_ICONS in generate_icons.py")
-
-    icons = []
-    for m in re.finditer(r'\("([^"]+)",\s*"([^"]+)"\)', match.group(1)):
-        icons.append((m.group(1), m.group(2)))
-    return icons
-
-
-def make_registry_entry(node_id, figma_name, swift_name):
-    """Create a registry JSON entry for an icon."""
-    return {
-        "nodeId": node_id,
-        "componentName": {
-            "ios": f"Image.{swift_name}",
-            "android": f"Images.{swift_name}"
-        },
-        "skip": False,
-        "codeConnect": {
-            "ios": True,
-            "android": True
-        },
-        "confluence": {
-            "page": CONFLUENCE_PAGE,
-            "pageId": CONFLUENCE_PAGE_ID,
-            "ios": None,
-            "android": None
-        },
-        "fileKey": FILE_KEY,
-        "lastUpdated": TODAY,
-        "updatedBy": "script:register-icons-codeconnect",
-        "testingIdentifiers": [],
-        "localizationKeys": [],
-        "accessibilityKeys": [],
-        "analyticsEvents": []
-    }
-
-
-def main():
-    swift_map = build_swift_map(TOKENS_FILE)
-    print(f"Swift tokens: {len(swift_map)} CustomIcons entries")
-
-    icons = parse_figma_icons(GENERATE_ICONS_PY)
-    print(f"Parsed {len(icons)} icons from generate_icons.py")
-
-    os.makedirs(REGISTRY_DIR, exist_ok=True)
-
-    created = 0
-    updated = 0
-    unchanged = 0
-    unmatched = 0
-
-    for node_id, figma_name in icons:
-        swift_name = swift_map.get(figma_name.strip())
-        if not swift_name:
-            unmatched += 1
-            print(f"  SKIP: {figma_name} ({node_id})  -  no Swift match")
-            continue
-
-        ios_name = f"Image.{swift_name}"
-        android_name = f"Images.{swift_name}"
-
-        filename = node_id.replace(":", "-") + ".json"
-        filepath = os.path.join(REGISTRY_DIR, filename)
-
-        if os.path.exists(filepath):
-            with open(filepath, "r") as f:
-                existing = json.load(f)
-
-            changed = False
-
-            cc = existing.get("codeConnect", {})
-            if not cc.get("ios", False):
-                existing.setdefault("codeConnect", {})["ios"] = True
-                changed = True
-            if not cc.get("android", False):
-                existing.setdefault("codeConnect", {})["android"] = True
-                changed = True
-
-            # Fix componentName to use resolved Swift names
-            comp_name = existing.get("componentName", {})
-            if comp_name.get("ios") != ios_name:
-                existing.setdefault("componentName", {})["ios"] = ios_name
-                changed = True
-            if comp_name.get("android") != android_name:
-                existing.setdefault("componentName", {})["android"] = android_name
-                changed = True
-
-            conf = existing.get("confluence", {})
-            if conf.get("page") != CONFLUENCE_PAGE:
-                existing.setdefault("confluence", {})["page"] = CONFLUENCE_PAGE
-                existing["confluence"]["pageId"] = CONFLUENCE_PAGE_ID
-                changed = True
-
-            if existing.get("fileKey") != FILE_KEY:
-                existing["fileKey"] = FILE_KEY
-                changed = True
-
-            if changed:
-                existing["lastUpdated"] = TODAY
-                existing["updatedBy"] = "script:register-icons-codeconnect"
-                with open(filepath, "w") as f:
-                    json.dump(existing, f, indent=2, ensure_ascii=False)
-                    f.write("\n")
-                updated += 1
-                print(f"  UPDATED: {filename} → {ios_name}")
-            else:
-                unchanged += 1
-        else:
-            entry = make_registry_entry(node_id, figma_name, swift_name)
-            with open(filepath, "w") as f:
-                json.dump(entry, f, indent=2, ensure_ascii=False)
-                f.write("\n")
-            created += 1
-            print(f"  CREATED: {filename} → {ios_name}")
-
-    print(f"\nDone: {created} created, {updated} updated, {unchanged} unchanged, {unmatched} unmatched")
-    print(f"Registry: {REGISTRY_DIR}")
-
-
-if __name__ == "__main__":
-    main()