@cleocode/contracts 2026.5.129 → 2026.5.131

package/dist/daemon/subsystem.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Daemon subsystem + lifecycle-hook contracts.
+ *
+ * A **subsystem** is one supervised unit of long-running work inside a CLEO
+ * daemon process — Studio supervision, the GC cron, the web server, the
+ * docs-viewer, the runtime poller. Each declares a uniform lifecycle
+ * (`start → healthProbe → shutdown`) so the `@cleocode/runtime/daemon`
+ * registry can drive them identically and the Rust `cleo-supervisor` can
+ * aggregate their health over the FROZEN `supervisor-ipc` v1.0 contract.
+ *
+ * These are **pure type contracts** (no runtime/IO). The implementation —
+ * `defineSubsystem()`, the registry, the NDJSON client — lives in
+ * `@cleocode/runtime/daemon` (R2 child T11367) and imports these types rather
+ * than redeclaring them (Contracts Fan-Out gate, T10074).
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/daemon
+ *
+ * @epic T11253 R2 — `@cleocode/runtime/daemon` submodule
+ * @task T11366 — daemon lifecycle + subsystem contracts
+ * @saga T11243 SG-RUNTIME-UNIFICATION
+ */
+import type { SubsystemHealth } from './health.js';
+/**
+ * Lifecycle hooks fired by the subsystem registry around a subsystem's
+ * `start`/`shutdown` transitions.
+ *
+ * All hooks are optional and may be async. They are observational — a hook
+ * MUST NOT mutate registry state. `onError` is the single failure sink: a
+ * throwing `start` or `shutdown`, or a rejected `healthProbe`, surfaces here.
+ *
+ * Hooks fire in a defined order relative to the underlying transition:
+ * - `onStart`    — after the subsystem's `start()` resolves.
+ * - `onShutdown` — after the subsystem's `shutdown()` resolves.
+ * - `onError`    — when any lifecycle step throws/rejects (start, probe, or
+ *   shutdown), with the offending `error` and the `phase` it occurred in.
+ */
+export interface DaemonLifecycleHooks {
+    /**
+     * Fired after the subsystem has successfully started.
+     *
+     * @param name - The logical subsystem name.
+     */
+    onStart?: (name: string) => void | Promise<void>;
+    /**
+     * Fired after the subsystem has successfully shut down.
+     *
+     * @param name - The logical subsystem name.
+     */
+    onShutdown?: (name: string) => void | Promise<void>;
+    /**
+     * Fired when a lifecycle step throws or rejects. The single failure sink.
+     *
+     * @param name  - The logical subsystem name.
+     * @param error - The thrown value, normalized to an `Error`.
+     * @param phase - Which lifecycle step failed.
+     */
+    onError?: (name: string, error: Error, phase: SubsystemLifecyclePhase) => void | Promise<void>;
+}
+/**
+ * The lifecycle phase a subsystem transition is in, used to tag
+ * {@link DaemonLifecycleHooks.onError} and registry diagnostics.
+ */
+export type SubsystemLifecyclePhase = 'start' | 'healthProbe' | 'shutdown';
+/**
+ * The frozen, ordered set of lifecycle phases. Pinned by the daemon test suite
+ * so a phase cannot be silently added or removed.
+ */
+export declare const SUBSYSTEM_LIFECYCLE_PHASES: readonly ["start", "healthProbe", "shutdown"];
+/**
+ * A subsystem descriptor — the declarative unit `defineSubsystem()` produces
+ * and the registry drives.
+ *
+ * The three lifecycle methods are intentionally minimal and uniform so that
+ * every long-running concern (supervised child process, cron job, HTTP server)
+ * can be expressed identically:
+ *
+ * - `start`       — bring the subsystem up. May be async. Idempotent callers
+ *   should guard re-entry.
+ * - `healthProbe` — report current liveness as a {@link SubsystemHealth} row.
+ *   Maps onto a supervised `ChildStatus` the Rust supervisor aggregates.
+ * - `shutdown`    — bring the subsystem down gracefully. May be async.
+ *
+ * @typeParam TContext - Optional opaque context the registry threads through
+ *   `start`/`shutdown` (e.g. a resolved config or handle). Defaults to `void`.
+ */
+export interface Subsystem<TContext = void> {
+    /** Logical, stable subsystem name (matches the supervised `child_id`). */
+    readonly name: string;
+    /**
+     * Bring the subsystem up. The resolved value is threaded back into
+     * `shutdown` as its context argument.
+     *
+     * @returns The subsystem context (or `void`).
+     */
+    start: () => TContext | Promise<TContext>;
+    /**
+     * Report the subsystem's current health as a single
+     * {@link SubsystemHealth} row.
+     *
+     * @returns The current health row.
+     */
+    healthProbe: () => SubsystemHealth | Promise<SubsystemHealth>;
+    /**
+     * Bring the subsystem down gracefully.
+     *
+     * @param context - The value returned by `start`.
+     */
+    shutdown: (context: TContext) => void | Promise<void>;
+}
+/**
+ * The descriptor passed to `defineSubsystem()` — the same surface as
+ * {@link Subsystem} (a 1:1 mapping; `defineSubsystem` validates + freezes it).
+ *
+ * Exposed as a distinct name so call-sites can annotate the literal they pass
+ * without importing the post-construction {@link Subsystem} type.
+ *
+ * @typeParam TContext - See {@link Subsystem}.
+ */
+export type SubsystemDefinition<TContext = void> = Subsystem<TContext>;
+//# sourceMappingURL=subsystem.d.ts.map

package/dist/daemon/subsystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsystem.d.ts","sourceRoot":"","sources":["../../src/daemon/subsystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChG;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,0BAA0B,+CAAgD,CAAC;AAExF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS,CAAC,QAAQ,GAAG,IAAI;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,WAAW,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,CAAC,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC"}

package/dist/daemon/subsystem.js

@@ -0,0 +1,28 @@
+/**
+ * Daemon subsystem + lifecycle-hook contracts.
+ *
+ * A **subsystem** is one supervised unit of long-running work inside a CLEO
+ * daemon process — Studio supervision, the GC cron, the web server, the
+ * docs-viewer, the runtime poller. Each declares a uniform lifecycle
+ * (`start → healthProbe → shutdown`) so the `@cleocode/runtime/daemon`
+ * registry can drive them identically and the Rust `cleo-supervisor` can
+ * aggregate their health over the FROZEN `supervisor-ipc` v1.0 contract.
+ *
+ * These are **pure type contracts** (no runtime/IO). The implementation —
+ * `defineSubsystem()`, the registry, the NDJSON client — lives in
+ * `@cleocode/runtime/daemon` (R2 child T11367) and imports these types rather
+ * than redeclaring them (Contracts Fan-Out gate, T10074).
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/daemon
+ *
+ * @epic T11253 R2 — `@cleocode/runtime/daemon` submodule
+ * @task T11366 — daemon lifecycle + subsystem contracts
+ * @saga T11243 SG-RUNTIME-UNIFICATION
+ */
+/**
+ * The frozen, ordered set of lifecycle phases. Pinned by the daemon test suite
+ * so a phase cannot be silently added or removed.
+ */
+export const SUBSYSTEM_LIFECYCLE_PHASES = ['start', 'healthProbe', 'shutdown'];
+//# sourceMappingURL=subsystem.js.map

package/dist/daemon/subsystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsystem.js","sourceRoot":"","sources":["../../src/daemon/subsystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA+CH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,CAAU,CAAC"}

package/dist/daemon-ipc/__tests__/daemon-ipc-freeze.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Freeze + AC8-alias guard for the `@cleocode/contracts/daemon-ipc` surface
+ * (T11369 — R2 gates R4-R7).
+ *
+ * Proves the AC8-named `daemon-ipc` barrel:
+ * 1. resolves and re-exports the FROZEN supervisor-ipc v1.0 schemas + version,
+ * 2. is byte-identical to the `supervisor-ipc` surface (one contract, two
+ *    names — no duplicate drift surface),
+ * 3. pins `DAEMON_IPC_PROTOCOL_VERSION === SUPERVISOR_IPC_PROTOCOL_VERSION ===
+ *    '1.0.0'` and the complete frozen message-kind tuple.
+ *
+ * @task T11369
+ */
+export {};
+//# sourceMappingURL=daemon-ipc-freeze.test.d.ts.map

package/dist/daemon-ipc/__tests__/daemon-ipc-freeze.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-ipc-freeze.test.d.ts","sourceRoot":"","sources":["../../../src/daemon-ipc/__tests__/daemon-ipc-freeze.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/daemon-ipc/__tests__/daemon-ipc-freeze.test.js

@@ -0,0 +1,40 @@
+/**
+ * Freeze + AC8-alias guard for the `@cleocode/contracts/daemon-ipc` surface
+ * (T11369 — R2 gates R4-R7).
+ *
+ * Proves the AC8-named `daemon-ipc` barrel:
+ * 1. resolves and re-exports the FROZEN supervisor-ipc v1.0 schemas + version,
+ * 2. is byte-identical to the `supervisor-ipc` surface (one contract, two
+ *    names — no duplicate drift surface),
+ * 3. pins `DAEMON_IPC_PROTOCOL_VERSION === SUPERVISOR_IPC_PROTOCOL_VERSION ===
+ *    '1.0.0'` and the complete frozen message-kind tuple.
+ *
+ * @task T11369
+ */
+import { describe, expect, it } from 'vitest';
+import { SUPERVISOR_IPC_MESSAGE_KINDS, SUPERVISOR_IPC_PROTOCOL_VERSION, SupervisorIpcEnvelopeSchema as SupervisorEnvelopeFromRoot, } from '../../supervisor-ipc/index.js';
+import { DAEMON_IPC_PROTOCOL_VERSION, SUPERVISOR_IPC_MESSAGE_KINDS as MESSAGE_KINDS_VIA_DAEMON_IPC, SupervisorIpcEnvelopeSchema as SupervisorEnvelopeFromDaemonIpc, SUPERVISOR_IPC_PROTOCOL_VERSION as VERSION_VIA_DAEMON_IPC, } from '../index.js';
+describe('@cleocode/contracts/daemon-ipc AC8 alias surface (T11369)', () => {
+    it('re-exports the SAME frozen schema binding as supervisor-ipc', () => {
+        // Referential identity proves it is a re-export, not a duplicate schema.
+        expect(SupervisorEnvelopeFromDaemonIpc).toBe(SupervisorEnvelopeFromRoot);
+    });
+    it('pins the frozen protocol version through both names', () => {
+        expect(VERSION_VIA_DAEMON_IPC).toBe('1.0.0');
+        expect(DAEMON_IPC_PROTOCOL_VERSION).toBe('1.0.0');
+        expect(DAEMON_IPC_PROTOCOL_VERSION).toBe(SUPERVISOR_IPC_PROTOCOL_VERSION);
+    });
+    it('exposes the identical frozen message-kind set through the daemon-ipc name', () => {
+        expect([...MESSAGE_KINDS_VIA_DAEMON_IPC]).toEqual([...SUPERVISOR_IPC_MESSAGE_KINDS]);
+    });
+    it('validates a real Rust wire envelope through the daemon-ipc schema', () => {
+        const wire = {
+            protocol_version: '1.0.0',
+            id: 'abc',
+            direction: 'request',
+            request: { kind: 'health' },
+        };
+        expect(SupervisorEnvelopeFromDaemonIpc.safeParse(wire).success).toBe(true);
+    });
+});
+//# sourceMappingURL=daemon-ipc-freeze.test.js.map

package/dist/daemon-ipc/__tests__/daemon-ipc-freeze.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-ipc-freeze.test.js","sourceRoot":"","sources":["../../../src/daemon-ipc/__tests__/daemon-ipc-freeze.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,IAAI,0BAA0B,GAC1D,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,IAAI,4BAA4B,EAC5D,2BAA2B,IAAI,+BAA+B,EAC9D,+BAA+B,IAAI,sBAAsB,GAC1D,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACzE,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,yEAAyE;QACzE,MAAM,CAAC,+BAA+B,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,CAAC,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,IAAI,GAAG;YACX,gBAAgB,EAAE,OAAO;YACzB,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC5B,CAAC;QACF,MAAM,CAAC,+BAA+B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/daemon-ipc/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `@cleocode/contracts/daemon-ipc` — the FROZEN v1.0 daemon-IPC surface
+ * R4-R7 adapt against (T11253 AC8).
+ *
+ * ## AC8 reconciliation (T11369)
+ *
+ * Epic T11253 AC8 specifies the frozen surface is published under the name
+ * `@cleocode/contracts/daemon-ipc/`. R1 (T11339) had already shipped the
+ * byte-for-byte Rust mirror under `@cleocode/contracts/supervisor-ipc/`. Rather
+ * than DUPLICATE the contract (which would create two drift surfaces), this
+ * module is a **thin re-export barrel**: `supervisor-ipc` IS the frozen v1.0
+ * contract, and `daemon-ipc` is the AC8-named alias the R2 epic promised.
+ *
+ * Both import sites resolve to the same FROZEN schemas + version constant:
+ *
+ * ```ts
+ * import { SupervisorIpcEnvelopeSchema } from '@cleocode/contracts/daemon-ipc';
+ * import { SupervisorIpcEnvelopeSchema } from '@cleocode/contracts/supervisor-ipc';
+ * // identical binding — one frozen contract, two names.
+ * ```
+ *
+ * R4-R7 are **pure adapters** against this frozen surface (see the
+ * contract-evolution policy doc, slug `daemon-ipc-contract-evolution-policy`).
+ * Breaking changes require a NEW versioned directory + a version-negotiation
+ * shim + an R2 amendment task — never an in-place edit to the v1.0 schemas.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/daemon-ipc
+ *
+ * @epic T11253 R2 — `@cleocode/runtime/daemon` submodule
+ * @task T11369 — freeze + publish v1.0 daemon-IPC contract surface (AC8 + AC9)
+ * @saga T11243 SG-RUNTIME-UNIFICATION
+ */
+export type { ChildState, ChildStatus, EnvPair, ErrorResponse, HealthRequest, HealthResponse, LifecycleEventKind, LifecycleEventResponse, MonitorRequest, MonitorResponse, RestartedResponse, RestartRequest, SpawnedResponse, SpawnRequest, SupervisorIpcEnvelope, SupervisorIpcRequest, SupervisorIpcRequestEnvelope, SupervisorIpcResponse, SupervisorIpcResponseEnvelope, } from '../supervisor-ipc/index.js';
+export { ChildStateSchema, ChildStatusSchema, EnvPairSchema, ErrorResponseSchema, HealthRequestSchema, HealthResponseSchema, LifecycleEventKindSchema, LifecycleEventResponseSchema, MonitorRequestSchema, MonitorResponseSchema, RestartedResponseSchema, RestartRequestSchema, SpawnedResponseSchema, SpawnRequestSchema, SUPERVISOR_IPC_CHANNEL_BASENAME, SUPERVISOR_IPC_MESSAGE_KINDS, SUPERVISOR_IPC_PROTOCOL_VERSION, SUPERVISOR_IPC_REQUEST_KINDS, SUPERVISOR_IPC_RESPONSE_KINDS, SupervisorIpcEnvelopeSchema, SupervisorIpcRequestEnvelopeSchema, SupervisorIpcRequestSchema, SupervisorIpcResponseEnvelopeSchema, SupervisorIpcResponseSchema, } from '../supervisor-ipc/index.js';
+/**
+ * The AC8-canonical name for the frozen daemon-IPC protocol version.
+ *
+ * Alias of `SUPERVISOR_IPC_PROTOCOL_VERSION` — re-exported so the freeze/drift
+ * test (T11369) can pin the value through the `daemon-ipc` surface name AC8
+ * specifies. Both constants are the SAME frozen `'1.0.0'`.
+ */
+export { SUPERVISOR_IPC_PROTOCOL_VERSION as DAEMON_IPC_PROTOCOL_VERSION } from '../supervisor-ipc/version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/daemon-ipc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/daemon-ipc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,YAAY,EACV,UAAU,EACV,WAAW,EACX,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,+BAA+B,EAC/B,4BAA4B,EAC5B,+BAA+B,EAC/B,4BAA4B,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,kCAAkC,EAClC,0BAA0B,EAC1B,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC;;;;;;GAMG;AACH,OAAO,EAAE,+BAA+B,IAAI,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/daemon-ipc/index.js

@@ -0,0 +1,43 @@
+/**
+ * `@cleocode/contracts/daemon-ipc` — the FROZEN v1.0 daemon-IPC surface
+ * R4-R7 adapt against (T11253 AC8).
+ *
+ * ## AC8 reconciliation (T11369)
+ *
+ * Epic T11253 AC8 specifies the frozen surface is published under the name
+ * `@cleocode/contracts/daemon-ipc/`. R1 (T11339) had already shipped the
+ * byte-for-byte Rust mirror under `@cleocode/contracts/supervisor-ipc/`. Rather
+ * than DUPLICATE the contract (which would create two drift surfaces), this
+ * module is a **thin re-export barrel**: `supervisor-ipc` IS the frozen v1.0
+ * contract, and `daemon-ipc` is the AC8-named alias the R2 epic promised.
+ *
+ * Both import sites resolve to the same FROZEN schemas + version constant:
+ *
+ * ```ts
+ * import { SupervisorIpcEnvelopeSchema } from '@cleocode/contracts/daemon-ipc';
+ * import { SupervisorIpcEnvelopeSchema } from '@cleocode/contracts/supervisor-ipc';
+ * // identical binding — one frozen contract, two names.
+ * ```
+ *
+ * R4-R7 are **pure adapters** against this frozen surface (see the
+ * contract-evolution policy doc, slug `daemon-ipc-contract-evolution-policy`).
+ * Breaking changes require a NEW versioned directory + a version-negotiation
+ * shim + an R2 amendment task — never an in-place edit to the v1.0 schemas.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/daemon-ipc
+ *
+ * @epic T11253 R2 — `@cleocode/runtime/daemon` submodule
+ * @task T11369 — freeze + publish v1.0 daemon-IPC contract surface (AC8 + AC9)
+ * @saga T11243 SG-RUNTIME-UNIFICATION
+ */
+export { ChildStateSchema, ChildStatusSchema, EnvPairSchema, ErrorResponseSchema, HealthRequestSchema, HealthResponseSchema, LifecycleEventKindSchema, LifecycleEventResponseSchema, MonitorRequestSchema, MonitorResponseSchema, RestartedResponseSchema, RestartRequestSchema, SpawnedResponseSchema, SpawnRequestSchema, SUPERVISOR_IPC_CHANNEL_BASENAME, SUPERVISOR_IPC_MESSAGE_KINDS, SUPERVISOR_IPC_PROTOCOL_VERSION, SUPERVISOR_IPC_REQUEST_KINDS, SUPERVISOR_IPC_RESPONSE_KINDS, SupervisorIpcEnvelopeSchema, SupervisorIpcRequestEnvelopeSchema, SupervisorIpcRequestSchema, SupervisorIpcResponseEnvelopeSchema, SupervisorIpcResponseSchema, } from '../supervisor-ipc/index.js';
+/**
+ * The AC8-canonical name for the frozen daemon-IPC protocol version.
+ *
+ * Alias of `SUPERVISOR_IPC_PROTOCOL_VERSION` — re-exported so the freeze/drift
+ * test (T11369) can pin the value through the `daemon-ipc` surface name AC8
+ * specifies. Both constants are the SAME frozen `'1.0.0'`.
+ */
+export { SUPERVISOR_IPC_PROTOCOL_VERSION as DAEMON_IPC_PROTOCOL_VERSION } from '../supervisor-ipc/version.js';
+//# sourceMappingURL=index.js.map

package/dist/daemon-ipc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/daemon-ipc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAuBH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,+BAA+B,EAC/B,4BAA4B,EAC5B,+BAA+B,EAC/B,4BAA4B,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,kCAAkC,EAClC,0BAA0B,EAC1B,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC;;;;;;GAMG;AACH,OAAO,EAAE,+BAA+B,IAAI,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/db-inventory.json

@@ -22,7 +22,7 @@
       "role": "brain",
       "tier": "project",
       "filePathTemplate": "<projectRoot>/.cleo/brain.db",
-      "drizzleSchemaPath": "packages/core/src/store/memory-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/memory-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-brain/",
       "ownerPackage": "@cleocode/brain",
       "openedVia": "openCleoDb('brain', cwd)",
@@ -35,7 +35,7 @@
       "role": "conduit",
       "tier": "project",
       "filePathTemplate": "<projectRoot>/.cleo/conduit.db",
-      "drizzleSchemaPath": "packages/core/src/store/conduit-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/conduit-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-conduit/",
       "ownerPackage": "@cleocode/core",
       "openedVia": "openCleoDb('conduit', cwd)",
@@ -74,7 +74,7 @@
       "role": "nexus",
       "tier": "global",
       "filePathTemplate": "$XDG_DATA_HOME/cleo/nexus.db",
-      "drizzleSchemaPath": "packages/core/src/store/nexus-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/nexus-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-nexus/",
       "ownerPackage": "@cleocode/core",
       "openedVia": "openCleoDb('nexus')",
@@ -87,7 +87,7 @@
       "role": "signaldock-project",
       "tier": "project",
       "filePathTemplate": "<projectRoot>/.cleo/signaldock.db",
-      "drizzleSchemaPath": "packages/core/src/store/signaldock-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/signaldock-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-signaldock/",
       "ownerPackage": "@cleocode/core",
       "openedVia": "HISTORICAL — project-tier signaldock.db was migrated into conduit.db post-T310/ADR-037. No live opener; charter row retained for migration provenance and legacy backup detection.",
@@ -100,7 +100,7 @@
       "role": "signaldock-global",
       "tier": "global",
       "filePathTemplate": "$XDG_DATA_HOME/cleo/signaldock.db",
-      "drizzleSchemaPath": "packages/core/src/store/signaldock-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/signaldock-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-signaldock/",
       "ownerPackage": "@cleocode/core",
       "openedVia": "openCleoDb('signaldock')",
@@ -113,7 +113,7 @@
       "role": "telemetry",
       "tier": "global",
       "filePathTemplate": "$XDG_DATA_HOME/cleo/telemetry.db",
-      "drizzleSchemaPath": "packages/core/src/telemetry/schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/telemetry-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-telemetry/",
       "ownerPackage": "@cleocode/core",
       "openedVia": "@cleocode/core telemetry/sqlite.ts — lazy open on first event when opted-in; not yet registered as openCleoDb role",
@@ -126,7 +126,7 @@
       "role": "skills",
       "tier": "global",
       "filePathTemplate": "$XDG_DATA_HOME/cleo/skills.db",
-      "drizzleSchemaPath": "packages/core/src/store/skills-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/skills-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-skills/",
       "ownerPackage": "@cleocode/core",
       "openedVia": "openCleoDb('skills')",
@@ -139,7 +139,7 @@
       "role": "global-brain",
       "tier": "global",
       "filePathTemplate": "$XDG_DATA_HOME/cleo/brain.db",
-      "drizzleSchemaPath": "packages/core/src/store/memory-schema.ts",
+      "drizzleSchemaPath": "packages/core/src/store/schema/memory-schema.ts",
       "migrationsDir": "packages/core/migrations/drizzle-brain/",
       "ownerPackage": "@cleocode/brain",
       "openedVia": "UNREGISTERED — file exists on disk (audit §1.2 row 3) but no live opener. Provenance unclear; likely orphan from a getCleoHome()-vs-project-resolution path bug. Tracked for cleanup decision under T10282/T10307.",

package/dist/dispatch/identity.d.ts

@@ -59,7 +59,7 @@ export type Tier = 0 | 1 | 2;
  *
  * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9954 (Phase 0b)
  */
-export declare const CANONICAL_DOMAINS: readonly ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sticky", "intelligence", "diagnostics", "docs", "playbook", "conduit", "sentient", "release", "llm", "provenance", "upgrade", "worktree", "focus"];
+export declare const CANONICAL_DOMAINS: readonly ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sticky", "intelligence", "diagnostics", "docs", "playbook", "conduit", "sentient", "release", "llm", "provenance", "upgrade", "worktree", "focus", "attention"];
 /**
  * One of the canonical dispatch domain names.
  *

package/dist/dispatch/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/dispatch/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAIzC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAI7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,4PA4BpB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/dispatch/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAIzC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAI7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,yQA+BpB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/dispatch/identity.js

@@ -68,5 +68,8 @@ export const CANONICAL_DOMAINS = [
     'worktree',
     // T9973: 'cleo focus <id>' — single-envelope task orientation (8 calls → 1).
     'focus',
+    // T11373: 'cleo attention add|show|list' (alias 'jot') — Tier-2 scope-keyed
+    // working-memory buffer (Epic T11288 · Saga T11283).
+    'attention',
 ];
 //# sourceMappingURL=identity.js.map

package/dist/dispatch/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/dispatch/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA4BH,wEAAwE;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,UAAU;IACV,aAAa;IACb,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,cAAc;IACd,aAAa;IACb,MAAM;IACN,UAAU;IACV,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;IACL,wEAAwE;IACxE,YAAY;IACZ,wEAAwE;IACxE,0DAA0D;IAC1D,SAAS;IACT,6EAA6E;IAC7E,UAAU;IACV,6EAA6E;IAC7E,OAAO;CACC,CAAC"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/dispatch/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA4BH,wEAAwE;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,UAAU;IACV,aAAa;IACb,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,cAAc;IACd,aAAa;IACb,MAAM;IACN,UAAU;IACV,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;IACL,wEAAwE;IACxE,YAAY;IACZ,wEAAwE;IACxE,0DAA0D;IAC1D,SAAS;IACT,6EAA6E;IAC7E,UAAU;IACV,6EAA6E;IAC7E,OAAO;IACP,4EAA4E;IAC5E,qDAAqD;IACrD,WAAW;CACH,CAAC"}

package/dist/dispatch/operation-def.d.ts

@@ -68,6 +68,22 @@ export interface OperationDef {
      * @see T4897 for progressive migration
      */
     params?: ParamDef[];
+    /**
+     * Whether this operation is surfaced as an MCP tool by the
+     * `@cleocode/runtime/gateway/mcp` transport adapter.
+     *
+     * **Default-deny**: absent / `false` means the operation is NOT exposed over
+     * MCP. The MCP adapter generates its `tools/list` from the subset of
+     * {@link OperationDef} entries that explicitly set `mcpExposed: true`, so the
+     * external tool surface is opt-in rather than the full CQRS registry. This
+     * preserves the historically-curated MCP surface (the standalone
+     * `@cleocode/mcp-adapter` exposed exactly 3 sentient tools) while letting new
+     * tools be promoted one registry edit at a time.
+     *
+     * @see {@link https://modelcontextprotocol.io | Model Context Protocol}
+     * @task T11448
+     */
+    mcpExposed?: boolean;
 }
 /**
  * Resolution output for a dispatch request.

package/dist/dispatch/operation-def.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation-def.d.ts","sourceRoot":"","sources":["../../src/dispatch/operation-def.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAKpE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAIzD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;IACX,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,GAAG,EAAE,YAAY,CAAC;CACnB"}
+{"version":3,"file":"operation-def.d.ts","sourceRoot":"","sources":["../../src/dispatch/operation-def.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAKpE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAIzD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;IACX,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,GAAG,EAAE,YAAY,CAAC;CACnB"}

package/dist/dispatch/operations-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAMD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EA8gRpC,CAAC"}
+{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAMD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EA0pRpC,CAAC"}

package/dist/dispatch/operations-registry.js

@@ -7429,6 +7429,20 @@ export const OPERATIONS = [
     // in the DomainHandler map) but absent from OPERATIONS, making them invisible
     // to public SDK consumers using @cleocode/core. Adding all 10 ops here.
     // ---------------------------------------------------------------------------
+    // sentient query: status (T11448 — exposed over MCP; mirrors the standalone
+    // mcp-adapter `cleo_sentient_status` tool + the `cleo sentient status` CLI op).
+    {
+        gateway: 'query',
+        domain: 'sentient',
+        operation: 'status',
+        description: 'sentient.status (query) — daemon state, kill-switch status, Tier-2 enabled flag, and proposal statistics',
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [],
+        mcpExposed: true,
+    },
     // sentient query: propose.list
     {
         gateway: 'query',
@@ -7447,6 +7461,7 @@ export const OPERATIONS = [
                 description: 'Maximum number of proposals to return (default: 50)',
             },
         ],
+        mcpExposed: true,
     },
     // sentient query: propose.diff
     {
@@ -7549,6 +7564,7 @@ export const OPERATIONS = [
         sessionRequired: false,
         requiredParams: [],
         params: [],
+        mcpExposed: true,
     },
     // sentient mutate: propose.disable
     {
@@ -8388,6 +8404,123 @@ export const OPERATIONS = [
         ],
     },
     // ---------------------------------------------------------------------------
+    // T11373 — attention domain: Tier-2 scope-keyed working-memory jots (E2)
+    // ---------------------------------------------------------------------------
+    {
+        gateway: 'mutate',
+        domain: 'attention',
+        operation: 'add',
+        description: 'attention.add (mutate · alias jot) — record a scope-keyed working-memory ' +
+            'jot. Session/agent identity + current task are auto-resolved from the ' +
+            'environment (E0); the item keys to the narrowest scope (agent>task>epic>' +
+            'saga>session>global). No session/agent/task flags by default.',
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ['content'],
+        params: [
+            {
+                name: 'content',
+                type: 'string',
+                required: true,
+                description: 'The jot content',
+                cli: { positional: true },
+            },
+            {
+                name: 'tags',
+                type: 'array',
+                required: false,
+                description: 'Tags to attach (comma-separated on the CLI)',
+            },
+            {
+                name: 'scope',
+                type: 'string',
+                required: false,
+                description: 'Explicit scope escalation: agent|task|epic|saga|session|global (default: narrowest)',
+            },
+            {
+                name: 'ttlSeconds',
+                type: 'number',
+                required: false,
+                description: 'Optional time-to-live in seconds (sets expires_at)',
+            },
+        ],
+    },
+    {
+        gateway: 'query',
+        domain: 'attention',
+        operation: 'list',
+        description: 'attention.list (query) — list open working-memory jots visible to the ' +
+            'calling agent across its resolved scope chain. Optional --scope / --tag filters.',
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+            {
+                name: 'scope',
+                type: 'string',
+                required: false,
+                description: 'Restrict to one scope kind: agent|task|epic|saga|session|global',
+            },
+            {
+                name: 'tags',
+                type: 'array',
+                required: false,
+                description: 'Filter by tags (contains-ALL; comma-separated on the CLI)',
+            },
+            {
+                name: 'includeAll',
+                type: 'boolean',
+                required: false,
+                description: 'Include non-open (consolidated/discarded) items too. Default: false',
+            },
+            {
+                name: 'limit',
+                type: 'number',
+                required: false,
+                description: 'Maximum rows. Default: 50',
+            },
+        ],
+    },
+    {
+        gateway: 'query',
+        domain: 'attention',
+        operation: 'show',
+        description: 'attention.show (query) — synonym for attention.list; emits the open ' +
+            'working-memory jots for the calling agent within token budget.',
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+            {
+                name: 'scope',
+                type: 'string',
+                required: false,
+                description: 'Restrict to one scope kind: agent|task|epic|saga|session|global',
+            },
+            {
+                name: 'tags',
+                type: 'array',
+                required: false,
+                description: 'Filter by tags (contains-ALL; comma-separated on the CLI)',
+            },
+            {
+                name: 'includeAll',
+                type: 'boolean',
+                required: false,
+                description: 'Include non-open items too. Default: false',
+            },
+            {
+                name: 'limit',
+                type: 'number',
+                required: false,
+                description: 'Maximum rows. Default: 50',
+            },
+        ],
+    },
+    // ---------------------------------------------------------------------------
     // T10629 — tasks.context: bounded task-scoped context pack with token budget
     // ---------------------------------------------------------------------------
     {