@iowarp/clio-coder 0.5.0 → 0.5.1

package/dist/{slash-commands-ROG3KIFJ.js → slash-commands-MNKQ5QP3.js}

@@ -8,12 +8,12 @@ import {
   formatExtensionReloadNotice,
   handleRun,
   parseSlashCommand
-} from "./chunk-3LT34CAM.js";
+} from "./chunk-SAL2SBP4.js";
 import "./chunk-DGC6X6XR.js";
 import "./chunk-RFCKPS2V.js";
 import "./chunk-QUIJZSDW.js";
 import "./chunk-UCINIRHW.js";
-import "./chunk-OJXOA6YU.js";
+import "./chunk-TL6LNERH.js";
 import "./chunk-GGPF6LLE.js";
 import "./chunk-ISHUS7HC.js";
 import "./chunk-HOEDA42N.js";
@@ -35,7 +35,7 @@ import "./chunk-5LP5FNNR.js";
 import "./chunk-NVPXXW2H.js";
 import "./chunk-XZWSP67B.js";
 import "./chunk-BRCOSE7O.js";
-import "./chunk-55RMDDFM.js";
+import "./chunk-PGQG7ZMW.js";
 import "./chunk-L4N3DWNW.js";
 import "./chunk-CRHPCPZP.js";
 import "./chunk-6CTHLZFB.js";
@@ -104,4 +104,4 @@ export {
   handleRun,
   parseSlashCommand
 };
-//# sourceMappingURL=slash-commands-ROG3KIFJ.js.map
+//# sourceMappingURL=slash-commands-MNKQ5QP3.js.map

package/dist/{startup-background-KDWCQMWT.js → startup-background-PJMWTKVO.js}

@@ -5,14 +5,14 @@ import {
 } from "./chunk-BFOSV5EZ.js";
 import {
   endpointCapacityUsage
-} from "./chunk-LTWH2ACR.js";
+} from "./chunk-7FHSA7VB.js";
 import "./chunk-PECBKCDK.js";
 import "./chunk-OV62D6KO.js";
 import "./chunk-I4ELN5BX.js";
 import "./chunk-DXSETN72.js";
 import "./chunk-NFSK2VNU.js";
 import "./chunk-OZ76TLGU.js";
-import "./chunk-EOJPDNUP.js";
+import "./chunk-3OODBJ45.js";
 import "./chunk-BOBCCDJ6.js";
 import "./chunk-E6IPKW2E.js";
 import "./chunk-XMDBTYCH.js";
@@ -24,7 +24,7 @@ import "./chunk-ZU4JPCPR.js";
 import "./chunk-U5QU5ZOD.js";
 import "./chunk-DNHVRBH4.js";
 import "./chunk-O5F25NIE.js";
-import "./chunk-U6YTUVOX.js";
+import "./chunk-VMTCZ2GR.js";
 import "./chunk-SD7SHNDW.js";
 import "./chunk-7RET77VB.js";
 import "./chunk-YQ3GFEUY.js";
@@ -35,10 +35,10 @@ import "./chunk-SUTLW6ND.js";
 import "./chunk-RNDCROSG.js";
 import "./chunk-5LP5FNNR.js";
 import "./chunk-NVPXXW2H.js";
-import "./chunk-R7FGRZNF.js";
+import "./chunk-4D7QM7S5.js";
 import "./chunk-DOUISWEE.js";
 import "./chunk-VKHLUZNO.js";
-import "./chunk-OQ2EOAHA.js";
+import "./chunk-VWKR2NN5.js";
 import "./chunk-NDPF2N2L.js";
 import "./chunk-7QXCO3AF.js";
 import "./chunk-T33IYTZM.js";
@@ -48,7 +48,7 @@ import "./chunk-FD3IAHQM.js";
 import "./chunk-XNIZBOFV.js";
 import "./chunk-XZWSP67B.js";
 import "./chunk-BRCOSE7O.js";
-import "./chunk-55RMDDFM.js";
+import "./chunk-PGQG7ZMW.js";
 import "./chunk-L4N3DWNW.js";
 import "./chunk-TDGYTWM6.js";
 import "./chunk-CTFPFW3H.js";
@@ -244,4 +244,4 @@ async function prepareWorkerTargets(input) {
 export {
   prepareWorkerTargets
 };
-//# sourceMappingURL=startup-background-KDWCQMWT.js.map
+//# sourceMappingURL=startup-background-PJMWTKVO.js.map

package/dist/{system-ZDW44ZGX.js → system-IVVZRKGI.js}

@@ -1,7 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   runDoctor
-} from "./chunk-IN7DGBVS.js";
+} from "./chunk-FBXTHPNZ.js";
 import "./chunk-NOCSM22Y.js";
 import "./chunk-KW5HXKLJ.js";
 import "./chunk-URCXX7WJ.js";
@@ -139,4 +139,4 @@ export {
   inspectInterop,
   inspectSystem
 };
-//# sourceMappingURL=system-ZDW44ZGX.js.map
+//# sourceMappingURL=system-IVVZRKGI.js.map

package/dist/{targets-AJWA6E7Z.js → targets-RFRUMCQ5.js}

@@ -4,7 +4,7 @@ import {
   runConfigureCommand,
   runTargetRemove,
   runTargetRename
-} from "./chunk-EX57VVWW.js";
+} from "./chunk-GGEEG7CD.js";
 import "./chunk-HSQQFDB3.js";
 import "./chunk-LK2FN5JY.js";
 import "./chunk-N24R6KWS.js";
@@ -15,11 +15,11 @@ import {
   wrapPlain
 } from "./chunk-ZIDFQJRB.js";
 import "./chunk-R2CT5YDO.js";
-import "./chunk-4VDHLCF5.js";
+import "./chunk-M5FPIZQW.js";
 import "./chunk-HOYZUKG7.js";
 import "./chunk-QHSBROEW.js";
 import "./chunk-NASYVWDB.js";
-import "./chunk-IN7DGBVS.js";
+import "./chunk-FBXTHPNZ.js";
 import {
   ensureClioState
 } from "./chunk-NOCSM22Y.js";
@@ -1204,4 +1204,4 @@ function serializeStatus(status, extras = {
 export {
   runTargetsCommand
 };
-//# sourceMappingURL=targets-AJWA6E7Z.js.map
+//# sourceMappingURL=targets-RFRUMCQ5.js.map

package/dist/{terminal-lease-YFUSDPAD.js → terminal-lease-V2N2BIKQ.js}

@@ -3,7 +3,7 @@ import {
   ClioEditor,
   createBootWelcome,
   createProcessInteractiveShell
-} from "./chunk-R2UUNSNQ.js";
+} from "./chunk-O3ZAF7UY.js";
 import {
   GLYPH,
   clioTheme,
@@ -429,4 +429,4 @@ export {
   createProcessTerminalLease,
   instantShellEnabled
 };
-//# sourceMappingURL=terminal-lease-YFUSDPAD.js.map
+//# sourceMappingURL=terminal-lease-V2N2BIKQ.js.map

package/dist/{usage-XSILDHKF.js → usage-LA33SG3R.js}

@@ -1,16 +1,16 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   summarizeFailedCompactionUsage
-} from "./chunk-D3KWFOUT.js";
+} from "./chunk-DGMY2DWE.js";
 import "./chunk-GGPF6LLE.js";
 import {
   readOutOfTurnUsageRows,
   summarizeEvidenceIndex
-} from "./chunk-V35KZDUZ.js";
+} from "./chunk-GW2KVAVI.js";
 import "./chunk-4WOOTKFD.js";
 import {
   loadMemoryRecordsSync
-} from "./chunk-LTWH2ACR.js";
+} from "./chunk-7FHSA7VB.js";
 import "./chunk-PECBKCDK.js";
 import "./chunk-OV62D6KO.js";
 import "./chunk-I4ELN5BX.js";
@@ -25,7 +25,7 @@ import {
   parseSessionEntries,
   readAuditRows,
   responseModelIdObservationCountsLabel
-} from "./chunk-EOJPDNUP.js";
+} from "./chunk-3OODBJ45.js";
 import "./chunk-BOBCCDJ6.js";
 import "./chunk-E6IPKW2E.js";
 import "./chunk-XMDBTYCH.js";
@@ -40,7 +40,7 @@ import "./chunk-ZU4JPCPR.js";
 import "./chunk-U5QU5ZOD.js";
 import "./chunk-DNHVRBH4.js";
 import "./chunk-O5F25NIE.js";
-import "./chunk-U6YTUVOX.js";
+import "./chunk-VMTCZ2GR.js";
 import "./chunk-SD7SHNDW.js";
 import "./chunk-7RET77VB.js";
 import "./chunk-YQ3GFEUY.js";
@@ -68,10 +68,10 @@ import "./chunk-DNCE23JJ.js";
 import "./chunk-CDQ2UC6W.js";
 import "./chunk-5LP5FNNR.js";
 import "./chunk-NVPXXW2H.js";
-import "./chunk-R7FGRZNF.js";
+import "./chunk-4D7QM7S5.js";
 import "./chunk-DOUISWEE.js";
 import "./chunk-VKHLUZNO.js";
-import "./chunk-OQ2EOAHA.js";
+import "./chunk-VWKR2NN5.js";
 import "./chunk-NDPF2N2L.js";
 import "./chunk-7QXCO3AF.js";
 import "./chunk-T33IYTZM.js";
@@ -81,7 +81,7 @@ import "./chunk-FD3IAHQM.js";
 import "./chunk-XNIZBOFV.js";
 import "./chunk-XZWSP67B.js";
 import "./chunk-BRCOSE7O.js";
-import "./chunk-55RMDDFM.js";
+import "./chunk-PGQG7ZMW.js";
 import "./chunk-L4N3DWNW.js";
 import "./chunk-TDGYTWM6.js";
 import "./chunk-CTFPFW3H.js";
@@ -1080,4 +1080,4 @@ export {
   runUsageCommand,
   summarizePermissionDecisions
 };
-//# sourceMappingURL=usage-XSILDHKF.js.map
+//# sourceMappingURL=usage-LA33SG3R.js.map

package/dist/{wiki-generate-RP22WP5K.js → wiki-generate-HL73TICA.js}

@@ -2,14 +2,14 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   SchedulingDomainModule,
   createPromptsDomainModule
-} from "./chunk-3JLTRPN7.js";
+} from "./chunk-AKQ3N3L4.js";
 import {
   AgentsDomainModule
 } from "./chunk-UCINIRHW.js";
 import {
   createObservabilityDomainModule
-} from "./chunk-HQVN7G4F.js";
-import "./chunk-V35KZDUZ.js";
+} from "./chunk-QM7HFPQQ.js";
+import "./chunk-GW2KVAVI.js";
 import "./chunk-HOEDA42N.js";
 import {
   ResourcesDomainModule
@@ -27,7 +27,7 @@ import {
   buildWikiPagePrompt,
   buildWikiPlanPrompt,
   inspectWikiPageEvidence
-} from "./chunk-LTWH2ACR.js";
+} from "./chunk-7FHSA7VB.js";
 import "./chunk-PECBKCDK.js";
 import "./chunk-OV62D6KO.js";
 import "./chunk-I4ELN5BX.js";
@@ -36,7 +36,7 @@ import "./chunk-NFSK2VNU.js";
 import "./chunk-OZ76TLGU.js";
 import {
   SessionDomainModule
-} from "./chunk-EOJPDNUP.js";
+} from "./chunk-3OODBJ45.js";
 import "./chunk-BOBCCDJ6.js";
 import "./chunk-E6IPKW2E.js";
 import {
@@ -50,7 +50,7 @@ import "./chunk-ZU4JPCPR.js";
 import "./chunk-U5QU5ZOD.js";
 import "./chunk-DNHVRBH4.js";
 import "./chunk-O5F25NIE.js";
-import "./chunk-U6YTUVOX.js";
+import "./chunk-VMTCZ2GR.js";
 import "./chunk-SD7SHNDW.js";
 import "./chunk-7RET77VB.js";
 import "./chunk-YQ3GFEUY.js";
@@ -77,12 +77,12 @@ import "./chunk-CDQ2UC6W.js";
 import "./chunk-5LP5FNNR.js";
 import "./chunk-NVPXXW2H.js";
 import "./chunk-ZNUZ3EXD.js";
-import "./chunk-R7FGRZNF.js";
+import "./chunk-4D7QM7S5.js";
 import "./chunk-DOUISWEE.js";
 import "./chunk-VKHLUZNO.js";
 import {
   MiddlewareDomainModule
-} from "./chunk-OQ2EOAHA.js";
+} from "./chunk-VWKR2NN5.js";
 import "./chunk-NDPF2N2L.js";
 import "./chunk-7QXCO3AF.js";
 import "./chunk-T33IYTZM.js";
@@ -92,7 +92,7 @@ import "./chunk-FD3IAHQM.js";
 import "./chunk-XNIZBOFV.js";
 import "./chunk-XZWSP67B.js";
 import "./chunk-BRCOSE7O.js";
-import "./chunk-55RMDDFM.js";
+import "./chunk-PGQG7ZMW.js";
 import {
   declaredScopeIntent
 } from "./chunk-L4N3DWNW.js";
@@ -644,4 +644,4 @@ export {
   resolveDocumenterModelId,
   withWikiDispatchLifecycle
 };
-//# sourceMappingURL=wiki-generate-RP22WP5K.js.map
+//# sourceMappingURL=wiki-generate-HL73TICA.js.map

package/dist/worker/entry.js

@@ -15,7 +15,7 @@ import {
   sanitizeLockedSynthesisMessage,
   supportsNamedToolChoice,
   workerLoopBlockBudget
-} from "../chunk-GRHOXDKB.js";
+} from "../chunk-7KI4ZSEB.js";
 import {
   readLayeredSettings
 } from "../chunk-ZNUZ3EXD.js";
@@ -33,7 +33,7 @@ import {
   startAntigravityWorkerRun,
   startClaudeCodeWorkerRun,
   validateRehydratedWorkerRuntime
-} from "../chunk-R7FGRZNF.js";
+} from "../chunk-4D7QM7S5.js";
 import "../chunk-DOUISWEE.js";
 import "../chunk-VKHLUZNO.js";
 import {
@@ -45,7 +45,7 @@ import {
   resolveAgentTools,
   runtimeSpeaksResponseSchemaDialect,
   shouldRequestStalledTurnContinuation
-} from "../chunk-OQ2EOAHA.js";
+} from "../chunk-VWKR2NN5.js";
 import "../chunk-NDPF2N2L.js";
 import "../chunk-7QXCO3AF.js";
 import {
@@ -61,7 +61,7 @@ import {
 } from "../chunk-XNIZBOFV.js";
 import "../chunk-XZWSP67B.js";
 import "../chunk-BRCOSE7O.js";
-import "../chunk-55RMDDFM.js";
+import "../chunk-PGQG7ZMW.js";
 import "../chunk-L4N3DWNW.js";
 import "../chunk-TDGYTWM6.js";
 import "../chunk-CTFPFW3H.js";

package/docs/architecture/architecture.md

@@ -47,6 +47,7 @@ or CLI-owned feature areas.
 | plugins | `src/domains/plugins/**` | Plugin discovery, catalog, and lifecycle. |
 | prompts | `src/domains/prompts/**` | Prompt fragments, system prompt envelope, template hashing. |
 | providers | `src/domains/providers/**` | Target-first runtime registry, model probing, credentials. |
+| quota | `src/domains/quota/**` | Read-only subscription and credit readings from connected provider accounts, cached and normalized for the usage surfaces. |
 | resources | `src/domains/resources/**` | Package library, skills loader, prompts loader. |
 | safety | `src/domains/safety/**` | 10-step policy engine, path policy, zero-access rails, audit. |
 | scheduling | `src/domains/scheduling/**` | Budget ceilings, node cluster states, batch capacity checks. |

package/docs/architecture/context-engine.md

@@ -263,7 +263,7 @@ LM Studio 2.29.0 is that case today. Its OpenAI-compatible port returns `usage`,
 
 The verdict keeps its existing pi-ai path unless pi-ai reports `cacheRead === 0` while the backend reports a numeric `cachedTokens`. In that one case the same hot, partial, cold, and small thresholds are applied to the measured counts instead. No timing ratio or wall-clock heuristic participates in a verdict.
 
-`/context` renders the last call as `prefill: N uncached · M cached · X ms`, and falls back to `prefill: N prompt · X ms` when the server gave no cache figure. `/cost` folds every durable call in the session into a total uncached prefill plus the four verdict counts, `clio-coder usage report` carries the same two facts per session, and `clio-coder doctor` reports the latest session's verdict counts and its most frequent expected-cold reason without opening the TUI.
+`/context` renders the last call as `prefill: N uncached · M cached · X ms`, and falls back to `prefill: N prompt · X ms` when the server gave no cache figure. `/usage` folds every durable call in the session into a total uncached prefill plus the four verdict counts, `clio-coder usage report` carries the same two facts per session, and `clio-coder doctor` reports the latest session's verdict counts and its most frequent expected-cold reason without opening the TUI.
 
 The `/context` overlay closes the loop. When the last settled run came back `cold` and Clio had recorded a reason for it, the overlay adds a line naming that reason, for example `last cache-affecting events: working-set eviction (reuse measured separately)`, and reports the cache line without the warning token. A reused prompt shell with a cold backend and no recorded reason stays a warning: Clio kept the bytes stable and the provider re-prefilled anyway, which is a disagreement worth surfacing.
 
@@ -304,7 +304,7 @@ Submitting a task detaches an in-flight warm-up so interactive admission does no
 
 Each round appends one `prewarm` custom ledger entry carrying its trigger, the backend prompt tokens, `timing`, and `promptCache`. The entry is never rendered and never becomes a model message, so it contributes zero tokens to the context estimate.
 
-`/context` shows `prewarmed: N tokens in X ms` until the next settled run answers the question it asked. `prewarm` is never an expected-cold reason: a pre-warm is the opposite of a disturbance. Its provider usage is real spend and is reported to `/cost` and `clio-coder usage report` under its own row, the way a `/btw` side question is.
+`/context` shows `prewarmed: N tokens in X ms` until the next settled run answers the question it asked. `prewarm` is never an expected-cold reason: a pre-warm is the opposite of a disturbance. Its provider usage is real spend and is reported to `/usage` and `clio-coder usage report` under its own row, the way a `/btw` side question is.
 
 </details>
 

package/docs/architecture/observability.md

@@ -85,6 +85,8 @@ An `EvidenceIndexRow` has the following schema:
 
 ## Cross-Session Usage Facts
 
+Everything in this section describes what Clio itself recorded. Subscription quota is a separate source with separate meaning: `src/domains/quota/**` reads what each connected provider account reports about its own windows and credits, account-wide and shared across your sessions and devices, and nothing in that domain enters the cost ledger, the evidence spine, or the trace store. The `/usage` overlay shows both and keeps them in separate views, because a session's recorded tokens cannot be converted into a percentage of a provider's plan. See [Subscription quota and session usage](../guide/commands-and-modes.md#subscription-quota-and-session-usage).
+
 `clio-coder usage report` folds the local archive into one window of facts. Its token and cost facts come from two inputs: the per-session ledgers, folded through the session domain's `ledgerUsageCalls`, and the out-of-turn usage store described below. Both the text report and `--json` carry the same fields.
 
 | Field | Where it appears | Meaning |
@@ -92,7 +94,7 @@ An `EvidenceIndexRow` has the following schema:
 | `apiCalls` | `tokens in window: <total> over <n> model calls` and the `tokens` JSON fact | Provider calls folded in the window, out-of-turn rounds included. |
 | `input`, `output`, `cacheRead`, `cacheWrite`, `reasoningTokens`, `totalTokens` | the same line and fact | Provider-reported token breakdown for those calls. |
 | `costUsd` | `provider-reported cost in window` and the `tokens` fact | Provider-reported cost. Never estimated. |
-| `turns` | `turns in window` and the `tokens` fact | Folded calls that were turns, so labelled calls are subtracted exactly as `/cost` subtracts them. |
+| `turns` | `turns in window` and the `tokens` fact | Folded calls that were turns, so labelled calls are subtracted exactly as `/usage` subtracts them. |
 | `sideQuestions` | `side questions in window` and the `tokens` fact | `/btw` rounds in the window. |
 | `handoffs` | `handoffs in window` and the `tokens` fact | `/handoff` extraction rounds in the window. |
 | `prewarms` | `pre-warms in window` and the `tokens` fact | Prompt pre-warm rounds in the window. |
@@ -120,7 +122,7 @@ The row reads `top expected reason none` when the session recorded verdicts but
 
 ### The Out-of-Turn Usage Store
 
-A `/btw` side question and a `/handoff` extraction round are real provider calls that append nothing to the session JSONL, by design: a fleet run briefs its workers from the transcript, and a question the operator asked to orient themselves must not become context those workers inherit. The spend still has to be recorded somewhere durable, so it goes to `<stateDir>/usage/out-of-turn.jsonl`, one JSON line per priced call, written by the chat loop at the same moment it reports the call to `/cost`.
+A `/btw` side question and a `/handoff` extraction round are real provider calls that append nothing to the session JSONL, by design: a fleet run briefs its workers from the transcript, and a question the operator asked to orient themselves must not become context those workers inherit. The spend still has to be recorded somewhere durable, so it goes to `<stateDir>/usage/out-of-turn.jsonl`, one JSON line per priced call, written by the chat loop at the same moment it reports the call to `/usage`.
 
 The file is append-only NDJSON kept as a bounded ring (capped at 1000 rows, rewritten atomically under the shared state-file lock when it grows past the cap). Reads are tolerant: a malformed line is reported as a diagnostic on stderr and skipped.
 
@@ -155,9 +157,9 @@ Failed compaction attempts record one `failed-compaction` row per invoked summar
 
 New failed-compaction rows preserve missing usage fields as `null`. Positive partial-response facts survive an error that resets missing fields to zero. Ambiguous failed zeros remain unknown, reasoning is separate from ordinary output/total tokens, and an absent total is not inferred. Positive adapter prices are labeled `estimated`; zero or missing pricing is `unknown`, not a free-call claim. Existing numeric rows and historical checkpoints remain readable without rewriting them.
 
-`clio-coder usage report` includes these calls in its known subtotals, labels the failed-attempt count, and exposes `failedCompaction.knownUsage`, `erroredKnownUsage`, and per-field `unobservedUsageCalls` in the token and model JSON facts. A field with missing coverage and no known positive amount is `null`, including cost-only or wholly unobserved failures. Text output identifies incomplete subtotals. The live `/cost` view records positive known contributions under a failed-compaction label; its numeric token counters remain known subtotals. These figures do not certify provider billing or complete spending. The existing session-cost ceiling checks the numeric known sum, so unreported cost does not become an enforced complete-cost bound.
+`clio-coder usage report` includes these calls in its known subtotals, labels the failed-attempt count, and exposes `failedCompaction.knownUsage`, `erroredKnownUsage`, and per-field `unobservedUsageCalls` in the token and model JSON facts. A field with missing coverage and no known positive amount is `null`, including cost-only or wholly unobserved failures. Text output identifies incomplete subtotals. The live `/usage` view records positive known contributions under a failed-compaction label; its numeric token counters remain known subtotals. These figures do not certify provider billing or complete spending. The existing session-cost ceiling checks the numeric known sum, so unreported cost does not become an enforced complete-cost bound.
 
-In v0.5.0, eval tracked/stdout folds omit the failed-compaction sidecar, and live `/cost` reseeding reads the session ledger rather than this store. A later usage report can therefore include retained failed-compaction amounts that those views omit. These consumer projections remain separate; retained known amounts must not be presented as complete cross-surface billing.
+In v0.5.1, eval tracked/stdout folds omit the failed-compaction sidecar, and live `/usage` reseeding reads the session ledger rather than this store. A later usage report can therefore include retained failed-compaction amounts that those views omit. These consumer projections remain separate; retained known amounts must not be presented as complete cross-surface billing.
 
 A failed or empty summary produces no checkpoint. Required failed-compaction usage appends are flushed and a write failure remains an explicit operation error; no model call is repeated to repair accounting. If checkpoint append throws, Clio checks that checkpoint's exact identity in the original ledger before choosing the sidecar: an already written checkpoint is not counted again, and proven absence permits the sidecar. An unreadable or malformed ledger that leaves persistence ambiguous fails visibly without a speculative duplicate write. This is the existing bounded usage store, not a new recovery store; its 1000-row retention and unknown telemetry limits still apply.
 

package/docs/architecture/prompt-envelope-and-tools.md

@@ -316,7 +316,7 @@ Timing and cache behavior are persisted per API call, so a finished session can
 
 Native session timing uses a monotonic clock from each stream invocation, before the provider's response-header wait, to its first observed output (`ttftMs`) and completion (`apiMs`). A tool-loop continuation starts a new clock; no output leaves TTFT null, and a genuine rounded zero remains zero. Historical values are not rewritten and may omit the pre-header wait. Eval prefers these durable native call records. Its stdout-only fallback starts at the provider's `message_start` event, which can arrive after headers, so fallback spans are not complete request latency and must not be compared as equivalent measurements.
 
-For aggregate cost and token facts across sessions, use `clio-coder usage report --days <n>`. Inside the TUI, `/cost` shows session totals and `/context` opens the context-window ledger overlay.
+For aggregate cost and token facts across sessions, use `clio-coder usage report --days <n>`. Inside the TUI, `/usage` shows session totals and `/context` opens the context-window ledger overlay.
 
 ## Self-documentation retrieval
 

package/docs/architecture/session-lifecycle.md

@@ -167,7 +167,7 @@ cancels the whole handoff with nothing written in either session.
 The extraction round itself runs on the out-of-turn seam `/btw` uses: one call
 against the session's live target and model, the compiled message history as
 read-only input, no tools, and no entry in the ledger. Its provider usage is
-reported to `/cost` under a handoffs row and excluded from the turn count.
+reported to `/usage` under a handoffs row and excluded from the turn count.
 
 ### Streaming Turn Settlement During Session Transitions
 

package/docs/architecture/tui-design.md

@@ -203,7 +203,7 @@ Interactive startup uses one terminal lease across both boot stages. Stage 0 own
 The header has two operational modes: a framed launchpad dashboard on fresh start, and a single live session row after prompt admission. Source: `src/interactive/welcome-dashboard.ts`; contracts: `tests/extended/welcome-boot-header.test.ts`.
 
 - **Launchpad (before the first prompt): framed panel dashboard.** A boxed container (`buildWelcomeDashboardLines`) enclosed by `╭─ Clio Coder v<version> ─╮` and `╰─╯`:
-  - **11 Detail Rows:** Subhead/title ("Built for the code behind science."), model route status (`routeRow`), workspace path, permissions/autonomy (`stats.autonomy`), guidance ("Ask Clio how to use or extend her."), target inventory (`stats.targets`), and fleet recipes inventory (`stats.fleet`).
+  - **11 Detail Rows:** Subhead/title ("Built for the code behind science."), model route status (`routeRow`), workspace path, permissions/autonomy (`stats.autonomy`), guidance ("Ask Clio how to use or extend her."), target inventory (`stats.targets`), and fleet recipes inventory (`stats.fleet`). A `Subscriptions` field (`stats.quota`) joins the list between Targets and Fleet once a cached quota reading exists, wrapping at the detail-column width rather than clipping, and is absent entirely when no account is connected.
   - **Responsive Layout:** Renders wordmark ASCII art on the left at ≥76 columns (`sideBySide`), and rotating hint cards on the right at ≥160 columns (`WELCOME_HINT_MIN_WIDTH`) cycling commands and shortcuts every 15 seconds.
   - **Action Row:** A horizontal rule (`├─┤`) separates details from the action row (`actionRow`), which prints the next step or work blocker: no route or model (`/model`), route unavailable or degraded (`/settings targets`), malformed handbook (`CLIO-CODER.md malformed · /context to inspect`), uninitialized handbook (`describe a task · /context init to index this repo`), stale handbook (`describe a task · /context refresh to update it`), or default `describe a task · <SubmitKey> to send · / for commands`.
 
@@ -211,7 +211,7 @@ The header has two operational modes: a framed launchpad dashboard on fresh star
 
 - **Session header (after the first prompt): exactly one row, and live.**
   ```
-  >C_ Clio Coder v0.5.0 · dynamo · qwen3.8-27b · ~/iowarp/clio-coder · main*
+  >C_ Clio Coder v0.5.1 · dynamo · qwen3.8-27b · ~/iowarp/clio-coder · main*
   ```
   Collapsed via `sessionRow`, this line tracks mid-session model or branch mutations. It preserves identity (`>C_ Clio Coder v<version>`), active route, workspace tail, and git dirty state (`*`), dropping readiness and onboarding hints owned by the footer. Under extreme width pressure, the route is preserved longest, outliving workspace and version labels.
 
@@ -267,12 +267,12 @@ Starting Clio · you can type now
 Source: `src/interactive/footer/dashboard.ts`, `src/interactive/footer/pages.ts`.
 
 - **Compact Mode (Two-Line Ambient Strip)**:
-  - **Line 1 (Workload & Identity)**: Active phase (`accent` e.g. `Ready`) and worker counts (`agent` e.g. `· 2 active`) · Target/model identity (`fitIdentityLabel`) · Thinking level (`reason`) on the left; Context meter bar (8–14 cells) and token occupancy (`used / contextWindow`) on the right.
-  - **Line 2 (Status & Hints)**: Urgent input prompt (`Ctrl+C again to quit`, `Ctrl+G → choose key`), active notices (`• text`), demo tips, or rotating shortcut hints alternating with workspace path and git branch/dirty (`*`) on the left; Session throughput (`tok/s`) and dashboard toggle shortcut (`Alt+U`) on the right.
+  - **Line 1 (Workload & Identity)**: Active phase (`accent` e.g. `Ready`) and worker counts (`agent` e.g. `· 2 active`) · Target/model identity (`fitIdentityLabel`) · Selected model’s weekly quota (`weekly N% left`, when the local credential owner and model group are known) · Thinking level (`reason`) on the left; Context meter bar (8–14 cells) and token occupancy (`used / contextWindow`) on the right.
+  - **Line 2 (Status & Hints)**: Persistent workspace cwd and Git branch/dirty (`*`) on the left; rotating shortcut hints on the right. Urgent input prompts (`Ctrl+C again to quit`, `Ctrl+G → choose key`), active notices (`• text`), and demo tips borrow only the hint area. Quota never occupies this row.
 - **Expanded Mode (`Alt+U`)**: Renders across one-quarter of the viewport (minimum 8 rows), keeping the composer anchored below. Repeated presses cycle through three responsive pages (`DASHBOARD_PAGES`) and closed:
   1. `Activity`: Live agent phase, tool counts, session metrics, active worker cards (route, task, token usage, tool calls, timing, budget, `/view dispatch:<id>`), and finished worker history.
   2. `Context`: Context meter bar and category occupancy grid (system, tools, files, turns, memory), compaction/cache telemetry, headroom.
-  3. `Status`: Cost & Connections (session cost, MCP servers, plugins, extensions) and Local Machine metrics (CPU, memory, disk I/O sampled on 2s cadence), plus memory bank entries and free tokens.
+  3. `Status`: A session line (recorded tokens and tracked cost) above one compact row per connected subscription account (`renderQuotaAccounts`, `src/interactive/quota-view.ts`), then Cost & Connections (session cost, MCP servers, plugins, extensions) and Local Machine metrics (CPU, memory, disk I/O sampled on 2s cadence), plus memory bank entries and free tokens.
 
 ### 5.4 State Choreography Table
 
@@ -418,17 +418,20 @@ Agents and Fleets label plugin provider packages as `[plugin]` and show only the
 
 ## 8. Shared Vocabulary
 
-One quantity gets one word, and every surface that shows it uses that word. A user comparing the transcript, the footer, and an overlay is checking whether Clio is telling a consistent story; a synonym reads as a discrepancy. The current vocabulary is owned by `src/interactive/chat-panel.ts`, `src/interactive/cost-overlay.ts`, `src/interactive/status/reasoning.ts`, and `src/interactive/thinking-level-policy.ts`; there is no standalone `usage-vocabulary` contract test in the current tree.
+One quantity gets one word, and every surface that shows it uses that word. A user comparing the transcript, the footer, and an overlay is checking whether Clio is telling a consistent story; a synonym reads as a discrepancy. The current vocabulary is owned by `src/interactive/chat-panel.ts`, `src/interactive/usage-overlay.ts`, `src/interactive/status/reasoning.ts`, and `src/interactive/thinking-level-policy.ts`; there is no standalone `usage-vocabulary` contract test in the current tree.
 
 | Concept | Word | Surfaces |
 | --- | --- | --- |
-| One model API call | `call` | Chat panel `turn · in N over M calls`, `/cost` `model calls`, `/cost` `(avg/call …)` |
-| One user-to-assistant exchange | `turn` | Chat panel `turn · …`, `/cost` `turns` |
+| One model API call | `call` | Chat panel `turn · in N over M calls`, `/usage` `model calls`, `/usage` `(avg/call …)` |
+| One user-to-assistant exchange | `turn` | Chat panel `turn · …`, `/usage` `turns` |
 | Provider-reported reasoning tokens | `reasoning N provider` | Chat panel |
 | Reasoning tokens estimated from displayed text | `reasoning ≈N estimated` | Chat panel; the footer carries the same `≈` on `r≈N` |
-| Reasoning tokens in the cost tally | `reasoning N provider-reported only` | `/cost`. This tally never estimates, so it disagrees with the panel on a model that reports nothing, and the row says which one it is. |
+| Reasoning tokens in the cost tally | `reasoning N provider-reported only` | `/usage`. This tally never estimates, so it disagrees with the panel on a model that reports nothing, and the row says which one it is. |
 | Thinking level a model cannot turn off | `forced` | Editor rail, model overlay, thinking cycle (`thinkingLevelDisplayWord`) |
 | Thinking level on a model with only on and off | `on` / `off` | Same surfaces |
+| Consumed share of a subscription window | `N% used` | `/usage` Accounts, dashboard Status, welcome `Subscriptions`. A filled meter cell always means consumed capacity. |
+| Unconsumed share of the same window | `N% remaining` in a detailed meter, `N% left` in a compact badge | `/usage` Accounts and Status print `remaining` beside `used`; the compact footer, worker cards, and fleet islands carry `weekly N% left`. |
+| A limit belonging to the account rather than to this session | `Shared <account>` | Worker cards, fleet islands, `/usage` Workers. Never a measured per-worker share. |
 
 ### 8.1 Slash-Command Failures
 

package/docs/gui/parity/02-slash-and-surfaces.md

@@ -24,7 +24,7 @@ Two rows in the source are **corrupt Markdown**: an unescaped `|` inside the ope
 | 12 | Oracle advisory | `/oracle <question>` | **Absent** | No read-only record-briefed advisory operation exists. |
 | 13 | Council | `/council <task>` | **Partial** | Runs reconstructs the roster, plan approval, rounds, and synthesis shape from the ledger. Member voices are **host-only-by-design**; starting and sharing a council are absent. |
 | 14 | Agent reference | `/agents` | **Present** | Capability atlas provides the graphical recipe reference. |
-| 15 | Cost record | `/cost` | **Partial** | Exact tokens and historical reported cost exist, but live session cost, budget provenance, and provider-normalized totals are incomplete. |
+| 15 | Usage record | `/usage` | **Partial** | Exact tokens and historical reported cost exist, but live session cost, budget provenance, and provider-normalized totals are incomplete. |
 | 16 | Context family | `/context view \| compact \| recall \| init \| refresh \| reset` | **Partial** | `[RECONSTRUCTED]` — the source row is corrupt for the same reason. Verified against `src/interactive/slash-commands.ts:1695-1705`, whose `kinds` are `context-view, compact, context-recall, init, context-clear, context-refresh`. Reconstructed gap, consistent with the `Project context` row in part 1 and the `Context meter and overlay` row below: effective context sources and earlier replay are visible; live window pressure, working-set state, compaction, recall, and reset have no GUI surface. |
 | 17 | Fleet | `/fleet` settings and `/fleet run` preview/approval | **Partial** | Global dispatch status exists; fleet plan selection, variable binding, preview, approval, and run are absent. |
 | 18 | Decision ledger | `/decisions` | **Absent** | No typed decision-board projection reaches the GUI. |