fix: add python3 shebangs to all Python scripts (#681)

Added #!/usr/bin/env python3 to 74 Python scripts across:
- bin/ (16 scripts)
- scripts/ (48 scripts)
- pipeline/ (3 scripts)
- training/scripts/ (3 scripts)
- hermes-sovereign/ (1 script)

Also added executable permissions to fixed scripts.
Test files excluded (run by pytest, not directly).

Closes #681

bin/banned_provider_scan.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """Anthropic Ban Enforcement Scanner.
 
 Scans all config files, scripts, and playbooks for any references to

bin/conflict_detector.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Merge Conflict Detector — catches sibling PRs that will conflict.
 

bin/context-overflow-guard.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Context Overflow Guard Script
 Issue #510: [Robustness] Context overflow automation — auto-summarize and commit

bin/crucible_mcp_server.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """Z3-backed Crucible MCP server for Timmy.
 
 Sidecar-only. Lives in timmy-config, deploys into ~/.hermes/bin/, and is loaded

bin/deadman-fallback.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Dead Man Switch Fallback Engine
 

bin/glitch_patterns.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Glitch pattern definitions for 3D world anomaly detection.
 

bin/harm_facilitation_adversary.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """Adversary worker for issue #618 — Harm Facilitation jailbreak prompts.
 
 Generates a 200-prompt harm-facilitation corpus, can run the prompts against an

bin/matrix_glitch_detector.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Matrix 3D World Glitch Detector
 

bin/model-fallback-verify.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Model Fallback Verification Script
 Issue #514: [Robustness] Model fallback verification — test before trusting

bin/nostr-agent-demo.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Full Nostr agent-to-agent communication demo - FINAL WORKING
 """

bin/pr-checklist.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """pr-checklist.py -- Automated PR quality gate for Gitea CI.
 
 Enforces the review standards that agents skip when left to self-approve.

bin/preflight-provider-check.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Pre-Flight Provider Check Script
 Issue #508: [Robustness] Credential drain detection — provider health checks

bin/provider-health-monitor.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Provider Health Monitor Script
 Issue #509: [Robustness] Provider-aware profile config — auto-switch on failure

bin/quality-gate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Quality Gate — Validate pipeline outputs before saving.
 

bin/soul_eval_gate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Soul Eval Gate — The Conscience of the Training Pipeline
 

bin/validate_config.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Config Validator -- pre-deploy YAML validation for timmy-config sidecar.
 

hermes-sovereign/mempalace/wakeup.py

@@ -1,3 +1,4 @@
+#!/usr/bin/env python3
 """Wake-up Protocol — session start context injection.
 
 Generates 300-900 tokens of context when a new Hermes session starts.

pipeline/nightly_scheduler.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 nightly_scheduler.py — Nightly Pipeline Scheduler
 

pipeline/orchestrator.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 orchestrator.py — Shared Pipeline Orchestrator
 

pipeline/quality_gate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 quality_gate.py — Quality Gate for Pipeline Outputs
 

scripts/adr_manager.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [ARCH] ADR Manager
 Part of the Gemini Sovereign Governance System.

scripts/adversary_harness.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Adversary Execution Harness — Timmy Foundation
 

scripts/agent_dispatch.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Agent Dispatch Framework
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/agent_guardrails.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 agent_guardrails.py — Sovereign Agent Guardrails for the Timmy Foundation.
 

scripts/architecture_linter.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import os
 import sys
 import re

scripts/architecture_linter_v2.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [ARCH] Architecture Linter v2
 Part of the Gemini Sovereign Governance System.

scripts/bezalel_builder_wizard.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import os
 import json
 import subprocess

scripts/captcha_bypass_handler.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import json
 from hermes_tools import browser_navigate, browser_vision
 

scripts/ci-cron-validate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """CI: Validate cron fleet health. Exit 1 on systemic failures."""
 
 import sys

scripts/ci_automation_gate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 ci_automation_gate.py — Automated Quality Gate for Timmy Foundation CI.
 

scripts/config_drift.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 config_drift.py — Detect configuration drift across fleet nodes.
 

scripts/config_drift_detector.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 config_drift_detector.py — Detect config drift across fleet nodes.
 

scripts/config_template.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Config Template System — Environment-Specific Overlays (Issue #696)
 

scripts/config_validate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 config-validate — Pre-deploy validation for timmy-config YAML files.
 

scripts/config_validator.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 config_validator.py — Validate all YAML/JSON config files in timmy-config.
 

scripts/cron-audit-662.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Cron Fleet Audit Script — #662
 

scripts/cron_audit.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Cron Job Audit — Identify erroring jobs, categorize health, recommend actions.
 

scripts/cross_repo_test.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Cross-Repo Test Suite
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/diagram_meaning_extractor.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import json
 from hermes_tools import browser_navigate, browser_vision
 

scripts/fleet-dashboard.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 fleet-dashboard.py -- Timmy Foundation Fleet Status Dashboard.
 

scripts/fleet_llama.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] llama.cpp Fleet Manager
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/foundation_accessibility_audit.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 foundation_accessibility_audit.py — Multimodal Visual Accessibility Audit.
 

scripts/generate-crisis-direct-suicidal-pairs.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import argparse
 import json
 from pathlib import Path

scripts/generate_scene_descriptions.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Auto-generate scene descriptions from image/video assets.
 

scripts/gitea_webhook_handler.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Gitea Webhook Handler
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/hash_dedup.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 hash_dedup.py — Deduplication with bounded hash storage.
 

scripts/health_dashboard.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 health_dashboard.py — Sovereign Health & Observability Dashboard.
 

scripts/kaizen_retro.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Kaizen Retro — Automated retrospective after every burn cycle.
 

scripts/knowledge_base.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """knowledge_base.py - GOFAI symbolic knowledge base for the Timmy Foundation fleet.
 
 A classical AI knowledge representation system: stores facts as ground atoms,

scripts/matrix_glitch_detect.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 matrix_glitch_detect.py — 3D World Visual Artifact Detection for The Matrix.
 

scripts/model_eval.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [EVAL] Model Evaluation Harness
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/muda_audit.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 muda_audit.py — Weekly waste audit for the Timmy Foundation fleet.
 

scripts/nexus_smoke_test.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 nexus_smoke_test.py — Visual Smoke Test for The Nexus.
 

scripts/normalize-code-blocks.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 normalize-code-blocks.py — Fix inconsistent indentation in training data code blocks.
 

scripts/normalize_code_blocks.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 normalize-code-blocks.py — Fix inconsistent indentation in training data code blocks.
 

scripts/nostur_status_query.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Nostur Status Query MVP
 Read-only status responses sourced from Gitea truth.

scripts/phase_tracker.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Phase Progression Tracker
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/pr-backlog-triage.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 pr-backlog-triage.py — Analyze and triage open PR backlog.
 

scripts/pr-triage-automation.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 pr-backlog-triage.py — Analyze and triage open PR backlog.
 

scripts/pr_backlog_triage.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 pr_backlog_triage.py — Automated PR backlog analysis for Gitea repos (Issue #658).
 

scripts/provision_wizard.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Automated VPS Provisioning System (Von Neumann as Code)
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/quality_gate_integration.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 Quality Gate Integration — Pipeline Orchestrator Hook
 

scripts/reset_pipeline_state.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 reset_pipeline_state.py — Daily reset for pipeline_state.json
 

scripts/self_healing.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Self-Healing Infrastructure
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/skill_installer.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Sovereign Skill Installer
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/strips_planner.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """strips_planner.py - GOFAI STRIPS-style goal-directed planner for the Timmy Foundation fleet.
 
 Implements a classical means-ends analysis (MEA) planner over a STRIPS action

scripts/symbolic_reasoner.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """symbolic_reasoner.py — Forward-chaining rule engine for the Timmy Foundation fleet.
 
 A classical GOFAI approach: declarative IF-THEN rules evaluated over a

scripts/task_gate.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """Task Gate — Pre-task and post-task quality gates for fleet agents.
 
 This is the missing enforcement layer between the orchestrator dispatching

scripts/telemetry.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 [OPS] Telemetry Pipeline v2
 Part of the Gemini Sovereign Infrastructure Suite.

scripts/temporal_reasoner.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """temporal_reasoner.py - GOFAI temporal reasoning engine for the Timmy Foundation fleet.
 
 A symbolic temporal constraint network (TCN) for scheduling and ordering events.

scripts/test_reset_pipeline_state.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """Tests for scripts/reset_pipeline_state.py — 10 tests."""
 
 import json

scripts/token-tracker.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """Token Budget Tracker -- real-time spend dashboard for pipelines."""
 
 import argparse, json, os, sqlite3, sys, time

scripts/token_budget.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 token_budget.py — Daily token budget tracker for pipeline orchestration.
 

scripts/token_optimizer.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 token_optimizer.py — Token Efficiency & Optimization for the Timmy Foundation.
 

scripts/token_tracker.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 token_tracker.py — Pipeline Token Budget Tracker
 

scripts/tower_visual_mapper.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 tower_visual_mapper.py — Holographic Map of The Tower Architecture.
 

scripts/validate-scene-data.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 validate-scene-data.py — Validate scene description JSONL files against schema.
 

scripts/visual_pr_reviewer.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import json
 from hermes_tools import browser_navigate, browser_vision
 

training/scripts/augment_pairs.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 augment_pairs.py — Training data augmentation: paraphrase and translate.
 

training/scripts/generate_scene_descriptions.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 """
 generate_scene_descriptions.py — Auto-generate scene descriptions from image/video.
 

training/scripts/quality_filter.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#!/usr/bin/env python3
 import json,sys,re,os
 from pathlib import Path