From a20c0dbee8e97d5eed5ce5d4e51c00d00eb9985e Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Tue, 6 Oct 2026 09:31:39 -0700 Subject: [PATCH 1/3] docs(agents): a renamed flag refuses through Deprecated, not a hidden alias Co-Authored-By: Claude Opus 5.5 --- rs/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rs/AGENTS.md b/rs/AGENTS.md index e4259e34141..3705ed5118f 100644 --- a/rs/AGENTS.md +++ b/rs/AGENTS.md @@ -46,7 +46,7 @@ Prefer poll. New logic is a `poll_*` with an `async` helper, not the other way a - Don't add `#[non_exhaustive]` by default. It earns its keep on error enums, enums that will gain variants, and `Config`-style structs with `pub` fields plus a `Default`/constructor. Builders with private fields don't need it. - Append new variants to the end of a public fieldless enum with implicit discriminants; inserting reorders `as` values. -- A deprecated item gets `#[doc(hidden)]` and `#[deprecated(note)]`; a deprecated flag becomes a hidden alias (`alias_hidden`; Usage advertises a plain `alias` in help and completions). Never advertise the dead name in docs or `--help`. +- A deprecated item gets `#[doc(hidden)]` and `#[deprecated(note)]`. A renamed flag or env var stays as a hidden arg recorded in `moq_tokio::Deprecated`, which refuses to start and names the replacement rather than honoring the old spelling. Never advertise the dead name in docs or `--help`. # Testing From edbc2a7364ddd73b64f5ae9b4c405c2f8c0688ce Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Tue, 6 Oct 2026 09:32:33 -0700 Subject: [PATCH 2/3] docs(agents): drop the enumerated relay drills; the drill README is the catalog Co-Authored-By: Claude Opus 5.5 --- rs/moq-relay/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rs/moq-relay/AGENTS.md b/rs/moq-relay/AGENTS.md index c09198a143c..508dff9c29a 100644 --- a/rs/moq-relay/AGENTS.md +++ b/rs/moq-relay/AGENTS.md @@ -9,7 +9,7 @@ Config structs are Usage `Args` that also load from TOML, with the `moq-tokio` c # Testing -`tests/drills.rs` disrupts a live session through a real relay over real QUIC: a cancelled reader with a backlog, the relay dying mid-group, and a publisher republishing a name it lost. Each drill records that its fault activated and requires a terminal result rather than a clean finish or a hang. `test/drill/README.md` covers the recipe and the sensitivity proof; add a mutation there for any recovery behavior a new drill grades. +`tests/drills.rs` disrupts a live session through a real relay over real QUIC. Each drill records that its fault activated and requires a terminal result rather than a clean finish or a hang. `test/drill/README.md` covers the recipe and the sensitivity proof; add a mutation there for any recovery behavior a new drill grades. # Semver From 8e1034943bfc180a0d8d47b55b5f673f0dd47198 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Tue, 6 Oct 2026 10:25:48 -0700 Subject: [PATCH 3/3] docs(agents): clarify deprecated argument refusal Co-Authored-By: GPT-6 --- rs/AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rs/AGENTS.md b/rs/AGENTS.md index 3705ed5118f..724007ecba3 100644 --- a/rs/AGENTS.md +++ b/rs/AGENTS.md @@ -46,7 +46,7 @@ Prefer poll. New logic is a `poll_*` with an `async` helper, not the other way a - Don't add `#[non_exhaustive]` by default. It earns its keep on error enums, enums that will gain variants, and `Config`-style structs with `pub` fields plus a `Default`/constructor. Builders with private fields don't need it. - Append new variants to the end of a public fieldless enum with implicit discriminants; inserting reorders `as` values. -- A deprecated item gets `#[doc(hidden)]` and `#[deprecated(note)]`. A renamed flag or env var stays as a hidden arg recorded in `moq_tokio::Deprecated`, which refuses to start and names the replacement rather than honoring the old spelling. Never advertise the dead name in docs or `--help`. +- A deprecated item gets `#[doc(hidden)]` and `#[deprecated(note)]`. A renamed flag or env var stays as a hidden arg with its original `env`, reported by the section's `deprecated()` into `moq_tokio::cli::Deprecated`; callers must reject startup when the collection is non-empty and name the replacement rather than honor the old spelling. Never advertise the dead name in docs or `--help`. # Testing