Skip to content

Rename optimize analyzers to product names + positional args (v0.3.1)#75

Merged
anilmurty merged 1 commit into
mainfrom
fix/optimize-cli-naming-0.3.1
May 29, 2026
Merged

Rename optimize analyzers to product names + positional args (v0.3.1)#75
anilmurty merged 1 commit into
mainfrom
fix/optimize-cli-naming-0.3.1

Conversation

@anilmurty
Copy link
Copy Markdown
Contributor

Closes #74.

Summary

  • Drop `--finding` flag; accept analyzer names as positional args
    • `tj optimize` — run all (unchanged)
    • `tj optimize downsize` — run one
    • `tj optimize downsize cache trim` — run several
  • Rename registration strings to match the product names users see in docs / the website / `docs/optimize/*.md`:
    old new product page
    `model-downgrade` `downsize` downsize.md
    `cache-efficacy` `cache` cache.md
    `workflow-restructure` `script` script.md
    `prompt-bloat` `trim` trim.md
  • Rename `tj report --bloat` → `tj report --trim`
  • Bump version to `0.3.1`

`cache-recommend` (sub-finding) and `budget-projection` (infra concept) keep their names. No back-compat aliases — we have zero external users on 0.3.0.

Honesty discipline preserved: `MODEL_DOWNGRADE_CAVEAT` constant stays (internal symbol). All "structural match — review before applying" framing unchanged.

Test plan

  • 575 tests green (unit + synthetic + agents + integration)
  • `tj optimize --help` lists the new names in the positional argument
  • `tj optimize downsize --since 7d` runs Downsize only
  • `tj optimize downsize cache` runs both
  • `tj optimize foo` errors with a list of valid names (Click's default)
  • `tj report --trim` works
  • Smoke-test `tj optimize --export-config claude-code` snippet (deferred to merger)

🤖 Generated with Claude Code

Drops the `--finding NAME` flag and accepts analyzer names as positional
arguments — `tj optimize downsize` instead of
`tj optimize --finding model-downgrade`. Renames the analyzer
registration strings to match the user-facing product names used in
docs, the website, and `docs/optimize/*.md`:

  model-downgrade      → downsize
  cache-efficacy       → cache
  workflow-restructure → script
  prompt-bloat         → trim

`cache-recommend` and `budget-projection` keep their names (sub-finding
and infra concept respectively, neither has a product page).

`tj report --bloat` becomes `tj report --trim` for the same reason —
"bloat" doesn't appear in any user-facing surface.

No back-compat aliases. We have zero external users on 0.3.0; renaming
is free.

Honesty discipline preserved: MODEL_DOWNGRADE_CAVEAT constant stays put
(it's an internal symbol, not a CLI surface); all "structural match —
review before applying" framing is unchanged. This is a CLI rename
only — no behavior or rendering changes.

Bumps version to 0.3.1.

Closes #74.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@anilmurty anilmurty merged commit af4a46f into main May 29, 2026
4 checks passed
@anilmurty anilmurty deleted the fix/optimize-cli-naming-0.3.1 branch May 29, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

tj optimize: rename analyzers to product names + accept positional args

1 participant