fix(codex): preserve native source priority behind featured subagent models

docs-site/src/content/docs/fr/guides/model-ordering.md

@@ -30,7 +30,7 @@ Sans ordre global du sélecteur, les priorités sans sélecteur pertinentes sont
 | `subagentModels[i]` | `i` (`0` à `4`) | La carte de classement présentée dans `src/codex/catalog/sync.ts` |
 | Autres modèles acheminés | `5` | Création d'une entrée routé dans `src/codex/catalog/sync.ts` |
 | Modèles routés non mis en avant et présents dans `modelPickerOrder` | `1000 + i` | Rang d’affichage du sélecteur dans `src/codex/catalog/sync.ts` |
-| Slugs GPT natifs par défaut | `9` | Création d'entrées natives dans `src/codex/catalog/sync.ts` |
+| Slugs GPT natifs par défaut | `sourcePriority` | Création d'entrées natives dans `src/codex/catalog/sync.ts` |
 | Modèles natifs non sélectionnés alors qu'une liste sélectionnée existe | Au moins `featured.length + 100` | Fusion du catalogue natif dans `src/codex/catalog/sync.ts` |
 
 La direction API limite `subagentModels` à cinq entrées avec `slice(0, 5)` en
@@ -73,7 +73,7 @@ Sans sélecteur de compte éligible et sans liste de sélection non vide, l'ordr
 3. Modèles natifs non sélectionnés, poussés sous le bloc sélectionné lors de la fusion du catalogue.
 
 Sans `subagentModels`, les modèles routés restent en priorité `5`, les entrées natives GPT utilisent leur
-priorité (normalement `9` pour les entrées construites par opencodex), et le groupe routé reste provider/id
+priorité (sourcePriority, avec `9` en dernier recours), et le groupe routé reste provider/id
 alphabétique.
 
 ## Exemple

docs-site/src/content/docs/fr/guides/sub-agent-surface.md

@@ -70,7 +70,7 @@ Par exemple, sans sélecteurs de compte et avec cette liste :
 | 3 | `deepseek/deepseek-v4-flash` | `5` | Première ligne routée restante dans l'ordre alphabétique |
 | 4 | `google/gemini-3-pro` | `5` | Ligne routée suivante |
 | 5 | `moonshot/kimi-k3` | `5` | Ligne routée suivante |
-| 6+ | `zai/glm-5.2`, puis les lignes GPT natives | `5`, puis `102` | Hors des cinq |
+| 6+ | `zai/glm-5.2`, puis les lignes GPT natives | `5`, puis `102 + sourcePriority` | Hors des cinq |
 
 Avec une liste vide, opencodex ne fixe aucune priorité et les cinq suivent les priorités normales du catalogue.
 

docs-site/src/content/docs/guides/model-ordering.md

@@ -30,8 +30,18 @@ Without complete-picker ordering, the relevant no-selector priorities are:
 | `subagentModels[i]` | `i` (`0` through `4`) | The featured rank map in `src/codex/catalog/sync.ts` |
 | Other routed models | `5` | Routed entry creation in `src/codex/catalog/sync.ts` |
 | Non-featured routed models listed in `modelPickerOrder` | `1000 + i` | Display-only picker rank in `src/codex/catalog/sync.ts` |
-| Native GPT slugs by default | `9` | Native entry creation in `src/codex/catalog/sync.ts` |
-| Unselected native models while a featured list exists | At least `featured.length + 100` | Native catalog merge in `src/codex/catalog/sync.ts` |
+| Native GPT slugs without a featured list | `sourcePriority` (fallback `9`) | Shared native source-priority resolver |
+| Unselected native models while a featured list exists | `featured.length + 100 + sourcePriority` | Shared native source-priority resolver |
+
+Native source priority comes from the current discovered descriptor, then the pristine catalog
+backup, then the same model's retained source value, then the upstream snapshot. Each candidate
+must be an integer from `0` through `1000`; invalid values are skipped and the final fallback is
+`9`. Published display priorities are never reused as source priorities. With four featured
+models, native source priorities `3`, `8` and missing become `107`, `112` and `113` respectively.
+This preserves native source order behind featured and ordinary routed rows, including after
+repeated sync or featuring and later unfeaturing a native. The live Codex model list, published
+catalog and models cache use the same priorities for the same inputs. Account-selector groups
+retain their separate stride policy; complete-picker ordering remains the final override.
 
 The management API limits `subagentModels` to five entries with `slice(0, 5)` in
 `src/server/management/agent-settings-routes.ts`. This matches the Codex `spawn_agent` surface, which
@@ -73,7 +83,7 @@ With no eligible account selectors and a non-empty featured list, the resulting
 3. Unselected native models, pushed below the featured block during catalog merge.
 
 Without `subagentModels`, routed models remain at priority `5`, native GPT entries use their normal
-priority (normally `9` for entries built by opencodex), and the routed group remains provider/id
+source priority (fallback `9`), and the routed group remains provider/id
 alphabetical.
 
 ## Example
@@ -101,7 +111,7 @@ The picker begins as follows:
 | 5 | `gpt-5.6-terra` | `4` | Fifth selection |
 | 6 | `anthropic/claude-fable-5` | `5` | First remaining routed id in provider/id alphabetical order |
 | 7 onward | Remaining routed models | `5` | Provider alphabetically, then model id alphabetically |
-| After routed models | Remaining native models | `featured.length + 100` or higher | Unselected natives are moved below the featured block |
+| After routed models | Remaining native models | `featured.length + 100 + sourcePriority` | Source order is preserved within the native band |
 
 The first five entries are the overrides advertised to `spawn_agent`; the rest continue in the
 normal picker order. With account selectors, the five-entry limit applies after bare native choices

docs-site/src/content/docs/guides/sub-agent-surface.md

@@ -93,7 +93,7 @@ depend on the catalog:
 
 | Catalog | Rows that fill the remaining slots |
 | --- | --- |
-| No Codex account selectors | Other routed `provider/model` rows. They all share priority `5`, so they appear by provider name and then model id, alphabetically. Unfeatured native GPT rows sit at priority `100` plus the number of featured ids or higher, so they come later. |
+| No Codex account selectors | Other routed `provider/model` rows. They all share priority `5`, so they appear by provider name and then model id, alphabetically. Unfeatured native GPT rows use `featured.length + 100 + sourcePriority`, preserving native source order behind those routed rows. |
 | Codex account selectors | Account-qualified native rows (`<selector>/<native-model>`), which directly follow the featured rows. Unfeatured routed rows move to priority `1005` and come after them. |
 
 For example, with no account selectors and this roster:
@@ -109,7 +109,12 @@ For example, with no account selectors and this roster:
 | 3 | `deepseek/deepseek-v4-flash` | `5` | First remaining routed row alphabetically |
 | 4 | `google/gemini-3-pro` | `5` | Next routed row |
 | 5 | `moonshot/kimi-k3` | `5` | Next routed row |
-| 6+ | `zai/glm-5.2`, then native GPT rows | `5`, then `102` | Outside the five |
+| 6+ | `zai/glm-5.2`, then native GPT rows | `5`, then `102 + sourcePriority` | Outside the five |
+
+The native source rank uses current discovery before the pristine backup, exact-model retained
+source rank and upstream snapshot, with fallback `9`. Repeated sync and feature/unfeature preserve
+that unbanded rank. The live list, published catalog and cache agree for equal inputs. See
+[Model ordering](/guides/model-ordering/) for validation and picker-order overrides.
 
 With an empty roster, opencodex pins nothing and the five follow the catalog's normal
 priorities.

docs-site/src/content/docs/ja/guides/model-ordering.md

@@ -28,7 +28,7 @@ selector がない場合の priority は次のとおりです。
  --- | ---: | --- |
 | `subagentModels[i]` | `i`(`0` から `4`) | `src/codex/catalog/sync.ts` の featured rank map |
 | その他のルーティングモデル | `5` | `src/codex/catalog/sync.ts` のルーティング項目生成 |
-| デフォルトネイティブ GPT スラッグ | `9` | `src/codex/catalog/sync.ts` のネイティブ項目生成 |
+| デフォルトネイティブ GPT スラッグ | `sourcePriority` | `src/codex/catalog/sync.ts` のネイティブ項目生成 |
 | featured リストがあるとき選択されていないネイティブモデル | 最小 `featured.length + 100` | `src/codex/catalog/sync.ts` のネイティブカタログマージ |
 
 管理 API は `src/server/management/agent-settings-routes.ts` の `slice(0, 5)` で `subagentModels` を最大
@@ -69,7 +69,7 @@ Codex の priority ソートでもこの先頭順序は保存されます。
 3. カタログマージ過程で featured ブロックの下に押し下げられた選択されていないネイティブモデル
 
 `subagentModels` がない場合、ルーティングモデルは priority `5` を維持し、ネイティブ GPT 項目は通常 priority
-(opencodex が作った項目は通常 `9`)を使います。ルーティンググループ内部は引き続きプロバイダー/ID
+(sourcePriority、情報がなければ `9`)を使います。ルーティンググループ内部は引き続きプロバイダー/ID
 アルファベット順です。
 
 ## 例

docs-site/src/content/docs/ja/guides/sub-agent-surface.md

@@ -57,7 +57,7 @@ Codex は `spawn_agent` ツールの説明に最大 5 つのモデルを列挙
 | 3 | `deepseek/deepseek-v4-flash` | `5` | アルファベット順で最初の残りのルーティング済み行 |
 | 4 | `google/gemini-3-pro` | `5` | 次のルーティング済み行 |
 | 5 | `moonshot/kimi-k3` | `5` | 次のルーティング済み行 |
-| 6+ | `zai/glm-5.2`、続いてネイティブ GPT 行 | `5`、続いて `102` | 5 つの枠外 |
+| 6+ | `zai/glm-5.2`、続いてネイティブ GPT 行 | `5`、続いて `102 + sourcePriority` | 5 つの枠外 |
 
 ロスターが空の場合、opencodex は何も固定せず、5 つの枠はカタログ本来の priority に従います。
 

docs-site/src/content/docs/ko/guides/model-ordering.md

@@ -28,7 +28,7 @@ selector가 없을 때의 priority는 다음과 같습니다.
 | --- | ---: | --- |
 | `subagentModels[i]` | `i` (`0`부터 `4`) | `src/codex/catalog/sync.ts`의 featured rank map |
 | 그 밖의 라우팅 모델 | `5` | `src/codex/catalog/sync.ts`의 라우팅 항목 생성 |
-| 기본 네이티브 GPT slug | `9` | `src/codex/catalog/sync.ts`의 네이티브 항목 생성 |
+| 기본 네이티브 GPT slug | `sourcePriority` | `src/codex/catalog/sync.ts`의 네이티브 항목 생성 |
 | featured 목록이 있을 때 선택되지 않은 네이티브 모델 | 최소 `featured.length + 100` | `src/codex/catalog/sync.ts`의 네이티브 카탈로그 병합 |
 
 관리 API는 `src/server/management/agent-settings-routes.ts`의 `slice(0, 5)`로 `subagentModels`를 최대
@@ -69,7 +69,7 @@ Codex의 priority 정렬에서도 이 선두 순서가 보존됩니다.
 3. 카탈로그 병합 과정에서 featured 블록 아래로 밀린 선택되지 않은 네이티브 모델
 
 `subagentModels`가 없으면 라우팅 모델은 priority `5`를 유지하고, 네이티브 GPT 항목은 정상 priority
-(opencodex가 만든 항목은 보통 `9`)를 사용합니다. 라우팅 그룹 내부는 계속 프로바이더/id
+(sourcePriority, 출처가 없으면 `9`)를 사용합니다. 라우팅 그룹 내부는 계속 프로바이더/id
 알파벳순입니다.
 
 ## 예시

docs-site/src/content/docs/ko/guides/sub-agent-surface.md

@@ -57,7 +57,7 @@ Codex는 `spawn_agent` 도구 설명에 모델을 최대 5개까지 나열하며
 | 3 | `deepseek/deepseek-v4-flash` | `5` | 알파벳 순으로 첫 번째인 남은 라우팅 행 |
 | 4 | `google/gemini-3-pro` | `5` | 다음 라우팅 행 |
 | 5 | `moonshot/kimi-k3` | `5` | 다음 라우팅 행 |
-| 6+ | `zai/glm-5.2`, 그다음 네이티브 GPT 행 | `5`, 그다음 `102` | 5개 밖 |
+| 6+ | `zai/glm-5.2`, 그다음 네이티브 GPT 행 | `5`, 그다음 `102 + sourcePriority` | 5개 밖 |
 
 로스터가 비어 있으면 opencodex는 아무것도 고정하지 않고, 5개는 카탈로그의 원래 priority를 따릅니다.
 

docs-site/src/content/docs/ru/guides/model-ordering.md

@@ -31,7 +31,7 @@ selector-групп.
 | --- | ---: | --- |
 | `subagentModels[i]` | `i` (от `0` до `4`) | Карта рангов избранных в `src/codex/catalog/sync.ts` |
 | Остальные маршрутизируемые модели | `5` | Создание маршрутизируемых записей в `src/codex/catalog/sync.ts` |
-| Нативные GPT-слаги по умолчанию | `9` | Создание нативных записей в `src/codex/catalog/sync.ts` |
+| Нативные GPT-слаги по умолчанию | `sourcePriority` | Создание нативных записей в `src/codex/catalog/sync.ts` |
 | Невыбранные нативные модели при непустом списке избранных | Не менее `featured.length + 100` | Слияние нативного каталога в `src/codex/catalog/sync.ts` |
 
 API управления ограничивает `subagentModels` пятью записями через `slice(0, 5)` в
@@ -77,7 +77,7 @@ API управления ограничивает `subagentModels` пятью з
 3. Невыбранные нативные модели, сдвинутые ниже блока избранных при слиянии каталога.
 
 Без `subagentModels` маршрутизируемые модели остаются с приоритетом `5`, нативные GPT-записи
-используют обычный приоритет (для записей, построенных opencodex, обычно `9`), а группа
+используют обычный приоритет (sourcePriority, резервное значение `9`), а группа
 маршрутизируемых моделей сохраняет алфавитный порядок «провайдер/id».
 
 ## Пример

docs-site/src/content/docs/ru/guides/sub-agent-surface.md

@@ -70,7 +70,7 @@ Codex перечисляет в описании инструмента `spawn_a
 | 3 | `deepseek/deepseek-v4-flash` | `5` | Первая оставшаяся маршрутизируемая строка по алфавиту |
 | 4 | `google/gemini-3-pro` | `5` | Следующая маршрутизируемая строка |
 | 5 | `moonshot/kimi-k3` | `5` | Следующая маршрутизируемая строка |
-| 6+ | `zai/glm-5.2`, затем нативные строки GPT | `5`, затем `102` | За пределами пяти |
+| 6+ | `zai/glm-5.2`, затем нативные строки GPT | `5`, затем `102 + sourcePriority` | За пределами пяти |
 
 С пустым ростером opencodex ничего не закрепляет, и пять мест определяются обычными приоритетами каталога.
 

docs-site/src/content/docs/tr/guides/model-ordering.md

@@ -34,7 +34,7 @@ Aşağıdaki öncelik tabloları ve örnek, seçicinin tamamını sıralama modu
 | --- | ---: | --- |
 | `subagentModels[i]` | `i` (`0` - `4`) | `src/codex/catalog/sync.ts` içindeki öne çıkan sıra haritası |
 | Diğer yönlendirilen modeller | `5` | `src/codex/catalog/sync.ts` içindeki yönlendirilen girdi oluşturma |
-| Varsayılan olarak yerel GPT slug'ları | `9` | `src/codex/catalog/sync.ts` içindeki yerel girdi oluşturma |
+| Varsayılan olarak yerel GPT slug'ları | `sourcePriority` | `src/codex/catalog/sync.ts` içindeki yerel girdi oluşturma |
 | Öne çıkan bir liste varken seçilmeyen yerel modeller | En az `featured.length + 100` | `src/codex/catalog/sync.ts` içindeki yerel katalog birleştirme |
 
 Yönetim API'si `src/server/management/agent-settings-routes.ts` içinde `slice(0,
@@ -89,8 +89,7 @@ olduğunda ortaya çıkan sıra şöyledir:
    modeller.
 
 `subagentModels` olmadan yönlendirilen modeller `5` önceliğinde kalır, yerel GPT
-girdileri normal önceliklerini kullanır (opencodex tarafından oluşturulan
-girdiler için normalde `9`) ve yönlendirilen grup sağlayıcı/kimlik olarak
+girdileri normal önceliklerini kullanır (sourcePriority, kaynak yoksa `9`) ve yönlendirilen grup sağlayıcı/kimlik olarak
 alfabetik kalır.
 
 ## Örnek

docs-site/src/content/docs/tr/guides/sub-agent-surface.md

@@ -71,7 +71,7 @@ Bir ile dört arasında model öne çıkarırsanız Codex kalan yuvaları öncel
 | 3 | `deepseek/deepseek-v4-flash` | `5` | Alfabetik olarak kalan ilk yönlendirilmiş satır |
 | 4 | `google/gemini-3-pro` | `5` | Sonraki yönlendirilmiş satır |
 | 5 | `moonshot/kimi-k3` | `5` | Sonraki yönlendirilmiş satır |
-| 6+ | `zai/glm-5.2`, ardından yerel GPT satırları | `5`, ardından `102` | Beşin dışında |
+| 6+ | `zai/glm-5.2`, ardından yerel GPT satırları | `5`, ardından `102 + sourcePriority` | Beşin dışında |
 
 Kadro boşsa opencodex hiçbir satırı sabitlemez ve beş yuva kataloğun normal önceliklerine göre belirlenir.
 

docs-site/src/content/docs/zh-cn/guides/model-ordering.md

@@ -26,7 +26,7 @@ priority 为 `i * N + j` 的 selector 行，其中 `j` 是从 0 开始的 select
 | --- | ---: | --- |
 | `subagentModels[i]` | `i`（`0` 至 `4`） | `src/codex/catalog/sync.ts` 中的 featured rank map |
 | 其他路由模型 | `5` | `src/codex/catalog/sync.ts` 中创建路由条目的逻辑 |
-| 默认原生 GPT slug | `9` | `src/codex/catalog/sync.ts` 中创建原生条目的逻辑 |
+| 默认原生 GPT slug | `sourcePriority` | `src/codex/catalog/sync.ts` 中创建原生条目的逻辑 |
 | 存在 featured 列表时未选中的原生模型 | 至少为 `featured.length + 100` | `src/codex/catalog/sync.ts` 中合并原生目录的逻辑 |
 
 管理 API 在 `src/server/management/agent-settings-routes.ts` 中使用 `slice(0, 5)`，把
@@ -67,7 +67,7 @@ priority，因此 Codex 的 priority 排序会保留这个开头序列。
 3. 在目录合并过程中被移到 featured 区块之后的未选中原生模型。
 
 如果没有 `subagentModels`，路由模型保持 priority `5`，原生 GPT 条目使用正常 priority
-（opencodex 创建的条目通常为 `9`），路由组内部仍按 provider/id 字母排序。
+（sourcePriority，缺少来源时回退到 `9`），路由组内部仍按 provider/id 字母排序。
 
 ## 示例
 

docs-site/src/content/docs/zh-cn/guides/sub-agent-surface.md

@@ -57,7 +57,7 @@ Codex 在 `spawn_agent` 工具描述中最多列出五个模型，并由 Codex 
 | 3 | `deepseek/deepseek-v4-flash` | `5` | 按字母顺序第一个剩余的路由行 |
 | 4 | `google/gemini-3-pro` | `5` | 下一个路由行 |
 | 5 | `moonshot/kimi-k3` | `5` | 下一个路由行 |
-| 6+ | `zai/glm-5.2`，然后是原生 GPT 行 | `5`，然后是 `102` | 不在前五之内 |
+| 6+ | `zai/glm-5.2`，然后是原生 GPT 行 | `5`，然后是 `102 + sourcePriority` | 不在前五之内 |
 
 roster 为空时，opencodex 不固定任何行，前五个按目录原有的 priority 决定。
 

docs-site/src/content/docs/zh-tw/guides/model-ordering.md

@@ -20,7 +20,7 @@ Codex 的 models-manager 按 `priority` 升序排列選擇器中可見的目錄
 | --- | ---: | --- |
 | `subagentModels[i]` | `i`（`0` 至 `4`） | `src/codex/catalog/sync.ts` 中的 featured rank map |
 | 其他路由模型 | `5` | `src/codex/catalog/sync.ts` 中建立路由條目的邏輯 |
-| 預設原生 GPT slug | `9` | `src/codex/catalog/sync.ts` 中建立原生條目的邏輯 |
+| 預設原生 GPT slug | `sourcePriority` | `src/codex/catalog/sync.ts` 中建立原生條目的邏輯 |
 | 存在 featured 列表時未選中的原生模型 | 至少為 `featured.length + 100` | `src/codex/catalog/sync.ts` 中合併原生目錄的邏輯 |
 
 管理 API 在 `src/server/management/agent-settings-routes.ts` 中使用 `slice(0, 5)`，把
@@ -61,7 +61,7 @@ featured 列表非空時，最終順序為：
 3. 在目錄合併過程中被移到 featured 區塊之後的未選中原生模型。
 
 如果沒有 `subagentModels`，路由模型保持 priority `5`，原生 GPT 條目使用正常 priority
-（opencodex 建立的條目通常為 `9`），路由組內部仍按 provider/id 字母排序。
+（sourcePriority，缺少來源時回退至 `9`），路由組內部仍按 provider/id 字母排序。
 
 ## 示例
 

docs-site/src/content/docs/zh-tw/guides/sub-agent-surface.md

@@ -57,7 +57,7 @@ Codex 在 `spawn_agent` 工具說明中最多列出五個模型，並由 Codex 
 | 3 | `deepseek/deepseek-v4-flash` | `5` | 依字母順序第一個剩餘的路由列 |
 | 4 | `google/gemini-3-pro` | `5` | 下一個路由列 |
 | 5 | `moonshot/kimi-k3` | `5` | 下一個路由列 |
-| 6+ | `zai/glm-5.2`，接著是原生 GPT 列 | `5`，接著是 `102` | 不在前五之內 |
+| 6+ | `zai/glm-5.2`，接著是原生 GPT 列 | `5`，接著是 `102 + sourcePriority` | 不在前五之內 |
 
 名冊為空時，opencodex 不固定任何列，前五個依目錄原有的 priority 決定。