@soulbatical/tetra-dev-toolkit 1.1.1 → 1.3.0

package/bin/cleanup-repos.sh

@@ -0,0 +1,287 @@
+#!/bin/bash
+# =============================================================================
+# Repo Cleanup Script — Verplaats alles naar de juiste plek
+#
+# Wat het doet:
+# 1. Stray .md files → /docs/_moved/{oorspronkelijk-pad}/
+# 2. Stray .sh scripts → /scripts/_moved/{oorspronkelijk-pad}/
+# 3. Nested docs/ (frontend/docs/, backend/docs/) → /docs/{subdir-naam}/
+# 4. Root clutter files (.txt, .png, .csv, .py) → /docs/_cleanup/
+# 5. Code dir clutter (.txt, .log, .env) → /docs/_cleanup/{code-dir}/
+# 6. Clutter dirs (tmp/, logs/, data/, etc.) → .gitignore
+# 7. .env/.env.local in code dirs → verwijder (secrets horen niet in git)
+#
+# DRY RUN: standaard toont het alleen wat het zou doen.
+# EXECUTE: ./cleanup-repos.sh --execute
+# =============================================================================
+
+set -euo pipefail
+
+DRY_RUN=true
+[[ "${1:-}" == "--execute" ]] && DRY_RUN=false
+
+BASE="$HOME/projecten"
+PROJECTS=(sparkbuddy-live agentrook ralph-manager vincifox snelstart-mcp web-mcp)
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Counters
+TOTAL_MOVED=0
+TOTAL_GITIGNORED=0
+TOTAL_DELETED=0
+
+lower() { echo "$1" | tr '[:upper:]' '[:lower:]'; }
+
+log() { echo -e "${BLUE}[INFO]${NC} $1"; }
+warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+action() { echo -e "${GREEN}[MOVE]${NC} $1"; }
+danger() { echo -e "${RED}[DEL]${NC} $1"; }
+
+safe_move() {
+  local src="$1" dst="$2"
+
+  if $DRY_RUN; then
+    action "$src → $dst"
+  else
+    mkdir -p "$(dirname "$PROJECT_PATH/$dst")"
+    mv "$PROJECT_PATH/$src" "$PROJECT_PATH/$dst"
+  fi
+  TOTAL_MOVED=$((TOTAL_MOVED + 1))
+}
+
+safe_delete() {
+  local target="$1"
+  if $DRY_RUN; then
+    danger "DELETE $target"
+  else
+    rm -f "$target"
+  fi
+  TOTAL_DELETED=$((TOTAL_DELETED + 1))
+}
+
+add_gitignore() {
+  local project_path="$1" entry="$2"
+  local gitignore="$project_path/.gitignore"
+
+  if [ -f "$gitignore" ] && grep -qF "$entry" "$gitignore" 2>/dev/null; then
+    return
+  fi
+
+  if $DRY_RUN; then
+    log "Add to .gitignore: $entry"
+  else
+    echo "$entry" >> "$gitignore"
+  fi
+  TOTAL_GITIGNORED=$((TOTAL_GITIGNORED + 1))
+}
+
+is_allowed_root_md() {
+  local name_lc
+  name_lc=$(lower "$1")
+  case "$name_lc" in
+    readme.md|claude.md|changelog.md|license.md|prompt.md|plan.md|contributing.md|code_of_conduct.md)
+      return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# =============================================================================
+# Main cleanup per project
+# =============================================================================
+
+for PROJECT in "${PROJECTS[@]}"; do
+  PROJECT_PATH="$BASE/$PROJECT"
+  [ -d "$PROJECT_PATH" ] || continue
+
+  echo ""
+  echo "================================================================"
+  echo -e "${BLUE}=== $PROJECT ===${NC}"
+  echo "================================================================"
+
+  # --- 1. Nested docs/ → merge into /docs/{subdir-naam}/ (FIRST, before stray .md scan) ---
+  log "Checking nested docs/ directories..."
+  for subdir in frontend backend backend-mcp backend-pdf mcp shell; do
+    nested_docs="$PROJECT_PATH/$subdir/docs"
+    [ -d "$nested_docs" ] || continue
+
+    file_count=$(find "$nested_docs" -type f 2>/dev/null | wc -l | tr -d ' ')
+    [[ "$file_count" == "0" ]] && continue
+
+    log "Moving $subdir/docs/ ($file_count files) → docs/$subdir/"
+    while IFS= read -r -d '' file; do
+      rel_from_nested="${file#$nested_docs/}"
+      safe_move "$subdir/docs/$rel_from_nested" "docs/$subdir/$rel_from_nested"
+    done < <(find "$nested_docs" -type f -print0 2>/dev/null)
+  done
+
+  # --- 2. Stray .md files → /docs/_moved/ ---
+  log "Checking stray .md files..."
+  while IFS= read -r -d '' file; do
+    rel="${file#$PROJECT_PATH/}"
+    name=$(basename "$file")
+    name_lc=$(lower "$name")
+    top_dir="${rel%%/*}"
+
+    # Skip README.md and CLAUDE.md anywhere (standard practice)
+    case "$name_lc" in
+      readme.md|claude.md) continue ;;
+    esac
+
+    # Skip root allowed .md files
+    [[ "$rel" == "$name" ]] && is_allowed_root_md "$name" && continue
+
+    # Skip /docs/, .ralph/, .claude/, .agents/, e2e/
+    case "$top_dir" in
+      docs|.ralph|.claude|.agents|e2e) continue ;;
+    esac
+
+    # Skip shell/templates/
+    [[ "$rel" == shell/templates/* ]] && continue
+
+    # Skip files already handled by nested docs merge (avoid double-move)
+    [[ "$rel" == */docs/* ]] && continue
+
+    safe_move "$rel" "docs/_moved/$rel"
+  done < <(find "$PROJECT_PATH" -maxdepth 5 -name "*.md" -type f \
+    -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/dist/*" \
+    -not -path "*/.next/*" -not -path "*/coverage/*" -print0 2>/dev/null)
+
+  # --- 3. Stray .sh scripts → /scripts/_moved/ ---
+  log "Checking stray .sh scripts..."
+  while IFS= read -r -d '' file; do
+    rel="${file#$PROJECT_PATH/}"
+    top_dir="${rel%%/*}"
+
+    # Skip root-level scripts
+    [[ "$rel" != */* ]] && continue
+
+    # Skip allowed dirs
+    case "$top_dir" in
+      scripts|shell|hooks|.husky|.ralph|.claude) continue ;;
+    esac
+
+    safe_move "$rel" "scripts/_moved/$rel"
+  done < <(find "$PROJECT_PATH" -maxdepth 5 -name "*.sh" -type f \
+    -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/dist/*" \
+    -print0 2>/dev/null)
+
+  # --- 4. Root clutter files → /docs/_cleanup/ ---
+  log "Checking root clutter..."
+  for file in "$PROJECT_PATH"/*; do
+    [ -f "$file" ] || continue
+    name=$(basename "$file")
+    name_lc=$(lower "$name")
+
+    # Skip dotfiles
+    [[ "$name" == .* ]] && continue
+
+    # Skip known config extensions and types handled by other checks
+    case "$name_lc" in
+      *.json|*.js|*.cjs|*.mjs|*.ts|*.toml|*.lock) continue ;;
+      *.md|*.sh|*.yml|*.yaml) continue ;;
+      dockerfile*|procfile) continue ;;
+    esac
+
+    # Check for clutter extensions
+    ext=".${name_lc##*.}"
+    case "$ext" in
+      .txt|.log|.pdf|.csv|.png|.jpg|.jpeg|.gif|.py|.bak|.tmp|.orig|.patch|.diff)
+        safe_move "$name" "docs/_cleanup/$name"
+        ;;
+    esac
+  done
+
+  # --- 5. Code dir clutter → /docs/_cleanup/{code-dir}/ ---
+  log "Checking code dir clutter..."
+  for codeDir in backend frontend backend-mcp backend-pdf mcp; do
+    code_path="$PROJECT_PATH/$codeDir"
+    [ -d "$code_path" ] || continue
+
+    while IFS= read -r -d '' file; do
+      name=$(basename "$file")
+      name_lc=$(lower "$name")
+      rel="${file#$PROJECT_PATH/}"
+      rel_from_code="${file#$code_path/}"
+      sub_top="${rel_from_code%%/*}"
+
+      # Skip allowed subdirs
+      case "$sub_top" in
+        public|static|assets|fixtures|supabase|migrations|prisma|test-fixtures) continue ;;
+      esac
+
+      # .env files → DELETE (secrets!)
+      case "$name_lc" in
+        .env|.env.local|.env.development|.env.production|.env.staging)
+          danger "SECRET: $rel"
+          safe_delete "$file"
+          continue
+          ;;
+      esac
+
+      # Skip templates
+      case "$name_lc" in
+        *.example|*.test) continue ;;
+      esac
+
+      # Skip standard web files
+      case "$name_lc" in
+        robots.txt|llms.txt|llms-full.txt|humans.txt|security.txt|ads.txt) continue ;;
+      esac
+
+      # Check for clutter extensions
+      ext=".${name_lc##*.}"
+      case "$ext" in
+        .txt|.log|.pdf|.csv|.bak|.tmp|.orig|.patch|.diff)
+          safe_move "$rel" "docs/_cleanup/$rel"
+          ;;
+      esac
+    done < <(find "$code_path" -maxdepth 4 -type f \
+      -not -path "*/node_modules/*" -not -path "*/dist/*" -not -path "*/.next/*" \
+      -not -path "*/coverage/*" -not -path "*/.turbo/*" -not -path "*/test-results/*" \
+      \( -name "*.txt" -o -name "*.log" -o -name "*.pdf" -o -name "*.csv" \
+         -o -name "*.bak" -o -name "*.tmp" -o -name "*.orig" \
+         -o -name ".env" -o -name ".env.*" \) -print0 2>/dev/null)
+  done
+
+  # --- 6. Clutter dirs → .gitignore ---
+  log "Checking clutter directories..."
+  for dir_name in tmp temp logs log data venv .venv reports output out backup backups; do
+    if [ -d "$PROJECT_PATH/$dir_name" ]; then
+      add_gitignore "$PROJECT_PATH" "$dir_name/"
+      warn "Directory $dir_name/ → added to .gitignore"
+    fi
+  done
+
+done
+
+# =============================================================================
+# Summary
+# =============================================================================
+
+echo ""
+echo "================================================================"
+if $DRY_RUN; then
+  echo -e "${YELLOW}DRY RUN COMPLETE${NC}"
+  echo "  Files to move:      $TOTAL_MOVED"
+  echo "  Files to delete:    $TOTAL_DELETED"
+  echo "  Gitignore entries:  $TOTAL_GITIGNORED"
+  echo ""
+  echo "Run with --execute to apply changes:"
+  echo "  bash cleanup-repos.sh --execute"
+else
+  echo -e "${GREEN}CLEANUP COMPLETE${NC}"
+  echo "  Files moved:        $TOTAL_MOVED"
+  echo "  Files deleted:      $TOTAL_DELETED"
+  echo "  Gitignore entries:  $TOTAL_GITIGNORED"
+  echo ""
+  echo "Next steps:"
+  echo "  1. Review /docs/_moved/ and /docs/_cleanup/ per project"
+  echo "  2. Delete what you don't need, keep what's useful"
+  echo "  3. git add + commit per project"
+fi
+echo "================================================================"

package/bin/{vca-audit.js → tetra-audit.js}

@@ -1,25 +1,26 @@
 #!/usr/bin/env node
 
 /**
- * VCA Quality Toolkit - Main CLI
+ * Tetra Dev Toolkit - Main CLI
  *
  * Usage:
- *   vca-audit              # Run all checks
- *   vca-audit security     # Run security checks only
- *   vca-audit stability    # Run stability checks only
- *   vca-audit quick        # Run quick critical checks
- *   vca-audit --ci         # CI mode (GitHub Actions annotations)
- *   vca-audit --json       # JSON output
+ *   tetra-audit              # Run all checks
+ *   tetra-audit security     # Run security checks only
+ *   tetra-audit stability    # Run stability checks only
+ *   tetra-audit hygiene      # Run repo hygiene checks only
+ *   tetra-audit quick        # Run quick critical checks
+ *   tetra-audit --ci         # CI mode (GitHub Actions annotations)
+ *   tetra-audit --json       # JSON output
  */
 
 import { program } from 'commander'
-import { runAllChecks, runSecurityChecks, runStabilityChecks, runCodeQualityChecks, runQuickCheck } from '../lib/runner.js'
+import { runAllChecks, runSecurityChecks, runStabilityChecks, runCodeQualityChecks, runHygieneChecks, runQuickCheck } from '../lib/runner.js'
 import { formatResults, formatGitHubActions } from '../lib/reporters/terminal.js'
 
 program
-  .name('vca-audit')
-  .description('VCA Quality Toolkit - Unified quality checks for all projects')
-  .version('1.0.0')
+  .name('tetra-audit')
+  .description('Tetra Dev Toolkit - Unified quality checks for all projects')
+  .version('1.2.0')
   .argument('[suite]', 'Check suite to run: security, stability, quick, or all (default)')
   .option('--ci', 'CI mode - output GitHub Actions annotations')
   .option('--json', 'Output results as JSON')
@@ -40,6 +41,9 @@ program
         case 'code-quality':
           results = await runCodeQualityChecks()
           break
+        case 'hygiene':
+          results = await runHygieneChecks()
+          break
         case 'quick':
           results = await runQuickCheck()
           break
@@ -56,7 +60,7 @@ program
 
         // Also print summary
         console.log('')
-        console.log('## VCA Quality Audit Results')
+        console.log('## Tetra Quality Audit Results')
         console.log('')
         console.log(`- **Status**: ${results.passed ? '✅ PASSED' : '❌ FAILED'}`)
         console.log(`- **Checks**: ${results.summary.passed} passed, ${results.summary.failed} failed`)

package/bin/{vca-dev-token.js → tetra-dev-token.js}

@@ -1,25 +1,25 @@
 #!/usr/bin/env node
 
 /**
- * VCA Dev Toolkit - Dev Token CLI
+ * Tetra Dev Toolkit - Dev Token CLI
  *
  * Manage Supabase dev tokens for API testing.
  * Auto-detects project from package.json, finds Supabase config from .env files.
  *
  * Usage:
- *   vca-dev-token                    # Auto-refresh or show status
- *   vca-dev-token --login            # Interactive login (prompts for password)
- *   vca-dev-token --status           # Show current token status
- *   vca-dev-token --project myapp    # Override project detection
+ *   tetra-dev-token                    # Auto-refresh or show status
+ *   tetra-dev-token --login            # Interactive login (prompts for password)
+ *   tetra-dev-token --status           # Show current token status
+ *   tetra-dev-token --project myapp    # Override project detection
  */
 
 import { program } from 'commander'
 import { runDevToken } from '../lib/commands/dev-token.js'
 
 program
-  .name('vca-dev-token')
+  .name('tetra-dev-token')
   .description('Manage Supabase dev tokens for API testing')
-  .version('1.1.0')
+  .version('1.2.0')
   .option('--login', 'Interactive login (prompts for email/password)')
   .option('--status', 'Show current token status')
   .option('--project <name>', 'Override auto-detected project slug')

package/bin/{vca-setup.js → tetra-setup.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * VCA Quality Toolkit - Setup CLI
+ * Tetra Dev Toolkit - Setup CLI
  *
  * Sets up quality infrastructure in a project:
  * - Husky pre-commit hooks
@@ -9,10 +9,10 @@
  * - Configuration file
  *
  * Usage:
- *   vca-setup              # Interactive setup
- *   vca-setup hooks        # Setup Husky hooks only
- *   vca-setup ci           # Setup GitHub Actions only
- *   vca-setup config       # Create .vca-quality.json
+ *   tetra-setup              # Interactive setup
+ *   tetra-setup hooks        # Setup Husky hooks only
+ *   tetra-setup ci           # Setup GitHub Actions only
+ *   tetra-setup config       # Create .tetra-quality.json
  */
 
 import { program } from 'commander'
@@ -23,14 +23,14 @@ import { join } from 'path'
 const projectRoot = process.cwd()
 
 program
-  .name('vca-setup')
-  .description('Setup VCA Quality Toolkit in your project')
-  .version('1.0.0')
+  .name('tetra-setup')
+  .description('Setup Tetra Dev Toolkit in your project')
+  .version('1.2.0')
   .argument('[component]', 'Component to setup: hooks, ci, config, or all (default)')
   .option('-f, --force', 'Overwrite existing files')
   .action(async (component, options) => {
     console.log('')
-    console.log('🔧 VCA Quality Toolkit - Setup')
+    console.log('🔧 Tetra Dev Toolkit - Setup')
     console.log('═'.repeat(50))
     console.log('')
 
@@ -58,7 +58,7 @@ program
     console.log('✅ Setup complete!')
     console.log('')
     console.log('Next steps:')
-    console.log('  1. Run `vca-audit` to check your project')
+    console.log('  1. Run `tetra-audit` to check your project')
     console.log('  2. Commit the generated files')
     console.log('  3. Push to trigger CI checks')
     console.log('')
@@ -95,14 +95,14 @@ async function setupHooks(options) {
     const preCommitContent = `#!/bin/sh
 . "$(dirname "$0")/_/husky.sh"
 
-echo "🔍 Running VCA Quality checks..."
+echo "🔍 Running Tetra quality checks..."
 
 # Run quick security checks (fast, blocks commit on critical issues)
-npx vca-audit quick
+npx tetra-audit quick
 if [ $? -ne 0 ]; then
   echo ""
   echo "❌ Security issues found! Fix before committing."
-  echo "   Run 'vca-audit' for detailed report."
+  echo "   Run 'tetra-audit' for detailed report."
   exit 1
 fi
 
@@ -120,6 +120,39 @@ echo "✅ Pre-commit checks passed"
     console.log('   ⏭️  .husky/pre-commit already exists (use --force to overwrite)')
   }
 
+  // Create or extend pre-push hook with hygiene check
+  const prePushPath = join(huskyDir, 'pre-push')
+  const hygieneBlock = `
+# Tetra hygiene check — blocks push if repo contains clutter
+echo "🧹 Running repo hygiene check..."
+npx tetra-audit hygiene
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "❌ Repo hygiene issues found! Clean up before pushing."
+  echo "   Run 'npx tetra-audit hygiene --verbose' for details."
+  echo "   Run 'bash node_modules/@soulbatical/tetra-dev-toolkit/bin/cleanup-repos.sh' to auto-fix."
+  exit 1
+fi
+echo "✅ Repo hygiene passed"
+`
+
+  if (!existsSync(prePushPath)) {
+    // No pre-push hook yet — create one
+    const prePushContent = `#!/bin/sh\n${hygieneBlock}\n`
+    writeFileSync(prePushPath, prePushContent)
+    execSync(`chmod +x ${prePushPath}`)
+    console.log('   ✅ Created .husky/pre-push with hygiene check')
+  } else {
+    // Pre-push hook exists — add hygiene check if not already there
+    const existing = readFileSync(prePushPath, 'utf-8')
+    if (!existing.includes('tetra-audit hygiene')) {
+      writeFileSync(prePushPath, existing.trimEnd() + '\n' + hygieneBlock)
+      console.log('   ✅ Added hygiene check to existing .husky/pre-push')
+    } else {
+      console.log('   ⏭️  .husky/pre-push already has hygiene check')
+    }
+  }
+
   // Add prepare script to package.json
   if (!pkg.scripts?.prepare?.includes('husky')) {
     pkg.scripts = pkg.scripts || {}
@@ -149,7 +182,7 @@ on:
 
 jobs:
   quality:
-    name: 🔍 VCA Quality Audit
+    name: 🔍 Tetra Quality Audit
     runs-on: ubuntu-latest
 
     steps:
@@ -165,8 +198,8 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Run VCA Quality Audit
-        run: npx @vca/quality-toolkit --ci
+      - name: Run Tetra Quality Audit
+        run: npx tetra-audit --ci
 
       - name: Upload results
         if: always()
@@ -186,15 +219,16 @@ jobs:
 async function setupConfig(options) {
   console.log('📝 Setting up configuration...')
 
-  const configPath = join(projectRoot, '.vca-quality.json')
+  const configPath = join(projectRoot, '.tetra-quality.json')
   if (!existsSync(configPath) || options.force) {
     const config = {
-      "$schema": "https://vca-tools.dev/schemas/quality-toolkit.json",
+      "$schema": "https://tetra-tools.dev/schemas/quality-toolkit.json",
       "suites": {
         "security": true,
         "stability": true,
         "codeQuality": true,
-        "supabase": "auto"
+        "supabase": "auto",
+        "hygiene": true
       },
       "security": {
         "checkHardcodedSecrets": true,
@@ -218,7 +252,7 @@ async function setupConfig(options) {
     }
 
     writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n')
-    console.log('   ✅ Created .vca-quality.json')
+    console.log('   ✅ Created .tetra-quality.json')
   } else {
     console.log('   ⏭️  Config already exists (use --force to overwrite)')
   }