@cleocode/contracts 2.0.0

package/dist/adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Core CLEOProviderAdapter interface.
+ * Every provider adapter must implement this contract.
+ *
+ * @task T5240
+ */
+import type { AdapterCapabilities } from './capabilities.js';
+import type { AdapterContextMonitorProvider } from './context-monitor.js';
+import type { AdapterHookProvider } from './hooks.js';
+import type { AdapterInstallProvider } from './install.js';
+import type { AdapterPathProvider } from './provider-paths.js';
+import type { AdapterSpawnProvider } from './spawn.js';
+import type { AdapterTaskSyncProvider } from './task-sync.js';
+import type { AdapterTransportProvider } from './transport.js';
+export interface CLEOProviderAdapter {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    capabilities: AdapterCapabilities;
+    hooks?: AdapterHookProvider;
+    spawn?: AdapterSpawnProvider;
+    install: AdapterInstallProvider;
+    paths?: AdapterPathProvider;
+    contextMonitor?: AdapterContextMonitorProvider;
+    transport?: AdapterTransportProvider;
+    taskSync?: AdapterTaskSyncProvider;
+    initialize(projectDir: string): Promise<void>;
+    dispose(): Promise<void>;
+    healthCheck(): Promise<AdapterHealthStatus>;
+}
+export interface AdapterHealthStatus {
+    healthy: boolean;
+    provider: string;
+    details?: Record<string, unknown>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/adapter.js

@@ -0,0 +1,8 @@
+/**
+ * Core CLEOProviderAdapter interface.
+ * Every provider adapter must implement this contract.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/archive.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Archive types for archived task records and metadata.
+ *
+ * @task T4555
+ */
+import type { Task } from './task.js';
+/** Archive metadata attached to archived task records. */
+export interface ArchiveMetadata {
+    archivedAt?: string;
+    cycleTimeDays?: number;
+    archiveSource?: string;
+    archiveReason?: string;
+}
+/** A task with archive metadata. */
+export interface ArchivedTask extends Task {
+    _archive?: ArchiveMetadata;
+}
+/** Report type for archive statistics. */
+export type ArchiveReportType = 'summary' | 'by-phase' | 'by-label' | 'by-priority' | 'cycle-times' | 'trends';
+/** Summary report from archive statistics. */
+export interface ArchiveSummaryReport {
+    totalArchived: number;
+    byStatus: Record<string, number>;
+    byPriority: Record<string, number>;
+    averageCycleTime: number | null;
+    oldestArchived: string | null;
+    newestArchived: string | null;
+    archiveSourceBreakdown: Record<string, number>;
+}
+/** Phase breakdown entry from archive statistics. */
+export interface ArchivePhaseEntry {
+    phase: string;
+    count: number;
+    avgCycleTime: number | null;
+}
+/** Label breakdown entry from archive statistics. */
+export interface ArchiveLabelEntry {
+    label: string;
+    count: number;
+}
+/** Priority breakdown entry from archive statistics. */
+export interface ArchivePriorityEntry {
+    priority: string;
+    count: number;
+    avgCycleTime: number | null;
+}
+/** Cycle time distribution buckets. */
+export interface CycleTimeDistribution {
+    '0-1 days': number;
+    '2-7 days': number;
+    '8-30 days': number;
+    '30+ days': number;
+}
+/** Cycle time percentiles. */
+export interface CycleTimePercentiles {
+    p25: number | null;
+    p50: number | null;
+    p75: number | null;
+    p90: number | null;
+}
+/** Cycle times report from archive statistics. */
+export interface ArchiveCycleTimesReport {
+    count: number;
+    min: number | null;
+    max: number | null;
+    avg: number | null;
+    median: number | null;
+    distribution: CycleTimeDistribution;
+    percentiles?: CycleTimePercentiles;
+}
+/** Daily archive trend entry. */
+export interface ArchiveDailyTrend {
+    date: string;
+    count: number;
+}
+/** Monthly archive trend entry. */
+export interface ArchiveMonthlyTrend {
+    month: string;
+    count: number;
+}
+/** Trends report from archive statistics. */
+export interface ArchiveTrendsReport {
+    byDay: ArchiveDailyTrend[];
+    byMonth: ArchiveMonthlyTrend[];
+    totalPeriod: number;
+    averagePerDay: number;
+}
+/** Archive statistics result envelope. */
+export interface ArchiveStatsEnvelope {
+    report: ArchiveReportType;
+    filters: {
+        since: string | null;
+        until: string | null;
+    } | null;
+    data: ArchiveSummaryReport | ArchivePhaseEntry[] | ArchiveLabelEntry[] | ArchivePriorityEntry[] | ArchiveCycleTimesReport | ArchiveTrendsReport | {
+        totalArchived: 0;
+        message: string;
+    };
+}
+//# sourceMappingURL=archive.d.ts.map

package/dist/archive.d.ts.map

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

package/dist/archive.js

@@ -0,0 +1,7 @@
+/**
+ * Archive types for archived task records and metadata.
+ *
+ * @task T4555
+ */
+export {};
+//# sourceMappingURL=archive.js.map

package/dist/archive.js.map

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

package/dist/brain.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Brain/Memory domain types for brain.db cognitive memory system.
+ *
+ * Extracted from inline type definitions in engine-compat.ts to eliminate
+ * repeated `{ id: string; type: string; content: string; createdAt: string }` patterns.
+ *
+ * @task T5800
+ */
+/** Compact brain entry reference used in contradiction analysis. */
+export interface BrainEntryRef {
+    id: string;
+    type: string;
+    content: string;
+    createdAt: string;
+}
+/** Brain entry reference with summary, used in superseded analysis. */
+export interface BrainEntrySummary {
+    id: string;
+    type: string;
+    createdAt: string;
+    summary: string;
+}
+/** Contradiction detail between two brain entries. */
+export interface ContradictionDetail {
+    entryA: BrainEntryRef;
+    entryB: BrainEntryRef;
+    context?: string;
+    conflictDetails: string;
+}
+/** Superseded entry pair showing old and replacement entries. */
+export interface SupersededEntry {
+    oldEntry: BrainEntrySummary;
+    replacement: BrainEntrySummary;
+    grouping: string;
+}
+//# sourceMappingURL=brain.d.ts.map

package/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/brain.js

@@ -0,0 +1,10 @@
+/**
+ * Brain/Memory domain types for brain.db cognitive memory system.
+ *
+ * Extracted from inline type definitions in engine-compat.ts to eliminate
+ * repeated `{ id: string; type: string; content: string; createdAt: string }` patterns.
+ *
+ * @task T5800
+ */
+export {};
+//# sourceMappingURL=brain.js.map

package/dist/brain.js.map

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

package/dist/capabilities.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Adapter capability declarations for CLEO provider adapters.
+ *
+ * @task T5240
+ */
+export interface AdapterCapabilities {
+    supportsHooks: boolean;
+    supportedHookEvents: string[];
+    supportsSpawn: boolean;
+    supportsInstall: boolean;
+    supportsMcp: boolean;
+    supportsInstructionFiles: boolean;
+    /** Provider-specific instruction file name, e.g. "CLAUDE.md", ".cursorrules" */
+    instructionFilePattern?: string;
+    supportsContextMonitor: boolean;
+    supportsStatusline: boolean;
+    supportsProviderPaths: boolean;
+    supportsTransport: boolean;
+    supportsTaskSync: boolean;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,wBAAwB,EAAE,OAAO,CAAC;IAClC,gFAAgF;IAChF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;CAC3B"}

package/dist/capabilities.js

@@ -0,0 +1,7 @@
+/**
+ * Adapter capability declarations for CLEO provider adapters.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Configuration type definitions for CLEO.
+ *
+ * Covers project and global config with cascade resolution.
+ * These are stable types shared across core, dispatch, and CLI.
+ *
+ * @epic T4454
+ * @task T4456
+ * @task T5710
+ */
+/** Output format options. */
+export type OutputFormat = 'json' | 'text' | 'jsonl' | 'markdown' | 'table';
+/** Date format options. */
+export type DateFormat = 'relative' | 'iso' | 'short' | 'long';
+/** Output configuration. */
+export interface OutputConfig {
+    defaultFormat: OutputFormat;
+    showColor: boolean;
+    showUnicode: boolean;
+    showProgressBars: boolean;
+    dateFormat: DateFormat;
+}
+/** Backup configuration. */
+export interface BackupConfig {
+    maxOperationalBackups: number;
+    maxSafetyBackups: number;
+    compressionEnabled: boolean;
+}
+/** Hierarchy enforcement profile preset. */
+export type EnforcementProfile = 'llm-agent-first' | 'human-cognitive' | 'custom';
+/** Hierarchy configuration. */
+export interface HierarchyConfig {
+    maxDepth: number;
+    maxSiblings: number;
+    cascadeDelete: boolean;
+    /** Maximum number of active (non-done) siblings. 0 = disabled. */
+    maxActiveSiblings: number;
+    /** Whether done tasks count toward the sibling limit. */
+    countDoneInLimit: boolean;
+    /** Enforcement profile preset. Explicit fields override preset values. */
+    enforcementProfile: EnforcementProfile;
+}
+/** Session configuration. */
+export interface SessionConfig {
+    autoStart: boolean;
+    requireNotes: boolean;
+    multiSession: boolean;
+}
+/** Pino log levels. */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | 'silent';
+/** Logging configuration. */
+export interface LoggingConfig {
+    /** Minimum log level to record (default: 'info') */
+    level: LogLevel;
+    /** Log file path relative to .cleo/ (default: 'logs/cleo.log') */
+    filePath: string;
+    /** Max log file size in bytes before rotation (default: 10MB) */
+    maxFileSize: number;
+    /** Number of rotated log files to retain (default: 5) */
+    maxFiles: number;
+    /** Days to retain audit_log rows before pruning (default: 90) */
+    auditRetentionDays: number;
+    /** Whether to archive pruned rows to compressed JSONL before deletion (default: true) */
+    archiveBeforePrune: boolean;
+}
+/** Lifecycle enforcement mode. */
+export type LifecycleEnforcementMode = 'strict' | 'advisory' | 'off';
+/** Lifecycle enforcement configuration. */
+export interface LifecycleConfig {
+    mode: LifecycleEnforcementMode;
+}
+/** Sharing mode: whether .cleo/ files are committed to the project git repo. */
+export type SharingMode = 'none' | 'project';
+/** Sharing configuration for multi-contributor .cleo/ state management. */
+export interface SharingConfig {
+    /** Sharing mode (default: 'none'). */
+    mode: SharingMode;
+    /** Files/patterns in .cleo/ to commit to project git (relative to .cleo/). */
+    commitAllowlist: string[];
+    /** Files/patterns to always exclude, even if in commitAllowlist. */
+    denylist: string[];
+}
+/** SignalDock transport mode. */
+export type SignalDockMode = 'http' | 'native';
+/** SignalDock integration configuration. */
+export interface SignalDockConfig {
+    /** Whether SignalDock transport is enabled (default: false). */
+    enabled: boolean;
+    /** Transport mode: 'http' for REST API client, 'native' for napi-rs bindings (default: 'http'). */
+    mode: SignalDockMode;
+    /** SignalDock API server endpoint (default: 'http://localhost:4000'). */
+    endpoint: string;
+    /** Prefix for CLEO agent names in SignalDock registry (default: 'cleo-'). */
+    agentPrefix: string;
+    /** Default privacy tier for registered agents (default: 'private'). */
+    privacyTier: 'public' | 'discoverable' | 'private';
+}
+/** CLEO project configuration (config.json). */
+export interface CleoConfig {
+    version: string;
+    output: OutputConfig;
+    backup: BackupConfig;
+    hierarchy: HierarchyConfig;
+    session: SessionConfig;
+    lifecycle: LifecycleConfig;
+    logging: LoggingConfig;
+    sharing: SharingConfig;
+    /** SignalDock inter-agent transport (optional, disabled by default). */
+    signaldock?: SignalDockConfig;
+}
+/** Configuration resolution priority. */
+export type ConfigSource = 'cli' | 'env' | 'project' | 'global' | 'default';
+/** A resolved config value with its source. */
+export interface ResolvedValue<T> {
+    value: T;
+    source: ConfigSource;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5E,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/D,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAElF,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,uBAAuB;AACvB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1F,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,KAAK,EAAE,QAAQ,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,kCAAkC;AAClC,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AAErE,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,mGAAmG;IACnG,IAAI,EAAE,cAAc,CAAC;IACrB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;CACpD;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,wEAAwE;IACxE,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5E,+CAA+C;AAC/C,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,YAAY,CAAC;CACtB"}

package/dist/config.js

@@ -0,0 +1,12 @@
+/**
+ * Configuration type definitions for CLEO.
+ *
+ * Covers project and global config with cascade resolution.
+ * These are stable types shared across core, dispatch, and CLI.
+ *
+ * @epic T4454
+ * @task T4456
+ * @task T5710
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context-monitor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Context monitor provider interface for CLEO provider adapters.
+ * Allows providers to implement context window tracking and statusline integration.
+ * @task T5240
+ */
+export interface AdapterContextMonitorProvider {
+    /** Process context window input and return a status string */
+    processContextInput(input: unknown, cwd?: string): Promise<string>;
+    /** Check if statusline integration is configured */
+    checkStatuslineIntegration(): 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
+    /** Get the statusline configuration object */
+    getStatuslineConfig(): Record<string, unknown>;
+    /** Get human-readable setup instructions */
+    getSetupInstructions(): string;
+}
+//# sourceMappingURL=context-monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["../src/context-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,6BAA6B;IAC5C,8DAA8D;IAC9D,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,oDAAoD;IACpD,0BAA0B,IAAI,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAC;IACjG,8CAA8C;IAC9C,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,4CAA4C;IAC5C,oBAAoB,IAAI,MAAM,CAAC;CAChC"}

package/dist/context-monitor.js

@@ -0,0 +1,7 @@
+/**
+ * Context monitor provider interface for CLEO provider adapters.
+ * Allows providers to implement context window tracking and statusline integration.
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=context-monitor.js.map

package/dist/context-monitor.js.map

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

package/dist/data-accessor.d.ts

@@ -0,0 +1,167 @@
+/**
+ * DataAccessor: File-level storage abstraction for core modules.
+ *
+ * Core modules operate on whole-file data structures (ArchiveFile, SessionsFile).
+ * The DataAccessor abstracts WHERE that data is stored (SQLite via Drizzle ORM)
+ * while preserving the read-modify-write pattern that core business logic relies on.
+ *
+ * This is the DRY/SOLID injection point: core modules accept a DataAccessor parameter
+ * instead of calling readJson/saveJson directly.
+ *
+ * Implementation: SqliteDataAccessor (materializes/dematerializes from SQLite tables)
+ *
+ * @epic T4454
+ */
+import type { ArchivedTask } from './archive.js';
+import type { Session } from './session.js';
+import type { Task, TaskPriority, TaskSize, TaskStatus, TaskType } from './task.js';
+/** Archive-specific fields for task upsert. */
+export interface ArchiveFields {
+    archivedAt?: string;
+    archiveReason?: string;
+    cycleTimeDays?: number | null;
+}
+/** Archive file structure. */
+export interface ArchiveFile {
+    archivedTasks: ArchivedTask[];
+    version?: string;
+}
+/** Filter bag for queryTasks(). Covers ~90% of task query patterns. */
+export interface TaskQueryFilters {
+    status?: TaskStatus | TaskStatus[];
+    priority?: TaskPriority;
+    type?: TaskType;
+    parentId?: string | null;
+    phase?: string;
+    label?: string;
+    search?: string;
+    excludeStatus?: TaskStatus | TaskStatus[];
+    limit?: number;
+    offset?: number;
+    orderBy?: 'position' | 'createdAt' | 'updatedAt' | 'priority';
+}
+/** Result from queryTasks() with pagination support. */
+export interface QueryTasksResult {
+    tasks: Task[];
+    total: number;
+}
+/** Partial task row fields for updateTaskFields(). */
+export interface TaskFieldUpdates {
+    title?: string;
+    description?: string | null;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    type?: TaskType | null;
+    parentId?: string | null;
+    phase?: string | null;
+    size?: TaskSize | null;
+    position?: number | null;
+    positionVersion?: number;
+    labelsJson?: string;
+    notesJson?: string;
+    acceptanceJson?: string;
+    filesJson?: string;
+    origin?: string | null;
+    blockedBy?: string | null;
+    epicLifecycle?: string | null;
+    noAutoComplete?: boolean | null;
+    completedAt?: string | null;
+    cancelledAt?: string | null;
+    cancellationReason?: string | null;
+    verificationJson?: string | null;
+    createdBy?: string | null;
+    modifiedBy?: string | null;
+    sessionId?: string | null;
+    updatedAt?: string | null;
+}
+/**
+ * Subset of DataAccessor methods available inside a transaction callback.
+ * Write-only — reads use the outer accessor (snapshot isolation).
+ */
+export interface TransactionAccessor {
+    upsertSingleTask(task: Task): Promise<void>;
+    archiveSingleTask(taskId: string, fields: ArchiveFields): Promise<void>;
+    removeSingleTask(taskId: string): Promise<void>;
+    setMetaValue(key: string, value: unknown): Promise<void>;
+    updateTaskFields(taskId: string, fields: TaskFieldUpdates): Promise<void>;
+    appendLog(entry: Record<string, unknown>): Promise<void>;
+}
+/**
+ * DataAccessor interface.
+ *
+ * Core modules call these methods instead of readJson/saveJson.
+ * Each method maps directly to the file-level operations that
+ * core modules already perform.
+ */
+export interface DataAccessor {
+    /** The storage engine backing this accessor. */
+    readonly engine: 'sqlite';
+    /** Load the archive file. Returns null if archive doesn't exist. */
+    loadArchive(): Promise<ArchiveFile | null>;
+    /** Save the archive file atomically. Creates backup before write. */
+    saveArchive(data: ArchiveFile): Promise<void>;
+    /** Load all sessions from the store. Returns empty array if none exist. */
+    loadSessions(): Promise<Session[]>;
+    /** Save all sessions to the store atomically. */
+    saveSessions(sessions: Session[]): Promise<void>;
+    /** Append an entry to the audit log. */
+    appendLog(entry: Record<string, unknown>): Promise<void>;
+    /** Release any resources (close DB connections, etc.). */
+    close(): Promise<void>;
+    /** Upsert a single task (targeted write, no full-file reload). */
+    upsertSingleTask(task: Task): Promise<void>;
+    /** Archive a single task by ID (sets status='archived' + archive metadata). */
+    archiveSingleTask(taskId: string, fields: ArchiveFields): Promise<void>;
+    /** Delete a single task permanently from the tasks table. */
+    removeSingleTask(taskId: string): Promise<void>;
+    /** Load a single task by ID with its dependencies and relations. Returns null if not found. */
+    loadSingleTask(taskId: string): Promise<Task | null>;
+    /** Insert a row into the task_relations table (T5168). */
+    addRelation(taskId: string, relatedTo: string, relationType: string, reason?: string): Promise<void>;
+    /** Read a typed value from the metadata store. Returns null if not found. */
+    getMetaValue<T>(key: string): Promise<T | null>;
+    /** Write a typed value to the metadata store. */
+    setMetaValue(key: string, value: unknown): Promise<void>;
+    /** Read the schema version from metadata. Convenience for getMetaValue('schema_version'). */
+    getSchemaVersion(): Promise<string | null>;
+    /** Query tasks with filters, pagination, and ordering. Returns matching tasks + total count. */
+    queryTasks(filters: TaskQueryFilters): Promise<QueryTasksResult>;
+    /** Count tasks matching optional filters. Excludes archived by default. */
+    countTasks(filters?: {
+        status?: TaskStatus | TaskStatus[];
+        parentId?: string;
+    }): Promise<number>;
+    /** Get direct children of a parent task. */
+    getChildren(parentId: string): Promise<Task[]>;
+    /** Count direct children of a parent task (all statuses except archived). */
+    countChildren(parentId: string): Promise<number>;
+    /** Count active (non-terminal) children of a parent task. */
+    countActiveChildren(parentId: string): Promise<number>;
+    /** Get ancestor chain from task to root via WITH RECURSIVE CTE. Ordered root-first. */
+    getAncestorChain(taskId: string): Promise<Task[]>;
+    /** Get full subtree rooted at taskId via WITH RECURSIVE CTE. Includes root. */
+    getSubtree(rootId: string): Promise<Task[]>;
+    /** Get tasks that depend on (are blocked by) the given task. Reverse dep lookup. */
+    getDependents(taskId: string): Promise<Task[]>;
+    /** Get transitive dependency chain via WITH RECURSIVE CTE. Returns task IDs. */
+    getDependencyChain(taskId: string): Promise<string[]>;
+    /** Check if a task exists (any status including archived). */
+    taskExists(taskId: string): Promise<boolean>;
+    /** Load multiple tasks by ID in a single batch query. */
+    loadTasks(taskIds: string[]): Promise<Task[]>;
+    /** Update specific fields on a task without full load/save cycle. */
+    updateTaskFields(taskId: string, fields: TaskFieldUpdates): Promise<void>;
+    /** Get next available position for a task within a parent scope (SQL-level, race-safe). */
+    getNextPosition(parentId: string | null): Promise<number>;
+    /** Shift positions of siblings >= fromPosition by delta (bulk SQL update). */
+    shiftPositions(parentId: string | null, fromPosition: number, delta: number): Promise<void>;
+    /** Execute a function inside a SQLite transaction (BEGIN IMMEDIATE / COMMIT / ROLLBACK). */
+    transaction<T>(fn: (tx: TransactionAccessor) => Promise<T>): Promise<T>;
+    /** Get the currently active session (status='active', most recent). */
+    getActiveSession(): Promise<Session | null>;
+    /** Upsert a single session (targeted write). */
+    upsertSingleSession(session: Session): Promise<void>;
+    /** Remove a single session by ID. */
+    removeSingleSession(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=data-accessor.d.ts.map

package/dist/data-accessor.d.ts.map

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

package/dist/data-accessor.js

@@ -0,0 +1,18 @@
+/**
+ * DataAccessor: File-level storage abstraction for core modules.
+ *
+ * Core modules operate on whole-file data structures (ArchiveFile, SessionsFile).
+ * The DataAccessor abstracts WHERE that data is stored (SQLite via Drizzle ORM)
+ * while preserving the read-modify-write pattern that core business logic relies on.
+ *
+ * This is the DRY/SOLID injection point: core modules accept a DataAccessor parameter
+ * instead of calling readJson/saveJson directly.
+ *
+ * Implementation: SqliteDataAccessor (materializes/dematerializes from SQLite tables)
+ *
+ * @epic T4454
+ */
+export {};
+// Factory functions (createDataAccessor, getAccessor) live in @cleocode/core,
+// not here. Contracts is types-only.
+//# sourceMappingURL=data-accessor.js.map

package/dist/data-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-accessor.js","sourceRoot":"","sources":["../src/data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;AAgOH,8EAA8E;AAC9E,qCAAqC"}