Report live correction progress through CommandKit

This commit is contained in:
2026-11-16 15:12:06 +00:00
parent 891d4aac2c
commit 11f314d995
14 changed files with 289 additions and 11 deletions

View File

@@ -17,6 +17,17 @@ history to the selected repair provider. A provider rejection ends that branch
as unavailable; other approved edits can still be applied. See
[configuration](config.md#settings) for the attempt budget and profile selection.
## Configuration trust
Treat the selected main file, imports, overlay, and automatically loaded
glossary and prompt companions as one trusted bundle. Choose the working
directory deliberately when using automatic discovery. A bundle can select
the provider, prompt content, and local files consumed by processing. Review
these sources before running with sensitive transcript data. Native inspection
describes the loaded configuration and resources. Processing readiness also
depends on the profiles and glossaries selected by the pipeline. See
[configuration loading](config.md#loading-and-composition) for discovery rules.
## Outputs and lifecycle
Reporting is enabled by default. For transcript file output, `errors.yml`,
@@ -37,6 +48,8 @@ delivery failure while preserving the new destination. Parent directories for
required outputs must already exist. Publication uses the destinations resolved
during preparation. Give concurrent invocations separate destinations, and
choose separate report directories when retaining reports from multiple runs.
The caller owns these directories and their retention. Later runs can replace
ordinary report files at the same destination.
Enabled reports are initialized as `in_progress` before processing. The
transcript is published before final reports; the files do not form a single
@@ -49,6 +62,13 @@ the reader. If failed reports cannot be rendered, available report evidence
remains. An uncatchable termination can leave `in_progress` evidence. Use the
exit status and report status to determine the outcome.
## Live progress
Use `--progress` to follow stage, chunk, proposal, validation, and repair
activity on stderr. Report and transcript files provide the retained outcome.
Debug mode enables live progress by default. Use `--progress=false` to keep
debug evidence with progress disabled.
## Debug evidence
The shared `--debug` flag enables retained artifacts in a run directory beneath