Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/coherence-credit-internal-currency
Last refresh never
Coherence Credit (CC) — Internal Currency (Phase 1: Unit of Account)
inventory_source local | spec_api /api/spec-registry/coherence-credit-internal-currency | registry_updated 2026-04-09T03:10:08.846503Z
potential_value 0.00 | actual_value 1.00 | value_gap 0.00
estimated_cost 0.00 | actual_cost 1.00 | cost_gap 1.00
estimated_roi 0.00 | actual_roi 1.00
Missing contributor linkage. Submit a change request with contributor attribution.
Open process view for this spec
task_ids -
branches -
source_files specs/cc-economics-and-value-coherence.md, specs/coherence-credit-internal-currency.md, specs/grounded-cost-value-measurement.md, specs/grounded-idea-portfolio-metrics.md, specs/mvp-cost-and-acceptance-proof.md, specs/portfolio-governance-effectiveness.md
evidence_refs -
Open implementation view for this spec
implementation_refs spec-registry:cc-economics-and-value-coherence, spec-registry:coherence-credit-internal-currency, spec-registry:grounded-cost-value-measurement, spec-registry:grounded-idea-portfolio-metrics, spec-registry:mvp-cost-and-acceptance-proof, spec-registry:portfolio-governance-effectiveness
lineage_ids -
public_endpoints -
summary The Coherence Network tracks ideas, specs, and value lineage but currently uses raw USD floats with hardcoded conversion rates scattered across services. This spec introduces an internal unit of account called "Coherence Credit" (CC) that represents real resource cost, preserves resource-type breakdowns, has a configurable exchange rate anchored to observable market prices, and makes all formulas dimensionally consistent. Phase 1 is purely additive: new models, config, service, and a `value_basi
process_summary R1: CostVector and ValueVector Pydantic models that decompose any CC amount into resource categories; R2: ExchangeRate config loaded from `data/exchange_rates.json` with epoch-locked rates; R3: `cc_from_usd()` and `usd_from_cc()` conversion functions (verified inverses); R4: `value_basis` field on the Idea model — dict mapping field names to human-readable rationale strings; R5: ProviderRate model for comparing providers in CC terms
pseudocode_summary -
implementation_summary api/app/services/coherence_credit_service.py (exchange rates, CC conversion); api/app/models/coherence_credit.py (CostVector, ValueVector, ExchangeRate, ProviderRate)