@cleocode/contracts 2.0.0

package/dist/task.d.ts.map

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

package/dist/task.js

@@ -0,0 +1,24 @@
+/**
+ * Task type definitions matching todo.schema.json (v2.10.0).
+ *
+ * Consolidates types from src/types/task.ts and packages/contracts/src/task-types.ts.
+ *
+ * ## Type Safety Design
+ *
+ * - {@link Task} represents a fully-materialized task as stored in the database.
+ *   Fields that CLEO's anti-hallucination rules require at runtime are marked as
+ *   required (non-optional) so the type system enforces what the business rules demand.
+ *
+ * - {@link TaskCreate} represents the input for creating a new task. Only fields the
+ *   caller MUST supply are required; everything else has sensible defaults applied
+ *   by the `addTask` function.
+ *
+ * - {@link CompletedTask} and {@link CancelledTask} are discriminated union types
+ *   that narrow `Task` for status-specific contexts where additional fields become
+ *   required (e.g., `completedAt` is required when `status = 'done'`).
+ *
+ * @epic T4454
+ * @task T4456
+ */
+export {};
+//# sourceMappingURL=task.js.map

package/dist/task.js.map

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

package/dist/tessera.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tessera Type Definitions
+ *
+ * Tessera templates extend WarpChain with variable bindings,
+ * archetype classification, and instantiation inputs for
+ * parameterized pipeline creation.
+ *
+ * @task T5408
+ */
+import type { WarpChain } from './warp-chain.js';
+/** A variable declaration within a Tessera template. */
+export interface TesseraVariable {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'taskId' | 'epicId';
+    description: string;
+    required: boolean;
+    default?: unknown;
+}
+/** A parameterized WarpChain template with variable bindings. */
+export interface TesseraTemplate extends WarpChain {
+    variables: Record<string, TesseraVariable>;
+    archetypes: string[];
+    defaultValues: Record<string, unknown>;
+    category: 'lifecycle' | 'hotfix' | 'research' | 'security-audit' | 'custom';
+}
+/** Input for instantiating a Tessera template into a concrete chain. */
+export interface TesseraInstantiationInput {
+    templateId: string;
+    epicId: string;
+    variables: Record<string, unknown>;
+}
+//# sourceMappingURL=tessera.d.ts.map

package/dist/tessera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tessera.d.ts","sourceRoot":"","sources":["../src/tessera.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,gBAAgB,GAAG,QAAQ,CAAC;CAC7E;AAED,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/tessera.js

@@ -0,0 +1,11 @@
+/**
+ * Tessera Type Definitions
+ *
+ * Tessera templates extend WarpChain with variable bindings,
+ * archetype classification, and instantiation inputs for
+ * parameterized pipeline creation.
+ *
+ * @task T5408
+ */
+export {};
+//# sourceMappingURL=tessera.js.map

package/dist/tessera.js.map

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

package/dist/todowrite.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TodoWrite types for Claude TodoWrite state merge operations.
+ *
+ * @task T4551
+ */
+/** TodoWrite item status as exported by Claude. */
+export type TodoWriteItemStatus = 'pending' | 'in_progress' | 'completed';
+/** TodoWrite item as exported by Claude. */
+export interface TodoWriteItem {
+    content: string;
+    status: TodoWriteItemStatus;
+    activeForm?: string;
+}
+/** TodoWrite state file format. */
+export interface TodoWriteState {
+    todos: TodoWriteItem[];
+}
+/** Sync session state for TodoWrite integration. */
+export interface TodoWriteSyncSessionState {
+    injected_tasks: string[];
+    injectedPhase?: string;
+    task_metadata?: Record<string, {
+        phase?: string;
+    }>;
+}
+/** Detected changes from TodoWrite state analysis. */
+export interface TodoWriteChangeSet {
+    completed: string[];
+    progressed: string[];
+    newTasks: string[];
+    removed: string[];
+}
+/** Action type for a TodoWrite merge change. */
+export type TodoWriteChangeAction = 'complete' | 'create' | 'update';
+/** A single change applied during TodoWrite merge. */
+export interface TodoWriteChange {
+    taskId: string;
+    action: TodoWriteChangeAction;
+    details?: string;
+}
+/** Result of a TodoWrite merge operation. */
+export interface TodoWriteMergeResult {
+    dryRun: boolean;
+    changes: {
+        completed: number;
+        progressed: number;
+        new: number;
+        removed: number;
+        applied: number;
+    };
+    sessionCleared?: boolean;
+}
+//# sourceMappingURL=todowrite.d.ts.map

package/dist/todowrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todowrite.d.ts","sourceRoot":"","sources":["../src/todowrite.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1E,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/todowrite.js

@@ -0,0 +1,7 @@
+/**
+ * TodoWrite types for Claude TodoWrite state merge operations.
+ *
+ * @task T4551
+ */
+export {};
+//# sourceMappingURL=todowrite.js.map

package/dist/todowrite.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Transport provider interface for CLEO provider adapters.
+ * Allows providers to supply custom inter-agent transport mechanisms.
+ * @task T5240
+ */
+export interface AdapterTransportProvider {
+    /** Create a transport instance for inter-agent communication */
+    createTransport(): unknown;
+    /** Name of this transport type for logging/debugging */
+    readonly transportName: string;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,eAAe,IAAI,OAAO,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

package/dist/transport.js

@@ -0,0 +1,7 @@
+/**
+ * Transport provider interface for CLEO provider adapters.
+ * Allows providers to supply custom inter-agent transport mechanisms.
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/warp-chain.d.ts

@@ -0,0 +1,121 @@
+/**
+ * WarpChain Type System
+ *
+ * Defines the complete type system for WarpChain workflow definitions.
+ * Warp is the unyielding protocol chain: the synthesis of composable workflow
+ * shape (topology) and LOOM quality gates into a unified chain model.
+ *
+ * ProtocolType and GateName are inlined here (contracts has zero external deps).
+ *
+ * @task T5407
+ */
+/** All supported protocol types. */
+export type ProtocolType = 'research' | 'consensus' | 'specification' | 'decomposition' | 'implementation' | 'contribution' | 'release' | 'artifact-publish' | 'provenance';
+/** Verification gate names (ordered dependency chain). */
+export type GateName = 'implemented' | 'testsPassed' | 'qaPassed' | 'cleanupDone' | 'securityPassed' | 'documented';
+/**
+ * A single stage in the warp chain.
+ *
+ * The category union includes all canonical CLEO pipeline stages
+ * plus 'custom' for user-defined stages.
+ */
+export interface WarpStage {
+    id: string;
+    name: string;
+    category: 'research' | 'consensus' | 'architecture' | 'specification' | 'decomposition' | 'implementation' | 'validation' | 'testing' | 'release' | 'contribution' | 'custom';
+    skippable: boolean;
+    description?: string;
+}
+/** Connection between two stages in the chain. */
+export interface WarpLink {
+    from: string;
+    to: string;
+    type: 'linear' | 'fork' | 'branch';
+    condition?: string;
+}
+/** The topology/DAG of a workflow. */
+export interface ChainShape {
+    stages: WarpStage[];
+    links: WarpLink[];
+    entryPoint: string;
+    exitPoints: string[];
+}
+/** Discriminated union for gate check types. */
+export type GateCheck = {
+    type: 'stage_complete';
+    stageId: string;
+} | {
+    type: 'artifact_exists';
+    artifactType: string;
+    path?: string;
+} | {
+    type: 'protocol_valid';
+    protocolType: ProtocolType;
+} | {
+    type: 'verification_gate';
+    gateName: GateName;
+} | {
+    type: 'custom';
+    validator: string;
+    params?: Record<string, unknown>;
+};
+/** A quality gate embedded in the chain. */
+export interface GateContract {
+    id: string;
+    name: string;
+    type: 'entry' | 'exit' | 'checkpoint';
+    stageId: string;
+    position: 'before' | 'after';
+    check: GateCheck;
+    severity: 'blocking' | 'warning' | 'info';
+    canForce: boolean;
+}
+/** Complete chain definition combining shape and gates. */
+export interface WarpChain {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    shape: ChainShape;
+    gates: GateContract[];
+    tessera?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Result of validating a chain definition. */
+export interface ChainValidation {
+    wellFormed: boolean;
+    gateSatisfiable: boolean;
+    artifactComplete: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/** A chain bound to a specific epic. */
+export interface WarpChainInstance {
+    id: string;
+    chainId: string;
+    epicId: string;
+    variables: Record<string, unknown>;
+    stageToTask: Record<string, string>;
+    status: 'pending' | 'active' | 'completed' | 'failed' | 'cancelled';
+    currentStage: string;
+    createdAt: string;
+    createdBy: string;
+}
+/** Result of evaluating a single gate. */
+export interface GateResult {
+    gateId: string;
+    passed: boolean;
+    forced: boolean;
+    message?: string;
+    evaluatedAt: string;
+}
+/** Runtime state of a chain instance execution. */
+export interface WarpChainExecution {
+    instanceId: string;
+    currentStage: string;
+    gateResults: GateResult[];
+    status: 'running' | 'paused' | 'completed' | 'failed';
+    startedAt: string;
+    completedAt?: string;
+}
+//# sourceMappingURL=warp-chain.d.ts.map

package/dist/warp-chain.d.ts.map

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

package/dist/warp-chain.js

@@ -0,0 +1,13 @@
+/**
+ * WarpChain Type System
+ *
+ * Defines the complete type system for WarpChain workflow definitions.
+ * Warp is the unyielding protocol chain: the synthesis of composable workflow
+ * shape (topology) and LOOM quality gates into a unified chain model.
+ *
+ * ProtocolType and GateName are inlined here (contracts has zero external deps).
+ *
+ * @task T5407
+ */
+export {};
+//# sourceMappingURL=warp-chain.js.map

package/dist/warp-chain.js.map

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

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@cleocode/contracts",
+  "version": "2.0.0",
+  "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/adapter.ts

@@ -0,0 +1,38 @@
+/**
+ * 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>;
+}

package/src/archive.ts

@@ -0,0 +1,121 @@
+/**
+ * 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 };
+}

package/src/brain.ts

@@ -0,0 +1,39 @@
+/**
+ * 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;
+}

package/src/capabilities.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;
+}