cometric 0.4.0__tar.gz → 0.6.0__tar.gz

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 (176) hide show
  1. cometric-0.6.0/.hypothesis/constants/00299dec3c4b63f6 +4 -0
  2. cometric-0.6.0/.hypothesis/constants/0959898f47ce6219 +4 -0
  3. cometric-0.6.0/.hypothesis/constants/1015cf9f295fb82e +4 -0
  4. cometric-0.6.0/.hypothesis/constants/25249dac93819ae8 +4 -0
  5. cometric-0.4.0/.hypothesis/constants/052e28aa39cf014b → cometric-0.6.0/.hypothesis/constants/39ddef8181ccd60b +1 -1
  6. cometric-0.6.0/.hypothesis/constants/99194e78dd8c7710 +4 -0
  7. cometric-0.6.0/.hypothesis/constants/a4f9ffea0a66de23 +4 -0
  8. cometric-0.6.0/.hypothesis/constants/b527c524943480e9 +4 -0
  9. cometric-0.6.0/.hypothesis/constants/b6f068d3d0ed35be +4 -0
  10. cometric-0.6.0/.hypothesis/constants/c09746c259503fde +4 -0
  11. cometric-0.6.0/.hypothesis/constants/d01b809993f4b3ef +4 -0
  12. cometric-0.6.0/.hypothesis/constants/f8856d8fb0b2f51b +4 -0
  13. cometric-0.6.0/.hypothesis/constants/fc8a9b408c1c8c81 +4 -0
  14. {cometric-0.4.0 → cometric-0.6.0}/CHANGELOG.md +18 -0
  15. {cometric-0.4.0 → cometric-0.6.0}/PKG-INFO +24 -4
  16. {cometric-0.4.0 → cometric-0.6.0}/README.md +23 -3
  17. {cometric-0.4.0 → cometric-0.6.0}/docs/COMETRIC_SPEC_v0.3.md +27 -5
  18. {cometric-0.4.0 → cometric-0.6.0}/docs/PATTERNS.md +13 -0
  19. cometric-0.6.0/docs/PROPOSE_STRUCTURES_SPEC_v0.2.md +315 -0
  20. {cometric-0.4.0 → cometric-0.6.0}/docs/STATUS.md +1 -1
  21. cometric-0.6.0/docs/ontology/README.md +252 -0
  22. cometric-0.6.0/docs/ontology/cometric.ttl +10755 -0
  23. cometric-0.6.0/docs/ontology/core.md +647 -0
  24. cometric-0.6.0/docs/ontology/pack-alsp.md +804 -0
  25. cometric-0.6.0/docs/ontology/pack-base.md +4286 -0
  26. cometric-0.6.0/docs/ontology/pack-consulting.md +307 -0
  27. {cometric-0.4.0 → cometric-0.6.0}/pyproject.toml +2 -2
  28. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/__init__.py +2 -0
  29. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/cli.py +34 -13
  30. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/api.py +28 -0
  31. cometric-0.6.0/src/cometric/core/glossary.py +23 -0
  32. cometric-0.6.0/src/cometric/core/ontology.py +1179 -0
  33. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/packs.py +31 -1
  34. cometric-0.6.0/src/cometric/core/propose.py +815 -0
  35. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/quickstart.py +24 -0
  36. cometric-0.6.0/src/cometric/core/realizations.py +692 -0
  37. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/schema.py +11 -3
  38. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/templates.py +18 -5
  39. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/validation.py +39 -9
  40. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/mcp/server.py +40 -23
  41. cometric-0.6.0/src/cometric/packs/base/concepts/client_priorities.yaml +123 -0
  42. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/selection_heuristics.yaml +10 -0
  43. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/pack.yaml +1 -1
  44. cometric-0.6.0/src/cometric/packs/base/realizations/levers.yaml +251 -0
  45. cometric-0.6.0/src/cometric/packs/base/realizations/models.yaml +263 -0
  46. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/rules/rules.yaml +70 -0
  47. cometric-0.6.0/tests/golden/propose_a4.json +295 -0
  48. cometric-0.6.0/tests/test_ontology.py +105 -0
  49. {cometric-0.4.0 → cometric-0.6.0}/tests/test_packs_and_templates.py +3 -1
  50. cometric-0.6.0/tests/test_placeholders_and_templates.py +107 -0
  51. cometric-0.6.0/tests/test_propose.py +327 -0
  52. cometric-0.6.0/tests/test_propose_flow.py +77 -0
  53. cometric-0.6.0/tests/test_realizations.py +129 -0
  54. {cometric-0.4.0 → cometric-0.6.0}/uv.lock +24 -1
  55. cometric-0.4.0/.hypothesis/constants/1452a68a7516a238 +0 -4
  56. cometric-0.4.0/.hypothesis/constants/31846ac0f55db7cc +0 -4
  57. cometric-0.4.0/.hypothesis/constants/3570e270a2e92983 +0 -4
  58. cometric-0.4.0/.hypothesis/constants/5e3c558a497b7b3b +0 -4
  59. cometric-0.4.0/.hypothesis/constants/e275ad1f9cb17aaf +0 -4
  60. cometric-0.4.0/.hypothesis/constants/ed391256aab33efd +0 -4
  61. cometric-0.4.0/.hypothesis/constants/f19d2aecb94f07ec +0 -4
  62. {cometric-0.4.0 → cometric-0.6.0}/.github/workflows/ci.yml +0 -0
  63. {cometric-0.4.0 → cometric-0.6.0}/.github/workflows/publish.yml +0 -0
  64. {cometric-0.4.0 → cometric-0.6.0}/.gitignore +0 -0
  65. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/.gitignore +0 -0
  66. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/0a08468b27ab0e2b +0 -0
  67. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/1a54c0e5b66b34fa +0 -0
  68. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/284cdb085a69e559 +0 -0
  69. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/3faf924fe60f71dc +0 -0
  70. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/52563cc61b61afeb +0 -0
  71. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/5c08095823382694 +0 -0
  72. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/64a2c31fcab5443b +0 -0
  73. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/6ab7a80f708d05c3 +0 -0
  74. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/6eef135e443dc63b +0 -0
  75. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/85a66397c5e4b867 +0 -0
  76. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/b428358d86c25f38 +0 -0
  77. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/bddcf7e0e0af1f28 +0 -0
  78. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/da39a3ee5e6b4b0d +0 -0
  79. {cometric-0.4.0 → cometric-0.6.0}/.hypothesis/constants/fd18071893a59813 +0 -0
  80. {cometric-0.4.0 → cometric-0.6.0}/LICENSE +0 -0
  81. {cometric-0.4.0 → cometric-0.6.0}/docs/ALSP_COMMERCIAL_ONTOLOGY_SPEC_v0.1.pdf +0 -0
  82. {cometric-0.4.0 → cometric-0.6.0}/docs/COMETRIC_SPEC_v0.2.md +0 -0
  83. {cometric-0.4.0 → cometric-0.6.0}/docs/RECONCILIATION.md +0 -0
  84. {cometric-0.4.0 → cometric-0.6.0}/scripts/build_alsp.py +0 -0
  85. {cometric-0.4.0 → cometric-0.6.0}/scripts/build_consulting.py +0 -0
  86. {cometric-0.4.0 → cometric-0.6.0}/scripts/build_fixtures.py +0 -0
  87. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/__init__.py +0 -0
  88. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/engine.py +0 -0
  89. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/enums.py +0 -0
  90. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/fingerprint.py +0 -0
  91. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/issues.py +0 -0
  92. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/ledger.py +0 -0
  93. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/models.py +0 -0
  94. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/money.py +0 -0
  95. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/periods.py +0 -0
  96. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/predicates.py +0 -0
  97. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/present.py +0 -0
  98. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/quantities.py +0 -0
  99. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/core/tiers.py +0 -0
  100. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_a.json +0 -0
  101. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_b.json +0 -0
  102. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_c.json +0 -0
  103. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_d.json +0 -0
  104. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_e.json +0 -0
  105. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_f.json +0 -0
  106. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_g.json +0 -0
  107. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/case_h.json +0 -0
  108. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/pattern_counting_rules.json +0 -0
  109. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/pattern_partial_and_hours.json +0 -0
  110. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/pattern_termination.json +0 -0
  111. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/pattern_tiered_minimum.json +0 -0
  112. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/pattern_transition_credit.json +0 -0
  113. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/examples/spec_example.json +0 -0
  114. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/mcp/__init__.py +0 -0
  115. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/mcp/__main__.py +0 -0
  116. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/concepts/counting_rules.yaml +0 -0
  117. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/concepts/provider_types.yaml +0 -0
  118. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/concepts/service_categories.yaml +0 -0
  119. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/concepts/unit_templates.yaml +0 -0
  120. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/coverage.yaml +0 -0
  121. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/evidence/claims.yaml +0 -0
  122. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/evidence/sources.yaml +0 -0
  123. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/overlays/levers.yaml +0 -0
  124. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/overlays/mechanisms.yaml +0 -0
  125. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/overlays/metrics.yaml +0 -0
  126. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/overlays/pricing_models.yaml +0 -0
  127. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/pack.yaml +0 -0
  128. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/rules/rules.yaml +0 -0
  129. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/alsp/templates/tiered_units_annual_minimum.json +0 -0
  130. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/automation_structures.yaml +0 -0
  131. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/billing_bases.yaml +0 -0
  132. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/cost_categories.yaml +0 -0
  133. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/dimensions.yaml +0 -0
  134. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/fee_components.yaml +0 -0
  135. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/layers.yaml +0 -0
  136. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/levers.yaml +0 -0
  137. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/mechanisms.yaml +0 -0
  138. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/metrics.yaml +0 -0
  139. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/negotiation_exchanges.yaml +0 -0
  140. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/offers.yaml +0 -0
  141. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/pricing_models.yaml +0 -0
  142. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/schema_map.yaml +0 -0
  143. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/concepts/selection_framework.yaml +0 -0
  144. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/coverage.yaml +0 -0
  145. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/evidence/claims.yaml +0 -0
  146. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/evidence/sources.yaml +0 -0
  147. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/base/excluded.yaml +0 -0
  148. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/concepts/consulting_concepts.yaml +0 -0
  149. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/concepts/provider_types.yaml +0 -0
  150. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/concepts/service_categories.yaml +0 -0
  151. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/concepts/unit_templates.yaml +0 -0
  152. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/coverage.yaml +0 -0
  153. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/overlays/pricing_models.yaml +0 -0
  154. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/pack.yaml +0 -0
  155. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/rules/rules.yaml +0 -0
  156. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/templates/capped_tm.json +0 -0
  157. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/templates/fixed_fee_plus_success.json +0 -0
  158. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/templates/phased_fixed_fee.json +0 -0
  159. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/templates/retainer_hours_drawdown.json +0 -0
  160. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/packs/consulting/templates/role_based_tm.json +0 -0
  161. {cometric-0.4.0 → cometric-0.6.0}/src/cometric/py.typed +0 -0
  162. {cometric-0.4.0 → cometric-0.6.0}/tests/builders.py +0 -0
  163. {cometric-0.4.0 → cometric-0.6.0}/tests/conftest.py +0 -0
  164. {cometric-0.4.0 → cometric-0.6.0}/tests/test_casebook.py +0 -0
  165. {cometric-0.4.0 → cometric-0.6.0}/tests/test_counting.py +0 -0
  166. {cometric-0.4.0 → cometric-0.6.0}/tests/test_engine_review_fixes.py +0 -0
  167. {cometric-0.4.0 → cometric-0.6.0}/tests/test_llm_feedback.py +0 -0
  168. {cometric-0.4.0 → cometric-0.6.0}/tests/test_mcp.py +0 -0
  169. {cometric-0.4.0 → cometric-0.6.0}/tests/test_outcome_and_realization.py +0 -0
  170. {cometric-0.4.0 → cometric-0.6.0}/tests/test_patterns.py +0 -0
  171. {cometric-0.4.0 → cometric-0.6.0}/tests/test_pricing.py +0 -0
  172. {cometric-0.4.0 → cometric-0.6.0}/tests/test_properties.py +0 -0
  173. {cometric-0.4.0 → cometric-0.6.0}/tests/test_reconcile.py +0 -0
  174. {cometric-0.4.0 → cometric-0.6.0}/tests/test_reproducibility_and_search.py +0 -0
  175. {cometric-0.4.0 → cometric-0.6.0}/tests/test_search_and_context.py +0 -0
  176. {cometric-0.4.0 → cometric-0.6.0}/tests/test_termination.py +0 -0
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/templates.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ ['/', '/engagement/currency', '/engagement/end_date', '/engagement/name', '0', '0.2', '1000', '10000', '100000', '10240', '120', '12000', '1200000', '16000', '2000', '2027-01-01', '2027-06', '2027-12-31', '250', '6000', '8', '900000', '<required>', 'ALLOWANCE_OVERAGE', 'ALL_ELIGIBLE', 'ANNUAL', 'COUNT', 'CUMULATIVE', 'DEDICATED_RESOURCE', 'ESTIMATED', 'EVENT', 'FIXED', 'FIXED_PROJECT', 'FIXED_RECURRING', 'FTE_MONTHS', 'HOURS', 'MARGINAL', 'MONTH', 'MONTHLY', 'NONE', 'OUTPUT', 'PER_SEGMENT', 'RESOURCE', 'TEMPLATE-DEDICATED', 'TEMPLATE-TM', 'TERM', 'TIME', 'USD', 'YEAR', 'acceptance_rule', 'accumulation_period', 'allowance', 'amount', 'analyst', 'arrangement_versions', 'assumptions', 'base', 'base_plus_overage', 'billing_basis', 'calculation_method', 'charge_cadence', 'code', 'components', 'composition', 'consultant', 'core', 'cost_components', 'counting_rule', 'currency', 'dedicated_team', 'delivery_hours', 'delivery_plan', 'depends_on', 'description', 'effective_from', 'effective_period', 'end_date', 'engagement', 'engagement_id', 'entitlements', 'examples', 'fixed_project', 'from', 'fte', 'fte_month', 'granted_by', 'hour', 'hours', 'hours.consultant', 'hours_used', 'id', 'included_quantity', 'kind', 'month', 'name', 'origin', 'overage', 'overage_rate', 'overage_recognition', 'policy', 'project', 'quantity_source', 'rate', 'rate_per_fte_month', 'rate_schedules', 'role', 'rollover', 'scenario', 'scenario.hours', 'scenario.units', 'schema_version', 'service', 'service_id', 'services', 'source', 'start_date', 'team', 'template_id', 'tier_method', 'tier_scope', 'tiers', 'time', 'time_and_materials', 'time_period', 'to', 'unit', 'unit_definition_id', 'unit_definitions', 'units', 'v1', 'value']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/mcp/server.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [b'Method Not Allowed', b'POST', b'Unauthorized', b'allow', b'authorization', b'content-type', b'text/plain', 401, 405, 8765, ',', '.yaml', '.yml', '/', '/mcp', '0', '0.01', '127.0.0.1', '127.0.0.1:*', 'COMETRIC_MCP_TOKEN', 'Cometric', 'DELETE', 'ERROR', 'GET', 'INTERNAL_ERROR', 'INVALID_INPUT', 'UNKNOWN_NAME', 'application/json', 'approvals_required', 'areas', 'body', 'claims', 'code', 'cometric', 'cometric://glossary', 'concept', 'concept-scheme', 'coverage', 'display', 'engagement', 'engine_version', 'error', 'errors', 'evidence_class', 'example', 'examples', 'glossary', 'headers', 'hint', 'http', 'http.response.body', 'http.response.start', 'id', 'info', 'invalid', 'issues', 'label', 'localhost', 'localhost:*', 'message', 'method', 'name', 'overlays', 'pack', 'pack-template', 'packs', 'path', 'prevalence', 'propose_structures', 'query', 'quickstart', 'reference', 'results', 'rules', 'schema', 'schema_version', 'search_structures', 'severity', 'source_records', 'sources', 'status', 'stdio', 'summary', 'template', 'templates', 'terms', 'type', 'validate_engagement', 'values', 'warnings']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/glossary.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ ['accumulation_period', 'contractual_fee', 'contribution_profit', 'cost_policy', 'derived_bearer', 'dominance', 'evidence_class', 'gross_profit', 'margin', 'margin_layer', 'origin', 'outcome_fee', 'price_floor', 'realization', 'recognition', 'spend_variability', 'structure_proposal', 'volume_excess', 'volume_shortfall']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/realizations.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [', ', '0', '0.2', '0.5', '1', '1 if', '1000', '1200', '2027-01-01', '600', 'ALLOWANCE_OVERAGE', 'ALL_ELIGIBLE', 'BOUNDED', 'CLIENT', 'COUNT', 'DEDICATED_LABOR', 'ESTIMATED', 'FIXED', 'FTE-month', 'FTE-months', 'FTE_MONTHS', 'HOURS', 'JOINT', 'MARGINAL', 'MIXED', 'MONTH', 'MONTHLY', 'MOSTLY_FIXED', 'MOSTLY_VARIABLE', 'NONE', 'NONE_ADVERSE', 'ONE_TIME', 'OUTPUT', 'POOLED_LABOR', 'PRORATE', 'PROVIDER', 'RANGE', 'RATE', 'REQUIRED_FIELD', 'SHARED', 'TERM', 'TIME', 'TRANSITION', 'UNIT_OUTPUT', 'UNKNOWN', 'USAGE', 'USD', 'VARIABLE', 'WEIGHTED_UNIT_OUTPUT', 'YEAR', '[^a-z0-9]+', '_', 'a', 'acceptance rule', 'acceptance_rule', 'accumulation_period', 'adds_features', 'adjustments', 'amount', 'arrangement_versions', 'assumptions', 'automation_benefit', 'axis', 'b', 'bands', 'basis', 'behavior', 'c', 'c_t', 'c_unit', 'calculation_method', 'category', 'client_value_unit', 'code', 'commitments', 'complexity', 'components', 'concept', 'concepts', 'cost_components', 'count', 'counting rule', 'counting_rule', 'currency', 'currency (ISO code)', 'date', 'delivery_plan', 'delivery_team', 'depends_on', 'derived', 'description', 'descriptors', 'driver', 'early_exit', 'effective_from', 'effective_period', 'effects', 'end date', 'end_date', 'engagement', 'engagement name', 'engagement_id', 'entitlements', 'error', 'errors', 'excludes_features', 'expected', 'expression', 'features', 'fraction', 'fragment', 'from', 'fte', 'fte_month', 'fte_months', 'high', 'hour', 'hours', 'hours.delivery', 'id', 'invalid', 'issues', 'kind', 'label', 'labels', 'lever', 'levers', 'low', 'mitigates', 'mitigates_when_tiers', 'mix', 'model', 'name', 'needs ', 'once', 'origin', 'packs', 'patch', 'per_tier', 'per_unit', 'per_variable', 'period', 'pricing_models', 'pricing_unit', 'product', 'proposal', 'q', 'rate', 'rate_schedules', 'ratio', 'raw_unit', 'reference', 'requires_features', 'requires_tiers', 'rounding', 'scenario_assumptions', 'scenarios', 'schema_version', 'selection_heuristics', 'service', 'service_category', 'service_id', 'services', 'setup', 'setup cost', 'share of volume', 'spend_variability', 'start date', 'start_date', 'status', 'suggested_when', 't', 'termination_date', 'termination_rule', 'text', 'tier', 'tier_method', 'tier_scope', 'time_period', 'to', 'total', 'tradeoffs', 'u', 'unit', 'unit_definition_id', 'unit_definitions', 'unit_kinds', 'units', 'units_total', 'v1', 'value', 'variable_delivery', 'variable_ids', 'version', 'volume_basis', 'volume_excess', 'volume_q', 'volume_shortfall', 'volume_unit', 'weight', 'weight_tables', 'weighted', 'weighted_unit', 'weighted_units', '{', '{variable_ids}', '}']
@@ -1,4 +1,4 @@
1
1
  # file: /home/runner/work/cometric/cometric/src/cometric/__init__.py
2
2
  # hypothesis_version: 6.170.14
3
3
 
4
- ['0.0.0', 'ENGINE_VERSION', 'SCHEMA_VERSION', 'break_even', 'calculate_periods', 'cometric', 'compare_arrangements', 'derive_risk_exposure', 'describe_pack', 'describe_schema', 'explain_fee', 'get_template', 'list_packs', 'list_templates', 'list_vocabulary', 'lookup_concept', 'price_floor', 'reconcile', 'search_structures', 'validate_engagement']
4
+ ['0.0.0', 'ENGINE_VERSION', 'SCHEMA_VERSION', 'break_even', 'calculate_periods', 'cometric', 'compare_arrangements', 'derive_risk_exposure', 'describe_pack', 'describe_schema', 'explain_fee', 'get_template', 'list_packs', 'list_templates', 'list_vocabulary', 'lookup_concept', 'price_floor', 'propose_structures', 'reconcile', 'search_structures', 'validate_engagement']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/ontology.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [' (', ' (needs tiers)', ' .', ' ;\n ', '"', '""")', '# Cometric ontology', '## Claims', '## Classes', '## Contents', '## Core model', '## Core vocabularies', '## Files', '## Glossary', '## Overlays', '## Packs', '## Realizations', '## Rules', '## Sources', '### Classes', '### References by id', '(?<!^)(?=[A-Z])', ')', ', ', ', evaluated', ', not evaluated', '-', '.', '0..1', '1', '; ', '</details>', 'Adjustment', 'Arrangement version', 'ArrangementVersion', 'Billing bases: ', 'Broader: ', 'CapacityLimit', 'Claim', 'Claims', 'Claims: ', 'Commitment', 'CostComponent', 'CostPolicy', 'CostTier', 'DeliveryPlan', 'EffectivePeriod', 'Engagement', 'Entitlement', 'FeeComponent', 'Glossary', 'Horizon', 'IncurredLine', 'Methods: ', 'MoneyPolicy', 'Namespaces:', 'OutcomeTerms', 'Overlay', 'Overlays', 'Pack', 'PackRef', 'Party', 'PaymentLine', 'ProductionStandard', 'README.md', 'RateSchedule', 'Realization', 'Realizations', 'Related: ', 'ResourceLine', 'ResourceRole', 'RiskAllocation', 'RoleRate', 'Rollover', 'Root documents: ', 'Rule', 'Rules', 'Scenario', 'Service', 'Source', 'Sources', 'Synonyms: ', 'Tier', 'TolerancePolicy', 'URL', 'UnitDefinition', 'WeightBand', '\\', '\\"', '\\\\', '\\n', '\\r', '\\t', '\\|', '_', '```', '```json', '```mermaid', '```python', 'a', 'allowed value', 'allowedValue', 'any', 'applies_to', 'assessment', 'attributes', 'bases', 'billing basis', 'billingBasis', 'boolean', 'broader', 'calculation method', 'calculationMethod', 'caveat', 'caveats', 'claim', 'claims', 'classification', 'cm', 'cm:Claim', 'cm:Overlay', 'cm:Pack', 'cm:Realization', 'cm:Rule', 'cm:Source', 'cm:allowedValue', 'cm:assessment', 'cm:attributes', 'cm:billingBasis', 'cm:calculationMethod', 'cm:caveat', 'cm:claim', 'cm:code', 'cm:condition', 'cm:defaultValue', 'cm:evaluable', 'cm:evidenceClass', 'cm:explanation', 'cm:extends', 'cm:fieldName', 'cm:fragment', 'cm:kind', 'cm:message', 'cm:minItems', 'cm:multiple', 'cm:overlays', 'cm:pack', 'cm:prevalence', 'cm:publicationDate', 'cm:realizes', 'cm:referencedById', 'cm:required', 'cm:retrievedDate', 'cm:riskEffects', 'cm:riskLabels', 'cm:severity', 'cm:source', 'cm:sourceRef', 'cm:sourceType', 'cm:statement', 'cm:status', 'cm:url', 'cm:verified', 'cmv', 'code', 'cometric.ttl', 'component_id', 'component_ids', 'concept', 'concepts', 'condition', 'core model', 'core vocabularies', 'core#', 'core.md', 'date', 'dcterms', 'dcterms:license', 'decimal (string)', 'default', 'default value', 'defaultValue', 'definition', 'depends_on', 'description', 'effects', 'emit', 'en', 'entitlement_id', 'enum', 'evaluable', 'evidence class', 'evidenceClass', 'evidence_class', 'explanation', 'extends', 'field name', 'fieldName', 'flowchart LR', 'fragment', 'glossary', 'granted_by', 'id', 'import rdflib', 'integer', 'issue code', 'kind', 'label', 'labels', 'literal', 'map', 'message', 'methods', 'minItems', 'min_items', 'minimum items', 'model', 'month (YYYY-MM)', 'multiple', 'no', 'none', 'object (map)', 'one of ', 'ontology terms', 'overflow_replaces', 'overlay', 'overlays', 'owl', 'owl:Class', 'owl:DatatypeProperty', 'owl:ObjectProperty', 'owl:Ontology', 'owl:versionInfo', 'pack', 'prevalence', 'publication date', 'publicationDate', 'publication_date', 'rate_schedule_id', 'rdf', 'rdf:JSON', 'rdfs', 'rdfs:comment', 'rdfs:domain', 'rdfs:label', 'rdfs:range', 'realization', 'realizes', 'ref', 'referenced by id', 'referencedById', 'related', 'required', 'requires_features', 'requires_tiers', 'retrieved date', 'retrievedDate', 'retrieved_date', 'risk effects', 'risk labels', 'riskEffects', 'riskLabels', 'row', 'rows = g.query("""', 'rule', 'scalar', 'service_id', 'severity', 'skos', 'skos:Concept', 'skos:ConceptScheme', 'skos:altLabel', 'skos:broader', 'skos:definition', 'skos:inScheme', 'skos:notation', 'skos:prefLabel', 'skos:related', 'skos:topConceptOf', 'source', 'source reference', 'source type', 'sourceRef', 'sourceType', 'source_ref', 'source_type', 'sources', 'statement', 'status', 'string', 'supersedes_id', 'synonyms', 'title', 'true', 'unit_definition_id', 'unit_kinds', 'url', 'values', 'verified', 'version', 'vocab#', 'weight_table_id', 'when', 'xsd', 'xsd:anyURI', 'xsd:boolean', 'xsd:date', 'xsd:decimal', 'xsd:gYearMonth', 'xsd:integer', 'xsd:string', 'yes', '|', '| Class | Meaning |', '| File | Contents |', '|---|---|', '|---|---|---|', '|---|---|---|---|', '} ORDER BY ?id']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/validation.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ ['/', '/cost_policy', '/engagement', '/horizon', '/mapping', '/scenario', '/termination_date', '0.10', '2500000', '; ', '<required:', '<required>', '>', 'ADJUSTMENT_FIELDS', 'APPROVAL_REQUIRED', 'ATTRIBUTION_METHOD', 'ATTRIBUTION_REQUIRED', 'BASELINE_REQUIRED', 'CAP needs amount', 'COMMITMENT_SCOPE', 'CONTRACT_YEAR', 'COST_FIELDS', 'CURRENCY_MISMATCH', 'DANGLING_DEPENDENCY', 'DATE_ORDER', 'DEPENDENCY_CYCLE', 'DEPENDENCY_MISSING', 'DISCOUNT', 'DUPLICATE_ID', 'EMPTY_VERSION', 'ERROR', 'EXCESS_ONLY', 'FIELD_NOT_USED', 'HORIZON_OUTSIDE_TERM', 'INFO', 'METHOD_FIELDS', 'METHOD_NOT_SUPPORTED', 'OUTCOME_FEE_APPROVAL', 'RANGE', 'RECOGNITION_PERIOD', 'REQUIRED_FIELD', 'SCHEMA', 'TIER_CLIFF', 'TIER_INVALID', 'UNCAPPED_OUTCOME_FEE', 'UNIT_MISMATCH', 'UNKNOWN_COMPONENT', 'UNKNOWN_COST_POLICY', 'UNKNOWN_ENTITLEMENT', 'UNKNOWN_SERVICE', 'UNKNOWN_UNIT', 'UNKNOWN_VERSION', 'UNKNOWN_WEIGHT_TABLE', 'VERSION_OVERLAP', 'WARNING', 'accumulation_period', 'adjustments', 'amount', 'applies_to', 'approval_reference', 'approvals_required', 'arrangement_versions', 'attribution_method', 'attribution_percent', 'band_lower', 'band_lower_inclusive', 'band_upper_exclusive', 'baseline', 'billing_basis', 'calculation_method', 'cap_amount', 'cap_percent', 'capacity', 'category', 'charge_cadence', 'commitments', 'component_id', 'component_ids', 'components', 'cost_components', 'currency', 'delivery_plan', 'depends_on', 'driver', 'effective_from', 'engagement', 'entitlement_id', 'entitlements', 'errors', 'fixed_amount', 'granted_by', 'info', 'invalid', 'kind', 'loc', 'lower', 'lower_inclusive', 'mapping', 'msg', 'ok', 'outcome', 'overage_recognition', 'overflow_replaces', 'parties', 'payment_schedule', 'percent', 'proration_policy', 'provider_type', 'quantity_source', 'rate_schedule_id', 'rate_schedules', 'raw_unit', 'recognition', 'resources', 'role_rates', 'roles', 'service_category', 'service_id', 'services', 'share_percent', 'shortfall_rule', 'start_date', 'status', 'step_size', 'supersedes_id', 'target', 'threshold', 'threshold_scope', 'tier_method', 'tiers', 'trigger', 'type', 'unit', 'unit_definition_id', 'unit_definitions', 'upper_exclusive', 'valid', 'warnings', 'weight_table_id', 'weight_tables']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/schema.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [10000, '$schema', ', ', '.', '0', '0.15', '110', 'A bare engagement', 'Actuals (reconcile)', 'BASE', 'Default display', 'Default summary', 'MEAN', 'SearchSpec', 'WORST', 'actuals', 'add', 'adjustment', 'aggregation', 'all', 'arrangement_version', 'array', 'assumption', 'base_scenario', 'boolean', 'by_reference', 'candidate', 'commitment', 'commitment_shortfall', 'constraint', 'constraint_paths', 'constraints', 'contractual_fee', 'contribution_margin', 'contribution_profit', 'cost_component', 'cost_policy', 'deal_profile', 'delivery_plan', 'derived_quantities', 'description', 'detail', 'direct_delivery_cost', 'display', 'dry_run', 'engagement', 'entitlement', 'enum', 'error_paths', 'exact', 'examples', 'fee_component', 'from', 'frontier_metrics', 'full', 'gross_margin', 'gross_profit', 'gt', 'id', 'include_baseline', 'integer', 'items', 'lt', 'lte', 'max', 'max_candidates', 'max_returned', 'maximum', 'metric', 'min', 'name', 'not', 'object', 'objective', 'oneOf', 'outcome_fee', 'overage_fee', 'parameters', 'path', 'paths', 'periods', 'pointer', 'pointers', 'precision', 'properties', 'propose_options', 'quantity_source', 'range', 'rate_schedule', 'required', 'rule_paths', 'scale', 'scenario', 'scenarios', 'schema_version', 'search_parameters', 'search_spec', 'sense', 'set', 'standard', 'step', 'string', 'summary', 'term', 'tie_breakers', 'title', 'to', 'tolerance_policy', 'transform', 'type', 'values', '{metric: "amount"}']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/api.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [10000, '...', '/', '/...', '/actuals', '/actuals/term', '/assumption', '/candidates', '/constraints', '/cost_policy', '/detail', '/driver', '/engagement', '/name', '/objective', '/objective/sense', '/parameters', '/pointer', '/pointers', '/precision', '/results', '/risk_premium', '/scenarios', '/search_spec', '/target_margin', '/tolerance_absolute', '/tolerance_relative', '/transform', '/value', '/values', '0', '0.01', '0.15', '0.2', '100', '100000', '140', '20', '90000', '; ', '?', 'BAD_CONSTRAINT', 'BAD_POINTER', 'BASE', 'BEST_AT_GRID_EDGE', 'COSTS_NOT_EVALUATED', 'COST_POLICY_REQUIRED', 'DUPLICATE_ID', 'ERROR', 'INTERNAL_POLICY', 'MEAN', 'NO_RESULTS', 'PARAMETER_SPEC', 'PENDING_HUMAN_REVIEW', 'RANGE', 'RATE', 'RISK_MISMATCH', 'RISK_PREMIUM_RANGE', 'SCENARIO_INFEASIBLE', 'SCHEMA', 'TARGET_MARGIN_RANGE', 'TERM', 'UNKNOWN_DRIVER', 'UNKNOWN_METRIC', 'UNKNOWN_QUANTITY', 'WORST', '_doc', 'absolute', 'accumulation_period', 'actual', 'actuals', 'add', 'aggregation', 'allowances', 'approval_state', 'assumption', 'assumptions', 'base', 'base_client_price', 'base_contribution', 'base_fee', 'base_scenario', 'base_scenario_id', 'baseline', 'best', 'best_under_objective', 'binding_constraints', 'calculate_periods', 'calculated', 'calculations', 'candidates', 'capacity', 'client_downside', 'client_price', 'closest_value_slack', 'code', 'cometric_higher', 'cometric_lower', 'commitment_shortfall', 'compared', 'component', 'computed', 'constraints', 'contract_facts', 'contractual_fee', 'contribution_margin', 'contribution_profit', 'cost_per_unit', 'cost_policy', 'costs', 'costs_by_category', 'costs_evaluated', 'costs_in_floor', 'counts', 'currency', 'current', 'current_fee', 'declared_bearer', 'decreasing', 'definitions', 'derived_bearer', 'derived_quantities', 'description', 'detail', 'deviations', 'difference', 'direct_delivery_cost', 'direction', 'discrepancies', 'display', 'distribution', 'dominated_by', 'driver', 'dry_run', 'edge', 'engagement', 'engagement_id', 'engine_version', 'entitlement', 'enumerated', 'errors', 'estimated_seconds', 'evaluated', 'exact', 'explanation', 'failing_constraints', 'feasible', 'fee_change', 'fee_line_items', 'fee_total', 'fees', 'fingerprints', 'flat', 'floors', 'formula', 'from', 'frontier', 'frontier_metrics', 'frontier_truncated', 'full', 'full_cost_profit', 'grid_edges', 'grid_size', 'gross_margin', 'gross_profit', 'gt', 'gte', 'headroom', 'horizon', 'id', 'include_baseline', 'increasing', 'infeasible', 'input_fingerprint', 'invalid', 'invalid_reasons', 'issues', 'kind', 'labels', 'leaf_true', 'ledger', 'line_items', 'lower', 'lt', 'lte', 'max', 'max_candidates', 'max_returned', 'measured', 'mechanisms_priced', 'message', 'metric', 'metrics', 'min', 'minimums', 'money_policy', 'month', 'must not be negative', 'name', 'non_dominated', 'not', 'note', 'nothing_compared', 'objective', 'objective_values', 'ok', 'on_frontier', 'op', 'operation', 'origin', 'outcome_fee', 'overage_fee', 'overage_recognition', 'packs', 'parameter', 'parameters', 'path', 'percent', 'period', 'periods', 'pointer', 'pointers', 'precision', 'price_floor', 'profile', 'provider_downside', 'publishable_summary', 'quantity_spreading', 'range', 'ranking', 'rate', 'rate_assumptions', 'reason', 'reconcile', 'reconciled', 'record_type', 'reference', 'rejected', 'relative', 'relative_difference', 'results', 'risk', 'risk_exposure', 'risk_premium', 'rollover', 'rounding', 'rows', 'rules_fired', 'scale', 'scenario', 'scenario_id', 'scenarios', 'schema_version', 'scope', 'sense', 'set', 'severity', 'shortfall_rule', 'standard', 'standard_value', 'status', 'step', 'summary', 'target_margin', 'term', 'termination', 'tested_against', 'threshold', 'thresholds', 'tie_breakers', 'time_period', 'to', 'tolerance', 'transform', 'type', 'unit', 'unit_contribution', 'unit_floor', 'upper', 'valid', 'value', 'values', 'values_per_parameter', 'volume', 'volume_quantity', 'vs_baseline', 'warnings', 'whole', 'within_limit', 'within_tolerance', 'worked_hours', 'years', '~', '~0', '~1']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/propose.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [0.5, ' and ', ' for each unit', ' or ', ' with ', "'", '+', ',', ', ', ', tier ', '.', '/deal_profile', '/deal_profile/volume', '/options', '/packs', ':', '; ', 'AMBIGUOUS_ID', 'ANY', 'APPROVAL_REQUIRED', 'CLIENT', 'COUNT', 'C_INFERENCE', 'DUPLICATE_ID', 'D_PROPOSED', 'FEWER_CANDIDATES', 'FTE_MONTHS', 'HOURS', 'INFO', 'KNOWN', 'LABELS_ARE_PROPOSED', 'MIXED', 'MONTH', 'MOSTLY_FIXED', 'MOSTLY_VARIABLE', 'NONE', 'NONE_ADVERSE', 'NO_CANDIDATES', 'PENDING_HUMAN_REVIEW', 'PROVIDER', 'RANGE', 'SCHEMA', 'SHARED', 'STRUCTURALLY_WEAK', 'StructureProposal', 'TIERS_IGNORED', 'UNKNOWN', 'UNKNOWN_CANDIDATE', 'UNKNOWN_VOCABULARY', 'UNVERIFIED', 'VOLUME_UNKNOWN', 'WARNING', 'WEAK', 'YEAR', '__args__', 'approval_state', 'approvals_required', 'assessment', 'attributes', 'axis', 'base', 'base_model', 'candidates', 'caution', 'caution_refs', 'claims', 'class', 'client_priorities', 'code', 'common_inputs', 'composition', 'compositions', 'concept', 'concepts', 'ctx', 'currency (ISO code)', 'deal_profile', 'definitions', 'early_exit', 'emit', 'engagement', 'engagement_id', 'engine_version', 'evaluable', 'evidence', 'evidence_class', 'example', 'exclude_levers', 'excluded', 'expand', 'expected', 'extra_forbidden', 'favored_refs', 'features', 'fingerprint', 'fits', 'fits_priorities', 'flag', 'high', 'hint', 'id', 'in', 'include_levers', 'input', 'invalid', 'issues', 'json', 'keys', 'kind', 'label', 'label_assumes', 'labels', 'lever', 'lever_count', 'levers', 'literal_error', 'loc', 'low', 'message', 'mitigates', 'mitigates_when_tiers', 'mix', 'model', 'msg', 'next_step', 'note', 'notes', 'ok', 'options', 'order_note', 'pack', 'packs', 'prevalence', 'priority', 'profile_signal', 'propose_structures', 'reason', 'record_type', 'requires_inputs', 'requires_tiers', 'risk_allocation', 'rule', 'rules', 'scenario volumes', 'scenarios', 'schema_version', 'selection_heuristics', 'service_categories', 'service_category', 'severity', 'similar_template', 'skeleton', 'sources', 'spend_variability', 'start date', 'status', 'suggested_when', 'suggests', 'tension', 'tension_note', 'text', 'tiers', 'tool', 'tradeoffs', 'type', 'unit_kinds', 'verified', 'version', 'volume_excess', 'volume_shortfall', 'warnings', 'when']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/cli.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ [8765, '+', '--actuals', '--component', '--cost-policy', '--detail', '--driver', '--expand', '--host', '--max', '--out', '--pack', '--period', '--port', '--risk-premium', '--scenario', '--scenarios', '--summary-only', '--target-margin', '--tolerance-absolute', '--tolerance-relative', '--transport', '--version', '.yaml', '.yml', '0', '0.01', '127.0.0.1', '__main__', 'append', 'break-even', 'calculate', 'cmd', 'cometric', 'compare', 'compared', 'cost_policies', 'deal_profile', 'discrepancies', 'engagement', 'engagements', 'errors', 'expand', 'explain', 'feasible', 'floor', 'http', 'id', 'infeasible', 'issues', 'line_items', 'list installed packs', 'list templates', 'lookup', 'max_candidates', 'mcp', 'model', 'nothing_compared', 'ok', 'ontology', 'options', 'pack', 'packs', 'periods', 'print a template', 'problems', 'propose', 'publishable_summary', 'query', 'reconcile', 'reconciled', 'request', 'run the MCP server', 'scenarios', 'schema', 'search', 'spec', 'status', 'stdio', 'store_true', 'summary', 'template', 'template_id', 'templates', 'valid', 'validate', 'validate-pack', 'version', 'warnings']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/quickstart.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ ['0.10', '0.20', '100000', '110', '1200', '12000', '1200000', '130', '140.00', '1500', '15000', '2027-01', '40', '400', '40000', '9000', '90000', 'CONTRACTS', 'COUNT', 'DEDICATED_LABOR', 'ESTIMATED', 'EX-ALT', 'FIXED', 'MEAN', 'MIXED', 'MONTHLY', 'POOLED_LABOR', 'RANGE', 'SHARED', 'TERM', 'VARIABLE', 'WORST', 'YEAR', 'accepted_units', 'actuals', 'aggregation', 'alsp', 'amount', 'arguments', 'arrangement_versions', 'assumptions', 'base', 'base_fee', 'behavior', 'break_even', 'budget_certainty', 'by_reference', 'calculate_periods', 'candidates', 'category', 'certainty', 'client_priorities', 'compare_arrangements', 'components', 'constraints', 'contractual_fee', 'contribution_profit', 'conventions', 'cost_components', 'cost_policy', 'cost_profile', 'counting_rules', 'current', 'deal_profile', 'decimals', 'delivery_plan', 'derive_risk_exposure', 'description', 'detail', 'detail_and_precision', 'driver', 'engagement', 'engagement_id', 'errors', 'examples', 'expected', 'explain_fee', 'fixed_amount', 'fixed_team', 'get_template', 'high', 'how', 'id', 'kind', 'lookup_concept', 'low', 'lower_base', 'lt', 'max', 'max_candidates', 'max_volume_risk', 'medium', 'metric', 'months', 'name', 'next', 'no_arithmetic', 'not', 'notes', 'objective', 'options', 'origin', 'overage_rate', 'packs', 'parameters', 'path', 'patterns', 'pay_for_use', 'per_review', 'period', 'periods', 'pointer', 'price_floor', 'propose_structures', 'propose_then_compare', 'provider_constraints', 'quantities', 'rate', 'rate_schedules', 'reconcile', 'reference', 'references', 'results', 'scenario', 'scenarios', 'search_dry_run', 'search_spec', 'search_structures', 'sense', 'service_category', 'shape', 'spec_example.json', 'summary', 'target_margin', 'team', 'term', 'termination', 'tie_breakers', 'tiers', 'time_period', 'tool', 'tools_with_examples', 'unit', 'unit_of_work', 'validate_engagement', 'value', 'values', 'volume']
@@ -0,0 +1,4 @@
1
+ # file: /home/runner/work/cometric/cometric/src/cometric/core/packs.py
2
+ # hypothesis_version: 6.170.14
3
+
4
+ ['*.json', '*.py', '*.yaml', '0.1', 'APPROVAL_REQUIRED', 'C_INFERENCE', 'D_PROPOSED', 'INFO', 'PACK_VERSION', 'UNKNOWN_DESCRIPTOR', 'UNKNOWN_PACK', 'UNKNOWN_VOCABULARY', 'WARNING', 'accumulation_period', 'adjustment_type', 'areas', 'assessment', 'attributes', 'bases', 'billing_basis', 'breach_mode', 'broader', 'calculation_method', 'charge_cadence', 'claim_records', 'claims', 'claims.yaml', 'client_priorities', 'code', 'commitment_kind', 'composition', 'concepts', 'core', 'cost_behavior', 'cost_category', 'count', 'coverage', 'coverage.yaml', 'definition', 'description', 'descriptors', 'dimensions', 'emit', 'engagement', 'evaluable', 'evidence', 'evidence_class', 'excluded', 'excluded.yaml', 'explanation', 'extends', 'fits', 'id', 'key', 'kind', 'label', 'label_note', 'margin_layer', 'message', 'meta', 'methods', 'origin', 'overlays', 'pack', 'pack.yaml', 'packs', 'parties', 'prevalence', 'profile_signal', 'provider_type', 'provider_types', 'realizations', 'recognition', 'related', 'rule', 'rules', 'scheme', 'schemes', 'selection_heuristics', 'service_categories', 'service_category', 'services', 'severity', 'source', 'sources', 'sources.yaml', 'sources_verified', 'suggests', 'summary', 'synonyms', 'templates', 'tension', 'tier_method', 'title', 'value', 'values', 'verified', 'version', 'when']
@@ -1,5 +1,23 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.6.0 (2026-11-05)
4
+
5
+ Additive. `ENGINE_VERSION` stays 0.3.0: no calculation changed. Validation now reports labelled placeholders and scenario placeholders, and `search_structures` rejects unfilled placeholders. The `base` pack is 0.2.0, so engagements that pin `base` 0.1.0 get a `PACK_VERSION` warning.
6
+
7
+ - `list_templates` lists core and pack templates, each labelled with its source; `pack` narrows it to one pack. The CLI's `cometric templates` lists all of them.
8
+ - Labelled placeholders: `"<required: unit rate, tier high>"` works like `"<required>"` and the label is reported in `REQUIRED_FIELD` (`detail.required_input`). Placeholders in scenarios are now reported as `REQUIRED_FIELD` too.
9
+ - `search_structures` rejects a spec whose engagement or scenarios still hold placeholders, except values a search parameter writes.
10
+ - `propose_structures` engine (`cometric.core.propose`): validates a deal profile (nearest valid value on errors), builds a lever pool from profile signals, priorities, and partner preferences, enumerates compositions, removes those that break the provider's volume-risk limit or a composition rule, evaluates fit and tension per priority, and lists candidates grouped by who absorbs a volume shortfall, with trade-offs, label assumptions, heuristic notes, evidence strength, the candidate's own inputs and the inputs all share, and on request a skeleton engagement with shared scenarios. Risk labels are checked against `derive_risk_exposure` on filled skeletons (T: P16).
11
+ - Surfaces: MCP tool `propose_structures` (20 tools) and a `propose_structures` prompt that walks an LLM through the partner conversation; CLI `cometric propose request.json [--expand ID] [--max N]`; `describe_schema("deal_profile")` and `("propose_options")`; a runnable `quickstart("propose_structures")` and a `propose_then_compare` note; glossary terms for the risk axes; `cometric.propose_structures` exported.
12
+ - `base` pack 0.2.0: realizations (how 8 pricing models and 12 levers become engagement terms, with risk labels and label effects), a `client_priorities` scheme, `profile_signal` predicates on the selection heuristics, and composition rules (COMP-001 to COMP-004). `validate-pack` assembles every model, alone and with each lever that applies, fills the placeholders with sample values, and fails if any scenario does not calculate. The ontology export includes realizations.
13
+
14
+ ## 0.5.0 (2026-11-05)
15
+
16
+ Additive; no breaking changes. `ENGINE_VERSION` stays 0.3.0: no calculation or fingerprint changed.
17
+
18
+ - Ontology export: `cometric ontology` prints the ontology as Turtle (OWL classes and properties for the input model, SKOS concept schemes for the core vocabularies and every pack, with overlays, rules, claims, and sources as typed resources). `cometric ontology --out DIR` also writes a Markdown reference. The generated reference is committed in `docs/ontology/`, and a test fails when it is stale.
19
+ - The glossary moved from the MCP server to `cometric.core.glossary`, so the ontology can use it without the `mcp` extra.
20
+
3
21
  ## 0.4.0 (2026-11-05)
4
22
 
5
23
  Additive; no breaking changes. `ENGINE_VERSION` stays 0.3.0 because no existing calculation changed. Fingerprints of existing scenarios still change, because the scenario schema gained fields with default values (`derived`, and `basis` on assumptions) that are part of the fingerprint.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: cometric
3
- Version: 0.4.0
3
+ Version: 0.6.0
4
4
  Summary: Commercial Intelligence Engine: model, simulate, and optimize the economics of service engagements.
5
5
  Project-URL: Homepage, https://github.com/mfbaig35r/cometric
6
6
  Project-URL: Repository, https://github.com/mfbaig35r/cometric
@@ -86,7 +86,7 @@ print(result["term"]["contribution_margin"], result["input_fingerprint"])
86
86
 
87
87
  ## MCP server
88
88
 
89
- Cometric ships a read-only, stateless MCP server: 19 tools (start with `quickstart`), schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and six guided prompts.
89
+ Cometric ships a read-only, stateless MCP server: 20 tools (start with `quickstart`; for a new deal, `propose_structures`), schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and seven guided prompts.
90
90
 
91
91
  ```bash
92
92
  cometric mcp # stdio
@@ -118,7 +118,7 @@ The HTTP transport keeps no session state, answers `GET /mcp` with 405, keeps DN
118
118
 
119
119
  ## Packs
120
120
 
121
- Packs are YAML only, with no executable code. `base` holds domain-neutral commercial knowledge: billing bases, 34 pricing models, 61 levers, 16 commercial dimensions, 49 metrics and indicators, cost categories, compatibility and reasoning rules, selection heuristics, mechanisms, and negotiation exchanges. `alsp` extends it for alternative legal services with service categories, unit templates, provider types, regulatory review rules, sector prevalence overlays, and evidence. `consulting` extends it for advisory work with realization and staffing concepts, outcome-fee review rules, and five templates: role-based time and materials, capped time and materials, phased fixed fee, hours-drawdown retainer, and fixed fee plus success fee.
121
+ Packs are YAML only, with no executable code. `base` holds domain-neutral commercial knowledge: billing bases, 34 pricing models, 70 levers, 16 commercial dimensions, 49 metrics and indicators, cost categories, compatibility and reasoning rules, selection heuristics, mechanisms, and negotiation exchanges. `alsp` extends it for alternative legal services with service categories, unit templates, provider types, regulatory review rules, sector prevalence overlays, and evidence. `consulting` extends it for advisory work with realization and staffing concepts, outcome-fee review rules, and five templates: role-based time and materials, capped time and materials, phased fixed fee, hours-drawdown retainer, and fixed fee plus success fee.
122
122
 
123
123
  ```bash
124
124
  cometric packs
@@ -126,6 +126,26 @@ cometric validate-pack alsp
126
126
  cometric validate-pack consulting
127
127
  ```
128
128
 
129
+ ## Proposing structures
130
+
131
+ `propose_structures` takes a short deal profile (unit of work and complexity tiers, volume certainty and figures, cost shape, one to three client priorities, the provider's limit on volume risk, term) and lists candidate structures, each a base pricing model plus levers. Candidates are grouped by who absorbs a volume shortfall and never ranked; each shows its risk allocation, which priorities it serves and where it falls short, what its labels assume, trade-offs, evidence strength, and the inputs to supply. It proposes no figures: expanded candidates are skeleton engagements with labelled placeholders and shared scenarios, ready for `compare_arrangements` once filled.
132
+
133
+ ```bash
134
+ cometric propose request.json # {packs, deal_profile, options}
135
+ cometric propose request.json --expand PM-011+CL-R01+CL-V07
136
+ ```
137
+
138
+ `quickstart("propose_structures")` returns a runnable request; the full contract is `docs/PROPOSE_STRUCTURES_SPEC_v0.2.md`.
139
+
140
+ ## Ontology
141
+
142
+ The ontology is published in [`docs/ontology/`](docs/ontology/README.md): diagrams of the core model, every field and controlled vocabulary, and a page per pack with each concept's definition, evidence class, relations, rules, claims, and sources. [`cometric.ttl`](docs/ontology/cometric.ttl) holds the same content in Turtle (OWL classes for the core model, SKOS concept schemes for vocabularies and packs), for Protégé, rdflib, or any SPARQL store. Both are generated from the package, and a test fails when the committed copy is out of date.
143
+
144
+ ```bash
145
+ cometric ontology > cometric.ttl # Turtle to stdout
146
+ cometric ontology --out docs/ontology # regenerate the reference
147
+ ```
148
+
129
149
  ## Development
130
150
 
131
151
  ```bash
@@ -135,7 +155,7 @@ uv run ruff check src tests scripts && uv run ruff format --check src tests scri
135
155
  uv run python scripts/build_fixtures.py # regenerate casebook fixtures
136
156
  ```
137
157
 
138
- The specification is `docs/COMETRIC_SPEC_v0.3.md` (normative for 0.1.0). Implementation status is in `docs/STATUS.md`; worked commercial patterns (tiered minimums, transition credits, partial billing, cost from hours, early termination) are in `docs/PATTERNS.md`; reconciling a real engagement is described in `docs/RECONCILIATION.md`.
158
+ The specification is `docs/COMETRIC_SPEC_v0.3.md`; the ontology reference is `docs/ontology/`. Implementation status is in `docs/STATUS.md`; worked commercial patterns (tiered minimums, transition credits, partial billing, cost from hours, early termination) are in `docs/PATTERNS.md`; reconciling a real engagement is described in `docs/RECONCILIATION.md`.
139
159
 
140
160
  ## License
141
161
 
@@ -56,7 +56,7 @@ print(result["term"]["contribution_margin"], result["input_fingerprint"])
56
56
 
57
57
  ## MCP server
58
58
 
59
- Cometric ships a read-only, stateless MCP server: 19 tools (start with `quickstart`), schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and six guided prompts.
59
+ Cometric ships a read-only, stateless MCP server: 20 tools (start with `quickstart`; for a new deal, `propose_structures`), schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and seven guided prompts.
60
60
 
61
61
  ```bash
62
62
  cometric mcp # stdio
@@ -88,7 +88,7 @@ The HTTP transport keeps no session state, answers `GET /mcp` with 405, keeps DN
88
88
 
89
89
  ## Packs
90
90
 
91
- Packs are YAML only, with no executable code. `base` holds domain-neutral commercial knowledge: billing bases, 34 pricing models, 61 levers, 16 commercial dimensions, 49 metrics and indicators, cost categories, compatibility and reasoning rules, selection heuristics, mechanisms, and negotiation exchanges. `alsp` extends it for alternative legal services with service categories, unit templates, provider types, regulatory review rules, sector prevalence overlays, and evidence. `consulting` extends it for advisory work with realization and staffing concepts, outcome-fee review rules, and five templates: role-based time and materials, capped time and materials, phased fixed fee, hours-drawdown retainer, and fixed fee plus success fee.
91
+ Packs are YAML only, with no executable code. `base` holds domain-neutral commercial knowledge: billing bases, 34 pricing models, 70 levers, 16 commercial dimensions, 49 metrics and indicators, cost categories, compatibility and reasoning rules, selection heuristics, mechanisms, and negotiation exchanges. `alsp` extends it for alternative legal services with service categories, unit templates, provider types, regulatory review rules, sector prevalence overlays, and evidence. `consulting` extends it for advisory work with realization and staffing concepts, outcome-fee review rules, and five templates: role-based time and materials, capped time and materials, phased fixed fee, hours-drawdown retainer, and fixed fee plus success fee.
92
92
 
93
93
  ```bash
94
94
  cometric packs
@@ -96,6 +96,26 @@ cometric validate-pack alsp
96
96
  cometric validate-pack consulting
97
97
  ```
98
98
 
99
+ ## Proposing structures
100
+
101
+ `propose_structures` takes a short deal profile (unit of work and complexity tiers, volume certainty and figures, cost shape, one to three client priorities, the provider's limit on volume risk, term) and lists candidate structures, each a base pricing model plus levers. Candidates are grouped by who absorbs a volume shortfall and never ranked; each shows its risk allocation, which priorities it serves and where it falls short, what its labels assume, trade-offs, evidence strength, and the inputs to supply. It proposes no figures: expanded candidates are skeleton engagements with labelled placeholders and shared scenarios, ready for `compare_arrangements` once filled.
102
+
103
+ ```bash
104
+ cometric propose request.json # {packs, deal_profile, options}
105
+ cometric propose request.json --expand PM-011+CL-R01+CL-V07
106
+ ```
107
+
108
+ `quickstart("propose_structures")` returns a runnable request; the full contract is `docs/PROPOSE_STRUCTURES_SPEC_v0.2.md`.
109
+
110
+ ## Ontology
111
+
112
+ The ontology is published in [`docs/ontology/`](docs/ontology/README.md): diagrams of the core model, every field and controlled vocabulary, and a page per pack with each concept's definition, evidence class, relations, rules, claims, and sources. [`cometric.ttl`](docs/ontology/cometric.ttl) holds the same content in Turtle (OWL classes for the core model, SKOS concept schemes for vocabularies and packs), for Protégé, rdflib, or any SPARQL store. Both are generated from the package, and a test fails when the committed copy is out of date.
113
+
114
+ ```bash
115
+ cometric ontology > cometric.ttl # Turtle to stdout
116
+ cometric ontology --out docs/ontology # regenerate the reference
117
+ ```
118
+
99
119
  ## Development
100
120
 
101
121
  ```bash
@@ -105,7 +125,7 @@ uv run ruff check src tests scripts && uv run ruff format --check src tests scri
105
125
  uv run python scripts/build_fixtures.py # regenerate casebook fixtures
106
126
  ```
107
127
 
108
- The specification is `docs/COMETRIC_SPEC_v0.3.md` (normative for 0.1.0). Implementation status is in `docs/STATUS.md`; worked commercial patterns (tiered minimums, transition credits, partial billing, cost from hours, early termination) are in `docs/PATTERNS.md`; reconciling a real engagement is described in `docs/RECONCILIATION.md`.
128
+ The specification is `docs/COMETRIC_SPEC_v0.3.md`; the ontology reference is `docs/ontology/`. Implementation status is in `docs/STATUS.md`; worked commercial patterns (tiered minimums, transition credits, partial billing, cost from hours, early termination) are in `docs/PATTERNS.md`; reconciling a real engagement is described in `docs/RECONCILIATION.md`.
109
129
 
110
130
  ## License
111
131
 
@@ -1,6 +1,6 @@
1
1
  # Cometric | Commercial Intelligence Engine
2
2
 
3
- **Engineering Requirements v0.3 (as built for 0.4.0)**
3
+ **Engineering Requirements v0.3 (as built for 0.6.0)**
4
4
 
5
5
  Cometric does three things:
6
6
 
@@ -13,7 +13,7 @@ It is built for any service relationship priced through a composite arrangement:
13
13
  | | |
14
14
  |---|---|
15
15
  | Project | Cometric (`cometric` on PyPI; CLI and MCP server `cometric`) |
16
- | Status | Normative for `cometric` 0.4.0 (0.1.0 released 2026-11-04; 0.2.0, 0.3.0, and 0.4.0 on 2026-11-05). Open-source project. Where this document and the code disagree, the code's tests are the tiebreaker and the disagreement is a defect in one of them. |
16
+ | Status | Normative for `cometric` 0.6.0 (0.1.0 released 2026-11-04; 0.2.0 to 0.6.0 on 2026-11-05). Open-source project. Where this document and the code disagree, the code's tests are the tiebreaker and the disagreement is a defect in one of them. |
17
17
  | License | Apache-2.0 |
18
18
  | Date | November 4, 2026 |
19
19
  | Supersedes | `COMETRIC_SPEC_v0.2.md` (kept for history, with the v0.1 to v0.2 change log) |
@@ -58,6 +58,8 @@ v0.3 records what was built. Most changes resolve questions v0.2 left implicit;
58
58
  | V3-23 | 4.2, 9 | ALL_UNITS cliff bands compare every earlier tier with each threshold, with an inclusive lower bound where a band starts at a tier edge (0.2.0). |
59
59
  | V3-24 | 8.3, 9, 10 | `reconcile` operation for M6, with a publishable summary (0.2.0). |
60
60
  | V3-30 | 6.1, 6.4, 9 | Counting rules through RATE assumptions and derived quantities; search parameters can set a named assumption (0.4.0). |
61
+ | V3-31 | 3.7, 9 | Ontology export: Turtle (OWL and SKOS) and a Markdown reference generated from the models, core vocabularies, and packs; committed in `docs/ontology/` (0.5.0). |
62
+ | V3-32 | 3.6, 6.5, 8.3, 9 | `propose_structures`: candidate structures for a deal profile from pack realizations, listed by who absorbs a volume shortfall, never ranked; P-03 amended; labelled placeholders; pack-aware `list_templates` (0.6.0). Full specification: `docs/PROPOSE_STRUCTURES_SPEC_v0.2.md`. |
61
63
  | V3-28 | 4.4, 6.1, 9 | Termination scenarios: `termination_date` on a scenario, `termination_rule` on minimums, `termination_fee` on a version (0.3.0). |
62
64
  | V3-29 | 3.4, 6.3, App. C | ALSP template `tiered_units_annual_minimum` and five worked patterns (`docs/PATTERNS.md`); "pending human review" defined (0.3.0). |
63
65
  | V3-27 | 6.2, 6.4, 8.3, 11 | Search returns best results first with full figures, tie-breakers, constraint results, grid-edge warnings, and baseline differences; dry run; linked and scaled parameters; detail and precision levels; the server stays stateless (0.3.0). |
@@ -335,10 +337,22 @@ The research report itself is not shipped as prose (§11, Q-3). It is decomposed
335
337
 
336
338
  **Rules:**
337
339
 
338
- - Knowledge records are advisory and explanatory. The engine computes only from core vocabulary, methods, and caller policies. It never reads selection heuristics, negotiation exchanges, mechanisms, or compatibility classes to compute, rank, or choose (P-03).
340
+ - Knowledge records are advisory and explanatory. The engine computes only from core vocabulary, methods, and caller policies. It never reads selection heuristics, negotiation exchanges, mechanisms, or compatibility classes to compute or rank (P-03). `propose_structures` may read composition rules to exclude a structure and heuristics and evidence to annotate one; no knowledge record computes a figure or ranks `[V3-32]`.
339
341
  - Every record keeps its evidence class. A class C or D record is always returned labeled as inference or proposal.
340
342
  - Capture is auditable: every report identifier, and every row of the unnumbered tables above, appears in a pack or in `packs/base/excluded.yaml` with a reason (T-033).
341
343
 
344
+ ### 3.7 Ontology export `[V3-31]`
345
+
346
+ The ontology is a generated view of what the engine accepts, never a separate source of truth. `cometric ontology` emits it as Turtle:
347
+
348
+ | Layer | Representation | Namespace |
349
+ |---|---|---|
350
+ | Core model (every class reachable from Engagement, Scenario, CostPolicy, TolerancePolicy) | `owl:Class`; each field an `owl:ObjectProperty` or `owl:DatatypeProperty` with domain, range, required, multiple, and default. Fields that hold another object's id are object properties marked `cm:referencedById`. | `cm:` |
351
+ | Core vocabularies and the glossary | `skos:ConceptScheme` (also an `owl:Class`) with one `skos:Concept` per value | `cmv:` |
352
+ | Packs | One `skos:ConceptScheme` per concept file; concepts carry `skos:broader`, `skos:related`, billing bases, methods, evidence class, prevalence, claims, and caveats. Overlays, rules, claims, and sources are `cm:Overlay`, `cm:Rule`, `cm:Claim`, `cm:Source`. | `pack-<id>:` |
353
+
354
+ Concept ids are unique within a pack chain, not across packs, so a reference resolves through the referring pack's chain. `cometric ontology --out DIR` also writes a Markdown reference (one diagram per aggregate, a table of references by id, field tables, one page per pack). The copy in `docs/ontology/` is committed; a test regenerates it and fails on any difference, and fails on any reference to an undeclared resource.
355
+
342
356
  ## 4. Contract and fee semantics
343
357
 
344
358
  ### 4.1 Fee component contract
@@ -724,6 +738,10 @@ In Cometric, "optimize" means a deterministic search over a space of candidate s
724
738
 
725
739
  **Guardrails.** Results are `PricingRecommendation` records with `approval_state = PENDING_HUMAN_REVIEW` (§6.3). The engine never invents parameter ranges or objectives. An advisory agent may propose a `search_spec`, and the spec must be shown to the user before it runs.
726
740
 
741
+ ### 6.5 Structure proposal `[V3-32]`
742
+
743
+ `propose_structures(packs, deal_profile, options?)` answers the question before comparison: which structures are worth modelling. The deal profile states the unit of work (and complexity tiers), volume certainty and any figures, cost shape, one to three ordered client priorities, the provider's limit on volume risk, and the term. Candidates are compositions of a base pricing model and up to three levers, built from pack **realizations** that say how each model and lever becomes engagement terms and how it allocates risk on five axes (volume shortfall, volume excess, spend variability, mix, early exit). The partner's inputs and composition rules decide what is listed; heuristics and evidence only annotate. Candidates are grouped by who absorbs a volume shortfall, never ranked, and carry trade-offs, label assumptions, evidence strength, and the inputs to supply. `options.expand` returns skeleton engagements with labelled placeholders (`"<required: label>"`) and scenarios shared by every candidate, so a comparison runs on identical volumes. No figure is generated. Risk labels use `derive_risk_exposure`'s meaning, and a test checks them against it on filled skeletons. The full contract, pack data formats, and acceptance tests are in `docs/PROPOSE_STRUCTURES_SPEC_v0.2.md`.
744
+
727
745
  ## 7. Evidence and governance
728
746
 
729
747
  ### 7.1 Evidence classes
@@ -912,12 +930,14 @@ The CLI, Python API, and MCP server expose the same operations. Every operation
912
930
 
913
931
  - `describe_schema(model) -> json_schema` for any input or output model
914
932
  - `list_packs() -> [{id, version, summary}]` and `describe_pack(id) -> vocabularies, rules, templates`
915
- - `get_template(template_id, pack?) -> engagement skeleton` with required fields present and unknown values marked `"<required>"`
933
+ - `list_templates(pack?) -> core and pack templates with their source` `[V3-32]`
934
+ - `get_template(template_id, pack?) -> engagement skeleton` with required fields present and unknown values marked `"<required>"` or `"<required: label>"`
916
935
  - `list_vocabulary(name, pack?) -> values with definitions`
917
936
  - `lookup_concept(id_or_query, pack?) -> concept records` with definitions, links, evidence class, prevalence overlays, and claims
918
937
 
919
938
  **Engine:**
920
939
 
940
+ - `propose_structures(packs, deal_profile, options?) -> structure proposal` `[V3-32]`
921
941
  - `validate_engagement(input) -> validation_report`
922
942
  - `calculate_periods(engagement, scenario, cost_policy, detail?) -> calculation_result`
923
943
  - `compare_arrangements(candidates, scenario_set, cost_policy, objective?, tolerance_policy?) -> comparison_result`
@@ -936,7 +956,7 @@ The CLI, Python API, and MCP server expose the same operations. Every operation
936
956
 
937
957
  - `reconcile(engagement, scenario, cost_policy, actuals, tolerance_absolute?, tolerance_relative?) -> reconciliation_result`. `actuals` holds recorded figures by month and for the term, as decimal strings or integers. Each compared figure passes within either tolerance (both non-negative). Unknown metrics, malformed months, floats, nulls, and negative tolerances are errors with JSON Pointer paths, never silently skipped. A metric the engine did not compute (costs without a cost policy, realization without a rate card) is reported as not computed, never as zero. Status is `reconciled`, `discrepancies`, `infeasible` (the scenario breaches capacity, so matching figures do not reconcile it), `nothing_compared`, or `invalid`. Failing monthly rows carry that month's fee line items. The result carries its own fingerprint over the inputs, actuals, and tolerances, plus the underlying calculation's fingerprint. `publishable_summary` carries only metric, month of the engagement term (1 = first month of the engagement), relative difference, direction, and the mechanisms priced that month; no amounts, dates, or names.
938
958
 
939
- The MCP server exposes 19 tools, starting with `quickstart`, which returns the conventions and, per tool, a complete runnable argument object (each one is executed by the test suite). `[V3-26]` The others are the operations above plus `describe_schema`, `list_packs`, `describe_pack`, `list_templates`, `get_template`, `list_vocabulary`, and `lookup_concept`; `reconcile` is the 18th. `[V3-17]`
959
+ The MCP server exposes 20 tools, starting with `quickstart`, which returns the conventions and, per tool, a complete runnable argument object (each one is executed by the test suite). `[V3-26]` The others are the operations above plus `describe_schema`, `list_packs`, `describe_pack`, `list_templates`, `get_template`, `list_vocabulary`, and `lookup_concept`; `reconcile` is the 18th and `propose_structures` the 20th. `[V3-17]`
940
960
 
941
961
  **MCP server requirements:**
942
962
 
@@ -1051,6 +1071,8 @@ The test suite MUST include:
1051
1071
  | T-044 | LLM-feedback fixes `[V3-26]` | Threshold discount and rebate: EXCESS_ONLY 3,175,000 and ENTIRE_SUBTOTAL 2,925,000 on a 3,250,000 gross with a 2,500,000 threshold; the excess discount starts in the crossing month; missing scope or period is an error with an example; several unit types give a null unit price with a warning, and `client_value_unit` with `+` sums them; bare-engagement candidates work and bad ones get a pointer; the constraint `op` alias works; no tool returns an unstructured error; every quickstart payload runs through the MCP server |
1052
1072
  | T-045 | Termination `[V3-28]` | PRORATE charges the shortfall against 150,000 x 181/365 at a 30 June termination; REMAINDER_DUE charges 90,000 for one year and 240,000 with a second year, and owes later years at a period-end termination; WAIVED charges none; the fee posts; quantities spread over the original term; unamortized transition is written off; a cut-short outcome fee is not charged; a missing rule, an out-of-range date, and a mid-month date without proration are errors |
1053
1073
  | T-046 | Patterns `[V3-29]` | Every pattern file matches figures computed by hand in `scripts/build_alsp.py`; the ALSP template round-trips |
1074
+ | T-049 to T-066 | Structure proposal `[V3-32]` | P01 to P18 of `docs/PROPOSE_STRUCTURES_SPEC_v0.2.md`: candidates span shortfall groups; skeletons validate except labelled placeholders and calculate when filled; unfilled skeletons are rejected by compare and search; output is deterministic, carries no generated figure, reports exclusions with rule ids, honours partner lever preferences and the provider's risk limit, flags weak evidence, and stays under 8,000 characters; risk labels agree with `derive_risk_exposure`; `validate-pack` rejects broken realizations |
1075
+ | T-048 | Ontology export `[V3-31]` | The Turtle parses; every pack concept, rule, claim, and source is typed; no reference points to an undeclared resource; every model field is a property; the README's example query returns rows; the committed `docs/ontology/` matches the generator |
1054
1076
  | T-047 | Counting rules `[V3-30]` | A RATE assumption applies each month; a derived billable quantity prices correctly; rounding is required for COUNT units and applied per month; bad expressions, unknown references, cycles, division by zero, negative results, and name clashes are errors with paths; search can vary an assumption; the counting-rules pattern matches its hand-computed fee |
1055
1077
  | T-042 | Reconciliation `[V3-24]` | Actuals equal to computed figures reconcile; a changed July invoice is reported at month 7 with the mechanism that priced it; the publishable summary contains no amounts, dates, or names; relative tolerance and unknown metrics are honored |
1056
1078
 
@@ -65,3 +65,16 @@ Other termination rules: `REMAINDER_DUE` charges this period's full minimum and
65
65
  Monthly billable units become 42.75 / 17.1 / 51.3 / 79.0875 instead of 50 / 20 / 60 / 80, so the year bills 3,552,525 before the discount and 3,497,272.50 after it, against 3,972,000 without the rules. The counts are fractional expected values (`rounding: NONE`); use `HALF_UP`, `DOWN`, or `UP` to bill whole units each month.
66
66
 
67
67
  Monthly totals cannot show which documents arrive together, so the bundle share and size are assumptions, not facts. Search them by adding a parameter such as `{"name": "reissue", "assumption": "reissue_rate", "values": ["0", "0.05", "0.10"]}`.
68
+
69
+ ## 7. Starting from a deal profile
70
+
71
+ `quickstart("propose_structures")`. A contract-review deal: three complexity tiers, 400 to 1,500 requests a year (1,200 expected), a fixed team, a 24-month term the client can exit early, and the client wants budget certainty first and to pay for use second; the provider accepts at most a shared volume risk. The proposal lists four candidates:
72
+
73
+ | Candidate | Volume shortfall | Spend | Serves | Falls short on |
74
+ |---|---|---|---|---|
75
+ | Dedicated team priced per FTE (PM-004) | CLIENT | FIXED | budget certainty | pay for use |
76
+ | Fixed-fee managed service (PM-007) | CLIENT | FIXED | budget certainty | pay for use |
77
+ | Per-unit pricing with a minimum and an annual cap (PM-011 + CL-R01 + CL-V07) | SHARED | BOUNDED | both | |
78
+ | Volume-banded unit pricing with an annual cap (PM-014 + CL-V07) | SHARED | BOUNDED | both | |
79
+
80
+ Per-unit pricing alone is excluded because the provider would carry the whole shortfall. The fixed fee carries a validation approval: nothing bounds the provider's volume exposure. The minimum's label assumes it sits below expected spend, and the banded structure's assumes expected volume reaches the cheaper band. Expanding two candidates gives skeletons with identical scenarios (low, expected, high as term totals, tier shares as derived quantities, and an early-exit case); once their rates, minimum, cap, and costs are filled, `compare_arrangements` runs on them unchanged, and `derive_risk_exposure` confirms each shortfall label. The figures are the partner's; the tool supplies none.