@mmerterden/multi-agent-pipeline 12.5.0 → 12.7.0

package/pipeline/schemas/agent-state.schema.json

@@ -97,8 +97,16 @@
             "type": "object",
             "required": ["tool", "phase"],
             "properties": {
-              "tool": { "type": "string", "description": "MCP tool name, e.g. mcp__claude_ai_Figma__get_design_context." },
-              "phase": { "type": "integer", "minimum": 0, "maximum": 7, "description": "Pipeline phase the call ran in. Only 0 (init) and 1 (analysis) are permitted." },
+              "tool": {
+                "type": "string",
+                "description": "MCP tool name, e.g. mcp__claude_ai_Figma__get_design_context."
+              },
+              "phase": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 7,
+                "description": "Pipeline phase the call ran in. Only 0 (init) and 1 (analysis) are permitted."
+              },
               "timestamp": { "type": "string", "description": "ISO-8601 time of the call." }
             }
           }
@@ -121,6 +129,108 @@
       "default": false,
       "description": "A Figma / skill instruction file is steering phases 3-6."
     },
+    "mode": {
+      "type": ["string", "null"],
+      "description": "Pipeline mode for this run (e.g. 'dev', 'local', 'design-check'). Absent = full pipeline."
+    },
+    "designCheck": {
+      "type": ["object", "null"],
+      "additionalProperties": true,
+      "description": "State for a /multi-agent:design-check run. Populated in Phase 0 (mock feasibility, scenario inventory, scope), Phase 2 (Figma variants) and Phase 3 (captures, skips, findings).",
+      "properties": {
+        "module": { "type": "string", "description": "Module / submodule path being audited." },
+        "platform": { "type": "string", "enum": ["ios", "android"] },
+        "mock": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "design_mock_detect result.",
+          "properties": {
+            "supported": { "description": "true | false | 'debug-only'" },
+            "mechanism": { "type": ["string", "null"] },
+            "activation": { "type": ["object", "null"] },
+            "variantsHint": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "inventory": {
+          "type": ["object", "null"],
+          "additionalProperties": true,
+          "description": "design_scenario_inventory result, persisted verbatim. THIS is the audit's target set  -  Phase 3 iterates it and Phase 4 gates on it. Never re-derive it by reading the repo.",
+          "properties": {
+            "targetCount": { "type": "integer" },
+            "targets": {
+              "type": "array",
+              "items": { "type": "object", "additionalProperties": true },
+              "description": "{ id, kind, label, screen, driver, evidence } per state driver (launch-arg / scenario-case / code-scenario / fixture / deep-link)."
+            },
+            "groups": {
+              "type": "array",
+              "items": { "type": "object", "additionalProperties": true }
+            },
+            "byKind": { "type": "object", "additionalProperties": true },
+            "truncated": { "type": "boolean" }
+          }
+        },
+        "scope": {
+          "type": ["object", "null"],
+          "additionalProperties": true,
+          "description": "Resolved run scope: the inventory targets this run must audit. The coverage gate applies to this set, not to the whole inventory  -  a scoped run is not penalised for out-of-scope targets.",
+          "properties": {
+            "argument": {
+              "type": ["string", "null"],
+              "description": "Raw $ARGUMENTS as given (empty = whole module, '--resume' = remainder of the last run)."
+            },
+            "targetIds": { "type": "array", "items": { "type": "string" } },
+            "resumedFrom": {
+              "type": ["string", "null"],
+              "description": "Report dir of the run this scope resumes, when --resume was used."
+            }
+          }
+        },
+        "figmaUrl": { "type": ["string", "null"] },
+        "variants": {
+          "type": "array",
+          "description": "Mapped variants with their Figma spec, capture, and findings.",
+          "items": { "type": "object", "additionalProperties": true }
+        },
+        "captured": {
+          "type": "array",
+          "description": "Every capture taken, appended and persisted as it happens so a dying run is resumable. One entry per screenshot, keyed to the target that produced it ('<targetId>', or '<targetId>#<sub-label>' for tap-reachable sub-states).",
+          "items": { "type": "object", "additionalProperties": true }
+        },
+        "skipped": {
+          "type": "array",
+          "description": "Targets that could not be audited, each with a CONCRETE reason. 'Requires a scenario / prefix / launch-arg' is not a reason  -  that is the work Phase 3 exists to do. A skip without a reason fails the coverage gate.",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "reason"],
+            "properties": {
+              "id": { "type": "string" },
+              "group": { "type": ["string", "null"] },
+              "reason": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "coverage": {
+          "type": ["object", "null"],
+          "additionalProperties": true,
+          "description": "design_report coverage verdict for this run. gate='fail' means the run is INCOMPLETE and must be reported as such, with the unaccounted ids and the --resume command.",
+          "properties": {
+            "gate": { "type": "string", "enum": ["pass", "fail"] },
+            "audited": { "type": "integer" },
+            "target": { "type": "integer" },
+            "pct": { "type": "number" },
+            "skippedWithReason": { "type": "integer" },
+            "unaccounted": { "type": "integer" },
+            "unaccountedIds": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "reportDir": {
+          "type": ["string", "null"],
+          "description": "Output dir under ~/DesignChecks."
+        }
+      }
+    },
     "identity": {
       "type": "object",
       "additionalProperties": false,
@@ -128,7 +238,10 @@
       "properties": {
         "name": { "type": "string" },
         "email": { "type": "string", "format": "email" },
-        "username": { "type": "string", "description": "SCM username (GitHub/Bitbucket). Used to filter out PR author from reviewer list." }
+        "username": {
+          "type": "string",
+          "description": "SCM username (GitHub/Bitbucket). Used to filter out PR author from reviewer list."
+        }
       }
     },
     "phases": {
@@ -139,7 +252,10 @@
           "type": "object",
           "additionalProperties": false,
           "properties": {
-            "status": { "type": "string", "enum": ["pending", "in_progress", "done", "skipped", "failed"] },
+            "status": {
+              "type": "string",
+              "enum": ["pending", "in_progress", "done", "skipped", "failed"]
+            },
             "startedAt": { "type": "string", "format": "date-time" },
             "finishedAt": { "type": "string", "format": "date-time" },
             "model": { "type": "string" },
@@ -222,7 +338,11 @@
       "properties": {
         "number": { "type": "integer", "minimum": 1 },
         "url": { "type": "string", "format": "uri" },
-        "version": { "type": "integer", "minimum": 0, "description": "Bitbucket PR version  -  must increment by 1 per PUT." },
+        "version": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Bitbucket PR version  -  must increment by 1 per PUT."
+        },
         "draft": { "type": "boolean" },
         "reviewers": {
           "type": "array",

package/pipeline/schemas/analysis-output.schema.json

@@ -18,8 +18,14 @@
           "enum": ["ios", "android", "backend", "frontend", "mobile", "unknown"],
           "description": "Dominant stack inferred from project markers (.xcodeproj, build.gradle, package.json, etc.)."
         },
-        "language": { "type": "string", "description": "E.g. 'Swift 6', 'Kotlin 2.1', 'Python 3.13', 'TypeScript 5'." },
-        "framework": { "type": "string", "description": "E.g. 'SwiftUI', 'Jetpack Compose', 'FastAPI', 'Next.js 16'." }
+        "language": {
+          "type": "string",
+          "description": "E.g. 'Swift 6', 'Kotlin 2.1', 'Python 3.13', 'TypeScript 5'."
+        },
+        "framework": {
+          "type": "string",
+          "description": "E.g. 'SwiftUI', 'Jetpack Compose', 'FastAPI', 'Next.js 16'."
+        }
       }
     },
     "touchedAreas": {
@@ -30,8 +36,16 @@
         "additionalProperties": false,
         "required": ["path", "why"],
         "properties": {
-          "path": { "type": "string", "minLength": 1, "description": "File or directory relative to repo root." },
-          "why": { "type": "string", "minLength": 4, "description": "Why the task likely affects this area." }
+          "path": {
+            "type": "string",
+            "minLength": 1,
+            "description": "File or directory relative to repo root."
+          },
+          "why": {
+            "type": "string",
+            "minLength": 4,
+            "description": "Why the task likely affects this area."
+          }
         }
       },
       "description": "Files / modules the task is most likely to modify. Phase 2 uses this to scope tasks."

package/pipeline/schemas/analysis-spec.schema.json

@@ -128,8 +128,15 @@
               "url": { "type": "string", "format": "uri" },
               "fileKey": { "type": ["string", "null"] },
               "nodeId": { "type": ["string", "null"] },
-              "screenshotUrl": { "type": ["string", "null"], "description": "Local PNG path or signed render URL for this node." },
-              "tier": { "type": ["integer", "null"], "enum": [1, 2, 3, null], "description": "Figma access tier used to capture this record (mirrors state.figmaAccess.tier)." },
+              "screenshotUrl": {
+                "type": ["string", "null"],
+                "description": "Local PNG path or signed render URL for this node."
+              },
+              "tier": {
+                "type": ["integer", "null"],
+                "enum": [1, 2, 3, null],
+                "description": "Figma access tier used to capture this record (mirrors state.figmaAccess.tier)."
+              },
               "frames": {
                 "type": "array",
                 "items": {
@@ -202,14 +209,23 @@
                   "properties": {
                     "nodeId": { "type": "string" },
                     "name": { "type": ["string", "null"] },
-                    "designText": { "type": ["string", "null"], "description": "The visible-layer text at this node (often a placeholder)." },
-                    "raw": { "type": ["string", "null"], "description": "The raw annotation label/labelMarkdown before parsing." },
+                    "designText": {
+                      "type": ["string", "null"],
+                      "description": "The visible-layer text at this node (often a placeholder)."
+                    },
+                    "raw": {
+                      "type": ["string", "null"],
+                      "description": "The raw annotation label/labelMarkdown before parsing."
+                    },
                     "parsed": {
                       "type": "object",
                       "description": "Parsed copy keyed by language code (lowercased), e.g. { tr, en }.",
                       "additionalProperties": { "type": "string" }
                     },
-                    "mode": { "type": "string", "enum": ["prefixed", "two-line", "single", "empty"] }
+                    "mode": {
+                      "type": "string",
+                      "enum": ["prefixed", "two-line", "single", "empty"]
+                    }
                   }
                 }
               }
@@ -231,7 +247,10 @@
                   "additionalProperties": false,
                   "required": ["method", "path"],
                   "properties": {
-                    "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+                    "method": {
+                      "type": "string",
+                      "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"]
+                    },
                     "path": { "type": "string" },
                     "summary": { "type": ["string", "null"] },
                     "auth": { "type": ["string", "null"] },
@@ -363,7 +382,10 @@
                 "enum": ["names", "schema", "console"],
                 "description": "Sub-type: names (comma list), schema (local JSON), console (reference-only URL)."
               },
-              "source": { "type": ["string", "null"], "description": "Original input string (path, URL, or comma list)." },
+              "source": {
+                "type": ["string", "null"],
+                "description": "Original input string (path, URL, or comma list)."
+              },
               "events": {
                 "type": "array",
                 "items": {
@@ -387,7 +409,10 @@
                     },
                     "platformsEmitting": {
                       "type": "array",
-                      "items": { "type": "string", "enum": ["ios", "android", "backend", "frontend"] }
+                      "items": {
+                        "type": "string",
+                        "enum": ["ios", "android", "backend", "frontend"]
+                      }
                     },
                     "citation": { "type": ["string", "null"] }
                   }
@@ -415,7 +440,10 @@
                       "name": { "type": "string" },
                       "file": { "type": "string" },
                       "line": { "type": ["integer", "null"] },
-                      "tag": { "type": "string", "enum": ["direct-match", "same-domain", "cross-cutting"] }
+                      "tag": {
+                        "type": "string",
+                        "enum": ["direct-match", "same-domain", "cross-cutting"]
+                      }
                     }
                   }
                 }
@@ -493,29 +521,89 @@
       "additionalProperties": false,
       "description": "v3 template - 23 main sections + 3 footer. Each section is either filled (object) or omitted (null). Omitted sections do not appear in the output document. Sections 1, 2, 4, 9, 13, 14, 20, 21 are never omitted (Locked 2).",
       "properties": {
-        "summary":              { "type": ["object", "null"], "description": "Section 1 - Geliştirme Özeti / Summary. Never null." },
-        "goalsAndNonGoals":     { "type": ["object", "null"], "description": "Section 2 - Hedefler ve Karşı Hedefler. Never null. Both columns mandatory (Locked 13)." },
-        "flowChart":            { "type": ["object", "null"], "description": "Section 3 - Akış Diyagramı. Mermaid blocks." },
-        "userStories":          { "type": ["object", "null"], "description": "Section 4 - Kullanıcı Hikayeleri. Gherkin format (Locked 12). Never null." },
-        "designReference":      { "type": ["object", "null"], "description": "Section 5 - Tasarım Referansı. All Figma variants drilled (Locked 18). Screenshots embedded (Locked 17)." },
-        "componentInventory":   { "type": ["object", "null"], "description": "Section 6 - Bileşen Envanteri." },
-        "designTokens":         { "type": ["object", "null"], "description": "Section 7 - Tasarım Token'ları." },
-        "assetInventory":       { "type": ["object", "null"], "description": "Section 8 - Asset Envanteri. SVG default for new assets (Locked 15)." },
-        "apiContracts":         { "type": ["object", "null"], "description": "Section 9 - API Kontratları. All response variants enumerated (Locked 17)." },
-        "localization":         { "type": ["object", "null"], "description": "Section 10 - Lokalizasyon. 8-locale full coverage for new keys (Locked 20)." },
-        "analytics":            { "type": ["object", "null"], "description": "Section 11 - Analytics." },
-        "deeplinkPush":         { "type": ["object", "null"], "description": "Section 12 - Deeplink ve Push Notification. Conditional." },
-        "architecturePlan":     { "type": ["object", "null"], "description": "Section 13 - Mimari Plan. Never null. Concept table filled by Pass B (Locked 22 + 24)." },
-        "filesToAdd":           { "type": ["object", "null"], "description": "Section 14 - Eklenecek Dosyalar. Never null. Every row carries Reuse / Add new / Modify tag (Locked 16)." },
-        "testPlan":             { "type": ["object", "null"], "description": "Section 15 - Test Planı." },
-        "accessibility":        { "type": ["object", "null"], "description": "Section 16 - Erişilebilirlik." },
-        "securityAndPrivacy":   { "type": ["object", "null"], "description": "Section 17 - Güvenlik ve Gizlilik." },
-        "rolloutPlan":          { "type": ["object", "null"], "description": "Section 18 - Yayılım Planı." },
-        "alternativesConsidered":{ "type": ["object", "null"], "description": "Section 19 - Değerlendirilen Alternatifler. ADR format." },
-        "risksAndOpenQuestions":{ "type": ["object", "null"], "description": "Section 20 - Riskler ve Açık Sorular. Never null. Auto-populated from conventionRisks + reuse competitors." },
-        "references":           { "type": ["object", "null"], "description": "Section 21 - Referanslar. Never null. User-supplied input table at the bottom (Locked 21)." },
-        "glossary":             { "type": ["object", "null"], "description": "Section 22 - Sözlük (footer). Optional in Lite mode." },
-        "changelog":            { "type": ["object", "null"], "description": "Section 23 - Değişiklik Geçmişi (footer)." }
+        "summary": {
+          "type": ["object", "null"],
+          "description": "Section 1 - Geliştirme Özeti / Summary. Never null."
+        },
+        "goalsAndNonGoals": {
+          "type": ["object", "null"],
+          "description": "Section 2 - Hedefler ve Karşı Hedefler. Never null. Both columns mandatory (Locked 13)."
+        },
+        "flowChart": {
+          "type": ["object", "null"],
+          "description": "Section 3 - Akış Diyagramı. Mermaid blocks."
+        },
+        "userStories": {
+          "type": ["object", "null"],
+          "description": "Section 4 - Kullanıcı Hikayeleri. Gherkin format (Locked 12). Never null."
+        },
+        "designReference": {
+          "type": ["object", "null"],
+          "description": "Section 5 - Tasarım Referansı. All Figma variants drilled (Locked 18). Screenshots embedded (Locked 17)."
+        },
+        "componentInventory": {
+          "type": ["object", "null"],
+          "description": "Section 6 - Bileşen Envanteri."
+        },
+        "designTokens": {
+          "type": ["object", "null"],
+          "description": "Section 7 - Tasarım Token'ları."
+        },
+        "assetInventory": {
+          "type": ["object", "null"],
+          "description": "Section 8 - Asset Envanteri. SVG default for new assets (Locked 15)."
+        },
+        "apiContracts": {
+          "type": ["object", "null"],
+          "description": "Section 9 - API Kontratları. All response variants enumerated (Locked 17)."
+        },
+        "localization": {
+          "type": ["object", "null"],
+          "description": "Section 10 - Lokalizasyon. 8-locale full coverage for new keys (Locked 20)."
+        },
+        "analytics": { "type": ["object", "null"], "description": "Section 11 - Analytics." },
+        "deeplinkPush": {
+          "type": ["object", "null"],
+          "description": "Section 12 - Deeplink ve Push Notification. Conditional."
+        },
+        "architecturePlan": {
+          "type": ["object", "null"],
+          "description": "Section 13 - Mimari Plan. Never null. Concept table filled by Pass B (Locked 22 + 24)."
+        },
+        "filesToAdd": {
+          "type": ["object", "null"],
+          "description": "Section 14 - Eklenecek Dosyalar. Never null. Every row carries Reuse / Add new / Modify tag (Locked 16)."
+        },
+        "testPlan": { "type": ["object", "null"], "description": "Section 15 - Test Planı." },
+        "accessibility": {
+          "type": ["object", "null"],
+          "description": "Section 16 - Erişilebilirlik."
+        },
+        "securityAndPrivacy": {
+          "type": ["object", "null"],
+          "description": "Section 17 - Güvenlik ve Gizlilik."
+        },
+        "rolloutPlan": { "type": ["object", "null"], "description": "Section 18 - Yayılım Planı." },
+        "alternativesConsidered": {
+          "type": ["object", "null"],
+          "description": "Section 19 - Değerlendirilen Alternatifler. ADR format."
+        },
+        "risksAndOpenQuestions": {
+          "type": ["object", "null"],
+          "description": "Section 20 - Riskler ve Açık Sorular. Never null. Auto-populated from conventionRisks + reuse competitors."
+        },
+        "references": {
+          "type": ["object", "null"],
+          "description": "Section 21 - Referanslar. Never null. User-supplied input table at the bottom (Locked 21)."
+        },
+        "glossary": {
+          "type": ["object", "null"],
+          "description": "Section 22 - Sözlük (footer). Optional in Lite mode."
+        },
+        "changelog": {
+          "type": ["object", "null"],
+          "description": "Section 23 - Değişiklik Geçmişi (footer)."
+        }
       },
       "required": [
         "summary",

package/pipeline/schemas/clarify-output.schema.json

@@ -49,9 +49,19 @@
               "additionalProperties": false,
               "required": ["label"],
               "properties": {
-                "label":       { "type": "string", "description": "The choice text (≤ 60 chars; longer wraps awkwardly in AskUserQuestion)." },
-                "recommended": { "type": "boolean", "default": false, "description": "True for the conventional default. At most one option per question carries this flag." },
-                "reason":      { "type": "string", "description": "One-line tradeoff hint  -  why this choice would or would not be the right pick." }
+                "label": {
+                  "type": "string",
+                  "description": "The choice text (≤ 60 chars; longer wraps awkwardly in AskUserQuestion)."
+                },
+                "recommended": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "True for the conventional default. At most one option per question carries this flag."
+                },
+                "reason": {
+                  "type": "string",
+                  "description": "One-line tradeoff hint  -  why this choice would or would not be the right pick."
+                }
               }
             }
           },
@@ -67,8 +77,8 @@
       "description": "Filled in AFTER the orchestrator runs AskUserQuestion. Keys are question IDs (q1, q2, ...) and values are the selected label or free-text response. Empty during the agent's own emission.",
       "additionalProperties": { "type": "string" }
     },
-    "tokens_in":   { "type": "integer", "minimum": 0 },
-    "tokens_out":  { "type": "integer", "minimum": 0 },
+    "tokens_in": { "type": "integer", "minimum": 0 },
+    "tokens_out": { "type": "integer", "minimum": 0 },
     "duration_ms": { "type": "integer", "minimum": 0 }
   }
 }

package/pipeline/schemas/design-check-config.schema.json

@@ -0,0 +1,183 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/design-check-config.schema.json",
+  "title": "Design Check Configuration",
+  "description": "Optional per-project config for /multi-agent:design-check. Stored at ~/.claude/projects/{slug}/design-check-config.json. Never committed. Everything here is optional: design_mock_detect auto-detects mock support and design_scenario_inventory auto-enumerates state drivers at run time; this file only overrides or augments that detection (extra mock switch keys, extra launch args / targets no source signal reveals, explicit variant->Figma-node mappings, status-bar crop, coverage floor, Confluence toggle). Keeps the engine generic - project specifics live here, never in shipped code.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0.0" },
+    "platform": {
+      "type": "string",
+      "enum": ["ios", "android"],
+      "description": "Override auto platform detection."
+    },
+    "mock": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Mock-mode overrides. Omit to rely purely on auto-detection.",
+      "properties": {
+        "keys": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Extra UserDefaults / launch-arg switch keys to look for (passed as extra_keys to design_mock_detect)."
+        },
+        "launchArg": {
+          "type": "string",
+          "description": "Explicit iOS launch argument to force mock mode, e.g. '-debugMockMode YES'. Overrides the detected one."
+        },
+        "intentExtra": {
+          "type": "string",
+          "description": "Explicit Android intent extra, e.g. '--ez mockEnabled true'."
+        },
+        "buildConfig": {
+          "type": "string",
+          "description": "Build configuration that compiles the mocks (default 'Debug')."
+        }
+      }
+    },
+    "inventory": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Augments design_scenario_inventory, which decides the audit's target set. Only for states no source signal can reveal - everything detectable is detected.",
+      "properties": {
+        "extraLaunchArgs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Launch args (iOS) / boolean intent-extra keys (Android) that drive a distinct state but appear in no scanned literal."
+        },
+        "extraTargets": {
+          "type": "array",
+          "description": "Fully hand-declared targets, for states reachable only by a documented manual step.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id"],
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Stable target id, e.g. 'config:seatmap-3d'."
+              },
+              "kind": { "type": "string", "description": "Target kind label (default 'config')." },
+              "label": { "type": "string" },
+              "screen": {
+                "type": "string",
+                "description": "Screen this target belongs to (groups the coverage report)."
+              },
+              "driver": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "How to reach it: { type: 'manual', note } or any driver shape the runner understands."
+              }
+            }
+          }
+        },
+        "ignoreTargets": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Target ids to drop from the inventory entirely (dead drivers, states retired in code but still referenced). Unlike a skip, these never enter the coverage gate - use sparingly and prefer a skip with a reason."
+        }
+      }
+    },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Coverage gate tuning. The gate itself is not optional: a target is audited, or skipped with an explicit reason.",
+      "properties": {
+        "floor": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Additional hard floor on audited/target ratio (e.g. 0.9). Below it the gate fails even when every skip carries a reason."
+        },
+        "confirmAbove": {
+          "type": "integer",
+          "default": 25,
+          "description": "Relaunch count (inventory.relaunchCount for the scoped set, NOT the target count) above which Phase 0 asks for confirmation. Relaunches are the run's real cost: one relaunch serves every in-app target on that screen. Whole-module remains the intended default - this threshold estimates cost, it does not invite shrinking the audit."
+        }
+      }
+    },
+    "figma": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Figma frame + variant mapping overrides.",
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "Default Figma MCP URL for this module's frame/page."
+        },
+        "frameSize": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": { "w": { "type": "number" }, "h": { "type": "number" } },
+          "description": "Figma frame size the spec coordinates are in (usually auto-read)."
+        }
+      }
+    },
+    "variants": {
+      "type": "array",
+      "description": "Explicit mock-variant -> Figma-node mappings. When present, the picker skips name-similarity guessing for these.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "figmaNodeId"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Mock variant id (matches a variantsHint / fixture name)."
+          },
+          "label": { "type": "string" },
+          "figmaNodeId": {
+            "type": "string",
+            "description": "Figma node id for this variant's frame."
+          },
+          "activation": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "How to put the app into this variant (launch arg / UserDefaults values / navigation path)."
+          }
+        }
+      }
+    },
+    "capture": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Capture / comparison tuning.",
+      "properties": {
+        "cropTopLive": {
+          "type": "number",
+          "description": "Pixels to crop from the top of the live capture (status bar)."
+        },
+        "tolerancePx": { "type": "number", "default": 2 },
+        "colorTolerance": { "type": "number", "default": 3 },
+        "maxDiffPct": { "type": "number", "default": 1.0 }
+      }
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Report output + export.",
+      "properties": {
+        "outputRoot": {
+          "type": "string",
+          "description": "Report root dir (default ~/DesignChecks)."
+        },
+        "formats": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["html", "pdf", "confluence"] },
+          "default": ["html", "pdf"]
+        },
+        "confluence": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": { "type": "boolean", "default": false },
+            "space": { "type": "string" },
+            "parentId": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}