@cleocode/contracts 2026.5.130 → 2026.5.132

package/dist/index.js

@@ -15,6 +15,12 @@ export { CHANGESET_KINDS, ChangesetEntrySchema } from './changesets.js';
 export { CLI_CATEGORY_ORDER } from './cli-category.js';
 export { CLEO_CONFIG_MANIFEST, CONFIG_MANIFEST_ENTRIES, configManifestEntrySchema, GLOBAL_CLEO_CONFIG_MANIFEST, PROJECT_CONTEXT_MANIFEST, PROJECT_INFO_MANIFEST, } from './config/manifest.js';
 export { parseClaudeCodeCredentials } from './credentials.js';
+export { HealthStatusSchema, SUBSYSTEM_LIFECYCLE_PHASES, SubsystemHealthSchema, SubsystemStateSchema, summarizeHealth, toMonitorChildren, } from './daemon/index.js';
+// === Daemon-IPC v1.0 (AC8 alias of supervisor-ipc — T11369 · R2 gates R4-R7) ===
+// `daemon-ipc` is the AC8-named re-export barrel over the FROZEN supervisor-ipc
+// v1.0 contract — one contract, two names. The subpath
+// `@cleocode/contracts/daemon-ipc` resolves via the package `./*` export.
+export { DAEMON_IPC_PROTOCOL_VERSION } from './daemon-ipc/index.js';
 export { DB_INVENTORY } from './db-inventory.js';
 export { CANONICAL_DOMAINS } from './dispatch/identity.js';
 // === Dispatch OPERATIONS data + builder helpers (T10061 — T9833b / E-CLI-BOUNDARY / SG-ARCH-SOLID) ===
@@ -48,12 +54,14 @@ E_INVALID_PIPELINE_STAGE, E_INVALID_SEVERITY_VALUE, E_INVALID_STATE, E_PLAN_NOT_
 E_WRITE_CONTENTION, ExitCode, getExitCodeName, isErrorCode, isNoChangeCode, isRecoverableCode, isSuccessCode, } from './exit-codes.js';
 // === Facade API Interfaces ===
 export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, BRAIN_OBSERVATION_TYPES, } from './facade.js';
+export { GOAL_STATUSES, GOAL_TARGET_TASK_ID_REGEX, GOAL_TERMINAL_STATUSES, isFuzzyGoal, isTaskCompletionGoal, isTerminalGoalStatus, isValidGoalTargetTaskId, } from './goal.js';
 export { confidenceFromProvenance, confidenceLabelFromNumeric, provenanceFromNumeric, } from './graph.js';
 export { ADR_056_INVARIANTS, ADR_073_INVARIANTS, getInvariant, getInvariantsByAdr, INVARIANTS_REGISTRY, } from './invariants/index.js';
 // === LAFS Envelope Types ===
 export { isGatewayEnvelope, isLafsError, isLafsSuccess, } from './lafs.js';
 export { PluginDeniedError, PluginLlmError, PluginModelGateError, PluginRateLimitedError, } from './llm/plugin-llm.js';
 export { BRAIN_OBSERVATION_SOURCE_TYPES } from './memory/observe.js';
+export { expansionFromNextDirectives, expansionFromStructuredOps, expansionFromSuggestedCommands, isNextDirectivesHint, isStructuredOpsHint, isSuggestedCommandsHint, } from './mvi.js';
 export { E_LAFS_OPERATION_ERROR_SHAPE, E_LAFS_OPERATION_RESULT_SCHEMA, E_LAFS_OPERATION_UNREGISTERED, OPERATION_RESULT_SCHEMAS, validateOperationEnvelope, } from './operation-envelope-validation.js';
 // === Docs Operation Types (T10618 — docs.update lifecycle status SSoT) ===
 // Re-exported at top level so core and CLI layers can consume the same
@@ -85,6 +93,8 @@ PIPELINE_STATUS_ICONS, SESSION_STATUSES, STAGE_STATUS_ICONS, STATUS_REGISTRY, TA
 TASK_STATUSES, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES, 
 // Terminal state sets
 TERMINAL_TASK_STATUSES, } from './status-registry.js';
+// === Supervisor IPC v1.0 (FROZEN — T11339 · SG-RUNTIME-UNIFICATION R1) ===
+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';
 export { isTestFixtureOrigin, TASK_ORIGIN_CANONICAL } from './task.js';
 export { commandOutputEvidenceSchema, fileEvidenceSchema, logEvidenceSchema, screenshotEvidenceSchema, taskEvidenceSchema, testOutputEvidenceSchema, } from './task-evidence.js';
 // === Archive Reason Enum (T1409 — typed z.enum + tombstone guard) ===

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mvi.d.ts

@@ -0,0 +1,209 @@
+/**
+ * MVI (Minimum-Viable-Information) progressive-disclosure primitive.
+ *
+ * CLEO historically grew three *separate* "expansion-hint" conventions, each
+ * answering the same question — *"the agent got a lean result; how does it
+ * drill deeper?"* — in a different wire shape:
+ *
+ * 1. **`_next`** (`core/src/mvi-helpers.ts`) — `Record<string, string>`: a map
+ *    of follow-up *name* → copy-pasteable CLI command
+ *    (`{ full: "cleo show T1", children: "cleo find --parent T1" }`).
+ * 2. **`meta.suggestedNext`** (`core/src/dispatch/suggested-next.ts`, T9920) — a
+ *    flat `ReadonlyArray<string>` of copy-pasteable CLI commands.
+ * 3. **`_nexus.suggestedNext`** (`contracts/operations/nexus-scope.ts`) — a
+ *    `ReadonlyArray<SuggestedNextOp>` of machine-readable, structured operations.
+ *
+ * {@link MviDigest} is the single primitive that unifies them. A digest
+ * describes a *collapsed* collection: a one-line `summary`, the total `count`,
+ * an optional bounded `preview` sample, and exactly one {@link ExpansionHint}
+ * describing how to fetch the rest. The hint is a discriminated union whose
+ * variants are the three legacy conventions — so existing producers can emit a
+ * digest and existing consumers can read one *without any `any` casts*.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/mvi
+ *
+ * @epic T11285 EP-MVI-PRIMITIVE
+ * @task T11349
+ * @saga T11283 SG-COGNITIVE-SUBSTRATE
+ */
+import type { SuggestedNextOp } from './operations/nexus-scope.js';
+/**
+ * `_next`-style expansion hint: a map of follow-up *name* → CLI command string.
+ *
+ * The `kind` discriminant lets a single {@link MviDigest} carry any of the
+ * three legacy conventions without ambiguity. This variant corresponds to the
+ * `_next` directives built by `core/src/mvi-helpers.ts`.
+ *
+ * @example
+ * ```ts
+ * const hint: NextDirectivesHint = {
+ *   kind: 'next-directives',
+ *   directives: { full: 'cleo show T1', children: 'cleo find --parent T1' },
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface NextDirectivesHint {
+    /** Discriminant: this hint carries `_next`-style named CLI directives. */
+    readonly kind: 'next-directives';
+    /** Map of follow-up operation name → copy-pasteable CLI command string. */
+    readonly directives: Readonly<Record<string, string>>;
+}
+/**
+ * `meta.suggestedNext`-style expansion hint: a flat list of CLI commands.
+ *
+ * Corresponds to the `ReadonlyArray<string>` promoted to
+ * `meta.suggestedNext` in T9920 (`core/src/dispatch/suggested-next.ts`).
+ *
+ * @example
+ * ```ts
+ * const hint: SuggestedCommandsHint = {
+ *   kind: 'suggested-commands',
+ *   commands: ['cleo show T1', 'cleo focus T1'],
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface SuggestedCommandsHint {
+    /** Discriminant: this hint carries a flat list of CLI command strings. */
+    readonly kind: 'suggested-commands';
+    /** Copy-pasteable CLI command strings the agent may run next. */
+    readonly commands: ReadonlyArray<string>;
+}
+/**
+ * `_nexus.suggestedNext`-style expansion hint: structured machine-readable ops.
+ *
+ * Corresponds to the `ReadonlyArray<SuggestedNextOp>` carried under
+ * `meta._nexus.suggestedNext` (`contracts/operations/nexus-scope.ts`). Display
+ * strings are *derived* from these structured fields, never the reverse.
+ *
+ * @example
+ * ```ts
+ * const hint: StructuredOpsHint = {
+ *   kind: 'structured-ops',
+ *   ops: [{ op: 'nexus.context', args: { name: 'foo' }, scope: 'project',
+ *           effect: 'read', requiresConfirmation: false, reason: 'see callers' }],
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface StructuredOpsHint {
+    /** Discriminant: this hint carries structured, machine-readable operations. */
+    readonly kind: 'structured-ops';
+    /** Structured next-operations. Every `.op` resolves to a known op key. */
+    readonly ops: ReadonlyArray<SuggestedNextOp>;
+}
+/**
+ * Unified expansion hint — the discriminated union reconciling CLEO's three
+ * historical progressive-disclosure conventions (`_next`,
+ * `meta.suggestedNext`, `_nexus.suggestedNext`) under one type.
+ *
+ * Narrow on {@link ExpansionHint | the `.kind` discriminant} to access the
+ * variant payload without casts.
+ *
+ * @public
+ */
+export type ExpansionHint = NextDirectivesHint | SuggestedCommandsHint | StructuredOpsHint;
+/**
+ * The Minimum-Viable-Information digest: the formalized progressive-disclosure
+ * primitive for any *collapsed* collection in a LAFS envelope.
+ *
+ * Instead of streaming a full collection (and blowing the agent's token
+ * budget), a producer emits a digest: a one-line {@link MviDigest.summary}, the
+ * total {@link MviDigest.count}, an optional bounded {@link MviDigest.preview}
+ * sample, and exactly one {@link MviDigest.expand} hint describing how to fetch
+ * the remainder.
+ *
+ * @typeParam T - Element type of the underlying collection. The optional
+ *   `preview` is a `ReadonlyArray<T>`; the rest of the digest is element-shape
+ *   agnostic, so a producer can describe any collection with one primitive.
+ *
+ * @example
+ * ```ts
+ * const digest: MviDigest<{ id: string }> = {
+ *   summary: '12 child tasks (3 done, 9 pending)',
+ *   count: 12,
+ *   preview: [{ id: 'T1' }, { id: 'T2' }],
+ *   expand: { kind: 'next-directives', directives: { all: 'cleo list --parent T0' } },
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface MviDigest<T = unknown> {
+    /** One-line human/agent-readable summary of the collapsed collection. */
+    readonly summary: string;
+    /** Total number of elements the collection contains (not the preview size). */
+    readonly count: number;
+    /**
+     * A bounded sample of elements for at-a-glance context. Omitted when no
+     * preview is carried (the agent must {@link MviDigest.expand} to see any).
+     *
+     * @defaultValue undefined
+     */
+    readonly preview?: ReadonlyArray<T>;
+    /** Exactly one {@link ExpansionHint} describing how to fetch the remainder. */
+    readonly expand: ExpansionHint;
+}
+/**
+ * Adapt a legacy `_next` directives map into the unified {@link ExpansionHint}.
+ *
+ * Lets existing `core/src/mvi-helpers.ts` producers feed a digest without
+ * re-shaping their output by hand.
+ *
+ * @param directives - The `_next`-style name → CLI command map.
+ * @returns A {@link NextDirectivesHint} wrapping the directives verbatim.
+ *
+ * @public
+ */
+export declare function expansionFromNextDirectives(directives: Readonly<Record<string, string>>): NextDirectivesHint;
+/**
+ * Adapt a legacy `meta.suggestedNext` command list into an {@link ExpansionHint}.
+ *
+ * @param commands - The flat `ReadonlyArray<string>` of CLI commands.
+ * @returns A {@link SuggestedCommandsHint} wrapping the commands verbatim.
+ *
+ * @public
+ */
+export declare function expansionFromSuggestedCommands(commands: ReadonlyArray<string>): SuggestedCommandsHint;
+/**
+ * Adapt a legacy `_nexus.suggestedNext` op list into an {@link ExpansionHint}.
+ *
+ * @param ops - The structured `ReadonlyArray<SuggestedNextOp>`.
+ * @returns A {@link StructuredOpsHint} wrapping the ops verbatim.
+ *
+ * @public
+ */
+export declare function expansionFromStructuredOps(ops: ReadonlyArray<SuggestedNextOp>): StructuredOpsHint;
+/**
+ * Type guard: narrow an {@link ExpansionHint} to its `_next`-directives variant.
+ *
+ * @param hint - The hint to test.
+ * @returns `true` when `hint.kind === 'next-directives'`.
+ *
+ * @public
+ */
+export declare function isNextDirectivesHint(hint: ExpansionHint): hint is NextDirectivesHint;
+/**
+ * Type guard: narrow an {@link ExpansionHint} to its suggested-commands variant.
+ *
+ * @param hint - The hint to test.
+ * @returns `true` when `hint.kind === 'suggested-commands'`.
+ *
+ * @public
+ */
+export declare function isSuggestedCommandsHint(hint: ExpansionHint): hint is SuggestedCommandsHint;
+/**
+ * Type guard: narrow an {@link ExpansionHint} to its structured-ops variant.
+ *
+ * @param hint - The hint to test.
+ * @returns `true` when `hint.kind === 'structured-ops'`.
+ *
+ * @public
+ */
+export declare function isStructuredOpsHint(hint: ExpansionHint): hint is StructuredOpsHint;
+//# sourceMappingURL=mvi.d.ts.map

package/dist/mvi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvi.d.ts","sourceRoot":"","sources":["../src/mvi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAC9C;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC3C,kBAAkB,CAEpB;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,qBAAqB,CAEvB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,iBAAiB,CAEjG;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,kBAAkB,CAEpF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,qBAAqB,CAE1F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,iBAAiB,CAElF"}

package/dist/mvi.js

@@ -0,0 +1,99 @@
+/**
+ * MVI (Minimum-Viable-Information) progressive-disclosure primitive.
+ *
+ * CLEO historically grew three *separate* "expansion-hint" conventions, each
+ * answering the same question — *"the agent got a lean result; how does it
+ * drill deeper?"* — in a different wire shape:
+ *
+ * 1. **`_next`** (`core/src/mvi-helpers.ts`) — `Record<string, string>`: a map
+ *    of follow-up *name* → copy-pasteable CLI command
+ *    (`{ full: "cleo show T1", children: "cleo find --parent T1" }`).
+ * 2. **`meta.suggestedNext`** (`core/src/dispatch/suggested-next.ts`, T9920) — a
+ *    flat `ReadonlyArray<string>` of copy-pasteable CLI commands.
+ * 3. **`_nexus.suggestedNext`** (`contracts/operations/nexus-scope.ts`) — a
+ *    `ReadonlyArray<SuggestedNextOp>` of machine-readable, structured operations.
+ *
+ * {@link MviDigest} is the single primitive that unifies them. A digest
+ * describes a *collapsed* collection: a one-line `summary`, the total `count`,
+ * an optional bounded `preview` sample, and exactly one {@link ExpansionHint}
+ * describing how to fetch the rest. The hint is a discriminated union whose
+ * variants are the three legacy conventions — so existing producers can emit a
+ * digest and existing consumers can read one *without any `any` casts*.
+ *
+ * @packageDocumentation
+ * @module @cleocode/contracts/mvi
+ *
+ * @epic T11285 EP-MVI-PRIMITIVE
+ * @task T11349
+ * @saga T11283 SG-COGNITIVE-SUBSTRATE
+ */
+/**
+ * Adapt a legacy `_next` directives map into the unified {@link ExpansionHint}.
+ *
+ * Lets existing `core/src/mvi-helpers.ts` producers feed a digest without
+ * re-shaping their output by hand.
+ *
+ * @param directives - The `_next`-style name → CLI command map.
+ * @returns A {@link NextDirectivesHint} wrapping the directives verbatim.
+ *
+ * @public
+ */
+export function expansionFromNextDirectives(directives) {
+    return { kind: 'next-directives', directives };
+}
+/**
+ * Adapt a legacy `meta.suggestedNext` command list into an {@link ExpansionHint}.
+ *
+ * @param commands - The flat `ReadonlyArray<string>` of CLI commands.
+ * @returns A {@link SuggestedCommandsHint} wrapping the commands verbatim.
+ *
+ * @public
+ */
+export function expansionFromSuggestedCommands(commands) {
+    return { kind: 'suggested-commands', commands };
+}
+/**
+ * Adapt a legacy `_nexus.suggestedNext` op list into an {@link ExpansionHint}.
+ *
+ * @param ops - The structured `ReadonlyArray<SuggestedNextOp>`.
+ * @returns A {@link StructuredOpsHint} wrapping the ops verbatim.
+ *
+ * @public
+ */
+export function expansionFromStructuredOps(ops) {
+    return { kind: 'structured-ops', ops };
+}
+/**
+ * Type guard: narrow an {@link ExpansionHint} to its `_next`-directives variant.
+ *
+ * @param hint - The hint to test.
+ * @returns `true` when `hint.kind === 'next-directives'`.
+ *
+ * @public
+ */
+export function isNextDirectivesHint(hint) {
+    return hint.kind === 'next-directives';
+}
+/**
+ * Type guard: narrow an {@link ExpansionHint} to its suggested-commands variant.
+ *
+ * @param hint - The hint to test.
+ * @returns `true` when `hint.kind === 'suggested-commands'`.
+ *
+ * @public
+ */
+export function isSuggestedCommandsHint(hint) {
+    return hint.kind === 'suggested-commands';
+}
+/**
+ * Type guard: narrow an {@link ExpansionHint} to its structured-ops variant.
+ *
+ * @param hint - The hint to test.
+ * @returns `true` when `hint.kind === 'structured-ops'`.
+ *
+ * @public
+ */
+export function isStructuredOpsHint(hint) {
+    return hint.kind === 'structured-ops';
+}
+//# sourceMappingURL=mvi.js.map

package/dist/mvi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvi.js","sourceRoot":"","sources":["../src/mvi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAkIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA4C;IAE5C,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAA+B;IAE/B,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAmC;IAC5E,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAmB;IACtD,OAAO,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAmB;IACzD,OAAO,IAAI,CAAC,IAAI,KAAK,oBAAoB,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,OAAO,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC;AACxC,CAAC"}

package/dist/operations/attention.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Attention Domain Operations Contract (Tier-2 working memory).
+ *
+ * The attention buffer is a per-agent, scope-keyed, decaying working-memory
+ * layer. `cleo attention add` (alias `jot`) writes ONE item, auto-keyed to the
+ * narrowest scope the writing agent resolves (agent > task > epic > saga >
+ * session > global) via the E0 env-first identity resolvers. Because visibility
+ * is the scope key itself, an agent working task `T-A` can never read the
+ * agent/task-scoped items written by an agent working `T-B` — cross-agent
+ * leakage is structurally impossible (Epic T11288).
+ *
+ * CLI identifiers start with `attention.*` and route through the `attention`
+ * domain handler. These operation types are the wire-format API contract.
+ *
+ * @task T11373 — Attention CLI + dispatch op
+ * @epic T11288 EP-TIER2-ATTENTION
+ * @saga T11283 SG-COGNITIVE-SUBSTRATE
+ * @see packages/core/src/memory/attention.ts
+ * @see packages/cleo/src/dispatch/domains/attention.ts
+ */
+/**
+ * Scope-kind taxonomy for attention items, ordered NARROWEST → BROADEST.
+ *
+ * Mirrors `BRAIN_ATTENTION_SCOPE_KINDS` in the brain schema; declared here so
+ * the wire contract does not depend on the core schema module.
+ */
+export type AttentionScopeKind = 'agent' | 'task' | 'epic' | 'saga' | 'session' | 'global';
+/** Lifecycle status of an attention item. */
+export type AttentionStatus = 'open' | 'consolidated' | 'discarded';
+/**
+ * One attention item in wire format.
+ *
+ * Returned by `add`, `show`, and `list`. `tags` is always a parsed string
+ * array (decoded from the JSONB column via `json(col)`), never the raw BLOB.
+ */
+export interface AttentionItem {
+    /** Stable item id (`att_<ts>_<hex>`). */
+    id: string;
+    /** The jot content. */
+    content: string;
+    /** Resolved session id of the writer, if any. */
+    sessionId: string | null;
+    /** Resolved agent identity of the writer, if any. */
+    agentId: string | null;
+    /** Narrowest scope kind the item was keyed to. */
+    scopeKind: AttentionScopeKind;
+    /** Id of the bound scope (task/epic/saga id, agent id, session id, or `global`). */
+    scopeId: string;
+    /** Parsed tag list (decoded from the JSONB column). */
+    tags: string[];
+    /** Creation time, unix epoch milliseconds. */
+    createdAt: number;
+    /** Optional hard TTL, unix epoch milliseconds. */
+    expiresAt: number | null;
+    /** Optional decay score in `[0, 1]`. */
+    decayScore: number | null;
+    /** Lifecycle status. */
+    status: AttentionStatus;
+}
+/**
+ * Parameters for `attention.add` (alias `jot`).
+ *
+ * Identity (`sessionId`/`agentId`) and the current task are resolved server-
+ * side from the environment (E0) — callers do NOT pass them by default. The
+ * optional `scope` override escalates the auto-resolved narrowest scope.
+ */
+export interface AttentionAddParams {
+    /** The jot content. Required, non-empty. */
+    content: string;
+    /** Optional tags to attach. */
+    tags?: string[];
+    /**
+     * Optional explicit scope override. When omitted the narrowest resolvable
+     * scope is used. Accepts a scope kind to escalate to (e.g. `epic`, `saga`).
+     */
+    scope?: AttentionScopeKind;
+    /** Optional TTL in seconds from now (sets `expiresAt`). */
+    ttlSeconds?: number;
+}
+/**
+ * Parameters for `attention.list` / `attention.show`.
+ *
+ * With no flags the resolved scope chain (narrowest + visible ancestors) of the
+ * calling agent is used. `--scope` restricts to one kind; `--tag` filters by
+ * "contains ALL" membership.
+ */
+export interface AttentionListParams {
+    /** Restrict to one scope kind. */
+    scope?: AttentionScopeKind;
+    /** "Contains ALL" tag filter. */
+    tags?: string[];
+    /** Include non-open items too (default: open only). */
+    includeAll?: boolean;
+    /** Max rows. */
+    limit?: number;
+}
+/** Result of `attention.add`. */
+export interface AttentionAddResult {
+    /** The persisted item. */
+    item: AttentionItem;
+}
+/** Result of `attention.list` / `attention.show`. */
+export interface AttentionListResult {
+    /** Matching items, newest first. */
+    items: AttentionItem[];
+    /** Total returned (== items.length; the digest carries the live count). */
+    total: number;
+    /** The scope chain the items were resolved against (for transparency). */
+    resolvedScopes: Array<{
+        kind: AttentionScopeKind;
+        id: string;
+    }>;
+}
+//# sourceMappingURL=attention.d.ts.map

package/dist/operations/attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../src/operations/attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3F,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,WAAW,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wCAAwC;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wBAAwB;IACxB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE"}

package/dist/operations/attention.js

@@ -0,0 +1,22 @@
+/**
+ * Attention Domain Operations Contract (Tier-2 working memory).
+ *
+ * The attention buffer is a per-agent, scope-keyed, decaying working-memory
+ * layer. `cleo attention add` (alias `jot`) writes ONE item, auto-keyed to the
+ * narrowest scope the writing agent resolves (agent > task > epic > saga >
+ * session > global) via the E0 env-first identity resolvers. Because visibility
+ * is the scope key itself, an agent working task `T-A` can never read the
+ * agent/task-scoped items written by an agent working `T-B` — cross-agent
+ * leakage is structurally impossible (Epic T11288).
+ *
+ * CLI identifiers start with `attention.*` and route through the `attention`
+ * domain handler. These operation types are the wire-format API contract.
+ *
+ * @task T11373 — Attention CLI + dispatch op
+ * @epic T11288 EP-TIER2-ATTENTION
+ * @saga T11283 SG-COGNITIVE-SUBSTRATE
+ * @see packages/core/src/memory/attention.ts
+ * @see packages/cleo/src/dispatch/domains/attention.ts
+ */
+export {};
+//# sourceMappingURL=attention.js.map

package/dist/operations/attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.js","sourceRoot":"","sources":["../../src/operations/attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/operations/focus.d.ts

@@ -11,7 +11,23 @@
  * @task T9973
  * @epic T9964 E-ORIENT-V2
  */
+import type { MviDigest } from '../mvi.js';
+import type { AttentionScopeKind } from './attention.js';
 import type { MemoryCompactHit } from './memory.js';
+/**
+ * A minimal preview element for the attention digest (T11374 · Epic T11288).
+ *
+ * The MVI digest preview carries only the few fields an agent needs to glance
+ * at a jot — the full item is one `cleo attention show` away (the expand hint).
+ */
+export interface AttentionDigestPreviewItem {
+    /** Item id. */
+    id: string;
+    /** Truncated jot content. */
+    content: string;
+    /** Scope kind the jot is keyed to. */
+    scopeKind: AttentionScopeKind;
+}
 /**
  * Parameters for `focus.show`.
  *
@@ -182,6 +198,15 @@ export interface FocusShowResult {
      * Omitted when the BRAIN store is unavailable.
      */
     brainContext?: FocusBrainContext;
+    /**
+     * Tier-2 attention digest — a budget-bounded MVI summary of the open
+     * working-memory jots visible to the calling agent in this scope (T11374 ·
+     * Epic T11288). Carries a one-line summary, the live count, a tiny preview,
+     * and the `cleo attention show` expand hint — never a full dump. Omitted when
+     * there are zero open items (the empty-attention contract) or the buffer is
+     * unavailable.
+     */
+    attentionDigest?: MviDigest<AttentionDigestPreviewItem>;
     /** Estimated token weight of this envelope. */
     tokensEstimated: number;
 }

package/dist/operations/focus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/operations/focus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/operations/focus.ts"],"names":[],"mappings":"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"}

package/dist/operations/index.d.ts

@@ -6,6 +6,7 @@
  */
 export * from './admin.js';
 export * from './agent-operation-contract.js';
+export * from './attention.js';
 export * from './brain.js';
 export * from './conduit.js';
 export * from './dialectic.js';

package/dist/operations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/operations/index.js

@@ -6,6 +6,7 @@
  */
 export * from './admin.js';
 export * from './agent-operation-contract.js';
+export * from './attention.js';
 export * from './brain.js';
 export * from './conduit.js';
 export * from './dialectic.js';

package/dist/operations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/operations/session.d.ts

@@ -523,6 +523,17 @@ export interface SessionEndParams {
      * @task T140 @epic T134
      */
     sessionSummary?: import('../config.js').SessionSummaryInput;
+    /**
+     * Explicit session id to end (T11346 · Epic T11284).
+     *
+     * When omitted, session-end targets the CALLER's session resolved env-first
+     * (`CLEO_SESSION_ID` → … → most-recent active). When provided, this id
+     * overrides env/active resolution. Either way, one agent can no longer end a
+     * different concurrently-active agent's session implicitly.
+     *
+     * @task T11346
+     */
+    sessionId?: string;
 }
 /** Result of `session.end`. */
 export interface SessionEndResult {