Files
adaptive-pricing/workplans/ADAPTIVE-WP-0003-canonical-pricing-core-and-schema.md

87 lines
2.3 KiB
Markdown

---
id: ADAPTIVE-WP-0003
type: workplan
title: "Canonical pricing core and schema extraction"
domain: financials
repo: adaptive-pricing
status: ready
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: todo
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: todo
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: todo
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: todo
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: todo
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.