feat: replace --verbose/--quiet with --log-level (-l)

Use syslog-style severity levels inspired by @transloadit/sev-logger:
- err (3): Error conditions
- warn (4): Warning conditions
- notice (5): Normal but significant (default)
- info (6): Informational messages
- debug (7): Debug-level messages

Example: `npx transloadit assemblies list -l debug`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: kvz

README.md

@@ -167,17 +167,30 @@ echo '{"workspace":"my-workspace","template":"my-template","input":"image.jpg"}'
 All commands support these common options:
 
 - `--json, -j` - Output results as JSON (useful for scripting)
-- `--verbose, -v` - Enable debug output (shows DEBUG messages in addition to INFO/WARNING/ERROR)
-- `--quiet, -q` - Suppress non-essential output (only shows ERROR messages, hides INFO and WARNING)
+- `--log-level, -l` - Set log verbosity level (default: notice)
 - `--help, -h` - Show help for a command
 
-Output levels:
+#### Log Levels
 
-| Flag        | ERROR | WARNING | INFO | DEBUG |
-| ----------- | ----- | ------- | ---- | ----- |
-| `--quiet`   | ✓     |         |      |       |
-| _(default)_ | ✓     | ✓       | ✓    |       |
-| `--verbose` | ✓     | ✓       | ✓    | ✓     |
+The CLI uses [syslog severity levels](https://en.wikipedia.org/wiki/Syslog#Severity_level). Lower = more severe, higher = more verbose:
+
+| Level    | Value | Description                           |
+| -------- | ----- | ------------------------------------- |
+| `err`    | 3     | Error conditions                      |
+| `warn`   | 4     | Warning conditions                    |
+| `notice` | 5     | Normal but significant **(default)**  |
+| `info`   | 6     | Informational messages                |
+| `debug`  | 7     | Debug-level messages                  |
+
+Examples:
+
+```bash
+# Show only errors and warnings
+npx transloadit assemblies list -l warn
+
+# Show debug output
+npx transloadit assemblies list -l debug
+```
 
 ## SDK Usage
 

src/cli/OutputCtl.ts

@@ -1,22 +1,54 @@
+/**
+ * Log levels following syslog severity (https://en.wikipedia.org/wiki/Syslog#Severity_level)
+ * Lower numbers = more severe, higher numbers = more verbose
+ */
+export const LOG_LEVEL = {
+  ERR: 3, // Error conditions
+  WARN: 4, // Warning conditions
+  NOTICE: 5, // Normal but significant (default)
+  INFO: 6, // Informational
+  DEBUG: 7, // Debug-level messages
+} as const
+
+export type LogLevelName = keyof typeof LOG_LEVEL
+export type LogLevelValue = (typeof LOG_LEVEL)[LogLevelName]
+
+export const LOG_LEVEL_DEFAULT: LogLevelValue = LOG_LEVEL.NOTICE
+
+/** Valid log level names for CLI parsing */
+export const LOG_LEVEL_NAMES = Object.keys(LOG_LEVEL).map((k) => k.toLowerCase()) as Lowercase<
+  LogLevelName
+>[]
+
+/** Parse a log level string to its numeric value */
+export function parseLogLevel(level: string): LogLevelValue {
+  const upper = level.toUpperCase() as LogLevelName
+  if (upper in LOG_LEVEL) {
+    return LOG_LEVEL[upper]
+  }
+  throw new Error(`Invalid log level: ${level}. Valid levels: ${LOG_LEVEL_NAMES.join(', ')}`)
+}
+
 export interface OutputCtlOptions {
-  logLevel?: number
+  logLevel?: LogLevelValue
   jsonMode?: boolean
 }
 
 /** Interface for output controllers (used to allow test mocks) */
 export interface IOutputCtl {
   error(msg: unknown): void
   warn(msg: unknown): void
+  notice(msg: unknown): void
   info(msg: unknown): void
   debug(msg: unknown): void
   print(simple: unknown, json: unknown): void
 }
 
 export default class OutputCtl implements IOutputCtl {
   private json: boolean
-  private logLevel: number
+  private logLevel: LogLevelValue
 
-  constructor({ logLevel = 0, jsonMode = false }: OutputCtlOptions = {}) {
+  constructor({ logLevel = LOG_LEVEL_DEFAULT, jsonMode = false }: OutputCtlOptions = {}) {
     this.json = jsonMode
     this.logLevel = logLevel
 
@@ -33,19 +65,23 @@ export default class OutputCtl implements IOutputCtl {
   }
 
   error(msg: unknown): void {
-    console.error('ERROR  ', msg)
+    if (this.logLevel >= LOG_LEVEL.ERR) console.error('err    ', msg)
   }
 
   warn(msg: unknown): void {
-    if (this.logLevel > 0) console.error('WARNING', msg)
+    if (this.logLevel >= LOG_LEVEL.WARN) console.error('warn   ', msg)
+  }
+
+  notice(msg: unknown): void {
+    if (this.logLevel >= LOG_LEVEL.NOTICE) console.error('notice ', msg)
   }
 
   info(msg: unknown): void {
-    if (this.logLevel > 0) console.error('INFO   ', msg)
+    if (this.logLevel >= LOG_LEVEL.INFO) console.error('info   ', msg)
   }
 
   debug(msg: unknown): void {
-    if (this.logLevel > 1) console.error('DEBUG  ', msg)
+    if (this.logLevel >= LOG_LEVEL.DEBUG) console.error('debug  ', msg)
   }
 
   print(simple: unknown, json: unknown): void {

src/cli/commands/BaseCommand.ts

@@ -2,15 +2,16 @@ import process from 'node:process'
 import { Command, Option } from 'clipanion'
 import 'dotenv/config'
 import { Transloadit as TransloaditClient } from '../../Transloadit.ts'
-import OutputCtl, { type IOutputCtl } from '../OutputCtl.ts'
+import OutputCtl, {
+  type IOutputCtl,
+  LOG_LEVEL_DEFAULT,
+  LOG_LEVEL_NAMES,
+  parseLogLevel,
+} from '../OutputCtl.ts'
 
 export abstract class BaseCommand extends Command {
-  verbose = Option.Boolean('-v,--verbose', false, {
-    description: 'Enable debug output',
-  })
-
-  quiet = Option.Boolean('-q,--quiet', false, {
-    description: 'Disable warnings',
+  logLevelOption = Option.String('-l,--log-level', {
+    description: `Log level: ${LOG_LEVEL_NAMES.join(', ')} (default: notice)`,
   })
 
   json = Option.Boolean('-j,--json', false, {
@@ -20,15 +21,10 @@ export abstract class BaseCommand extends Command {
   protected output!: IOutputCtl
   protected client!: TransloaditClient
 
-  protected get logLevel(): number {
-    if (this.verbose) return 2
-    if (this.quiet) return 0
-    return 1
-  }
-
   protected setupOutput(): void {
+    const logLevel = this.logLevelOption ? parseLogLevel(this.logLevelOption) : LOG_LEVEL_DEFAULT
     this.output = new OutputCtl({
-      logLevel: this.logLevel,
+      logLevel,
       jsonMode: this.json,
     })
   }

test/e2e/cli/OutputCtl.ts

@@ -1,7 +1,8 @@
-import type { OutputCtlOptions } from '../../../src/cli/OutputCtl.ts'
+import type { LogLevelValue, OutputCtlOptions } from '../../../src/cli/OutputCtl.ts'
+import { LOG_LEVEL_DEFAULT } from '../../../src/cli/OutputCtl.ts'
 
 interface OutputEntry {
-  type: 'error' | 'warn' | 'info' | 'debug' | 'print'
+  type: 'error' | 'warn' | 'notice' | 'info' | 'debug' | 'print'
   msg: unknown
   json?: unknown
 }
@@ -14,9 +15,9 @@ export default class OutputCtl {
   private output: OutputEntry[]
   // These properties are required by the src/cli/OutputCtl interface but not used in tests
   private json: boolean
-  private logLevel: number
+  private logLevel: LogLevelValue
 
-  constructor({ logLevel = 0, jsonMode = false }: OutputCtlOptions = {}) {
+  constructor({ logLevel = LOG_LEVEL_DEFAULT, jsonMode = false }: OutputCtlOptions = {}) {
     this.output = []
     this.json = jsonMode
     this.logLevel = logLevel
@@ -30,6 +31,10 @@ export default class OutputCtl {
     this.output.push({ type: 'warn', msg })
   }
 
+  notice(msg: unknown): void {
+    this.output.push({ type: 'notice', msg })
+  }
+
   info(msg: unknown): void {
     this.output.push({ type: 'info', msg })
   }