Skip to content

docs: post-yank cleanup — delete dead orch design docs, banner V2 auth doc#75

Merged
steve-krisjanovs merged 1 commit into
mainfrom
docs/post-yank-cleanup
Jun 26, 2026
Merged

docs: post-yank cleanup — delete dead orch design docs, banner V2 auth doc#75
steve-krisjanovs merged 1 commit into
mainfrom
docs/post-yank-cleanup

Conversation

@steve-krisjanovs

Copy link
Copy Markdown
Contributor

Summary

Documentation stragglers from the v0.37.0 orch yank. No code changes; no version bump.

  • DELETE ORCHESTRATION-DESIGN.md — design doc for the engine I yanked. Targeted "v1.0.0 of orch" which will never happen.
  • DELETE MONTECARLO.md — step-by-step `llmux orch` walkthrough. Every CLI verb it documents (`send`, `inbox`, `next`, `reply`) is now an unknown command.
  • V2-SYSTEM-AUTH-DESIGN.md — survives because v2 auth survives, but mentions orch in 5+ places (`orch alias`, `/var/lib/llmux/orchestration/`, `/api/orch/send` spoofing prevention, etc.). Added a "Note (v0.37.0)" header banner explaining the orch references are historical context for why v2 auth was designed with identity binding — the binding still earns its keep against the v2 token store, just no longer for orch message authorship.
  • README.md — one line in the Remote Operation section had a stale comment (`# mint with \`llmux token create\``) that didn't reflect the new required `--username ` flag. Fixed.

Net diff

`+10 / −848` (848 deletions are the two killed design docs).

What I checked but left alone

  • Status banner at the top of README — generic enough ("Auth + tokens, mobile picker, …") to still read correctly post-yank.
  • `tests/cli-read.sh`, `tests/cli-write.sh` — zero orch references, verified.
  • `tests/README.md` — covers token CRUD but stays current after the v2-tokens-unify ownership add.
  • `CHANGELOG.md` — the `[0.37.0]` entries describe both the yank and the v2-tokens-unify; nothing else stale.

🤖 Generated with Claude Code

…h doc

Follow-on to v0.37.0 (orch yank). Four documentation stragglers:

- DELETE ORCHESTRATION-DESIGN.md — design doc for the orch engine
  that was yanked. No live code references it; its target release
  ("v1.0.0 of orch") will never happen.
- DELETE MONTECARLO.md — step-by-step `llmux orch` walkthrough for
  the Monte Carlo fanout pattern. The CLI commands it documented
  (`llmux orch send`, `inbox`, `next`, `reply`) are unknown commands
  now.
- V2-SYSTEM-AUTH-DESIGN.md — survives because v2 auth survives, but
  mentions orch in 5+ places. Added a "Note (v0.37.0)" header banner
  explaining the orch references are historical context for why
  v2 auth was designed with identity binding; the binding still earns
  its keep against the v2 token store, just no longer for orch
  message authorship.
- README.md — one line in the Remote Operation section had a stale
  comment (`# mint with \`llmux token create\``). Updated to reflect
  the new required `--username <name>` flag.

Docs-only; no version bump.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@steve-krisjanovs steve-krisjanovs merged commit ff15188 into main Jun 26, 2026
1 check passed
@steve-krisjanovs steve-krisjanovs deleted the docs/post-yank-cleanup branch June 26, 2026 15:34
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.

1 participant