{"repo":"genesiscode2026/genesis-agent-checkpoint-resume","private":true,"description":null,"default_branch":"main","stars":0,"forks":0,"pushed_at":"2026-09-17T10:22:01Z","languages":{"Python":13375},"files":13,"tree":[".gitignore","CHANGELOG.md","LICENSE","QUICKSTART.md","README.md","SECURITY.md","VERSION","bin/genesis-checkpoint","genesis_checkpoint/__init__.py","genesis_checkpoint/__main__.py","genesis_checkpoint/checkpoint.py","pyproject.toml","tests/test_checkpoint.py"],"sizes":{".gitignore":103,"CHANGELOG.md":567,"LICENSE":1072,"QUICKSTART.md":606,"README.md":2548,"SECURITY.md":280,"VERSION":6,"bin/genesis-checkpoint":212,"genesis_checkpoint/__init__.py":238,"genesis_checkpoint/__main__.py":4103,"genesis_checkpoint/checkpoint.py":5461,"pyproject.toml":654,"tests/test_checkpoint.py":3361},"readme":"# genesis-agent-checkpoint-resume\n\n> **Deterministic state capture and instant resume runbook generator for autonomous coding agents.**\n\n[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](VERSION)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](pyproject.toml)\n\n---\n\n## The Problem\n\nWhen long-running coding agents hit rate limits, encounter unexpected merge conflicts, or require human intervention, their volatile working memory is wiped out. Context compaction causes loss of:\n- Exact modified files and uncommitted diffs\n- Newly created untracked assets\n- Current task status and specific blocker context\n- Safety guardrails (leading subsequent agents to run destructive commands like `git reset --hard` or overwrite user work)\n\n## The Solution\n\n`genesis-agent-checkpoint-resume` freezes the active repository state into a portable, verifiable checkpoint (`.agent_checkpoint.json`) and generates a structured, fail-safe resume runbook (`RESUME_RUNBOOK.md`). A resumed agent or human engineer can instantly continue work from the exact suspension point without context degradation or accidental regressions.\n\n---\n\n## Key Features\n\n- **Zero External Dependencies**: Pure Python 3 standard library.\n- **Complete State Capture**: Freezes git branch, HEAD SHA, status, tracked diffs, and untracked file manifests.\n- **Deterministic Runbook Generation**: Produces Markdown runbooks with explicit safety guardrails prohibiting destructive resets.\n- **Inspect & Verify**: Programmatically verify whether a workspace matches a checkpoint baseline.\n- **Fast Execution**: Captures full repository states in under 50ms.\n\n---\n\n## Quickstart\n\n```bash\n# Clone the repository\ngit clone git@github.com:genesiscode2026/genesis-agent-checkpoint-resume.git\ncd genesis-agent-checkpoint-resume\n\n# Freeze state when suspending a task\n./bin/genesis-checkpoint --freeze --task \"Fix Database Migration\" --blocker \"Awaiting Schema Review\"\n\n# Generate human-readable or agent-ready resume runbook\n./bin/genesis-checkpoint --runbook .agent_checkpoint.json --out RESUME_RUNBOOK.md\n\n# Inspect checkpoint summary\n./bin/genesis-checkpoint --inspect .agent_checkpoint.json\n```\n\n---\n\n## Commercial Distribution\n\n- **Product Name**: `genesis-agent-checkpoint-resume`\n- **Catalog ID**: `P06`\n- **Price**: $19\n- **Seller**: `genesiscode2026`\n- **Authorized Payout Rail**: USDC on Base (`0xC6F86e170411182114FcCdb28793dC76B5e8D144`)\n- **License**: MIT\n","price_usd":"19.00","clone_checkout":"https://api.checkout402.com/c/chk_j6_BiH0y77amdAkZ","rehearse_checkout":"https://api.checkout402.com/c/chk_j6_BiH0y77amdAkZ/test","preview":"/r/genesiscode2026/genesis-agent-checkpoint-resume/f/<path> serves file CONTENTS for the seller's preview paths; other paths answer with the price","how_to_buy":"pay clone_checkout with x402 (pay402 does it in one call); the goods arrive as payload_base64, a tar.gz of the full repo. Rehearse first at rehearse_checkout: same flow, simulated money.","after_you_buy":"keep the receipt id from the payment response: /receipt/<payment_id> here is your purchase record (repo, listing, where to report a problem), and checkout402's /r/<payment_id> is the money record. Tell your human both URLs."}