LorenFrankLab
diff --git a/‎.claude/commands/refactor.md‎
Lines changed: 232 additions & 0 deletions b/‎.claude/commands/refactor.md‎
Lines changed: 232 additions & 0 deletions
diff --git a/‎.claude/commands/setup.md‎
Lines changed: 72 additions & 0 deletions b/‎.claude/commands/setup.md‎
Lines changed: 72 additions & 0 deletions
diff --git a/‎.eslintignore‎
Lines changed: 7 additions & 0 deletions b/‎.eslintignore‎
Lines changed: 7 additions & 0 deletions
@@ -0,0 +1,232 @@
+---
+description: Quick access to refactoring project status, documentation, and common operations
+---
+
+# 🔄 Refactoring Project Assistant
+
+**Context:** You're working on the rec_to_nwb_yaml_creator refactoring project following the comprehensive Phase 0-5 plan.
+
+---
+
+## 📊 Current Status
+
+**Phase:** Phase 0 - Baseline & Infrastructure
+**Branch:** `refactor/phase-0-baselines`
+**Working Directory:** `.worktrees/phase-0-baselines/`
+
+---
+
+## 📚 Key Documentation
+
+Read these files to understand context:
+
+### Critical Reading Order
+1. **CLAUDE.md** - Project overview, zero-tolerance policy, critical workflows
+2. **docs/plans/2025-10-23-phase-0-baselines.md** - Phase 0 detailed implementation plan
+3. **docs/TASKS.md** - Current task checklist with completion status
+4. **docs/SCRATCHPAD.md** - Session notes and performance baselines
+5. **docs/REFACTOR_CHANGELOG.md** - All changes made during refactoring
+
+### Supporting Documentation
+- **docs/ENVIRONMENT_SETUP.md** - Node.js environment details
+- **docs/CI_CD_PIPELINE.md** - GitHub Actions workflow documentation
+- **docs/GIT_HOOKS.md** - Pre-commit/pre-push hook details
+- **docs/INTEGRATION_CONTRACT.md** - Schema sync and device type contracts
+
+---
+
+## 🧪 Common Test Commands
+
+```bash
+# Run all tests
+npm test -- --run
+
+# Run baseline tests only
+npm run test:baseline -- --run
+
+# Run specific test file
+npm test -- validation-baseline.test.js --run
+
+# Run with coverage
+npm run test:coverage -- --run
+
+# Run E2E tests
+npm run test:e2e
+
+# Run integration tests
+npm run test:integration -- --run
+
+# Update visual regression snapshots
+npm run test:e2e -- --update-snapshots
+```
+
+---
+
+## 🔧 Quick Actions
+
+### Check Project Status
+```bash
+# View current phase tasks
+cat docs/TASKS.md | grep -A 50 "## Phase 0"
+
+# Check what's been completed
+git log --oneline --grep="phase0" -20
+
+# View performance baselines
+cat docs/SCRATCHPAD.md
+```
+
+### Run Verification Suite
+```bash
+# Full verification (what CI runs)
+npm run lint && npm run test:baseline -- --run && npm run test:coverage -- --run
+
+# Quick smoke test
+npm test -- --run --passWithNoTests
+```
+
+### Git Workflow
+```bash
+# Current branch and status
+git status
+
+# Commit with phase prefix
+git add <files>
+git commit -m "phase0(category): description"
+
+# View recent commits
+git log --oneline -10
+
+# Push to remote
+git push -u origin refactor/phase-0-baselines
+```
+
+---
+
+## ⚠️ Critical Rules
+
+### Test-Driven Development (TDD)
+1. **ALWAYS write test FIRST**
+2. **Run test and verify it FAILS** (or establishes baseline)
+3. **Only then create implementation**
+4. **Run test until it PASSES**
+5. **Run full regression suite**
+
+### Phase Gate Rules
+- ❌ **DO NOT move to next phase** until ALL current phase tasks are checked
+- ❌ **DO NOT skip tests** to match broken code
+- ❌ **DO NOT change baselines** without explicit approval
+- ✅ **ASK permission** if you need to change requirements
+
+### Zero-Tolerance Policy
+- This is **critical scientific infrastructure**
+- Any regression can **corrupt irreplaceable data**
+- Always use **verification-before-completion** skill
+- Never skip verification steps
+
+---
+
+## 📋 Phase 0 Exit Criteria
+
+Before moving to Phase 1, ALL must be ✅:
+
+- [ ] All baseline tests documented and passing
+- [ ] CI/CD pipeline operational and green
+- [ ] Performance baselines documented
+- [ ] Visual regression baselines captured
+- [ ] Schema sync check working
+- [ ] Human review and approval
+- [ ] Tag created: `git tag v3.0.0-phase0-complete`
+
+**Check current status:** `cat docs/TASKS.md | grep -A 5 "Phase 0 Exit Gate"`
+
+---
+
+## 🆘 Troubleshooting
+
+### Tests Failing
+```bash
+# Check console output for errors
+npm test -- <test-file> --run --no-coverage
+
+# Verify imports work
+npm test -- --run --passWithNoTests
+
+# Clear and reinstall
+rm -rf node_modules && npm install
+```
+
+### Snapshots Need Updating
+```bash
+# Update Vitest snapshots
+npm test -- --run --update
+
+# Update Playwright screenshots
+npm run test:e2e -- --update-snapshots
+```
+
+### Hooks Not Running
+```bash
+# Reinstall hooks
+npx husky install
+
+# Check hook files exist
+ls -la .husky/
+```
+
+### Environment Issues
+```bash
+# Run environment setup
+/setup
+
+# Or manually
+nvm use && npm install
+```
+
+---
+
+## 🎯 Your Next Steps
+
+1. **Read docs/TASKS.md** to find the next unchecked [ ] task
+2. **Read the task specification** in docs/plans/2025-10-23-phase-0-baselines.md
+3. **Follow TDD workflow** for the task:
+   - Write test first
+   - Verify it fails/establishes baseline
+   - Implement
+   - Verify it passes
+   - Run full regression suite
+4. **Update documentation**:
+   - Check off [x] in TASKS.md
+   - Add notes to SCRATCHPAD.md
+   - Update REFACTOR_CHANGELOG.md
+5. **Commit with phase prefix**: `phase0(category): description`
+
+---
+
+## 💡 Remember
+
+- **Read before you code** - Use Read tool to understand context
+- **Test before you implement** - TDD is mandatory
+- **Verify before you claim completion** - Use verification-before-completion skill
+- **Ask when uncertain** - Better to ask than assume
+- **Document as you go** - Update SCRATCHPAD.md with decisions/blockers
+
+---
+
+## 📞 When Blocked
+
+If you encounter any of these, STOP and document in SCRATCHPAD.md:
+
+1. ❓ **Unclear requirements** - Ask for clarification
+2. 🐛 **Unexpected test failures** - Use systematic-debugging skill
+3. 🔄 **Conflicting requirements** - Ask for guidance
+4. ⚠️ **Need to change baselines** - Request approval
+5. 🚫 **Missing dependencies** - Document and ask for help
+
+**Never proceed with assumptions** - this is critical scientific infrastructure.
+
+---
+
+Now tell me: **What task are you working on next?**
+
+Read docs/TASKS.md to find the first unchecked [ ] task in Phase 0.
@@ -0,0 +1,72 @@
+---
+description: Set up the contained development environment (Node.js + dependencies)
+---
+
+# Environment Setup
+
+**CRITICAL:** You MUST run this at the start of any session before making code changes.
+
+## Steps
+
+Follow these steps in order:
+
+### 1. Check for .nvmrc file
+
+Run: `test -f .nvmrc && cat .nvmrc || echo "ERROR: .nvmrc not found"`
+
+Expected: Should display Node version (e.g., "20.19.5")
+
+### 2. Switch to correct Node version
+
+Run: `nvm use`
+
+Expected output should include: "Now using node v20.19.5" or similar
+
+### 3. Verify Node version matches
+
+Run: `node --version`
+
+Expected: Should show "v20.19.5" (matching .nvmrc)
+
+### 4. Install/verify dependencies
+
+Run: `npm install`
+
+Expected: Should complete successfully, may show "up to date" if already installed
+
+### 5. Verify node_modules exists
+
+Run: `ls node_modules | wc -l`
+
+Expected: Should show a large number (800+)
+
+### 6. Run quick smoke test
+
+Run: `npm test -- --version`
+
+Expected: Should display react-scripts test runner version without errors
+
+## Success Report
+
+After completing all steps, announce:
+
+```
+✓ Environment ready: Node v20.19.5, dependencies installed
+✓ Ready to proceed with development tasks
+```
+
+## If Any Step Fails
+
+**DO NOT PROCEED** with code changes. Report the specific failure:
+
+```
+✗ Environment setup failed at step [N]: [error message]
+Unable to proceed until environment is properly configured.
+
+Suggested fixes:
+- Ensure nvm is installed: https://github.com/nvm-sh/nvm
+- Check Node.js version availability: nvm ls
+- Clear node_modules and retry: rm -rf node_modules && npm install
+```
+
+Ask the user to resolve the issue before continuing.
@@ -28,6 +28,13 @@ npm-debug.log.*
 *.sass.d.ts
 *.scss.d.ts
 
+# Build directories
+build
+
+# Config files
+vitest.config.js
+playwright.config.js
+
 # eslint ignores hidden directories by default:
 # https://github.com/eslint/eslint/issues/8429
 !.erb