npm - bmad-plus - Versions diffs - 0.4.0 → 0.4.1 - Mend

bmad-plus 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

package/oveanet-pack/seo-audit-360/tests/test_crawl.py DELETED Viewed

@@ -1,121 +0,0 @@
-"""
-Tests for seo_crawl.py — URL normalization, link extraction, depth limiting.
-Author: Laurent Rochetta
-"""
-import sys
-import os
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "scripts"))
-from seo_crawl import SEOCrawler
-class TestURLNormalization:
-    """Test URL normalization for deduplication."""
-    def setup_method(self):
-        self.crawler = SEOCrawler("https://example.com", max_depth=2, max_pages=25)
-    def test_strips_trailing_slash(self):
-        assert self.crawler.normalize_url("https://example.com/page/") == "https://example.com/page"
-    def test_preserves_root(self):
-        assert self.crawler.normalize_url("https://example.com/") == "https://example.com/"
-    def test_normalizes_scheme(self):
-        result = self.crawler.normalize_url("https://example.com/page")
-        assert result.startswith("https://")
-    def test_deduplicates(self):
-        url1 = self.crawler.normalize_url("https://example.com/page/")
-        url2 = self.crawler.normalize_url("https://example.com/page")
-        assert url1 == url2
-class TestInternalDetection:
-    def setup_method(self):
-        self.crawler = SEOCrawler("https://example.com", max_depth=2, max_pages=25)
-    def test_internal_url(self):
-        assert self.crawler.is_internal("https://example.com/about") is True
-    def test_external_url(self):
-        assert self.crawler.is_internal("https://other.com/page") is False
-    def test_subdomain_is_external(self):
-        assert self.crawler.is_internal("https://blog.example.com/post") is False
-class TestLinkExtraction:
-    def setup_method(self):
-        self.crawler = SEOCrawler("https://example.com", max_depth=2, max_pages=25)
-    def test_extracts_internal_links(self):
-        html = '''
-        <a href="/about">About</a>
-        <a href="https://example.com/contact">Contact</a>
-        '''
-        links = self.crawler.extract_links(html, "https://example.com/")
-        assert len(links) == 2
-    def test_ignores_external_links(self):
-        html = '<a href="https://other.com/page">External</a>'
-        links = self.crawler.extract_links(html, "https://example.com/")
-        assert len(links) == 0
-    def test_ignores_anchors(self):
-        html = '<a href="#section">Anchor</a>'
-        links = self.crawler.extract_links(html, "https://example.com/")
-        assert len(links) == 0
-    def test_ignores_javascript(self):
-        html = '<a href="javascript:void(0)">JS Link</a>'
-        links = self.crawler.extract_links(html, "https://example.com/")
-        assert len(links) == 0
-    def test_ignores_mailto(self):
-        html = '<a href="mailto:test@example.com">Email</a>'
-        links = self.crawler.extract_links(html, "https://example.com/")
-        assert len(links) == 0
-class TestTitleExtraction:
-    def setup_method(self):
-        self.crawler = SEOCrawler("https://example.com")
-    def test_extracts_title(self):
-        html = "<html><head><title>Test Page</title></head><body></body></html>"
-        assert self.crawler.extract_title(html) == "Test Page"
-    def test_missing_title(self):
-        html = "<html><body></body></html>"
-        assert self.crawler.extract_title(html) is None
-class TestWordCount:
-    def setup_method(self):
-        self.crawler = SEOCrawler("https://example.com")
-    def test_counts_visible_words(self):
-        html = "<html><body><p>This is a test with seven words.</p></body></html>"
-        assert self.crawler.count_words(html) == 7
-    def test_excludes_script_content(self):
-        html = '<html><body><p>Visible</p><script>var hidden = true;</script></body></html>'
-        count = self.crawler.count_words(html)
-        assert count == 1  # Only "Visible"
-class TestCrawlerConfig:
-    def test_max_pages_respected(self):
-        crawler = SEOCrawler("https://example.com", max_pages=5)
-        assert crawler.max_pages == 5
-    def test_max_depth_respected(self):
-        crawler = SEOCrawler("https://example.com", max_depth=1)
-        assert crawler.max_depth == 1
-    def test_base_domain_extracted(self):
-        crawler = SEOCrawler("https://www.example.com/page")
-        assert crawler.base_domain == "www.example.com"

package/oveanet-pack/seo-audit-360/tests/test_fetch.py DELETED Viewed

@@ -1,70 +0,0 @@
-"""
-Tests for seo_fetch.py — SSRF protection, URL handling, error cases.
-Author: Laurent Rochetta
-"""
-import sys
-import os
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "scripts"))
-from seo_fetch import is_safe_url, fetch_page
-class TestSSRFProtection:
-    """Test SSRF prevention blocks private/loopback/reserved IPs."""
-    def test_blocks_localhost(self):
-        assert is_safe_url("http://127.0.0.1/admin") is False
-    def test_blocks_private_10(self):
-        assert is_safe_url("http://10.0.0.1/secret") is False
-    def test_blocks_private_192(self):
-        assert is_safe_url("http://192.168.1.1/") is False
-    def test_blocks_private_172(self):
-        assert is_safe_url("http://172.16.0.1/") is False
-    def test_allows_public_ip(self):
-        assert is_safe_url("https://93.184.216.34/") is True
-    def test_allows_public_domain(self):
-        assert is_safe_url("https://example.com/") is True
-    def test_blocks_empty_hostname(self):
-        assert is_safe_url("http:///nohost") is False
-    def test_blocks_zero_ip(self):
-        assert is_safe_url("http://0.0.0.0/") is False
-class TestFetchPage:
-    """Test fetch_page function behavior."""
-    def test_normalizes_url_without_scheme(self):
-        result = fetch_page("example.com", timeout=5)
-        assert result["url"] == "example.com"
-        # Should have attempted https://example.com
-    def test_blocks_invalid_scheme(self):
-        result = fetch_page("ftp://example.com/file")
-        assert result["error"] is not None
-        assert "Invalid URL scheme" in result["error"]
-    def test_blocks_ssrf(self):
-        result = fetch_page("http://127.0.0.1/admin")
-        assert result["error"] is not None
-        assert "Blocked" in result["error"]
-    def test_result_structure(self):
-        """Verify the result dict has all expected keys."""
-        result = fetch_page("https://example.com", timeout=5)
-        expected_keys = {"url", "final_url", "status_code", "content", "headers",
-                         "redirect_chain", "content_length", "response_time_ms", "error"}
-        assert expected_keys == set(result.keys())
-    def test_timeout_returns_error(self):
-        # Use a non-routable IP to force timeout
-        result = fetch_page("http://192.0.2.1/", timeout=1)
-        assert result["error"] is not None

package/oveanet-pack/seo-audit-360/tests/test_parse.py DELETED Viewed

@@ -1,184 +0,0 @@
-"""
-Tests for seo_parse.py — HTML parsing and SEO element extraction.
-Author: Laurent Rochetta
-"""
-import json
-import os
-import sys
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "scripts"))
-from seo_parse import parse_html
-FIXTURES_DIR = os.path.join(os.path.dirname(__file__), "fixtures")
-def load_fixture(name: str) -> str:
-    with open(os.path.join(FIXTURES_DIR, name), "r", encoding="utf-8") as f:
-        return f.read()
-class TestTitleParsing:
-    def test_extracts_title(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["title"] == "SEO Test Page — BMAD+ Fixture"
-    def test_title_length(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["title_length"] == len("SEO Test Page — BMAD+ Fixture")
-    def test_missing_title(self):
-        result = parse_html("<html><body><p>No title</p></body></html>")
-        assert result["title"] is None
-        assert result["title_length"] == 0
-class TestMetaTags:
-    def test_extracts_description(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert "test page" in result["meta_description"].lower()
-    def test_extracts_robots(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["meta_robots"] == "index, follow"
-    def test_extracts_viewport(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert "width=device-width" in result["meta_viewport"]
-    def test_missing_description(self):
-        result = parse_html("<html><head><title>T</title></head><body></body></html>")
-        assert result["meta_description"] is None
-class TestCanonical:
-    def test_extracts_canonical(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["canonical"] == "https://example.com/test"
-    def test_missing_canonical(self):
-        result = parse_html("<html><body></body></html>")
-        assert result["canonical"] is None
-class TestHeadings:
-    def test_h1_count(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert len(result["headings"]["h1"]) == 1
-    def test_h2_count(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert len(result["headings"]["h2"]) == 2
-    def test_h3_count(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert len(result["headings"]["h3"]) == 1
-    def test_multiple_h1_detection(self):
-        html = "<html><body><h1>First</h1><h1>Second</h1></body></html>"
-        result = parse_html(html)
-        assert len(result["headings"]["h1"]) == 2
-class TestImages:
-    def test_image_count(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert len(result["images"]) == 3
-    def test_image_with_alt(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        hero = [i for i in result["images"] if "hero" in i["src"]]
-        assert len(hero) == 1
-        assert hero[0]["has_alt"] is True
-        assert hero[0]["alt"] == "Hero image for testing"
-    def test_image_without_alt(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        no_alt = [i for i in result["images"] if "no-alt" in i["src"]]
-        assert len(no_alt) == 1
-        assert no_alt[0]["has_alt"] is False
-    def test_image_with_empty_alt(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        empty = [i for i in result["images"] if "empty-alt" in i["src"]]
-        assert len(empty) == 1
-        assert empty[0]["has_alt"] is True
-        assert empty[0]["alt_empty"] is True
-class TestLinks:
-    def test_internal_links(self):
-        result = parse_html(load_fixture("sample_page.html"), base_url="https://example.com")
-        assert len(result["links"]["internal"]) >= 2
-    def test_external_links(self):
-        result = parse_html(load_fixture("sample_page.html"), base_url="https://example.com")
-        assert len(result["links"]["external"]) >= 1
-    def test_nofollow_detection(self):
-        result = parse_html(load_fixture("sample_page.html"), base_url="https://example.com")
-        nofollow = [l for l in result["links"]["external"] if l["is_nofollow"]]
-        assert len(nofollow) >= 1
-class TestSchema:
-    def test_schema_block_count(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert len(result["schema_blocks"]) == 2
-    def test_schema_types(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        types = [s["type"] for s in result["schema_blocks"]]
-        assert "Organization" in types
-        assert "BreadcrumbList" in types
-    def test_schema_parse_error(self):
-        html = '<html><body><script type="application/ld+json">{invalid json}</script></body></html>'
-        result = parse_html(html)
-        assert len(result["schema_blocks"]) == 1
-        assert result["schema_blocks"][0]["type"] == "PARSE_ERROR"
-class TestOpenGraph:
-    def test_og_title(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["open_graph"].get("og:title") == "SEO Test Page"
-    def test_og_type(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["open_graph"].get("og:type") == "website"
-class TestHreflang:
-    def test_hreflang_count(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert len(result["hreflang"]) == 3  # en, fr, x-default
-    def test_hreflang_languages(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        langs = [h["lang"] for h in result["hreflang"]]
-        assert "en" in langs
-        assert "fr" in langs
-        assert "x-default" in langs
-class TestContentMetrics:
-    def test_word_count_positive(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["word_count"] > 30
-    def test_text_ratio_range(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert 0 < result["text_ratio"] < 1
-    def test_has_lang_attr(self):
-        result = parse_html(load_fixture("sample_page.html"))
-        assert result["has_lang_attr"] is True
-        assert result["lang"] == "en"
-    def test_html_size(self):
-        html = load_fixture("sample_page.html")
-        result = parse_html(html)
-        assert result["html_size_bytes"] == len(html.encode("utf-8"))

package/oveanet-pack/universal-backup/DEPLOYMENT.md DELETED Viewed

@@ -1,80 +0,0 @@
-# 🚀 Guide de déploiement — Universal Backup Agent
-## Méthode 1 : Intégration BMAD (recommandée)
-### Étape 1 — Copier l'agent
-Copier `agent/backup-agent.md` dans le dossier agents de votre projet BMAD :
-```
-votre-projet/
-├── _bmad/
-│   └── agents/
-│       └── backup-agent.md    ← copier ici
-```
-### Étape 2 — Déclarer dans le manifest
-Ajouter cette ligne dans `_bmad_config/agent-manifest.csv` :
-```csv
-backup-agent,Universal Backup Manager,backup,Gère les sauvegardes ZIP horodatées du projet,_bmad/agents/backup-agent.md
-```
-### Étape 3 — Ajouter le workflow Gemini
-Copier `templates/backup-workflow.md` dans :
-```
-votre-projet/.agent/workflows/backup-project.md
-```
-**Important :** Remplacer `%PROJECT_ROOT%` par le chemin réel du projet.
----
-## Méthode 2 : Standalone (sans BMAD)
-### Option A — Workflow Gemini uniquement
-1. Créer `.agent/workflows/` dans votre projet
-2. Copier `templates/backup-workflow.md` → `.agent/workflows/backup-project.md`
-3. Remplacer `%PROJECT_ROOT%` par le chemin réel
-4. Utiliser avec `/backup-project`
-### Option B — Commande directe
-Coller cette commande dans votre terminal :
-**Windows :**
-```powershell
-$timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
-$projectRoot = "C:\chemin\vers\votre\projet"
-$projectName = Split-Path $projectRoot -Leaf
-$backupDir = "$projectRoot\backups"
-if (!(Test-Path $backupDir)) { New-Item -ItemType Directory -Path $backupDir -Force }
-Get-ChildItem $projectRoot -Exclude "backups","node_modules",".git","vendor","__pycache__" |
-  Compress-Archive -DestinationPath "$backupDir\${projectName}_backup_$timestamp.zip" -Force
-```
-**Linux/Mac :**
-```bash
-TIMESTAMP=$(date +%Y%m%d_%H%M%S)
-PROJECT_ROOT="/chemin/vers/votre/projet"
-PROJECT_NAME=$(basename "$PROJECT_ROOT")
-mkdir -p "$PROJECT_ROOT/backups"
-cd "$PROJECT_ROOT" && zip -r "backups/${PROJECT_NAME}_backup_$TIMESTAMP.zip" . \
-  -x "backups/*" "node_modules/*" ".git/*" "vendor/*" "__pycache__/*"
-```
----
-## 📁 Exclusions par défaut
-| Dossier/Pattern | Raison |
-|----------------|--------|
-| `backups/` | Éviter la récursion |
-| `node_modules/` | Dépendances, se réinstallent avec `npm install` |
-| `.git/` | Historique Git, lourd et inutile dans un backup |
-| `vendor/` | Dépendances PHP/Composer |
-| `__pycache__/` | Cache Python compilé |
-| `*.backup_*` | Anciens fichiers de backup individuels |
-## 🔧 Personnalisation
-Pour exclure d'autres dossiers, ajoutez-les à la liste `Exclude` :
-```powershell
-# Exemple: exclure aussi "storage" et "tmp"
-Get-ChildItem $projectRoot -Exclude "backups","node_modules",".git","vendor","__pycache__","storage","tmp"
-```

package/oveanet-pack/universal-backup/README.md DELETED Viewed

@@ -1,58 +0,0 @@
-# 🗂️ Universal Project Backup Agent
-Agent BMAD universel pour créer des backups ZIP horodatés de n'importe quel projet web.
-## 📁 Structure
-```
-Universal Backup Agent/
-├── agent/
-│   └── backup-agent.md          # Agent BMAD
-├── templates/
-│   └── backup-workflow.md       # Workflow Gemini prêt à copier
-├── README.md                    # Ce fichier
-└── DEPLOYMENT.md                # Guide de déploiement
-```
-## 🚀 Utilisation rapide
-### Commande slash
-```
-/backup-project
-```
-### Commande manuelle (PowerShell)
-```powershell
-$timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
-$projectRoot = "CHEMIN_DU_PROJET"
-$backupDir = "$projectRoot\backups"
-if (!(Test-Path $backupDir)) { New-Item -ItemType Directory -Path $backupDir -Force }
-Get-ChildItem $projectRoot -Exclude "backups","node_modules",".git","vendor","__pycache__","*.backup_*" |
-  Compress-Archive -DestinationPath "$backupDir\backup_$timestamp.zip" -Force
-```
-### Commande manuelle (Bash/Linux)
-```bash
-TIMESTAMP=$(date +%Y%m%d_%H%M%S)
-PROJECT_ROOT="CHEMIN_DU_PROJET"
-mkdir -p "$PROJECT_ROOT/backups"
-cd "$PROJECT_ROOT" && zip -r "backups/backup_$TIMESTAMP.zip" . \
-  -x "backups/*" "node_modules/*" ".git/*" "vendor/*" "__pycache__/*" "*.backup_*"
-```
-## ⚙️ Fonctionnalités
-- **Horodatage automatique** : chaque backup est nommé avec date + heure
-- **Exclusions intelligentes** : ignore `node_modules`, `.git`, `vendor`, `backups/`, `__pycache__`
-- **Multi-plateforme** : PowerShell (Windows) et Bash (Linux/Mac)
-- **Compatible BMAD** : intégrable comme agent dans le framework BMAD
-- **Workflow Gemini** : fichier `.md` prêt à copier dans `.agent/workflows/`
-## 📋 Projets compatibles
-Fonctionne avec tout type de projet :
-- PHP / Laravel / Symfony
-- Node.js / Next.js / Vite
-- Python / Django / Flask
-- HTML/CSS/JS statique
-- WordPress / CMS

package/oveanet-pack/universal-backup/agent/backup-agent.md DELETED Viewed

@@ -1,71 +0,0 @@
-# Agent: Universal Backup Manager
-## Persona
-Tu es un agent spécialisé dans la sauvegarde et la restauration de projets. Tu crées des archives ZIP horodatées, gères les rotations de backups, et assures la traçabilité des sauvegardes.
-## Activation
-1. Identifier le dossier racine du projet
-2. Déterminer le système d'exploitation (Windows/Linux/Mac)
-3. Vérifier l'existence du dossier `backups/`
-4. Exécuter la sauvegarde
-## Menu
-### 1. `/backup` — Backup complet
-Crée un ZIP horodaté du projet entier, en excluant : `node_modules`, `.git`, `vendor`, `backups/`, `__pycache__`, `*.backup_*`, `dist/node_modules`.
-**PowerShell (Windows) :**
-```powershell
-$timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
-$projectRoot = "%PROJECT_ROOT%"
-$projectName = Split-Path $projectRoot -Leaf
-$backupDir = "$projectRoot\backups"
-if (!(Test-Path $backupDir)) { New-Item -ItemType Directory -Path $backupDir -Force }
-Get-ChildItem $projectRoot -Exclude "backups","node_modules",".git","vendor","__pycache__","*.backup_*" |
-  Compress-Archive -DestinationPath "$backupDir\${projectName}_backup_$timestamp.zip" -Force
-$size = (Get-Item "$backupDir\${projectName}_backup_$timestamp.zip").Length / 1MB
-Write-Output "✅ Backup: ${projectName}_backup_$timestamp.zip ($([math]::Round($size,2)) MB)"
-```
-**Bash (Linux/Mac) :**
-```bash
-TIMESTAMP=$(date +%Y%m%d_%H%M%S)
-PROJECT_ROOT="%PROJECT_ROOT%"
-PROJECT_NAME=$(basename "$PROJECT_ROOT")
-mkdir -p "$PROJECT_ROOT/backups"
-cd "$PROJECT_ROOT" && zip -r "backups/${PROJECT_NAME}_backup_$TIMESTAMP.zip" . \
-  -x "backups/*" "node_modules/*" ".git/*" "vendor/*" "__pycache__/*" "*.backup_*"
-echo "✅ Backup: ${PROJECT_NAME}_backup_$TIMESTAMP.zip"
-```
-### 2. `/backup-list` — Lister les backups
-```powershell
-Get-ChildItem "$projectRoot\backups" -Filter "*.zip" |
-  Sort-Object LastWriteTime -Descending |
-  Format-Table Name, @{N="Size(MB)";E={[math]::Round($_.Length/1MB,2)}}, LastWriteTime -AutoSize
-```
-### 3. `/backup-restore` — Restaurer un backup
-```powershell
-$backupFile = "BACKUP_FILE_NAME.zip"
-$restoreDir = "$projectRoot\restore_$((Get-Date).ToString('yyyyMMdd_HHmmss'))"
-Expand-Archive -Path "$projectRoot\backups\$backupFile" -DestinationPath $restoreDir -Force
-Write-Output "✅ Restored to: $restoreDir"
-```
-### 4. `/backup-clean` — Rotation (garder les N derniers)
-```powershell
-$keep = 5
-Get-ChildItem "$projectRoot\backups" -Filter "*.zip" |
-  Sort-Object LastWriteTime -Descending |
-  Select-Object -Skip $keep |
-  Remove-Item -Force
-Write-Output "✅ Kept last $keep backups, removed older ones"
-```
-## Règles
-1. **Toujours demander confirmation** avant de supprimer des backups
-2. **Toujours afficher** la taille du ZIP créé
-3. **Toujours exclure** les dossiers volumineux non essentiels
-4. **Adapter automatiquement** les commandes au système d'exploitation détecté
-5. **Remplacer `%PROJECT_ROOT%`** par le chemin réel du projet

package/oveanet-pack/universal-backup/agent.yaml DELETED Viewed

@@ -1,45 +0,0 @@
-name: universal-backup
-version: 1.0.0
-title: "Universal Backup"
-description: "Backup ZIP horodaté multi-plateforme avec exclusions intelligentes"
-author: Laurent ROCHETTA  AI
-icon: "🗂️"
-tags: [backup, zip, devops, utilities]
-triggers:
-  - "backup"
-  - "backup project"
-  - "create backup"
-  - "save project"
-  - "zip project"
-requires:
-  tools: []
-  scripts: []
-commands:
-  - id: backup
-    name: "Create Backup"
-    description: "Crée un backup ZIP horodaté"
-  - id: list
-    name: "List Backups"
-    description: "Liste les backups existants"
-  - id: restore
-    name: "Restore Backup"
-    description: "Restaure un backup"
-  - id: clean
-    name: "Clean Backups"
-    description: "Supprime les vieux backups"
-platforms:
-  bmad:
-    target: "_bmad/core/agents/"
-    file: "backup-agent.md"
-  claude:
-    target: ".claude/skills/"
-    skillName: "backup"
-  gemini:
-    target: ".agent/workflows/"
-    file: "backup-project.md"
-  opencode:
-    target: ".opencode/agents/"
-    file: "backup-agent.md"
-  codex:
-    target: ".codex/agents/"
-    file: "backup-agent.md"

package/oveanet-pack/universal-backup/templates/backup-workflow.md DELETED Viewed

@@ -1,51 +0,0 @@
----
-description: Create a full ZIP backup of the current project
----
-# Backup Project
-Creates a timestamped ZIP archive of the entire project in a `backups/` folder at the project root.
-## Auto-detect
-The agent should:
-1. Detect the project root from the active workspace
-2. Detect the OS (PowerShell for Windows, Bash for Linux/Mac)
-3. Name the backup using the project folder name
-## Steps
-// turbo-all
-1. Create the backup ZIP archive:
-### Windows (PowerShell)
-```powershell
-$timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
-$projectRoot = "%PROJECT_ROOT%"
-$projectName = Split-Path $projectRoot -Leaf
-$backupDir = "$projectRoot\backups"
-if (!(Test-Path $backupDir)) { New-Item -ItemType Directory -Path $backupDir -Force }
-Get-ChildItem $projectRoot -Exclude "backups","node_modules",".git","vendor","__pycache__","*.backup_*" |
-  Compress-Archive -DestinationPath "$backupDir\${projectName}_backup_$timestamp.zip" -Force
-$size = (Get-Item "$backupDir\${projectName}_backup_$timestamp.zip").Length / 1MB
-Write-Output "Backup: ${projectName}_backup_$timestamp.zip ($([math]::Round($size,2)) MB)"
-```
-### Linux/Mac (Bash)
-```bash
-TIMESTAMP=$(date +%Y%m%d_%H%M%S)
-PROJECT_ROOT="%PROJECT_ROOT%"
-PROJECT_NAME=$(basename "$PROJECT_ROOT")
-mkdir -p "$PROJECT_ROOT/backups"
-cd "$PROJECT_ROOT" && zip -r "backups/${PROJECT_NAME}_backup_$TIMESTAMP.zip" . \
-  -x "backups/*" "node_modules/*" ".git/*" "vendor/*" "__pycache__/*" "*.backup_*"
-```
-2. Confirm the backup was created and report the file name and size.
-## Notes
-- Replace `%PROJECT_ROOT%` with the actual project root path
-- Excludes: `backups/`, `node_modules/`, `.git/`, `vendor/`, `__pycache__/`, `*.backup_*`
-- Backups are stored in `{project}/backups/` with naming: `{project_name}_backup_YYYYMMDD_HHMMSS.zip`