meridianforensicslisted

# /meridian:forensics — Workflow Forensics Post-mortem analysis of failed or stuck workflow states. Reads git history, DB state, and phase artifacts to detect stuck loops, missing artifacts, abandoned work, and crash signatures. Always writes a report to `.planning/forensics/`. **Read-only** — never modifies source files. ## Arguments - (no args) — run all checks, print summary, write report - `--stuck-hours N` — override stuck execution threshold (default: 4h) - `--abandoned-days N` — override abandoned work threshold (default: 3 days) - `--no-git` — skip git context gathering (faster, no subprocess calls) ## Keywords forensics, postmortem, stuck, crash, abandoned, missing, artifact, investigation, debug, audit, analysis ## Procedure ### Run forensics (default — writes report automatically) ```bash PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c " import json from pathlib import Path from scripts.forensics import run_forensics, write_report report = run_forensics(Path('.')) path = write_report(report, Path('.')) report['report_path'] = str(path) print(json.dumps(report, indent=2)) " ``` ### Run with custom stuck threshold (e.g. 8 hours) ```bash PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c " import json from pathlib import Path from scripts.forensics import run_forensics, write_report report = run_forensics(Path('.'), stuck_threshold_hours=8) path = write_report(report, Path('.')) report['report_path'] = str(path) print(j