{"spec_id":"value-lineage-and-payout-attribution","title":"Spec: Value Lineage and Payout Attribution","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.","potential_value":0.0,"actual_value":1.0,"estimated_cost":0.0,"actual_cost":1.0,"value_gap":0.0,"cost_gap":1.0,"estimated_roi":0.0,"actual_roi":1.0,"idea_id":"value-attribution","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":null,"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)","created_by_contributor_id":null,"updated_by_contributor_id":null,"created_at":"2026-04-09T03:10:09.069424Z","updated_at":"2026-04-09T03:10:09.069424Z","content_path":"specs/value-lineage-and-payout-attribution.md","content_hash":"807caa7bbb1570eb","workspace_id":"coherence-network"}