@cleocode/contracts 2026.3.39 → 2026.3.40

package/dist/adapter.d.ts

@@ -10,7 +10,7 @@ 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 { ExternalTaskProvider } from './task-sync.js';
 import type { AdapterTransportProvider } from './transport.js';
 export interface CLEOProviderAdapter {
     readonly id: string;
@@ -23,7 +23,7 @@ export interface CLEOProviderAdapter {
     paths?: AdapterPathProvider;
     contextMonitor?: AdapterContextMonitorProvider;
     transport?: AdapterTransportProvider;
-    taskSync?: AdapterTaskSyncProvider;
+    taskSync?: ExternalTaskProvider;
     initialize(projectDir: string): Promise<void>;
     dispose(): Promise<void>;
     healthCheck(): Promise<AdapterHealthStatus>;

package/dist/adapter.d.ts.map

@@ -1 +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"}
+{"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,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,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,oBAAoB,CAAC;IAChC,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/index.d.ts

@@ -31,9 +31,8 @@ export type { CAAMPSpawnOptions, CAAMPSpawnResult, CLEOSpawnAdapter, CLEOSpawnCo
 export { ADR_STATUSES, type AdrStatus, type EntityType, GATE_STATUSES, type GateStatus, isValidStatus, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, MANIFEST_STATUSES, type ManifestStatus, PIPELINE_STATUS_ICONS, type PipelineStatus, SESSION_STATUSES, type SessionStatus, STAGE_STATUS_ICONS, STATUS_REGISTRY, type StageStatus, TASK_STATUS_SYMBOLS_ASCII, TASK_STATUS_SYMBOLS_UNICODE, TASK_STATUSES, type TaskStatus, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES, TERMINAL_TASK_STATUSES, } from './status-registry.js';
 export type { CancelledTask, CompletedTask, EpicLifecycle, FileMeta, Phase, PhaseStatus, PhaseTransition, ProjectMeta, Release, ReleaseStatus, SessionNote, Task, TaskCreate, TaskFile, TaskOrigin, TaskPriority, TaskProvenance, TaskRelation, TaskSize, TaskType, TaskVerification, TaskWorkState, VerificationAgent, VerificationFailure, VerificationGate, } from './task.js';
 export type { MinimalTaskRecord, TaskRecord, TaskRecordRelation, ValidationHistoryEntry, } from './task-record.js';
-export type { AdapterTaskSyncProvider, ConflictPolicy, ExternalTask, ExternalTaskStatus, ReconcileAction, ReconcileActionType, ReconcileOptions, ReconcileResult, SyncSessionState, } from './task-sync.js';
+export type { ConflictPolicy, ExternalLinkType, ExternalTask, ExternalTaskLink, ExternalTaskProvider, ExternalTaskStatus, ReconcileAction, ReconcileActionType, ReconcileOptions, ReconcileResult, SyncDirection, } from './task-sync.js';
 export type { TesseraInstantiationInput, TesseraTemplate, TesseraVariable, } from './tessera.js';
-export type { TodoWriteChange, TodoWriteChangeAction, TodoWriteChangeSet, TodoWriteItem, TodoWriteItemStatus, TodoWriteMergeResult, TodoWriteState, TodoWriteSyncSessionState, } from './todowrite.js';
 export type { AdapterTransportProvider } from './transport.js';
 export type { ChainShape, ChainValidation, GateCheck, GateContract, GateName, GateResult, ProtocolType, WarpChain, WarpChainExecution, WarpChainInstance, WarpLink, WarpStage, } from './warp-chain.js';
 //# sourceMappingURL=index.d.ts.map

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/task-sync.d.ts

@@ -1,11 +1,10 @@
 /**
  * Task synchronization contracts for provider-agnostic task reconciliation.
  *
- * Replaces the legacy Claude Code-specific TodoWrite integration with a
- * provider-agnostic system. Any provider adapter can implement
- * AdapterTaskSyncProvider to sync its external task system with CLEO as SSoT.
- *
- * @task T5800
+ * Defines the interface for syncing external issue/task systems (Linear, Jira,
+ * GitHub Issues, GitLab, etc.) with CLEO as SSoT. Provider adapters normalize
+ * their native formats into ExternalTask[], and the reconciliation engine
+ * handles diffing, creating, updating, and linking.
  */
 /** Normalized status for tasks coming from an external provider. */
 export type ExternalTaskStatus = 'pending' | 'active' | 'completed' | 'removed';
@@ -16,34 +15,56 @@ export type ExternalTaskStatus = 'pending' | 'active' | 'completed' | 'removed';
 export interface ExternalTask {
     /** Provider-assigned identifier for this task (opaque to core). */
     externalId: string;
-    /** Mapped CLEO task ID, or null if the task is new / unmatched. */
-    cleoTaskId: string | null;
     /** Human-readable title. */
     title: string;
     /** Normalized status. */
     status: ExternalTaskStatus;
     /** Optional description text. */
     description?: string;
+    /** Optional priority mapping (provider decides how to map). */
+    priority?: 'critical' | 'high' | 'medium' | 'low';
+    /** Optional task type mapping. */
+    type?: 'epic' | 'task' | 'subtask';
     /** Optional labels/tags from the provider. */
     labels?: string[];
+    /** Optional URL to the external task (for linking). */
+    url?: string;
+    /** Optional parent external ID (for hierarchy). */
+    parentExternalId?: string;
     /** Arbitrary provider-specific metadata (opaque to core). */
     providerMeta?: Record<string, unknown>;
 }
+/** How an external task link was established. */
+export type ExternalLinkType = 'created' | 'matched' | 'manual';
+/** Direction of the sync that established the link. */
+export type SyncDirection = 'inbound' | 'outbound' | 'bidirectional';
 /**
- * Persistent state for a sync session between CLEO and a provider.
- * Stored per-provider under `.cleo/sync/<providerId>-session.json`.
+ * A link between a CLEO task and an external provider task.
+ * Stored in the external_task_links table in tasks.db.
  */
-export interface SyncSessionState {
-    /** CLEO task IDs that were injected into the provider's task list. */
-    injectedTaskIds: string[];
-    /** Optional phase context when tasks were injected. */
-    injectedPhase?: string;
-    /** Per-task metadata at injection time. */
-    taskMetadata?: Record<string, {
-        phase?: string;
-    }>;
-    /** ISO timestamp of the last successful reconciliation. */
-    lastSyncAt?: string;
+export interface ExternalTaskLink {
+    /** Link ID (UUID). */
+    id: string;
+    /** CLEO task ID. */
+    taskId: string;
+    /** Provider identifier (e.g. 'linear', 'jira', 'github'). */
+    providerId: string;
+    /** Provider-assigned external task ID. */
+    externalId: string;
+    /** URL to the external task. */
+    externalUrl?: string | null;
+    /** Title at time of last sync. */
+    externalTitle?: string | null;
+    /** How this link was established. */
+    linkType: ExternalLinkType;
+    /** Sync direction. */
+    syncDirection: SyncDirection;
+    /** Provider-specific metadata (JSON). */
+    metadata?: Record<string, unknown>;
+    /** When the link was first established. */
+    linkedAt: string;
+    /** When the external task was last synchronized. */
+    lastSyncAt?: string | null;
 }
 /**
  * Policy for resolving conflicts between CLEO and provider state.
@@ -56,7 +77,7 @@ export interface SyncSessionState {
 export type ConflictPolicy = 'cleo-wins' | 'provider-wins' | 'latest-wins' | 'report-only';
 /** Options for the reconciliation engine. */
 export interface ReconcileOptions {
-    /** Provider ID (e.g. 'claude-code', 'cursor'). */
+    /** Provider ID (e.g. 'linear', 'jira', 'github'). */
     providerId: string;
     /** Working directory (project root). */
     cwd?: string;
@@ -70,19 +91,21 @@ export interface ReconcileOptions {
     defaultLabels?: string[];
 }
 /** The type of action the reconciliation engine will take. */
-export type ReconcileActionType = 'complete' | 'activate' | 'create' | 'remove' | 'skip' | 'conflict';
+export type ReconcileActionType = 'create' | 'update' | 'complete' | 'activate' | 'skip' | 'conflict';
 /** A single reconciliation action (planned or applied). */
 export interface ReconcileAction {
     /** What kind of change. */
     type: ReconcileActionType;
     /** The CLEO task ID affected (null for creates before they happen). */
     cleoTaskId: string | null;
-    /** The external task that triggered this action. */
+    /** The external task ID that triggered this action. */
     externalId: string;
     /** Human-readable description of the action. */
     summary: string;
     /** Whether this action was actually applied. */
     applied: boolean;
+    /** The link ID if a link was created or updated. */
+    linkId?: string;
     /** Error message if the action failed during apply. */
     error?: string;
 }
@@ -96,24 +119,45 @@ export interface ReconcileResult {
     actions: ReconcileAction[];
     /** Summary counts. */
     summary: {
+        created: number;
+        updated: number;
         completed: number;
         activated: number;
-        created: number;
-        removed: number;
         skipped: number;
         conflicts: number;
+        total: number;
         applied: number;
     };
-    /** Whether sync session state was cleared after apply. */
-    sessionCleared: boolean;
+    /** Links created or updated during this reconciliation. */
+    linksAffected: number;
 }
 /**
  * Interface that provider adapters implement to expose their external
  * task system to the reconciliation engine.
  *
- * Provider-specific parsing lives here — core never sees native formats.
+ * Provider-specific parsing lives in the adapter — core never sees native formats.
+ * Consumers implement this interface to integrate their issue tracker with CLEO.
+ *
+ * @example
+ * ```typescript
+ * class LinearAdapter implements ExternalTaskProvider {
+ *   async getExternalTasks(projectDir: string): Promise<ExternalTask[]> {
+ *     const issues = await linearClient.issues({ projectId: '...' });
+ *     return issues.map(issue => ({
+ *       externalId: issue.id,
+ *       title: issue.title,
+ *       status: mapLinearStatus(issue.state),
+ *       description: issue.description,
+ *       priority: mapLinearPriority(issue.priority),
+ *       labels: issue.labels.map(l => l.name),
+ *       url: issue.url,
+ *       providerMeta: { linearId: issue.identifier },
+ *     }));
+ *   }
+ * }
+ * ```
  */
-export interface AdapterTaskSyncProvider {
+export interface ExternalTaskProvider {
     /**
      * Read the provider's current task state and return normalized ExternalTasks.
      *
@@ -122,7 +166,7 @@ export interface AdapterTaskSyncProvider {
      */
     getExternalTasks(projectDir: string): Promise<ExternalTask[]>;
     /**
-     * Optionally push CLEO task state back to the provider.
+     * Optionally push CLEO task state back to the provider (outbound sync).
      * Not all providers support bidirectional sync.
      *
      * @param tasks - Current CLEO tasks to push.
@@ -133,11 +177,5 @@ export interface AdapterTaskSyncProvider {
         title: string;
         status: string;
     }>, projectDir: string): Promise<void>;
-    /**
-     * Clean up provider-specific sync artifacts (e.g. state files).
-     *
-     * @param projectDir - Project root directory.
-     */
-    cleanup?(projectDir: string): Promise<void>;
 }
 //# sourceMappingURL=task-sync.d.ts.map

package/dist/task-sync.d.ts.map

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

package/dist/task-sync.js

@@ -1,11 +1,10 @@
 /**
  * Task synchronization contracts for provider-agnostic task reconciliation.
  *
- * Replaces the legacy Claude Code-specific TodoWrite integration with a
- * provider-agnostic system. Any provider adapter can implement
- * AdapterTaskSyncProvider to sync its external task system with CLEO as SSoT.
- *
- * @task T5800
+ * Defines the interface for syncing external issue/task systems (Linear, Jira,
+ * GitHub Issues, GitLab, etc.) with CLEO as SSoT. Provider adapters normalize
+ * their native formats into ExternalTask[], and the reconciliation engine
+ * handles diffing, creating, updating, and linking.
  */
 export {};
 //# sourceMappingURL=task-sync.js.map

package/dist/task-sync.js.map

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

package/package.json

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

package/src/adapter.ts

@@ -11,7 +11,7 @@ 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 { ExternalTaskProvider } from './task-sync.js';
 import type { AdapterTransportProvider } from './transport.js';
 
 export interface CLEOProviderAdapter {
@@ -25,7 +25,7 @@ export interface CLEOProviderAdapter {
   paths?: AdapterPathProvider;
   contextMonitor?: AdapterContextMonitorProvider;
   transport?: AdapterTransportProvider;
-  taskSync?: AdapterTaskSyncProvider;
+  taskSync?: ExternalTaskProvider;
   initialize(projectDir: string): Promise<void>;
   dispose(): Promise<void>;
   healthCheck(): Promise<AdapterHealthStatus>;

package/src/index.ts

@@ -244,15 +244,17 @@ export type {
 } from './task-record.js';
 // === Task Sync Types (provider-agnostic reconciliation) ===
 export type {
-  AdapterTaskSyncProvider,
   ConflictPolicy,
+  ExternalLinkType,
   ExternalTask,
+  ExternalTaskLink,
+  ExternalTaskProvider,
   ExternalTaskStatus,
   ReconcileAction,
   ReconcileActionType,
   ReconcileOptions,
   ReconcileResult,
-  SyncSessionState,
+  SyncDirection,
 } from './task-sync.js';
 // === Tessera Types ===
 export type {
@@ -260,17 +262,6 @@ export type {
   TesseraTemplate,
   TesseraVariable,
 } from './tessera.js';
-// === TodoWrite Types (deprecated — use task-sync types) ===
-export type {
-  TodoWriteChange,
-  TodoWriteChangeAction,
-  TodoWriteChangeSet,
-  TodoWriteItem,
-  TodoWriteItemStatus,
-  TodoWriteMergeResult,
-  TodoWriteState,
-  TodoWriteSyncSessionState,
-} from './todowrite.js';
 export type { AdapterTransportProvider } from './transport.js';
 // === WarpChain Types ===
 export type {

package/src/task-sync.ts

@@ -1,11 +1,10 @@
 /**
  * Task synchronization contracts for provider-agnostic task reconciliation.
  *
- * Replaces the legacy Claude Code-specific TodoWrite integration with a
- * provider-agnostic system. Any provider adapter can implement
- * AdapterTaskSyncProvider to sync its external task system with CLEO as SSoT.
- *
- * @task T5800
+ * Defines the interface for syncing external issue/task systems (Linear, Jira,
+ * GitHub Issues, GitLab, etc.) with CLEO as SSoT. Provider adapters normalize
+ * their native formats into ExternalTask[], and the reconciliation engine
+ * handles diffing, creating, updating, and linking.
  */
 
 // ---------------------------------------------------------------------------
@@ -22,37 +21,63 @@ export type ExternalTaskStatus = 'pending' | 'active' | 'completed' | 'removed';
 export interface ExternalTask {
   /** Provider-assigned identifier for this task (opaque to core). */
   externalId: string;
-  /** Mapped CLEO task ID, or null if the task is new / unmatched. */
-  cleoTaskId: string | null;
   /** Human-readable title. */
   title: string;
   /** Normalized status. */
   status: ExternalTaskStatus;
   /** Optional description text. */
   description?: string;
+  /** Optional priority mapping (provider decides how to map). */
+  priority?: 'critical' | 'high' | 'medium' | 'low';
+  /** Optional task type mapping. */
+  type?: 'epic' | 'task' | 'subtask';
   /** Optional labels/tags from the provider. */
   labels?: string[];
+  /** Optional URL to the external task (for linking). */
+  url?: string;
+  /** Optional parent external ID (for hierarchy). */
+  parentExternalId?: string;
   /** Arbitrary provider-specific metadata (opaque to core). */
   providerMeta?: Record<string, unknown>;
 }
 
 // ---------------------------------------------------------------------------
-// Sync session state
+// External task link (DB-backed tracking)
 // ---------------------------------------------------------------------------
 
+/** How an external task link was established. */
+export type ExternalLinkType = 'created' | 'matched' | 'manual';
+
+/** Direction of the sync that established the link. */
+export type SyncDirection = 'inbound' | 'outbound' | 'bidirectional';
+
 /**
- * Persistent state for a sync session between CLEO and a provider.
- * Stored per-provider under `.cleo/sync/<providerId>-session.json`.
+ * A link between a CLEO task and an external provider task.
+ * Stored in the external_task_links table in tasks.db.
  */
-export interface SyncSessionState {
-  /** CLEO task IDs that were injected into the provider's task list. */
-  injectedTaskIds: string[];
-  /** Optional phase context when tasks were injected. */
-  injectedPhase?: string;
-  /** Per-task metadata at injection time. */
-  taskMetadata?: Record<string, { phase?: string }>;
-  /** ISO timestamp of the last successful reconciliation. */
-  lastSyncAt?: string;
+export interface ExternalTaskLink {
+  /** Link ID (UUID). */
+  id: string;
+  /** CLEO task ID. */
+  taskId: string;
+  /** Provider identifier (e.g. 'linear', 'jira', 'github'). */
+  providerId: string;
+  /** Provider-assigned external task ID. */
+  externalId: string;
+  /** URL to the external task. */
+  externalUrl?: string | null;
+  /** Title at time of last sync. */
+  externalTitle?: string | null;
+  /** How this link was established. */
+  linkType: ExternalLinkType;
+  /** Sync direction. */
+  syncDirection: SyncDirection;
+  /** Provider-specific metadata (JSON). */
+  metadata?: Record<string, unknown>;
+  /** When the link was first established. */
+  linkedAt: string;
+  /** When the external task was last synchronized. */
+  lastSyncAt?: string | null;
 }
 
 // ---------------------------------------------------------------------------
@@ -75,7 +100,7 @@ export type ConflictPolicy = 'cleo-wins' | 'provider-wins' | 'latest-wins' | 're
 
 /** Options for the reconciliation engine. */
 export interface ReconcileOptions {
-  /** Provider ID (e.g. 'claude-code', 'cursor'). */
+  /** Provider ID (e.g. 'linear', 'jira', 'github'). */
   providerId: string;
   /** Working directory (project root). */
   cwd?: string;
@@ -91,10 +116,10 @@ export interface ReconcileOptions {
 
 /** The type of action the reconciliation engine will take. */
 export type ReconcileActionType =
+  | 'create'
+  | 'update'
   | 'complete'
   | 'activate'
-  | 'create'
-  | 'remove'
   | 'skip'
   | 'conflict';
 
@@ -104,12 +129,14 @@ export interface ReconcileAction {
   type: ReconcileActionType;
   /** The CLEO task ID affected (null for creates before they happen). */
   cleoTaskId: string | null;
-  /** The external task that triggered this action. */
+  /** The external task ID that triggered this action. */
   externalId: string;
   /** Human-readable description of the action. */
   summary: string;
   /** Whether this action was actually applied. */
   applied: boolean;
+  /** The link ID if a link was created or updated. */
+  linkId?: string;
   /** Error message if the action failed during apply. */
   error?: string;
 }
@@ -124,16 +151,17 @@ export interface ReconcileResult {
   actions: ReconcileAction[];
   /** Summary counts. */
   summary: {
+    created: number;
+    updated: number;
     completed: number;
     activated: number;
-    created: number;
-    removed: number;
     skipped: number;
     conflicts: number;
+    total: number;
     applied: number;
   };
-  /** Whether sync session state was cleared after apply. */
-  sessionCleared: boolean;
+  /** Links created or updated during this reconciliation. */
+  linksAffected: number;
 }
 
 // ---------------------------------------------------------------------------
@@ -144,9 +172,29 @@ export interface ReconcileResult {
  * Interface that provider adapters implement to expose their external
  * task system to the reconciliation engine.
  *
- * Provider-specific parsing lives here — core never sees native formats.
+ * Provider-specific parsing lives in the adapter — core never sees native formats.
+ * Consumers implement this interface to integrate their issue tracker with CLEO.
+ *
+ * @example
+ * ```typescript
+ * class LinearAdapter implements ExternalTaskProvider {
+ *   async getExternalTasks(projectDir: string): Promise<ExternalTask[]> {
+ *     const issues = await linearClient.issues({ projectId: '...' });
+ *     return issues.map(issue => ({
+ *       externalId: issue.id,
+ *       title: issue.title,
+ *       status: mapLinearStatus(issue.state),
+ *       description: issue.description,
+ *       priority: mapLinearPriority(issue.priority),
+ *       labels: issue.labels.map(l => l.name),
+ *       url: issue.url,
+ *       providerMeta: { linearId: issue.identifier },
+ *     }));
+ *   }
+ * }
+ * ```
  */
-export interface AdapterTaskSyncProvider {
+export interface ExternalTaskProvider {
   /**
    * Read the provider's current task state and return normalized ExternalTasks.
    *
@@ -156,7 +204,7 @@ export interface AdapterTaskSyncProvider {
   getExternalTasks(projectDir: string): Promise<ExternalTask[]>;
 
   /**
-   * Optionally push CLEO task state back to the provider.
+   * Optionally push CLEO task state back to the provider (outbound sync).
    * Not all providers support bidirectional sync.
    *
    * @param tasks - Current CLEO tasks to push.
@@ -166,11 +214,4 @@ export interface AdapterTaskSyncProvider {
     tasks: ReadonlyArray<{ id: string; title: string; status: string }>,
     projectDir: string,
   ): Promise<void>;
-
-  /**
-   * Clean up provider-specific sync artifacts (e.g. state files).
-   *
-   * @param projectDir - Project root directory.
-   */
-  cleanup?(projectDir: string): Promise<void>;
 }

package/dist/todowrite.d.ts

@@ -1,53 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

package/dist/todowrite.js.map

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

package/src/todowrite.ts

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