roadmap-runtime

What problem does it solve?

Shared roadmap artifacts, checkpoints, and learning logs can become inconsistent, large, and unwieldy across multi-item feature execution; roadmap-runtime provides deterministic models, checkpoint lifecycle management, and progressive learning-log handling to keep execution resumable and auditable.

Core Features & Use Cases

• Checkpoint management: create, save, load, advance phases, mark completions and failures with idempotent resume semantics and dependency propagation.
• Bounded context assembly: assemble only the artifacts and recent learning entries needed for the current item, keeping context size O(k).
• Learning-log helpers: read/write per-item entries, update a compact index, and compact older entries into an archive while preserving active items.
• Sanitization & validation: redact sensitive fields, detect potential secrets, and optionally validate artifacts against JSON Schemas.
• Use Case: resume a paused roadmap execution, advance to the next ready item, record outcomes in learning logs, and sanitize persisted state for coordinator storage.

Quick Start

Import the roadmap-runtime helpers and call assemble_context with your workspace path to build the execution context for the current checkpoint item.