$ recs session --help
usage: recs session [-h] {show,quality,markers,extract,handoff,recover,recover-scan,finalize,export-midi,migrate,export}

Inspect or manage one session. Use recs sessions ROOT to list sessions.

 options
 ----------------------------------------------------------------------------------------------------------------------
  -h, --help        show this help message and exit

 subcommands
 ----------------------------------------------------------------------------------------------------------------------
  (required)
    - show          Inspect one finalized recording session.
    - quality       Report one recording document's evidence; audio decoding is opt-in.

                    Frame positions are source-local, half-open ranges, not cross-device alignment. Near-full-scale
                    advisories are not proof of clipping. No quietness verdicts.
    - markers       List numbered markers and their available source-frame evidence.
    - extract       Preview marker extraction; supply --destination to render a new session.

                    Use numbers from session markers, not labels. Select one capture clock. Without --end-marker,
                    lead/tail surround --start-marker. Durations are seconds. Historical unpositioned markers are
                    rejected, never mapped from wall time.
    - handoff       Preview aligned tracks from one sealed segment; --destination writes the bundle.

                    Frame bounds are half-open on one capture clock. No resampling or alignment between independent
                    clocks is inferred. Output is 32-bit float WAV plus JSON.
    - recover       Preview recovery of a stopped version 5 capture; --destination creates a copy.

                    Audio is fully decoded for verification. Unfinished readable audio is retained as unplaced assets,
                    not aligned tracks. No original files are changed.
    - recover-scan  Discover unfinished session records below ROOT once.
    - finalize
    - export-midi
    - migrate
    - export


$ recs session export --help
usage: recs session export [-h] PATH PATH [--resume {None}|PATH] [--asset-policy {None}|PATH]

Copy a recording and its continuations into a portable directory.

 positional arguments
 ------------------------------------------------------------------------------------------------
  PATH        record (required)
  PATH        destination (required)

 options
 ------------------------------------------------------------------------------------------------
  -h, --help  show this help message and exit
  --resume {None}|PATH
              Resume the reported staging directory after an interrupted export. (default: None)
  --asset-policy {None}|PATH
              Host policy for finite recording assets (default: None)


$ recs session export-midi --help
usage: recs session export-midi [-h] PATH STR PATH

 positional arguments
 ---------------------------------------------
  PATH        recording (required)
  STR         source (required)
  PATH        destination (required)

 options
 ---------------------------------------------
  -h, --help  show this help message and exit


$ recs session extract --help
usage: recs session extract [-h] [OPTIONS] PATH

Preview marker extraction; supply --destination to render a new session.

Use numbers from session markers, not labels. Select one capture clock. Without --end-marker, lead/tail surround --start-marker. Durations are seconds. Historical unpositioned markers are rejected, never mapped from wall time.

 positional arguments
 ---------------------------------------------------------------------------------------------------
  PATH          path (required)

 options
 ---------------------------------------------------------------------------------------------------
  -h, --help    show this help message and exit
  --clock STR   (required)
  --start-marker INT
                (required)
  --end-marker {None}|INT
                (default: None)
  --lead FLOAT  (default: 0)
  --tail FLOAT  (default: 0)
  --tracks [STR [STR ...]]
                Exact stream IDs on the selected clock; default: all its audio streams. (default: )
  --destination {None}|PATH
                (default: None)
  --json, --no-json
                (default: False)


$ recs session finalize --help
usage: recs session finalize [-h] PATH

 positional arguments
 ---------------------------------------------
  PATH        session (required)

 options
 ---------------------------------------------
  -h, --help  show this help message and exit


$ recs session handoff --help
usage: recs session handoff [-h] [OPTIONS] PATH

Preview aligned tracks from one sealed segment; --destination writes the bundle.

Frame bounds are half-open on one capture clock. No resampling or alignment between independent clocks is inferred. Output is 32-bit float WAV plus JSON.

 positional arguments
 --------------------------------------------------------------------------------------------------
  PATH             path (required)

 options
 --------------------------------------------------------------------------------------------------
  -h, --help       show this help message and exit
  --clock STR      (required)
  --start-frame INT
                   (required)
  --end-frame INT  (required)
  --tracks [STR [STR ...]]
                   Exact stream IDs; default: all audio streams on the selected clock. (default: )
  --destination {None}|PATH
                   (default: None)


$ recs session markers --help
usage: recs session markers [-h] PATH [--json | --no-json]

List numbered markers and their available source-frame evidence.

 positional arguments
 ----------------------------------------------------
  PATH               path (required)

 options
 ----------------------------------------------------
  -h, --help         show this help message and exit
  --json, --no-json  (default: False)


$ recs session migrate --help
usage: recs session migrate [-h] PATH [--paths-relative-to {None}|PATH]

 positional arguments
 ---------------------------------------------
  PATH        session (required)

 options
 ---------------------------------------------
  -h, --help  show this help message and exit
  --paths-relative-to {None}|PATH
              (default: None)


$ recs session quality --help
usage: recs session quality [-h] [OPTIONS] PATH

Report one recording document's evidence; audio decoding is opt-in.

Frame positions are source-local, half-open ranges, not cross-device alignment. Near-full-scale advisories are not proof of clipping. No quietness verdicts.

 positional arguments
 --------------------------------------------------------------------------------------------------------
  PATH               path (required)

 options
 --------------------------------------------------------------------------------------------------------
  -h, --help         show this help message and exit
  --json, --no-json  (default: False)
  --analyze-audio, --no-analyze-audio
                     (default: False)

 analysis options
 --------------------------------------------------------------------------------------------------------
  Limits apply independently to each fragment and its channels.
  --------------------------------------------------------------------------------------------------------
  --analysis.near-full-scale-dbfs FLOAT
                     Advisory threshold for absolute sample amplitude, in dBFS. (default: -0.1)
  --analysis.max-seconds FLOAT
                     Analyze at most this prefix of each fragment, in seconds. (default: 60)
  --analysis.max-runs INT
                     Retain at most this many run ranges per channel; count omitted runs. (default: 100)


$ recs session recover --help
usage: recs session recover [-h] PATH [--destination {None}|PATH] [--json | --no-json]

Preview recovery of a stopped version 5 capture; --destination creates a copy.

Audio is fully decoded for verification. Unfinished readable audio is retained as unplaced assets, not aligned tracks. No original files are changed.

 positional arguments
 ---------------------------------------------
  PATH        path (required)

 options
 ---------------------------------------------
  -h, --help  show this help message and exit
  --destination {None}|PATH
              (default: None)
  --json, --no-json
              (default: False)


$ recs session recover-scan --help
usage: recs session recover-scan [-h] PATH

Discover unfinished session records below ROOT once.

 positional arguments
 ---------------------------------------------
  PATH        root (required)

 options
 ---------------------------------------------
  -h, --help  show this help message and exit


$ recs session show --help
usage: recs session show [-h] PATH [--json | --no-json]

Inspect one finalized recording session.

 positional arguments
 ----------------------------------------------------
  PATH               path (required)

 options
 ----------------------------------------------------
  -h, --help         show this help message and exit
  --json, --no-json  (default: False)
