Mission Control — Test & Validation Cases

Use this document to manually walk through every feature and confirm the app behaves correctly. Each case has an expected outcome. Mark Pass/Fail as you go.

Core Systems

1. Mission Management

#	P	Test Case	Steps	Expected Outcome	Status
1.1	🔴	Create a new mission	POST to create-mission with name, dates, categories	Mission created, returns missionId. Config table updated with active missionId.	🔲
1.2	🔴	Load active mission on app open	Open the app fresh	Dashboard loads with correct mission name, date range, and days remaining	🔲
1.3	🟡	Mission date range display	Check dashboard header	Start/end dates correct. Days remaining counts down accurately. Progress bar reflects position between start and end.	🔲
1.4	🟡	Mission with no quests/habits	Create a brand new empty mission	Dashboard shows zeros gracefully. No crashes, no NaN. Empty states on all pages.	🔲
1.5	🟡	Success criteria display	Navigate to Character page	Principles and success criteria from mission definition render correctly	🔲
1.6	🟢	Mission theme badge	Check dashboard header	Theme (e.g., “Foundation”) shown as a badge/label	🔲

Quest Engine

2. Quests — CRUD

#	P	Test Case	Steps	Expected Outcome	Status
2.1	🔴	Add a quest (minimal)	Type “Buy milk” in add quest field, click Add	Quest created as active, no category/size yet, appears on quest board	🔲
2.2	🔴	Add a quest with all fields	Add quest, then manually set category=home, size=tiny, points=1	All fields saved and displayed correctly on the card	🔲
2.3	🔴	View quest detail	Click on a quest card	Detail panel/modal opens showing name, category, size, points, steps, status, notes, creation date	🔲
2.4	🔴	Complete a quest	Click complete on an active quest	Status → complete. Points added to ledger. Balance updated. Quest moves to completed section. Timestamp recorded.	🔲
2.5	🔴	Quest board grouping	View /quests with quests in multiple categories	Quests grouped by category (Home, Kids, Laura, Work, Personal). Each group labeled.	🔲
2.6	🟡	Block a quest	Mark a quest as blocked	Status → blocked. Visual indicator changes. Quest remains visible but distinct.	🔲
2.7	🟡	Drop a quest	Drop a quest	Status → dropped. No points awarded. Quest moves to completed/archived section.	🔲
2.8	🟡	Edit quest name/notes	Modify name or notes on existing quest	Changes persist after page refresh	🔲
2.9	🟡	Completed quests section	Scroll to bottom of /quests	Collapsible section with all completed quests. Collapsed by default.	🔲
2.10	🟢	Empty category	Have zero quests in “Work”	Category either hidden or shows graceful empty state, not a broken empty column	🔲

3. Quests — Steps & Progress

#	P	Test Case	Steps	Expected Outcome	Status
3.1	🔴	Quest with steps displays progress	View a quest with 4 steps, currentStep=2	Shows “2/4” on the card. Detail view highlights step 2 as current, steps 0-1 as done.	🔲
3.2	🔴	Advance a step	Click “Advance Step” on a quest at step 1/3	currentStep increments to 2. lastAdvancedAt updated. UI reflects immediately.	🔲
3.3	🟡	Advance past final step	Advance a quest that’s on its last step	Either auto-completes the quest OR prompts “All steps done — mark as complete?”	🔲
3.4	🟡	Quest with no steps	Add a quest without steps	Card shows no step indicator (not “0/0”). Complete button works directly.	🔲
3.5	🟡	Quest with steps at -1 (not started)	Seed data has Potty training at step -1	Shows “Not started” or “0/3”. First advance moves to step 0.	🔲
3.6	🟢	Step names visible in detail	Open quest with named steps	Each step name visible, with done/current/pending styling	🔲

4. Quests — Signal Decay

#	P	Test Case	Steps	Expected Outcome	Status
4.1	🟡	Fresh quest is bright	Complete a step just now	Quest card has full opacity/brightness. Visually stands out.	🔲
4.2	🟡	Stale quest is dim	Quest with lastAdvancedAt 14+ days ago	Card is visually dimmer (lower opacity on border or background). Still readable.	🔲
4.3	🟡	Decay is gradual	Compare quests at 0, 3, 7, 14 days stale	Visible gradient of brightness. Not a binary switch.	🔲
4.4	🟢	New quest (no lastAdvancedAt)	Just-added quest with no steps advanced	Uses createdAt as the freshness anchor. Starts bright.	🔲
4.5	🟢	Blocked quest decay	Quest blocked for 3 weeks	Still shows decay. Being blocked doesn’t freeze the visual — it’s honest about staleness.	🔲

Habits & Economy

5. Habits — Tracking

#	P	Test Case	Steps	Expected Outcome	Status
5.1	🔴	Toggle a habit day ON	Click the Monday dot for “Writing”	Dot fills with amber. HabitLog entry created.	🔲
5.2	🔴	Toggle a habit day OFF	Click a filled dot	Dot empties. HabitLog entry deleted or marked undone.	🔲
5.3	🔴	Weekly progress calculation	Mark 3/4 Writing days	Row shows “3/4”. Footer recalculates total checks and percentage.	🔲
5.4	🔴	Habit points calculation	Achieve 80% across all habits in a week	Footer shows 7pts (75-90% bracket).	🔲
5.5	🔴	Habit points edge cases	Test exactly 90%, 75%, 50%, 25%, 10%, 9%	Points: 10, 7, 5, 3, 1, 0 respectively. Boundary correctness matters.	🔲
5.6	🟡	Bonus dot (exceeded target)	Mark 5/4 days for Writing	5th dot renders in gold/amber to indicate exceeding target	🔲
5.7	🟡	View past week	Use week selector to view Week 3	Shows correct habit data for that week. Current week’s dots are editable, past weeks are read-only (or editable with warning).	🔲
5.8	🟡	Add a new habit definition	Add “Stretching” with target 3/week	New row appears in the grid. No existing data for it.	🔲
5.9	🟡	Remove a habit definition	Remove “No sugar”	Row disappears. Historical logs preserved (visible in past weeks).	🔲
5.10	🟢	Habit with 7/7 target (daily)	View “No alcohol” or “Friends” (7/week)	Shows 7 dots for the week. All must be filled to hit 100%.	🔲
5.11	🟢	Week with zero data	Navigate to a future week with no logs	All dots empty, 0/0, 0%. No crashes.	🔲

6. Point Economy & Ledger

#	P	Test Case	Steps	Expected Outcome	Status
6.1	🔴	Quest completion adds points	Complete a 5pt quest	Ledger entry: earn_quest, +5. Mission balance increases by 5.	🔲
6.2	🔴	Spending deducts points	Quick spend “Comics” for 76pts	Ledger entry: spend, -76. Balance decreases. Can go negative.	🔲
6.3	🔴	Balance reflects all activity	Check dashboard after multiple earn/spend events	Balance = sum of all ledger entries. Matches displayed number exactly.	🔲
6.4	🔴	Negative balance display	Spend more than earned	Balance shows as red negative number (e.g., “-29”). Not zero-clamped.	🔲
6.5	🟡	Hobby points via ledger	Log a “Book read” hobby	Ledger entry: earn_hobby, +5. Balance increases.	🔲
6.6	🟡	Habit points end-of-week	Complete a week with 85% habits	Ledger entry: earn_habit, +7. One entry per week (not per habit).	🔲
6.7	🟡	Ledger shows in activity feed	Complete a quest, spend points, log hobby	All three appear in dashboard activity feed in chronological order	🔲
6.8	🟢	Ledger filtering	On log page or Quartermaster, filter by type	Can view only spends, only earns, etc.	🔲
6.9	🟢	1pt = 1€ consistency	All point values match expected euro equivalents	Tiny=1, Small=3, Medium=5, Big=7, Huge=10. Book=5, Game=3, Audiobook=2, Boardgame=1.	🔲

7. Weekly Log

#	P	Test Case	Steps	Expected Outcome	Status
7.1	🔴	View a completed week	Navigate to /log, select Week 3	Shows: quests completed that week, habit summary with percentages, hobbies logged, points spent, weekly totals, running balance	🔲
7.2	🔴	Running balance accuracy	View multiple weeks in sequence	Balance at end of Week N = balance at end of Week N-1 + earned - spent. Chain is consistent.	🔲
7.3	🟡	Current (incomplete) week	View the current week	Shows partial data. Habits that haven’t happened yet are empty, not zero.	🔲
7.4	🟡	Week with no activity	View a week where nothing was logged	Graceful empty state. Shows ”—” or equivalent. Balance carries forward unchanged.	🔲
7.5	🟡	Week selector navigation	Navigate between weeks	Smooth, no loading flicker for cached data. Week number and date range displayed correctly.	🔲

AI Features

8. AI — Quest Enrichment

#	P	Test Case	Steps	Expected Outcome	Status
8.1	🔴	Enrich a simple quest	Create “Buy milk”, click Enrich	AI returns: category, size (tiny/1pt), steps (1-2 steps), reasoning. All shown for review.	🔲
8.2	🔴	Enrich a complex quest	Create “Set up home lab”, click Enrich	AI returns: huge/10pt, 4-5 steps, correct category (personal). Reasoning references complexity.	🔲
8.3	🔴	Accept AI enrichment	After enrichment, click Accept/Save	Quest updated with AI-suggested values. aiEnriched set to true.	🔲
8.4	🔴	Modify AI enrichment before saving	After enrichment, change category from AI suggestion	Modified values saved, not the AI originals. User has final say.	🔲
8.5	🟡	AI returns valid JSON	Trigger enrichment	Response is valid JSON matching expected schema. No markdown fences leaking into UI.	🔲
8.6	🟡	AI error handling	Disconnect network or use invalid API key	Graceful error message. No crash. Quest remains in its pre-enrichment state.	🔲
8.7	🟡	AI uses personality	Check the reasoning field	Tone matches COMMS personality. Uses “Commander.” Not generic/corporate.	🔲
8.8	🟢	Enrich quest with ambiguous name	Create “the thing” and enrich	AI makes a reasonable guess or the reasoning explains its uncertainty. Doesn’t crash.	🔲
8.9	🟢	Enrichment loading state	Click Enrich	Button shows loading/spinner. UI not blocked. Other actions still possible.	🔲

9. AI — Commander’s Debrief

#	P	Test Case	Steps	Expected Outcome	Status
9.1	🔴	Generate debrief for a past week	Go to Log, select Week 3, click Generate Debrief	AI returns narrative, suggested traits, title events. Narrative references actual data (quest names, habit %, spend).	🔲
9.2	🔴	Debrief is cached	Generate debrief, navigate away, come back	Same debrief shown. No re-generation. Stored in Debriefs table.	🔲
9.3	🟡	Debrief personality	Read the narrative	COMMS voice: direct, dry, uses “Commander”, references patterns. Not generic.	🔲
9.4	🟡	Debrief for a bad week	Generate for a week with 0 quests, low habits, high spend	Narrative is honest but not cruel. Acknowledges the dip. Suggests next steps.	🔲
9.5	🟡	Debrief for a great week	Generate for Week 3 (17 quest points, 6 hobbies)	Narrative acknowledges wins. Still notes weaknesses (sugar at 0). Not sycophantic.	🔲
9.6	🟡	Trait suggestion	AI suggests “Binge Reader” after 2 books in one week	Trait appears in debrief response. If accepted, added to CharacterStats.	🔲
9.7	🟡	Title event in debrief	Week where balance goes negative for 3rd consecutive time	Debrief includes title event: debt_walker earned.	🔲
9.8	🟢	Debrief for current (incomplete) week	Try to generate for current week	Either blocked (“Week not complete”) or generates with caveat (“Week still in progress, Commander.”)	🔲

10. AI — Salvage Runs

#	P	Test Case	Steps	Expected Outcome	Status
10.1	🔴	Request 15-minute salvage run	On /quests, click salvage run, select 15 min	AI suggests ONE specific micro-action from active quests. Includes quest name, step, actionable instruction.	🔲
10.2	🟡	Request 60-minute salvage run	Select 60 min	AI suggests a bigger action, possibly a full step completion. Different from 15-min suggestion.	🔲
10.3	🟡	Salvage with no active quests	Remove all active quests, request salvage	Graceful response: “No active quests to salvage, Commander. Time to hit the Tavern Board.”	🔲
10.4	🟡	Salvage prioritizes stale quests	Have one quest advanced today and one stale for 3 weeks	AI should prefer suggesting the stale quest (higher impact).	🔲
10.5	🟢	Salvage response is actionable	Read the suggestion	It’s specific (“open camera roll and star 20 photos”) not vague (“work on the photo album”).	🔲

Character & Progression

11. Character Sheet

#	P	Test Case	Steps	Expected Outcome	Status
11.1	🔴	Character page loads	Navigate to /character	Shows level, stats, titles, traits. No crash on first load with seed data.	🔲
11.2	🔴	Stats are derived from real data	Check STR, INT, CHA, CON, WIS values	Values reflect actual quest completions, habit consistency, spending patterns. Not all zeros, not all 20s.	🔲
11.3	🔴	Level calculation	Check level and XP bar	Level matches formula: floor(sqrt(totalLifetimePoints / 10)). XP bar shows progress to next level.	🔲
11.4	🔴	Radar/pentagon chart renders	View stats section	Five-axis chart renders correctly. Shape reflects stat distribution (not a perfect pentagon unless all stats equal).	🔲
11.5	🟡	Title earned automatically	Complete 10th quest in the mission	”Questbreaker” title appears in titles section. Notification or visual indication of new title.	🔲
11.6	🟡	Set active title	Click on an earned title	Title becomes active. Displayed next to name on sidebar and character page.	🔲
11.7	🟡	Locked titles visible	View titles section	Unearned titles shown as muted silhouettes with ”???” and a hint about the trigger.	🔲
11.8	🟡	Traits display	Check traits section	AI-detected traits shown as tags. At least the seeded traits visible.	🔲
11.9	🟡	Stats recompute on stale data	lastComputedAt is >1 hour old, load character page	Stats recomputed from source data. Updated values shown.	🔲
11.10	🟢	Mission archive	View with seed data from one mission	Current mission shown with live stats. Format ready for multiple missions.	🔲
11.11	🟢	Stat tooltips or explanations	Hover/tap on a stat name	Shows what the stat is derived from (e.g., “STR: Physical/home quest completions”)	🔲

12. Character — Title Triggers

#	P	Test Case	Steps	Expected Outcome	Status
12.1	🟡	Questbreaker	Complete 10 quests in one mission	Title awarded	🔲
12.2	🟡	The Disciplined	Achieve 90%+ habits for 4 consecutive weeks	Title awarded	🔲
12.3	🟡	The Indulgent	Spend 50+ points in a single week	Title awarded (Week 3: comics 76pts should trigger)	🔲
12.4	🟡	Debt Walker	Negative balance for 3+ consecutive weeks	Title awarded (Weeks 4-7 in seed data)	🔲
12.5	🟡	Streak Runner	Complete a Tavern Board streak bounty	Title awarded	🔲
12.6	🟡	Zero Dark	Hit 0% on any habit for a full week	Title awarded (No sugar at 0 in Week 4)	🔲
12.7	🟡	Marathon	Complete a huge (10pt) quest	Title awarded	🔲
12.8	🟡	Social Butterfly	Contact every crew member in a single week	Title awarded	🔲
12.9	🟢	The Constant	Log activity 30 days in a row	Title awarded (hard to test manually, verify logic)	🔲
12.10	🟢	Penny Pincher	End a mission with 100+ surplus	Title awarded (check at mission close)	🔲
12.11	🟡	No duplicate titles	Trigger Questbreaker conditions twice	Title appears only once. earnedAt is first occurrence.	🔲

Quartermaster & Social

13. Quartermaster

#	P	Test Case	Steps	Expected Outcome	Status
13.1	🔴	View balance on Quartermaster	Navigate to /quartermaster	Balance displayed prominently. Matches dashboard balance exactly. Shows total earned and total spent.	🔲
13.2	🔴	Add wishlist item	Add “LOTR expansion” at 35pts, category=boardgame	Item appears in wishlist. Status: wanted.	🔲
13.3	🔴	Purchase wishlist item (affordable)	With balance >= 35, purchase the item	Balance deducts 35. Ledger entry: spend_wishlist. Item status → purchased.	🔲
13.4	🔴	Purchase wishlist item (not affordable)	With balance < item cost, attempt purchase	Purchase allowed (can go negative, matching existing economy). Balance goes negative. Red display.	🔲
13.5	🟡	Affordable badge	Balance is 40, item costs 35	”AFFORDABLE” green badge on the item.	🔲
13.6	🟡	Progress bar for unaffordable	Balance is 15, item costs 35	Progress bar at ~43%. Text: “20 points away”.	🔲
13.7	🟡	Affordability projection	Average earning 15pts/week, item costs 35, balance is 15	Shows “~1.3 weeks” or “~2 weeks” estimate.	🔲
13.8	🟡	Quick spend (ad-hoc)	Spend 10pts on “Bracelet” via quick spend	Ledger entry: spend (not spend_wishlist). Balance deducts. Appears in purchase history.	🔲
13.9	🟡	Purchase history	After multiple purchases	Chronological list showing wishlist and ad-hoc purchases with dates and amounts	🔲
13.10	🟢	Wishlist sorting	Mix of affordable and unaffordable items	Affordable items sorted to top. Within groups, sorted by creation date.	🔲
13.11	🟢	Wishlist category icons	Items with different categories	Each shows a relevant icon (game, book, boardgame, etc.)	🔲

14. Crew Manifest

#	P	Test Case	Steps	Expected Outcome	Status
14.1	🔴	View crew list	Navigate to /crew	All crew members displayed as cards with names, relationship, last contact time.	🔲
14.2	🔴	Ping a crew member	Click Ping on “Mamá”	lastContactAt updated to now. Timer resets. Contact log entry created. Visual feedback (pulse animation).	🔲
14.3	🔴	Last contact in natural language	View a crew member pinged 3 days ago	Shows “3 days ago” (via date-fns), not a raw timestamp.	🔲
14.4	🟡	Freshness color coding	Crew members with varying last contact times	Recently pinged = green border. Overdue = yellow. Very overdue = red. Gradient, not binary.	🔲
14.5	🟡	Sorted by neediest first	View /crew	Person with lowest freshness (most overdue relative to their pattern) at top.	🔲
14.6	🟡	Average frequency computation	Ping “Mamá” 5 times over 20 days	averageFrequencyDays computes to ~4 days. Freshness decay calibrated to that rhythm.	🔲
14.7	🟡	New crew member (no history)	Add a new person, no pings yet	Shows “Never contacted” or uses creation date. Falls back to 7-day flat decay.	🔲
14.8	🟡	Add crew member	Click Add, fill name/relationship/method	New card appears in the grid.	🔲
14.9	🟡	Delete crew member	Remove a crew member	Card removed. Contact history cleaned up (or retained for stats).	🔲
14.10	🟢	Crew Pulse on dashboard	View dashboard with overdue crew	Small widget showing 2-3 most overdue names with “X days ago”	🔲
14.11	🟢	Contact log note	Ping with a note: “Called about birthday plans”	Note stored in contact log. Visible somewhere (crew detail or log).	🔲
14.12	🟢	CHA stat reflects crew health	High crew contact frequency	CHA stat on character sheet is higher than with poor contact patterns	🔲

15. Tavern Board

#	P	Test Case	Steps	Expected Outcome	Status
15.1	🔴	Generate bounties	On /tavern, click “Post New Bounties”	3-5 bounties generated by AI. Mix of types and sources. Each has description, reward, type.	🔲
15.2	🔴	Accept a bounty	Click Accept on an available bounty	Status → accepted. acceptedAt set. Visual change (highlighted border).	🔲
15.3	🔴	Complete a bounty	Click Complete on an accepted bounty	Status → completed. Points awarded via ledger. Balance increases.	🔲
15.4	🟡	Bounties are context-aware	Generate bounties when habits are weak	At least one bounty targets the weakest habit. AI references actual data.	🔲
15.5	🟡	Streak bounty display	Generate a streak bounty	Shows streak progress dots (e.g., ●○○ for 1/3 weeks).	🔲
15.6	🟡	Streak bounty completion bonus	Complete week 3/3 of a streak	Normal reward + streak bonus points both credited. Two ledger entries.	🔲
15.7	🟡	Bounty expiration	Wait for bounty to pass expiresAt	Status → expired on next load. Not shown as available.	🔲
15.8	🟡	No duplicate generation	Generate bounties twice in one week	Second generation either blocked (“Bounties already posted this week”) or confirms replacement.	🔲
15.9	🟡	Bounty sources are varied	Inspect generated bounties	Not all same source. Mix of: hobby_inertia, habit_support, quest_nudge, crew_nudge, etc.	🔲
15.10	🟢	Bounty AI personality	Read bounty descriptions	Written in COMMS voice. Not generic task descriptions. Has personality.	🔲
15.11	🟢	Active bounties on dashboard	Accept a bounty, check dashboard	Active Bounties widget shows the accepted bounty with progress.	🔲
15.12	🟢	Bounty history	View past weeks’ bounties	Collapsible section showing completed/expired bounties from previous weeks.	🔲
15.13	🟢	Streak Runner title	Complete a full streak bounty	”Streak Runner” title triggers on character sheet.	🔲

Dashboard & Navigation

16. Dashboard — Aggregate View

#	P	Test Case	Steps	Expected Outcome	Status
16.1	🔴	Dashboard loads with all widgets	Navigate to /	All widgets render: mission header, character mini-card, quest status, habit pulse, activity feed. No crashes.	🔲
16.2	🔴	Character mini-card	Check sidebar or dashboard	Shows level, active title, balance. Clickable → navigates to /character.	🔲
16.3	🔴	Quest status counts	Check quest panel	Correct counts: active, complete, blocked. Matches actual data.	🔲
16.4	🔴	Habit pulse shows current week	Check habit widget	Dot grid for current week. Filled/empty matches actual habit logs. Percentage correct.	🔲
16.5	🟡	Activity feed	Check feed after various actions	Shows last 5-8 ledger entries. Most recent first. Descriptions are readable.	🔲
16.6	🟡	Crew pulse widget	Check with overdue crew members	Shows 2-3 most overdue crew with “X days ago” text.	🔲
16.7	🟡	Active bounties widget	Accept a bounty, check dashboard	Shows accepted bounties with progress indicators.	🔲
16.8	🟢	Dashboard data freshness	Complete a quest on /quests, return to /	Dashboard reflects the new data immediately (React Query invalidation) or on refresh.	🔲

17. Layout & Navigation

#	P	Test Case	Steps	Expected Outcome	Status
17.1	🔴	Desktop sidebar navigation	Click each nav link on desktop	All pages load correctly. Active page highlighted in sidebar.	🔲
17.2	🔴	Mobile bottom tab bar	View on 375px width	Bottom tabs visible: Dashboard, Quests, Habits, Character, More. Tapping works.	🔲
17.3	🔴	Mobile “More” menu	Tap More on mobile	Sheet/menu opens with: Log, Quartermaster, Crew, Tavern links.	🔲
17.4	🟡	Sidebar mission info	Check desktop sidebar	Shows mission name, character mini-card (level, title, balance), nav links with icons.	🔲
17.5	🟡	Responsive breakpoints	Resize from 375px to 1440px	Layout transitions smoothly. No broken layouts at any width.	🔲
17.6	🟢	Page transition animations	Navigate between pages	Subtle transitions (framer-motion). Not jarring. Not slow.	🔲

Design & Infrastructure

18. Design — Wayfarer Cockpit Aesthetic

#	P	Test Case	Steps	Expected Outcome	Status
18.1	🔴	Color scheme correct	Visual inspection	Dark navy hull, warm cream text, amber accents. NOT white backgrounds, NOT blue accents.	🔲
18.2	🔴	Typography correct	Check fonts loaded	JetBrains Mono for data/numbers. Space Grotesk for labels/body. Both loaded from Google Fonts.	🔲
18.3	🟡	Panel styling	Inspect cards/panels	Rounded corners, 1px border, mc-panel background. NO drop shadows.	🔲
18.4	🟡	Section headers	Check any section header	Left amber border bar (4px), uppercase muted label, small text.	🔲
18.5	🟡	Data readouts	Check point balance, stats	Monospace font. Muted uppercase labels above. Dense, cockpit-like.	🔲
18.6	🟡	Status colors	Check positive/negative/warning elements	Green for earned/complete, red for spent/negative, amber for warnings, blue for info. Consistent.	🔲
18.7	🟢	Information density	Overall feel	Feels like a cockpit — dense, functional, warm. NOT like a blog (too much whitespace) or a corporate dashboard (too sterile).	🔲
18.8	🟢	Interactive feedback	Hover over buttons, toggle habits	Amber hover states, 150ms transitions. Point changes have brief scale pulse.	🔲

19. Offline & PWA

#	P	Test Case	Steps	Expected Outcome	Status
19.1	🟡	Zustand persistence	Load app, navigate around, hard refresh	State restored from localStorage. Last-viewed data shown.	🔲
19.2	🟡	Offline display	Disconnect network, open app	Shows last-known data from Zustand cache. No blank screen. Error indicator that data may be stale.	🔲
19.3	🟡	PWA installable	Open in Chrome mobile, check install prompt	App can be added to home screen. Opens in standalone mode.	🔲
19.4	🟢	Service worker caching	Install PWA, go offline, open app	App shell loads from SW cache. Static assets available.	🔲
19.5	🟢	Manifest correct	Check /manifest.json	App name “Mission Control”, correct theme colors (mc-hull), icon present.	🔲

20. Error Handling & Edge Cases

#	P	Test Case	Steps	Expected Outcome	Status
20.1	🔴	API error on page load	Break API key, load any page	Error state shown (not blank, not crash). Message like “Comms down, Commander.”	🔲
20.2	🔴	Loading states	Throttle network, load each page	Every page shows loading indicator while fetching. Not blank.	🔲
20.3	🔴	Empty states	New mission with zero data on every page	Each page has a meaningful empty state. Not blank, not broken.	🔲
20.4	🟡	AI timeout	Slow network, trigger enrichment	Loading state shown. After timeout, error message. Quest unchanged.	🔲
20.5	🟡	Invalid AI response	AI returns malformed JSON (simulate)	Error handled gracefully. User informed. No crash. Original data preserved.	🔲
20.6	🟡	Concurrent mutations	Complete a quest while viewing dashboard	No stale data. React Query invalidation ensures both views update.	🔲
20.7	🟢	Very long quest name	Add quest with 200-character name	Card truncates gracefully. Detail view shows full name. No layout break.	🔲
20.8	🟢	Rapid clicking	Double-click Complete on a quest	Only one completion processed. No duplicate ledger entries.	🔲
20.9	🟢	Deep link to page	Navigate directly to /quests or /character via URL	Page loads correctly with all data, not just from root route.	🔲

Seed Data & New Features

21. Seed Data Validation

#	P	Test Case	Steps	Expected Outcome	Status
21.1	🔴	All seed quests present	View /quests	All 14 active quests visible in correct categories. Correct sizes and points.	🔲
21.2	🔴	Quest steps match seed	Click Garage protections (step 2/3)	Shows step 2 of 3 highlighted. Steps match: Find existing → Buy if needed → Install.	🔲
21.3	🔴	All 6 habits present	View /habits	Writing (4/wk), Sports (3/wk), Friends (7/wk), Meditate (5/wk), No alcohol (7/wk), No sugar (7/wk).	🔲
21.4	🟡	Crew seeded	View /crew	Laura, family members, and friends present with placeholder contact dates.	🔲
21.5	🟡	Wishlist seeded	View /quartermaster	2-3 wishlist items with realistic prices.	🔲
21.6	🟡	Blocked quest visible	Check Homelab quest	Shows as blocked with distinct visual.	🔲
21.7	🟢	Categories correct	Each quest is in the right category column/group	Home quests in Home, Kids in Kids, etc. None miscategorized.	🔲
21.8	🟡	Last Pings seeded	View /pings	4 pings present: Kira’s litter, Watered plants, Changed bed sheets, Backed up phone.	🔲
21.9	🟡	Media Log seeded	View /media	4 entries: Severance S2 (watching), Nosferatu (want_to_watch), White Lotus S3 (want_to_watch), Andor S1 (completed, 5 stars).	🔲

22. Last Ping

#	P	Test Case	Steps	Expected Outcome	Status
22.1	🔴	View pings list	Navigate to /pings	All pings displayed as cards with names, icons, last ping time.	🔲
22.2	🔴	Ping an item	Click Ping on “Kira’s litter”	lastPingedAt updated to now. Timer resets to “just now”. Log entry created. Pulse animation.	🔲
22.3	🔴	Last ping in natural language	View a ping done 3 days ago	Shows “3 days ago” (via date-fns), not a raw timestamp.	🔲
22.4	🟡	Freshness color coding	Pings with varying last-ping times	Recently pinged = green border. Overdue = yellow. Very overdue = red. Gradient, not binary.	🔲
22.5	🟡	Sorted by neediest first	View /pings	Ping with lowest freshness (most overdue relative to its pattern) at top.	🔲
22.6	🟡	Average frequency computation	Ping “Kira’s litter” 5 times over 15 days	averageFrequencyDays computes to ~3 days. Freshness decay calibrated accordingly.	🔲
22.7	🟡	New ping (no history)	Create a new ping, no prior pings	Shows “just now” (created with lastPingedAt = now). Falls back to 7-day flat decay.	🔲
22.8	🟡	Add a ping	Click Add, fill name and pick icon	New card appears in the grid.	🔲
22.9	🟡	Delete a ping	Remove a ping	Card removed. Log entries cleaned up.	🔲
22.10	🟡	Ping history view	Tap/expand a ping card	Shows last 5-10 log entries with dates. Frequency pattern visible.	🔲
22.11	🟡	Ping with note	Ping with note: “Used the new brand”	Note stored in log entry. Visible in history.	🔲
22.12	🟢	Last Ping Pulse on dashboard	View dashboard with overdue pings	Small widget showing 2-3 most overdue pings with “X days ago”.	🔲
22.13	🟢	Icon picker on creation	Add a new ping	Subset of Lucide icons available to pick from (cat, droplets, car, bed, etc.). Selected icon displays on card.	🔲
22.14	🟢	Pings persist across missions	Create new mission, check /pings	Same pings visible. Not mission-scoped.	🔲
22.15	🟢	Signal decay matches crew formula	Compare visually to crew cards	Same freshness formula: `1.0 - clamp(days / (avg * 1.5

23. Ship’s Log — Media Tracker

#	P	Test Case	Steps	Expected Outcome	Status
23.1	🔴	View media list	Navigate to /media	All media entries displayed. Grouped or filtered by status.	🔲
23.2	🔴	Add media entry	Add “Dune Part 3” as movie, want_to_watch	Entry created. Appears in “Want to Watch” view.	🔲
23.3	🔴	Start watching	Click “Start Watching” on a want_to_watch entry	Status → watching. startedAt set to now. Card moves to Watching section.	🔲
23.4	🔴	Complete media	Click “Complete” on a watching entry	Prompted for 1-5 star rating. After rating: status → completed, completedAt set, rating saved.	🔲
23.5	🔴	Hobby points on completion	Complete a TV show season	Ledger entry created: earn_hobby, +3 pts. Mission balance increases.	🔲
23.6	🟡	Different media type points	Complete a movie (1pt), documentary (2pt), TV season (3pt)	Each creates correct ledger entry with correct point value.	🔲
23.7	🟡	Drop media	Click “Drop” on a watching entry	Status → dropped. No points awarded. Card moves to dropped/completed section.	🔲
23.8	🟡	Filter by status	Click “Watching” tab/filter	Only watching entries shown. Other tabs work similarly.	🔲
23.9	🟡	Filter by type	Filter to only tv_show entries	Only TV shows displayed.	🔲
23.10	🟡	Rating display	View completed entry with rating 4	Shows 4/5 stars or equivalent visual.	🔲
23.11	🟡	Season number	Add “Severance S2” with seasonNumber=2	Season number displayed on card: “Season 2”.	🔲
23.12	🟡	Quick stats	View stats section on /media	Shows total watched this mission, breakdown by type, total points earned from media.	🔲
23.13	🟡	Edit media entry	Change notes or type on existing entry	Changes persist after refresh.	🔲
23.14	🟡	Delete media entry	Remove an entry	Entry deleted. If it was completed, ledger entry remains (history intact).	🔲
23.15	🟢	Media persists across missions	Create new mission, check /media	Same entries visible. Not mission-scoped. Points earned go to active mission.	🔲
23.16	🟢	Tavern Board references media backlog	Generate bounties with want_to_watch entries	At least one bounty source is media_backlog referencing a want_to_watch item.	🔲
23.17	🟢	Notes on media card	Add entry with notes	Notes preview visible on card. Full notes in detail view.	🔲

24. Habit Mutations

#	P	Test Case	Steps	Expected Outcome	Status
24.1	🟡	Debrief includes mutation field	Generate a debrief for any week	Response JSON includes habitMutations array (may be empty). No crash if empty.	🔲
24.2	🟡	Evolve mutation suggested	Generate debrief for a week where Writing has been 90%+ for 4+ consecutive weeks	habitMutations contains an evolve suggestion for Writing (e.g., increase to 5/week).	🔲
24.3	🟡	Simplify mutation suggested	Generate debrief for a week where No sugar has been <25% for 3+ weeks	habitMutations contains a simplify suggestion for No sugar (e.g., reduce to 3/week).	🔲
24.4	🟡	Mutation card UI — evolve	View debrief with evolve mutation	Green-bordered card with upward arrow, shows current→proposed change, Accept and Dismiss buttons.	🔲
24.5	🟡	Mutation card UI — simplify	View debrief with simplify mutation	Amber-bordered card with adjustment icon, shows current→proposed change, Accept and Dismiss buttons.	🔲
24.6	🔴	Accept mutation	Click Accept on a mutation card	HabitDefinition updated with proposed change (e.g., daysPerWeek 4→5). Change reflected on /habits page.	🔲
24.7	🟡	Dismiss mutation	Click Dismiss on a mutation card	Card hidden/removed. No changes to HabitDefinition. Debrief still shows the narrative.	🔲
24.8	🟡	Mutation personality	Read the mutation suggestion text	Written in COMMS voice. Evolve: encouraging but not sycophantic. Simplify: honest, pragmatic.	🔲
24.9	🟢	No mutation when not warranted	Generate debrief for a normal week (no extreme patterns)	habitMutations array is empty. No mutation cards shown.	🔲
24.10	🟢	Mutation doesn’t double-fire	Generate debrief twice for same week	Same cached debrief returned. Accepting mutation twice doesn’t apply change twice.	🔲
24.11	🟢	Accepted mutation visible next week	Accept evolve (4→5/week), navigate to /habits next week	Habit grid shows 5 target. New target in effect.	🔲

Summary

Section	🔴 Critical	🟡 Important	🟢 Nice-to-have	Total
1. Missions	2	3	1	6
2. Quests CRUD	5	4	1	10
3. Quest Steps	2	3	1	6
4. Signal Decay	0	3	2	5
5. Habits	5	4	2	11
6. Point Economy	4	3	2	9
7. Weekly Log	2	3	0	5
8. AI Enrichment	4	3	2	9
9. AI Debrief	2	5	1	8
10. AI Salvage	1	3	1	5
11. Character	4	5	2	11
12. Title Triggers	0	9	2	11
13. Quartermaster	4	5	2	11
14. Crew Manifest	3	6	3	12
15. Tavern Board	3	6	4	13
16. Dashboard	4	3	1	8
17. Navigation	3	2	1	6
18. Design	2	4	2	8
19. PWA/Offline	0	3	2	5
20. Error Handling	3	3	3	9
21. Seed Data	3	5	1	9
22. Last Ping	3	8	4	15
23. Ship’s Log	5	9	3	17
24. Habit Mutations	1	7	3	11
TOTAL	65	113	46	224