@cleocode/core 2026.3.42 → 2026.3.43

package/dist/sessions/briefing.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Session briefing computation.
+ *
+ * Aggregates session-start context from multiple sources for quick agent
+ * orientation. This is the READ side of the handoff/briefing pair.
+ *
+ * Data sources:
+ * - Last session handoff (session.handoff)
+ * - Current focus (tasks.current)
+ * - Top-N next tasks (tasks.next leverage-scored)
+ * - Open bugs (tasks with origin:bug-report or label:bug)
+ * - Blocked tasks (tasks.blockers)
+ * - Active epics status (tasks.tree filtered)
+ * - Pipeline stage data (from T4912)
+ *
+ * @task T4916
+ * @epic T4914
+ */
+import type { SessionMemoryContext } from '../memory/session-memory.js';
+import { type HandoffData } from './handoff.js';
+/**
+ * Task summary for briefing output.
+ */
+export interface BriefingTask {
+    id: string;
+    title: string;
+    leverage: number;
+    score: number;
+}
+/**
+ * Bug summary for briefing output.
+ */
+export interface BriefingBug {
+    id: string;
+    title: string;
+    priority: string;
+}
+/**
+ * Blocked task summary for briefing output.
+ */
+export interface BriefingBlockedTask {
+    id: string;
+    title: string;
+    blockedBy: string[];
+}
+/**
+ * Active epic summary for briefing output.
+ */
+export interface BriefingEpic {
+    id: string;
+    title: string;
+    completionPercent: number;
+}
+/**
+ * Pipeline stage data for briefing output.
+ */
+export interface PipelineStageInfo {
+    currentStage: string;
+    stageStatus: string;
+}
+/**
+ * Last session info with handoff data.
+ */
+export interface LastSessionInfo {
+    endedAt: string;
+    duration: number;
+    handoff: HandoffData;
+}
+/**
+ * Currently active task info.
+ */
+export interface CurrentTaskInfo {
+    id: string;
+    title: string;
+    status: string;
+    blockedBy?: string[];
+}
+/**
+ * Session briefing result.
+ */
+export interface SessionBriefing {
+    lastSession: LastSessionInfo | null;
+    currentTask: CurrentTaskInfo | null;
+    nextTasks: BriefingTask[];
+    openBugs: BriefingBug[];
+    blockedTasks: BriefingBlockedTask[];
+    activeEpics: BriefingEpic[];
+    pipelineStage?: PipelineStageInfo;
+    warnings?: string[];
+    /** Brain memory context -- decisions/patterns/observations relevant to this scope. */
+    memoryContext?: SessionMemoryContext;
+}
+/**
+ * Options for computing session briefing.
+ */
+export interface BriefingOptions {
+    /** Maximum number of next tasks to include (default: 5) */
+    maxNextTasks?: number;
+    /** Maximum number of bugs to include (default: 10) */
+    maxBugs?: number;
+    /** Maximum number of blocked tasks to include (default: 10) */
+    maxBlocked?: number;
+    /** Maximum number of active epics to include (default: 5) */
+    maxEpics?: number;
+    /** Scope filter: 'global' or 'epic:T###' */
+    scope?: string;
+}
+/**
+ * Compute the complete session briefing.
+ * Aggregates data from all 6+ sources.
+ */
+export declare function computeBriefing(projectRoot: string, options?: BriefingOptions): Promise<SessionBriefing>;
+//# sourceMappingURL=briefing.d.ts.map

package/dist/sessions/briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../../src/sessions/briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAsF1B"}

package/dist/sessions/context-alert.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Context window threshold crossing alerts.
+ *
+ * Detects when context usage crosses warning/caution/critical/emergency
+ * thresholds and emits alerts. Supports suppression and per-command filtering.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Context alert thresholds (percentage of context window). */
+export declare const THRESHOLDS: {
+    readonly WARNING: 70;
+    readonly CAUTION: 85;
+    readonly CRITICAL: 90;
+    readonly EMERGENCY: 95;
+};
+/** Alert level names. */
+export type AlertLevel = 'warning' | 'caution' | 'critical' | 'emergency';
+/** Get the current session ID. */
+export declare function getCurrentSessionId(cwd?: string): string | null;
+/** Get context state file path for a session. */
+export declare function getContextStatePath(sessionId?: string, cwd?: string): string;
+/** Read context state for a session. Returns null if stale or missing. */
+export declare function readContextState(sessionId?: string, cwd?: string): Record<string, unknown> | null;
+/** Determine the threshold level for a given percentage. */
+export declare function getThresholdLevel(percentage: number): AlertLevel | null;
+/**
+ * Determine if we should alert based on threshold crossing.
+ * Returns the alert level if a new threshold was crossed, null otherwise.
+ */
+export declare function shouldAlert(currentPct: number, lastAlertedPct?: number, minThreshold?: AlertLevel): AlertLevel | null;
+/** Alert result from check_context_alert. */
+export interface AlertCheckResult {
+    alerted: boolean;
+    level: AlertLevel | null;
+    percentage: number;
+    currentTokens: number;
+    maxTokens: number;
+    action: string | null;
+}
+/** Get recommended action for an alert level. */
+export declare function getRecommendedAction(percentage: number): string | null;
+/**
+ * Main function to check and determine if an alert should fire.
+ * Non-blocking - always returns a result.
+ */
+export declare function checkContextAlert(currentCommand?: string, cwd?: string): AlertCheckResult;
+//# sourceMappingURL=context-alert.d.ts.map

package/dist/sessions/context-alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-alert.d.ts","sourceRoot":"","sources":["../../src/sessions/context-alert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH,+DAA+D;AAC/D,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,yBAAyB;AACzB,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAgB1E,kCAAkC;AAClC,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ/D;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBjG;AAyBD,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAMvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,MAAU,EAC1B,YAAY,GAAE,UAAsB,GACnC,UAAU,GAAG,IAAI,CAcnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA4EzF"}

package/dist/sessions/context-inject.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Session Context Injection
+ *
+ * Reads protocol injection content for a given protocol type. Extracted from
+ * engine-compat.ts during the memory domain cutover (T5241) to separate
+ * session concerns from brain.db cognitive memory.
+ *
+ * @task T5241
+ * @epic T5149
+ */
+/**
+ * Data returned by context injection.
+ */
+export interface ContextInjectionData {
+    protocolType: string;
+    content: string;
+    path: string | null;
+    contentLength: number;
+    estimatedTokens: number;
+    taskId: string | null;
+    variant: string | null;
+}
+/**
+ * Read protocol injection content for a given protocol type.
+ * Core logic for session.context.inject.
+ */
+export declare function injectContext(protocolType: string, params?: {
+    taskId?: string;
+    variant?: string;
+}, projectRoot?: string): ContextInjectionData;
+//# sourceMappingURL=context-inject.d.ts.map

package/dist/sessions/context-inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-inject.d.ts","sourceRoot":"","sources":["../../src/sessions/context-inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,WAAW,CAAC,EAAE,MAAM,GACnB,oBAAoB,CA0CtB"}

package/dist/sessions/context-monitor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Context monitor - reads Claude Code context window JSON and writes state.
+ *
+ * Used by the status line integration to track context window usage.
+ * Receives JSON via stdin from Claude Code and writes state files.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Context window input from Claude Code. */
+export interface ContextWindowInput {
+    context_window: {
+        context_window_size?: number;
+        current_usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        };
+    };
+}
+/** Context status derived from input. */
+export type ContextStatus = 'ok' | 'warning' | 'caution' | 'critical' | 'emergency';
+/** Determine status from percentage. */
+export declare function getContextStatusFromPercentage(percentage: number): ContextStatus;
+/**
+ * Process context window input and write state file.
+ * Returns the status line string for display.
+ *
+ * Tries adapter-based context monitoring first; falls back to local implementation.
+ */
+export declare function processContextInput(input: ContextWindowInput, cwd?: string): Promise<string>;
+//# sourceMappingURL=context-monitor.d.ts.map

package/dist/sessions/context-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["../../src/sessions/context-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE;QACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE;YACd,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,2BAA2B,CAAC,EAAE,MAAM,CAAC;YACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;SAClC,CAAC;KACH,CAAC;CACH;AAED,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpF,wCAAwC;AACxC,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAMhF;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAqEjB"}

package/dist/sessions/decisions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Decision recording and retrieval for session audit trail.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import type { DecisionRecord } from './types.js';
+export interface RecordDecisionParams {
+    sessionId: string;
+    taskId: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+}
+export interface DecisionLogParams {
+    sessionId?: string;
+    taskId?: string;
+}
+/**
+ * Record a decision to the audit trail.
+ * Appends a JSON line to `.cleo/audit/decisions.jsonl`.
+ * Throws if required params are missing.
+ */
+export declare function recordDecision(projectRoot: string, params: RecordDecisionParams): Promise<DecisionRecord>;
+/**
+ * Read the decision log, optionally filtered by sessionId and/or taskId.
+ */
+export declare function getDecisionLog(projectRoot: string, params?: DecisionLogParams): Promise<DecisionRecord[]>;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/sessions/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/sessions/decisions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CA4B3B"}

package/dist/sessions/find.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Lightweight session discovery — returns minimal session records.
+ *
+ * Unlike listSessions() which returns full Session objects, findSessions()
+ * returns only the fields agents need for discovery: id, name, status,
+ * startedAt, and scope.
+ *
+ * @task T5119
+ */
+import type { SessionScope } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+/** Minimal session record returned by findSessions(). */
+export interface MinimalSessionRecord {
+    id: string;
+    name: string;
+    status: string;
+    startedAt: string;
+    scope: SessionScope;
+}
+/** Parameters for findSessions(). */
+export interface FindSessionsParams {
+    status?: string;
+    scope?: string;
+    query?: string;
+    limit?: number;
+}
+/**
+ * Find sessions with minimal field projection.
+ *
+ * Loads all sessions, applies filters, then projects to minimal fields.
+ * This is cheaper for agents that only need discovery-level data.
+ *
+ * @param accessor - DataAccessor for loading sessions
+ * @param params - Optional filters (status, scope, query, limit)
+ * @returns Array of minimal session records
+ */
+export declare function findSessions(accessor: DataAccessor, params?: FindSessionsParams): Promise<MinimalSessionRecord[]>;
+//# sourceMappingURL=find.d.ts.map

package/dist/sessions/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/sessions/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuCjC"}

package/dist/sessions/handoff.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Session handoff computation and persistence.
+ *
+ * Creates structured handoff data when a session ends, containing:
+ * - Last focused task
+ * - Tasks completed and created
+ * - Decisions recorded
+ * - Next suggested tasks
+ * - Open blockers and bugs
+ * - Human override notes
+ *
+ * @task T4915
+ * @epic T4914
+ */
+/**
+ * Handoff data schema - structured state for session transition.
+ */
+export interface HandoffData {
+    /** Last task being worked on */
+    lastTask: string | null;
+    /** Tasks completed in session */
+    tasksCompleted: string[];
+    /** Tasks created in session */
+    tasksCreated: string[];
+    /** Count of decisions recorded */
+    decisionsRecorded: number;
+    /** Top-3 from tasks.next */
+    nextSuggested: string[];
+    /** Tasks with blockers */
+    openBlockers: string[];
+    /** Open bugs */
+    openBugs: string[];
+    /** Human override note */
+    note?: string;
+    /** Human override next action */
+    nextAction?: string;
+}
+/**
+ * Options for computing handoff data.
+ */
+export interface ComputeHandoffOptions {
+    sessionId: string;
+    /** Optional human note override */
+    note?: string;
+    /** Optional human next action override */
+    nextAction?: string;
+}
+/**
+ * Compute handoff data for a session.
+ * Gathers all session statistics and auto-computes structured state.
+ */
+export declare function computeHandoff(projectRoot: string, options: ComputeHandoffOptions): Promise<HandoffData>;
+/**
+ * Persist handoff data to a session.
+ */
+export declare function persistHandoff(projectRoot: string, sessionId: string, handoff: HandoffData): Promise<void>;
+/**
+ * Get handoff data for a session.
+ */
+export declare function getHandoff(projectRoot: string, sessionId: string): Promise<HandoffData | null>;
+/**
+ * Get handoff data for the most recent ended session.
+ * Filters by scope if provided.
+ */
+export declare function getLastHandoff(projectRoot: string, scope?: {
+    type: string;
+    epicId?: string;
+    rootTaskId?: string;
+}): Promise<{
+    sessionId: string;
+    handoff: HandoffData;
+} | null>;
+/**
+ * Git state snapshot captured at session end.
+ */
+export interface GitState {
+    branch: string;
+    commitCount: number;
+    lastCommitHash: string | null;
+    uncommittedChanges: boolean;
+}
+/**
+ * Decision summary for debrief output.
+ */
+export interface DebriefDecision {
+    id: string;
+    decision: string;
+    rationale: string;
+    taskId: string;
+}
+/**
+ * Rich debrief data — superset of HandoffData.
+ * Captures comprehensive session state for cross-conversation continuity.
+ *
+ * @epic T4959
+ */
+export interface DebriefData {
+    /** Standard handoff data (backward compat). */
+    handoff: HandoffData;
+    /** Session that produced this debrief. */
+    sessionId: string;
+    /** Agent/conversation identifier (if known). */
+    agentIdentifier: string | null;
+    /** Session start time. */
+    startedAt: string;
+    /** Session end time. */
+    endedAt: string;
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Decisions made during the session. */
+    decisions: DebriefDecision[];
+    /** Git state at session end (best-effort). */
+    gitState: GitState | null;
+    /** Position in the session chain (1-based). */
+    chainPosition: number;
+    /** Total length of the session chain. */
+    chainLength: number;
+}
+/**
+ * Options for computing debrief data.
+ */
+export interface ComputeDebriefOptions extends ComputeHandoffOptions {
+    /** Agent/conversation identifier. */
+    agentIdentifier?: string | null;
+    /** Session start time. */
+    startedAt?: string;
+    /** Session end time. */
+    endedAt?: string;
+}
+/**
+ * Compute rich debrief data for a session.
+ * Builds on computeHandoff() and adds decisions, git state, chain position.
+ *
+ * @epic T4959
+ */
+export declare function computeDebrief(projectRoot: string, options: ComputeDebriefOptions): Promise<DebriefData>;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/sessions/handoff.d.ts.map

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

package/dist/sessions/hitl-warnings.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Human-in-the-Loop (HITL) warning system.
+ *
+ * Generates warnings for concurrent operations, orphaned locks,
+ * and high-risk operations that may require human review.
+ *
+ * Warning levels:
+ *   INFO  - Informational, no action needed
+ *   WARN  - Review recommended
+ *   BLOCK - Requires human decision before proceeding
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** HITL warning level. */
+export type HITLLevel = 'none' | 'info' | 'warn' | 'block';
+/** HITL warning entry. */
+export interface HITLWarning {
+    level: 'INFO' | 'WARN' | 'BLOCK';
+    type: string;
+    message: string;
+    details: unknown;
+    action: string;
+}
+/** Lock info from .cleo/*.lock files. */
+interface LockInfo {
+    resource: string;
+    pid: number;
+    process: string;
+    status: 'active' | 'stale' | 'orphaned';
+    age_seconds: number;
+}
+/** HITL warnings result. */
+export interface HITLWarningsResult {
+    enabled: boolean;
+    level: HITLLevel;
+    requiresHuman: boolean;
+    warnings: HITLWarning[];
+    activeLocks: LockInfo[];
+    summary: {
+        total: number;
+        byLevel: {
+            block: number;
+            warn: number;
+            info: number;
+        };
+    } | null;
+}
+/** Check if HITL warnings are enabled. */
+export declare function isHITLEnabled(cwd?: string): boolean;
+/** Generate HITL warnings based on lock state. */
+export declare function generateHITLWarnings(cwd?: string): HITLWarningsResult;
+/** Get highest warning level from warnings. */
+export declare function getHighestLevel(warnings: HITLWarning[]): HITLLevel;
+/** Get concurrency data for analyze JSON output. */
+export declare function getConcurrencyJson(cwd?: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=hitl-warnings.d.ts.map

package/dist/sessions/hitl-warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-warnings.d.ts","sourceRoot":"","sources":["../../src/sessions/hitl-warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA+BH,0BAA0B;AAC1B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACxD,GAAG,IAAI,CAAC;CACV;AAID,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAMnD;AAsED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAoHrE;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAKlE;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBxE"}

package/dist/sessions/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Session management operations.
+ * @task T4463
+ * @epic T4454
+ */
+import type { Session, SessionScope } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+import '../hooks/handlers/index.js';
+/** Options for starting a session. */
+export interface StartSessionOptions {
+    name: string;
+    scope: string;
+    autoStart?: boolean;
+    startTask?: string;
+    focus?: string;
+    agent?: string;
+    /** Enable full query+mutation audit logging for this session (behavioral grading). */
+    grade?: boolean;
+    /** Provider adapter ID active for this session (T5240). */
+    providerId?: string;
+}
+/** Options for ending a session. */
+export interface EndSessionOptions {
+    sessionId?: string;
+    note?: string;
+}
+/** Options for listing sessions. */
+export interface ListSessionsOptions {
+    status?: string;
+    limit?: number;
+}
+/**
+ * Parse a scope string into a SessionScope.
+ * @task T4463
+ */
+export declare function parseScope(scopeStr: string): SessionScope;
+/**
+ * Read sessions from accessor or JSON file.
+ * @task T4463
+ */
+export declare function readSessions(cwd?: string, accessor?: DataAccessor): Promise<Session[]>;
+/**
+ * Save sessions via accessor or JSON file.
+ * @task T4463
+ */
+export declare function saveSessions(sessions: Session[], cwd?: string, accessor?: DataAccessor): Promise<void>;
+/**
+ * Start a new session.
+ * @task T4463
+ */
+export declare function startSession(options: StartSessionOptions, cwd?: string, accessor?: DataAccessor): Promise<Session>;
+/**
+ * End a session.
+ * @task T4463
+ */
+export declare function endSession(options?: EndSessionOptions, cwd?: string, accessor?: DataAccessor): Promise<Session>;
+/**
+ * Get current session status.
+ * @task T4463
+ */
+export declare function sessionStatus(cwd?: string, accessor?: DataAccessor): Promise<Session | null>;
+/**
+ * Resume an existing session.
+ * @task T4463
+ */
+export declare function resumeSession(sessionId: string, cwd?: string, accessor?: DataAccessor): Promise<Session>;
+/**
+ * List sessions with optional filtering.
+ * @task T4463
+ */
+export declare function listSessions(options?: ListSessionsOptions, cwd?: string, accessor?: DataAccessor): Promise<Session[]>;
+/**
+ * Garbage collect old sessions.
+ * Marks orphaned sessions that have been active too long.
+ * @task T4463
+ */
+export declare function gcSessions(maxAgeHours?: number, cwd?: string, accessor?: DataAccessor): Promise<{
+    orphaned: string[];
+    removed: string[];
+}>;
+export type { Session as SessionRecord } from '@cleocode/contracts';
+export type { RecordAssumptionParams } from './assumptions.js';
+export { recordAssumption } from './assumptions.js';
+export type { BriefingBlockedTask, BriefingBug, BriefingEpic, BriefingOptions, BriefingTask, CurrentTaskInfo, LastSessionInfo, PipelineStageInfo, SessionBriefing, } from './briefing.js';
+export { computeBriefing } from './briefing.js';
+export type { DecisionLogParams, RecordDecisionParams } from './decisions.js';
+export { getDecisionLog, recordDecision } from './decisions.js';
+export type { FindSessionsParams, MinimalSessionRecord } from './find.js';
+export { findSessions } from './find.js';
+export type { ComputeDebriefOptions, ComputeHandoffOptions, DebriefData, DebriefDecision, GitState, HandoffData, } from './handoff.js';
+export { computeDebrief, computeHandoff, getHandoff, getLastHandoff, persistHandoff, } from './handoff.js';
+export { archiveSessions } from './session-archive.js';
+export { cleanupSessions } from './session-cleanup.js';
+export type { ContextDriftResult } from './session-drift.js';
+export { getContextDrift } from './session-drift.js';
+export type { SessionHistoryEntry, SessionHistoryParams } from './session-history.js';
+export { getSessionHistory } from './session-history.js';
+export type { SessionBridgeData } from './session-memory-bridge.js';
+export { bridgeSessionToMemory } from './session-memory-bridge.js';
+export { showSession } from './session-show.js';
+export type { SessionStatsResult } from './session-stats.js';
+export { getSessionStats } from './session-stats.js';
+export { suspendSession } from './session-suspend.js';
+export { switchSession } from './session-switch.js';
+export { SessionView } from './session-view.js';
+export type { AssumptionRecord, DecisionRecord, TaskFileExt, TaskWorkStateExt } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/sessions/session-archive.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Archive old/ended sessions.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+/**
+ * Archive old/ended sessions.
+ * Identifies ended and suspended sessions older than the threshold.
+ * With SQLite, all sessions live in a single table — "archiving" marks them
+ * as identified for potential cleanup rather than moving between arrays.
+ */
+export declare function archiveSessions(projectRoot: string, olderThan?: string): Promise<{
+    archived: string[];
+    count: number;
+}>;
+//# sourceMappingURL=session-archive.d.ts.map

package/dist/sessions/session-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-archive.d.ts","sourceRoot":"","sources":["../../src/sessions/session-archive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiChD"}