@hover-dev/core 0.17.0 → 0.19.0

package/dist/service/saveHandlers.d.ts

@@ -1,50 +0,0 @@
-/**
- * Save-artifact WebSocket handlers (spec / Jira CSV).
- *
- * Both save-* messages share the same shape: validate `name + steps`, call a
- * per-kind writer, fork on Exists-error vs. success. The differences (which
- * writer, which message names, which fields to pluck) are captured in the
- * `SaveArtifactConfig` descriptor table below. (Save-as-Skill was retired; the
- * generic `onSaved` hook it used is kept for any future artifact that needs a
- * post-write tail.)
- */
-import type { WebSocket } from 'ws';
-import { type SkillStep } from '../specs/specStep.js';
-import { writeSpec, type SpecAssertion } from '../specs/writeSpec.js';
-import { type ClientMessage } from './types.js';
-interface SaveArtifactConfig<TWriteResult extends {
-    slug: string;
-    path: string;
-}> {
-    /** Used in error messages. Mirrors the WS `type` the client sent. */
-    requestName: string;
-    /** Emitted on success. */
-    savedType: string;
-    /** Emitted when the writer threw an Exists-error. */
-    existsType: string;
-    /** Optional — fires after a successful write (e.g. to push a refreshed list
-     *  to the widget). Currently unused; kept generic for future artifacts. */
-    onSaved?: (ws: WebSocket, devRoot: string) => Promise<void>;
-    /** Class used in `err instanceof …` to detect "already exists" errors. */
-    ExistsError: new (...args: never[]) => {
-        slug: string;
-        path: string;
-    } & Error;
-    /** Pluck the payload fields this artifact needs and call its writer. */
-    write: (args: {
-        devRoot: string;
-        name: string;
-        description: string;
-        steps: SkillStep[];
-        assertions: SpecAssertion[];
-        payload: NonNullable<ClientMessage['payload']>;
-        overwrite: boolean;
-    }) => Promise<TWriteResult>;
-}
-export declare function handleSaveArtifact<TWriteResult extends {
-    slug: string;
-    path: string;
-}>(ws: WebSocket, msg: ClientMessage, devRoot: string, cfg: SaveArtifactConfig<TWriteResult>): Promise<void>;
-export declare const SPEC_CONFIG: SaveArtifactConfig<Awaited<ReturnType<typeof writeSpec>>>;
-export {};
-//# sourceMappingURL=saveHandlers.d.ts.map

package/dist/service/saveHandlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"saveHandlers.d.ts","sourceRoot":"","sources":["../../src/service/saveHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAmB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,UAAU,kBAAkB,CAAC,YAAY,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;IAC9E,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB;+EAC2E;IAC3E,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,0EAA0E;IAC1E,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IAC9E,wEAAwE;IACxE,KAAK,EAAE,CAAC,IAAI,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,UAAU,EAAE,aAAa,EAAE,CAAC;QAC5B,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,SAAS,EAAE,OAAO,CAAC;KACpB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC7B;AAED,wBAAsB,kBAAkB,CAAC,YAAY,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1F,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,kBAAkB,CAAC,YAAY,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,eAAO,MAAM,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAOjF,CAAC"}

package/dist/service/saveHandlers.js

@@ -1,77 +0,0 @@
-/**
- * Save-artifact WebSocket handlers (spec / Jira CSV).
- *
- * Both save-* messages share the same shape: validate `name + steps`, call a
- * per-kind writer, fork on Exists-error vs. success. The differences (which
- * writer, which message names, which fields to pluck) are captured in the
- * `SaveArtifactConfig` descriptor table below. (Save-as-Skill was retired; the
- * generic `onSaved` hook it used is kept for any future artifact that needs a
- * post-write tail.)
- */
-import { writeSpec, SpecExistsError } from '../specs/writeSpec.js';
-import { send } from './types.js';
-export async function handleSaveArtifact(ws, msg, devRoot, cfg) {
-    const name = msg.payload?.name;
-    const description = msg.payload?.description ?? '';
-    const steps = msg.payload?.steps;
-    const assertions = msg.payload?.assertions ?? [];
-    const overwrite = msg.payload?.overwrite === true;
-    if (typeof name !== 'string' || !name.trim()) {
-        send(ws, { type: 'error', payload: { message: `${cfg.requestName}: name is required` } });
-        return;
-    }
-    if (!Array.isArray(steps) || steps.length === 0) {
-        send(ws, { type: 'error', payload: { message: `${cfg.requestName}: no steps to save` } });
-        return;
-    }
-    let result;
-    try {
-        result = await cfg.write({
-            devRoot, name, description, steps, assertions,
-            payload: msg.payload, overwrite,
-        });
-    }
-    catch (err) {
-        if (err instanceof cfg.ExistsError) {
-            send(ws, { type: cfg.existsType, payload: { slug: err.slug, existingPath: err.path } });
-            return;
-        }
-        const message = err instanceof Error ? err.message : String(err);
-        send(ws, { type: 'error', payload: { message: `${cfg.requestName} failed: ${message}` } });
-        return;
-    }
-    // When the run was split into several feature files, report all their slugs
-    // so the widget can confirm "Saved 3 specs: login, checkout, …".
-    const files = result.files;
-    // Auth-as-fixture (debt 3): a login was detected but a user playwright.config
-    // exists — forward the proposed config edit so the extension can offer it for
-    // approval (Stage 4b). Absent on a normal save.
-    const authFixtureOffer = result.authFixtureOffer;
-    send(ws, {
-        type: cfg.savedType,
-        payload: {
-            name: result.slug,
-            path: result.path,
-            ...(files && files.length > 1 ? { files: files.map((f) => f.slug) } : {}),
-            ...(authFixtureOffer ? { authFixtureOffer } : {}),
-        },
-    });
-    // The artifact is already on disk; an onSaved failure (e.g. a follow-up
-    // list re-scan) shouldn't surface as if the save itself failed — log on.
-    if (cfg.onSaved) {
-        try {
-            await cfg.onSaved(ws, devRoot);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.warn(`[hover] ${cfg.requestName} onSaved failed: ${message}`);
-        }
-    }
-}
-export const SPEC_CONFIG = {
-    requestName: 'save-spec',
-    savedType: 'spec-saved',
-    existsType: 'spec-exists',
-    ExistsError: SpecExistsError,
-    write: ({ devRoot, name, description, steps, assertions, payload, overwrite }) => writeSpec({ devRoot, name, description, steps, assertions, overwrite, redactions: payload.redactions, resetRecipe: payload.resetRecipe, authFixture: payload.authFixture }),
-};

package/dist/service/types.d.ts

@@ -1,158 +0,0 @@
-/**
- * Shared types for the service/ handler modules.
- *
- * `ClientMessage` describes the wire-protocol envelope every message from
- * the widget arrives in. Lives here (not in service.ts) so individual
- * handlers can type their `msg` argument without circular imports.
- *
- * `send` is the one-liner used by every handler to emit a typed message
- * back to the widget. Centralised so the JSON.stringify happens in exactly
- * one place.
- */
-import { WebSocket } from 'ws';
-import type { SkillStep } from '../specs/specStep.js';
-import type { SpecAssertion } from '../specs/writeSpec.js';
-export interface ClientMessage {
-    type: string;
-    payload?: {
-        text?: string;
-        sessionId?: string;
-        /** The chat conversation a run belongs to — groups its run folders under
-         *  `.hover/runs/<conversationId>/`. */
-        conversationId?: string;
-        name?: string;
-        description?: string;
-        steps?: SkillStep[];
-        assertions?: SpecAssertion[];
-        overwrite?: boolean;
-        /** save-spec only — credentials to parameterize into process.env.<envVar>
-         *  references so secrets never land in the spec / sidecar. */
-        redactions?: {
-            value: string;
-            envVar: string;
-        }[];
-        /** save-spec only — the active env's recon-discovered reset recipe (debt-2).
-         *  A tier-1 recipe makes the spec generate + call a resetState() beforeEach. */
-        resetRecipe?: {
-            tier: number;
-            storageKeys?: string[];
-            hook?: string;
-        };
-        /** save-spec only — auth-as-fixture (debt 3). The user approved Hover editing
-         *  their existing playwright.config; engage the fixture (lift login into
-         *  auth.setup.ts) and apply the setup-project edit. Absent on a normal save. */
-        authFixture?: boolean;
-        /** command only — test accounts the prompt referenced via @label. Injected
-         *  into the agent's system prompt (ephemeral, not the saved transcript) so
-         *  it can log in; the recorded fill values get redacted on save. */
-        accounts?: {
-            label: string;
-            username?: string;
-            password?: string;
-            role?: string;
-        }[];
-        /** command only — ask the agent to run state-reset recon this run (debt-2
-         *  reproducible-state-isolation). Off unless the extension sets it (e.g. the
-         *  active env has no reset recipe yet); recon clears client state, so it must
-         *  be opt-in, never on a plain Flow recording. */
-        reconReset?: boolean;
-        /** check-cdp / launch-chrome / focus-debug — the widget's
-         *  window.location.href so service can compare origins or navigate the
-         *  newly-launched debug Chrome to the same URL. */
-        pageUrl?: string;
-        /** switch-agent only — id of the agent to switch the service to. */
-        agentId?: string;
-        /** set-model only — the model id to use for subsequent runs (e.g. opus). */
-        model?: string;
-        /** optimize-spec only — override model for the F7 refinement pass (the
-         *  `hover.optimizeModel` setting). Empty → the agent's cheap default. */
-        optimizeModel?: string;
-        /** heal-spec only — the failing spec's source, so the engine can build the
-         *  heal prompt without guessing the spec's path. */
-        specSource?: string;
-        /** set-effort only — reasoning-effort level for subsequent runs (empty
-         *  string clears it → agent/model default). */
-        effort?: string;
-        /** set-local-endpoint only — base URL of the user's self-hosted
-         *  OpenAI-compatible endpoint for the Local LLM agent. */
-        baseUrl?: string;
-        /** set-byok only — bring-your-own-key model config (protocol + key + base
-         *  URL + model injected into the protocol's matching CLI), or null to clear
-         *  and fall back to the local-CLI agent's own auth. */
-        config?: {
-            protocol: string;
-            baseUrl: string;
-            model: string;
-            maxTokens: number;
-            apiKey: string;
-        } | null;
-        /** set-mode only — id of the plugin-contributed mode to activate,
-         *  or null to return to normal (unmoded) operation. */
-        modeId?: string | null;
-        /** optimize-spec / promote-optimized / discard-optimized — the spec slug. */
-        slug?: string;
-        /** launch-chrome only — launch the debug Chrome headless (silent mode). */
-        headless?: boolean;
-        /** launch-chrome only — close any existing debug Chrome first, then
-         *  relaunch (so a headless↔visible switch / "reopen browser" takes effect). */
-        force?: boolean;
-        /** reveal-source only — a `data-hover-source` value (`<rel-path>:<line>:<col>`)
-         *  an in-page client (widget) captured from a clicked element. The service
-         *  relays it to every OTHER connected client; the VSCode extension listens
-         *  for it and jumps the editor to that location (F2 page→editor transport). */
-        source?: string;
-        /** command only — the editor's source-read grant for this run:
-         *  'always' (skip the gate), 'ask' (gate each read), 'deny' (no source MCP).
-         *  Default 'ask' when absent. */
-        sourceAccess?: 'always' | 'ask' | 'deny';
-        /** command only — run the agent in an isolated cwd so it loads none of the
-         *  user's CLAUDE.md / Claude Code auto-memory (Memory = "isolated"). */
-        isolateContext?: boolean;
-        /** command only — the active environment, recorded in the session ledger. */
-        env?: {
-            id?: string;
-            name?: string;
-        };
-        /** source-approval-request (from the source MCP) / -response (from the
-         *  editor): a correlation id, the requested repo-relative path + kind, and
-         *  the user's allow/deny decision. */
-        approvalId?: string;
-        sourcePath?: string;
-        sourceKind?: string;
-        allow?: boolean;
-        /** ask-user-request (from the control MCP) / -response (from the editor):
-         *  a correlation id, the question + offered choices, and the user's answer. */
-        askId?: string;
-        question?: string;
-        options?: {
-            label: string;
-            description?: string;
-        }[];
-        allowFreeText?: boolean;
-        value?: string;
-        cancelled?: boolean;
-        /** record-fact (from the control MCP, QA/API modes only): a business RULE
-         *  the agent learned/confirmed, to persist into `.hover/memory/` so it isn't
-         *  re-asked next run. RULES only — never secrets/PII (the tool + directive
-         *  enforce this; the engine also ignores it outside QA/API). */
-        fact?: {
-            title: string;
-            rule: string;
-            type?: string;
-        };
-    };
-}
-export declare function send(ws: WebSocket, message: {
-    type: string;
-    payload?: unknown;
-}): void;
-/** Send a message only if the socket is still open. Use this from delayed
- *  callbacks (promise `.then`, timers) where the client may have disconnected
- *  between scheduling and firing — calling `ws.send` on a closed socket
- *  is a silent no-op for some states and throws for others, so a single
- *  guarded helper makes the intent obvious and prevents surprises. */
-export declare function sendIfOpen(ws: WebSocket, message: {
-    type: string;
-    payload?: unknown;
-}): boolean;
-//# sourceMappingURL=types.d.ts.map

package/dist/service/types.d.ts.map

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

package/dist/service/types.js

@@ -1,26 +0,0 @@
-/**
- * Shared types for the service/ handler modules.
- *
- * `ClientMessage` describes the wire-protocol envelope every message from
- * the widget arrives in. Lives here (not in service.ts) so individual
- * handlers can type their `msg` argument without circular imports.
- *
- * `send` is the one-liner used by every handler to emit a typed message
- * back to the widget. Centralised so the JSON.stringify happens in exactly
- * one place.
- */
-import { WebSocket } from 'ws';
-export function send(ws, message) {
-    ws.send(JSON.stringify(message));
-}
-/** Send a message only if the socket is still open. Use this from delayed
- *  callbacks (promise `.then`, timers) where the client may have disconnected
- *  between scheduling and firing — calling `ws.send` on a closed socket
- *  is a silent no-op for some states and throws for others, so a single
- *  guarded helper makes the intent obvious and prevents surprises. */
-export function sendIfOpen(ws, message) {
-    if (ws.readyState !== WebSocket.OPEN)
-        return false;
-    ws.send(JSON.stringify(message));
-    return true;
-}

package/dist/service.d.ts

@@ -1,54 +0,0 @@
-import { type HoverPluginManifest } from './plugin-api.js';
-export interface ServiceOptions {
-    port: number;
-    agentId?: string;
-    model?: string;
-    /** Initial reasoning-effort level (set-effort overrides at runtime). */
-    effort?: string;
-    maxBudgetUsd?: number;
-    mcpConfig?: string;
-    /** CDP URL to preflight before each command (default http://localhost:9222). */
-    cdpUrl?: string;
-    /** Isolated Chrome user-data-dir for this service's debug Chrome (default
-     *  `<tmpdir>/hover-chrome`). Set per-service so several engine hosts (one per
-     *  chat session) each drive their OWN Chrome profile — distinct logins, no
-     *  profile-lock contention. Paired with a distinct `cdpUrl` port. */
-    userDataDir?: string;
-    /** Working directory for the spawned agent. Also the root under which saved
-     *  specs (`__vibe_tests__/`), sidecars + seeds (`.hover/`) live. Defaults to
-     *  process.cwd(); in Vite plugin context, set to `server.config.root` so the
-     *  agent runs against the project (and Claude Code reads its CLAUDE.md). */
-    devRoot?: string;
-    /** Plugins contributed by the bundler-plugin wrapper. Each manifest can
-     *  add a widget mode, MCP servers, Chrome flags, and lifecycle hooks.
-     *  Empty array (default) means "no plugins, behaviour identical to
-     *  pre-plugin Hover" — important for the long tail of users who never
-     *  install one. */
-    plugins?: HoverPluginManifest[];
-    /** When true, the service launches the single debug Chrome itself at
-     *  startup — AFTER firing plugin `hover:service:start` hooks, so a plugin
-     *  that set a resident proxy (e.g. security's MITM) has its flags baked
-     *  into that one Chrome. Previously each bundler shim called
-     *  launchDebugChrome() directly, which bypassed the service and so couldn't
-     *  see the proxy; moving it here is what enables the single-Chrome model.
-     *  Default false (shims pass it through from their own option). */
-    autoLaunchChrome?: boolean;
-    /** Opt-in: give the agent READ-ONLY, fenced access to the project's source
-     *  via a `read_source` / `list_source` MCP server (in addition to Playwright
-     *  MCP), in every mode. Lets it author against real selectors/routes and do
-     *  white-box security/pentest. Fenced to devRoot, secrets/keys/.git/build
-     *  excluded, no write/exec. Default false — the agent stays browser-only. */
-    codeContext?: boolean;
-    /** The dev-server URL the auto-launched Chrome should open. Each shim knows
-     *  its own framework's dev URL and passes it here. Defaults to the cdp host
-     *  if unset, but shims should always provide it. */
-    devUrl?: string;
-}
-export interface ServiceHandle {
-    /** The port the WebSocketServer actually bound to. May differ from
-     *  the requested port if it was taken (we auto-bump up to 10 times). */
-    port: number;
-    close(): Promise<void>;
-}
-export declare function startService(opts: ServiceOptions): Promise<ServiceHandle>;
-//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAqFA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AAqCzB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;yEAGqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;gFAG4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;uBAImB;IACnB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC;;;;;;uEAMmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;iFAI6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;wDAEoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B;4EACwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkFD,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAglD/E"}