Function registerCommands

packages/cli/src/cli.ts:151–852

* Registers all available commands on the program.

(program: Command)

 * Registers all available commands on the program.
 */
function registerCommands(program: Command): void {
  // Inspect command - for inspecting and displaying .deepnote file metadata
  program
    .command('inspect')
    .description('Inspect and display metadata from a .deepnote file')
    .argument('[path]', 'Path to a .deepnote file or directory (defaults to current directory)')
    .option(
      '-o, --output <format>',
      'Output format: json, toon, llm',
      createFormatValidator(OUTPUT_FORMATS, TOON_LLM_RESOLUTION)
    )
    .addHelpText('after', () => {
      const c = getChalk()
      return `
${c.bold('Output:')}
  Displays structured information about the .deepnote file including:
  - File path and project name
  - Project ID and file format version
  - Creation, modification, and export timestamps
  - Number of notebooks and total blocks
  - List of notebooks with their block counts

${getSmartFileDiscoveryHelp(c)}

${c.bold('Examples:')}
  ${c.dim('# Inspect first .deepnote file in current directory')}
  $ deepnote inspect

  ${c.dim('# Inspect a specific .deepnote file')}
  $ deepnote inspect my-project.deepnote

  ${c.dim('# Inspect first .deepnote file in a subdirectory')}
  $ deepnote inspect notebooks/

  ${c.dim('# Output as JSON for scripting')}
  $ deepnote inspect my-project.deepnote -o json

  ${c.dim('# Output as TOON for LLM consumption (30-60% fewer tokens)')}
  $ deepnote inspect my-project.deepnote -o toon

  ${c.dim('# Use with jq for specific fields')}
  $ deepnote inspect my-project.deepnote -o json | jq '.project.name'
`
    })
    .action(createInspectAction(program))

  // Cat command - display block contents from a .deepnote file
  program
    .command('cat')
    .description('Display block contents from a .deepnote file')
    .argument('<path>', 'Path to a .deepnote file')
    .option('-o, --output <format>', 'Output format: json, llm', createFormatValidator(['json'], JSON_LLM_RESOLUTION))
    .option('--notebook <name>', 'Show only blocks from the specified notebook')
    .option('--type <type>', `Filter blocks by type (${FILTERABLE_BLOCK_TYPES.join(', ')})`, createBlockTypeValidator())
    .option('--tree', 'Show structure only without block content')
    .addHelpText('after', () => {
      const c = getChalk()
      return `