chore(local-plugins): record provider usage footer proof

Author: J-Giggles

AGENTS.md

@@ -102,6 +102,8 @@ Current topic order:
 3. `feat(runtime): preserve worktree context and controlled recovery`
 4. `feat(project-git): add project Git dashboard and VCS reconciliation`
 5. `feat(provider-settings): add usage, reset, and T3 access controls`
+   - Includes selected-provider usage icon and popover wiring in the chat composer footer, with headed chat-layout
+     smoke coverage so the popover cannot be replayed as an unused component.
 6. `feat(composer): add mentions, slash menus, chat context, and worktree naming`
    - Includes chat-layout protection for seeded history rows, context-window visibility, right-panel access, and
      terminal-drawer composer offsetting.

docs/operations/jordan-topic-stack.manifest.json

@@ -31,6 +31,7 @@
       "id": "provider-settings",
       "pluginPath": "local-plugins/provider-settings",
       "commits": ["cbabcf08e13af412f9feb57afbcc583b63f87f06"],
+      "replayFollowupCommits": ["a159898af2e75a9c87a82f3480db8e56b4e3b0dd"],
       "subject": "feat(provider-settings): add usage, reset, and T3 access controls"
     },
     {

docs/operations/jordan-topic-stack.md

@@ -41,6 +41,8 @@ installable Codex plugins.
 5. `feat(provider-settings): add usage, reset, and T3 access controls`
    - Owns provider usage state/UI, Codex native reset, T3 access settings, and
      provider interrupt/hang stabilization.
+   - Owns chat composer footer wiring for the selected-provider usage icon and
+     popover, plus headed chat-layout smoke coverage that proves it is visible.
 6. `feat(composer): add mentions, slash menus, chat context, and worktree naming`
    - Owns composer `@` mentions, slash menus, chat/terminal context
      attachments, semantic worktree naming, compact chat/sidebar stabilization,

docs/operations/staging-review-guide.md

@@ -617,6 +617,9 @@ Important implementation areas:
   hover/focus refresh path.
 - `apps/web/src/components/chat/ChatComposer.tsx` places the usage popover in
   the composer footer for the selected provider instance.
+- `apps/desktop/e2e/specs/chat-layout.spec.ts` requires the provider usage
+  button and popover alongside the context-window meter in headed Electron
+  smoke coverage.
 
 ### Why This Shape
 
@@ -644,6 +647,8 @@ Reviewers should check:
   provider instance and applies the updated provider list.
 - The usage icon color reflects the lowest remaining rate-limit window without
   overstating accuracy.
+- Headed chat-layout smoke fails if the composer footer has the context-window
+  meter but drops the selected-provider usage button.
 
 ### Suggested Manual Checks
 

local-plugins/provider-settings/README.md

@@ -12,6 +12,10 @@ Add provider settings for usage limits, provider-native reset behavior, and T3 a
 
 This is the provider settings topic from the June 25 replay stack.
 
+Replay support follow-ups currently listed in the nightly manifest:
+
+- `a159898af2e75a9c87a82f3480db8e56b4e3b0dd` `fix(provider-settings): restore composer usage popover`
+
 ## Added Features
 
 - [x] Provider usage and Codex limit state are exposed through provider settings modules (`apps/web/src/localTopics/providerSettings/index.ts`, `apps/server/src/localTopics/providerSettings/index.ts`).
@@ -21,6 +25,7 @@ This is the provider settings topic from the June 25 replay stack.
 ## Added UI
 
 - [x] Settings panels expose usage, reset actions, and T3 access toggles (`apps/web/src/routes/settings.providers.tsx`, `apps/web/src/localTopics/providerSettings/index.ts`).
+- [x] The chat composer footer exposes the selected provider usage icon and popover through thin composer wiring (`apps/web/src/components/chat/ChatComposer.tsx`, `apps/web/src/components/chat/ProviderUsagePopover.tsx`).
 
 ## Added Server And Runtime Behavior
 
@@ -30,6 +35,7 @@ This is the provider settings topic from the June 25 replay stack.
 ## Added Tests
 
 - [x] Provider usage ordering, reset behavior, settings contracts, and provider maintenance are covered by focused tests (`apps/server/src/provider/providerMaintenance.test.ts`, `apps/server/src/provider/Drivers/CodexNativeReset.test.ts`, `packages/contracts/src/provider.test.ts`).
+- [x] Headed Electron chat-layout smoke requires the provider usage footer button and popover alongside the context-window meter (`apps/desktop/e2e/specs/chat-layout.spec.ts`, `vp run --filter @t3tools/desktop e2e:smoke -- chat-layout.spec.ts`).
 
 ## Component Entrypoints
 
@@ -42,6 +48,7 @@ Componentization status: `complete`.
 
 - `apps/server/src/provider`
 - `apps/web/src/components/settings`
+- `apps/web/src/components/chat/ChatComposer.tsx`
 - `packages/contracts/src/provider.ts`
 - `packages/contracts/src/settings.ts`
 
@@ -65,14 +72,25 @@ export * from "../../components/settings/ProviderSettingsForm.tsx";
 export * from "../../components/settings/providerStatus.ts";
 ```
 
+`apps/web/src/components/chat/ChatComposer.tsx`
+
+```tsx
+<ProviderUsagePopover
+  environmentId={props.environmentId}
+  provider={props.selectedProviderStatus}
+  selectedInstanceId={props.selectedInstanceId}
+/>
+```
+
 ## Replay Notes
 
-Replay after project-git and before composer because composer provider menus consume stabilized provider state.
+Replay after project-git and before composer because composer provider menus consume stabilized provider state. Keep the composer footer usage wiring with this topic so the popover component is not replayed without a visible integration point.
 
 ## Verification
 
 - `vp check`
 - `vp run typecheck`
+- `vp run --filter @t3tools/desktop e2e:smoke -- chat-layout.spec.ts`
 
 ## Known Follow-Up Work
 

local-plugins/provider-settings/plugin.json

@@ -13,6 +13,14 @@
       "path": "apps/web/src/components/settings",
       "role": "source"
     },
+    {
+      "path": "apps/web/src/components/chat/ProviderUsagePopover.tsx",
+      "role": "source"
+    },
+    {
+      "path": "apps/desktop/e2e/specs/chat-layout.spec.ts",
+      "role": "test"
+    },
     {
       "path": "packages/contracts/src/provider.ts",
       "role": "source"
@@ -46,6 +54,10 @@
       "path": "apps/web/src/components/settings",
       "role": "thin-wiring"
     },
+    {
+      "path": "apps/web/src/components/chat/ChatComposer.tsx",
+      "role": "thin-wiring"
+    },
     {
       "path": "packages/contracts/src/provider.ts",
       "role": "public-facade"
@@ -63,5 +75,9 @@
       "role": "consumer"
     }
   ],
-  "verification": ["vp check", "vp run typecheck"]
+  "verification": [
+    "vp check",
+    "vp run typecheck",
+    "vp run --filter @t3tools/desktop e2e:smoke -- chat-layout.spec.ts"
+  ]
 }