@cleocode/core 2026.4.9 → 2026.4.11

package/dist/snapshot/index.js

@@ -0,0 +1,188 @@
+/**
+ * Snapshot module for multi-contributor task state sharing.
+ *
+ * Exports task state from SQLite to a portable JSON format suitable for
+ * git commit and cross-contributor review. Imports snapshots back into
+ * the local task database with last-write-wins merge.
+ *
+ * @task T4882
+ */
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { getCleoDirAbsolute } from '../paths.js';
+import { getAccessor } from '../store/data-accessor.js';
+/** Snapshot format version. */
+const SNAPSHOT_FORMAT_VERSION = '1.0.0';
+/**
+ * Strip a Task down to its portable snapshot representation.
+ * Removes local-only fields: position, positionVersion, verification,
+ * provenance, notes, acceptance, files, blockedBy.
+ * @task T4882
+ */
+function toSnapshotTask(task) {
+    return {
+        id: task.id,
+        title: task.title,
+        status: task.status,
+        priority: task.priority,
+        ...(task.type != null && { type: task.type }),
+        ...(task.parentId != null && { parentId: task.parentId }),
+        ...(task.size != null && { size: task.size }),
+        ...(task.phase != null && { phase: task.phase }),
+        ...(task.description != null && { description: task.description }),
+        ...(task.depends != null && task.depends.length > 0 && { depends: task.depends }),
+        ...(task.labels != null && task.labels.length > 0 && { labels: task.labels }),
+        createdAt: task.createdAt,
+        ...(task.updatedAt != null && { updatedAt: task.updatedAt }),
+        ...(task.completedAt != null && { completedAt: task.completedAt }),
+    };
+}
+/**
+ * Compute SHA-256 checksum of snapshot content.
+ * @task T4882
+ */
+function computeChecksum(tasks) {
+    const hash = createHash('sha256');
+    hash.update(JSON.stringify(tasks));
+    return hash.digest('hex').slice(0, 16);
+}
+/**
+ * Export current task state to a snapshot.
+ * @task T4882
+ */
+export async function exportSnapshot(cwd) {
+    const accessor = await getAccessor(cwd);
+    const { tasks } = await accessor.queryTasks({});
+    const projectMeta = await accessor.getMetaValue('project');
+    const version = await accessor.getMetaValue('version');
+    const snapshotTasks = tasks.map(toSnapshotTask);
+    const checksum = computeChecksum(snapshotTasks);
+    return {
+        $schema: 'https://lafs.dev/schemas/v1/cleo-snapshot.schema.json',
+        _meta: {
+            format: 'cleo-snapshot',
+            version: SNAPSHOT_FORMAT_VERSION,
+            createdAt: new Date().toISOString(),
+            source: {
+                project: projectMeta?.name ?? 'unknown',
+                cleoVersion: version ?? '0.0.0',
+            },
+            checksum,
+            taskCount: snapshotTasks.length,
+        },
+        project: {
+            name: projectMeta?.name ?? 'unknown',
+            ...(projectMeta?.currentPhase != null && {
+                currentPhase: projectMeta.currentPhase,
+            }),
+        },
+        tasks: snapshotTasks,
+    };
+}
+/**
+ * Write a snapshot to a file.
+ * @task T4882
+ */
+export async function writeSnapshot(snapshot, outputPath) {
+    const dir = dirname(outputPath);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    await writeFile(outputPath, JSON.stringify(snapshot, null, 2) + '\n');
+}
+/**
+ * Read a snapshot from a file.
+ * @task T4882
+ */
+export async function readSnapshot(inputPath) {
+    const content = await readFile(inputPath, 'utf-8');
+    const parsed = JSON.parse(content);
+    if (parsed._meta?.format !== 'cleo-snapshot') {
+        throw new Error(`Invalid snapshot format: expected 'cleo-snapshot', got '${parsed._meta?.format}'`);
+    }
+    return parsed;
+}
+/**
+ * Generate a default snapshot file path.
+ * @task T4882
+ */
+export function getDefaultSnapshotPath(cwd) {
+    const cleoDir = getCleoDirAbsolute(cwd);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    return join(cleoDir, 'snapshots', `snapshot-${timestamp}.json`);
+}
+/**
+ * Import a snapshot into the local task database.
+ * Uses last-write-wins strategy: if a task exists locally and in the snapshot,
+ * the snapshot version wins only if its updatedAt is newer.
+ * @task T4882
+ */
+export async function importSnapshot(snapshot, cwd) {
+    const accessor = await getAccessor(cwd);
+    const { tasks: localTasks } = await accessor.queryTasks({});
+    const result = {
+        added: 0,
+        updated: 0,
+        skipped: 0,
+        conflicts: [],
+    };
+    const localTaskMap = new Map(localTasks.map((t) => [t.id, t]));
+    for (const snapshotTask of snapshot.tasks) {
+        const localTask = localTaskMap.get(snapshotTask.id);
+        if (!localTask) {
+            // New task -- add it
+            const newTask = {
+                id: snapshotTask.id,
+                title: snapshotTask.title,
+                status: snapshotTask.status,
+                priority: snapshotTask.priority,
+                type: snapshotTask.type,
+                parentId: snapshotTask.parentId,
+                size: snapshotTask.size,
+                phase: snapshotTask.phase,
+                description: snapshotTask.description ?? '',
+                depends: snapshotTask.depends,
+                labels: snapshotTask.labels,
+                createdAt: snapshotTask.createdAt,
+                updatedAt: snapshotTask.updatedAt,
+                completedAt: snapshotTask.completedAt,
+            };
+            await accessor.upsertSingleTask(newTask);
+            result.added++;
+            continue;
+        }
+        // Task exists locally -- compare timestamps
+        const localUpdated = localTask.updatedAt ?? localTask.createdAt;
+        const snapshotUpdated = snapshotTask.updatedAt ?? snapshotTask.createdAt;
+        if (snapshotUpdated > localUpdated) {
+            // Snapshot is newer -- update local via upsert (preserves fields not in snapshot)
+            const updatedTask = {
+                ...localTask,
+                title: snapshotTask.title,
+                status: snapshotTask.status,
+                priority: snapshotTask.priority,
+                ...(snapshotTask.description != null && { description: snapshotTask.description }),
+                ...(snapshotTask.labels != null && { labels: snapshotTask.labels }),
+                ...(snapshotTask.depends != null && { depends: snapshotTask.depends }),
+                updatedAt: snapshotTask.updatedAt,
+                ...(snapshotTask.completedAt != null && { completedAt: snapshotTask.completedAt }),
+            };
+            await accessor.upsertSingleTask(updatedTask);
+            result.updated++;
+        }
+        else if (snapshotUpdated === localUpdated) {
+            result.skipped++;
+        }
+        else {
+            // Local is newer -- skip but note conflict
+            result.skipped++;
+            if (localTask.title !== snapshotTask.title || localTask.status !== snapshotTask.status) {
+                result.conflicts.push(`${snapshotTask.id}: local is newer (local: ${localUpdated}, snapshot: ${snapshotUpdated})`);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

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

package/dist/spawn/adapter-registry.js

@@ -0,0 +1,246 @@
+/**
+ * Spawn Adapter Registry
+ *
+ * Registry to manage multiple spawn adapters for different providers.
+ * Provides adapter lookup by ID, by provider, and filtering by capability.
+ *
+ * Delegates to adapter packages in packages/adapters/ via bridge adapters
+ * that map between CLEOSpawnAdapter and AdapterSpawnProvider interfaces.
+ *
+ * @task T5236
+ * @phase 1C
+ */
+import { getProvidersBySpawnCapability, getSpawnCapableProviders, providerSupportsById, } from '@cleocode/caamp';
+/**
+ * Registry to manage spawn adapters.
+ *
+ * Maintains mappings between adapter IDs, provider IDs, and adapter instances.
+ * Supports registration, lookup, and capability-based filtering.
+ */
+export class SpawnAdapterRegistry {
+    /** Map of adapter ID to adapter instance */
+    adapters = new Map();
+    /** Map of provider ID to adapter ID */
+    providerAdapters = new Map();
+    /**
+     * Register an adapter with the registry.
+     *
+     * @param adapter - The adapter instance to register
+     */
+    register(adapter) {
+        this.adapters.set(adapter.id, adapter);
+        this.providerAdapters.set(adapter.providerId, adapter.id);
+    }
+    /**
+     * Get an adapter by its unique ID.
+     *
+     * @param adapterId - The adapter identifier
+     * @returns The adapter instance, or undefined if not found
+     */
+    get(adapterId) {
+        return this.adapters.get(adapterId);
+    }
+    /**
+     * Get the adapter registered for a specific provider.
+     *
+     * @param providerId - The provider identifier
+     * @returns The adapter instance, or undefined if no adapter is registered for this provider
+     */
+    getForProvider(providerId) {
+        const adapterId = this.providerAdapters.get(providerId);
+        return adapterId ? this.adapters.get(adapterId) : undefined;
+    }
+    /**
+     * Check if an adapter is registered for a given provider.
+     *
+     * @param providerId - The provider identifier
+     * @returns True if an adapter exists for the provider
+     */
+    hasAdapterForProvider(providerId) {
+        return this.providerAdapters.has(providerId);
+    }
+    /**
+     * List all registered adapters.
+     *
+     * @returns Array of all registered adapter instances
+     */
+    list() {
+        return Array.from(this.adapters.values());
+    }
+    /**
+     * List adapters for providers that have spawn capability.
+     *
+     * Queries CAAMP for spawn-capable providers and returns the
+     * corresponding registered adapters.
+     *
+     * @returns Promise resolving to array of spawn-capable adapters
+     */
+    async listSpawnCapable() {
+        await initializeDefaultAdapters();
+        const providers = getSpawnCapableProviders();
+        return providers
+            .filter((p) => providerSupportsById(p.id, 'spawn.supportsSubagents'))
+            .map((p) => this.getForProvider(p.id))
+            .filter((a) => a !== undefined);
+    }
+    /**
+     * Check if a provider can spawn subagents.
+     *
+     * Uses providerSupportsById to check if the provider supports
+     * the spawn.supportsSubagents capability.
+     *
+     * @param providerId - The provider identifier
+     * @returns True if the provider supports spawning
+     */
+    async canProviderSpawn(providerId) {
+        await initializeDefaultAdapters();
+        return providerSupportsById(providerId, 'spawn.supportsSubagents');
+    }
+    /**
+     * Clear all adapter registrations.
+     *
+     * Removes all adapters and provider mappings from the registry.
+     */
+    clear() {
+        this.adapters.clear();
+        this.providerAdapters.clear();
+    }
+}
+/**
+ * Get providers by specific spawn capability
+ *
+ * Queries CAAMP for providers that support a specific spawn capability.
+ *
+ * @param capability - The spawn capability to filter by
+ * @returns Array of providers with the specified capability
+ */
+export function getProvidersWithSpawnCapability(capability) {
+    return getProvidersBySpawnCapability(capability);
+}
+/**
+ * Check if any provider supports parallel spawn
+ *
+ * @returns True if at least one provider supports parallel spawn
+ */
+export function hasParallelSpawnProvider() {
+    return getProvidersWithSpawnCapability('supportsParallelSpawn').length > 0;
+}
+/**
+ * Singleton registry instance.
+ *
+ * Use this instance for all spawn adapter registration and lookup operations.
+ */
+export const spawnRegistry = new SpawnAdapterRegistry();
+/**
+ * Bridge an AdapterSpawnProvider (from packages/adapters/) to CLEOSpawnAdapter.
+ *
+ * Maps between the contracts-based SpawnContext/SpawnResult types and the
+ * CLEO-specific CLEOSpawnContext/CLEOSpawnResult types used by the orchestrate
+ * engine and spawn registry.
+ *
+ * @param providerId - Provider identifier (e.g. 'claude-code', 'opencode')
+ * @param delegate - The underlying AdapterSpawnProvider instance
+ * @returns A CLEOSpawnAdapter wrapping the delegate
+ */
+function bridgeSpawnAdapter(providerId, delegate) {
+    return {
+        id: providerId,
+        providerId,
+        canSpawn() {
+            return delegate.canSpawn();
+        },
+        async spawn(context) {
+            const contractContext = {
+                taskId: context.taskId,
+                prompt: context.prompt,
+                workingDirectory: context.workingDirectory,
+                options: context.options,
+            };
+            const result = await delegate.spawn(contractContext);
+            return {
+                instanceId: result.instanceId,
+                output: result.output ?? '',
+                exitCode: result.exitCode ?? 0,
+                status: result.status,
+                taskId: result.taskId,
+                providerId: result.providerId,
+                timing: {
+                    startTime: result.startTime,
+                    endTime: result.endTime,
+                },
+            };
+        },
+        async listRunning() {
+            const results = await delegate.listRunning();
+            return results.map((r) => ({
+                instanceId: r.instanceId,
+                output: r.output ?? '',
+                exitCode: r.exitCode ?? 0,
+                status: r.status,
+                taskId: r.taskId,
+                providerId: r.providerId,
+                timing: {
+                    startTime: r.startTime,
+                    endTime: r.endTime,
+                },
+            }));
+        },
+        terminate(instanceId) {
+            return delegate.terminate(instanceId);
+        },
+    };
+}
+/**
+ * Initialize spawn adapters dynamically from discovered adapter manifests.
+ *
+ * Scans all discovered manifests for adapters with `capabilities.supportsSpawn`,
+ * dynamically imports their spawn provider, and bridges it into the spawn registry.
+ *
+ * Zero hardcoded adapter names — everything derives from manifests.
+ *
+ * @param manifests - Discovered adapter manifests (from AdapterManager.discover())
+ * @returns Promise that resolves when initialization is complete
+ */
+export async function initializeSpawnAdapters(manifests) {
+    for (const manifest of manifests) {
+        if (!manifest.capabilities?.supportsSpawn)
+            continue;
+        if (spawnRegistry.hasAdapterForProvider(manifest.provider))
+            continue;
+        try {
+            const { join } = await import('node:path');
+            const modulePath = join(manifest.packagePath, manifest.entryPoint);
+            const adapterModule = await import(modulePath);
+            // Look for an exported spawn provider class — convention: <Name>SpawnProvider
+            let SpawnProviderClass;
+            for (const [exportName, exportValue] of Object.entries(adapterModule)) {
+                if (exportName.endsWith('SpawnProvider') && typeof exportValue === 'function') {
+                    SpawnProviderClass = exportValue;
+                    break;
+                }
+            }
+            if (SpawnProviderClass) {
+                const provider = new SpawnProviderClass();
+                spawnRegistry.register(bridgeSpawnAdapter(manifest.provider, provider));
+            }
+        }
+        catch {
+            // Adapter not installed or doesn't have spawn provider — skip
+        }
+    }
+}
+/**
+ * Initialize the registry with default adapters.
+ *
+ * Legacy entry point that discovers adapters from the project root
+ * and delegates to initializeSpawnAdapters(). Maintains backward
+ * compatibility for callers that don't have manifests handy.
+ *
+ * @returns Promise that resolves when initialization is complete
+ */
+export async function initializeDefaultAdapters() {
+    const { discoverAdapterManifests } = await import('../adapters/discovery.js');
+    const manifests = discoverAdapterManifests(process.cwd());
+    await initializeSpawnAdapters(manifests);
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/spawn/adapter-registry.js.map

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

package/dist/spawn/index.js

@@ -0,0 +1,10 @@
+/**
+ * Spawn core module — barrel export.
+ *
+ * Re-exports spawn adapter registry and utilities from the core layer.
+ *
+ * @task T5709
+ * @epic T5701
+ */
+export { getProvidersWithSpawnCapability, hasParallelSpawnProvider, initializeDefaultAdapters, initializeSpawnAdapters, SpawnAdapterRegistry, spawnRegistry, } from './adapter-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/spawn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spawn/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,GACd,MAAM,uBAAuB,CAAC"}