Transcript Lake

Documentation / CLI

transcript-lake signals

Query cross-source Oko/Lake signal views.

Invocation#

sh
transcript-lake [--data-dir <path>] signals [--report <frustration|overlap|daily|freshness>] [--limit <n>] [--json]

Purpose#

Query cross-source Oko/Lake signal views.

Inputs and options#

  • --report accepts frustration, overlap, daily, or freshness; default is freshness.
  • --limit <n> keeps n rows; without it every row is returned. --json selects JSON output.
  • The selected Oko index must be available to DuckDB for these joined views.

Output and state effect#

Read-only with respect to Lake and Oko. Loads the matching signal view, attaches the Oko SQLite index, and returns every row, or the number --limit names. DuckDB may manage its own extension cache outside the Lake.

Exact refusals#

  • Unknown report: --report must be frustration, overlap, daily, or freshness.
  • --limit must be a whole number of at least one; omit it to list every row.
  • Any positional argument is refused as signals accepts flags only.
  • An unrecognized --wat is refused as unknown signals flag: --wat.
  • Repeating --json is refused as signals received duplicate --json.

All long flags are exact and single-use. A value flag never consumes another --flag. Global --data-dir may appear anywhere in the invocation, must appear once, and selects an absolute root.

Back to the complete CLI command tree.