Files
emba-course-solver/openspec/changes/show-completed-plan/specs/optimization-engine/spec.md
T
Bill cb2024f857 v1.5.1: Show completed plan in Top Plans
Once every elective set is pinned, the Top Plans panel now renders the
user's completed selection as a single "Your Plan" card showing the
achievement count and pinned courses. Previously the panel went blank
because the all-pinned branch in useAppState cleared topPlans, even
though the spec strip was already showing the achievement.

Synthesizes a single PlanOutcome from pinnedAssignments +
optimizationResult.achieved + the priority scorer; TopPlans detects the
all-pinned state via ELECTIVE_SETS.every(...) and bypasses the
length>0 filter so a 0-spec completed plan still renders honestly.
2026-05-10 11:57:56 -04:00

24 lines
1.6 KiB
Markdown

## ADDED Requirements
### Requirement: Synthesized completed plan when all sets are pinned
When `openSetIds.length === 0` (every elective set has a pinned course), `useAppState` SHALL emit a single-element `topPlans` array containing a synthesized `PlanOutcome` rather than clearing the slice. The synthesized plan's fields SHALL be:
- `courseAssignments`: the `pinnedAssignments` map (setId → courseId for every elective set)
- `achievedSpecs`: `optimizationResult.achieved` (the optimizer's output for the same selection)
- `priorityScore`: `makePriorityScorer(state.ranking)(achievedSpecs)`
The other state slices (`treeResults`, `topPlansPartial`, `searchProgress`, `treeLoading`) SHALL remain in their cleared/null state for this branch — no decision-tree search runs when there are no open sets.
#### Scenario: Top Plans state populates after every set is pinned
- **WHEN** the user pins a course in the final remaining open set
- **THEN** `topPlans` SHALL contain exactly one element whose `courseAssignments` matches the user's pinned selection
- **AND** that element's `achievedSpecs` SHALL equal `optimizationResult.achieved`
#### Scenario: Search progress remains null when selection is complete
- **WHEN** every elective set is pinned
- **THEN** `searchProgress` SHALL be `null` and `treeLoading` SHALL be `false`
#### Scenario: Unpinning resumes normal search
- **WHEN** the user unpins one course after the synthesized state was emitted
- **THEN** the search effect SHALL run normally (cache filter, partial worker spawn) and `topPlans` SHALL reflect the cached subset and any streamed improvements