/sdd-new

/sdd-new <change-name>

Want me to continue with specs and design? (or review the proposal first)

/sdd-new add-dark-mode

## Launching explorer sub-agent...

✓ Codebase analyzed. React + Tailwind detected.
✓ Current theme: hardcoded light mode in globals.css
✓ 12 components reference color values directly

### Exploration Summary
**Approach**: CSS custom properties + React Context
**Affected Areas**: Theme system, 12 components, layout wrapper
**Complexity**: Medium (2-3 days)
**Risk**: Medium - Requires testing all UI states

---

## Launching proposal sub-agent...

✓ proposal.md created

### Proposal Summary
**Intent**: Add user-toggleable dark mode with system preference detection
**Scope**: 
  - IN: Theme toggle component, CSS variables, localStorage persistence
  - OUT: Per-component theme overrides, theme customization API
**Approach**: CSS custom properties for colors + React Context for state
**Risk Level**: Medium

### Artifacts Created
- openspec/changes/add-dark-mode/exploration.md
- openspec/changes/add-dark-mode/proposal.md

---

Want me to continue with specs and design? (or review the proposal first)

/sdd-new fix-auth-token-refresh

## Launching explorer sub-agent...

✓ Token refresh logic found in src/auth/token-manager.ts
✓ Issue identified: Race condition when multiple requests trigger refresh
✓ Existing tests: 3 auth tests, none cover concurrent refresh

### Exploration Summary
**Approach**: Mutex lock pattern with promise queue
**Affected Areas**: Token manager, HTTP interceptor
**Complexity**: Low (4-6 hours)
**Risk**: Low - Well-isolated change

---

## Launching proposal sub-agent...

✓ proposal.md created

### Proposal Summary
**Intent**: Fix race condition in token refresh causing 401 errors
**Scope**:
  - IN: Mutex for refresh, promise queue, concurrent refresh tests
  - OUT: Token rotation, refresh token storage changes
**Approach**: Single in-flight refresh with waiting queue
**Risk Level**: Low

### Artifacts Created
- openspec/changes/fix-auth-token-refresh/exploration.md
- openspec/changes/fix-auth-token-refresh/proposal.md

---

Want me to continue with specs and design?

openspec/changes/add-dark-mode/
├── exploration.md    # Codebase analysis
└── proposal.md       # Change proposal

# Proposal: Add Dark Mode

## Intent
Users have requested dark mode for reduced eye strain during night usage.
Current app only supports light theme. 40% of user sessions happen after 8pm.

## Scope

### In Scope
- Dark mode toggle component in header
- CSS custom properties for theme colors
- System preference detection (prefers-color-scheme)
- localStorage persistence of user choice
- Documentation for theme color usage

### Out of Scope
- Per-component theme overrides
- Theme customization API for users
- Multiple theme options beyond dark/light
- Automatic switching based on time

## Approach
Implement CSS custom properties for all colors. Create React Context for theme
state. Detect system preference on mount. Allow manual override via toggle.
Persist choice in localStorage.

## Affected Areas

| Area | Impact | Description |
|------|--------|-------------|
| `src/styles/globals.css` | Modified | Add CSS custom properties |
| `src/components/Layout.tsx` | Modified | Wrap with ThemeProvider |
| `src/components/ThemeToggle.tsx` | New | Toggle component |
| `src/context/ThemeContext.tsx` | New | Theme state management |
| `src/hooks/useTheme.ts` | New | Theme hook |

## Risks

| Risk | Likelihood | Mitigation |
|------|------------|------------|
| CSS specificity conflicts | Medium | Use CSS cascade layers |
| Flash of wrong theme on load | High | Inline script in HTML head |
| Missed color references | Medium | Comprehensive component testing |

## Rollback Plan
1. Remove ThemeProvider from Layout
2. Delete new theme files
3. Revert globals.css to previous version
4. Deploy - app returns to light mode only

## Dependencies
- None

## Success Criteria
- [ ] Users can toggle between light and dark modes
- [ ] System preference is detected and respected
- [ ] User choice persists across sessions
- [ ] No flash of unstyled content on page load
- [ ] All UI components render correctly in both themes