@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/windows-computer-use-mcp/docs/_stale/repository-protection/README.md

@@ -1,333 +0,0 @@
-# 🛡️ Repository Protection Documentation
-
-**Complete guide to keeping your notepadpp-mcp repository safe**
-
----
-
-## 📚 **Documentation Index**
-
-### **Quick Start**
-1. [Branch Protection Settings](BRANCH_PROTECTION_SETTINGS.md) - **START HERE** (5 minutes setup)
-2. [Branch Strategy & AI Workflow](BRANCH_STRATEGY_AND_AI_WORKFLOW.md) - How to collaborate with AI safely
-3. [Backup & Recovery Guide](BACKUP_AND_RECOVERY_GUIDE.md) - Multiple layers of protection
-
----
-
-## 🎯 **What's In This Directory**
-
-### **1. Branch Protection Settings**
-📄 `BRANCH_PROTECTION_SETTINGS.md`
-
-**Quick reference for setting up GitHub branch protection**
-
-**What it covers**:
-- ✅ Step-by-step GitHub settings
-- ✅ Exact checkboxes to enable
-- ✅ Visual setup checklist
-- ✅ Verification tests
-
-**Time to complete**: 5 minutes  
-**Difficulty**: Easy  
-**Priority**: **HIGH** - Do this first!
-
----
-
-### **2. Branch Strategy & AI Workflow**
-📄 `BRANCH_STRATEGY_AND_AI_WORKFLOW.md`
-
-**Complete guide to safe AI collaboration**
-
-**What it covers**:
-- ✅ Three-branch strategy (main/develop/experimental)
-- ✅ AI playground on feature/experimental
-- ✅ PR workflow for production
-- ✅ Examples of AI prompts for each branch
-- ✅ Cherry-picking experimental features
-- ✅ Keeping branches synchronized
-
-**Key benefit**: AI can experiment wildly without risking production code!
-
----
-
-### **3. Backup & Recovery Guide**
-📄 `BACKUP_AND_RECOVERY_GUIDE.md`
-
-**Multi-layer protection strategy**
-
-**What it covers**:
-- ✅ 5 layers of protection
-- ✅ Automated backup script
-- ✅ Git reflog (90-day time machine)
-- ✅ Recovery scenarios
-- ✅ Emergency procedures
-- ✅ Windows Task Scheduler setup
-
-**Key benefit**: Almost impossible to permanently lose code!
-
----
-
-## 🚀 **Quick Setup (15 Minutes)**
-
-### **Step 1: Enable Branch Protection (5 min)**
-
-Follow: [BRANCH_PROTECTION_SETTINGS.md](BRANCH_PROTECTION_SETTINGS.md)
-
-1. Go to GitHub repository settings
-2. Add protection rule for `main` branch
-3. Enable required PR reviews
-4. Disable force pushes and deletions
-
-**Result**: Main branch is bulletproof! ✅
-
----
-
-### **Step 2: Understand Branch Strategy (5 min)**
-
-Read: [BRANCH_STRATEGY_AND_AI_WORKFLOW.md](BRANCH_STRATEGY_AND_AI_WORKFLOW.md)
-
-**Learn**:
-- When to use `main` (production)
-- When to use `develop` (testing)
-- When to use `feature/experimental` (AI playground)
-
-**Result**: Clear workflow for AI collaboration! ✅
-
----
-
-### **Step 3: Set Up Automated Backups (5 min)**
-
-Follow: [BACKUP_AND_RECOVERY_GUIDE.md](BACKUP_AND_RECOVERY_GUIDE.md)
-
-1. Run backup script: `..\..\scripts\backup-repo.ps1`
-2. Optionally: Set up Windows Task Scheduler
-3. Verify backups are created
-
-**Result**: Automated daily backups! ✅
-
----
-
-## 🎨 **Usage Scenarios**
-
-### **Scenario 1: Normal Development**
-
-```powershell
-# Work on develop branch
-git checkout develop
-# Make changes, test
-git commit -am "Add feature"
-git push origin develop
-
-# When ready, create PR to main
-# Review and merge on GitHub
-```
-
----
-
-### **Scenario 2: AI Experimentation**
-
-**You say to AI**:
-> "Switch to feature/experimental and add 5 crazy experimental features!"
-
-**AI workflow**:
-```powershell
-git checkout feature/experimental
-# AI experiments freely
-git commit -am "Added experimental features"
-git push origin feature/experimental --force  # Can do this!
-```
-
-**Your protection**: Main and develop are safe! ✅
-
----
-
-### **Scenario 3: Emergency Recovery**
-
-**If something breaks**:
-
-```powershell
-# Option 1: Use reflog (undo last operations)
-git reflog
-git reset --hard HEAD@{5}
-
-# Option 2: Use backup branch
-git reset --hard backup-safe-2025-10-08
-
-# Option 3: Restore from bundle
-git clone D:\Backups\notepadpp-mcp\[latest-bundle].bundle restored
-
-# Option 4: Re-clone from GitHub (nuclear option)
-git clone https://github.com/sandraschi/notepadpp-mcp.git
-```
-
----
-
-## 📊 **Protection Layers**
-
-Your repository is protected by **5 independent layers**:
-
-| Layer | What | Recovery Time | Auto |
-|-------|------|---------------|------|
-| **GitHub Remote** | All commits & history | Instant | ✅ |
-| **Git Reflog** | 90-day operation log | Instant | ✅ |
-| **Backup Branches** | Known-good states | Instant | Manual |
-| **Local Bundles** | Complete repo files | 5 minutes | Setup |
-| **Branch Protection** | PR-only workflow | N/A | Setup |
-
-**Combined**: Almost impossible to permanently lose code! 🛡️
-
----
-
-## 🎯 **Best Practices**
-
-### **Before AI Does Anything Risky**
-
-```powershell
-# Create safety snapshot
-git branch backup-before-ai
-git push origin backup-before-ai
-```
-
-### **Daily Routine**
-
-```powershell
-# Run backup
-..\..\scripts\backup-repo.ps1
-
-# Check status
-git status
-git log --oneline -5
-```
-
-### **Weekly Maintenance**
-
-```powershell
-# Verify backups exist
-Get-ChildItem D:\Backups\notepadpp-mcp\
-
-# Sync branches
-git checkout develop
-git merge main
-git push origin develop
-```
-
----
-
-## 🚨 **Emergency Contacts**
-
-### **If Something Goes Wrong**
-
-1. **Don't Panic** - Your code is safe on GitHub
-2. **Check Reflog** - `git reflog` shows everything
-3. **Check Backups** - Look in `D:\Backups\notepadpp-mcp\`
-4. **Re-clone if Needed** - GitHub has everything
-
-### **Common Issues**
-
-**"I can't push to main!"**
-- ✅ This is correct! Use PR workflow
-- Create branch → Push → Create PR → Merge
-
-**"AI broke something on experimental!"**
-- ✅ That's fine! Experimental is expendable
-- Reset: `git reset --hard origin/develop`
-
-**"I lost uncommitted work!"**
-- Check: `git stash list`
-- Restore: `git stash pop`
-
----
-
-## 📋 **Checklist**
-
-### **Protection Setup**
-
-- [ ] Branch protection enabled on `main`
-- [ ] Backup script tested (`scripts\backup-repo.ps1`)
-- [ ] Backup branches created
-- [ ] Windows Task Scheduler configured (optional)
-- [ ] Recovery procedure tested
-
-### **Workflow Understanding**
-
-- [ ] Know when to use `main` (production)
-- [ ] Know when to use `develop` (testing)
-- [ ] Know when to use `feature/experimental` (AI playground)
-- [ ] Understand PR workflow
-- [ ] Can create backup branches
-
-### **Emergency Preparedness**
-
-- [ ] Know how to use `git reflog`
-- [ ] Know where backups are stored
-- [ ] Tested bundle restore
-- [ ] Can re-clone from GitHub
-- [ ] Have backup of backup branches
-
----
-
-## 🎓 **Learning Resources**
-
-### **Git Basics**
-- [Git Reflog Explained](https://git-scm.com/docs/git-reflog)
-- [Branch Protection](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches)
-- [Pull Request Workflow](https://docs.github.com/en/pull-requests)
-
-### **Advanced Topics**
-- [Git Bundles](https://git-scm.com/docs/git-bundle)
-- [Cherry-picking Commits](https://git-scm.com/docs/git-cherry-pick)
-- [Interactive Rebase](https://git-scm.com/docs/git-rebase)
-
----
-
-## 🏆 **You're Protected!**
-
-With these three documents and tools, you have:
-
-✅ **Branch protection** preventing accidents  
-✅ **Clear workflow** for AI collaboration  
-✅ **Multiple backups** for recovery  
-✅ **Safe playground** for experimentation  
-✅ **Emergency procedures** for any scenario  
-
-**You can now safely say to AI**:
-> *"Let's experiment on feature/experimental and try some wild ideas!"*
-
-**And your production code stays 100% safe!** 🛡️
-
----
-
-## 📞 **Quick Reference**
-
-| Need | Document | Section |
-|------|----------|---------|
-| Setup protection | [BRANCH_PROTECTION_SETTINGS.md](BRANCH_PROTECTION_SETTINGS.md) | Quick Setup |
-| AI workflow | [BRANCH_STRATEGY_AND_AI_WORKFLOW.md](BRANCH_STRATEGY_AND_AI_WORKFLOW.md) | AI Prompts |
-| Create backup | [BACKUP_AND_RECOVERY_GUIDE.md](BACKUP_AND_RECOVERY_GUIDE.md) | Layer 4 |
-| Undo changes | [BACKUP_AND_RECOVERY_GUIDE.md](BACKUP_AND_RECOVERY_GUIDE.md) | Git Reflog |
-| Recover lost work | [BACKUP_AND_RECOVERY_GUIDE.md](BACKUP_AND_RECOVERY_GUIDE.md) | Emergency Recovery |
-
----
-
-## 🔗 **Related Documentation**
-
-### **In This Repository**
-
-- [Main README](../../README.md) - Project overview
-- [CONTRIBUTING.md](../../CONTRIBUTING.md) - Contribution guidelines
-- [Build Scripts](../../scripts/) - Automation scripts
-
-### **External Resources**
-
-- [GitHub Repository](https://github.com/sandraschi/notepadpp-mcp)
-- [Issue Tracker](https://github.com/sandraschi/notepadpp-mcp/issues)
-- [Pull Requests](https://github.com/sandraschi/notepadpp-mcp/pulls)
-
----
-
-*Repository Protection Documentation*  
-*Created: October 8, 2025*  
-*Location: `docs/repository-protection/`*  
-*Status: Complete and Ready to Use*
-
-**Your repository is safer than Fort Knox!** 🏰🛡️
-

package/mcps/windows-computer-use-mcp/docs/_stale/serena/SERENA_COPY_TO_OTHER_REPOS.md

@@ -1,159 +0,0 @@
-# 📋 Copy Serena to Other Repos - One Command
-
-**Use this to add Serena to any other repo (myai, veogen, etc.)**
-
----
-
-## ⚡ **One-Command Install**
-
-**Copy this entire block and run in target repo**:
-
-```powershell
-# Navigate to your repo
-Set-Location "D:\Dev\repos\YOUR-REPO-NAME"  # ← CHANGE THIS
-
-# Create .cursor folder
-New-Item -Path ".cursor" -ItemType Directory -Force
-
-# Get project path
-$projectPath = (Get-Location).Path
-
-# Create Serena config
-@"
-{
-  "mcpServers": {
-    "serena": {
-      "command": "uvx",
-      "args": [
-        "--from",
-        "git+https://github.com/oraios/serena",
-        "serena",
-        "start-mcp-server",
-        "--context",
-        "ide-assistant",
-        "--project",
-        "$($projectPath.Replace('\', '\\'))"
-      ],
-      "env": {
-        "PYTHONUNBUFFERED": "1"
-      }
-    }
-  }
-}
-"@ | Out-File -FilePath ".cursor\mcp.json" -Encoding UTF8
-
-# Add to .gitignore
-if (Test-Path ".gitignore") {
-    $gitignore = Get-Content ".gitignore" -Raw
-    if ($gitignore -notmatch "\.serena") {
-        Add-Content ".gitignore" "`n# Serena`n.serena/`n"
-        Write-Host "✅ Added .serena/ to .gitignore" -ForegroundColor Green
-    }
-} else {
-    @"
-# Serena
-.serena/
-"@ | Out-File -FilePath ".gitignore" -Encoding UTF8
-    Write-Host "✅ Created .gitignore with Serena entry" -ForegroundColor Green
-}
-
-# Success message
-Write-Host "`n✅ Serena configured for: $projectPath" -ForegroundColor Green
-Write-Host "`nNext steps:" -ForegroundColor Cyan
-Write-Host "1. Restart Cursor" -ForegroundColor Yellow
-Write-Host "2. Say: '@Composer Run onboarding'" -ForegroundColor Yellow
-Write-Host "3. Dashboard: http://localhost:24282" -ForegroundColor Yellow
-```
-
----
-
-## 🎯 **For Specific Repos**
-
-### **For myai**
-
-```powershell
-Set-Location "D:\Dev\repos\myai"
-# Then run the one-command install above
-```
-
-### **For veogen**
-
-```powershell
-Set-Location "D:\Dev\repos\veogen"
-# Then run the one-command install above
-```
-
-### **For any repo**
-
-```powershell
-Set-Location "D:\Dev\repos\<repo-name>"
-# Then run the one-command install above
-```
-
----
-
-## 📊 **Which Repos Benefit Most?**
-
-**Best candidates** for Serena:
-
-✅ **Large projects** (1,000+ lines)  
-✅ **Multi-file codebases**  
-✅ **Complex relationships** (classes, imports)  
-✅ **Active development** (frequent navigation needed)  
-✅ **Python, TypeScript, Rust, Go** (best LSP support)  
-
-**Skip for**:
-❌ Single-file scripts  
-❌ Very small projects (<100 lines)  
-❌ Pure data/config repos  
-
----
-
-## 🔧 **Advanced: Pre-Index Large Projects**
-
-**For huge repos** (10,000+ lines), pre-index before first use:
-
-```powershell
-Set-Location "D:\Dev\repos\YOUR-REPO"
-uvx --from git+https://github.com/oraios/serena serena project index
-```
-
-**This takes 1-5 minutes** but makes first Serena use much faster!
-
----
-
-## 🗑️ **Uninstall Serena from a Repo**
-
-**If you decide Serena isn't useful for a specific project**:
-
-```powershell
-# Remove config
-Remove-Item ".cursor\mcp.json" -Force
-
-# Remove Serena cache
-Remove-Item ".serena" -Recurse -Force
-
-# Restart Cursor
-```
-
-**Easy!** No global state, no mess.
-
----
-
-## 📚 **After Installing in Multiple Repos**
-
-**Check dashboard** to see all projects:
-- http://localhost:24282/dashboard/index.html
-- Dashboard shows ALL projects Serena is working on
-- Compare token savings across projects
-
----
-
-*Quick Copy Template*  
-*Add Serena to any repo in 30 seconds*  
-*No global installation*  
-*Easy to remove*
-
-**Copy and adapt for your repos!** 🚀
-
-