Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/value-lineage-and-payout-attribution
Last refresh never
Spec: Value Lineage and Payout Attribution
inventory_source local | spec_api /api/spec-registry/value-lineage-and-payout-attribution | registry_updated 2026-04-09T03:10:09.069424Z
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/assets-api.md, specs/contributions-api.md, specs/contributor-onboarding-and-governed-change-flow.md, specs/distribution-engine.md, specs/normalize-github-commit-cost-estimation.md, specs/task-claim-tracking-and-roi-dedupe.md, specs/value-lineage-and-payout-attribution.md
evidence_refs -
Open implementation view for this spec
implementation_refs spec-registry:assets-api, spec-registry:contributions-api, spec-registry:contributor-onboarding-and-governed-change-flow, spec-registry:distribution-engine, spec-registry:normalize-github-commit-cost-estimation, spec-registry:task-claim-tracking-and-roi-dedupe, spec-registry:value-lineage-and-payout-attribution
lineage_ids -
public_endpoints -
summary Create a verifiable, machine-readable chain from **idea -> research -> spec creation/upgrade -> implementation -> usage/value signals -> payout preview** so contributors can be rewarded based on measurable system value and energy-balanced contribution quality.
process_summary API supports creating and fetching a lineage link that binds idea/spec/implementation references, contributor roles, and; API supports appending usage/value events to a lineage link.; API exposes valuation summary for a lineage link (measured value, estimated cost, ROI ratio, event count).; API supports payout preview from valuation using explicit stage weights and returns per-contributor attribution.; Payout preview applies optimization objectives for coherence, energy flow, awareness, friction relief, and stage-balance
pseudocode_summary -
implementation_summary api/app/routers/value_lineage.py (create_link(), add_usage_event(), get_valuation(), payout_preview()); api/app/services/value_lineage_service.py (create_link(), list_links(), valuation(), payout_preview()); api/app/models/value_lineage.py (LineageLink, UsageEvent, LineageValuation, PayoutPreview)