@abide/abide 0.33.1 → 0.34.1

package/src/lib/bundle/disconnected.abide

@@ -147,90 +147,120 @@ async function saveConfig() {
 </script>
 
 <template if={phase === 'splash'}>
-  <div class="flex min-h-screen items-center justify-center bg-gray-50 dark:bg-gray-950">
-    <template if={logo}>
-      <img src={logo} alt="" class="h-16 w-16 rounded-xl object-contain opacity-90">
-    </template>
-  </div>
-  <template else>
-    <main class="flex min-h-screen items-center justify-center bg-gray-50 p-6 text-gray-900 dark:bg-gray-950 dark:text-gray-100">
-      <div class="w-full max-w-sm rounded-2xl bg-white p-8 shadow-sm ring-1 ring-gray-200 dark:bg-gray-900 dark:ring-gray-800">
+    <div class="flex min-h-screen items-center justify-center bg-gray-50 dark:bg-gray-950">
         <template if={logo}>
-          <img src={logo} alt="" class="mx-auto mb-5 h-16 w-16 rounded-xl object-contain">
+            <img src={logo} alt="" class="h-16 w-16 rounded-xl object-contain opacity-90" />
         </template>
-        <h1 class="mb-6 text-center text-xl font-semibold tracking-tight">{heading}</h1>
-
-        <form class="flex flex-col gap-3" onsubmit={(event) => { event.preventDefault(); void connect() }}>
-          <input type="url" bind:value={url} placeholder={placeholder} autocomplete="url"
-            class="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm outline-none focus:border-gray-900 focus:ring-1 focus:ring-gray-900 dark:border-gray-700 dark:bg-gray-800 dark:focus:border-gray-100 dark:focus:ring-gray-100">
-          <button type="submit"
-            class="w-full rounded-lg bg-gray-900 px-3 py-2 text-sm font-medium text-white hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-gray-300">
-            Connect
-          </button>
-        </form>
-
-        <div class="my-5 flex items-center gap-3 text-xs text-gray-400 dark:text-gray-500">
-          <span class="h-px flex-1 bg-gray-200 dark:bg-gray-800"></span>
-          or
-          <span class="h-px flex-1 bg-gray-200 dark:bg-gray-800"></span>
-        </div>
+    </div>
+    <template else>
+        <main
+            class="flex min-h-screen items-center justify-center bg-gray-50 p-6 text-gray-900 dark:bg-gray-950 dark:text-gray-100">
+            <div
+                class="w-full max-w-sm rounded-2xl bg-white p-8 shadow-sm ring-1 ring-gray-200 dark:bg-gray-900 dark:ring-gray-800">
+                <template if={logo}>
+                    <img
+                        src={logo}
+                        alt=""
+                        class="mx-auto mb-5 h-16 w-16 rounded-xl object-contain" />
+                </template>
+                <h1 class="mb-6 text-center text-xl font-semibold tracking-tight">{heading}</h1>
 
-        <button type="button" onclick={() => void start()}
-          class="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm font-medium hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800">
-          Start server
-        </button>
+                <form class="flex flex-col gap-3" onsubmit={(event) => { event.preventDefault(); void connect() }}>
+                    <input
+                        type="url"
+                        bind:value={url}
+                        placeholder={placeholder}
+                        autocomplete="url"
+                        class="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm outline-none focus:border-gray-900 focus:ring-1 focus:ring-gray-900 dark:border-gray-700 dark:bg-gray-800 dark:focus:border-gray-100 dark:focus:ring-gray-100" />
+                    <button
+                        type="submit"
+                        class="w-full rounded-lg bg-gray-900 px-3 py-2 text-sm font-medium text-white hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-gray-300">
+                        Connect
+                    </button>
+                </form>
 
-        <template if={error}>
-          <p class="mt-4 text-center text-sm text-red-600 dark:text-red-400">{error}</p>
-        </template>
+                <div class="my-5 flex items-center gap-3 text-xs text-gray-400 dark:text-gray-500">
+                    <span class="h-px flex-1 bg-gray-200 dark:bg-gray-800"></span>
+                    or
+                    <span class="h-px flex-1 bg-gray-200 dark:bg-gray-800"></span>
+                </div>
 
-        <p class="mt-8 text-center text-xs text-gray-400 dark:text-gray-500">
-          made with
-          <a href="https://github.com/briancray/abide" class="underline hover:text-gray-600 dark:hover:text-gray-300">abide</a>
-        </p>
-      </div>
-    </main>
-  </template>
+                <button
+                    type="button"
+                    onclick={() => void start()}
+                    class="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm font-medium hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800">
+                    Start server
+                </button>
+
+                <template if={error}>
+                    <p class="mt-4 text-center text-sm text-red-600 dark:text-red-400">
+                        {error}
+                    </p>
+                </template>
+
+                <p class="mt-8 text-center text-xs text-gray-400 dark:text-gray-500">
+                    made with
+                    <a
+                        href="https://github.com/briancray/abide"
+                        class="underline hover:text-gray-600 dark:hover:text-gray-300"
+                        >abide</a
+                    >
+                </p>
+            </div>
+        </main>
+    </template>
 </template>
 
 <template if={showConfig}>
-  <div class="fixed inset-0 z-10 flex items-center justify-center bg-black/40 p-6 text-gray-900 dark:text-gray-100">
-    <div class="w-full max-w-sm rounded-2xl bg-white p-8 shadow-lg ring-1 ring-gray-200 dark:bg-gray-900 dark:ring-gray-800">
-      <h2 class="mb-5 text-lg font-semibold tracking-tight">Set up {heading}</h2>
-
-      <form class="flex flex-col gap-4" onsubmit={(event) => { event.preventDefault(); void saveConfig() }}>
-        <template each={configFields} as="field" key="field.key">
-          <label class="flex flex-col gap-1 text-sm">
-            <span class="font-medium">{field.label}</span>
-            <template if={field.inputType === 'checkbox'}>
-              <input type="checkbox" onchange={(event) => { configValues[field.key] = event.currentTarget.checked ? 'true' : 'false' }}
-                class="mt-1 size-4 self-start rounded border-gray-300 dark:border-gray-700">
-              <template else>
-                <input type={field.inputType} value={configValues[field.key]} oninput={(event) => { configValues[field.key] = event.currentTarget.value }}
-                  class="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm outline-none focus:border-gray-900 focus:ring-1 focus:ring-gray-900 dark:border-gray-700 dark:bg-gray-800 dark:focus:border-gray-100 dark:focus:ring-gray-100">
-              </template>
-            </template>
-            <template if={field.description}>
-              <span class="text-xs text-gray-400 dark:text-gray-500">{field.description}</span>
-            </template>
-          </label>
-        </template>
+    <div
+        class="fixed inset-0 z-10 flex items-center justify-center bg-black/40 p-6 text-gray-900 dark:text-gray-100">
+        <div
+            class="w-full max-w-sm rounded-2xl bg-white p-8 shadow-lg ring-1 ring-gray-200 dark:bg-gray-900 dark:ring-gray-800">
+            <h2 class="mb-5 text-lg font-semibold tracking-tight">Set up {heading}</h2>
 
-        <div class="mt-1 flex gap-3">
-          <button type="button" onclick={() => { showConfig = false }}
-            class="flex-1 rounded-lg border border-gray-300 px-3 py-2 text-sm font-medium hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800">
-            Cancel
-          </button>
-          <button type="submit"
-            class="flex-1 rounded-lg bg-gray-900 px-3 py-2 text-sm font-medium text-white hover:bg-gray-700 disabled:opacity-60 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-gray-300">
-            Save &amp; start
-          </button>
-        </div>
-      </form>
+            <form class="flex flex-col gap-4" onsubmit={(event) => { event.preventDefault(); void saveConfig() }}>
+                <template each={configFields} as="field" key="field.key">
+                    <label class="flex flex-col gap-1 text-sm">
+                        <span class="font-medium">{field.label}</span>
+                        <template if={field.inputType === 'checkbox'}>
+                            <input
+                                type="checkbox"
+                                onchange={(event) => { configValues[field.key] = event.currentTarget.checked ? 'true' : 'false' }}
+                                class="mt-1 size-4 self-start rounded border-gray-300 dark:border-gray-700" />
+                            <template else>
+                                <input
+                                    type={field.inputType}
+                                    value={configValues[field.key]}
+                                    oninput={(event) => { configValues[field.key] = event.currentTarget.value }}
+                                    class="w-full rounded-lg border border-gray-300 px-3 py-2 text-sm outline-none focus:border-gray-900 focus:ring-1 focus:ring-gray-900 dark:border-gray-700 dark:bg-gray-800 dark:focus:border-gray-100 dark:focus:ring-gray-100" />
+                            </template>
+                        </template>
+                        <template if={field.description}>
+                            <span class="text-xs text-gray-400 dark:text-gray-500"
+                                >{field.description}</span
+                            >
+                        </template>
+                    </label>
+                </template>
 
-      <template if={error}>
-        <p class="mt-4 text-center text-sm text-red-600 dark:text-red-400">{error}</p>
-      </template>
+                <div class="mt-1 flex gap-3">
+                    <button
+                        type="button"
+                        onclick={() => { showConfig = false }}
+                        class="flex-1 rounded-lg border border-gray-300 px-3 py-2 text-sm font-medium hover:bg-gray-50 dark:border-gray-700 dark:hover:bg-gray-800">
+                        Cancel
+                    </button>
+                    <button
+                        type="submit"
+                        class="flex-1 rounded-lg bg-gray-900 px-3 py-2 text-sm font-medium text-white hover:bg-gray-700 disabled:opacity-60 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-gray-300">
+                        Save &amp; start
+                    </button>
+                </div>
+            </form>
+
+            <template if={error}>
+                <p class="mt-4 text-center text-sm text-red-600 dark:text-red-400">{error}</p>
+            </template>
+        </div>
     </div>
-  </div>
 </template>

package/src/lib/bundle/onMenu.ts

@@ -18,7 +18,7 @@ Inert during SSR and in a plain browser tab — `effect` only runs client-side,
 the native menu that fires the event exists only in the bundled desktop app,
 and `window` is guarded so importing the module never assumes a DOM.
 */
-// @readme bundle
+// @documentation bundle
 export function onMenu(handler: (name: string) => void): () => void
 export function onMenu(name: string, handler: () => void): () => void
 export function onMenu(

package/src/lib/mcp/createMcpServer.ts

@@ -23,7 +23,7 @@ feeds each rpc tool's annotations. Auth inherits from the inbound request
 each rpc handler. An optional `authorize` hook in opts can short-circuit
 the request before any tool dispatches.
 */
-// @readme plumbing
+// @documentation mcp
 export function createMcpServer(opts: McpServerOptions = {}): McpServer {
     const serverInfo = {
         name: opts.name ?? DEFAULT_NAME,

package/src/lib/server/AppModule.ts

@@ -13,7 +13,7 @@ Inside request scopes, the live Bun.Server is reachable via the
 exported `server()` function from `abide/server`; `init` receives it
 explicitly because it runs outside a request.
 */
-// @readme plumbing
+// @documentation plumbing
 export type AppModule = {
     /*
     Extra inbound header names to forward onto in-process rpc Requests, on

package/src/lib/server/DELETE.ts

@@ -6,5 +6,5 @@ DELETE verb helper. The bundler rewrites every `export const x = DELETE(fn)` ins
 `src/server/rpc/<file>.ts` into a defineVerb call (server target) or a
 remoteProxy stub (client target). Calling this directly throws.
 */
-// @readme rpc
+// @documentation rpc
 export const DELETE: VerbHelper = (_fn: any, _opts?: any) => unprocessed('DELETE')

package/src/lib/server/GET.ts

@@ -6,5 +6,5 @@ GET verb helper. The bundler rewrites every `export const x = GET(fn)` inside
 `src/server/rpc/<file>.ts` into a defineVerb call (server target) or a
 remoteProxy stub (client target). Calling this directly throws.
 */
-// @readme rpc
+// @documentation rpc
 export const GET: VerbHelper = (_fn: any, _opts?: any) => unprocessed('GET')

package/src/lib/server/HEAD.ts

@@ -6,5 +6,5 @@ HEAD verb helper. The bundler rewrites every `export const x = HEAD(fn)` inside
 `src/server/rpc/<file>.ts` into a defineVerb call (server target) or a
 remoteProxy stub (client target). Calling this directly throws.
 */
-// @readme rpc
+// @documentation rpc
 export const HEAD: VerbHelper = (_fn: any, _opts?: any) => unprocessed('HEAD')

package/src/lib/server/PATCH.ts

@@ -6,5 +6,5 @@ PATCH verb helper. The bundler rewrites every `export const x = PATCH(fn)` insid
 `src/server/rpc/<file>.ts` into a defineVerb call (server target) or a
 remoteProxy stub (client target). Calling this directly throws.
 */
-// @readme rpc
+// @documentation rpc
 export const PATCH: VerbHelper = (_fn: any, _opts?: any) => unprocessed('PATCH')

package/src/lib/server/POST.ts

@@ -6,5 +6,5 @@ POST verb helper. The bundler rewrites every `export const x = POST(fn)` inside
 `src/server/rpc/<file>.ts` into a defineVerb call (server target) or a
 remoteProxy stub (client target). Calling this directly throws.
 */
-// @readme rpc
+// @documentation rpc
 export const POST: VerbHelper = (_fn: any, _opts?: any) => unprocessed('POST')

package/src/lib/server/PUT.ts

@@ -6,5 +6,5 @@ PUT verb helper. The bundler rewrites every `export const x = PUT(fn)` inside
 `src/server/rpc/<file>.ts` into a defineVerb call (server target) or a
 remoteProxy stub (client target). Calling this directly throws.
 */
-// @readme rpc
+// @documentation rpc
 export const PUT: VerbHelper = (_fn: any, _opts?: any) => unprocessed('PUT')

package/src/lib/server/agent.ts

@@ -27,7 +27,7 @@ tool) are fenced by static rules in the engine's config.
 */
 
 // A turn in the conversation, provider-neutral. The engine maps these to its provider's wire shape.
-// @readme agent
+// @documentation agent
 export type NeutralMessage =
     | { role: 'user'; text: string }
     | {

package/src/lib/server/appDataDir.ts

@@ -10,7 +10,7 @@ the path derives from the bundler-injected program name, not the process working
 directory (which `open` sets to `/`). Pure: computes the path, never touches the
 filesystem.
 */
-// @readme reference
+// @documentation bundle
 export function appDataDir(): string {
     return appDataDirForName(cliProgramName)
 }

package/src/lib/server/cookies.ts

@@ -17,7 +17,7 @@ Materialized lazily on first call and cached on the request store, so a request
 that never touches cookies parses nothing and emits no `Set-Cookie`. Throws
 outside a request scope, like request().
 */
-// @readme request-scope
+// @documentation request-scope
 export function cookies(): Bun.CookieMap {
     const store = requestContext.getStore()
     if (!store) {

package/src/lib/server/env.ts

@@ -26,7 +26,7 @@ Validation must be synchronous — boot can't await config — so a schema whose
 (path + message) so a misconfigured deploy shows the full list rather than one
 variable per restart.
 */
-// @readme configuration
+// @documentation configuration
 export function env<Schema extends StandardSchemaV1>(
     schema: Schema,
 ): StandardSchemaV1.InferOutput<Schema> {

package/src/lib/server/error.ts

@@ -56,7 +56,7 @@ the union of branches in a handler narrow to whatever the success
 branch carries (`TypedResponse<{user}> | TypedResponse<never>` → Return
 = {user}).
 */
-// @readme response
+// @documentation response
 export function error(status: number, message?: string, init?: ResponseInit): TypedResponse<never> {
     const body = message ?? STATUS_TEXT[status] ?? `HTTP ${status}`
     return new Response(

package/src/lib/server/json.ts

@@ -27,7 +27,7 @@ paths, so a handler typed `Shape | undefined` round-trips the wire. The
 helper owns the 204 (a body-bearing status with no body would break the
 round trip), so it wins over any `init.status`.
 */
-// @readme response
+// @documentation response
 export function json<T>(data: T, init?: ResponseInit): TypedResponse<T> {
     if (data === undefined) {
         return new Response(

package/src/lib/server/jsonl.ts

@@ -27,7 +27,7 @@ import type { TypedResponse } from './rpc/types/TypedResponse.ts'
 import { streamFromIterator } from './runtime/streamFromIterator.ts'
 import { withResponseDefaults } from './runtime/withResponseDefaults.ts'
 
-// @readme response
+// @documentation response
 export function jsonl<Frame>(
     iterable: AsyncIterable<Frame>,
     init?: ResponseInit,

package/src/lib/server/prompts/definePrompt.ts

@@ -9,7 +9,7 @@ Builds a Prompt from a name + options. The resolver plugin parses every
 path becomes the prompt's identity. Registers itself so the MCP dispatcher
 can enumerate and render it.
 */
-// @readme plumbing
+// @documentation plumbing
 export function definePrompt(name: string, opts: PromptOptions): Prompt {
     const self: Prompt = {
         name,

package/src/lib/server/prompts/renderPromptTemplate.ts

@@ -9,7 +9,7 @@ string — MCP only enforces `required` at the client, so an optional
 argument the model omits should vanish from the text. Called by the
 render closure the resolver plugin generates for every `.md` prompt.
 */
-// @readme plumbing
+// @documentation plumbing
 export function renderPromptTemplate(template: string, args: Record<string, string>): string {
     return template.replace(PLACEHOLDER, (_match, key: string) =>
         args[key] === undefined ? '' : String(args[key]),

package/src/lib/server/reachable.ts

@@ -37,7 +37,7 @@ async function probeOrigin(origin: string): Promise<boolean> {
     }
 }
 
-// @readme observability
+// @documentation observability
 export const reachable = createReachable({
     probe: probeOrigin,
     intervalMs: TTL_MS,

package/src/lib/server/redirect.ts

@@ -30,7 +30,7 @@ the wire response is a 3xx with no body the caller resolves to, so it
 must not pollute the inferred `Return` of a route that conditionally
 redirects vs returns json.
 */
-// @readme response
+// @documentation response
 export function redirect(
     url: string,
     status: RedirectStatus = 302,

package/src/lib/server/request.ts

@@ -7,7 +7,7 @@ the fetch boundary. Throws if called outside a request scope (e.g. from
 top-level module code or from app.ts init) — silent undefined would mask
 the misuse.
 */
-// @readme request-scope
+// @documentation request-scope
 export function request(): Request {
     const store = requestContext.getStore()
     if (!store) {

package/src/lib/server/rpc/defineVerb.ts

@@ -44,7 +44,7 @@ the Request via parseArgs).
 Every raw invocation records the synthesized Request against the returned
 promise so cache() can stash it on the entry without re-building.
 */
-// @readme plumbing
+// @documentation plumbing
 export function defineVerb<Args, Return>(
     method: HttpVerb,
     url: string,

package/src/lib/server/runtime/buildCacheSnapshot.ts

@@ -41,7 +41,7 @@ function projectEntry(entry: CacheEntry, now: number): InspectorCacheEntry {
         remote: entry.request !== undefined,
         ttl: entry.ttl,
         expiresInMs: entry.expiresAt !== undefined ? entry.expiresAt - now : undefined,
-        scope: entry.scope ? [...entry.scope] : [],
+        tags: entry.tags ? [...entry.tags] : [],
         value: preview(entry.value),
         policy: policyLabel(entry),
     }

package/src/lib/server/runtime/types/InspectorCacheEntry.ts

@@ -15,8 +15,8 @@ export type InspectorCacheEntry = {
     ttl: number | undefined
     /* Ms until expiry from snapshot time; undefined = no expiry armed. */
     expiresInMs: number | undefined
-    /* The call's scope tags (cache.invalidate({ scope }) targets). */
-    scope: string[]
+    /* The call's tags (cache.invalidate({ tags }) targets). */
+    tags: string[]
     /* A short JSON preview of the decoded warm value, when the entry holds one. */
     value: string | undefined
     /* An armed swr policy (`swr`, optionally + throttle/debounce + ms), if declared. */

package/src/lib/server/runtime/types/InspectorContext.ts

@@ -10,14 +10,14 @@ surface for it (mirrors how AppModule / AgentEngine are the documented seams).
 Everything here is already produced by the runtime: the registries behind
 loadSurface(), the log chokepoint behind onRecord().
 */
-// @readme plumbing
+// @documentation plumbing
 export type InspectorContext = {
     /* App identity for the UI header — the same name/version the health probe reports. */
     app: { name: string; version: string }
     /* Eager-loads the registries, then projects the current RPC + socket catalog. */
     loadSurface: () => Promise<InspectorSurface>
     /* Snapshots the persistent (global) cache store — current entries with their
-       lifecycle state, retention, scope tags, and a value preview. */
+       lifecycle state, retention, tags, and a value preview. */
     cacheSnapshot: () => InspectorCacheSnapshot
     /*
     Subscribes to the unified event stream: every emitted log record (the log's

package/src/lib/server/server.ts

@@ -18,7 +18,7 @@ When no Bun.serve has booted, resolution forks on the request scope:
   app.ts init); keep throwing — silent undefined would mask it and strand
   later property reads with cryptic errors.
 */
-// @readme request-scope
+// @documentation request-scope
 export function server(): Server<unknown> {
     const active = getActiveServer()
     if (active) {

package/src/lib/server/socket.ts

@@ -6,7 +6,7 @@ import type { SocketOptions } from './sockets/types/SocketOptions.ts'
 Declares a Socket inside a file under `src/server/sockets/`. Each file contains
 exactly one export, named after the file (e.g. `chat.ts` →
 `export const chat = socket<ChatMessage>(...)`). The bundler reads the
-// @readme sockets
+// @documentation sockets
 export name from the filename and the socket name from the file path
 under `src/server/sockets/`, then rewrites this call to bind the name into the
 runtime implementation (defineSocket on the server, socketProxy on the

package/src/lib/server/sockets/defineSocket.ts

@@ -26,7 +26,7 @@ called server-side it both notifies in-process iterators and broadcasts
 to remote subscribers; called client-side (via socketProxy) it sends a
 `pub` frame the dispatcher validates and forwards.
 */
-// @readme plumbing
+// @documentation plumbing
 export function defineSocket<T>(name: string, opts: SocketOptions = {}): Socket<T> {
     const retention = opts.tail ?? 0
     const ttl = opts.ttl

package/src/lib/server/sse.ts

@@ -31,7 +31,7 @@ import { withResponseDefaults } from './runtime/withResponseDefaults.ts'
 
 const KEEPALIVE_INTERVAL_MS = 15000
 
-// @readme response
+// @documentation response
 export function sse<Frame>(
     iterable: AsyncIterable<Frame>,
     init?: ResponseInit,

package/src/lib/shared/HttpError.ts

@@ -4,7 +4,7 @@ status. Carries the raw Response so callers can inspect body, headers, or
 status text — useful for showing user-friendly error UI without having to
 opt every call site into the `.raw()` escape hatch.
 */
-// @readme response
+// @documentation response
 export class HttpError extends Error {
     readonly status: number
     readonly statusText: string

package/src/lib/shared/cache.ts

@@ -15,7 +15,7 @@ import { REPLAYABLE_METHODS } from './REPLAYABLE_METHODS.ts'
 import { SocketDisconnectedError } from './SocketDisconnectedError.ts'
 import { selectorMatcher } from './selectorMatcher.ts'
 import { selectorPrefix } from './selectorPrefix.ts'
-import { toScopeSet } from './toScopeSet.ts'
+import { toTagSet } from './toTagSet.ts'
 import type { CacheEntry } from './types/CacheEntry.ts'
 import type { CacheOnContext } from './types/CacheOnContext.ts'
 import type { CacheOptions } from './types/CacheOptions.ts'
@@ -116,7 +116,7 @@ keep streaming reads in a parent that never top-level awaits — the
 await-everything mode is per component instance, so a child's await blocks only
 the child.
 */
-// @readme cache
+// @documentation cache
 export function cache<Args, Return>(
     fn: RemoteFunction<Args, Return>,
     options?: CacheOptions,
@@ -173,7 +173,7 @@ export function cache<Args, Return>(
         const existing = store.entries.get(key)
         recordRead(options?.global ? activeCacheStore() : store, key, existing)
         if (existing) {
-            tagScope(existing, options?.scope)
+            tagEntry(existing, options?.tags)
             attachPolicy(existing, options, () => remote(args as Args))
             adoptTtl(store, existing, options)
         }
@@ -278,7 +278,7 @@ function warnAnonymousProducer(producer: (args?: never) => unknown): void {
     }
     warnedAnonymousProducers.add(source)
     abideLog.warn(
-        'cache() received an anonymous function — each call mints a fresh identity, so it never coalesces and pending()/refreshing() never match it. Hoist it to a named binding, or add a scope tag to probe it from elsewhere.',
+        'cache() received an anonymous function — each call mints a fresh identity, so it never coalesces and pending()/refreshing() never match it. Hoist it to a named binding, or add a tag to probe it from elsewhere.',
     )
 }
 
@@ -298,7 +298,7 @@ function invokeProducer<Args, Return>(
     const existing = store.entries.get(key)
     recordRead(options?.global ? activeCacheStore() : store, key, existing)
     if (existing) {
-        tagScope(existing, options?.scope)
+        tagEntry(existing, options?.tags)
         attachPolicy(existing, options, () => producer(args))
         const shared = existing.promise as Promise<Return>
         /* A coalesced join waits on the in-flight producer — time the block so the
@@ -368,7 +368,7 @@ function registerEntry(
         request,
         ttl,
         expiresAt: undefined,
-        scope: options?.scope === undefined ? undefined : toScopeSet(options.scope),
+        tags: options?.tags === undefined ? undefined : toTagSet(options.tags),
         refreshing,
         invalidation,
     }
@@ -451,7 +451,7 @@ function armTtlExpiry(store: CacheStore, entry: CacheEntry, ttl: number): void {
 }
 
 /*
-Mirrors tagScope/attachPolicy for retention: a hydrated snapshot entry ships
+Mirrors tagEntry/attachPolicy for retention: a hydrated snapshot entry ships
 without its wrap options (they live at call sites, not on the wire), so the
 first read adopts its call site's ttl declaration. Omitted = forever, exactly
 as shipped; ttl > 0 = the expiry clock starts at this read; ttl = 0 = the warm
@@ -530,7 +530,7 @@ function invalidate<Args, Return>(arg?: CacheSelector<Args, Return>, args?: Args
 Human-readable selector identity for the tripwire and cache.on coverage: the
 key prefix for fn selectors — the exact key when args narrow it — falling
 back to the function's name for a producer never cached, the tag list for
-scopes, `*` for the bare form.
+a `{ tags }` selector, `*` for the bare form.
 */
 function selectorLabel<Args, Return>(
     arg?: CacheSelector<Args, Return>,
@@ -543,7 +543,7 @@ function selectorLabel<Args, Return>(
     if (typeof arg === 'function') {
         return prefix ?? selectorPrefix(arg, args) ?? (arg.name || 'anonymous producer')
     }
-    return `scope: ${[...toScopeSet(arg.scope ?? [])].join(', ')}`
+    return `tags: ${[...toTagSet(arg.tags ?? [])].join(', ')}`
 }
 
 cache.invalidate = invalidate
@@ -920,24 +920,24 @@ function settleRefetchFailure(store: CacheStore, entry: CacheEntry, status?: num
 }
 
 /* Folds new tags into an entry's existing set without duplicating them. */
-function mergeScopes(existing: Set<string> | undefined, incoming: string | string[]): Set<string> {
-    return new Set([...(existing ?? []), ...toScopeSet(incoming)])
+function mergeTags(existing: Set<string> | undefined, incoming: string | string[]): Set<string> {
+    return new Set([...(existing ?? []), ...toTagSet(incoming)])
 }
 
 /*
-Tags an existing entry with a read's scope so a later cache.invalidate({ scope })
-reaches entries hydrated from the SSR snapshot (which carry a value but no scope)
+Tags an existing entry with a read's tags so a later cache.invalidate({ tags })
+reaches entries hydrated from the SSR snapshot (which carry a value but no tags)
 without a refetch. Merges rather than replaces so a read tagging one group can't
-drop tags another read site already added; a no-op when the read passes no scope.
+drop tags another read site already added; a no-op when the read passes no tags.
 */
-function tagScope(entry: CacheEntry, scope: CacheOptions['scope']): void {
-    if (scope !== undefined) {
-        entry.scope = mergeScopes(entry.scope, scope)
+function tagEntry(entry: CacheEntry, tags: CacheOptions['tags']): void {
+    if (tags !== undefined) {
+        entry.tags = mergeTags(entry.tags, tags)
     }
 }
 
 /*
-Mirrors tagScope for invalidate policies: a read declaring a policy arms an
+Mirrors tagEntry for invalidate policies: a read declaring a policy arms an
 existing entry that lacks one. Hydrated snapshot entries carry a value but no
 refetch thunk — without this, the first invalidate after hydration would hard-
 drop the entry (a pending flash) instead of revalidating stale-in-place, and a

package/src/lib/shared/createSubscriber.ts

@@ -24,7 +24,7 @@ resource down and reopening it across a re-run. Called outside any tracking scop
 `track` is a no-op, observers stay empty, and the resource never opens — matching
 the open-on-first-read contract.
 */
-// @readme plumbing
+// @documentation plumbing
 export function createSubscriber(start: (update: () => void) => () => void): () => void {
     const node = createSignalNode(undefined)
     let cleanup: (() => void) | undefined