@cleocode/core 2026.3.76 → 2026.4.0

package/dist/skills/manifests/contribution.js

@@ -0,0 +1,175 @@
+/**
+ * Multi-agent contribution protocol.
+ * Ports lib/skills/contribution-protocol.sh.
+ *
+ * Implements the contribution protocol for multi-agent research coordination:
+ * template instantiation, task validation, injection block generation,
+ * conflict detection, and consensus computation.
+ *
+ * @epic T4454
+ * @task T4520
+ */
+import { randomBytes } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { getAccessor } from '../../store/data-accessor.js';
+// ============================================================================
+// Contribution Protocol
+// ============================================================================
+/**
+ * Generate a unique contribution ID.
+ * @task T4520
+ */
+export function generateContributionId(taskId) {
+    const hash = randomBytes(4).toString('hex');
+    const date = new Date().toISOString().split('T')[0];
+    return `contrib-${taskId}-${date}-${hash}`;
+}
+/**
+ * Validate that a task is suitable for contribution protocol.
+ * @task T4520
+ */
+export async function validateContributionTask(taskId, cwd) {
+    const issues = [];
+    const acc = await getAccessor(cwd);
+    const task = await acc.loadSingleTask(taskId);
+    if (!task) {
+        return { valid: false, issues: [`Task ${taskId} not found`] };
+    }
+    // Must be pending or active
+    if (task.status !== 'pending' && task.status !== 'active') {
+        issues.push(`Task status is ${task.status}, expected pending or active`);
+    }
+    // Should have a description
+    if (!task.description) {
+        issues.push('Task missing description');
+    }
+    return { valid: issues.length === 0, issues };
+}
+/**
+ * Generate the contribution injection block for a subagent prompt.
+ * @task T4520
+ */
+export function getContributionInjection(taskId, protocolPath, _cwd) {
+    const lines = [
+        '---',
+        '## CONTRIBUTION PROTOCOL',
+        '',
+        `**Task**: ${taskId}`,
+        `**Protocol**: contribution`,
+        `**Generated**: ${new Date().toISOString()}`,
+        '',
+        '### Requirements',
+        '- Tag all new functions with @task and @contribution markers',
+        '- Provide rationale for all decisions',
+        '- Report confidence levels (0.0-1.0)',
+        '- Document any conflicts with prior agent outputs',
+        '',
+    ];
+    if (protocolPath && existsSync(protocolPath)) {
+        lines.push('### Protocol Details');
+        lines.push('');
+        lines.push(readFileSync(protocolPath, 'utf-8'));
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+/**
+ * Detect conflicts between two sets of decisions.
+ * @task T4520
+ */
+export function detectConflicts(decisions1, decisions2) {
+    const conflicts = [];
+    for (const d1 of decisions1) {
+        for (const d2 of decisions2) {
+            if (d1.taskId === d2.taskId && d1.decision !== d2.decision) {
+                const confDiff = Math.abs(d1.confidence - d2.confidence);
+                const severity = confDiff > 0.5 ? 'high' : confDiff > 0.2 ? 'medium' : 'low';
+                conflicts.push({
+                    field: 'decision',
+                    agent1: d1.agentId,
+                    agent2: d2.agentId,
+                    value1: d1.decision,
+                    value2: d2.decision,
+                    severity,
+                });
+            }
+        }
+    }
+    return conflicts;
+}
+/**
+ * Compute weighted consensus from multiple agent decisions.
+ * @task T4520
+ */
+export function computeConsensus(decisions, weights) {
+    if (decisions.length === 0) {
+        return { decision: '', confidence: 0, votes: [], conflicts: [] };
+    }
+    // Build vote map: decision -> weighted score
+    const voteMap = new Map();
+    const votes = [];
+    for (const d of decisions) {
+        const weight = weights?.[d.agentId] ?? d.confidence;
+        const current = voteMap.get(d.decision) ?? 0;
+        voteMap.set(d.decision, current + weight);
+        votes.push({ agentId: d.agentId, weight, vote: d.decision });
+    }
+    // Find highest scoring decision
+    let bestDecision = '';
+    let bestScore = -1;
+    let totalWeight = 0;
+    for (const [decision, score] of voteMap) {
+        totalWeight += score;
+        if (score > bestScore) {
+            bestScore = score;
+            bestDecision = decision;
+        }
+    }
+    // Detect conflicts among decisions
+    const conflicts = [];
+    const uniqueDecisions = [...new Set(decisions.map((d) => d.decision))];
+    if (uniqueDecisions.length > 1) {
+        // Pairwise conflict detection
+        for (let i = 0; i < decisions.length; i++) {
+            for (let j = i + 1; j < decisions.length; j++) {
+                if (decisions[i].decision !== decisions[j].decision) {
+                    const confDiff = Math.abs(decisions[i].confidence - decisions[j].confidence);
+                    conflicts.push({
+                        field: 'decision',
+                        agent1: decisions[i].agentId,
+                        agent2: decisions[j].agentId,
+                        value1: decisions[i].decision,
+                        value2: decisions[j].decision,
+                        severity: confDiff > 0.5 ? 'high' : confDiff > 0.2 ? 'medium' : 'low',
+                    });
+                }
+            }
+        }
+    }
+    return {
+        decision: bestDecision,
+        confidence: totalWeight > 0 ? bestScore / totalWeight : 0,
+        votes,
+        conflicts,
+    };
+}
+/**
+ * Create a manifest entry for a contribution.
+ * @task T4520
+ */
+export function createContributionManifestEntry(taskId, contributionId, decisions) {
+    return {
+        id: contributionId,
+        file: `${contributionId}.md`,
+        title: `Contribution for ${taskId}`,
+        date: new Date().toISOString().split('T')[0],
+        status: 'completed',
+        agent_type: 'contribution',
+        topics: ['contribution', 'multi-agent'],
+        key_findings: decisions.map((d) => `${d.agentId}: ${d.decision} (conf: ${d.confidence})`),
+        actionable: true,
+        needs_followup: [],
+        linked_tasks: [taskId],
+    };
+}
+//# sourceMappingURL=contribution.js.map

package/dist/skills/manifests/contribution.js.map

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

package/dist/skills/manifests/research.js

@@ -0,0 +1,281 @@
+/**
+ * Research manifest CRUD operations.
+ * Ports lib/skills/research-manifest.sh.
+ *
+ * Manages MANIFEST.jsonl (append-only JSONL format) for agent outputs.
+ * Supports read, append, find, filter, archive, and rotation.
+ *
+ * @epic T4454
+ * @task T4520
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ExitCode, MANIFEST_STATUSES } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getAgentOutputsAbsolute, getAgentOutputsDir, getManifestPath } from '../../paths.js';
+// ============================================================================
+// Initialization
+// ============================================================================
+/**
+ * Ensure agent outputs directory and manifest file exist.
+ * @task T4520
+ */
+export function ensureOutputs(cwd) {
+    const outputDir = getAgentOutputsDir(cwd);
+    const absOutputDir = getAgentOutputsAbsolute(cwd);
+    const manifestPath = getManifestPath(cwd);
+    const archiveDir = join(absOutputDir, 'archive');
+    const created = [];
+    if (!existsSync(absOutputDir)) {
+        mkdirSync(absOutputDir, { recursive: true });
+        created.push(outputDir);
+    }
+    if (!existsSync(archiveDir)) {
+        mkdirSync(archiveDir, { recursive: true });
+        created.push('archive/');
+    }
+    if (!existsSync(manifestPath)) {
+        writeFileSync(manifestPath, '', 'utf-8');
+        created.push('MANIFEST.jsonl');
+    }
+    return { created };
+}
+// ============================================================================
+// CRUD Operations
+// ============================================================================
+/**
+ * Read all manifest entries.
+ * @task T4520
+ */
+export function readManifest(cwd) {
+    const manifestPath = getManifestPath(cwd);
+    if (!existsSync(manifestPath))
+        return [];
+    const content = readFileSync(manifestPath, 'utf-8');
+    const entries = [];
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip invalid lines
+        }
+    }
+    return entries;
+}
+/**
+ * Append a manifest entry (atomic JSONL append).
+ * @task T4520
+ */
+export function appendManifest(entry, cwd) {
+    ensureOutputs(cwd);
+    const manifestPath = getManifestPath(cwd);
+    // Validate entry
+    validateEntry(entry);
+    // Check for duplicate ID
+    const existing = readManifest(cwd);
+    if (existing.some((e) => e.id === entry.id)) {
+        throw new CleoError(ExitCode.ID_COLLISION, `Manifest entry with id="${entry.id}" already exists`);
+    }
+    // Atomic append (single line, no pretty-print)
+    const line = JSON.stringify(entry) + '\n';
+    appendFileSync(manifestPath, line, 'utf-8');
+}
+/**
+ * Find a manifest entry by ID.
+ * @task T4520
+ */
+export function findEntry(id, cwd) {
+    const entries = readManifest(cwd);
+    return entries.find((e) => e.id === id) ?? null;
+}
+/**
+ * Filter manifest entries by criteria.
+ * @task T4520
+ */
+export function filterEntries(criteria, cwd) {
+    let entries = readManifest(cwd);
+    if (criteria.status) {
+        const s = criteria.status;
+        entries = entries.filter((e) => e.status === s);
+    }
+    if (criteria.agentType) {
+        const at = criteria.agentType;
+        entries = entries.filter((e) => e.agent_type === at);
+    }
+    if (criteria.topic) {
+        const t = criteria.topic;
+        entries = entries.filter((e) => e.topics.includes(t));
+    }
+    if (criteria.linkedTask) {
+        const lt = criteria.linkedTask;
+        entries = entries.filter((e) => e.linked_tasks?.includes(lt));
+    }
+    if (criteria.actionable !== undefined) {
+        entries = entries.filter((e) => e.actionable === criteria.actionable);
+    }
+    return entries;
+}
+/**
+ * Get entries with pending follow-ups.
+ * @task T4520
+ */
+export function getPendingFollowup(cwd) {
+    const entries = readManifest(cwd);
+    return entries.filter((e) => Array.isArray(e.needs_followup) && e.needs_followup.length > 0);
+}
+/**
+ * Get unique follow-up task IDs from all manifest entries.
+ * @task T4520
+ */
+export function getFollowupTaskIds(cwd) {
+    const entries = getPendingFollowup(cwd);
+    const ids = new Set();
+    for (const entry of entries) {
+        for (const id of entry.needs_followup) {
+            if (!id.startsWith('BLOCKED:')) {
+                ids.add(id);
+            }
+        }
+    }
+    return [...ids];
+}
+/**
+ * Check if a task has linked research.
+ * @task T4520
+ */
+export function taskHasResearch(taskId, cwd) {
+    const entries = readManifest(cwd);
+    const linked = entries.filter((e) => e.linked_tasks?.includes(taskId));
+    return { hasResearch: linked.length > 0, count: linked.length };
+}
+/**
+ * Archive a manifest entry (move to archive status).
+ * @task T4520
+ */
+export function archiveEntry(entryId, cwd) {
+    const manifestPath = getManifestPath(cwd);
+    if (!existsSync(manifestPath))
+        return false;
+    const content = readFileSync(manifestPath, 'utf-8');
+    const lines = content.split('\n');
+    let found = false;
+    const newLines = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            newLines.push(line);
+            continue;
+        }
+        try {
+            const entry = JSON.parse(trimmed);
+            if (entry.id === entryId) {
+                entry.status = 'archived';
+                newLines.push(JSON.stringify(entry));
+                found = true;
+            }
+            else {
+                newLines.push(line);
+            }
+        }
+        catch {
+            newLines.push(line);
+        }
+    }
+    if (found) {
+        writeFileSync(manifestPath, newLines.join('\n'), 'utf-8');
+    }
+    return found;
+}
+/**
+ * Rotate manifest by archiving old entries.
+ * @task T4520
+ */
+export function rotateManifest(maxEntries = 100, cwd) {
+    const entries = readManifest(cwd);
+    if (entries.length <= maxEntries)
+        return 0;
+    const manifestPath = getManifestPath(cwd);
+    const absOutputDir = getAgentOutputsAbsolute(cwd);
+    const archiveDir = join(absOutputDir, 'archive');
+    // Archive older entries
+    const toKeep = entries.slice(-maxEntries);
+    const toArchive = entries.slice(0, entries.length - maxEntries);
+    if (!existsSync(archiveDir)) {
+        mkdirSync(archiveDir, { recursive: true });
+    }
+    // Write archive file
+    const archivePath = join(archiveDir, `MANIFEST-${new Date().toISOString().split('T')[0]}.jsonl`);
+    const archiveContent = toArchive.map((e) => JSON.stringify(e)).join('\n') + '\n';
+    appendFileSync(archivePath, archiveContent, 'utf-8');
+    // Rewrite main manifest with kept entries
+    const keepContent = toKeep.map((e) => JSON.stringify(e)).join('\n') + '\n';
+    writeFileSync(manifestPath, keepContent, 'utf-8');
+    return toArchive.length;
+}
+// ============================================================================
+// Validation
+// ============================================================================
+const MANIFEST_STATUS_SET = new Set(MANIFEST_STATUSES);
+const VALID_AGENT_TYPES = new Set([
+    'research',
+    'consensus',
+    'specification',
+    'decomposition',
+    'implementation',
+    'contribution',
+    'release',
+    'validation',
+    'documentation',
+    'analysis',
+    'testing',
+    'cleanup',
+    'design',
+    'architecture',
+    'report',
+    'synthesis',
+    'orchestrator',
+    'handoff',
+    'verification',
+    'review',
+]);
+/**
+ * Validate a manifest entry before appending.
+ * @task T4520
+ */
+function validateEntry(entry) {
+    if (!entry.id) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'Manifest entry missing "id" field');
+    }
+    if (!entry.file) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'Manifest entry missing "file" field');
+    }
+    if (!entry.title) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'Manifest entry missing "title" field');
+    }
+    if (!entry.date || !/^\d{4}-\d{2}-\d{2}$/.test(entry.date)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid date format: ${entry.date}`);
+    }
+    if (!MANIFEST_STATUS_SET.has(entry.status)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid status: ${entry.status}`);
+    }
+    if (!Array.isArray(entry.topics)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'topics must be an array');
+    }
+    if (!Array.isArray(entry.key_findings)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'key_findings must be an array');
+    }
+    if (typeof entry.actionable !== 'boolean') {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'actionable must be a boolean');
+    }
+    // Validate agent_type if present
+    if (entry.agent_type &&
+        !VALID_AGENT_TYPES.has(entry.agent_type) &&
+        !entry.agent_type.startsWith('ct-')) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid agent_type: ${entry.agent_type}`);
+    }
+}
+//# sourceMappingURL=research.js.map

package/dist/skills/manifests/research.js.map

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

package/dist/skills/manifests/resolver.js

@@ -0,0 +1,146 @@
+/**
+ * Cached manifest generation and resolution.
+ * Ports lib/skills/manifest-resolver.sh.
+ *
+ * Generates and caches a unified skills manifest by scanning all search paths.
+ * Uses TTL-based cache with graceful degradation.
+ *
+ * @epic T4454
+ * @task T4520
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoHome } from '../../paths.js';
+import { generateManifest } from '../discovery.js';
+// ============================================================================
+// Cache Configuration
+// ============================================================================
+const DEFAULT_CACHE_TTL = 300; // 5 minutes in seconds
+/**
+ * Get the manifest cache directory.
+ */
+function getCacheDir() {
+    return process.env['CLEO_MANIFEST_CACHE_DIR'] ?? join(getCleoHome(), 'cache');
+}
+/**
+ * Get the cached manifest file path.
+ */
+function getCachedManifestPath() {
+    return join(getCacheDir(), 'skills-manifest.json');
+}
+// ============================================================================
+// Cache Management
+// ============================================================================
+/**
+ * Check if the cached manifest is fresh (within TTL).
+ * @task T4520
+ */
+export function isCacheFresh(cachePath) {
+    const path = cachePath ?? getCachedManifestPath();
+    if (!existsSync(path))
+        return false;
+    try {
+        const content = readFileSync(path, 'utf-8');
+        const manifest = JSON.parse(content);
+        const ttl = manifest._meta?.ttlSeconds ?? DEFAULT_CACHE_TTL;
+        const generatedAt = new Date(manifest._meta?.generatedAt ?? 0).getTime();
+        const ageSeconds = (Date.now() - generatedAt) / 1000;
+        return ageSeconds < ttl;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Invalidate the cache (delete the cached manifest).
+ * @task T4520
+ */
+export function invalidateCache() {
+    const cachePath = getCachedManifestPath();
+    if (existsSync(cachePath)) {
+        try {
+            writeFileSync(cachePath, '', 'utf-8');
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+}
+// ============================================================================
+// Manifest Resolution
+// ============================================================================
+/**
+ * Resolve the skills manifest.
+ * Returns a cached version if fresh, otherwise generates a new one.
+ *
+ * Graceful degradation:
+ *   1. Fresh cached manifest (within TTL)
+ *   2. Stale cached manifest (expired but valid)
+ *   3. Embedded project manifest (skills/manifest.json)
+ *   4. Freshly generated manifest
+ *
+ * @task T4520
+ */
+export function resolveManifest(cwd) {
+    const cachePath = getCachedManifestPath();
+    // Strategy 1: Fresh cache
+    if (isCacheFresh(cachePath)) {
+        try {
+            return JSON.parse(readFileSync(cachePath, 'utf-8'));
+        }
+        catch {
+            // Fall through to regenerate
+        }
+    }
+    // Strategy 2: Stale cache (still valid JSON)
+    if (existsSync(cachePath)) {
+        try {
+            const content = readFileSync(cachePath, 'utf-8');
+            if (content.trim()) {
+                const staleManifest = JSON.parse(content);
+                if (staleManifest.skills?.length > 0) {
+                    // Use stale but try to regenerate in background
+                    regenerateCache(cwd);
+                    return staleManifest;
+                }
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Strategy 3: Generate fresh manifest
+    const manifest = generateManifest(cwd);
+    // Cache the result
+    try {
+        const cacheDir = getCacheDir();
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        writeFileSync(cachePath, JSON.stringify(manifest, null, 2), 'utf-8');
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+    return manifest;
+}
+/**
+ * Force regenerate the cache.
+ * @task T4520
+ */
+export function regenerateCache(cwd) {
+    const manifest = generateManifest(cwd);
+    const cachePath = getCachedManifestPath();
+    try {
+        const cacheDir = getCacheDir();
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        writeFileSync(cachePath, JSON.stringify(manifest, null, 2), 'utf-8');
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+    return manifest;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/skills/manifests/resolver.js.map

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