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
Open process view for this spec
task_ids api-coverage-verification-gap-closure, asset-modularity-drift-daily-audit, asset-modularity-runtime-validation, ci-gates-governance-traceability-stability, contributor-onboarding-and-review-flow, endpoint-evidence-coverage, endpoint-traceability-coverage, endpoint-usage-metrics-audit, flow-registry-data-linkage, implementation-request-question-sync
branches codex/20260215-public-walkable-flow, codex/20260215-walkable-flow-fixes, codex/20260215-web-ideas-specs-usage, codex/20260217-api-coverage-verification
Open implementation view for this spec
implementation_refs spec-registry:portfolio-governance-health
lineage_ids lnk_bd27a61fc45d
public_endpoints /api/agent/metrics, /api/health/persistence, /api/inventory/endpoint-traceability, /api/inventory/system-lineage, https://coherence-network-production.up.railway.app/api/agent/effectiveness, https://coherence-network-production.up.railway.app/api/agent/monitor-issues
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)
source_files .github/workflows/asset-modularity-drift.yml, .github/workflows/auto_track_contributions.yml, .github/workflows/maintainability-architecture-audit.yml, .github/workflows/test.yml, .github/workflows/thread-gates.yml, AGENTS.md, CLAUDE.md, Makefile
evidence_refs ./scripts/verify_web_api_deploy.sh | ./scripts/verify_web_api_deploy.sh https://coherence-network-production.up.railway.app https://coherence-web-production.up.railway.app | ./scripts/verify_worktree_local_web.sh | /Users/ursmuff/source/Coherence-Network/api/.venv/bin/pytest -q api/tests/test_inventory_api.py | /Users/ursmuff/source/Coherence-Network/api/.venv/bin/python api/scripts/run_asset_modularity_audit.py --json --max-implementation-files 1500