@cleocode/contracts 2026.3.70 → 2026.3.71

package/dist/facade.d.ts

@@ -0,0 +1,571 @@
+/**
+ * Facade API interfaces for the Cleo class.
+ *
+ * These define the public API surface that consumers (e.g. CleoOS) use
+ * to interact with @cleocode/core via the `Cleo` facade. Defined here
+ * in contracts so downstream packages can import types without depending
+ * on core directly.
+ *
+ * @module facade
+ */
+import type { DataAccessor, ExternalTask, ExternalTaskLink, ReconcileOptions, ReconcileResult, Task, TaskPriority, TaskSize, TaskStatus, TaskType } from './index.js';
+/** Observation type categories for brain entries. */
+export declare const BRAIN_OBSERVATION_TYPES: readonly ["discovery", "change", "feature", "bugfix", "decision", "refactor"];
+/** Brain observation type. */
+export type BrainObservationType = (typeof BRAIN_OBSERVATION_TYPES)[number];
+/** Options for hybrid (FTS + vector + graph) brain search. */
+export interface HybridSearchOptions {
+    /** Weight for full-text search results (0-1). */
+    ftsWeight?: number;
+    /** Weight for vector similarity results (0-1). */
+    vecWeight?: number;
+    /** Weight for graph-based results (0-1). */
+    graphWeight?: number;
+    /** Maximum number of results to return. */
+    limit?: number;
+}
+/** Strategy for handling duplicate tasks during import. */
+export type DuplicateStrategy = 'skip' | 'overwrite' | 'rename';
+/** Parameters for task import operations. */
+export interface ImportParams {
+    /** Path to the import file. */
+    file: string;
+    /** Parent task ID for imported tasks. */
+    parent?: string;
+    /** Phase assignment for imported tasks. */
+    phase?: string;
+    /** Strategy when a duplicate task ID is found. */
+    onDuplicate?: DuplicateStrategy;
+    /** Label to add to all imported tasks. */
+    addLabel?: string;
+    /** If true, simulate the import without persisting. */
+    dryRun?: boolean;
+    /** Working directory for resolving paths. */
+    cwd?: string;
+}
+/** Agent instance status values. */
+export declare const AGENT_INSTANCE_STATUSES: readonly ["starting", "active", "idle", "error", "crashed", "stopped"];
+/** Agent instance status type. */
+export type AgentInstanceStatus = (typeof AGENT_INSTANCE_STATUSES)[number];
+/** Agent type classification values. */
+export declare const AGENT_TYPES: readonly ["orchestrator", "executor", "researcher", "architect", "validator", "documentor", "custom"];
+/** Agent type classification. */
+export type AgentType = (typeof AGENT_TYPES)[number];
+/**
+ * Row shape for the `agent_instances` table.
+ *
+ * Manually defined to avoid Drizzle dependency in contracts.
+ * Must stay in sync with `packages/core/src/agents/agent-schema.ts`.
+ */
+export interface AgentInstanceRow {
+    /** Unique agent instance ID. */
+    id: string;
+    /** Agent type classification. */
+    agentType: AgentType;
+    /** Current status. */
+    status: AgentInstanceStatus;
+    /** Associated session ID (nullable). */
+    sessionId: string | null;
+    /** Associated task ID (nullable). */
+    taskId: string | null;
+    /** ISO timestamp when the agent started. */
+    startedAt: string;
+    /** ISO timestamp of the last heartbeat. */
+    lastHeartbeat: string;
+    /** ISO timestamp when the agent stopped (nullable). */
+    stoppedAt: string | null;
+    /** Number of errors encountered. */
+    errorCount: number;
+    /** Total tasks completed by this agent. */
+    totalTasksCompleted: number;
+    /** Agent capacity as a string (e.g. "1.0"). */
+    capacity: string;
+    /** JSON-encoded metadata. */
+    metadataJson: string | null;
+    /** Parent agent ID for hierarchical orchestration (nullable). */
+    parentAgentId: string | null;
+}
+/** Options for registering a new agent instance. */
+export interface RegisterAgentOptions {
+    /** Agent type classification. */
+    agentType: AgentType;
+    /** Session to associate with. */
+    sessionId?: string;
+    /** Task to associate with. */
+    taskId?: string;
+    /** Parent agent ID for hierarchical orchestration. */
+    parentAgentId?: string;
+    /** Arbitrary metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** Agent capacity information. */
+export interface AgentCapacity {
+    /** Agent instance ID. */
+    agentId: string;
+    /** Agent type classification. */
+    agentType: AgentType;
+    /** Current status of the agent. */
+    status: AgentInstanceStatus;
+    /** Number of tasks currently assigned to this agent. */
+    activeTasks: number;
+    /** Number of additional tasks this agent can accept (max - active). */
+    remainingCapacity: number;
+    /** Maximum tasks this agent can hold. */
+    maxCapacity: number;
+    /** Whether this agent can accept new tasks. */
+    available: boolean;
+}
+/** Agent health status from heartbeat monitoring. */
+export interface AgentHealthStatus {
+    /** Agent instance ID. */
+    agentId: string;
+    /** Current DB status. */
+    status: AgentInstanceStatus;
+    /** ISO timestamp of the last recorded heartbeat. */
+    lastHeartbeat: string;
+    /** Milliseconds since the last recorded heartbeat (at call time). */
+    heartbeatAgeMs: number;
+    /** Whether the agent is considered healthy (heartbeat within threshold). */
+    healthy: boolean;
+    /** Whether the agent is considered stale (heartbeat older than threshold). */
+    stale: boolean;
+    /** Threshold used for staleness determination (ms). */
+    thresholdMs: number;
+}
+/** Severity classification for blast radius. */
+export type BlastRadiusSeverity = 'isolated' | 'moderate' | 'widespread' | 'critical';
+/** A single task predicted to be affected by a change. */
+export interface ImpactedTask {
+    /** Task ID. */
+    id: string;
+    /** Task title. */
+    title: string;
+    /** Current task status. */
+    status: string;
+    /** Current task priority. */
+    priority: string;
+    /** Severity of exposure to the change. */
+    exposure: 'direct' | 'dependent' | 'transitive';
+    /** Number of downstream tasks that depend on this task. */
+    downstreamCount: number;
+    /** Why this task is predicted to be affected. */
+    reason: string;
+}
+/** Full impact prediction report for a free-text change description. */
+export interface ImpactReport {
+    /** The original free-text change description. */
+    change: string;
+    /** Tasks directly matched by the change description (fuzzy search). */
+    matchedTasks: ImpactedTask[];
+    /** All tasks predicted to be affected, ordered by exposure severity. */
+    affectedTasks: ImpactedTask[];
+    /** Total count of distinct affected tasks (including direct matches). */
+    totalAffected: number;
+    /** Human-readable summary of predicted impact scope. */
+    summary: string;
+}
+/** Quantified scope of a task's impact across the project. */
+export interface BlastRadius {
+    /** Number of direct dependents. */
+    directCount: number;
+    /** Number of transitive dependents (full downstream tree). */
+    transitiveCount: number;
+    /** Number of distinct epics affected. */
+    epicCount: number;
+    /** Percentage of the total project impacted (0-100). */
+    projectPercentage: number;
+    /** Classification of impact severity. */
+    severity: BlastRadiusSeverity;
+}
+/** Result of starting work on a task. */
+export interface TaskStartResult {
+    /** The task ID that was started. */
+    taskId: string;
+    /** The task title. */
+    title: string;
+    /** Previous task ID if one was active (auto-stopped). */
+    previousTask?: string | null;
+}
+/** Tasks domain API. */
+export interface TasksAPI {
+    /** Add a new task. */
+    add(params: {
+        title: string;
+        description: string;
+        parent?: string;
+        priority?: TaskPriority;
+        type?: TaskType;
+        size?: TaskSize;
+        phase?: string;
+        labels?: string[];
+        depends?: string[];
+        notes?: string;
+    }): Promise<unknown>;
+    /** Find tasks by query, ID, status, or limit. */
+    find(params: {
+        query?: string;
+        id?: string;
+        status?: TaskStatus;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Show full details of a task. */
+    show(taskId: string): Promise<unknown>;
+    /** List tasks with optional filters. */
+    list(params?: {
+        status?: TaskStatus;
+        priority?: TaskPriority;
+        parentId?: string;
+        phase?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Update task fields. */
+    update(params: {
+        taskId: string;
+        title?: string;
+        status?: TaskStatus;
+        priority?: TaskPriority;
+        description?: string;
+        notes?: string;
+    }): Promise<unknown>;
+    /** Complete a task with optional notes. */
+    complete(params: {
+        taskId: string;
+        notes?: string;
+    }): Promise<unknown>;
+    /** Delete a task. */
+    delete(params: {
+        taskId: string;
+        force?: boolean;
+    }): Promise<unknown>;
+    /** Archive tasks by date or IDs. */
+    archive(params?: {
+        before?: string;
+        taskIds?: string[];
+        dryRun?: boolean;
+    }): Promise<unknown>;
+    /** Start working on a specific task (sets focus). */
+    start(taskId: string): Promise<unknown>;
+    /** Stop working on the current task (clears focus). */
+    stop(): Promise<{
+        previousTask: string | null;
+    }>;
+    /** Get the current task work state. */
+    current(): Promise<unknown>;
+}
+/** Sessions domain API. */
+export interface SessionsAPI {
+    /** Start a new session. */
+    start(params: {
+        name: string;
+        scope: string;
+        agent?: string;
+        startTask?: string;
+    }): Promise<unknown>;
+    /** End the current session. */
+    end(params?: {
+        note?: string;
+    }): Promise<unknown>;
+    /** Get current session status. */
+    status(): Promise<unknown>;
+    /** Resume an existing session. */
+    resume(sessionId: string): Promise<unknown>;
+    /** List sessions with optional filters. */
+    list(params?: {
+        status?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Find sessions by criteria. */
+    find(params?: {
+        status?: string;
+        scope?: string;
+        query?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Show full details of a session. */
+    show(sessionId: string): Promise<unknown>;
+    /** Suspend a session. */
+    suspend(sessionId: string, reason?: string): Promise<unknown>;
+    /** Compute session briefing. */
+    briefing(params?: {
+        maxNextTasks?: number;
+        scope?: string;
+    }): Promise<unknown>;
+    /** Compute session handoff. */
+    handoff(sessionId: string, options?: {
+        note?: string;
+        nextAction?: string;
+    }): Promise<unknown>;
+    /** Garbage-collect stale sessions. */
+    gc(maxAgeHours?: number): Promise<unknown>;
+    /** Record a decision in a session. */
+    recordDecision(params: {
+        sessionId: string;
+        taskId: string;
+        decision: string;
+        rationale: string;
+        alternatives?: string[];
+    }): Promise<unknown>;
+    /** Record an assumption. */
+    recordAssumption(params: {
+        assumption: string;
+        confidence: 'high' | 'medium' | 'low';
+        sessionId?: string;
+        taskId?: string;
+    }): Promise<unknown>;
+    /** Get context drift metrics. */
+    contextDrift(params?: {
+        sessionId?: string;
+    }): Promise<unknown>;
+    /** Get decision log. */
+    decisionLog(params?: {
+        sessionId?: string;
+        taskId?: string;
+    }): Promise<unknown>;
+    /** Get last handoff for a scope. */
+    lastHandoff(scope?: {
+        type: string;
+        epicId?: string;
+    }): Promise<unknown>;
+}
+/** Memory/Brain domain API. */
+export interface MemoryAPI {
+    /** Record a brain observation. */
+    observe(params: {
+        text: string;
+        title?: string;
+        type?: BrainObservationType;
+    }): Promise<unknown>;
+    /** Find brain entries by query. */
+    find(params: {
+        query: string;
+        limit?: number;
+        tables?: Array<'decisions' | 'patterns' | 'learnings' | 'observations'>;
+    }): Promise<unknown>;
+    /** Fetch brain entries by IDs. */
+    fetch(params: {
+        ids: string[];
+    }): Promise<unknown>;
+    /** Get temporal context around an anchor entry. */
+    timeline(params: {
+        anchor: string;
+        depthBefore?: number;
+        depthAfter?: number;
+    }): Promise<unknown>;
+    /** Search brain entries. */
+    search(query: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    /** Hybrid search combining FTS, vector, and graph. */
+    hybridSearch(query: string, options?: HybridSearchOptions): Promise<unknown>;
+}
+/** Orchestration domain API. */
+export interface OrchestrationAPI {
+    /** Start orchestration for an epic. */
+    start(epicId: string): Promise<unknown>;
+    /** Analyze an epic's structure and dependencies. */
+    analyze(epicId: string): Promise<unknown>;
+    /** Get tasks ready to execute in an epic. */
+    readyTasks(epicId: string): Promise<unknown>;
+    /** Get the next recommended task in an epic. */
+    nextTask(epicId: string): Promise<unknown>;
+    /** Get orchestrator context for an epic. */
+    context(epicId: string): Promise<unknown>;
+    /** Build a dependency graph from tasks. */
+    dependencyGraph(tasks: Task[]): unknown;
+    /** Compute epic status summary. */
+    epicStatus(epicId: string, title: string, children: Task[]): unknown;
+    /** Compute progress metrics for tasks. */
+    progress(tasks: Task[]): unknown;
+}
+/** Lifecycle pipeline domain API. */
+export interface LifecycleAPI {
+    /** Get lifecycle status for an epic. */
+    status(epicId: string): Promise<unknown>;
+    /** Start a pipeline stage. */
+    startStage(epicId: string, stage: string): Promise<unknown>;
+    /** Complete a pipeline stage. */
+    completeStage(epicId: string, stage: string, artifacts?: string[]): Promise<unknown>;
+    /** Skip a pipeline stage. */
+    skipStage(epicId: string, stage: string, reason: string): Promise<unknown>;
+    /** Check gate requirements for a stage. */
+    checkGate(epicId: string, targetStage: string): Promise<unknown>;
+    /** Get lifecycle history for an epic. */
+    history(epicId: string): Promise<unknown>;
+    /** Reset a pipeline stage. */
+    resetStage(epicId: string, stage: string, reason: string): Promise<unknown>;
+    /** Pass a gate check. */
+    passGate(epicId: string, gateName: string, agent?: string): Promise<unknown>;
+    /** Fail a gate check. */
+    failGate(epicId: string, gateName: string, reason?: string): Promise<unknown>;
+    /** Available pipeline stages. */
+    stages: readonly string[];
+}
+/** Release management domain API. */
+export interface ReleaseAPI {
+    /** Prepare a release. */
+    prepare(params: {
+        version: string;
+        tasks?: string[];
+        notes?: string;
+    }): Promise<unknown>;
+    /** Commit a release. */
+    commit(params: {
+        version: string;
+    }): Promise<unknown>;
+    /** Tag a release. */
+    tag(params: {
+        version: string;
+    }): Promise<unknown>;
+    /** Push a release. */
+    push(params: {
+        version: string;
+        remote?: string;
+        explicitPush?: boolean;
+    }): Promise<unknown>;
+    /** Rollback a release. */
+    rollback(params: {
+        version: string;
+        reason?: string;
+    }): Promise<unknown>;
+    /** Calculate new version from bump type. */
+    calculateVersion(current: string, bumpType: string): string;
+    /** Bump version from config. */
+    bumpVersion(): Promise<unknown>;
+}
+/** Admin domain API. */
+export interface AdminAPI {
+    /** Export tasks. */
+    export(params?: Record<string, unknown>): Promise<unknown>;
+    /** Import tasks from file. */
+    import(params: Omit<ImportParams, 'cwd'>): Promise<unknown>;
+}
+/** Sticky notes domain API. */
+export interface StickyAPI {
+    /** Add a sticky note. */
+    add(params: {
+        content: string;
+        tags?: string[];
+        priority?: string;
+        color?: string;
+    }): Promise<unknown>;
+    /** Show a sticky note. */
+    show(stickyId: string): Promise<unknown>;
+    /** List sticky notes with optional filters. */
+    list(params?: {
+        status?: string;
+        color?: string;
+        priority?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Archive a sticky note. */
+    archive(stickyId: string): Promise<unknown>;
+    /** Purge a sticky note. */
+    purge(stickyId: string): Promise<unknown>;
+    /** Convert a sticky note to task or memory. */
+    convert(params: {
+        stickyId: string;
+        targetType: 'task' | 'memory' | 'task_note' | 'session_note';
+        title?: string;
+        memoryType?: string;
+        taskId?: string;
+    }): Promise<unknown>;
+}
+/** Cross-project Nexus domain API. */
+export interface NexusAPI {
+    /** Initialize nexus for the current project. */
+    init(): Promise<unknown>;
+    /** Register a project in the nexus. */
+    register(params: {
+        path: string;
+        name?: string;
+        permissions?: string;
+    }): Promise<unknown>;
+    /** Unregister a project from the nexus. */
+    unregister(params: {
+        name: string;
+    }): Promise<unknown>;
+    /** List registered projects. */
+    list(): Promise<unknown>;
+    /** Show details of a registered project. */
+    show(params: {
+        name: string;
+    }): Promise<unknown>;
+    /** Sync a project or all projects. */
+    sync(params?: {
+        name?: string;
+    }): Promise<unknown>;
+    /** Discover related content across projects. */
+    discover(params: {
+        query: string;
+        method?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Search across registered projects. */
+    search(params: {
+        pattern: string;
+        project?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    /** Set permission level for a project. */
+    setPermission(params: {
+        name: string;
+        level: 'read' | 'write' | 'execute';
+    }): Promise<unknown>;
+    /** Get sharing status. */
+    sharingStatus(): Promise<unknown>;
+}
+/** Task reconciliation / sync domain API. */
+export interface SyncAPI {
+    /** Reconcile external tasks with CLEO as SSoT. */
+    reconcile(params: {
+        externalTasks: ExternalTask[];
+        providerId: string;
+        dryRun?: boolean;
+        conflictPolicy?: ReconcileOptions['conflictPolicy'];
+        defaultPhase?: string;
+        defaultLabels?: string[];
+    }): Promise<ReconcileResult>;
+    /** Get all external task links for a provider. */
+    getLinks(providerId: string): Promise<ExternalTaskLink[]>;
+    /** Get all external task links for a CLEO task. */
+    getTaskLinks(taskId: string): Promise<ExternalTaskLink[]>;
+    /** Remove all external task links for a provider. */
+    removeProviderLinks(providerId: string): Promise<number>;
+}
+/** Agent registry domain API. */
+export interface AgentsAPI {
+    /** Register a new agent instance. */
+    register(options: RegisterAgentOptions): Promise<AgentInstanceRow>;
+    /** Deregister an agent instance. */
+    deregister(agentId: string): Promise<AgentInstanceRow | null>;
+    /** Get health status for a specific agent. */
+    health(agentId: string): Promise<AgentHealthStatus | null>;
+    /** Detect agents that have crashed (missed heartbeats). */
+    detectCrashed(thresholdMs?: number): Promise<AgentInstanceRow[]>;
+    /** Record a heartbeat for an agent. */
+    recordHeartbeat(agentId: string): Promise<unknown>;
+    /** Get capacity info for an agent. */
+    capacity(agentId: string): Promise<AgentCapacity | null>;
+    /** Check if system is overloaded (available capacity below threshold). */
+    isOverloaded(threshold?: number): Promise<boolean>;
+    /** List all agent instances with optional filters. */
+    list(params?: {
+        status?: string;
+        agentType?: string;
+    }): Promise<AgentInstanceRow[]>;
+}
+/** Intelligence / impact analysis domain API. */
+export interface IntelligenceAPI {
+    /** Predict impact of a change description on related tasks. */
+    predictImpact(change: string): Promise<ImpactReport>;
+    /** Calculate blast radius for a task change. */
+    blastRadius(taskId: string): Promise<BlastRadius>;
+}
+/** Options for initializing the Cleo facade. */
+export interface CleoInitOptions {
+    /** Custom data accessor (store backend). */
+    store?: DataAccessor;
+    /** Enable CAAMP injection. */
+    caamp?: boolean;
+}
+//# sourceMappingURL=facade.d.ts.map

package/dist/facade.d.ts.map

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

package/dist/facade.js

@@ -0,0 +1,44 @@
+/**
+ * Facade API interfaces for the Cleo class.
+ *
+ * These define the public API surface that consumers (e.g. CleoOS) use
+ * to interact with @cleocode/core via the `Cleo` facade. Defined here
+ * in contracts so downstream packages can import types without depending
+ * on core directly.
+ *
+ * @module facade
+ */
+// ============================================================================
+// Supporting types (previously scattered across core modules)
+// ============================================================================
+// --- Brain / Memory ---
+/** Observation type categories for brain entries. */
+export const BRAIN_OBSERVATION_TYPES = [
+    'discovery',
+    'change',
+    'feature',
+    'bugfix',
+    'decision',
+    'refactor',
+];
+// --- Agents ---
+/** Agent instance status values. */
+export const AGENT_INSTANCE_STATUSES = [
+    'starting',
+    'active',
+    'idle',
+    'error',
+    'crashed',
+    'stopped',
+];
+/** Agent type classification values. */
+export const AGENT_TYPES = [
+    'orchestrator',
+    'executor',
+    'researcher',
+    'architect',
+    'validator',
+    'documentor',
+    'custom',
+];
+//# sourceMappingURL=facade.js.map

package/dist/facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.js","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,+EAA+E;AAC/E,8DAA8D;AAC9D,+EAA+E;AAE/E,yBAAyB;AAEzB,qDAAqD;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW;IACX,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;CACF,CAAC;AAwCX,iBAAiB;AAEjB,oCAAoC;AACpC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU;IACV,QAAQ;IACR,MAAM;IACN,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC;AAKX,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,UAAU;IACV,YAAY;IACZ,WAAW;IACX,WAAW;IACX,YAAY;IACZ,QAAQ;CACA,CAAC"}

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export type { ArchiveFields, ArchiveFile, DataAccessor, QueryTasksResult, TaskFi
 export type { AdapterManifest, DetectionPattern } from './discovery.js';
 export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
 export { ExitCode, getExitCodeName, isErrorCode, isNoChangeCode, isRecoverableCode, isSuccessCode, } from './exit-codes.js';
+export type { AdminAPI, AgentCapacity, AgentHealthStatus, AgentInstanceRow, AgentInstanceStatus, AgentsAPI, AgentType, BlastRadius, BlastRadiusSeverity, BrainObservationType, CleoInitOptions, DuplicateStrategy, HybridSearchOptions, ImpactedTask, ImpactReport, ImportParams, IntelligenceAPI, LifecycleAPI, MemoryAPI, NexusAPI, OrchestrationAPI, RegisterAgentOptions, ReleaseAPI, SessionsAPI, StickyAPI, SyncAPI, TaskStartResult, TasksAPI, } from './facade.js';
+export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, BRAIN_OBSERVATION_TYPES, } from './facade.js';
 export type { AdapterHookProvider } from './hooks.js';
 export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
 export type { CleoResponse, ConformanceReport, FlagInput, GatewayEnvelope, GatewayError, GatewayMeta, GatewaySuccess, LAFSEnvelope, LAFSError, LAFSErrorCategory, LAFSMeta, LAFSPage, LAFSPageNone, LAFSPageOffset, LAFSTransport, LafsAlternative, LafsEnvelope, LafsError, LafsErrorDetail, LafsSuccess, MVILevel, Warning, } from './lafs.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -9,6 +9,8 @@
 export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
 // === Exit Codes ===
 export { 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';
 // === LAFS Envelope Types ===
 export { isGatewayEnvelope, isLafsError, isLafsSuccess, } from './lafs.js';
 // === Operations Types (API wire format, namespaced to avoid collision with domain types) ===

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmEH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA2BzB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAkC7C,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmEH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AA2BrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAkC7C,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.3.70",
+  "version": "2026.3.71",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/facade.ts

@@ -0,0 +1,573 @@
+/**
+ * Facade API interfaces for the Cleo class.
+ *
+ * These define the public API surface that consumers (e.g. CleoOS) use
+ * to interact with @cleocode/core via the `Cleo` facade. Defined here
+ * in contracts so downstream packages can import types without depending
+ * on core directly.
+ *
+ * @module facade
+ */
+
+import type {
+  DataAccessor,
+  ExternalTask,
+  ExternalTaskLink,
+  ReconcileOptions,
+  ReconcileResult,
+  Task,
+  TaskPriority,
+  TaskSize,
+  TaskStatus,
+  TaskType,
+} from './index.js';
+
+// ============================================================================
+// Supporting types (previously scattered across core modules)
+// ============================================================================
+
+// --- Brain / Memory ---
+
+/** Observation type categories for brain entries. */
+export const BRAIN_OBSERVATION_TYPES = [
+  'discovery',
+  'change',
+  'feature',
+  'bugfix',
+  'decision',
+  'refactor',
+] as const;
+
+/** Brain observation type. */
+export type BrainObservationType = (typeof BRAIN_OBSERVATION_TYPES)[number];
+
+/** Options for hybrid (FTS + vector + graph) brain search. */
+export interface HybridSearchOptions {
+  /** Weight for full-text search results (0-1). */
+  ftsWeight?: number;
+  /** Weight for vector similarity results (0-1). */
+  vecWeight?: number;
+  /** Weight for graph-based results (0-1). */
+  graphWeight?: number;
+  /** Maximum number of results to return. */
+  limit?: number;
+}
+
+// --- Admin / Import ---
+
+/** Strategy for handling duplicate tasks during import. */
+export type DuplicateStrategy = 'skip' | 'overwrite' | 'rename';
+
+/** Parameters for task import operations. */
+export interface ImportParams {
+  /** Path to the import file. */
+  file: string;
+  /** Parent task ID for imported tasks. */
+  parent?: string;
+  /** Phase assignment for imported tasks. */
+  phase?: string;
+  /** Strategy when a duplicate task ID is found. */
+  onDuplicate?: DuplicateStrategy;
+  /** Label to add to all imported tasks. */
+  addLabel?: string;
+  /** If true, simulate the import without persisting. */
+  dryRun?: boolean;
+  /** Working directory for resolving paths. */
+  cwd?: string;
+}
+
+// --- Agents ---
+
+/** Agent instance status values. */
+export const AGENT_INSTANCE_STATUSES = [
+  'starting',
+  'active',
+  'idle',
+  'error',
+  'crashed',
+  'stopped',
+] as const;
+
+/** Agent instance status type. */
+export type AgentInstanceStatus = (typeof AGENT_INSTANCE_STATUSES)[number];
+
+/** Agent type classification values. */
+export const AGENT_TYPES = [
+  'orchestrator',
+  'executor',
+  'researcher',
+  'architect',
+  'validator',
+  'documentor',
+  'custom',
+] as const;
+
+/** Agent type classification. */
+export type AgentType = (typeof AGENT_TYPES)[number];
+
+/**
+ * Row shape for the `agent_instances` table.
+ *
+ * Manually defined to avoid Drizzle dependency in contracts.
+ * Must stay in sync with `packages/core/src/agents/agent-schema.ts`.
+ */
+export interface AgentInstanceRow {
+  /** Unique agent instance ID. */
+  id: string;
+  /** Agent type classification. */
+  agentType: AgentType;
+  /** Current status. */
+  status: AgentInstanceStatus;
+  /** Associated session ID (nullable). */
+  sessionId: string | null;
+  /** Associated task ID (nullable). */
+  taskId: string | null;
+  /** ISO timestamp when the agent started. */
+  startedAt: string;
+  /** ISO timestamp of the last heartbeat. */
+  lastHeartbeat: string;
+  /** ISO timestamp when the agent stopped (nullable). */
+  stoppedAt: string | null;
+  /** Number of errors encountered. */
+  errorCount: number;
+  /** Total tasks completed by this agent. */
+  totalTasksCompleted: number;
+  /** Agent capacity as a string (e.g. "1.0"). */
+  capacity: string;
+  /** JSON-encoded metadata. */
+  metadataJson: string | null;
+  /** Parent agent ID for hierarchical orchestration (nullable). */
+  parentAgentId: string | null;
+}
+
+/** Options for registering a new agent instance. */
+export interface RegisterAgentOptions {
+  /** Agent type classification. */
+  agentType: AgentType;
+  /** Session to associate with. */
+  sessionId?: string;
+  /** Task to associate with. */
+  taskId?: string;
+  /** Parent agent ID for hierarchical orchestration. */
+  parentAgentId?: string;
+  /** Arbitrary metadata. */
+  metadata?: Record<string, unknown>;
+}
+
+/** Agent capacity information. */
+export interface AgentCapacity {
+  /** Agent instance ID. */
+  agentId: string;
+  /** Agent type classification. */
+  agentType: AgentType;
+  /** Current status of the agent. */
+  status: AgentInstanceStatus;
+  /** Number of tasks currently assigned to this agent. */
+  activeTasks: number;
+  /** Number of additional tasks this agent can accept (max - active). */
+  remainingCapacity: number;
+  /** Maximum tasks this agent can hold. */
+  maxCapacity: number;
+  /** Whether this agent can accept new tasks. */
+  available: boolean;
+}
+
+/** Agent health status from heartbeat monitoring. */
+export interface AgentHealthStatus {
+  /** Agent instance ID. */
+  agentId: string;
+  /** Current DB status. */
+  status: AgentInstanceStatus;
+  /** ISO timestamp of the last recorded heartbeat. */
+  lastHeartbeat: string;
+  /** Milliseconds since the last recorded heartbeat (at call time). */
+  heartbeatAgeMs: number;
+  /** Whether the agent is considered healthy (heartbeat within threshold). */
+  healthy: boolean;
+  /** Whether the agent is considered stale (heartbeat older than threshold). */
+  stale: boolean;
+  /** Threshold used for staleness determination (ms). */
+  thresholdMs: number;
+}
+
+// --- Intelligence ---
+
+/** Severity classification for blast radius. */
+export type BlastRadiusSeverity = 'isolated' | 'moderate' | 'widespread' | 'critical';
+
+/** A single task predicted to be affected by a change. */
+export interface ImpactedTask {
+  /** Task ID. */
+  id: string;
+  /** Task title. */
+  title: string;
+  /** Current task status. */
+  status: string;
+  /** Current task priority. */
+  priority: string;
+  /** Severity of exposure to the change. */
+  exposure: 'direct' | 'dependent' | 'transitive';
+  /** Number of downstream tasks that depend on this task. */
+  downstreamCount: number;
+  /** Why this task is predicted to be affected. */
+  reason: string;
+}
+
+/** Full impact prediction report for a free-text change description. */
+export interface ImpactReport {
+  /** The original free-text change description. */
+  change: string;
+  /** Tasks directly matched by the change description (fuzzy search). */
+  matchedTasks: ImpactedTask[];
+  /** All tasks predicted to be affected, ordered by exposure severity. */
+  affectedTasks: ImpactedTask[];
+  /** Total count of distinct affected tasks (including direct matches). */
+  totalAffected: number;
+  /** Human-readable summary of predicted impact scope. */
+  summary: string;
+}
+
+/** Quantified scope of a task's impact across the project. */
+export interface BlastRadius {
+  /** Number of direct dependents. */
+  directCount: number;
+  /** Number of transitive dependents (full downstream tree). */
+  transitiveCount: number;
+  /** Number of distinct epics affected. */
+  epicCount: number;
+  /** Percentage of the total project impacted (0-100). */
+  projectPercentage: number;
+  /** Classification of impact severity. */
+  severity: BlastRadiusSeverity;
+}
+
+// ============================================================================
+// Task work types
+// ============================================================================
+
+/** Result of starting work on a task. */
+export interface TaskStartResult {
+  /** The task ID that was started. */
+  taskId: string;
+  /** The task title. */
+  title: string;
+  /** Previous task ID if one was active (auto-stopped). */
+  previousTask?: string | null;
+}
+
+// ============================================================================
+// Facade API interfaces
+// ============================================================================
+
+/** Tasks domain API. */
+export interface TasksAPI {
+  /** Add a new task. */
+  add(params: {
+    title: string;
+    description: string;
+    parent?: string;
+    priority?: TaskPriority;
+    type?: TaskType;
+    size?: TaskSize;
+    phase?: string;
+    labels?: string[];
+    depends?: string[];
+    notes?: string;
+  }): Promise<unknown>;
+  /** Find tasks by query, ID, status, or limit. */
+  find(params: {
+    query?: string;
+    id?: string;
+    status?: TaskStatus;
+    limit?: number;
+  }): Promise<unknown>;
+  /** Show full details of a task. */
+  show(taskId: string): Promise<unknown>;
+  /** List tasks with optional filters. */
+  list(params?: {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    parentId?: string;
+    phase?: string;
+    limit?: number;
+  }): Promise<unknown>;
+  /** Update task fields. */
+  update(params: {
+    taskId: string;
+    title?: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    description?: string;
+    notes?: string;
+  }): Promise<unknown>;
+  /** Complete a task with optional notes. */
+  complete(params: { taskId: string; notes?: string }): Promise<unknown>;
+  /** Delete a task. */
+  delete(params: { taskId: string; force?: boolean }): Promise<unknown>;
+  /** Archive tasks by date or IDs. */
+  archive(params?: { before?: string; taskIds?: string[]; dryRun?: boolean }): Promise<unknown>;
+  /** Start working on a specific task (sets focus). */
+  start(taskId: string): Promise<unknown>;
+  /** Stop working on the current task (clears focus). */
+  stop(): Promise<{ previousTask: string | null }>;
+  /** Get the current task work state. */
+  current(): Promise<unknown>;
+}
+
+/** Sessions domain API. */
+export interface SessionsAPI {
+  /** Start a new session. */
+  start(params: {
+    name: string;
+    scope: string;
+    agent?: string;
+    startTask?: string;
+  }): Promise<unknown>;
+  /** End the current session. */
+  end(params?: { note?: string }): Promise<unknown>;
+  /** Get current session status. */
+  status(): Promise<unknown>;
+  /** Resume an existing session. */
+  resume(sessionId: string): Promise<unknown>;
+  /** List sessions with optional filters. */
+  list(params?: { status?: string; limit?: number }): Promise<unknown>;
+  /** Find sessions by criteria. */
+  find(params?: {
+    status?: string;
+    scope?: string;
+    query?: string;
+    limit?: number;
+  }): Promise<unknown>;
+  /** Show full details of a session. */
+  show(sessionId: string): Promise<unknown>;
+  /** Suspend a session. */
+  suspend(sessionId: string, reason?: string): Promise<unknown>;
+  /** Compute session briefing. */
+  briefing(params?: { maxNextTasks?: number; scope?: string }): Promise<unknown>;
+  /** Compute session handoff. */
+  handoff(sessionId: string, options?: { note?: string; nextAction?: string }): Promise<unknown>;
+  /** Garbage-collect stale sessions. */
+  gc(maxAgeHours?: number): Promise<unknown>;
+  /** Record a decision in a session. */
+  recordDecision(params: {
+    sessionId: string;
+    taskId: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+  }): Promise<unknown>;
+  /** Record an assumption. */
+  recordAssumption(params: {
+    assumption: string;
+    confidence: 'high' | 'medium' | 'low';
+    sessionId?: string;
+    taskId?: string;
+  }): Promise<unknown>;
+  /** Get context drift metrics. */
+  contextDrift(params?: { sessionId?: string }): Promise<unknown>;
+  /** Get decision log. */
+  decisionLog(params?: { sessionId?: string; taskId?: string }): Promise<unknown>;
+  /** Get last handoff for a scope. */
+  lastHandoff(scope?: { type: string; epicId?: string }): Promise<unknown>;
+}
+
+/** Memory/Brain domain API. */
+export interface MemoryAPI {
+  /** Record a brain observation. */
+  observe(params: { text: string; title?: string; type?: BrainObservationType }): Promise<unknown>;
+  /** Find brain entries by query. */
+  find(params: {
+    query: string;
+    limit?: number;
+    tables?: Array<'decisions' | 'patterns' | 'learnings' | 'observations'>;
+  }): Promise<unknown>;
+  /** Fetch brain entries by IDs. */
+  fetch(params: { ids: string[] }): Promise<unknown>;
+  /** Get temporal context around an anchor entry. */
+  timeline(params: { anchor: string; depthBefore?: number; depthAfter?: number }): Promise<unknown>;
+  /** Search brain entries. */
+  search(query: string, options?: { limit?: number }): Promise<unknown>;
+  /** Hybrid search combining FTS, vector, and graph. */
+  hybridSearch(query: string, options?: HybridSearchOptions): Promise<unknown>;
+}
+
+/** Orchestration domain API. */
+export interface OrchestrationAPI {
+  /** Start orchestration for an epic. */
+  start(epicId: string): Promise<unknown>;
+  /** Analyze an epic's structure and dependencies. */
+  analyze(epicId: string): Promise<unknown>;
+  /** Get tasks ready to execute in an epic. */
+  readyTasks(epicId: string): Promise<unknown>;
+  /** Get the next recommended task in an epic. */
+  nextTask(epicId: string): Promise<unknown>;
+  /** Get orchestrator context for an epic. */
+  context(epicId: string): Promise<unknown>;
+  /** Build a dependency graph from tasks. */
+  dependencyGraph(tasks: Task[]): unknown;
+  /** Compute epic status summary. */
+  epicStatus(epicId: string, title: string, children: Task[]): unknown;
+  /** Compute progress metrics for tasks. */
+  progress(tasks: Task[]): unknown;
+}
+
+/** Lifecycle pipeline domain API. */
+export interface LifecycleAPI {
+  /** Get lifecycle status for an epic. */
+  status(epicId: string): Promise<unknown>;
+  /** Start a pipeline stage. */
+  startStage(epicId: string, stage: string): Promise<unknown>;
+  /** Complete a pipeline stage. */
+  completeStage(epicId: string, stage: string, artifacts?: string[]): Promise<unknown>;
+  /** Skip a pipeline stage. */
+  skipStage(epicId: string, stage: string, reason: string): Promise<unknown>;
+  /** Check gate requirements for a stage. */
+  checkGate(epicId: string, targetStage: string): Promise<unknown>;
+  /** Get lifecycle history for an epic. */
+  history(epicId: string): Promise<unknown>;
+  /** Reset a pipeline stage. */
+  resetStage(epicId: string, stage: string, reason: string): Promise<unknown>;
+  /** Pass a gate check. */
+  passGate(epicId: string, gateName: string, agent?: string): Promise<unknown>;
+  /** Fail a gate check. */
+  failGate(epicId: string, gateName: string, reason?: string): Promise<unknown>;
+  /** Available pipeline stages. */
+  stages: readonly string[];
+}
+
+/** Release management domain API. */
+export interface ReleaseAPI {
+  /** Prepare a release. */
+  prepare(params: { version: string; tasks?: string[]; notes?: string }): Promise<unknown>;
+  /** Commit a release. */
+  commit(params: { version: string }): Promise<unknown>;
+  /** Tag a release. */
+  tag(params: { version: string }): Promise<unknown>;
+  /** Push a release. */
+  push(params: { version: string; remote?: string; explicitPush?: boolean }): Promise<unknown>;
+  /** Rollback a release. */
+  rollback(params: { version: string; reason?: string }): Promise<unknown>;
+  /** Calculate new version from bump type. */
+  calculateVersion(current: string, bumpType: string): string;
+  /** Bump version from config. */
+  bumpVersion(): Promise<unknown>;
+}
+
+/** Admin domain API. */
+export interface AdminAPI {
+  /** Export tasks. */
+  export(params?: Record<string, unknown>): Promise<unknown>;
+  /** Import tasks from file. */
+  import(params: Omit<ImportParams, 'cwd'>): Promise<unknown>;
+}
+
+/** Sticky notes domain API. */
+export interface StickyAPI {
+  /** Add a sticky note. */
+  add(params: {
+    content: string;
+    tags?: string[];
+    priority?: string;
+    color?: string;
+  }): Promise<unknown>;
+  /** Show a sticky note. */
+  show(stickyId: string): Promise<unknown>;
+  /** List sticky notes with optional filters. */
+  list(params?: {
+    status?: string;
+    color?: string;
+    priority?: string;
+    limit?: number;
+  }): Promise<unknown>;
+  /** Archive a sticky note. */
+  archive(stickyId: string): Promise<unknown>;
+  /** Purge a sticky note. */
+  purge(stickyId: string): Promise<unknown>;
+  /** Convert a sticky note to task or memory. */
+  convert(params: {
+    stickyId: string;
+    targetType: 'task' | 'memory' | 'task_note' | 'session_note';
+    title?: string;
+    memoryType?: string;
+    taskId?: string;
+  }): Promise<unknown>;
+}
+
+/** Cross-project Nexus domain API. */
+export interface NexusAPI {
+  /** Initialize nexus for the current project. */
+  init(): Promise<unknown>;
+  /** Register a project in the nexus. */
+  register(params: { path: string; name?: string; permissions?: string }): Promise<unknown>;
+  /** Unregister a project from the nexus. */
+  unregister(params: { name: string }): Promise<unknown>;
+  /** List registered projects. */
+  list(): Promise<unknown>;
+  /** Show details of a registered project. */
+  show(params: { name: string }): Promise<unknown>;
+  /** Sync a project or all projects. */
+  sync(params?: { name?: string }): Promise<unknown>;
+  /** Discover related content across projects. */
+  discover(params: { query: string; method?: string; limit?: number }): Promise<unknown>;
+  /** Search across registered projects. */
+  search(params: { pattern: string; project?: string; limit?: number }): Promise<unknown>;
+  /** Set permission level for a project. */
+  setPermission(params: { name: string; level: 'read' | 'write' | 'execute' }): Promise<unknown>;
+  /** Get sharing status. */
+  sharingStatus(): Promise<unknown>;
+}
+
+/** Task reconciliation / sync domain API. */
+export interface SyncAPI {
+  /** Reconcile external tasks with CLEO as SSoT. */
+  reconcile(params: {
+    externalTasks: ExternalTask[];
+    providerId: string;
+    dryRun?: boolean;
+    conflictPolicy?: ReconcileOptions['conflictPolicy'];
+    defaultPhase?: string;
+    defaultLabels?: string[];
+  }): Promise<ReconcileResult>;
+  /** Get all external task links for a provider. */
+  getLinks(providerId: string): Promise<ExternalTaskLink[]>;
+  /** Get all external task links for a CLEO task. */
+  getTaskLinks(taskId: string): Promise<ExternalTaskLink[]>;
+  /** Remove all external task links for a provider. */
+  removeProviderLinks(providerId: string): Promise<number>;
+}
+
+/** Agent registry domain API. */
+export interface AgentsAPI {
+  /** Register a new agent instance. */
+  register(options: RegisterAgentOptions): Promise<AgentInstanceRow>;
+  /** Deregister an agent instance. */
+  deregister(agentId: string): Promise<AgentInstanceRow | null>;
+  /** Get health status for a specific agent. */
+  health(agentId: string): Promise<AgentHealthStatus | null>;
+  /** Detect agents that have crashed (missed heartbeats). */
+  detectCrashed(thresholdMs?: number): Promise<AgentInstanceRow[]>;
+  /** Record a heartbeat for an agent. */
+  recordHeartbeat(agentId: string): Promise<unknown>;
+  /** Get capacity info for an agent. */
+  capacity(agentId: string): Promise<AgentCapacity | null>;
+  /** Check if system is overloaded (available capacity below threshold). */
+  isOverloaded(threshold?: number): Promise<boolean>;
+  /** List all agent instances with optional filters. */
+  list(params?: { status?: string; agentType?: string }): Promise<AgentInstanceRow[]>;
+}
+
+/** Intelligence / impact analysis domain API. */
+export interface IntelligenceAPI {
+  /** Predict impact of a change description on related tasks. */
+  predictImpact(change: string): Promise<ImpactReport>;
+  /** Calculate blast radius for a task change. */
+  blastRadius(taskId: string): Promise<BlastRadius>;
+}
+
+/** Options for initializing the Cleo facade. */
+export interface CleoInitOptions {
+  /** Custom data accessor (store backend). */
+  store?: DataAccessor;
+  /** Enable CAAMP injection. */
+  caamp?: boolean;
+}

package/src/index.ts

@@ -90,6 +90,42 @@ export {
   isRecoverableCode,
   isSuccessCode,
 } from './exit-codes.js';
+export type {
+  AdminAPI,
+  AgentCapacity,
+  AgentHealthStatus,
+  AgentInstanceRow,
+  AgentInstanceStatus,
+  AgentsAPI,
+  AgentType,
+  BlastRadius,
+  BlastRadiusSeverity,
+  BrainObservationType,
+  CleoInitOptions,
+  DuplicateStrategy,
+  HybridSearchOptions,
+  ImpactedTask,
+  ImpactReport,
+  ImportParams,
+  IntelligenceAPI,
+  LifecycleAPI,
+  MemoryAPI,
+  NexusAPI,
+  OrchestrationAPI,
+  RegisterAgentOptions,
+  ReleaseAPI,
+  SessionsAPI,
+  StickyAPI,
+  SyncAPI,
+  TaskStartResult,
+  TasksAPI,
+} from './facade.js';
+// === Facade API Interfaces ===
+export {
+  AGENT_INSTANCE_STATUSES,
+  AGENT_TYPES,
+  BRAIN_OBSERVATION_TYPES,
+} from './facade.js';
 export type { AdapterHookProvider } from './hooks.js';
 export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
 export type {