@mmerterden/multi-agent-pipeline 11.2.0 → 11.3.0

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

@@ -1,336 +0,0 @@
-#!/usr/bin/env python3
-"""
-Confluence publish orchestration script.
-Creates/updates main page + iOS sub-page + Android placeholder.
-Attaches screenshots and updates the per-component registry.
-
-Usage:
-    python3 scripts/confluence-publish.py \
-        --component "LabelBadge" \
-        --artifact-path "path/to/confluence" \
-        --node-id "6893:6879" \
-        --parent-page-id "148074778" \
-        [--space DK] [--dry-run]
-"""
-
-import argparse
-import glob
-import json
-import os
-import subprocess
-import sys
-import urllib.parse
-import urllib.request
-
-BASE_URL = "{confluence.baseUrl}"
-
-
-def get_token():
-    result = subprocess.run(
-        ["security", "find-generic-password", "-a", os.environ["USER"],
-         "-s", "CONFLUENCE_TOKEN", "-w"],
-        capture_output=True, text=True, check=True
-    )
-    return result.stdout.strip()
-
-
-def lookup_page(token, space, title):
-    encoded = urllib.parse.quote(title)
-    url = f"{BASE_URL}/rest/api/content?spaceKey={space}&title={encoded}&expand=version"
-    req = urllib.request.Request(url)
-    req.add_header("Authorization", f"Bearer {token}")
-    with urllib.request.urlopen(req) as resp:
-        data = json.loads(resp.read())
-    results = data.get("results", [])
-    if results:
-        r = results[0]
-        return {"id": r["id"], "version": r["version"]["number"]}
-    return None
-
-
-def create_page(token, space, title, content, parent_id):
-    payload = {
-        "type": "page",
-        "title": title,
-        "ancestors": [{"id": str(parent_id)}],
-        "space": {"key": space},
-        "body": {
-            "storage": {
-                "value": content,
-                "representation": "storage"
-            }
-        }
-    }
-    body = json.dumps(payload).encode()
-    req = urllib.request.Request(f"{BASE_URL}/rest/api/content", data=body, method="POST")
-    req.add_header("Authorization", f"Bearer {token}")
-    req.add_header("Content-Type", "application/json")
-    with urllib.request.urlopen(req) as resp:
-        data = json.loads(resp.read())
-    if "id" in data:
-        return {"id": data["id"], "version": data["version"]["number"]}
-    raise RuntimeError(f"Create failed: {data.get('message', data)}")
-
-
-def update_page(token, page_id, title, content, version):
-    new_version = version + 1
-    payload = {
-        "version": {"number": new_version},
-        "title": title,
-        "type": "page",
-        "body": {
-            "storage": {
-                "value": content,
-                "representation": "storage"
-            }
-        }
-    }
-    body = json.dumps(payload).encode()
-    req = urllib.request.Request(
-        f"{BASE_URL}/rest/api/content/{page_id}", data=body, method="PUT"
-    )
-    req.add_header("Authorization", f"Bearer {token}")
-    req.add_header("Content-Type", "application/json")
-    with urllib.request.urlopen(req) as resp:
-        data = json.loads(resp.read())
-    if "id" in data:
-        return new_version
-    raise RuntimeError(f"Update failed: {data.get('message', data)}")
-
-
-def get_existing_attachment(token, page_id, filename):
-    """Look up an existing attachment by filename on a page."""
-    encoded = urllib.parse.quote(filename)
-    url = (f"{BASE_URL}/rest/api/content/{page_id}/child/attachment"
-           f"?filename={encoded}")
-    req = urllib.request.Request(url)
-    req.add_header("Authorization", f"Bearer {token}")
-    with urllib.request.urlopen(req) as resp:
-        data = json.loads(resp.read())
-    results = data.get("results", [])
-    if results:
-        return results[0]["id"]
-    return None
-
-
-def attach_file(token, page_id, file_path):
-    """Attach or update a file on a Confluence page using curl."""
-    filename = os.path.basename(file_path)
-    attachment_id = get_existing_attachment(token, page_id, filename)
-
-    if attachment_id:
-        # Update existing attachment
-        url = (f"{BASE_URL}/rest/api/content/{page_id}"
-               f"/child/attachment/{attachment_id}/data")
-        method = "POST"
-    else:
-        # Create new attachment
-        url = f"{BASE_URL}/rest/api/content/{page_id}/child/attachment"
-        method = "POST"
-
-    result = subprocess.run(
-        ["curl", "-s", "-X", method, url,
-         "-H", f"Authorization: Bearer {token}",
-         "-H", "X-Atlassian-Token: nocheck",
-         "-F", f"file=@{file_path}"],
-        capture_output=True, text=True, check=True
-    )
-    data = json.loads(result.stdout)
-    results = data.get("results", [])
-    if results:
-        action = "Updated" if attachment_id else "Created"
-        return f"{action}: {results[0].get('title', filename)}"
-    # Single-object response (update returns object directly)
-    if "title" in data:
-        return f"Updated: {data['title']}"
-    return str(data)[:200]
-
-
-def find_registry_file(node_id):
-    node_id_dash = node_id.replace(":", "-")
-    candidates = [
-        f"{repos.common.path}/Shared/Figma/Components/{node_id_dash}.json",
-    ]
-    for path in candidates:
-        if os.path.isfile(path):
-            return path
-    return None
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Publish component to Confluence")
-    parser.add_argument("--component", required=True, help="Component name")
-    parser.add_argument("--artifact-path", required=True, help="Path to confluence artifacts")
-    parser.add_argument("--node-id", required=True, help="Figma node ID (e.g. 6893:6879)")
-    parser.add_argument("--parent-page-id", required=True, help="Confluence parent page ID")
-    parser.add_argument("--space", default="DK", help="Confluence space key")
-    parser.add_argument("--dry-run", action="store_true", help="Preview without changes")
-    args = parser.parse_args()
-
-    token = get_token()
-    registry_file = find_registry_file(args.node_id)
-
-    print("=== Confluence Publish ===")
-    print(f"Component: {args.component}")
-    print(f"Artifact:  {args.artifact_path}")
-    print(f"Node ID:   {args.node_id}")
-    print(f"Parent:    {args.parent_page_id}")
-    print(f"Space:     {args.space}")
-    print(f"Registry:  {registry_file or 'not found'}")
-    print()
-
-    # ---- 1. MAIN PAGE ----
-    print(f"--- Main Page: {args.component} ---")
-    main_file = os.path.join(args.artifact_path, "main.html")
-    if not os.path.isfile(main_file):
-        print(f"ERROR: main.html not found at {main_file}")
-        sys.exit(1)
-
-    with open(main_file) as f:
-        main_content = f.read()
-
-    existing = lookup_page(token, args.space, args.component)
-    main_page_id = None
-
-    if existing is None:
-        if args.dry_run:
-            print(f"[DRY RUN] Would create page: {args.component} (parent: {args.parent_page_id})")
-            main_page_id = "DRY_RUN"
-        else:
-            result = create_page(token, args.space, args.component,
-                                 main_content, args.parent_page_id)
-            main_page_id = result["id"]
-            print(f"Created: {main_page_id}")
-    else:
-        main_page_id = existing["id"]
-        if args.dry_run:
-            print(f"[DRY RUN] Would update page: {main_page_id} (v{existing['version']})")
-        else:
-            new_v = update_page(token, main_page_id, args.component,
-                                main_content, existing["version"])
-            print(f"Updated: {main_page_id} (v{new_v})")
-
-    # ---- 2. ATTACH SCREENSHOTS (main page  -  non-ios_ assets) ----
-    print(f"\n--- Attachments (Main Page) ---")
-    assets_dir = os.path.join(args.artifact_path, "assets")
-    ios_assets = []  # defer ios_ prefixed assets for iOS sub-page
-    if os.path.isdir(assets_dir):
-        for asset in sorted(glob.glob(os.path.join(assets_dir, "*.png"))):
-            name = os.path.basename(asset)
-            if name.startswith("ios_"):
-                ios_assets.append(asset)
-                continue
-            if args.dry_run:
-                print(f"[DRY RUN] Would attach: {name} to page {main_page_id}")
-            else:
-                result = attach_file(token, main_page_id, asset)
-                print(f"Attached: {result}")
-    else:
-        print(f"No assets directory found at {assets_dir}")
-
-    # ---- 3. iOS SUB-PAGE ----
-    ios_title = f"{args.component} - iOS"
-    ios_file = os.path.join(args.artifact_path, "ios.html")
-    ios_page_id = None
-
-    print(f"\n--- iOS Sub-Page: {ios_title} ---")
-    if not os.path.isfile(ios_file):
-        print(f"WARNING: ios.html not found at {ios_file}  -  skipping")
-    else:
-        with open(ios_file) as f:
-            ios_content = f.read()
-
-        ios_existing = lookup_page(token, args.space, ios_title)
-        if ios_existing is None:
-            if args.dry_run:
-                print(f"[DRY RUN] Would create iOS sub-page (parent: {main_page_id})")
-                ios_page_id = "DRY_RUN"
-            else:
-                result = create_page(token, args.space, ios_title,
-                                     ios_content, main_page_id)
-                ios_page_id = result["id"]
-                print(f"Created: {ios_page_id}")
-        else:
-            ios_page_id = ios_existing["id"]
-            if args.dry_run:
-                print(f"[DRY RUN] Would update: {ios_page_id} (v{ios_existing['version']})")
-            else:
-                new_v = update_page(token, ios_page_id, ios_title,
-                                    ios_content, ios_existing["version"])
-                print(f"Updated: {ios_page_id} (v{new_v})")
-
-    # ---- 3b. ATTACH iOS SNAPSHOT IMAGES ----
-    if ios_page_id and ios_assets:
-        print(f"\n--- Attachments (iOS Page) ---")
-        for asset in ios_assets:
-            name = os.path.basename(asset)
-            if args.dry_run:
-                print(f"[DRY RUN] Would attach: {name} to page {ios_page_id}")
-            else:
-                result = attach_file(token, ios_page_id, asset)
-                print(f"Attached: {result}")
-
-    # ---- 4. ANDROID PLACEHOLDER ----
-    android_title = f"{args.component} - Android"
-    android_page_id = None
-
-    print(f"\n--- Android Placeholder: {android_title} ---")
-    android_existing = lookup_page(token, args.space, android_title)
-
-    if android_existing is None:
-        android_content = (
-            f'<p><ac:link><ri:page ri:content-title="{args.component}"/>'
-            f'<ac:plain-text-link-body><![CDATA[&larr; Back to {args.component}]]>'
-            f'</ac:plain-text-link-body></ac:link></p>'
-            f'<hr/><p><em>Android implementation pending.</em></p>'
-        )
-        if args.dry_run:
-            print("[DRY RUN] Would create Android placeholder")
-            android_page_id = "DRY_RUN"
-        else:
-            result = create_page(token, args.space, android_title,
-                                 android_content, main_page_id)
-            android_page_id = result["id"]
-            print(f"Created placeholder: {android_page_id}")
-    else:
-        android_page_id = android_existing["id"]
-        print(f"Android placeholder already exists: {android_page_id}")
-
-    # ---- 5. UPDATE REGISTRY ----
-    component_encoded = args.component.replace(" ", "+")
-    ios_encoded = ios_title.replace(" ", "+")
-    android_encoded = android_title.replace(" ", "+")
-    main_url = f"{BASE_URL}/display/{args.space}/{component_encoded}"
-    ios_url = f"{BASE_URL}/display/{args.space}/{ios_encoded}"
-    android_url = f"{BASE_URL}/display/{args.space}/{android_encoded}"
-
-    print(f"\n--- Registry Update ---")
-    if registry_file and os.path.isfile(registry_file):
-        if args.dry_run:
-            print(f"[DRY RUN] Would update registry: {registry_file}")
-            print(f"  confluence.page = {main_url}")
-            print(f"  confluence.ios = {ios_url}")
-            print(f"  confluence.android = {android_url}")
-        else:
-            with open(registry_file) as f:
-                registry = json.load(f)
-            registry.setdefault("confluence", {})
-            registry["confluence"]["page"] = main_url
-            registry["confluence"]["ios"] = ios_url
-            registry["confluence"]["android"] = android_url
-            with open(registry_file, "w") as f:
-                json.dump(registry, f, indent=2, sort_keys=True, ensure_ascii=False)
-                f.write("\n")
-            print(f"Registry updated: {registry_file}")
-    else:
-        print("WARNING: Registry file not found  -  skipping registry update")
-
-    # ---- SUMMARY ----
-    print(f"\n=== Done ===")
-    print(f"Main Page:  {main_page_id or 'N/A'} ({main_url})")
-    print(f"iOS Page:   {ios_page_id or 'N/A'} ({ios_url})")
-    print(f"Android:    {android_page_id or 'N/A'} ({android_url})")
-
-
-if __name__ == "__main__":
-    main()