@cleocode/contracts 2026.4.99 → 2026.4.101

package/dist/operations/session.d.ts

@@ -1,15 +1,18 @@
 /**
- * Session Domain Operations (9 operations)
+ * Session Domain Operations (15 operations)
  *
- * Query operations: 4
- * Mutate operations: 5
+ * Query operations: 8 (status, list, show, find, decision.log, context.drift, handoff.show, briefing.show)
+ * Mutate operations: 7 (start, end, resume, suspend, gc, record.decision, record.assumption)
  *
- * SYNC: Canonical type definitions live in the CLI package at:
- *   src/types/session.ts (Session, SessionScope, etc.)
- * These operation types are the API contract (wire format).
+ * SYNC: Canonical domain types live in packages/contracts/src/session.ts.
+ * These operation types are the API contract (wire format) for the dispatch layer.
+ *
+ * @task T975 — typed-dispatch migration (Wave D · T962)
  */
+import type { Session } from '../session.js';
 /**
- * Common session types
+ * Minimal session representation for wire-format responses.
+ * Used in results that return simplified session data.
  */
 export interface SessionOp {
     id: string;
@@ -21,56 +24,129 @@ export interface SessionOp {
     status: 'active' | 'suspended' | 'ended';
     notes?: string[];
 }
-/**
- * Query Operations
- */
+/** Parameters for `session.status` — no params required. */
 export type SessionStatusParams = Record<string, never>;
 /**
  * Result of `session.status`.
  *
  * @remarks
  * Re-synced to match the envelope returned by `sessionStatus` in
- * `packages/cleo/src/dispatch/engines/session-engine.ts`. The legacy
- * contract's `{current, hasStartedTask, startedTask}` shape predated the
- * current engine and never matched dispatch output — agents reading the
- * contract would never find their data.
+ * `packages/cleo/src/dispatch/engines/session-engine.ts`.
  *
  * @task T963 — contract↔impl drift reconciliation (T910 audit)
  */
 export interface SessionStatusResult {
-    /** True when a session is currently active. @task T963 */
+    /** True when a session is currently active. */
     hasActiveSession: boolean;
-    /**
-     * Active session record (full shape per `Session` contract) or `null`
-     * when none active.
-     * @task T963
-     */
-    session?: SessionOp | null;
-    /**
-     * Current task work state from `meta.focus_state` — tracks the
-     * task the orchestrator is focused on within the session.
-     * @task T963
-     */
+    /** Active session record or `null` when none active. */
+    session?: Session | null;
+    /** Current task work state from `meta.focus_state`. */
     taskWork?: import('../task.js').TaskWorkState | null;
 }
+/** Parameters for `session.list`. */
 export interface SessionListParams {
     active?: boolean;
     status?: string;
     limit?: number;
     offset?: number;
 }
+/** Result of `session.list`. */
 export interface SessionListResult {
-    sessions: SessionOp[];
+    sessions: Session[];
     total: number;
     filtered: number;
 }
+/** Parameters for `session.show`. */
 export interface SessionShowParams {
     sessionId: string;
+    /** When set to 'debrief', returns debrief data instead of the raw session. */
+    include?: string;
+}
+/**
+ * Result of `session.show`.
+ *
+ * @remarks
+ * `unknown` because `show` with `include='debrief'` returns opaque debrief
+ * data (DebriefData | fallback object) rather than a Session record.
+ */
+export type SessionShowResult = unknown;
+/** Parameters for `session.find` — lightweight session discovery. */
+export interface SessionFindParams {
+    status?: string;
+    scope?: string;
+    query?: string;
+    limit?: number;
+}
+/** Result of `session.find` — minimal session records. */
+export interface SessionFindResult {
+    sessions: Array<{
+        id: string;
+        name: string;
+        status: string;
+        startedAt: string;
+        scope: unknown;
+    }>;
+}
+/** Parameters for `session.decision.log`. */
+export interface SessionDecisionLogParams {
+    sessionId?: string;
+    taskId?: string;
+}
+/** A single decision record in the audit trail. */
+export interface DecisionRecord {
+    id: string;
+    sessionId: string;
+    taskId: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+    timestamp: string;
+}
+/** Result of `session.decision.log`. */
+export type SessionDecisionLogResult = DecisionRecord[];
+/** Parameters for `session.context.drift`. */
+export interface SessionContextDriftParams {
+    sessionId?: string;
+}
+/** Result of `session.context.drift`. */
+export interface SessionContextDriftResult {
+    score: number;
+    factors: string[];
+    completedInScope: number;
+    totalInScope: number;
+    outOfScope: number;
+}
+/** Parameters for `session.handoff.show`. */
+export interface SessionHandoffShowParams {
+    /**
+     * Scope filter string. Use 'global' for global scope or 'epic:<id>' for
+     * epic-scoped handoff data.
+     */
+    scope?: string;
+}
+/** Result of `session.handoff.show`. */
+export interface SessionHandoffShowResult {
+    sessionId: string;
+    handoff: unknown;
+}
+/** Parameters for `session.briefing.show`. */
+export interface SessionBriefingShowParams {
+    maxNextTasks?: number;
+    maxBugs?: number;
+    maxBlocked?: number;
+    maxEpics?: number;
+    scope?: string;
 }
-export type SessionShowResult = SessionOp;
+/**
+ * Result of `session.briefing.show` — composite session-start context.
+ * The full shape is defined in `@cleocode/core/internal.SessionBriefing`.
+ */
+export type SessionBriefingShowResult = unknown;
+/** Parameters for `session.history`. */
 export interface SessionHistoryParams {
     limit?: number;
 }
+/** A single session history entry. */
 export interface SessionHistoryEntry {
     sessionId: string;
     name: string;
@@ -79,19 +155,25 @@ export interface SessionHistoryEntry {
     tasksCompleted: number;
     duration: string;
 }
+/** Result of `session.history`. */
 export type SessionHistoryResult = SessionHistoryEntry[];
-/**
- * Mutate Operations
- */
+/** Parameters for `session.start`. */
 export interface SessionStartParams {
     scope: string;
     name?: string;
     autoStart?: boolean;
     startTask?: string;
+    /** Alias for startTask — accepted from CLI for backward compat. */
+    focus?: string;
+    /** Enable full query+mutation audit logging for behavioral grading. */
+    grade?: boolean;
 }
-export type SessionStartResult = SessionOp;
+/** Result of `session.start` — the newly created session. */
+export type SessionStartResult = Session;
+/** Parameters for `session.end`. */
 export interface SessionEndParams {
-    notes?: string;
+    note?: string;
+    nextAction?: string;
     /**
      * Structured session summary for direct ingestion into brain.db.
      * When provided, CLEO persists key learnings, decisions, patterns, and next actions.
@@ -99,13 +181,10 @@ export interface SessionEndParams {
      */
     sessionSummary?: import('../config.js').SessionSummaryInput;
 }
+/** Result of `session.end`. */
 export interface SessionEndResult {
-    session: SessionOp;
-    summary: {
-        duration: string;
-        tasksCompleted: number;
-        tasksCreated: number;
-    };
+    sessionId: string;
+    ended: boolean;
     /**
      * A summarization prompt built from this session's debrief data.
      * Populated when `brain.summarization.enabled` is true.
@@ -113,22 +192,81 @@ export interface SessionEndResult {
      */
     memoryPrompt?: string;
 }
+/** Parameters for `session.resume`. */
 export interface SessionResumeParams {
     sessionId: string;
 }
-export type SessionResumeResult = SessionOp;
+/** Result of `session.resume` — the resumed session. */
+export type SessionResumeResult = Session;
+/** Parameters for `session.suspend`. */
 export interface SessionSuspendParams {
-    notes?: string;
-}
-export interface SessionSuspendResult {
     sessionId: string;
-    suspended: string;
+    reason?: string;
 }
+/** Result of `session.suspend` — the suspended session. */
+export type SessionSuspendResult = Session;
+/** Parameters for `session.gc`. */
 export interface SessionGcParams {
-    olderThan?: string;
+    maxAgeDays?: number;
 }
+/** Result of `session.gc`. */
 export interface SessionGcResult {
-    cleaned: number;
-    sessionIds: string[];
+    orphaned: string[];
+    removed: string[];
+}
+/** Parameters for `session.record.decision`. */
+export interface SessionRecordDecisionParams {
+    sessionId?: string;
+    taskId: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+}
+/** Result of `session.record.decision`. */
+export type SessionRecordDecisionResult = DecisionRecord;
+/** Parameters for `session.record.assumption`. */
+export interface SessionRecordAssumptionParams {
+    sessionId?: string;
+    taskId?: string;
+    assumption: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+/** Result of `session.record.assumption`. */
+export interface SessionRecordAssumptionResult {
+    id: string;
+    sessionId: string;
+    taskId: string | null;
+    assumption: string;
+    confidence: string;
+    timestamp: string;
 }
+/**
+ * Typed operation record for the session domain.
+ *
+ * Maps each operation name (as dispatched by the registry — no domain prefix)
+ * to its `[Params, Result]` tuple. Used by `TypedDomainHandler<SessionOps>`
+ * in the dispatch layer to provide compile-time narrowing of params.
+ *
+ * @task T975 — Wave D typed-dispatch migration
+ */
+export type SessionOps = {
+    readonly status: readonly [SessionStatusParams, SessionStatusResult];
+    readonly list: readonly [SessionListParams, SessionListResult];
+    readonly show: readonly [SessionShowParams, SessionShowResult];
+    readonly find: readonly [SessionFindParams, SessionFindResult];
+    readonly 'decision.log': readonly [SessionDecisionLogParams, SessionDecisionLogResult];
+    readonly 'context.drift': readonly [SessionContextDriftParams, SessionContextDriftResult];
+    readonly 'handoff.show': readonly [SessionHandoffShowParams, SessionHandoffShowResult | null];
+    readonly 'briefing.show': readonly [SessionBriefingShowParams, SessionBriefingShowResult];
+    readonly start: readonly [SessionStartParams, SessionStartResult];
+    readonly end: readonly [SessionEndParams, SessionEndResult];
+    readonly resume: readonly [SessionResumeParams, SessionResumeResult];
+    readonly suspend: readonly [SessionSuspendParams, SessionSuspendResult];
+    readonly gc: readonly [SessionGcParams, SessionGcResult];
+    readonly 'record.decision': readonly [SessionRecordDecisionParams, SessionRecordDecisionResult];
+    readonly 'record.assumption': readonly [
+        SessionRecordAssumptionParams,
+        SessionRecordAssumptionResult
+    ];
+};
 //# sourceMappingURL=session.d.ts.map

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

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

package/dist/operations/session.js

@@ -1,12 +1,13 @@
 /**
- * Session Domain Operations (9 operations)
+ * Session Domain Operations (15 operations)
  *
- * Query operations: 4
- * Mutate operations: 5
+ * Query operations: 8 (status, list, show, find, decision.log, context.drift, handoff.show, briefing.show)
+ * Mutate operations: 7 (start, end, resume, suspend, gc, record.decision, record.assumption)
  *
- * SYNC: Canonical type definitions live in the CLI package at:
- *   src/types/session.ts (Session, SessionScope, etc.)
- * These operation types are the API contract (wire format).
+ * SYNC: Canonical domain types live in packages/contracts/src/session.ts.
+ * These operation types are the API contract (wire format) for the dispatch layer.
+ *
+ * @task T975 — typed-dispatch migration (Wave D · T962)
  */
 export {};
 //# sourceMappingURL=session.js.map

package/dist/operations/session.js.map

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

package/dist/operations/sticky.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Sticky Domain Operations Contract (6 operations)
+ *
+ * Query operations: 2
+ * Mutate operations: 4
+ *
+ * Sticky notes are ephemeral task fragments stored in a project-local SQLite database.
+ * They support filtering by status (active/converted/archived), color, priority, and tags.
+ * CLI identifiers start with `sticky.*` and are routed through the `sticky` domain handler.
+ *
+ * SYNC: Canonical type definitions live in packages/core/src/sticky/types.ts.
+ * These operation types are the API contract (wire format).
+ *
+ * @task T1031 — Contract authoring for T980 migration worker
+ * @see packages/cleo/src/dispatch/domains/sticky.ts
+ * @see packages/core/src/sticky/types.ts
+ */
+/**
+ * Sticky note status classification.
+ */
+export type StickyNoteStatus = 'active' | 'converted' | 'archived';
+/**
+ * Sticky note color options.
+ */
+export type StickyNoteColor = 'yellow' | 'blue' | 'green' | 'red' | 'purple';
+/**
+ * Sticky note priority levels.
+ */
+export type StickyNotePriority = 'low' | 'medium' | 'high';
+/**
+ * Converted target type for note transformation.
+ */
+export type StickyConvertTargetType = 'task' | 'memory' | 'session_note' | 'task_note';
+/**
+ * Reference to a converted target (task, memory, session note, or task note).
+ */
+export interface StickyConvertedTarget {
+    /** Type of the conversion target. */
+    type: StickyConvertTargetType;
+    /** ID of the target item. */
+    id: string;
+}
+/**
+ * Core sticky note wire format (API projection).
+ *
+ * Returned by list, show, add, archive, purge operations.
+ */
+export interface StickyNoteOp {
+    /** Unique ID (SN-001, SN-002...). */
+    id: string;
+    /** Raw note text content. */
+    content: string;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last update timestamp. */
+    updatedAt?: string;
+    /** Array of user-assigned tags. */
+    tags: string[];
+    /** Current status (active/converted/archived). */
+    status: StickyNoteStatus;
+    /** Conversion target if converted (nullable). */
+    convertedTo?: StickyConvertedTarget;
+    /** Visual color indicator. */
+    color?: StickyNoteColor;
+    /** Priority level. */
+    priority?: StickyNotePriority;
+    /** Source type for BRAIN queries. */
+    sourceType: string;
+}
+/**
+ * List of sticky notes with pagination metadata.
+ */
+export interface StickyListData {
+    /** Array of sticky notes matching the filter. */
+    stickies: StickyNoteOp[];
+    /** Total count of stickies in the project (ignoring pagination). */
+    total: number;
+    /** Count of stickies that matched the filter. */
+    filtered: number;
+}
+/**
+ * Parameters for `sticky.list`.
+ *
+ * @remarks
+ * All filter parameters are optional and combine with AND logic (all must match).
+ * Pagination applies to filtered results.
+ */
+export interface StickyListParams {
+    /** Filter to notes with a specific status. */
+    status?: StickyNoteStatus;
+    /** Filter to notes with a specific color. */
+    color?: StickyNoteColor;
+    /** Filter to notes with a specific priority. */
+    priority?: StickyNotePriority;
+    /** Filter to notes containing ALL of the specified tags. */
+    tags?: string[];
+    /** Max results to return (pagination limit). */
+    limit?: number;
+    /** Pagination offset (number of results to skip). */
+    offset?: number;
+}
+/**
+ * Result of `sticky.list`.
+ *
+ * @remarks
+ * Returns a paginated list of sticky notes with total and filtered counts.
+ */
+export interface StickyListResult {
+    /** Array of sticky notes for this page. */
+    stickies: StickyNoteOp[];
+    /** Total sticky note count across all filters. */
+    total: number;
+    /** Count of stickies matching the applied filters. */
+    filtered: number;
+}
+/**
+ * Parameters for `sticky.show`.
+ */
+export interface StickyShowParams {
+    /** Sticky note ID to retrieve (required). */
+    stickyId: string;
+}
+/**
+ * Result of `sticky.show`.
+ *
+ * @remarks
+ * Returns the full sticky note record, or error if not found.
+ */
+export type StickyShowResult = StickyNoteOp;
+/**
+ * Parameters for `sticky.add`.
+ */
+export interface StickyAddParams {
+    /** Note text content (required). */
+    content: string;
+    /** User-assigned tags. */
+    tags?: string[];
+    /** Visual color indicator. */
+    color?: StickyNoteColor;
+    /** Priority level. */
+    priority?: StickyNotePriority;
+}
+/**
+ * Result of `sticky.add`.
+ *
+ * @remarks
+ * Returns the newly-created sticky note record.
+ */
+export type StickyAddResult = StickyNoteOp;
+/**
+ * Parameters for `sticky.convert`.
+ *
+ * @remarks
+ * Converts a sticky note to a different item type (task, memory, session note, task note).
+ * Required params vary by targetType:
+ *   - task: optional title
+ *   - memory: optional memoryType
+ *   - session_note: optional sessionId
+ *   - task_note: required taskId
+ */
+export interface StickyConvertParams {
+    /** Sticky note ID to convert (required). */
+    stickyId: string;
+    /** Target item type: task, memory, session_note, or task_note (required). */
+    targetType: StickyConvertTargetType;
+    /** Optional title when converting to task. */
+    title?: string;
+    /** Optional memory type when converting to memory (observation, decision, pattern, etc.). */
+    memoryType?: string;
+    /** Required task ID when converting to task_note. */
+    taskId?: string;
+    /** Optional session ID when converting to session_note. */
+    sessionId?: string;
+}
+/**
+ * Result of `sticky.convert`.
+ *
+ * @remarks
+ * Returns the target item ID that was created/updated by the conversion.
+ * The returned key varies by targetType:
+ *   - task → taskId
+ *   - memory → memoryId
+ *   - session_note → sessionId
+ *   - task_note → taskId
+ */
+export interface StickyConvertResult {
+    /** ID of the created or updated target item (key name varies by type). */
+    taskId?: string;
+    memoryId?: string;
+    sessionId?: string;
+}
+/**
+ * Parameters for `sticky.archive`.
+ */
+export interface StickyArchiveParams {
+    /** Sticky note ID to archive (required). */
+    stickyId: string;
+}
+/**
+ * Result of `sticky.archive`.
+ *
+ * @remarks
+ * Returns the archived sticky note record with status updated to 'archived'.
+ */
+export type StickyArchiveResult = StickyNoteOp;
+/**
+ * Parameters for `sticky.purge`.
+ */
+export interface StickyPurgeParams {
+    /** Sticky note ID to permanently delete (required). */
+    stickyId: string;
+}
+/**
+ * Result of `sticky.purge`.
+ *
+ * @remarks
+ * Returns the purged sticky note record. After purge, the note is permanently deleted
+ * from the database and cannot be recovered.
+ */
+export type StickyPurgeResult = StickyNoteOp;
+/**
+ * All sticky operation keys (for TypedDomainHandler routing).
+ */
+export type StickyOpKey = 'sticky.list' | 'sticky.show' | 'sticky.add' | 'sticky.convert' | 'sticky.archive' | 'sticky.purge';
+/**
+ * Sticky operations discriminated union.
+ *
+ * @remarks
+ * Each variant carries:
+ * - `op`: the operation key (for routing)
+ * - `params`: strongly-typed parameters for this operation
+ * - `result`: strongly-typed return type for this operation
+ *
+ * Consumed by packages/cleo/src/dispatch/domains/sticky.ts via TypedDomainHandler<StickyOps>.
+ *
+ * @task T1031
+ * @task T980 — migration worker that consumes this contract
+ */
+export type StickyOps = {
+    op: 'sticky.list';
+    params: StickyListParams;
+    result: StickyListResult;
+} | {
+    op: 'sticky.show';
+    params: StickyShowParams;
+    result: StickyShowResult;
+} | {
+    op: 'sticky.add';
+    params: StickyAddParams;
+    result: StickyAddResult;
+} | {
+    op: 'sticky.convert';
+    params: StickyConvertParams;
+    result: StickyConvertResult;
+} | {
+    op: 'sticky.archive';
+    params: StickyArchiveParams;
+    result: StickyArchiveResult;
+} | {
+    op: 'sticky.purge';
+    params: StickyPurgeParams;
+    result: StickyPurgeResult;
+};
+//# sourceMappingURL=sticky.d.ts.map

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

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

package/dist/operations/sticky.js

@@ -0,0 +1,19 @@
+/**
+ * Sticky Domain Operations Contract (6 operations)
+ *
+ * Query operations: 2
+ * Mutate operations: 4
+ *
+ * Sticky notes are ephemeral task fragments stored in a project-local SQLite database.
+ * They support filtering by status (active/converted/archived), color, priority, and tags.
+ * CLI identifiers start with `sticky.*` and are routed through the `sticky` domain handler.
+ *
+ * SYNC: Canonical type definitions live in packages/core/src/sticky/types.ts.
+ * These operation types are the API contract (wire format).
+ *
+ * @task T1031 — Contract authoring for T980 migration worker
+ * @see packages/cleo/src/dispatch/domains/sticky.ts
+ * @see packages/core/src/sticky/types.ts
+ */
+export {};
+//# sourceMappingURL=sticky.js.map

package/dist/operations/sticky.js.map

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