a0_software_orchestrator/prompts/agent.system.tool.block_compactor.md

block_compactor

Persist a compact block summary for resume/recovery using the plugin DB-backed state flow.

Use this exact Agent Zero tool-call shape:

{"tool_name":"block_compactor","tool_args":{"project_name":"my_project","block_id":"T012","block_summary":"what changed","next_block":"continue with tests","force":false}}

Required args:

• project_name (str): Projektname
• block_id (str): Block identifier, e.g. 'T012', 'B-requirements-v1'
• block_summary (str): What was done in this block (non-empty)
• next_block (str): What comes next (default: "see next_steps.md")

Optional args:

• force (bool): Override context-ratio threshold block (NOT preconditions)
• decisions, open_questions, key_findings (list): Optional metadata
• estimated_context_tokens, max_context_tokens (int): For ratio check

Preconditions (must be met before compact):

• Pending next_steps must exist (orch_next_steps non-empty)
• Context ratio must be >= 0.80 (use force=true to override threshold only)

Rules:
- Do not use this tool to discover, read, infer, validate, or print credential values.
- If the tool is not found, stop and report a runtime tool-registration failure. Do not switch to WebUI login, CSRF, HTTP cache-refresh, shell credential scans, or `.env`/config/log searches.