cometric 0.1.0__tar.gz → 0.2.0__tar.gz

cometric-0.1.0/.hypothesis/constants/c0553da3badd1746 → cometric-0.2.0/.hypothesis/constants/052e28aa39cf014b

@@ -1,4 +1,4 @@
 # file: /home/runner/work/cometric/cometric/src/cometric/__init__.py
 # hypothesis_version: 6.170.14
 
-['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', 'search_structures', 'validate_engagement']
+['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']

cometric-0.2.0/.hypothesis/constants/6f3f7dda3bd02709

@@ -0,0 +1,4 @@
+# file: /home/runner/work/cometric/cometric/src/cometric/core/engine.py
+# hypothesis_version: 6.170.14
+
+['-', '/calculation_method', '/driver', '/outcome/metric', '/quantity_source', '/scenario/horizon', '0.2.0', ':', 'BACKLOG', 'CAPACITY_BREACH', 'DRIVER_REQUIRED', 'FTE', 'LEDGER_INVARIANT', 'METHOD_NOT_SUPPORTED', 'MISSING_ASSUMPTION', 'OVERFLOW_COST', 'SEGMENTED_MONTH', 'UNKNOWN_WEIGHT_TABLE', 'adjustments', 'allowance_consumed', 'allowance_granted', 'amortized', 'amount', 'amount_unrounded', 'arrangement_versions', 'backlog_end', 'by_category', 'cap', 'cap_use', 'capacity', 'capacity_utilization', 'category', 'collar', 'commitment_shortfall', 'component', 'components', 'contractual_fee', 'contribution_margin', 'contribution_profit', 'cost_components', 'cost_per_unit', 'costs_by_category', 'ctier', 'delivery_plan', 'demand', 'demand_hours', 'direct_delivery_cost', 'discount', 'driver_quantity', 'elig', 'engagement', 'fixed', 'formula', 'full_cost_profit', 'gross_margin', 'gross_profit', 'hours', 'id', 'incurred', 'incurred_adjustment', 'indexation', 'infeasible', 'kind', 'layer', 'layers', 'margin_note', 'min', 'minimum', 'minimum_shortfall', 'months', 'ok', 'one-time fee', 'one_time', 'outcome', 'outcome_fee', 'overage', 'overage_fee', 'overflow', 'overflow_cost_rate', 'performance', 'period', 'periods', 'price', 'productive_hours', 'project_payment', 'quantity', 'rate', 'realization', 'rebate', 'ref', 'resource', 'safe_capacity_hours', 'scenario.', 'segment', 'served', 'stage', 'standard_value', 'step', 'term', 'tier', 'time', 'trigger', 'unit', 'unit_contribution', 'version', 'weighted:', 'worked_hours', 'worked_hours_source', 'write_down', 'years']

cometric-0.2.0/.hypothesis/constants/8263d258dca94122

@@ -0,0 +1,4 @@
+# file: /home/runner/work/cometric/cometric/src/cometric/mcp/server.py
+# hypothesis_version: 6.170.14
+
+[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', 'GET', 'accumulation_period', 'application/json', 'areas', 'body', 'claims', 'cometric', 'cometric://glossary', 'concept', 'concept-scheme', 'contractual_fee', 'contribution_profit', 'cost_policy', 'coverage', 'derived_bearer', 'dominance', 'engagement', 'engine_version', 'evidence_class', 'example', 'examples', 'glossary', 'gross_profit', 'headers', 'http', 'http.response.body', 'http.response.start', 'id', 'label', 'localhost', 'localhost:*', 'margin', 'margin_layer', 'method', 'name', 'origin', 'outcome_fee', 'overlays', 'pack', 'pack-template', 'packs', 'path', 'prevalence', 'price_floor', 'query', 'realization', 'recognition', 'reference', 'results', 'rules', 'schema', 'schema_version', 'search_structures', 'source_records', 'sources', 'status', 'stdio', 'summary', 'template', 'templates', 'terms', 'type', 'validate_engagement', 'values']

cometric-0.1.0/.hypothesis/constants/3d80302e16570458 → cometric-0.2.0/.hypothesis/constants/b428358d86c25f38

@@ -1,4 +1,4 @@
 # file: /home/runner/work/cometric/cometric/src/cometric/core/tiers.py
 # hypothesis_version: 6.170.14
 
-['band_lower_exclusive', 'band_upper_exclusive', 'threshold']
+['band_lower', 'band_lower_inclusive', 'band_upper_exclusive', 'threshold']

cometric-0.2.0/.hypothesis/constants/f33d5940d4c83207

@@ -0,0 +1,4 @@
+# file: /home/runner/work/cometric/cometric/src/cometric/core/api.py
+# hypothesis_version: 6.170.14
+
+[10000, '/', '/actuals', '/actuals/term', '/constraints', '/cost_policy', '/driver', '/parameters', '/results', '/risk_premium', '/target_margin', '/tolerance_absolute', '/tolerance_relative', '0', '0.01', '?', 'BAD_CONSTRAINT', 'BAD_POINTER', 'BASE', 'COSTS_NOT_EVALUATED', 'COST_POLICY_REQUIRED', 'INTERNAL_POLICY', 'NO_RESULTS', 'PARAMETER_SPEC', 'PENDING_HUMAN_REVIEW', 'RANGE', 'RISK_MISMATCH', 'RISK_PREMIUM_RANGE', 'SCENARIO_INFEASIBLE', 'SCHEMA', 'TARGET_MARGIN_RANGE', 'TERM', 'UNKNOWN_DRIVER', 'UNKNOWN_METRIC', 'WORST', '_doc', 'absolute', 'actual', 'actuals', 'aggregation', 'approval_state', 'assumptions', 'base', 'base_client_price', 'base_contribution', 'base_scenario', 'base_scenario_id', 'best_under_objective', 'binding_constraints', 'calculate_periods', 'calculated', '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_fee', 'declared_bearer', 'decreasing', 'derived_bearer', 'deviations', 'difference', 'direct_delivery_cost', 'direction', 'discrepancies', 'distribution', 'dominated_by', 'driver', 'engagement', 'engagement_id', 'engine_version', 'enumerated', 'errors', '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_cost_profit', 'grid_size', 'gross_margin', 'gross_profit', 'gt', 'gte', 'headroom', 'horizon', 'id', 'increasing', 'infeasible', 'input_fingerprint', 'invalid', 'invalid_reasons', 'issues', 'labels', 'ledger', 'line_items', 'lt', 'lte', 'max', 'max_candidates', 'max_returned', 'measured', 'mechanisms_priced', 'message', 'metric', 'metrics', 'min', 'money_policy', 'month', 'must not be negative', 'name', 'non_dominated', 'note', 'nothing_compared', 'objective', 'ok', 'on_frontier', 'op', 'operation', 'origin', 'outcome_fee', 'overage_fee', 'packs', 'parameters', 'path', 'period', 'periods', 'pointer', 'price_floor', 'profile', 'provider_downside', 'publishable_summary', 'range', 'ranking', 'reason', 'reconcile', 'reconciled', 'record_type', 'rejected', 'relative', 'relative_difference', 'results', 'risk_exposure', 'risk_premium', 'rows', 'rules_fired', 'scenario', 'scenario_id', 'scenarios', 'schema_version', 'scope', 'sense', 'standard_value', 'status', 'step', 'summary', 'target_margin', 'term', 'threshold', 'time_period', 'to', 'tolerance', 'unit_contribution', 'unit_floor', 'valid', 'value', 'values', 'volume', 'volume_quantity', 'warnings', 'whole', 'within_tolerance', 'worked_hours', 'years', '~', '~0', '~1']

cometric-0.2.0/.hypothesis/constants/fbe7b640dc5ad53e

@@ -0,0 +1,4 @@
+# file: /home/runner/work/cometric/cometric/src/cometric/core/validation.py
+# hypothesis_version: 6.170.14
+
+['/', '/cost_policy', '/engagement', '/horizon', '/mapping', '/scenario', '; ', '<required>', 'ADJUSTMENT_FIELDS', 'APPROVAL_REQUIRED', 'ATTRIBUTION_METHOD', 'ATTRIBUTION_REQUIRED', 'BASELINE_REQUIRED', 'CAP needs amount', 'COMMITMENT_SCOPE', 'COST_FIELDS', 'CURRENCY_MISMATCH', 'DANGLING_DEPENDENCY', 'DATE_ORDER', 'DEPENDENCY_CYCLE', 'DEPENDENCY_MISSING', 'DUPLICATE_ID', 'EMPTY_VERSION', 'ERROR', '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', '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', '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', 'tier_method', 'tiers', 'trigger', 'unit', 'unit_definition_id', 'unit_definitions', 'upper_exclusive', 'valid', 'warnings', 'weight_table_id', 'weight_tables']

cometric-0.2.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+## 0.2.0 (2026-11-05)
+
+- `reconcile`: compare computed figures with recorded actuals by month and term, with a publishable summary that carries no amounts, dates, or names (API, CLI, MCP tool). Guide in `docs/RECONCILIATION.md`.
+- Fix: ALL_UNITS cliff detection now reports bands across non-adjacent tiers, with an inclusive lower bound where a band starts at a tier edge. Found by property testing.
+- MCP resource `cometric://packs/{pack}/templates/{id}`; CLI `templates --pack` and `template --pack`.
+- `TIER_CLIFF` warnings: one per threshold with a `bands` list (lower, lower_inclusive, upper_exclusive), replacing the single `band` pair.
+- Fixed from code review of `reconcile`: uncalculated costs are reported as not computed instead of zero (decided once in the shared calculation step); invalid actuals and tolerances return issues instead of raising; infeasible scenarios never report `reconciled`; unknown metrics are errors; the result has its own fingerprint over actuals and tolerances; month numbers count from the engagement start; repeated scans removed.
+- Fixed from the full engine review (calculation changes, so `ENGINE_VERSION` moves to 0.2.0):
+  - `FULL_MONTH_FROM_CURRENT` and `FULL_MONTH_FROM_NEXT` now bill the whole month instead of prorating by component dates.
+  - A fixed project payment due in a month split between contract versions is no longer dropped.
+  - A horizon that starts after the engagement simulates from the engagement start, so allowances, tiers, minimums, caps, and outcome periods carry into it; year and term assumptions spread over the engagement's months.
+  - One-time fees are never prorated; quarterly and annual fees keep their declared totals and anchor at the component start.
+  - Collars reprice at the cumulative tier position.
+  - Indexation applies to period-end overage as well as cumulative overage, not to project payments or outcome fees, and contract years honor the start day.
+  - Term costs that start later keep their declared total.
+  - The incurred-view adjustment ignores portfolio and overhead costs.
+  - A performance trigger missing from the scenario is an error; the price floor reports missing costs as an issue.
+  - Components are evaluated in id order, so results never depend on list order.
+  - Rebates settled after the horizon raise `TRUE_UP_OUTSIDE_HORIZON`.
+- Spec v0.3.
+
+## 0.1.0 (2026-11-04)
+
+First release.
+
+- Core engine: deterministic decimal monthly calculation with the specified evaluation order (allowances, tiers, collars, discounts, minimums, performance adjustments, caps), accumulation periods, entitlement ledger with rollover, proration, exact allocation, margin-layer cost policies, capacity breach modes, and input fingerprints.
+- Fee methods: fixed recurring, time, dedicated resource, unit output, weighted unit output, allowance plus overage, fixed project, and outcome adjustment (gain-share, success fee, percent of outcome).
+- Realization against a standard rate card: standard value, realization, write-down, effective billing rate.
+- Operations: validate, calculate, explain, compare (dominance), structure search (frontier), risk exposure, price floor, break-even, and commercial constraint checks.
+- Packs (data only): `base`, `alsp`, and `consulting`, with evidence records and verification status.
+- Interfaces: CLI and a read-only MCP server (stdio and stateless HTTP) with discovery tools, resources, and guided prompts.
+- Casebook fixtures A to H.

{cometric-0.1.0 → cometric-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cometric
-Version: 0.1.0
+Version: 0.2.0
 Summary: Commercial Intelligence Engine: model, simulate, and optimize the economics of service engagements.
 Project-URL: Homepage, https://github.com/mfbaig35r/cometric
 Project-URL: Repository, https://github.com/mfbaig35r/cometric
@@ -51,10 +51,12 @@ It is built for any service relationship priced through a composite arrangement:
 ## Install
 
 ```bash
-uv pip install "cometric[mcp]"        # once published
+pip install "cometric[mcp]"           # or: uv pip install "cometric[mcp]"
 uv sync --all-extras                  # from a checkout
 ```
 
+[![PyPI](https://img.shields.io/pypi/v/cometric)](https://pypi.org/project/cometric/)
+
 Python 3.11 or later.
 
 ## Quickstart
@@ -66,6 +68,8 @@ cometric explain src/cometric/examples/spec_example.json --period 2027-01
 cometric break-even src/cometric/examples/case_b.json --driver contracts --scenario base --cost-policy reference
 cometric floor src/cometric/examples/case_b.json --cost-policy reference --target-margin 0.20
 cometric template base_plus_overage
+cometric template phased_fixed_fee --pack consulting
+cometric reconcile engagement.json --scenarios actual-quantities.json --actuals actuals.json --cost-policy reference --summary-only
 cometric lookup PM-023
 ```
 
@@ -81,7 +85,7 @@ print(result["term"]["contribution_margin"], result["input_fingerprint"])
 
 ## MCP server
 
-Cometric ships a read-only, stateless MCP server: 17 tools, schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and six guided prompts.
+Cometric ships a read-only, stateless MCP server: 18 tools, schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and six guided prompts.
 
 ```bash
 cometric mcp                                   # stdio
@@ -92,7 +96,7 @@ cometric mcp --transport http --port 8765      # stateless streamable HTTP at PO
 Claude Code:
 
 ```bash
-claude mcp add cometric -- uv run --directory /path/to/cometric cometric mcp
+claude mcp add cometric -- uvx --from "cometric[mcp]" cometric mcp
 ```
 
 The HTTP transport keeps no session state, answers `GET /mcp` with 405, keeps DNS-rebinding protection on (set `COMETRIC_ALLOWED_HOSTS` for your hostname), and checks a bearer token when `COMETRIC_MCP_TOKEN` is set.
@@ -130,7 +134,7 @@ uv run ruff check src tests scripts && uv run ruff format --check src tests scri
 uv run python scripts/build_fixtures.py   # regenerate casebook fixtures
 ```
 
-The specification is in `docs/COMETRIC_SPEC_v0.2.md`. Implementation status and clarifications are in `docs/STATUS.md`.
+The specification is `docs/COMETRIC_SPEC_v0.3.md` (normative for 0.1.0). Implementation status is in `docs/STATUS.md`; reconciling a real engagement is described in `docs/RECONCILIATION.md`.
 
 ## License
 

{cometric-0.1.0 → cometric-0.2.0}/README.md

@@ -21,10 +21,12 @@ It is built for any service relationship priced through a composite arrangement:
 ## Install
 
 ```bash
-uv pip install "cometric[mcp]"        # once published
+pip install "cometric[mcp]"           # or: uv pip install "cometric[mcp]"
 uv sync --all-extras                  # from a checkout
 ```
 
+[![PyPI](https://img.shields.io/pypi/v/cometric)](https://pypi.org/project/cometric/)
+
 Python 3.11 or later.
 
 ## Quickstart
@@ -36,6 +38,8 @@ cometric explain src/cometric/examples/spec_example.json --period 2027-01
 cometric break-even src/cometric/examples/case_b.json --driver contracts --scenario base --cost-policy reference
 cometric floor src/cometric/examples/case_b.json --cost-policy reference --target-margin 0.20
 cometric template base_plus_overage
+cometric template phased_fixed_fee --pack consulting
+cometric reconcile engagement.json --scenarios actual-quantities.json --actuals actuals.json --cost-policy reference --summary-only
 cometric lookup PM-023
 ```
 
@@ -51,7 +55,7 @@ print(result["term"]["contribution_margin"], result["input_fingerprint"])
 
 ## MCP server
 
-Cometric ships a read-only, stateless MCP server: 17 tools, schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and six guided prompts.
+Cometric ships a read-only, stateless MCP server: 18 tools, schema and template discovery, resources for the glossary, schemas, concept schemes, rules, coverage, templates, and worked examples, and six guided prompts.
 
 ```bash
 cometric mcp                                   # stdio
@@ -62,7 +66,7 @@ cometric mcp --transport http --port 8765      # stateless streamable HTTP at PO
 Claude Code:
 
 ```bash
-claude mcp add cometric -- uv run --directory /path/to/cometric cometric mcp
+claude mcp add cometric -- uvx --from "cometric[mcp]" cometric mcp
 ```
 
 The HTTP transport keeps no session state, answers `GET /mcp` with 405, keeps DNS-rebinding protection on (set `COMETRIC_ALLOWED_HOSTS` for your hostname), and checks a bearer token when `COMETRIC_MCP_TOKEN` is set.
@@ -100,7 +104,7 @@ uv run ruff check src tests scripts && uv run ruff format --check src tests scri
 uv run python scripts/build_fixtures.py   # regenerate casebook fixtures
 ```
 
-The specification is in `docs/COMETRIC_SPEC_v0.2.md`. Implementation status and clarifications are in `docs/STATUS.md`.
+The specification is `docs/COMETRIC_SPEC_v0.3.md` (normative for 0.1.0). Implementation status is in `docs/STATUS.md`; reconciling a real engagement is described in `docs/RECONCILIATION.md`.
 
 ## License