dsh-github-copilot 0.1.0-alpha.2.dsh.0.2.2.rc.3 → 0.1.0-alpha.20.dsh.0.2.2.rc.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/AGENTS.md +301 -66
  2. package/CHANGELOG.md +111 -0
  3. package/CONTRIBUTING.md +17 -5
  4. package/README.md +146 -22
  5. package/README.zh.md +108 -17
  6. package/deployment-baseline.json +102 -50
  7. package/docs/account-management-experience.md +10 -5
  8. package/docs/agent-autonomy-evaluation.md +78 -0
  9. package/docs/agent-readiness.md +49 -6
  10. package/docs/auto-high-cost.md +7 -21
  11. package/docs/auto-review-sampling.md +50 -1
  12. package/docs/auto-task-routing.md +4 -4
  13. package/docs/automatic-model-routing.md +6 -6
  14. package/docs/copilot-accounts.md +141 -83
  15. package/docs/copilot-compaction.md +1 -1
  16. package/docs/copilot-usage.md +5 -1
  17. package/docs/image-input-compatibility.md +28 -109
  18. package/docs/manual-compaction-recovery.md +12 -11
  19. package/docs/model-compatibility-acceptance.md +20 -9
  20. package/docs/npm-distribution.md +21 -2
  21. package/docs/official-first-016-alpha2.md +3 -2
  22. package/docs/official-first-020-rc1.md +3 -2
  23. package/docs/official-first-020-rc2.md +4 -0
  24. package/docs/official-first-021-alpha4.md +3 -0
  25. package/docs/official-first-021-alpha5.md +5 -0
  26. package/docs/official-first-021-rc3.md +3 -0
  27. package/docs/plugin-diagnostics.md +12 -578
  28. package/docs/session-continuation.md +13 -9
  29. package/docs/session-search-routing.md +9 -6
  30. package/docs/single-route-migration.md +102 -125
  31. package/lib/client.js +650 -1104
  32. package/lib/client.js.map +1 -1
  33. package/lib/copilot-identity-BpfZQOip.js +21 -0
  34. package/lib/index.js +2248 -2035
  35. package/lib/manual-compaction-recovery.js +3 -17
  36. package/lib/remote.js +125 -433
  37. package/lib/routed-web.js +2 -2
  38. package/lib/{traditional-search-BZpWOTZA.js → traditional-search-6Gf2GmQW.js} +38 -4
  39. package/lib/types/account-model-catalog.d.ts +2 -0
  40. package/lib/types/authorization-controller.d.ts +36 -0
  41. package/lib/types/client.d.ts +1 -6
  42. package/lib/types/config.d.ts +10 -5
  43. package/lib/types/context-evidence.d.ts +4 -4
  44. package/lib/types/copilot-accounts-host.d.ts +9 -1
  45. package/lib/types/copilot-accounts-remote.d.ts +2 -0
  46. package/lib/types/copilot-accounts-types.d.ts +1 -1
  47. package/lib/types/copilot-auth.d.ts +1 -1
  48. package/lib/types/copilot-identity.d.ts +2 -0
  49. package/lib/types/copilot-system-trust.d.ts +3 -0
  50. package/lib/types/copilot-usage-card.d.ts +14 -0
  51. package/lib/types/copilot-usage-host.d.ts +4 -0
  52. package/lib/types/copilot-usage-remote.d.ts +8 -1
  53. package/lib/types/copilot-usage-types.d.ts +2 -0
  54. package/lib/types/model-preferences-card.d.ts +1 -1
  55. package/lib/types/native-copilot-access.d.ts +28 -0
  56. package/lib/types/native-copilot-search-remote.d.ts +18 -0
  57. package/lib/types/native-copilot-search.d.ts +21 -0
  58. package/lib/types/native-model-sync.d.ts +38 -0
  59. package/lib/types/native-search-model-card.d.ts +10 -0
  60. package/lib/types/preview-provider.d.ts +0 -6
  61. package/lib/types/preview-route.d.ts +10 -0
  62. package/lib/types/remote.d.ts +90 -3
  63. package/lib/types/session-accounts-host.d.ts +12 -1
  64. package/lib/types/session-accounts-remote.d.ts +2 -0
  65. package/lib/types/session-accounts.d.ts +2 -1
  66. package/lib/types/traditional-search.d.ts +3 -1
  67. package/package.json +4 -4
  68. package/scripts/autonomy-evaluation.mjs +313 -0
  69. package/scripts/check-search-composition.mjs +0 -1
  70. package/scripts/release-policy.mjs +2 -1
  71. package/tests/fixtures/autonomy-evaluation.json +71 -0
  72. package/lib/copilot-identity-BF8J8-9O.js +0 -12
  73. package/lib/diagnostics-analysis-io.js +0 -78
  74. package/lib/diagnostics-analysis.js +0 -427
  75. package/lib/diagnostics-types-eEWwFOFD.js +0 -668
  76. package/lib/types/auto-allocation-diagnostics.d.ts +0 -126
  77. package/lib/types/diagnostics-analysis-io.d.ts +0 -23
  78. package/lib/types/diagnostics-analysis.d.ts +0 -298
  79. package/lib/types/diagnostics-card.d.ts +0 -12
  80. package/lib/types/diagnostics-client.d.ts +0 -13
  81. package/lib/types/diagnostics-collector.d.ts +0 -50
  82. package/lib/types/diagnostics-host.d.ts +0 -183
  83. package/lib/types/diagnostics-remote.d.ts +0 -113
  84. package/lib/types/diagnostics-types.d.ts +0 -893
  85. package/lib/types/image-input-admission.d.ts +0 -20
  86. package/lib/types/request-diagnostics.d.ts +0 -278
  87. package/scripts/analyze-diagnostics.mjs +0 -91
package/AGENTS.md CHANGED
@@ -7,10 +7,10 @@ This file is the authoritative entry point for humans and coding agents. Read it
7
7
  This repository follows a **plugin-only** policy: implement fixes in `dsh-github-copilot` through existing published public Core/pi-ai APIs. This rule applies to agents, subagents, scripts, installers and release plans, not just the final diff.
8
8
 
9
9
  - Do not edit DSH Core source, create Core implementation worktrees, prepare Core commits/PRs/releases, or rebuild/install a modified Core to complete this project's work.
10
- - Do not patch deployed Core or dependency artifacts in `node_modules`, ship hidden Core patches, replace Core prototypes/private registries, or mutate shared upstream model catalogs. Create only plugin-owned objects and reversible registrations through public APIs.
10
+ - Do not patch deployed Core or dependency artifacts in `node_modules`, ship hidden Core patches, replace Core prototypes/private registries, or mutate shared upstream model catalogs. Create plugin-owned objects and reversible registrations through public APIs; the sole Core-owned credential exception is the user-confirmed native Copilot account switch described below.
11
11
  - Do not make a Core patch, a new Core export, or an upstream Core PR being merged/released a prerequisite for delivering a plugin fix.
12
12
  - Read-only Core/API inspection and isolated compatibility tests against unchanged pinned artifacts are allowed. Test-only fixtures must not alter tracked Core implementation or a live deployment and must clean up only their own temporary files. Historical controlled baselines are regression evidence, not permission for new Core changes.
13
- - If the existing API cannot support the desired behavior, report the limit and choose a tested plugin-local alternative or defer that capability. Do not expand into Core work to preserve an earlier design claim. Reusing a published adapter class for an account-scoped, metadata-driven Copilot route is allowed; a second wire implementation, independently maintained static model catalog, copied credentials, or a fabricated single-route claim is not.
13
+ - If the existing API cannot support the desired behavior, report the limit and choose a tested plugin-local alternative or defer that capability. Do not expand into Core work to preserve an earlier design claim. Reusing a published adapter class for an account-scoped, metadata-driven Copilot route is allowed; a second wire implementation, independently maintained static model catalog, unapproved credential copies, or a fabricated single-route claim is not.
14
14
  - General model compatibility must be data-driven: new account models with supported endpoint/capability metadata must work without adding model IDs or name-prefix branches to code. Unknown or incomplete metadata must produce a diagnostic rather than guessed capabilities. Follow [the current acceptance checklist](./docs/model-compatibility-acceptance.md), including Thinking, pi version compatibility, PR/merge/release and the requested local upgrade.
15
15
  - Any future Core work requires a separate, explicit human request and separate task scope. Generic requests to fix compatibility, add models, optimize, or continue a goal do not grant that permission. Preserve abandoned Core work without resuming, publishing or deleting it automatically.
16
16
 
@@ -27,15 +27,113 @@ This repository follows a **plugin-only** policy: implement fixes in `dsh-github
27
27
 
28
28
  Use native DSH tools for goals, background jobs and scoped subagents. Use local Git and the GitHub REST API for delivery; no external orchestration daemon, roster or `vcs_*` tool is required. Do not assume a model provider's identity is the assisting agent.
29
29
 
30
+ ## Session isolation and temporary artifacts (#442)
31
+
32
+ - Prefer one app-managed worktree per independent repository session when supported and authorized. A branch-backed session, folder session or shared checkout is not necessarily isolated. Verify the actual workspace and branch; preserve the user's chosen workspace. Creating or checking out another worktree still requires separate approval.
33
+ - Store temporary evidence, downloads, scratch files and backups in the session-owned artifact area outside the repository checkout. Keep only intentional deliverables in the repository. Clean up only explicitly identified temporary files created by the current task; never hide, move, delete or stage pre-existing files merely to make a gate pass.
34
+ - Inspect the explicit staged and committed diff before delivery. Unrelated untracked files are not by themselves a Git conflict or proof of a GitHub permission failure. Respect each delivery tool's own instructions and allowed fallback paths; repository guidance cannot override those requirements or branch protection.
35
+ - Continue routine investigation and authorized delivery without repeated approval prompts. For a genuine decision, safety boundary or tool-policy blocker, ask or report it once with the exact consequence; do not loop while the user is unavailable. Preserve existing approval boundaries for profile installation, sign-out, disruptive restart and worktree checkout.
36
+
37
+ These are agent instructions and contract-drift checks, not a filesystem sandbox or a guarantee that every session uses a worktree.
38
+
39
+ ### Scoped autonomous execution (#491)
40
+
41
+ **Keep progressing within the user's authorization; ask only at a new boundary.**
42
+ Before asking, check the direct user instructions already available for this task.
43
+ Retain the approved target, purpose, side effects, limits and any revocation in
44
+ session-owned task state. Completing one step, receiving a continuation reminder,
45
+ losing a UI window or finding the user unavailable does not by itself erase that
46
+ authorization. A checkpoint records evidence of consent, not a new permission
47
+ grant; respect any tool that requires fresh direct consent or cannot recover it.
48
+
49
+ Proceed with safe inspection, isolated checks and bounded recovery without routine
50
+ confirmation. An explicit "restart and check" approval covers stopping the approved
51
+ app, starting that same target and inspecting it. If fresh discovery subsequently
52
+ proves it is not running before that check completes, allow at most one recovery
53
+ start under the same authorization, unless the user or tool limits consent to one
54
+ invocation. Do not stop an app that is already running for this recovery, start a
55
+ different target, reinstall, change settings/accounts or broaden the operation.
56
+ Unknown app state calls for read-only discovery, not a guessed launch. Repeated
57
+ exit is a concrete failure to investigate and report, not an unlimited restart loop.
58
+
59
+ Tool consent, refusal and interruption controls take precedence. Report
60
+ "the tool reported input interruption", not "you were operating the app";
61
+ the report does not independently establish human activity or intent. Reobserve
62
+ through the same supported tool before any permitted retry. An interrupted
63
+ attempt is not proof of navigation or product failure. Preserve attempt budgets
64
+ across continuation and compaction; do not reset them by renaming the task,
65
+ switching tools to evade refusal, or receiving an automated completion reminder.
66
+
67
+ At a genuine blocker, state the exact missing permission/capability, consequence
68
+ and next action once, then continue any independent authorized work. Do not repeat
69
+ the same question or unchanged waiting message. If no safe work remains, use the
70
+ host's blocked/awaiting-input mechanism when available; otherwise give one truthful
71
+ partial handoff and wait for changed evidence or user input. A completion reminder
72
+ is not new consent, a retry-budget reset or evidence of success. Never mark an
73
+ unverified requirement passed merely to end the loop.
74
+
75
+ | Situation | Decision |
76
+ |---|---|
77
+ | Approved restart/check; exact app is confirmed stopped | Continue the approved start/check, including the one bounded recovery start when consent permits; do not ask again solely because a previous step finished. |
78
+ | App is already running, target differs, or consent was revoked | Observe the running app; obtain new consent only for the new disruptive action, never infer it from prior installation approval. |
79
+ | Tool reports interruption; user says they did not interact | Keep both facts separate, reread UI and follow the tool's permitted recovery; do not blame the user or bypass the tool. |
80
+ | Genuine approval is missing and the user is absent | Keep that action blocked, do other authorized work, and do not send repeated waiting messages. |
81
+ | Install/import checks pass but loaded version is unknown | Preserve partial status; neither a policy check nor disk evidence proves runtime acceptance. |
82
+
83
+ This policy is exposed by `agent.mjs describe/plan` and checked for drift, not
84
+ enforced by a runtime permission engine. It grants no new live-profile access and
85
+ does not bypass tool approvals, plugin-only ownership, required reviews or CI.
86
+
30
87
  ## Product and architecture
31
88
 
32
89
  ### Confirmed product scope (#455, #456)
33
90
 
91
+ Current source target: official DSH `0.2.2-rc.3`. The exact source commit and
92
+ dependency versions are recorded in `deployment-baseline.json` and `package.json`.
93
+
94
+ The native enhancement request (#460/#461) adds only reviewer-scoped Responses
95
+ sampling compatibility and an optional canonical-account hosted-search backend.
96
+ Use public native ownership/configuration proof and prepared dispatch; never
97
+ replace Web, select a backend, migrate accounts/settings, or bypass review.
98
+ Search permits one fixed capability proof and one final query within 25 seconds,
99
+ with four concurrent operations and configuration/credential/disposal fences.
100
+ The plugin settings may explicitly choose the native search model, defaulting to
101
+ automatic. List only the canonical account/native Responses intersection; metadata
102
+ is not search proof. Invalid or unavailable explicit choices fail without fallback.
103
+ Use a separate hidden volatile `nativeSearchModel` leaf with path-level CAS and
104
+ readback; never migrate or interpret the old `searchModel` as this choice.
105
+ The former plugin routing UI and managed Auto remain retired. Supplier calls,
106
+ live installation and restarts are separate from synthetic CI acceptance.
107
+
108
+ The user-authorized native model sync (#466, #479) is a narrow exception to the
109
+ no-settings-rewrite rule: after a visible preview and one explicit confirmation, one
110
+ revision-checked write may replace only
111
+ `llm-pi-ai.providers.github-copilot.models` in an existing canonical profile.
112
+ Prove current canonical-account metadata and the native adapter-owned catalog.
113
+ The explicit #508 direction changes this operation to ID-only account model
114
+ submission, not capability qualification: submit all enabled account IDs as
115
+ `{ id }` references without intersecting them with the native catalog. Do not copy,
116
+ correct or certify account capacity, input, image or reasoning facts here.
117
+ Unknown native IDs are advisory only, not skipped; do not invent definitions
118
+ or rewrite route defaults. Native validation may reject the entire update.
119
+ The native adapter owns inherited definitions, validation,
120
+ requests and their limitations. This does not weaken account capability proof
121
+ for search or other plugin-owned request paths. Disclose additions, updates,
122
+ removals and IDs absent from the native catalog, and that replacing customized entries removes their
123
+ per-model overrides and output request defaults. A successful sync is not
124
+ model-call compatibility evidence.
125
+ Prepare the preview without forced discovery from existing verified evidence.
126
+ An existing `compat.supportsStrictMode: false` may be preserved only when at
127
+ least one synced Responses or Completions model supports it; block other unproven
128
+ compatibility overrides. Recheck account/catalog/preferences and Settings evidence
129
+ before the one-shot write, then read back both user and effective values. Never create a profile,
130
+ change other paths or perform this sync automatically.
131
+
34
132
  The user-confirmed direction on 2026-11-14 supersedes conflicting legacy feature
35
133
  requirements below: this plugin is a lightweight GitHub Copilot model integration
36
134
  for DSH Desktop, not a second agent product. The qualification target is the exact
37
- official DSH `0.2.2-rc.3` source and published package graph; it is a candidate,
38
- not supported or delivered until the required CI gates pass.
135
+ official DSH `0.2.2-rc.3` source and published package graph. Each new revision
136
+ requires its own CI and release evidence; a previous release does not qualify it.
39
137
 
40
138
  DSH owns application login, AgentLoop, model selection, Auto, parent-model
41
139
  following, subagents, tools, Web, permissions, history, context/compaction, and
@@ -74,18 +172,35 @@ add model-ID routing rules, patch Core, or claim untested parity.
74
172
  When any later legacy detail in this guide conflicts with this confirmed scope,
75
173
  follow this section and the current acceptance criteria in #455/#456.
76
174
 
77
- The user clarified that the ordinary route should be DSH's native
78
- `github-copilot` provider, with only useful plugin enhancements through public
79
- APIs. Retire the separate managed route when native-route acceptance is met;
80
- do not preserve it solely to continue old conversations or create a history
175
+ The user clarified that the ordinary route is DSH's native
176
+ `github-copilot` provider, with useful plugin enhancements attached only through
177
+ public APIs. The production package registers no `github-copilot-preview`
178
+ provider; do not restore it to preserve old selections or create a history
81
179
  migration. Existing stored conversations, credentials and settings are not
82
- authorized for deletion or rewriting. Explicitly document that old managed
180
+ authorized for deletion or rewriting. Explicitly document that old preview
83
181
  route selections may become unavailable. Native model selection and actual
84
182
  subagent invocation must be verified on `github-copilot`, not inferred from
85
- managed-route tests. Record enhancements that cannot safely attach to native
183
+ legacy-route tests. Record enhancements that cannot safely attach to native
86
184
  APIs rather than patching Core or misrepresenting support.
87
185
 
88
- The last qualified release line is official DSH `0.2.1-rc.3`; its source/artifact CI passed on Windows/Linux in run `40098031196`, while Desktop artifacts/signatures remain unverified. DSH `0.2.2-rc.3` is the current requested candidate and has not passed this repository's required CI. The previous thirteen pins remain historical evidence, not current support or release gates. Do not treat either prerelease as a production Core upgrade recommendation. DSH's built-in `llm-pi-ai` owns the canonical GitHub Copilot provider, OAuth, grant format, token exchange, refresh, and normal model transport.
186
+ For official DSH `0.2.2-rc.3`, plugin `0.1.0-alpha.14.dsh.0.2.2.rc.3`
187
+ at `5d82df760683eeae7bb0413c946e4d25daef2049` passed the Windows/Linux
188
+ source/artifact CI in [run 43691055529](https://github.com/cloga/dsh-github-copilot/actions/runs/43691055529)
189
+ and was published to GitHub Releases and npm. This evidence is limited to that
190
+ revision; later changes require their own CI and publication evidence.
191
+ Desktop signatures, installation, loaded state, OAuth and supplier calls are not
192
+ established. The `desktopCandidateQualified: false` contract
193
+ tracks the unverified Desktop artifact/live-acceptance layer, not a failed CI.
194
+ Earlier pins are historical evidence, not current support gates. A prerelease
195
+ is not a production Core upgrade recommendation. DSH's built-in `llm-pi-ai`
196
+ owns the canonical GitHub Copilot provider, OAuth, grant format, token exchange,
197
+ refresh, and normal model transport.
198
+
199
+ Historical [#483](https://github.com/cloga/dsh-github-copilot/issues/483):
200
+ releases through alpha.12 could reject native schema-default compatibility
201
+ maps, blocking hosted-search proof and reviewer-only temperature omission.
202
+ The alpha.13 release includes a narrow fix; confirm live behavior independently.
203
+ Do not suggest profile edits as a workaround.
89
204
 
90
205
  The following is a historical architecture inventory, not a requirement to keep
91
206
  every surface as a product feature; apply the confirmed scope above when deciding
@@ -94,7 +209,7 @@ which runtime registrations, UI, and settings remain active:
94
209
  1. A conditional authorization-service bootstrap plus Host controller that joins DSH authorization, credentials, and settings.
95
210
  2. A Client Models provider-card contribution with one shared account-state owner, Client-safe Remote descriptors and a nested plugin-owned model-preferences disclosure; embed in an existing configured canonical row, suppress its separate footer controller, and retain footer/old-Core section fallback when no such row is mounted.
96
211
  3. Strict JSON normalization of pi-ai's provider-owned Copilot OAuth grant.
97
- 4. Preserve intentional absence of `llm-pi-ai.providers.github-copilot`; reconcile only existing legacy profiles and verified ownership journals. Fresh installations use the single account-discovered route; existing profiles require explicit migration, never silent removal.
212
+ 4. Preserve intentional absence of `llm-pi-ai.providers.github-copilot`; reconcile only existing legacy profiles and verified ownership journals. The confirmed #466 models-only sync is the narrow explicit exception above; never create or remove a native profile automatically.
98
213
  5. Direct provider-hosted search using the same Host-side credential lifecycle.
99
214
  6. Provider-scoped tool-schema compatibility for Copilot payload behaviors; Core remains the tool and execution owner.
100
215
  7. A bounded account-discovery route that supplies validated endpoint/capability metadata to the published native adapter, including explicit managed Responses sampling compatibility, plus exact plugin-owned model exclusions enforced across its directory, Auto pools and direct admission, without maintaining model-ID routing rules or changing Core's catalog.
@@ -110,22 +225,12 @@ projection may diagnose concrete failed-zero or invalid-sample incidents; ordina
110
225
  request progress and absent fresh sampling stay quiet. Never filter shared native
111
226
  usage, replace Core's meter, infer current occupancy/percentages or rewrite history.
112
227
  See [quota boundaries](./docs/copilot-usage.md).
113
- 12. Default-off local account/Checking/compaction diagnostics through public storage-domain and strict additive Remotes. Keep fixed-dimension Client/Host and logical/physical populations separate, with bounded handles/rows, 14-day retention, explicit loss/uncertainty and native commit evidence. Isolate the home-wide backend by public profile context, never account/Session identity; one writer per profile is required. No content, raw errors, identities/hashes, credential/history reads, ad-hoc files, Settings logs, upload, daily task or automatic repair. Aggregate and Auto controls remain independent. Separately consented `requestDiagnosticsEnabled` collects at most 128 content-free managed-adapter physical requests for 24 hours within the shared 2 MiB cap. Random stream groups/dispatch indices are not Session/turn identity or Core retry counts. Local body-write completion does not prove supplier receipt; abort attribution needs actual signal evidence, not EOF text. Never change transport/retries/Usage to obtain diagnostics. All controls use hidden volatile CAS leaves with exact readback; clear is a separately confirmed epoch fence. Missing/corrupt storage remains unavailable, never healthy empty data. Publication does not enable collection. See [local diagnostics](./docs/plugin-diagnostics.md).
114
-
115
- Auto aggregate assessment outcomes are fixed codes only; keep legacy missing reasons
116
- unrecorded and separate from new cohorts. Count decisions by selected/no-fit counts,
117
- not repeated candidate opportunities. Never change assessment policy, deadline or
118
- context safety merely to populate diagnostics; retain the shared storage/row bounds.
119
-
120
- Credential-change observations (#402) use the existing independent request
121
- consent: at most 128 fixed notification/commit rows and pending handles for 24
122
- hours within the shared 2 MiB cap. Derive reasons only from existing refresh
123
- checks, never new credential reads. No grant/record/identity/endpoint values or
124
- hashes; random change IDs join verdict phases only. Live-wire counts are not
125
- unique requests, retries or execution proof. Unknown source and missing legacy
126
- evidence stay unknown. Preserve #385 qualification/revocation; clear, pause,
127
- expiry and disposal fence later callbacks. Each diagnostic population, including
128
- Auto, is independently collapsed by default; opening it never enables collection.
228
+ 12. Local diagnostics is retired (#499): do not register its service, UI,
229
+ Remotes, storage or collectors. Preserve existing data and the four hidden
230
+ legacy settings without rewriting them; even true values do not enable
231
+ collection. Older releases may collect again if loaded with those settings.
232
+ Native Usage, context incident notices, immediate request errors and native
233
+ refresh qualification remain independent. See [retirement details](./docs/plugin-diagnostics.md).
129
234
 
130
235
  ## Session-policy compaction replay consent (#349, #352)
131
236
 
@@ -148,13 +253,50 @@ Safe background diagnostics use bounded Error cause chains and fixed allowlisted
148
253
  codes, never raw errors. Installation alone neither selects nor invokes recovery.
149
254
  See `src/compaction-replay.ts` and `docs/manual-compaction-recovery.md` (#349).
150
255
 
151
- ## Approved multi-account ownership extension (#297)
256
+ ## Approved multi-account ownership extension (#297, #474)
257
+
258
+ The user-approved #297 extension allows independently authorized
259
+ `github-copilot/account-<opaque-id>` records in DSH's credentials service.
260
+ The later explicit #474 direction supersedes the earlier prohibition on
261
+ canonical writes only for a user-confirmed global account switch: copy the
262
+ selected normalized OAuth grant into `llm-pi-ai/github-copilot` through the
263
+ public serialized credential API so DSH's existing native provider uses it.
264
+ Do not intercept native reads, patch Core, create a second provider as the
265
+ switching solution, or change model/history/provider settings. The selected
266
+ account applies profile-wide to future native requests; in-progress requests
267
+ retain their admitted credentials.
268
+
269
+ Before replacing a different configured canonical grant, preserve it in a new
270
+ plugin-owned account record unless the previous selected account already owns
271
+ that exact grant. Refuse when preservation would exceed the account bound. On
272
+ later switches, synchronize the previous active account's saved grant from
273
+ canonical before replacement. Use exact per-record serialization/readback and
274
+ path-level Settings CAS. A failed Settings commit may roll back only while the
275
+ canonical record still exactly matches the attempted write; otherwise retain
276
+ data and report uncertainty. Fence native Agent turns, OAuth and account
277
+ mutations. Direct provider calls outside observable Agent turn lifecycle remain
278
+ outside the plugin's turn fence.
279
+ Refresh remains owned by native pi-ai `Models.getAuth()` and DSH
280
+ `modifyRecord()`; the pinned Copilot refresh keeps the refresh token stable.
281
+ If selection and canonical credential diverge after an external native sign-in,
282
+ show an actionable mismatch and require explicit recovery; never auto-migrate.
283
+
284
+ Keep the native UI and its canonical quota/search attribution. The
285
+ `github-copilot-preview` adapter remains compatibility code but is not
286
+ registered by the production package entry. Session account overrides are not
287
+ evidence of native-provider behavior or a reason to register a second model
288
+ provider. Disposal removes only plugin registrations. Native model selections
289
+ remain native; explicit `web.searchProvider=github-copilot-hosted` needs a
290
+ user-selected replacement before uninstall. Missing configured Web backends return
291
+ `WEB_PROVIDER_CONFIGURED_MISSING`, not automatic fallback. Uninstall leaves the
292
+ last selected grant in the native canonical record. No automatic
293
+ Settings/history migration or sign-out.
152
294
 
153
295
  Login environments (#424) use only pinned native pi-ai OAuth for GitHub.com and
154
296
  validated single-label `tenant.ghe.com` Enterprise Cloud hosts. Preserve host
155
297
  binding through identity, duplicate checks, reauthorization and native refresh/
156
298
  discovery/request auth. Plugin identity rejects redirects; native OAuth redirect
157
- control is unavailable in pi-ai 1.1.0 and must not be claimed or emulated with a
299
+ control is unavailable in pi-ai 1.3.0 and must not be claimed or emulated with a
158
300
  global Fetch patch/second flow. GHES and Enterprise quota remain unsupported.
159
301
  See `src/copilot-login-environment.ts` and `docs/copilot-accounts.md`.
160
302
 
@@ -166,15 +308,15 @@ metadata-only Retry; late results and disposal cannot publish stale state.
166
308
  Never apply this deadline to add/cancel/switch/reauthorize/remove mutations,
167
309
  release their fences, cancel Host work or introduce an automatic retry.
168
310
 
169
- Account display names survive freshness expiry in bounded Host memory, never credential invalidation or failed verification. Visible account lists may ensure missing configured names without activating accounts; no disk name cache, credential copying or identity-based authorization. Turn admission captures the first verified name for the frozen account. A missing name may be filled by one existing nonforcing account-bound lookup only during that exact active, uncancelled turn/signal; never after turn/end/disposal. Evidence still requires actual native delivery and never reconstructs completed history (#322).
311
+ Account display names survive freshness expiry in bounded Host memory, never credential invalidation or failed verification. Visible account lists may ensure missing configured names without activating accounts; no disk name cache, incidental credential copying or identity-based authorization. Only the explicit confirmed native-switch preservation/projection above may copy a normalized grant. Turn admission captures the first verified name for the frozen account. A missing name may be filled by one existing nonforcing account-bound lookup only during that exact active, uncancelled turn/signal; never after turn/end/disposal. Evidence still requires actual native delivery and never reconstructs completed history (#322).
170
312
 
171
- The user approved independently authorized account records in the existing DSH credentials service. The canonical `llm-pi-ai/github-copilot` record remains unchanged as the compatibility account. Additional plugin-owned `github-copilot/account-<opaque-id>` records must be written directly by official pi-ai OAuth through public account-bound stores; never copy/move grants, refill the canonical record, introduce a separate credential storage service, patch Core, or implement another wire/catalog. Native `Models.getAuth()` and DSH `modifyRecord()` remain the refresh and serialization owners.
313
+ Additional plugin-owned `github-copilot/account-<opaque-id>` records are written directly by official pi-ai OAuth through public account-bound stores. Only an explicit user-confirmed switch may project a selected normalized grant into the canonical record as specified above; preserve the former canonical grant before the first replacement. Never intercept Core credential reads, introduce a separate credential service, patch Core, or implement another wire/catalog. Native `Models.getAuth()` and DSH `modifyRecord()` remain the refresh and serialization owners.
172
314
 
173
- Settings store only the opaque global account selector and explicit `sessionAccounts` rows. Missing/invalid selectors or records fail explicitly, without another-account fallback. Models manages reauthorization/removal and the global default; Credits may select an already authorized account for this Session's subsequent turns, restore global inheritance or run add-only authorization without selecting it (#305/#318). An explicit choice equal to the default remains explicit. Freeze account ownership before Auto assessment and request admission, holding mutation fences until native `turn/end`/disposal; later Session/default changes never redirect running steps, retries or search. Account-local credentials, metadata, quota, proof cancellation and native adapter composition must remain isolated. Keep one public adapter/controller registration, with no second wire/catalog or Core changes. Reauthorization/removal of a pinned record stays blocked; global-default selection may continue independently.
315
+ Settings store only the opaque global account selector and explicit `sessionAccounts` rows. Missing/invalid selectors or records fail explicitly, without another-account fallback. Models manages account authorization and the global default; Credits may select an already authorized managed-route account for this Session's subsequent turns or restore global inheritance (#305/#318). An explicit choice equal to the default remains explicit. Freeze account ownership before request admission, holding mutation fences until native `turn/end`/disposal; later Session/default changes never redirect running steps, retries or search. Account-local credentials, metadata, quota, proof cancellation and native adapter composition must remain isolated. Keep one public adapter/controller registration, with no second wire/catalog or Core changes. Reauthorization/removal of a pinned record stays blocked; global-default selection may continue independently.
174
316
 
175
- Account selection shows the current account and a compact Switch dropdown with no account search, never a flat unbounded account list. Mark the current choice, scroll long lists internally and place Add at the bottom. Saved-account reauthorization/removal remains in a separate management disclosure. One Models Manage disclosure contains account management and cross-account exact-ID model preferences. Continuation settings belong beside account controls. Persist the initial default-on epoch and later global changes with path-level CAS; only unseeded Sessions born after a known epoch inherit it, never retroactively enroll existing/unknown/forked histories. Normal Client continuation uses only the persistent Session policy; no next-turn-only or temporary-recovery duration choices. Explicit-off account changes require persistent-enable/keep-off/cancel choices, then fresh account revision readback before CAS. Exact replay failures offer loss-disclosed persistent Enable/Cancel when off, diagnostics without repeated authorization when on. Missing policy evidence fails explicitly, never a temporary authorization fallback. Retain old next-turn/recovery strict Remote contracts and Host admission for compatibility; failure-evidence expiry does not disable the persistent policy. No automatic send/retry, history writes, private Settings navigation or inferred encrypted account origin. The approved synthetic mock and current navigation limit are documented in [account management](./docs/account-management-experience.md).
317
+ Account selection shows the current account and a compact Switch dropdown with no account search, never a flat unbounded account list. Mark the current choice and scroll long lists internally; Add and saved-account reauthorization/removal remain in Models, not Credits. One Models Manage disclosure contains account management and cross-account exact-ID model preferences. The former new-Session continuation default is not shown now that the managed route is retired; preserve existing settings and compatibility contracts. The historical default-on epoch and later changes use path-level CAS; only unseeded Sessions born after a known epoch inherit it, never retroactively enroll existing/unknown/forked histories. Normal Client continuation uses only the persistent Session policy; no next-turn-only or temporary-recovery duration choices. Explicit-off account changes require persistent-enable/keep-off/cancel choices, then fresh account revision readback before CAS. Exact replay failures offer loss-disclosed persistent Enable/Cancel when off, diagnostics without repeated authorization when on. Missing policy evidence fails explicitly, never a temporary authorization fallback. Retain old next-turn/recovery strict Remote contracts and Host admission for compatibility; failure-evidence expiry does not disable the persistent policy. No automatic send/retry, history writes, private Settings navigation or inferred encrypted account origin. The approved synthetic mock and current navigation limit are documented in [account management](./docs/account-management-experience.md).
176
318
 
177
- Use hidden volatile `sessionAccounts` with path-level SettingsForms CAS, readback and restart evidence. Session account Remotes use explicit viewed IDs, native Agent lookup and strict codecs, never automatic Client scope. Credits uses that Session's account for identity/quota, rejecting mismatched or late results. Historical Account is an additive assistant-actions disclosure beside native Usage, captured only after a real ordinary native chunk; bounded Host-lifetime evidence becomes unknown after restart/eviction and is never reconstructed from today's settings. No new durable events, history/default/model/Usage writes, automatic account fallback, replay deletion or message retry. See [the requirements and acceptance gates](./docs/copilot-accounts.md).
319
+ Use hidden volatile `sessionAccounts` with path-level SettingsForms CAS, readback and restart evidence. Session account Remotes use explicit viewed IDs, native Agent lookup and strict codecs, never automatic Client scope. Credits uses that Session's account for identity/quota, rejecting mismatched or late results. Historical Account is an additive assistant-actions disclosure beside native Usage, captured only after a real ordinary native chunk; bounded Host-lifetime evidence becomes unknown after restart/eviction and is never reconstructed from today's settings. Account-only model membership may use explicitly configured native IDs outside the native catalog, but never expands reviewer/search protocol qualification or proves model capability. Preserve native ownership, canonical-account matching and credential/configuration revocation. No new durable events, history/default/model/Usage writes, automatic account fallback, replay deletion or message retry. See [the requirements and acceptance gates](./docs/copilot-accounts.md).
178
320
 
179
321
  ## Retired model-role compatibility boundary (#158)
180
322
 
@@ -187,8 +329,14 @@ Alpha.25 admits native `subagent/descriptor` v3, already v3 in the retained rc.1
187
329
  - `src/index.ts`: authorization bootstrap, dependency-gated Host entry, settings registration, listener, and `ctx.web` provider composition.
188
330
  - `src/authorization-controller.ts`: sign-in/status/sign-out and route mutation.
189
331
  - `src/copilot-grant.ts`, `src/copilot-auth.ts`: strict grant normalization and narrow pi-ai `CredentialStore` adapter; canonical compatibility and explicitly selected account records follow the account-binding contract.
190
- - `src/client.ts`: `settings.models.provider-card` account UI, a `plugins.bundle.config` provider-routing page with Models/footer/section fallback, and independently managed optional Chat integration.
191
- - `src/web-search-routing-config.ts`, `src/web-search-routing-card.ts`: plugin-owned cross-provider live routing settings and the plugin-detail control surface. The user-facing page exposes only primary and fallback providers. Routing is stored directly under the existing `github-copilot` settings namespace at `searchRouting`, mutating both leaves via nested paths `['searchRouting', 'searchProvider']` and `['searchRouting', 'defaultSearchProvider']` in one CAS call; legacy separate routing namespaces are read as fallback only. Revisions coordinate between routing and legacy `searchModel` resets so subsequent edits do not false-conflict. Hosted-search safety settings remain schema-owned rather than a routine tuning form. The Models fallback retains routing only.
332
+ - `src/client.ts`: account and model controls, the native search-model setting,
333
+ and additive optional Chat integration through public slots.
334
+ - `src/native-copilot-access.ts`, `src/native-copilot-search.ts`,
335
+ `src/native-search-model-card.ts`: proof-bound canonical hosted search in
336
+ DSH's existing Web service and its explicit model choice.
337
+ - `src/web-search-routing-config.ts`, `src/web-search-routing-card.ts`: retained
338
+ legacy routing code and compatibility exports; the old routing UI and facade
339
+ are not mounted current behavior. Never reactivate them implicitly.
192
340
  - `tests/fixtures/reasoning-presentation-core.fixture.ts`: native blank-reasoning rendering acceptance and independent Auto/Usage mount evidence. Do not restore the retired plugin renderer/provenance projection or change messages, replay indexes or Usage.
193
341
  - `src/remote.ts`: Typert Remote contribution. Never add credential payloads here.
194
342
  - `src/copilot-usage-host.ts`, `src/copilot-usage-remote.ts`, `src/copilot-usage-card.ts`, `src/copilot-usage-ui.ts`: bounded Host quota snapshots, an independent strict namespace and reversible composer presentation. No real account fetches in tests, private Client store/DOM injection, quota-specific credential owner or general model wire.
@@ -206,17 +354,18 @@ Alpha.25 admits native `subagent/descriptor` v3, already v3 in the retained rc.1
206
354
  - `src/temporary-models.ts`: exact, account-gated corrections with semantic protocol/capability retirement.
207
355
  - `src/model-protocol.ts`: explicit Core capability detection and conservative legacy fallback.
208
356
  - `src/responses-reasoning.ts`, `src/responses-reasoning-text.ts`: selected-model effort mapping and public summary assembly.
209
- - `src/tool-schema-compat.ts`: Copilot-only prompt-assembly filter for unusable escalation arguments and action-specific Goal update schemas.
210
- - `src/plan.ts`: Copilot-only, fail-closed hosted-search candidate lifecycle.
211
- - `src/auto-assessment-evidence.ts`: bounded request-local semantic classifier milestones copied into strict ephemeral turn evidence; no prompts, replay, credentials or error bodies. Total includes preparation; adapter start and first text are not HTTP dispatch/byte timings. Keep one configured monotonic deadline (30s default, 1000–120000ms) checked at preparation/native request/result boundaries and 128-token compact output; delayed timer settlement is not a real-time guarantee. The user-approved budget trial is not calibrated latency or proof of past timeout causes. Empty classifier setting retains metadata-driven automatic selection; a nonempty exact account ID preserves proof/exclusion/text/headroom guards, never a virtual Auto ID or silent alternate-model fallback. Both native volatile Config leaves affect future assessments and preserve admitted turns. Prefer eligible supplier-advertised reasoning-off classifiers, but request off only when supplier and public prepared-model effort agree; unsupported native controls stay unchanged. No guessed optimal/latency ranking, benchmark requests, adaptive timeout, cooldown or cross-turn cache without reviewed observations.
212
- - `src/probe.ts`: bounded native-search capability proof.
213
- - `src/wire.ts`, `src/wire-anthropic.ts`: inline hosted-search streaming.
214
- - `src/traditional-search.ts`: `github-copilot-hosted` `ctx.web` provider.
357
+ - `src/tool-schema-compat.ts`: Copilot-only prompt-assembly filter for unusable escalation arguments; Goal schemas remain native.
358
+ - `src/plan.ts`, `src/probe.ts`, `src/wire.ts`, `src/wire-anthropic.ts`,
359
+ `src/traditional-search.ts`: retained historical hosted-search and routing
360
+ implementation; current registration is owned by `src/native-copilot-search.ts`.
361
+ - `src/auto-assessment-evidence.ts`: retained historical classifier evidence;
362
+ plugin-owned Auto assessment and routing are not mounted. Preserve bounded,
363
+ content-free evidence without reactivating them.
215
364
  - `src/serialize.ts`, `src/sse.ts`, `src/failure.ts`: protocol conversion and bounded error handling.
216
365
  - `src/response-error-body.ts`, `src/request-body-timeout.ts`, `src/request-upload-evidence.ts`: bounded clone-only HTTP error evidence and safe managed upload-timeout guidance. Request-scoped public Node diagnostic events supply numeric local body-write/header/ALPN evidence only after an exact verified `408/user_request_timeout`; absent events, multiple native requests and work limits stay explicit. Always dispose subscriptions when Fetch settles, without changing its arguments, Response/errors, dispatcher, proxy or retry owner. Local body-write completion is not upload duration, kernel ACK, supplier receipt or execution; its absence does not prove incomplete upload. Native failure classification/retry metadata stay unchanged; final JSON bytes are not tokens or a payload limit. A separate explicit opt-in compression setting is default-off and never activated by a 408; never infer overflow, auto-compact, trim history, switch models or add retries from a 408.
217
366
  - `src/responses-request-compression.ts`: asynchronous `node:zlib` gzip at `Z_BEST_SPEED` only for exact account-proven official Copilot HTTPS `/responses` JSON POSTs through the existing public Fetch seam. `github-copilot.responsesRequestCompression` defaults false; enforce the 256 KiB minimum, 32 MiB compression-work bound and both 5%/4 KiB savings thresholds. Skips retain the original request with a fixed reason, and cancellation/account/deadline fences run before dispatch. No custom Fetch, other protocol, explicit `auto`/WebSocket, DNS/proxy/dispatcher changes, context-admission or replay changes, resend after an encoding rejection, or new retry. Gzip is wire encoding, not compaction or proof of supplier receipt.
218
367
  - Verified 408 error correlation (#276) adds only validated model/protocol, UTC header-observation time and strictly formatted `x-github-request-id` / `x-request-id` response IDs. Missing/malformed IDs stay unavailable; no other header values or new persisted population. IDs do not prove receipt/execution, and zero/unknown image composition cannot justify image-budget guidance.
219
- - `src/request-body-evidence.ts`, `src/request-body-composition.ts`: bounded numeric original-JSON spans for verified 408s and separately consented request observations. Keep replay validation/recovery at 16 MiB; only diagnostic composition may use the 32 MiB cooperative scanner with 64 Ki-character yields, a two-second monotonic deadline and four scan slots. Do not build a full payload object graph or decode image/replay values. Conversation/tool definitions/top-level system/residual partition total bytes; structural image and opaque replay spans are disjoint conversation subsets. Unknown/limited/cancelled evidence stays explicit. Opted-in large scans start after Fetch invocation without delaying ordinary native delivery; retained numeric rows may update after settlement only behind consent/clear/retention/eviction fences. Retain source strings only for bounded in-flight counting, never in storage/logs. Fetch-to-header time excludes analysis and is not upload duration. With gzip, report original JSON and prepared HTTP-body bytes separately; neither establishes delivered bytes. No automatic mitigation, timeout/retry changes or supplier-limit claim.
368
+ - `src/request-body-evidence.ts`, `src/request-body-composition.ts`: bounded numeric original-JSON spans for verified 408 guidance only. Keep replay validation/recovery at 16 MiB; error composition may use the 32 MiB cooperative scanner with 64 Ki-character yields, a two-second monotonic deadline and four scan slots. Do not build a full payload object graph or decode image/replay values. Conversation/tool definitions/top-level system/residual partition total bytes; structural image and opaque replay spans are disjoint conversation subsets. Unknown/limited/cancelled evidence stays explicit. Retain source strings only for bounded in-flight counting, never in storage/logs. With gzip, report original JSON and prepared HTTP-body bytes separately; neither establishes delivered bytes. No automatic mitigation, timeout/retry changes or supplier-limit claim.
220
369
  - `src/copilot-stream-liveness.ts`: request-local HTTP/SSE byte-idle observation, paired with the public native adapter's bounded assistant-chunk deadline. Default five-minute byte idle and ten-minute semantic silence; no fake assistant output, private watchdog access, new retry or Core patch. Consumer think time is excluded; explicit WebSocket/auto stays native-only. `chatStreamLiveness: false` restores native-only timing. `chatMaxRequestImageBytes` retains Core's 20 MiB default; smaller explicit settings authorize only native image offload, not hidden history trimming or a guessed supplier limit. Synthetic heartbeat evidence is not production heartbeat proof.
221
370
  - `tests/`: unit and integration evidence; mirror the source area being changed.
222
371
  - `deployment-baseline.json`: declared machine-readable compatibility and capability evidence inventory.
@@ -225,6 +374,10 @@ Alpha.25 admits native `subagent/descriptor` v3, already v3 in the retained rc.1
225
374
 
226
375
  ## Non-negotiable invariants
227
376
 
377
+ The following two classifier and context-projection paragraphs are historical
378
+ constraints on retained plugin Auto code, not a current runtime feature or
379
+ authorization to reactivate it.
380
+
228
381
  Auxiliary classifier disable proof accepts explicit supplier `off` or the
229
382
  selected protocol's native `none` (Responses/Completions) or `disabled`
230
383
  (Anthropic), scoped to the isolated classifier model only. Missing/empty effort
@@ -265,29 +418,37 @@ evidence is content-free and ephemeral, never a new persistent population.
265
418
  See `docs/copilot-accounts.md` (#385).
266
419
  - Copilot OAuth grant writes must rebuild only pi-ai's documented provider fields as a fresh plain JSON object; unrelated extension values never reach DSH credential storage.
267
420
  - Settings changes are path-level. Never replace the whole `llm-pi-ai` section or unrelated provider profiles.
268
- - Sign-out deletes only the active Copilot credential record and keeps other records, the selector and route settings. A missing selected noncanonical slot fails explicitly; only an explicit eligible Add or Switch recovers it, never automatic canonical fallback.
269
- - Hosted search serves either an eligible initiating `github-copilot` / managed `github-copilot-preview` route, or provider-owned independent search selected by the web-search router. Independent search preserves a nonempty explicit `searchModel` override; otherwise the Host considers at most three eligible Responses models from current account route facts, in deterministic ID order, without a static model list. Metadata alone is not search proof, and the final user query is sent once after candidate proof, never replayed across models. Both paths require an account-available model and supported search protocol; custom inline transport remains legacy-canonical only. Never substitute the global chat default or another Session's identity. The default `probe: true` path requires successful capability proof; `probe: false` is an explicit trust override, not an implicit fallback. Any request containing a file block, including one nested in tool-result content, must bypass the custom wire through `next()` so Core retains file projection ownership.
421
+ - Native sign-out deletes only `llm-pi-ai/github-copilot` and keeps plugin account records, the selector and route settings. A selected plugin account remains saved and must be explicitly applied again after sign-out; a missing selected slot fails explicitly, never automatic canonical fallback.
422
+ - The explicitly selected `github-copilot-hosted` backend uses the canonical native Copilot account and account-proven Responses models also present in the native catalog. Its configured model or deterministic first eligible model receives one fixed capability probe followed by one user query, without fallback or replay. Enforce the 25-second deadline, four-operation limit and account/configuration/disposal fences; metadata alone is not search proof. The old plugin router and custom inline transport are historical, not active alternatives. If that legacy wire is ever deliberately restored, file blocks, including nested tool-result files, must still delegate through `next()` so Core owns file projection.
270
423
  - Misconfiguration and API drift fail loudly with a named missing seam. Do not fall back to process-local secrets or implicit machine state.
271
424
  - Host, Client, and Remote package entries must stay independently buildable and exported.
272
425
  - The package must self-provide authorization when Core omits it, reuse an existing service without duplicate registration, and never activate the integration body before authorization is available.
273
426
 
274
427
  ## Session and migration ownership (V3, alpha.8, #99)
275
428
 
429
+ The following legacy managed-route/search design is historical. The plugin
430
+ router and managed Auto are retired, and removing the canonical native route is
431
+ not the current direction. Do not execute the old migration proposal; use the
432
+ confirmed scope above and the [current README](./README.md).
433
+
276
434
  - One global Host account supplies many models; selected/history-backed Sessions retain independent model context. Auto-mode native search derives from the captured initiating Session's effective request-header/config or explicit `GenerateOptions`, never another Session or future global default C. Fixed/fallback Copilot search uses the explicit provider-owned `searchModel` override when nonempty, otherwise bounded automatic account-owned Responses selection; it never borrows the Chat model, another Session's selection or the global chat default. `Agent.options` is the activation seed, not selected Session-model evidence; `installModelSelection` overrides request/assembly; Core records the effective `Session.requestHeader().config` before tools. Without proven request context, traditional search is unavailable. A newly selected pending model must not reuse the old request header as current prompt guidance. Per-owner plan caches prevent different-model A/B reuse/cancellation; metadata remains shared.
277
435
  - The ordinary Web search card selects only the primary and fallback providers and saves both routing leaves in one CAS mutation in the existing `github-copilot` namespace at `['searchRouting', 'searchProvider']` and `['searchRouting', 'defaultSearchProvider']`. It must not depend on Copilot model discovery, account credentials or a model selection to save routing. Capture traced Settings/routing Remote faces once per UI registration so parent renders do not reset drafts. Preserve a legacy nonempty `searchModel` override; display it read-only and reset it only through an explicit, separate narrow CAS setting `searchModel: ''`, never as a routing-save side effect. Because routing and `searchModel` share the `github-copilot` namespace and revision, successful mutation of either updates the other's expected revision to avoid false CAS conflicts while preserving unsaved drafts. Saving settings does not prove hosted-search capability.
278
436
  - Cold Chat picker and `/model` `listModels()` ensure the shared managed source without Settings first. Actual cold managed search non-forcing ensures metadata before deriving facts; existing 24h maximum TTL, cooldown, credential, allowlist and capability/probe gates remain.
279
437
  - Without `agents.currentInitiator`, traditional hosted search is unavailable with a named diagnostic; explicit marked `GenerateOptions` can still bind guarded inline requests, uncached if necessary. Credential notification during initial lazy discovery cannot distinguish own rotation from external account change via public status: fail closed with `WEB_PROVIDER_UNAVAILABLE` before probe/wire; a later user/driver request may retry, never automatically.
280
438
  - The new native Copilot draft warning says Save adds another real group, not a second account. Public additive APIs cannot veto Add or disable Save; this is warning-only, not enforced single-route registration. Core Edit/Delete remain.
281
439
  - Public `session.selectModel` also saves the future global default. Choose only approved Sessions/default; preserve other selected/history-backed Sessions, but do not promise unselected empty Sessions cannot inherit that default.
282
- - Code does not auto-migrate settings, credentials or history. After plugin release, approved Ops migration may compare-and-swap only the reviewed user-native `llm-pi-ai.providers.github-copilot` path after ruling out base/journal conflicts, then read back settings and registry. No hidden groups, bulk rewrites or credential copying. Search allowlist updates to the managed ID require a separate reviewed Ops edit; never silently broaden old lists.
440
+ - Code does not automatically migrate settings, credentials or history; only a user-confirmed account switch updates the canonical credential as described above. After plugin release, approved Ops migration may compare-and-swap only the reviewed user-native `llm-pi-ai.providers.github-copilot` path after ruling out base/journal conflicts, then read back settings and registry. No hidden groups, bulk rewrites or credential copying outside the explicit switch. Search allowlist updates to the managed ID require a separate reviewed Ops edit; never silently broaden old lists.
283
441
 
284
442
  ## Live migration readiness (alpha.9, #101)
285
443
 
444
+ Historical readiness evidence only: it is not an authorization or current plan
445
+ to remove the native provider or migrate settings.
446
+
286
447
  - Use no-argument `githubCopilot.migrationStatus()` for fresh live-Agent evidence; generic `session/list` may be stale and plugin inventory alone has no loaded-version evidence. `src/migration-status.ts` reads public leaves synchronously and reports loaded build `plugin.name/version`, `protocolVersion: 1`, `observedAt`, capability flags and completeness flags. Missing/unknown/incomplete is not safe absence.
287
448
  - Capabilities are `agentsList`, `sessionProjections`, `settingsCas`, `providerRegistry`, `defaultSelection`; `complete.sessions/defaultSelection/routes` describes evidence completeness, not migration approval. Effective selection uses pending projection, request-header config, then default only for genuinely empty Sessions with known projection state. Running `activeRequestSelection` is the latest recorded header, not proven in-flight LLM work. Native effective configuration and native/managed registration are separate flags.
288
449
  - This read invokes no auth status/model discovery, credentials or network and mutates no settings/Sessions. No normal UI/global current-model/search card is added. Nine ordinary authorization/model-preference Remotes retain their codec; the tenth migration Remote uses a separate strict `GitHubCopilotMigrationStatus` codec.
289
450
  - `historyScope: live-agents-only` excludes cold stored histories. Require operator acknowledgement that older conversations may need a new explicit selection later. Loaded version/structural capability self-reports are not full Desktop/Core byte attestation or an atomic cross-namespace guarantee; recheck immediately before CAS.
290
- - The planned `cloga/dsh-windows-ops` command `tools/migrate-copilot-managed-route.ps1` is separate config-only maintenance after release. V1 performs no automated Session/default writes, cold-history scan, plugin install, restart or full Desktop-baseline acceptance. Resolve selection blockers separately with explicit approval; never report this planned command or live migration as published/installed/completed without evidence.
451
+ - The earlier planned `cloga/dsh-windows-ops` command `tools/migrate-copilot-managed-route.ps1` is superseded: production no longer registers the managed model route, so provider-profile removal is not required. Never claim that this historical command or a live migration was published/installed/completed without evidence.
291
452
 
292
453
  ## Supported DSH seams
293
454
 
@@ -307,19 +468,32 @@ The retained upstream baselines and current qualification target are:
307
468
  - Official tag `dsh-v0.2.0-rc.2`, commit `639ed015397290b3745d163aafe02ffee4aa3f84`; the signed installed Windows Desktop descriptor identifies the rc.2 shared peer graph.
308
469
  - Official tag `dsh-v0.2.1-alpha.4`, commit `86a402200d95fecef4529d969836f1fe13c6cb0d`; historical alpha.16 source/npm qualification only.
309
470
  - Official tag `dsh-v0.2.1-alpha.5`, commit `1517a4dbca0a2789ff1d41ba439600f8547d23fa`; exact source/npm qualification is separate from unverified candidate Desktop artifacts/signatures.
310
- - Official tag `dsh-v0.2.1-rc.3`, commit `1f81c047fc48fa190a683e469daa699857e9afe8`; prerelease target with a public `WebRuntime` Volatile-provider contract change. Source and published artifacts require exact CI qualification; Desktop artifacts/signatures remain unverified.
311
-
312
- The release admission, development dependency and CI targets are exact official `0.2.1-rc.3`; the earlier thirteen pins remain historical evidence only. CI runs unchanged tagged-source and isolated exact published-npm-artifact fixtures on Windows and Linux. Public APIs require pi-ai `1.1.0`, Cordis `4.0.5`, cordis-plugin-loader `1.0.6`, schemastery `3.18.5` and storage-domain-compatible Zod `4.4.3`. The current fixture must await serialized `agent/created`, avoid new synchronous Session-history reads, and preserve MCP/PTC/workflow/Sandbox/Shell/image-offload/Team ownership. Native gateway fixtures bind an explicit public owner Peer and interactive Client carrier; Session-controller fixtures register native resources. Synthetic identities never authorize live access. Neither source nor synthetic tests prove live endpoints, plugin activation, publication or loaded runtime state. See the [rc.3 qualification evidence](./docs/official-first-021-rc3.md); passing source/artifact CI does not authorize Core implementation rewrites or experimental durable records.
471
+ - Official tag `dsh-v0.2.1-rc.3`, commit `1f81c047fc48fa190a683e469daa699857e9afe8`; historical prerelease with a public `WebRuntime` Volatile-provider contract change.
472
+ - Official tag `dsh-v0.2.2-rc.3`, commit `38a6a5c965aa99ab525161efb7cc5cf1fe62fced`; current source and published-package qualification target.
473
+
474
+ Release admission, development dependencies and CI target the exact current
475
+ Core in `package.json`; prior pins are historical. The exact pi-ai,
476
+ Cordis, loader, schemastery and Zod versions also come from package metadata.
477
+ CI runs unchanged tagged-source and isolated published-artifact fixtures on
478
+ Windows and Linux. Fixtures await serialized `agent/created`, avoid new
479
+ synchronous Session-history reads, and preserve MCP/PTC/workflow/Sandbox/Shell/
480
+ image-offload/Team ownership. Native gateway fixtures bind an explicit public
481
+ owner Peer and interactive Client carrier; Session-controller fixtures register
482
+ native resources. Synthetic identities never authorize live access. Source or
483
+ synthetic tests alone do not prove live endpoints, plugin activation,
484
+ publication or loaded runtime state. The [0.2.1-rc.3 review](./docs/official-first-021-rc3.md)
485
+ is historical; passing source/artifact CI never authorizes Core rewrites or
486
+ experimental durable records.
313
487
 
314
488
  These pins document compatibility evidence. They do not authorize creating another controlled Core patch or making one a prerequisite for new plugin fixes.
315
489
 
316
- - Models UI: `0.1.2-rc.1`, `0.1.3-alpha.1`, `0.1.5-alpha.1`, `0.1.5-alpha.2`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.6-alpha.1`, `0.1.6-alpha.2`, `0.2.0-rc.1` and `0.2.0-rc.2` expose `settings.models.provider-card`, keyed by settings namespace `llm-pi-ai`, to embed login/status/Refresh/Manage in a mounted configured canonical `github-copilot` row and suppress the separate footer controller. With no such row mounted, retain footer fallback; historical 0.1.1-rc.2 uses a dedicated `settings.section`. Preserve the shared account-state owner across transfer only while another eligible surface remains mounted. Unmounting the last surface or replacing declarations without overlapping mounts stops polling; a later controller reads status and separately non-forcing ensures missing/idle/stale/error/loading signed-in metadata, without replaying the old forced-login action. Manual Refresh models lives inside Manage; errors expose Retry. Opening Models is no longer guaranteed network-free, but status/details themselves remain pure. This additive slot cannot replace Core Edit/Delete: retain the native editor, while normal plugin discovery needs no manual model definitions. UI integration must not merge/remove actual canonical and `github-copilot-preview` routes or rewrite credentials, configuration, history or selection.
490
+ - Models UI: `0.1.2-rc.1`, `0.1.3-alpha.1`, `0.1.5-alpha.1`, `0.1.5-alpha.2`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.6-alpha.1`, `0.1.6-alpha.2`, `0.2.0-rc.1` and `0.2.0-rc.2` expose `settings.models.provider-card`, keyed by settings namespace `llm-pi-ai`, to embed login/status/Refresh/Manage in a mounted configured canonical `github-copilot` row and suppress the separate footer controller. With no such row mounted, retain footer fallback; historical 0.1.1-rc.2 uses a dedicated `settings.section`. Preserve the shared account-state owner across transfer only while another eligible surface remains mounted. Unmounting the last surface or replacing declarations without overlapping mounts stops polling; a later controller reads status and separately non-forcing ensures missing/idle/stale/error/loading signed-in metadata, without replaying the old forced-login action. Manual Refresh models lives inside Manage; errors expose Retry. Opening Models is no longer guaranteed network-free, but status/details themselves remain pure. This additive slot cannot replace Core Edit/Delete: retain the native editor, while normal plugin discovery needs no manual model definitions. Native account switching is the explicit, confirmed canonical credential exception above; other route, model, history and Settings ownership remains unchanged.
317
491
  - Canonical authorization flow key: `llm-pi-ai/github-copilot`; additional account flows bind directly to their own plugin-owned record under the approved #297 contract.
318
492
  - Authorization verification links recognize the public `window.dshDesktop.protocolVersion === 1` marker and use `_self` so Desktop's existing `will-navigate` handler opens the system browser without popup creation. Other hosts retain `_blank`; display a selectable manual URL in both cases. This does not confirm browser launch or OAuth success. Manage omits the compatibility disclosure but retains actionable legacy diagnostics and explicit repair; migration documentation and backend ownership are unchanged.
319
493
  - Authorization service: rc.1 Core provides it; the rc.2 web/headless profiles rely on this package's runtime dependency and conditional bootstrap.
320
494
  - Credentials: use record description/read/modify/delete APIs on the Host. Never read records in the browser.
321
495
  - Copilot grant schema: `type: oauth`, non-empty `refresh`/`access`, finite `expires`, optional non-empty `enterpriseUrl`, and optional deduplicated non-empty-string `availableModelIds`.
322
- - Settings: never recreate a missing `providers.github-copilot` profile. Existing native profiles remain user/Core-owned and require explicit migration before only the account-discovered route is listed.
496
+ - Settings: never recreate a missing `providers.github-copilot` profile. Existing native profiles remain user/Core-owned; production does not register a second account-discovered model route. Native model sync is an explicit, reviewed operation on an existing canonical profile.
323
497
  - Per-model API: do not assume stock Core honors a configured model.api. Verify the existing published behavior; where it cannot serve a model, use a plugin-local, exact-model alternative or report the limitation rather than patching Core.
324
498
  - Route activation: the dormant `llm-pi-ai` mount observes the profile and registers the route.
325
499
  - Client activation: package metadata injects DSH remotes and Models UI; `./client` mounts `./remote`.
@@ -327,9 +501,9 @@ These pins document compatibility evidence. They do not authorize creating anoth
327
501
  - Remote results: the nine ordinary authorization/model-preference methods retain the Zod v4 `GitHubCopilotAuthorizationView` strict codec required by rc.2 and accepted by rc.1. The tenth no-argument `migrationStatus()` method has a separate strict `GitHubCopilotMigrationStatus` codec; it does not change the ordinary auth contract.
328
502
  - Single-model saves use the additive `setModelExcluded(modelId, excluded)` Remote with an independent strict `GitHubCopilotModelPreferencesView` result. Preserve the ten existing descriptor identities/codecs. Do not read credentials, discover models or enumerate Sessions on this mutation path; confirm native CAS persistence before returning.
329
503
 
330
- When upgrading DSH or pi-ai, inspect the exact tagged public exports and update the baseline, compatibility guard, tests, and docs together. Apply the **official-first policy**: compare each customization's purpose against exact official source/contracts, classify complete/partial/unverified support, choose retain/migrate/retire, and record the remaining gap plus a concrete retirement trigger. Unverified parity is not evidence of absence. Prefer official behavior only after configuration/data migration, safety and runtime acceptance are reviewed; remove redundant paths and their obsolete tests without losing user-visible acceptance coverage. The current comparison is [official-first alpha.2](./docs/official-first-016-alpha2.md).
504
+ When upgrading DSH or pi-ai, inspect the exact tagged public exports and update the baseline, compatibility guard, tests, and docs together. Apply the **official-first policy**: compare each customization's purpose against exact official source/contracts, classify complete/partial/unverified support, choose retain/migrate/retire, and record the remaining gap plus a concrete retirement trigger. Unverified parity is not evidence of absence. Prefer official behavior only after configuration/data migration, safety and runtime acceptance are reviewed; remove redundant paths and their obsolete tests without losing user-visible acceptance coverage. The [alpha.2 comparison](./docs/official-first-016-alpha2.md) is historical, not the current release qualification.
331
505
 
332
- For alpha.25, source markers, local rc.1-backed focused tests and fifteen scoped exact-source runtime tests passed (alpha.2 contracts 8, Remote 1 and Session-context 6). Full local `pnpm verify` passed: 1373 Vitest tests with 2 expected skips, 176 tooling tests, typechecks, build and package smoke; pack/tarball verification passed. The scoped tests use a supplemental resolver with official TypeScript `6.0.3`, declared `mime-types@3.0.2` and `ws@8.21.0`, and shared Zod `^4.4.3`, without source/dependency patches, not the full official-root-helper closure. Broad frozen dependency installation is blocked by the configured mirror's HTTP 404 for `node-addon-require-builtin@0.1.6`, and candidate CI qualification has not executed. Keep these limits separate from live Desktop, published-artifact, OAuth and model-call compatibility; none is claimed.
506
+ For historical alpha.25, source markers, local rc.1-backed focused tests and fifteen scoped exact-source runtime tests passed (alpha.2 contracts 8, Remote 1 and Session-context 6). Full local `pnpm verify` passed: 1373 Vitest tests with 2 expected skips, 176 tooling tests, typechecks, build and package smoke; pack/tarball verification passed. The scoped tests used a supplemental resolver with official TypeScript `6.0.3`, declared `mime-types@3.0.2` and `ws@8.21.0`, and shared Zod `^4.4.3`, without source/dependency patches, not the full official-root-helper closure. That historical local mirror lacked `node-addon-require-builtin@0.1.6`; the observation is not the current CI status. Keep historical limits separate from live Desktop, published-artifact, OAuth and model-call compatibility.
333
507
 
334
508
  ## Code and documentation conventions
335
509
 
@@ -352,13 +526,45 @@ For alpha.25, source markers, local rc.1-backed focused tests and fifteen scoped
352
526
 
353
527
  ## Important-update release delivery
354
528
 
355
- - User-requested important updates include user-visible features, behavior fixes, compatibility fixes, and security or stability fixes. Their default delivery includes publication after a reviewed merge and green required CI; do not stop at a merged PR or ask a second time whether to release.
356
- - Explicit user restrictions such as code-only, review-only or do-not-release take precedence. Pure documentation and internal-only changes are not automatically release-bearing; they need an explicit release request if publication is desired. A task plan is not permission for an unrelated release.
529
+ - User-requested important plugin updates include user-visible features, behavior fixes, compatibility fixes, and security or stability fixes for plugin consumers. Their default delivery includes publication after a reviewed merge and green required CI; do not stop at a merged PR or ask a second time whether to release. Repository engineering features are not plugin features merely because they improve the project.
530
+ - Explicit user restrictions such as code-only, review-only or do-not-release take precedence. Pure documentation and internal-only changes are not automatically release-bearing; distributing them as plugin artifacts requires an explicit request for that artifact, not a generic delivery instruction. A task plan is not permission for an unrelated release.
357
531
  - Plan version alignment with the implementation PR whenever possible. If the prepared version/tag is unused and aligned, release it; otherwise prepare the next appropriate SemVer version through the normal PR path. Preserve the prerelease channel unless promotion is explicitly requested. Any additional version PR follows the same required review/CI and branch protection, without a separate merge-approval prompt.
358
532
  - Check all required CI, tag rules and package/archive checks. Create a fresh annotated tag only on the verified merged revision, let the protected Release workflow publish, and verify the non-draft Release, intended prerelease flag, tag/commit, assets and SHA-256. Never bypass failing CI, move a tag or substitute an unverified local archive.
359
533
  - A release-bearing update is not fully delivered until the published Release URL, verified version/commit/assets/checksum and npm version/SRI are reported. If CI, permissions or network prevents either channel, report partial delivery and the exact pending step; never describe merged-only or GitHub-only work as fully delivered.
360
534
  - This standing release authorization does not authorize profile installation, sign-out, worktree checkout or interruption of running Sessions. Keep published, installed-on-disk and loaded-runtime status separate; a session-interrupting restart still requires explicit acknowledgement.
361
535
 
536
+ ### Classify delivery before packaging (#502)
537
+
538
+ Choose the task's consumer impact before editing versions, installation URLs or
539
+ package contents. Record the classification and concrete rationale in the PR's
540
+ `Release delivery` section:
541
+
542
+ | Classification | Completion and artifact boundary |
543
+ | --- | --- |
544
+ | `repository-only` | Agent guidance, CI, tests, documentation governance and unshipped development tools complete at reviewed merge and green required CI. Keep the plugin version and package whitelist unchanged; no plugin release or local upgrade is needed. |
545
+ | `plugin-update` | An actual plugin runtime, compatibility or release-significant consumer-package change follows the important-update release gates above. A version/baseline/whitelist edit alone is not evidence of such a change. |
546
+ | `explicit-plugin-artifact` | An explicit request to distribute an engineering artifact as a plugin package may authorize that separate delivery. Record the actual artifact-specific request under `Authorization`; generic "deliver/publish" instructions or release-status questions are not that authorization. A version-only follow-through PR may instead cite the already reviewed and authorized plugin update; it needs no second approval. |
547
+ | `release-recovery` | Repair publication infrastructure or reconcile an already authorized version without a new version or changed consumer payload. Verify that existing release's outcome; do not describe reconciliation as a new plugin upgrade. |
548
+
549
+ Never add repository tools, fixtures or guides to `package.json.files`, or bump a
550
+ version, merely to make an engineering task releasable. If an intended change
551
+ touches an already shipped executable or other release-significant file, preserve the existing release-policy gate:
552
+ separate/defer that artifact change or establish its real consumer release scope,
553
+ never relabel it repository-only to bypass the gate. Preserve historical releases,
554
+ tags and package contents; this rule does not authorize unpublishing or repacking.
555
+ Documentation-only source edits, including packaged guides, may wait for the next
556
+ independently justified version without changing any already published bytes.
557
+
558
+ The existing PR `documentation-impact` check also checks this declaration against
559
+ the actual base/head manifests and important-file diff. It rejects repository-only
560
+ package changes and metadata-only manufactured plugin updates, and requires a
561
+ reviewable artifact-specific authorization statement for the explicit exception.
562
+ These are consistency checks, not proof of semantic impact or user consent; an
563
+ agent or human must review the rationale and actual request without adding a new
564
+ human-only approval gate. Report repository delivery, plugin publication,
565
+ installed-on-disk and loaded-runtime status separately. No runtime benefit means
566
+ no recommendation to install or restart merely because a new package exists.
567
+
362
568
  ## Installation-agent PowerShell practice
363
569
 
364
570
  Installation agents using the DSH `pwsh` tool must follow these rules:
@@ -382,8 +588,9 @@ plugin version. Attempt safe authorized checks on an already-running Desktop;
382
588
  unreliable local npm is not a reason to skip them. Use existing computer-use
383
589
  tools, never shell activation or a repository script as an App controller.
384
590
  Begin with current app discovery, not a historical "already open" claim. If not
385
- running, start only with explicit launch authorization via controlled `start_app`
386
- using the exact approved target; then verify discovery and fresh UI, not merely
591
+ running, start only with explicit launch authorization (including an applicable
592
+ restart/check approval retained under scoped autonomous execution) via controlled
593
+ `start_app` using the exact approved target; then verify discovery and fresh UI, not merely
387
594
  the launch receipt. Do not start an already-running app again. A welcome screen
388
595
  is not automatically an auth blocker: inspect an official safe skip first. DSH's
389
596
  Add API Key -> Set up later path does not submit/store a key or authenticate;
@@ -391,17 +598,22 @@ use it only when actually exposed, within tool permission rules. Never infer
391
598
  Copilot account invalidity from welcome UI or bypass real authentication/warnings.
392
599
  Welcome dismissal may replace the window: rediscover app/window and read its fresh
393
600
  tree before acting, rather than retrying a stale window on an empty immediate diff.
394
- Honor user-input interruption: reread UI before retrying the same permitted action.
601
+ Honor tool-reported input interruption without inferring human intent: reread UI
602
+ before retrying the same permitted action.
395
603
  Before handoff, freshly discover the current app and inspect the target panel or
396
604
  workspace, reporting the observation time only; past success does not establish
397
605
  current running state or guarantee the app remains running later.
398
606
  An action receipt or empty immediate diff is not a navigation failure: obtain
399
607
  a fresh post-action `get_window_state` observation first. Keep one attempt per
400
- supported navigation method, at most two different methods, then report precise
608
+ supported navigation method, at most two different methods. A tool-required
609
+ interruption recovery may retry that same method once after fresh observation;
610
+ it is not a new method or an unlimited retry exemption. Then report precise
401
611
  `automation-blocked` and request the named panel once. User absence or an
402
612
  unanswered request never grants permission or proves the panel opened.
403
613
  App unavailable, restart/install, account/OAuth/paid actions outside explicit
404
- permission stay blocked. Do not repeat exhausted methods on ordinary continuation.
614
+ permission stay blocked; first check whether the needed action is already covered
615
+ by scoped authorization. Do not repeat exhausted methods on ordinary continuation
616
+ or repeat an unchanged blocker message.
405
617
  Record only fixed action/outcome codes, numeric times and version/source facts;
406
618
  never upload identities, credentials or conversation content. Unknown loaded
407
619
  version permits qualified observations only, not a version-specific fix claim.
@@ -463,7 +675,17 @@ Then run `pnpm verify:tarball -- artifacts/dsh-github-copilot-<package-version>.
463
675
 
464
676
  If a historical/approved local installation attempt is blocked solely by an enterprise registry or network policy while GitHub Actions can obtain unchanged pinned packages from an authorized official registry, record it as **local validation blocked**, not passed. Do not repeat dependency recovery, switch sources, or expand permissions. A PR may proceed with that limitation disclosed; the complete required GitHub CI matrix, including install, tests, build and package checks, is authoritative before merge. Never weaken or skip CI, substitute dependencies, bypass organizational restrictions, claim unrun local gates succeeded, or tag/release a revision whose required CI is not green. If CI has the same failure, resolve it through approved infrastructure rather than bypassing it.
465
677
 
466
- The release CI matrix targets only exact official `0.2.1-rc.3` on Windows and Linux; earlier pins are not support gates. It runs the unchanged tagged-source runtime fixture, optional native Chat fixture, exact published-artifact adapter fixture and all 28 native reviewer regressions without skips. This is a required gate, not evidence that an unexecuted qualification passed. `verify:upstream` is static seam-marker evidence. `verify:controlled-core` exclusively installs a temporary config fixture, refuses an existing target, and removes only its own file; it is not full plugin activation. Published-artifact synthetic adapter fixtures do not prove live provider transport. The release job must wait for the complete reusable CI matrix on the tagged revision, then verify its own packed bytes before publishing.
678
+ The release CI matrix targets only the exact current Core on Windows and Linux;
679
+ earlier pins are not support gates. It runs the unchanged tagged-source runtime
680
+ fixture, optional native Chat fixture, exact published-artifact adapter fixture
681
+ and the reviewer regressions required by the current CI workflow without skips.
682
+ This is a required gate, not evidence that an unexecuted qualification passed.
683
+ `verify:upstream` is static seam-marker evidence. `verify:controlled-core`
684
+ exclusively installs a temporary config fixture, refuses an existing target,
685
+ and removes only its own file; it is not full plugin activation. Published-artifact
686
+ synthetic adapter fixtures do not prove live provider transport. The release job
687
+ must wait for the complete reusable CI matrix on the tagged revision, then
688
+ verify its own packed bytes before publishing.
467
689
 
468
690
  ### Evidence and side effects
469
691
 
@@ -482,7 +704,7 @@ The release CI matrix targets only exact official `0.2.1-rc.3` on Windows and Li
482
704
  | Last metadata display | Same-account data may display during TTL refresh/loading/error but never authorize requests; credential/account/permission invalidation or proof expiry immediately revokes evidence; TTL does not extend tokens |
483
705
  | Last-success timestamp (alpha.7, #97) | Show `snapshot.discoveredAt` once beside count outside Manage: English relative text, full LOCAL date/time/zone tooltip and accessible semantic `time`; missing/invalid/no account hides it, future uses absolute text. Pending/error retains last success, successful refresh replaces it and sign-out clears it. One mounted 60s display-only timer makes no RPC/status/discovery calls and is disposed with timestamp/unmount; cache/discovery lifecycle unchanged |
484
706
  | Definitive `UNKNOWN_MODEL` | One bounded metadata refresh, never message replay or automatic model switching; generic HTTP/network errors are not guessed to be unknown models |
485
- | README screenshot | `copilot-search-routing.png` shows the current built plugin-detail routing card with synthetic providers in an isolated browser fixture. It proves only the current presentation surface, not live credentials, provider availability, search success or Desktop activation. |
707
+ | Historical routing screenshot | `copilot-search-routing.png` records a retired plugin-detail routing card with synthetic providers; it does not depict the current UI or prove live search or Desktop activation. |
486
708
  | Host attach/restart | Does not repair or rewrite the stored native profile; search proofs stay lazy and do not start at attach |
487
709
  | Background credential/reset notifications | Invalidate evidence and clear Client state with read-only status; no forced discovery on every token event; next Models open/use ensures metadata |
488
710
  | Eligible model/search request | May resolve/refresh credentials and run bounded capability proof; changes during proof must fail closed rather than reuse another account's proof |
@@ -492,6 +714,10 @@ Never say GPT-6/search works merely because settings, typecheck or a package imp
492
714
 
493
715
  ## Changing capabilities
494
716
 
717
+ The plugin-owned Auto and parent-follow implementations described in historical
718
+ paragraphs below are not mounted current behavior. Preserve retained data and
719
+ compatibility code, but do not reactivate their routing or UI.
720
+
495
721
  Auto routing, assessment, cost weights, continuity and assistance changes must
496
722
  first read and validate `docs/auto-iteration-review.json` using
497
723
  `scripts/iteration-review.mjs`. Follow `docs/evidence-driven-iteration.md`:
@@ -560,7 +786,7 @@ Retain native Host agent lookup/access checks and strict codecs. Failed reads
560
786
  must remain distinct from successfully read missing evidence; Retry reads the
561
787
  same turn only and never replays inference. See #249.
562
788
 
563
- Parent-model following uses the profile-wide `github-copilot.followParentModel` switch (default false), with a single control in the plugin-detail page (#234). Never require per-session enrollment for the ordinary experience. Preserve legacy `parentModelFollow` bindings independently, including when the broad switch is off. `src/parent-model-follow.ts` and the Auto Host integration use public projections and per-turn scoped routing, never descriptor/history/default writes. Child-owned explicit selections win; enabling authorizes replacement of creation-time route snapshots, not removal of later picker history. Only supported native spawn children and managed Copilot parents participate; roots, other providers, fork descriptors and historical dedicated policies remain native. Missing eligible parent evidence fails explicitly. Settings changes preserve admitted turns, and Client saves use one path-level CAS without credentials/discovery. See `docs/parent-model-follow.md` for requirements/mockup and `docs/automatic-model-routing.md` for exact-source evidence.
789
+ Historical parent-model following used the profile-wide `github-copilot.followParentModel` switch and a plugin-detail control (#234). That routing and control are retired; DSH owns current parent/child behavior. Preserve legacy `parentModelFollow` data without reactivating the plugin policy, mutating descriptors/history/defaults or silently migrating settings. See `docs/parent-model-follow.md` and `docs/automatic-model-routing.md` for historical evidence.
564
790
 
565
791
  Model preferences must survive the Client's owned-field projection before strict decoding. `excludedModelIds` is a hidden volatile Config leaf, read via `readInlineConfig`; exercise native SettingsForms CAS, fiber preservation and restart persistence, not only map-backed settings mocks. Missing preference settings leave model rows read-only with named diagnostics and status-only Retry. Unknown exclusion state is not an empty exclusion set. Discovery diagnostics stay in a separate Manage disclosure. Selected models are excludable without scanning Sessions/defaults; the legacy `lockedModelIds` wire leaf stays empty. Check exclusion at new-turn admission through public `agent/request`, preserving only the same Session/turn/model and exact native request signal for subsequent steps/retries. Clear admission on `turn/end`. Direct/unbound requests and new turns remain excluded; never rewrite selections/history or switch models silently. Account/token/metadata/cancellation guards remain independent and revocable.
566
792
 
@@ -572,7 +798,16 @@ Auto intent continuity (#293) uses the strict `githubCopilotAutoModelIntent` pub
572
798
 
573
799
  1. Identify the owning seam using `agent-contract.json`; do not duplicate an upstream owner.
574
800
  2. Add or update focused tests before changing deployment claims.
575
- 3. Update both READMEs when user behavior, setup, migration, or boundaries change.
801
+ 3. Review both READMEs and every affected domain document against source for
802
+ user behavior, setup, migration, limitations, and evidence changes. Update
803
+ both READMEs and the relevant `docs/*.md` in the same PR for user-facing
804
+ changes, beyond version-only edits. For unchanged behavior, explain why.
805
+ The PR `Documentation impact` declaration is checked against changed files
806
+ and rechecked when edited; it cannot judge semantic accuracy or relevance.
807
+ An agent or human reviewer must check those claims against source and retain
808
+ dated historical evidence. Record findings in the PR. This is not a new
809
+ human-only approval gate; agents may complete the review and proceed when
810
+ actual GitHub review/CI requirements and authorization boundaries are met.
576
811
  4. Update `deployment-baseline.json`, `agent-contract.json` and their verifiers when the corresponding contract changes.
577
812
  5. Build before package smoke; never hand-edit `lib/`.
578
813