@cleocode/cleo 2026.2.5

package/dist/core/paths.js

@@ -0,0 +1,269 @@
+/**
+ * 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
+ */
+import { resolve, dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, readFileSync, renameSync } from 'node:fs';
+/**
+ * Check if a CLEO project is initialized at the given root.
+ * Checks for both tasks.json (canonical) and todo.json (legacy).
+ */
+export function isProjectInitialized(projectRoot) {
+    const root = projectRoot ?? getProjectRoot();
+    const cleoDir = join(root, '.cleo');
+    return existsSync(cleoDir) && (existsSync(join(cleoDir, 'tasks.json')) || existsSync(join(cleoDir, 'todo.json')));
+}
+/**
+ * Get the global CLEO home directory.
+ * Respects CLEO_HOME env var, defaults to ~/.cleo.
+ */
+export function getCleoHome() {
+    return process.env['CLEO_HOME'] ?? join(homedir(), '.cleo');
+}
+/**
+ * Get the global CLEO templates directory.
+ */
+export function getCleoTemplatesDir() {
+    return join(getCleoHome(), 'templates');
+}
+/**
+ * Get the global CLEO schemas directory.
+ */
+export function getCleoSchemasDir() {
+    return join(getCleoHome(), 'schemas');
+}
+/**
+ * Get the global CLEO docs directory.
+ */
+export function getCleoDocsDir() {
+    return join(getCleoHome(), 'docs');
+}
+/**
+ * Get the project CLEO data directory (relative).
+ * Respects CLEO_DIR env var, defaults to ".cleo".
+ */
+export function getCleoDir(cwd) {
+    if (cwd) {
+        return getCleoDirAbsolute(cwd);
+    }
+    return process.env['CLEO_DIR'] ?? '.cleo';
+}
+/**
+ * Get the absolute path to the project CLEO directory.
+ */
+export function getCleoDirAbsolute(cwd) {
+    const cleoDir = getCleoDir();
+    if (isAbsolutePath(cleoDir)) {
+        return cleoDir;
+    }
+    return resolve(cwd ?? process.cwd(), cleoDir);
+}
+/**
+ * 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 function getProjectRoot(cwd) {
+    if (!cwd && process.env['CLEO_ROOT']) {
+        return process.env['CLEO_ROOT'];
+    }
+    const cleoDirAbs = getCleoDirAbsolute(cwd);
+    if (cleoDirAbs.endsWith('/.cleo') || cleoDirAbs.endsWith('\\.cleo')) {
+        return dirname(cleoDirAbs);
+    }
+    return cwd ?? process.cwd();
+}
+/**
+ * Resolve a project-relative path to an absolute path.
+ */
+export function resolveProjectPath(relativePath, cwd) {
+    if (isAbsolutePath(relativePath)) {
+        return relativePath;
+    }
+    // Expand leading tilde
+    if (relativePath.startsWith('~/') || relativePath === '~') {
+        return resolve(homedir(), relativePath.slice(2));
+    }
+    return resolve(getProjectRoot(cwd), relativePath);
+}
+/**
+ * Get the path to the project's tasks.json file.
+ */
+export function getTaskPath(cwd) {
+    return join(getCleoDirAbsolute(cwd), 'tasks.json');
+}
+/**
+ * Get the path to the project's todo.json file.
+ * @deprecated Use getTaskPath() instead.
+ */
+export function getTodoPath(cwd) {
+    return getTaskPath(cwd);
+}
+/**
+ * Get the path to the project's config.json file.
+ */
+export function getConfigPath(cwd) {
+    return join(getCleoDirAbsolute(cwd), 'config.json');
+}
+/**
+ * Get the path to the project's sessions.json file.
+ */
+export function getSessionsPath(cwd) {
+    return join(getCleoDirAbsolute(cwd), 'sessions.json');
+}
+/**
+ * Get the path to the project's archive file.
+ */
+export function getArchivePath(cwd) {
+    return join(getCleoDirAbsolute(cwd), 'tasks-archive.json');
+}
+/**
+ * Get the path to the project's log file.
+ * Auto-migrates legacy todo-log.json to tasks-log.jsonl if needed.
+ * @task T4644
+ */
+export function getLogPath(cwd) {
+    const cleoDir = getCleoDirAbsolute(cwd);
+    const newPath = join(cleoDir, 'tasks-log.jsonl');
+    const legacyPath = join(cleoDir, 'todo-log.json');
+    // Auto-migrate: rename legacy file if new file doesn't exist
+    if (!existsSync(newPath) && existsSync(legacyPath)) {
+        try {
+            renameSync(legacyPath, newPath);
+        }
+        catch {
+            // If rename fails (e.g. permissions), fall back to legacy path
+            return legacyPath;
+        }
+    }
+    return newPath;
+}
+/**
+ * Get the backup directory for operational backups.
+ */
+export function getBackupDir(cwd) {
+    return join(getCleoDirAbsolute(cwd), 'backups', 'operational');
+}
+/**
+ * Get the global config file path.
+ */
+export function getGlobalConfigPath() {
+    return join(getCleoHome(), 'config.json');
+}
+// ============================================================================
+// Agent Outputs
+// ============================================================================
+const DEFAULT_AGENT_OUTPUTS_DIR = '.cleo/agent-outputs';
+/**
+ * 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 function getAgentOutputsDir(cwd) {
+    const projectRoot = getProjectRoot(cwd);
+    const configPath = join(projectRoot, '.cleo', 'config.json');
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            // Priority 1: agentOutputs.directory (canonical)
+            if (typeof config.agentOutputs === 'object' && config.agentOutputs?.directory) {
+                return config.agentOutputs.directory;
+            }
+            // Also support agentOutputs as a plain string
+            if (typeof config.agentOutputs === 'string' && config.agentOutputs) {
+                return config.agentOutputs;
+            }
+            // Priority 2: research.outputDir (deprecated)
+            if (config.research?.outputDir) {
+                return config.research.outputDir;
+            }
+            // Priority 3: directories.agentOutputs (deprecated)
+            if (config.directories?.agentOutputs) {
+                return config.directories.agentOutputs;
+            }
+        }
+        catch {
+            // fallback to default
+        }
+    }
+    return DEFAULT_AGENT_OUTPUTS_DIR;
+}
+/**
+ * Get the absolute path to the agent outputs directory.
+ * @task T4700
+ */
+export function getAgentOutputsAbsolute(cwd) {
+    const dir = getAgentOutputsDir(cwd);
+    if (isAbsolutePath(dir)) {
+        return dir;
+    }
+    return resolve(getProjectRoot(cwd), dir);
+}
+/**
+ * Get the absolute path to the MANIFEST.jsonl file.
+ *
+ * Checks config.agentOutputs.manifestFile for custom filename,
+ * defaults to 'MANIFEST.jsonl'.
+ *
+ * @task T4700
+ */
+export function getManifestPath(cwd) {
+    const outputDir = getAgentOutputsDir(cwd);
+    const projectRoot = getProjectRoot(cwd);
+    const configPath = join(projectRoot, '.cleo', 'config.json');
+    let manifestFile = 'MANIFEST.jsonl';
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            const customFile = config.agentOutputs?.manifestFile ?? config.research?.manifestFile;
+            if (customFile) {
+                manifestFile = customFile;
+            }
+        }
+        catch {
+            // fallback
+        }
+    }
+    return resolve(projectRoot, outputDir, manifestFile);
+}
+/**
+ * Get the absolute path to the MANIFEST.archive.jsonl file.
+ * @task T4700
+ */
+export function getManifestArchivePath(cwd) {
+    const outputDir = getAgentOutputsDir(cwd);
+    const projectRoot = getProjectRoot(cwd);
+    return resolve(projectRoot, outputDir, 'MANIFEST.archive.jsonl');
+}
+// ============================================================================
+// Path Utilities
+// ============================================================================
+/**
+ * Check if a path is absolute (POSIX or Windows).
+ */
+export function isAbsolutePath(path) {
+    // POSIX absolute
+    if (path.startsWith('/'))
+        return true;
+    // Windows drive letter (C:\, D:/)
+    if (/^[A-Za-z]:[\\/]/.test(path))
+        return true;
+    // UNC path
+    if (path.startsWith('\\\\'))
+        return true;
+    return false;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

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

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

@@ -0,0 +1,142 @@
+/**
+ * Dependency graph resolution - topological sort, cycle detection, impact analysis.
+ * @task T4464
+ * @task T4659
+ * @epic T4454
+ * @epic T4654
+ */
+import type { Task } from '../../types/task.js';
+import type { DataAccessor } from '../../store/data-accessor.js';
+/**
+ * Invalidate the cached TodoFile (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: {
+        id: string;
+        title: string;
+        status: string;
+    };
+    upstream: Array<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+    downstream: Array<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+    blockedBy: Array<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+}
+/** Execution wave (group of parallelizable tasks). */
+export interface ExecutionWave {
+    wave: number;
+    tasks: Array<{
+        id: string;
+        title: string;
+        status: string;
+        depends: string[];
+    }>;
+}
+/** Critical path result. */
+export interface CriticalPathResult {
+    path: Array<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+    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/core/phases/deps.d.ts.map

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