@hover-dev/core 0.25.0 → 0.26.0

package/dist/cloud.d.ts

@@ -0,0 +1,56 @@
+import type { RunFailure } from './specs/runFailures.js';
+export declare const DEFAULT_CLOUD_URL = "https://cloud.gethover.dev";
+export interface CloudCredentials {
+    /** Personal access token minted at cloud Settings → Access tokens. */
+    token: string;
+    /** Cloud base URL; DEFAULT_CLOUD_URL unless self-configured. */
+    url: string;
+}
+/** One drifted spec queued by the cloud, as /api/v1/heal-requests returns it.
+ *  `hint` is RunFailure-shaped — feed it straight to the local heal flow. */
+export interface CloudHealRequest {
+    id: string;
+    status: 'open' | 'routed' | 'healed' | 'dismissed';
+    specFile: string;
+    hint: RunFailure;
+    createdAt: string;
+    project: {
+        id: string;
+        name: string;
+        repo: string;
+    };
+    run: {
+        id: string;
+        branch: string | null;
+        commitSha: string | null;
+        ciUrl: string | null;
+        createdAt: string;
+    };
+}
+export declare function credentialsPath(home?: string): string;
+/** Resolve credentials: env first, then ~/.hover/credentials.json. Null when
+ *  neither is present (the surfaces show their "connect" hint on null). */
+export declare function readCloudCredentials(env?: NodeJS.ProcessEnv, home?: string): CloudCredentials | null;
+/** Persist credentials for every local surface (0600 — token, not a secret to
+ *  sync; same trust model as ~/.aws/credentials). Returns the path written. */
+export declare function writeCloudCredentials(creds: {
+    token: string;
+    url?: string;
+}, home?: string): string;
+/** Raised on a non-2xx cloud response; `status` 401 → token revoked/expired. */
+export declare class CloudApiError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+/** The open heal queue (optionally one repo's slice, `owner/name`). */
+export declare function fetchHealRequests(creds: CloudCredentials, opts?: {
+    status?: 'open' | 'routed' | 'healed' | 'dismissed' | 'all';
+    repo?: string;
+}, fetchImpl?: typeof fetch): Promise<CloudHealRequest[]>;
+/** 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>;
+/** The heal slug for a queued request (`checkout.spec.ts` → `checkout`) — what
+ *  `/mcp__hover__heal <slug>` takes. */
+export declare function healSlug(specFile: string): string;
+//# sourceMappingURL=cloud.d.ts.map

package/dist/cloud.d.ts.map

@@ -0,0 +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"}

package/dist/cloud.js

@@ -0,0 +1,93 @@
+/**
+ * Hover Cloud client — the PULL side of the cloud ↔ editor loop.
+ *
+ * Cloud (cloud.gethover.dev) ingests CI runs and queues a heal request per
+ * drifted spec. Nothing in the cloud can reach into an editor: this module is
+ * how the local surfaces (the VS Code extension, the MCP server) pull that
+ * queue and feed it to the existing local heal flow. The fix stays local +
+ * human-reviewed; a request auto-closes only when CI sees the spec pass again.
+ *
+ * Credentials resolve in a fixed chain so one sign-in covers every surface:
+ *   1. HOVER_CLOUD_TOKEN (+ optional HOVER_CLOUD_URL) env vars — explicit, CI
+ *   2. ~/.hover/credentials.json — written by "Hover: Connect Hover Cloud" in
+ *      VS Code (or by hand); 0600, shared by the extension AND the MCP server
+ *      (VS Code SecretStorage is extension-private, so it can't be the store).
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const DEFAULT_CLOUD_URL = 'https://cloud.gethover.dev';
+export function credentialsPath(home = homedir()) {
+    return join(home, '.hover', 'credentials.json');
+}
+/** Resolve credentials: env first, then ~/.hover/credentials.json. Null when
+ *  neither is present (the surfaces show their "connect" hint on null). */
+export function readCloudCredentials(env = process.env, home) {
+    if (env.HOVER_CLOUD_TOKEN) {
+        return { token: env.HOVER_CLOUD_TOKEN, url: env.HOVER_CLOUD_URL || DEFAULT_CLOUD_URL };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(credentialsPath(home), 'utf8'));
+        if (!raw.token)
+            return null;
+        return { token: raw.token, url: raw.url || DEFAULT_CLOUD_URL };
+    }
+    catch {
+        return null;
+    }
+}
+/** Persist credentials for every local surface (0600 — token, not a secret to
+ *  sync; same trust model as ~/.aws/credentials). Returns the path written. */
+export function writeCloudCredentials(creds, home = homedir()) {
+    const p = credentialsPath(home);
+    mkdirSync(join(home, '.hover'), { recursive: true });
+    writeFileSync(p, `${JSON.stringify({ url: DEFAULT_CLOUD_URL, ...creds }, null, 2)}\n`, {
+        mode: 0o600,
+    });
+    return p;
+}
+/** Raised on a non-2xx cloud response; `status` 401 → token revoked/expired. */
+export class CloudApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+async function cloudJson(creds, path, init = {}, fetchImpl = fetch) {
+    const res = await fetchImpl(`${creds.url.replace(/\/$/, '')}${path}`, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            'Content-Type': 'application/json',
+            ...init.headers,
+        },
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        throw new CloudApiError(res.status, `${path} → ${res.status}: ${body.slice(0, 200)}`);
+    }
+    return (await res.json());
+}
+/** The open heal queue (optionally one repo's slice, `owner/name`). */
+export async function fetchHealRequests(creds, opts = {}, fetchImpl = fetch) {
+    const params = new URLSearchParams();
+    if (opts.status)
+        params.set('status', opts.status);
+    if (opts.repo)
+        params.set('repo', opts.repo);
+    const qs = params.size > 0 ? `?${params}` : '';
+    const data = await cloudJson(creds, `/api/v1/heal-requests${qs}`, {}, fetchImpl);
+    return data.healRequests;
+}
+/** 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 async function updateHealRequest(creds, id, status, fetchImpl = fetch) {
+    await cloudJson(creds, `/api/v1/heal-requests/${id}`, { method: 'PATCH', body: JSON.stringify({ status }) }, fetchImpl);
+}
+/** The heal slug for a queued request (`checkout.spec.ts` → `checkout`) — what
+ *  `/mcp__hover__heal <slug>` takes. */
+export function healSlug(specFile) {
+    const base = specFile.split('/').pop() ?? specFile;
+    return base.replace(/\.spec\.ts$/, '');
+}

package/package.json

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