Function printHelp

scripts/export-deepseek-session-traces.ts:80–102

()

const OUTPUT_DATASET_NAME = 'freebuff_data'

function printHelp() {
  console.log(`Export reconstructed multi-turn DeepSeek V4 free-mode sessions.

Usage:
  bun scripts/export-deepseek-session-traces.ts [options]

Options:
  --prod                  Use codebuff_data instead of codebuff_data_dev.
  --sessions-per-agent n  Sessions to export per target agent. Default: 1.
  --total-sessions n      Export n sessions total across DeepSeek Pro and Flash, newest first.
  --sample-mode mode      With --total-sessions: newest, random, or even. Default: newest.
  --lookback-days n       Days to scan before the before-days cutoff. Default: 60.
  --before-days n         Exclude rows newer than this many days. Default: 3.
  --start-date date       Inclusive UTC date/time lower bound, e.g. 2026-05-12.
  --end-date date         Exclusive UTC date/time upper bound, e.g. 2026-05-16.
  --min-messages n        Minimum messages in representative request. Default: 10.
  --client-id id          Export one known client session id.
  --out path              Output JSON path. Default: .context/deepseek-session-traces.json.
  --trace-dir path        Directory for separate trace files. Default: <out-dir>/deepseek-session-traces.
  --skip-aggregate        Only write separate trace files, not the combined JSON.
  --help                  Show this message.
`)
}

function readNumberFlag(
  argv: string[],