Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/portfolio-governance-effectiveness
Last refresh never
Portfolio Governance Effectiveness Metrics
inventory_source local | spec_api /api/spec-registry/portfolio-governance-effectiveness | registry_updated 2026-04-09T03:10:08.988162Z
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 Portfolio governance exists to ensure ideas move from promise to real results. Today there is no automated way to tell whether governance itself is working — operators must manually inspect each idea. This spec adds a `/api/ideas/health` endpoint that computes and returns effectiveness metrics so operators and the cockpit UI can answer: "Is governance producing results, and where is it stuck?" Without this, the portfolio-governance super-idea cannot prove its own value, leaving its second open q
process_summary R1: New `GET /api/ideas/health` endpoint returns a `GovernanceHealth` response with the metrics defined in the Data Mode; R2: `throughput_rate` is calculated as the count of ideas whose `manifestation_status` changed to `validated` in the las; R3: `value_gap_trend` compares the sum of all `value_gap` values now vs. 30 days ago (negative means gaps are closing).; R4: `question_answer_rate` is the ratio of answered open questions (non-null `answer`) to total open questions across al; R5: `stale_ideas` lists idea IDs that have `manifestation_status != validated` and no field update in the last 14 days.
pseudocode_summary -
implementation_summary api/app/routers/ideas.py (compute_governance_health()); api/app/services/idea_service.py (compute_governance_health()); api/app/models/idea.py (GovernanceHealth)