@mmerterden/multi-agent-pipeline 11.2.0 → 11.3.0

package/pipeline/skills/figma-ios/figma-to-component/reference/wiki-to-confluence-mapping.md

@@ -1,182 +0,0 @@
-# Wiki Markdown → Confluence XHTML Mapping
-
-Rules for converting wiki markdown documentation to Confluence Storage Format XHTML.
-Used by the standalone `/figma-to-swift-ui-confluence` skill.
-
----
-
-## Document Splitting
-
-Split the single `{ComponentName}.md` at the `## iOS Implementation` heading:
-
-- **Everything above** `## iOS Implementation` → `main.html` (platform-agnostic main page)
-- **Everything from** `## iOS Implementation` **onward** → `ios.html` (iOS sub-page)
-
-### ios.html prepend
-
-Prepend a back-link to the main page:
-
-```xml
-<p><ac:link><ri:page ri:content-title="{ComponentName}"/><ac:plain-text-link-body><![CDATA[&larr; Back to {ComponentName}]]></ac:plain-text-link-body></ac:link></p>
-<hr/>
-```
-
-### main.html prepend
-
-Prepend a TOC macro after the metadata block:
-
-```xml
-<ac:structured-macro ac:name="toc">
-<ac:parameter ac:name="printable">true</ac:parameter>
-<ac:parameter ac:name="style">disc</ac:parameter>
-<ac:parameter ac:name="maxLevel">2</ac:parameter>
-<ac:parameter ac:name="minLevel">2</ac:parameter>
-</ac:structured-macro>
-<hr/>
-```
-
-### Platform Implementations section
-
-In `main.html`, replace the simple table with links to sub-pages:
-
-```xml
-<table><tbody>
-<tr><th>Platform</th><th>Status</th><th>Documentation</th></tr>
-<tr>
-<td>iOS</td><td>Implemented</td>
-<td><ac:link><ri:page ri:content-title="{ComponentName} - iOS"/><ac:plain-text-link-body><![CDATA[{ComponentName} - iOS]]></ac:plain-text-link-body></ac:link></td>
-</tr>
-<tr>
-<td>Android</td><td>Pending</td>
-<td><ac:link><ri:page ri:content-title="{ComponentName} - Android"/><ac:plain-text-link-body><![CDATA[{ComponentName} - Android]]></ac:plain-text-link-body></ac:link></td>
-</tr>
-</tbody></table>
-```
-
----
-
-## Element Mapping
-
-### Headings
-
-| Markdown | XHTML |
-|----------|-------|
-| `# H1` | `<h1>H1</h1>` |
-| `## H2` | `<h2>H2</h2>` |
-| `### H3` | `<h3>H3</h3>` |
-| `#### H4` | `<h4>H4</h4>` |
-
-### Horizontal Rules
-
-| Markdown | XHTML |
-|----------|-------|
-| `---` | `<hr/>` |
-
-### Inline Formatting
-
-| Markdown | XHTML |
-|----------|-------|
-| `*italic*` | `<em>italic</em>` |
-| `**bold**` | `<strong>bold</strong>` |
-| `` `code` `` | `<code>code</code>` |
-
-### Images (Wiki Syntax)
-
-| Wiki Markdown | XHTML |
-|---------------|-------|
-| `[[/FigmaComponents/.../assets/{file}|{alt}]]` | `<ac:image ac:width="375"><ri:attachment ri:filename="{file}"/></ac:image>` |
-
-**Width rules:**
-- Main screenshot: `ac:width="375"`
-- Variant screenshots: `ac:width="100"`
-- Snapshot test images: use width from test file frame (e.g., `ac:width="60"` or `ac:width="375"`)
-
-**Filename extraction:** From `[[/FigmaComponents/.../assets/screenshot.png|alt]]`, extract just `screenshot.png` for `ri:filename`.
-
-### Internal Links (Wiki Syntax)
-
-| Wiki Markdown | XHTML |
-|---------------|-------|
-| `[[ComponentName]]` | `<ac:link><ri:page ri:content-title="ComponentName"/><ac:plain-text-link-body><![CDATA[ComponentName]]></ac:plain-text-link-body></ac:link>` |
-
-### External Links
-
-| Markdown | XHTML |
-|----------|-------|
-| `[text](url)` | `<a href="url">text</a>` |
-
-### Code Blocks
-
-````markdown
-```swift
-code here
-```
-````
-
-→
-
-```xml
-<ac:structured-macro ac:name="code">
-<ac:parameter ac:name="language">java</ac:parameter>
-<ac:plain-text-body><![CDATA[code here]]></ac:plain-text-body>
-</ac:structured-macro>
-```
-
-**Note:** Confluence uses `language="java"` for Swift syntax highlighting.
-
-### Tables
-
-```markdown
-| Header1 | Header2 |
-|---------|---------|
-| cell1   | cell2   |
-```
-
-→
-
-```xml
-<table><tbody>
-<tr><th>Header1</th><th>Header2</th></tr>
-<tr><td>cell1</td><td>cell2</td></tr>
-</tbody></table>
-```
-
-### Paragraphs
-
-| Markdown | XHTML |
-|----------|-------|
-| Plain text | `<p>text</p>` |
-| Empty line | Paragraph break |
-
----
-
-## XHTML Escaping Rules
-
-- XML attribute values (`ri:filename`, `ri:content-title`) MUST escape: `&` → `&amp;`, `"` → `&quot;`, `<` → `&lt;`, `>` → `&gt;`
-- Text inside `<![CDATA[...]]>` blocks does NOT need escaping
-- Text inside element content (between tags) needs `&` and `<` escaped
-- Filenames on disk keep original characters  -  XML parser decodes the escapes
-
----
-
-## Snapshot Tests Section
-
-The Snapshot Tests section in the wiki markdown uses wiki image syntax in table cells.
-Convert each row:
-
-**Wiki:**
-```markdown
-| **VariantName** | `ComponentName(param: .value)` | [[/.../ios_light_variant.png|light]] | [[/.../ios_dark_variant.png|dark]] |
-```
-
-**XHTML:**
-```xml
-<tr>
-<td><strong>VariantName</strong></td>
-<td><pre style="background:#f4f5f7; border:1px solid #dfe1e6; border-radius:3px; padding:8px; font-family:SFMono-Regular,Menlo,Monaco,monospace; font-size:12px; margin:0; white-space:pre">ComponentName(param: .value)</pre></td>
-<td><ac:image ac:width="{SNAPSHOT_WIDTH}"><ri:attachment ri:filename="ios_light_variant.png"/></ac:image></td>
-<td><ac:image ac:width="{SNAPSHOT_WIDTH}"><ri:attachment ri:filename="ios_dark_variant.png"/></ac:image></td>
-</tr>
-```
-
-Use `<pre>` style for inline code in snapshot tables (not `<code>` or code macro) to match Confluence rendering.

package/pipeline/skills/figma-ios/figma-to-component/scripts/apply-author-login-map.py

@@ -1,185 +0,0 @@
-#!/usr/bin/env python3
-"""apply-author-login-map.py  -  rewrite status.<platform>.implementedBy
-in every registry entry, replacing git-author display names with the
-resolved GitHub logins from temp/author-login-map.json.
-
-Walks the component registry. For each entry whose
-status.<platform>.implementedBy is a display name present in the
-mapping file, overwrites the value with the resolved `login`. Entries
-whose implementedBy is already a login (e.g. M-ISPIRLI_tkgithub, or
-the author resolved to the same login after manual fill) are
-re-written idempotently (no-op write).
-
-Entries whose implementedBy is not in the mapping file at all are
-left alone  -  they were either set by something else or wouldn't be
-found by the build-author-registry pass.
-
-Writes go through lib.registry_writer.set_implemented_by so the
-lastUpdated/updatedBy fields stay consistent.
-
-Usage:
-    python3 apply-author-login-map.py \\
-        [--registry-dir /path] \\
-        [--map-file temp/author-login-map.json] \\
-        [--platform ios] \\
-        [--dry-run]
-
-Exit codes:
-    0  -  success
-    1  -  setup error (missing files)
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-from typing import Dict, Optional
-
-sys.path.insert(0, str(Path(__file__).parent))
-from lib.registry_writer import set_implemented_by  # 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 default_map_file() -> Path:
-    return find_repo_root() / "temp" / "author-login-map.json"
-
-
-def load_display_to_login(map_file: Path) -> Dict[str, str]:
-    """Return { display_name: github_login } from the map file."""
-    data = json.loads(map_file.read_text(encoding="utf-8"))
-    result: Dict[str, str] = {}
-    for name, info in (data.get("mapping") or {}).items():
-        login = info.get("login")
-        if login:
-            result[name] = login
-    return result
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Rewrite implementedBy using resolved GitHub logins",
-    )
-    parser.add_argument("--registry-dir")
-    parser.add_argument("--map-file")
-    parser.add_argument("--platform", default="ios", choices=["ios", "android"])
-    parser.add_argument("--dry-run", action="store_true")
-    args = parser.parse_args()
-
-    registry_dir = Path(args.registry_dir) if args.registry_dir else default_registry_dir()
-    map_file = Path(args.map_file) if args.map_file else default_map_file()
-
-    if not registry_dir.exists():
-        print(f"ERROR: registry dir not found: {registry_dir}", file=sys.stderr)
-        return 1
-    if not map_file.exists():
-        print(f"ERROR: map file not found: {map_file}", file=sys.stderr)
-        return 1
-
-    display_to_login = load_display_to_login(map_file)
-    print(f"Loaded {len(display_to_login)} display→login mappings", file=sys.stderr)
-
-    counts = {
-        "total_files": 0,
-        "rewritten": 0,
-        "already_login": 0,
-        "no_implemented_by": 0,
-        "not_in_map": 0,
-    }
-    rewritten_samples = []
-    not_in_map_samples = []
-
-    for path in sorted(registry_dir.glob("*.json")):
-        counts["total_files"] += 1
-        try:
-            data = json.loads(path.read_text(encoding="utf-8"))
-        except (json.JSONDecodeError, OSError):
-            continue
-
-        status = data.get("status")
-        if not isinstance(status, dict):
-            counts["no_implemented_by"] += 1
-            continue
-        ps = status.get(args.platform)
-        if not isinstance(ps, dict):
-            counts["no_implemented_by"] += 1
-            continue
-
-        current = ps.get("implementedBy")
-        if not isinstance(current, str) or not current:
-            counts["no_implemented_by"] += 1
-            continue
-
-        login = display_to_login.get(current)
-        if login is None:
-            # Current value isn't a key in the map. Might already be a login
-            # (e.g. the build-author-registry already resolved it directly
-            # for login-like names). Check: if current is a value in the map,
-            # we leave it  -  it's already correct.
-            if current in display_to_login.values():
-                counts["already_login"] += 1
-            else:
-                counts["not_in_map"] += 1
-                if len(not_in_map_samples) < 5:
-                    not_in_map_samples.append({
-                        "node_id": data.get("nodeId"),
-                        "current": current,
-                    })
-            continue
-
-        if current == login:
-            counts["already_login"] += 1
-            continue
-
-        if not args.dry_run:
-            set_implemented_by(
-                registry_dir=registry_dir,
-                node_id=data.get("nodeId", path.stem.replace("-", ":")),
-                platform=args.platform,
-                author=login,
-                updater="apply-author-login-map",
-            )
-
-        counts["rewritten"] += 1
-        if len(rewritten_samples) < 5:
-            rewritten_samples.append({
-                "node_id": data.get("nodeId"),
-                "from": current,
-                "to": login,
-            })
-
-    summary = {
-        "status": "ok",
-        "dry_run": args.dry_run,
-        "registry_dir": str(registry_dir),
-        "map_file": str(map_file),
-        "platform": args.platform,
-        "counts": counts,
-        "rewritten_samples": rewritten_samples,
-        "not_in_map_samples": not_in_map_samples,
-    }
-    print(json.dumps(summary, indent=2, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())