@cleocode/core 2026.4.9 → 2026.4.11

package/dist/nexus/workspace.js

@@ -0,0 +1,355 @@
+/**
+ * NEXUS Workspace — Cross-project orchestration operations.
+ *
+ * Implements ORCH-PLAN Phase B:
+ * - B.2: nexus.route(directiveEvent) — dispatch Conduit directives to the correct project
+ * - B.3: nexus.workspace.status() — aggregated cross-project task view
+ * - B.4: nexus.workspace.agents() — cross-project agent registry view
+ *
+ * Security: project-level ACL enforced on all routing operations (HIGH-02).
+ * Rate limiting: per-agent throttling on route operations (MEDIUM-05).
+ * Audit: all routing operations logged (LOW-06).
+ *
+ * @module nexus/workspace
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+import { nexusList } from './registry.js';
+// ============================================================================
+// Rate limiting (MEDIUM-05)
+// ============================================================================
+const RATE_LIMIT_WINDOW_MS = 60_000;
+const RATE_LIMIT_MAX_OPS = 100;
+/** Per-agent operation counters for rate limiting. */
+const rateLimitCounters = new Map();
+/** Check if an agent is rate-limited. Throws if exceeded. */
+function checkRateLimit(agentId) {
+    const now = Date.now();
+    const entry = rateLimitCounters.get(agentId);
+    if (!entry || now - entry.windowStart > RATE_LIMIT_WINDOW_MS) {
+        rateLimitCounters.set(agentId, { count: 1, windowStart: now });
+        return;
+    }
+    entry.count++;
+    if (entry.count > RATE_LIMIT_MAX_OPS) {
+        throw new CleoError(ExitCode.GENERAL_ERROR, `Agent '${agentId}' exceeded rate limit: ${RATE_LIMIT_MAX_OPS} routing ops per ${RATE_LIMIT_WINDOW_MS / 1000}s`);
+    }
+}
+// ============================================================================
+// ACL (HIGH-02)
+// ============================================================================
+/** Default ACL: denies every agent unless the project explicitly authorizes them. */
+const DEFAULT_ACL = { authorizedAgents: [] };
+/**
+ * Load ACL for a project. Reads from .cleo/config.json authorizedAgents field.
+ * Falls back to deny-all if not configured.
+ */
+async function loadProjectACL(projectPath) {
+    try {
+        const { loadConfig } = await import('../config.js');
+        const config = await loadConfig(projectPath);
+        const agents = config?.authorizedAgents;
+        if (Array.isArray(agents) && agents.length > 0) {
+            return { authorizedAgents: agents };
+        }
+    }
+    catch {
+        await logAclFailure(projectPath);
+    }
+    return DEFAULT_ACL;
+}
+async function logAclFailure(projectPath) {
+    try {
+        const { getLogger } = await import('../logger.js');
+        const log = getLogger('nexus.acl');
+        log.warn({ projectPath }, 'Failed to load ACL configuration, defaulting to deny-all');
+    }
+    catch {
+        // best-effort logging
+    }
+}
+/** Check if an agent is authorized to mutate a project. */
+function isAuthorized(acl, agentId) {
+    if (acl.authorizedAgents.includes('*'))
+        return true;
+    return acl.authorizedAgents.includes(agentId);
+}
+// ============================================================================
+// B.2: nexus.route() — Directive routing
+// ============================================================================
+/** Task reference pattern: T followed by digits (T001, T42, T1234). */
+const TASK_REF_PATTERN = /\bT(\d+)\b/g;
+/**
+ * Parse a Conduit message into a structured directive.
+ *
+ * Extracts directive verbs (/claim, /done, /blocked) and task references
+ * from the message content and metadata.
+ */
+export function parseDirective(message) {
+    const content = message.content;
+    // Extract directive verb (first /word in content)
+    const verbMatch = content.match(/^\/(\w+)/);
+    if (!verbMatch)
+        return null;
+    const verb = verbMatch[1];
+    // Extract task refs from content
+    const taskRefs = [];
+    const pattern = new RegExp(TASK_REF_PATTERN.source, 'g');
+    for (const m of content.matchAll(pattern)) {
+        taskRefs.push(`T${m[1]}`);
+    }
+    // Also check metadata.taskRefs from SignalDock extraction (Phase A.5)
+    const metaRefs = message.metadata?.taskRefs;
+    if (Array.isArray(metaRefs)) {
+        for (const ref of metaRefs) {
+            if (typeof ref === 'string' && !taskRefs.includes(ref)) {
+                taskRefs.push(ref);
+            }
+        }
+    }
+    if (taskRefs.length === 0)
+        return null;
+    return {
+        verb,
+        taskRefs,
+        agentId: message.from,
+        messageId: message.id,
+        timestamp: message.timestamp,
+    };
+}
+/** Map directive verbs to CLEO task operations. */
+const VERB_TO_OPERATION = {
+    claim: 'tasks.start',
+    done: 'tasks.complete',
+    complete: 'tasks.complete',
+    blocked: 'tasks.update', // Update status to blocked
+    start: 'tasks.start',
+    stop: 'tasks.stop',
+};
+/**
+ * Route a Conduit directive to the correct project's CLEO instance.
+ *
+ * Resolves which project owns the referenced task, checks ACL,
+ * and dispatches the appropriate CLEO operation.
+ *
+ * @param directive - Parsed directive from a Conduit message
+ * @returns Array of route results (one per task reference)
+ */
+export async function routeDirective(directive) {
+    // Rate limit check (MEDIUM-05)
+    checkRateLimit(directive.agentId);
+    const results = [];
+    const operation = VERB_TO_OPERATION[directive.verb];
+    if (!operation) {
+        // Unknown verb — not routable, just skip
+        return results;
+    }
+    const projects = await nexusList();
+    for (const taskRef of directive.taskRefs) {
+        const result = await routeSingleTask(taskRef, directive, operation, projects);
+        results.push(result);
+    }
+    return results;
+}
+/** Route a single task reference to its project and execute the operation. */
+async function routeSingleTask(taskId, directive, operation, projects) {
+    // Find which project owns this task
+    let targetProject = null;
+    let targetAccessor = null;
+    for (const project of projects) {
+        try {
+            const acc = await getAccessor(project.path);
+            const { tasks } = await acc.queryTasks({});
+            const task = tasks.find((t) => t.id === taskId);
+            if (task) {
+                targetProject = project;
+                targetAccessor = acc;
+                break;
+            }
+        }
+        catch { }
+    }
+    if (!targetProject || !targetAccessor) {
+        return {
+            success: false,
+            project: 'unknown',
+            projectPath: '',
+            taskId,
+            operation,
+            error: `Task ${taskId} not found in any registered project`,
+        };
+    }
+    // ACL check (HIGH-02)
+    const acl = await loadProjectACL(targetProject.path);
+    if (!isAuthorized(acl, directive.agentId)) {
+        // E-FIND-004: audit ACL denials and redact projectPath
+        await logRouteAudit(directive, targetProject.name, taskId, operation, false);
+        return {
+            success: false,
+            project: targetProject.name,
+            projectPath: '',
+            taskId,
+            operation,
+            error: `Agent '${directive.agentId}' not authorized to mutate project '${targetProject.name}'`,
+        };
+    }
+    // Execute the operation
+    try {
+        await executeOperation(operation, taskId, targetProject.path, targetAccessor, directive);
+        // Audit log (LOW-06)
+        await logRouteAudit(directive, targetProject.name, taskId, operation, true);
+        return {
+            success: true,
+            project: targetProject.name,
+            projectPath: targetProject.path,
+            taskId,
+            operation,
+        };
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        // Audit log for failures too
+        await logRouteAudit(directive, targetProject.name, taskId, operation, false, errorMsg);
+        return {
+            success: false,
+            project: targetProject.name,
+            projectPath: targetProject.path,
+            taskId,
+            operation,
+            error: errorMsg,
+        };
+    }
+}
+/** Execute a CLEO operation on a project's task. */
+async function executeOperation(operation, taskId, projectPath, accessor, directive) {
+    switch (operation) {
+        case 'tasks.start': {
+            const { startTask } = await import('../task-work/index.js');
+            await startTask(taskId, projectPath, accessor);
+            break;
+        }
+        case 'tasks.complete': {
+            const { completeTask } = await import('../tasks/complete.js');
+            await completeTask({ taskId, notes: `Completed via Conduit directive from ${directive.agentId}` }, projectPath, accessor);
+            break;
+        }
+        case 'tasks.stop': {
+            const { stopTask } = await import('../task-work/index.js');
+            await stopTask(projectPath, accessor);
+            break;
+        }
+        case 'tasks.update': {
+            const { updateTask } = await import('../tasks/update.js');
+            await updateTask({ taskId, notes: `Marked blocked via Conduit directive from ${directive.agentId}` }, projectPath, accessor);
+            break;
+        }
+    }
+}
+/** Log a routing operation to the audit trail. */
+async function logRouteAudit(directive, projectName, taskId, operation, success, error) {
+    try {
+        const { getLogger } = await import('../logger.js');
+        const log = getLogger('nexus.route');
+        const level = success ? 'info' : 'warn';
+        log[level]({
+            directive: directive.verb,
+            agentId: directive.agentId,
+            messageId: directive.messageId,
+            project: projectName,
+            taskId,
+            operation,
+            success,
+            error,
+        }, `Conduit directive routed: ${directive.verb} ${taskId} → ${projectName} (${success ? 'OK' : 'FAILED'})`);
+    }
+    catch {
+        // Audit logging is best-effort
+    }
+}
+// ============================================================================
+// B.3: nexus.workspace.status() — Aggregated view
+// ============================================================================
+/**
+ * Get aggregated task status across all registered projects.
+ *
+ * Returns per-project task counts and workspace-wide totals.
+ * Respects project permissions — only includes readable projects.
+ */
+export async function workspaceStatus() {
+    const projects = await nexusList();
+    const summaries = [];
+    const totals = { pending: 0, active: 0, done: 0, total: 0 };
+    for (const project of projects) {
+        try {
+            const acc = await getAccessor(project.path);
+            const { tasks } = await acc.queryTasks({});
+            const counts = {
+                pending: tasks.filter((t) => t.status === 'pending').length,
+                active: tasks.filter((t) => t.status === 'active').length,
+                done: tasks.filter((t) => t.status === 'done').length,
+                total: tasks.length,
+            };
+            summaries.push({
+                name: project.name,
+                path: project.path,
+                counts,
+                health: project.healthStatus,
+                lastSync: project.lastSync,
+            });
+            totals.pending += counts.pending;
+            totals.active += counts.active;
+            totals.done += counts.done;
+            totals.total += counts.total;
+        }
+        catch {
+            // Skip unreachable projects
+            summaries.push({
+                name: project.name,
+                path: project.path,
+                counts: { pending: 0, active: 0, done: 0, total: 0 },
+                health: 'unreachable',
+                lastSync: project.lastSync,
+            });
+        }
+    }
+    return {
+        projectCount: projects.length,
+        projects: summaries,
+        totals,
+        computedAt: new Date().toISOString(),
+    };
+}
+// ============================================================================
+// B.4: nexus.workspace.agents() — Cross-project agent view
+// ============================================================================
+/**
+ * Get all agents registered across all projects.
+ *
+ * Queries each project's agent_instances table and returns a unified list.
+ */
+export async function workspaceAgents() {
+    const projects = await nexusList();
+    const agents = [];
+    for (const project of projects) {
+        try {
+            const acc = await getAccessor(project.path);
+            const instances = await acc.listAgentInstances();
+            for (const inst of instances) {
+                agents.push({
+                    agentId: inst.id,
+                    agentType: inst.agentType,
+                    status: inst.status,
+                    project: project.name,
+                    taskId: inst.taskId ?? null,
+                    lastHeartbeat: inst.lastHeartbeat,
+                });
+            }
+        }
+        catch {
+            // Skip projects without agent support
+        }
+    }
+    return agents;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/nexus/workspace.js.map

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

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"}

package/dist/observability/log-parser.js

@@ -0,0 +1,99 @@
+/**
+ * Pino JSONL log line parser.
+ *
+ * Parses individual JSONL lines into typed PinoLogEntry objects.
+ * Handles malformed lines gracefully (returns null).
+ * Separates known fields from extra fields.
+ *
+ * @task T5187
+ * @epic T5186
+ */
+import { PINO_LEVEL_VALUES } from './types.js';
+const VALID_LEVELS = new Set(Object.keys(PINO_LEVEL_VALUES));
+/** Known fields that are extracted into typed PinoLogEntry properties. */
+const KNOWN_FIELDS = new Set([
+    'level',
+    'time',
+    'pid',
+    'hostname',
+    'msg',
+    'subsystem',
+    'code',
+    'exitCode',
+]);
+/**
+ * Validate that a string is a valid PinoLevel.
+ */
+export function isValidLevel(level) {
+    return VALID_LEVELS.has(level);
+}
+/**
+ * Parse a single JSONL line into a PinoLogEntry.
+ * Returns null for empty lines, non-JSON, or lines missing required fields.
+ */
+export function parseLogLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return null;
+    const level = raw.level;
+    if (typeof level !== 'string' || !isValidLevel(level))
+        return null;
+    const time = raw.time;
+    if (typeof time !== 'string')
+        return null;
+    const pid = raw.pid;
+    if (typeof pid !== 'number')
+        return null;
+    const hostname = raw.hostname;
+    if (typeof hostname !== 'string')
+        return null;
+    const msg = raw.msg;
+    if (typeof msg !== 'string')
+        return null;
+    // Collect extra fields
+    const extra = {};
+    for (const key of Object.keys(raw)) {
+        if (!KNOWN_FIELDS.has(key)) {
+            extra[key] = raw[key];
+        }
+    }
+    const entry = {
+        level,
+        time,
+        pid,
+        hostname,
+        msg,
+        extra,
+    };
+    // Optional typed fields
+    if (typeof raw.subsystem === 'string')
+        entry.subsystem = raw.subsystem;
+    if (typeof raw.code === 'string')
+        entry.code = raw.code;
+    if (typeof raw.exitCode === 'number')
+        entry.exitCode = raw.exitCode;
+    return entry;
+}
+/**
+ * Parse multiple JSONL lines into PinoLogEntry array.
+ * Skips malformed lines.
+ */
+export function parseLogLines(lines) {
+    const entries = [];
+    for (const line of lines) {
+        const entry = parseLogLine(line);
+        if (entry)
+            entries.push(entry);
+    }
+    return entries;
+}
+//# sourceMappingURL=log-parser.js.map

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

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