@cleocode/core 2026.3.56 → 2026.3.58

package/dist/nexus/sharing/index.js

@@ -0,0 +1,179 @@
+/**
+ * Sharing module for multi-contributor .cleo/ state management.
+ *
+ * Controls which .cleo/ files are committed to the project git repo
+ * via a config-driven allowlist. Provides status reporting and
+ * .gitignore auto-management.
+ *
+ * @task T4883
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { loadConfig } from '../../config.js';
+import { getCleoDirAbsolute, getProjectRoot } from '../../paths.js';
+/** Markers for the managed section in .gitignore. */
+const GITIGNORE_START = '# CLEO:SHARING:START - Auto-managed by cleo sharing sync';
+const GITIGNORE_END = '# CLEO:SHARING:END';
+/**
+ * Match a file path against a glob-like pattern.
+ * Supports: '*' (single segment wildcard), '**' (recursive wildcard),
+ * and trailing '/' for directory matching.
+ * @task T4883
+ */
+export function matchesPattern(filePath, pattern) {
+    // Normalize: remove leading/trailing slashes
+    const normalizedPath = filePath.replace(/^\/+|\/+$/g, '');
+    const normalizedPattern = pattern.replace(/^\/+|\/+$/g, '');
+    // Trailing ** matches everything under a directory
+    if (normalizedPattern.endsWith('/**')) {
+        const prefix = normalizedPattern.slice(0, -3);
+        return normalizedPath === prefix || normalizedPath.startsWith(prefix + '/');
+    }
+    // Wildcard patterns with *
+    if (normalizedPattern.includes('*')) {
+        const regex = new RegExp('^' +
+            normalizedPattern
+                .replace(/\./g, '\\.')
+                .replace(/\*\*/g, '<<<GLOBSTAR>>>')
+                .replace(/\*/g, '[^/]*')
+                .replace(/<<<GLOBSTAR>>>/g, '.*') +
+            '$');
+        return regex.test(normalizedPath);
+    }
+    // Exact match
+    return normalizedPath === normalizedPattern;
+}
+/**
+ * Check if a file path matches any pattern in a list.
+ * @task T4883
+ */
+function matchesAny(filePath, patterns) {
+    return patterns.some((pattern) => matchesPattern(filePath, pattern));
+}
+/**
+ * Collect all files in .cleo/ directory (relative to .cleo/).
+ * Skips the .git subdirectory.
+ * @task T4883
+ */
+function collectCleoFiles(cleoDir) {
+    if (!existsSync(cleoDir))
+        return [];
+    const files = [];
+    function walk(dir) {
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            if (entry === '.git')
+                continue; // Skip isolated .cleo/.git repo
+            const fullPath = join(dir, entry);
+            const relPath = relative(cleoDir, fullPath);
+            try {
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    walk(fullPath);
+                }
+                else {
+                    files.push(relPath.replaceAll('\\', '/'));
+                }
+            }
+            catch {
+                // Skip files we can't stat (e.g. broken symlinks)
+            }
+        }
+    }
+    walk(cleoDir);
+    return files.sort();
+}
+/**
+ * Get the sharing status: which .cleo/ files are tracked vs ignored.
+ * @task T4883
+ */
+export async function getSharingStatus(cwd) {
+    const config = await loadConfig(cwd);
+    const sharing = config.sharing;
+    const cleoDir = getCleoDirAbsolute(cwd);
+    const allFiles = collectCleoFiles(cleoDir);
+    const tracked = [];
+    const ignored = [];
+    for (const file of allFiles) {
+        if (matchesAny(file, sharing.denylist)) {
+            ignored.push(file);
+        }
+        else if (matchesAny(file, sharing.commitAllowlist)) {
+            tracked.push(file);
+        }
+        else {
+            ignored.push(file);
+        }
+    }
+    return {
+        mode: sharing.mode,
+        allowlist: sharing.commitAllowlist,
+        denylist: sharing.denylist,
+        tracked,
+        ignored,
+    };
+}
+/**
+ * Generate .gitignore entries for the managed section.
+ * In 'project' mode: ignore everything except allowlisted files.
+ * In 'none' mode: ignore all .cleo/ contents.
+ * @task T4883
+ */
+function generateGitignoreEntries(sharing) {
+    if (sharing.mode === 'none') {
+        return ['.cleo/'];
+    }
+    // In 'project' mode: ignore .cleo/ broadly, then un-ignore allowlisted paths
+    const entries = [];
+    // First ignore everything in .cleo/
+    entries.push('.cleo/');
+    // Then un-ignore allowlisted paths (git negation patterns)
+    for (const pattern of sharing.commitAllowlist) {
+        // Ensure parent directories are also un-ignored
+        const parts = pattern.split('/');
+        let accumulated = '.cleo';
+        for (let i = 0; i < parts.length - 1; i++) {
+            accumulated += '/' + parts[i];
+            entries.push(`!${accumulated}/`);
+        }
+        entries.push(`!.cleo/${pattern}`);
+    }
+    return entries;
+}
+/**
+ * Sync the project .gitignore to match the sharing config.
+ * Adds/updates a managed section between CLEO markers.
+ * @task T4883
+ */
+export async function syncGitignore(cwd) {
+    const config = await loadConfig(cwd);
+    const projectRoot = getProjectRoot(cwd);
+    const gitignorePath = join(projectRoot, '.gitignore');
+    const entries = generateGitignoreEntries(config.sharing);
+    const managedSection = ['', GITIGNORE_START, ...entries, GITIGNORE_END, ''].join('\n');
+    let content = '';
+    if (existsSync(gitignorePath)) {
+        content = await readFile(gitignorePath, 'utf-8');
+    }
+    // Check if managed section already exists
+    const startIdx = content.indexOf(GITIGNORE_START);
+    const endIdx = content.indexOf(GITIGNORE_END);
+    if (startIdx !== -1 && endIdx !== -1) {
+        // Replace existing managed section
+        const before = content.slice(0, startIdx);
+        const after = content.slice(endIdx + GITIGNORE_END.length);
+        const newContent = before.trimEnd() + managedSection + after.trimStart();
+        if (newContent.trim() === content.trim()) {
+            return { updated: false, entriesCount: entries.length };
+        }
+        await writeFile(gitignorePath, newContent);
+    }
+    else {
+        // Append managed section
+        const newContent = content.trimEnd() + '\n' + managedSection;
+        await writeFile(gitignorePath, newContent);
+    }
+    return { updated: true, entriesCount: entries.length };
+}
+//# sourceMappingURL=index.js.map

package/dist/nexus/sharing/index.js.map

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

package/dist/nexus/transfer-types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for cross-project task transfer via NEXUS.
+ *
+ * @task T046, T047
+ * @epic T4540
+ */
+export {};
+//# sourceMappingURL=transfer-types.js.map

package/dist/nexus/transfer-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-types.js","sourceRoot":"","sources":["../../src/nexus/transfer-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/nexus/transfer.js

@@ -0,0 +1,263 @@
+/**
+ * Cross-project task transfer engine for NEXUS.
+ *
+ * Provides executeTransfer() and previewTransfer() for moving/copying
+ * tasks between registered NEXUS projects with full provenance tracking.
+ *
+ * @task T046, T049, T050, T051, T052, T053
+ * @epic T4540
+ */
+import { randomUUID } from 'node:crypto';
+import { importFromPackage } from '../admin/import-tasks.js';
+import { getLogger } from '../logger.js';
+import { createLink } from '../reconciliation/link-store.js';
+import { BrainDataAccessor } from '../store/brain-accessor.js';
+import { getBrainDb } from '../store/brain-sqlite.js';
+import { getAccessor } from '../store/data-accessor.js';
+import { exportSingle, exportSubtree } from '../store/export.js';
+import { requirePermission } from './permissions.js';
+import { nexusGetProject } from './registry.js';
+const log = getLogger('nexus:transfer');
+/**
+ * Preview a transfer without writing any data.
+ * Validates projects, permissions, and builds the manifest.
+ */
+export async function previewTransfer(params) {
+    return executeTransferInternal({ ...params, dryRun: true });
+}
+/**
+ * Execute a cross-project task transfer.
+ *
+ * Pipeline:
+ *   1. Validate source/target projects via nexusGetProject()
+ *   2. Check permissions: read on source, write on target
+ *   3. Read source tasks
+ *   4. Build ExportPackage via exportSubtree/exportSingle
+ *   5. Import into target via importFromPackage()
+ *   6. Create bidirectional external_task_links
+ *   7. Write nexus_audit_log entry
+ *   8. If move mode: archive source tasks
+ *   9. If transferBrain: copy brain observations
+ */
+export async function executeTransfer(params) {
+    return executeTransferInternal(params);
+}
+async function executeTransferInternal(params) {
+    const { taskIds, sourceProject: sourceProjectRef, targetProject: targetProjectRef, mode = 'copy', scope = 'subtree', onConflict = 'rename', onMissingDep = 'strip', provenance = true, targetParent, transferBrain = false, dryRun = false, } = params;
+    if (!taskIds.length) {
+        throw new Error('No task IDs specified for transfer');
+    }
+    // Step 1: Validate projects
+    const sourceProject = await nexusGetProject(sourceProjectRef);
+    if (!sourceProject) {
+        throw new Error(`Source project not found: ${sourceProjectRef}`);
+    }
+    const targetProject = await nexusGetProject(targetProjectRef);
+    if (!targetProject) {
+        throw new Error(`Target project not found: ${targetProjectRef}`);
+    }
+    if (sourceProject.hash === targetProject.hash) {
+        throw new Error('Source and target projects must be different');
+    }
+    // Step 2: Check permissions
+    await requirePermission(sourceProject.hash, 'read', 'nexus.transfer');
+    await requirePermission(targetProject.hash, 'write', 'nexus.transfer');
+    // Step 3: Read source tasks
+    const sourceAccessor = await getAccessor(sourceProject.path);
+    const { tasks: allSourceTasks } = await sourceAccessor.queryTasks({});
+    // Step 4: Build ExportPackage for each task
+    const exportPackages = [];
+    for (const taskId of taskIds) {
+        const pkg = scope === 'subtree'
+            ? exportSubtree(taskId, allSourceTasks, sourceProject.name)
+            : exportSingle(taskId, allSourceTasks, sourceProject.name);
+        if (!pkg) {
+            throw new Error(`Task not found in source project: ${taskId}`);
+        }
+        exportPackages.push(pkg);
+    }
+    // Merge all packages into one (dedup by task ID)
+    const seenIds = new Set();
+    const mergedTasks = [];
+    for (const pkg of exportPackages) {
+        for (const task of pkg.tasks) {
+            if (!seenIds.has(task.id)) {
+                seenIds.add(task.id);
+                mergedTasks.push(task);
+            }
+        }
+    }
+    // Use the first package as base and replace tasks
+    const mergedPkg = { ...exportPackages[0] };
+    mergedPkg.tasks = mergedTasks;
+    mergedPkg._meta = { ...mergedPkg._meta, taskCount: mergedTasks.length };
+    // Step 5: Import into target
+    const importResult = await importFromPackage(mergedPkg, {
+        cwd: targetProject.path,
+        dryRun,
+        parent: targetParent,
+        provenance,
+        onConflict,
+        onMissingDep,
+    });
+    // Build manifest
+    const entries = mergedTasks.map((t) => ({
+        sourceId: t.id,
+        targetId: importResult.idRemap[t.id] ?? t.id,
+        title: t.title,
+        type: t.type ?? 'task',
+    }));
+    const manifest = {
+        sourceProject: sourceProject.name,
+        targetProject: targetProject.name,
+        mode,
+        scope,
+        entries,
+        idRemap: importResult.idRemap,
+        brainObservationsTransferred: 0,
+    };
+    const result = {
+        dryRun,
+        transferred: importResult.imported,
+        skipped: importResult.skipped,
+        archived: 0,
+        linksCreated: 0,
+        brainObservationsTransferred: 0,
+        manifest,
+    };
+    if (dryRun) {
+        return result;
+    }
+    // Step 6: Create bidirectional external_task_links
+    // Only create links for tasks that were actually imported (verify they exist in target)
+    let linksCreated = 0;
+    const targetAccessor = await getAccessor(targetProject.path);
+    const { tasks: targetTasks } = await targetAccessor.queryTasks({});
+    const targetTaskIds = new Set(targetTasks.map((t) => t.id));
+    for (const entry of entries) {
+        if (importResult.idRemap[entry.sourceId] && targetTaskIds.has(entry.targetId)) {
+            // Link in target: points back to source
+            await createLink({
+                taskId: entry.targetId,
+                providerId: `nexus:${sourceProject.name}`,
+                externalId: entry.sourceId,
+                externalTitle: entry.title,
+                linkType: 'transferred',
+                syncDirection: 'inbound',
+                metadata: {
+                    transferMode: mode,
+                    transferScope: scope,
+                    sourceProject: sourceProject.name,
+                    transferredAt: new Date().toISOString(),
+                },
+            }, targetProject.path);
+            linksCreated++;
+            // Link in source: points to target
+            await createLink({
+                taskId: entry.sourceId,
+                providerId: `nexus:${targetProject.name}`,
+                externalId: entry.targetId,
+                externalTitle: entry.title,
+                linkType: 'transferred',
+                syncDirection: 'outbound',
+                metadata: {
+                    transferMode: mode,
+                    transferScope: scope,
+                    targetProject: targetProject.name,
+                    transferredAt: new Date().toISOString(),
+                },
+            }, sourceProject.path);
+            linksCreated++;
+        }
+    }
+    result.linksCreated = linksCreated;
+    // Step 7: Write audit log
+    try {
+        const { getNexusDb } = await import('../store/nexus-sqlite.js');
+        const { nexusAuditLog } = await import('../store/nexus-schema.js');
+        const db = await getNexusDb();
+        await db.insert(nexusAuditLog).values({
+            id: randomUUID(),
+            action: 'transfer',
+            projectHash: sourceProject.hash,
+            projectId: sourceProject.projectId,
+            domain: 'nexus',
+            operation: 'transfer',
+            success: 1,
+            detailsJson: JSON.stringify({
+                sourceProject: sourceProject.name,
+                targetProject: targetProject.name,
+                mode,
+                scope,
+                taskCount: result.transferred,
+                idRemap: importResult.idRemap,
+            }),
+        });
+    }
+    catch (err) {
+        log.warn({ err }, 'nexus transfer audit write failed');
+    }
+    // Step 8: Move mode — archive source tasks
+    if (mode === 'move') {
+        let archived = 0;
+        for (const entry of entries) {
+            if (importResult.idRemap[entry.sourceId]) {
+                try {
+                    await sourceAccessor.archiveSingleTask(entry.sourceId, {
+                        archivedAt: new Date().toISOString(),
+                        archiveReason: `Transferred to ${targetProject.name} as ${entry.targetId}`,
+                    });
+                    archived++;
+                }
+                catch (err) {
+                    log.warn({ err, taskId: entry.sourceId }, 'failed to archive source task after transfer');
+                }
+            }
+        }
+        result.archived = archived;
+    }
+    // Step 9: Brain observation transfer
+    if (transferBrain) {
+        let brainTransferred = 0;
+        try {
+            const sourceBrainDb = await getBrainDb(sourceProject.path);
+            const targetBrainDb = await getBrainDb(targetProject.path);
+            const sourceBrain = new BrainDataAccessor(sourceBrainDb);
+            const targetBrain = new BrainDataAccessor(targetBrainDb);
+            for (const entry of entries) {
+                if (!importResult.idRemap[entry.sourceId])
+                    continue;
+                const links = await sourceBrain.getLinksForTask(entry.sourceId);
+                for (const link of links) {
+                    if (link.memoryType !== 'observation')
+                        continue;
+                    const observation = await sourceBrain.getObservation(link.memoryId);
+                    if (!observation)
+                        continue;
+                    const newObsId = `O-${randomUUID().slice(0, 8)}`;
+                    await targetBrain.addObservation({
+                        ...observation,
+                        id: newObsId,
+                        createdAt: observation.createdAt,
+                        updatedAt: new Date().toISOString().replace('T', ' ').slice(0, 19),
+                    });
+                    await targetBrain.addLink({
+                        memoryType: 'observation',
+                        memoryId: newObsId,
+                        taskId: entry.targetId,
+                        linkType: 'applies_to',
+                        createdAt: new Date().toISOString().replace('T', ' ').slice(0, 19),
+                    });
+                    brainTransferred++;
+                }
+            }
+        }
+        catch (err) {
+            log.warn({ err }, 'brain observation transfer failed');
+        }
+        result.brainObservationsTransferred = brainTransferred;
+        result.manifest.brainObservationsTransferred = brainTransferred;
+    }
+    return result;
+}
+//# sourceMappingURL=transfer.js.map

package/dist/nexus/transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../src/nexus/transfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQhD,MAAM,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAsB;IAC1D,OAAO,uBAAuB,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAsB;IAC1D,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,MAAsB;IAC3D,MAAM,EACJ,OAAO,EACP,aAAa,EAAE,gBAAgB,EAC/B,aAAa,EAAE,gBAAgB,EAC/B,IAAI,GAAG,MAAM,EACb,KAAK,GAAG,SAAS,EACjB,UAAU,GAAG,QAAQ,EACrB,YAAY,GAAG,OAAO,EACtB,UAAU,GAAG,IAAI,EACjB,YAAY,EACZ,aAAa,GAAG,KAAK,EACrB,MAAM,GAAG,KAAK,GACf,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,4BAA4B;IAC5B,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,6BAA6B,gBAAgB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,6BAA6B,gBAAgB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,4BAA4B;IAC5B,MAAM,iBAAiB,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACtE,MAAM,iBAAiB,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAEvE,4BAA4B;IAC5B,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAEtE,4CAA4C;IAC5C,MAAM,cAAc,GAAG,EAAE,CAAC;IAC1B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GACP,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC;YAC3D,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,SAAS,GAAG,EAAE,GAAG,cAAc,CAAC,CAAC,CAAE,EAAE,CAAC;IAC5C,SAAS,CAAC,KAAK,GAAG,WAAW,CAAC;IAC9B,SAAS,CAAC,KAAK,GAAG,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IAExE,6BAA6B;IAC7B,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE;QACtD,GAAG,EAAE,aAAa,CAAC,IAAI;QACvB,MAAM;QACN,MAAM,EAAE,YAAY;QACpB,UAAU;QACV,UAAU;QACV,YAAY;KACb,CAAC,CAAC;IAEH,iBAAiB;IACjB,MAAM,OAAO,GAA4B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,QAAQ,EAAE,CAAC,CAAC,EAAE;QACd,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE;QAC5C,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM;KACvB,CAAC,CAAC,CAAC;IAEJ,MAAM,QAAQ,GAAqB;QACjC,aAAa,EAAE,aAAa,CAAC,IAAI;QACjC,aAAa,EAAE,aAAa,CAAC,IAAI;QACjC,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,4BAA4B,EAAE,CAAC;KAChC,CAAC;IAEF,MAAM,MAAM,GAAmB;QAC7B,MAAM;QACN,WAAW,EAAE,YAAY,CAAC,QAAQ;QAClC,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,CAAC;QACf,4BAA4B,EAAE,CAAC;QAC/B,QAAQ;KACT,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mDAAmD;IACnD,wFAAwF;IACxF,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9E,wCAAwC;YACxC,MAAM,UAAU,CACd;gBACE,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,UAAU,EAAE,SAAS,aAAa,CAAC,IAAI,EAAE;gBACzC,UAAU,EAAE,KAAK,CAAC,QAAQ;gBAC1B,aAAa,EAAE,KAAK,CAAC,KAAK;gBAC1B,QAAQ,EAAE,aAAa;gBACvB,aAAa,EAAE,SAAS;gBACxB,QAAQ,EAAE;oBACR,YAAY,EAAE,IAAI;oBAClB,aAAa,EAAE,KAAK;oBACpB,aAAa,EAAE,aAAa,CAAC,IAAI;oBACjC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACxC;aACF,EACD,aAAa,CAAC,IAAI,CACnB,CAAC;YACF,YAAY,EAAE,CAAC;YAEf,mCAAmC;YACnC,MAAM,UAAU,CACd;gBACE,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,UAAU,EAAE,SAAS,aAAa,CAAC,IAAI,EAAE;gBACzC,UAAU,EAAE,KAAK,CAAC,QAAQ;gBAC1B,aAAa,EAAE,KAAK,CAAC,KAAK;gBAC1B,QAAQ,EAAE,aAAa;gBACvB,aAAa,EAAE,UAAU;gBACzB,QAAQ,EAAE;oBACR,YAAY,EAAE,IAAI;oBAClB,aAAa,EAAE,KAAK;oBACpB,aAAa,EAAE,aAAa,CAAC,IAAI;oBACjC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACxC;aACF,EACD,aAAa,CAAC,IAAI,CACnB,CAAC;YACF,YAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;IAEnC,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAChE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACnE,MAAM,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;YACpC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,aAAa,CAAC,IAAI;YAC/B,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC;gBAC1B,aAAa,EAAE,aAAa,CAAC,IAAI;gBACjC,aAAa,EAAE,aAAa,CAAC,IAAI;gBACjC,IAAI;gBACJ,KAAK;gBACL,SAAS,EAAE,MAAM,CAAC,WAAW;gBAC7B,OAAO,EAAE,YAAY,CAAC,OAAO;aAC9B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,mCAAmC,CAAC,CAAC;IACzD,CAAC;IAED,2CAA2C;IAC3C,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACH,MAAM,cAAc,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE;wBACrD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACpC,aAAa,EAAE,kBAAkB,aAAa,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,EAAE;qBAC3E,CAAC,CAAC;oBACH,QAAQ,EAAE,CAAC;gBACb,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,8CAA8C,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,qCAAqC;IACrC,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC;YACzD,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAEzD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBAEpD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,UAAU,KAAK,aAAa;wBAAE,SAAS;oBAEhD,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACpE,IAAI,CAAC,WAAW;wBAAE,SAAS;oBAE3B,MAAM,QAAQ,GAAG,KAAK,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACjD,MAAM,WAAW,CAAC,cAAc,CAAC;wBAC/B,GAAG,WAAW;wBACd,EAAE,EAAE,QAAQ;wBACZ,SAAS,EAAE,WAAW,CAAC,SAAS;wBAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;qBACnE,CAAC,CAAC;oBAEH,MAAM,WAAW,CAAC,OAAO,CAAC;wBACxB,UAAU,EAAE,aAAa;wBACzB,QAAQ,EAAE,QAAQ;wBAClB,MAAM,EAAE,KAAK,CAAC,QAAQ;wBACtB,QAAQ,EAAE,YAAY;wBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;qBACnE,CAAC,CAAC;oBAEH,gBAAgB,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,mCAAmC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,CAAC,4BAA4B,GAAG,gBAAgB,CAAC;QACvD,MAAM,CAAC,QAAQ,CAAC,4BAA4B,GAAG,gBAAgB,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,103 @@
+/**
+ * CLEO Observability module -- log reading, parsing, filtering.
+ *
+ * Public API for Phase 1 of the Observability epic (T5186).
+ * Read-only: discovers and reads pino JSONL log files from .cleo/logs/.
+ *
+ * @task T5187
+ * @epic T5186
+ */
+export { compareLevels, filterEntries, matchesFilter, paginate } from './log-filter.js';
+export { isValidLevel, parseLogLine, parseLogLines } from './log-parser.js';
+export { discoverLogFiles, getGlobalLogDir, getProjectLogDir, readLogFileLines, streamLogFileLines, } from './log-reader.js';
+export { PINO_LEVEL_VALUES } from './types.js';
+import { filterEntries, matchesFilter, paginate } from './log-filter.js';
+import { parseLogLine, parseLogLines } from './log-parser.js';
+import { discoverLogFiles, readLogFileLines, streamLogFileLines } from './log-reader.js';
+/**
+ * High-level query: discover files, parse, filter, paginate.
+ * Convenience wrapper combining all three layers.
+ */
+export function queryLogs(filter, options, cwd) {
+    const files = discoverLogFiles(options, cwd);
+    const filesPaths = files.map((f) => f.path);
+    let totalScanned = 0;
+    const allEntries = [];
+    for (const file of files) {
+        const lines = readLogFileLines(file.path);
+        totalScanned += lines.length;
+        const parsed = parseLogLines(lines);
+        allEntries.push(...parsed);
+    }
+    // Apply filters (excluding limit/offset which are pagination)
+    const matched = filter ? filterEntries(allEntries, filter) : allEntries;
+    const totalMatched = matched.length;
+    // Apply pagination
+    const entries = paginate(matched, filter?.limit, filter?.offset);
+    return {
+        entries,
+        totalScanned,
+        totalMatched,
+        files: filesPaths,
+    };
+}
+/**
+ * Stream-based query for large log datasets.
+ * Yields matching entries one at a time.
+ * Respects limit. Does not support offset (streaming is forward-only).
+ */
+export async function* streamLogs(filter, options, cwd) {
+    const files = discoverLogFiles(options, cwd);
+    let yielded = 0;
+    const limit = filter?.limit;
+    for (const file of files) {
+        if (limit !== undefined && yielded >= limit)
+            break;
+        for await (const line of streamLogFileLines(file.path)) {
+            const entry = parseLogLine(line);
+            if (!entry)
+                continue;
+            if (filter && !matchesFilter(entry, filter))
+                continue;
+            yield entry;
+            yielded++;
+            if (limit !== undefined && yielded >= limit)
+                return;
+        }
+    }
+}
+/**
+ * Get a summary of log activity (counts by level, date range, subsystems).
+ * Reads all discovered files but does not return individual entries.
+ */
+export function getLogSummary(options, cwd) {
+    const files = discoverLogFiles(options, cwd);
+    const byLevel = {};
+    const bySubsystem = {};
+    let totalEntries = 0;
+    let earliest = null;
+    let latest = null;
+    for (const file of files) {
+        const lines = readLogFileLines(file.path);
+        const entries = parseLogLines(lines);
+        totalEntries += entries.length;
+        for (const entry of entries) {
+            byLevel[entry.level] = (byLevel[entry.level] ?? 0) + 1;
+            if (entry.subsystem) {
+                bySubsystem[entry.subsystem] = (bySubsystem[entry.subsystem] ?? 0) + 1;
+            }
+            if (earliest === null || entry.time < earliest)
+                earliest = entry.time;
+            if (latest === null || entry.time > latest)
+                latest = entry.time;
+        }
+    }
+    return {
+        totalEntries,
+        byLevel,
+        bySubsystem,
+        dateRange: earliest && latest ? { earliest, latest } : null,
+        files,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

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

package/dist/observability/log-filter.js

@@ -0,0 +1,63 @@
+/**
+ * Log entry filtering and pagination.
+ *
+ * Applies filter criteria to parsed PinoLogEntry arrays.
+ * All filter fields use AND logic when multiple are specified.
+ *
+ * @task T5187
+ * @epic T5186
+ */
+import { PINO_LEVEL_VALUES } from './types.js';
+/**
+ * Compare two pino levels numerically.
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+export function compareLevels(a, b) {
+    return PINO_LEVEL_VALUES[a] - PINO_LEVEL_VALUES[b];
+}
+/**
+ * Check if a single entry matches the filter criteria.
+ * All specified fields must match (AND logic).
+ */
+export function matchesFilter(entry, filter) {
+    if (filter.level !== undefined && entry.level !== filter.level)
+        return false;
+    if (filter.minLevel !== undefined && compareLevels(entry.level, filter.minLevel) < 0)
+        return false;
+    if (filter.since !== undefined && entry.time < filter.since)
+        return false;
+    if (filter.until !== undefined && entry.time > filter.until)
+        return false;
+    if (filter.subsystem !== undefined && entry.subsystem !== filter.subsystem)
+        return false;
+    if (filter.code !== undefined && entry.code !== filter.code)
+        return false;
+    if (filter.exitCode !== undefined && entry.exitCode !== filter.exitCode)
+        return false;
+    if (filter.pid !== undefined && entry.pid !== filter.pid)
+        return false;
+    if (filter.msgContains !== undefined) {
+        if (!entry.msg.toLowerCase().includes(filter.msgContains.toLowerCase()))
+            return false;
+    }
+    return true;
+}
+/**
+ * Filter an array of parsed log entries against criteria.
+ * Returns entries matching ALL specified criteria (AND logic).
+ * Does not apply pagination (limit/offset) -- use paginate() for that.
+ */
+export function filterEntries(entries, filter) {
+    return entries.filter((entry) => matchesFilter(entry, filter));
+}
+/**
+ * Apply pagination (limit/offset) to a result set.
+ */
+export function paginate(entries, limit, offset) {
+    const start = offset ?? 0;
+    if (limit !== undefined) {
+        return entries.slice(start, start + limit);
+    }
+    return start > 0 ? entries.slice(start) : entries;
+}
+//# sourceMappingURL=log-filter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log-filter.js","sourceRoot":"","sources":["../../src/observability/log-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAY,EAAE,CAAY;IACtD,OAAO,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,MAAiB;IAClE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAE7E,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClF,OAAO,KAAK,CAAC;IAEf,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAE1E,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAE1E,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAEzF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAE1E,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEtF,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvE,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;IACxF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAuB,EAAE,MAAiB;IACtE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAuB,EAAE,KAAc,EAAE,MAAe;IAC/E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpD,CAAC"}