Skip to content

Support Utilities

This page documents the active support-tooling surface under scripts/.

These tools are not the framework itself and they are not the primary simulation or app surfaces. They exist to inspect, verify, compare, visualize, and debug the surrounding system.

Current Layout

debug_api/

Provider probes and connection checks.

Key files:

  • scripts/debug_api/openai_probe.py
  • scripts/debug_api/legacy/*

session_tools/

Utilities for analyzing or plotting saved runs.

Key files:

  • scripts/session_tools/analyze_flame_war.py
  • scripts/session_tools/extract_and_visualize.py
  • scripts/session_tools/repository_guardian_dashboard.py
  • scripts/session_tools/visualize_clock_session.py
  • scripts/session_tools/visualize_house_of_david.py

simulation_support/

Stress tests, verification helpers, and support renderers around specific builds.

Key files:

  • scripts/simulation_support/repository_guardian_stress_test.py
  • scripts/simulation_support/torahbot_debug_renderer.py
  • scripts/simulation_support/verify_clock_that_eats_futures.py

Root Utility

  • scripts/vanilla_comparison.py

This compares a saved DDA-X run against a plain chat-completions baseline.

Role In The Repo

The support layer is where operational clarity lives:

  • provider probing
  • saved-run inspection
  • dashboard generation
  • regression-style validation
  • side-by-side comparison

If src/, simulations/, and apps/ are the active bodies of work, scripts/ is the inspection and operations belt around them.