@ashlr/hub 2.2.0

package/dist/core/observability/rollup.js

@@ -0,0 +1,311 @@
+/**
+ * rollup.ts — build ActivityRollup from local usage events + git commit counts.
+ *
+ * Privacy: delegates to collectUsageEvents which reads METADATA ONLY.
+ * Performance: skips files outside the window (mtime filtering in usage-source),
+ *   git log --since is bounded per-repo, never throws globally.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { basename } from 'node:path';
+import { collectUsageEvents, dashNormalize } from './usage-source.js';
+import { evalBudget } from './budget-alert.js';
+import { estCostUsd } from '../run/budget.js';
+import { loadIndex } from '../index-engine.js';
+// ---------------------------------------------------------------------------
+// windowToMs
+// ---------------------------------------------------------------------------
+/**
+ * Convert a window label to milliseconds.
+ * Unknown labels fall back to 7d.
+ */
+export function windowToMs(window) {
+    switch (window) {
+        case '1d': return 86_400_000;
+        case '7d': return 7 * 86_400_000;
+        case '30d': return 30 * 86_400_000;
+        default: return 7 * 86_400_000;
+    }
+}
+// ---------------------------------------------------------------------------
+// Git commit counting (best-effort, never throws)
+// ---------------------------------------------------------------------------
+const GIT_TIMEOUT = 5_000;
+/**
+ * Count commits in `repoPath` with author date >= sinceMs.
+ * Returns 0 on any error (git unavailable, not a repo, timeout, etc.).
+ */
+function countCommitsSince(repoPath, sinceMs) {
+    try {
+        if (!existsSync(repoPath))
+            return 0;
+        const since = new Date(sinceMs).toISOString();
+        const out = execFileSync('git', ['log', '--oneline', `--after=${since}`], { cwd: repoPath, timeout: GIT_TIMEOUT, stdio: 'pipe', encoding: 'utf8' });
+        return out.trim() === '' ? 0 : out.trim().split('\n').length;
+    }
+    catch {
+        return 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Cost estimation — map model id to a provider key for estCostUsd()
+// ---------------------------------------------------------------------------
+/**
+ * Derive a provider key from a model id so estCostUsd() can match it.
+ *
+ * Examples:
+ *   'claude-3-5-sonnet-20241022' -> 'claude'
+ *   'gpt-4o'                     -> 'gpt'
+ *   'gemini-1.5-pro'             -> 'gemini'
+ *   'ollama/llama3'              -> 'ollama'
+ *   unknown                      -> model id as-is (budget fallback applies)
+ */
+export function modelToProviderKey(model) {
+    const m = model.toLowerCase();
+    if (m.startsWith('claude'))
+        return 'claude';
+    if (m.startsWith('gpt'))
+        return 'gpt';
+    if (m.startsWith('gemini'))
+        return 'gemini';
+    if (m.startsWith('mistral'))
+        return 'mistral';
+    if (m.startsWith('cohere'))
+        return 'cohere';
+    if (m.includes('ollama'))
+        return 'ollama';
+    if (m.includes('lmstudio'))
+        return 'lmstudio';
+    // Pass through: estCostUsd will fallback to conservative $3/$15
+    return model;
+}
+/**
+ * Local (zero-cost) provider keys. A model whose `modelToProviderKey` lands in
+ * this set is served by a LOCAL backend and costs $0. Shared with forecast.ts so
+ * the local/cloud split stays consistent across rollup and savings computation.
+ */
+export const LOCAL_PROVIDER_KEYS = new Set(['ollama', 'lmstudio']);
+/** True when `model` is served by a local provider (cost $0). */
+export function isLocalProviderModel(model) {
+    return LOCAL_PROVIDER_KEYS.has(modelToProviderKey(model));
+}
+// ---------------------------------------------------------------------------
+// buildRollup
+// ---------------------------------------------------------------------------
+export function buildRollup(window, cfg, opts) {
+    const now = Date.now();
+    const sinceMs = now - windowToMs(window);
+    const sinceIso = new Date(sinceMs).toISOString();
+    // ── Collect usage events ─────────────────────────────────────────────────
+    let events = [];
+    try {
+        events = collectUsageEvents(sinceMs);
+    }
+    catch {
+        // partial data ok
+    }
+    // ── Load the index ONCE ───────────────────────────────────────────────────
+    // Reused for (a) reconciling mangled transcript paths to real repo paths and
+    // (b) git commit counting — avoids the previous double loadIndex().
+    let index = null;
+    try {
+        index = loadIndex();
+    }
+    catch {
+        // missing index is fine — degrade to best-effort decode + no commits
+    }
+    // Build a lookup from the dash-normalized form of each indexed repo path to
+    // its REAL path. Transcript events carry a LOSSY decode (every '-' became
+    // '/'), but dashNormalize collapses both the real and the lossy form to the
+    // same key, so we can recover the correct real path for dashed repo names.
+    const realByNorm = new Map();
+    if (index) {
+        for (const item of index.items) {
+            if (item.kind !== 'repo')
+                continue;
+            realByNorm.set(dashNormalize(item.path), item.path);
+        }
+    }
+    // Reconcile each event's (possibly mangled) project path to the real index
+    // path so token activity joins the git-commit activity on the SAME key and
+    // by-project labels/--project matching work for dashed repos. Falls back to
+    // the original decode when there is no index match.
+    if (realByNorm.size > 0) {
+        for (const ev of events) {
+            if (!ev.project)
+                continue;
+            const real = realByNorm.get(dashNormalize(ev.project));
+            if (real)
+                ev.project = real;
+        }
+    }
+    // ── Optional project filter ──────────────────────────────────────────────
+    const projectFilter = opts?.project?.trim();
+    if (projectFilter) {
+        events = events.filter((e) => {
+            if (!e.project)
+                return false;
+            return (e.project === projectFilter ||
+                basename(e.project) === projectFilter ||
+                e.project.includes(projectFilter));
+        });
+    }
+    // ── Aggregation maps ─────────────────────────────────────────────────────
+    // project key -> ProjectActivity accumulator
+    const projectMap = new Map();
+    // YYYY-MM-DD -> DailyUsage accumulator
+    const dayMap = new Map();
+    // model id -> ModelUsage accumulator
+    const modelMap = new Map();
+    // Grand totals
+    let totalTokensIn = 0;
+    let totalTokensOut = 0;
+    let totalCost = 0;
+    // Track distinct session files globally for totals.sessions
+    const allSessions = new Set();
+    for (const ev of events) {
+        const cost = estCostUsd(modelToProviderKey(ev.model), ev.tokensIn, ev.tokensOut);
+        // Grand totals
+        totalTokensIn += ev.tokensIn;
+        totalTokensOut += ev.tokensOut;
+        totalCost += cost;
+        // Session key: for 'claude' events the session file is implicit per-event
+        // grouping; we use (project + day) as a session proxy when we don't have
+        // the actual filename, but usage-source may embed it in model/ts combos.
+        // For simplicity, use a session key = project + ISO-day to count sessions.
+        const day = ev.ts.slice(0, 10); // YYYY-MM-DD
+        const sessionKey = `${ev.project ?? '__none__'}::${day}`;
+        allSessions.add(sessionKey);
+        // ── Per-project ────────────────────────────────────────────────────────
+        const proj = ev.project ?? '__unknown__';
+        if (!projectMap.has(proj)) {
+            projectMap.set(proj, { sessions: new Set(), tokensIn: 0, tokensOut: 0, estCostUsd: 0, lastActive: null });
+        }
+        const pa = projectMap.get(proj);
+        pa.sessions.add(sessionKey);
+        pa.tokensIn += ev.tokensIn;
+        pa.tokensOut += ev.tokensOut;
+        pa.estCostUsd += cost;
+        if (pa.lastActive === null || ev.ts > pa.lastActive) {
+            pa.lastActive = ev.ts;
+        }
+        // ── Per-day ────────────────────────────────────────────────────────────
+        if (!dayMap.has(day)) {
+            dayMap.set(day, { tokensIn: 0, tokensOut: 0, estCostUsd: 0, sessions: new Set() });
+        }
+        const du = dayMap.get(day);
+        du.tokensIn += ev.tokensIn;
+        du.tokensOut += ev.tokensOut;
+        du.estCostUsd += cost;
+        du.sessions.add(sessionKey);
+        // ── Per-model ──────────────────────────────────────────────────────────
+        const modelKey = ev.model || 'unknown';
+        if (!modelMap.has(modelKey)) {
+            modelMap.set(modelKey, { tokensIn: 0, tokensOut: 0, estCostUsd: 0, calls: 0 });
+        }
+        const mu = modelMap.get(modelKey);
+        mu.tokensIn += ev.tokensIn;
+        mu.tokensOut += ev.tokensOut;
+        mu.estCostUsd += cost;
+        mu.calls++;
+    }
+    // ── Git commit counts (single pass) ──────────────────────────────────────
+    // For each indexed repo matching the (optional) project filter, count commits
+    // within the window EXACTLY ONCE. Derive totalCommits by summing the map, and
+    // seed commit-only project buckets in the same pass. Reuses the index loaded
+    // above — no second loadIndex(), no second countCommitsSince() per repo.
+    const commitsByProject = new Map();
+    let totalCommits = 0;
+    if (index) {
+        for (const item of index.items) {
+            if (item.kind !== 'repo')
+                continue;
+            // Apply project filter to repos
+            if (projectFilter) {
+                const matches = item.path === projectFilter ||
+                    item.name === projectFilter ||
+                    item.path.includes(projectFilter);
+                if (!matches)
+                    continue;
+            }
+            const repoCommits = countCommitsSince(item.path, sinceMs);
+            if (repoCommits <= 0)
+                continue;
+            commitsByProject.set(item.path, repoCommits);
+            totalCommits += repoCommits;
+            // Seed a minimal project entry for commit-only repos (no token events),
+            // carrying lastActive from the repo's last commit. Token-active repos
+            // already have an entry keyed on the reconciled real path.
+            if (!projectMap.has(item.path)) {
+                projectMap.set(item.path, {
+                    sessions: new Set(),
+                    tokensIn: 0,
+                    tokensOut: 0,
+                    estCostUsd: 0,
+                    lastActive: item.git?.lastCommit ?? null,
+                });
+            }
+        }
+    }
+    // ── Freeze byProject ─────────────────────────────────────────────────────
+    const byProject = [];
+    for (const [proj, pa] of projectMap.entries()) {
+        byProject.push({
+            project: proj,
+            sessions: pa.sessions.size,
+            commits: commitsByProject.get(proj) ?? 0,
+            tokensIn: pa.tokensIn,
+            tokensOut: pa.tokensOut,
+            estCostUsd: pa.estCostUsd,
+            lastActive: pa.lastActive,
+        });
+    }
+    // Sort by cost desc, then tokens desc
+    byProject.sort((a, b) => b.estCostUsd !== a.estCostUsd
+        ? b.estCostUsd - a.estCostUsd
+        : (b.tokensIn + b.tokensOut) - (a.tokensIn + a.tokensOut));
+    // ── Freeze byDay (ascending) ──────────────────────────────────────────────
+    const byDay = [];
+    for (const [day, du] of dayMap.entries()) {
+        byDay.push({
+            day,
+            tokensIn: du.tokensIn,
+            tokensOut: du.tokensOut,
+            estCostUsd: du.estCostUsd,
+            sessions: du.sessions.size,
+        });
+    }
+    byDay.sort((a, b) => a.day.localeCompare(b.day));
+    // ── Freeze byModel (desc by cost) ────────────────────────────────────────
+    const byModel = [];
+    for (const [model, mu] of modelMap.entries()) {
+        byModel.push({
+            model,
+            tokensIn: mu.tokensIn,
+            tokensOut: mu.tokensOut,
+            estCostUsd: mu.estCostUsd,
+            calls: mu.calls,
+        });
+    }
+    byModel.sort((a, b) => b.estCostUsd !== a.estCostUsd
+        ? b.estCostUsd - a.estCostUsd
+        : (b.tokensIn + b.tokensOut) - (a.tokensIn + a.tokensOut));
+    // ── Budget alert ──────────────────────────────────────────────────────────
+    const budget = evalBudget({ spentUsd: totalCost, spentTokens: totalTokensIn + totalTokensOut }, cfg, window);
+    return {
+        window,
+        since: sinceIso,
+        totals: {
+            tokensIn: totalTokensIn,
+            tokensOut: totalTokensOut,
+            estCostUsd: totalCost,
+            sessions: allSessions.size,
+            commits: totalCommits,
+        },
+        byProject,
+        byDay,
+        byModel,
+        budget,
+    };
+}
+//# sourceMappingURL=rollup.js.map

package/dist/core/observability/rollup.js.map

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

package/dist/core/observability/telemetry-sink.d.ts

@@ -0,0 +1,63 @@
+/**
+ * core/observability/telemetry-sink.ts — M19 telemetry sink seam.
+ *
+ * Two implementations:
+ *   LocalFileSink  — default (no endpoint / no PAT). Appends spans as JSONL
+ *                    to a daily file under ~/.ashlr/telemetry/. What `ashlr
+ *                    pulse` already aggregates locally.
+ *   OtlpHttpSink   — opt-in, only when cfg.telemetry.pulse AND a PAT are
+ *                    both present. Builds an OTLP/HTTP-JSON trace and POSTs
+ *                    it to the configured endpoint. Fire-and-forget, bounded
+ *                    timeout, never throws/blocks.
+ *
+ * GUARDRAILS:
+ *   - PRIVACY: JSONL records and span attributes are METADATA ONLY (model,
+ *     token counts, cost, ids, provider, tier, status, duration). NEVER
+ *     prompt/response text, tool args, file contents, or secrets.
+ *   - PAT/SECRET SAFETY: PAT lives ONLY in the Authorization header. It is
+ *     NEVER logged, printed, returned, placed in span attrs or `detail`, or
+ *     committed. Source: phantom (preferred) or ASHLR_PULSE_TOKEN env var.
+ *   - All emits are best-effort: ok:false is logged to stderr only and NEVER
+ *     blocks or propagates out of a run/swarm.
+ */
+import type { AshlrConfig, GenAiSpan, TelemetryEmitResult } from '../types.js';
+/**
+ * Returns the absolute path to the local telemetry directory:
+ * ~/.ashlr/telemetry
+ *
+ * Re-resolves homedir() at call time so a relocated HOME in tests is honored.
+ */
+export declare function localTelemetryDir(): string;
+/**
+ * Returns true when a Pulse PAT is discoverable — either via the
+ * ASHLR_PULSE_TOKEN environment variable or via phantom (when installed,
+ * initialized, and the key is present in the vault).
+ *
+ * NEVER reads, returns, or logs the PAT value — boolean only.
+ *
+ * `allowPhantomProbe` (default true) controls the blocking spawnSync phantom
+ * probe. The doctor / `ashlr telemetry status` callers want the full probe
+ * (they are NOT on a run's completion path). The emit hot path
+ * (getSink -> patAvailable) MUST pass `false`: the spawnSync probe freezes the
+ * event loop for up to ~10s (2x5s) and is redundant there — OtlpHttpSink.emit
+ * resolves the PAT itself via the async, bounded resolvePatAsync. With the
+ * probe off, patAvailable is a pure env-var check (no blocking).
+ */
+export declare function patAvailable(cfg: AshlrConfig, allowPhantomProbe?: boolean): boolean;
+export interface TelemetrySink {
+    emit(spans: GenAiSpan[]): Promise<TelemetryEmitResult>;
+}
+/**
+ * Returns the appropriate TelemetrySink for the given config:
+ *   - OtlpHttpSink when cfg.telemetry.pulse is set AND a PAT is available.
+ *   - LocalFileSink (default, 100% local) otherwise.
+ *
+ * `allowPhantomProbe` (default true) is forwarded to patAvailable. On the
+ * emit hot path (orchestrator/swarm completion) callers MUST pass `false` so
+ * the selection never runs a blocking spawnSync phantom probe: when an
+ * endpoint is configured we hand off to OtlpHttpSink, which resolves the PAT
+ * asynchronously with a bounded timeout (and degrades to a logged
+ * 'PAT unavailable' no-op if none is found) — never freezing the event loop.
+ * The CLI (`telemetry test`/`status`) keeps the default probe.
+ */
+export declare function getSink(cfg: AshlrConfig, allowPhantomProbe?: boolean): TelemetrySink;