onto-mcp 0.3.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 (447) hide show
  1. package/.onto/authority/core-lens-registry.yaml +134 -0
  2. package/.onto/authority/core-lexicon.yaml +1562 -0
  3. package/.onto/authority/diagnostic-codes.yaml +94 -0
  4. package/.onto/domains/accounting/competency_qs.md +384 -0
  5. package/.onto/domains/accounting/concepts.md +186 -0
  6. package/.onto/domains/accounting/conciseness_rules.md +160 -0
  7. package/.onto/domains/accounting/dependency_rules.md +239 -0
  8. package/.onto/domains/accounting/domain_scope.md +213 -0
  9. package/.onto/domains/accounting/extension_cases.md +416 -0
  10. package/.onto/domains/accounting/logic_rules.md +226 -0
  11. package/.onto/domains/accounting/structure_spec.md +298 -0
  12. package/.onto/domains/accounting-kr/competency_qs.md +562 -0
  13. package/.onto/domains/accounting-kr/concepts.md +187 -0
  14. package/.onto/domains/accounting-kr/conciseness_rules.md +125 -0
  15. package/.onto/domains/accounting-kr/dependency_rules.md +93 -0
  16. package/.onto/domains/accounting-kr/domain_scope.md +140 -0
  17. package/.onto/domains/accounting-kr/extension_cases.md +343 -0
  18. package/.onto/domains/accounting-kr/logic_rules.md +160 -0
  19. package/.onto/domains/accounting-kr/structure_spec.md +85 -0
  20. package/.onto/domains/business/competency_qs.md +263 -0
  21. package/.onto/domains/business/concepts.md +200 -0
  22. package/.onto/domains/business/conciseness_rules.md +135 -0
  23. package/.onto/domains/business/dependency_rules.md +113 -0
  24. package/.onto/domains/business/domain_scope.md +240 -0
  25. package/.onto/domains/business/extension_cases.md +249 -0
  26. package/.onto/domains/business/logic_rules.md +134 -0
  27. package/.onto/domains/business/structure_spec.md +114 -0
  28. package/.onto/domains/finance/competency_qs.md +362 -0
  29. package/.onto/domains/finance/concepts.md +194 -0
  30. package/.onto/domains/finance/conciseness_rules.md +155 -0
  31. package/.onto/domains/finance/dependency_rules.md +171 -0
  32. package/.onto/domains/finance/domain_scope.md +215 -0
  33. package/.onto/domains/finance/extension_cases.md +350 -0
  34. package/.onto/domains/finance/logic_rules.md +191 -0
  35. package/.onto/domains/finance/structure_spec.md +182 -0
  36. package/.onto/domains/llm-native-development/competency_qs.md +430 -0
  37. package/.onto/domains/llm-native-development/concepts.md +242 -0
  38. package/.onto/domains/llm-native-development/conciseness_rules.md +163 -0
  39. package/.onto/domains/llm-native-development/dependency_rules.md +216 -0
  40. package/.onto/domains/llm-native-development/domain_scope.md +197 -0
  41. package/.onto/domains/llm-native-development/extension_cases.md +474 -0
  42. package/.onto/domains/llm-native-development/logic_rules.md +123 -0
  43. package/.onto/domains/llm-native-development/prompt_interface.md +49 -0
  44. package/.onto/domains/llm-native-development/structure_spec.md +245 -0
  45. package/.onto/domains/market-intelligence/competency_qs.md +274 -0
  46. package/.onto/domains/market-intelligence/concepts.md +233 -0
  47. package/.onto/domains/market-intelligence/conciseness_rules.md +165 -0
  48. package/.onto/domains/market-intelligence/dependency_rules.md +197 -0
  49. package/.onto/domains/market-intelligence/domain_scope.md +231 -0
  50. package/.onto/domains/market-intelligence/extension_cases.md +425 -0
  51. package/.onto/domains/market-intelligence/logic_rules.md +247 -0
  52. package/.onto/domains/market-intelligence/structure_spec.md +209 -0
  53. package/.onto/domains/ontology/competency_qs.md +394 -0
  54. package/.onto/domains/ontology/concepts.md +172 -0
  55. package/.onto/domains/ontology/conciseness_rules.md +134 -0
  56. package/.onto/domains/ontology/dependency_rules.md +125 -0
  57. package/.onto/domains/ontology/domain_scope.md +114 -0
  58. package/.onto/domains/ontology/extension_cases.md +501 -0
  59. package/.onto/domains/ontology/logic_rules.md +114 -0
  60. package/.onto/domains/ontology/problem_framing_profile.md +67 -0
  61. package/.onto/domains/ontology/structure_spec.md +115 -0
  62. package/.onto/domains/palantir-foundry/RESEARCH_NOTES.md +911 -0
  63. package/.onto/domains/palantir-foundry/competency_qs.md +191 -0
  64. package/.onto/domains/palantir-foundry/competitive_comparison.md +329 -0
  65. package/.onto/domains/palantir-foundry/concepts.md +197 -0
  66. package/.onto/domains/palantir-foundry/conciseness_rules.md +245 -0
  67. package/.onto/domains/palantir-foundry/dependency_rules.md +135 -0
  68. package/.onto/domains/palantir-foundry/domain_scope.md +395 -0
  69. package/.onto/domains/palantir-foundry/extension_cases.md +210 -0
  70. package/.onto/domains/palantir-foundry/logic_rules.md +172 -0
  71. package/.onto/domains/palantir-foundry/structure_spec.md +291 -0
  72. package/.onto/domains/software-engineering/competency_qs.md +538 -0
  73. package/.onto/domains/software-engineering/concepts.md +238 -0
  74. package/.onto/domains/software-engineering/conciseness_rules.md +167 -0
  75. package/.onto/domains/software-engineering/dependency_rules.md +216 -0
  76. package/.onto/domains/software-engineering/domain_scope.md +183 -0
  77. package/.onto/domains/software-engineering/extension_cases.md +551 -0
  78. package/.onto/domains/software-engineering/logic_rules.md +240 -0
  79. package/.onto/domains/software-engineering/problem_framing_profile.md +68 -0
  80. package/.onto/domains/software-engineering/structure_spec.md +185 -0
  81. package/.onto/domains/ui-design/competency_qs.md +567 -0
  82. package/.onto/domains/ui-design/concepts.md +194 -0
  83. package/.onto/domains/ui-design/conciseness_rules.md +190 -0
  84. package/.onto/domains/ui-design/dependency_rules.md +323 -0
  85. package/.onto/domains/ui-design/domain_scope.md +340 -0
  86. package/.onto/domains/ui-design/extension_cases.md +563 -0
  87. package/.onto/domains/ui-design/logic_rules.md +349 -0
  88. package/.onto/domains/ui-design/structure_spec.md +252 -0
  89. package/.onto/domains/visual-design/competency_qs.md +472 -0
  90. package/.onto/domains/visual-design/concepts.md +147 -0
  91. package/.onto/domains/visual-design/conciseness_rules.md +186 -0
  92. package/.onto/domains/visual-design/dependency_rules.md +282 -0
  93. package/.onto/domains/visual-design/domain_scope.md +290 -0
  94. package/.onto/domains/visual-design/extension_cases.md +480 -0
  95. package/.onto/domains/visual-design/logic_rules.md +232 -0
  96. package/.onto/domains/visual-design/structure_spec.md +213 -0
  97. package/.onto/principles/llm-native-development-guideline.md +401 -0
  98. package/.onto/principles/llm-runtime-interface-principles.md +665 -0
  99. package/.onto/principles/non-specialist-communication-guideline.md +74 -0
  100. package/.onto/principles/ontology-as-code-guideline.md +243 -0
  101. package/.onto/principles/ontology-as-code-naming-charter.md +130 -0
  102. package/.onto/principles/product-locality-principle.md +129 -0
  103. package/.onto/principles/productization-charter.md +569 -0
  104. package/.onto/processes/evolve/material-kind-adapter-contract.md +113 -0
  105. package/.onto/processes/reconstruct/reconstruct-boundary-contract.md +366 -0
  106. package/.onto/processes/reconstruct/source-profile-contract.md +107 -0
  107. package/.onto/processes/reconstruct/source-profiles/code.md +72 -0
  108. package/.onto/processes/reconstruct/source-profiles/database.md +74 -0
  109. package/.onto/processes/reconstruct/source-profiles/document.md +71 -0
  110. package/.onto/processes/reconstruct/source-profiles/spreadsheet.md +79 -0
  111. package/.onto/processes/review/binding-contract.md +270 -0
  112. package/.onto/processes/review/execution-preparation-artifacts.md +281 -0
  113. package/.onto/processes/review/interpretation-contract.md +245 -0
  114. package/.onto/processes/review/issue-stance-deliberation-contract.md +761 -0
  115. package/.onto/processes/review/lens-prompt-contract.md +402 -0
  116. package/.onto/processes/review/lens-registry.md +127 -0
  117. package/.onto/processes/review/pre-dispatch-contracts.md +428 -0
  118. package/.onto/processes/review/productized-live-path.md +398 -0
  119. package/.onto/processes/review/prompt-execution-runner-contract.md +187 -0
  120. package/.onto/processes/review/record-contract.md +427 -0
  121. package/.onto/processes/review/record-field-mapping.md +337 -0
  122. package/.onto/processes/review/review-context-manifest-contract.md +356 -0
  123. package/.onto/processes/review/review-execution-ux-contract.md +809 -0
  124. package/.onto/processes/review/review-target-profile-contract.md +259 -0
  125. package/.onto/processes/review/shared-phenomenon-contract.md +129 -0
  126. package/.onto/processes/review/synthesize-prompt-contract.md +343 -0
  127. package/.onto/processes/shared/target-material-kind-contract.md +198 -0
  128. package/.onto/roles/axiology.md +81 -0
  129. package/.onto/roles/conciseness.md +36 -0
  130. package/.onto/roles/coverage.md +34 -0
  131. package/.onto/roles/dependency.md +37 -0
  132. package/.onto/roles/evolution.md +35 -0
  133. package/.onto/roles/logic.md +104 -0
  134. package/.onto/roles/pragmatics.md +32 -0
  135. package/.onto/roles/semantics.md +36 -0
  136. package/.onto/roles/structure.md +33 -0
  137. package/.onto/roles/synthesize.md +92 -0
  138. package/AGENTS.md +240 -0
  139. package/CLAUDE.md +39 -0
  140. package/README.md +287 -0
  141. package/bin/onto +92 -0
  142. package/dist/cli.js +101 -0
  143. package/dist/core-api/reconstruct-api.js +222 -0
  144. package/dist/core-api/review-api.js +1271 -0
  145. package/dist/core-runtime/cli/assemble-review-record.js +431 -0
  146. package/dist/core-runtime/cli/bootstrap-review-binding.js +186 -0
  147. package/dist/core-runtime/cli/codex-nested-dispatch.js +226 -0
  148. package/dist/core-runtime/cli/codex-nested-dispatch.test.js +390 -0
  149. package/dist/core-runtime/cli/codex-nested-teamlead-executor.js +464 -0
  150. package/dist/core-runtime/cli/codex-nested-teamlead-executor.test.js +335 -0
  151. package/dist/core-runtime/cli/codex-review-unit-executor.js +228 -0
  152. package/dist/core-runtime/cli/complete-review-session.js +64 -0
  153. package/dist/core-runtime/cli/complexity-assessment.js +153 -0
  154. package/dist/core-runtime/cli/coordinator-helpers.js +583 -0
  155. package/dist/core-runtime/cli/coordinator-state-machine-deliberation.test.js +167 -0
  156. package/dist/core-runtime/cli/coordinator-state-machine.js +794 -0
  157. package/dist/core-runtime/cli/e2e-codex-multi-agent-fixes.test.js +615 -0
  158. package/dist/core-runtime/cli/e2e-start-review-session.test.js +312 -0
  159. package/dist/core-runtime/cli/health.js +44 -0
  160. package/dist/core-runtime/cli/inline-http-review-unit-executor.js +656 -0
  161. package/dist/core-runtime/cli/inline-http-review-unit-executor.test.js +567 -0
  162. package/dist/core-runtime/cli/materialize-review-execution-preparation.js +104 -0
  163. package/dist/core-runtime/cli/materialize-review-prompt-packets.js +952 -0
  164. package/dist/core-runtime/cli/migrate-session-roots.js +118 -0
  165. package/dist/core-runtime/cli/mock-review-unit-executor.js +285 -0
  166. package/dist/core-runtime/cli/onto-tools.js +369 -0
  167. package/dist/core-runtime/cli/prepare-review-session.js +272 -0
  168. package/dist/core-runtime/cli/render-review-final-output.js +350 -0
  169. package/dist/core-runtime/cli/repo-layout-migration-replace.smoke.test.js +106 -0
  170. package/dist/core-runtime/cli/review-invoke-auto-resolution.test.js +268 -0
  171. package/dist/core-runtime/cli/review-invoke-coordinator-topology.test.js +136 -0
  172. package/dist/core-runtime/cli/review-invoke-resolver-caching.test.js +201 -0
  173. package/dist/core-runtime/cli/review-invoke-topology-dispatch.test.js +192 -0
  174. package/dist/core-runtime/cli/review-invoke.js +2030 -0
  175. package/dist/core-runtime/cli/run-review-prompt-execution.js +2152 -0
  176. package/dist/core-runtime/cli/session-root-guard.js +168 -0
  177. package/dist/core-runtime/cli/spawn-watcher.js +173 -0
  178. package/dist/core-runtime/cli/spawn-watcher.test.js +457 -0
  179. package/dist/core-runtime/cli/start-review-session.js +68 -0
  180. package/dist/core-runtime/cli/strip-wrapping-code-fence.js +56 -0
  181. package/dist/core-runtime/cli/strip-wrapping-code-fence.test.js +79 -0
  182. package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.js +412 -0
  183. package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.test.js +351 -0
  184. package/dist/core-runtime/cli/topology-executor-mapping.js +139 -0
  185. package/dist/core-runtime/cli/topology-executor-mapping.test.js +173 -0
  186. package/dist/core-runtime/cli/write-review-interpretation.js +81 -0
  187. package/dist/core-runtime/config/onto-config-cli.js +278 -0
  188. package/dist/core-runtime/config/onto-config-key-path.js +288 -0
  189. package/dist/core-runtime/config/onto-config-key-path.test.js +195 -0
  190. package/dist/core-runtime/config/onto-config-preview.js +108 -0
  191. package/dist/core-runtime/config/onto-config-preview.test.js +132 -0
  192. package/dist/core-runtime/discovery/config-chain.js +118 -0
  193. package/dist/core-runtime/discovery/config-chain.test.js +103 -0
  194. package/dist/core-runtime/discovery/config-profile.js +199 -0
  195. package/dist/core-runtime/discovery/config-profile.test.js +233 -0
  196. package/dist/core-runtime/discovery/host-detection.js +33 -0
  197. package/dist/core-runtime/discovery/host-detection.test.js +186 -0
  198. package/dist/core-runtime/discovery/installation-paths.js +21 -0
  199. package/dist/core-runtime/discovery/installation-paths.test.js +65 -0
  200. package/dist/core-runtime/discovery/lens-registry.js +60 -0
  201. package/dist/core-runtime/discovery/lens-registry.test.js +81 -0
  202. package/dist/core-runtime/discovery/onto-home.js +71 -0
  203. package/dist/core-runtime/discovery/path-normalization.js +28 -0
  204. package/dist/core-runtime/discovery/path-normalization.test.js +22 -0
  205. package/dist/core-runtime/discovery/plugin-path.js +72 -0
  206. package/dist/core-runtime/discovery/plugin-path.test.js +95 -0
  207. package/dist/core-runtime/discovery/project-root.js +47 -0
  208. package/dist/core-runtime/discovery/settings-chain.js +353 -0
  209. package/dist/core-runtime/discovery/walk-up.js +17 -0
  210. package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.js +344 -0
  211. package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.test.js +915 -0
  212. package/dist/core-runtime/evolve/adapters/code-product/compile/compile.js +564 -0
  213. package/dist/core-runtime/evolve/adapters/code-product/compile/compile.test.js +708 -0
  214. package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.js +165 -0
  215. package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.test.js +227 -0
  216. package/dist/core-runtime/evolve/adapters/code-product/validators/validate.js +59 -0
  217. package/dist/core-runtime/evolve/adapters/code-product/validators/validate.test.js +205 -0
  218. package/dist/core-runtime/evolve/adapters/methodology/adapter.js +16 -0
  219. package/dist/core-runtime/evolve/adapters/methodology/adapter.test.js +9 -0
  220. package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.js +298 -0
  221. package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.test.js +70 -0
  222. package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.js +46 -0
  223. package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.test.js +73 -0
  224. package/dist/core-runtime/evolve/adapters/registry.js +47 -0
  225. package/dist/core-runtime/evolve/adapters/registry.test.js +67 -0
  226. package/dist/core-runtime/evolve/cli.js +256 -0
  227. package/dist/core-runtime/evolve/commands/align.js +194 -0
  228. package/dist/core-runtime/evolve/commands/align.test.js +82 -0
  229. package/dist/core-runtime/evolve/commands/apply.js +161 -0
  230. package/dist/core-runtime/evolve/commands/apply.test.js +138 -0
  231. package/dist/core-runtime/evolve/commands/close.js +39 -0
  232. package/dist/core-runtime/evolve/commands/close.test.js +99 -0
  233. package/dist/core-runtime/evolve/commands/defer.js +40 -0
  234. package/dist/core-runtime/evolve/commands/defer.test.js +134 -0
  235. package/dist/core-runtime/evolve/commands/draft.js +323 -0
  236. package/dist/core-runtime/evolve/commands/draft.test.js +178 -0
  237. package/dist/core-runtime/evolve/commands/e2e-evolve-full-cycle.test.js +208 -0
  238. package/dist/core-runtime/evolve/commands/error-messages.js +125 -0
  239. package/dist/core-runtime/evolve/commands/error-messages.test.js +167 -0
  240. package/dist/core-runtime/evolve/commands/propose-align.js +222 -0
  241. package/dist/core-runtime/evolve/commands/propose-align.test.js +136 -0
  242. package/dist/core-runtime/evolve/commands/reconstruct.js +330 -0
  243. package/dist/core-runtime/evolve/commands/reconstruct.test.js +278 -0
  244. package/dist/core-runtime/evolve/commands/shared.js +22 -0
  245. package/dist/core-runtime/evolve/commands/stale-check.js +103 -0
  246. package/dist/core-runtime/evolve/commands/stale-check.test.js +84 -0
  247. package/dist/core-runtime/evolve/commands/start.js +887 -0
  248. package/dist/core-runtime/evolve/commands/start.test.js +396 -0
  249. package/dist/core-runtime/evolve/config/project-config.js +99 -0
  250. package/dist/core-runtime/evolve/config/project-config.test.js +170 -0
  251. package/dist/core-runtime/evolve/renderers/align-packet.js +280 -0
  252. package/dist/core-runtime/evolve/renderers/align-packet.test.js +332 -0
  253. package/dist/core-runtime/evolve/renderers/draft-packet.js +303 -0
  254. package/dist/core-runtime/evolve/renderers/draft-packet.test.js +377 -0
  255. package/dist/core-runtime/evolve/renderers/format.js +5 -0
  256. package/dist/core-runtime/evolve/renderers/scope-md.js +237 -0
  257. package/dist/core-runtime/evolve/renderers/scope-md.test.js +306 -0
  258. package/dist/core-runtime/govern/cli.js +369 -0
  259. package/dist/core-runtime/govern/cli.test.js +314 -0
  260. package/dist/core-runtime/govern/drift-engine.js +103 -0
  261. package/dist/core-runtime/govern/drift-engine.test.js +319 -0
  262. package/dist/core-runtime/govern/promote-principle.js +206 -0
  263. package/dist/core-runtime/govern/promote-principle.test.js +368 -0
  264. package/dist/core-runtime/govern/queue.js +81 -0
  265. package/dist/core-runtime/govern/types.js +16 -0
  266. package/dist/core-runtime/install/cli.js +530 -0
  267. package/dist/core-runtime/install/detect.js +128 -0
  268. package/dist/core-runtime/install/detect.test.js +155 -0
  269. package/dist/core-runtime/install/gitignore-update.js +74 -0
  270. package/dist/core-runtime/install/gitignore-update.test.js +64 -0
  271. package/dist/core-runtime/install/install-integration.test.js +373 -0
  272. package/dist/core-runtime/install/prompts.js +389 -0
  273. package/dist/core-runtime/install/prompts.test.js +293 -0
  274. package/dist/core-runtime/install/types.js +26 -0
  275. package/dist/core-runtime/install/validation.js +295 -0
  276. package/dist/core-runtime/install/validation.test.js +313 -0
  277. package/dist/core-runtime/install/writer.js +254 -0
  278. package/dist/core-runtime/install/writer.test.js +218 -0
  279. package/dist/core-runtime/learning/extractor.js +461 -0
  280. package/dist/core-runtime/learning/feedback.js +179 -0
  281. package/dist/core-runtime/learning/health-report.js +165 -0
  282. package/dist/core-runtime/learning/health-report.test.js +169 -0
  283. package/dist/core-runtime/learning/loader.js +388 -0
  284. package/dist/core-runtime/learning/loader.test.js +102 -0
  285. package/dist/core-runtime/learning/promote/apply-state.js +240 -0
  286. package/dist/core-runtime/learning/promote/audit-obligation.js +195 -0
  287. package/dist/core-runtime/learning/promote/collector.js +432 -0
  288. package/dist/core-runtime/learning/promote/degraded-state.js +125 -0
  289. package/dist/core-runtime/learning/promote/domain-doc-proposer.js +166 -0
  290. package/dist/core-runtime/learning/promote/e2e-promote.test.js +6385 -0
  291. package/dist/core-runtime/learning/promote/health-snapshot.js +150 -0
  292. package/dist/core-runtime/learning/promote/insight-reclassifier.js +544 -0
  293. package/dist/core-runtime/learning/promote/judgment-auditor.js +517 -0
  294. package/dist/core-runtime/learning/promote/panel-reviewer.js +1158 -0
  295. package/dist/core-runtime/learning/promote/promote-executor.js +1675 -0
  296. package/dist/core-runtime/learning/promote/promoter.js +307 -0
  297. package/dist/core-runtime/learning/promote/retirement.js +122 -0
  298. package/dist/core-runtime/learning/promote/types.js +23 -0
  299. package/dist/core-runtime/learning/prompt-sections.js +51 -0
  300. package/dist/core-runtime/learning/shared/artifact-registry-init.js +45 -0
  301. package/dist/core-runtime/learning/shared/artifact-registry.js +254 -0
  302. package/dist/core-runtime/learning/shared/audit-obligation-kernel.js +73 -0
  303. package/dist/core-runtime/learning/shared/audit-state.js +99 -0
  304. package/dist/core-runtime/learning/shared/duplicate-check.js +28 -0
  305. package/dist/core-runtime/learning/shared/llm-caller.js +831 -0
  306. package/dist/core-runtime/learning/shared/llm-caller.test.js +601 -0
  307. package/dist/core-runtime/learning/shared/llm-tool-loop.js +393 -0
  308. package/dist/core-runtime/learning/shared/mode.js +25 -0
  309. package/dist/core-runtime/learning/shared/paths.js +84 -0
  310. package/dist/core-runtime/learning/shared/paths.test.js +79 -0
  311. package/dist/core-runtime/learning/shared/patterns.js +37 -0
  312. package/dist/core-runtime/learning/shared/recoverability.js +355 -0
  313. package/dist/core-runtime/learning/shared/recovery-context.js +374 -0
  314. package/dist/core-runtime/learning/shared/scope.js +1 -0
  315. package/dist/core-runtime/learning/shared/semantic-classifier.js +94 -0
  316. package/dist/core-runtime/learning/shared/specs/apply-execution-state-spec.js +42 -0
  317. package/dist/core-runtime/learning/shared/specs/audit-state-spec.js +37 -0
  318. package/dist/core-runtime/learning/shared/specs/backup-metadata-spec.js +39 -0
  319. package/dist/core-runtime/learning/shared/specs/emergency-log-spec.js +41 -0
  320. package/dist/core-runtime/learning/shared/specs/layout-version-spec.js +38 -0
  321. package/dist/core-runtime/learning/shared/specs/promote-decisions-spec.js +43 -0
  322. package/dist/core-runtime/learning/shared/specs/promote-report-spec.js +113 -0
  323. package/dist/core-runtime/learning/shared/specs/prune-log-spec.js +36 -0
  324. package/dist/core-runtime/learning/shared/specs/recovery-resolution-spec.js +48 -0
  325. package/dist/core-runtime/learning/shared/specs/restore-manifest-spec.js +43 -0
  326. package/dist/core-runtime/learning/shared/specs/spec-helpers.js +64 -0
  327. package/dist/core-runtime/learning/usage-tracker.js +190 -0
  328. package/dist/core-runtime/learning/usage-tracker.test.js +176 -0
  329. package/dist/core-runtime/llm/llm-caller.js +649 -0
  330. package/dist/core-runtime/llm/llm-tool-loop.js +401 -0
  331. package/dist/core-runtime/llm/model-switcher.js +62 -0
  332. package/dist/core-runtime/logger.js +22 -0
  333. package/dist/core-runtime/onboard/detect-review-axes.js +122 -0
  334. package/dist/core-runtime/onboard/detect-review-axes.test.js +127 -0
  335. package/dist/core-runtime/onboard/write-review-block.js +188 -0
  336. package/dist/core-runtime/onboard/write-review-block.test.js +240 -0
  337. package/dist/core-runtime/readers/brownfield-builder.js +150 -0
  338. package/dist/core-runtime/readers/brownfield-builder.test.js +136 -0
  339. package/dist/core-runtime/readers/code-chunk-collector.js +53 -0
  340. package/dist/core-runtime/readers/code-chunk-collector.test.js +136 -0
  341. package/dist/core-runtime/readers/file-utils.js +240 -0
  342. package/dist/core-runtime/readers/file-utils.test.js +146 -0
  343. package/dist/core-runtime/readers/lexicon-citation-check.js +93 -0
  344. package/dist/core-runtime/readers/lexicon-citation-check.test.js +77 -0
  345. package/dist/core-runtime/readers/mcp-figma.js +30 -0
  346. package/dist/core-runtime/readers/mcp-figma.test.js +82 -0
  347. package/dist/core-runtime/readers/mcp-generic.js +31 -0
  348. package/dist/core-runtime/readers/mcp-generic.test.js +76 -0
  349. package/dist/core-runtime/readers/ontology-index.js +148 -0
  350. package/dist/core-runtime/readers/ontology-index.test.js +245 -0
  351. package/dist/core-runtime/readers/ontology-query.js +168 -0
  352. package/dist/core-runtime/readers/ontology-query.test.js +311 -0
  353. package/dist/core-runtime/readers/ontology-resolve.js +48 -0
  354. package/dist/core-runtime/readers/ontology-resolve.test.js +48 -0
  355. package/dist/core-runtime/readers/patterns/index.js +7 -0
  356. package/dist/core-runtime/readers/review-log.js +213 -0
  357. package/dist/core-runtime/readers/review-log.test.js +313 -0
  358. package/dist/core-runtime/readers/scan-local.js +102 -0
  359. package/dist/core-runtime/readers/scan-local.test.js +102 -0
  360. package/dist/core-runtime/readers/scan-tarball.js +121 -0
  361. package/dist/core-runtime/readers/scan-tarball.test.js +283 -0
  362. package/dist/core-runtime/readers/scan-vault.js +34 -0
  363. package/dist/core-runtime/readers/scan-vault.test.js +81 -0
  364. package/dist/core-runtime/readers/types.js +42 -0
  365. package/dist/core-runtime/readers/types.test.js +94 -0
  366. package/dist/core-runtime/readers/viewpoint-collectors.js +229 -0
  367. package/dist/core-runtime/reconstruct/artifact-types.js +1 -0
  368. package/dist/core-runtime/reconstruct/directive-validation.js +123 -0
  369. package/dist/core-runtime/reconstruct/materialize-preparation.js +251 -0
  370. package/dist/core-runtime/reconstruct/record.js +198 -0
  371. package/dist/core-runtime/reconstruct/run.js +578 -0
  372. package/dist/core-runtime/reconstruct/seed-candidate-validation.js +356 -0
  373. package/dist/core-runtime/reconstruct/source-observations.js +62 -0
  374. package/dist/core-runtime/reconstruct/source-profiles.js +73 -0
  375. package/dist/core-runtime/release-channel/release-channel.js +90 -0
  376. package/dist/core-runtime/review/artifact-types.js +13 -0
  377. package/dist/core-runtime/review/citation-audit.js +204 -0
  378. package/dist/core-runtime/review/citation-audit.test.js +165 -0
  379. package/dist/core-runtime/review/controlled-lens-deliberation.js +125 -0
  380. package/dist/core-runtime/review/execution-plan-resolver.js +247 -0
  381. package/dist/core-runtime/review/execution-plan-resolver.test.js +243 -0
  382. package/dist/core-runtime/review/execution-topology-resolver-axis-first.test.js +246 -0
  383. package/dist/core-runtime/review/execution-topology-resolver.js +401 -0
  384. package/dist/core-runtime/review/execution-topology-resolver.test.js +315 -0
  385. package/dist/core-runtime/review/failure-records.js +57 -0
  386. package/dist/core-runtime/review/inline-context-embedder.js +141 -0
  387. package/dist/core-runtime/review/inline-context-embedder.test.js +154 -0
  388. package/dist/core-runtime/review/issue-artifact-runtime.js +859 -0
  389. package/dist/core-runtime/review/legacy-mode-policy.js +88 -0
  390. package/dist/core-runtime/review/lens-completion-policy.js +17 -0
  391. package/dist/core-runtime/review/materializers-effort-persist.test.js +79 -0
  392. package/dist/core-runtime/review/materializers.js +963 -0
  393. package/dist/core-runtime/review/ontology-path-classifier.js +179 -0
  394. package/dist/core-runtime/review/ontology-path-classifier.test.js +216 -0
  395. package/dist/core-runtime/review/packet-boundary-policy.js +215 -0
  396. package/dist/core-runtime/review/packet-boundary-policy.test.js +107 -0
  397. package/dist/core-runtime/review/participating-lens-paths.js +61 -0
  398. package/dist/core-runtime/review/participating-lens-paths.test.js +73 -0
  399. package/dist/core-runtime/review/review-artifact-utils.js +287 -0
  400. package/dist/core-runtime/review/review-config-legacy-translate.js +244 -0
  401. package/dist/core-runtime/review/review-config-legacy-translate.test.js +161 -0
  402. package/dist/core-runtime/review/review-config-validator.js +289 -0
  403. package/dist/core-runtime/review/review-config-validator.test.js +236 -0
  404. package/dist/core-runtime/review/review-execution-profile.js +193 -0
  405. package/dist/core-runtime/review/review-execution-route.js +52 -0
  406. package/dist/core-runtime/review/review-progress-contract.js +123 -0
  407. package/dist/core-runtime/review/review-record-validation.js +251 -0
  408. package/dist/core-runtime/review/review-result-classification.js +379 -0
  409. package/dist/core-runtime/review/review-state-machine.js +39 -0
  410. package/dist/core-runtime/review/route-visibility.js +125 -0
  411. package/dist/core-runtime/review/shape-pipeline-audit.test.js +311 -0
  412. package/dist/core-runtime/review/shape-to-topology-id.js +117 -0
  413. package/dist/core-runtime/review/shape-to-topology-id.test.js +132 -0
  414. package/dist/core-runtime/review/topology-shape-derivation.js +155 -0
  415. package/dist/core-runtime/review/topology-shape-derivation.test.js +195 -0
  416. package/dist/core-runtime/scope-runtime/constants.js +12 -0
  417. package/dist/core-runtime/scope-runtime/constraint-pool.js +166 -0
  418. package/dist/core-runtime/scope-runtime/constraint-pool.test.js +674 -0
  419. package/dist/core-runtime/scope-runtime/domain-validation-log.js +135 -0
  420. package/dist/core-runtime/scope-runtime/domain-validation-log.test.js +156 -0
  421. package/dist/core-runtime/scope-runtime/eval-persistence.js +65 -0
  422. package/dist/core-runtime/scope-runtime/eval-persistence.test.js +84 -0
  423. package/dist/core-runtime/scope-runtime/event-pipeline.js +64 -0
  424. package/dist/core-runtime/scope-runtime/event-pipeline.test.js +450 -0
  425. package/dist/core-runtime/scope-runtime/event-store.js +39 -0
  426. package/dist/core-runtime/scope-runtime/event-store.test.js +95 -0
  427. package/dist/core-runtime/scope-runtime/gate-guard.js +348 -0
  428. package/dist/core-runtime/scope-runtime/gate-guard.test.js +1047 -0
  429. package/dist/core-runtime/scope-runtime/hash.js +4 -0
  430. package/dist/core-runtime/scope-runtime/hash.test.js +33 -0
  431. package/dist/core-runtime/scope-runtime/id.js +4 -0
  432. package/dist/core-runtime/scope-runtime/id.test.js +17 -0
  433. package/dist/core-runtime/scope-runtime/reducer.js +297 -0
  434. package/dist/core-runtime/scope-runtime/reducer.test.js +759 -0
  435. package/dist/core-runtime/scope-runtime/scope-manager.js +161 -0
  436. package/dist/core-runtime/scope-runtime/state-machine.js +309 -0
  437. package/dist/core-runtime/scope-runtime/state-machine.test.js +704 -0
  438. package/dist/core-runtime/scope-runtime/types.js +116 -0
  439. package/dist/core-runtime/scope-runtime/types.test.js +69 -0
  440. package/dist/core-runtime/target-material-kind.js +256 -0
  441. package/dist/core-runtime/translate/render-for-user.js +169 -0
  442. package/dist/core-runtime/translate/render-for-user.test.js +122 -0
  443. package/dist/mcp/server.js +1011 -0
  444. package/dist/mcp/tool-schemas.js +93 -0
  445. package/dist/providers/capability-contract.js +1 -0
  446. package/package.json +68 -0
  447. package/settings.example.json +33 -0
@@ -0,0 +1,472 @@
1
+ ---
2
+ version: 2
3
+ last_updated: "2026-04-16"
4
+ source: manual
5
+ status: established
6
+ ---
7
+
8
+ # Visual Design Domain — Competency Questions
9
+
10
+ A list of core questions that this domain's system must be able to answer.
11
+ The pragmatics agent verifies the actual reasoning path for each question.
12
+
13
+ Classification axis: **Verification concern** — Classified by the concern that must be addressed during visual design system review. This axis aligns with domain_scope.md Key Sub-Areas + Cross-Cutting Concerns.
14
+
15
+ Question priority principles: **Visual system fundamentals (color system, typography, accessibility, token architecture) are the highest priority.** Consistency, brand governance, and motion refinement are secondary concerns applied on top of the visual foundation.
16
+
17
+ Priority levels:
18
+ - **P1** — Must be answerable in any visual design review. Failure indicates a fundamental visual system defect.
19
+ - **P2** — Should be answerable for production systems. Failure indicates a quality gap.
20
+ - **P3** — Recommended for mature systems. Failure indicates a refinement opportunity.
21
+
22
+ ## CQ ID System
23
+
24
+ ### Prefix Allocation
25
+
26
+ | Prefix | Concern Area | Aligned Sub-Area (domain_scope.md) |
27
+ |--------|-------------|-------------------------------------|
28
+ | CQ-VH | Visual Hierarchy and Composition | Cross-cutting: Typography + Color + Layout + Iconography |
29
+ | CQ-T | Typography | Typography |
30
+ | CQ-C | Color | Color |
31
+ | CQ-GL | Grid and Layout | Layout and Composition |
32
+ | CQ-II | Iconography and Imagery | Iconography and Imagery |
33
+ | CQ-DS | Design System | Design System |
34
+ | CQ-AC | Accessibility | Accessibility |
35
+ | CQ-BI | Brand Alignment | Brand Identity |
36
+ | CQ-MO | Motion and Animation | Motion and Animation |
37
+ | CQ-SOT | Source of Truth | Cross-cutting: Design System + Brand Identity |
38
+ | CQ-CO | Consistency | Cross-cutting: all sub-areas |
39
+
40
+ Prefix allocation protocol: New CQ sections use 1-3 character alphabetic prefix codes with mandatory `-` separator (e.g., CQ-XX-01). Prefixes must not be string prefixes of existing prefixes.
41
+
42
+ ### ME Rationale
43
+
44
+ Each prefix covers a mutually exclusive concern area. CQ-VH = how information importance is conveyed visually (cross-cutting). CQ-T = how text is displayed. CQ-C = how colors are selected and combined. CQ-GL = how elements are spatially arranged. CQ-II = how icons and images communicate. CQ-DS = how tokens and components are governed. CQ-AC = how diverse abilities are served visually. CQ-BI = how brand identity is maintained. CQ-MO = how motion conveys information. CQ-SOT = which standards govern decisions. CQ-CO = whether visual patterns are uniformly applied.
45
+
46
+ When a concern touches multiple areas, attribution follows the **primary enforcement point** (domain_scope.md §Cross-cutting Concern Attribution). Contrast ratio → CQ-AC (WCAG is the enforcement driver), not CQ-C.
47
+
48
+ ### CE Argument
49
+
50
+ The 11 prefixes cover all 8 sub-areas in domain_scope.md Key Sub-Areas plus 3 cross-cutting concerns (Visual Hierarchy, Source of Truth, Consistency). Visual Hierarchy is cross-cutting because it spans Typography, Color, Layout, and Iconography.
51
+
52
+ **Open-world note**: New sub-areas (e.g., 3D Design, Spatial UI) require new CQ prefixes.
53
+
54
+ ---
55
+
56
+ ## 1. Visual Hierarchy and Composition (CQ-VH)
57
+
58
+ Cross-cutting section — spans Typography, Color, Layout, and Iconography sub-areas. Verifies that information importance is clearly conveyed through visual means.
59
+
60
+ - **CQ-VH-01** [P1] Is the order of information importance clearly conveyed through visual means (size, color, contrast, position)?
61
+ - Inference path: logic_rules.md §Visual Hierarchy Logic → visual hierarchy through combination of means → concepts.md §Composition Principle Core Terms → Visual Hierarchy definition
62
+ - Verification criteria: PASS if a first-time viewer can identify the most important element within 3 seconds. FAIL if no clear visual priority — elements compete equally for attention
63
+
64
+ - **CQ-VH-02** [P1] Are at least 2 different visual means combined to establish each hierarchy level?
65
+ - Inference path: logic_rules.md §Visual Hierarchy Logic → single means = weak hierarchy → concepts.md §Visual Weight → size, saturation, contrast, complexity, isolation
66
+ - Verification criteria: PASS if each hierarchy level uses ≥2 combined means (e.g., larger + bolder, or brighter + positioned higher). FAIL if hierarchy relies on a single dimension (e.g., size alone)
67
+
68
+ - **CQ-VH-03** [P1] Are Gestalt principles (proximity, similarity, continuity, closure, figure-ground) consistently applied to group related elements?
69
+ - Inference path: concepts.md §Composition Principle Core Terms → Gestalt Principles → logic_rules.md §Grid and Spacing Logic → proximity principle enforcement
70
+ - Verification criteria: PASS if related elements are visually grouped and unrelated elements visually separated. FAIL if related elements have the same spacing as unrelated elements
71
+
72
+ - **CQ-VH-04** [P2] Is negative space intentionally designed, not incidentally left over?
73
+ - Inference path: concepts.md §Composition Principle Core Terms → Negative Space → active vs passive whitespace
74
+ - Verification criteria: PASS if whitespace serves clear purpose (breathing room, separation, emphasis). FAIL if whitespace distribution appears random or incidental
75
+
76
+ - **CQ-VH-05** [P2] Does the layout account for gaze movement patterns (F-pattern for text, Z-pattern for images)?
77
+ - Inference path: concepts.md §Composition Principle Core Terms → F-pattern/Z-pattern → logic_rules.md §Visual Hierarchy Logic → critical info along scan paths
78
+ - Verification criteria: PASS if most important content sits along natural scan path. FAIL if critical information is placed in areas users scan last
79
+
80
+ - **CQ-VH-06** [P2] Is the number of hierarchy levels within the perceivable range (3~5)?
81
+ - Inference path: logic_rules.md §Visual Hierarchy Logic → 3~5 levels perceivable → more levels make adjacent levels indistinguishable
82
+ - Verification criteria: PASS if hierarchy has 3~5 clearly distinguishable levels. FAIL if >5 levels that blur into each other or <3 levels (flat presentation)
83
+
84
+ - **CQ-VH-07** [P2] Do emphasized elements stay below ~30% of the viewport area?
85
+ - Inference path: logic_rules.md §Visual Hierarchy Logic → >30% emphasis = emphasis lost → emphasis works by contrast with non-emphasized
86
+ - Verification criteria: PASS if emphasis is selective and creates clear contrast. FAIL if most elements are visually "loud"
87
+
88
+ - **CQ-VH-08** [P3] Are CRAP principles (Contrast, Repetition, Alignment, Proximity) each explicitly applied?
89
+ - Inference path: concepts.md §Composition Principle Core Terms → CRAP Principles → Robin Williams (1994)
90
+ - Verification criteria: PASS if all 4 principles identifiable in the layout. FAIL if any principle is not addressed
91
+
92
+ ---
93
+
94
+ ## 2. Typography (CQ-T)
95
+
96
+ Verifies that the typography system supports readability, hierarchy, and visual rhythm.
97
+
98
+ - **CQ-T-01** [P1] Is the rationale for typeface selection documented (medium, content type, target users, licensing, language support)?
99
+ - Inference path: logic_rules.md §Typography Logic → typeface selection is functional, not sensory → concepts.md §Typography Core Terms → Typeface
100
+ - Verification criteria: PASS if selection rationale documented with constraints. FAIL if choice is undocumented or justified only by "it looks nice"
101
+
102
+ - **CQ-T-02** [P1] Is the type scale defined on a consistent ratio basis with named hierarchy levels?
103
+ - Inference path: logic_rules.md §Typography Logic → consistent ratio prevents arbitrary sizes → structure_spec.md §Token Layer Structure → type tokens → concepts.md §Typography Core Terms → Type Scale
104
+ - Verification criteria: PASS if ratio documented (e.g., 1.25), levels named (h1/h2/h3/body/caption), and all sizes derivable from ratio. FAIL if sizes are arbitrary
105
+
106
+ - **CQ-T-03** [P1] Do line-height values meet readability criteria (body 1.4~1.6×, heading 1.1~1.3×)?
107
+ - Inference path: logic_rules.md §Typography Logic → insufficient = collision, excessive = broken cohesion → concepts.md §Typography Core Terms → Line-height
108
+ - Verification criteria: PASS if body line-height 1.4~1.6× and heading 1.1~1.3×. FAIL if values outside range without documented justification
109
+
110
+ - **CQ-T-04** [P1] Is the measure within optimal readability range (45~75 chars English, 25~35 chars CJK)?
111
+ - Inference path: logic_rules.md §Typography Logic → long = hard to find next line, short = excessive breaks → dependency_rules.md §Typography–Layout Dependency → Measure → Grid Column Width
112
+ - Verification criteria: PASS if text blocks at each breakpoint fall within range. FAIL if any text block consistently exceeds/falls below range
113
+
114
+ - **CQ-T-05** [P2] Is the number of typefaces limited to 2~3?
115
+ - Inference path: logic_rules.md §Typography Logic → >3 causes visual clutter and consistency burden
116
+ - Verification criteria: PASS if 2~3 typefaces with clear role assignment. FAIL if >3 typefaces or roles overlap
117
+
118
+ - **CQ-T-06** [P2] Does typeface pairing follow the contrast principle (e.g., sans-serif + serif)?
119
+ - Inference path: logic_rules.md §Typography Logic → similar typefaces = awkward similarity → clear contrast needed
120
+ - Verification criteria: PASS if paired typefaces have clear visual contrast. FAIL if two similar typefaces (e.g., two geometric sans-serifs)
121
+
122
+ - **CQ-T-07** [P2] Are minimum text sizes enforced per context (body ≥16px, caption ≥12px)?
123
+ - Inference path: logic_rules.md §Typography Logic → below 12px, legibility degrades significantly
124
+ - Verification criteria: PASS if no text below 12px and body text ≥16px on screen. FAIL if text below minimum thresholds
125
+
126
+ - **CQ-T-08** [P2] Are letter-spacing adjustments defined per text role?
127
+ - Inference path: concepts.md §Typography Core Terms → Letter-spacing → logic_rules.md §Typography Logic → headings tighter, uppercase/small text wider
128
+ - Verification criteria: PASS if tracking varies appropriately by role. FAIL if uniform tracking everywhere including uppercase/small text
129
+
130
+ - **CQ-T-09** [P2] Is text alignment method chosen with rationale (left for body, center for short headings)?
131
+ - Inference path: logic_rules.md §Typography Logic → full justification on narrow columns causes river effect
132
+ - Verification criteria: PASS if alignment appropriate to context with documented rationale. FAIL if full justification on narrow columns
133
+
134
+ - **CQ-T-10** [P3] Is typeface fallback defined for multilingual environments? (when applicable)
135
+ - Inference path: concepts.md §Typography Core Terms → fallback stacks → dependency_rules.md §Typography–Layout Dependency → typeface change requires full re-verification
136
+ - Verification criteria: PASS if fallback chain defined with CJK/script-specific faces. FAIL if no fallback beyond generic family
137
+
138
+ - **CQ-T-11** [P3] Are variable font axes utilized when variable fonts are available? (when applicable)
139
+ - Inference path: concepts.md §Typography Core Terms → Variable Font → axes (wght, wdth, opsz) → optical sizing for small text
140
+ - Verification criteria: PASS if variable axes used for responsive type or optical sizing. FAIL if variable font loaded but only one static instance used
141
+
142
+ ---
143
+
144
+ ## 3. Color (CQ-C)
145
+
146
+ Verifies that the color system supports harmony, hierarchy, meaning, and accessibility.
147
+
148
+ - **CQ-C-01** [P1] Is a color palette defined with primary/secondary/accent/neutral roles distinguished?
149
+ - Inference path: structure_spec.md §Visual Design System Required Elements → Color System → logic_rules.md §Color Logic → basic composition
150
+ - Verification criteria: PASS if palette has named roles with clear usage rules. FAIL if colors selected ad-hoc without role system
151
+
152
+ - **CQ-C-02** [P1] Are semantic colors (success, error, warning, info) defined and separated from raw values?
153
+ - Inference path: concepts.md §Color Core Terms → Semantic Color → structure_spec.md §Token Layer Structure → semantic layer references primitive
154
+ - Verification criteria: PASS if semantic colors reference primitive tokens, not hardcoded values. FAIL if `error: #EF4444` instead of `error: red-500`
155
+
156
+ - **CQ-C-03** [P1] Do all text-background combinations meet WCAG AA contrast (4.5:1 normal, 3:1 large)?
157
+ - Inference path: logic_rules.md §Accessibility Logic → WCAG criteria → dependency_rules.md §Color–Accessibility Dependency → all combinations verified
158
+ - Verification criteria: PASS if all combinations documented with computed ratio. FAIL if any combination below threshold or unverified
159
+ <!-- derived-from: WCAG 2.2, SC 1.4.3 -->
160
+
161
+ - **CQ-C-04** [P1] Are supplementary means (icons, text, shape) provided alongside color for conveying meaning?
162
+ - Inference path: logic_rules.md §Accessibility Logic → color alone = WCAG 1.4.1 violation → dependency_rules.md §Color–Accessibility Dependency → Semantic Color → Supplementary Means
163
+ - Verification criteria: PASS if every color-based meaning has ≥1 non-color supplement. FAIL if any meaning conveyed by color alone
164
+ <!-- derived-from: WCAG 2.2, SC 1.4.1 -->
165
+
166
+ - **CQ-C-05** [P2] Does the color ratio approximate 60-30-10 (dominant/secondary/accent)?
167
+ - Inference path: logic_rules.md §Color Logic → accent 10% concentrated on action guidance → concepts.md §Color Core Terms → 60-30-10 Rule
168
+ - Verification criteria: PASS if dominant/secondary/accent proportions identifiable. FAIL if accent distributed widely or no clear proportion
169
+
170
+ - **CQ-C-06** [P2] Are high-saturation colors restricted to small areas (accents) with low saturation for large surfaces?
171
+ - Inference path: logic_rules.md §Color Logic → high saturation on large areas = eye fatigue
172
+ - Verification criteria: PASS if backgrounds use desaturated colors and only accents use high saturation. FAIL if large areas use high-saturation colors
173
+
174
+ - **CQ-C-07** [P2] Is color harmony based on identifiable color wheel relationships?
175
+ - Inference path: logic_rules.md §Color Logic → harmony from identifiable relationships → concepts.md §Color Core Terms → Color Wheel
176
+ - Verification criteria: PASS if palette colors have an identifiable relationship (complementary, analogous, triadic). FAIL if colors appear arbitrarily selected
177
+
178
+ - **CQ-C-08** [P2] Do UI components and graphical objects meet 3:1 contrast against adjacent colors?
179
+ - Inference path: logic_rules.md §Accessibility Logic → WCAG 1.4.11 → icons, borders, focus rings, form controls
180
+ - Verification criteria: PASS if all non-text UI elements meet 3:1. FAIL if icon/border on similar-tone background fails ratio
181
+ <!-- derived-from: WCAG 2.2, SC 1.4.11 -->
182
+
183
+ - **CQ-C-09** [P2] Is the palette tested against protanopia, deuteranopia, and tritanopia simulations?
184
+ - Inference path: logic_rules.md §Accessibility Logic → color blindness simulation required for semantic colors
185
+ - Verification criteria: PASS if simulations run and semantic colors remain distinguishable. FAIL if error/success indistinguishable under simulation
186
+
187
+ - **CQ-C-10** [P2] If dark mode exists, is it designed with separate semantic token mappings (not color inversion)?
188
+ - Inference path: dependency_rules.md §Color–Accessibility Dependency → Dark Mode Addition → logic_rules.md §Color Logic → dark mode ≠ inversion
189
+ - Verification criteria: PASS if dark mode has separate primitives, re-verified contrast, elevation model adapted. FAIL if colors are auto-inverted
190
+
191
+ - **CQ-C-11** [P3] Are colors specified in a defined color space (sRGB, Display P3)?
192
+ - Inference path: concepts.md §Color Core Terms → Color Space → cross-device consistency
193
+ - Verification criteria: PASS if color space documented and conversions defined. FAIL if hex-only with no space specification
194
+
195
+ - **CQ-C-12** [P3] Are tonal palettes perceptually even (using OKLCH or CIE LAB, not just sRGB math)?
196
+ - Inference path: logic_rules.md §Color Logic → perceptually even > mathematically even → concepts.md §Accessibility Core Terms → Perceptual Uniformity
197
+ - Verification criteria: PASS if lightness steps appear visually even. FAIL if palette has visible jumps or plateaus
198
+
199
+ ---
200
+
201
+ ## 4. Grid and Layout (CQ-GL)
202
+
203
+ Verifies that spatial organization supports alignment, rhythm, and responsive adaptation.
204
+
205
+ - **CQ-GL-01** [P1] Is a grid system (columns, gutters, margins) defined and consistently applied?
206
+ - Inference path: structure_spec.md §Visual Design System Required Elements → Layout System → concepts.md §Layout Core Terms → Grid System
207
+ - Verification criteria: PASS if grid documented with column count, gutter width, margin width per breakpoint. FAIL if no grid or elements placed arbitrarily
208
+
209
+ - **CQ-GL-02** [P1] Is a spacing system defined based on a consistent base unit (4px or 8px)?
210
+ - Inference path: logic_rules.md §Grid and Spacing Logic → consistent base unit required → structure_spec.md §Visual Design System Required Elements → Spacing System
211
+ - Verification criteria: PASS if base unit documented and all spacing values are multiples. FAIL if arbitrary spacing values used
212
+
213
+ - **CQ-GL-03** [P1] Are responsive breakpoints defined based on content (where layout breaks), not devices?
214
+ - Inference path: structure_spec.md §Responsive Structure → concepts.md §Layout Core Terms → Breakpoint → content-driven
215
+ - Verification criteria: PASS if breakpoints set where content needs to reflow. FAIL if breakpoints match only specific device widths
216
+
217
+ - **CQ-GL-04** [P2] Is gutter width less than margin width?
218
+ - Inference path: logic_rules.md §Grid and Spacing Logic → gutter > margin inverts visual structure
219
+ - Verification criteria: PASS if gutter < margin at every breakpoint. FAIL if gutter ≥ margin
220
+
221
+ - **CQ-GL-05** [P2] Are spacing values restricted to the defined spatial system (no off-scale values)?
222
+ - Inference path: logic_rules.md §Grid and Spacing Logic → arbitrary values destroy visual rhythm → structure_spec.md §Isolated Node Prohibition → off-scale spacing
223
+ - Verification criteria: PASS if all spacing values in the system. FAIL if values outside the scale (e.g., 15px, 23px)
224
+
225
+ - **CQ-GL-06** [P2] Is the Gestalt proximity principle applied — related elements closer than unrelated?
226
+ - Inference path: logic_rules.md §Grid and Spacing Logic → inter-group ≥ 2× intra-group recommended
227
+ - Verification criteria: PASS if spacing ratios clearly distinguish groups. FAIL if related and unrelated elements have similar spacing
228
+
229
+ - **CQ-GL-07** [P2] Does content reflow properly at 200% text enlargement without clipping?
230
+ - Inference path: structure_spec.md §Responsive Structure → WCAG 1.4.10 → no horizontal scrolling for vertical text
231
+ - Verification criteria: PASS if content reflows with no horizontal scroll at 200%. FAIL if content clipped or horizontal scrollbar appears
232
+ <!-- derived-from: WCAG 2.2, SC 1.4.10 -->
233
+
234
+ - **CQ-GL-08** [P2] Are max-width constraints defined to prevent content from stretching beyond readable measure?
235
+ - Inference path: logic_rules.md §Grid and Spacing Logic → max-width prevents 200+ char lines on wide screens
236
+ - Verification criteria: PASS if content area has max-width (1200~1440px) and text blocks have max-width (680~720px). FAIL if text stretches full-width on wide monitors
237
+
238
+ - **CQ-GL-09** [P3] Is a baseline grid defined to maintain vertical rhythm?
239
+ - Inference path: concepts.md §Layout Core Terms → Baseline Grid → all vertical spacing aligns to multiples of body line-height
240
+ - Verification criteria: PASS if vertical spacing aligns to baseline. FAIL if no baseline grid defined
241
+
242
+ ---
243
+
244
+ ## 5. Iconography and Imagery (CQ-II)
245
+
246
+ Verifies that icons and images communicate clearly, consistently, and accessibly.
247
+
248
+ - **CQ-II-01** [P1] Is the icon style (outline/filled/duotone) unified across the system?
249
+ - Inference path: logic_rules.md §Icon and Image Logic → mixing styles = visual noise → structure_spec.md §Visual Design System Required Elements → Icon System
250
+ - Verification criteria: PASS if one consistent style throughout. FAIL if styles mixed without documented semantic distinction
251
+
252
+ - **CQ-II-02** [P1] Are icon meanings used consistently (same icon = same meaning everywhere)?
253
+ - Inference path: logic_rules.md §Icon and Image Logic → meaning mapping is permanent → structure_spec.md §Isolated Node Prohibition → icon meaning collision
254
+ - Verification criteria: PASS if each icon maps to exactly one meaning. FAIL if same icon means different things on different screens
255
+
256
+ - **CQ-II-03** [P1] Are icons accompanied by text labels so meaning is not conveyed by icon alone?
257
+ - Inference path: logic_rules.md §Accessibility Logic → icons must not be sole information carrier → WCAG 1.4.1 principle extended
258
+ - Verification criteria: PASS if every icon has text label, tooltip, or aria-label. FAIL if icon-only navigation or action without any text
259
+
260
+ - **CQ-II-04** [P2] Is an icon size system defined (e.g., 16/20/24/32px) with usage context per size?
261
+ - Inference path: logic_rules.md §Icon and Image Logic → defined scale with usage context → structure_spec.md §Visual Design System Required Elements
262
+ - Verification criteria: PASS if sizes defined with context (16px=inline, 24px=button). FAIL if arbitrary icon sizes used
263
+
264
+ - **CQ-II-05** [P2] Do icons meet 3:1 contrast against their background (WCAG 1.4.11)?
265
+ - Inference path: logic_rules.md §Accessibility Logic → UI components 3:1 → applies to icons
266
+ - Verification criteria: PASS if all icons meet 3:1 contrast. FAIL if icons on similar-tone backgrounds fail
267
+ <!-- derived-from: WCAG 2.2, SC 1.4.11 -->
268
+
269
+ - **CQ-II-06** [P2] Are icons designed on a consistent grid (keyline grid with uniform stroke and padding)?
270
+ - Inference path: logic_rules.md §Icon and Image Logic → grid-based design → optical alignment may adjust 1~2px
271
+ - Verification criteria: PASS if grid documented and icons follow it. FAIL if icons appear visually inconsistent in size/weight
272
+
273
+ - **CQ-II-07** [P3] Are image aspect ratios consistent within the same context?
274
+ - Inference path: logic_rules.md §Icon and Image Logic → mixed ratios in same context = chaotic
275
+ - Verification criteria: PASS if one ratio per context (e.g., all product cards 4:3). FAIL if mixed ratios in a grid
276
+
277
+ ---
278
+
279
+ ## 6. Design System (CQ-DS)
280
+
281
+ Verifies that tokens and components are structured, governed, and consistently applied.
282
+
283
+ - **CQ-DS-01** [P1] Are design tokens defined with primitive/semantic/component layers distinguished?
284
+ - Inference path: structure_spec.md §Token Layer Structure → 3 layers, unidirectional reference → concepts.md §Design System Core Terms → Design Token
285
+ - Verification criteria: PASS if 3 layers exist with clear naming convention. FAIL if flat token structure or missing semantic layer
286
+
287
+ - **CQ-DS-02** [P1] Do component tokens reference semantic tokens (not primitives directly)?
288
+ - Inference path: dependency_rules.md §Token–Component Dependency → primitive bypass = meaning layer violation → structure_spec.md §Isolated Node Prohibition → layer bypass
289
+ - Verification criteria: PASS if all component tokens trace to semantic tokens. FAIL if any component token references a primitive directly
290
+
291
+ - **CQ-DS-03** [P1] Are visual specifications defined per interactive state (default/hover/active/focus/disabled)?
292
+ - Inference path: structure_spec.md §State System → 5 minimum states → dependency_rules.md §Component–State Dependency → all states required
293
+ - Verification criteria: PASS if ≥5 states visually specified per interactive component. FAIL if any interactive component has <5 states
294
+
295
+ - **CQ-DS-04** [P2] Are component variants defined with usage criteria?
296
+ - Inference path: structure_spec.md §Visual Design System Required Elements → Variant Definitions → logic_rules.md §Component Logic → manageable range
297
+ - Verification criteria: PASS if variants documented with when-to-use criteria. FAIL if variants exist without selection guidance
298
+
299
+ - **CQ-DS-05** [P2] Is a Figma↔code synchronization method defined with frequency and tolerance?
300
+ - Inference path: dependency_rules.md §Design Tool–Code Dependency → bidirectional sync → frequency and acceptable discrepancy documented
301
+ - Verification criteria: PASS if sync frequency, token pipeline, and acceptable discrepancy defined. FAIL if no sync process
302
+
303
+ - **CQ-DS-06** [P2] Are token naming conventions consistent (e.g., `{category}-{property}-{variant}-{state}`)?
304
+ - Inference path: structure_spec.md §Token Layer Structure → naming convention per layer
305
+ - Verification criteria: PASS if naming follows documented pattern consistently. FAIL if naming is inconsistent or undocumented
306
+
307
+ - **CQ-DS-07** [P2] Is design system governance defined (add/change/deprecation)? (scale-dependent: 2+ teams)
308
+ - Inference path: domain_scope.md §Key Sub-Areas → Governance (scale-dependent) → concepts.md §Design System Core Terms → Governance
309
+ - Verification criteria: PASS if process documented and enforced. FAIL if no process or ad-hoc additions without review
310
+
311
+ - **CQ-DS-08** [P3] Are tokens managed in a tool-independent format (JSON/YAML)?
312
+ - Inference path: extension_cases.md §Case 7 → tool migration → tokens in tool-agnostic format
313
+ - Verification criteria: PASS if tokens in JSON/YAML with build pipeline. FAIL if tokens only in Figma with no export
314
+
315
+ - **CQ-DS-09** [P3] Is the design system maturity level identified and appropriate?
316
+ - Inference path: concepts.md §Design System Core Terms → Design System Maturity → L1 style guide → L4 infrastructure
317
+ - Verification criteria: PASS if maturity level identified and roadmap exists. FAIL if maturity not assessed
318
+
319
+ ---
320
+
321
+ ## 7. Accessibility (CQ-AC)
322
+
323
+ Verifies that the visual system serves users of diverse visual abilities.
324
+
325
+ - **CQ-AC-01** [P1] Is WCAG 2.2 AA explicitly stated as the applicable standard?
326
+ - Inference path: domain_scope.md §Reference Standards/Frameworks → WCAG version SSOT → domain_scope.md §Normative System Classification → Tier-1a
327
+ - Verification criteria: PASS if standard version explicitly stated. FAIL if "WCAG" without version or no standard stated
328
+
329
+ - **CQ-AC-02** [P1] Does the focus indicator provide sufficient visibility (≥2px, ≥3:1 contrast)?
330
+ - Inference path: logic_rules.md §Accessibility Logic → focus indicator requirements → structure_spec.md §State System → Focus state
331
+ - Verification criteria: PASS if focus indicator ≥2px solid with ≥3:1 contrast on all backgrounds. FAIL if outline:none without alternative or insufficient contrast
332
+ <!-- derived-from: WCAG 2.2, SC 2.4.7, 2.4.11 -->
333
+
334
+ - **CQ-AC-03** [P1] Is prefers-reduced-motion supported for all non-essential motion?
335
+ - Inference path: logic_rules.md §Motion Logic → replace with instant transition, not remove → concepts.md §Accessibility Core Terms → prefers-reduced-motion
336
+ - Verification criteria: PASS if all non-essential motion has reduced-motion alternative. FAIL if animations play regardless of system setting
337
+
338
+ - **CQ-AC-04** [P1] Is there no content that flashes more than 3 times per second?
339
+ - Inference path: logic_rules.md §Motion Logic → WCAG 2.3.1 absolute prohibition → seizure risk
340
+ - Verification criteria: PASS if no flashing content. FAIL if any element flashes >3/sec (GIFs, loaders, video)
341
+ <!-- derived-from: WCAG 2.2, SC 2.3.1 -->
342
+
343
+ - **CQ-AC-05** [P2] Is content readable and functional at 200% text enlargement?
344
+ - Inference path: structure_spec.md §Responsive Structure → WCAG 1.4.4 → no clipping, no horizontal scroll
345
+ - Verification criteria: PASS if content reflows and remains functional at 200%. FAIL if text clipped or functionality lost
346
+ <!-- derived-from: WCAG 2.2, SC 1.4.4 -->
347
+
348
+ - **CQ-AC-06** [P2] Do all non-text UI elements meet 3:1 contrast (WCAG 1.4.11)?
349
+ - Inference path: logic_rules.md §Accessibility Logic → icons, borders, focus rings, form controls → 3:1 minimum
350
+ - Verification criteria: PASS if all UI elements meet 3:1. FAIL if any element below threshold
351
+
352
+ - **CQ-AC-07** [P2] Is color blindness accommodation verified via simulation?
353
+ - Inference path: logic_rules.md §Accessibility Logic → protanopia, deuteranopia, tritanopia simulations
354
+ - Verification criteria: PASS if all semantic colors distinguishable under all 3 simulations. FAIL if any pair indistinguishable
355
+
356
+ - **CQ-AC-08** [P3] When reduced motion is active, are state changes still communicated (instant transition, not removal)?
357
+ - Inference path: logic_rules.md §Motion Logic → instant transition replaces animation → state change must still be visible
358
+ - Verification criteria: PASS if state changes visible without motion. FAIL if reduced-motion removes all visual feedback
359
+
360
+ ---
361
+
362
+ ## 8. Brand Alignment (CQ-BI)
363
+
364
+ Verifies that visual elements maintain brand identity consistently.
365
+
366
+ - **CQ-BI-01** [P1] Are visual elements (colors, typefaces, image style) consistent with the brand tone and manner?
367
+ - Inference path: logic_rules.md §Brand Alignment Logic → tone constrains visual choices → dependency_rules.md §Brand–Visual System Dependency
368
+ - Verification criteria: PASS if visual choices align with documented tone. FAIL if visual elements contradict the stated brand personality
369
+
370
+ - **CQ-BI-02** [P1] Are logo usage rules (minimum size, clear space, prohibited modifications) defined and followed?
371
+ - Inference path: concepts.md §Brand Identity Core Terms → Logo, Clear Space → logic_rules.md §Brand Alignment Logic → clear space never violated
372
+ - Verification criteria: PASS if logo rules documented and consistently followed. FAIL if logo encroached, distorted, or below minimum size
373
+
374
+ - **CQ-BI-03** [P2] Are brand colors applied through the design token system (not hardcoded)?
375
+ - Inference path: logic_rules.md §Brand Alignment Logic → brand through token system → dependency_rules.md §Brand–Visual System Dependency
376
+ - Verification criteria: PASS if brand colors are tokens that propagate through the system. FAIL if brand colors hardcoded in individual components
377
+
378
+ - **CQ-BI-04** [P2] When brand colors conflict with accessibility, is accessibility prioritized with adjustment documented?
379
+ - Inference path: logic_rules.md §Constraint Conflict Checks → Accessibility vs Brand Identity → accessibility prevails
380
+ - Verification criteria: PASS if accessibility met with documented brand adjustment. FAIL if contrast sacrificed for brand
381
+
382
+ - **CQ-BI-05** [P3] Are brand application rules defined per medium (digital/print/environmental)? (when applicable)
383
+ - Inference path: domain_scope.md §Key Sub-Areas → Brand Identity → Medium-Specific Application
384
+ - Verification criteria: PASS if per-medium rules exist. FAIL if single set of rules applied across all media
385
+
386
+ - **CQ-BI-06** [P3] Is co-branding visual hierarchy defined? (when applicable)
387
+ - Inference path: concepts.md §Brand Identity Core Terms → Co-branding → logic_rules.md §Brand Alignment Logic
388
+ - Verification criteria: PASS if relative size, placement, clear space rules defined. FAIL if co-branding ad-hoc
389
+
390
+ ---
391
+
392
+ ## 9. Motion and Animation (CQ-MO)
393
+
394
+ Verifies that motion conveys information, respects accessibility, and follows a consistent system.
395
+
396
+ - **CQ-MO-01** [P2] Is the purpose of each animation (feedback/transition/guidance) stated?
397
+ - Inference path: logic_rules.md §Motion Logic → motion is information, not decoration → concepts.md §Motion Core Terms
398
+ - Verification criteria: PASS if each animation has stated purpose. FAIL if any animation exists without information purpose
399
+
400
+ - **CQ-MO-02** [P2] Is an easing curve system defined (ease-out for entrance, ease-in for exit)?
401
+ - Inference path: logic_rules.md §Motion Logic → standard easing assignments → concepts.md §Motion Core Terms → Easing
402
+ - Verification criteria: PASS if easing assignments documented per motion type. FAIL if easing is arbitrary or uniform linear
403
+
404
+ - **CQ-MO-03** [P2] Is a duration system defined with ranges by complexity (100~200ms micro, 200~400ms transitions)?
405
+ - Inference path: logic_rules.md §Motion Logic → duration proportional to complexity → concepts.md §Motion Core Terms → Duration
406
+ - Verification criteria: PASS if duration ranges defined and applied. FAIL if durations are arbitrary or >700ms for UI
407
+
408
+ - **CQ-MO-04** [P2] Are simultaneous animations limited to 2?
409
+ - Inference path: logic_rules.md §Motion Logic → >2 simultaneous = cognitive overload → stagger 30~50ms
410
+ - Verification criteria: PASS if ≤2 simultaneous animations. FAIL if >2 simultaneous without stagger
411
+
412
+ - **CQ-MO-05** [P3] Are motion semantics consistent (expansion = reveal, slide-in = new context)?
413
+ - Inference path: concepts.md §Motion Core Terms → Motion Semantics → logic_rules.md §Motion Logic → consistent semantics
414
+ - Verification criteria: PASS if same motion type conveys same meaning throughout. FAIL if expansion means "reveal" on one screen and "error" on another
415
+
416
+ ---
417
+
418
+ ## 10. Source of Truth (CQ-SOT)
419
+
420
+ Cross-cutting section. Verifies that authoritative standards for visual decisions are designated and followed.
421
+
422
+ - **CQ-SOT-01** [P1] Is an authoritative standard for visual design decisions designated?
423
+ - Inference path: dependency_rules.md §Source of Truth Management → design system documentation = SoT → not Figma, not code
424
+ - Verification criteria: PASS if SoT explicitly designated. FAIL if no designated authority or ambiguous authority
425
+
426
+ - **CQ-SOT-02** [P1] Is the conflict resolution priority defined (Accessibility > Platform > Design System > Heuristics)?
427
+ - Inference path: dependency_rules.md §Source of Truth Management → Conflict Resolution Priority → domain_scope.md §Normative System Classification
428
+ - Verification criteria: PASS if priority documented and consistently applied. FAIL if conflicts resolved ad-hoc
429
+
430
+ - **CQ-SOT-03** [P2] Is design tool vs code precedence defined for discrepancy resolution?
431
+ - Inference path: dependency_rules.md §Design Tool–Code Dependency → Discrepancy Resolution → documentation is SoT
432
+ - Verification criteria: PASS if resolution process documented. FAIL if discrepancies left unresolved or resolved inconsistently
433
+
434
+ - **CQ-SOT-04** [P2] Are external standard versions explicitly specified (e.g., "WCAG 2.2" not "WCAG")?
435
+ - Inference path: domain_scope.md §Reference Standards/Frameworks → version SSOT table
436
+ - Verification criteria: PASS if all external standards include version. FAIL if version omitted
437
+
438
+ ---
439
+
440
+ ## 11. Consistency (CQ-CO)
441
+
442
+ Cross-cutting section — spans all sub-areas. Verifies that visual patterns are uniformly applied.
443
+
444
+ - **CQ-CO-01** [P1] Is the same visual expression applied for the same meaning across the product?
445
+ - Inference path: domain_scope.md §Cross-Cutting Concerns → Visual Consistency → logic_rules.md §Constraint Conflict Checks → same function = same expression
446
+ - Verification criteria: PASS if visual patterns are uniform for identical concepts. FAIL if same concept has different visual treatment on different screens
447
+
448
+ - **CQ-CO-02** [P1] Are all token values used consistently — no hardcoded values bypassing the token system?
449
+ - Inference path: structure_spec.md §Isolated Node Prohibition → hardcoded values bypass tokens → dependency_rules.md §Token–Component Dependency
450
+ - Verification criteria: PASS if all visual properties reference tokens. FAIL if hardcoded values found in component specs
451
+
452
+ - **CQ-CO-03** [P2] Are intentional visual deviations documented with rationale?
453
+ - Inference path: logic_rules.md §Constraint Conflict Checks → Consistency vs Contextual Appropriateness → deviation must be documented
454
+ - Verification criteria: PASS if every deviation has documented reason. FAIL if deviations exist without rationale
455
+
456
+ - **CQ-CO-04** [P2] Is the design system consistent with platform guidelines where applicable?
457
+ - Inference path: domain_scope.md §Normative System Classification → Tier-1b platform standards → dependency_rules.md §Source of Truth Management
458
+ - Verification criteria: PASS if platform conventions followed for system elements. FAIL if platform conventions violated without documentation
459
+
460
+ - **CQ-CO-05** [P3] Are visual specs consistent between design tool and code implementation?
461
+ - Inference path: dependency_rules.md §Design Tool–Code Dependency → Discrepancy Resolution → within defined tolerance
462
+ - Verification criteria: PASS if Figma and code values match within tolerance. FAIL if divergence detected
463
+
464
+ ---
465
+
466
+ ## Related Documents
467
+ - domain_scope.md — Sub-area to CQ section mapping, normative tier classification, cross-cutting concerns
468
+ - logic_rules.md — Rules providing inference paths for CQ answers
469
+ - structure_spec.md — Structural requirements providing inference paths
470
+ - dependency_rules.md — Dependency rules providing inference paths
471
+ - concepts.md — Term definitions referenced in questions
472
+ - extension_cases.md — Extension scenarios referenced in CQ-BI and CQ-DS