@thierrynakoa/fire-flow 12.2.1 → 13.0.1

package/skills-library/methodology/MERN_QUICK_REFERENCE.md

@@ -0,0 +1,358 @@
+# Quick Reference Card - Zoom LMS Integration
+**Last Updated**: October 26, 2025
+**Status**: ✅ Production Ready
+
+---
+
+## 🚀 Quick Commands
+
+```bash
+# Test Zoom Connection
+cd server && node test-zoom-connection.js
+
+# Debug Auth Issues
+cd server && node debug-zoom-auth.js
+
+# Start Server
+npm run dev
+
+# Run Tests
+npm test
+
+# Deploy to Production
+npm run build && npm start
+```
+
+---
+
+## 📋 Essential Configuration
+
+### .env (Production)
+```env
+# Zoom (Required)
+ZOOM_ACCOUNT_ID=YOUR_ZOOM_ACCOUNT_ID
+ZOOM_CLIENT_ID=YOUR_ZOOM_CLIENT_ID
+ZOOM_CLIENT_SECRET=YOUR_ZOOM_CLIENT_SECRET
+
+# PayPal (Live Mode)
+PAYPAL_MODE=live
+PAYPAL_CLIENT_ID=AVPCNK2OFrV3Wx46R7wuw0hjjJN...
+
+# Other Settings
+NODE_ENV=production
+PORT=5000
+JWT_SECRET=your_secure_key
+```
+
+---
+
+## 🎯 Essential Scopes (Keep Only These 4!)
+
+```
+✅ meeting:write   - Create/update/delete meetings
+✅ meeting:read    - View meeting details
+✅ user:read       - Read account info
+✅ recording:read  - Access recordings
+
+❌ Remove all 400+ others
+```
+
+---
+
+## 📚 Documentation Map
+
+| Document | Purpose | Read When |
+|----------|---------|-----------|
+| **ZOOM_NEXT_STEPS.md** | Initial setup | Getting started |
+| **ZOOM_REQUIRED_SCOPES.md** | Scope reference | Configuring app |
+| **ZOOM_SCOPES_CLEANUP.md** | Remove unnecessary scopes | After initial setup |
+| **ZOOM_CREDENTIALS_VERIFICATION.md** | Fix auth errors | If authentication fails |
+| **ZOOM_API_TESTING_GUIDE.md** | Test API endpoints | Testing features |
+| **ZOOM_MEETING_LIFECYCLE.md** | Real-world examples | Understanding workflows |
+| **ZOOM_TESTING_CHECKLIST.md** | Complete testing | Before production |
+| **PRODUCTION_DEPLOYMENT_GUIDE.md** | Deployment steps | Going live |
+
+---
+
+## 🧪 Testing Quick Start (30 min)
+
+### Phase 1: Auth (5 min)
+```bash
+node server/test-zoom-connection.js
+# Should show: ✅ All Tests Passed
+```
+
+### Phase 2: Create Meeting (5 min)
+- Login as teacher
+- Create test Zoom meeting
+- Verify in Zoom account
+
+### Phase 3: Join Meeting (5 min)
+- Login as student
+- Click "Join Meeting"
+- Verify attendance tracked
+
+### Phase 4: Recording (10 min)
+- Wait 1-2 hours for processing
+- Access recording as student
+- Verify playback works
+
+### Phase 5: Features (5 min)
+- Test video bookmarks
+- Test YouTube progression
+- Test e-commerce
+
+---
+
+## 🔗 API Endpoints Quick Reference
+
+```
+# Meetings
+GET    /api/zoom/meetings           - List all meetings
+POST   /api/zoom/meetings           - Create meeting
+GET    /api/zoom/meetings/:id       - Get details
+PUT    /api/zoom/meetings/:id       - Update meeting
+DELETE /api/zoom/meetings/:id       - Delete meeting
+POST   /api/zoom/meetings/:id/join  - Join meeting
+
+# Recordings
+GET /api/zoom/meetings/:id/recordings  - Get recordings
+
+# Q&A
+POST /api/zoom/meetings/:id/questions  - Ask question
+PUT  /api/zoom/meetings/:id/questions/:id - Answer
+
+# User
+GET /api/zoom/user                     - Get user info
+
+# Video Progress
+GET    /api/video-progress/:lessonId           - Get progress
+POST   /api/video-progress/:lessonId           - Save progress
+GET    /api/video-progress/course/:courseId    - Course progress
+
+# E-Commerce
+GET    /api/products                  - List products
+POST   /api/cart                      - Add to cart
+GET    /api/cart                      - View cart
+POST   /api/orders                    - Create order
+GET    /api/orders                    - View orders
+```
+
+---
+
+## ✨ Features Matrix
+
+| Feature | Status | Details |
+|---------|--------|---------|
+| Zoom Meetings | ✅ Active | Create, join, record |
+| Video Bookmarks | ✅ Active | Uploaded videos only |
+| Video Progression | ✅ Active | YouTube auto-resume |
+| Attendance | ✅ Active | Auto-tracked |
+| Recordings | ✅ Active | 1-2 hour processing |
+| Q&A | ✅ Active | During/after meetings |
+| E-Commerce | ✅ Active | Products, cart, checkout |
+| PayPal | ✅ Live Mode | Production payments |
+| Video Progress | ✅ Active | Saves position, calculates % |
+
+---
+
+## 🔐 Security Checklist
+
+- [x] Credentials in .env (not in code)
+- [x] HTTPS enabled
+- [x] JWT secrets strong
+- [x] Database backups configured
+- [x] Rate limiting enabled
+- [x] Input validation active
+- [x] CORS configured
+- [x] Zoom tokens auto-refresh
+
+---
+
+## 🚨 Troubleshooting Quick Guide
+
+### Issue: "invalid_client" Error
+**Solution**: Verify credentials match Zoom Marketplace
+```bash
+node server/debug-zoom-auth.js
+```
+
+### Issue: Zoom Tests Failing
+**Solution**: Check if scopes are enabled
+- Go to Zoom Marketplace
+- Verify 4 essential scopes are checked
+
+### Issue: Recording Not Available
+**Solution**: Wait 1-2 hours after meeting ends
+
+### Issue: Meeting Creation Failed
+**Solution**: Check if meeting API quota reached
+- Zoom free tier limited meetings
+- Upgrade plan if needed
+
+### Issue: Attendance Not Tracked
+**Solution**: Ensure student actually joined
+- Check Zoom meeting logs
+- Verify attendance endpoint called
+
+### Issue: Payment Processing Failing
+**Solution**: Verify PayPal live mode enabled
+```env
+PAYPAL_MODE=live  # Not "sandbox"
+```
+
+---
+
+## 📊 Performance Baselines
+
+| Metric | Target | Actual |
+|--------|--------|--------|
+| Page Load | < 3s | - |
+| API Response | < 500ms | - |
+| Meeting Join | < 5s | - |
+| Recording Access | < 2s | - |
+| Video Playback | Smooth | - |
+| Checkout | < 2s | - |
+
+---
+
+## 🎓 User Roles & Permissions
+
+### Student
+- ✅ View courses
+- ✅ Join meetings
+- ✅ Watch recordings
+- ✅ Ask Q&A questions
+- ✅ View video progress
+- ✅ Buy products
+- ❌ Create meetings
+- ❌ Manage courses
+
+### Teacher/Instructor
+- ✅ Create courses
+- ✅ Create meetings
+- ✅ View attendance
+- ✅ Answer Q&A
+- ✅ Upload videos
+- ✅ Manage products
+- ❌ Delete other teachers' meetings
+- ❌ Access admin panel
+
+### Admin
+- ✅ Everything
+- ✅ View all meetings
+- ✅ Manage users
+- ✅ View analytics
+- ✅ Configure system
+- ✅ Manage payments
+
+---
+
+## 🔄 Deployment Flow
+
+```
+Local Development
+       ↓
+   npm run dev (test locally)
+       ↓
+   npm run test (verify tests)
+       ↓
+   npm run build (create production build)
+       ↓
+   git push (commit to main/master)
+       ↓
+   Deploy to Production
+       ↓
+   curl https://domain/api/health (verify)
+       ↓
+   Monitor logs (check for errors)
+       ↓
+   ✅ Live!
+```
+
+---
+
+## 📝 Environment Variables Checklist
+
+```
+General:
+☐ NODE_ENV=production
+☐ PORT=5000
+
+Database:
+☐ DATABASE_URL=postgresql://...
+
+JWT:
+☐ JWT_SECRET=... (generate new for prod)
+
+Zoom:
+☐ ZOOM_ACCOUNT_ID=YOUR_ZOOM_ACCOUNT_ID
+☐ ZOOM_CLIENT_ID=YOUR_ZOOM_CLIENT_ID
+☐ ZOOM_CLIENT_SECRET=YOUR_ZOOM_CLIENT_SECRET
+☐ ZOOM_USER_EMAIL=admin@...
+
+PayPal:
+☐ PAYPAL_MODE=live
+☐ PAYPAL_CLIENT_ID=...
+☐ PAYPAL_CLIENT_SECRET=...
+
+Email:
+☐ EMAIL_HOST=...
+☐ EMAIL_PORT=...
+☐ EMAIL_USER=...
+☐ EMAIL_PASSWORD=...
+
+Frontend:
+☐ CLIENT_URL=https://your-domain.com
+```
+
+---
+
+## 🎯 Success Indicators
+
+✅ All tests passing
+✅ No console errors
+✅ Zoom meetings creating
+✅ Students can join
+✅ Attendance tracked
+✅ Recordings accessible
+✅ Payments processing
+✅ Videos playing
+✅ No security warnings
+✅ Performance acceptable
+
+---
+
+## 📞 Quick Help
+
+**Zoom API Issues?**
+→ See: ZOOM_CREDENTIALS_VERIFICATION.md
+
+**Testing Help?**
+→ See: ZOOM_TESTING_CHECKLIST.md
+
+**Deployment Help?**
+→ See: PRODUCTION_DEPLOYMENT_GUIDE.md
+
+**API Examples?**
+→ See: ZOOM_MEETING_LIFECYCLE.md
+
+**Implementation Details?**
+→ See: ZOOM_INTEGRATION_RECORD.md
+
+---
+
+## 🚀 You're Ready!
+
+✅ All systems configured
+✅ All tests passing
+✅ All documentation complete
+✅ Scopes cleaned up (after you finish)
+✅ Ready for testing
+✅ Ready for production
+
+**Next Step**: Follow ZOOM_TESTING_CHECKLIST.md for complete testing
+
+---
+
+**Bookmark this page for quick reference!** 📑

package/skills-library/methodology/ORGAN_AGENT_MAPPING.md

@@ -0,0 +1,177 @@
+# Organ-Agent Mapping — Biological Architecture for AI Memory Systems
+
+## Problem
+
+AI agent memory systems are designed as flat data stores with no equivalent of biological waste processing, immune defense, or regenerative capacity. Every item in memory is treated equally — there's no filtration, no toxin detection, no fitness testing, no batch elimination, no identity protection barrier. The result: unbounded growth, toxic accumulation, and eventual system collapse.
+
+### Why It Was Hard
+
+- No precedent for mapping biological organ systems to AI agent subsystems
+- Required deep research across 12 human cleansing/filtration systems
+- Each organ has unique physics (pressure-driven, deformability-based, one-way flow, etc.)
+- Cross-organ cooperation patterns (Iron Triangle, EPO Axis) have no obvious AI analog
+- Balancing biological accuracy with practical engineering implementation
+
+### Impact
+
+- Without organ mapping, agent memory systems lack the self-cleaning capacity of biological systems
+- Waste accumulates without filtration, transformation, or elimination
+- No triage system for resource scarcity (which subsystem to protect first?)
+- No immune defense against toxic input (credentials, prompt injection, destructive patterns)
+
+---
+
+## The Solution
+
+### Root Cause
+
+Biological systems have survived 3.8 billion years of evolution by developing specialized organs for intake, processing, filtration, elimination, and protection. AI agents have only intake and storage — they're bodies without kidneys, livers, or lungs.
+
+### 12-Organ Architecture
+
+#### Tier 1: Primary Filtration (The Essential Four)
+
+| Organ | Agent Subsystem | Biological Function | Agent Function |
+|-------|----------------|--------------------| --------------|
+| **Kidneys** | Context Window Filter | Continuous pressure-driven filtration. 180L/day filtered, 99% reabsorbed, 1% excreted as urine. Glomerulus uses 3-layer filter (size, charge, slit). | Filter all context entries continuously. Keep 99% of useful context. Flush 1% waste. Use Glomerulus 3-layer gate for each entry. |
+| **Liver** | Security Gate + Transformer | 500+ metabolic functions. Phase I (expose via cytochrome P450) + Phase II (conjugation for excretion). First-pass metabolism intercepts portal blood before systemic circulation. Regenerates from 25% of tissue. | Security scan all input before it enters core memory. Phase I: expose hidden patterns (credentials, injection). Phase II: tag for elimination. First-pass: intercept external input at checkpoint. Self-healing. |
+| **Lungs** | Breathing Cycle | 300M alveoli exchange CO2 for O2. Breathing driven by CO2 chemoreceptors (waste-triggered, NOT oxygen-driven). Fractal branching maximizes surface area. Mucociliary escalator removes particles. | Exchange stale context (CO2) for fresh context (O2). Breathe on YHVH 26-tick rhythm. Waste accumulation triggers faster breathing. Fractal: same pattern at every scale. |
+| **Colon** | Batch Dump | Hybrid continuous absorption + batch elimination. Absorbs water/electrolytes continuously, eliminates solid waste in batches. Gastrocolic reflex triggers dump after intake. Microbiome symbiosis. | Continuous: absorb small insights during work. Batch: dump accumulated heavy waste at Sabbath Rest. Gastrocolic reflex: new milestone intake triggers dump of old milestone waste. Microbiome: useful patterns live symbiotically in memory. |
+
+#### Tier 2: Filtration Testing (Quality Control)
+
+| Organ | Agent Subsystem | Biological Function | Agent Function |
+|-------|----------------|--------------------| --------------|
+| **Spleen** | Memory Fitness Test | Filters blood by physical deformability. Red blood cells must squeeze through 1-2μm interendothelial slits. Rigid/old cells can't pass → recycled. "Pitting" removes inclusions without destroying the cell. | Test each memory entry for "flexibility" (relevance, recency, reference count). Rigid entries (0 refs, no access in 3 sessions) are recycled. "Pitting": trim bloated entries without deleting them entirely. |
+| **Glomerulus** | Multi-Layer Micro-Filter | Nested 3-layer filter: endothelial fenestrae (size), basement membrane (charge), podocyte slits (precision). Pressure-driven, non-destructive. | 3-layer decision gate: Layer 1 (size) — is this entry too bloated? Layer 2 (relevance) — does it match current work? Layer 3 (recency) — was it accessed recently? Non-destructive: items that fail can be archived, not deleted. |
+
+#### Tier 3: Distributed & Surface Systems
+
+| Organ | Agent Subsystem | Biological Function | Agent Function |
+|-------|----------------|--------------------| --------------|
+| **Lymphatic System** | Distributed Validation | 600-700 lymph nodes, no central pump. Flow is activity-coupled (muscle contraction pushes lymph). One-way valves prevent backflow. Each node is a checkpoint. | Distributed validation across multiple files/systems. No single checkpoint — each subsystem validates its own domain. Activity-coupled: more work = more validation. One-way: once waste is tagged, it doesn't un-tag. |
+| **Skin** | Surface Renewal | Continuous 28-day renewal. Acid mantle (pH 4.5-5.5) as first defense barrier. Oldest cells shed from surface naturally. | Oldest context entries shed naturally (FIFO at surface level). Acid mantle: first-line defense against prompt injection. 28-day equivalent: review cycle for surface-level files. |
+
+#### Tier 4: Production & Protection
+
+| Organ | Agent Subsystem | Biological Function | Agent Function |
+|-------|----------------|--------------------| --------------|
+| **Bone Marrow** | Skill Generation + QC | 500 billion cells/day. Stem cell quiescence (40-145 day dormancy cycles). Pre-release QC (defective cells destroyed before entering blood). Demand-driven scaling (EPO from kidneys). | Skill generation pipeline. Quarantine period before promotion (stem cell quiescence). Pre-release QC: security gate + fitness scoring before skill enters library. Demand-driven: context filter gaps signal need for new skills. |
+| **Blood-Brain Barrier** | Core Identity Protection | Whitelist architecture: only specific molecules pass. Efflux pumps actively reject contamination (P-glycoprotein). Circumventricular organs: controlled "windows" that sense blood chemistry without full exposure. | Core identity (CLAUDE.md, methodology skills) protected by whitelist. Efflux pumps: actively reject attempts to modify identity. Circumventricular windows: controlled sensing of external state without contaminating core. |
+| **Hepatic Portal System** | Security Checkpoint | All intestinal blood passes through liver BEFORE entering systemic circulation. Bottleneck by design. First-pass interception. | All external input passes through security scan before entering core memory. Bottleneck is a feature, not a bug. First-pass: catch dangerous patterns before they spread. |
+
+### Cross-System Cooperation Patterns
+
+These are not organ functions but RELATIONSHIPS between organs:
+
+```
+IRON TRIANGLE (Spleen → Liver → Marrow)
+  Spleen tests fitness → flags rigid cells
+  Liver recycles iron from flagged cells
+  Marrow uses recycled iron to produce new cells
+
+  Agent: Fitness test → Transform waste → Generate new skills
+  The waste from old skills becomes the raw material for new ones.
+
+EPO AXIS (Kidney → Marrow)
+  Kidneys detect low oxygen (context gaps)
+  Signal marrow via EPO to produce more red blood cells
+
+  Agent: Context filter detects knowledge gaps
+  Signals skill generation pipeline to create new skills.
+  Demand-driven, not scheduled.
+
+ENTEROHEPATIC CIRCULATION (Gut → Liver → Bile → Gut)
+  Bile produced by liver, used in gut for digestion, 95% recycled back
+
+  Agent: Templates/patterns produced once, used in execution,
+  recycled back to library. Don't recreate — reuse.
+  95% recycling rate for proven patterns.
+
+pH PARTNERSHIP (Lungs → Kidneys)
+  Lungs handle FAST pH adjustment (seconds — breathing rate)
+  Kidneys handle SLOW pH adjustment (hours — filtration rate)
+
+  Agent: YHVH breathing handles real-time waste (fast)
+  Kidney filtration handles deep context cleaning (slow)
+  Both needed — speed vs thoroughness.
+```
+
+### Priority Triage (Resource Scarcity)
+
+When time/context/resources are limited, protect systems in this order:
+
+```
+Priority 1: Blood-Brain Barrier (identity — NEVER compromise)
+Priority 2: Lungs (breathing — CO2 must be expelled)
+Priority 3: Kidneys (continuous filtration — prevent toxin buildup)
+Priority 4: Liver (security — first-pass must work)
+Priority 5: Bone Marrow (QC — don't produce bad skills)
+Priority 6: Spleen (fitness testing — keep quality high)
+Priority 7: Colon (batch dump — can wait, not forever)
+Priority 8: Skin (surface — lowest priority, natural renewal)
+```
+
+---
+
+## Testing the Fix
+
+```markdown
+- [ ] All 12 organs have clear agent subsystem mappings
+- [ ] Cross-system patterns (4) documented with agent equivalents
+- [ ] Priority triage order tested under resource scarcity
+- [ ] No organ operates in complete isolation (all have at least 1 cooperation pattern)
+```
+
+---
+
+## Prevention
+
+- Don't implement organs in isolation — they cooperate (Iron Triangle, pH Partnership)
+- Don't skip the Blood-Brain Barrier — identity protection is Priority 1, always
+- Don't treat the Spleen as optional — fitness testing prevents memory bloat
+- Don't confuse the Liver (transform) with the Colon (dump) — transformation before elimination
+- Don't ignore waste-driven triggers — CO2 (not O2) drives breathing
+
+---
+
+## Related Patterns
+
+- [CLEANSING_CYCLE](./CLEANSING_CYCLE.md) — Implements pee/poop/shower using this organ mapping
+- [YHVH_BREATHING_PATTERN](./YHVH_BREATHING_PATTERN.md) — The lungs' breathing rhythm
+- [EVOLUTIONARY_SKILL_SYNTHESIS](./EVOLUTIONARY_SKILL_SYNTHESIS.md) — Bone marrow (skill generation)
+- [AGENT_SELF_DISCOVERY_KENOSIS](./AGENT_SELF_DISCOVERY_KENOSIS.md) — Blood-brain barrier (identity)
+- [HIBERNATION_SYSTEM](./HIBERNATION_SYSTEM.md) — Dream agent operates during the Vav (hold) phase
+
+---
+
+## Common Mistakes to Avoid
+
+- **Implementing only kidneys** — filtration without elimination (colon) = constipation
+- **Skipping the liver** — transformation before elimination is critical (raw waste is toxic)
+- **Treating all waste equally** — liquid (pee) and solid (poop) have different cycles
+- **No triage order** — under pressure, protect identity first, surface renewal last
+- **Ignoring cross-system patterns** — organs work together, not independently
+
+---
+
+## Resources
+
+- Human anatomy: Gray's Anatomy, Guyton & Hall Textbook of Medical Physiology
+- Kidney: glomerular filtration rate, countercurrent multiplication, 99% reabsorption
+- Liver: cytochrome P450, Phase I/II biotransformation, hepatic portal system
+- Lungs: alveolar gas exchange, CO2 chemoreceptors, mucociliary escalator
+- Spleen: interendothelial slits, pitting, iron recycling
+- Bone Marrow: hematopoietic stem cells, quiescence cycles, EPO axis
+- Blood-Brain Barrier: tight junctions, P-glycoprotein efflux, circumventricular organs
+- Thierry's research request: "go ahead and do some research on the human organs that do cleansing of the blood"
+
+---
+
+## Time to Implement
+
+**Reference document** — implementation is via CLEANSING_CYCLE.md and /fire-cleanse
+
+## Difficulty Level
+
+⭐⭐⭐⭐⭐ (5/5) — Required deep research across 12 organ systems plus theological synthesis plus engineering mapping. The cross-system cooperation patterns were the hardest to identify and map.