From bafaac5e61aaa1a30a0db67db638972eb54cba5f Mon Sep 17 00:00:00 2001 From: Mariano Nicolini Date: Fri, 28 Aug 2026 12:26:30 -0300 Subject: [PATCH] docs(nous): correct the subtract-only claim in the policy plan MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The plan stated the policy set should only ever subtract from a list. That is wrong when an allowlist names a model the curated manifest lacks, which empties the picker instead of narrowing it — the behaviour fixed in 117e7fef88. Co-Authored-By: Claude Opus 5 (1M context) --- docs/nous-org-model-policy.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/nous-org-model-policy.md b/docs/nous-org-model-policy.md index 174f65fec7..942c798507 100644 --- a/docs/nous-org-model-policy.md +++ b/docs/nous-org-model-policy.md @@ -135,8 +135,16 @@ entry the surface already populates, so no surface makes an extra request. **Do not** replace a list with the response's keys. Every surface shows the curated agentic list in curated order deliberately — the live catalog is a large alphabetical dump of vendor-prefixed models, and swapping it in is the -regression `model_switch.py:3070` records. Recommendations should be able to -*reveal* a newly launched model; the policy set should only ever subtract. +regression `model_switch.py:3070` records. + +**Do not** treat the policy set as subtract-only either. An allowlist can name +a model the curated manifest has never heard of, and intersecting alone then +empties the picker — strictly worse than an unfiltered list, because the one +model the org may use is the one dropped. When the reachable set is small +enough to be a human-authored allowlist, append what it admits that the +curated list lacks, after the curated entries so their order survives. Bound +it by size: a provider-only policy leaves the whole catalog reachable, and +appending that would bury the curated order. **Do not** narrow a list on evidence that cannot support it. `nous_policy_allowed_ids()` returns `None` — meaning "leave the list alone" —