Task Rescue Blackbox — v1.0 Release Notes

Released: 2026-05-05

Version: 1.0

Category: Operations

Price: $4.99 (one-time)

What is New in v1.0

First public release of Task Rescue Blackbox.

Recover abandoned or half-finished agent work with an evidence-backed continuation package
Git-aware workspace analysis: captures current branch, status, changed files, and diff stat automatically when a git repo is detected
TODO/FIXME/BLOCKED/HACK/XXX marker scanning across .py, .md, .js, .ts, .json, .yaml, .yml, and .txt files
Log evidence capture: excerpt recent errors and notable events from .log, .txt, and .out files (configurable tail depth, up to 20 files)
Continuation checklist and risk notes generated from captured evidence
Credential redaction active on all log excerpts and diff output — no raw secrets in generated notes
Markdown or JSON output for handoff to another agent or human reviewer

Read-only: the script does not alter source files, config, or any workspace content
Git subprocess boundary is fixed-list commands only: git rev-parse, git branch, git status, git diff. No shell=True, no user-controlled input passed to subprocess. 15-second timeout enforced.
.git/, node_modules/, and __pycache__ directories excluded from file scans
Secrets redacted from all log excerpts and marker text before inclusion in report
Optional --output writes rescue note to the specified path only
Dependency: stdlib only (argparse, json, os, re, subprocess, sys, pathlib) — no pip installs required

# Basic rescue scan of a workspace

python3 scripts/task_rescue_blackbox.py --workspace /path/to/repo --output rescue-note.md

# Include log directory for error context

python3 scripts/task_rescue_blackbox.py --workspace /path/to/repo --log-dir /path/to/logs --output rescue-note.md

# Include specific log files

python3 scripts/task_rescue_blackbox.py --workspace /path/to/repo --log /path/to/agent.log --output rescue-note.md

# JSON output for pipeline consumption

python3 scripts/task_rescue_blackbox.py --workspace /path/to/repo --format json

Python 3.8+ (stdlib only — no pip installs)
OpenClaw v2026.3.23 or later
Git (optional — script degrades gracefully if git is unavailable or workspace is not a repo)
No API keys required