@mmerterden/multi-agent-pipeline 12.5.0 → 12.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (290) hide show
  1. package/CHANGELOG.md +213 -0
  2. package/README.md +19 -19
  3. package/docs/FIGMA_PIPELINE.md +34 -34
  4. package/docs/adr/0001-three-model-triage.md +12 -12
  5. package/docs/adr/0002-instruction-driven-flag.md +5 -5
  6. package/docs/adr/0003-unified-shared-skills.md +5 -5
  7. package/docs/adr/0004-zero-dependency-philosophy.md +5 -5
  8. package/docs/adr/0005-lazy-phase-docs.md +2 -2
  9. package/docs/adr/0006-skills-core-external-split.md +6 -6
  10. package/docs/adr/0007-multi-tool-adapter-framework.md +19 -19
  11. package/docs/adr/0008-installer-modularization-and-secret-leak-defense.md +19 -19
  12. package/docs/adr/README.md +1 -1
  13. package/docs/best-practices.md +3 -3
  14. package/docs/features.md +48 -28
  15. package/docs/performance.md +16 -16
  16. package/docs/recovery-guide.md +39 -39
  17. package/index.js +11 -5
  18. package/install/_common.mjs +5 -11
  19. package/install/_copilot-instructions.mjs +2 -2
  20. package/install/_dev-only-files.mjs +2 -1
  21. package/install/_platform-filter.mjs +1 -1
  22. package/install/_telemetry.mjs +1 -1
  23. package/install/claude.mjs +10 -9
  24. package/install/copilot.mjs +10 -19
  25. package/install/index.mjs +7 -15
  26. package/install/templates/copilot-instructions.md +54 -54
  27. package/install.js +1 -1
  28. package/package.json +15 -11
  29. package/pipeline/agents/security-auditor.md +1 -1
  30. package/pipeline/commands/archive-guard.md +5 -5
  31. package/pipeline/commands/multi-agent/SKILL.md +3 -1
  32. package/pipeline/commands/multi-agent/analysis/SKILL.md +1 -1
  33. package/pipeline/commands/multi-agent/analysis-resolve/SKILL.md +1 -1
  34. package/pipeline/commands/multi-agent/autopilot/SKILL.md +1 -1
  35. package/pipeline/commands/multi-agent/build-optimize/SKILL.md +1 -1
  36. package/pipeline/commands/multi-agent/create-jira/SKILL.md +1 -1
  37. package/pipeline/commands/multi-agent/design-check/SKILL.md +287 -0
  38. package/pipeline/commands/multi-agent/dev/SKILL.md +1 -1
  39. package/pipeline/commands/multi-agent/dev-autopilot/SKILL.md +1 -1
  40. package/pipeline/commands/multi-agent/dev-local/SKILL.md +1 -1
  41. package/pipeline/commands/multi-agent/dev-local-autopilot/SKILL.md +1 -1
  42. package/pipeline/commands/multi-agent/diff-explain/SKILL.md +1 -1
  43. package/pipeline/commands/multi-agent/finish/SKILL.md +6 -6
  44. package/pipeline/commands/multi-agent/forget/SKILL.md +1 -1
  45. package/pipeline/commands/multi-agent/garbage-collect/SKILL.md +1 -1
  46. package/pipeline/commands/multi-agent/help/SKILL.md +46 -6
  47. package/pipeline/commands/multi-agent/issue/SKILL.md +1 -1
  48. package/pipeline/commands/multi-agent/jira/SKILL.md +1 -1
  49. package/pipeline/commands/multi-agent/kill/SKILL.md +1 -1
  50. package/pipeline/commands/multi-agent/language/SKILL.md +1 -1
  51. package/pipeline/commands/multi-agent/local/SKILL.md +1 -1
  52. package/pipeline/commands/multi-agent/local-autopilot/SKILL.md +1 -1
  53. package/pipeline/commands/multi-agent/log/SKILL.md +1 -1
  54. package/pipeline/commands/multi-agent/manual-test/SKILL.md +1 -1
  55. package/pipeline/commands/multi-agent/prune-logs/SKILL.md +1 -1
  56. package/pipeline/commands/multi-agent/purge/SKILL.md +1 -1
  57. package/pipeline/commands/multi-agent/refactor/SKILL.md +107 -19
  58. package/pipeline/commands/multi-agent/resume/SKILL.md +2 -2
  59. package/pipeline/commands/multi-agent/review/SKILL.md +2 -2
  60. package/pipeline/commands/multi-agent/review-issue/SKILL.md +1 -1
  61. package/pipeline/commands/multi-agent/review-jira/SKILL.md +1 -1
  62. package/pipeline/commands/multi-agent/routines/SKILL.md +1 -1
  63. package/pipeline/commands/multi-agent/save/SKILL.md +1 -1
  64. package/pipeline/commands/multi-agent/scan/SKILL.md +1 -1
  65. package/pipeline/commands/multi-agent/search/SKILL.md +1 -1
  66. package/pipeline/commands/multi-agent/setup/SKILL.md +2 -2
  67. package/pipeline/commands/multi-agent/stack/SKILL.md +3 -3
  68. package/pipeline/commands/multi-agent/status/SKILL.md +1 -1
  69. package/pipeline/commands/multi-agent/sync/SKILL.md +123 -16
  70. package/pipeline/commands/multi-agent/test/SKILL.md +2 -2
  71. package/pipeline/commands/multi-agent/uninstall/SKILL.md +1 -1
  72. package/pipeline/commands/multi-agent/update/SKILL.md +3 -3
  73. package/pipeline/commands/sim-test.md +5 -5
  74. package/pipeline/eval/run-metrics-fixture.json +60 -13
  75. package/pipeline/lib/account-resolver.sh +1 -1
  76. package/pipeline/lib/channels-multi-repo.sh +1 -1
  77. package/pipeline/lib/context-link-extractor.sh +1 -1
  78. package/pipeline/lib/credential-store.sh +33 -1
  79. package/pipeline/lib/fetch-confluence.sh +1 -1
  80. package/pipeline/lib/fetch-crashlytics.sh +1 -1
  81. package/pipeline/lib/fetch-fortify.sh +1 -1
  82. package/pipeline/lib/fetch-graylog.sh +1 -1
  83. package/pipeline/lib/fetch-swagger.sh +1 -1
  84. package/pipeline/lib/issue-fetcher.sh +1 -1
  85. package/pipeline/lib/multi-repo-pipeline.sh +1 -1
  86. package/pipeline/lib/repo-cache.sh +1 -1
  87. package/pipeline/lib/submodule-detector.sh +1 -1
  88. package/pipeline/multi-agent-refs/component-dispatch.md +1 -1
  89. package/pipeline/multi-agent-refs/component-generation.md +121 -0
  90. package/pipeline/multi-agent-refs/cross-cli-contract.md +4 -4
  91. package/pipeline/multi-agent-refs/features/model-fallback.md +2 -2
  92. package/pipeline/multi-agent-refs/phases/phase-3-dev.md +2 -2
  93. package/pipeline/multi-agent-refs/phases/phase-4-review.md +1 -1
  94. package/pipeline/multi-agent-refs/phases/phase-5-test.md +4 -4
  95. package/pipeline/preferences-template.json +23 -12
  96. package/pipeline/schemas/agent-state.schema.json +125 -5
  97. package/pipeline/schemas/analysis-output.schema.json +18 -4
  98. package/pipeline/schemas/analysis-spec.schema.json +120 -32
  99. package/pipeline/schemas/clarify-output.schema.json +15 -5
  100. package/pipeline/schemas/design-check-config.schema.json +183 -0
  101. package/pipeline/schemas/dev-critic-output.schema.json +20 -5
  102. package/pipeline/schemas/figma-project-config.schema.json +42 -10
  103. package/pipeline/schemas/learnings-ledger.schema.json +10 -2
  104. package/pipeline/schemas/migrations/figma-config-1.0.0-to-2.0.0.mjs +1 -4
  105. package/pipeline/schemas/migrations/prefs-2.0.0-to-2.1.0.mjs +24 -7
  106. package/pipeline/schemas/migrations/state-2.0.0-to-2.1.0.mjs +30 -12
  107. package/pipeline/schemas/plan-todos.schema.json +6 -3
  108. package/pipeline/schemas/planning-output.schema.json +5 -1
  109. package/pipeline/schemas/prefs.schema.json +215 -197
  110. package/pipeline/schemas/test-gap.schema.json +5 -5
  111. package/pipeline/schemas/token-budget.json +8 -8
  112. package/pipeline/schemas/triage-corpus.schema.json +1 -1
  113. package/pipeline/scripts/README.md +7 -5
  114. package/pipeline/scripts/aggregate-metrics.mjs +18 -6
  115. package/pipeline/scripts/build-skills-index.mjs +6 -2
  116. package/pipeline/scripts/build-stack-plugins.mjs +142 -39
  117. package/pipeline/scripts/check-derived-drift.mjs +196 -0
  118. package/pipeline/scripts/check-md-links.mjs +6 -2
  119. package/pipeline/scripts/classify-plan-safety.mjs +26 -8
  120. package/pipeline/scripts/cost-budget-check.mjs +11 -6
  121. package/pipeline/scripts/cost-table.json +1 -1
  122. package/pipeline/scripts/diff-explain.mjs +7 -3
  123. package/pipeline/scripts/diff-risk-score.mjs +13 -3
  124. package/pipeline/scripts/eval-golden-tasks-live.mjs +8 -3
  125. package/pipeline/scripts/eval-golden-tasks.mjs +21 -9
  126. package/pipeline/scripts/eval-intent.mjs +8 -4
  127. package/pipeline/scripts/eval-mine-corpus.mjs +14 -4
  128. package/pipeline/scripts/evidence-gate.mjs +7 -2
  129. package/pipeline/scripts/fixtures/install-layout.tsv +7 -7
  130. package/pipeline/scripts/gen-mode-dispatch.mjs +38 -21
  131. package/pipeline/scripts/gen-skills-index.mjs +18 -3
  132. package/pipeline/scripts/learning-curve.mjs +13 -3
  133. package/pipeline/scripts/learnings-ledger.mjs +119 -34
  134. package/pipeline/scripts/lint-mcp-refs.mjs +218 -0
  135. package/pipeline/scripts/lint-skills.mjs +20 -9
  136. package/pipeline/scripts/localize-commands.mjs +6 -1
  137. package/pipeline/scripts/match-skills.mjs +15 -4
  138. package/pipeline/scripts/memory-load.sh +5 -1
  139. package/pipeline/scripts/migrate-prefs.mjs +33 -16
  140. package/pipeline/scripts/phase-tracker.sh +3 -1
  141. package/pipeline/scripts/render-work-summary.sh +4 -1
  142. package/pipeline/scripts/repo-map.mjs +110 -64
  143. package/pipeline/scripts/review-scope.mjs +7 -1
  144. package/pipeline/scripts/routine-registry.mjs +4 -9
  145. package/pipeline/scripts/run-aggregator.mjs +11 -5
  146. package/pipeline/scripts/run-metrics.mjs +13 -8
  147. package/pipeline/scripts/run-smokes.mjs +57 -3
  148. package/pipeline/scripts/scorecard.mjs +258 -0
  149. package/pipeline/scripts/smoke-command-inventory.sh +81 -0
  150. package/pipeline/scripts/smoke-commands-skills-parity.sh +1 -1
  151. package/pipeline/scripts/smoke-compliance-skills.sh +4 -4
  152. package/pipeline/scripts/smoke-context-budget.sh +72 -0
  153. package/pipeline/scripts/smoke-cross-cli-behavior.sh +12 -2
  154. package/pipeline/scripts/smoke-generate-issue.sh +6 -5
  155. package/pipeline/scripts/smoke-model-fallback.sh +1 -1
  156. package/pipeline/scripts/smoke-no-mcp-in-dev-phases.sh +86 -7
  157. package/pipeline/scripts/smoke-own-punctuation.sh +103 -0
  158. package/pipeline/scripts/smoke-per-repo-memory.sh +2 -2
  159. package/pipeline/scripts/smoke-review-readiness.sh +3 -2
  160. package/pipeline/scripts/smoke-schema-validation.sh +19 -5
  161. package/pipeline/scripts/smoke-shadow-git.sh +4 -2
  162. package/pipeline/scripts/smoke-workflow-audit.sh +43 -11
  163. package/pipeline/scripts/smoke-write-state.sh +49 -5
  164. package/pipeline/scripts/test-gap-rules/android.json +11 -11
  165. package/pipeline/scripts/test-gap-rules/ios.json +16 -11
  166. package/pipeline/scripts/test-gap-rules/node.json +19 -7
  167. package/pipeline/scripts/test-gap-rules/python.json +10 -4
  168. package/pipeline/scripts/test-gap-scan.mjs +44 -12
  169. package/pipeline/scripts/test-integrity-gate.mjs +5 -1
  170. package/pipeline/scripts/token-budget-report.mjs +44 -21
  171. package/pipeline/scripts/triage-memory.mjs +142 -32
  172. package/pipeline/scripts/uninstall.mjs +75 -31
  173. package/pipeline/scripts/validate-analysis-doc.mjs +15 -5
  174. package/pipeline/scripts/validate-diff-risk.mjs +32 -18
  175. package/pipeline/scripts/validate-test-gap.mjs +17 -7
  176. package/pipeline/scripts/validate-triage.mjs +17 -5
  177. package/pipeline/scripts/write-state.mjs +32 -9
  178. package/pipeline/skills/.skill-manifest.json +24 -8
  179. package/pipeline/skills/.skills-index.json +125 -89
  180. package/pipeline/skills/shared/README.md +65 -61
  181. package/pipeline/skills/shared/core/apple-archive-compliance/SKILL.md +10 -8
  182. package/pipeline/skills/shared/core/google-play-compliance/SKILL.md +1 -1
  183. package/pipeline/skills/shared/core/multi-agent/SKILL.md +26 -279
  184. package/pipeline/skills/shared/core/multi-agent-analysis/SKILL.md +1 -1
  185. package/pipeline/skills/shared/core/multi-agent-analysis-resolve/SKILL.md +1 -1
  186. package/pipeline/skills/shared/core/multi-agent-autopilot/SKILL.md +1 -1
  187. package/pipeline/skills/shared/core/multi-agent-build-optimize/SKILL.md +1 -1
  188. package/pipeline/skills/shared/core/multi-agent-create-jira/SKILL.md +1 -1
  189. package/pipeline/skills/shared/core/multi-agent-design-check/SKILL.md +248 -0
  190. package/pipeline/skills/shared/core/multi-agent-dev/SKILL.md +1 -1
  191. package/pipeline/skills/shared/core/multi-agent-dev-autopilot/SKILL.md +1 -1
  192. package/pipeline/skills/shared/core/multi-agent-dev-local/SKILL.md +1 -1
  193. package/pipeline/skills/shared/core/multi-agent-dev-local-autopilot/SKILL.md +1 -1
  194. package/pipeline/skills/shared/core/multi-agent-diff-explain/SKILL.md +1 -1
  195. package/pipeline/skills/shared/core/multi-agent-finish/SKILL.md +1 -1
  196. package/pipeline/skills/shared/core/multi-agent-forget/SKILL.md +1 -1
  197. package/pipeline/skills/shared/core/multi-agent-garbage-collect/SKILL.md +1 -1
  198. package/pipeline/skills/shared/core/multi-agent-help/SKILL.md +23 -1
  199. package/pipeline/skills/shared/core/multi-agent-issue/SKILL.md +1 -1
  200. package/pipeline/skills/shared/core/multi-agent-jira/SKILL.md +1 -1
  201. package/pipeline/skills/shared/core/multi-agent-kill/SKILL.md +1 -1
  202. package/pipeline/skills/shared/core/multi-agent-language/SKILL.md +1 -1
  203. package/pipeline/skills/shared/core/multi-agent-local/SKILL.md +1 -1
  204. package/pipeline/skills/shared/core/multi-agent-local-autopilot/SKILL.md +1 -1
  205. package/pipeline/skills/shared/core/multi-agent-log/SKILL.md +1 -1
  206. package/pipeline/skills/shared/core/multi-agent-manual-test/SKILL.md +1 -1
  207. package/pipeline/skills/shared/core/multi-agent-prune-logs/SKILL.md +1 -1
  208. package/pipeline/skills/shared/core/multi-agent-purge/SKILL.md +1 -1
  209. package/pipeline/skills/shared/core/multi-agent-refactor/SKILL.md +82 -18
  210. package/pipeline/skills/shared/core/multi-agent-resume/SKILL.md +1 -1
  211. package/pipeline/skills/shared/core/multi-agent-review/SKILL.md +2 -2
  212. package/pipeline/skills/shared/core/multi-agent-review-issue/SKILL.md +1 -1
  213. package/pipeline/skills/shared/core/multi-agent-review-jira/SKILL.md +1 -1
  214. package/pipeline/skills/shared/core/multi-agent-routines/SKILL.md +1 -1
  215. package/pipeline/skills/shared/core/multi-agent-save/SKILL.md +1 -1
  216. package/pipeline/skills/shared/core/multi-agent-scan/SKILL.md +1 -1
  217. package/pipeline/skills/shared/core/multi-agent-search/SKILL.md +1 -1
  218. package/pipeline/skills/shared/core/multi-agent-setup/SKILL.md +1 -1
  219. package/pipeline/skills/shared/core/multi-agent-stack/SKILL.md +3 -3
  220. package/pipeline/skills/shared/core/multi-agent-status/SKILL.md +1 -1
  221. package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md +51 -9
  222. package/pipeline/skills/shared/core/multi-agent-test/SKILL.md +2 -2
  223. package/pipeline/skills/shared/core/multi-agent-uninstall/SKILL.md +1 -1
  224. package/pipeline/skills/shared/core/multi-agent-update/SKILL.md +1 -1
  225. package/pipeline/skills/shared/external/accessibility-compliance-accessibility-audit/SKILL.md +1 -1
  226. package/pipeline/skills/shared/external/agent-introspection-debugging/SKILL.md +4 -4
  227. package/pipeline/skills/shared/external/agentflow/SKILL.md +1 -1
  228. package/pipeline/skills/shared/external/android-jetpack-compose-expert/SKILL.md +1 -1
  229. package/pipeline/skills/shared/external/android_ui_verification/SKILL.md +1 -1
  230. package/pipeline/skills/shared/external/api-patterns/SKILL.md +1 -1
  231. package/pipeline/skills/shared/external/api-security-best-practices/SKILL.md +1 -1
  232. package/pipeline/skills/shared/external/app-store-changelog/SKILL.md +1 -1
  233. package/pipeline/skills/shared/external/backlog/BACKLOG.md +1 -1
  234. package/pipeline/skills/shared/external/backlog/SKILL.md +12 -12
  235. package/pipeline/skills/shared/external/ci-cd-pipelines/SKILL.md +1 -1
  236. package/pipeline/skills/shared/external/context-compression/SKILL.md +1 -1
  237. package/pipeline/skills/shared/external/council/SKILL.md +3 -3
  238. package/pipeline/skills/shared/external/css-modern/SKILL.md +1 -1
  239. package/pipeline/skills/shared/external/database-patterns/SKILL.md +1 -1
  240. package/pipeline/skills/shared/external/debugging-strategies/SKILL.md +1 -1
  241. package/pipeline/skills/shared/external/docker-expert/SKILL.md +1 -1
  242. package/pipeline/skills/shared/external/fastapi-pro/SKILL.md +1 -1
  243. package/pipeline/skills/shared/external/firebase/SKILL.md +1 -1
  244. package/pipeline/skills/shared/external/github-actions-templates/SKILL.md +1 -1
  245. package/pipeline/skills/shared/external/help-skills/SKILL.md +1 -1
  246. package/pipeline/skills/shared/external/hig-components-content/SKILL.md +1 -1
  247. package/pipeline/skills/shared/external/hig-components-layout/SKILL.md +1 -1
  248. package/pipeline/skills/shared/external/hig-components-status/SKILL.md +1 -1
  249. package/pipeline/skills/shared/external/hig-components-system/SKILL.md +1 -1
  250. package/pipeline/skills/shared/external/hig-foundations/SKILL.md +1 -1
  251. package/pipeline/skills/shared/external/hig-inputs/SKILL.md +1 -1
  252. package/pipeline/skills/shared/external/hig-patterns/SKILL.md +1 -1
  253. package/pipeline/skills/shared/external/hig-platforms/SKILL.md +1 -1
  254. package/pipeline/skills/shared/external/hig-technologies/SKILL.md +1 -1
  255. package/pipeline/skills/shared/external/html-semantic/SKILL.md +1 -1
  256. package/pipeline/skills/shared/external/humanizer/SKILL.md +1 -1
  257. package/pipeline/skills/shared/external/ios-debugger-agent/SKILL.md +1 -1
  258. package/pipeline/skills/shared/external/ios-developer/SKILL.md +1 -1
  259. package/pipeline/skills/shared/external/kotlin-coroutines-expert/SKILL.md +1 -1
  260. package/pipeline/skills/shared/external/macos-menubar-tuist-app/SKILL.md +1 -1
  261. package/pipeline/skills/shared/external/macos-spm-app-packaging/SKILL.md +1 -1
  262. package/pipeline/skills/shared/external/monorepo-architect/SKILL.md +1 -1
  263. package/pipeline/skills/shared/external/nextjs-app-router/SKILL.md +1 -1
  264. package/pipeline/skills/shared/external/nodejs-backend-patterns/SKILL.md +1 -1
  265. package/pipeline/skills/shared/external/observability-engineer/SKILL.md +1 -1
  266. package/pipeline/skills/shared/external/python-patterns/SKILL.md +1 -1
  267. package/pipeline/skills/shared/external/react-best-practices/SKILL.md +1 -1
  268. package/pipeline/skills/shared/external/rest-api-design/SKILL.md +1 -1
  269. package/pipeline/skills/shared/external/search-first/SKILL.md +2 -2
  270. package/pipeline/skills/shared/external/skill-creator/SKILL.md +12 -12
  271. package/pipeline/skills/shared/external/skill-creator/audit.md +21 -21
  272. package/pipeline/skills/shared/external/skill-creator/checklist.md +3 -3
  273. package/pipeline/skills/shared/external/skill-creator/examples.md +10 -10
  274. package/pipeline/skills/shared/external/skill-creator/label-check.md +17 -17
  275. package/pipeline/skills/shared/external/skill-creator/scripts/audit-panel.js +86 -50
  276. package/pipeline/skills/shared/external/skill-creator/template.md +9 -9
  277. package/pipeline/skills/shared/external/swift-concurrency-expert/SKILL.md +1 -1
  278. package/pipeline/skills/shared/external/swiftui-performance-audit/SKILL.md +1 -1
  279. package/pipeline/skills/shared/external/swiftui-ui-patterns/SKILL.md +1 -1
  280. package/pipeline/skills/shared/external/swiftui-view-refactor/SKILL.md +1 -1
  281. package/pipeline/skills/shared/external/tailwind-css/SKILL.md +1 -1
  282. package/pipeline/skills/shared/external/testing-backend/SKILL.md +1 -1
  283. package/pipeline/skills/shared/external/typescript-patterns/SKILL.md +1 -1
  284. package/pipeline/skills/shared/external/vue-composition/SKILL.md +1 -1
  285. package/pipeline/skills/shared/external/web-accessibility/SKILL.md +1 -1
  286. package/pipeline/skills/shared/external/web-performance/SKILL.md +1 -1
  287. package/pipeline/skills/shared/external/web-testing/SKILL.md +1 -1
  288. package/pipeline/skills/shared/external/xcode-build-benchmark/schemas/build-benchmark.schema.json +9 -49
  289. package/pipeline/skills/skills-index.md +63 -59
  290. package/pipeline/scripts/smoke-plugin-validate.sh +0 -64
@@ -33,8 +33,14 @@
33
33
  "required": ["status"],
34
34
  "properties": {
35
35
  "status": { "type": "string", "enum": ["pass", "fail", "skipped"] },
36
- "skip_reason": { "type": "string", "description": "Required when status == 'skipped'. E.g. 'xcodebuild not installed on this runner'." },
37
- "error_summary": { "type": "string", "description": "First failure line + count when status == 'fail'." }
36
+ "skip_reason": {
37
+ "type": "string",
38
+ "description": "Required when status == 'skipped'. E.g. 'xcodebuild not installed on this runner'."
39
+ },
40
+ "error_summary": {
41
+ "type": "string",
42
+ "description": "First failure line + count when status == 'fail'."
43
+ }
38
44
  }
39
45
  },
40
46
  "lint": {
@@ -84,11 +90,20 @@
84
90
  "required": ["severity", "file", "issue"],
85
91
  "properties": {
86
92
  "severity": { "type": "string", "enum": ["blocking", "important", "suggestion"] },
87
- "file": { "type": "string", "description": "Repo-relative path. For multi-repo tasks, prefixed with '<repo-name>/'." },
93
+ "file": {
94
+ "type": "string",
95
+ "description": "Repo-relative path. For multi-repo tasks, prefixed with '<repo-name>/'."
96
+ },
88
97
  "line": { "type": "integer", "minimum": 1 },
89
- "rule": { "type": "string", "description": "Citation. Format: 'rules/<file>.md#<anchor>' or 'gate/<name>'." },
98
+ "rule": {
99
+ "type": "string",
100
+ "description": "Citation. Format: 'rules/<file>.md#<anchor>' or 'gate/<name>'."
101
+ },
90
102
  "issue": { "type": "string", "description": "Short, one-sentence description." },
91
- "fix": { "type": "string", "description": "Concrete suggestion the generator can act on without re-reading the rule." }
103
+ "fix": {
104
+ "type": "string",
105
+ "description": "Concrete suggestion the generator can act on without re-reading the rule."
106
+ }
92
107
  }
93
108
  }
94
109
  },
@@ -283,10 +283,22 @@
283
283
  "additionalProperties": false,
284
284
  "properties": {
285
285
  "mode": { "type": "string", "enum": ["native", "custom"], "default": "native" },
286
- "router": { "type": "string", "description": "Router type that dispatches routes (custom mode)." },
287
- "routeEnum": { "type": "string", "description": "Exhaustive cross-surface route enum (custom mode)." },
288
- "sceneType": { "type": "string", "description": "Headless screen container type (custom mode, optional)." },
289
- "navigatorProtocol": { "type": "string", "description": "DI'd selection/present API (custom mode, optional)." }
286
+ "router": {
287
+ "type": "string",
288
+ "description": "Router type that dispatches routes (custom mode)."
289
+ },
290
+ "routeEnum": {
291
+ "type": "string",
292
+ "description": "Exhaustive cross-surface route enum (custom mode)."
293
+ },
294
+ "sceneType": {
295
+ "type": "string",
296
+ "description": "Headless screen container type (custom mode, optional)."
297
+ },
298
+ "navigatorProtocol": {
299
+ "type": "string",
300
+ "description": "DI'd selection/present API (custom mode, optional)."
301
+ }
290
302
  }
291
303
  },
292
304
  "overlaySystem": {
@@ -294,8 +306,15 @@
294
306
  "additionalProperties": false,
295
307
  "properties": {
296
308
  "mode": { "type": "string", "enum": ["native", "custom"], "default": "native" },
297
- "center": { "type": "string", "description": "DI'd overlay center protocol callable from VM/coordinator (custom mode)." },
298
- "surfaces": { "type": "array", "items": { "type": "string" }, "description": "Independent render surfaces, e.g. root/currentScene (custom mode, optional)." }
309
+ "center": {
310
+ "type": "string",
311
+ "description": "DI'd overlay center protocol callable from VM/coordinator (custom mode)."
312
+ },
313
+ "surfaces": {
314
+ "type": "array",
315
+ "items": { "type": "string" },
316
+ "description": "Independent render surfaces, e.g. root/currentScene (custom mode, optional)."
317
+ }
299
318
  }
300
319
  },
301
320
  "sheetSystem": {
@@ -303,11 +322,24 @@
303
322
  "additionalProperties": false,
304
323
  "properties": {
305
324
  "mode": { "type": "string", "enum": ["native", "custom"], "default": "native" },
306
- "brandedModifier": { "type": "string", "description": "Branded sheet entry modifier, e.g. bottomSheet (custom mode)." },
307
- "headlessModifiers": { "type": "array", "items": { "type": "string" }, "description": "Headless sheet modifiers, e.g. modalSheet/dockedSheet/expandableSheet/detentNavigationSheet (custom mode)." },
325
+ "brandedModifier": {
326
+ "type": "string",
327
+ "description": "Branded sheet entry modifier, e.g. bottomSheet (custom mode)."
328
+ },
329
+ "headlessModifiers": {
330
+ "type": "array",
331
+ "items": { "type": "string" },
332
+ "description": "Headless sheet modifiers, e.g. modalSheet/dockedSheet/expandableSheet/detentNavigationSheet (custom mode)."
333
+ },
308
334
  "detentType": { "type": "string", "description": "Detent enum type (custom mode)." },
309
- "backdropType": { "type": "string", "description": "Backdrop enum type (custom mode)." },
310
- "cornerRadiusToken": { "type": "string", "description": "Branded top-corner radius token (custom mode)." }
335
+ "backdropType": {
336
+ "type": "string",
337
+ "description": "Backdrop enum type (custom mode)."
338
+ },
339
+ "cornerRadiusToken": {
340
+ "type": "string",
341
+ "description": "Branded top-corner radius token (custom mode)."
342
+ }
311
343
  }
312
344
  }
313
345
  }
@@ -9,8 +9,16 @@
9
9
  "required": ["v", "ts", "repo_slug", "kind", "scope", "statement"],
10
10
  "properties": {
11
11
  "v": { "type": "string", "description": "Row schema version." },
12
- "ts": { "type": "string", "format": "date-time", "description": "When the entry was recorded." },
13
- "repo_slug": { "type": "string", "minLength": 1, "description": "Repo the knowledge belongs to." },
12
+ "ts": {
13
+ "type": "string",
14
+ "format": "date-time",
15
+ "description": "When the entry was recorded."
16
+ },
17
+ "repo_slug": {
18
+ "type": "string",
19
+ "minLength": 1,
20
+ "description": "Repo the knowledge belongs to."
21
+ },
14
22
  "kind": {
15
23
  "type": "string",
16
24
  "enum": ["fact", "convention", "rejected-preference"],
@@ -30,10 +30,7 @@ export function migrate(prev) {
30
30
  if (prev.board.projectId && !next.github.projectV2Id) {
31
31
  next.github.projectV2Id = prev.board.projectId;
32
32
  }
33
- if (
34
- prev.board.customFields &&
35
- !next.github.projectV2Fields
36
- ) {
33
+ if (prev.board.customFields && !next.github.projectV2Fields) {
37
34
  next.github.projectV2Fields = { ...prev.board.customFields };
38
35
  }
39
36
  }
@@ -25,9 +25,16 @@ export default function migrate(data) {
25
25
 
26
26
  // keychainMapping defaults (10 services)
27
27
  const kmDefaults = {
28
- jira: null, bitbucket_token: null, bitbucket_user: null, github: null,
29
- confluence: null, figma: null, figma_mcp: null,
30
- fortify: null, firebase: null, jenkins: null,
28
+ jira: null,
29
+ bitbucket_token: null,
30
+ bitbucket_user: null,
31
+ github: null,
32
+ confluence: null,
33
+ figma: null,
34
+ figma_mcp: null,
35
+ fortify: null,
36
+ firebase: null,
37
+ jenkins: null,
31
38
  };
32
39
  const km = out.global.keychainMapping || {};
33
40
  for (const [k, v] of Object.entries(kmDefaults)) {
@@ -55,13 +62,23 @@ export default function migrate(data) {
55
62
  if (!out.global.serviceStatus) out.global.serviceStatus = {};
56
63
  if (!out.global.settings) {
57
64
  out.global.settings = {
58
- branchTtlDays: 15, pushRetryMax: 5, buildRetryMax: 3,
59
- serviceStatusCacheSeconds: 300, repoScanDays: 90,
60
- identityRoutingEnabled: false, multiRepoEnabled: false, pushMustSucceed: true,
65
+ branchTtlDays: 15,
66
+ pushRetryMax: 5,
67
+ buildRetryMax: 3,
68
+ serviceStatusCacheSeconds: 300,
69
+ repoScanDays: 90,
70
+ identityRoutingEnabled: false,
71
+ multiRepoEnabled: false,
72
+ pushMustSucceed: true,
61
73
  };
62
74
  }
63
75
  if (!out.global.triageCrossCheck) {
64
- out.global.triageCrossCheck = { enabled: false, samplePct: 10, model: "sonnet", blockOnDisagreement: false };
76
+ out.global.triageCrossCheck = {
77
+ enabled: false,
78
+ samplePct: 10,
79
+ model: "sonnet",
80
+ blockOnDisagreement: false,
81
+ };
65
82
  }
66
83
  if (!out.global.promptLanguage) out.global.promptLanguage = "en";
67
84
 
@@ -12,22 +12,40 @@ export default function migrate(data) {
12
12
 
13
13
  out.schemaVersion = "2.1.0";
14
14
 
15
- // If projects[] doesn't exist and scalar fields do, create projects[0] from scalars
16
- if (!Array.isArray(out.projects) && out.project) {
17
- out.projects = [{
18
- name: out.project,
19
- root: out.projectRoot || null,
20
- worktreePath: out.worktreePath || null,
21
- branch: out.branch || null,
22
- baseBranch: out.baseBranch || null,
23
- identity: out.identity || null,
24
- platform: out.remoteType || null,
25
- baseFetchStatus: "fresh",
15
+ // If projects[] doesn't exist and the scalar mirrors do, create projects[0]
16
+ // from them. The item schema sets additionalProperties:false and requires
17
+ // project/projectRoot/branch/baseBranch/identity, so only emit keys the
18
+ // schema declares and only build the entry when every required key is
19
+ // populated - a partial entry would be schema-invalid, which is worse than
20
+ // no entry at all.
21
+ const canMirror =
22
+ !Array.isArray(out.projects) &&
23
+ typeof out.project === "string" &&
24
+ typeof out.projectRoot === "string" &&
25
+ typeof out.branch === "string" &&
26
+ typeof out.baseBranch === "string" &&
27
+ out.identity !== null &&
28
+ typeof out.identity === "object";
29
+
30
+ if (canMirror) {
31
+ const entry = {
32
+ project: out.project,
33
+ projectRoot: out.projectRoot,
34
+ branch: out.branch,
35
+ baseBranch: out.baseBranch,
36
+ identity: out.identity,
37
+ worktreePath: out.worktreePath ?? null,
26
38
  commit: null,
27
39
  pr: null,
28
40
  pushAttempts: 0,
29
41
  buildStatus: null,
30
- }];
42
+ };
43
+ // `platform` and `remoteType` are non-nullable enums: omit rather than null.
44
+ if (typeof out.remoteType === "string") {
45
+ entry.remoteType = out.remoteType;
46
+ entry.platform = out.remoteType;
47
+ }
48
+ out.projects = [entry];
31
49
  }
32
50
 
33
51
  return out;
@@ -45,11 +45,14 @@
45
45
  "description": "Array of todo IDs that must reach `completed` (or `skipped`) before this one can move to `in_progress`. Empty for parallelizable steps.",
46
46
  "items": { "type": "string", "pattern": "^t[0-9]+$" }
47
47
  },
48
- "startedAt": { "type": "string", "format": "date-time" },
48
+ "startedAt": { "type": "string", "format": "date-time" },
49
49
  "completedAt": { "type": "string", "format": "date-time" },
50
- "notes": { "type": "string", "description": "Free-text outcome - commit hash, test count, anything Phase 7 should echo." },
50
+ "notes": {
51
+ "type": "string",
52
+ "description": "Free-text outcome - commit hash, test count, anything Phase 7 should echo."
53
+ },
51
54
  "failureReason": { "type": "string" },
52
- "skipReason": { "type": "string" },
55
+ "skipReason": { "type": "string" },
53
56
  "estimatedMinutes": {
54
57
  "type": "integer",
55
58
  "minimum": 1,
@@ -20,7 +20,11 @@
20
20
  "additionalProperties": false,
21
21
  "required": ["id", "title", "type", "files"],
22
22
  "properties": {
23
- "id": { "type": "string", "pattern": "^T[0-9]+$", "description": "Local task id, e.g. T1, T2." },
23
+ "id": {
24
+ "type": "string",
25
+ "pattern": "^T[0-9]+$",
26
+ "description": "Local task id, e.g. T1, T2."
27
+ },
24
28
  "title": { "type": "string", "minLength": 4 },
25
29
  "type": {
26
30
  "type": "string",