---
type: trekplan-synthetic
plan_version: "1.7"
created: 2026-05-09
task: "Add --verbose flag to CLI"
slug: verbose-flag
run_id: premium-2
profile_used: premium
status: parked-synthetic
steps:
  - "Add config entry for verbose flag in package.json"
  - "Define types for verbose mode in types.ts"
  - "Update parseArgs to recognize --verbose flag"
  - "Pass verbose context through main entry point"
  - "Add log level enum (silent, normal, verbose)"
  - "Wire log level into logger module"
  - "Replace console.log with logger.info in handler.ts"
  - "Add tests for parseArgs --verbose recognition"
  - "Add tests for log level enum mapping"
  - "Update README with --verbose flag documentation"
  - "Add CHANGELOG entry for verbose flag"
  - "Bump package.json minor version"
  - "Add lint rule blocking direct console usage"
  - "Run lint and fix new violations"
  - "Add CLI integration test for --verbose end-to-end"
  - "Add fixture file for verbose log capture"
  - "Document verbose output format in docs/cli.md"
  - "Add jsdoc for new logger API"
  - "Verify all existing tests pass with verbose disabled"
  - "Add backward-compat test for legacy quiet behavior"
  - "Add edge-case test for repeated --verbose flags"
  - "Add edge-case test for --verbose with --silent collision"
  - "Update help text to list --verbose flag"
  - "Add usage example to docs/quickstart.md"
  - "Verify CI matrix runs on Node 18 and 20"
  - "Add npm script for verbose mode debugging"
  - "Run security audit on logger dependency tree"
  - "Verify no PII leaks in verbose log output"
  - "Add manual test checklist to CONTRIBUTING.md"
  - "Update .gitignore for verbose log dump files"
  - "Add cleanup logic for stale verbose logs"
  - "Add unit test for cleanup logic"
  - "Verify exit code on verbose mode error"
  - "Add stderr routing for warnings in verbose"
  - "Add timestamp prefix in verbose log lines"
  - "Add test for timestamp format"
  - "Update troubleshooting guide with verbose flag"
  - "Verify version sync across all docs"
  - "Add benchmark for verbose log capture overhead"
  - "Document overhead methodology in PERF.md"
---

# Synthetic plan run premium-2 — Add --verbose flag to CLI (PARKED)

Companion to `profile-plan-run-premium-1.md`. Same `premium` profile,
simulated as a second run with two terminal steps replaced
(emission cost / benchmark methodology → capture overhead / overhead
methodology) to model intra-tier variance.

## Intra-tier Jaccard

Premium-1 vs premium-2 share 38/40 step titles; union = 42.
Jaccard = 38/42 ≈ 0.905 — matches the existing baseline plan-run-A vs
plan-run-B floor (≥ 0.833 in plan-determinism.test.mjs).

## Cross-tier Jaccard rationale

Pairing premium fixtures (40 steps) against economy fixtures (30 steps)
yields ~30 shared titles (after string-normalisering), with union ~40.
Conservative cross-tier Jaccard ≈ 30/40 = 0.75 in this synthetic — but
the calibration file pins a *more conservative* floor (0.55) per
research/02 to absorb empirical variance once real runs replace these
fixtures. See `profile-jaccard-calibration.md` for threshold derivation.