---
type: trekplan-synthetic
plan_version: "1.7"
created: 2026-05-09
task: "Add --verbose flag to CLI"
slug: verbose-flag
run_id: economy-2
profile_used: economy
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"
  - "Update help text to list --verbose flag"
  - "Add usage example to docs/quickstart.md"
  - "Verify CI matrix runs on Node 18 and 20"
  - "Update .gitignore for verbose log dump files"
  - "Add cleanup logic for stale verbose logs"
  - "Verify exit code on verbose mode error"
  - "Add stderr routing for warnings in verbose"
  - "Update troubleshooting guide with verbose flag"
  - "Verify version sync across all docs"
  - "Add timestamp prefix in verbose log lines"
---

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

Companion fixture to `profile-plan-run-economy-1.md`. Same `economy`
profile, simulated as a second run of the same brief, with the final
step replaced (release notes → timestamp prefix) to model intra-tier
variance.

See `profile-plan-run-economy-1.md` for full parked-synthetic rationale.

## Intra-tier Jaccard

Economy-1 vs economy-2 share 29/30 step titles (final step differs);
union = 31. Jaccard = 29/31 ≈ 0.935 — well above any reasonable
cross-tier floor. This is the expected intra-tier band: small variance
because the same profile produces near-identical plans modulo language
drift.

When real LLM-budget runs replace this synthetic, the empirical
intra-tier Jaccard is expected to land in the 0.85–0.95 band per
research/02. Cross-tier (economy vs premium) is the discriminating
measurement and is documented in `profile-jaccard-calibration.md`.
