emba-course-solver/openspec/changes/show-completed-plan/specs/optimization-engine/spec.md at cb2024f857003130611bed58bdc7b19bb26aa13d

Files

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

1.6 KiB

Raw Blame History

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

1.6 KiB Raw Blame History