@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

package/pipeline/skills/figma-ios/figma-to-component/scripts/sidebar-generator.py

@@ -1,321 +0,0 @@
-#!/usr/bin/env python3
-"""
-sidebar-generator.py  -  Idempotent _Sidebar.md generator for GitHub Wiki.
-
-Scans the wiki directory structure and produces a deterministic _Sidebar.md.
-No external dependencies (registry, frontmatter, etc.)  -  purely filesystem-based.
-
-Usage:
-    python3 sidebar-generator.py [--wiki-root PATH] [--dry-run] [--check]
-
-    --wiki-root PATH   Path to wiki repo (default: auto-detect from script location)
-    --dry-run          Print to stdout instead of writing _Sidebar.md
-    --check            Exit 0 if _Sidebar.md is already up-to-date, exit 1 if stale
-"""
-
-import argparse
-import os
-import sys
-from pathlib import Path
-from typing import Dict, List, Optional
-
-# ── Configuration ──────────────────────────────────────────────────────────
-
-# Top-level folders that map to sidebar sections (order preserved).
-# Key = folder name, Value = sidebar bold heading.
-SECTION_MAP = {
-    "DesignSystemCore": "Design System Core",
-    "MobileAppComponents": "Mobile App Components",
-    "VisualAssets": "Visual Assets",
-}
-
-# Folders to skip entirely (not component directories).
-SKIP_FOLDERS = {"FigmaComponents", "assets", ".git"}
-
-# Fixed header lines at the top of _Sidebar.md.
-HEADER = """\
-**[[Home]]**
-**[[ComponentImplementationStatus|Component Status]]**
-**[[BuildMetrics|Build Metrics]]**"""
-
-
-# ── Helpers ────────────────────────────────────────────────────────────────
-
-def find_wiki_root() -> Path:
-    """Auto-detect wiki root relative to this script's location."""
-    script_dir = Path(__file__).resolve().parent
-    # Navigate from .instructions/figma/figma-to-swiftui/scripts/ up to repo root
-    repo_root = script_dir.parent.parent.parent.parent
-    wiki_root = repo_root / "{repos.packagesContainer}" / "Packages" / "{project.slug}-wiki"
-    if not wiki_root.is_dir():
-        sys.exit(f"ERROR: Wiki root not found at {wiki_root}")
-    return wiki_root
-
-
-def has_wiki_page(folder: Path) -> bool:
-    """Check if a folder contains at least one .md file (excluding -iOS.md)."""
-    for item in folder.rglob("*.md"):
-        if not item.name.endswith("-iOS.md") and not item.name.startswith("_"):
-            return True
-    return False
-
-
-def collect_components(section_root: Path) -> Dict[str, List[str]]:
-    """
-    Walk a section folder and return {subsection_name: [component_names]}.
-
-    The subsection is the "grouping folder"  -  the directory that contains
-    individual component folders (which themselves contain .md files).
-
-    Structure patterns handled:
-      DesignSystemCore/Avatar/AvatarCorporateClub/AvatarCorporateClub.md
-        → subsection="Avatar", component="AvatarCorporateClub"
-
-      DesignSystemCore/Checkbox/Checkbox.md
-        → subsection="Checkbox", component="Checkbox"
-
-      MobileAppComponents/Components/Animations/LoadingProgress/LoadingProgress.md
-        → subsection="Animations", component="LoadingProgress"
-
-      MobileAppComponents/FlowBasedComponents/Booker/BookerHolidayContactArea/...
-        → subsection="Booker", component="BookerHolidayContactArea"
-
-      VisualAssets/OtherVisualAssets/Badge/AddToSiri/AddToSiri.md
-        → subsection="Badge", component="AddToSiri"
-
-      VisualAssets/Logos/BrandLogo/LogoTkPay/LogoTkPay.md
-        → subsection="Logos", component="LogoTkPay"
-    """
-    result: Dict[str, List[str]] = {}
-
-    def _scan(base: Path, subsection_name: Optional[str]):
-        """Recursively scan directories to find component leaf folders."""
-        for child in sorted(base.iterdir()):
-            if not child.is_dir() or child.name in SKIP_FOLDERS:
-                continue
-
-            # Check if this child folder directly contains a .md wiki page
-            direct_md = [
-                f for f in child.iterdir()
-                if f.is_file()
-                and f.suffix == ".md"
-                and not f.name.endswith("-iOS.md")
-                and not f.name.startswith("_")
-            ]
-
-            # Check if it also has component subdirectories
-            component_subdirs = [
-                grandchild for grandchild in child.iterdir()
-                if grandchild.is_dir()
-                and grandchild.name not in SKIP_FOLDERS
-                and has_wiki_page(grandchild)
-            ]
-
-            if direct_md and not component_subdirs:
-                # Pure leaf component folder with a wiki page.
-                sub = subsection_name or child.name
-                result.setdefault(sub, []).append(child.name)
-            elif direct_md and component_subdirs:
-                # Hybrid: has both a direct .md AND component subfolders.
-                # E.g. Components/Carousel/ has Carousel.md + CarouselGroup/
-                # Use child.name as subsection (not the intermediate parent).
-                sub = child.name
-                result.setdefault(sub, []).append(child.name)
-                _scan(child, sub)
-            elif component_subdirs:
-                # Pure grouping folder  -  recurse.
-                if _is_intermediate_folder(child, base):
-                    _scan(child, subsection_name)
-                else:
-                    _scan(child, child.name)
-
-    _scan(section_root, None)
-    return result
-
-
-def _is_intermediate_folder(folder: Path, section_root: Path) -> bool:
-    """
-    Determine if a folder is an intermediate grouping folder
-    (like Components, FlowBasedComponents, Icons, Logos, OtherVisualAssets)
-    rather than a meaningful subsection.
-
-    Intermediate folders are direct children of the section root
-    that contain further grouping subdirectories (not leaf components).
-    """
-    if folder.parent != section_root:
-        return False
-
-    # Check if this folder's children are mostly directories with their own subdirectories
-    child_dirs = [
-        c for c in folder.iterdir()
-        if c.is_dir() and c.name not in SKIP_FOLDERS
-    ]
-    if not child_dirs:
-        return False
-
-    # If none of the children have direct .md files, this is intermediate.
-    has_any_direct_md = any(
-        any(
-            f.is_file() and f.suffix == ".md"
-            and not f.name.endswith("-iOS.md")
-            and not f.name.startswith("_")
-            for f in c.iterdir()
-        )
-        for c in child_dirs
-    )
-    return not has_any_direct_md
-
-
-def format_section(heading: str, subsections: Dict[str, List[str]]) -> str:
-    """Format a sidebar section with its subsections and components."""
-    lines = [f"**{heading}**", ""]
-
-    for sub_name in sorted(subsections.keys()):
-        components = sorted(subsections[sub_name])
-        lines.append(f"*{sub_name}*")
-        for comp in components:
-            lines.append(f"- [[{comp}]]")
-        lines.append("")
-
-    return "\n".join(lines)
-
-
-def generate_sidebar(wiki_root: Path) -> str:
-    """Generate the full _Sidebar.md content."""
-    parts = [HEADER, ""]
-
-    for folder_name, heading in SECTION_MAP.items():
-        section_path = wiki_root / folder_name
-        if not section_path.is_dir():
-            continue
-
-        parts.append("---")
-        parts.append("")
-
-        subsections = collect_components(section_path)
-        if subsections:
-            parts.append(format_section(heading, subsections))
-
-    content = "\n".join(parts)
-    # Normalize: ensure single trailing newline, collapse triple+ blank lines
-    while "\n\n\n" in content:
-        content = content.replace("\n\n\n", "\n\n")
-    return content.rstrip() + "\n"
-
-
-# ── VisualAssets special handling ──────────────────────────────────────────
-# VisualAssets has a deeper nesting:
-#   VisualAssets/OtherVisualAssets/Badge/AddToSiri/AddToSiri.md
-#   VisualAssets/Logos/BrandLogo/LogoTkPay/LogoTkPay.md
-#   VisualAssets/Logos/PaymentLogo/CreditCardLogo/CreditCardLogo.md
-#
-# The subsection grouping for VisualAssets works differently:
-#   - Icons → children are grouped under their direct subfolder name (BrandIcons)
-#   - Logos → collapse BrandLogo/PaymentLogo/ThirdPartyLogo under "Logos"
-#   - OtherVisualAssets → children are grouped under their subfolder (Badge)
-#
-# The generic collect_components handles this because:
-#   - VisualAssets/Logos is intermediate (has BrandLogo, PaymentLogo, ThirdPartyLogo)
-#   - Each of those is a subsection candidate, but Logos grouping is preferred
-#
-# We override with a specialized collector for VisualAssets.
-
-
-def collect_visual_assets(section_root: Path) -> Dict[str, List[str]]:
-    """
-    Specialized collector for VisualAssets.
-    Groups components by the level-2 subfolder for Icons/OtherVisualAssets
-    and collapses Logos into a single "Logos" subsection.
-    """
-    result: Dict[str, List[str]] = {}
-
-    for level1 in sorted(section_root.iterdir()):
-        if not level1.is_dir() or level1.name in SKIP_FOLDERS:
-            continue
-
-        if level1.name == "Logos":
-            # Collapse all logo subfolders into one "Logos" subsection
-            for level2 in sorted(level1.iterdir()):
-                if not level2.is_dir() or level2.name in SKIP_FOLDERS:
-                    continue
-                for comp_folder in sorted(level2.iterdir()):
-                    if not comp_folder.is_dir() or comp_folder.name in SKIP_FOLDERS:
-                        continue
-                    if has_wiki_page(comp_folder):
-                        result.setdefault("Logos", []).append(comp_folder.name)
-        else:
-            # Icons, OtherVisualAssets: group by level-2 folder
-            for level2 in sorted(level1.iterdir()):
-                if not level2.is_dir() or level2.name in SKIP_FOLDERS:
-                    continue
-                for comp_folder in sorted(level2.iterdir()):
-                    if not comp_folder.is_dir() or comp_folder.name in SKIP_FOLDERS:
-                        continue
-                    if has_wiki_page(comp_folder):
-                        result.setdefault(level2.name, []).append(comp_folder.name)
-
-    return result
-
-
-# Patch the generate function to use the specialized collector for VisualAssets.
-_original_generate = generate_sidebar
-
-
-def generate_sidebar(wiki_root: Path) -> str:
-    parts = [HEADER, ""]
-
-    for folder_name, heading in SECTION_MAP.items():
-        section_path = wiki_root / folder_name
-        if not section_path.is_dir():
-            continue
-
-        parts.append("---")
-        parts.append("")
-
-        if folder_name == "VisualAssets":
-            subsections = collect_visual_assets(section_path)
-        else:
-            subsections = collect_components(section_path)
-
-        if subsections:
-            parts.append(format_section(heading, subsections))
-
-    content = "\n".join(parts)
-    while "\n\n\n" in content:
-        content = content.replace("\n\n\n", "\n\n")
-    return content.rstrip() + "\n"
-
-
-# ── Main ───────────────────────────────────────────────────────────────────
-
-def main():
-    parser = argparse.ArgumentParser(description="Generate _Sidebar.md from wiki directory structure.")
-    parser.add_argument("--wiki-root", type=str, help="Path to the wiki repo root.")
-    parser.add_argument("--dry-run", action="store_true", help="Print to stdout instead of writing file.")
-    parser.add_argument("--check", action="store_true", help="Exit 1 if _Sidebar.md is stale.")
-    args = parser.parse_args()
-
-    wiki_root = Path(args.wiki_root) if args.wiki_root else find_wiki_root()
-    if not wiki_root.is_dir():
-        sys.exit(f"ERROR: Wiki root not found: {wiki_root}")
-
-    content = generate_sidebar(wiki_root)
-    sidebar_path = wiki_root / "_Sidebar.md"
-
-    if args.check:
-        if sidebar_path.exists() and sidebar_path.read_text() == content:
-            print("_Sidebar.md is up-to-date.")
-            sys.exit(0)
-        else:
-            print("_Sidebar.md is STALE  -  needs regeneration.")
-            sys.exit(1)
-
-    if args.dry_run:
-        print(content, end="")
-    else:
-        sidebar_path.write_text(content)
-        print(f"✓ _Sidebar.md written ({content.count(chr(10))} lines)")
-
-
-if __name__ == "__main__":
-    main()