@cleocode/core 2026.3.76 → 2026.4.0

package/dist/observability/log-reader.js

@@ -0,0 +1,139 @@
+/**
+ * Log file discovery and reading.
+ *
+ * Discovers pino log files in .cleo/logs/ directories,
+ * reads them synchronously or via async streaming.
+ *
+ * @task T5187
+ * @epic T5186
+ */
+import { createReadStream, existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { getLogDir } from '../logger.js';
+import { getCleoDirAbsolute, getCleoHome } from '../paths.js';
+/** Regex for standard CLEO pino log files: cleo.YYYY-MM-DD.N.log */
+const CLEO_LOG_PATTERN = /^cleo\.(\d{4}-\d{2}-\d{2})\.(\d+)\.log$/;
+/** Regex for migration log files: migration-*.jsonl */
+const MIGRATION_LOG_PATTERN = /^migration-.*\.jsonl$/;
+/**
+ * Get the project log directory path.
+ * Uses getLogDir() from logger if available, falls back to config-based resolution.
+ */
+export function getProjectLogDir(cwd) {
+    // Try the runtime-initialized log dir first
+    const runtimeDir = getLogDir();
+    if (runtimeDir)
+        return runtimeDir;
+    // Fall back to standard path
+    const cleoDir = getCleoDirAbsolute(cwd);
+    const logsDir = join(cleoDir, 'logs');
+    return existsSync(logsDir) ? logsDir : null;
+}
+/**
+ * Get the global log directory path (~/.cleo/logs/).
+ */
+export function getGlobalLogDir() {
+    return join(getCleoHome(), 'logs');
+}
+/**
+ * Scan a directory for log files and build LogFileInfo entries.
+ */
+function scanLogDir(dir, includeMigration) {
+    if (!existsSync(dir))
+        return [];
+    let fileNames;
+    try {
+        fileNames = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const name of fileNames) {
+        const cleoMatch = name.match(CLEO_LOG_PATTERN);
+        const isMigration = MIGRATION_LOG_PATTERN.test(name);
+        if (!cleoMatch && (!isMigration || !includeMigration))
+            continue;
+        const filePath = join(dir, name);
+        let stat;
+        try {
+            stat = statSync(filePath);
+        }
+        catch {
+            continue;
+        }
+        files.push({
+            path: filePath,
+            name,
+            size: stat.size,
+            mtime: stat.mtime.toISOString(),
+            date: cleoMatch ? cleoMatch[1] : null,
+            isActive: false, // set below
+        });
+    }
+    return files;
+}
+/**
+ * Discover all log files in the specified scope.
+ * Returns file info sorted by date (newest first).
+ */
+export function discoverLogFiles(options, cwd) {
+    const scope = options?.scope ?? 'project';
+    const includeMigration = options?.includeMigration ?? false;
+    const sinceDate = options?.since;
+    let files = [];
+    if (scope === 'project' || scope === 'both') {
+        const dir = getProjectLogDir(cwd);
+        if (dir)
+            files.push(...scanLogDir(dir, includeMigration));
+    }
+    if (scope === 'global' || scope === 'both') {
+        const dir = getGlobalLogDir();
+        files.push(...scanLogDir(dir, includeMigration));
+    }
+    // Filter by modification date
+    if (sinceDate) {
+        files = files.filter((f) => f.mtime >= sinceDate);
+    }
+    // Sort newest first by mtime
+    files.sort((a, b) => b.mtime.localeCompare(a.mtime));
+    // Mark the newest file as active
+    if (files.length > 0) {
+        files[0].isActive = true;
+    }
+    return files;
+}
+/**
+ * Read all lines from a log file synchronously.
+ * Returns raw JSON strings (one per line). Suitable for small-to-medium files.
+ */
+export function readLogFileLines(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    if (!content.trim())
+        return [];
+    return content.split('\n').filter((line) => line.trim() !== '');
+}
+/**
+ * Create an async iterable over lines of a log file.
+ * Suitable for large files -- does not load entire file into memory.
+ */
+export async function* streamLogFileLines(filePath) {
+    if (!existsSync(filePath))
+        return;
+    const rl = createInterface({
+        input: createReadStream(filePath, { encoding: 'utf-8' }),
+        crlfDelay: Infinity,
+    });
+    for await (const line of rl) {
+        if (line.trim())
+            yield line;
+    }
+}
+//# sourceMappingURL=log-reader.js.map

package/dist/observability/log-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-reader.js","sourceRoot":"","sources":["../../src/observability/log-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG9D,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,yCAAyC,CAAC;AAEnE,uDAAuD;AACvD,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,4CAA4C;IAC5C,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;IAC/B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,6BAA6B;IAC7B,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW,EAAE,gBAAyB;IACxD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,IAAI,SAAmB,CAAC;IACxB,IAAI,CAAC;QACH,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErD,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,gBAAgB,CAAC;YAAE,SAAS;QAEhE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,QAAQ;YACd,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAC/B,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI;YACtC,QAAQ,EAAE,KAAK,EAAE,YAAY;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA6B,EAAE,GAAY;IAC1E,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,SAAS,CAAC;IAC1C,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC;IAC5D,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,CAAC;IAEjC,IAAI,KAAK,GAAkB,EAAE,CAAC;IAE9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,8BAA8B;IAC9B,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,iCAAiC;IACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CAAC,QAAgB;IACxD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAElC,MAAM,EAAE,GAAG,eAAe,CAAC;QACzB,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACxD,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/observability/types.js

@@ -0,0 +1,19 @@
+/**
+ * Type definitions for the CLEO log reader (observability) module.
+ *
+ * Covers pino JSONL log entry parsing, file discovery, filtering,
+ * and query results.
+ *
+ * @task T5187
+ * @epic T5186
+ */
+/** Numeric pino level values for comparison. */
+export const PINO_LEVEL_VALUES = {
+    TRACE: 10,
+    DEBUG: 20,
+    INFO: 30,
+    WARN: 40,
+    ERROR: 50,
+    FATAL: 60,
+};
+//# sourceMappingURL=types.js.map

package/dist/observability/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC"}

package/dist/orchestration/analyze.js

@@ -0,0 +1,107 @@
+/**
+ * Dependency analysis for orchestration.
+ *
+ * Provides dependency graph building, circular dependency detection (DFS),
+ * and missing dependency identification for epic task hierarchies.
+ *
+ * @task T5702
+ */
+/**
+ * Build a dependency graph for a set of tasks.
+ *
+ * Returns a Map from task ID to the set of task IDs it depends on.
+ */
+export function buildDependencyGraph(tasks) {
+    const graph = new Map();
+    for (const task of tasks) {
+        if (!graph.has(task.id)) {
+            graph.set(task.id, new Set());
+        }
+        if (task.depends) {
+            for (const dep of task.depends) {
+                graph.get(task.id).add(dep);
+            }
+        }
+    }
+    return graph;
+}
+/**
+ * Detect circular dependencies using DFS traversal.
+ *
+ * @param tasks - The set of tasks to analyze
+ * @param graph - Pre-built dependency graph (optional; built from tasks if not provided)
+ * @returns Array of circular dependency cycles (each cycle is an array of task IDs)
+ */
+export function detectCircularDependencies(tasks, graph) {
+    const depGraph = graph ?? buildDependencyGraph(tasks);
+    const circularDeps = [];
+    const visited = new Set();
+    const recursionStack = new Set();
+    function dfs(taskId, path) {
+        visited.add(taskId);
+        recursionStack.add(taskId);
+        const deps = depGraph.get(taskId) || new Set();
+        for (const dep of deps) {
+            if (!visited.has(dep)) {
+                dfs(dep, [...path, taskId]);
+            }
+            else if (recursionStack.has(dep)) {
+                circularDeps.push([...path, taskId, dep]);
+            }
+        }
+        recursionStack.delete(taskId);
+    }
+    for (const task of tasks) {
+        if (!visited.has(task.id)) {
+            dfs(task.id, []);
+        }
+    }
+    return circularDeps;
+}
+/**
+ * Find missing dependencies — deps that reference tasks outside the epic
+ * that are not yet completed.
+ *
+ * @param children - Child tasks of the epic
+ * @param allTasks - All tasks in the project (to check if deps are completed elsewhere)
+ * @returns Array of missing dependency references
+ */
+export function findMissingDependencies(children, allTasks) {
+    const childIds = new Set(children.map((t) => t.id));
+    const missingDeps = [];
+    for (const task of children) {
+        if (task.depends) {
+            for (const dep of task.depends) {
+                if (!childIds.has(dep) && !allTasks.find((t) => t.id === dep && t.status === 'done')) {
+                    missingDeps.push({ taskId: task.id, missingDep: dep });
+                }
+            }
+        }
+    }
+    return missingDeps;
+}
+/**
+ * Perform full dependency analysis for an epic's children.
+ *
+ * Combines dependency graph building, circular detection, and missing dep
+ * identification into a single analysis result.
+ *
+ * @param children - Child tasks of the epic
+ * @param allTasks - All tasks in the project
+ * @returns Complete dependency analysis
+ */
+export function analyzeDependencies(children, allTasks) {
+    const graph = buildDependencyGraph(children);
+    const circularDependencies = detectCircularDependencies(children, graph);
+    const missingDependencies = findMissingDependencies(children, allTasks);
+    const dependencyGraph = {};
+    for (const [key, value] of graph.entries()) {
+        dependencyGraph[key] = Array.from(value);
+    }
+    return {
+        dependencyGraph,
+        circularDependencies,
+        missingDependencies,
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/orchestration/analyze.js.map

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

package/dist/orchestration/bootstrap.js

@@ -0,0 +1,132 @@
+/**
+ * Bootstrap brain state loading for agent startup.
+ * Calls other core modules directly (not engine functions).
+ * @task T4784
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getAccessor } from '../store/data-accessor.js';
+/** Build brain state for agent bootstrapping. */
+export async function buildBrainState(projectRoot, opts, accessor) {
+    const speed = opts?.speed || 'fast';
+    const brain = {
+        _meta: {
+            speed,
+            generatedAt: new Date().toISOString(),
+            version: '1.0.0',
+        },
+    };
+    // --- Session (from SQLite, ADR-006/ADR-020) ---
+    const acc = accessor ?? (await getAccessor(projectRoot));
+    try {
+        const sessions = await acc.loadSessions();
+        const activeSession = sessions.find((s) => s.status === 'active');
+        if (activeSession) {
+            brain.session = {
+                id: activeSession.id,
+                name: activeSession.name || activeSession.id,
+                status: activeSession.status,
+                startedAt: activeSession.startedAt,
+            };
+        }
+    }
+    catch {
+        // skip
+    }
+    // --- Tasks & Progress ---
+    const { tasks } = await acc.queryTasks({});
+    brain.progress = {
+        total: tasks.length,
+        done: tasks.filter((t) => t.status === 'done').length,
+        active: tasks.filter((t) => t.status === 'active').length,
+        blocked: tasks.filter((t) => t.status === 'blocked').length,
+        pending: tasks.filter((t) => t.status === 'pending').length,
+    };
+    // --- Current Task (from focus or session) ---
+    const focus = await acc.getMetaValue('focus_state');
+    const focusTaskId = focus?.currentTask ?? null;
+    if (focusTaskId) {
+        const task = tasks.find((t) => t.id === focusTaskId);
+        if (task) {
+            brain.currentTask = { id: task.id, title: task.title, status: task.status };
+        }
+    }
+    // --- Next Suggestion (simple: pick first pending task with all deps met) ---
+    const completedIds = new Set(tasks.filter((t) => t.status === 'done').map((t) => t.id));
+    const readyTasks = tasks.filter((t) => {
+        if (t.status !== 'pending')
+            return false;
+        const deps = t.depends ?? [];
+        return deps.every((d) => completedIds.has(d));
+    });
+    if (readyTasks.length > 0) {
+        // Sort by priority
+        const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+        readyTasks.sort((a, b) => {
+            const aPri = priorityOrder[a.priority ?? 'medium'] ?? 2;
+            const bPri = priorityOrder[b.priority ?? 'medium'] ?? 2;
+            return aPri - bPri;
+        });
+        const next = readyTasks[0];
+        brain.nextSuggestion = { id: next.id, title: next.title, score: 1 };
+    }
+    // --- Full tier: decisions, blockers, contextDrift ---
+    if (speed === 'full' || speed === 'complete') {
+        // Blockers
+        const blockedTasks = tasks.filter((t) => t.status === 'blocked' || t.depends?.some((d) => !completedIds.has(d)));
+        brain.blockers = blockedTasks.slice(0, 10).map((b) => ({
+            taskId: b.id,
+            title: b.title,
+            blockedBy: b.depends || [],
+        }));
+        // Recent decisions (from decision-log in .cleo)
+        try {
+            const decisionLogPath = join(projectRoot, '.cleo', 'decision-log.jsonl');
+            if (existsSync(decisionLogPath)) {
+                const content = readFileSync(decisionLogPath, 'utf-8').trim();
+                if (content) {
+                    const entries = content
+                        .split('\n')
+                        .filter((l) => l.trim())
+                        .map((l) => {
+                        try {
+                            return JSON.parse(l);
+                        }
+                        catch {
+                            return null;
+                        }
+                    })
+                        .filter(Boolean);
+                    const recent = entries.slice(-5);
+                    brain.recentDecisions = recent.map((d) => ({
+                        id: d.id ?? '',
+                        decision: d.decision ?? '',
+                        timestamp: d.timestamp ?? '',
+                    }));
+                }
+            }
+        }
+        catch {
+            // skip
+        }
+        // Context drift (from context state file)
+        try {
+            const contextStatePath = join(projectRoot, '.cleo', '.context-state.json');
+            if (existsSync(contextStatePath)) {
+                const state = JSON.parse(readFileSync(contextStatePath, 'utf-8'));
+                const percentage = state.contextWindow?.percentage ?? 0;
+                const factors = [];
+                if (percentage > 80)
+                    factors.push('high_context_usage');
+                if (percentage > 50)
+                    factors.push('moderate_context_usage');
+                brain.contextDrift = { score: percentage, factors };
+            }
+        }
+        catch {
+            // skip
+        }
+    }
+    return brain;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/orchestration/bootstrap.js.map

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

package/dist/orchestration/context.js

@@ -0,0 +1,56 @@
+/**
+ * Context estimation for orchestration.
+ *
+ * Estimates token usage and provides context budget recommendations
+ * for orchestrator operations.
+ *
+ * @task T5702
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { getManifestPath as getCentralManifestPath } from '../paths.js';
+/**
+ * Count manifest entries from MANIFEST.jsonl.
+ *
+ * @param projectRoot - The project root directory
+ * @returns Number of manifest entries
+ */
+export function countManifestEntries(projectRoot) {
+    const manifestPath = getCentralManifestPath(projectRoot);
+    if (!existsSync(manifestPath)) {
+        return 0;
+    }
+    try {
+        const content = readFileSync(manifestPath, 'utf-8');
+        return content.split('\n').filter((l) => l.trim()).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Estimate context usage for orchestration.
+ *
+ * @param taskCount - Number of tasks to estimate for
+ * @param projectRoot - The project root directory
+ * @param epicId - Optional epic ID for scoped estimation
+ * @returns Context estimation with recommendations
+ */
+export function estimateContext(taskCount, projectRoot, epicId) {
+    const estimatedTokens = taskCount * 100;
+    const manifestEntries = countManifestEntries(projectRoot);
+    return {
+        epicId: epicId || null,
+        taskCount,
+        manifestEntries,
+        estimatedTokens,
+        recommendation: estimatedTokens > 5000
+            ? 'Consider using manifest summaries instead of full task details'
+            : 'Context usage is within recommended limits',
+        limits: {
+            orchestratorBudget: 10000,
+            maxFilesPerAgent: 3,
+            currentUsage: estimatedTokens,
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/orchestration/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/orchestration/context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAgBxE;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,YAAY,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,WAAmB,EACnB,MAAe;IAEf,MAAM,eAAe,GAAG,SAAS,GAAG,GAAG,CAAC;IACxC,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAE1D,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,IAAI;QACtB,SAAS;QACT,eAAe;QACf,eAAe;QACf,cAAc,EACZ,eAAe,GAAG,IAAI;YACpB,CAAC,CAAC,gEAAgE;YAClE,CAAC,CAAC,4CAA4C;QAClD,MAAM,EAAE;YACN,kBAAkB,EAAE,KAAK;YACzB,gBAAgB,EAAE,CAAC;YACnB,YAAY,EAAE,eAAe;SAC9B;KACF,CAAC;AACJ,CAAC"}

package/dist/orchestration/critical-path.js

@@ -0,0 +1,100 @@
+/**
+ * Critical path analysis for task dependency graphs.
+ * @task T4784
+ */
+import { getAccessor } from '../store/data-accessor.js';
+/** Find the critical path (longest dependency chain) in the task graph. */
+export async function getCriticalPath(cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const { tasks } = await acc.queryTasks({});
+    if (tasks.length === 0) {
+        return { path: [], length: 0, totalEffort: 0, completedInPath: 0, remainingInPath: 0 };
+    }
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    // Build dependency maps
+    const dependsOn = new Map();
+    const dependents = new Map();
+    for (const task of tasks) {
+        if (!dependsOn.has(task.id))
+            dependsOn.set(task.id, new Set());
+        if (!dependents.has(task.id))
+            dependents.set(task.id, new Set());
+        if (task.depends) {
+            for (const dep of task.depends) {
+                dependsOn.get(task.id).add(dep);
+                if (!dependents.has(dep))
+                    dependents.set(dep, new Set());
+                dependents.get(dep).add(task.id);
+            }
+        }
+    }
+    // Find longest path using DFS with memoization
+    const memo = new Map();
+    function longestPathEndingAt(taskId, visited) {
+        if (memo.has(taskId))
+            return memo.get(taskId);
+        if (visited.has(taskId))
+            return [taskId]; // circular
+        visited.add(taskId);
+        const deps = dependsOn.get(taskId) || new Set();
+        let longest = [];
+        for (const dep of deps) {
+            if (taskMap.has(dep)) {
+                const path = longestPathEndingAt(dep, visited);
+                if (path.length > longest.length)
+                    longest = path;
+            }
+        }
+        visited.delete(taskId);
+        const result = [...longest, taskId];
+        memo.set(taskId, result);
+        return result;
+    }
+    // Find leaf nodes
+    const leafNodes = tasks.filter((t) => {
+        const deps = dependents.get(t.id);
+        return !deps || deps.size === 0;
+    });
+    let criticalPath = [];
+    for (const leaf of leafNodes) {
+        const path = longestPathEndingAt(leaf.id, new Set());
+        if (path.length > criticalPath.length)
+            criticalPath = path;
+    }
+    if (criticalPath.length === 0) {
+        for (const task of tasks) {
+            const path = longestPathEndingAt(task.id, new Set());
+            if (path.length > criticalPath.length)
+                criticalPath = path;
+        }
+    }
+    const sizeWeights = { small: 1, medium: 3, large: 8 };
+    const annotatedPath = criticalPath.map((taskId) => {
+        const task = taskMap.get(taskId);
+        const size = task?.size || 'medium';
+        const incompleteDeps = (task?.depends || []).filter((dep) => {
+            const depTask = taskMap.get(dep);
+            return depTask && depTask.status !== 'done' && depTask.status !== 'cancelled';
+        });
+        return {
+            taskId,
+            title: task?.title || taskId,
+            status: task?.status || 'unknown',
+            size,
+            blockerCount: incompleteDeps.length,
+        };
+    });
+    const completedInPath = annotatedPath.filter((t) => t.status === 'done' || t.status === 'cancelled').length;
+    const remainingInPath = annotatedPath.length - completedInPath;
+    const totalEffort = annotatedPath
+        .filter((t) => t.status !== 'done' && t.status !== 'cancelled')
+        .reduce((sum, t) => sum + (sizeWeights[t.size] ?? 3), 0);
+    return {
+        path: annotatedPath,
+        length: criticalPath.length,
+        totalEffort,
+        completedInPath,
+        remainingInPath,
+    };
+}
+//# sourceMappingURL=critical-path.js.map

package/dist/orchestration/critical-path.js.map

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

package/dist/orchestration/hierarchy.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OrchestrationHierarchyImpl — Concrete implementation of the 5-level hierarchy.
+ *
+ * Loads the agent matrix from agent-matrix.json (if available) or uses
+ * the built-in default matrix. Provides escalation chain resolution,
+ * authority checks, and project scoping.
+ *
+ * @see docs/specs/CLEO-ORCH-PLAN.md
+ * @task T217
+ */
+import type { AgentHierarchy, AgentHierarchyEntry, EscalationChain, OrchestrationHierarchyAPI } from '@cleocode/contracts';
+import { OrchestrationLevel } from '@cleocode/contracts';
+/** Concrete implementation of OrchestrationHierarchyAPI. */
+export declare class OrchestrationHierarchyImpl implements OrchestrationHierarchyAPI {
+    private hierarchy;
+    constructor(hierarchy?: AgentHierarchy);
+    /** Get the full hierarchy. */
+    getHierarchy(): AgentHierarchy;
+    /** Get a single agent's hierarchy entry. */
+    getAgent(agentId: string): AgentHierarchyEntry | null;
+    /** Get all agents at a specific level. */
+    getAgentsAtLevel(level: OrchestrationLevel): AgentHierarchyEntry[];
+    /** Get the escalation chain for an agent (nearest authority first). */
+    getEscalationChain(agentId: string): EscalationChain;
+    /** Get all agents directly managed by a specific agent. */
+    getDirectReports(agentId: string): AgentHierarchyEntry[];
+    /** Check if agent A has authority over agent B (A is in B's escalation chain). */
+    hasAuthority(agentIdA: string, agentIdB: string): boolean;
+    /** Get all agents scoped to a project. */
+    getProjectAgents(projectId: string): AgentHierarchyEntry[];
+}
+//# sourceMappingURL=hierarchy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/orchestration/hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA4HzD,4DAA4D;AAC5D,qBAAa,0BAA2B,YAAW,yBAAyB;IAC1E,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,CAAC,EAAE,cAAc;IAItC,8BAA8B;IAC9B,YAAY,IAAI,cAAc;IAI9B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIrD,0CAA0C;IAC1C,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,EAAE;IAIlE,uEAAuE;IACvE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAgBpD,2DAA2D;IAC3D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE;IASxD,kFAAkF;IAClF,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKzD,0CAA0C;IAC1C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;CAG3D"}

package/dist/orchestration/index.d.ts

@@ -9,6 +9,7 @@ export type { CircularDependency, DependencyAnalysis, MissingDependency } from '
 export { analyzeDependencies, buildDependencyGraph, detectCircularDependencies, findMissingDependencies, } from './analyze.js';
 export type { ContextEstimation } from './context.js';
 export { countManifestEntries, estimateContext } from './context.js';
+export { OrchestrationHierarchyImpl } from './hierarchy.js';
 export type { EpicStatus, OverallStatus, ProgressMetrics, StartupSummary, StatusCounts, } from './status.js';
 export { computeEpicStatus, computeOverallStatus, computeProgress, computeStartupSummary, countByStatus, } from './status.js';
 /** Orchestrator session state. */