cleanup: prune stale CLI contracts and documentation #316

New issue

Closed

opened 2026-05-11 19:19:50 +00:00 by barrettruth · 0 comments

barrettruth commented

2026-05-11 19:19:50 +00:00

Owner

Parent: #305
Related: #133

Problem

The CLI still documents or accepts some surfaces that do not match the current core model. Examples found during the scan include priority task flags/filters and import documentation for formats that are not implemented by cli/src/import.ts.

Solution

Make the CLI contract match the reduced product:

audit cli/src/task.ts, cli/src/lib/filters.ts, generated completions, and cli/man/delta.1.md
remove flags, filters, examples, and docs for fields or imports that do not exist
regenerate cli/man/delta.1 after markdown changes
leave broader CLI parity work under #133, but close this issue with the stale-contract cleanup

Acceptance criteria

CLI help, completions, manpage, and implementation agree.
Removed features and non-existent fields are not advertised.
bun run build:man is run for CLI docs changes.
just lint and relevant CLI tests pass.

Parent: #305 Related: #133 ## Problem The CLI still documents or accepts some surfaces that do not match the current core model. Examples found during the scan include `priority` task flags/filters and import documentation for formats that are not implemented by `cli/src/import.ts`. ## Solution Make the CLI contract match the reduced product: - audit `cli/src/task.ts`, `cli/src/lib/filters.ts`, generated completions, and `cli/man/delta.1.md` - remove flags, filters, examples, and docs for fields or imports that do not exist - regenerate `cli/man/delta.1` after markdown changes - leave broader CLI parity work under #133, but close this issue with the stale-contract cleanup ## Acceptance criteria - CLI help, completions, manpage, and implementation agree. - Removed features and non-existent fields are not advertised. - `bun run build:man` is run for CLI docs changes. - `just lint` and relevant CLI tests pass.

barrettruth added this to the v0.1.0 milestone

2026-05-11 19:19:50 +00:00

barrettruth added the

track:core

type:cleanup

labels

2026-05-11 19:19:50 +00:00

barrettruth referenced this issue

2026-05-11 19:20:49 +00:00

tracker: blank-start cleanup and foundation migration #305

barrettruth referenced this issue

2026-05-11 19:21:16 +00:00