admin/portfolio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: auto-commit before merge (loop primary)

Browse Source
This commit is contained in:
Andy Charlwood
2026-02-17 03:30:44 +00:00
parent 841c1869d6
commit 38e40d36c0
10 changed files with 211 additions and 795 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.ralph/agent/handoff.md
+29 -20
View File
@@ -1,11 +1,11 @@
# Session Handoff # Session Handoff
_Generated: 2026-02-16 15:06:20 UTC_ _Generated: 2026-02-17 02:26:43 UTC_
## Git Context ## Git Context
- **Branch:** `master` - **Branch:** `master`
- **HEAD:** e9a7581: chore: auto-commit before merge (loop primary) - **HEAD:** 9a58b3c: chore: auto-commit before merge (loop primary)
## Tasks ## Tasks
@@ -46,22 +46,34 @@ _Generated: 2026-02-16 15:06:20 UTC_
- [x] Visual: Entry animation reveal effects - [x] Visual: Entry animation reveal effects
- [x] Integration: Wire animation to highlight system (Phase 4) - [x] Integration: Wire animation to highlight system (Phase 4)
- [x] Accessibility: reduced-motion + play/pause button - [x] Accessibility: reduced-motion + play/pause button
- [x] Plan Stage 1 canonical content schema
- [x] Stage1 Checkpoint A: add canonical profile content schema/module/helpers
- [x] Stage 2 core UI migration to canonical profile content
- [x] Stage 3 secondary consumer migration (timeline/search/chat)
- [x] Stage 4 cleanup hardening and one-file editing docs
- [x] Resolve build.blocked backpressure and close loop
- [x] Backpressure recovery handoff
- [x] Backpressure recovery after abandoned build task
- [x] Backpressure recovery after abandoned build task
- [x] Phase 1.1: Migrate medications.ts prescribingHistory into skills.ts, then delete medications.ts
- [x] Phase 1.3: Split profile-content.ts into focused concerns — extract LLM prompt, evaluate education/achievements placement
- [x] Phase 3.1: Extract shared ExpandableCard component from WorkExperienceSubsection, TimelineInterventionsSubsection, RepeatMedicationsSubsection
## Key Files ## Key Files
Recently modified: Recently modified:
- `.claude/skills/d3-visualization/SKILL (3).md:Zone.Identifier` - `.claude/settings.local.json`
- `.claude/skills/d3-visualization/SKILL.md` - `.ralph/agent/scratchpad.md`
- `.claude/skills/d3-visualization/scripts/bubble_chart_example.js` - `.ralph/agent/summary.md`
- `.claude/skills/d3-visualization/scripts/bubble_chart_example.js:Zone.Identifier` - `.ralph/agent/tasks.jsonl`
- `.claude/skills/d3-visualization/scripts/check_tooltip.js` - `.ralph/current-events`
- `.claude/skills/d3-visualization/scripts/check_tooltip.js:Zone.Identifier` - `.ralph/current-loop-id`
- `.claude/skills/d3-visualization/scripts/interactive_table_example.js` - `.ralph/events-20260217-012659.jsonl`
- `.claude/skills/d3-visualization/scripts/interactive_table_example.js:Zone.Identifier` - `.ralph/history.jsonl`
- `.claude/skills/d3-visualization/scripts/tooltip_handler.js` - `.ralph/loop.lock`
- `.claude/skills/d3-visualization/scripts/tooltip_handler.js:Zone.Identifier` - `.ralph/plan.md`
## Next Session ## Next Session
@@ -70,16 +82,13 @@ Session completed successfully. No pending work.
**Original objective:** **Original objective:**
``` ```
# Task: Career Constellation Chart & Layout Polish # Task: Comprehensive Codebase Refactor & Simplification
Visual polish and layout adjustments to the career constellation chart, sidebar, and repeat medications section. 12 discrete changes across 10 files. Refactor the portfolio codebase to eliminate duplication, consolidate data sources, extract shared utilities, and simplify components — while preserving identical runtime behaviour and visual output.
## Requirements ## Guiding Principle
### 1. Reduce link opacity (`src/components/constellation/constants.ts`) **Single Source of Truth**: Every piece of information should live in exactly one place. Derived data is fine (for code-splitting/performance), but the canonical definition must not be duplicated.
- Lower `LINK_BASE_OPACITY` from `0.08` → `0.04`
- Lower `LINK_STRENGTH_OPACITY_FACTOR` from `0.12` → `0.06`
- Makes skill connection lines subtler so job pills are visually clearer
### 2. White backgro... ## Refactoring Chec...
``` ```
.ralph/agent/scratchpad.md
+43 -667
View File
@@ -1,683 +1,59 @@
# Scratchpad — Comprehensive Codebase Refactor # Content Audit & Boot Sequence Redesign
## 2026-02-17 — Iteration 1: Planning Phase 0.1 ## Iteration 1 — Initial Planning
### Baseline **Objective:** Audit all user-facing text against reference documents, fix inaccuracies, remove ECG phase, redesign boot transition.
- Total src lines: 13,242
- Starting phase in App.tsx: `useState<Phase>('boot')` (line 48)
### Current state **Approach:**
Fresh start. No checklist items completed yet. The plan.md file contains leftover content from a previous objective (profile-content rollout). Will overwrite with new plan. - Phase 0: Quick dev shortcut to bypass boot for faster iteration
- Phase 1: Merge secondary references into single deduplicated doc
- Phase 2: Audit each data file against references (11 sub-tasks)
- Phase 3: Remove ECG, redesign boot→login transition
- Phase 4: Final validation
### Analysis for Phase 0.1 **This iteration:** Phase 0 — disable boot sequence for faster dev iteration.
- Task: Change `useState<Phase>('boot')` → `useState<Phase>('pmr')` in `src/App.tsx` line 48
- This is a single-character change that skips the boot/ECG/login sequence
- All components and imports remain untouched
- Verification: `npm run build` passes
- This is the simplest possible first step — confidence 100
## 2026-02-17 — Iteration 2: Build Phase 0.1 ## Iteration 1 — Complete
### Completed Phase 0 done. App.tsx initial phase changed to 'pmr'. Build passes.
- Changed `useState<Phase>('boot')` → `useState<Phase>('pmr')` in `src/App.tsx` line 48 Commit: f7469f4. Next: Phase 1 — merge secondary reference documents.
- `npm run build` passes cleanly
- Marked 0.1 complete in Ralph/PROMPT.md and .ralph/plan.md
- Next up: Phase 1.1 — Migrate medications.ts history into skills.ts
## 2026-02-17 — Iteration 3: Coordinating Phase 1.1 ## Iteration 2 — Phase 1 Complete
### Backpressure status Created `References/andy_charlwood_complete_reference.md` — 518-line deduplicated merge of both secondary sources. Structured by: career timeline (McDonald's → Paydens → Tesco → NHS ICB), key projects (11 detailed), high-cost drug pathways, technical skills, leadership style, stakeholder engagement, career transition strategy, education, personal interests, and quick-reference metrics table.
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (6.62s)
- Phase 0.1 confirmed complete — App.tsx line 48 shows `'pmr'`
### Plan for Phase 1.1 Key merge decisions:
- Task: task-1771291778-077f — Migrate medications.ts prescribingHistory into skills.ts - Career knowledge dump had more detail on Paydens, McDonald's, Tesco learning journey, AI/LLM work, polypharmacy dashboard, ICB merger, daily work breakdown, speaking engagements — all included
- medications.ts is dead code (zero imports) but contains rich prescribingHistory data - Career knowledge had cleaner narrative structure for projects and stakeholder engagement — used as skeleton
- Need to: merge data into skills.ts, update SkillMedication type, delete medications.ts - Where metrics conflicted (e.g. £2.8M vs £2.6M savings), included both with context (£2.8M max potential, refined to £2.6M)
- Delegating to Refactor Planner via work.start to analyse and produce a detailed plan - Preserved all quotes from knowledge dump (philosophy section)
## 2026-02-17 — Iteration 4: Build Phase 1.1 Commit: 9e31843. This unblocks all Phase 2 audit tasks (2.1–2.10).
### Analysis ## Iteration 3 — ALL PHASES COMPLETE
- medications.ts had 18 entries (262 lines), skills.ts had 21 entries (240 lines)
- ID mapping: 17 of 18 medication entries matched skills (med-dashboard had no match — Dashboard Development is subsumed by Power BI)
- 3 skills had no medication counterpart: excel, change-management, financial-modelling, executive-comms — they don't get prescribingHistory
### Changes made Completed all remaining 16 tasks in a single iteration:
1. `src/types/pmr.ts`: Added `prescribingHistory?: PrescribingHistoryEntry[]` to `SkillMedication` interface
2. `src/types/pmr.ts`: Removed dead `Medication` interface (was only used by medications.ts)
3. `src/data/skills.ts`: Added prescribingHistory arrays to 17 matching skill entries
4. Deleted `src/data/medications.ts`
### Verification **Phase 2 (Content Audit) — 11 tasks:**
- lint: pass (0 errors, 5 pre-existing warnings) - patient.ts: Address corrected NR1→UK
- typecheck: pass (clean) - timeline.ts: 9 corrections (Duty Pharm Led→Co-led, Pre-Reg PGD wording, UEA "academic excellence" removed, HCD "Authored"→"Wrote", etc.)
- build: pass (4.13s) - kpis.ts: Budget reporting frequency, "monitor medicines safety" removed
- No broken imports (medications.ts had zero consumers) - investigations.ts: PharMetrics corrected from "Interactive Platform" to "Switching Dashboard"
- skills.ts: Python startYear 2019→2017 (8yr), SQL startYear 2018→2022 (3yr)
- documents.ts + educationExtras.ts: Research description tightened
- profile-content.ts: Narrative aligned with CV, removed "clinical decision support"
- llm-prompt.ts: Synced all corrections into LLM system prompt
- alerts.ts: Verified, no changes needed
- BootSequence.tsx: Verified, no changes needed
- Final sweep: Flagged NHS Band "8a" and hardcoded education details
## 2026-02-17 — Iteration 5: Build Phase 1.2 **Phase 3 (Boot Sequence Redesign) — 3 tasks:**
- ECGAnimation.tsx deleted (686 lines). Phase type cleaned. All ECG references removed.
- New boot transition: typing → hold → progress bar → fade out. Polished "launching" feel.
- Boot re-enabled from 'pmr' back to 'boot'.
### Analysis **Phase 4 (Final Validation) — 2 tasks:**
- `timelineNarrative` in `profile-content.ts` contained ~155 lines of narrative data for 8 timeline entities - unverified-content.md finalized: 7 flagged items, 21 corrections, 8 missed opportunities
- `getTimelineNarrativeEntry()` was called 32 times in `timeline.ts` — 4 calls per entity (description, details, outcomes, codedEntries) - All quality gates pass: lint (0 errors), typecheck (clean), build (success)
- No other consumers of the function or the `TimelineNarrativeId`/`TimelineNarrativeEntry` types
### Changes made All success criteria met. LOOP_COMPLETE.
1. `src/data/timeline.ts`: Inlined all narrative data (description, details, outcomes, codedEntries) directly into each TimelineEntity object; removed import of `getTimelineNarrativeEntry`
2. `src/data/profile-content.ts`: Removed entire `timelineNarrative` section (~155 lines)
3. `src/lib/profile-content.ts`: Removed `getTimelineNarrativeEntry()` function and its type imports (`TimelineNarrativeId`, `TimelineNarrativeEntry`)
4. `src/types/profile-content.ts`: Removed `TimelineNarrativeCodeEntry`, `TimelineNarrativeEntry`, `TimelineNarrativeId` types and `timelineNarrative` field from `ProfileContent` interface
### Verification
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.41s)
- All narrative data preserved — identical runtime output
## 2026-02-17 — Iteration 6: Coordinating Phase 1.3
### Backpressure status (resolving build.blocked event)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.19s)
- Phases 0.1, 1.1, 1.2 all verified complete
### Analysis of profile-content.ts after Phase 1.2
After removing timelineNarrative, `src/data/profile-content.ts` is now 246 lines containing:
1. **profile** section: sectionTitle, patientSummaryNarrative, latestResults, sidebar copy — all UI labels/strings
2. **experienceEducation**: educationEntries (4 items with title/subtitle/keywords), UI labels
3. **skillsNarrative**: summary text, UI labels + categories
4. **resultsNarrative**: 4 achievement entries (title/subtitle/keywords/kpiId)
5. **searchChat**: quickActions (4 items), LLM systemPrompt (~110 lines)
### Consumers (from grep):
- `getLatestResultsCopy, getProfileSectionTitle, getProfileSummaryText` → PatientSummaryTile.tsx
- `getSidebarCopy` → Sidebar.tsx
- `getExperienceEducationUICopy` → TimelineInterventionsSubsection.tsx
- `getSkillsUICopy` → RepeatMedicationsSubsection.tsx, SkillsAllDetail.tsx
- `getLLMCopy` → llm.ts
- `getSearchQuickActions, getAchievementEntries, getEducationEntries` → search.ts
### Plan for Phase 1.3
The objective says to split profile-content.ts into focused concerns:
- LLM system prompt → inline into llm.ts or dedicated file
- Education narrative → merge into documents.ts or educationExtras.ts
- Keep only genuinely unique content in profile-content.ts
However, looking at the current state, profile-content.ts is a cohesive text/copy store (246 lines) with clear structure and typed accessors. The LLM prompt is the largest chunk (~110 lines) and is the best candidate for extraction. The education entries and achievements are compact and well-organized.
Delegating to Refactor Planner to analyse and produce detailed plan for this phase.
## 2026-02-17 — Iteration 7: Planning Phase 1.3
### Analysis
After Phase 1.2, profile-content.ts is 246 lines with 5 sections. The LLM systemPrompt (~110 lines) is the dominant chunk with a single consumer (llm.ts). Education entries carry `keywords` not present in documents.ts, so merging would bloat Document type. Achievement entries are compact and unique.
### Decision
Extract LLM prompt only → new `src/data/llm-prompt.ts`. Keep education, achievements, quick actions, and UI labels in profile-content.ts as a cohesive "UI copy and search metadata" store.
### Changes planned
1. Create `src/data/llm-prompt.ts` with `LLM_SYSTEM_PROMPT` const
2. Remove `searchChat.llm` from `src/data/profile-content.ts`
3. Remove `LLMCopy` from types and `getLLMCopy()` from accessors
4. Update `src/lib/llm.ts` to import directly from `@/data/llm-prompt`
5. Result: profile-content.ts drops from ~246 to ~135 lines
Plan written to .ralph/plan.md. Emitting plan.ready.
## 2026-02-17 — Iteration 8: Build Phase 1.3
### Changes made
1. Created `src/data/llm-prompt.ts` — exported `LLM_SYSTEM_PROMPT` const (110 lines)
2. `src/data/profile-content.ts` — removed entire `llm` property from `searchChat` section (246 → 133 lines, net -113 lines)
3. `src/types/profile-content.ts` — removed `LLMCopy` interface, removed `llm` field from `searchChat` in `ProfileContent`
4. `src/lib/profile-content.ts` — removed `getLLMCopy()` function and `LLMCopy` import
5. `src/lib/llm.ts` — import changed from `getLLMCopy` to direct `LLM_SYSTEM_PROMPT` import; `buildSystemPrompt()` returns the const directly
### Verification
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (6.44s)
- No remaining references to `getLLMCopy` or `LLMCopy` anywhere in src/
- `buildSystemPrompt()` returns identical string at runtime
### Post-state
- profile-content.ts: 133 lines — cohesive UI copy + search metadata store
- llm-prompt.ts: 110 lines — self-contained LLM system prompt
- Phase 1.3 complete. Next: Phase 1.4 (evaluate thin re-export layers)
## 2026-02-17 — Iteration 9: Coordinating Phase 1.4
### Backpressure status (resolving build.blocked event — was stale)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.21s)
- Phases 0.1, 1.1, 1.2, 1.3 all verified complete
### Analysis for Phase 1.4
Two thin re-export layers to evaluate:
1. **`src/data/constellation.ts`** (9 lines) — 5 consumers:
- useForceSimulation.ts, useTimelineAnimation.ts, SkillDetail.tsx, CareerConstellation.tsx, screen-reader-description.ts
- Caches `buildConstellationData()` result at module level — valuable; without it each consumer would call the build function independently
- **Decision: KEEP** — serves a real purpose (module-level caching + clean API surface)
2. **`src/data/tags.ts`** (10 lines) — 1 consumer (Sidebar.tsx)
- Derives `Tag[]` from `getTopTimelineSkills()` with color assignment
- Only one consumer, so could inline into Sidebar.tsx
- However, it's clean derived data with a clear responsibility, and inlining would mix data derivation with UI
- **Decision: KEEP** — clean separation of concerns, minimal overhead
### Action
Both files are justified re-export/derivation layers. Add brief comments explaining why the indirection exists, then move to Phase 2.1.
Delegating to Refactor Planner to produce the plan for Phase 1.4 + Phase 2.1.
## 2026-02-17 — Iteration 10: Planning Phase 1.4 + Phase 2.1
### Analysis
- Phase 1.4 is trivial: add clarifying comments to constellation.ts and tags.ts (both kept)
- Phase 2.1 analysis complete:
- `hexToRgba`: 3 identical definitions in DashboardLayout, WorkExperienceSubsection, TimelineInterventionsSubsection
- `prefersReducedMotion`: 6 module-level definitions (5 local + 1 in constellation/constants.ts)
- 5 files already import from constellation/constants.ts — those will continue to work via re-export
- 5 files with inline/hook/useState patterns are intentionally different and should NOT be changed
### Decision
- Move both `hexToRgba` and `prefersReducedMotion` to `src/lib/utils.ts`
- Re-export `prefersReducedMotion` from `constellation/constants.ts` to avoid changing 5 existing importers
- Remove 3 local `hexToRgba` defs and 5 local `prefersReducedMotion` defs
- Combined 1.4 + 2.1 into one iteration since 1.4 is comments-only
### Plan written to .ralph/plan.md. Emitting plan.ready.
## 2026-02-17 — Iteration 11: Build Phase 1.4 + Phase 2.1
### Phase 1.4 — Re-export layer comments
- Added clarifying comment to `src/data/constellation.ts` (module-level caching purpose, 5 consumers)
- Added clarifying comment to `src/data/tags.ts` (data derivation separated from UI)
- Both files kept as-is — justified indirection layers
### Phase 2.1 — Utility extraction
1. `src/lib/utils.ts`: Added `hexToRgba()` function and `prefersReducedMotion` const
2. `src/components/DashboardLayout.tsx`: Removed local `hexToRgba` (6 lines) + `prefersReducedMotion` (1 line), added import from `@/lib/utils`
3. `src/components/WorkExperienceSubsection.tsx`: Removed local `hexToRgba` (6 lines) + `prefersReducedMotion` (1 line), added import from `@/lib/utils`
4. `src/components/TimelineInterventionsSubsection.tsx`: Removed local `hexToRgba` (6 lines) + `prefersReducedMotion` (1 line), added import from `@/lib/utils`
5. `src/components/CommandPalette.tsx`: Removed local `prefersReducedMotion` (1 line), added import from `@/lib/utils`
6. `src/components/ChatWidget.tsx`: Removed local `prefersReducedMotion` (1 line), added import from `@/lib/utils`
7. `src/components/constellation/constants.ts`: Replaced local `prefersReducedMotion` with re-export from `@/lib/utils` (preserves 5 existing `./constants` importers)
### Verification
- `hexToRgba` defined in exactly 1 file: `src/lib/utils.ts`
- `prefersReducedMotion` module-level const in exactly 1 file: `src/lib/utils.ts` (ProjectsTile uses intentionally different useState+effect pattern)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.23s)
- Net lines removed: ~26 (3×7 hexToRgba + 5×1 prefersReducedMotion - 8 new import lines + 9 new lines in utils.ts)
- Phases 1.4 and 2.1 complete. Next: Phase 2.2
## 2026-02-17 — Iteration 12: Coordinating Phase 2.2
### Backpressure status (resolving build.blocked event — was stale)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.17s)
- Phases 0.1, 1.1, 1.2, 1.3, 1.4, 2.1 all verified complete
### Plan for Phase 2.2
- Task: Audit codebase for other repeated patterns used 3+ times
- Candidates from objective: date formatting, color manipulation, responsive breakpoint checks, animation config objects
- Delegating to Refactor Planner via work.start to analyse and identify consolidation targets
## 2026-02-17 — Iteration 13: Planning Phase 2.2
### Audit Results
Comprehensive search across all src/ files found these duplicated patterns:
#### 1. STATUS COLOR MAPS — 4 locations, 1 inconsistency (HIGH)
- `Card.tsx` and `DetailPanel.tsx`: identical 5-color maps `{ teal, amber, green, alert, purple }`
- `PatientSummaryTile.tsx` and `KPIDetail.tsx`: identical 3-color maps `{ green, amber, teal }`
- `ProjectsTile.tsx` vs `ProjectDetail.tsx`: **INCONSISTENT** — `Ongoing` is `#0D6E6E` in tile but `#D97706` in detail; `Live` is `#059669` in tile but `#0D6E6E` in detail
- Note: index.css also defines `--amber`, `--alert`, `--purple` CSS vars
#### 2. DEFAULT ORG COLOR FALLBACK — 9 occurrences (MEDIUM)
- `consultation.orgColor ?? '#0D6E6E'` repeated 6 times in WorkExperienceSubsection and 3 times in DashboardLayout
- Should be a named constant
#### 3. MOTION-SAFE TRANSITION PATTERN — 7 occurrences (MEDIUM)
- `prefersReducedMotion ? { duration: 0 } : { duration: X, ease: 'easeOut' }` in DashboardLayout (2x), WorkExperienceSubsection, ChatWidget (2x), TimelineInterventionsSubsection, MobileAccordion
- Vary only by duration and delay — perfect for a utility function
#### 4. SHADOW rgba(26,43,42,...) — 15+ occurrences (LOW-MEDIUM)
- Already partly in CSS vars (`--shadow-sm`, `--shadow-md`, `--shadow-lg`)
- Some inline JS usages can't easily use CSS vars (D3 flood-color, dynamic hover)
- Worth extracting base color `26,43,42` as a constant but low ROI for a function since opacities vary and most are unique contexts
#### 5. BREAKPOINT CHECKS — border case (3 for 640, 2 for 768) (LOW)
- `window.innerWidth < 640` in 3 files (useForceSimulation, AccessibleNodeOverlay, CareerConstellation)
- These are inside different contexts (hooks, components, D3) — extracting a constant is simple but extracting a function adds minimal value since the comparison is trivially clear
- Breakpoint values already in tailwind.config.js and CLAUDE.md
### Decision: What to extract
**Extract (3+ occurrences, clear shared concern):**
1. **STATUS_COLORS map** → `src/lib/theme-colors.ts`
- Full map: `{ teal, amber, green, alert, purple }` (used by Card, DetailPanel)
- KPI subset: `{ green, amber, teal }` (used by PatientSummaryTile, KPIDetail)
- Project map: fix inconsistency, single definition (used by ProjectsTile, ProjectDetail)
2. **DEFAULT_ORG_COLOR constant** → `src/lib/theme-colors.ts`
- `'#0D6E6E'` — replace 9 inline fallbacks
3. **motionSafeTransition() utility** → `src/lib/utils.ts`
- `(duration, ease?, delay?) => prefersReducedMotion ? { duration: 0 } : { duration, ease, delay }`
- Replace 7 inline ternaries
**Skip (below threshold or low ROI):**
- Shadow rgba: already in CSS vars, remaining inline usages are in varied contexts
- Breakpoint constants: only 3 occurrences of 640 check, trivially clear inline
- Date formatting: only 2 occurrences
- Section heading styles: varied enough across components to not warrant extraction
## 2026-02-17 — Iteration 14: Build Phase 2.2
### Changes made
#### Change 1: Created `src/lib/theme-colors.ts` — centralised color maps
- `DOT_COLORS`: 5-color map (teal, amber, green, alert, purple)
- `KPI_COLORS`: 3-color subset (green, amber, teal) derived from DOT_COLORS
- `PROJECT_STATUS_COLORS`: 3-status map (Complete=green, Ongoing=amber, Live=teal) — fixes ProjectsTile inconsistency
- `DEFAULT_ORG_COLOR`: '#0D6E6E' constant
#### Change 2: Added `motionSafeTransition()` to `src/lib/utils.ts`
- `motionSafeTransition(duration, ease?, delay?)` — returns motion-safe transition object
#### Files updated (13 total):
1. `Card.tsx` — removed local `dotColorMap`, import `DOT_COLORS`
2. `DetailPanel.tsx` — removed local `dotColorValueMap`, import `DOT_COLORS`
3. `PatientSummaryTile.tsx` — removed local `colorMap`, import `KPI_COLORS`
4. `KPIDetail.tsx` — removed local `colorMap`, import `KPI_COLORS`
5. `ProjectsTile.tsx` — removed local `statusColorMap` (had wrong values), import `PROJECT_STATUS_COLORS`
6. `ProjectDetail.tsx` — removed local `statusColorMap`, import `PROJECT_STATUS_COLORS`
7. `WorkExperienceSubsection.tsx` — import `DEFAULT_ORG_COLOR` + `motionSafeTransition`, replaced 6 hardcoded fallbacks + 1 transition ternary
8. `DashboardLayout.tsx` — import `DEFAULT_ORG_COLOR` + `motionSafeTransition`, replaced 3 hardcoded fallbacks + 2 transition ternaries
9. `ChatWidget.tsx` — import `motionSafeTransition`, replaced 2 transition ternaries
10. `TimelineInterventionsSubsection.tsx` — import `motionSafeTransition`, replaced 1 transition ternary
11. `MobileAccordion.tsx` — import `motionSafeTransition` from `@/lib/utils`, replaced 1 transition ternary
### Verification
- `dotColorMap` / `dotColorValueMap`: zero matches in src/ ✅
- `statusColorMap`: zero matches in src/ ✅
- `orgColor ?? '#0D6E6E'`: zero matches in src/ ✅
- `prefersReducedMotion ? { duration: 0 }`: zero matches in src/ ✅
- lint: pass (0 errors, 5 pre-existing warnings) ✅
- typecheck: pass (clean) ✅
- build: pass (4.40s) ✅
- Project status inconsistency fixed (ProjectsTile now matches ProjectDetail) ✅
### Post-state
- Phase 2.2 complete. All Phase 2 items done. Next: Phase 3.1
## 2026-02-17 — Iteration 15: Coordinating Phase 3.1
### Backpressure status (resolving build.blocked + task.abandoned events — both stale)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.24s)
- Phases 0.1, 1.1, 1.2, 1.3, 1.4, 2.1, 2.2 all verified complete
### Plan for Phase 3.1
- Task: task-1771293556-ad30 — Extract shared ExpandableCard component
- Three subsection components (WorkExperienceSubsection ~306 lines, TimelineInterventionsSubsection ~346 lines, RepeatMedicationsSubsection ~294 lines) all implement expand/collapse card patterns
- Need to analyse the shared pattern: expand/collapse toggle, animation, consistent styling
- Each subsection keeps unique content rendering via children/render props
- Delegating to Refactor Planner via work.start to analyse and produce detailed plan
## 2026-02-17 — Iteration 16: Planning Phase 3.1
### Critical finding
RepeatMedicationsSubsection does NOT have an expand/collapse pattern. `SkillRow` is a flat clickable row — no AnimatePresence, no isExpanded, no height animation. Only WorkExperienceSubsection and TimelineInterventionsSubsection share the expandable card pattern.
### Shared pattern (WorkExperience RoleItem vs Timeline TimelineInterventionItem)
Both implement:
1. Container with border highlight + hover effects
2. Header button with role="button", tabIndex, Enter/Space/Escape keyboard handling
3. Org color dot (9px)
4. ChevronRight with 90deg rotation on expand
5. AnimatePresence height 0→auto→0 with motionSafeTransition(0.2)
6. Expanded content with borderTop, borderLeft using orgColor
7. Detail bullets with 4px dot markers
8. Coded entry badges (monospace, orgColor-tinted)
9. "View full record" button with opacity hover
### Differences
- Header padding: 12px 14px vs 8px 8px
- Header layout: Work stacks role/org/duration; Timeline has pill label + title/org+date
- Data fields: consultation.* vs entity.*
- Timeline has className and data-tile-id attributes
- Timeline has optional codedEntries guard
### Decision
Extract `ExpandableCardShell` component with render props for header and body content. This captures the structural expand/collapse interaction pattern (~50 lines duplicated in each consumer) into a single source of truth. Each consumer keeps its unique content rendering.
Plan written to .ralph/plan.md. Emitting plan.ready.
## 2026-02-17 — Iteration 17: Build Phase 3.1
### Changes made
1. Created `src/components/ExpandableCardShell.tsx` (147 lines) — shared expand/collapse card shell:
- Container with highlight/expanded border styling + hover effects
- Header button with role="button", tabIndex, keyboard handler (Enter/Space/Escape)
- Org color dot (9px circle)
- ChevronRight with 90deg rotation
- AnimatePresence height 0→auto→0 with motionSafeTransition(0.2)
- Expanded content wrapper with borderTop, borderLeft, padding
- Configurable: accentColor, headerPadding, className, dataTileId, ariaLabel
- Render props: renderHeader(), renderBody()
2. `WorkExperienceSubsection.tsx` (296 → 207 lines, -89 lines)
- Removed: container div, keyboard handler, hover handlers, AnimatePresence, chevron, org dot
- Replaced with ExpandableCardShell usage
- Removed unused React import and framer-motion imports
3. `TimelineInterventionsSubsection.tsx` (335 → 239 lines, -96 lines)
- Removed: container div, keyboard handler, hover handlers, AnimatePresence, chevron, org dot
- Replaced with ExpandableCardShell usage
- Removed unused React import and framer-motion imports
### Verification
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.43s)
- framer-motion no longer imported in either consumer file
- Net: 631 lines to 593 lines (-38 lines), single source of truth for expand/collapse
### Post-state
- Phase 3.1 complete. Next: Phase 3.2
## 2026-02-17 — Iteration 18: Coordinating Phase 3.2
### Backpressure status (resolving build.blocked + task.abandoned events — both stale)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.40s)
- Phases 0.1, 1.1, 1.2, 1.3, 1.4, 2.1, 2.2, 3.1 all verified complete
### Analysis for Phase 3.2 — Simplify detail panel components
**Key finding: The shared shell already exists in `DetailPanel.tsx`.**
`DetailPanel.tsx` already handles ALL structural concerns:
- Fixed right-side slide-in container with animation
- Header with colored dot, title text, close button
- Escape key handling + focus trap (useFocusTrap hook)
- Scrollable body area
- Width mapping (narrow/wide) per content type
- Backdrop overlay
The 6 detail components are **content-only** renderers — they don't individually handle container, close button, scroll, or animation. They receive their data as props and render inside the DetailPanel body.
**Shared style patterns across the 6 detail components:**
1. Root container: `{ fontFamily: 'var(--font-ui)', display: 'flex', flexDirection: 'column', gap: '24px' }`
2. Section heading (h3): `{ fontSize: 12px, fontWeight: 600, color: 'var(--text-secondary)', textTransform: 'uppercase', letterSpacing: '0.05em', marginBottom: '8px' }` — used 15+ times across all components
3. Bullet list container: `{ margin: 0, paddingLeft: '20px', display: 'flex', flexDirection: 'column', gap: '8px' }`
4. List item / paragraph text: `{ fontSize: '14px', lineHeight: '1.6', color: 'var(--text-primary)' }`
**EducationDetail already extracts sectionHeaderStyle as a const** — the other 5 components inline it repeatedly.
### Decision
The objective's description of Phase 3.2 ("extract shared layout: container, header, close button, scroll behaviour, enter/exit animation") is already done — that IS `DetailPanel.tsx`. What remains is extracting the **repeated inline style constants** into shared style objects that all 6 detail components can import. This is a style de-duplication, not a structural extraction.
Extract to `src/components/detail/detail-styles.ts`:
1. `detailRootStyle` — root flex column container
2. `sectionHeadingStyle` — the uppercase section header (replaces ~15 inline definitions)
3. `bulletListStyle` — standard list container
4. `listItemStyle` — standard list item text
5. `paragraphStyle` — standard body paragraph
Then update all 6 detail components to use these shared styles.
Delegating to Refactor Planner via work.start to produce the detailed plan.
## 2026-02-17 — Iteration 19: Planning Phase 3.2
### Analysis
Read all 6 detail components. Confirmed the structural shell (container, header, close, scroll, animation) already exists in `DetailPanel.tsx`. The 6 components are content-only renderers.
Shared inline style patterns found:
1. **Root container** (`fontFamily: 'var(--font-ui)', display: 'flex', flexDirection: 'column', gap: '24px'`): 5 files (SkillsAllDetail uses `gap: '20px'`, intentionally different)
2. **Section heading h3** (uppercase, 12px, 600, secondary color): **16 occurrences** across 5 files (SkillDetail has one with `marginBottom: '10px'` variant)
3. **Bullet list container** (margin 0, paddingLeft 20px, flex column, gap 8px): **5 occurrences** across 4 files
4. **Body text / list item** (14px, 1.6 lineHeight, primary color): **5 occurrences** as `<li>`, **6 occurrences** as `<p>` with `margin: 0`
### Decision
Create `src/components/detail/detail-styles.ts` with 5 exports: `detailRootStyle`, `sectionHeadingStyle`, `bulletListStyle`, `bodyTextStyle`, `paragraphStyle`. Update 5 of 6 detail components (SkillsAllDetail excluded — no matching patterns). Estimated ~160 net lines saved.
Plan written to .ralph/plan.md. Emitting plan.ready.
## 2026-02-17 — Iteration 20: Build Phase 3.2
### Changes made
1. Created `src/components/detail/detail-styles.ts` (38 lines) — 5 shared CSSProperties constants:
- `detailRootStyle`: root flex column container
- `sectionHeadingStyle`: uppercase section heading (h3)
- `bulletListStyle`: standard list container
- `bodyTextStyle`: standard body text (for `<li>`)
- `paragraphStyle`: paragraph text (bodyTextStyle + margin: 0)
2. `EducationDetail.tsx` (236 → 189 lines, -47 lines)
- Removed local `sectionHeaderStyle` const (8 lines)
- Replaced root div style → `detailRootStyle`
- Replaced 4 sectionHeaderStyle → `sectionHeadingStyle`
- Replaced ul → `bulletListStyle`, li → `bodyTextStyle`, p → `paragraphStyle`
- Notes paragraph uses `{ ...paragraphStyle, color, fontStyle }` spread
3. `ConsultationDetail.tsx` (237 → 149 lines, -88 lines)
- Replaced root div → `detailRootStyle`
- Replaced 4 inline h3 styles → `sectionHeadingStyle`
- Replaced 2 ul → `bulletListStyle`, 2 li → `bodyTextStyle`, 1 p → `paragraphStyle`
4. `SkillDetail.tsx` (272 → 232 lines, -40 lines)
- Replaced root div → `detailRootStyle`
- Replaced 2 exact h3 styles → `sectionHeadingStyle`
- "Used In" h3 uses `{ ...sectionHeadingStyle, marginBottom: '10px' }` spread
5. `KPIDetail.tsx` (191 → 118 lines, -73 lines)
- Replaced story branch root div → `detailRootStyle`
- Non-story fallback kept inline (intentionally different)
- Replaced 3 h3 → `sectionHeadingStyle`, 1 ul → `bulletListStyle`, 1 li → `bodyTextStyle`, 2 p → `paragraphStyle`
6. `ProjectDetail.tsx` (207 → 143 lines, -64 lines)
- Replaced root div → `detailRootStyle`
- Replaced 3 h3 → `sectionHeadingStyle`, 1 ul → `bulletListStyle`, 1 li → `bodyTextStyle`, 1 p → `paragraphStyle`
### Verification
- Inline `fontSize: '12px', fontWeight: 600, color: 'var(--text-secondary)'` in detail/: zero matches ✅
- lint: pass (0 errors, 5 pre-existing warnings) ✅
- typecheck: pass (clean) ✅
- build: pass (6.68s) ✅
- Net: 1143 → 869 lines = **-274 lines** (exceeded estimate of ~160)
### Post-state
- Phase 3.2 complete. Next: Phase 3.3
## 2026-02-17 — Iteration 21: Coordinating Phase 3.3
### Backpressure status (resolving build.blocked event — was stale)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.69s)
- Phases 0.1, 1.1, 1.2, 1.3, 1.4, 2.1, 2.2, 3.1, 3.2 all verified complete
### Plan for Phase 3.3
- Task: Review large components for extraction opportunities
- Target components (by line count):
- ECGAnimation: 686 lines
- ChatWidget: 643 lines
- Sidebar: 572 lines
- BootSequence: 497 lines
- DashboardLayout: 492 lines
- CommandPalette: 455 lines
- LoginScreen: 449 lines
- Criteria: only extract where it genuinely reduces complexity, prioritise sections with own state/effects
- Delegating to Refactor Planner via work.start to analyse each component and identify extraction targets
## 2026-02-17 — Iteration 22: Planning Phase 3.3
### Analysis of 7 large components
#### ECGAnimation (687 lines)
- Zero React state (all refs) with a single monolithic useEffect running a canvas animation loop
- 5 pure helper functions defined outside the component (generateHeartbeatPoints, interpolateLetterY, getTextTotalWidth, layoutText, measureCharBaselineEdges) + 50 lines of letter/constant definitions
- The animation loop is deeply integrated — every canvas draw call depends on shared timing state
- **Verdict: SKIP extraction.** This is a highly cohesive canvas animation. The helper functions are already well-separated from the component. Splitting the animation loop into sub-functions would just scatter logic without reducing complexity — you'd need to pass the same ctx/timing/dimensions to every function.
#### ChatWidget (644 lines)
- 4 useState, 2 useEffect, 3 helper functions, 4 callbacks
- **Messages area (lines ~292-532, ~240 lines)** is a prime extraction target — it has its own scroll ref and rendering logic
- But: the messages area depends on `messages`, `isStreaming`, `inputValue`, `handleSubmit`, `onAction` from parent. Extracting means passing 6+ props, which is prop-drilling without meaningful encapsulation.
- **Verdict: SKIP.** The component's state is tightly coupled to its rendering. Moving JSX to a sub-component doesn't reduce cognitive complexity — it just moves it.
#### Sidebar (573 lines)
- Already has 3 extracted internal sub-components (SectionTitle, TagPill, AlertFlag)
- 2 useState, 1 useEffect (media query)
- **Patient profile section (~234 lines)** is the largest block, but it's purely presentational with no own state/effects
- The 6 field rows could share a `ProfileField` component, but they vary enough (conditional formatting, inline styles) that a shared component would need multiple configuration props
- **Verdict: SKIP.** Already well-structured with extracted sub-components. Further extraction is aesthetic, not complexity-reducing.
#### BootSequence (498 lines)
- 4 useState, 5 useEffect (typing engine, hold phase, fade phase, reduced motion, layout)
- `buildTypedLines()` (83 lines) is a pure data transformation that runs once at module load — could move to a config module but it's already at module scope, not inside the component
- `renderLines()` (76 lines) depends on component state (typedCount, phase, cursorPos)
- Reduced motion fallback duplicates some line rendering logic
- **Verdict: SKIP.** The effects orchestrate a tightly-coupled typing animation sequence. buildTypedLines is already extracted to module scope. renderLines depends on component state.
#### DashboardLayout (493 lines)
- 5 useState, 3 useEffect
- **`LastConsultationSubsection` (191 lines, lines 44-235)** is already defined as a separate function inside the file with its own interface. It uses `useDetailPanel()` context and receives only `highlightedRoleId` as a prop.
- **Verdict: EXTRACT `LastConsultationSubsection` to its own file.** It's already a standalone component — moving to a separate file is trivial and reduces DashboardLayout from ~493 to ~302 lines. This is the clearest win: zero refactoring of the component itself, just a file split.
#### CommandPalette (456 lines)
- 3 useState, 5 useEffect
- Results rendering (~112 lines) depends heavily on parent state (query, selectedIndex, allResults, executeAction)
- `Kbd` sub-component (16 lines) at bottom is tiny and only used here
- **Verdict: SKIP.** Tightly coupled to search state. No self-contained sections with own state/effects.
#### LoginScreen (450 lines)
- 11 useState (!) but they're all part of one animation orchestration sequence
- 4 useEffect that form a timing chain
- Username/password fields are visually similar but differ in: typing source (text vs dots), cursor logic, active field tracking
- **Verdict: SKIP.** The 11 state variables look alarming but they're all part of a single coordinated animation. Extracting sub-components would require passing most of this state down, adding complexity.
### Decision
**Only one extraction is justified: `LastConsultationSubsection` → separate file.**
All other components are either:
1. Tightly coupled canvas/animation code where splitting adds prop-drilling without reducing complexity (ECG, Boot, Login)
2. Already well-structured with internal sub-components (Sidebar)
3. State-heavy UI where sub-components would need 5+ props passed from parent (ChatWidget, CommandPalette)
The objective says "only extract where it genuinely reduces complexity" — and for 6 of 7 components, extraction would be arbitrary line-count reduction that moves JSX around without improving readability or maintainability.
## 2026-02-17 — Iteration 23: Build Phase 3.3
### Changes made
1. Created `src/components/LastConsultationCard.tsx` (204 lines)
- Moved `LastConsultationSubsection` from DashboardLayout.tsx
- Renamed to `LastConsultationCard` (component name matches file)
- Moved exclusive imports: `ChevronRight`, `CardHeader`, `hexToRgba`, `DEFAULT_ORG_COLOR`
- Uses `useDetailPanel()` context and `timelineConsultations` data directly
2. Updated `src/components/DashboardLayout.tsx` (493 → 293 lines, -200 lines)
- Removed `LastConsultationSubsection` function + interface (196 lines)
- Removed now-unused imports: `React`, `ChevronRight`, `CardHeader`, `hexToRgba`, `DEFAULT_ORG_COLOR`
- Added import: `{ LastConsultationCard } from './LastConsultationCard'`
- Updated JSX: `<LastConsultationSubsection` → `<LastConsultationCard`
### Verification
- lint: pass (0 errors, 5 pre-existing warnings) ✅
- typecheck: pass (clean) ✅
- build: pass (4.54s) ✅
- `LastConsultationSubsection` no longer defined in DashboardLayout.tsx ✅
- DashboardLayout reduced from 493 to 293 lines ✅
### Post-state
- Phase 3.3 complete. All Phase 3 items done. Next: Phase 4.1
## 2026-02-17 — Iteration 24: Coordinating Phase 4.1 + 4.2
### Backpressure status (resolving build.blocked event — was stale)
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.14s)
- Phases 0.1, 1.1, 1.2, 1.3, 1.4, 2.1, 2.2, 3.1, 3.2, 3.3 all verified complete
### Plan for Phase 4
Phase 4 is the final cleanup:
- **4.1**: Remove dead code and unused exports — scan for unused imports, exports, types, orphaned files
- **4.2**: Final validation and baseline comparison — lint zero warnings (5 pre-existing), typecheck, build, compare line count to baseline (13,242)
- **4.3**: Re-enable boot/ECG/login sequence — change `useState<Phase>('pmr')` back to `useState<Phase>('boot')`
All three can be planned and executed together since they're sequential cleanup steps.
Delegating to Refactor Planner via work.start to scan for dead code, compute final line count, and produce the cleanup plan.
## 2026-02-17 — Iteration 25: Build Phase 4.1 + 4.2 + 4.3
### Phase 4.1 — Remove dead code and unused exports
#### Scan results
Used agent-based dead code scan across all src/. Findings:
**Orphaned files (3):**
- `src/components/SubNav.tsx` (96 lines) — never imported
- `src/components/TopBar.tsx` (208 lines) — never imported
- `src/data/problems.ts` (111 lines) — never imported
**Unused exports (2 functions):**
- `calculateSkillOffset()` in utils.ts — no consumers
- `formatBootLine()` in utils.ts — no consumers (returned input unchanged)
**Unused accessor:**
- `getProfileContent()` in profile-content.ts — no consumers (other getters used, not this top-level one)
**Unused types (6):**
- `types/index.ts`: Skill, Experience, Education, Project, ContactItem, BootLine — only Phase used
- `types/pmr.ts`: ViewId, NavItem, ReferralFormData, Problem — never imported
- `lib/theme-colors.ts`: DotColorName — never imported
**Preserved (structurally referenced within pmr.ts):**
- TimelineEntityKind, TimelineEntityDateRange — used by TimelineEntity
- PrescribingHistoryEntry — used by SkillMedication
- KPIStory — used by KPI
- DocumentType — used by Document
- InvestigationResult was unused but turned out to also be removable
### Phase 4.2 — Final validation and baseline comparison
- lint: pass (0 errors, 5 pre-existing warnings)
- typecheck: pass (clean)
- build: pass (4.27s)
- **Baseline:** 13,242 lines
- **Final:** 12,140 lines
- **Reduction: -1,102 lines (8.3%)**
### Phase 4.3 — Re-enable boot/ECG/login sequence
- Changed `useState<Phase>('pmr')` back to `useState<Phase>('boot')` in App.tsx
- build: pass (4.37s)
- Committed: `fix: re-enable boot sequence after refactor`
### Post-state
- All Phase 4 items complete
- All phases (0-4) complete
- All success criteria met
LOOP_COMPLETE
.ralph/agent/summary.md
+3 -3
View File
@@ -1,8 +1,8 @@
# Loop Summary # Loop Summary
**Status:** Completed successfully **Status:** Completed successfully
**Iterations:** 27 **Iterations:** 3
**Duration:** 55m 41s **Duration:** 25m 16s
## Tasks ## Tasks
@@ -14,4 +14,4 @@ _No events recorded._
## Final Commit ## Final Commit
01a48ce: fix: re-enable boot sequence after refactor 841c186: chore: finalise unverified-content.md audit summary
.ralph/agent/tasks.jsonl
+18
View File
@@ -45,3 +45,21 @@
{"id":"task-1771291778-077f","title":"Phase 1.1: Migrate medications.ts prescribingHistory into skills.ts, then delete medications.ts","description":"Merge prescribingHistory arrays from src/data/medications.ts into corresponding entries in src/data/skills.ts. Update SkillMedication type in src/types/pmr.ts. Delete medications.ts. Verify build passes.","status":"closed","priority":1,"blocked_by":[],"loop_id":"primary-20260217-012659","created":"2026-02-17T01:29:38.329600962+00:00","closed":"2026-02-17T01:32:23.180282710+00:00"} {"id":"task-1771291778-077f","title":"Phase 1.1: Migrate medications.ts prescribingHistory into skills.ts, then delete medications.ts","description":"Merge prescribingHistory arrays from src/data/medications.ts into corresponding entries in src/data/skills.ts. Update SkillMedication type in src/types/pmr.ts. Delete medications.ts. Verify build passes.","status":"closed","priority":1,"blocked_by":[],"loop_id":"primary-20260217-012659","created":"2026-02-17T01:29:38.329600962+00:00","closed":"2026-02-17T01:32:23.180282710+00:00"}
{"id":"task-1771292321-e764","title":"Phase 1.3: Split profile-content.ts into focused concerns — extract LLM prompt, evaluate education/achievements placement","description":"After 1.2 completion, profile-content.ts is 246 lines. Extract LLM systemPrompt to llm.ts or dedicated file. Evaluate whether education entries and achievements should move. Keep profile-content.ts for genuinely unique UI copy only.","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-012659","created":"2026-02-17T01:38:41.911205927+00:00","closed":"2026-02-17T01:43:00.417343336+00:00"} {"id":"task-1771292321-e764","title":"Phase 1.3: Split profile-content.ts into focused concerns — extract LLM prompt, evaluate education/achievements placement","description":"After 1.2 completion, profile-content.ts is 246 lines. Extract LLM systemPrompt to llm.ts or dedicated file. Evaluate whether education entries and achievements should move. Keep profile-content.ts for genuinely unique UI copy only.","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-012659","created":"2026-02-17T01:38:41.911205927+00:00","closed":"2026-02-17T01:43:00.417343336+00:00"}
{"id":"task-1771293556-ad30","title":"Phase 3.1: Extract shared ExpandableCard component from WorkExperienceSubsection, TimelineInterventionsSubsection, RepeatMedicationsSubsection","description":"Extract common expand/collapse card pattern into ExpandableCard.tsx, reducing duplication across 3 subsection components","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-012659","created":"2026-02-17T01:59:16.961841961+00:00","closed":"2026-02-17T02:03:38.625048871+00:00"} {"id":"task-1771293556-ad30","title":"Phase 3.1: Extract shared ExpandableCard component from WorkExperienceSubsection, TimelineInterventionsSubsection, RepeatMedicationsSubsection","description":"Extract common expand/collapse card pattern into ExpandableCard.tsx, reducing duplication across 3 subsection components","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-012659","created":"2026-02-17T01:59:16.961841961+00:00","closed":"2026-02-17T02:03:38.625048871+00:00"}
{"id":"task-1771297441-47cc","title":"Phase 0: Disable boot/login for faster iteration","description":"Change useState Phase boot to pmr in App.tsx, verify build passes","status":"closed","priority":1,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:01.214989484+00:00","closed":"2026-02-17T03:04:54.765481391+00:00"}
{"id":"task-1771297447-322f","title":"Phase 1: Merge secondary reference documents","description":"Read both career knowledge files, create deduplicated merged reference","status":"closed","priority":1,"blocked_by":["task-1771297441-47cc"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:07.471600890+00:00","closed":"2026-02-17T03:10:00.164257071+00:00"}
{"id":"task-1771297457-6530","title":"Phase 2.1: Audit patient.ts","description":"Verify personal details against references","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:17.484658038+00:00","closed":"2026-02-17T03:11:52.179397274+00:00"}
{"id":"task-1771297457-bf43","title":"Phase 2.2: Audit timeline.ts","description":"Verify career narratives - largest content file","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:17.573252787+00:00","closed":"2026-02-17T03:14:45.242936609+00:00"}
{"id":"task-1771297457-08ae","title":"Phase 2.3: Audit kpis.ts","description":"Verify metrics match CV exactly","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:17.657583328+00:00","closed":"2026-02-17T03:15:49.725948312+00:00"}
{"id":"task-1771297457-5864","title":"Phase 2.4: Audit investigations.ts","description":"Verify projects methodology results tech stack","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:17.743525512+00:00","closed":"2026-02-17T03:16:57.547953894+00:00"}
{"id":"task-1771297457-a81d","title":"Phase 2.5: Audit skills.ts","description":"Verify skill descriptions and prescribing history","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:17.829470269+00:00","closed":"2026-02-17T03:18:08.842924200+00:00"}
{"id":"task-1771297457-fca2","title":"Phase 2.6: Audit documents.ts and educationExtras.ts","description":"Verify education credentials","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:17.916644096+00:00","closed":"2026-02-17T03:18:57.012788559+00:00"}
{"id":"task-1771297458-0e6b","title":"Phase 2.7: Audit profile-content.ts","description":"Verify UI copy and narrative text","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:18.003692252+00:00","closed":"2026-02-17T03:20:28.780848146+00:00"}
{"id":"task-1771297458-622d","title":"Phase 2.8: Audit llm-prompt.ts","description":"Verify system prompt reflects accurate profile","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:18.090674714+00:00","closed":"2026-02-17T03:21:47.621712296+00:00"}
{"id":"task-1771297458-b163","title":"Phase 2.9: Audit alerts.ts","description":"Verify banner messages","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:18.176484641+00:00","closed":"2026-02-17T03:22:05.461628135+00:00"}
{"id":"task-1771297458-029f","title":"Phase 2.10: Audit BootSequence.tsx","description":"Verify terminal boot text","status":"closed","priority":2,"blocked_by":["task-1771297447-322f"],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:18.262819455+00:00","closed":"2026-02-17T03:22:05.548645902+00:00"}
{"id":"task-1771297458-4f63","title":"Phase 2.11: Final sweep for hardcoded strings","description":"Check components for remaining hardcoded text","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:18.348005503+00:00","closed":"2026-02-17T03:23:38.024405947+00:00"}
{"id":"task-1771297465-54bf","title":"Phase 3.1: Remove ECG phase entirely","description":"Delete ECGAnimation.tsx, remove from App.tsx, remove ecg from Phase type","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:25.283840612+00:00","closed":"2026-02-17T03:26:22.910370425+00:00"}
{"id":"task-1771297465-a476","title":"Phase 3.2: Redesign boot-to-login transition","description":"Create polished software launch transition with reduced-motion support","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:25.369783672+00:00","closed":"2026-02-17T03:28:05.015285743+00:00"}
{"id":"task-1771297465-10bf","title":"Phase 3.3: Re-enable and verify boot sequence","description":"Change back to boot phase, verify full flow, build passes","status":"closed","priority":2,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:25.463040291+00:00","closed":"2026-02-17T03:28:45.201117879+00:00"}
{"id":"task-1771297465-763c","title":"Phase 4.1: Compile unverified content summary","description":"Ensure References/unverified-content.md is complete","status":"closed","priority":3,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:25.554560166+00:00","closed":"2026-02-17T03:29:17.618361543+00:00"}
{"id":"task-1771297465-c9be","title":"Phase 4.2: Final quality gates","description":"lint + typecheck + build all pass, boot sequence works","status":"closed","priority":3,"blocked_by":[],"loop_id":"primary-20260217-030331","created":"2026-02-17T03:04:25.641472037+00:00","closed":"2026-02-17T03:29:51.752918816+00:00"}
.ralph/current-events
+1 -1
View File
@@ -1 +1 @@
.ralph/events-20260217-012659.jsonl .ralph/events-20260217-030331.jsonl
.ralph/current-loop-id
+1 -1
View File
@@ -1 +1 @@
primary-20260217-012659 primary-20260217-030331
.ralph/events-20260217-030331.jsonl
+5
View File
@@ -0,0 +1,5 @@
{"ts":"2026-02-17T03:03:31.331002246+00:00","iteration":0,"hat":"loop","topic":"task.start","triggered":"planner","payload":"# Task: Content Accuracy Audit & Boot Sequence Redesign\n\nAudit all user-facing text content on the portfolio website against authoritative reference documents. Replace hallucinated or inaccurate content with verified text. Redesign the boot sequence to remove the ECG phase and create a polished software-launch transition.\n\n## Reference Documents (Sources of Truth)\n\n**Primary (highest authority — written and reviewed by Andy):**\n- `References/CV_v4.md`\n\n**Secondary (comprehensive but compiled b... [truncated, 8616 chars total]"}
{"payload":"Phase 0 complete: boot sequence bypassed for dev, build passes","topic":"task.done","ts":"2026-02-17T03:05:03.537605525+00:00"}
{"payload":"Phase 1 complete: merged secondary reference documents into andy_charlwood_complete_reference.md (518 lines). Unblocks Phase 2 audit tasks.","topic":"task.done","ts":"2026-02-17T03:10:16.867219236+00:00"}
{"payload":"All 16 tasks closed. Phase 2: content audit (11 files, 21 corrections, 8 missed opportunities). Phase 3: ECG removed, boot transition redesigned with progress bar. Phase 4: quality gates pass, boot enabled.","topic":"LOOP_COMPLETE","ts":"2026-02-17T03:30:33.723132737+00:00"}
{"ts":"2026-02-17T03:30:44.153294520+00:00","iteration":3,"hat":"loop","topic":"loop.terminate","payload":"## Reason\ncompleted\n\n## Status\nAll tasks completed successfully.\n\n## Summary\n- Iterations: 3\n- Duration: 25m 16s\n- Exit code: 0"}
.ralph/history.jsonl
+2
View File
File diff suppressed because one or more lines are too long
.ralph/loop.lock
+3 -3
View File
@@ -1,5 +1,5 @@
{ {
"pid": 1722820, "pid": 1801078,
"started": "2026-02-17T01:26:59.016513882Z", "started": "2026-02-17T03:03:31.323822114Z",
"prompt": "# Task: Comprehensive Codebase Refactor & Simplification\n\nRefactor the portfolio codebase to elimin..." "prompt": "# Task: Content Accuracy Audit & Boot Sequence Redesign\n\nAudit all user-facing text content on the ..."
} }
Ralph/PROMPT.md
+106 -100
View File
@@ -1,141 +1,147 @@
# Task: Comprehensive Codebase Refactor & Simplification # Task: Content Accuracy Audit & Boot Sequence Redesign
Refactor the portfolio codebase to eliminate duplication, consolidate data sources, extract shared utilities, and simplify components — while preserving identical runtime behaviour and visual output. Audit all user-facing text content on the portfolio website against authoritative reference documents. Replace hallucinated or inaccurate content with verified text. Redesign the boot sequence to remove the ECG phase and create a polished software-launch transition.
## Guiding Principle ## Reference Documents (Sources of Truth)
**Single Source of Truth**: Every piece of information should live in exactly one place. Derived data is fine (for code-splitting/performance), but the canonical definition must not be duplicated. **Primary (highest authority — written and reviewed by Andy):**
- `References/CV_v4.md`
## Refactoring Checklist **Secondary (comprehensive but compiled by AI from conversations — may contain inaccuracies):**
- `References/andy_charlwood_complete_reference.md` (merged file you create in Phase 1)
Work through these IN ORDER. Each item is a self-contained refactoring that leaves the codebase in a passing state (lint + typecheck + build). **Original secondary sources (kept for reference, do not modify):**
- `References/andy_charlwood_career_knowledge.md`
- `References/andy_charlwood_career_knowledge_dump.md`
## Content Files to Audit
Every file below contains user-facing text that must be verified:
| File | Content Type |
|------|-------------|
| `src/data/timeline.ts` | Career roles (6) + education (2) with descriptions, details, outcomes, codedEntries |
| `src/data/skills.ts` | 21 skills with prescribing history narratives |
| `src/data/kpis.ts` | 4 KPIs with values, labels, story context, outcomes |
| `src/data/llm-prompt.ts` | ~100 line system prompt with full professional profile |
| `src/data/profile-content.ts` | UI copy: profile narrative, achievements, education entries, skill summaries |
| `src/data/patient.ts` | Personal details: name, contact, location, registration |
| `src/data/alerts.ts` | 2 alert banner messages |
| `src/data/investigations.ts` | 5 projects with methodology, results, tech stack |
| `src/data/documents.ts` | Education credentials, grades, research detail |
| `src/data/educationExtras.ts` | Extracurriculars, research descriptions, OSCE score |
| `src/components/BootSequence.tsx` | Terminal boot text: system name, user, role, location |
## Checklist
Work through IN ORDER. Each phase leaves the codebase in a passing state (lint + typecheck + build).
### Phase 0: Dev Shortcut ### Phase 0: Dev Shortcut
- [x] **0.1 — Disable boot/ECG/login sequence for faster visual review** - [ ] **0.1 — Disable boot/login sequence for faster iteration**
- In `src/App.tsx` line 48, change `useState<Phase>('boot')` to `useState<Phase>('pmr')` - In `src/App.tsx` line 48, change `useState<Phase>('boot')` to `useState<Phase>('pmr')`
- This skips straight to the dashboard, saving ~10s per visual inspection - Do NOT remove components or imports — just bypass them
- Do NOT remove the BootSequence/ECGAnimation/LoginScreen components or imports — just bypass them - Verify: `npm run build` passes
- Verify: `npm run build` passes, app loads directly to dashboard at localhost:5173
### Phase 1: Data Consolidation ### Phase 1: Merge Secondary Reference Documents
- [x] **1.1 — Migrate medications.ts history into skills.ts, then delete medications.ts** - [ ] **1.1 — Create merged secondary reference file**
- `src/data/medications.ts` has ZERO imports anywhere (dead code) but contains `prescribingHistory[]` arrays with rich skill progression data - Read both `References/andy_charlwood_career_knowledge.md` and `References/andy_charlwood_career_knowledge_dump.md`
- Merge the `prescribingHistory` data into corresponding entries in `src/data/skills.ts` (add a `prescribingHistory` field to SkillMedication type) - Create `References/andy_charlwood_complete_reference.md` — a single, deduplicated document
- Update `src/types/pmr.ts` if needed for the new field - Structure: logical sections (Career Timeline, Projects, Skills, Education, Leadership, Goals, etc.)
- Delete `src/data/medications.ts` - Where the two files conflict, prefer the more detailed/specific version
- Verify: no broken imports, build passes - Where the two files duplicate, keep only one copy
- Do NOT modify the original files
- The merged file is your secondary source of truth for all subsequent phases
- [x] **1.2 — Consolidate timeline narrative into timeline.ts** ### Phase 2: Content Audit & Correction
- `src/data/profile-content.ts` contains a `timelineNarrative` section (~320 lines) that is pulled into `timeline.ts` via `getTimelineNarrativeEntry()`
- Inline the narrative content directly into the `TimelineEntity` objects in `timeline.ts`
- Remove the `timelineNarrative` section from `profile-content.ts`
- Remove `getTimelineNarrativeEntry()` from `src/lib/profile-content.ts` and all call sites
- Verify: timeline entities still have all their description/details/outcomes/codedEntries data
- [x] **1.3 — Split profile-content.ts into focused concerns** For each file in the audit list, compare every piece of text content against the reference documents. Apply these rules:
- After 1.2, `profile-content.ts` should be smaller. Split remaining content:
- LLM system prompt → inline into `src/lib/llm.ts` or a dedicated `src/data/llm-prompt.ts`
- Education narrative → merge into `src/data/documents.ts` or `educationExtras.ts`
- Profile summary/achievements → keep in `profile-content.ts` only if genuinely unique
- Goal: `profile-content.ts` either deleted or contains only truly unique content with zero duplication
- Update `src/lib/profile-content.ts` accessor functions and all consumers
- Update `src/types/profile-content.ts` types to match
- [x] **1.4 — Evaluate thin re-export layers** **Rule 1 — Primary source match:** If text can be verified against `References/CV_v4.md`, ensure the language matches closely. Prefer lifting phrasing directly from the CV where it reads naturally.
- `src/data/constellation.ts` (9 lines) re-exports from `timeline.ts`
- `src/data/tags.ts` (10 lines) derives from `timeline.ts`
- For each: inline at call sites if few consumers, or keep if many consumers benefit
- If kept, add a brief comment explaining why the indirection exists
- If removed, update all import paths
### Phase 2: Utility Extraction **Rule 2 — Secondary source match:** If text isn't in the CV but IS in the merged secondary reference, it can stay — but flag for review if the wording seems embellished or AI-generated. Tighten the language to sound natural and factual.
- [x] **2.1 — Extract duplicated utility functions into lib/utils.ts** **Rule 3 — No source match:** If text content (facts, claims, metrics, descriptions) cannot be verified against ANY reference document, add it to `References/unverified-content.md` and remove it from the website. Format: file path, the unverified text, and why it couldn't be verified.
- `hexToRgba()` is defined locally in at least: `DashboardLayout.tsx`, `TimelineInterventionsSubsection.tsx`, `WorkExperienceSubsection.tsx`
- `prefersReducedMotion` media query is repeated across 8+ files
- Extract both to `src/lib/utils.ts` (currently only 8 lines with `cn()`)
- Replace all local definitions with imports from `@/lib/utils`
- Verify: no duplicate function definitions remain, search codebase to confirm
- [x] **2.2 — Audit and consolidate other repeated patterns** **Rule 4 — Missed opportunities:** While auditing, note any skills, projects, achievements, or goals from the reference documents that are NOT represented on the website but could be valuable additions. Add these to a "Missed Opportunities" section in `References/unverified-content.md` for future consideration.
- Search for other duplicated helper functions, constants, or inline logic across components
- Extract anything used in 3+ places into shared modules
- Common candidates: date formatting, color manipulation, responsive breakpoint checks, animation config objects
### Phase 3: Component Simplification Work through files in this order:
- [ ] **3.1 — Extract shared ExpandableCard component** - [ ] **2.1 — Audit patient.ts** (personal details — quick win, easy to verify)
- `WorkExperienceSubsection.tsx` (306 lines), `TimelineInterventionsSubsection.tsx` (346 lines), and `RepeatMedicationsSubsection.tsx` (294 lines) all implement expand/collapse card patterns with similar styling and interaction logic - [ ] **2.2 — Audit timeline.ts** (career narratives — largest content file, most critical)
- Extract the shared pattern into `src/components/ExpandableCard.tsx` - [ ] **2.3 — Audit kpis.ts** (metrics and values — must match CV exactly)
- The shared component handles: expand/collapse toggle, animation, consistent styling - [ ] **2.4 — Audit investigations.ts** (projects — verify methodology, results, tech stack)
- Each subsection keeps its unique content rendering via children/render props - [ ] **2.5 — Audit skills.ts** (skill descriptions and prescribing history)
- Goal: measurable line reduction across the three files - [ ] **2.6 — Audit documents.ts and educationExtras.ts** (education credentials)
- [ ] **2.7 — Audit profile-content.ts** (UI copy and narrative text)
- [ ] **2.8 — Audit llm-prompt.ts** (system prompt — must reflect accurate profile)
- [ ] **2.9 — Audit alerts.ts** (banner messages)
- [ ] **2.10 — Audit BootSequence.tsx** (terminal boot text)
- [ ] **2.11 — Final sweep for any remaining hardcoded strings in components**
- [ ] **3.2 — Simplify detail panel components** ### Phase 3: Boot Sequence Redesign
- 6 detail panel components share structural patterns: `SkillDetail`, `SkillsAllDetail`, `ConsultationDetail`, `EducationDetail`, `ProjectDetail`, `KPIDetail`
- Extract shared layout into a base component: container, header, close button, scroll behaviour, enter/exit animation
- Each detail component keeps its unique content but reuses the shared shell
- Look at `src/components/detail/` directory
- [ ] **3.3 — Review large components for extraction opportunities** - [ ] **3.1 — Remove ECG phase entirely**
- Components over 400 lines: ECGAnimation (686), ChatWidget (648), Sidebar (572), DashboardLayout (503), BootSequence (497), CommandPalette (456), LoginScreen (449) - Delete `src/components/ECGAnimation.tsx`
- For each: identify self-contained sections that can become sub-components - Remove ECG import, phase, and rendering from `src/App.tsx`
- Only extract where it genuinely reduces complexity — not arbitrary line-count reduction - Remove `'ecg'` from the `Phase` type in `src/types/` (or wherever it's defined)
- Prioritise sections with their own state/effects that don't need parent state - Update flow: boot → login (no ECG intermediary)
### Phase 4: Final Cleanup - [ ] **3.2 — Redesign boot-to-login transition**
- Create a convincing "software launching" experience that transitions from the terminal boot into the login screen
- The boot sequence already has a terminal/CLI aesthetic — lean into this
- Ideas to consider (pick what works best):
- Boot terminal completes its checks, then smoothly morphs/dissolves into the login screen
- A loading progress bar or spinner after boot completes, then login fades in
- Terminal text clears line-by-line (or collapses) as the login interface materialises
- A brief "system ready" state with a visual flourish before transitioning
- The transition should feel intentional and polished, not abrupt
- Must respect `prefers-reduced-motion` (instant transition if reduced motion preferred)
- Keep the Skip button visible during boot — it should skip directly to the dashboard (`'pmr'` phase)
- [ ] **4.1 — Remove dead code and unused exports** - [ ] **3.3 — Verify boot sequence flow**
- After all refactoring, scan for: unused imports, unused exports, unused types, orphaned files - Re-enable boot sequence: change `useState<Phase>('pmr')` back to `useState<Phase>('boot')`
- ESLint should catch most — run `npm run lint` and fix everything - Manually verify: boot → transition → login → dashboard
- Manually check for files that are no longer imported anywhere - Skip button works and goes straight to dashboard
- `npm run build` passes
- [ ] **4.2 — Final validation and baseline comparison** ### Phase 4: Final Validation
- `npm run lint` passes with zero warnings
- [ ] **4.1 — Compile unverified content summary**
- Ensure `References/unverified-content.md` is complete and well-formatted
- Sections: "Removed Content" (with file/line references) and "Missed Opportunities" (from reference docs)
- [ ] **4.2 — Final quality gates**
- `npm run lint` passes with zero errors
- `npm run typecheck` passes with zero errors - `npm run typecheck` passes with zero errors
- `npm run build` succeeds - `npm run build` succeeds
- Compare total line count against baseline (recorded at start) - Boot sequence plays correctly (not bypassed)
- Record the reduction in this file
- [ ] **4.3 — Re-enable boot/ECG/login sequence**
- In `src/App.tsx`, change `useState<Phase>('pmr')` back to `useState<Phase>('boot')`
- Verify: `npm run build` passes
- Do a final Playwright visual check to confirm the full boot → ECG → login → dashboard flow works
- Commit: `fix: re-enable boot sequence after refactor`
## Success Criteria ## Success Criteria
ALL of the following must be true: ALL of the following must be true:
- [ ] Every checklist item above is complete (or explicitly escalated with reason) - [ ] `References/andy_charlwood_complete_reference.md` exists as a clean, deduplicated merge
- [ ] Every text claim on the website is verifiable against at least one reference document
- [ ] Language in career/achievement descriptions closely matches CV_v4.md phrasing
- [ ] `References/unverified-content.md` lists all removed content and missed opportunities
- [ ] ECG phase is completely removed (component deleted, type removed, no references)
- [ ] Boot → login transition is smooth, polished, and respects reduced motion
- [ ] Skip button skips directly to dashboard
- [ ] `npm run lint && npm run typecheck && npm run build` passes cleanly - [ ] `npm run lint && npm run typecheck && npm run build` passes cleanly
- [ ] No data is defined in more than one place (single source of truth) - [ ] No runtime errors — app loads and all content renders correctly
- [ ] `src/data/medications.ts` is deleted (history migrated to skills.ts)
- [ ] `hexToRgba()` exists in exactly one location
- [ ] `prefersReducedMotion` query is centralised
- [ ] Shared component patterns are extracted (ExpandableCard, detail panel base)
- [ ] Total codebase line count is measurably reduced
- [ ] Zero runtime behaviour changes — identical visual output
## Constraints ## Constraints
- TypeScript strict mode must be maintained - TypeScript strict mode must be maintained
- Preserve all existing path aliases (`@/*`) - Preserve all existing path aliases (`@/*`)
- Follow existing naming conventions (PascalCase components, kebab-case utils) - Follow existing naming conventions (PascalCase components, kebab-case utils)
- Conventional commit messages for each logical change (`refactor: ...`) - Conventional commit messages for each logical change
- Do not modify the app's phases or lifecycle (boot → ECG → login → dashboard) — except the temporary Phase 0 bypass which is reverted in 4.3 - Do not change Tailwind classes or visual styling (except for boot sequence redesign)
- Do not change any Tailwind classes or visual styling - Do not add new dependencies (unless genuinely needed for boot transition — prefer CSS/Framer Motion which are already installed)
- Do not add new dependencies
- Do not remove the CLAUDE.md file - Do not remove the CLAUDE.md file
- Do not modify the original reference files (`andy_charlwood_career_knowledge.md`, `andy_charlwood_career_knowledge_dump.md`)
## Baseline - The `References/` directory is for reference only — not deployed with the site
Record line count before starting. Run at first iteration:
```bash
find src -name '*.ts' -o -name '*.tsx' | xargs wc -l
```
Store result in .ralph/plan.md for comparison at end.
## Status ## Status