---
id: ADAPTIVE-WP-0003
type: workplan
title: "Canonical pricing core and schema extraction"
domain: financials
repo: adaptive-pricing
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-07-02"
updated: "2026-07-02"
state_hub_workstream_id: "7a4a23fc-c424-471b-9abb-b48b101799d5"
---

# Canonical pricing core and schema extraction

Extract a reusable adaptive-pricing core from the Coulomb observatory MVP and
define the canonical pricing-model schema needed by the later milestones.

## Define Canonical Pricing Schema

```task
id: ADAPTIVE-WP-0003-T01
status: done
priority: high
state_hub_task_id: "c79647e3-f760-4a2f-ae45-a3532692a3d3"
```

Define the repository's canonical pricing-model schema and parameter taxonomy.
Cover charge components, commitments, tunable parameters, calculated fields,
eligibility, lifecycle metadata, and provider-mapping hooks.

## Extract Generic Pricing Core

```task
id: ADAPTIVE-WP-0003-T02
status: done
priority: high
state_hub_task_id: "2d27616b-ea0c-4600-b7a2-eb5a22932b58"
```

Refactor the current Coulomb-specific observatory modules so generic pricing
logic can live outside project-specific deployment code. Preserve Coulomb as the
first adopter of the extracted core rather than leaving the core trapped inside
`projects/coulomb-pricing/observatory/`.

## Implement Schema Loader And Validator

```task
id: ADAPTIVE-WP-0003-T03
status: done
priority: high
state_hub_task_id: "6fa1ee8f-27ae-45b3-bd98-ea2a4873c0c8"
```

Implement loading and validation for the canonical schema, including structural
checks, required-field rules, and scenario tests for flat, hybrid, and
commitment-backed models.

## Migrate Coulomb Pricing Registries

```task
id: ADAPTIVE-WP-0003-T04
status: done
priority: medium
state_hub_task_id: "fed8cb44-4219-4b7f-b641-90d872ebc285"
```

Migrate `projects/coulomb-pricing/data/pricing-models.json` and related loading
paths so the Coulomb observatory uses the canonical schema without losing
existing dashboard behavior.

## Exit Criteria

```task
id: ADAPTIVE-WP-0003-T05
status: done
priority: medium
state_hub_task_id: "77305962-6f56-44aa-a8e4-32cfc5de262b"
```

Exit when the repo has a documented canonical schema, a validator with tests,
and a working Coulomb observatory instance backed by the new internal model.

Dependencies: `ADAPTIVE-WP-0002` completed baseline.