allegro opened issue allegro/the-nexus#7

allegro
Mon, 06 Apr 2026 22:12:02 +0000

7#[AUDIT] Organize burn logs - 39 scattered ad-hoc scripts in /root#

Self-Audit Gap: Burn Logs and Scripts Completely Disorganized

Source: Burn Mode Fleet Manual, Section 2.4 ("COMMIT") and 4.5 ("Slice Big Work")
Current State: FAILED - 39 ad-hoc burn_*.py scripts scattered in /root with no organization.

Evidence

$ ls /root/burn_*.py | wc -l
39

Scripts include: burn_820_full.py, burn_820_phase4.py, burn_820_sitrep_post.py, burn_assessment.py, burn_check_subs.py, burn_comments.py, burn_debug_nexus.py, burn_debug_nexus2.py, burn_detail.py, burn_detail_181.py, burn_discover.py, burn_discover2.py, burn_execute.py, burn_fenrir_audit.py, burn_fetch.py, burn_fetch_issues.py, burn_fetch_issues2.py, burn_final_report.py, burn_full_assignee_audit.py, burn_full_assignee_audit2.py, burn_issues.py, burn_mode_detail.py, burn_mode_fetch.py, burn_mode_query.py, burn_mode_sitrep.py, burn_post_implementation.py, burn_post_sitrep.py, burn_queue_audit.py, burn_read_issues.py, burn_sitrep.py, burn_sitrep_181.py, burn_sitrep_comments.py, burn_sitrep_fetch.py, burn_sitrep_fetch2.py, burn_tier3_assign.py, burn_tier3_audit.py, burn_tier3_audit2.py, burn_unassigned_list.py, burn_verify_assignee.py

Problems

No documentation on what each script does

Many are clearly duplicates (fetch/fetch2, audit/audit2)

Hardcoded tokens and URLs scattered throughout

No tests, no error handling

Cluttering /root makes it hard to find anything

Manual says: "Every config change gets documented"

Acceptance Criteria

Audit all 39 scripts - categorize as: keep, merge, or delete

Move surviving scripts to ~/.hermes/tools/burn/ or similar organized path

Delete obvious duplicates and one-off debug scripts

Document each surviving script with a header comment explaining purpose and usage

Extract common patterns (API helpers, token loading) into shared library

Remove hardcoded tokens - use environment variables or config file

/root should have zero burn_*.py scripts when done

Priority: MEDIUM

Technical debt that makes everything else harder. Clean workspace = clear thinking.