{
 "schema_version": 1,
 "generated": "2026-10-20",
 "repo": "MaxHu-xuan/task-state-guard",
 "name": "task-state-guard",
 "owner": "MaxHu-xuan",
 "slug": "maxhu-xuan-task-state-guard",
 "github": "https://github.com/MaxHu-xuan/task-state-guard",
 "what": "TaskStateGuard is a Python library and CLI that reconciles stuck AI-agent task and delivery states in a local SQLite ledger.",
 "why": "",
 "language": "Python",
 "requirements": [
  "CPython 3.11 to 3.14",
  "A SQLite ledger file on a local filesystem, not a network or mapped drive",
  "A virtual environment with task-state-guard installed from PyPI"
 ],
 "audience_note": "Developers and operators running AI agents, background workers, or local workflows that need to recover task state after a restart or timeout.",
 "risk": "none",
 "section": "earlier",
 "weekly_rank": null,
 "category": "Software and DevOps",
 "url": "https://dedupedai.com/use-cases/maxhu-xuan-task-state-guard/",
 "use_case_count": 3,
 "use_cases": [
  {
   "id": "maxhu-xuan-task-state-guard--preview-restart-reconciliation-before-applying",
   "title": "Preview restart cleanup of stuck tasks before applying it",
   "best": true,
   "url": "https://dedupedai.com/use-cases/maxhu-xuan-task-state-guard/preview-restart-reconciliation-before-applying/",
   "json": "https://dedupedai.com/use-cases/u/maxhu-xuan-task-state-guard/preview-restart-reconciliation-before-applying.json"
  },
  {
   "id": "maxhu-xuan-task-state-guard--record-real-task-and-delivery-outcomes",
   "title": "Record task and delivery closures only from real outcomes",
   "best": false,
   "url": "https://dedupedai.com/use-cases/maxhu-xuan-task-state-guard/record-real-task-and-delivery-outcomes/",
   "json": "https://dedupedai.com/use-cases/u/maxhu-xuan-task-state-guard/record-real-task-and-delivery-outcomes.json"
  },
  {
   "id": "maxhu-xuan-task-state-guard--audit-workflow-ledger-health-with-doctor",
   "title": "Check a workflow ledger's health before trusting its history",
   "best": false,
   "url": "https://dedupedai.com/use-cases/maxhu-xuan-task-state-guard/audit-workflow-ledger-health-with-doctor/",
   "json": "https://dedupedai.com/use-cases/u/maxhu-xuan-task-state-guard/audit-workflow-ledger-health-with-doctor.json"
  }
 ],
 "disclaimer": "Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk."
}