peaks-loop 4.0.0-beta.9 → 4.0.3

package/dist/cli/commands/dashboard-long-run.js

@@ -0,0 +1,122 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
+import { read24hState } from '../../services/24h-mode/index.js';
+import { getErrorMessage } from '../cli-helpers.js';
+const SINCE_PATTERN = /^(\d+)([smhd])$/i;
+const WINDOW_CAP_HOURS = 24;
+const WINDOW_CAP_MS = WINDOW_CAP_HOURS * 60 * 60 * 1000;
+function parseSince(raw) {
+    if (!raw)
+        return { ok: false, error: '--since is required (e.g. 24h, 8h, 30m)' };
+    const match = SINCE_PATTERN.exec(raw);
+    if (!match)
+        return { ok: false, error: `--since must match <n><s|m|h|d> (got ${raw})` };
+    const value = Number(match[1]);
+    if (!Number.isFinite(value) || value < 0)
+        return { ok: false, error: `--since must be a non-negative integer (got ${raw})` };
+    const unit = (match[2] ?? 'h').toLowerCase();
+    const multiplier = unit === 'd' ? 86_400_000 : unit === 'h' ? 3_600_000 : unit === 'm' ? 60_000 : 1_000;
+    return { ok: true, ms: Math.min(WINDOW_CAP_MS, value * multiplier) };
+}
+function readSlices(projectRoot, sessionId) {
+    const path = join(projectRoot, '.peaks', '_runtime', sessionId, 'metrics', 'slices.jsonl');
+    if (!existsSync(path))
+        return 0;
+    try {
+        return readFileSync(path, 'utf8').split('\n').filter((line) => line.trim().length > 0).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function readLastCheckpointAgeMs(snapshot) {
+    if (!snapshot.lastCheckpointAt)
+        return null;
+    const ts = Date.parse(snapshot.lastCheckpointAt);
+    return Number.isFinite(ts) ? Math.max(0, Date.now() - ts) : null;
+}
+function boundaryLabel(raw) {
+    if (raw === '0h' || raw === '0m' || raw === '0s' || raw === '0d') {
+        return { key: 'empty', message: 'since=0 produces an empty window' };
+    }
+    const match = SINCE_PATTERN.exec(raw);
+    if (!match)
+        return { key: 'valid', message: 'unparseable' };
+    const value = Number(match[1]);
+    const unit = (match[2] ?? 'h').toLowerCase();
+    const multiplier = unit === 'd' ? 86_400_000 : unit === 'h' ? 3_600_000 : unit === 'm' ? 60_000 : 1_000;
+    if (value * multiplier > WINDOW_CAP_MS) {
+        return { key: 'cap', message: 'since>24h is capped to the 24h window' };
+    }
+    return { key: 'valid', message: 'within window' };
+}
+export function registerDashboardLongRunCommand(dashboard, io) {
+    dashboard
+        .command('long-run')
+        .description('24h long-run indicator dashboard (read-only) for the active 24h state')
+        .option('--since <duration>', 'time window (e.g. 24h, 8h, 30m); capped at 24h')
+        .option('--project <path>', 'project root (defaults to current directory)')
+        .option('--session-id <sessionId>', 'explicit session id')
+        .option('--json', 'emit machine-readable JSON')
+        .action(async (options) => {
+        const projectRoot = resolveCanonicalProjectRoot(options.project ?? process.cwd());
+        const parsed = parseSince(options.since);
+        if (!parsed.ok) {
+            io.stdout((options.json === true
+                ? JSON.stringify({ ok: false, code: 'INVALID_SINCE', message: parsed.error })
+                : `${parsed.error}\n`) + '\n');
+            process.exitCode = 1;
+            return;
+        }
+        const sid = options.sessionId ?? (await (async () => {
+            const { getSessionIdCanonical } = await import('../../services/session/session-manager.js');
+            return getSessionIdCanonical(projectRoot);
+        })());
+        if (!sid) {
+            io.stdout((options.json === true
+                ? JSON.stringify({ ok: false, code: 'NO_ACTIVE_SESSION', message: 'no --session-id and no canonical binding' })
+                : 'NO_ACTIVE_SESSION: no --session-id and no canonical binding\n'));
+            process.exitCode = 1;
+            return;
+        }
+        const boundary = boundaryLabel(options.since ?? '');
+        try {
+            const snapshot = read24hState(projectRoot, sid);
+            const sliceCount = readSlices(projectRoot, sid);
+            const checkpointAgeMs = readLastCheckpointAgeMs(snapshot);
+            const checkpointFrequency = snapshot.checkpoints > 0 && snapshot.enteredAt
+                ? Math.max(1, Math.round((Date.now() - Date.parse(snapshot.enteredAt)) / snapshot.checkpoints / 60_000))
+                : null;
+            const indicators = {
+                dispatchCount: sliceCount,
+                autoCompactCount: snapshot.autoCompactCount,
+                monotonicTriggerCount: snapshot.monotonicGuards,
+                subAgentFailureCount: Object.values(snapshot.attempts).reduce((a, b) => a + b, 0),
+                checkpointFrequency
+            };
+            const payload = {
+                ok: true,
+                data: {
+                    sessionId: sid,
+                    since: options.since ?? null,
+                    sinceMs: parsed.ms,
+                    sinceCapped: parsed.ms === WINDOW_CAP_MS && boundary.key === 'cap',
+                    boundary: boundary.key,
+                    snapshot: { state: snapshot.state, enteredAt: snapshot.enteredAt, lastCheckpointAt: snapshot.lastCheckpointAt },
+                    indicators,
+                    checkpointAgeMs
+                }
+            };
+            io.stdout((options.json === true ? JSON.stringify(payload) : JSON.stringify(payload.data, null, 2)) + '\n');
+        }
+        catch (error) {
+            io.stdout((options.json === true
+                ? JSON.stringify({ ok: false, code: 'LONG_RUN_READ_FAILED', message: getErrorMessage(error) })
+                : `LONG_RUN_READ_FAILED: ${getErrorMessage(error)}\n`) + '\n');
+            process.exitCode = 1;
+        }
+    });
+}
+export const DASHBOARD_LONG_RUN_CONSTANTS = { WINDOW_CAP_HOURS, WINDOW_CAP_MS };
+export const __test__ = { parseSince, boundaryLabel };

package/dist/cli/commands/dashboard-summary.d.ts

@@ -0,0 +1,12 @@
+/**
+ * rid-030 F-direction: `peaks dashboard summary --since <duration>`.
+ *
+ * Read-only 5-metric surface derived from raw observability events
+ * (cycle / token / dispatch / compact / monotonic-trigger). Distinct
+ * from `peaks dashboard long-run` (which reads 24h-state indicators);
+ * the two commands answer different questions and intentionally
+ * coexist.
+ */
+import type { Command } from 'commander';
+import { type ProgramIO } from '../cli-helpers.js';
+export declare function registerDashboardSummaryCommand(dashboard: Command, io: ProgramIO): void;

package/dist/cli/commands/dashboard-summary.js

@@ -0,0 +1,58 @@
+import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
+import { aggregateDashboardMetrics } from '../../services/observability/aggregation.js';
+import { getErrorMessage } from '../cli-helpers.js';
+import { __test__ as longRunTest } from './dashboard-long-run.js';
+const { parseSince } = longRunTest;
+export function registerDashboardSummaryCommand(dashboard, io) {
+    dashboard
+        .command('summary')
+        .description('Read-only 24h dashboard summary (5 metric classes from observability events)')
+        .option('--since <duration>', 'time window (e.g. 24h, 8h, 30m); defaults to 24h', '24h')
+        .option('--project <path>', 'project root (defaults to current directory)')
+        .option('--session-id <sessionId>', 'explicit session id (defaults to canonical binding)')
+        .option('--json', 'emit machine-readable JSON', false)
+        .action(async (options) => {
+        const projectRoot = resolveCanonicalProjectRoot(options.project ?? process.cwd());
+        const parsed = parseSince(options.since ?? '24h');
+        if (!parsed.ok) {
+            io.stdout((options.json === true
+                ? JSON.stringify({ ok: false, code: 'INVALID_SINCE', message: parsed.error })
+                : `${parsed.error}\n`) + '\n');
+            process.exitCode = 1;
+            return;
+        }
+        const since = new Date(Date.now() - parsed.ms);
+        let sid = options.sessionId ?? null;
+        if (!sid) {
+            const { getSessionIdCanonical } = await import('../../services/session/session-manager.js');
+            sid = await getSessionIdCanonical(projectRoot);
+        }
+        if (!sid) {
+            io.stdout((options.json === true
+                ? JSON.stringify({ ok: false, code: 'NO_ACTIVE_SESSION', message: 'no --session-id and no canonical binding' })
+                : 'NO_ACTIVE_SESSION: no --session-id and no canonical binding\n'));
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const metrics = aggregateDashboardMetrics(projectRoot, sid, since);
+            const payload = {
+                ok: true,
+                data: {
+                    sessionId: sid,
+                    since: options.since ?? '24h',
+                    sinceMs: parsed.ms,
+                    windowStart: since.toISOString(),
+                    metrics
+                }
+            };
+            io.stdout((options.json === true ? JSON.stringify(payload) : JSON.stringify(payload.data, null, 2)) + '\n');
+        }
+        catch (error) {
+            io.stdout((options.json === true
+                ? JSON.stringify({ ok: false, code: 'SUMMARY_READ_FAILED', message: getErrorMessage(error) })
+                : `SUMMARY_READ_FAILED: ${getErrorMessage(error)}\n`) + '\n');
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/cli/commands/dispatch-commands.d.ts

@@ -1,10 +1,3 @@
 import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
 export declare function registerDispatchCommand(parent: Command, io: ProgramIO): void;
-/**
- * 2.7.0 slice-dag-dispatcher MVP — see `dispatch-from-dag.ts`.
- * The function was pulled out of this file in slice 2026-06-23-audit-3rd
- * #7 to honor the 800-line file cap and isolate the three heavy
- * module loads (slice-dag / dag-orchestrator / contract-store) to the
- * --from-dag codepath only.
- */