docs: capture new TODO items from the post-redesign audit #27

Merged

David merged 1 commit from chore/todo-additions into main

2026-05-14 18:56:50 +02:00

David commented

2026-05-14 18:17:30 +02:00

Owner

Summary

Appends five items to TODO.md that the recent yt update + per-instance-config PRs (#23-#26) surfaced.

Tier 2 additions

Instance management verbs (yt auth list/use/logout/whoami). PR #26 dropped the config configurations subcommand group in favor of --instance, but users still need ways to enumerate instances, switch the default without editing config.yml, and remove an instance. The existing "auth list/logout/whoami" bullet is reworded around this rationale.
yt auth verify. One-shot health check against the active instance's stored token.
yt issue apply <id...> -- "<command query>". Raw passthrough to /api/commands, so users can run any YouTrack command-language string (state changes, tag mutations, link mutations) without each one needing a bespoke subcommand.
Note that --dry-run is already in place for yt update (PR #25); the existing bullet now says "generalize the flag".

Tier 3 additions

yt update already-up-to-date short-circuit. Skip the download when the published hash matches local.
yt update checksum verification. Verify a sidecar .sha256 (or signed manifest) before swapping.

Code hygiene

url is no longer in the unused-deps list (the per-instance redesign in PR #26 calls url::Url::host() to parse the YouTrack base URL). secrecy stays flagged.

Sequence

This is part 1 of 4 for today's batch:

(this PR) TODO.md captures the new items.
PR B: Tier 1 bundled (issue update + link/unlink + delete + list pagination + raw query + user + project + work history + attachments + tags).
PR C: Tier 2 bundled (yt open + search + completions + auth verbs + verify + issue apply + dry-run + quiet + json parity).
PR D: Tier 3 bundled (custom-field $type + work-check local time + retry + verbose + color + multi-board sprint + update already-up-to-date + update checksum).

Per your direction. These PRs will be large; expect ~1500-3000 LoC each.

## Summary Appends five items to `TODO.md` that the recent `yt update` + per-instance-config PRs (#23-#26) surfaced. ## Tier 2 additions - **Instance management verbs** (`yt auth list/use/logout/whoami`). PR #26 dropped the `config configurations` subcommand group in favor of `--instance`, but users still need ways to enumerate instances, switch the default without editing `config.yml`, and remove an instance. The existing "auth list/logout/whoami" bullet is reworded around this rationale. - **`yt auth verify`**. One-shot health check against the active instance's stored token. - **`yt issue apply <id...> -- "<command query>"`**. Raw passthrough to `/api/commands`, so users can run any YouTrack command-language string (state changes, tag mutations, link mutations) without each one needing a bespoke subcommand. - Note that `--dry-run` is already in place for `yt update` (PR #25); the existing bullet now says "generalize the flag". ## Tier 3 additions - **`yt update` already-up-to-date short-circuit**. Skip the download when the published hash matches local. - **`yt update` checksum verification**. Verify a sidecar `.sha256` (or signed manifest) before swapping. ## Code hygiene `url` is no longer in the unused-deps list (the per-instance redesign in PR #26 calls `url::Url::host()` to parse the YouTrack base URL). `secrecy` stays flagged. ## Sequence This is part 1 of 4 for today's batch: - (this PR) TODO.md captures the new items. - PR B: Tier 1 bundled (issue update + link/unlink + delete + list pagination + raw query + user + project + work history + attachments + tags). - PR C: Tier 2 bundled (yt open + search + completions + auth verbs + verify + issue apply + dry-run + quiet + json parity). - PR D: Tier 3 bundled (custom-field $type + work-check local time + retry + verbose + color + multi-board sprint + update already-up-to-date + update checksum). Per your direction. These PRs will be large; expect ~1500-3000 LoC each.

David added 1 commit

2026-05-14 18:17:30 +02:00

docs: capture new TODO items from the post-redesign audit

Check / fmt + clippy + build + tests (pull_request) Successful in 9s

Details

Create release / Create release from merged PR (pull_request) Has been skipped

Details

2950247e1c

Adds five items surfaced by the recent yt update + per-instance-config PRs (#23-#26):

Tier 2:
- Instance management verbs (`yt auth list/use/logout/whoami`). The `config configurations` subcommand group was dropped in PR #26 in favor of `--instance`, but users still need ways to enumerate instances, switch the default without editing config.yml, and remove an instance. The earlier "auth list/logout/whoami" bullet is reworded around this rationale.
- `yt auth verify`. One-shot health check against the active instance's stored token.
- `yt issue apply <id...> -- "<command query>"`. Raw passthrough to `/api/commands` so users can run any command-language string, not just sprint set.
- Note that `--dry-run` is already in place for `yt update` (PR #25); the Tier 2 line now says "generalize the flag".

Tier 3:
- `yt update` already-up-to-date short-circuit. Skip the download when the published hash matches local.
- `yt update` checksum verification. Verify a sidecar `.sha256` (or signed manifest) before swapping.

Code hygiene: `url` is no longer unused (the per-instance redesign in PR #26 calls `url::Url::host()` to parse the YouTrack base URL). Removed from the unused-deps note; `secrecy` stays flagged.