Enum HistoryCommand 

pub enum HistoryCommand {
    List {
        outcome: Option<OutcomeArg>,
        limit: i64,
        offset: i64,
        output: OutputFormat,
    },
    Show {
        run_id: i64,
        output: OutputFormat,
    },
    Revert {
        run_id: i64,
        bridge_host: Option<String>,
        server: Option<String>,
        yes: bool,
        output: OutputFormat,
    },
    Prune {
        older_than_days: Option<u32>,
        dry_run: bool,
        output: OutputFormat,
    },
}

Variants

List

List past runs, newest first.

Fields

outcome: Option<OutcomeArg>

limit: i64

offset: i64

output: OutputFormat

How to print the run list.

Show

Show one run’s full detail: config, initial readings, calculated results, and any PID write-back audit rows.

Fields

run_id: i64

output: OutputFormat

How to print the run detail.

Revert

Undo a run’s PID write-back, writing its recorded pre-write P/I/D values back to the live loop. Reverts whichever write-kind write-back that run last recorded; refuses if the run has none, if that write-back’s pre-read itself failed (nothing to revert to), or if the run did not use the opcda driver (nothing live to revert against).

Fields

run_id: i64

bridge_host: Option<String>

Cross-checked against the run’s own recorded bridge host – never used to resolve a default, and deliberately has no BHTUNE_BRIDGE_HOST/config fallback the way every other command’s --bridge-host does, so an unrelated ambient env var can never silently affect which gateway a revert targets. Omit this to use the recorded value; a value that contradicts it is refused rather than preferred, so a revert can never target a different gateway than the run it is undoing actually used (db-run-request-snapshot).

server: Option<String>

Cross-checked against the run’s own recorded OPC server – never used to resolve a default. Omit this to use the recorded value; a value that contradicts it is refused rather than preferred, so a revert can never target a different server than the run it is undoing actually used (db-run-request-snapshot).

yes: bool

Confirm writing to a live loop. Required – there is no interactive prompt for reverting, since there is no calculated result to choose between as there is for tune’s own write-back step.

output: OutputFormat

How to print the revert outcome.

Prune

Delete runs older than the configured retention policy (history-retention), without waiting for the next automatic startup sweep.

Fields

older_than_days: Option<u32>

Delete runs older than this many days, overriding the configured retention_days policy for this invocation only. Required if no retention policy is configured at all (--retention-days / BHTUNE_RETENTION_DAYS / the config file’s retention_days key) – there is no default “prune everything older than X” to fall back to.

dry_run: bool

Report how many runs would be deleted, and as of what cutoff, without deleting anything.

output: OutputFormat

How to print the prune outcome.

Trait Implementations

impl Debug for HistoryCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for HistoryCommand

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for HistoryCommand

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand