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,135 @@
1
+ ---
2
+ version: 2
3
+ last_updated: "2026-03-31"
4
+ source: manual
5
+ status: established
6
+ ---
7
+
8
+ # Conciseness Rules (business)
9
+
10
+ This document defines the business-domain rules used by conciseness.
11
+ It controls where repetition is necessary, where it becomes harmful, and which thresholds should trigger consolidation review.
12
+
13
+ ## 1. Allowed Redundancy
14
+
15
+ Each rule is tagged with a severity level:
16
+ - **[MUST-ALLOW]**: Removing the redundancy would break inference, traceability, or execution.
17
+ - **[MAY-ALLOW]**: The redundancy may remain when it serves a clearly different review purpose.
18
+
19
+ ### Performance and Measurement
20
+
21
+ - [MUST-ALLOW] Leading and lagging indicators for the same objective appearing together. Removing either side breaks the causal interpretation of performance.
22
+ - [MUST-ALLOW] Balanced Scorecard perspectives referring to the same KPI from different lenses. The perspectives are not duplicates because they support different judgments.
23
+ - [MAY-ALLOW] The same metric appearing in `concepts.md §Benchmark Registry` and a CQ verification criterion, as long as the CQ cites the registry rather than redefining the number.
24
+
25
+ ### Strategy and Operating Translation
26
+
27
+ - [MUST-ALLOW] A strategic claim in `domain_scope.md` and the operating consequence in `logic_rules.md` or `structure_spec.md`. These are not duplicates because one declares scope and the other declares behavior.
28
+ - [MAY-ALLOW] A revenue model appearing in both strategic and operational contexts when the strategic version explains choice and the operational version explains delivery mechanics.
29
+ - [MAY-ALLOW] The same case being referenced in both `extension_cases.md` and another file, provided only one file is the detailed owner and the others use it as a compressed anchor.
30
+
31
+ ### Source of Truth and Reference Copies
32
+
33
+ - [MUST-ALLOW] An internal reference to an external authority such as a legal rule, accounting output, or benchmark source. Without the reference copy, the business domain loses reviewability.
34
+ - [MUST-ALLOW] A benchmark value in `concepts.md §Benchmark Registry` and a qualitative interpretation of that benchmark in `logic_rules.md`. Numeric authority and business interpretation are different functions.
35
+ - [MAY-ALLOW] The same stakeholder appearing under governance and ESG if one reference concerns control ownership and the other concerns impact ownership.
36
+
37
+ ### Modern Business Patterns
38
+
39
+ - [MUST-ALLOW] A platform metric in both platform logic and governance analysis when the first explains economics and the second explains participant fairness or enforcement.
40
+ - [MUST-ALLOW] Subscription metrics in both finance and customer-management contexts when one explains unit economics and the other explains retention operations.
41
+ - [MUST-ALLOW] AI concepts appearing in economic and governance contexts when one explains value capture and the other explains control obligations.
42
+
43
+ ## 2. Removal Target Patterns
44
+
45
+ Each rule is tagged with a severity level:
46
+ - **[MUST-REMOVE]**: The duplication itself creates wrong inferences or conflicting authority.
47
+ - **[SHOULD-REMOVE]**: The duplication adds complexity without adding a distinct review function.
48
+
49
+ ### Relation Redundancy
50
+
51
+ - [MUST-REMOVE] Multiple causal chains that express the same business rule with no extra decision value. If both can change independently but should not, one should be removed.
52
+ - [MUST-REMOVE] A subordinate tactic restated as if it were an independent strategy when it is already entailed by the superior strategic choice.
53
+ - [SHOULD-REMOVE] Parallel lists of "important factors" that have the same members and no different ownership, threshold, or CQ impact.
54
+
55
+ ### Classification Redundancy
56
+
57
+ - [SHOULD-REMOVE] Intermediate classifications with only one child and no distinct CQ, dependency, or constraint effect.
58
+ - [SHOULD-REMOVE] Separate classifications for labels that differ only in wording but not in review behavior.
59
+ - [SHOULD-REMOVE] Scale distinctions that do not change review behavior. If Micro, Small, Mid, or Large labels do not alter the rule, keep the rule at the broader level.
60
+
61
+ ### Definition Redundancy
62
+
63
+ - [MUST-REMOVE] Competing definitions of the same metric, concept, or benchmark under different sections.
64
+ - [MUST-REMOVE] Re-stating a benchmark number outside `concepts.md §Benchmark Registry` without a reference back to the canonical source.
65
+ - [SHOULD-REMOVE] Re-explaining a concept in multiple files when the downstream file only needs to apply the concept.
66
+
67
+ ### Case Redundancy
68
+
69
+ - [MUST-REMOVE] The same company case explained in detail in two or more files with no declared primary owner.
70
+ - [SHOULD-REMOVE] Multiple cases used to prove the same exact logic when one case already anchors the behavior and the others add no new boundary condition.
71
+ - [SHOULD-REMOVE] Extension cases that only restate existing CQ wording without adding a change event, impact pattern, or affected-file path.
72
+
73
+ ## 3. Minimum Granularity Criteria
74
+
75
+ A sub-classification is justified only if it satisfies at least one of the following:
76
+
77
+ 1. **Competency-question difference**: It changes the answer or evaluation path for at least one CQ in `competency_qs.md`.
78
+ 2. **Constraint difference**: It introduces different metrics, thresholds, authorities, or time horizons.
79
+ 3. **Dependency difference**: It changes which teams, systems, or stakeholders depend on the concept.
80
+
81
+ Examples:
82
+ - Platform governance and corporate governance remain separate because they change different authorities and CQ paths.
83
+ - Churn and NRR remain separate because both relate to retention but diagnose different economic behavior.
84
+ - If two customer-segmentation labels lead to the same target, same metrics, and same execution path, they should be merged.
85
+
86
+ ## 4. Boundaries — Domain-Specific Application Cases
87
+
88
+ The authoritative source for general boundary definitions is `roles/conciseness.md`. This section only states the business-domain-specific edge cases.
89
+
90
+ ### pragmatics boundary
91
+
92
+ - conciseness asks whether an element should exist at all.
93
+ - pragmatics asks whether the current amount or placement of information prevents effective use.
94
+ - Example: a dashboard with too many KPIs but still structurally legitimate is a pragmatics issue. Three different definitions of CAC is a conciseness issue.
95
+
96
+ ### coverage boundary
97
+
98
+ - conciseness removes unjustified duplication.
99
+ - coverage adds missing concerns, rules, or CQ anchors.
100
+ - Example: missing supply-chain risk logic is coverage. Repeating the same supply-chain rule across three files is conciseness.
101
+
102
+ ### logic boundary
103
+
104
+ - logic determines whether two statements are functionally equivalent or whether one entails the other.
105
+ - conciseness decides whether one of the equivalent statements should be removed after that equivalence is established.
106
+ - Example: if a premium position already entails premium pricing, a separate "use premium pricing" tactic may be removable.
107
+
108
+ ### semantics boundary
109
+
110
+ - semantics determines whether two terms refer to the same concept.
111
+ - conciseness decides whether multiple names for that concept should be consolidated.
112
+ - Example: "recurring revenue retention" and "NRR" may be the same concept. "financial risk" and "model risk" are not.
113
+
114
+ ## 5. Quantitative Criteria
115
+
116
+ These thresholds trigger consolidation review. They do not force deletion automatically, but they require an explicit owner or exception rationale.
117
+
118
+ | Criterion | Threshold | Review Action |
119
+ |---|---|---|
120
+ | Same detailed case appearing in multiple files | 2+ files with 3+ sentences each | Require a declared primary owner and compress other mentions |
121
+ | Intermediate classification with one child | 1 child | Merge unless the child changes CQ, dependency, or authority behavior |
122
+ | Empty classification | 0 concrete instances or no landing rule | Remove or mark as reserved for future extension |
123
+ | CQ duplication | Same target, same reasoning path, same pass/fail behavior | Merge or justify distinct scope |
124
+ | Benchmark duplication outside registry | 1+ uncited repeated numeric definitions | Replace with a reference to `concepts.md §Benchmark Registry` |
125
+ | Repeated threshold across CQ sections | 2+ CQ sections using the same threshold with different formulas | Normalize formula and designate one canonical interpretation |
126
+ | Same business pattern transferred across cases with no new boundary condition | 2+ cases | Merge into one stronger case or state the new boundary condition |
127
+ | Scale-specific rule with no changed review behavior | 1 occurrence is enough | Collapse to the broader rule and remove tier-specific wording |
128
+
129
+ ## Related Documents
130
+
131
+ - `concepts.md §Benchmark Registry` and `concepts.md §Homonyms Requiring Attention` — canonical numeric authority and concept-boundary checks used in duplication review
132
+ - `structure_spec.md §Business System Required Elements` and `structure_spec.md §Authority and Responsibility Separation` — structural elements used to detect unjustified duplication of roles, systems, or hierarchies
133
+ - `competency_qs.md §4. Revenue and Cost Structure (CQ-RC)` and `competency_qs.md §13. Scalability and Adaptation (CQ-SC)` — CQ sections used to test whether a distinction creates a real verification difference
134
+ - `dependency_rules.md §Source of Truth Management` and `dependency_rules.md §Platform Dependency Chains` — authority and dependency rules that justify some reference copies
135
+ - `logic_rules.md §Constraint Conflict Checking` and `logic_rules.md §Transfer Patterns` — rule sections used to test whether repeated statements are actually distinct or just rephrasings
@@ -0,0 +1,113 @@
1
+ ---
2
+ version: 2
3
+ last_updated: "2026-03-31"
4
+ source: manual
5
+ status: established
6
+ ---
7
+
8
+ # Business Domain — Dependency Rules
9
+
10
+ This document defines the directional dependencies that make business systems executable rather than merely descriptive.
11
+
12
+ ## Strategy-Execution Dependency
13
+
14
+ - Strategic objective -> execution program: a strategic claim that does not map to a concrete program, project, or operating change is not execution-ready.
15
+ - Execution program -> resource allocation: a program without budget, people, and time allocation is not a real commitment.
16
+ - Resource allocation -> KPI system: any committed resource should have a measurement logic that makes its performance visible.
17
+ - KPI system -> strategic feedback: KPI results must be able to trigger continuation, revision, or abandonment of the original strategic objective.
18
+ - Portfolio logic -> business-unit logic: when multiple businesses or product lines exist, resource allocation must state whether optimization is local or portfolio-wide.
19
+
20
+ ## Strategy-Marketing Dependency
21
+
22
+ - Competitive posture -> STP: cost leadership, differentiation, or focus should constrain who is targeted and what evidence is used to persuade them.
23
+ - STP -> marketing mix: positioning is upstream of price, channel, and promotional tone.
24
+ - Marketing promise -> customer journey: a promise without a delivery path or onboarding logic is not commercially complete.
25
+ - Brand strategy -> pricing and channel discipline: premium positioning can be destroyed by channels or discounts that contradict the intended signal.
26
+ - Acquisition motion -> retention logic: rapid customer acquisition without an explicit retention or service path can create growth optics with weak economics.
27
+
28
+ ## Finance-Strategy Dependency
29
+
30
+ - Investment criteria -> strategic option selection: strategies that require capital should state the decision rule that allowed the capital to be committed.
31
+ - Capital structure -> investment hurdle rate: financing choices determine the relevant discount rate and acceptable return level.
32
+ - Cash-flow planning -> operating scope: liquidity constraints should visibly limit rollout speed, hiring pace, or inventory intensity.
33
+ - Unit economics -> scale decision: if contribution margin is negative, scale should not be treated as the primary fix unless there is a clearly stated transition mechanism.
34
+ - Transition economics -> strategic resilience: subscription shifts, pricing changes, and platform subsidy phases should state how temporary financial pain is financed.
35
+
36
+ ## Organization-Strategy Dependency
37
+
38
+ - Strategy type -> structure type: efficiency-oriented strategies need repeatable control; exploration-oriented strategies need flexibility and faster adjustment.
39
+ - Structure type -> decision speed: deeper hierarchy and stronger control reduce local autonomy and response speed unless escalation design compensates.
40
+ - Delegation -> monitoring -> incentive design: these three must be designed together, not sequentially.
41
+ - Leadership model -> change capacity: the way leaders allocate authority directly affects whether change management is realistic or ceremonial.
42
+ - Multi-business-unit scope -> control model: once the business diversifies, local optimization and enterprise governance can no longer be treated as the same layer.
43
+
44
+ ## Change Management Circular Dependency
45
+
46
+ - New technology or process -> cooperation requirement -> first success -> broader adoption -> more cooperation forms a circular structure that must be entered intentionally.
47
+ - Entry options include executive sponsorship, a narrow pilot, or an external proof point, but the chosen entry should match the real source of resistance.
48
+ - If the business depends on short-term wins to persuade the organization, it must also show how those wins will be translated into the next adoption step.
49
+ - If cooperation depends on incentives, the business should show which role controls those incentives.
50
+ - A change initiative without an entry rule is effectively blocked before it starts.
51
+
52
+ ## Organization-Process Dependency
53
+
54
+ - Organization change -> process redesign: changing reporting lines or decision rights should trigger process review, not just org-chart updates.
55
+ - Process automation -> role redesign: automated work changes staffing, escalation, and accountability, not only labor hours.
56
+ - Competency model -> hiring and development criteria: if competency definitions change, role qualification logic should change as well.
57
+ - Decision authority -> execution responsibility: either one without the other creates bottlenecks or unmanaged risk.
58
+ - Growth in scale -> information flow design: more layers require deliberate reporting and exception routing, or decisions slow down invisibly.
59
+
60
+ ## Operations-Quality Dependency
61
+
62
+ - Throughput goals -> bottleneck investment: capacity investment should follow the bottleneck rather than local convenience.
63
+ - Lean or Six Sigma initiative -> baseline and target metric: improvement programs need explicit measurement anchors.
64
+ - Supply chain design -> risk posture: supplier concentration, geography, lead-time variance, and inventory policy should connect to risk response logic.
65
+ - Quality system -> customer promise: premium positioning or regulated offerings require stronger quality controls than commodity operations.
66
+ - Automation quality -> exception handling: the faster the automated process, the more important the exception path becomes.
67
+
68
+ ## Governance-ESG Relationship
69
+
70
+ - Governance and ESG are separate but linked. Governance defines who decides and who oversees; ESG defines which stakeholder impacts are managed and disclosed.
71
+ - Legal obligations outrank voluntary commitments unless a voluntary framework has been contractually or regulatorily adopted.
72
+ - Board or oversight changes should trigger ESG-responsibility review when sustainability claims depend on governance ownership.
73
+ - ESG disclosure changes should trigger governance review when new oversight, assurance, or data-control responsibilities are introduced.
74
+ - Green claims, social claims, or impact claims without underlying control ownership should be treated as structurally weak.
75
+
76
+ ## M&A Dependency
77
+
78
+ - Key-structure compatibility of finance, customer, product, and operations systems is a prerequisite to integration quality.
79
+ - If identifiers are incompatible, the business should name whether it will use mapping tables, parallel-run phases, or canonical-key replacement.
80
+ - Governance integration should specify which approval rights and control structures move first and which remain transitional.
81
+ - Culture integration depends on stakeholder reconciliation, not only process integration.
82
+ - The intended target structure after integration should be stated; otherwise the business is only describing coexistence, not integration.
83
+
84
+ ## Source of Truth Management
85
+
86
+ - Financial facts should point to the authoritative ledger or finance system.
87
+ - Strategic decisions should point to the approving body or decision record rather than a slide deck summary alone.
88
+ - KPI values should point to one measurement system and one refresh cadence.
89
+ - Customer, product, and supplier master data should each name a primary authority when multiple systems exist.
90
+ - When a source of truth changes, dependent references must be updated as a migration, not opportunistically. Partial authority changes create silent conflict.
91
+
92
+ ## Platform Dependency Chains
93
+
94
+ - Participant growth on one side depends on perceived value on the other side. Marketplace growth is therefore a two-sided dependency chain, not a single-funnel problem.
95
+ - Take-rate changes depend on liquidity, trust, and side-specific surplus. Monetization cannot be changed independently of participant economics.
96
+ - Governance rules depend on enforcement tools, appeal paths, and moderation capacity. Policy text without operating enforcement is not a real dependency closure.
97
+ - Trust and safety incidents can break growth, monetization, and brand at once. Platform governance is upstream of multiple business outcomes.
98
+ - Multi-homing reduces switching dependence and increases the importance of differentiated workflow, demand quality, or service tools.
99
+
100
+ ## AI/Data Dependency
101
+
102
+ - AI output quality depends on data access, data quality, model choice, prompt or workflow design, and review process together.
103
+ - Data rights are upstream of AI monetization. If reuse rights are unclear, the commercial model is unstable even if the product works.
104
+ - Model deployment depends on override and rollback design. A production AI system without a fallback path is an operational dependency gap.
105
+ - Human review load depends on model reliability, risk tolerance, and customer expectation. Review cost should be treated as part of the operating model.
106
+ - Regulatory exposure depends on use case, not only on the model. The same model can require different control depth across different business decisions.
107
+
108
+ ## Related Documents
109
+
110
+ - `domain_scope.md §Major Sub-areas` and `domain_scope.md §Inter-Document Contract` — the business concerns and ownership model that these dependencies serve
111
+ - `concepts.md §Benchmark Registry` and `concepts.md §Governance/Risk Core Terms` — source concepts and benchmark authorities referenced by these dependencies
112
+ - `structure_spec.md §Business System Required Elements`, `structure_spec.md §Digital Business Structure`, and `structure_spec.md §Authority and Responsibility Separation` — structures that make these dependencies visible
113
+ - `logic_rules.md §Financial Decision-Making Logic`, `logic_rules.md §Change Management Logic`, and `logic_rules.md §AI Business Logic` — rule sections that interpret the consequences of broken dependencies
@@ -0,0 +1,240 @@
1
+ ---
2
+ version: 2
3
+ last_updated: "2026-03-31"
4
+ source: manual
5
+ status: established
6
+ ---
7
+
8
+ # Business Domain — Domain Scope Definition
9
+
10
+ This is the reference document used by coverage to identify what should exist but is missing when reviewing a business system.
11
+ This domain applies when **reviewing** business plans, operating models, growth strategies, and management system design.
12
+
13
+ ## Major Sub-areas
14
+
15
+ Classification axis: **management concern** — classified by the business concerns that a viable and governable business system must address.
16
+
17
+ Applicability markers:
18
+ - **(required, scale: X-Y)**: Must be addressed whenever the target falls inside the stated scale range. Absence indicates a coverage gap.
19
+ - **(when applicable, scale: X-Y)**: Address only when the business actually uses the pattern and the target falls inside the stated scale range.
20
+ - **(reference)**: Context provider only. Informative, not a mandatory coverage anchor.
21
+
22
+ Scale handling rule:
23
+ - If the target is `scale unknown`, review generic structure and decision logic, but do not fail the target for missing tier-specific controls until the scale input contract is satisfied.
24
+
25
+ ### Strategic Management
26
+ - **Competitive Analysis** (required, scale: Micro-Large): Porter's Five Forces, substitute pressure, competitor response patterns, and market attractiveness. Micro businesses may use qualitative analysis; Mid/Large businesses should make industry structure explicit.
27
+ - **Resource-Based Strategy** (required, scale: Micro-Large): VRIO, core capability identification, dynamic capabilities, and sustainability of advantage. Claimed data moats, ecosystem control, or brand assets must be tested for rarity and imitability, not just asserted.
28
+ - **Growth Strategy** (required, scale: Micro-Large): Ansoff Matrix, adjacency logic, portfolio posture, and the rationale for market penetration, market development, product development, or diversification.
29
+ - **Value Innovation** (when applicable, scale: Micro-Large): Blue Ocean strategy, strategy canvas, and ERRC logic when the business claims category creation or non-price differentiation.
30
+ - **Business Development** (when applicable, scale: Small-Large): partnerships, channel expansion, M&A, regional expansion, and ecosystem entry. Founder-led opportunistic dealmaking in a Micro business is not treated as a full business-development system unless it is formalized.
31
+
32
+ ### Marketing
33
+ - **Market Strategy** (required, scale: Micro-Large): STP, customer selection criteria, willingness-to-pay logic, and explicit target-customer rationale.
34
+ - **Marketing Mix** (required, scale: Micro-Large): 4P or 7P alignment with the target segment, including service operations and physical evidence where relevant.
35
+ - **Customer Management** (required, scale: Micro-Large): customer journey, conversion logic, retention design, brand equity, and feedback loops between customer behavior and strategic decisions.
36
+ - **Digital and Growth Marketing** (when applicable, scale: Micro-Large): funnel measurement, attribution logic, experimentation, product-led growth, lifecycle messaging, and paid/organic channel mix.
37
+
38
+ ### Finance
39
+ - **Investment Decision-Making** (required, scale: Micro-Large): capital budgeting, payback logic, NPV or IRR where appropriate, and explicit treatment of downside cases. Micro firms may use simpler survival-oriented screens, but capital commitments still require a decision rule.
40
+ - **Capital Structure** (required, scale: Small-Large): cost of capital, debt-equity mix, funding strategy, and financing constraints. For Small and above, WACC or an explicit substitute discount-rate rationale should exist.
41
+ - **Working Capital Management** (required, scale: Micro-Large): cash runway, CCC, liquidity planning, receivables/inventory/payables management, and crisis response triggers.
42
+ - **Corporate Valuation** (when applicable, scale: Small-Large): DCF, relative valuation, scenario ranges, and value-driver assumptions for fundraising, M&A, or strategic review.
43
+ - **Accounting Standards Reference** (reference): revenue recognition and detailed financial-statement compliance are governed by the accounting domain. This domain uses accounting outputs as decision inputs, not as the primary rule system.
44
+
45
+ ### Operations Management
46
+ - **Process Optimization** (required, scale: Micro-Large): Lean, process flow clarity, waste identification, baseline measurement, and operational improvement logic.
47
+ - **Constraint Management** (required, scale: Micro-Large): TOC, bottleneck identification, throughput logic, and avoidance of local optimization.
48
+ - **Supply Chain Management** (when applicable, scale: Small-Large): procurement, logistics, inventory policy, supplier concentration, lead-time risk, and resilience design once direct founder coordination no longer scales.
49
+ - **Quality Management** (required, scale: Small-Large): TQM, cost-of-quality reasoning, defect prevention, and repeatability controls. Micro businesses may apply lightweight quality checks, but formal quality systems become material as process volume rises.
50
+ - **Automation** (when applicable, scale: Micro-Large): automation scope boundaries, baseline measurement, discrepancy adjudication authority, ROI conversion logic, and role redesign after automation.
51
+
52
+ ### Organization & HR
53
+ - **Organizational Structure** (required, scale: Micro-Large): Mintzberg structure fit, reporting hierarchy, coordination mechanism, and the match between structure and strategy.
54
+ - **Organizational Theory** (required, scale: Small-Large): Agency Theory, stakeholder alignment, incentive design, and delegated authority controls once ownership, management, and execution are no longer the same person or team.
55
+ - **Human Resource Management** (required, scale: Small-Large): competency model, performance management, role design, succession logic, and talent pipeline for key positions.
56
+ - **Change Management** (when applicable, scale: Small-Large): Kotter, ADKAR, sponsorship structure, short-term-win design, and circular dependency resolution between adoption and cooperation.
57
+ - **Leadership** (when applicable, scale: Micro-Large): leadership style, delegation, culture formation, and management-system maturity.
58
+
59
+ ### Innovation Management
60
+ - **Disruptive Innovation** (when applicable, scale: Micro-Large): sustaining vs. disruptive innovation, response options for incumbents, and the organizational implications of attacking non-consumption or the low end.
61
+ - **Technology Adoption** (when applicable, scale: Micro-Large): Technology Adoption Lifecycle, Chasm strategy, whole-product design, and adoption-risk segmentation.
62
+ - **Design Thinking** (when applicable, scale: Micro-Large): user research, problem framing, prototyping, and iteration where uncertainty is customer-need driven.
63
+ - **R&D Management** (when applicable, scale: Small-Large): technology roadmaps, innovation portfolio balancing, open-innovation interfaces, and governance of experimentation spend.
64
+
65
+ ### Governance & Risk
66
+ - **Corporate Governance** (required, scale: Mid-Large): board or equivalent oversight, internal controls, audit logic, escalation design, and separation between decision rights and control rights.
67
+ - **Risk Management** (required, scale: Micro-Large): risk identification, response strategy, residual-risk ownership, and crisis escalation. COSO-style formalization becomes more explicit with scale, but risk blindness is a gap at every size.
68
+ - **Business Law** (required, scale: Micro-Large): contracts, regulatory compliance, intellectual property, labor obligations, and legal constraints on growth or automation.
69
+ - **ESG** (when applicable, scale: Small-Large): environmental and social disclosure obligations, stakeholder-impact management, and the boundary between governance structures and sustainability claims.
70
+
71
+ ### Modern Extensions
72
+ - **Platform Business** (when applicable, scale: Micro-Large): multi-sided markets, network effects, take rate logic, participant governance, and cross-side incentive balance.
73
+ - **Subscription Economy** (when applicable, scale: Micro-Large): MRR/ARR, churn, retention cohorts, LTV/CAC, pricing resets, and J-curve transition management.
74
+ - **AI Business** (when applicable, scale: Micro-Large): data moat claims, model economics, AI product design, explainability, appeal paths, and regulatory exposure for algorithmic decisions.
75
+
76
+ ## Required Concept Categories
77
+
78
+ These categories must be available somewhere in the business knowledge system.
79
+
80
+ | Category | Description | Risk if Missing |
81
+ |---|---|---|
82
+ | Revenue model | Revenue generation structure, pricing system, and unit of monetization | No basis for commercial viability |
83
+ | Cost structure | Fixed/variable cost logic, cost attribution, and operating leverage | Profitability cannot be tested |
84
+ | Value proposition | The concrete customer benefit and differentiation logic | Market fit is unverified |
85
+ | Competitive strategy | Industry position, advantage source, and growth direction | Strategic choices lack basis |
86
+ | Risk management | Risk register, response design, and residual-risk ownership | Shocks cannot be absorbed or escalated properly |
87
+ | Performance measurement | KPI definitions, cadence, and leading/lagging split | Improvement cannot be directed or verified |
88
+ | Organization design | Decision rights, reporting hierarchy, and execution ownership | Strategy cannot be executed consistently |
89
+ | Source of truth | The designated authority when strategic, financial, or operational data conflicts | Decisions will be made on inconsistent facts |
90
+
91
+ ## Reference Standards/Frameworks
92
+
93
+ | Standard/Framework | Application Area | Core Content | When to Apply |
94
+ |---|---|---|---|
95
+ | Porter's Five Forces | Strategic management | Industry structure and competitive intensity analysis | Any strategy review with external competition |
96
+ | VRIO | Strategic management | Sustainability test for resources and capabilities | When advantage claims are made |
97
+ | Ansoff Matrix | Growth strategy | Product-market growth directions | When growth direction or adjacency expansion is reviewed |
98
+ | Business Model Canvas | Business model design | Nine-block business model framing | When revenue logic or operating model needs explicit articulation |
99
+ | Balanced Scorecard | Performance management | Financial, customer, internal process, and learning perspectives | Small-Large organizations with formal KPI systems |
100
+ | Lean / TPS | Operations management | Waste elimination and flow improvement | Any process-improvement review |
101
+ | Six Sigma / DMAIC | Quality and process improvement | Variation reduction through measurement-driven improvement | Mid-Large operating environments with repeatable processes |
102
+ | Theory of Constraints | Operations management | Throughput focus via bottleneck management | When flow constraints or capacity saturation exist |
103
+ | Kotter's 8 Steps / ADKAR | Change management | Organizational change sequencing and adoption readiness | When adoption depends on organizational cooperation |
104
+ | COSO ERM | Governance and risk | Enterprise risk management structure | Small-Large risk-system design; most formal at Mid-Large |
105
+ | GRI / SASB / ISSB | ESG | Sustainability disclosure and reporting frameworks | When ESG disclosure or stakeholder-impact reporting exists |
106
+ | SaaS Metrics | Subscription business | MRR, ARR, churn, NRR, LTV/CAC | When recurring-revenue models are present |
107
+
108
+ ## Scale Tier Definitions
109
+
110
+ Scale is determined by employee count only. Lifecycle signals are tracked separately and never override tier assignment.
111
+
112
+ | Scale State | Employee Count Rule | Review Meaning | Typical Coordination Pattern |
113
+ |---|---|---|---|
114
+ | scale unknown | No verified employee-count evidence | Tier-sensitive conclusions must be deferred or downgraded | Generic structure review only |
115
+ | Micro | `[1,10)` | Very small operating organization | Direct coordination, founder-centered execution |
116
+ | Small | `[10,100)` | Functionally differentiated small business | Emerging specialization and repeatable processes |
117
+ | Mid | `[100,1000)` | Formally managed organization | Delegated authority, explicit coordination systems |
118
+ | Large | `[1000,∞)` | Enterprise-scale organization | Cross-business-unit governance and formal control systems |
119
+
120
+ Interpretation rules:
121
+ - Use the half-open intervals exactly as written.
122
+ - `0 employees`, founder-only entities, or targets with no verified headcount remain `scale unknown`.
123
+ - `pre_revenue`, `founder_led`, `regulated_business`, `single_product`, and `multi_business_unit` are lifecycle or context flags, not scale tiers.
124
+ - Tier-sensitive checks may produce `SKIP-scale` or `SKIP-scale-unknown`, but generic review of structure, decision rights, and economic logic should still proceed.
125
+
126
+ ### Scale Assessment Input Contract
127
+
128
+ | Field | Requirement | Notes |
129
+ |---|---|---|
130
+ | `employee_count` or `employee_count_range` | Required for deterministic tiering | Exact count preferred; a range is acceptable only if it resolves to one tier |
131
+ | `as_of` | Required | Headcount is time-sensitive |
132
+ | `source` | Required | User statement, filing, org chart, HR source, or equivalent |
133
+ | `confidence` | Recommended | `high`, `medium`, or `low` |
134
+ | `lifecycle_flags` | Optional | `pre_revenue`, `founder_led`, `multi_business_unit`, `regulated_business`, etc. |
135
+
136
+ Resolution rules:
137
+ - If evidence spans multiple tiers, keep `scale unknown`.
138
+ - If sources conflict, prefer the narrower range from the stronger source; otherwise keep `scale unknown`.
139
+ - Lifecycle flags refine interpretation but do not change the scale state.
140
+
141
+ ## Bias Detection Criteria
142
+
143
+ - If 3 or more of the major sub-areas are missing entirely -> **insufficient coverage**
144
+ - If one area accounts for more than 70% of the content -> **area bias**
145
+ - If the revenue model exists with no cost structure -> **revenue-cost imbalance**
146
+ - If strategy exists with no execution path or operating consequences -> **execution path absence**
147
+ - If only qualitative goals exist with no measurable indicators -> **unmeasurable warning**
148
+ - If strategy is stated without competitive analysis -> **strategy basis absence**
149
+ - If relevant modern extensions (platform, subscription, AI) are missing for an applicable business model -> **modern business model blind spot**
150
+ - If 2 or more key data items have no designated source of truth -> **undesignated authority**
151
+ - If execution plans exist with no organization design or decision owner -> **execution owner unclear**
152
+ - If multiple normative systems (law, industry standard, self-regulation) apply but priority is unspecified -> **normative priority absence**
153
+ - If mandatory norms and voluntary norms are applied with the same force -> **normative strength confusion**
154
+ - If KPI targets exist but no qualitative judgment principle exists for conflict resolution -> **qualitative judgment absence**
155
+ - If platform participant rules are set unilaterally with no governance or appeal path -> **platform governance bias**
156
+ - If AI decisions have no explainability, contestability, or override path -> **algorithmic accountability absence**
157
+ - If subscription changes (pricing, downgrade, cancellation) ignore customer-impact analysis -> **subscriber impact not evaluated**
158
+ - If Mid/Large control frameworks are applied to Micro/Small targets without adaptation -> **scale mismatch (over-application)**
159
+ - If Mid/Large organizations are reviewed only with Micro/Small informal heuristics -> **scale mismatch (under-formalization)**
160
+ - If a tier-sensitive judgment is made without verified employee-count evidence -> **scale context unverified**
161
+
162
+ ## Inter-Document Contract
163
+
164
+ This section declares which file owns which cross-cutting topic so that the business domain can expand without duplicating rules or leaving orphan concepts.
165
+
166
+ ### Rule Ownership
167
+
168
+ | Cross-cutting Topic | Owner File | Other Files |
169
+ |---|---|---|
170
+ | Concept definitions | `concepts.md` | All other files reference, do not redefine |
171
+ | Financial decision-making rules | `logic_rules.md §Financial Decision-Making Logic` | `dependency_rules.md` references only |
172
+ | Strategy analysis rules | `logic_rules.md §Strategy Analysis Logic` | `structure_spec.md` references only |
173
+ | Organizational structure rules | `structure_spec.md §Organization-Strategy Fit` | `logic_rules.md` references only |
174
+ | Dependency chain rules | `dependency_rules.md` | `structure_spec.md` references only |
175
+ | Source-of-truth designation | `dependency_rules.md §Source of Truth Management` | `structure_spec.md` references only |
176
+ | Competency questions | `competency_qs.md` | Other files provide inference-path targets |
177
+ | Conciseness criteria | `conciseness_rules.md` | Other files reference only |
178
+ | Extension scenarios | `extension_cases.md` | `competency_qs.md` provides one-way CQ linkage |
179
+ | Benchmark registry | `concepts.md §Benchmark Registry` | Other files reference with `as_of` metadata |
180
+ | Change management rules | `logic_rules.md §Change Management Logic` | `dependency_rules.md §Change Management Circular Dependency` |
181
+ | Platform business rules | `logic_rules.md §Platform Business Logic` | `structure_spec.md §Digital Business Structure` |
182
+ | Automation scope rules | `logic_rules.md §Operations Management Logic` | `dependency_rules.md §Organization-Process Dependency` |
183
+ | Supply-chain and operations-quality rules | `dependency_rules.md §Operations-Quality Dependency` | `logic_rules.md §Operations Management Logic` |
184
+ | ESG relationship rules | `dependency_rules.md §Governance-ESG Relationship` | `concepts.md §Governance/Risk Core Terms`; `competency_qs.md` references only |
185
+ | Scale tier definitions and applicability ranges | `domain_scope.md §Scale Tier Definitions` | `competency_qs.md` and coverage planning inherit only |
186
+ | Bias detection criteria | `domain_scope.md §Bias Detection Criteria` | `competency_qs.md` may consume as warnings only |
187
+
188
+ ### Required Substance per Sub-area
189
+
190
+ Each sub-area declared in `§Major Sub-areas` must have corresponding substance in at least one of:
191
+ - `concepts.md`: term definitions and interpretation anchors
192
+ - `logic_rules.md`, `structure_spec.md`, or `dependency_rules.md`: operational rules and structural constraints
193
+ - `competency_qs.md`: verification questions
194
+
195
+ A declared sub-area with no substance in any of those files is a **ghost sub-area** and must either be populated or explicitly narrowed by applicability.
196
+
197
+ ### Cross-cutting Concern Attribution
198
+
199
+ When a concern spans multiple sub-areas, attribute it to the sub-area with the **primary enforcement point**:
200
+
201
+ 1. The primary enforcement point is the sub-area whose rules would be violated if the concern were ignored.
202
+ 2. Other sub-areas should reference the primary rule rather than redefine it.
203
+ 3. If enforcement is genuinely split, attribute the concern to the area with the fewer existing items and cross-reference the rest.
204
+
205
+ ### Classification Axis Relationships
206
+
207
+ The business domain uses three related concern axes. They are facets of the same system, not separate taxonomies.
208
+
209
+ | File | Axis | Facet |
210
+ |---|---|---|
211
+ | domain_scope.md | management concern | What business concerns exist |
212
+ | logic_rules.md / structure_spec.md / dependency_rules.md | operational concern | What rules govern those concerns |
213
+ | competency_qs.md | verification concern | What must be answerable during review |
214
+
215
+ ### Sub-area to CQ Section Mapping
216
+
217
+ | Sub-area | CQ Sections | Coverage |
218
+ |---|---|---|
219
+ | Strategic Management | CQ-SM | Full |
220
+ | Marketing | CQ-MK | Full |
221
+ | Finance | CQ-FI | Core financial decision-making |
222
+ | Operations Management | CQ-OP | Full |
223
+ | Organization & HR | CQ-OH | Core organizational design |
224
+ | Innovation Management | CQ-IN | Full |
225
+ | Governance & Risk | CQ-GR | Full |
226
+ | Modern Extensions — Platform | CQ-PL | Focused |
227
+ | Modern Extensions — Subscription | CQ-SB | Focused |
228
+ | Modern Extensions — AI Business | CQ-AB | Focused |
229
+
230
+ Cross-cutting CQ sections:
231
+ - `CQ-RC` spans Finance + Marketing + Modern Extensions where pricing, unit economics, and return attribution intersect.
232
+ - `CQ-CM` spans Organization & HR + Operations Management + Innovation Management where change crosses structure, process, and adoption.
233
+ - `CQ-SC` spans Strategic Management + Governance & Risk + extension events such as M&A, regional expansion, and business-model transfer.
234
+
235
+ ## Related Documents
236
+
237
+ - `concepts.md §Strategic Management Core Terms` and `concepts.md §Governance/Risk Core Terms` — canonical concept definitions for this scope
238
+ - `structure_spec.md §Business System Required Elements` and `structure_spec.md §Authority and Responsibility Separation` — structural requirements implied by this scope
239
+ - `dependency_rules.md §Source of Truth Management` and `dependency_rules.md §Governance-ESG Relationship` — dependency and authority rules consumed by this scope
240
+ - `competency_qs.md §3. Finance (CQ-FI)` and `competency_qs.md §9. Governance and Risk (CQ-GR)` — verification entry points that consume this scope