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,231 @@
1
+ ---
2
+ version: 2
3
+ last_updated: "2026-04-16"
4
+ source: manual
5
+ status: established
6
+ ---
7
+
8
+ # Market Intelligence Domain — Domain Scope Definition
9
+
10
+ This is the reference document used by coverage to identify "what should exist but is missing" in market intelligence systems.
11
+ This domain applies when **reviewing** market intelligence systems — data collection, analysis, strategy derivation, and risk assessment for strategic decision-making.
12
+
13
+ > **Boundary with business domain**: The business domain covers business model design, value proposition, organizational strategy. This domain covers the intelligence inputs that inform business strategy — market data, competitor analysis, risk assessment. Strategy formulation is business; strategy candidate generation from market analysis is here.
14
+
15
+ > **Boundary with finance domain**: The finance domain covers financial reporting and analytical metrics derived from financial statements. This domain covers market-side analysis — competitor financial position as competitive intelligence, market sizing using public data. Internal financial analysis belongs to finance; competitive intelligence using public financial data belongs here.
16
+
17
+ ## Domain Definition
18
+
19
+ Market Intelligence is a system that supports strategic decision-making through the collection, analysis, and interpretation of market data.
20
+ This domain consists of the following four **independent areas**.
21
+
22
+ | Area | Definition | Basis for Independence |
23
+ |------|-----------|----------------------|
24
+ | Collection | Acquisition of market data, source management, credibility classification | Collection quality determines the upper bound for subsequent analysis |
25
+ | Analysis | Pattern identification, quantitative and qualitative interpretation of collected data | Analysis methodologies evolve independently of collection |
26
+ | Strategy Derivation | Conversion of analysis results into strategy options | Strategy is a separate judgment domain, not a derivative of analysis |
27
+ | Risk Assessment | Identification, quantification, and response design for market risks | **An independent area, not an appendage of strategy design** |
28
+
29
+ ### Independence of Risk Assessment
30
+
31
+ Risk assessment is performed in parallel with strategy derivation and is not subordinate to strategy. Risk assessment results can modify strategy, but risk assessment remains independently valid even without a strategy.
32
+
33
+ This independence is enforced by:
34
+ - Separate organizational ownership (risk team vs strategy team)
35
+ - Separate input sources (risk has its own collection paths)
36
+ - Veto authority (risk assessment can block strategy execution)
37
+ - Independent reporting line (risk reports to board, not strategy)
38
+
39
+ ## Classification Axes
40
+
41
+ | Axis | Values | Description |
42
+ |---|---|---|
43
+ | Source type | Primary / Secondary / Tertiary | Data origin classification |
44
+ | Collection method | Manual / Automated / Crawled / API | How data is acquired |
45
+ | Analysis type | Quantitative / Qualitative / Mixed | Analysis methodology |
46
+ | Strategic horizon | Short-term (<1Y) / Medium-term (1-3Y) / Long-term (>3Y) | Strategy time scope |
47
+ | Risk type | Market / Operational / Strategic / Compliance / Reputational | Risk category |
48
+
49
+ ## Key Sub-Areas
50
+
51
+ Classification axis: **Market intelligence concern** — Classified by the concern that the intelligence system must address.
52
+
53
+ Applicability markers:
54
+ - **(required)**: Must be addressed in any market intelligence system review
55
+ - **(when applicable)**: Address when the system's scope includes the relevant pattern
56
+ - **(scale-dependent)**: Becomes required beyond a scale threshold
57
+
58
+ ### Data Collection
59
+ - **Source classification** (required): Credibility rating system, source registration, classification criteria
60
+ - **Collection policy** (required): Frequency, targets, methods declaration
61
+ - **Data freshness** (required): Time-to-live (TTL) per source, expiration handling
62
+ - **Raw data normalization** (required): Format unification, schema mapping, deduplication
63
+ - **Real-time monitoring** (when applicable): Streaming data ingestion, event-driven triggers
64
+ - **OSINT collection** (when applicable): Open-source intelligence methodology, ethical and legal boundaries
65
+
66
+ ### Analysis
67
+ - **Competitive landscape analysis** (required): Competitors identification, capability assessment, strategic positioning
68
+ - **Market size estimation** (required): TAM (Total Addressable Market), SAM (Serviceable Addressable Market), SOM (Serviceable Obtainable Market)
69
+ - **Customer segmentation** (required): Segment definition, classification criteria (MECE), segment characterization
70
+ - **Trend identification** (required): Time-series analysis, signal vs noise distinction, leading indicators
71
+ - **Industry framework analysis** (when applicable): Porter's Five Forces, PESTEL, SWOT, value chain analysis
72
+ - **Quantitative modeling** (when applicable): Statistical models, ML-based prediction, simulation
73
+ - **Sentiment analysis** (when applicable): Social media sentiment, news sentiment, brand perception
74
+
75
+ ### Strategy Derivation
76
+ - **Strategy option generation** (required): Option creation from analysis, divergent thinking phase
77
+ - **Option evaluation matrix** (required): Multi-criteria evaluation (impact, feasibility, cost, time)
78
+ - **Priority determination** (required): Quantitative scoring, ranking logic
79
+ - **Decision gate criteria** (required): Pass conditions for execution approval
80
+ - **Scenario planning** (when applicable): Multiple future scenarios, contingency strategies
81
+ - **Option portfolio management** (when applicable): Strategy portfolio balance (core/adjacent/transformational)
82
+
83
+ ### Risk Assessment
84
+ - **Risk identification** (required): Risk inventory, taxonomy, source identification
85
+ - **Risk quantification** (required): Impact × Likelihood scoring, risk score calculation
86
+ - **Risk response strategy** (required): Avoidance, mitigation, acceptance, transfer (per ISO 31000)
87
+ - **Risk monitoring** (required): Frequency definition, threshold alerts, escalation paths
88
+ - **Risk appetite definition** (when applicable): Organizational risk tolerance levels per category
89
+ - **Stress testing** (when applicable): Extreme scenario simulation, sensitivity analysis
90
+
91
+ ## Normative System Classification
92
+
93
+ Standards governing market intelligence operate at three tiers (no hard regulatory tier — this is judgment-driven).
94
+
95
+ | Tier | Name | Enforcement Mechanism | Change Velocity | Examples |
96
+ |------|------|----------------------|-----------------|---------|
97
+ | Tier-1 | Methodology Frameworks | Industry adoption, professional convention | Slow (years) | ISO 31000 Risk Management, Porter's Five Forces, SWOT/TOWS |
98
+ | Tier-2 | Organizational Standards | Internal review, audit | Medium (annual) | Internal credibility rating system, internal decision gate criteria, risk appetite statement |
99
+ | Tier-3 | Project Practices | Per-project decision | Fast (per project) | Specific competitor list, segment definitions for current quarter, ad-hoc analysis approach |
100
+
101
+ **Ordering principle**: Tier-1 > Tier-2 > Tier-3. Methodology frameworks override organizational standards; organizational standards override project practices.
102
+
103
+ Tier classification decision tree:
104
+ 1. **Tier-1**: Is this rule from an industry methodology (ISO 31000, Porter, PESTEL, SWOT)? Would deviation require explicit justification?
105
+ 2. **Tier-2**: If not Tier-1, is this rule from organizational policy (risk appetite, internal credibility rating system)?
106
+ 3. **Tier-3**: If neither, is this a project-level decision (competitor list, segment criteria for the current analysis)?
107
+
108
+ ## Cross-Cutting Concerns
109
+
110
+ ### Source Credibility Propagation
111
+
112
+ Spans Data Collection, Analysis, Strategy Derivation, Risk Assessment. Credibility is established at collection and propagates through the entire chain.
113
+
114
+ - Credibility rating system: logic_rules.md §Data Source Credibility Rating Consistency Rules
115
+ - Propagation principle (weakest link): logic_rules.md §Credibility Propagation Rules
116
+ - Cross-area consistency: logic_rules.md §ST01-ST03 multi-point matching
117
+
118
+ ### Declaration-Implementation Link
119
+
120
+ Spans Strategy Derivation and Decision Gates. Every declared rule must have implemented verification logic.
121
+
122
+ - Decision gate rule: logic_rules.md §Decision Gate Declaration-Implementation Link Rules
123
+ - Verification logic mandatory: PG01-PG03
124
+ - Audit trail for declarations and implementations
125
+
126
+ ### Multi-Domain Coexistence
127
+
128
+ The market intelligence domain can be applied in parallel with other domains (e.g., technology, healthcare, finance) within the same project.
129
+
130
+ - Namespace prefixes: `{domain}::{concept}` notation
131
+ - Homonym resolution: concepts.md §Cross-Domain Homonyms
132
+ - Independent decision gates per domain
133
+
134
+ ## Required Concept Categories
135
+
136
+ | Category | Description | Risk if Missing | Example of Failure |
137
+ |---|---|---|---|
138
+ | Source credibility rating | Classification system for data source reliability | Untrusted data treated as authoritative | Blog post used as basis for strategic decision |
139
+ | Collection policy | Declaration of frequency, targets, methods | Uncoordinated collection, gaps and duplicates | Same source crawled by 3 teams; missing critical sources |
140
+ | Data freshness | Time-validity of collected data | Stale data used as current | 2-year-old market sizing used for current strategy |
141
+ | Competitive landscape | Structured competitor analysis | Strategic blind spots | Major competitor missed; strategy attacks weak target |
142
+ | Market size estimation | TAM/SAM/SOM quantification | Unrealistic strategy scope | SaaS company plans for 10x revenue without TAM check |
143
+ | Customer segmentation | MECE customer grouping | Mass-market approach to differentiated needs | Single product strategy fails segments with different requirements |
144
+ | Trend signal | Directional pattern in time series | Reactive instead of proactive strategy | Industry shift detected after revenue decline begins |
145
+ | Strategy option | Actionable strategy candidate | No alternatives, single-track risk | Single strategic bet without backup plans |
146
+ | Decision gate | Verification point for strategy approval | Strategies execute without governance | Risky strategy executed without risk review |
147
+ | Risk factor | Identified market/operational/strategic risk | Unmanaged risk exposure | Foreign exchange risk realizes; no hedging strategy in place |
148
+ | Risk score | Quantified risk impact × likelihood | Subjective risk prioritization | High-impact rare risks ignored due to low frequency |
149
+ | Risk response | Strategy for handling identified risk | Risk identified but not addressed | Risk register exists but no mitigation plans |
150
+
151
+ ## Reference Standards/Frameworks
152
+
153
+ This file is the **single source of truth for external standard version information** within the market-intelligence domain.
154
+
155
+ | Standard | Version | Application Area | Core Content |
156
+ |----------|---------|-----------------|--------------|
157
+ | ISO 31000 | 2018 | Risk Assessment | Risk management framework: identification, analysis, evaluation, treatment, monitoring |
158
+ | Porter's Five Forces | 1979 (Porter) | Analysis (industry structure) | 5 competitive forces: rivalry, supplier power, buyer power, substitute threat, new entrant threat |
159
+ | PESTEL | — | Analysis, Risk Assessment (macro environment) | 6 macro factors: Political, Economic, Social, Technological, Environmental, Legal |
160
+ | SWOT / TOWS | — | Strategy Derivation | Internal (Strengths/Weaknesses) × External (Opportunities/Threats) matrix |
161
+ | OSINT Framework | Open-Source Intelligence framework | Data Collection | Open-source intelligence collection methodology and tools taxonomy |
162
+ | Value Chain (Porter) | 1985 (Porter) | Analysis (internal) | Primary activities + support activities decomposition for competitive advantage |
163
+ | Blue Ocean Strategy | 2005 (Kim & Mauborgne) | Strategy Derivation | Uncontested market space creation framework |
164
+ | BCG Matrix | 1970 (Henderson) | Strategy Derivation (portfolio) | Market growth × Market share matrix (Star/Cash Cow/Question Mark/Dog) |
165
+ | Scenario Planning | — | Strategy Derivation | Multiple future scenarios for contingency planning |
166
+ | TAM/SAM/SOM | — | Market Size Estimation | Total/Serviceable Addressable/Serviceable Obtainable Market |
167
+
168
+ ## Bias Detection Criteria
169
+
170
+ ### Coverage Distribution
171
+
172
+ - If 2 or more of the 4 areas are not represented at all → **insufficient coverage**
173
+ - If specific area accounts for >70% of total findings → **area bias**
174
+ - If risk assessment is treated as subordinate to strategy → **independence violation**
175
+
176
+ ### Source Quality
177
+
178
+ - If collection policy is undefined or undocumented → **collection rigor absence**
179
+ - If credibility rating is not assigned to all sources → **credibility gap**
180
+ - If only one source type (e.g., only secondary) is used → **source diversity gap**
181
+
182
+ ### Analysis Completeness
183
+
184
+ - If competitive landscape addresses only direct competitors (no substitutes, new entrants) → **narrow competitive view**
185
+ - If market size uses only TAM without SAM/SOM → **unrealistic sizing**
186
+ - If only quantitative or only qualitative analysis is used → **methodology imbalance**
187
+
188
+ ### Strategy and Risk
189
+
190
+ - If strategy options have no traceability to analysis → **strategy without basis**
191
+ - If decision gate conditions are declared without verification logic → **declaration-implementation gap**
192
+ - If risk identification covers only one risk type (e.g., only market risk) → **risk type narrow**
193
+ - If risk responses are not defined for all identified risks → **response gap**
194
+
195
+ ## Inter-Document Contract
196
+
197
+ ### Rule Ownership
198
+
199
+ | Cross-cutting Topic | Owner File | Other Files |
200
+ |---|---|---|
201
+ | Data source credibility rating consistency | logic_rules.md §Data Source Credibility Rating Consistency Rules | structure_spec.md (references) |
202
+ | Decision gate declaration-implementation link | logic_rules.md §Decision Gate Declaration-Implementation Link Rules | dependency_rules.md (references) |
203
+ | Risk independence | logic_rules.md §Risk Assessment Rules | dependency_rules.md §Inter-Area Dependency Structure |
204
+ | Concept definitions and homonyms | concepts.md | All other files reference, do not redefine |
205
+ | Source of Truth priority | dependency_rules.md §Source Credibility Propagation | logic_rules.md (references) |
206
+ | Structural requirements | structure_spec.md §Entity Type Definitions, §Trait Definitions | Other files reference |
207
+ | Conciseness criteria | conciseness_rules.md | Other files reference |
208
+ | Competency questions | competency_qs.md | Other files provide inference path targets |
209
+
210
+ ### Sub-area to CQ Section Mapping
211
+
212
+ | Sub-area | CQ Sections | Coverage |
213
+ |---|---|---|
214
+ | Data Collection | CQ-DC | Full |
215
+ | Analysis | CQ-AN | Full |
216
+ | Strategy Derivation | CQ-SD | Full |
217
+ | Risk Assessment | CQ-RA | Full |
218
+
219
+ Cross-cutting CQ sections:
220
+ - CQ-CR (Credibility Propagation) — spans all 4 areas
221
+ - CQ-DI (Declaration-Implementation Link) — spans Strategy Derivation
222
+ - CQ-MD (Multi-Domain Coexistence) — spans all 4 areas
223
+
224
+ ## Related Documents
225
+ - concepts.md — Term definitions and interpretation principles
226
+ - competency_qs.md — System verification questions
227
+ - logic_rules.md — Logic rules and data credibility consistency
228
+ - structure_spec.md — Structural requirements and classification axes
229
+ - dependency_rules.md — Inter-element dependency relationships
230
+ - extension_cases.md — Extension scenarios
231
+ - conciseness_rules.md — Allowed/prohibited redundancy patterns
@@ -0,0 +1,425 @@
1
+ ---
2
+ version: 2
3
+ last_updated: "2026-04-16"
4
+ source: manual
5
+ status: established
6
+ ---
7
+
8
+ # Market Intelligence Domain — Extension Scenarios
9
+
10
+ Classification axis: **Change trigger** — cases classified by the type of change that triggers system evolution. Cases cover growth triggers (Cases 1–8) and shrinkage/simplification triggers (Cases 9–10).
11
+
12
+ The evolution agent simulates each scenario to verify whether the existing market intelligence system breaks.
13
+
14
+ ---
15
+
16
+ ## Case 1: Adding a New Data Source Type
17
+
18
+ ### Situation
19
+
20
+ A new data source type not covered by the existing credibility rating system emerges. Examples: AI-generated reports, social media real-time sentiment data, blockchain on-chain analytics, satellite imagery, IoT sensor data.
21
+
22
+ ### Case Study: AI-Generated Report Integration
23
+
24
+ A market intelligence team began incorporating AI-generated industry reports (e.g., from large language models analyzing public data). Existing credibility rating system has Primary/Secondary/Tertiary, but AI-generated content fits none cleanly:
25
+ - Not Primary (not direct observation)
26
+ - Not Secondary (not human-authored intermediary processing)
27
+ - Not Tertiary (not summary of secondary)
28
+
29
+ Team added a new rating "AI-Generated" with credibility downgrade applied. Required updates across collection policy, decision gates, analysis pipeline.
30
+
31
+ ### Impact Analysis
32
+
33
+ | Principle | Impact |
34
+ |---|---|
35
+ | Credibility rating set | New value added to allowed set |
36
+ | Multi-point matching (ST01-ST02) | Must update at all 3 reference points simultaneously |
37
+ | Credibility propagation (TP01) | New rating's relative position determined |
38
+ | Pipeline ingestion | New source type recognition |
39
+
40
+ ### Verification Checklist
41
+
42
+ - [ ] Has new value been added to credibility rating allowed set? → logic_rules.md §2.1
43
+ - [ ] Following multi-point matching rule, has it been **simultaneously** updated at collection/policy/analysis? → logic_rules.md §ST01-ST02
44
+ - [ ] Are credibility propagation rules defined for the new rating? → dependency_rules.md §4.2
45
+ - [ ] Has competency_qs.md CQ-DC-01 been re-executed to verify consistency? → competency_qs.md
46
+ - [ ] Is the new value validly handled in all entity types declared as application targets? → structure_spec.md §3.1
47
+
48
+ ### Affected Files
49
+
50
+ | File | Impact | Section |
51
+ |---|---|---|
52
+ | logic_rules.md | Modify | §2 Allowed Set Definition |
53
+ | dependency_rules.md | Verify | §Credibility Propagation Rules |
54
+ | structure_spec.md | Verify | §Trait Definitions (Source Credibility Rating) |
55
+ | concepts.md | Modify | §Source Classification Terms |
56
+
57
+ ---
58
+
59
+ ## Case 2: Adding Decision Gate Conditions
60
+
61
+ ### Situation
62
+
63
+ New pass conditions added to decision gate due to new regulations, compliance requirements, internal policies, or risk events.
64
+
65
+ ### Case Study: ESG Compliance Gate Addition
66
+
67
+ After ESG regulations affecting strategic decisions, the team added "ESG impact assessment" as a pass condition for all major strategy options. Required:
68
+ - New condition declaration at decision gate
69
+ - Implementation of ESG assessment verification logic
70
+ - Review of all in-progress strategy options
71
+
72
+ ### Impact Analysis
73
+
74
+ | Principle | Impact |
75
+ |---|---|
76
+ | Pass condition count | Increased |
77
+ | Verification logic | Must be created simultaneously |
78
+ | Existing strategies | May need re-validation |
79
+ | Declaration-implementation gap | Must avoid creating new gap |
80
+
81
+ ### Verification Checklist
82
+
83
+ - [ ] Has new condition been added to decision gate's pass condition list? → structure_spec.md §2.3 Pass Condition
84
+ - [ ] Following declaration-implementation link rule, has corresponding verification logic been **immediately** created? → logic_rules.md §PG02
85
+ - [ ] Have existing strategy options whose gate status changes been identified? → dependency_rules.md §3 AC02
86
+ - [ ] Have existing passed strategies been re-evaluated against new condition? → competency_qs.md CQ-SD-04
87
+
88
+ ### Affected Files
89
+
90
+ | File | Impact | Section |
91
+ |---|---|---|
92
+ | logic_rules.md | Verify | §3 Decision Gate Declaration-Implementation Link Rules |
93
+ | structure_spec.md | Modify | §2.3 Pass Condition entity instances |
94
+ | competency_qs.md | Verify | CQ-SD section, CQ-DI section |
95
+
96
+ ---
97
+
98
+ ## Case 3: Risk Assessment Framework Replacement
99
+
100
+ ### Situation
101
+
102
+ Switching from current framework to a different framework (e.g., from ISO 31000 to COSO ERM, or to NIST RMF for cybersecurity-heavy contexts).
103
+
104
+ ### Case Study: ISO 31000 → NIST CSF Transition
105
+
106
+ A company expanding into critical infrastructure adopted NIST Cybersecurity Framework alongside ISO 31000. Required:
107
+ - Risk score calculation formula reconciliation
108
+ - Risk taxonomy mapping
109
+ - Risk Independence preservation across both frameworks
110
+
111
+ ### Impact Analysis
112
+
113
+ | Principle | Impact |
114
+ |---|---|
115
+ | Risk score formula | May change (e.g., qualitative ratings vs numeric) |
116
+ | Risk type taxonomy | Reclassification needed |
117
+ | Risk independence | Must be preserved regardless of framework |
118
+ | Existing risk register | Migration needed |
119
+
120
+ ### Verification Checklist
121
+
122
+ - [ ] Is risk score calculation formula updated in logic_rules.md? → logic_rules.md §RA01
123
+ - [ ] Have risk level trait allowed values been updated? → structure_spec.md §3 Trait Definitions
124
+ - [ ] Is risk assessment **independence** maintained regardless of framework change? → logic_rules.md §RA03, §5.2
125
+ - [ ] Have existing risk factor scores been recalculated using new formula? → concepts.md §Risk Quantification Terms
126
+ - [ ] Are framework references updated in domain_scope.md? → domain_scope.md §Reference Standards/Frameworks
127
+
128
+ ### Affected Files
129
+
130
+ | File | Impact | Section |
131
+ |---|---|---|
132
+ | logic_rules.md | Modify | §5 Risk Assessment Rules |
133
+ | structure_spec.md | Modify | §3 Risk-related traits |
134
+ | domain_scope.md | Modify | §Reference Standards |
135
+ | concepts.md | Modify | §Risk Identification/Quantification/Response Terms |
136
+
137
+ ---
138
+
139
+ ## Case 4: Multi-Domain Simultaneous Analysis
140
+
141
+ ### Situation
142
+
143
+ Applying market intelligence domain alongside another domain in a single project (e.g., market intelligence + technology trend analysis + regulatory compliance domain).
144
+
145
+ ### Case Study: MI + Technology + Compliance
146
+
147
+ A pharmaceutical company set up an integrated intelligence system combining:
148
+ - Market intelligence (commercial market analysis)
149
+ - Technology intelligence (R&D and patent landscape)
150
+ - Compliance intelligence (regulatory environment)
151
+
152
+ Naming conflicts: "Risk", "Trend", "Segment" — different meanings per domain.
153
+
154
+ ### Impact Analysis
155
+
156
+ | Principle | Impact |
157
+ |---|---|
158
+ | Namespace prefixes | Required across all entities and traits |
159
+ | Homonym registration | All conflicting terms documented |
160
+ | Cross-domain references | `{domain}::{concept}` format mandatory |
161
+ | Decision gates | Each domain operates independent gates |
162
+
163
+ ### Verification Checklist
164
+
165
+ - [ ] Have domain namespace prefixes been applied to all entities and traits? → structure_spec.md §5.4
166
+ - [ ] Have conflicting terms been registered in concepts.md homonym table? → concepts.md §5
167
+ - [ ] Are cross-domain references using `{domain}::{concept}` format? → domain_scope.md §Multi-Domain Coexistence
168
+ - [ ] If inter-domain dependencies arise, are multi-domain rules from dependency_rules.md applied? → dependency_rules.md §6
169
+ - [ ] Do decision gates for each domain operate independently? → dependency_rules.md §MD03
170
+
171
+ ### Affected Files
172
+
173
+ | File | Impact | Section |
174
+ |---|---|---|
175
+ | concepts.md | Modify | §5 Cross-Domain Homonyms |
176
+ | dependency_rules.md | Verify | §6 Multi-Domain Dependency Rules |
177
+ | structure_spec.md | Verify | §5.4 Multi-Domain Namespace |
178
+
179
+ ---
180
+
181
+ ## Case 5: Adding Real-Time Monitoring
182
+
183
+ ### Situation
184
+
185
+ Extending from batch analysis to real-time monitoring (live market data, social sentiment streams, automated alerts on threshold breach).
186
+
187
+ ### Case Study: Social Sentiment Real-Time Pipeline
188
+
189
+ Existing batch analysis updated daily. New real-time stream integration:
190
+ - Twitter/X API + Reddit firehose
191
+ - Detection latency < 5 minutes
192
+ - Auto-alert on negative sentiment spikes
193
+ - Risk threshold-triggered alerts
194
+
195
+ ### Impact Analysis
196
+
197
+ | Principle | Impact |
198
+ |---|---|
199
+ | Collection method trait | New value: "streaming" |
200
+ | Freshness criteria | Stricter TTL for real-time |
201
+ | Trend signal detection | Latency attribute added |
202
+ | Risk alert path | Threshold-triggered automation |
203
+ | Multi-point credibility matching | Applies in real-time too |
204
+
205
+ ### Verification Checklist
206
+
207
+ - [ ] Has collection method trait been added to raw data (batch/streaming/event-driven)? → structure_spec.md §3 Trait Definitions
208
+ - [ ] Have freshness rating criteria been adjusted for real-time data? → logic_rules.md §6 Data Freshness Rules
209
+ - [ ] Has detection latency attribute been added to trend signals? → structure_spec.md §2.2 Trend Signal
210
+ - [ ] Has alert path that **immediately** triggers when risk thresholds exceeded been designed? → logic_rules.md §RA02
211
+ - [ ] Do multi-point credibility rating matching rules apply equally in real-time environment? → logic_rules.md §ST01-ST02
212
+
213
+ ### Affected Files
214
+
215
+ | File | Impact | Section |
216
+ |---|---|---|
217
+ | structure_spec.md | Modify | §3 Traits, §2.1 Collection entity attributes |
218
+ | logic_rules.md | Modify | §6 Data Freshness Rules, §RA02 |
219
+ | concepts.md | Modify | §Collection Method Terms (Streaming Ingestion) |
220
+
221
+ ---
222
+
223
+ ## Case 6: Classification Axis Refinement
224
+
225
+ ### Situation
226
+
227
+ Adding a third classification axis to existing 2-axis (entity type, trait) system. Example: "Analysis perspective" — analyzing the same market entity from technical, financial, regulatory perspectives.
228
+
229
+ ### Impact Analysis
230
+
231
+ | Principle | Impact |
232
+ |---|---|
233
+ | Classification dimensionality | 2 → 3 axes |
234
+ | Orthogonality | New axis must be orthogonal to existing two |
235
+ | Axis mixing prohibition | Applies to new axis as well |
236
+ | Backward compatibility | Existing entities may need new axis assignment |
237
+
238
+ ### Verification Checklist
239
+
240
+ - [ ] Is new classification axis explicitly declared in structure_spec.md? → structure_spec.md §3
241
+ - [ ] Is new axis orthogonal to existing entity type axis and trait axis? → concepts.md §6.1
242
+ - [ ] Does axis mixing prohibition principle apply to new axis as well? → concepts.md §6.1
243
+ - [ ] Has classification axis separation principle been updated in concepts.md? → concepts.md §6.1
244
+ - [ ] Is new axis value needed for all existing entities? → structure_spec.md §6.1
245
+
246
+ ### Affected Files
247
+
248
+ | File | Impact | Section |
249
+ |---|---|---|
250
+ | structure_spec.md | Modify | §3 (add new axis), §6 Classification Criteria Design |
251
+ | concepts.md | Modify | §6.1 Classification Axis Separation |
252
+
253
+ ---
254
+
255
+ ## Case 7: Quantitative Analysis Model Integration
256
+
257
+ ### Situation
258
+
259
+ Integrating quantitative models (statistics, ML, forecasting) for market size estimation, competitive simulation, sentiment analysis, etc.
260
+
261
+ ### Case Study: Forecasting Model Integration
262
+
263
+ Team integrated time-series forecasting model (ARIMA + LSTM) for market size projection. Required:
264
+ - New entity type: Analysis Model
265
+ - Model output credibility rating logic
266
+ - Model preconditions documentation
267
+ - Decision gate integration
268
+
269
+ ### Impact Analysis
270
+
271
+ | Principle | Impact |
272
+ |---|---|
273
+ | New entity type | Analysis Model entity added |
274
+ | New relationship | Model Application: model → market/competitor/segment |
275
+ | Model output credibility | Determined by input data + model verification status |
276
+ | Decision gate integration | Model output as verification logic |
277
+
278
+ ### Verification Checklist
279
+
280
+ - [ ] Has new entity type "Analysis Model" been added (model name, preconditions, input/output definitions)? → structure_spec.md §2.2
281
+ - [ ] Has new relationship type "Model Application" been added (analysis model → market/competitor/segment)? → structure_spec.md §4.1
282
+ - [ ] Is model output credibility determined by input data credibility AND model verification status? → logic_rules.md §7 Credibility Propagation Rules
283
+ - [ ] If model is used as verification logic at decision gate, does it comply with declaration-implementation link rule? → logic_rules.md §PG01
284
+
285
+ ### Affected Files
286
+
287
+ | File | Impact | Section |
288
+ |---|---|---|
289
+ | structure_spec.md | Modify | §2.2 (add Analysis Model entity), §4.1 (add Model Application relationship) |
290
+ | logic_rules.md | Modify | §7 Credibility Propagation Rules |
291
+ | concepts.md | Modify | §Methodology Terms (Quantitative modeling) |
292
+
293
+ ---
294
+
295
+ ## Case 8: Geographic Scope Expansion
296
+
297
+ ### Situation
298
+
299
+ Expanding analysis from single-country/region to multi-country/global scope.
300
+
301
+ ### Case Study: APAC Expansion
302
+
303
+ Team expanded from Korea-only market intelligence to APAC (Korea, Japan, China, SEA). Required:
304
+ - Geographic dimension added
305
+ - Source credibility variations by jurisdiction
306
+ - Risk taxonomy expanded for cross-border risks
307
+ - Cultural/regulatory framework differences
308
+
309
+ ### Impact Analysis
310
+
311
+ | Principle | Impact |
312
+ |---|---|
313
+ | Market entity scope | Geographic attribute added |
314
+ | Source credibility | May vary by jurisdiction (e.g., government statistics quality varies) |
315
+ | Risk taxonomy | Foreign exchange, geopolitical risks added |
316
+ | Compliance | Multi-jurisdictional regulatory analysis |
317
+
318
+ ### Verification Checklist
319
+
320
+ - [ ] Has geographic dimension been added to market and competitor entities? → structure_spec.md §2.2
321
+ - [ ] Are source credibility ratings adjusted per jurisdiction? → concepts.md §Source Classification Terms
322
+ - [ ] Has risk taxonomy been expanded for cross-border risks? → concepts.md §Risk Identification Terms
323
+ - [ ] Are jurisdiction-specific regulatory frameworks incorporated? → domain_scope.md §Reference Standards
324
+
325
+ ### Affected Files
326
+
327
+ | File | Impact | Section |
328
+ |---|---|---|
329
+ | structure_spec.md | Modify | §2.2 Market entity attributes |
330
+ | concepts.md | Modify | §Risk Identification Terms |
331
+ | domain_scope.md | Modify | §Reference Standards |
332
+
333
+ ---
334
+
335
+ ## Case 9: Source Decommissioning
336
+
337
+ ### Situation (Shrinkage)
338
+
339
+ A previously trusted data source is decommissioned (vendor stops publishing, source becomes paywalled beyond budget, source becomes unreliable).
340
+
341
+ ### Impact Analysis
342
+
343
+ | Principle | Impact |
344
+ |---|---|
345
+ | Source registry | Decommission with effective date |
346
+ | Historical data | Preserved but marked as no-longer-updating |
347
+ | Analysis dependencies | Identify analyses dependent on decommissioned source |
348
+ | Replacement | Identify alternative sources or accept analytical gap |
349
+
350
+ ### Verification Checklist
351
+
352
+ - [ ] Is source decommission documented with effective date? → structure_spec.md §2.1
353
+ - [ ] Are dependent analyses identified and re-validated? → dependency_rules.md §7.2
354
+ - [ ] Are alternative sources identified or analytical gaps documented? → concepts.md §Source Classification Terms
355
+ - [ ] Are dependent strategy options re-evaluated for credibility? → logic_rules.md §TP03
356
+
357
+ ---
358
+
359
+ ## Case 10: Methodology Deprecation
360
+
361
+ ### Situation (Shrinkage)
362
+
363
+ A methodology is deprecated (e.g., a framework is shown to have systematic biases; a model is invalidated by new evidence).
364
+
365
+ ### Impact Analysis
366
+
367
+ | Principle | Impact |
368
+ |---|---|
369
+ | Methodology registry | Mark as deprecated |
370
+ | Analysis outputs | Mark outputs from deprecated methodology |
371
+ | Re-analysis | Determine if affected analyses need re-execution |
372
+ | Documentation | Document deprecation reason for institutional memory |
373
+
374
+ ### Verification Checklist
375
+
376
+ - [ ] Is methodology marked as deprecated? → concepts.md §Methodology Terms
377
+ - [ ] Are analysis outputs from deprecated methodology marked? → structure_spec.md §2.2 Analysis Output
378
+ - [ ] Have affected analyses been re-evaluated? → competency_qs.md CQ-AN-04
379
+ - [ ] Has deprecation reason been documented? → extension_cases.md (this file, future cases)
380
+
381
+ ---
382
+
383
+ ## Common Checklist for All Extensions
384
+
385
+ Confirm the following items in all extension scenarios:
386
+
387
+ - [ ] Is multi-point credibility rating matching maintained? (logic_rules.md §ST01-ST05)
388
+ - [ ] Has no declaration-implementation gap occurred at decision gates? (logic_rules.md §PG01-PG05)
389
+ - [ ] Are entity type and trait classification axes not mixed? (concepts.md §6.1)
390
+ - [ ] Does the cross-verification of trait application targets and value sets pass? (structure_spec.md §3.1)
391
+ - [ ] Is the independence of risk assessment maintained? (domain_scope.md §Independence of Risk Assessment, logic_rules.md §RA03)
392
+ - [ ] Are there no multi-domain namespace collisions? (structure_spec.md §5.4)
393
+ - [ ] Has no circular dependency occurred? (dependency_rules.md §3)
394
+ - [ ] Do the relevant questions in competency_qs.md pass when re-executed?
395
+
396
+ ---
397
+
398
+ ## Scenario Interconnections
399
+
400
+ | Scenario | Triggers / Interacts With | Reason |
401
+ |---|---|---|
402
+ | Case 1 (New Source Type) | → Case 5 (Real-Time Monitoring) | New source types often involve real-time data |
403
+ | Case 2 (Decision Gate Condition) | → Case 7 (Quantitative Model) | New conditions often need automated verification via models |
404
+ | Case 3 (Risk Framework) | → Case 8 (Geographic Expansion) | International expansion may require different risk frameworks |
405
+ | Case 4 (Multi-Domain) | → Case 6 (Classification Axis) | Multi-domain may reveal need for additional classification dimensions |
406
+ | Case 5 (Real-Time) | → Case 7 (Quantitative Model) | Real-time data often paired with ML models |
407
+ | Case 6 (Classification Axis) | → Case 4 (Multi-Domain) | Refined classification supports multi-domain coexistence |
408
+ | Case 7 (Quantitative Model) | → Case 2 (Decision Gate) | Models become verification logic for gates |
409
+ | Case 8 (Geographic Expansion) | → Case 1 (New Source Type) | New geographies require new source types |
410
+ | Case 9 (Source Decommissioning) | → Case 1 (New Source Type) | Often triggers search for replacement |
411
+ | Case 10 (Methodology Deprecation) | → Case 7 (Quantitative Model) | Replacement methodology may be a new model |
412
+
413
+ ---
414
+
415
+ ## Related Documents
416
+
417
+ | Document | Reference Reason |
418
+ |----------|-----------------|
419
+ | [domain_scope.md](domain_scope.md) | Domain definition, independence principles, multi-domain principles |
420
+ | [concepts.md](concepts.md) | Terms, homonyms, classification axis principles |
421
+ | [competency_qs.md](competency_qs.md) | Post-extension verification questions |
422
+ | [logic_rules.md](logic_rules.md) | Credibility rating consistency, decision gate rules |
423
+ | [structure_spec.md](structure_spec.md) | Entity/trait/relationship structure |
424
+ | [dependency_rules.md](dependency_rules.md) | Dependency and impact relationship rules |
425
+ | [conciseness_rules.md](conciseness_rules.md) | Allowed/prohibited redundancy patterns |