@hover-dev/core 0.26.0 → 0.27.0

package/dist/cloud.d.ts

@@ -1,4 +1,5 @@
 import type { RunFailure } from './specs/runFailures.js';
+import type { DashboardData } from './dashboard.js';
 export declare const DEFAULT_CLOUD_URL = "https://cloud.gethover.dev";
 export interface CloudCredentials {
     /** Personal access token minted at cloud Settings → Access tokens. */
@@ -24,6 +25,9 @@ export interface CloudHealRequest {
         branch: string | null;
         commitSha: string | null;
         ciUrl: string | null;
+        /** Environment the spec drifted on — heal against THIS env's URL (matched
+         *  to `.hover/environments.json`), not localhost. Null on older runs. */
+        environment?: string | null;
         createdAt: string;
     };
 }
@@ -50,6 +54,11 @@ export declare function fetchHealRequests(creds: CloudCredentials, opts?: {
 /** Mark a request routed (a local heal picked it up) or dismissed / reopened.
  *  `healed` is not writable — only CI seeing the spec pass closes a request. */
 export declare function updateHealRequest(creds: CloudCredentials, id: string, status: 'routed' | 'dismissed' | 'open', fetchImpl?: typeof fetch): Promise<void>;
+/** One project's dashboard, computed cloud-side from ingested CI runs — the
+ *  same `DashboardData` shape the local gatherer builds from `.hover/runs`, so
+ *  a dashboard surface can swap data sources without a UI change. `repo` is the
+ *  GitHub `owner/name` the project was created with. */
+export declare function fetchDashboard(creds: CloudCredentials, repo: string, fetchImpl?: typeof fetch): Promise<DashboardData>;
 /** The heal slug for a queued request (`checkout.spec.ts` → `checkout`) — what
  *  `/mcp__hover__heal <slug>` takes. */
 export declare function healSlug(specFile: string): string;

package/dist/cloud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../src/cloud.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;6EAC6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEhE;AAED;2EAC2E;AAC3E,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,GAAG,IAAI,CAczB;AAED;+EAC+E;AAC/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACtC,IAAI,GAAE,MAAkB,GACvB,MAAM,CAOR;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,KAAK;IAE7B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAIlB;AAuBD,uEAAuE;AACvE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EACzF,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAY7B;AAED;gFACgF;AAChF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,EACvC,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;wCACwC;AACxC,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD"}
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../src/cloud.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;6EAC6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB;iFACyE;QACzE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEhE;AAED;2EAC2E;AAC3E,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,GAAG,IAAI,CAczB;AAED;+EAC+E;AAC/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACtC,IAAI,GAAE,MAAkB,GACvB,MAAM,CAOR;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,KAAK;IAE7B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAIlB;AAuBD,uEAAuE;AACvE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EACzF,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAY7B;AAED;gFACgF;AAChF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,EACvC,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;wDAGwD;AACxD,wBAAsB,cAAc,CAClC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,aAAa,CAAC,CASxB;AAED;wCACwC;AACxC,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/dist/cloud.js

@@ -85,6 +85,15 @@ export async function fetchHealRequests(creds, opts = {}, fetchImpl = fetch) {
 export async function updateHealRequest(creds, id, status, fetchImpl = fetch) {
     await cloudJson(creds, `/api/v1/heal-requests/${id}`, { method: 'PATCH', body: JSON.stringify({ status }) }, fetchImpl);
 }
+/** One project's dashboard, computed cloud-side from ingested CI runs — the
+ *  same `DashboardData` shape the local gatherer builds from `.hover/runs`, so
+ *  a dashboard surface can swap data sources without a UI change. `repo` is the
+ *  GitHub `owner/name` the project was created with. */
+export async function fetchDashboard(creds, repo, fetchImpl = fetch) {
+    const qs = `?${new URLSearchParams({ repo })}`;
+    const data = await cloudJson(creds, `/api/v1/dashboard${qs}`, {}, fetchImpl);
+    return data.dashboard;
+}
 /** The heal slug for a queued request (`checkout.spec.ts` → `checkout`) — what
  *  `/mcp__hover__heal <slug>` takes. */
 export function healSlug(specFile) {

package/dist/dashboard.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Dashboard data contract (v1) + the pure helpers that compute it.
+ *
+ * ONE shape feeds every dashboard surface: the VS Code webview panel builds it
+ * from local `.hover/runs/*.json` (see vscode-ext/src/dashboardView.ts) and
+ * Hover Cloud's `GET /api/v1/dashboard` emits the same shape from ingested CI
+ * runs — so the panel can swap data sources without a UI change. The cloud
+ * route (Hover-cloud repo, apps/dashboard/app/api/v1/dashboard/route.ts)
+ * mirrors this contract; change it here first, then there.
+ *
+ * Everything in this module is pure (no vscode, no fs) so the extension, the
+ * MCP server, and tests can all use it.
+ */
+export type Status = 'pass' | 'fail' | 'flaky';
+/** How many recent runs a dashboard shows (the run-history strip width). */
+export declare const MAX_RUNS = 14;
+export interface SpecRow {
+    /** Spec basename, e.g. `checkout.spec.ts` — the row identity. */
+    name: string;
+    /** Absolute local fsPath for open/run actions. Local source only; cloud → null. */
+    path: string | null;
+    /** Repo-relative spec file path. Cloud source only; local → omitted. */
+    specFile?: string;
+    /** Folder group under `__vibe_tests__/` ('' = top level). */
+    group: string;
+    security: boolean;
+    /** One cell per entry in `runs` (null = spec not part of that run). */
+    cells: (Status | null)[];
+    /** Inconsistent across the window — a candidate for 🏥 Heal. */
+    flaky: boolean;
+}
+export interface DashboardRun {
+    id: string;
+    /** ISO-ish timestamp label (local: the run filename stamp; cloud: createdAt). */
+    ts: string;
+    /** Deep link back to the user's CI. Cloud source only. */
+    ciUrl?: string | null;
+    branch?: string | null;
+    /** Which environment the run targeted (`local` / `staging` / `prod` / `ci`) —
+     *  the Environments-view id the reporter tagged the run with. Cloud source only. */
+    environment?: string | null;
+}
+export interface DashboardData {
+    hasRuns: boolean;
+    tiles: {
+        specs: number;
+        /** Pass rate (%) of the latest run; null when there are no runs. */
+        passRate: number | null;
+        flaky: number;
+        /** 7-day agent token spend. Local source only; cloud → null. */
+        tokens7d: number | null;
+    };
+    runs: DashboardRun[];
+    rows: SpecRow[];
+}
+/** One run as a computable unit: its column header + per-spec statuses. The
+ *  local gatherer parses these from `.hover/runs/*.json`; `dashboardRunSlices`
+ *  recovers them from a cloud `DashboardData`. */
+export interface RunSlice extends DashboardRun {
+    specs: Record<string, Status>;
+}
+/** Where a spec row's file lives — local absolute path and/or repo-relative. */
+export interface SpecFileRef {
+    path: string | null;
+    specFile?: string;
+}
+/** Worst-wins ranking when a single run file reports several specs in one file. */
+export declare function worse(a: Status | undefined, b: Status): Status;
+/** Flaky = a spec that both passed and failed across the window (or a run marked
+ *  it flaky on retry). Shared by the per-row flag and the aggregate tile. */
+export declare function cellsFlaky(cells: (Status | null)[]): boolean;
+/** Security specs get a shield in every surface — one naming rule. */
+export declare function isSecuritySpec(name: string): boolean;
+/** Folder segments between the nearest `__vibe_tests__` and the file (excl. the
+ *  filename), joined by '/'. `__vibe_tests__/auth/login.spec.ts` → 'auth'.
+ *  Works on both absolute fsPaths and repo-relative paths. */
+export declare function specGroup(path: string): string;
+/** Recover per-run slices from a `DashboardData` (rows/cells → specs maps) —
+ *  how a cloud dashboard becomes mergeable with locally-gathered runs. */
+export declare function dashboardRunSlices(data: DashboardData): RunSlice[];
+/** The GitHub Actions run id inside a CI deep link, or null. Matches the
+ *  `ci-<id>.json` ledger naming the extension's CI sync uses — the dedup key
+ *  between a locally-synced CI run and the same run ingested by the cloud. */
+export declare function actionsRunId(ciUrl: string | null | undefined): string | null;
+/** Merge locally-gathered runs with cloud-ingested ones into one chronological
+ *  timeline, newest-last, capped at MAX_RUNS. A CI run present on both sides
+ *  (a `ci-<id>` local ledger vs the cloud run's `ciUrl`) keeps the CLOUD copy —
+ *  it carries the real timestamp + deep link. Unparseable timestamps sort
+ *  oldest, preserving their relative order (Array.sort is stable). */
+export declare function mergeRunSlices(local: RunSlice[], cloud: RunSlice[]): RunSlice[];
+/** Assemble the final `DashboardData` from run slices (chronological) + the
+ *  known spec files. `files` seeds the rows (a catalogue spec with no runs yet
+ *  still shows) and supplies open/run paths; specs seen only in run history get
+ *  a path-less row. `specCount` overrides the specs tile when the caller has a
+ *  better catalogue count than `files.size`. */
+export declare function buildDashboard(runs: RunSlice[], files: Map<string, SpecFileRef>, tokens7d: number | null, specCount?: number): DashboardData;
+/** Parse a Playwright json report into { specBasename → status }. Defensive:
+ *  an unexpected shape just yields no entries. */
+export declare function parsePlaywrightRun(json: unknown): Record<string, Status>;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/dashboard.d.ts.map

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

package/dist/dashboard.js

@@ -0,0 +1,133 @@
+/**
+ * Dashboard data contract (v1) + the pure helpers that compute it.
+ *
+ * ONE shape feeds every dashboard surface: the VS Code webview panel builds it
+ * from local `.hover/runs/*.json` (see vscode-ext/src/dashboardView.ts) and
+ * Hover Cloud's `GET /api/v1/dashboard` emits the same shape from ingested CI
+ * runs — so the panel can swap data sources without a UI change. The cloud
+ * route (Hover-cloud repo, apps/dashboard/app/api/v1/dashboard/route.ts)
+ * mirrors this contract; change it here first, then there.
+ *
+ * Everything in this module is pure (no vscode, no fs) so the extension, the
+ * MCP server, and tests can all use it.
+ */
+/** How many recent runs a dashboard shows (the run-history strip width). */
+export const MAX_RUNS = 14;
+/** Worst-wins ranking when a single run file reports several specs in one file. */
+export function worse(a, b) {
+    const rank = { pass: 0, flaky: 1, fail: 2 };
+    if (!a)
+        return b;
+    return rank[b] > rank[a] ? b : a;
+}
+/** Flaky = a spec that both passed and failed across the window (or a run marked
+ *  it flaky on retry). Shared by the per-row flag and the aggregate tile. */
+export function cellsFlaky(cells) {
+    const seen = new Set(cells.filter(Boolean));
+    return seen.has('flaky') || (seen.has('pass') && seen.has('fail'));
+}
+/** Security specs get a shield in every surface — one naming rule. */
+export function isSecuritySpec(name) {
+    return name.endsWith('.api-test.spec.ts');
+}
+/** Folder segments between the nearest `__vibe_tests__` and the file (excl. the
+ *  filename), joined by '/'. `__vibe_tests__/auth/login.spec.ts` → 'auth'.
+ *  Works on both absolute fsPaths and repo-relative paths. */
+export function specGroup(path) {
+    const parts = path.split(/[\\/]/);
+    const idx = parts.lastIndexOf('__vibe_tests__');
+    return idx >= 0 ? parts.slice(idx + 1, -1).join('/') : '';
+}
+/** Recover per-run slices from a `DashboardData` (rows/cells → specs maps) —
+ *  how a cloud dashboard becomes mergeable with locally-gathered runs. */
+export function dashboardRunSlices(data) {
+    return data.runs.map((run, i) => {
+        const specs = {};
+        for (const row of data.rows) {
+            const cell = row.cells[i];
+            if (cell)
+                specs[row.name] = cell;
+        }
+        return { ...run, specs };
+    });
+}
+/** The GitHub Actions run id inside a CI deep link, or null. Matches the
+ *  `ci-<id>.json` ledger naming the extension's CI sync uses — the dedup key
+ *  between a locally-synced CI run and the same run ingested by the cloud. */
+export function actionsRunId(ciUrl) {
+    return ciUrl?.match(/\/actions\/runs\/(\d+)/)?.[1] ?? null;
+}
+/** Merge locally-gathered runs with cloud-ingested ones into one chronological
+ *  timeline, newest-last, capped at MAX_RUNS. A CI run present on both sides
+ *  (a `ci-<id>` local ledger vs the cloud run's `ciUrl`) keeps the CLOUD copy —
+ *  it carries the real timestamp + deep link. Unparseable timestamps sort
+ *  oldest, preserving their relative order (Array.sort is stable). */
+export function mergeRunSlices(local, cloud) {
+    const cloudCiIds = new Set(cloud.map((r) => actionsRunId(r.ciUrl)).filter(Boolean));
+    const keptLocal = local.filter((r) => !cloudCiIds.has(r.id.replace(/^ci-/, '')));
+    const key = (r) => {
+        const t = Date.parse(r.ts);
+        return Number.isNaN(t) ? 0 : t;
+    };
+    return [...keptLocal, ...cloud].sort((a, b) => key(a) - key(b)).slice(-MAX_RUNS);
+}
+/** Assemble the final `DashboardData` from run slices (chronological) + the
+ *  known spec files. `files` seeds the rows (a catalogue spec with no runs yet
+ *  still shows) and supplies open/run paths; specs seen only in run history get
+ *  a path-less row. `specCount` overrides the specs tile when the caller has a
+ *  better catalogue count than `files.size`. */
+export function buildDashboard(runs, files, tokens7d, specCount = files.size) {
+    const names = new Set(files.keys());
+    for (const r of runs)
+        for (const k of Object.keys(r.specs))
+            names.add(k);
+    const rows = [...names]
+        .sort((a, b) => a.localeCompare(b))
+        .map((name) => {
+        const ref = files.get(name);
+        const cells = runs.map((r) => r.specs[name] ?? null);
+        return {
+            name,
+            path: ref?.path ?? null,
+            ...(ref?.specFile ? { specFile: ref.specFile } : {}),
+            group: specGroup(ref?.path ?? ref?.specFile ?? ''),
+            security: isSecuritySpec(name),
+            cells,
+            flaky: cellsFlaky(cells),
+        };
+    });
+    let passRate = null;
+    const last = runs[runs.length - 1];
+    if (last) {
+        const vals = Object.values(last.specs);
+        if (vals.length)
+            passRate = Math.round((vals.filter((s) => s === 'pass').length / vals.length) * 100);
+    }
+    return {
+        hasRuns: runs.length > 0,
+        tiles: { specs: specCount, passRate, flaky: rows.filter((r) => r.flaky).length, tokens7d },
+        runs: runs.map(({ specs: _specs, ...run }) => run),
+        rows,
+    };
+}
+/** Parse a Playwright json report into { specBasename → status }. Defensive:
+ *  an unexpected shape just yields no entries. */
+export function parsePlaywrightRun(json) {
+    const out = {};
+    const visit = (suite, inherited) => {
+        const file = suite.file ?? inherited;
+        for (const raw of suite.specs ?? []) {
+            const spec = raw;
+            const key = (file ?? spec.file ?? 'unknown').split(/[\\/]/).pop() ?? 'unknown';
+            let status = spec.ok ? 'pass' : 'fail';
+            if (spec.ok && (spec.tests ?? []).some((t) => t.status === 'flaky'))
+                status = 'flaky';
+            out[key] = worse(out[key], status);
+        }
+        for (const child of suite.suites ?? [])
+            visit(child, file);
+    };
+    for (const s of json?.suites ?? [])
+        visit(s);
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hover-dev/core",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Hover's local Node service: agent invocation, Playwright CDP preflight, WebSocket bridge.",
   "license": "Apache-2.0",
   "author": "Hyperyond",
@@ -38,6 +38,10 @@
     "./cloud": {
       "types": "./dist/cloud.d.ts",
       "import": "./dist/cloud.js"
+    },
+    "./dashboard": {
+      "types": "./dist/dashboard.d.ts",
+      "import": "./dist/dashboard.js"
     }
   },
   "files": [