@stoneforge/quarry 1.10.1 → 1.12.0

package/dist/cli/commands/history.js

@@ -135,7 +135,7 @@ Arguments:
   id    Element identifier (e.g., el-abc123)
 
 Options:
-  -n, --limit <n>       Maximum events to show (default: 50)
+  -l, --limit <n>       Maximum events to show (default: 50)
   -t, --type <type>     Filter by event type
   -a, --actor <actor>   Filter by actor
       --after <time>    Show events after this time (ISO 8601)

package/dist/cli/commands/log.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Log Command - Show operation log entries
+ *
+ * Provides CLI access to the persistent operation log, allowing users
+ * to query system events (dispatch, session, merge, rate-limit, recovery).
+ *
+ * Examples:
+ *   sf log                           Show last 20 entries
+ *   sf log --level error             Filter by level
+ *   sf log --category rate-limit     Filter by category
+ *   sf log --since 2h               Relative time filter
+ *   sf log --task el-xxxx            Filter by task
+ *   sf log --agent el-xxxx           Filter by agent
+ *   sf log --limit 50               Control output count
+ */
+import type { Command } from '../types.js';
+export declare const logCommand: Command;
+//# sourceMappingURL=log.d.ts.map

package/dist/cli/commands/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAA+C,MAAM,aAAa,CAAC;AA+SxF,eAAO,MAAM,UAAU,EAAE,OAiCxB,CAAC"}

package/dist/cli/commands/log.js

@@ -0,0 +1,282 @@
+/**
+ * Log Command - Show operation log entries
+ *
+ * Provides CLI access to the persistent operation log, allowing users
+ * to query system events (dispatch, session, merge, rate-limit, recovery).
+ *
+ * Examples:
+ *   sf log                           Show last 20 entries
+ *   sf log --level error             Filter by level
+ *   sf log --category rate-limit     Filter by category
+ *   sf log --since 2h               Relative time filter
+ *   sf log --task el-xxxx            Filter by task
+ *   sf log --agent el-xxxx           Filter by agent
+ *   sf log --limit 50               Control output count
+ */
+import { success, failure, ExitCode } from '../types.js';
+import { getOutputMode } from '../formatter.js';
+import { createAPI } from '../db.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+const VALID_LEVELS = ['info', 'warn', 'error'];
+const VALID_CATEGORIES = ['dispatch', 'merge', 'session', 'rate-limit', 'steward', 'recovery'];
+/**
+ * Parse a relative time string (e.g. "2h", "30m", "1d") into an ISO timestamp.
+ * Falls back to treating the string as an ISO 8601 timestamp.
+ */
+function parseSinceValue(value) {
+    const relativeMatch = value.match(/^(\d+(?:\.\d+)?)\s*(s|m|h|d|w)$/i);
+    if (relativeMatch) {
+        const amount = parseFloat(relativeMatch[1]);
+        const unit = relativeMatch[2].toLowerCase();
+        const multipliers = {
+            s: 1000,
+            m: 60 * 1000,
+            h: 60 * 60 * 1000,
+            d: 24 * 60 * 60 * 1000,
+            w: 7 * 24 * 60 * 60 * 1000,
+        };
+        const ms = amount * multipliers[unit];
+        return new Date(Date.now() - ms).toISOString();
+    }
+    // Treat as ISO timestamp — validate it parses
+    const date = new Date(value);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid --since value: "${value}". Use relative time (e.g. 2h, 30m, 1d) or ISO 8601 timestamp.`);
+    }
+    return date.toISOString();
+}
+/**
+ * Format a timestamp for display.
+ * Shows relative time for recent entries, full timestamp for older ones.
+ */
+function formatTimestamp(isoTimestamp) {
+    const date = new Date(isoTimestamp);
+    const now = Date.now();
+    const diffMs = now - date.getTime();
+    if (diffMs < 60_000) {
+        return `${Math.floor(diffMs / 1000)}s ago`;
+    }
+    if (diffMs < 3600_000) {
+        return `${Math.floor(diffMs / 60_000)}m ago`;
+    }
+    if (diffMs < 86400_000) {
+        return `${Math.floor(diffMs / 3600_000)}h ago`;
+    }
+    // For older entries, show the date and time
+    return date.toLocaleString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    });
+}
+/**
+ * Format a log level with consistent width and visual indicator
+ */
+function formatLevel(level) {
+    switch (level) {
+        case 'error':
+            return 'ERR ';
+        case 'warn':
+            return 'WARN';
+        case 'info':
+            return 'INFO';
+        default:
+            return level.toUpperCase().padEnd(4);
+    }
+}
+// ============================================================================
+// Command Options
+// ============================================================================
+const logOptions = [
+    {
+        name: 'level',
+        description: `Filter by log level (${VALID_LEVELS.join(', ')})`,
+        hasValue: true,
+    },
+    {
+        name: 'category',
+        short: 'c',
+        description: `Filter by category (${VALID_CATEGORIES.join(', ')})`,
+        hasValue: true,
+    },
+    {
+        name: 'since',
+        short: 's',
+        description: 'Show entries since time (e.g. 2h, 30m, 1d) or ISO 8601 timestamp',
+        hasValue: true,
+    },
+    {
+        name: 'task',
+        short: 't',
+        description: 'Filter by task ID',
+        hasValue: true,
+    },
+    {
+        name: 'agent',
+        short: 'a',
+        description: 'Filter by agent ID',
+        hasValue: true,
+    },
+    {
+        name: 'limit',
+        short: 'l',
+        description: 'Maximum number of entries to show (default: 20)',
+        hasValue: true,
+    },
+];
+// ============================================================================
+// Handler
+// ============================================================================
+async function logHandler(_args, options) {
+    const { backend, error } = createAPI(options);
+    if (error) {
+        return failure(error, ExitCode.GENERAL_ERROR);
+    }
+    try {
+        // Validate level
+        if (options.level && !VALID_LEVELS.includes(options.level)) {
+            return failure(`Invalid --level: "${options.level}". Must be one of: ${VALID_LEVELS.join(', ')}`, ExitCode.VALIDATION);
+        }
+        // Validate category
+        if (options.category && !VALID_CATEGORIES.includes(options.category)) {
+            return failure(`Invalid --category: "${options.category}". Must be one of: ${VALID_CATEGORIES.join(', ')}`, ExitCode.VALIDATION);
+        }
+        // Validate and parse limit
+        let limit = 20;
+        if (options.limit) {
+            limit = parseInt(options.limit, 10);
+            if (isNaN(limit) || limit < 1) {
+                return failure('--limit must be a positive number', ExitCode.VALIDATION);
+            }
+        }
+        // Parse --since
+        let since;
+        if (options.since) {
+            try {
+                since = parseSinceValue(options.since);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return failure(msg, ExitCode.VALIDATION);
+            }
+        }
+        // Build SQL query directly (the CLI has direct storage access)
+        const conditions = [];
+        const params = [];
+        if (options.level) {
+            conditions.push('level = ?');
+            params.push(options.level);
+        }
+        if (options.category) {
+            conditions.push('category = ?');
+            params.push(options.category);
+        }
+        if (since) {
+            conditions.push('timestamp >= ?');
+            params.push(since);
+        }
+        if (options.task) {
+            conditions.push('task_id = ?');
+            params.push(options.task);
+        }
+        if (options.agent) {
+            conditions.push('agent_id = ?');
+            params.push(options.agent);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const rows = backend.query(`SELECT id, timestamp, level, category, agent_id, task_id, message, details
+       FROM operation_log
+       ${whereClause}
+       ORDER BY timestamp DESC
+       LIMIT ?`, [...params, limit]);
+        // Map rows to a JSON-friendly shape
+        const entries = rows.map((row) => ({
+            id: row.id,
+            timestamp: row.timestamp,
+            level: row.level,
+            category: row.category,
+            agentId: row.agent_id ?? undefined,
+            taskId: row.task_id ?? undefined,
+            message: row.message,
+            details: row.details ? JSON.parse(row.details) : undefined,
+        }));
+        const mode = getOutputMode(options);
+        if (mode === 'json') {
+            return success(entries);
+        }
+        if (mode === 'quiet') {
+            const ids = entries.map((e) => e.id).join('\n');
+            return success(ids);
+        }
+        // Human-readable output
+        if (entries.length === 0) {
+            return success([], 'No log entries found.');
+        }
+        const lines = [];
+        // Show entries in reverse chronological order (newest first)
+        for (const entry of entries) {
+            const time = formatTimestamp(entry.timestamp);
+            const level = formatLevel(entry.level);
+            const cat = entry.category.padEnd(10);
+            let line = `${time.padEnd(14)} ${level}  ${cat}  ${entry.message}`;
+            // Append context tags
+            const tags = [];
+            if (entry.taskId)
+                tags.push(`task=${entry.taskId}`);
+            if (entry.agentId)
+                tags.push(`agent=${entry.agentId}`);
+            if (tags.length > 0) {
+                line += `  [${tags.join(', ')}]`;
+            }
+            lines.push(line);
+        }
+        const header = `Operation Log (${entries.length} entries):\n`;
+        return success(entries, header + lines.join('\n'));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return failure(`Failed to query operation log: ${message}`, ExitCode.GENERAL_ERROR);
+    }
+}
+// ============================================================================
+// Command Definition
+// ============================================================================
+export const logCommand = {
+    name: 'log',
+    description: 'Show operation log entries',
+    usage: 'sf log [options]',
+    help: `Show persistent operation log entries for system observability.
+
+The operation log captures key events from the orchestration system including
+dispatch, session, merge, rate-limit, steward, and recovery events.
+
+Options:
+      --level <level>       Filter by level: info, warn, error
+  -c, --category <cat>      Filter by category: dispatch, merge, session,
+                             rate-limit, steward, recovery
+  -s, --since <time>        Show entries since time. Accepts relative time
+                             (e.g. 2h, 30m, 1d, 1w) or ISO 8601 timestamp
+  -t, --task <id>           Filter by task ID
+  -a, --agent <id>          Filter by agent ID
+  -l, --limit <n>           Maximum entries to show (default: 20)
+
+Examples:
+  sf log                              Show last 20 entries
+  sf log --level error                Show only errors
+  sf log --category session           Show session events
+  sf log --category rate-limit        Show rate limit events
+  sf log --since 2h                   Show entries from last 2 hours
+  sf log --since 2026-02-23T00:00:00  Show entries since specific time
+  sf log --task el-xxxx               Show entries for a specific task
+  sf log --agent el-xxxx              Show entries for a specific agent
+  sf log --limit 50                   Show last 50 entries
+  sf log --level error --since 1d     Combine filters
+  sf log --json                       Output as JSON`,
+    options: logOptions,
+    handler: logHandler,
+};
+//# sourceMappingURL=log.js.map

package/dist/cli/commands/log.js.map

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

package/dist/cli/commands/metrics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Metrics Command - Show provider metrics
+ *
+ * Displays LLM provider usage metrics including token counts,
+ * estimated costs, session counts, and error rates.
+ */
+import type { Command } from '../types.js';
+export declare const metricsCommand: Command;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/cli/commands/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAA+C,MAAM,aAAa,CAAC;AAwQxF,eAAO,MAAM,cAAc,EAAE,OAoB5B,CAAC"}

package/dist/cli/commands/metrics.js

@@ -0,0 +1,219 @@
+/**
+ * Metrics Command - Show provider metrics
+ *
+ * Displays LLM provider usage metrics including token counts,
+ * estimated costs, session counts, and error rates.
+ */
+import { success, failure, ExitCode } from '../types.js';
+import { createAPI } from '../db.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Parse a time range string (e.g., '7d', '14d', '30d') to number of days.
+ */
+function parseTimeRange(value) {
+    if (!value)
+        return 7;
+    const match = value.match(/^(\d+)d$/);
+    if (match) {
+        const days = parseInt(match[1], 10);
+        if (days > 0 && days <= 365)
+            return days;
+    }
+    return 7;
+}
+/**
+ * Rough cost estimate based on token counts.
+ * Uses approximate Claude pricing: $3/MTok input, $15/MTok output.
+ */
+function estimateCost(inputTokens, outputTokens) {
+    const inputCost = (inputTokens / 1_000_000) * 3;
+    const outputCost = (outputTokens / 1_000_000) * 15;
+    return inputCost + outputCost;
+}
+/**
+ * Format a number with thousands separators
+ */
+function formatNumber(n) {
+    return n.toLocaleString('en-US');
+}
+/**
+ * Format milliseconds as human-readable duration
+ */
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const seconds = Math.round(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60)
+        return `${minutes}m ${remainingSeconds}s`;
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return `${hours}h ${remainingMinutes}m`;
+}
+/**
+ * Format cost as a dollar amount
+ */
+function formatCost(cost) {
+    if (cost < 0.01)
+        return '$0.00';
+    return `$${cost.toFixed(2)}`;
+}
+/**
+ * Query aggregated metrics directly from the database
+ */
+function queryMetrics(backend, days, groupBy, providerFilter) {
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const cutoffStr = cutoff.toISOString();
+    const groupExpr = groupBy === 'provider' ? 'provider' : "COALESCE(model, 'unknown')";
+    const params = [cutoffStr];
+    let whereClause = 'WHERE timestamp >= ?';
+    if (providerFilter) {
+        whereClause += ' AND provider = ?';
+        params.push(providerFilter);
+    }
+    return backend.query(`SELECT
+       ${groupExpr} AS group_key,
+       COALESCE(SUM(input_tokens), 0) AS total_input_tokens,
+       COALESCE(SUM(output_tokens), 0) AS total_output_tokens,
+       COUNT(*) AS session_count,
+       COALESCE(AVG(duration_ms), 0) AS avg_duration_ms,
+       COALESCE(SUM(CASE WHEN outcome = 'failed' THEN 1 ELSE 0 END), 0) AS failed_count,
+       COALESCE(SUM(CASE WHEN outcome = 'rate_limited' THEN 1 ELSE 0 END), 0) AS rate_limited_count
+     FROM provider_metrics
+     ${whereClause}
+     GROUP BY group_key
+     ORDER BY total_input_tokens + total_output_tokens DESC`, params);
+}
+// ============================================================================
+// Handler
+// ============================================================================
+async function metricsHandler(_args, options) {
+    const { backend, error } = createAPI(options);
+    if (error) {
+        return failure(error, ExitCode.GENERAL_ERROR);
+    }
+    try {
+        const days = parseTimeRange(options.range);
+        const providerFilter = options.provider;
+        const groupBy = options['group-by'] === 'model' ? 'model' : 'provider';
+        const rows = queryMetrics(backend, days, groupBy, providerFilter);
+        const metrics = rows.map(row => ({
+            group: row.group_key,
+            totalInputTokens: Number(row.total_input_tokens),
+            totalOutputTokens: Number(row.total_output_tokens),
+            totalTokens: Number(row.total_input_tokens) + Number(row.total_output_tokens),
+            sessionCount: Number(row.session_count),
+            avgDurationMs: Math.round(Number(row.avg_duration_ms)),
+            errorRate: Number(row.session_count) > 0
+                ? Number(row.failed_count) / Number(row.session_count)
+                : 0,
+            failedCount: Number(row.failed_count),
+            rateLimitedCount: Number(row.rate_limited_count),
+            estimatedCost: estimateCost(Number(row.total_input_tokens), Number(row.total_output_tokens)),
+        }));
+        const totals = {
+            totalInputTokens: metrics.reduce((sum, m) => sum + m.totalInputTokens, 0),
+            totalOutputTokens: metrics.reduce((sum, m) => sum + m.totalOutputTokens, 0),
+            totalTokens: metrics.reduce((sum, m) => sum + m.totalTokens, 0),
+            sessionCount: metrics.reduce((sum, m) => sum + m.sessionCount, 0),
+            estimatedCost: metrics.reduce((sum, m) => sum + m.estimatedCost, 0),
+        };
+        const summary = {
+            timeRange: { days, label: `${days}d` },
+            groupBy,
+            metrics,
+            totals,
+        };
+        // Build human-readable output
+        const lines = [];
+        const groupLabel = groupBy === 'provider' ? 'Provider' : 'Model';
+        lines.push(`Provider Metrics (last ${days} days)`);
+        if (providerFilter) {
+            lines.push(`Filtered by provider: ${providerFilter}`);
+        }
+        lines.push('');
+        if (metrics.length === 0) {
+            lines.push('No metrics recorded for the selected time range.');
+            return success(summary, lines.join('\n'));
+        }
+        // Summary totals
+        lines.push('Summary:');
+        lines.push(`  Total tokens:     ${formatNumber(totals.totalTokens)}`);
+        lines.push(`  Input tokens:     ${formatNumber(totals.totalInputTokens)}`);
+        lines.push(`  Output tokens:    ${formatNumber(totals.totalOutputTokens)}`);
+        lines.push(`  Sessions:         ${formatNumber(totals.sessionCount)}`);
+        lines.push(`  Estimated cost:   ${formatCost(totals.estimatedCost)}`);
+        lines.push('');
+        // Per-group breakdown
+        lines.push(`By ${groupLabel}:`);
+        lines.push('');
+        for (const m of metrics) {
+            lines.push(`  ${m.group}`);
+            lines.push(`    Tokens:      ${formatNumber(m.totalTokens)} (in: ${formatNumber(m.totalInputTokens)}, out: ${formatNumber(m.totalOutputTokens)})`);
+            lines.push(`    Sessions:    ${formatNumber(m.sessionCount)}`);
+            lines.push(`    Avg duration: ${formatDuration(m.avgDurationMs)}`);
+            lines.push(`    Error rate:  ${(m.errorRate * 100).toFixed(1)}% (${m.failedCount} failed, ${m.rateLimitedCount} rate limited)`);
+            lines.push(`    Est. cost:   ${formatCost(m.estimatedCost)}`);
+            lines.push('');
+        }
+        return success(summary, lines.join('\n'));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return failure(`Failed to get metrics: ${message}`, ExitCode.GENERAL_ERROR);
+    }
+}
+// ============================================================================
+// Command Options
+// ============================================================================
+const metricsOptions = [
+    {
+        name: 'range',
+        short: 'r',
+        description: 'Time range (e.g., 7d, 14d, 30d)',
+        hasValue: true,
+    },
+    {
+        name: 'provider',
+        short: 'p',
+        description: 'Filter by provider name',
+        hasValue: true,
+    },
+    {
+        name: 'group-by',
+        short: 'g',
+        description: 'Group by: provider (default) or model',
+        hasValue: true,
+    },
+];
+// ============================================================================
+// Command Definition
+// ============================================================================
+export const metricsCommand = {
+    name: 'metrics',
+    description: 'Show provider metrics and usage statistics',
+    usage: 'sf metrics [options]',
+    help: `Show LLM provider usage metrics including token counts, estimated costs,
+session counts, average duration, and error rates.
+
+Options:
+  --range, -r    Time range (e.g., 7d, 14d, 30d). Default: 7d
+  --provider, -p Filter by provider name (e.g., claude-code)
+  --group-by, -g Group by: provider (default) or model
+
+Examples:
+  sf metrics                  Show metrics for last 7 days
+  sf metrics --range 30d      Show metrics for last 30 days
+  sf metrics --provider claude-code  Filter by provider
+  sf metrics --group-by model        Group by model
+  sf metrics --json           Output as JSON`,
+    handler: metricsHandler,
+    options: metricsOptions,
+};
+//# sourceMappingURL=metrics.js.map

package/dist/cli/commands/metrics.js.map

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

package/dist/cli/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,YAAY,CAAC;AAiBxE;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnD;AAwDD;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGzD;AAgCD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,KAAK,CAAC,CAuKjF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,YAAY,CAAC;AAiBxE;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnD;AAwDD;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGzD;AAgCD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,KAAK,CAAC,CA6KjF"}

package/dist/cli/runner.js

@@ -222,9 +222,11 @@ export async function main(argv = process.argv.slice(2)) {
     const { identityCommand, whoamiCommand } = await import('./commands/identity.js');
     const { entityCommand } = await import('./commands/entity.js');
     const { statsCommand } = await import('./commands/stats.js');
+    const { metricsCommand } = await import('./commands/metrics.js');
     const { doctorCommand, migrateCommand } = await import('./commands/admin.js');
     const { gcCommand } = await import('./commands/gc.js');
     const { historyCommand } = await import('./commands/history.js');
+    const { logCommand } = await import('./commands/log.js');
     const { planCommand } = await import('./commands/plan.js');
     const { workflowCommand } = await import('./commands/workflow.js');
     const { playbookCommand } = await import('./commands/playbook.js');
@@ -274,11 +276,14 @@ export async function main(argv = process.argv.slice(2)) {
     registerCommand(entityCommand);
     // Admin commands
     registerCommand(statsCommand);
+    registerCommand(metricsCommand);
     registerCommand(doctorCommand);
     registerCommand(migrateCommand);
     registerCommand(gcCommand);
     // History command
     registerCommand(historyCommand);
+    // Operation log command
+    registerCommand(logCommand);
     // Collection commands
     registerCommand(planCommand);
     registerCommand(workflowCommand);