@cleocode/contracts 2.0.0

package/dist/discovery.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Adapter manifest and discovery contracts for CLEO provider adapters.
+ *
+ * @task T5240
+ */
+import type { AdapterCapabilities } from './capabilities.js';
+export interface AdapterManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    /** Provider identifier, e.g. "claude-code", "opencode", "cursor" */
+    provider: string;
+    /** Relative path to the main adapter module */
+    entryPoint: string;
+    /**
+     * Resolved absolute path to the adapter package root.
+     * Populated at discovery time by discoverAdapterManifests().
+     */
+    packagePath: string;
+    capabilities: AdapterCapabilities;
+    detectionPatterns: DetectionPattern[];
+}
+export interface DetectionPattern {
+    type: 'env' | 'file' | 'process' | 'cli';
+    pattern: string;
+    description: string;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/discovery.js

@@ -0,0 +1,7 @@
+/**
+ * Adapter manifest and discovery contracts for CLEO provider adapters.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/exit-codes.d.ts

@@ -0,0 +1,109 @@
+/**
+ * CLEO exit codes — canonical definitions shared across all layers.
+ *
+ * Ranges: 0 = success, 1-99 = errors, 100+ = special (non-error) states.
+ *
+ * @epic T4454
+ * @task T4456
+ * @task T5710
+ */
+export declare enum ExitCode {
+    SUCCESS = 0,
+    GENERAL_ERROR = 1,
+    INVALID_INPUT = 2,
+    FILE_ERROR = 3,
+    NOT_FOUND = 4,
+    DEPENDENCY_ERROR = 5,
+    VALIDATION_ERROR = 6,
+    LOCK_TIMEOUT = 7,
+    CONFIG_ERROR = 8,
+    PARENT_NOT_FOUND = 10,
+    DEPTH_EXCEEDED = 11,
+    SIBLING_LIMIT = 12,
+    INVALID_PARENT_TYPE = 13,
+    CIRCULAR_REFERENCE = 14,
+    ORPHAN_DETECTED = 15,
+    HAS_CHILDREN = 16,
+    TASK_COMPLETED = 17,
+    CASCADE_FAILED = 18,
+    HAS_DEPENDENTS = 19,
+    CHECKSUM_MISMATCH = 20,
+    CONCURRENT_MODIFICATION = 21,
+    ID_COLLISION = 22,
+    SESSION_EXISTS = 30,
+    SESSION_NOT_FOUND = 31,
+    SCOPE_CONFLICT = 32,
+    SCOPE_INVALID = 33,
+    TASK_NOT_IN_SCOPE = 34,
+    TASK_CLAIMED = 35,
+    SESSION_REQUIRED = 36,
+    SESSION_CLOSE_BLOCKED = 37,
+    ACTIVE_TASK_REQUIRED = 38,
+    NOTES_REQUIRED = 39,
+    VERIFICATION_INIT_FAILED = 40,
+    GATE_UPDATE_FAILED = 41,
+    INVALID_GATE = 42,
+    INVALID_AGENT = 43,
+    MAX_ROUNDS_EXCEEDED = 44,
+    GATE_DEPENDENCY = 45,
+    VERIFICATION_LOCKED = 46,
+    ROUND_MISMATCH = 47,
+    CONTEXT_WARNING = 50,
+    CONTEXT_CAUTION = 51,
+    CONTEXT_CRITICAL = 52,
+    CONTEXT_EMERGENCY = 53,
+    CONTEXT_STALE = 54,
+    PROTOCOL_MISSING = 60,
+    INVALID_RETURN_MESSAGE = 61,
+    MANIFEST_ENTRY_MISSING = 62,
+    SPAWN_VALIDATION_FAILED = 63,
+    AUTONOMOUS_BOUNDARY = 64,
+    HANDOFF_REQUIRED = 65,
+    RESUME_FAILED = 66,
+    CONCURRENT_SESSION = 67,
+    NEXUS_NOT_INITIALIZED = 70,
+    NEXUS_PROJECT_NOT_FOUND = 71,
+    NEXUS_PERMISSION_DENIED = 72,
+    NEXUS_INVALID_SYNTAX = 73,
+    NEXUS_SYNC_FAILED = 74,
+    NEXUS_REGISTRY_CORRUPT = 75,
+    NEXUS_PROJECT_EXISTS = 76,
+    NEXUS_QUERY_FAILED = 77,
+    NEXUS_GRAPH_ERROR = 78,
+    NEXUS_RESERVED = 79,
+    LIFECYCLE_GATE_FAILED = 80,
+    AUDIT_MISSING = 81,
+    CIRCULAR_VALIDATION = 82,
+    LIFECYCLE_TRANSITION_INVALID = 83,
+    PROVENANCE_REQUIRED = 84,
+    ARTIFACT_TYPE_UNKNOWN = 85,
+    ARTIFACT_VALIDATION_FAILED = 86,
+    ARTIFACT_BUILD_FAILED = 87,
+    ARTIFACT_PUBLISH_FAILED = 88,
+    ARTIFACT_ROLLBACK_FAILED = 89,
+    PROVENANCE_CONFIG_INVALID = 90,
+    SIGNING_KEY_MISSING = 91,
+    SIGNATURE_INVALID = 92,
+    DIGEST_MISMATCH = 93,
+    ATTESTATION_INVALID = 94,
+    ADAPTER_NOT_FOUND = 95,
+    ADAPTER_INIT_FAILED = 96,
+    ADAPTER_HOOK_FAILED = 97,
+    ADAPTER_SPAWN_FAILED = 98,
+    ADAPTER_INSTALL_FAILED = 99,
+    NO_DATA = 100,
+    ALREADY_EXISTS = 101,
+    NO_CHANGE = 102,
+    TESTS_SKIPPED = 103
+}
+/** Check if an exit code represents an error (1-99). */
+export declare function isErrorCode(code: ExitCode): boolean;
+/** Check if an exit code represents success (0 or 100+). */
+export declare function isSuccessCode(code: ExitCode): boolean;
+/** Check if an exit code indicates no change (idempotent operation). */
+export declare function isNoChangeCode(code: ExitCode): boolean;
+/** Check if an exit code is recoverable (retry may succeed). */
+export declare function isRecoverableCode(code: ExitCode): boolean;
+/** Human-readable name for an exit code. */
+export declare function getExitCodeName(code: ExitCode): string;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAY,QAAQ;IAElB,OAAO,IAAI;IAGX,aAAa,IAAI;IACjB,aAAa,IAAI;IACjB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,YAAY,IAAI;IAChB,YAAY,IAAI;IAGhB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,kBAAkB,KAAK;IACvB,eAAe,KAAK;IACpB,YAAY,KAAK;IACjB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IAGnB,iBAAiB,KAAK;IACtB,uBAAuB,KAAK;IAC5B,YAAY,KAAK;IAGjB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,iBAAiB,KAAK;IACtB,YAAY,KAAK;IACjB,gBAAgB,KAAK;IACrB,qBAAqB,KAAK;IAC1B,oBAAoB,KAAK;IACzB,cAAc,KAAK;IAGnB,wBAAwB,KAAK;IAC7B,kBAAkB,KAAK;IACvB,YAAY,KAAK;IACjB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IACxB,cAAc,KAAK;IAGnB,eAAe,KAAK;IACpB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,iBAAiB,KAAK;IACtB,aAAa,KAAK;IAGlB,gBAAgB,KAAK;IACrB,sBAAsB,KAAK;IAC3B,sBAAsB,KAAK;IAC3B,uBAAuB,KAAK;IAC5B,mBAAmB,KAAK;IACxB,gBAAgB,KAAK;IACrB,aAAa,KAAK;IAClB,kBAAkB,KAAK;IAGvB,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,uBAAuB,KAAK;IAC5B,oBAAoB,KAAK;IACzB,iBAAiB,KAAK;IACtB,sBAAsB,KAAK;IAC3B,oBAAoB,KAAK;IACzB,kBAAkB,KAAK;IACvB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IAGnB,qBAAqB,KAAK;IAC1B,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,4BAA4B,KAAK;IACjC,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,0BAA0B,KAAK;IAC/B,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,wBAAwB,KAAK;IAG7B,yBAAyB,KAAK;IAC9B,mBAAmB,KAAK;IACxB,iBAAiB,KAAK;IACtB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IAGxB,iBAAiB,KAAK;IACtB,mBAAmB,KAAK;IACxB,mBAAmB,KAAK;IACxB,oBAAoB,KAAK;IACzB,sBAAsB,KAAK;IAG3B,OAAO,MAAM;IACb,cAAc,MAAM;IACpB,SAAS,MAAM;IACf,aAAa,MAAM;CACpB;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CA0BzD;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEtD"}

package/dist/exit-codes.js

@@ -0,0 +1,158 @@
+/**
+ * CLEO exit codes — canonical definitions shared across all layers.
+ *
+ * Ranges: 0 = success, 1-99 = errors, 100+ = special (non-error) states.
+ *
+ * @epic T4454
+ * @task T4456
+ * @task T5710
+ */
+export var ExitCode;
+(function (ExitCode) {
+    // === SUCCESS (0) ===
+    ExitCode[ExitCode["SUCCESS"] = 0] = "SUCCESS";
+    // === GENERAL ERRORS (1-9) ===
+    ExitCode[ExitCode["GENERAL_ERROR"] = 1] = "GENERAL_ERROR";
+    ExitCode[ExitCode["INVALID_INPUT"] = 2] = "INVALID_INPUT";
+    ExitCode[ExitCode["FILE_ERROR"] = 3] = "FILE_ERROR";
+    ExitCode[ExitCode["NOT_FOUND"] = 4] = "NOT_FOUND";
+    ExitCode[ExitCode["DEPENDENCY_ERROR"] = 5] = "DEPENDENCY_ERROR";
+    ExitCode[ExitCode["VALIDATION_ERROR"] = 6] = "VALIDATION_ERROR";
+    ExitCode[ExitCode["LOCK_TIMEOUT"] = 7] = "LOCK_TIMEOUT";
+    ExitCode[ExitCode["CONFIG_ERROR"] = 8] = "CONFIG_ERROR";
+    // === HIERARCHY ERRORS (10-19) ===
+    ExitCode[ExitCode["PARENT_NOT_FOUND"] = 10] = "PARENT_NOT_FOUND";
+    ExitCode[ExitCode["DEPTH_EXCEEDED"] = 11] = "DEPTH_EXCEEDED";
+    ExitCode[ExitCode["SIBLING_LIMIT"] = 12] = "SIBLING_LIMIT";
+    ExitCode[ExitCode["INVALID_PARENT_TYPE"] = 13] = "INVALID_PARENT_TYPE";
+    ExitCode[ExitCode["CIRCULAR_REFERENCE"] = 14] = "CIRCULAR_REFERENCE";
+    ExitCode[ExitCode["ORPHAN_DETECTED"] = 15] = "ORPHAN_DETECTED";
+    ExitCode[ExitCode["HAS_CHILDREN"] = 16] = "HAS_CHILDREN";
+    ExitCode[ExitCode["TASK_COMPLETED"] = 17] = "TASK_COMPLETED";
+    ExitCode[ExitCode["CASCADE_FAILED"] = 18] = "CASCADE_FAILED";
+    ExitCode[ExitCode["HAS_DEPENDENTS"] = 19] = "HAS_DEPENDENTS";
+    // === CONCURRENCY ERRORS (20-29) ===
+    ExitCode[ExitCode["CHECKSUM_MISMATCH"] = 20] = "CHECKSUM_MISMATCH";
+    ExitCode[ExitCode["CONCURRENT_MODIFICATION"] = 21] = "CONCURRENT_MODIFICATION";
+    ExitCode[ExitCode["ID_COLLISION"] = 22] = "ID_COLLISION";
+    // === SESSION ERRORS (30-39) ===
+    ExitCode[ExitCode["SESSION_EXISTS"] = 30] = "SESSION_EXISTS";
+    ExitCode[ExitCode["SESSION_NOT_FOUND"] = 31] = "SESSION_NOT_FOUND";
+    ExitCode[ExitCode["SCOPE_CONFLICT"] = 32] = "SCOPE_CONFLICT";
+    ExitCode[ExitCode["SCOPE_INVALID"] = 33] = "SCOPE_INVALID";
+    ExitCode[ExitCode["TASK_NOT_IN_SCOPE"] = 34] = "TASK_NOT_IN_SCOPE";
+    ExitCode[ExitCode["TASK_CLAIMED"] = 35] = "TASK_CLAIMED";
+    ExitCode[ExitCode["SESSION_REQUIRED"] = 36] = "SESSION_REQUIRED";
+    ExitCode[ExitCode["SESSION_CLOSE_BLOCKED"] = 37] = "SESSION_CLOSE_BLOCKED";
+    ExitCode[ExitCode["ACTIVE_TASK_REQUIRED"] = 38] = "ACTIVE_TASK_REQUIRED";
+    ExitCode[ExitCode["NOTES_REQUIRED"] = 39] = "NOTES_REQUIRED";
+    // === VERIFICATION ERRORS (40-47) ===
+    ExitCode[ExitCode["VERIFICATION_INIT_FAILED"] = 40] = "VERIFICATION_INIT_FAILED";
+    ExitCode[ExitCode["GATE_UPDATE_FAILED"] = 41] = "GATE_UPDATE_FAILED";
+    ExitCode[ExitCode["INVALID_GATE"] = 42] = "INVALID_GATE";
+    ExitCode[ExitCode["INVALID_AGENT"] = 43] = "INVALID_AGENT";
+    ExitCode[ExitCode["MAX_ROUNDS_EXCEEDED"] = 44] = "MAX_ROUNDS_EXCEEDED";
+    ExitCode[ExitCode["GATE_DEPENDENCY"] = 45] = "GATE_DEPENDENCY";
+    ExitCode[ExitCode["VERIFICATION_LOCKED"] = 46] = "VERIFICATION_LOCKED";
+    ExitCode[ExitCode["ROUND_MISMATCH"] = 47] = "ROUND_MISMATCH";
+    // === CONTEXT SAFEGUARD (50-54) ===
+    ExitCode[ExitCode["CONTEXT_WARNING"] = 50] = "CONTEXT_WARNING";
+    ExitCode[ExitCode["CONTEXT_CAUTION"] = 51] = "CONTEXT_CAUTION";
+    ExitCode[ExitCode["CONTEXT_CRITICAL"] = 52] = "CONTEXT_CRITICAL";
+    ExitCode[ExitCode["CONTEXT_EMERGENCY"] = 53] = "CONTEXT_EMERGENCY";
+    ExitCode[ExitCode["CONTEXT_STALE"] = 54] = "CONTEXT_STALE";
+    // === ORCHESTRATOR ERRORS (60-67) ===
+    ExitCode[ExitCode["PROTOCOL_MISSING"] = 60] = "PROTOCOL_MISSING";
+    ExitCode[ExitCode["INVALID_RETURN_MESSAGE"] = 61] = "INVALID_RETURN_MESSAGE";
+    ExitCode[ExitCode["MANIFEST_ENTRY_MISSING"] = 62] = "MANIFEST_ENTRY_MISSING";
+    ExitCode[ExitCode["SPAWN_VALIDATION_FAILED"] = 63] = "SPAWN_VALIDATION_FAILED";
+    ExitCode[ExitCode["AUTONOMOUS_BOUNDARY"] = 64] = "AUTONOMOUS_BOUNDARY";
+    ExitCode[ExitCode["HANDOFF_REQUIRED"] = 65] = "HANDOFF_REQUIRED";
+    ExitCode[ExitCode["RESUME_FAILED"] = 66] = "RESUME_FAILED";
+    ExitCode[ExitCode["CONCURRENT_SESSION"] = 67] = "CONCURRENT_SESSION";
+    // === NEXUS ERRORS (70-79) ===
+    ExitCode[ExitCode["NEXUS_NOT_INITIALIZED"] = 70] = "NEXUS_NOT_INITIALIZED";
+    ExitCode[ExitCode["NEXUS_PROJECT_NOT_FOUND"] = 71] = "NEXUS_PROJECT_NOT_FOUND";
+    ExitCode[ExitCode["NEXUS_PERMISSION_DENIED"] = 72] = "NEXUS_PERMISSION_DENIED";
+    ExitCode[ExitCode["NEXUS_INVALID_SYNTAX"] = 73] = "NEXUS_INVALID_SYNTAX";
+    ExitCode[ExitCode["NEXUS_SYNC_FAILED"] = 74] = "NEXUS_SYNC_FAILED";
+    ExitCode[ExitCode["NEXUS_REGISTRY_CORRUPT"] = 75] = "NEXUS_REGISTRY_CORRUPT";
+    ExitCode[ExitCode["NEXUS_PROJECT_EXISTS"] = 76] = "NEXUS_PROJECT_EXISTS";
+    ExitCode[ExitCode["NEXUS_QUERY_FAILED"] = 77] = "NEXUS_QUERY_FAILED";
+    ExitCode[ExitCode["NEXUS_GRAPH_ERROR"] = 78] = "NEXUS_GRAPH_ERROR";
+    ExitCode[ExitCode["NEXUS_RESERVED"] = 79] = "NEXUS_RESERVED";
+    // === LIFECYCLE ENFORCEMENT (80-84) ===
+    ExitCode[ExitCode["LIFECYCLE_GATE_FAILED"] = 80] = "LIFECYCLE_GATE_FAILED";
+    ExitCode[ExitCode["AUDIT_MISSING"] = 81] = "AUDIT_MISSING";
+    ExitCode[ExitCode["CIRCULAR_VALIDATION"] = 82] = "CIRCULAR_VALIDATION";
+    ExitCode[ExitCode["LIFECYCLE_TRANSITION_INVALID"] = 83] = "LIFECYCLE_TRANSITION_INVALID";
+    ExitCode[ExitCode["PROVENANCE_REQUIRED"] = 84] = "PROVENANCE_REQUIRED";
+    // === ARTIFACT PUBLISH (85-89) ===
+    ExitCode[ExitCode["ARTIFACT_TYPE_UNKNOWN"] = 85] = "ARTIFACT_TYPE_UNKNOWN";
+    ExitCode[ExitCode["ARTIFACT_VALIDATION_FAILED"] = 86] = "ARTIFACT_VALIDATION_FAILED";
+    ExitCode[ExitCode["ARTIFACT_BUILD_FAILED"] = 87] = "ARTIFACT_BUILD_FAILED";
+    ExitCode[ExitCode["ARTIFACT_PUBLISH_FAILED"] = 88] = "ARTIFACT_PUBLISH_FAILED";
+    ExitCode[ExitCode["ARTIFACT_ROLLBACK_FAILED"] = 89] = "ARTIFACT_ROLLBACK_FAILED";
+    // === PROVENANCE (90-94) ===
+    ExitCode[ExitCode["PROVENANCE_CONFIG_INVALID"] = 90] = "PROVENANCE_CONFIG_INVALID";
+    ExitCode[ExitCode["SIGNING_KEY_MISSING"] = 91] = "SIGNING_KEY_MISSING";
+    ExitCode[ExitCode["SIGNATURE_INVALID"] = 92] = "SIGNATURE_INVALID";
+    ExitCode[ExitCode["DIGEST_MISMATCH"] = 93] = "DIGEST_MISMATCH";
+    ExitCode[ExitCode["ATTESTATION_INVALID"] = 94] = "ATTESTATION_INVALID";
+    // === ADAPTER ERRORS (95-99) ===
+    ExitCode[ExitCode["ADAPTER_NOT_FOUND"] = 95] = "ADAPTER_NOT_FOUND";
+    ExitCode[ExitCode["ADAPTER_INIT_FAILED"] = 96] = "ADAPTER_INIT_FAILED";
+    ExitCode[ExitCode["ADAPTER_HOOK_FAILED"] = 97] = "ADAPTER_HOOK_FAILED";
+    ExitCode[ExitCode["ADAPTER_SPAWN_FAILED"] = 98] = "ADAPTER_SPAWN_FAILED";
+    ExitCode[ExitCode["ADAPTER_INSTALL_FAILED"] = 99] = "ADAPTER_INSTALL_FAILED";
+    // === SPECIAL CODES (100+) - NOT errors ===
+    ExitCode[ExitCode["NO_DATA"] = 100] = "NO_DATA";
+    ExitCode[ExitCode["ALREADY_EXISTS"] = 101] = "ALREADY_EXISTS";
+    ExitCode[ExitCode["NO_CHANGE"] = 102] = "NO_CHANGE";
+    ExitCode[ExitCode["TESTS_SKIPPED"] = 103] = "TESTS_SKIPPED";
+})(ExitCode || (ExitCode = {}));
+/** Check if an exit code represents an error (1-99). */
+export function isErrorCode(code) {
+    return code >= 1 && code < 100;
+}
+/** Check if an exit code represents success (0 or 100+). */
+export function isSuccessCode(code) {
+    return code === 0 || code >= 100;
+}
+/** Check if an exit code indicates no change (idempotent operation). */
+export function isNoChangeCode(code) {
+    return code === ExitCode.NO_CHANGE;
+}
+/** Check if an exit code is recoverable (retry may succeed). */
+export function isRecoverableCode(code) {
+    const nonRecoverable = new Set([
+        ExitCode.FILE_ERROR,
+        ExitCode.DEPENDENCY_ERROR,
+        ExitCode.CIRCULAR_REFERENCE,
+        ExitCode.CASCADE_FAILED,
+        ExitCode.SESSION_CLOSE_BLOCKED,
+        ExitCode.VERIFICATION_LOCKED,
+        ExitCode.CONTEXT_WARNING,
+        ExitCode.CONTEXT_CAUTION,
+        ExitCode.CONTEXT_CRITICAL,
+        ExitCode.CONTEXT_EMERGENCY,
+        ExitCode.CONTEXT_STALE,
+        ExitCode.AUTONOMOUS_BOUNDARY,
+        ExitCode.HANDOFF_REQUIRED,
+        ExitCode.NEXUS_PERMISSION_DENIED,
+        ExitCode.NEXUS_REGISTRY_CORRUPT,
+        ExitCode.CIRCULAR_VALIDATION,
+        ExitCode.LIFECYCLE_TRANSITION_INVALID,
+        ExitCode.ARTIFACT_TYPE_UNKNOWN,
+        ExitCode.ARTIFACT_ROLLBACK_FAILED,
+        ExitCode.DIGEST_MISMATCH,
+    ]);
+    if (!isErrorCode(code))
+        return false;
+    return !nonRecoverable.has(code);
+}
+/** Human-readable name for an exit code. */
+export function getExitCodeName(code) {
+    return ExitCode[code] ?? 'UNKNOWN';
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/exit-codes.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Hook provider interface for CLEO provider adapters.
+ * Maps provider-specific events to CAAMP hook events.
+ *
+ * @task T5240
+ */
+export interface AdapterHookProvider {
+    /** Map a provider-specific event name to a CAAMP hook event name, or null if unmapped. */
+    mapProviderEvent(providerEvent: string): string | null;
+    /** Register the provider's native hook mechanism for a project. */
+    registerNativeHooks(projectDir: string): Promise<void>;
+    /** Unregister all native hooks previously registered. */
+    unregisterNativeHooks(): Promise<void>;
+    /** Return the full event mapping for introspection. */
+    getEventMap?(): Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvD,mEAAmE;IACnE,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,yDAAyD;IACzD,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,uDAAuD;IACvD,WAAW,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD"}

package/dist/hooks.js

@@ -0,0 +1,8 @@
+/**
+ * Hook provider interface for CLEO provider adapters.
+ * Maps provider-specific events to CAAMP hook events.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @cleocode/contracts — Domain types, interfaces, and contracts for the CLEO ecosystem.
+ *
+ * This is the LEAF package in the dependency graph — ZERO runtime dependencies.
+ * All domain types (Task, Session, DataAccessor, etc.) are defined here.
+ * Implementation packages (@cleocode/core, @cleocode/cleo) import from here.
+ */
+export { TASK_STATUSES, SESSION_STATUSES, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, ADR_STATUSES, GATE_STATUSES, MANIFEST_STATUSES, type TaskStatus, type SessionStatus, type PipelineStatus, type StageStatus, type AdrStatus, type GateStatus, type ManifestStatus, TERMINAL_TASK_STATUSES, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES, type EntityType, STATUS_REGISTRY, isValidStatus, PIPELINE_STATUS_ICONS, STAGE_STATUS_ICONS, TASK_STATUS_SYMBOLS_UNICODE, TASK_STATUS_SYMBOLS_ASCII, } from './status-registry.js';
+export type { TaskPriority, TaskType, TaskSize, EpicLifecycle, TaskOrigin, VerificationAgent, VerificationGate, VerificationFailure, TaskVerification, TaskProvenance, TaskRelation, Task, TaskCreate, CompletedTask, CancelledTask, PhaseStatus, Phase, PhaseTransition, ReleaseStatus, Release, ProjectMeta, FileMeta, SessionNote, TaskWorkState, TaskFile, } from './task.js';
+export { SessionView } from './session.js';
+export type { SessionScope, SessionStats, SessionTaskWork, Session, } from './session.js';
+export { ExitCode, isErrorCode, isSuccessCode, isNoChangeCode, isRecoverableCode, getExitCodeName, } from './exit-codes.js';
+export type { OutputFormat, DateFormat, OutputConfig, BackupConfig, EnforcementProfile, HierarchyConfig, SessionConfig, LogLevel, LoggingConfig, LifecycleEnforcementMode, LifecycleConfig, SharingMode, SharingConfig, SignalDockMode, SignalDockConfig, CleoConfig, ConfigSource, ResolvedValue, } from './config.js';
+export { isLafsSuccess, isLafsError, isGatewayEnvelope, } from './lafs.js';
+export type { LAFSErrorCategory, LAFSError, Warning, LAFSTransport, MVILevel, LAFSPageNone, LAFSPageOffset, LAFSPage, LAFSMeta, LAFSEnvelope, FlagInput, ConformanceReport, LafsAlternative, LafsErrorDetail, LafsSuccess, LafsError, LafsEnvelope, GatewayMeta, GatewaySuccess, GatewayError, GatewayEnvelope, CleoResponse, } from './lafs.js';
+export type { ArchiveFields, ArchiveFile, TaskQueryFilters, QueryTasksResult, TaskFieldUpdates, TransactionAccessor, DataAccessor, } from './data-accessor.js';
+export type { CLEOProviderAdapter, AdapterHealthStatus } from './adapter.js';
+export type { AdapterCapabilities } from './capabilities.js';
+export type { AdapterManifest, DetectionPattern } from './discovery.js';
+export type { AdapterHookProvider } from './hooks.js';
+export type { AdapterInstallProvider, InstallOptions, InstallResult } from './install.js';
+export type { MemoryBridgeConfig, MemoryBridgeContent, SessionSummary, BridgeLearning, BridgePattern, BridgeDecision, BridgeObservation, } from './memory.js';
+export type { AdapterSpawnProvider, SpawnContext, SpawnResult } from './spawn.js';
+export type { AdapterPathProvider } from './provider-paths.js';
+export type { AdapterContextMonitorProvider } from './context-monitor.js';
+export type { AdapterTransportProvider } from './transport.js';
+export type { Provider, CAAMPSpawnOptions, CAAMPSpawnResult, CLEOSpawnContext, CLEOSpawnResult, CLEOSpawnAdapter, TokenResolution, SpawnStatus, } from './spawn-types.js';
+export type { ProtocolType, GateName, WarpStage, WarpLink, ChainShape, GateCheck, GateContract, WarpChain, ChainValidation, WarpChainInstance, GateResult, WarpChainExecution, } from './warp-chain.js';
+export type { TesseraVariable, TesseraTemplate, TesseraInstantiationInput, } from './tessera.js';
+export type { ArchiveMetadata, ArchivedTask, ArchiveReportType, ArchiveSummaryReport, ArchivePhaseEntry, ArchiveLabelEntry, ArchivePriorityEntry, CycleTimeDistribution, CycleTimePercentiles, ArchiveCycleTimesReport, ArchiveDailyTrend, ArchiveMonthlyTrend, ArchiveTrendsReport, ArchiveStatsEnvelope, } from './archive.js';
+export type { TodoWriteItemStatus, TodoWriteItem, TodoWriteState, TodoWriteSyncSessionState, TodoWriteChangeSet, TodoWriteChangeAction, TodoWriteChange, TodoWriteMergeResult, } from './todowrite.js';
+export type { ExternalTaskStatus, ExternalTask, SyncSessionState, ConflictPolicy, ReconcileOptions, ReconcileActionType, ReconcileAction, ReconcileResult, AdapterTaskSyncProvider, } from './task-sync.js';
+export type { TaskSummary, LabelCount, DashboardResult, StatsCurrentState, StatsCompletionMetrics, StatsActivityMetrics, StatsAllTime, StatsCycleTimes, StatsResult, LogQueryResult, ContextResult, SequenceResult, TaskRef, TaskRefPriority, LeveragedTask, BottleneckTask, TaskAnalysisResult, TaskDepsResult, CompleteTaskUnblocked, } from './results.js';
+export type { BrainEntryRef, BrainEntrySummary, ContradictionDetail, SupersededEntry, } from './brain.js';
+export type { TaskRecordRelation, ValidationHistoryEntry, TaskRecord, MinimalTaskRecord, } from './task-record.js';
+export type { SessionStartResult } from './session.js';
+export * as ops from './operations/index.js';
+export type { BrainState } from './operations/orchestrate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @cleocode/contracts — Domain types, interfaces, and contracts for the CLEO ecosystem.
+ *
+ * This is the LEAF package in the dependency graph — ZERO runtime dependencies.
+ * All domain types (Task, Session, DataAccessor, etc.) are defined here.
+ * Implementation packages (@cleocode/core, @cleocode/cleo) import from here.
+ */
+// === Status Registry (MUST be first — everything depends on this) ===
+export { 
+// Constants
+TASK_STATUSES, SESSION_STATUSES, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, ADR_STATUSES, GATE_STATUSES, MANIFEST_STATUSES, 
+// Terminal state sets
+TERMINAL_TASK_STATUSES, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES, STATUS_REGISTRY, isValidStatus, 
+// Display icons
+PIPELINE_STATUS_ICONS, STAGE_STATUS_ICONS, TASK_STATUS_SYMBOLS_UNICODE, TASK_STATUS_SYMBOLS_ASCII, } from './status-registry.js';
+// === Session Types ===
+export { SessionView } from './session.js';
+// === Exit Codes ===
+export { ExitCode, isErrorCode, isSuccessCode, isNoChangeCode, isRecoverableCode, getExitCodeName, } from './exit-codes.js';
+// === LAFS Envelope Types ===
+export { isLafsSuccess, isLafsError, isGatewayEnvelope, } from './lafs.js';
+// === Operations Types (API wire format, namespaced to avoid collision with domain types) ===
+export * as ops from './operations/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uEAAuE;AACvE,OAAO;AACL,YAAY;AACZ,aAAa,EACb,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,iBAAiB;AASjB,sBAAsB;AACtB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EAGvB,eAAe,EACf,aAAa;AACb,gBAAgB;AAChB,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AA+B9B,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQ3C,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAwBzB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAiLnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Install provider interface for CLEO provider adapters.
+ * Handles registration with the provider and instruction file references.
+ *
+ * @task T5240
+ */
+export interface AdapterInstallProvider {
+    install(options: InstallOptions): Promise<InstallResult>;
+    uninstall(): Promise<void>;
+    isInstalled(): Promise<boolean>;
+    /** Ensure the provider's instruction file references CLEO (e.g. @AGENTS.md in CLAUDE.md). */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+}
+export interface InstallOptions {
+    projectDir: string;
+    global?: boolean;
+    mcpServerPath?: string;
+}
+export interface InstallResult {
+    success: boolean;
+    installedAt: string;
+    instructionFileUpdated: boolean;
+    mcpRegistered: boolean;
+    details?: Record<string, unknown>;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,6FAA6F;IAC7F,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/install.js

@@ -0,0 +1,8 @@
+/**
+ * Install provider interface for CLEO provider adapters.
+ * Handles registration with the provider and instruction file references.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/lafs.d.ts

@@ -0,0 +1,132 @@
+/**
+ * LAFS (LLM-Agent-First Schema) unified envelope types.
+ *
+ * Defines canonical LAFS types inline (contracts has ZERO external dependencies).
+ * In the main CLEO codebase these are re-exported from @cleocode/lafs-protocol;
+ * here they are defined as plain interfaces for maximum portability.
+ *
+ * @epic T4654
+ * @task T4655
+ */
+/** LAFS error category. */
+export type LAFSErrorCategory = 'validation' | 'not_found' | 'conflict' | 'authorization' | 'internal' | 'rate_limit' | 'timeout' | 'dependency';
+/** LAFS error object. */
+export interface LAFSError {
+    code: number | string;
+    category: LAFSErrorCategory;
+    message: string;
+    fix?: string;
+    details?: Record<string, unknown>;
+}
+/** LAFS warning. */
+export interface Warning {
+    code: string;
+    message: string;
+}
+/** LAFS transport metadata. */
+export type LAFSTransport = 'mcp' | 'cli' | 'http' | 'sdk';
+/** MVI (Minimal Viable Information) level. */
+export type MVILevel = 'minimal' | 'standard' | 'full';
+/** LAFS page — no pagination. */
+export interface LAFSPageNone {
+    strategy: 'none';
+}
+/** LAFS page — offset-based pagination. */
+export interface LAFSPageOffset {
+    strategy: 'offset';
+    offset: number;
+    limit: number;
+    total: number;
+    hasMore: boolean;
+}
+/** LAFS page union. */
+export type LAFSPage = LAFSPageNone | LAFSPageOffset;
+/** LAFS metadata block. */
+export interface LAFSMeta {
+    transport: LAFSTransport;
+    mvi: MVILevel;
+    page?: LAFSPage;
+    warnings?: Warning[];
+    durationMs?: number;
+}
+/** LAFS envelope (canonical protocol type). */
+export interface LAFSEnvelope<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: LAFSError;
+    _meta?: LAFSMeta;
+}
+/** Flag input for conformance checks. */
+export interface FlagInput {
+    flag: string;
+    value: unknown;
+}
+/** Conformance report. */
+export interface ConformanceReport {
+    valid: boolean;
+    violations: string[];
+    warnings: string[];
+}
+/** Actionable alternative the caller can try. */
+export interface LafsAlternative {
+    action: string;
+    command: string;
+}
+/** LAFS error detail shared between CLI and MCP. */
+export interface LafsErrorDetail {
+    code: number | string;
+    name?: string;
+    message: string;
+    fix?: string;
+    alternatives?: LafsAlternative[];
+    details?: Record<string, unknown>;
+}
+/** LAFS success envelope (CLI). */
+export interface LafsSuccess<T = unknown> {
+    success: true;
+    data: T;
+    message?: string;
+    noChange?: boolean;
+}
+/** LAFS error envelope (CLI). */
+export interface LafsError {
+    success: false;
+    error: LafsErrorDetail;
+}
+/** CLI envelope union type. */
+export type LafsEnvelope<T = unknown> = LafsSuccess<T> | LafsError;
+/**
+ * Metadata attached to every MCP gateway response.
+ * Extends the canonical LAFSMeta with CLEO gateway-specific fields.
+ *
+ * @task T4655
+ */
+export interface GatewayMeta extends LAFSMeta {
+    gateway: string;
+    domain: string;
+    duration_ms: number;
+}
+/** MCP success envelope (extends CLI base with _meta). */
+export interface GatewaySuccess<T = unknown> extends LafsSuccess<T> {
+    _meta: GatewayMeta;
+}
+/** MCP error envelope (extends CLI base with _meta). */
+export interface GatewayError extends LafsError {
+    _meta: GatewayMeta;
+}
+/** MCP envelope union type. */
+export type GatewayEnvelope<T = unknown> = GatewaySuccess<T> | GatewayError;
+/**
+ * Unified CLEO response envelope.
+ *
+ * Every CLEO response (CLI or MCP) is a CleoResponse. MCP responses include
+ * the _meta field; CLI responses do not.
+ */
+export type CleoResponse<T = unknown> = LafsEnvelope<T> | GatewayEnvelope<T>;
+/** Type guard for success responses. */
+export declare function isLafsSuccess<T>(envelope: LafsEnvelope<T>): envelope is LafsSuccess<T>;
+/** Type guard for error responses. */
+export declare function isLafsError<T>(envelope: LafsEnvelope<T>): envelope is LafsError;
+/** Type guard for MCP gateway responses (has _meta). */
+export declare function isGatewayEnvelope<T>(envelope: CleoResponse<T>): envelope is GatewayEnvelope<T>;
+//# sourceMappingURL=lafs.d.ts.map

package/dist/lafs.d.ts.map

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