@cleocode/core 2026.4.9 → 2026.4.12

package/dist/orchestration/hierarchy.js

@@ -0,0 +1,183 @@
+/**
+ * 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 { OrchestrationLevel } from '@cleocode/contracts';
+/**
+ * Default agent hierarchy matching PRIME's agent matrix (Agenda 10).
+ *
+ * This is the canonical hierarchy as of 2026-03-30:
+ *   Owner (HITL)
+ *     └── cleoos-opus-orchestrator (PRIME)
+ *           ├── cleo-rust-lead → cleo-dev
+ *           ├── cleo-db-lead → signaldock-backend
+ *           ├── cleo-historian
+ *           └── signaldock-core-agent → signaldock-backend, signaldock-dev, signaldock-frontend
+ */
+function buildDefaultHierarchy() {
+    const agents = {
+        owner: {
+            agentId: 'owner',
+            displayName: 'Owner (HITL)',
+            level: OrchestrationLevel.HITL,
+            reportsTo: null,
+            manages: ['cleoos-opus-orchestrator'],
+            projectId: null,
+            teamId: null,
+            canSpawn: false,
+        },
+        'cleoos-opus-orchestrator': {
+            agentId: 'cleoos-opus-orchestrator',
+            displayName: 'PRIME Orchestrator',
+            level: OrchestrationLevel.Prime,
+            reportsTo: 'owner',
+            manages: ['cleo-rust-lead', 'cleo-db-lead', 'cleo-historian', 'signaldock-core-agent'],
+            projectId: null,
+            teamId: null,
+            canSpawn: true,
+        },
+        'cleo-rust-lead': {
+            agentId: 'cleo-rust-lead',
+            displayName: 'Cleo Rust Lead',
+            level: OrchestrationLevel.ProjectLead,
+            reportsTo: 'cleoos-opus-orchestrator',
+            manages: ['cleo-dev'],
+            projectId: 'cleocode',
+            teamId: 'cleocode',
+            canSpawn: true,
+        },
+        'cleo-db-lead': {
+            agentId: 'cleo-db-lead',
+            displayName: 'Cleo DB Lead',
+            level: OrchestrationLevel.ProjectLead,
+            reportsTo: 'cleoos-opus-orchestrator',
+            manages: ['signaldock-backend'],
+            projectId: 'cleocode',
+            teamId: 'cleocode',
+            canSpawn: true,
+        },
+        'cleo-historian': {
+            agentId: 'cleo-historian',
+            displayName: 'Cleo Historian',
+            level: OrchestrationLevel.TeamLead,
+            reportsTo: 'cleoos-opus-orchestrator',
+            manages: [],
+            projectId: 'cleocode',
+            teamId: 'cleocode',
+            canSpawn: false,
+        },
+        'cleo-dev': {
+            agentId: 'cleo-dev',
+            displayName: 'Cleo Dev',
+            level: OrchestrationLevel.TeamLead,
+            reportsTo: 'cleo-rust-lead',
+            manages: [],
+            projectId: 'cleocode',
+            teamId: 'cleocode',
+            canSpawn: true,
+        },
+        'signaldock-core-agent': {
+            agentId: 'signaldock-core-agent',
+            displayName: 'SignalDock Core Agent',
+            level: OrchestrationLevel.ProjectLead,
+            reportsTo: 'cleoos-opus-orchestrator',
+            manages: ['signaldock-backend', 'signaldock-dev', 'signaldock-frontend'],
+            projectId: 'signaldock',
+            teamId: 'signaldock',
+            canSpawn: true,
+        },
+        'signaldock-backend': {
+            agentId: 'signaldock-backend',
+            displayName: 'SignalDock Backend',
+            level: OrchestrationLevel.TeamLead,
+            reportsTo: 'signaldock-core-agent',
+            manages: [],
+            projectId: 'signaldock',
+            teamId: 'signaldock',
+            canSpawn: false,
+        },
+        'signaldock-dev': {
+            agentId: 'signaldock-dev',
+            displayName: 'SignalDock Dev',
+            level: OrchestrationLevel.TeamLead,
+            reportsTo: 'signaldock-core-agent',
+            manages: [],
+            projectId: 'signaldock',
+            teamId: 'signaldock',
+            canSpawn: false,
+        },
+        'signaldock-frontend': {
+            agentId: 'signaldock-frontend',
+            displayName: 'SignalDock Frontend',
+            level: OrchestrationLevel.TeamLead,
+            reportsTo: 'signaldock-core-agent',
+            manages: [],
+            projectId: 'signaldock',
+            teamId: 'signaldock',
+            canSpawn: false,
+        },
+    };
+    return {
+        agents,
+        primeId: 'cleoos-opus-orchestrator',
+        projectIds: ['cleocode', 'signaldock'],
+    };
+}
+/** Concrete implementation of OrchestrationHierarchyAPI. */
+export class OrchestrationHierarchyImpl {
+    hierarchy;
+    constructor(hierarchy) {
+        this.hierarchy = hierarchy ?? buildDefaultHierarchy();
+    }
+    /** Get the full hierarchy. */
+    getHierarchy() {
+        return this.hierarchy;
+    }
+    /** Get a single agent's hierarchy entry. */
+    getAgent(agentId) {
+        return this.hierarchy.agents[agentId] ?? null;
+    }
+    /** Get all agents at a specific level. */
+    getAgentsAtLevel(level) {
+        return Object.values(this.hierarchy.agents).filter((a) => a.level === level);
+    }
+    /** Get the escalation chain for an agent (nearest authority first). */
+    getEscalationChain(agentId) {
+        const chain = [];
+        let current = this.hierarchy.agents[agentId];
+        while (current?.reportsTo) {
+            chain.push(current.reportsTo);
+            current = this.hierarchy.agents[current.reportsTo];
+        }
+        return {
+            fromAgentId: agentId,
+            chain,
+            finalAuthority: chain.length > 0 ? chain[chain.length - 1] : agentId,
+        };
+    }
+    /** Get all agents directly managed by a specific agent. */
+    getDirectReports(agentId) {
+        const agent = this.hierarchy.agents[agentId];
+        if (!agent)
+            return [];
+        return agent.manages
+            .map((id) => this.hierarchy.agents[id])
+            .filter((a) => a !== undefined);
+    }
+    /** Check if agent A has authority over agent B (A is in B's escalation chain). */
+    hasAuthority(agentIdA, agentIdB) {
+        const chain = this.getEscalationChain(agentIdB);
+        return chain.chain.includes(agentIdA);
+    }
+    /** Get all agents scoped to a project. */
+    getProjectAgents(projectId) {
+        return Object.values(this.hierarchy.agents).filter((a) => a.projectId === projectId);
+    }
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/orchestration/hierarchy.js.map

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

package/dist/orchestration/index.js

@@ -0,0 +1,287 @@
+/**
+ * Orchestrator commands - coordinate multi-agent workflows.
+ * @task T4466
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getExecutionWaves } from '../phases/deps.js';
+// Re-export new core modules for barrel access
+export { analyzeDependencies, buildDependencyGraph, detectCircularDependencies, findMissingDependencies, } from './analyze.js';
+export { countManifestEntries, estimateContext } from './context.js';
+export { OrchestrationHierarchyImpl } from './hierarchy.js';
+export { computeEpicStatus, computeOverallStatus, computeProgress, computeStartupSummary, countByStatus, } from './status.js';
+/**
+ * Start an orchestrator session for an epic.
+ * @task T4466
+ */
+export async function startOrchestration(epicId, _cwd, accessor) {
+    const epic = await accessor.loadSingleTask(epicId);
+    if (!epic) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Epic not found: ${epicId}`);
+    }
+    if (epic.type !== 'epic') {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Task ${epicId} is not an epic (type: ${epic.type})`);
+    }
+    const session = {
+        epicId,
+        startedAt: new Date().toISOString(),
+        status: 'active',
+        currentWave: 1,
+        completedTasks: [],
+        spawnedAgents: [],
+    };
+    return session;
+}
+/**
+ * Analyze an epic's dependency structure.
+ * @task T4466
+ */
+export async function analyzeEpic(epicId, cwd, accessor) {
+    const epic = await accessor.loadSingleTask(epicId);
+    if (!epic) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Epic not found: ${epicId}`);
+    }
+    const childTasks = await accessor.getChildren(epicId);
+    const waves = await getExecutionWaves(epicId, cwd, accessor);
+    const completedTasks = childTasks.filter((t) => t.status === 'done').map((t) => t.id);
+    const blockedTasks = childTasks.filter((t) => t.status === 'blocked').map((t) => t.id);
+    // Find ready tasks (all deps complete, not yet started)
+    const completedSet = new Set(completedTasks);
+    const readyTasks = childTasks
+        .filter((t) => {
+        if (t.status === 'done' || t.status === 'cancelled')
+            return false;
+        const deps = t.depends ?? [];
+        return deps.every((d) => completedSet.has(d));
+    })
+        .map((t) => t.id);
+    return {
+        epicId,
+        totalTasks: childTasks.length,
+        waves: waves.map((w) => ({
+            wave: w.wave,
+            tasks: w.tasks.map((t) => ({ id: t.id, title: t.title, status: t.status })),
+        })),
+        readyTasks,
+        blockedTasks,
+        completedTasks,
+    };
+}
+/**
+ * Get parallel-safe ready tasks for an epic.
+ * @task T4466
+ */
+export async function getReadyTasks(epicId, _cwd, accessor) {
+    const childTasks = await accessor.getChildren(epicId);
+    const { tasks: allTasks } = await accessor.queryTasks({});
+    const completedIds = new Set(allTasks.filter((t) => t.status === 'done').map((t) => t.id));
+    return childTasks
+        .filter((t) => t.status !== 'done' && t.status !== 'cancelled')
+        .map((task) => {
+        const deps = task.depends ?? [];
+        const unmetDeps = deps.filter((d) => !completedIds.has(d));
+        const protocol = autoDispatch(task);
+        return {
+            taskId: task.id,
+            title: task.title,
+            ready: unmetDeps.length === 0,
+            blockers: unmetDeps,
+            protocol,
+        };
+    });
+}
+/**
+ * Get the next task to work on for an epic.
+ * @task T4466
+ */
+export async function getNextTask(epicId, cwd, accessor) {
+    const readyTasks = await getReadyTasks(epicId, cwd, accessor);
+    const ready = readyTasks.filter((t) => t.ready);
+    if (ready.length === 0)
+        return null;
+    return ready[0];
+}
+/**
+ * Prepare a spawn context for a subagent.
+ * @task T4466
+ */
+export async function prepareSpawn(taskId, _cwd, accessor) {
+    const task = await accessor.loadSingleTask(taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task not found: ${taskId}`);
+    }
+    const protocol = autoDispatch(task);
+    const prompt = buildSpawnPrompt(task, protocol);
+    // Check for unresolved tokens
+    const unresolvedTokens = findUnresolvedTokens(prompt);
+    return {
+        taskId,
+        protocol,
+        prompt,
+        tokenResolution: {
+            fullyResolved: unresolvedTokens.length === 0,
+            unresolvedTokens,
+        },
+    };
+}
+/**
+ * Validate a subagent's output.
+ * @task T4466
+ */
+export async function validateSpawnOutput(_taskId, output) {
+    const errors = [];
+    if (!output.file) {
+        errors.push('No output file specified');
+    }
+    if (!output.manifestEntry) {
+        errors.push('No manifest entry appended');
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Get orchestrator context summary.
+ * @task T4466
+ */
+export async function getOrchestratorContext(epicId, _cwd, accessor) {
+    const epic = await accessor.loadSingleTask(epicId);
+    if (!epic) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Epic not found: ${epicId}`);
+    }
+    const children = await accessor.getChildren(epicId);
+    const completed = children.filter((t) => t.status === 'done').length;
+    const inProgress = children.filter((t) => t.status === 'active').length;
+    const blocked = children.filter((t) => t.status === 'blocked').length;
+    const pending = children.filter((t) => t.status === 'pending').length;
+    return {
+        epicId,
+        epicTitle: epic.title,
+        totalTasks: children.length,
+        completed,
+        inProgress,
+        blocked,
+        pending,
+        completionPercent: children.length > 0 ? Math.floor((completed * 100) / children.length) : 0,
+    };
+}
+// === SKILL DISPATCH ===
+/** Protocol dispatch mapping. */
+const DISPATCH_MAP = {
+    research: {
+        keywords: ['research', 'investigate', 'explore', 'analyze', 'study'],
+        labels: ['research', 'investigation', 'analysis'],
+    },
+    consensus: {
+        keywords: ['vote', 'validate', 'decide', 'consensus'],
+        labels: ['consensus', 'voting', 'decision'],
+    },
+    specification: {
+        keywords: ['spec', 'rfc', 'design', 'specification'],
+        labels: ['specification', 'design', 'rfc'],
+    },
+    decomposition: {
+        keywords: ['epic', 'plan', 'decompose', 'breakdown'],
+        labels: ['decomposition', 'planning', 'epic'],
+    },
+    implementation: {
+        keywords: ['implement', 'build', 'create', 'code', 'develop', 'port', 'fix'],
+        labels: ['implementation', 'development', 'coding'],
+    },
+    contribution: {
+        keywords: ['pr', 'merge', 'shared', 'contribute'],
+        labels: ['contribution', 'pr', 'merge'],
+    },
+    release: {
+        keywords: ['release', 'version', 'publish', 'ship'],
+        labels: ['release', 'versioning', 'publishing'],
+    },
+};
+/**
+ * Auto-dispatch: determine the protocol for a task based on metadata.
+ * @task T4466
+ */
+export function autoDispatch(task) {
+    // 1. Label-based dispatch (highest priority)
+    if (task.labels?.length) {
+        for (const [protocol, config] of Object.entries(DISPATCH_MAP)) {
+            if (task.labels.some((l) => config.labels.includes(l))) {
+                return protocol;
+            }
+        }
+    }
+    // 2. Type-based dispatch
+    if (task.type === 'epic')
+        return 'decomposition';
+    // 3. Keyword-based dispatch
+    const text = `${task.title} ${task.description ?? ''}`.toLowerCase();
+    for (const [protocol, config] of Object.entries(DISPATCH_MAP)) {
+        if (config.keywords.some((kw) => text.includes(kw))) {
+            return protocol;
+        }
+    }
+    // 4. Fallback
+    return 'implementation';
+}
+/**
+ * Build a spawn prompt for a subagent.
+ * @task T4466
+ */
+function buildSpawnPrompt(task, protocol) {
+    const epicId = task.parentId ?? 'none';
+    const date = new Date().toISOString().split('T')[0];
+    return [
+        `## Task: ${task.id}`,
+        `**Title**: ${task.title}`,
+        task.description ? `**Description**: ${task.description}` : '',
+        `**Protocol**: ${protocol}`,
+        `**Epic**: ${epicId}`,
+        `**Date**: ${date}`,
+        '',
+        `### Instructions`,
+        `1. Start task: \`cleo start ${task.id}\``,
+        `2. Execute the ${protocol} protocol`,
+        `3. Write output file`,
+        `4. Append manifest entry to MANIFEST.jsonl`,
+        `5. Complete: \`cleo complete ${task.id}\``,
+        '',
+        task.acceptance?.length
+            ? `### Acceptance Criteria\n${task.acceptance.map((a) => `- ${a}`).join('\n')}`
+            : '',
+        task.depends?.length ? `### Dependencies\n${task.depends.map((d) => `- ${d}`).join('\n')}` : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+/**
+ * Find unresolved tokens in a prompt.
+ * @task T4466
+ */
+function findUnresolvedTokens(prompt) {
+    const tokens = [];
+    const tokenRegex = /\{\{([A-Z_]+)\}\}/g;
+    for (const match of prompt.matchAll(tokenRegex)) {
+        tokens.push(match[1]);
+    }
+    const refRegex = /@([a-zA-Z0-9_./-]+\.md)/g;
+    for (const match of prompt.matchAll(refRegex)) {
+        tokens.push(`@${match[1]}`);
+    }
+    return tokens;
+}
+/**
+ * Resolve tokens in a prompt string.
+ * @task T4466
+ */
+export function resolveTokens(prompt, context) {
+    let resolved = prompt;
+    const unresolved = [];
+    resolved = resolved.replace(/\{\{([A-Z_]+)\}\}/g, (fullMatch, token) => {
+        if (context[token] !== undefined) {
+            return context[token];
+        }
+        unresolved.push(token);
+        return fullMatch;
+    });
+    return { resolved, unresolved };
+}
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

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

package/dist/orchestration/parallel.js

@@ -0,0 +1,89 @@
+/**
+ * Parallel execution state management.
+ * @task T4784
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+import { computeWaves } from './waves.js';
+const PARALLEL_STATE_KEY = 'parallel_state';
+async function readParallelState(accessor) {
+    const state = await accessor.getMetaValue(PARALLEL_STATE_KEY);
+    return state ?? { active: false };
+}
+async function writeParallelState(state, accessor) {
+    await accessor.setMetaValue(PARALLEL_STATE_KEY, state);
+}
+/** Start parallel execution for a wave. */
+export async function startParallelExecution(epicId, wave, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const currentState = await readParallelState(acc);
+    if (currentState.active) {
+        throw new CleoError(ExitCode.GENERAL_ERROR, `Parallel execution already active for epic ${currentState.epicId}, wave ${currentState.wave}`);
+    }
+    const epic = await acc.loadSingleTask(epicId);
+    if (!epic) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Epic ${epicId} not found`);
+    }
+    const children = await acc.getChildren(epicId);
+    const waves = computeWaves(children);
+    const targetWave = waves.find((w) => w.waveNumber === wave);
+    if (!targetWave) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Wave ${wave} not found for epic ${epicId}`);
+    }
+    const startedAt = new Date().toISOString();
+    const state = {
+        active: true,
+        epicId,
+        wave,
+        startedAt,
+        tasks: targetWave.tasks,
+    };
+    await writeParallelState(state, acc);
+    return {
+        epicId,
+        wave,
+        tasks: targetWave.tasks,
+        taskCount: targetWave.tasks.length,
+        startedAt,
+    };
+}
+/** End parallel execution for a wave. */
+export async function endParallelExecution(epicId, wave, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const currentState = await readParallelState(acc);
+    if (!currentState.active) {
+        return {
+            epicId,
+            wave,
+            tasks: [],
+            taskCount: 0,
+            startedAt: null,
+            endedAt: new Date().toISOString(),
+            durationMs: 0,
+            alreadyEnded: true,
+        };
+    }
+    if (currentState.epicId !== epicId || currentState.wave !== wave) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Active parallel is for epic ${currentState.epicId} wave ${currentState.wave}, not epic ${epicId} wave ${wave}`);
+    }
+    const duration = currentState.startedAt
+        ? Date.now() - new Date(currentState.startedAt).getTime()
+        : 0;
+    await writeParallelState({ active: false }, acc);
+    return {
+        epicId,
+        wave,
+        tasks: currentState.tasks || [],
+        taskCount: currentState.tasks?.length || 0,
+        startedAt: currentState.startedAt || null,
+        endedAt: new Date().toISOString(),
+        durationMs: duration,
+    };
+}
+/** Get current parallel execution state. */
+export async function getParallelStatus(cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    return readParallelState(acc);
+}
+//# sourceMappingURL=parallel.js.map

package/dist/orchestration/parallel.js.map

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