chore: organize auxiliary and validation scripts into a utils directory

scripts/backlog-analysis/README.md

@@ -7,7 +7,10 @@ and determining implementation effort levels for the Gemini CLI project.
 
 - `data/`: Contains the issue data in JSON and CSV formats.
   - `bugs.json`: The primary source of truth for bug analysis.
-- `*.py`: Analysis and utility scripts.
+- `utils/`: Auxiliary scripts for manual overrides, debugging, and post-analysis
+  validation (e.g., `validate_effort.py`, `inject_manual_fixes.py`).
+- `*.py`: Core analysis and export scripts (e.g., `bug_analyzer_final.py`,
+  `generate_bugs_csv.py`).
 - `loop_analyzer.sh`: A shell script for running iterative analysis until all
   issues are processed.
 
@@ -39,10 +42,11 @@ Runs the single-turn analyzer in a loop until all issues have a valid analysis.
 
 ### 4. Validation & Export
 
-Run these after analysis to ensure consistency and generate a readable report.
+Run validation from the utils folder to ensure consistency, then generate a
+readable report.
 
 ```bash
-python3 validate_effort.py
+python3 utils/validate_effort.py
 python3 generate_bugs_csv.py
 ```
 

scripts/backlog-analysis/utils/debug_bug.py

@@ -52,7 +52,7 @@ def execute_tool(call):
         except: return "Error or no results."
     elif name == 'read_file':
         f = args.get('filepath', '')
-        if not f.startswith('/'): f = os.path.join('../../packages', f)
+        if not f.startswith('/'): f = os.path.join('../../../packages', f)
         if not os.path.exists(f): return "File not found."
         try:
             return subprocess.check_output(f'head -n 200 "{f}"', shell=True, text=True)
@@ -60,7 +60,7 @@ def execute_tool(call):
     return "Unknown tool"
 
 def debug_one(issue_num):
-    with open('data/bugs.json', 'r') as f:
+    with open('../data/bugs.json', 'r') as f:
         bugs = json.load(f)
     issue = next(b for b in bugs if b['number'] == issue_num)
     

scripts/backlog-analysis/utils/inject_manual_fixes.py

@@ -1,6 +1,6 @@
 import json
 
-BUGS_FILE = 'data/bugs.json'
+BUGS_FILE = '../data/bugs.json'
 
 with open(BUGS_FILE, 'r') as f:
     bugs = json.load(f)

scripts/backlog-analysis/utils/reclassify_effort.py

@@ -1,7 +1,7 @@
 import json
 import re
 
-BUGS_FILE = 'data/bugs.json'
+BUGS_FILE = '../data/bugs.json'
 
 with open(BUGS_FILE, 'r') as f:
     bugs = json.load(f)

scripts/backlog-analysis/utils/update_manual_bugs.py

@@ -1,6 +1,6 @@
 import json
 
-BUGS_FILE = 'data/bugs.json'
+BUGS_FILE = '../data/bugs.json'
 
 with open(BUGS_FILE, 'r') as f:
     bugs = json.load(f)

scripts/backlog-analysis/utils/update_verified_bugs.py

@@ -1,6 +1,6 @@
 import json
 
-BUGS_FILE = 'data/bugs.json'
+BUGS_FILE = '../data/bugs.json'
 
 with open(BUGS_FILE, 'r') as f:
     bugs = json.load(f)