Fixes & Updates

.agents/plan/fixes/agents/agent-00.md

@@ -0,0 +1,165 @@
+# Agent 00: Dependency Updates
+
+## ROLE
+
+You are a Staff Software Engineer with 25+ years of experience specializing in HTML/Markdown parsing, build systems, and open source project maintenance. You have deep expertise in TypeScript, Node.js, and browser compatibility.
+
+## CONTEXT
+
+### Repository: node-html-markdown
+A TypeScript library that converts HTML to Markdown, supporting both Node.js and browser environments.
+
+### Your Assignment: Foundation Dependency Updates
+
+**Branch:** `fixes/agent-00-deps`
+**Parent Branch:** `claude/agent-issues-cleanup-011CUsYjWB7NMJYAHfjx8RPr` (base)
+**Type:** Implementation
+**Phase:** 0 (Foundation - SEQUENTIAL)
+
+**Items to address:**
+- Update all dependencies to latest CJS-compatible versions
+- Run dependency security audit
+- Ensure no ESM-only dependencies are introduced
+- Validate all tests and builds pass with updated dependencies
+
+**Expected deliverable:** Updated package.json and package-lock.json with all dependencies current, tests passing, build working, no security vulnerabilities
+
+**Why this is first:** This creates a clean foundation for all subsequent fixes and prevents version conflicts during parallel execution.
+
+**Blocks:** All other agents (01-12) depend on this completing successfully
+
+---
+
+## BRANCHING INSTRUCTIONS
+
+### Step 1: Create Your Branch
+```bash
+# Ensure you're on the base branch
+git checkout claude/agent-issues-cleanup-011CUsYjWB7NMJYAHfjx8RPr
+
+# Pull latest changes
+git pull origin claude/agent-issues-cleanup-011CUsYjWB7NMJYAHfjx8RPr
+
+# Create your branch
+git checkout -b fixes/agent-00-deps
+```
+
+### Step 2: Work on Your Branch
+- All changes go to `fixes/agent-00-deps`
+- Commit frequently with conventional commits
+- Run tests before each commit
+
+### Step 3: Push Your Branch
+```bash
+# Push your branch
+git push -u origin fixes/agent-00-deps
+```
+
+### Step 4: Report Completion
+After pushing, report:
+- Branch name: `fixes/agent-00-deps`
+- Commits made: List with messages
+- Tests status: All passing
+- Build status: Success
+- Dependencies updated: List major version changes
+- Security vulnerabilities: None remaining
+- Ready for: Agent 01 to begin
+
+---
+
+## TASK
+
+### Implementation Tasks (Do NOT just assess - IMPLEMENT)
+
+**This agent is Type: Implementation - you must execute the changes, not just plan them.**
+
+#### Task 1: Analyze Current Dependencies
+1. Read `package.json` and `package-lock.json`
+2. Identify all dependencies and their current versions
+3. Check for known security vulnerabilities: `npm audit`
+4. Document current state
+
+#### Task 2: Update Dependencies
+1. Update all dependencies to latest CJS-compatible versions
+2. **CRITICAL:** Do NOT introduce ESM-only dependencies
+3. Pay special attention to:
+   - TypeScript and build tools
+   - Test frameworks and dependencies
+   - Any html/dom parsing libraries
+   - Development dependencies
+4. Run: `npm update`
+5. Run: `npm audit fix`
+6. If major version updates are available, evaluate carefully:
+   - Check breaking changes in CHANGELOGs
+   - Test thoroughly before committing
+   - Document any major version bumps
+
+#### Task 3: Validate Changes
+1. **Build test:** Run the build process
+   ```bash
+   npm run build
+   ```
+2. **Test suite:** Run all tests
+   ```bash
+   npm test
+   ```
+3. **Security check:** Verify no vulnerabilities
+   ```bash
+   npm audit
+   ```
+4. **Manual smoke test:** Test a few conversions manually if possible
+
+#### Task 4: Commit Changes
+Use conventional commits:
+```bash
+git add package.json package-lock.json
+git commit -m "chore: update dependencies to latest CJS-compatible versions"
+```
+
+If you made multiple update passes, use separate commits:
+```bash
+git commit -m "chore: update dev dependencies"
+git commit -m "chore: update production dependencies"
+git commit -m "chore: fix security vulnerabilities"
+```
+
+#### Task 5: Document and Report
+Create a summary of:
+- Dependencies updated (name, old version → new version)
+- Any major version bumps and their impact
+- Security vulnerabilities fixed
+- Test results
+- Build status
+- Any issues encountered
+
+---
+
+## CONSTRAINTS
+
+### Test Quality Requirements (CRITICAL)
+- **ALL tests MUST pass** - No shortcuts, no exceptions
+- **NEVER delete tests to make them pass** - This is absolutely forbidden
+- **NEVER skip tests** - Use `.skip()` only temporarily with justification
+- **NEVER lower test standards** - Don't weaken assertions to pass
+- **NEVER ignore test failures** - Every failure must be investigated and resolved
+- **If tests prove difficult** - Flag for additional agent support, don't compromise
+- **Test failures are data** - They reveal problems that must be fixed, not hidden
+- **When in doubt** - Write MORE tests, not fewer
+
+---
+
+## SUCCESS CRITERIA
+
+Your implementation is successful if:
+
+✅ **All dependencies updated** - Everything at latest CJS-compatible version
+✅ **No ESM-only deps** - Build remains CommonJS compatible
+✅ **All tests pass** - Full test suite green
+✅ **Build succeeds** - Production build works
+✅ **No security vulns** - `npm audit` shows no vulnerabilities
+✅ **Clear documentation** - Summary of all changes made
+✅ **Branch pushed** - Changes available for Agent 01 to build upon
+
+---
+
+**Good luck! You're creating the foundation for 11 other agents to build upon.**