Skip to main content

Module progress

Module progress 

Source
Expand description

Progress reporting helpers for long operations. Structured progress tracking.

Auto-extracts progress from tool results into DB metadata. Survives compaction. Injected into system prompt so the LLM always knows what’s been done even after context is trimmed.

§Why progress tracking exists

When compaction summarizes old messages, the model loses awareness of what files were created/modified and what steps were completed. Progress entries are stored in the DB (not in messages) and re-injected into the system prompt, providing a persistent “done” list.

§What gets tracked

  • Files created (Write tool)
  • Files modified (Edit tool)
  • Tests run and their results (Bash tool with test patterns)
  • Commands executed with exit codes

Functions§

get_progress_summary
Get the current progress summary for injection into the system prompt.
track_progress
Extract progress from a tool call and persist it.