diff --git a/docs/roadmap/commandkit.md b/docs/roadmap/commandkit.md index d343988..2684107 100644 --- a/docs/roadmap/commandkit.md +++ b/docs/roadmap/commandkit.md @@ -245,6 +245,19 @@ verbose/debug; progress requires `--progress` or debug. Quiet suppresses success results and progress while preserving failures. Material conditions also appear in the result, independent of diagnostic visibility. +Emit Progress for stage transitions and useful finer-grained activity, including +download starts/completions, individual speaker and artifact completions, and +reuse of prior work. These events are available with `--progress` alone and use +native streamed, unprefixed lines. Info supplies context: selected sources, +destinations, configuration, and reasons for decisions. For example, downloading +a speaker's audio is Progress; identifying the selected audio source is Info. + +Keep the categories independent. `--verbose` enables informational messages and +warnings without enabling progress; `--progress` enables progress without +enabling informational messages or warnings. With both flags, stderr carries +both categories while stdout retains the final report. Do not introduce a +separate verbose-progress level or require both flags for finer-grained events. + Keep downstream streams in existing captured logs and provide concise console context and log locations without automatic replay. Quiet does not disable logs or persistence; debug does not automatically enable downstream debug artifacts. @@ -301,9 +314,10 @@ These work areas describe scope, not mandatory buildable milestones. execution, add party-file selection, and remove the same-campaign diff restriction. Keep each comparison side independent and acquisition lazy. 4. **Integrate presentation and lifecycle.** Define domain report values, route - diagnostics through CommandKit, and replace ad hoc status handling. Propagate - signal cancellation and adapt runner failure/finalization paths to preserve - partial results and attempt terminal persistence. Add native completion. + diagnostics and finer-grained progress through CommandKit, and replace ad hoc + status handling. Propagate signal cancellation and adapt runner + failure/finalization paths to preserve partial results and attempt terminal + persistence. Add native completion. 5. **Complete integration and migration.** Update behavioral tests, remove obsolete CLI machinery and expectations, review dependency attribution, and update canonical documentation, examples, and affected scripts with the @@ -326,9 +340,12 @@ the integration risks without duplicating upstream parser/configuration tests: runtime state. Party selection reaches each consumer, and diff sides remain independent. App-only and aggregate override behavior follows ckconfig. - Structured results remain separate from diagnostics, retain meaningful partial - work, and use native outcomes. Lazy commands avoid configuration/services; - cancellation reaches active work, preserves checkpoints, and permits terminal - persistence and lock release, including their failure reporting. + work, and use native outcomes. Representative finer-grained progress events + appear with `--progress` alone; informational context follows verbose mode, + and combining the flags exposes both without changing stdout reports. +- Lazy commands avoid configuration/services; cancellation reaches active work, + preserves checkpoints, and permits terminal persistence and lock release, + including their failure reporting. - Existing consequential stage, resume, publication, restore, and cleanup behavior remains protected. Safe inspection, diagnostics, and persistence preserve the established secret-handling boundary.