Select temporary debug directory default
This commit is contained in:
@@ -645,30 +645,31 @@ retains the bookkeeping boundary; U9 still owns concrete durable record choices.
|
|||||||
|
|
||||||
**Discussion / decision:** Controls, native capture hooks, lifecycle, failure
|
**Discussion / decision:** Controls, native capture hooks, lifecycle, failure
|
||||||
policy, and optional diagnostics agreed. Use `--debug` for native verbosity and
|
policy, and optional diagnostics agreed. Use `--debug` for native verbosity and
|
||||||
conditional durable capture. The default-directory policy is reopened; removing
|
durable capture with `/tmp/notarius-debug` as the default root. Operator-owned
|
||||||
the existing default is not an agreed requirement. Operator-owned data handling
|
data handling and recording each fact once are agreed. The summary/trace
|
||||||
and recording each fact once are agreed. The summary/trace distinction, concrete
|
distinction, concrete capture inventory, and bundle organization remain under
|
||||||
capture inventory, and bundle organization remain under discussion.
|
discussion. Implementation is pending.
|
||||||
Implementation is pending.
|
|
||||||
|
|
||||||
### Shared Debug Control With Conditional Capture
|
### Shared Debug Control With Conditional Capture
|
||||||
|
|
||||||
Attach a native application boolean binding to CommandKit's shared `--debug`
|
Attach a native application boolean binding to CommandKit's shared `--debug`
|
||||||
option on the pipeline run command. Capture is enabled when that boolean is true
|
option on the pipeline run command. Capture is enabled when that boolean is true
|
||||||
and an effective debug directory is available. `--debug-dir PATH` overrides
|
and an effective debug directory is available. `--debug-dir PATH` overrides
|
||||||
`debug.directory` in application configuration, which may have an application
|
`debug.directory` in application configuration, whose default is
|
||||||
default. A directory alone does not enable capture. Do not add a separate
|
`/tmp/notarius-debug`. A directory alone does not enable capture. Do not add a
|
||||||
`--capture-debug` flag.
|
separate `--capture-debug` flag.
|
||||||
|
|
||||||
**Default-directory discussion:** The earlier removal of the implicit
|
**Default-directory decision:** Use the absolute root `/tmp/notarius-debug`,
|
||||||
`./notarius-debug` default was an inference, not a user-selected requirement;
|
with each run's bundle beneath it. Temporary diagnostic output belongs under
|
||||||
withdraw it. A default destination is compatible with the design. With a default,
|
`/tmp` or an operator-selected location under `/var`, rather than beside a
|
||||||
`--debug` ordinarily enables both verbosity and capture without an explicit path.
|
configuration file likely to live under `/etc`. Replace the old configuration-
|
||||||
The existing destination is relative to the selected main configuration file;
|
relative `./notarius-debug` default. Precedence is CLI override, configured value,
|
||||||
explicit CLI paths are relative to the invocation directory. Decide the default
|
then application default. Explicit relative configuration paths retain their
|
||||||
and whether there is a useful explicit way to select no capture destination
|
source-relative interpretation; relative CLI paths use the invocation directory.
|
||||||
before finalizing absent/empty-value behavior. Do not assume omission of a CLI or
|
|
||||||
configuration key means there is no effective destination.
|
Omitting both directory overrides selects the default, so `--debug` enables
|
||||||
|
verbosity and capture without requiring a path. Detailed explicit-empty handling
|
||||||
|
and any demonstrated need for verbosity without capture remain separate choices.
|
||||||
|
|
||||||
Determine capture from the application boolean and destination, not from
|
Determine capture from the application boolean and destination, not from
|
||||||
`Invocation.ReportingMode()`. A later quiet or verbose selection can change
|
`Invocation.ReportingMode()`. A later quiet or verbose selection can change
|
||||||
@@ -677,14 +678,11 @@ native boolean binding semantics and disables capture.
|
|||||||
|
|
||||||
| Invocation flags | Reporting selection | Capture |
|
| Invocation flags | Reporting selection | Capture |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| `--debug`, no effective directory | Debug | None. |
|
| No `--debug`, with any directory selection | Selected native mode | None. |
|
||||||
| `--debug`, effective directory from CLI/configuration/default | Debug | Enabled. |
|
| `--debug`, no directory override | Debug | Enabled under `/tmp/notarius-debug`. |
|
||||||
| `--debug --quiet`, no effective directory | Quiet | None. |
|
| `--debug`, with a directory override | Debug | Enabled under the selected root. |
|
||||||
| `--debug --quiet`, effective directory from CLI/configuration/default | Quiet | Enabled. |
|
| `--debug --quiet`, with any directory selection | Quiet | Enabled. |
|
||||||
| `--quiet --debug`, effective directory from CLI/configuration/default | Debug | Enabled. |
|
| `--quiet --debug`, with any directory selection | Debug | Enabled. |
|
||||||
|
|
||||||
The no-effective-directory rows apply only if the final directory policy allows
|
|
||||||
that state; with a default, omission alone does not select it.
|
|
||||||
|
|
||||||
**Upstream ordering clarification:** CommandKit uses the last enabled reporting
|
**Upstream ordering clarification:** CommandKit uses the last enabled reporting
|
||||||
mode. Thus `--debug --quiet` suppresses command output while retaining capture;
|
mode. Thus `--debug --quiet` suppresses command output while retaining capture;
|
||||||
|
|||||||
Reference in New Issue
Block a user