Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/ideas-prioritization
Last refresh never
Spec: Ideas Prioritization API
inventory_source local | spec_api /api/spec-registry/ideas-prioritization | registry_updated 2026-04-09T03:10:08.922012Z
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/idea-dual-identity.md, specs/idea-hierarchy-super-child.md, specs/idea-lifecycle-closure.md, specs/idea-lifecycle-management.md, specs/idea-right-sizing.md, specs/ideas-prioritization.md, specs/standing-questions-roi-and-next-task-generation.md, specs/super-idea-rollup-criteria.md
evidence_refs -
Open implementation view for this spec
implementation_refs spec-registry:idea-dual-identity, spec-registry:idea-hierarchy-super-child, spec-registry:idea-lifecycle-closure, spec-registry:idea-lifecycle-management, spec-registry:ideas-prioritization, spec-registry:standing-questions-roi-and-next-task-generation
lineage_ids -
public_endpoints -
summary | Contract | Content |
process_summary GET /api/ideas — List ideas ranked by free energy score with portfolio summary; GET /api/ideas/{id} — Retrieve individual idea with score (404 if not found); PATCH /api/ideas/{id} — Update idea validation fields (404 if not found); GET /api/ideas/storage — Report structured storage backend and row counts; Filter support for unvalidated ideas only
pseudocode_summary -
implementation_summary api/app/routers/ideas.py (list_ideas(), get_idea(), get_idea_tags_catalog()); api/app/services/idea_service.py (list_ideas(), _score(), _with_score(), _build_cost_vector(), _build_value_vector()); api/app/models/idea.py (Idea, IdeaWithScore, IdeaPortfolioResponse, IdeaSummary, CostVector)