Phase 1: Git Repository Audit (4 Agents, 2,438 files)
- GLOBAL_VISION_REPORT.md - Master audit synthesis (health score 8/10)
- ARCHAEOLOGIST_REPORT.md - Roadmap reconstruction (3 phases, no abandonments)
- INSPECTOR_REPORT.md - Wiring analysis (9/10, zero broken imports)
- SEGMENTER_REPORT.md - Functionality matrix (6/6 core features complete)
- GITEA_SYNC_STATUS_REPORT.md - Sync gap analysis (67 commits behind)
Phase 2: Multi-Environment Audit (3 Agents, 991 files)
- LOCAL_FILESYSTEM_ARTIFACTS_REPORT.md - 949 files scanned, 27 ghost files
- STACKCP_REMOTE_ARTIFACTS_REPORT.md - 14 deployment files, 12 missing from Git
- WINDOWS_DOWNLOADS_ARTIFACTS_REPORT.md - 28 strategic docs recovered
- PHASE_2_DELTA_REPORT.md - Cross-environment delta analysis
Remediation Kit (3 Agents)
- restore_chaos.sh - Master recovery script (1,785 lines, 23 functions)
- test_search_wiring.sh - Integration test suite (10 comprehensive tests)
- ELECTRICIAN_INDEX.md - Wiring fixes documentation
- REMEDIATION_COMMANDS.md - CLI command reference
Redis Knowledge Base
- redis_ingest.py - Automated ingestion (397 lines)
- forensic_surveyor.py - Filesystem scanner with Redis integration
- REDIS_INGESTION_*.md - Complete usage documentation
- Total indexed: 3,432 artifacts across 4 namespaces (1.43 GB)
Dockerfile Updates
- Enabled wkhtmltopdf for PDF export
- Multi-stage Alpine Linux build
- Health check endpoint configured
Security Updates
- Updated .env.example with comprehensive variable documentation
- server/index.js modified for api_search route integration
Audit Summary:
- Total files analyzed: 3,429
- Total execution time: 27 minutes
- Agents deployed: 7 (4 Phase 1 + 3 Phase 2)
- Health score: 8/10 (production ready)
- No lost work detected
- No abandoned features
- Zero critical blockers
Launch Status: APPROVED for December 10, 2025
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
76 lines
4.1 KiB
Bash
Executable file
76 lines
4.1 KiB
Bash
Executable file
#!/bin/bash
|
|
# NaviDocs Repository Reorganization Script
|
|
# Cleans up index sprawl by moving files to appropriate docs/ subfolders
|
|
|
|
set -e # Exit on error
|
|
|
|
echo "🧹 Starting NaviDocs repository reorganization..."
|
|
|
|
# Create new folder structure
|
|
echo "📁 Creating folder structure..."
|
|
mkdir -p docs/deployment
|
|
mkdir -p docs/guides
|
|
mkdir -p docs/development
|
|
mkdir -p docs/handover
|
|
|
|
# Move architecture files
|
|
echo "📦 Moving architecture docs..."
|
|
git mv ARCHITECTURE-SUMMARY.md docs/architecture/ 2>/dev/null || mv ARCHITECTURE-SUMMARY.md docs/architecture/
|
|
|
|
# Move deployment/StackCP files
|
|
echo "🚀 Moving deployment docs..."
|
|
git mv STACKCP_EVALUATION_REPORT.md docs/deployment/ 2>/dev/null || mv STACKCP_EVALUATION_REPORT.md docs/deployment/
|
|
git mv STACKCP_VERIFICATION_SUMMARY.md docs/deployment/ 2>/dev/null || mv STACKCP_VERIFICATION_SUMMARY.md docs/deployment/
|
|
git mv STACKCP_ARCHITECTURE_ANALYSIS.md docs/deployment/ 2>/dev/null || mv STACKCP_ARCHITECTURE_ANALYSIS.md docs/deployment/
|
|
git mv STACKCP_DEBATE_BRIEF.md docs/deployment/ 2>/dev/null || mv STACKCP_DEBATE_BRIEF.md docs/deployment/
|
|
git mv STACKCP_QUICK_REFERENCE.md docs/deployment/ 2>/dev/null || mv STACKCP_QUICK_REFERENCE.md docs/deployment/
|
|
git mv docs/DEPLOYMENT_STACKCP.md docs/deployment/ 2>/dev/null || mv docs/DEPLOYMENT_STACKCP.md docs/deployment/
|
|
git mv docs/STACKCP_QUICKSTART.md docs/deployment/ 2>/dev/null || mv docs/STACKCP_QUICKSTART.md docs/deployment/
|
|
|
|
# Move OCR/guides files
|
|
echo "📚 Moving guide docs..."
|
|
git mv OCR_PIPELINE_SETUP.md docs/guides/ 2>/dev/null || mv OCR_PIPELINE_SETUP.md docs/guides/
|
|
git mv OCR_FINAL_RECOMMENDATION.md docs/guides/ 2>/dev/null || mv OCR_FINAL_RECOMMENDATION.md docs/guides/
|
|
git mv GOOGLE_DRIVE_OCR_QUICKSTART.md docs/guides/ 2>/dev/null || mv GOOGLE_DRIVE_OCR_QUICKSTART.md docs/guides/
|
|
git mv docs/OCR_OPTIONS.md docs/guides/ 2>/dev/null || mv docs/OCR_OPTIONS.md docs/guides/
|
|
git mv docs/GOOGLE_OCR_COMPARISON.md docs/guides/ 2>/dev/null || mv docs/GOOGLE_OCR_COMPARISON.md docs/guides/
|
|
|
|
# Move development files
|
|
echo "🔧 Moving development docs..."
|
|
git mv DEVELOPMENT.md docs/development/ 2>/dev/null || mv DEVELOPMENT.md docs/development/
|
|
git mv PORT_ALLOCATION.md docs/development/ 2>/dev/null || mv PORT_ALLOCATION.md docs/development/
|
|
git mv PORT_MIGRATION_SUMMARY.md docs/development/ 2>/dev/null || mv PORT_MIGRATION_SUMMARY.md docs/development/
|
|
git mv BUILD_COMPLETE.md docs/development/ 2>/dev/null || mv BUILD_COMPLETE.md docs/development/
|
|
git mv IMPLEMENTATION_COMPLETE.md docs/development/ 2>/dev/null || mv IMPLEMENTATION_COMPLETE.md docs/development/
|
|
git mv TEST_RESULTS.md docs/development/ 2>/dev/null || mv TEST_RESULTS.md docs/development/
|
|
|
|
# Move handover/session files
|
|
echo "📋 Moving handover docs..."
|
|
git mv NAVIDOCS_HANDOVER.md docs/handover/ 2>/dev/null || mv NAVIDOCS_HANDOVER.md docs/handover/
|
|
git mv SESSION_STATUS.md docs/handover/ 2>/dev/null || mv SESSION_STATUS.md docs/handover/
|
|
git mv SERVICES_STATUS.md docs/handover/ 2>/dev/null || mv SERVICES_STATUS.md docs/handover/
|
|
git mv GITEA_ACCESS.md docs/handover/ 2>/dev/null || mv GITEA_ACCESS.md docs/handover/
|
|
git mv ANALYSIS_INDEX.md docs/handover/ 2>/dev/null || mv ANALYSIS_INDEX.md docs/handover/
|
|
|
|
# Remove duplicate branding brief from root (already in docs/creative/)
|
|
echo "🗑️ Removing duplicate files..."
|
|
git rm BRANDING_CREATIVE_BRIEF.md 2>/dev/null || rm -f BRANDING_CREATIVE_BRIEF.md
|
|
|
|
echo "✅ Reorganization complete!"
|
|
echo ""
|
|
echo "New structure:"
|
|
echo " docs/architecture/ - System architecture docs"
|
|
echo " docs/deployment/ - StackCP deployment guides"
|
|
echo " docs/guides/ - OCR and feature guides"
|
|
echo " docs/development/ - Dev setup and port allocation"
|
|
echo " docs/handover/ - Session notes and handover docs"
|
|
echo " docs/creative/ - Branding and design"
|
|
echo " docs/debates/ - Feature debates"
|
|
echo " docs/roadmap/ - Product roadmap"
|
|
echo ""
|
|
echo "Root directory now contains:"
|
|
echo " README.md - Main project overview"
|
|
echo " QUICKSTART.md - Quick start guide"
|
|
echo " client/ - Frontend code"
|
|
echo " server/ - Backend code"
|
|
echo " docs/ - All documentation"
|