@cleocode/cleo 2026.2.5

package/dist/core/error-registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * CLEO error code to LAFS canonical error code mapping.
+ *
+ * Maps CLEO's numeric exit codes (ExitCode enum) to LAFS error registry
+ * string codes for protocol conformance.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
+import { ExitCode } from '../types/exit-codes.js';
+/**
+ * Entry in the CLEO-to-LAFS error registry.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export interface CleoRegistryEntry {
+    exitCode: ExitCode;
+    lafsCode: string;
+    category: LAFSErrorCategory;
+    description: string;
+    retryable: boolean;
+    httpStatus: number;
+}
+/**
+ * Look up a registry entry by CLEO exit code.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function getRegistryEntry(exitCode: ExitCode): CleoRegistryEntry | undefined;
+/**
+ * Look up a registry entry by LAFS string code.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function getRegistryEntryByLafsCode(lafsCode: string): CleoRegistryEntry | undefined;
+/**
+ * Get the full CLEO error registry for conformance testing.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function getCleoErrorRegistry(): CleoRegistryEntry[];
+/**
+ * Check if a LAFS code is registered in the CLEO error registry.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function isCleoRegisteredCode(lafsCode: string): boolean;
+//# sourceMappingURL=error-registry.d.ts.map

package/dist/core/error-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-registry.d.ts","sourceRoot":"","sources":["../../src/core/error-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAwED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/core/error-registry.js

@@ -0,0 +1,109 @@
+/**
+ * CLEO error code to LAFS canonical error code mapping.
+ *
+ * Maps CLEO's numeric exit codes (ExitCode enum) to LAFS error registry
+ * string codes for protocol conformance.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+import { ExitCode } from '../types/exit-codes.js';
+/**
+ * Complete mapping of CLEO exit codes to LAFS canonical error codes.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+const CLEO_ERROR_REGISTRY = [
+    // General errors (1-9)
+    { exitCode: ExitCode.GENERAL_ERROR, lafsCode: 'E_CLEO_GENERAL', category: 'INTERNAL', description: 'General error', retryable: true, httpStatus: 500 },
+    { exitCode: ExitCode.INVALID_INPUT, lafsCode: 'E_CLEO_INVALID_INPUT', category: 'VALIDATION', description: 'Invalid input', retryable: false, httpStatus: 400 },
+    { exitCode: ExitCode.FILE_ERROR, lafsCode: 'E_CLEO_FILE_ERROR', category: 'INTERNAL', description: 'File system error', retryable: false, httpStatus: 500 },
+    { exitCode: ExitCode.NOT_FOUND, lafsCode: 'E_CLEO_NOT_FOUND', category: 'NOT_FOUND', description: 'Task or resource not found', retryable: false, httpStatus: 404 },
+    { exitCode: ExitCode.DEPENDENCY_ERROR, lafsCode: 'E_CLEO_DEPENDENCY', category: 'VALIDATION', description: 'Dependency error', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.VALIDATION_ERROR, lafsCode: 'E_CLEO_VALIDATION', category: 'VALIDATION', description: 'Validation error', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.LOCK_TIMEOUT, lafsCode: 'E_CLEO_LOCK_TIMEOUT', category: 'CONFLICT', description: 'File lock timeout', retryable: true, httpStatus: 409 },
+    { exitCode: ExitCode.CONFIG_ERROR, lafsCode: 'E_CLEO_CONFIG', category: 'VALIDATION', description: 'Configuration error', retryable: false, httpStatus: 422 },
+    // Hierarchy errors (10-19)
+    { exitCode: ExitCode.PARENT_NOT_FOUND, lafsCode: 'E_CLEO_PARENT_NOT_FOUND', category: 'NOT_FOUND', description: 'Parent task not found', retryable: false, httpStatus: 404 },
+    { exitCode: ExitCode.DEPTH_EXCEEDED, lafsCode: 'E_CLEO_DEPTH_EXCEEDED', category: 'VALIDATION', description: 'Max hierarchy depth exceeded', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.SIBLING_LIMIT, lafsCode: 'E_CLEO_SIBLING_LIMIT', category: 'VALIDATION', description: 'Max sibling count exceeded', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.INVALID_PARENT_TYPE, lafsCode: 'E_CLEO_INVALID_PARENT_TYPE', category: 'VALIDATION', description: 'Invalid parent task type', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.CIRCULAR_REFERENCE, lafsCode: 'E_CLEO_CIRCULAR_REF', category: 'VALIDATION', description: 'Circular dependency detected', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.ORPHAN_DETECTED, lafsCode: 'E_CLEO_ORPHAN', category: 'VALIDATION', description: 'Orphan task detected', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.HAS_CHILDREN, lafsCode: 'E_CLEO_HAS_CHILDREN', category: 'CONFLICT', description: 'Task has children', retryable: false, httpStatus: 409 },
+    { exitCode: ExitCode.TASK_COMPLETED, lafsCode: 'E_CLEO_TASK_COMPLETED', category: 'CONFLICT', description: 'Task already completed', retryable: false, httpStatus: 409 },
+    { exitCode: ExitCode.CASCADE_FAILED, lafsCode: 'E_CLEO_CASCADE_FAILED', category: 'INTERNAL', description: 'Cascade operation failed', retryable: false, httpStatus: 500 },
+    { exitCode: ExitCode.HAS_DEPENDENTS, lafsCode: 'E_CLEO_HAS_DEPENDENTS', category: 'CONFLICT', description: 'Task has dependents', retryable: false, httpStatus: 409 },
+    // Concurrency errors (20-29)
+    { exitCode: ExitCode.CHECKSUM_MISMATCH, lafsCode: 'E_CLEO_CHECKSUM_MISMATCH', category: 'CONFLICT', description: 'Checksum mismatch', retryable: true, httpStatus: 409 },
+    { exitCode: ExitCode.CONCURRENT_MODIFICATION, lafsCode: 'E_CLEO_CONCURRENT_MOD', category: 'CONFLICT', description: 'Concurrent modification', retryable: true, httpStatus: 409 },
+    { exitCode: ExitCode.ID_COLLISION, lafsCode: 'E_CLEO_ID_COLLISION', category: 'CONFLICT', description: 'ID collision', retryable: true, httpStatus: 409 },
+    // Session errors (30-39)
+    { exitCode: ExitCode.SESSION_EXISTS, lafsCode: 'E_CLEO_SESSION_EXISTS', category: 'CONFLICT', description: 'Session already exists', retryable: false, httpStatus: 409 },
+    { exitCode: ExitCode.SESSION_NOT_FOUND, lafsCode: 'E_CLEO_SESSION_NOT_FOUND', category: 'NOT_FOUND', description: 'Session not found', retryable: false, httpStatus: 404 },
+    { exitCode: ExitCode.SCOPE_CONFLICT, lafsCode: 'E_CLEO_SCOPE_CONFLICT', category: 'CONFLICT', description: 'Session scope conflict', retryable: false, httpStatus: 409 },
+    { exitCode: ExitCode.SCOPE_INVALID, lafsCode: 'E_CLEO_SCOPE_INVALID', category: 'VALIDATION', description: 'Invalid scope', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.TASK_NOT_IN_SCOPE, lafsCode: 'E_CLEO_TASK_NOT_IN_SCOPE', category: 'VALIDATION', description: 'Task not in session scope', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.TASK_CLAIMED, lafsCode: 'E_CLEO_TASK_CLAIMED', category: 'CONFLICT', description: 'Task claimed by another session', retryable: false, httpStatus: 409 },
+    { exitCode: ExitCode.SESSION_REQUIRED, lafsCode: 'E_CLEO_SESSION_REQUIRED', category: 'CONTRACT', description: 'Active session required', retryable: false, httpStatus: 428 },
+    { exitCode: ExitCode.SESSION_CLOSE_BLOCKED, lafsCode: 'E_CLEO_SESSION_CLOSE_BLOCKED', category: 'CONFLICT', description: 'Session close blocked', retryable: false, httpStatus: 409 },
+    { exitCode: ExitCode.FOCUS_REQUIRED, lafsCode: 'E_CLEO_FOCUS_REQUIRED', category: 'CONTRACT', description: 'Focus task required', retryable: false, httpStatus: 428 },
+    { exitCode: ExitCode.NOTES_REQUIRED, lafsCode: 'E_CLEO_NOTES_REQUIRED', category: 'VALIDATION', description: 'Notes required', retryable: false, httpStatus: 422 },
+    // Orchestrator errors (60-67)
+    { exitCode: ExitCode.PROTOCOL_MISSING, lafsCode: 'E_CLEO_PROTOCOL_MISSING', category: 'CONTRACT', description: 'Protocol missing', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.INVALID_RETURN_MESSAGE, lafsCode: 'E_CLEO_INVALID_RETURN', category: 'CONTRACT', description: 'Invalid return message', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.MANIFEST_ENTRY_MISSING, lafsCode: 'E_CLEO_MANIFEST_MISSING', category: 'CONTRACT', description: 'Manifest entry missing', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.SPAWN_VALIDATION_FAILED, lafsCode: 'E_CLEO_SPAWN_FAILED', category: 'VALIDATION', description: 'Spawn validation failed', retryable: true, httpStatus: 422 },
+    { exitCode: ExitCode.AUTONOMOUS_BOUNDARY, lafsCode: 'E_CLEO_AUTONOMOUS_BOUNDARY', category: 'CONTRACT', description: 'Autonomous boundary reached', retryable: false, httpStatus: 403 },
+    { exitCode: ExitCode.HANDOFF_REQUIRED, lafsCode: 'E_CLEO_HANDOFF_REQUIRED', category: 'CONTRACT', description: 'Human handoff required', retryable: false, httpStatus: 403 },
+    // Lifecycle errors (80-84)
+    { exitCode: ExitCode.LIFECYCLE_GATE_FAILED, lafsCode: 'E_CLEO_LIFECYCLE_GATE', category: 'CONTRACT', description: 'Lifecycle gate failed', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.AUDIT_MISSING, lafsCode: 'E_CLEO_AUDIT_MISSING', category: 'CONTRACT', description: 'Audit trail missing', retryable: false, httpStatus: 422 },
+    { exitCode: ExitCode.LIFECYCLE_TRANSITION_INVALID, lafsCode: 'E_CLEO_LIFECYCLE_INVALID', category: 'CONTRACT', description: 'Invalid lifecycle transition', retryable: false, httpStatus: 422 },
+];
+/** Lookup by exit code number. */
+const byExitCode = new Map();
+/** Lookup by LAFS string code. */
+const byLafsCode = new Map();
+for (const entry of CLEO_ERROR_REGISTRY) {
+    byExitCode.set(entry.exitCode, entry);
+    byLafsCode.set(entry.lafsCode, entry);
+}
+/**
+ * Look up a registry entry by CLEO exit code.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export function getRegistryEntry(exitCode) {
+    return byExitCode.get(exitCode);
+}
+/**
+ * Look up a registry entry by LAFS string code.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export function getRegistryEntryByLafsCode(lafsCode) {
+    return byLafsCode.get(lafsCode);
+}
+/**
+ * Get the full CLEO error registry for conformance testing.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export function getCleoErrorRegistry() {
+    return [...CLEO_ERROR_REGISTRY];
+}
+/**
+ * Check if a LAFS code is registered in the CLEO error registry.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export function isCleoRegisteredCode(lafsCode) {
+    return byLafsCode.has(lafsCode);
+}
+//# sourceMappingURL=error-registry.js.map

package/dist/core/error-registry.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLEO error types with exit code integration and LAFS error shape.
+ *
+ * @epic T4654
+ * @task T4655
+ */
+import type { LAFSError } from '@cleocode/lafs-protocol';
+import { ExitCode } from '../types/exit-codes.js';
+/**
+ * Structured error class for CLEO operations.
+ * Carries an exit code, human-readable message, and optional fix suggestions.
+ * Produces LAFS-conformant error shapes via toLAFSError().
+ */
+export declare class CleoError extends Error {
+    readonly code: ExitCode;
+    readonly fix?: string;
+    readonly alternatives?: Array<{
+        action: string;
+        command: string;
+    }>;
+    constructor(code: ExitCode, message: string, options?: {
+        fix?: string;
+        alternatives?: Array<{
+            action: string;
+            command: string;
+        }>;
+        cause?: unknown;
+    });
+    /**
+     * Produce a LAFS-conformant error object.
+     *
+     * @task T4655
+     */
+    toLAFSError(): LAFSError;
+    /** Structured JSON representation for LAFS output (backward compatible). */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAsC,MAAM,wBAAwB,CAAC;AAyCtF;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAGjE,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;IASH;;;;OAIG;IACH,WAAW,IAAI,SAAS;IAgBxB,4EAA4E;IAC5E,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYlC"}

package/dist/core/errors.js

@@ -0,0 +1,105 @@
+/**
+ * CLEO error types with exit code integration and LAFS error shape.
+ *
+ * @epic T4654
+ * @task T4655
+ */
+import { ExitCode, getExitCodeName, isRecoverableCode } from '../types/exit-codes.js';
+/**
+ * Map numeric exit codes to LAFS error category.
+ *
+ * @task T4655
+ */
+function exitCodeToCategory(code) {
+    if (code >= 1 && code <= 9) {
+        switch (code) {
+            case ExitCode.NOT_FOUND: return 'NOT_FOUND';
+            case ExitCode.VALIDATION_ERROR: return 'VALIDATION';
+            case ExitCode.CONFIG_ERROR: return 'VALIDATION';
+            case ExitCode.LOCK_TIMEOUT: return 'CONFLICT';
+            default: return 'INTERNAL';
+        }
+    }
+    if (code >= 10 && code <= 19)
+        return 'VALIDATION'; // hierarchy
+    if (code >= 20 && code <= 29)
+        return 'CONFLICT'; // concurrency
+    if (code >= 30 && code <= 39)
+        return 'CONTRACT'; // session
+    if (code >= 40 && code <= 47)
+        return 'VALIDATION'; // verification
+    if (code >= 50 && code <= 54)
+        return 'CONTRACT'; // context safeguard
+    if (code >= 60 && code <= 67)
+        return 'CONTRACT'; // orchestrator
+    if (code >= 70 && code <= 79)
+        return 'INTERNAL'; // nexus
+    if (code >= 80 && code <= 84)
+        return 'CONTRACT'; // lifecycle
+    if (code >= 85 && code <= 89)
+        return 'VALIDATION'; // artifact
+    if (code >= 90 && code <= 94)
+        return 'VALIDATION'; // provenance
+    return 'INTERNAL';
+}
+/**
+ * Map numeric exit code to LAFS string error code (E_CATEGORY_DETAIL).
+ *
+ * @task T4655
+ */
+function exitCodeToLafsCode(code) {
+    const name = getExitCodeName(code);
+    const category = exitCodeToCategory(code);
+    return `E_${category}_${name}`;
+}
+/**
+ * Structured error class for CLEO operations.
+ * Carries an exit code, human-readable message, and optional fix suggestions.
+ * Produces LAFS-conformant error shapes via toLAFSError().
+ */
+export class CleoError extends Error {
+    code;
+    fix;
+    alternatives;
+    constructor(code, message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'CleoError';
+        this.code = code;
+        this.fix = options?.fix;
+        this.alternatives = options?.alternatives;
+    }
+    /**
+     * Produce a LAFS-conformant error object.
+     *
+     * @task T4655
+     */
+    toLAFSError() {
+        return {
+            code: exitCodeToLafsCode(this.code),
+            message: this.message,
+            category: exitCodeToCategory(this.code),
+            retryable: isRecoverableCode(this.code),
+            retryAfterMs: null,
+            details: {
+                exitCode: this.code,
+                name: getExitCodeName(this.code),
+                ...(this.fix && { fix: this.fix }),
+                ...(this.alternatives && { alternatives: this.alternatives }),
+            },
+        };
+    }
+    /** Structured JSON representation for LAFS output (backward compatible). */
+    toJSON() {
+        return {
+            success: false,
+            error: {
+                code: this.code,
+                name: getExitCodeName(this.code),
+                message: this.message,
+                ...(this.fix && { fix: this.fix }),
+                ...(this.alternatives && { alternatives: this.alternatives }),
+            },
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/focus/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Focus management operations.
+ * @task T4462
+ * @epic T4454
+ */
+/** Result of getting focus. */
+export interface FocusShowResult {
+    currentTask: string | null;
+    currentPhase: string | null;
+    sessionNote: string | null;
+    nextAction: string | null;
+}
+/** Result of focus set. */
+export interface FocusSetResult {
+    taskId: string;
+    taskTitle: string;
+    previousTask: string | null;
+}
+/** Focus history entry. */
+export interface FocusHistoryEntry {
+    taskId: string;
+    timestamp: string;
+}
+/**
+ * Show current focus state.
+ * @task T4462
+ */
+export declare function showFocus(cwd?: string): Promise<FocusShowResult>;
+/**
+ * Set focus to a specific task.
+ * @task T4462
+ */
+export declare function setFocus(taskId: string, cwd?: string): Promise<FocusSetResult>;
+/**
+ * Clear current focus.
+ * @task T4462
+ */
+export declare function clearFocus(cwd?: string): Promise<{
+    previousTask: string | null;
+}>;
+/**
+ * Get focus history from session notes.
+ * @task T4462
+ */
+export declare function getFocusHistory(cwd?: string): Promise<FocusHistoryEntry[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/focus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/focus/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAYtE;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAyDpF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA2BvF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkBhF"}

package/dist/core/focus/index.js

@@ -0,0 +1,118 @@
+/**
+ * Focus management operations.
+ * @task T4462
+ * @epic T4454
+ */
+import { readJsonRequired, saveJson, computeChecksum } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getTodoPath, getLogPath, getBackupDir } from '../paths.js';
+import { logOperation } from '../tasks/add.js';
+/**
+ * Show current focus state.
+ * @task T4462
+ */
+export async function showFocus(cwd) {
+    const todoPath = getTodoPath(cwd);
+    const data = await readJsonRequired(todoPath);
+    const focus = data.focus ?? {};
+    return {
+        currentTask: focus.currentTask ?? null,
+        currentPhase: focus.currentPhase ?? null,
+        sessionNote: focus.sessionNote ?? null,
+        nextAction: focus.nextAction ?? null,
+    };
+}
+/**
+ * Set focus to a specific task.
+ * @task T4462
+ */
+export async function setFocus(taskId, cwd) {
+    if (!taskId) {
+        throw new CleoError(ExitCode.INVALID_INPUT, 'Task ID is required');
+    }
+    const todoPath = getTodoPath(cwd);
+    const logPath = getLogPath(cwd);
+    const backupDir = getBackupDir(cwd);
+    const data = await readJsonRequired(todoPath);
+    // Verify task exists
+    const task = data.tasks.find(t => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task not found: ${taskId}`, { fix: `Use 'cleo find "${taskId}"' to search` });
+    }
+    const previousTask = data.focus?.currentTask ?? null;
+    // Update focus
+    if (!data.focus) {
+        data.focus = {};
+    }
+    data.focus.currentTask = taskId;
+    data.focus.currentPhase = task.phase ?? null;
+    // Add to session notes for focus history tracking
+    const noteEntry = {
+        note: `Focus set to ${taskId}: ${task.title}`,
+        timestamp: new Date().toISOString(),
+    };
+    if (!data.focus.sessionNotes) {
+        data.focus.sessionNotes = [];
+    }
+    data.focus.sessionNotes.push(noteEntry);
+    // Update metadata
+    const now = new Date().toISOString();
+    data._meta.checksum = computeChecksum(data.tasks);
+    data.lastUpdated = now;
+    await saveJson(todoPath, data, { backupDir });
+    await logOperation(logPath, 'focus_set', taskId, {
+        previousTask,
+        title: task.title,
+    });
+    return {
+        taskId,
+        taskTitle: task.title,
+        previousTask,
+    };
+}
+/**
+ * Clear current focus.
+ * @task T4462
+ */
+export async function clearFocus(cwd) {
+    const todoPath = getTodoPath(cwd);
+    const logPath = getLogPath(cwd);
+    const backupDir = getBackupDir(cwd);
+    const data = await readJsonRequired(todoPath);
+    const previousTask = data.focus?.currentTask ?? null;
+    if (!data.focus) {
+        return { previousTask: null };
+    }
+    data.focus.currentTask = null;
+    data.focus.nextAction = null;
+    const now = new Date().toISOString();
+    data._meta.checksum = computeChecksum(data.tasks);
+    data.lastUpdated = now;
+    await saveJson(todoPath, data, { backupDir });
+    await logOperation(logPath, 'focus_cleared', previousTask ?? 'none', {
+        previousTask,
+    });
+    return { previousTask };
+}
+/**
+ * Get focus history from session notes.
+ * @task T4462
+ */
+export async function getFocusHistory(cwd) {
+    const todoPath = getTodoPath(cwd);
+    const data = await readJsonRequired(todoPath);
+    const notes = data.focus?.sessionNotes ?? [];
+    const history = [];
+    for (const note of notes) {
+        const match = note.note.match(/^Focus set to (T\d+)/);
+        if (match) {
+            history.push({
+                taskId: match[1],
+                timestamp: note.timestamp,
+            });
+        }
+    }
+    return history.reverse(); // Most recent first
+}
+//# sourceMappingURL=index.js.map

package/dist/core/focus/index.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLEO V2 core module exports.
+ * @epic T4454
+ * @task T4458
+ */
+export { CleoError } from './errors.js';
+export { formatOutput, formatSuccess, formatError } from './output.js';
+export type { LafsSuccess, LafsError, LafsEnvelope } from './output.js';
+export type { LafsAlternative, LafsErrorDetail, GatewayMeta, GatewaySuccess, GatewayError, GatewayEnvelope, CleoResponse, } from '../types/lafs.js';
+export { isLafsSuccess, isLafsError, isGatewayEnvelope } from '../types/lafs.js';
+export { getCleoHome, getCleoDir, getCleoDirAbsolute, getProjectRoot, resolveProjectPath, getTodoPath, getConfigPath, getSessionsPath, getArchivePath, getLogPath, getBackupDir, getGlobalConfigPath, isAbsolutePath, } from './paths.js';
+export { loadConfig, getConfigValue } from './config.js';
+export { validateAgainstSchema, validateAgainstSchemaFile, checkSchema } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EACL,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,12 @@
+/**
+ * CLEO V2 core module exports.
+ * @epic T4454
+ * @task T4458
+ */
+export { CleoError } from './errors.js';
+export { formatOutput, formatSuccess, formatError } from './output.js';
+export { isLafsSuccess, isLafsError, isGatewayEnvelope } from '../types/lafs.js';
+export { getCleoHome, getCleoDir, getCleoDirAbsolute, getProjectRoot, resolveProjectPath, getTodoPath, getConfigPath, getSessionsPath, getArchivePath, getLogPath, getBackupDir, getGlobalConfigPath, isAbsolutePath, } from './paths.js';
+export { loadConfig, getConfigValue } from './config.js';
+export { validateAgainstSchema, validateAgainstSchemaFile, checkSchema } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAWvE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EACL,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/init.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Core init logic - project initialization and maintenance.
+ *
+ * Single source of truth for all init operations. Both CLI and MCP
+ * delegate here (shared-core pattern).
+ *
+ * Handles:
+ *   1. .cleo/ directory structure creation
+ *   2. Core data files (todo.json, config.json, sessions.json, etc.)
+ *   3. Schema file installation (.cleo/schemas/)
+ *   4. Sequence counter (.cleo/.sequence)
+ *   5. Project info (.cleo/project-info.json)
+ *   6. CAAMP injection into agent instruction files
+ *   7. MCP server installation to detected providers
+ *   8. Agent definition installation (cleo-subagent)
+ *   9. Core skill installation via CAAMP
+ *  10. NEXUS project registration
+ *  11. Project type detection (--detect)
+ *  12. Injection refresh (--update-docs)
+ *
+ * @task T4681
+ * @task T4682
+ * @task T4684
+ * @task T4685
+ * @task T4686
+ * @task T4687
+ * @task T4689
+ * @task T4706
+ * @task T4707
+ * @epic T4663
+ */
+/** Options for the init operation. */
+export interface InitOptions {
+    /** Project name override. */
+    name?: string;
+    /** Overwrite existing files. */
+    force?: boolean;
+    /** Auto-detect project configuration. */
+    detect?: boolean;
+    /** Update agent documentation injections only. */
+    updateDocs?: boolean;
+}
+/** Result of the init operation. */
+export interface InitResult {
+    initialized: boolean;
+    directory: string;
+    created: string[];
+    skipped: string[];
+    warnings: string[];
+    updateDocsOnly?: boolean;
+}
+/**
+ * Run update-docs only: refresh all injections without reinitializing.
+ * Re-injects CLEO-INJECTION.md into all detected agent instruction files.
+ *
+ * @task T4686
+ */
+export declare function updateDocs(): Promise<InitResult>;
+/**
+ * Run full project initialization.
+ *
+ * Creates the .cleo/ directory structure, installs schemas, templates,
+ * agent definitions, MCP server configs, skills, and registers with NEXUS.
+ *
+ * @task T4681
+ * @task T4682
+ * @task T4684
+ * @task T4685
+ * @task T4686
+ * @task T4687
+ * @task T4689
+ * @task T4706
+ * @task T4707
+ */
+export declare function initProject(opts?: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/core/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAcH,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA6sBD;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAoBtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4D7E"}