@hover-dev/core 0.24.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/dist/engine.d.ts

@@ -18,7 +18,7 @@ export type { SkillStep } from './specs/specStep.js';
 export { reRenderSpec } from './specs/writeSpec.js';
 export { writeApiSpec } from './specs/writeApiSpec.js';
 export type { ApiCheck, WriteApiSpecOptions, WriteApiSpecResult } from './specs/writeApiSpec.js';
-export { buildOptimizeBrief, saveOptimizedCandidate, OptimizeError } from './specs/optimizeSpec.js';
+export { buildOptimizeBrief, saveOptimizedCandidate, promoteOptimizedCandidate, OptimizeError } from './specs/optimizeSpec.js';
 export type { OptimizeResult } from './specs/optimizeSpec.js';
 export { appendWikiLog, readWikiLog, wikiLogPath } from './specs/wikiLog.js';
 export type { WikiLogKind, WikiLogEntry } from './specs/wikiLog.js';

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGjG,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpG,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEzG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKhF,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5J,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzG,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzF,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGjG,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/H,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEzG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKhF,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5J,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzG,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/engine.js

@@ -19,7 +19,7 @@ export { reRenderSpec } from './specs/writeSpec.js';
 export { writeApiSpec } from './specs/writeApiSpec.js';
 // Optimize (F7) — build the improvement brief for the user's own agent, then
 // file its result as a reviewed candidate. No Hover-owned model runs.
-export { buildOptimizeBrief, saveOptimizedCandidate, OptimizeError } from './specs/optimizeSpec.js';
+export { buildOptimizeBrief, saveOptimizedCandidate, promoteOptimizedCandidate, OptimizeError } from './specs/optimizeSpec.js';
 // LLM-Wiki P3 log — append-only, machine-parseable run history at .hover/log.md.
 export { appendWikiLog, readWikiLog, wikiLogPath } from './specs/wikiLog.js';
 // LLM-Wiki P1 Lint — deterministic health check over .hover/ (map vs specs vs runs).

package/dist/specs/optimizeSpec.d.ts

@@ -54,6 +54,16 @@ export declare function saveOptimizedCandidate(devRoot: string, slug: string, ll
     candidatePath: string;
     code: string;
 }>;
+/**
+ * Promote a reviewed optimization candidate: overwrite the real spec with the
+ * `.hover/cache/optimized/<slug>.spec.ts.draft` and remove the draft. This is the
+ * one place a candidate replaces the original — done ONLY on the user's say-so
+ * (they reviewed the diff), never automatically as part of optimize. Re-validates
+ * the draft (in case it was hand-edited) before applying. Throws if no draft.
+ */
+export declare function promoteOptimizedCandidate(devRoot: string, slug: string): Promise<{
+    path: string;
+}>;
 /**
  * Build the codegen prompt: the current spec + the observed session, plus the
  * same rules the deterministic path enforces (semantic selectors, no XPath, no

package/dist/specs/optimizeSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optimizeSpec.d.ts","sourceRoot":"","sources":["../../src/specs/optimizeSpec.ts"],"names":[],"mappings":"AAeA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAgC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGzE,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7D;;;4DAG4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAOD;0DAC0D;AAC1D,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB/E;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb;2EACuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8B/C;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBlD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,KAAK,GAAE,QAAQ,EAAO,EACtB,KAAK,GAAE,YAA4B,EACnC,iBAAiB,SAA+F,GAC/G,MAAM,CAiFR;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAWhF"}
+{"version":3,"file":"optimizeSpec.d.ts","sourceRoot":"","sources":["../../src/specs/optimizeSpec.ts"],"names":[],"mappings":"AAeA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAgC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGzE,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7D;;;4DAG4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAOD;0DAC0D;AAC1D,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB/E;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb;2EACuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B/C;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBlD;AA6BD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBxG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,KAAK,GAAE,QAAQ,EAAO,EACtB,KAAK,GAAE,YAA4B,EACnC,iBAAiB,SAA+F,GAC/G,MAAM,CAiFR;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAWhF"}

package/dist/specs/optimizeSpec.js

@@ -10,7 +10,7 @@
  * The LLM call is injected (`runCodegen`) so callers wire their own agent and
  * tests run deterministically without spawning anything.
  */
-import { readFile, mkdir, writeFile, readdir } from 'node:fs/promises';
+import { readFile, mkdir, writeFile, readdir, rm } from 'node:fs/promises';
 import { join } from 'node:path';
 import { Project } from 'ts-morph';
 import { readSidecar } from './sidecar.js';
@@ -85,8 +85,9 @@ export async function buildOptimizeBrief(devRoot, slug) {
         `.ts file as \`code\`. Hover validates it (semantic selectors, no waitForTimeout/XPath), ` +
         `soft-batches trailing assertions, and files it as a REVIEW CANDIDATE at ` +
         `.hover/cache/optimized/${slug}.spec.ts.draft — it does NOT touch your spec. If it comes ` +
-        `back with a ✗ (a rejected check), fix that and call it again. Then tell the user the ` +
-        `candidate path so they can diff it against __vibe_tests__/${slug}.spec.ts and promote it.`;
+        `back with a ✗ (a rejected check), fix that and call it again. Then show the user the ` +
+        `diff vs __vibe_tests__/${slug}.spec.ts; if they approve, call \`promote_optimized_spec("${slug}")\` ` +
+        `to apply it (it overwrites the spec + removes the draft — no manual mv). They can also promote in the VS Code cockpit.`;
     return { prompt: buildOptimizePrompt(draft, sidecar, seeds, suite, outputInstruction), original: draft };
 }
 /**
@@ -115,6 +116,61 @@ export async function saveOptimizedCandidate(devRoot, slug, llmCode) {
     await writeFile(candidatePath, code.endsWith('\n') ? code : `${code}\n`, 'utf-8');
     return { candidatePath, code };
 }
+/** Find the on-disk spec whose basename is `<slug>.spec.ts` under __vibe_tests__/
+ *  (grouped specs live in subfolders), or the flat default path if none exists. */
+async function findSpecPath(devRoot, slug) {
+    const root = join(devRoot, '__vibe_tests__');
+    const want = `${slug}.spec.ts`;
+    const walk = async (d) => {
+        let entries;
+        try {
+            entries = await readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return null;
+        }
+        for (const e of entries) {
+            const p = join(d, e.name);
+            if (e.isDirectory()) {
+                if (e.name === 'pages' || e.name === '.hover' || e.name === 'node_modules')
+                    continue;
+                const hit = await walk(p);
+                if (hit)
+                    return hit;
+            }
+            else if (e.name === want) {
+                return p;
+            }
+        }
+        return null;
+    };
+    return (await walk(root)) ?? join(root, want);
+}
+/**
+ * Promote a reviewed optimization candidate: overwrite the real spec with the
+ * `.hover/cache/optimized/<slug>.spec.ts.draft` and remove the draft. This is the
+ * one place a candidate replaces the original — done ONLY on the user's say-so
+ * (they reviewed the diff), never automatically as part of optimize. Re-validates
+ * the draft (in case it was hand-edited) before applying. Throws if no draft.
+ */
+export async function promoteOptimizedCandidate(devRoot, slug) {
+    const draftPath = join(devRoot, '.hover', 'cache', 'optimized', `${slug}.spec.ts.draft`);
+    let draft;
+    try {
+        draft = await readFile(draftPath, 'utf-8');
+    }
+    catch {
+        throw new OptimizeError(`no optimization candidate for "${slug}" (looked at ${draftPath}). Run optimize first.`);
+    }
+    const check = validateSpecCode(draft);
+    if (!check.ok) {
+        throw new OptimizeError(`candidate for "${slug}" is invalid — ${check.errors.join('; ')}. Not promoting.`);
+    }
+    const specPath = await findSpecPath(devRoot, slug);
+    await writeFile(specPath, draft.endsWith('\n') ? draft : `${draft}\n`, 'utf-8');
+    await rm(draftPath, { force: true });
+    return { path: specPath };
+}
 /**
  * Build the codegen prompt: the current spec + the observed session, plus the
  * same rules the deterministic path enforces (semantic selectors, no XPath, no

package/dist/wiki.d.ts

@@ -0,0 +1,7 @@
+export { lintWiki, parseRunStatuses } from './specs/lintWiki.js';
+export type { LintResult, LintFinding, LintKind, LintSeverity } from './specs/lintWiki.js';
+export { readWikiLog, wikiLogPath } from './specs/wikiLog.js';
+export type { WikiLogEntry, WikiLogKind } from './specs/wikiLog.js';
+export { parseBusinessMap } from './specs/businessMap.js';
+export type { BusinessMapGraph, MapNode, MapEdge, MapRelation, RelationKind, CoverageStatus } from './specs/businessMap.js';
+//# sourceMappingURL=wiki.d.ts.map

package/dist/wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../src/wiki.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/wiki.js

@@ -0,0 +1,14 @@
+/*
+ * `@hover-dev/core/wiki` — the pure-read entry over `.hover/` (the app's test
+ * wiki): the business-map parser + the Lint health check + the run-history log
+ * reader. Everything here transitively imports ONLY `node:fs` / `node:path`
+ * (and type-only refs) — no playwright, no ts-morph, no engine.
+ *
+ * Why a separate entry from `./engine`: a slim consumer (the VS Code cockpit)
+ * bundles this to render the wiki, and importing the full engine barrel would
+ * drag `playwright-core` + `ts-morph` into its ~220 KB .vsix. This barrel keeps
+ * that consumer's bundle tiny while still sharing one source of truth.
+ */
+export { lintWiki, parseRunStatuses } from './specs/lintWiki.js';
+export { readWikiLog, wikiLogPath } from './specs/wikiLog.js';
+export { parseBusinessMap } from './specs/businessMap.js';

package/package.json

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