@cleocode/core 2026.3.41 → 2026.3.43

package/dist/orchestration/status.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Orchestration status computation.
+ *
+ * Provides status aggregation for epics, overall project state,
+ * progress metrics, and orchestration check state.
+ *
+ * @task T5702
+ */
+import type { Task } from '@cleocode/contracts';
+/** Status counts by task state. */
+export interface StatusCounts {
+    pending: number;
+    active: number;
+    blocked: number;
+    done: number;
+    cancelled?: number;
+}
+/** Epic-specific status result. */
+export interface EpicStatus {
+    epicId: string;
+    epicTitle: string;
+    totalTasks: number;
+    byStatus: StatusCounts;
+    waves: number;
+    currentWave: number | null;
+}
+/** Overall orchestration status (no specific epic). */
+export interface OverallStatus {
+    totalEpics: number;
+    totalTasks: number;
+    byStatus: StatusCounts;
+}
+/** Progress metrics for orchestration check. */
+export interface ProgressMetrics {
+    total: number;
+    done: number;
+    pending: number;
+    blocked: number;
+    active: number;
+    percentComplete: number;
+}
+/** Startup summary for an epic. */
+export interface StartupSummary {
+    epicId: string;
+    epicTitle: string;
+    initialized: boolean;
+    summary: {
+        totalTasks: number;
+        totalWaves: number;
+        readyTasks: number;
+        byStatus: StatusCounts;
+    };
+    firstWave: import('./waves.js').Wave | null;
+}
+/**
+ * Count tasks by status.
+ */
+export declare function countByStatus(tasks: Task[]): StatusCounts;
+/**
+ * Compute epic-specific status.
+ *
+ * @param epicId - The epic task ID
+ * @param epicTitle - The epic title
+ * @param children - Child tasks of the epic
+ * @returns Epic status with wave information
+ */
+export declare function computeEpicStatus(epicId: string, epicTitle: string, children: Task[]): EpicStatus;
+/**
+ * Compute overall orchestration status across all tasks.
+ *
+ * @param tasks - All tasks in the project
+ * @returns Overall status with epic count
+ */
+export declare function computeOverallStatus(tasks: Task[]): OverallStatus;
+/**
+ * Compute progress metrics for all tasks.
+ *
+ * @param tasks - All tasks to measure
+ * @returns Progress metrics with completion percentage
+ */
+export declare function computeProgress(tasks: Task[]): ProgressMetrics;
+/**
+ * Compute startup summary for an epic.
+ *
+ * @param epicId - The epic task ID
+ * @param epicTitle - The epic title
+ * @param children - Child tasks of the epic
+ * @param readyCount - Number of ready tasks
+ * @returns Startup summary with wave information
+ */
+export declare function computeStartupSummary(epicId: string, epicTitle: string, children: Task[], readyCount: number): StartupSummary;
+//# sourceMappingURL=status.d.ts.map

package/dist/orchestration/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/orchestration/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGhD,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,YAAY,CAAC;KACxB,CAAC;IACF,SAAS,EAAE,OAAO,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,CAQzD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,UAAU,CAYjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,aAAa,CAejE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,eAAe,CAe9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,EAAE,EAChB,UAAU,EAAE,MAAM,GACjB,cAAc,CAgBhB"}

package/dist/orchestration/unblock.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Unblock opportunities analysis.
+ * @task T4784
+ */
+import type { TaskRef } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+export interface HighImpactTask {
+    taskId: string;
+    title: string;
+    wouldUnblock: number;
+    dependents: string[];
+}
+export interface SingleBlockerTask {
+    taskId: string;
+    title: string;
+    remainingBlocker: Pick<TaskRef, 'id' | 'title'>;
+}
+export interface CommonBlocker {
+    taskId: string;
+    title: string;
+    blocksCount: number;
+    blockedTasks: string[];
+}
+export interface UnblockResult {
+    highImpact: HighImpactTask[];
+    singleBlocker: SingleBlockerTask[];
+    commonBlockers: CommonBlocker[];
+}
+/** Analyze dependency graph for unblocking opportunities. */
+export declare function getUnblockOpportunities(cwd?: string, accessor?: DataAccessor): Promise<UnblockResult>;
+//# sourceMappingURL=unblock.d.ts.map

package/dist/orchestration/unblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unblock.d.ts","sourceRoot":"","sources":["../../src/orchestration/unblock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAQ,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAqCD,6DAA6D;AAC7D,wBAAsB,uBAAuB,CAC3C,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,aAAa,CAAC,CAyExB"}

package/dist/orchestration/validate-spawn.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Spawn readiness validation.
+ * @task T4784
+ */
+import type { DataAccessor } from '../store/data-accessor.js';
+export interface ValidationIssue {
+    code: string;
+    message: string;
+    severity: string;
+}
+export interface SpawnValidationResult {
+    taskId: string;
+    title: string;
+    ready: boolean;
+    issues: ValidationIssue[];
+}
+/** Validate spawn readiness for a task. */
+export declare function validateSpawnReadiness(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<SpawnValidationResult>;
+//# sourceMappingURL=validate-spawn.d.ts.map

package/dist/orchestration/validate-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-spawn.d.ts","sourceRoot":"","sources":["../../src/orchestration/validate-spawn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,2CAA2C;AAC3C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAgEhC"}

package/dist/orchestration/waves.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Wave computation and dependency graph operations.
+ * @task T4784
+ */
+import type { Task, TaskRef } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+export interface Wave {
+    waveNumber: number;
+    tasks: string[];
+    status: 'pending' | 'in_progress' | 'completed';
+}
+export interface EnrichedWave {
+    waveNumber: number;
+    tasks: TaskRef[];
+    status: 'pending' | 'in_progress' | 'completed';
+}
+/** Compute execution waves using topological sort. */
+export declare function computeWaves(tasks: Task[]): Wave[];
+/** Get enriched wave data for an epic. */
+export declare function getEnrichedWaves(epicId: string, cwd?: string, accessor?: DataAccessor): Promise<{
+    epicId: string;
+    waves: EnrichedWave[];
+    totalWaves: number;
+    totalTasks: number;
+}>;
+//# sourceMappingURL=waves.d.ts.map

package/dist/orchestration/waves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waves.d.ts","sourceRoot":"","sources":["../../src/orchestration/waves.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;CACjD;AAkBD,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAkDlD;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB5F"}

package/dist/otel/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OpenTelemetry token metrics core module.
+ * @task T4535
+ * @epic T4454
+ */
+/** Get token tracking status. */
+export declare function getOtelStatus(): Promise<Record<string, unknown>>;
+/** Get combined token usage summary. */
+export declare function getOtelSummary(): Promise<Record<string, unknown>>;
+/** Get session-level token data. */
+export declare function getOtelSessions(opts: {
+    session?: string;
+    task?: string;
+}): Promise<Record<string, unknown>>;
+/** Get spawn-level token data. */
+export declare function getOtelSpawns(opts: {
+    task?: string;
+    epic?: string;
+}): Promise<Record<string, unknown>>;
+/** Get real token usage from Claude Code API. */
+export declare function getRealTokenUsage(_opts: {
+    session?: string;
+    since?: string;
+}): Promise<Record<string, unknown>>;
+/** Clear token tracking data with backup. */
+export declare function clearOtelData(): Promise<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,iCAAiC;AACjC,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqBtE;AAED,wCAAwC;AACxC,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkCvE;AAED,oCAAoC;AACpC,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAenC;AAED,kCAAkC;AAClC,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASnC;AAED,iDAAiD;AACjD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMnC;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAStE"}

package/dist/output.d.ts

@@ -0,0 +1,66 @@
+/**
+ * LAFS-compliant output formatter for CLEO V2.
+ *
+ * LAFS (LLM-Agent-First Schema) ensures all CLI output is
+ * machine-parseable JSON by default, with optional human-readable modes.
+ *
+ * All envelopes are now full LAFS-compliant with $schema and _meta.
+ * The backward-compatible shape (success + data, no _meta) has been removed.
+ *
+ * Types are re-exported from the canonical source in src/types/lafs.ts.
+ *
+ * @epic T4663
+ * @task T4672
+ */
+import type { LafsEnvelope, LafsError, LafsSuccess } from '@cleocode/contracts';
+import type { LAFSPage, Warning } from '@cleocode/lafs-protocol';
+import { CleoError } from './errors.js';
+export type { LafsEnvelope, LafsError, LafsSuccess };
+/**
+ * Push a deprecation or informational warning into the current envelope.
+ * Warnings are drained (consumed) by the next formatSuccess/formatError call.
+ *
+ * @task T4669
+ * @epic T4663
+ */
+export declare function pushWarning(warning: Warning): void;
+/**
+ * Options for envelope formatting.
+ *
+ * @task T4668
+ * @task T4670
+ * @epic T4663
+ */
+export interface FormatOptions {
+    operation?: string;
+    page?: LAFSPage;
+    extensions?: Record<string, unknown>;
+    /** MVI level to embed in the envelope _meta. Defaults to 'standard'. @task T4957 */
+    mvi?: import('@cleocode/lafs-protocol').MVILevel;
+}
+/**
+ * Format a successful result as a full LAFS-conformant envelope.
+ *
+ * Always produces the full LAFSEnvelope with $schema and _meta.
+ * When operation is omitted, defaults to 'cli.output'.
+ * Supports optional page (T4668) and _extensions (T4670).
+ *
+ * @task T4672
+ * @task T4668
+ * @task T4670
+ * @epic T4663
+ */
+export declare function formatSuccess<T>(data: T, message?: string, operationOrOpts?: string | FormatOptions): string;
+/**
+ * Format an error as a full LAFS-conformant envelope.
+ *
+ * Always produces the full LAFSEnvelope with $schema and _meta.
+ * When operation is omitted, defaults to 'cli.output'.
+ *
+ * @task T4672
+ * @epic T4663
+ */
+export declare function formatError(error: CleoError, operation?: string): string;
+/** Format any result (success or error) as LAFS JSON. */
+export declare function formatOutput<T>(result: T | CleoError): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAY,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAWrD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElD;AAeD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oFAAoF;IACpF,GAAG,CAAC,EAAE,OAAO,yBAAyB,EAAE,QAAQ,CAAC;CAClD;AAkCD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GAAG,aAAa,GACvC,MAAM,CAkBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CASxE;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM,CAK7D"}

package/dist/pagination.d.ts

@@ -0,0 +1,45 @@
+/**
+ * LAFS-compliant pagination utility for list commands.
+ *
+ * Wraps result arrays in LAFSPage offset pagination objects.
+ * Supports both offset-based and cursor-based pagination modes.
+ *
+ * @task T4668
+ * @epic T4663
+ */
+import type { LAFSPage } from '@cleocode/lafs-protocol';
+/**
+ * Input parameters for paginating a result set.
+ *
+ * @task T4668
+ * @epic T4663
+ */
+export interface PaginateInput {
+    /** Total number of items before pagination. */
+    total: number;
+    /** Number of items to return per page. */
+    limit?: number;
+    /** Number of items to skip. */
+    offset?: number;
+}
+/**
+ * Create an LAFSPage object from pagination parameters.
+ *
+ * Returns mode:"none" when no pagination is requested (no limit/offset).
+ * Returns mode:"offset" with hasMore/total when pagination is active.
+ *
+ * @task T4668
+ * @epic T4663
+ */
+export declare function createPage(input: PaginateInput): LAFSPage;
+/**
+ * Apply pagination to an array of items and return the sliced result with page metadata.
+ *
+ * @task T4668
+ * @epic T4663
+ */
+export declare function paginate<T>(items: T[], limit?: number, offset?: number): {
+    items: T[];
+    page: LAFSPage;
+};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAgC,MAAM,yBAAyB,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAmBzD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAehC"}

package/dist/paths.d.ts

@@ -0,0 +1,165 @@
+/**
+ * XDG-compliant path resolution for CLEO V2.
+ *
+ * Environment variables:
+ *   CLEO_HOME   - Global installation directory (default: ~/.cleo)
+ *   CLEO_DIR    - Project data directory (default: .cleo)
+ *
+ * @epic T4454
+ * @task T4458
+ */
+/**
+ * Check if a CLEO project is initialized at the given root.
+ * Checks for tasks.db.
+ */
+export declare function isProjectInitialized(projectRoot?: string): boolean;
+/**
+ * Get the global CLEO home directory.
+ * Respects CLEO_HOME env var; otherwise uses the OS-appropriate data path
+ * via env-paths (XDG_DATA_HOME on Linux, Library/Application Support on macOS,
+ * %LOCALAPPDATA% on Windows).
+ */
+export declare function getCleoHome(): string;
+/**
+ * Get the global CLEO templates directory.
+ */
+export declare function getCleoTemplatesDir(): string;
+/**
+ * Get the global CLEO schemas directory.
+ */
+export declare function getCleoSchemasDir(): string;
+/**
+ * Get the global CLEO docs directory.
+ */
+export declare function getCleoDocsDir(): string;
+/**
+ * Get the project CLEO data directory (relative).
+ * Respects CLEO_DIR env var, defaults to ".cleo".
+ */
+export declare function getCleoDir(cwd?: string): string;
+/**
+ * Get the absolute path to the project CLEO directory.
+ */
+export declare function getCleoDirAbsolute(cwd?: string): string;
+/**
+ * Get the project root from the CLEO directory.
+ * Respects CLEO_ROOT env var, then derives from CLEO_DIR.
+ * If CLEO_DIR is ".cleo", the project root is its parent.
+ */
+export declare function getProjectRoot(cwd?: string): string;
+/**
+ * Resolve a project-relative path to an absolute path.
+ */
+export declare function resolveProjectPath(relativePath: string, cwd?: string): string;
+/**
+ * Get the path to the project's tasks.db file (SQLite database).
+ * @deprecated Use getAccessor() from './store/data-accessor.js' instead. This function
+ *   returns the database file path for legacy compatibility, but all task data access
+ *   should go through the DataAccessor interface to ensure proper SQLite interaction.
+ *   Example:
+ *     // OLD (deprecated):
+ *     const taskPath = getTaskPath(cwd);
+ *     const data = await readJsonFile<TaskFile>(taskPath);
+ *     // NEW (correct):
+ *     const accessor = await getAccessor(cwd);
+ *     const data = await accessor.queryTasks({});
+ */
+export declare function getTaskPath(cwd?: string): string;
+/**
+ * Get the path to the project's config.json file.
+ */
+export declare function getConfigPath(cwd?: string): string;
+/**
+ * Get the path to the project's sessions.json file.
+ */
+export declare function getSessionsPath(cwd?: string): string;
+/**
+ * Get the path to the project's archive file.
+ */
+export declare function getArchivePath(cwd?: string): string;
+/**
+ * Get the path to the project's log file.
+ * Canonical structured runtime log path (pino).
+ * @task T4644
+ */
+export declare function getLogPath(cwd?: string): string;
+/**
+ * Get the backup directory for operational backups.
+ */
+export declare function getBackupDir(cwd?: string): string;
+/**
+ * Get the global config file path.
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * Get the agent outputs directory (relative path) from config or default.
+ *
+ * Config lookup priority:
+ *   1. config.agentOutputs.directory
+ *   2. config.research.outputDir (deprecated)
+ *   3. config.directories.agentOutputs (deprecated)
+ *   4. Default: '.cleo/agent-outputs'
+ *
+ * @task T4700
+ */
+export declare function getAgentOutputsDir(cwd?: string): string;
+/**
+ * Get the absolute path to the agent outputs directory.
+ * @task T4700
+ */
+export declare function getAgentOutputsAbsolute(cwd?: string): string;
+/**
+ * Get the absolute path to the MANIFEST.jsonl file.
+ *
+ * Checks config.agentOutputs.manifestFile for custom filename,
+ * defaults to 'MANIFEST.jsonl'.
+ *
+ * @task T4700
+ */
+export declare function getManifestPath(cwd?: string): string;
+/**
+ * Get the absolute path to the MANIFEST.archive.jsonl file.
+ * @task T4700
+ */
+export declare function getManifestArchivePath(cwd?: string): string;
+/**
+ * Check if a path is absolute (POSIX or Windows).
+ */
+export declare function isAbsolutePath(path: string): boolean;
+/**
+ * Get the OS log directory for CLEO global logs.
+ * Linux: ~/.local/state/cleo | macOS: ~/Library/Logs/cleo | Windows: %LOCALAPPDATA%\cleo\Log
+ */
+export declare function getCleoLogDir(): string;
+/**
+ * Get the OS cache directory for CLEO.
+ * Linux: ~/.cache/cleo | macOS: ~/Library/Caches/cleo | Windows: %LOCALAPPDATA%\cleo\Cache
+ */
+export declare function getCleoCacheDir(): string;
+/**
+ * Get the OS temp directory for CLEO ephemeral files.
+ */
+export declare function getCleoTempDir(): string;
+/**
+ * Get the OS config directory for CLEO.
+ * Linux: ~/.config/cleo | macOS: ~/Library/Preferences/cleo | Windows: %APPDATA%\cleo\Config
+ */
+export declare function getCleoConfigDir(): string;
+/**
+ * Get the global agents hub directory.
+ * Respects AGENTS_HOME env var, defaults to ~/.agents.
+ */
+export declare function getAgentsHome(): string;
+/**
+ * Get the Claude Code agents directory (~/.claude/agents by default).
+ * @deprecated Use AdapterPathProvider.getAgentInstallDir() from the active adapter instead.
+ */
+export declare function getClaudeAgentsDir(): string;
+/**
+ * Get the claude-mem SQLite database path.
+ * @deprecated Use AdapterPathProvider.getMemoryDbPath() from the active adapter instead.
+ * Respects CLAUDE_MEM_DB env var, defaults to ~/.claude-mem/claude-mem.db.
+ * This is a third-party tool path; homedir() is correct here (no env-paths standard).
+ */
+export declare function getClaudeMemDbPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBpD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/phases/deps.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Dependency graph resolution - topological sort, cycle detection, impact analysis.
+ * @task T4464
+ * @task T4659
+ * @epic T4454
+ * @epic T4654
+ */
+import type { Task, TaskRef } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+/**
+ * Invalidate the cached TaskFile (call after writes).
+ * @task T4659
+ * @epic T4654
+ */
+export declare function invalidateDepsCache(): void;
+/** A node in the dependency graph. */
+export interface DepNode {
+    id: string;
+    title: string;
+    status: string;
+    depends: string[];
+    dependents: string[];
+}
+/** Dependency overview result. */
+export interface DepsOverviewResult {
+    nodes: DepNode[];
+    totalTasks: number;
+    withDependencies: number;
+    withDependents: number;
+    roots: string[];
+    leaves: string[];
+}
+/** Single task dependency result. */
+export interface TaskDepsResult {
+    task: TaskRef;
+    upstream: TaskRef[];
+    downstream: TaskRef[];
+    blockedBy: TaskRef[];
+}
+/** Execution wave (group of parallelizable tasks). */
+export interface ExecutionWave {
+    wave: number;
+    tasks: Array<TaskRef & {
+        depends: string[];
+    }>;
+}
+/** Critical path result. */
+export interface CriticalPathResult {
+    path: TaskRef[];
+    length: number;
+}
+/** Cycle detection result. */
+export interface CycleResult {
+    hasCycles: boolean;
+    cycles: string[][];
+}
+/**
+ * Build an adjacency graph from task dependencies.
+ * @task T4464
+ */
+export declare function buildGraph(tasks: Task[]): Map<string, DepNode>;
+/**
+ * Get dependency overview for all tasks.
+ * @task T4464
+ */
+export declare function getDepsOverview(cwd?: string, accessor?: DataAccessor): Promise<DepsOverviewResult>;
+/**
+ * Get dependencies for a specific task.
+ * @task T4464
+ */
+export declare function getTaskDeps(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<TaskDepsResult>;
+/**
+ * Topological sort of tasks respecting dependencies.
+ * Returns tasks in execution order. Throws on cycles.
+ * @task T4464
+ */
+export declare function topologicalSort(tasks: Task[]): Task[];
+/**
+ * Group tasks into parallelizable execution waves.
+ * @task T4464
+ */
+export declare function getExecutionWaves(epicId?: string, cwd?: string, accessor?: DataAccessor): Promise<ExecutionWave[]>;
+/**
+ * Find the critical path (longest dependency chain) from a task.
+ * @task T4464
+ */
+export declare function getCriticalPath(taskId: string, cwd?: string, accessor?: DataAccessor): Promise<CriticalPathResult>;
+/**
+ * Find all tasks affected by changes to a given task.
+ * @task T4464
+ */
+export declare function getImpact(taskId: string, maxDepth?: number, cwd?: string, accessor?: DataAccessor): Promise<string[]>;
+/**
+ * Detect circular dependencies in the task graph.
+ * @task T4464
+ */
+export declare function detectCycles(cwd?: string, accessor?: DataAccessor): Promise<CycleResult>;
+/**
+ * Build task hierarchy tree.
+ * @task T4464
+ */
+export declare function getTaskTree(rootId?: string, cwd?: string, accessor?: DataAccessor): Promise<TreeNode[]>;
+/** Tree node representation. */
+export interface TreeNode {
+    id: string;
+    title: string;
+    status: string;
+    type?: string;
+    children: TreeNode[];
+}
+/**
+ * Manage task relationships (relates/blocks).
+ * @task T4464
+ */
+export declare function addRelation(taskId: string, relatedId: string, _cwd?: string, accessor?: DataAccessor): Promise<{
+    taskId: string;
+    relatedId: string;
+}>;
+//# sourceMappingURL=deps.d.ts.map

package/dist/phases/deps.d.ts.map

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