Add tags to a stored run

Adds mutable metadata tags to a run in a ledgr experiment store. Tags do not alter run identity hashes, stored artifacts, comparison semantics, or strategy provenance. Re-adding an existing tag is idempotent.

Usage

ledgr_run_tag(snapshot, run_id, tags)

Arguments

snapshot

A sealed ledgr_snapshot object. Use ledgr_snapshot_load(db_path, snapshot_id) to resume from a durable DuckDB file in a new R session.

run_id

Run identifier.

tags

Character vector of tags. Tags are trimmed, deduplicated, and must not contain commas or control characters.

Value

The input ledgr_snapshot, invisibly.

Examples

bars <- subset(ledgr_demo_bars, instrument_id == "DEMO_01")
snapshot <- ledgr_snapshot_from_df(utils::head(bars, 10))
strategy <- function(ctx, params) ctx$flat()
exp <- ledgr_experiment(snapshot, strategy, opening = ledgr_opening(cash = 1000))
bt <- ledgr_run(exp, params = list(), run_id = "flat")
ledgr_run_tag(snapshot, bt$run_id, c("baseline", "demo"))
ledgr_run_tags(snapshot, bt$run_id)
#> # A tibble: 2 × 3
#>   run_id tag      created_at_utc      
#>   <chr>  <chr>    <chr>               
#> 1 flat   baseline 2026-05-15T16:20:35Z
#> 2 flat   demo     2026-05-15T16:20:35Z
close(bt)
ledgr_snapshot_close(snapshot)