@ashlr/hub 2.2.0

package/dist/core/daemon/state.d.ts

@@ -0,0 +1,66 @@
+/**
+ * state.ts — Daemon state persistence.
+ *
+ * Responsibilities:
+ *  - daemonStatePath(): path to ~/.ashlr/daemon.json
+ *  - loadDaemonState(): read + parse; NEVER throws; returns zeroed state on
+ *    missing/corrupt file.
+ *  - saveDaemonState(): atomic write (tmp + rename, POSIX-atomic); mkdir -p.
+ *  - resetDayIfNeeded(): pure — if todayDate has rolled over, zero daily
+ *    spend and update the date. Returns (possibly new) state; caller persists.
+ *
+ * No new runtime deps; node builtins only.
+ */
+import type { DaemonState } from '../types.js';
+/** Absolute path to the daemon state file. */
+export declare function daemonStatePath(): string;
+/**
+ * Read and parse daemonStatePath(). NEVER throws.
+ * Returns a fresh zeroed DaemonState when the file is missing or malformed.
+ */
+export declare function loadDaemonState(): DaemonState;
+/**
+ * Atomically write DaemonState to daemonStatePath() via tmp-file + rename
+ * (POSIX-atomic). Creates ~/.ashlr if needed. Never throws.
+ */
+export declare function saveDaemonState(s: DaemonState): void;
+/**
+ * If s.todayDate differs from today's YYYY-MM-DD, return a copy with
+ * todayDate set to today and todaySpentUsd reset to 0 (daily budget reset).
+ * itemsProcessed and ticks are preserved.
+ *
+ * Pure-ish: returns the (possibly new) state; caller is responsible for
+ * persisting via saveDaemonState().
+ */
+export declare function resetDayIfNeeded(s: DaemonState): DaemonState;
+/**
+ * READ-ONLY liveness reconcile. If `s.running === true` but the recorded `pid`
+ * is NOT alive — `process.kill(pid, 0)` throws `ESRCH` (no such process) — flip
+ * `running` to false and `pid` to null so `daemon status` reports a dead daemon
+ * as stopped. Otherwise return `s` unchanged.
+ *
+ * HONEST BOUND (pid reuse): this reports a dead daemon as live ONLY in the rare
+ * case where the OS recycled the recorded pid for an unrelated live process
+ * (then `process.kill(pid,0)` succeeds and we leave the state unchanged) —
+ * inherent to pid-0 liveness. In every other case it is truthful. It is
+ * conservative-toward-alive (it NEVER force-flips a genuinely running daemon
+ * off), and since it changes no spend/guard the residual false-positive is an
+ * observability nicety only, never a safety issue.
+ *
+ * OBSERVABILITY-ONLY by construction: it touches NO spend accounting
+ * (`todaySpentUsd` / `itemsProcessed` / `ticks` are preserved byte-for-byte),
+ * NO guard (kill switch / enrollment / sandbox are unaffected), and adds NO
+ * capability. It only makes the persisted running/pid pair truthful.
+ *
+ * Liveness rules (conservative — NEVER destroy a real running daemon's state):
+ *  - `running !== true` or `pid` not a number => nothing to reconcile => unchanged.
+ *  - `process.kill(pid, 0)` succeeds => process alive => unchanged.
+ *  - throws `ESRCH` => process is GONE => flip to { running:false, pid:null }.
+ *  - throws `EPERM` (exists but not signalable by us) => process EXISTS => alive
+ *    => unchanged (do NOT flip).
+ *  - any other/unexpected error => treat as alive => unchanged.
+ *
+ * Pure-ish: returns the (possibly new) state; caller persists via
+ * saveDaemonState(). Never throws.
+ */
+export declare function reconcileDaemonState(s: DaemonState): DaemonState;

package/dist/core/daemon/state.js

@@ -0,0 +1,197 @@
+/**
+ * state.ts — Daemon state persistence.
+ *
+ * Responsibilities:
+ *  - daemonStatePath(): path to ~/.ashlr/daemon.json
+ *  - loadDaemonState(): read + parse; NEVER throws; returns zeroed state on
+ *    missing/corrupt file.
+ *  - saveDaemonState(): atomic write (tmp + rename, POSIX-atomic); mkdir -p.
+ *  - resetDayIfNeeded(): pure — if todayDate has rolled over, zero daily
+ *    spend and update the date. Returns (possibly new) state; caller persists.
+ *
+ * No new runtime deps; node builtins only.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum number of tick history entries kept in daemon.json. */
+const MAX_TICKS = 100;
+// ---------------------------------------------------------------------------
+// Path helpers (re-resolved at call time so tests can relocate HOME)
+// ---------------------------------------------------------------------------
+function ashlrDir() {
+    return join(homedir(), '.ashlr');
+}
+/** Absolute path to the daemon state file. */
+export function daemonStatePath() {
+    return join(ashlrDir(), 'daemon.json');
+}
+// ---------------------------------------------------------------------------
+// Zeroed default state
+// ---------------------------------------------------------------------------
+function freshState() {
+    return {
+        running: false,
+        pid: null,
+        startedAt: null,
+        lastTickAt: null,
+        todayDate: null,
+        todaySpentUsd: 0,
+        itemsProcessed: 0,
+        ticks: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Load
+// ---------------------------------------------------------------------------
+/**
+ * Read and parse daemonStatePath(). NEVER throws.
+ * Returns a fresh zeroed DaemonState when the file is missing or malformed.
+ */
+export function loadDaemonState() {
+    const p = daemonStatePath();
+    if (!existsSync(p))
+        return freshState();
+    try {
+        const raw = readFileSync(p, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return freshState();
+        }
+        const obj = parsed;
+        // Validate and coerce each field with a safe fallback.
+        const state = {
+            running: typeof obj['running'] === 'boolean' ? obj['running'] : false,
+            pid: typeof obj['pid'] === 'number'
+                ? obj['pid']
+                : obj['pid'] === null
+                    ? null
+                    : null,
+            startedAt: typeof obj['startedAt'] === 'string' ? obj['startedAt'] : null,
+            lastTickAt: typeof obj['lastTickAt'] === 'string' ? obj['lastTickAt'] : null,
+            todayDate: typeof obj['todayDate'] === 'string' ? obj['todayDate'] : null,
+            todaySpentUsd: typeof obj['todaySpentUsd'] === 'number' ? obj['todaySpentUsd'] : 0,
+            itemsProcessed: typeof obj['itemsProcessed'] === 'number' ? obj['itemsProcessed'] : 0,
+            ticks: Array.isArray(obj['ticks'])
+                ? obj['ticks'].filter((t) => typeof t === 'object' &&
+                    t !== null &&
+                    !Array.isArray(t) &&
+                    typeof t['ts'] === 'string')
+                : [],
+        };
+        // Self-heal at the load chokepoint: a daemon killed -9 leaves
+        // running:true/pid:<dead> behind; reconcile (read-only liveness) flips it to
+        // a truthful stopped state so status/start/tick never see a phantom-live
+        // daemon. Observability-only — touches NO spend accounting, NO guard.
+        return reconcileDaemonState(state);
+    }
+    catch {
+        // Corrupt JSON or any other read error — return zeroed state.
+        return freshState();
+    }
+}
+// ---------------------------------------------------------------------------
+// Save (atomic)
+// ---------------------------------------------------------------------------
+/**
+ * Atomically write DaemonState to daemonStatePath() via tmp-file + rename
+ * (POSIX-atomic). Creates ~/.ashlr if needed. Never throws.
+ */
+export function saveDaemonState(s) {
+    try {
+        const dir = ashlrDir();
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Bound ticks history before persisting.
+        const bounded = {
+            ...s,
+            ticks: s.ticks.slice(-MAX_TICKS),
+        };
+        const dest = daemonStatePath();
+        const tmp = dest + '.tmp';
+        writeFileSync(tmp, JSON.stringify(bounded, null, 2) + '\n', 'utf8');
+        renameSync(tmp, dest);
+    }
+    catch {
+        // Persistence failure must not crash the daemon — swallow silently.
+    }
+}
+// ---------------------------------------------------------------------------
+// Daily budget reset
+// ---------------------------------------------------------------------------
+/**
+ * If s.todayDate differs from today's YYYY-MM-DD, return a copy with
+ * todayDate set to today and todaySpentUsd reset to 0 (daily budget reset).
+ * itemsProcessed and ticks are preserved.
+ *
+ * Pure-ish: returns the (possibly new) state; caller is responsible for
+ * persisting via saveDaemonState().
+ */
+export function resetDayIfNeeded(s) {
+    const today = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    if (s.todayDate === today)
+        return s;
+    return {
+        ...s,
+        todayDate: today,
+        todaySpentUsd: 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Stale-daemon reconciliation (H5 — OBSERVABILITY-ONLY liveness check)
+// ---------------------------------------------------------------------------
+/**
+ * READ-ONLY liveness reconcile. If `s.running === true` but the recorded `pid`
+ * is NOT alive — `process.kill(pid, 0)` throws `ESRCH` (no such process) — flip
+ * `running` to false and `pid` to null so `daemon status` reports a dead daemon
+ * as stopped. Otherwise return `s` unchanged.
+ *
+ * HONEST BOUND (pid reuse): this reports a dead daemon as live ONLY in the rare
+ * case where the OS recycled the recorded pid for an unrelated live process
+ * (then `process.kill(pid,0)` succeeds and we leave the state unchanged) —
+ * inherent to pid-0 liveness. In every other case it is truthful. It is
+ * conservative-toward-alive (it NEVER force-flips a genuinely running daemon
+ * off), and since it changes no spend/guard the residual false-positive is an
+ * observability nicety only, never a safety issue.
+ *
+ * OBSERVABILITY-ONLY by construction: it touches NO spend accounting
+ * (`todaySpentUsd` / `itemsProcessed` / `ticks` are preserved byte-for-byte),
+ * NO guard (kill switch / enrollment / sandbox are unaffected), and adds NO
+ * capability. It only makes the persisted running/pid pair truthful.
+ *
+ * Liveness rules (conservative — NEVER destroy a real running daemon's state):
+ *  - `running !== true` or `pid` not a number => nothing to reconcile => unchanged.
+ *  - `process.kill(pid, 0)` succeeds => process alive => unchanged.
+ *  - throws `ESRCH` => process is GONE => flip to { running:false, pid:null }.
+ *  - throws `EPERM` (exists but not signalable by us) => process EXISTS => alive
+ *    => unchanged (do NOT flip).
+ *  - any other/unexpected error => treat as alive => unchanged.
+ *
+ * Pure-ish: returns the (possibly new) state; caller persists via
+ * saveDaemonState(). Never throws.
+ */
+export function reconcileDaemonState(s) {
+    if (s.running !== true || typeof s.pid !== 'number') {
+        return s;
+    }
+    try {
+        // Signal 0 performs error checking without actually sending a signal.
+        process.kill(s.pid, 0);
+        // No throw => the process exists and is signalable => treat as alive.
+        return s;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'ESRCH') {
+            // No such process — the daemon is dead. Flip to a truthful stopped state.
+            return { ...s, running: false, pid: null };
+        }
+        // EPERM (exists, not ours) or any other error => conservatively alive.
+        return s;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/core/daemon/state.js.map

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

package/dist/core/dashboard.d.ts

@@ -0,0 +1,40 @@
+/**
+ * core/dashboard.ts — M13 DashboardSnapshot aggregator.
+ *
+ * Builds a single bounded, read-only DashboardSnapshot by calling the
+ * existing data-source modules. Called on every TUI refresh tick (~2s) and
+ * by Raycast views; must be fast (<1s) and NEVER throw.
+ *
+ * MCP health strategy: discoverMcpServers() is synchronous and fast (file
+ * reads only). probeServer() is async and spawns child processes — far too
+ * slow to call on every tick. We use the discovered spec list as a
+ * "last-known configured" proxy: each server is reported ok:true, tools:0
+ * (configured but tool count unknown without probing). This keeps the
+ * snapshot bounded and sub-second while still surfacing which servers are
+ * configured.
+ *
+ * Genome strategy: we call loadGenome() directly (bounded, never-throws, no
+ * child process) and derive entry + distinct-project counts from it. We do
+ * NOT call genomeHealth() because it invokes probeEmbeddingsSync(), which
+ * runs execFileSync('curl', ...) with a ~2.5s timeout — a synchronous child
+ * spawn that would block the event loop (and thus keypress handling) on the
+ * ~2s refresh tick. loadGenome keeps the snapshot sub-second and non-blocking.
+ *
+ * All partial failures degrade to zeroed/empty fields — snapshot is always
+ * returned, never null.
+ */
+import type { AshlrConfig, DashboardSnapshot } from './types.js';
+/**
+ * Aggregate a DashboardSnapshot from all hub data sources.
+ *
+ * Calls: loadIndex, getToolsRegistry, buildRollup('7d'), listRuns,
+ * listSwarms, discoverMcpServers, loadGenome.
+ *
+ * Contract:
+ *  - Async (callers can await without blocking the event loop for I/O).
+ *  - NEVER throws — any failure degrades its field to zero/empty.
+ *  - Fast: all underlying calls are synchronous file reads + no child
+ *    process spawns (MCP probing is skipped; genome embedding probe is
+ *    skipped). Sub-1s on typical machines.
+ */
+export declare function buildSnapshot(cfg: AshlrConfig): Promise<DashboardSnapshot>;