@cleocode/cleo 2026.2.5

package/dist/core/orchestration/index.js

@@ -0,0 +1,295 @@
+/**
+ * Orchestrator commands - coordinate multi-agent workflows.
+ * @task T4466
+ * @epic T4454
+ */
+import { readJsonRequired } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getTodoPath } from '../paths.js';
+import { getExecutionWaves } from '../phases/deps.js';
+/**
+ * Start an orchestrator session for an epic.
+ * @task T4466
+ */
+export async function startOrchestration(epicId, cwd, accessor) {
+    const data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const epic = data.tasks.find(t => t.id === 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 data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const epic = data.tasks.find(t => t.id === epicId);
+    if (!epic) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Epic not found: ${epicId}`);
+    }
+    const childTasks = data.tasks.filter(t => t.parentId === epicId);
+    const waves = await getExecutionWaves(epicId, cwd);
+    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 data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const childTasks = data.tasks.filter(t => t.parentId === epicId);
+    const completedIds = new Set(data.tasks.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 data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const task = data.tasks.find(t => t.id === 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 data = accessor
+        ? await accessor.loadTodoFile()
+        : await readJsonRequired(getTodoPath(cwd));
+    const epic = data.tasks.find(t => t.id === epicId);
+    if (!epic) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Epic not found: ${epicId}`);
+    }
+    const children = data.tasks.filter(t => t.parentId === 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. Set focus: \`cleo focus set ${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;
+    let match;
+    while ((match = tokenRegex.exec(prompt)) !== null) {
+        tokens.push(match[1]);
+    }
+    const refRegex = /@([a-zA-Z0-9_./\-]+\.md)/g;
+    while ((match = refRegex.exec(prompt)) !== null) {
+        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/core/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA8CtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,GAAY,EACZ,QAAuB;IAEvB,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,aAAa,EACtB,QAAQ,MAAM,0BAA0B,IAAI,CAAC,IAAI,GAAG,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAwB;QACnC,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,EAAE;KAClB,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,GAAY,EAAE,QAAuB;IACrF,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnD,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEnF,wDAAwD;IACxD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,UAAU;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE;QACV,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;QAClE,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAElB,OAAO;QACL,MAAM;QACN,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC1E,CAAC,CAAC;QACH,UAAU;QACV,YAAY;QACZ,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,GAAY,EAAE,QAAuB;IACvF,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3D,CAAC;IAEF,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;SAC5D,GAAG,CAAC,IAAI,CAAC,EAAE;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAEpC,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;YAC7B,QAAQ,EAAE,SAAS;YACnB,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,GAAY,EAAE,QAAuB;IACrF,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,GAAY,EAAE,QAAuB;IACtF,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEhD,8BAA8B;IAC9B,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO;QACL,MAAM;QACN,QAAQ;QACR,MAAM;QACN,eAAe,EAAE;YACf,aAAa,EAAE,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAC5C,gBAAgB;SACjB;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,MAAkD;IAElD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAc,EAAE,GAAY,EAAE,QAAuB;IAUhG,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEpE,OAAO;QACL,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,UAAU,EAAE,QAAQ,CAAC,MAAM;QAC3B,SAAS;QACT,UAAU;QACV,OAAO;QACP,OAAO;QACP,iBAAiB,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,yBAAyB;AAEzB,iCAAiC;AACjC,MAAM,YAAY,GAA6D;IAC7E,QAAQ,EAAE;QACR,QAAQ,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;QACpE,MAAM,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,UAAU,CAAC;KAClD;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC;QACrD,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC;KAC5C;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC;QACpD,MAAM,EAAE,CAAC,eAAe,EAAE,QAAQ,EAAE,KAAK,CAAC;KAC3C;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;QACpD,MAAM,EAAE,CAAC,eAAe,EAAE,UAAU,EAAE,MAAM,CAAC;KAC9C;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAC5E,MAAM,EAAE,CAAC,gBAAgB,EAAE,aAAa,EAAE,QAAQ,CAAC;KACpD;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC;QACjD,MAAM,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC;KACxC;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KAChD;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,6CAA6C;IAC7C,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9D,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC;IAEjD,4BAA4B;IAC5B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IACrE,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,cAAc;IACd,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAU,EAAE,QAAgB;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,OAAO;QACL,YAAY,IAAI,CAAC,EAAE,EAAE;QACrB,cAAc,IAAI,CAAC,KAAK,EAAE;QAC1B,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;QAC9D,iBAAiB,QAAQ,EAAE;QAC3B,aAAa,MAAM,EAAE;QACrB,aAAa,IAAI,EAAE;QACnB,EAAE;QACF,kBAAkB;QAClB,kCAAkC,IAAI,CAAC,EAAE,IAAI;QAC7C,kBAAkB,QAAQ,WAAW;QACrC,sBAAsB;QACtB,4CAA4C;QAC5C,gCAAgC,IAAI,CAAC,EAAE,IAAI;QAC3C,EAAE;QACF,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,4BAA4B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC1G,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KAC9F,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,oBAAoB,CAAC;IACxC,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,QAAQ,GAAG,2BAA2B,CAAC;IAC7C,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,OAA+B;IAE/B,IAAI,QAAQ,GAAG,MAAM,CAAC;IACtB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,SAAS,EAAE,KAAa,EAAE,EAAE;QAC7E,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,KAAK,CAAE,CAAC;QACzB,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/orchestration/protocol-validators.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Protocol validators for all 9 CLEO protocols.
+ * Validates manifest entries and outputs against protocol requirements.
+ *
+ * @task T4499
+ * @epic T4498
+ */
+import { ExitCode } from '../../types/exit-codes.js';
+/** Protocol violation entry. */
+export interface ProtocolViolation {
+    requirement: string;
+    severity: 'error' | 'warning';
+    message: string;
+    fix: string;
+}
+/** Protocol validation result. */
+export interface ProtocolValidationResult {
+    valid: boolean;
+    protocol: string;
+    violations: ProtocolViolation[];
+    score: number;
+}
+/** Manifest entry structure for validation. */
+export interface ManifestEntryInput {
+    id?: string;
+    file?: string;
+    title?: string;
+    date?: string;
+    status?: string;
+    agent_type?: string;
+    topics?: string[];
+    key_findings?: string[];
+    actionable?: boolean;
+    needs_followup?: string[];
+    linked_tasks?: string[];
+    sources?: string[];
+}
+/** All supported protocol types. */
+export declare const PROTOCOL_TYPES: readonly ["research", "consensus", "specification", "decomposition", "implementation", "contribution", "release", "artifact-publish", "provenance"];
+export type ProtocolType = typeof PROTOCOL_TYPES[number];
+/** Map protocol types to exit codes. */
+export declare const PROTOCOL_EXIT_CODES: Record<ProtocolType, ExitCode>;
+/** @task T4499 */
+export declare function validateResearchProtocol(entry: ManifestEntryInput, options?: {
+    strict?: boolean;
+    hasCodeChanges?: boolean;
+}): ProtocolValidationResult;
+export interface VotingMatrix {
+    options: Array<{
+        name: string;
+        confidence: number;
+        rationale?: string;
+    }>;
+    threshold?: number;
+}
+/** @task T4499 */
+export declare function validateConsensusProtocol(entry: ManifestEntryInput, votingMatrix?: VotingMatrix): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateSpecificationProtocol(entry: ManifestEntryInput, specContent?: string): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateDecompositionProtocol(entry: ManifestEntryInput, options?: {
+    siblingCount?: number;
+    descriptionClarity?: boolean;
+}): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateImplementationProtocol(entry: ManifestEntryInput, options?: {
+    hasTaskTags?: boolean;
+}): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateContributionProtocol(entry: ManifestEntryInput, options?: {
+    hasContributionTags?: boolean;
+}): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateReleaseProtocol(entry: ManifestEntryInput, options?: {
+    version?: string;
+    hasChangelog?: boolean;
+}): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateArtifactPublishProtocol(entry: ManifestEntryInput, options?: {
+    artifactType?: string;
+    buildPassed?: boolean;
+}): ProtocolValidationResult;
+/** @task T4499 */
+export declare function validateProvenanceProtocol(entry: ManifestEntryInput, options?: {
+    hasAttestation?: boolean;
+    hasSbom?: boolean;
+}): ProtocolValidationResult;
+/**
+ * Validate a manifest entry against a specific protocol.
+ * Throws CleoError with appropriate exit code on strict failure.
+ * @task T4499
+ */
+export declare function validateProtocol(protocol: ProtocolType, entry: ManifestEntryInput, options?: Record<string, unknown>, strict?: boolean): ProtocolValidationResult;
+//# sourceMappingURL=protocol-validators.d.ts.map

package/dist/core/orchestration/protocol-validators.d.ts.map

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