Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/portfolio-governance-health
Last refresh never
Portfolio Governance Health -- Coherence Score, Right-Sizing, and Living Metrics
inventory_source local | spec_api /api/spec-registry/portfolio-governance-health | registry_updated 2026-04-09T03:10:08.991583Z
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/portfolio-governance-health.md
evidence_refs -
Open implementation view for this spec
implementation_refs spec-registry:portfolio-governance-health
lineage_ids lnk_bd27a61fc45d
public_endpoints -
summary Provide the measurement and governance layer that lets the network reason about its idea portfolio as one coherent system -- with grounded metrics that replace guesswork, coherence scoring from 9+ signals, automatic right-sizing detection, workspace vitality tracking, CC economics with treasury invariants, and a distribution engine that pays contributors based on proven impact.
process_summary Governance change requests with voting and auto-apply; Grounded idea metrics (actual_value vs potential_value); Coherence score from 9+ signals; Right-sizing detection (too_large, too_small, overlap via TF-IDF); Workspace vitality (6 living-system health signals)
pseudocode_summary -
implementation_summary api/app/services/governance_service.py (create_change_request, vote_on_change_request, apply_approved); api/app/services/grounded_idea_metrics_service.py (compute_idea_metrics, compute_portfolio_health); api/app/services/coherence_service.py (compute_coherence_score); api/app/services/right_sizing_service.py (build_report, compute_granularity_signal, apply_suggestion); api/app/services/vitality_service.py (compute_vitality); api/app/services/cc_economics_service.py (get_supply, stake, unstake); api/app/services/distribution_engine.py (compute_distribution)