@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

package/pipeline/skills/figma-ios/figma-to-component/reference/scripts-inventory.md

@@ -6,7 +6,7 @@ All scripts in `.instructions/figma/figma-to-swiftui/scripts/`. Each replaces sl
 
 ## Data Gathering
 
-### `phase1-gather.py` — Phase 1 Data Collection
+### `phase1-gather.py`  -  Phase 1 Data Collection
 
 Replaces the Phase 1 LLM subagent. Collects all Figma data for a component in one run.
 
@@ -48,7 +48,7 @@ python3 scripts/phase1-gather.py \
 
 ---
 
-### `remote-mcp-fetch.py` — Remote MCP Tool Caller
+### `remote-mcp-fetch.py`  -  Remote MCP Tool Caller
 
 Calls Figma remote MCP from any context (subagents, CI, scripts). See `reference/remote-mcp-script.md` for full docs.
 
@@ -70,7 +70,7 @@ python3 scripts/remote-mcp-fetch.py \
 
 ## Phase Processing
 
-### `phase2-finalize.py` — Phase 2 Finalization
+### `phase2-finalize.py`  -  Phase 2 Finalization
 
 Builds `component-utilities.json` from Phase 2 sub-phase JSON sidecars and registers with FigmaRegistryUtility.
 
@@ -91,7 +91,7 @@ python3 scripts/phase2-finalize.py \
 
 ---
 
-### `phase3-scripts.py` — Phase 3 Scriptable Sub-Phases
+### `phase3-scripts.py`  -  Phase 3 Scriptable Sub-Phases
 
 Runs deterministic Phase 3 sub-phases that don't need AI reasoning.
 
@@ -115,7 +115,7 @@ python3 scripts/phase3-scripts.py wave1 --artifact-path /path # 3b+3e+3f togethe
 
 ## Validation
 
-### `validate-phase4.sh` — Phase 4 Output Validation
+### `validate-phase4.sh`  -  Phase 4 Output Validation
 
 Checks Phase 4 (code generation) output for completeness.
 
@@ -123,7 +123,7 @@ Checks Phase 4 (code generation) output for completeness.
 bash scripts/validate-phase4.sh /path/to/artifacts
 ```
 
-### `validate-phase6.sh` — Phase 6 Output Validation
+### `validate-phase6.sh`  -  Phase 6 Output Validation
 
 Checks Phase 6 (Code Connect) output for completeness.
 
@@ -131,7 +131,7 @@ Checks Phase 6 (Code Connect) output for completeness.
 bash scripts/validate-phase6.sh /path/to/artifacts
 ```
 
-### `code-connect-publish.sh` — Resilient Code Connect Publish
+### `code-connect-publish.sh`  -  Resilient Code Connect Publish
 
 Wrapper around `npx figma connect publish` that auto-excludes stale components causing validation failures, retries once, and restores `figma.config.json` via trap.
 
@@ -145,7 +145,7 @@ Must be run from the uicomponents package root. Requires `FIGMA_ACCESS_TOKEN` en
 
 ## Utilities
 
-### `sync-skills.sh` — Sync Skill Files
+### `sync-skills.sh`  -  Sync Skill Files
 
 Copies `.instructions/figma/figma-to-swiftui/` to `.gemini/skills/figma/` and `.github/skills/figma/`.
 
@@ -153,7 +153,7 @@ Copies `.instructions/figma/figma-to-swiftui/` to `.gemini/skills/figma/` and `.
 bash scripts/sync-skills.sh
 ```
 
-### `run-uicomponents-tests.sh` — Run UIComponents Tests
+### `run-uicomponents-tests.sh`  -  Run UIComponents Tests
 
 Runs the Swift test suite for the UIComponents package.
 
@@ -165,7 +165,7 @@ bash scripts/run-uicomponents-tests.sh
 
 ## Code Connect
 
-### `register-icons-codeconnect.py` — Batch Icon Registration
+### `register-icons-codeconnect.py`  -  Batch Icon Registration
 
 Registers icon assets in Figma via Code Connect.
 
@@ -173,7 +173,7 @@ Registers icon assets in Figma via Code Connect.
 python3 scripts/register-icons-codeconnect.py [options]
 ```
 
-### `figma-subcomponent-graph.py` — Component Dependency Graph
+### `figma-subcomponent-graph.py`  -  Component Dependency Graph
 
 Builds a graph of nested component dependencies from Figma metadata.
 
@@ -185,7 +185,7 @@ python3 scripts/figma-subcomponent-graph.py [options]
 
 ## Confluence
 
-### `confluence-publish.py` — Publish to Confluence
+### `confluence-publish.py`  -  Publish to Confluence
 
 Publishes component documentation to Confluence.
 
@@ -193,7 +193,7 @@ Publishes component documentation to Confluence.
 python3 scripts/confluence-publish.py [options]
 ```
 
-### `confluence-component-status.py` — Component Status Tracker
+### `confluence-component-status.py`  -  Component Status Tracker
 
 Tracks implementation status across components in Confluence.
 
@@ -201,7 +201,7 @@ Tracks implementation status across components in Confluence.
 python3 scripts/confluence-component-status.py [options]
 ```
 
-### `confluence-page-ids.json` — Page ID Mapping
+### `confluence-page-ids.json`  -  Page ID Mapping
 
 Static JSON mapping of Confluence page IDs for documentation targets.
 

package/pipeline/skills/figma-ios/figma-to-component/reference/snapshot-testing.md

@@ -134,7 +134,7 @@ assertSnapshot(of: vc, as: .image, named: "dark")
 
 ## DI REGISTRATION FOR TESTS
 
-Snapshot tests run in SPM package context — no AppDelegate, no DI registration. Use `TestDependencies` helper to register providers before tests.
+Snapshot tests run in SPM package context  -  no AppDelegate, no DI registration. Use `TestDependencies` helper to register providers before tests.
 
 ```swift
 override class func setUp() {
@@ -160,7 +160,7 @@ func test_snapshot_rtl_light_default() {
 }
 ```
 
-**CRITICAL:** `String(localized:bundle:locale:)` does NOT select translation language — the `locale` parameter only affects interpolated value formatting. The `DevelopmentLocalizedStringProvider` uses `Bundle.localizedString(forKey:value:table:)` with a language-specific `.lproj` sub-bundle to correctly resolve translations by language.
+**CRITICAL:** `String(localized:bundle:locale:)` does NOT select translation language  -  the `locale` parameter only affects interpolated value formatting. The `DevelopmentLocalizedStringProvider` uses `Bundle.localizedString(forKey:value:table:)` with a language-specific `.lproj` sub-bundle to correctly resolve translations by language.
 
 **RTL snapshot helper pattern:**
 

package/pipeline/skills/figma-ios/figma-to-component/reference/subcomponent-graph.md

@@ -22,7 +22,7 @@ python3 .instructions/figma/figma-to-swiftui/scripts/figma-subcomponent-graph.py
 # Preview without API calls
 python3 .instructions/figma/figma-to-swiftui/scripts/figma-subcomponent-graph.py --dry-run
 
-# Skip Visual Assets (icons/flags — rarely have sub-components)
+# Skip Visual Assets (icons/flags  -  rarely have sub-components)
 python3 .instructions/figma/figma-to-swiftui/scripts/figma-subcomponent-graph.py --skip-assets
 
 # Verbose output
@@ -82,9 +82,9 @@ python3 .instructions/figma/figma-to-swiftui/scripts/figma-subcomponent-graph.py
 
 ## Consumers
 
-- `confluence-component-status.py` — reads graph to compute readiness (ready/blocked)
-- Phase 3C (nested components) — can reference graph for dependency info
-- Phase 4B (view implementation) — knows which sub-components to import
+- `confluence-component-status.py`  -  reads graph to compute readiness (ready/blocked)
+- Phase 3C (nested components)  -  can reference graph for dependency info
+- Phase 4B (view implementation)  -  knows which sub-components to import
 
 ## When to Re-run
 

package/pipeline/skills/figma-ios/figma-to-component/reference/testing-identifiers-naming.md

@@ -73,7 +73,7 @@ Both type-safe and raw string accepted:
 .testIdentifier(.TurkishButton.button)      // alias for accessibilityIdentifier
 ```
 
-Context keys are regular UITestingIdentifierKey entries — add via the tool:
+Context keys are regular UITestingIdentifierKey entries  -  add via the tool:
 
 ```bash
 UITestingIdentifierTool add --key 'PassengerList.screen' --value 'passenger_list'
@@ -81,11 +81,11 @@ UITestingIdentifierTool add --key 'PassengerList.screen' --value 'passenger_list
 
 ### Rules for Context Segments
 
-- **snake_case** — same as identifier values
-- **Prefer type-safe keys** — `.identifierContext(.PassengerList.screen)` over raw strings
-- **Descriptive** — `passenger_list`, not `pl` or `screen1`
-- **Stable** — don't use indices unless necessary (use `.with()` for dynamic)
-- **No component name** — the component's own identifier already includes it
+- **snake_case**  -  same as identifier values
+- **Prefer type-safe keys**  -  `.identifierContext(.PassengerList.screen)` over raw strings
+- **Descriptive**  -  `passenger_list`, not `pl` or `screen1`
+- **Stable**  -  don't use indices unless necessary (use `.with()` for dynamic)
+- **No component name**  -  the component's own identifier already includes it
 
 ---
 

package/pipeline/skills/figma-ios/figma-to-component/reference/tools.md

@@ -22,16 +22,16 @@
 | `generate_figma_design` | no | yes | Push web page or UI to Figma file | Figma file URL |
 | `whoami` | no | yes | Verify OAuth authentication | Authenticated user info |
 
-**Local prefix:** `mcp__figma__` — **Remote prefix:** `mcp__figma-remote__`
+**Local prefix:** `mcp__figma__`  -  **Remote prefix:** `mcp__figma-remote__`
 
 ---
 
-### 1.2 Tool Calls — Local MCP
+### 1.2 Tool Calls  -  Local MCP
 
 **Prefix:** `mcp__figma__`
 **Endpoint:** `http://127.0.0.1:3845/mcp`
 **Requirement:** Figma Desktop running + Dev Mode enabled (Shift+D)
-**Note:** `nodeId` is optional on local — omit to use the currently selected node.
+**Note:** `nodeId` is optional on local  -  omit to use the currently selected node.
 
 ```
 mcp__figma__get_design_context(nodeId?: "X:Y", dirForAssetWrites?: "/abs/path", forceCode?: true)
@@ -49,7 +49,7 @@ mcp__figma__send_code_connect_mappings(nodeId: "X:Y", mappings: [...])
 
 ---
 
-### 1.3 Tool Calls — Remote MCP
+### 1.3 Tool Calls  -  Remote MCP
 
 **Prefix:** `mcp__figma-remote__`
 **Endpoint:** `https://mcp.figma.com/mcp`
@@ -102,7 +102,7 @@ Prefer local for all active development. Use remote only when Figma Desktop is u
 ### 1.6 Return Formats
 
 **get_design_context**
-Returns generated code + asset URLs. If response is XML instead of code, the design node is too large — extract sublayer `nodeId` values from the XML and call again on each sublayer.
+Returns generated code + asset URLs. If response is XML instead of code, the design node is too large  -  extract sublayer `nodeId` values from the XML and call again on each sublayer.
 
 **get_variable_defs**
 ```json
@@ -120,11 +120,11 @@ XML containing node IDs, layer types, names, positions, and sizes. Use to identi
 
 ---
 
-### 1.7 Rate Limits (MCP Remote — effective November 2025)
+### 1.7 Rate Limits (MCP Remote  -  effective November 2025)
 
 | Plan | Per Minute | Per Day |
 |------|-----------|---------|
-| Viewer / Collaborator | — | 6 / month total |
+| Viewer / Collaborator |  -  | 6 / month total |
 | Dev / Full Pro | 15 | 200 |
 | Dev / Full Org | 20 | 200 |
 | Dev / Full Enterprise | 20 | 600 |
@@ -199,7 +199,7 @@ curl -H "X-Figma-Token: $TOKEN" \
 | `projects:read` | Read team projects |
 | `webhooks:write` | Manage webhooks |
 
-**Deprecated:** `files:read` — replace with `file_content:read` + `file_metadata:read`.
+**Deprecated:** `files:read`  -  replace with `file_content:read` + `file_metadata:read`.
 **Note:** Personal Access Tokens (PATs) are capped at 90-day expiry.
 
 ---
@@ -208,7 +208,7 @@ curl -H "X-Figma-Token: $TOKEN" \
 
 | Status | Meaning | Action |
 |--------|---------|--------|
-| 200 | Success | — |
+| 200 | Success |  -  |
 | 400 | Bad request | Check parameter format |
 | 403 | Forbidden | Check token validity and scopes |
 | 404 | Not found | Check fileKey and nodeId |

package/pipeline/skills/figma-ios/figma-to-component/reference/viewinspector.md

@@ -13,7 +13,7 @@ License: MIT
 | Framework | Supported | Notes |
 |-----------|-----------|-------|
 | XCTest | Yes | Full support, RECOMMENDED |
-| Swift Testing | Warning | Known issues with @Test (GitHub #319) — use XCTest |
+| Swift Testing | Warning | Known issues with @Test (GitHub #319)  -  use XCTest |
 | Swift 6.0+ | Yes | Use `.implicitAnyView()` for implicit AnyView wrappers |
 | iOS 17+ / iOS 26 | Yes | v0.10.3 fixes accessibilityIdentifier on iOS 26 |
 

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

@@ -155,7 +155,7 @@ code here
 - 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
+- Filenames on disk keep original characters  -  XML parser decodes the escapes
 
 ---
 

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""apply-author-login-map.py — rewrite status.<platform>.implementedBy
+"""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.
 
@@ -11,7 +11,7 @@ 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
+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
@@ -25,8 +25,8 @@ Usage:
         [--dry-run]
 
 Exit codes:
-    0 — success
-    1 — setup error (missing files)
+    0  -  success
+    1  -  setup error (missing files)
 """
 
 import argparse
@@ -134,7 +134,7 @@ def main() -> int:
             # 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.
+            # we leave it  -  it's already correct.
             if current in display_to_login.values():
                 counts["already_login"] += 1
             else:

package/pipeline/skills/figma-ios/figma-to-component/scripts/backfill-status.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""backfill-status.py — populate status blocks in existing registry files.
+"""backfill-status.py  -  populate status blocks in existing registry files.
 
 Walks every JSON in the registry directory and, for each component,
 infers the initial `status.ios.*` block from filesystem signals:
@@ -12,7 +12,7 @@ infers the initial `status.ios.*` block from filesystem signals:
 - status.ios.codeConnect:
     Mirrors the legacy top-level `codeConnect.ios` field. Only set if
     the legacy value was True. Recorded against the current
-    impl.version — so if impl was just set to 1 in this same run,
+    impl.version  -  so if impl was just set to 1 in this same run,
     codeConnect lands green (against=1), not yellow.
 
 - status.ios.tested and status.ios.wiki:
@@ -29,7 +29,7 @@ set_flag's built-in mirror keeps the two representations in sync going
 forward, and the backfill never explicitly downgrades anything.
 
 Usage:
-    # See what would change — no writes
+    # See what would change  -  no writes
     python3 backfill-status.py \\
         --registry-dir /path/to/Shared/Figma/Components \\
         --sources-dir  /path/to/uicomponents/Sources \\
@@ -45,8 +45,8 @@ Usage:
         --registry-dir ... --sources-dir ...
 
 Exit codes:
-    0 — Success (full walk completed)
-    1 — Error (bad paths, read/write failure)
+    0  -  Success (full walk completed)
+    1  -  Error (bad paths, read/write failure)
 """
 
 import argparse
@@ -190,10 +190,10 @@ def build_wiki_index(wiki_dir: Path) -> Dict[str, Path]:
         stem = md.stem
         parent_name = md.parent.name
         if parent_name == stem:
-            # {Component}/{Component}.md — canonical
+            # {Component}/{Component}.md  -  canonical
             index.setdefault(stem, md)
         elif stem not in index:
-            # {Component}.md at any depth — fallback
+            # {Component}.md at any depth  -  fallback
             index[stem] = md
     return index
 
@@ -271,10 +271,10 @@ def decide_backfill(
 ) -> dict:
     """Decide what the backfill should do for one registry entry.
 
-    Pure function — no I/O. Returns a dict describing the intended
+    Pure function  -  no I/O. Returns a dict describing the intended
     action per flag, used by both dry-run and real-write paths.
 
-    test_index and wiki_index are optional for backward compat — when
+    test_index and wiki_index are optional for backward compat  -  when
     None, tested/wiki detection is skipped and only implemented/cc are
     considered (original Step 5 behavior).
 
@@ -285,18 +285,18 @@ def decide_backfill(
             "has_status_block": bool,
             "impl_action": ...,
             "codeconnect_action": ...,
-            "tested_action": ...,        # NEW — "set" | "skip_*"
-            "wiki_action": ...,          # NEW — "set" | "skip_*"
+            "tested_action": ...,        # NEW  -  "set" | "skip_*"
+            "wiki_action": ...,          # NEW  -  "set" | "skip_*"
             "swift_path": Optional[str],
-            "test_paths": List[str],     # NEW — 0+ paths that match the component
-            "wiki_path": Optional[str],  # NEW — the detected wiki .md file
+            "test_paths": List[str],     # NEW  -  0+ paths that match the component
+            "wiki_path": Optional[str],  # NEW  -  the detected wiki .md file
         }
     """
     node_id = entry.get("nodeId")
     component_name = _component_name_ios(entry.get("componentName"))
 
     # Legacy shape: `status` was a bare string like "implemented". Leave
-    # these for manual migration — do not overwrite with the new block.
+    # these for manual migration  -  do not overwrite with the new block.
     raw_status = entry.get("status")
     if isinstance(raw_status, str):
         return {
@@ -362,7 +362,7 @@ def decide_backfill(
     if has_status:
         result["impl_action"] = "skip_existing_status"
         result["codeconnect_action"] = "skip_existing_status"
-        # Populate swift_path even when skipping impl — author detection
+        # Populate swift_path even when skipping impl  -  author detection
         # needs it, and we want to be able to fill in implementedBy for
         # components that were backfilled before author detection existed.
         swift_path = swift_index.get(component_name) if component_name else None
@@ -381,7 +381,7 @@ def decide_backfill(
             result["wiki_action"] = "skip_existing_status" if wiki_set else "skip_no_wiki"
         return result
 
-    # Fresh entry — check swift file for implementation
+    # Fresh entry  -  check swift file for implementation
     swift_path = swift_index.get(component_name)
     if not swift_path:
         result["impl_action"] = "skip_no_swift"
@@ -410,7 +410,7 @@ def apply_decision(
 ) -> None:
     """Execute the decision (skip if action is 'skip_*').
 
-    Writes are atomic per flag — a crash between writes leaves a
+    Writes are atomic per flag  -  a crash between writes leaves a
     partially-backfilled entry, recoverable on re-run. Order:
         1. set_implemented (establishes version=1)
         2. set_implemented_by (author)
@@ -431,7 +431,7 @@ def apply_decision(
             source_file=None,
         )
 
-    # Author detection — only meaningful when we actually set impl OR
+    # Author detection  -  only meaningful when we actually set impl OR
     # impl was already set (so the registry entry exists and we just
     # want to populate the missing field).
     if uicomponents_repo and decision.get("swift_path"):

package/pipeline/skills/figma-ios/figma-to-component/scripts/build-author-registry.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""build-author-registry.py — walk registry components, git-blame each
+"""build-author-registry.py  -  walk registry components, git-blame each
 swift file, build a reviewable author registry before ANY issue touch.
 
 For every registry entry that has a swift file under Sources/, runs
@@ -47,8 +47,8 @@ Usage:
         [--limit N]
 
 Exit codes:
-    0 — success (even with some per-component errors)
-    1 — setup error (bad paths)
+    0  -  success (even with some per-component errors)
+    1  -  setup error (bad paths)
 """
 
 import argparse
@@ -97,7 +97,7 @@ def default_temp_dir() -> Path:
 
 
 # --------------------------------------------------------------------
-# Heuristic — does a git author name look like a GitHub login?
+# Heuristic  -  does a git author name look like a GitHub login?
 # --------------------------------------------------------------------
 
 _GH_LOGIN_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9\-_]{0,38}$")

package/pipeline/skills/figma-ios/figma-to-component/scripts/bulk-sync-issues.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""bulk-sync-issues.py — sync every backfilled component's GitHub issue.
+"""bulk-sync-issues.py  -  sync every backfilled component's GitHub issue.
 
 Walks the component registry, picks every entry where
 `status.ios.implemented.value == true`, and invokes
@@ -10,7 +10,7 @@ doesn't spam 268 notifications to reviewers. Pass `--with-comment`
 to override.
 
 Usage:
-    # Dry-run — no gh calls, just print what would happen
+    # Dry-run  -  no gh calls, just print what would happen
     python3 bulk-sync-issues.py --dry-run
 
     # Real run on first 5 (smoke test)
@@ -23,8 +23,8 @@ Usage:
     python3 bulk-sync-issues.py --with-comment
 
 Exit codes:
-    0 — success (maybe with some per-node failures logged)
-    1 — setup error (bad path, missing dependency)
+    0  -  success (maybe with some per-node failures logged)
+    1  -  setup error (bad path, missing dependency)
 """
 
 import argparse

package/pipeline/skills/figma-ios/figma-to-component/scripts/code-connect-data-gather.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-Code Connect Data Gather — Fetches Figma component properties for standalone Code Connect publish.
+Code Connect Data Gather  -  Fetches Figma component properties for standalone Code Connect publish.
 
 Calls Figma REST API to get component property definitions and writes
 pass1/component_properties.json in the same format Phase 1 produces.

package/pipeline/skills/figma-ios/figma-to-component/scripts/code-connect-publish.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# code-connect-publish.sh — Resilient Code Connect publish wrapper
+# code-connect-publish.sh  -  Resilient Code Connect publish wrapper
 #
 # Handles the case where stale .figma.swift files from OTHER components
 # cause validation failures that block the entire batch publish.
@@ -111,10 +111,10 @@ if [[ $RC -eq 0 ]]; then
     exit 0
 fi
 
-# Check for 403 (token issue) — no retry can fix this
+# Check for 403 (token issue)  -  no retry can fix this
 if echo "$OUTPUT" | grep -q "403"; then
     echo ""
-    echo "[code-connect-publish] FATAL: 403 error detected. Token issue — cannot retry." >&2
+    echo "[code-connect-publish] FATAL: 403 error detected. Token issue  -  cannot retry." >&2
     exit 1
 fi
 

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

@@ -84,7 +84,7 @@ def build_component_index(figma_dir):
                     "variantCount": comp.get("variantCount", 0),
                     "codeConnect": comp.get("codeConnect", {}),
                     "subComponents": [],
-                    # Registry fields — filled below
+                    # Registry fields  -  filled below
                     "componentName": {},
                     "skip": False,
                     "confluence": {},
@@ -144,7 +144,7 @@ def build_component_index(figma_dir):
     name_to_nid = {}
     # Secondary fuzzy lookup keyed by figmaName with separators (`/ _ -`) and
     # whitespace stripped, lowercased. The Figma sub-component graph emits
-    # plain instance-names like "CardsFareAvailabilityFareTypes" — those won't
+    # plain instance-names like "CardsFareAvailabilityFareTypes"  -  those won't
     # match a catalog `figmaName` of "Cards/Fare/Availability/FareTypes" via
     # the exact-match map below, but they collapse to the same key here.
     # Used as a fallback when an exact lookup misses.
@@ -190,7 +190,7 @@ def build_component_index(figma_dir):
             sub_names = gdata.get("subComponents", [])
             if not sub_names:
                 continue
-            # Resolve sub-component names to nodeIds — exact match first,
+            # Resolve sub-component names to nodeIds  -  exact match first,
             # then fall back to the stripped/lowercased key. The fuzzy pass
             # turns the previous {nodeId: null} entries (which silently
             # bypass the readiness algorithm downstream) into real refs.
@@ -256,7 +256,7 @@ def compute_readiness(comp, components, platform="ios"):
     for sub in subs:
         sub_nid = sub.get("nodeId")
         if not sub_nid:
-            continue  # Unresolved name (not in catalog or registry) — doesn't block
+            continue  # Unresolved name (not in catalog or registry)  -  doesn't block
         sub_comp = components.get(sub_nid)
         if not sub_comp:
             continue
@@ -321,10 +321,10 @@ def generate_xhtml(index):
 
     p = []
 
-    p.append(f'<p><em>Component implementation status — generated from unified component index '
+    p.append(f'<p><em>Component implementation status  -  generated from unified component index '
              f'({summary["resolvedNames"]} name aliases, {summary["registryFiles"]} registry files).</em></p>')
     p.append(f'<p><strong>Legend:</strong> '
-             f'✅ Implemented (Code Connected) — shows component name | '
+             f'✅ Implemented (Code Connected)  -  shows component name | '
              f'🟢 Ready for Development | '
              f'🔴 Blocked (has unconnected sub-components) | '
              f'⏭️ Skipped (will not be implemented)<br/>'
@@ -421,7 +421,7 @@ def generate_xhtml(index):
         file_label_esc = xml_escape(file_label)
         file_stats = f'iOS {file_ios_impl}/{file_ios_eff} / Android {file_android_impl}/{file_android_eff}'
         if file_ios_eff == 0 and file_android_eff == 0:
-            # All skipped — no TOC entry, just a styled paragraph
+            # All skipped  -  no TOC entry, just a styled paragraph
             p.append(f'<p><strong style="font-size:20px"><s>{file_label_esc} ({file_stats})</s></strong></p>')
         else:
             p.append(f'<h2>{file_label_esc} ({file_stats})</h2>')
@@ -439,7 +439,7 @@ def generate_xhtml(index):
             page_name_esc = xml_escape(page_name)
             pg_stats = f'iOS {pg_ios_impl}/{pg_ios_eff} / Android {pg_android_impl}/{pg_android_eff}'
             if pg_ios_eff == 0 and pg_android_eff == 0:
-                # All skipped — no TOC entry, just a styled paragraph
+                # All skipped  -  no TOC entry, just a styled paragraph
                 p.append(f'<p><strong style="font-size:16px"><s>{page_name_esc} ({pg_stats})</s></strong></p>')
             else:
                 p.append(f'<h3>{page_name_esc} ({pg_stats})</h3>')
@@ -447,12 +447,12 @@ def generate_xhtml(index):
             sorted_comps = sorted(page_comps, key=lambda c: (
                 READINESS_ORDER.get(compute_readiness(c, components, "ios"), 9), c["name"]))
 
-            # Anchors OUTSIDE expand — Confluence can't resolve anchors inside collapsed expand
+            # Anchors OUTSIDE expand  -  Confluence can't resolve anchors inside collapsed expand
             for c in sorted_comps:
                 p.append(make_anchor(node_anchor(c["nodeId"])))
 
             p.append('<ac:structured-macro ac:name="expand">')
-            p.append(f'<ac:parameter ac:name="title">{page_name_esc} — '
+            p.append(f'<ac:parameter ac:name="title">{page_name_esc}  -  '
                      f'iOS {pg_ios_impl}/{pg_ios_eff} / Android {pg_android_impl}/{pg_android_eff} '
                      f'({len(page_comps)} components)</ac:parameter>')
             p.append('<ac:rich-text-body>')
@@ -493,9 +493,9 @@ def generate_xhtml(index):
 
                 # Variant count
                 vc = c.get("variantCount", 0)
-                variant_cell = str(vc) if vc > 0 else "—"
+                variant_cell = str(vc) if vc > 0 else " - "
 
-                # Sub-components — colored links (blue/green/red/gray), NO emoji
+                # Sub-components  -  colored links (blue/green/red/gray), NO emoji
                 subs = c.get("subComponents", [])
                 if subs:
                     sub_links = []
@@ -515,7 +515,7 @@ def generate_xhtml(index):
                             sub_links.append(f'<span style="color:#999">{xml_escape(sub_name)}</span>')
                     subs_cell = ", ".join(sub_links)
                 else:
-                    subs_cell = "—"
+                    subs_cell = " - "
 
                 row_style = ' style="background:#f5f5f5; color:#9E9E9E"' if is_skipped else ''
                 p.append(
@@ -536,9 +536,9 @@ def generate_xhtml(index):
 
         p.append('<hr/>')
 
-    # --- Connected Components — iOS ---
+    # --- Connected Components  -  iOS ---
     ios_connected = [c for c in catalog_comps if c.get("codeConnect", {}).get("ios")]
-    p.append('<h2>Connected Components — iOS</h2>')
+    p.append('<h2>Connected Components  -  iOS</h2>')
     if ios_connected:
         p.append('<table><tbody>')
         p.append('<tr><th>Component</th><th>Figma Name</th></tr>')
@@ -555,9 +555,9 @@ def generate_xhtml(index):
     else:
         p.append('<p><em>No iOS-connected components yet.</em></p>')
 
-    # --- Connected Components — Android ---
+    # --- Connected Components  -  Android ---
     android_connected = [c for c in catalog_comps if c.get("codeConnect", {}).get("android")]
-    p.append('<h2>Connected Components — Android</h2>')
+    p.append('<h2>Connected Components  -  Android</h2>')
     if android_connected:
         p.append('<table><tbody>')
         p.append('<tr><th>Component</th><th>Figma Name</th></tr>')
@@ -717,7 +717,7 @@ def main():
 
     # Write index to disk for inspection
     index_path = os.path.join(figma_dir, "Generated", "component-index.json")
-    # Write a slim version (no nameLookup — it's huge)
+    # Write a slim version (no nameLookup  -  it's huge)
     slim = {
         "components": index["components"],
         "files": index["files"],