foxhunt/CLEANUP_ACTION_ITEMS.md

Root Configuration Cleanup - Action Items

Generated: 2025-10-30 Status: Ready for Implementation Estimated Time: 45 minutes total

---

PHASE 1: IMMEDIATE CLEANUP (15 minutes)

Safe to Delete - Coverage & Build Artifacts

These files are regenerated by tests/builds and safe to delete immediately:

# Binary coverage files
rm -f .coverage
rm -f coverage.xml

# Build logs (safe - regenerated)
rm -f build_log.txt
rm -f build_results.txt
rm -f auth_bench.txt
rm -f benchmark_results_clean.txt

# Test output logs
rm -f final_test_results.txt
rm -f full_test_results.txt
rm -f ml_final_test.txt
rm -f ml_test_results.txt

# Clippy results
rm -f clippy_results.txt
rm -f final_clippy_results.txt
rm -f final_clippy_ml.txt
rm -f .clippy_baseline.txt
rm -f clippy_agent10_full.txt

# Coverage output
rm -f coverage_output.txt
rm -f coverage_full.txt

# Training logs
rm -f tft_training_log.txt
rm -f tft_qat_training_time.txt
rm -f ppo_hyperopt_output.txt

# Trader engine test output
rm -f trading_engine_test_output.txt

Total Freed: ~100MB Risk Level: NONE (all regenerated by CI/CD)

---

PHASE 2: ARCHIVE & DELETE LEGACY REPORTS (20 minutes)

Archive First (Keep for Reference)

# Create archive of legacy reports
cd /home/jgrusewski/Work/foxhunt
tar czf archives/foxhunt-legacy-reports-20251030.tar.gz \
  WAVE_*.txt \
  AGENT*.txt \
  *_SUMMARY.txt \
  HYPERPARAMETER_TUNING_ARCHITECTURE.txt \
  ML_TRAINING_SERVICE_ARCHITECTURE_DIAGRAM.txt \
  ML_CLIPPY_CATEGORY_BREAKDOWN.txt \
  PAPER_TRADING_PIPELINE_DIAGRAM.txt \
  RUNPOD_S3_ARCHITECTURE_DIAGRAM.txt \
  FILES_TO_DELETE.txt

# Verify archive
tar tzf archives/foxhunt-legacy-reports-20251030.tar.gz | head

# Then delete originals
rm -f WAVE_*.txt
rm -f AGENT*.txt
rm -f *_SUMMARY.txt
rm -f HYPERPARAMETER_TUNING_ARCHITECTURE.txt
rm -f ML_TRAINING_SERVICE_ARCHITECTURE_DIAGRAM.txt
rm -f ML_CLIPPY_CATEGORY_BREAKDOWN.txt
rm -f PAPER_TRADING_PIPELINE_DIAGRAM.txt
rm -f RUNPOD_S3_ARCHITECTURE_DIAGRAM.txt
rm -f FILES_TO_DELETE.txt

Total Freed: ~700MB Risk Level: VERY LOW (archived first)

Legacy Files to Archive (Specific List)

WAVE_*.txt files (20+ files, ~500MB):

WAVE_4_VISUAL_SUMMARY.txt
WAVE_7_VISUAL_SUMMARY.txt
WAVE_8_19_VISUAL_SUMMARY.txt
WAVE_9_AGENT_4_VISUAL_SUMMARY.txt
WAVE_112_AGENT20_SUMMARY.txt
WAVE_113_PRODUCTION_READINESS_COMPARISON.txt
WAVE_141_FULL_TEST_RESULTS.txt
WAVE_141_LIB_TEST_RESULTS.txt
WAVE_141_PARTIAL_TEST_RESULTS.txt
(plus others matching pattern)

AGENT.txt files* (30+ files, ~200MB):

AGENT11_SUMMARY.txt
AGENT3_DELIVERABLES.txt
AGENT3_FILE_INVENTORY.txt
agent54_summary.txt
(plus others matching pattern)

Summary files (~50MB):

AUDIT_EXECUTIVE_SUMMARY.txt
BENCHMARK_EXECUTIVE_SUMMARY.txt
CERTIFICATION_SCORE_CHART.txt
CERTIFICATION_V3_QUICK_SUMMARY.txt

---

PHASE 3: FIX .gitignore (5 minutes)

Current Issue

# Current .gitignore pattern
cat .gitignore | grep -A 5 "environment"

Output:

.env
.env.*
!.env.example
!.env.runpod       # ⚠️ WRONG: This is actual credentials file
!.env.runpod.template

Fix Applied

# Option 1: Edit directly
cat > .gitignore << 'EOF'
# ... (keep existing content before .env section) ...

# Environment variables and secrets
.env
.env.*
!.env.example
!.env.runpod.template

# Secret files and directories
/config/secrets/
secrets/
*.key
*.pem
*.p12

# ... (keep rest of .gitignore) ...
EOF

Verification

# Verify the pattern
git check-ignore -v .env.runpod
git check-ignore -v .env.runpod.template
git check-ignore -v .env.example

# Expected output:
# .gitignore:XX:.env.*    .env.runpod
# (pattern matches, so it's ignored)
#
# .gitignore:XX:!.env.runpod.template    .env.runpod.template
# (negation matches, so it's tracked)
#
# .gitignore:XX:!.env.example    .env.example
# (negation matches, so it's tracked)

---

PHASE 4: OPTIONAL - DOCUMENTATION REORGANIZATION

Create Directory Structure

# Create docs directory
mkdir -p docs/{architecture,deployment,quickref,runpod,ml,security,checklists,guides}

# Verify structure
ls -la docs/

Move Documentation Files

To docs/architecture/:

# Symlink or reference
# (Keep CLAUDE.md in root, but document in index)

To docs/deployment/:

mv DOCKER_BUILD_GUIDE.md docs/deployment/
mv DOCKER_BUILD_IMPLEMENTATION.md docs/deployment/
mv DOCKER_BUILD_QUICK_REF.md docs/deployment/
mv DOCKER_CUDA_124_DOWNGRADE_REPORT.md docs/deployment/
mv DOCKER_MULTISTAGE_PRODUCTION_GUIDE.md docs/deployment/
mv DOCKER_MULTI_STAGE_BUILD_REPORT.md docs/deployment/
mv GITLAB_CI_DOCKER_SETUP_GUIDE.md docs/deployment/
mv GITLAB_CI_IMPLEMENTATION_COMPLETE.md docs/deployment/
mv GITLAB_CI_QUICK_REF.md docs/deployment/
mv GITLAB_CI_VARIABLES_SETUP.md docs/deployment/
mv LOCAL_CI_PIPELINE_GUIDE.md docs/deployment/
mv LOCAL_CI_PIPELINE_VALIDATION.md docs/deployment/

To docs/quickref/:

mv BINARY_UPLOAD_QUICK_REF.md docs/quickref/
mv BINARY_VALIDATION_QUICK_REF.md docs/quickref/
mv DQN_TRAINING_PATHS_QUICK_REF.md docs/quickref/
mv GRAD_B3_QUICK_REF.md docs/quickref/
mv MONITOR_LOGS_QUICK_REF.md docs/quickref/
mv OOD_VALIDATION_QUICK_REF.md docs/quickref/
mv QAT_OOM_RECOVERY_QUICK_REF.md docs/quickref/

To docs/runpod/:

mv RUNPOD_DEPLOY_QUICK_REF.md docs/runpod/
mv RUNPOD_DEPLOYMENT_READINESS_CHECKLIST.md docs/runpod/
mv RUNPOD_PYTHON_QUICK_REF.md docs/runpod/
mv RUNPOD_WORKFLOW_GUIDE.md docs/runpod/
mv CUDA_12.9_DEPLOYMENT_GUIDE.md docs/runpod/

To docs/ml/:

mv HYPEROPT_DEPLOYMENT_GUIDE.md docs/ml/
mv OOM_RECOVERY_GUIDE.md docs/ml/

To docs/security/:

mv SECURITY_HARDENING_CHECKLIST.md docs/security/
mv SECURITY_PRODUCTION_DEPLOYMENT_CHECKLIST.md docs/security/

To docs/checklists/:

mv PRODUCTION_DEPLOYMENT_CHECKLIST.md docs/checklists/
mv PRE_FLIGHT_CHECKLIST.md docs/checklists/
mv PRE_DEPLOYMENT_CHECKLIST.md docs/checklists/
mv SAFE_DEPLOYMENT_CHECKLIST.md docs/checklists/
mv TRAINING_SESSION_CHECKLIST.md docs/checklists/

Keep in Root:

# These stay in root (entry points)
CLAUDE.md
README.md

---

EXECUTION CHECKLIST

Before Starting

• Verify backup exists (if concerned)
• Review this entire document
• Confirm you're in the correct directory

  pwd
  # Should show: /home/jgrusewski/Work/foxhunt
  

Phase 1: Delete Artifacts

• Execute Phase 1 deletion commands
• Verify files are deleted

  ls -la .coverage coverage.xml clippy_results.txt 2>/dev/null
  # Should show "No such file or directory"
  

Phase 2: Archive & Delete

• Create archives directory if needed

  mkdir -p archives
  

• Run tar command to create archive
• Verify archive created

  ls -lh archives/foxhunt-legacy-reports-*.tar.gz
  

• Extract sample files to verify integrity

  tar tzf archives/foxhunt-legacy-reports-*.tar.gz | head
  

• Delete original WAVE_.txt, AGENT.txt, etc.

Phase 3: Fix .gitignore

• Edit .gitignore
• Remove !.env.runpod line
• Verify .env.runpod.template line exists
• Test with git check-ignore

Phase 4: Documentation (Optional)

• Create docs directory structure
• Move files to subdirectories
• Create docs/README.md index
• Update links in README.md

Final Verification

• Run tests to ensure nothing broke

  cargo test --workspace
  

• Verify docker-compose still works

  docker-compose config > /dev/null
  

• Check that example configs are found

  ls -la tuning_config.yaml TFT_TUNING_CONFIG_RECOMMENDED.yaml
  

---

EXPECTED RESULTS

Before Cleanup

Total root files: 150+
Total size: ~7.9GB
Legacy/temp files: ~2.5GB

After Phase 1 & 2

Total root files: 50
Total size: ~5.4GB
Legacy/temp files: 0 (archived)

After Phase 3

.gitignore: Fixed (tracks only templates, ignores credentials)

After Phase 4 (Optional)

Root documentation: 2 files (CLAUDE.md, README.md)
Total root files: 35-40
Organized docs: 8 categories in docs/

---

ROLLBACK PROCEDURE

If anything goes wrong:

For Phase 1 (Artifacts)

• These can be regenerated by running tests
• cargo test --workspace will recreate coverage files if needed

For Phase 2 (Legacy Reports)

# Extract from archive
tar xzf archives/foxhunt-legacy-reports-*.tar.gz
# Files will be restored to root

For Phase 3 (.gitignore)

# Git has the original in history
git checkout .gitignore

For Phase 4 (Docs)

# Move files back
mv docs/deployment/*.md .
mv docs/quickref/*.md .
# etc.

---

REFERENCES

• Main Report: ROOT_CONFIG_FILES_ANALYSIS_REPORT.md
• Git Status: git status
• File Listing: ls -lah
• Archive: /home/jgrusewski/Work/foxhunt/archives/

---

NOTES

1. Environment Files: All correctly configured (no action needed)
2. Build Configs: All in correct locations (no action needed)
3. ML Tuning Configs: Keep in root (required by default paths)
4. Documentation: Optional to move; core docs (CLAUDE.md, README.md) essential in root
5. Legacy Files: Safe to delete/archive (not referenced, historical only)

---

Generated: 2025-10-30 Status: Ready to Execute Risk Level: LOW (all deletions are safe/reversible)