---
type: trekplan-synthetic
plan_version: "1.7"
created: 2026-05-09
task: "Add --verbose flag to CLI"
slug: verbose-flag
run_id: economy-1
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"
  - "Document verbose changes in release notes"
---

# Synthetic plan run economy-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

Per NEXT-SESSION-PROMPT.local.md fallback: "Hvis Step 17 LLM-budget
blokkerer: dokumentér `economy`-Plan som `parked` i kalibrasjons-fil og
fortsett med Step 18-19 ved bruk av `balanced` som lavterskel-profil."

The session running v4.1-execute-4b did not have authorization for live
LLM invocation against `/trekplan --profile economy --brief
examples/01-add-verbose-flag/brief.md`. Synthetic fixtures here represent
the *shape* of what such a run would produce — a near-subset of the
`premium` plan's steps (covering the same task surface) but with ~25 %
fewer sub-verification entries (no edge-case-collision step, no security
audit step, no PII test, no benchmark, etc).

## How this fixture is consumed

`tests/integration/profile-jaccard-smoke.test.mjs` (Step 18) reads the
`steps` array from the frontmatter and pairs it with the corresponding
`premium` fixtures to compute cross-tier Jaccard.

When real LLM budget is approved (deferred to v4.2), regenerate this
fixture by running the actual command and overwriting the frontmatter
`steps` array. Update `status: parked-synthetic` → `status: empirical`.

## Step-shape rationale

Economy profile uses sonnet for all phases (per
`lib/profiles/economy.yaml`). Empirical observation from research/02:
sonnet plans tend toward fewer verification entries, fewer edge-case
branches, and slightly less granular decomposition than opus plans. The
30 entries here represent the typical "skip the marginal sub-verification"
behaviour while keeping wording aligned with what an opus run would
produce on the same brief — modeling the realistic expectation that
profile choice changes *what* steps get included more than *how* the
included ones are phrased.
