navidocs/REORGANIZE_FILES.sh
Danny Stocker 841c9ac92e docs(audit): Add complete forensic audit reports and remediation toolkit
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>
2025-11-27 15:18:15 +01:00

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"