docs: expand README with new utility scripts and usage examples

Updated the README.md to include detailed descriptions and usage instructions for new utility scripts:
- `kill_long_running_tasks.py`: A Dagster utility for managing long-running jobs.
- SQLite utilities: `create_index.py`, `list_tables.py`, `list_indexes.py`, and `qry.py` for database performance optimization and inspection.

Added quick examples for each script to enhance user guidance and improve overall documentation clarity.

Author: andrewm4894

scripts/README.md

@@ -8,15 +8,67 @@ The scripts in this directory provide helpful utilities for common administrativ
 
 ## Structure
 
-### `sqlite/`
-Contains SQLite-specific utility scripts for users running Anomstack with SQLite as their database backend.
+### `kill_long_running_tasks.py`
+Dagster utility for terminating or marking as failed any runs that exceed the configured timeout. 
 
-### `utils/`
-Contains general utility scripts for system management and maintenance.
+**Features:**
+- Uses the same timeout configuration as the timeout sensor
+- Gracefully handles unreachable user code servers
+- Provides detailed logging of termination actions
+- Automatically marks stuck runs as failed when termination isn't possible
+
+**Usage:**
+```bash
+cd scripts/
+python kill_long_running_tasks.py
+```
 
 ### `posthog_example.py`
 Runs the PostHog metrics ingest function to ensure your PostHog credentials work.
 
+### `sqlite/`
+Contains SQLite-specific utility scripts for users running Anomstack with SQLite as their database backend:
+
+#### `create_index.py`
+Automatically creates performance indexes on common metric columns (`metric_timestamp`, `metric_batch`, `metric_type`) for all tables in the SQLite database.
+
+**Usage:**
+```bash
+cd scripts/sqlite/
+python create_index.py
+```
+
+#### `list_tables.py`
+Lists all tables in the SQLite database with their names and details.
+
+**Usage:**
+```bash
+cd scripts/sqlite/
+python list_tables.py
+```
+
+#### `list_indexes.py`
+Lists all indexes in the SQLite database with their names and associated tables.
+
+**Usage:**
+```bash
+cd scripts/sqlite/
+python list_indexes.py
+```
+
+#### `qry.py`
+Executes the SQL query from `qry.sql` file and returns results as a DataFrame. Useful for running ad-hoc SQL queries against your SQLite database.
+
+**Usage:**
+```bash
+cd scripts/sqlite/
+# Edit qry.sql with your query first
+python qry.py
+```
+
+### `utils/`
+Contains general utility scripts for system management and maintenance.
+
 ### `utils/reset_docker.sh`
 Comprehensive Docker reset utility with multiple cleanup levels:
 - **Gentle**: Rebuild containers with fresh images (safest)
@@ -31,10 +83,16 @@ Can be run interactively or with specific reset levels via Makefile targets.
 These scripts are typically used for:
 
 - **Database Setup**: Initialize databases and create required tables
+- **Database Performance**: Create indexes to improve query performance (`create_index.py`)
+- **Database Inspection**: View table and index structures (`list_tables.py`, `list_indexes.py`)
 - **Data Migration**: Move data between different storage backends
+- **Data Analysis**: Run ad-hoc SQL queries for troubleshooting (`qry.py`)
 - **Maintenance**: Clean up old data, optimize performance
+- **Task Management**: Terminate stuck or long-running Dagster jobs (`kill_long_running_tasks.py`)
 - **Development**: Setup development environments and test data
 - **Deployment**: Automate deployment tasks and configuration
+- **System Reset**: Clean up Docker environments with various levels of data preservation (`reset_docker.sh`)
+- **Credential Validation**: Test external service integrations (`posthog_example.py`)
 
 ## Usage
 
@@ -48,6 +106,34 @@ cd scripts/
 python script_name.py
 ```
 
+### Quick Examples
+
+**Database performance optimization:**
+```bash
+cd scripts/sqlite/
+python create_index.py  # Create performance indexes
+```
+
+**Database inspection:**
+```bash
+cd scripts/sqlite/
+python list_tables.py   # See all tables
+python list_indexes.py  # See all indexes
+```
+
+**Clean up stuck Dagster jobs:**
+```bash
+cd scripts/
+python kill_long_running_tasks.py
+```
+
+**Complete Docker environment reset:**
+```bash
+make reset-interactive  # Interactive mode
+# or
+make reset-nuclear      # Nuclear reset
+```
+
 ## Database-Specific Scripts
 
 Different database backends may have specific requirements and utilities: