---
type: trekplan-synthetic
plan_version: "1.7"
created: 2026-05-09
task: "Add --verbose flag to CLI"
slug: verbose-flag
run_id: premium-1
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 emission cost"
  - "Document benchmark methodology in PERF.md"
---

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

This fixture is a SYNTHETIC PLACEHOLDER for empirical Jaccard calibration
that requires live LLM-budget ($60-120 for 4 plan-runs). Marked
`status: parked-synthetic` per the Step 17 escalate-handler.

## Why parked

Same rationale as `profile-plan-run-economy-1.md`. The session running
v4.1-execute-4b did not have authorization for live LLM invocation. This
fixture mirrors the existing baseline `plan-run-A.md` (40 steps, opus
granularity) since premium profile uses opus for `plan` and `review`
phases per `lib/profiles/premium.yaml`.

## Step-shape rationale

Premium profile uses opus for plan + review phases (per
`lib/profiles/premium.yaml`). Empirical observation from research/02:
opus plans tend toward finer-grained steps, more explicit verification
entries, and richer edge-case decomposition than sonnet plans. The 40
entries here capture the level of detail typical of an opus run.

## Cross-tier Jaccard pairing

Paired with `profile-plan-run-economy-1.md` and `-economy-2.md` in
`tests/integration/profile-jaccard-smoke.test.mjs` (Step 18). Expected
cross-tier Jaccard for the parked-synthetic run-pair is documented in
`profile-jaccard-calibration.md`.