@hover-dev/mcp 0.17.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Hyperyond Studio
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/mcp.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+
+// src/mcp.ts
+import { chromium } from "playwright-core";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  launchDebugChrome,
+  writeSpec,
+  writeFact,
+  loadMemory,
+  formatMemoryForPrompt
+} from "@hover-dev/core/engine";
+
+// src/mcp/controller.ts
+import { groundedLocate } from "@hover-dev/core/engine";
+function describe(g) {
+  if (g.role && g.name) return `${g.role} "${g.name}"`;
+  if (g.testId) return `testId "${g.testId}"`;
+  if (g.text) return `text "${g.text}"`;
+  return "(no target)";
+}
+var HoverMcpController = class {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  deps;
+  /** The grounded-action buffer — sliced by `crystallize`. */
+  steps = [];
+  push(tool, input) {
+    this.steps.push({ kind: "step", tool, input });
+  }
+  async resolve(g) {
+    const page = await this.deps.getPage();
+    const loc = groundedLocate(page, g);
+    if (!loc) throw new Error(`pass role+name (preferred), or testId, or text \u2014 taken from the snapshot`);
+    return loc;
+  }
+  async navigate(url) {
+    const page = await this.deps.getPage();
+    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 2e4 });
+    this.push("browser_navigate", { url });
+    return `navigated to ${url}`;
+  }
+  /** ARIA snapshot of the page — the agent reads role+name from here. */
+  async snapshot() {
+    const page = await this.deps.getPage();
+    return await page.locator("body").ariaSnapshot();
+  }
+  async click(g) {
+    const loc = await this.resolve(g);
+    await loc.click({ timeout: 8e3 });
+    this.push("click_control", g);
+    return `\u2713 clicked ${describe(g)}`;
+  }
+  async fill(g, value) {
+    const loc = await this.resolve(g);
+    await loc.fill(value, { timeout: 8e3 });
+    this.push("fill_control", { ...g, value });
+    return `\u2713 filled ${describe(g)}`;
+  }
+  async select(g, value) {
+    const loc = await this.resolve(g);
+    await loc.selectOption(value, { timeout: 8e3 });
+    this.push("select_control", { ...g, value });
+    return `\u2713 selected ${value} in ${describe(g)}`;
+  }
+  async check(g, checked) {
+    const loc = await this.resolve(g);
+    if (checked) await loc.check({ timeout: 8e3 });
+    else await loc.uncheck({ timeout: 8e3 });
+    this.push("check_control", { ...g, checked });
+    return `\u2713 ${checked ? "checked" : "unchecked"} ${describe(g)}`;
+  }
+  async assertVisible(g) {
+    const loc = await this.resolve(g);
+    const visible = await loc.first().isVisible();
+    if (!visible) throw new Error(`${describe(g)} is not visible`);
+    this.push("assert_visible", { ...g, matcher: "visible" });
+    return `\u2713 ${describe(g)} is visible`;
+  }
+  /** Recall what earlier runs learned about this app's business rules. */
+  async recall() {
+    if (!this.deps.recall) return "No business memory available.";
+    const known = await this.deps.recall();
+    return known || "No business knowledge recorded yet for this app.";
+  }
+  /** Persist a confirmed business RULE so future runs don't re-ask it. Rules
+   *  only — never secrets / credentials / PII. */
+  async recordFact(title, rule, type = "business-rule") {
+    if (!this.deps.recordFact) return "Memory channel unavailable; continuing.";
+    const res = await this.deps.recordFact(title, rule, type);
+    return "error" in res ? `\u2717 could not save fact: ${res.error}` : `\u2713 remembered: ${title}`;
+  }
+  /** Crystallize the buffered flow → a plain Playwright spec, then clear the
+   *  buffer for the next flow. */
+  async crystallize(name, description) {
+    if (this.steps.length === 0) return "Nothing to crystallize yet \u2014 actuate some controls first.";
+    const flow = [...this.steps];
+    const { path } = await this.deps.crystallize(name, description, flow);
+    this.steps.length = 0;
+    return `\u2713 wrote ${path} (${flow.length} step${flow.length === 1 ? "" : "s"})`;
+  }
+};
+
+// src/mcp/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+var md = (text) => ({ content: [{ type: "text", text }] });
+var errLine = (e) => e instanceof Error ? e.message.split("\n")[0] : String(e);
+var GROUND = {
+  role: z.string().optional().describe("ARIA role from the snapshot, e.g. 'button', 'textbox', 'link'. Pair with `name`."),
+  name: z.string().optional().describe("Accessible name from the snapshot, exactly as shown. Pair with `role`."),
+  testId: z.string().optional().describe("A data-testid, if the element has one and no clean role+name."),
+  text: z.string().optional().describe("Real visible text on the element \u2014 last resort."),
+  within: z.object({ role: z.string(), name: z.string() }).optional().describe("Scope the search to a container first (role+name) when a label repeats across groups.")
+};
+function createHoverMcpServer(c) {
+  const server2 = new McpServer({ name: "hover", version: "0.1.0" });
+  const guard = (fn) => fn().then(md, (e) => md(`\u2717 ${errLine(e)}`));
+  server2.registerTool(
+    "browser_navigate",
+    { description: "Open a URL in the app under test (the debug Chrome).", inputSchema: { url: z.string() } },
+    ({ url }) => guard(() => c.navigate(url))
+  );
+  server2.registerTool(
+    "browser_snapshot",
+    {
+      description: "Read the current page as an ARIA snapshot (role + accessible-name tree). Call this BEFORE actuating to get the exact role+name to pass to the *_control tools.",
+      inputSchema: {}
+    },
+    () => guard(() => c.snapshot())
+  );
+  server2.registerTool(
+    "click_control",
+    {
+      description: "Click a control by a GROUNDED target read off the snapshot (role+name preferred \u2192 testId \u2192 text). Grounded so the saved spec replays exactly what you did.",
+      inputSchema: GROUND
+    },
+    (g) => guard(() => c.click(g))
+  );
+  server2.registerTool(
+    "fill_control",
+    { description: "Type a value into a textbox/field by a grounded target.", inputSchema: { ...GROUND, value: z.string() } },
+    ({ value, ...g }) => guard(() => c.fill(g, value))
+  );
+  server2.registerTool(
+    "select_control",
+    { description: "Choose an option in a <select> by a grounded target.", inputSchema: { ...GROUND, value: z.string() } },
+    ({ value, ...g }) => guard(() => c.select(g, value))
+  );
+  server2.registerTool(
+    "check_control",
+    {
+      description: "Check or uncheck a checkbox/radio by a grounded target (handles sr-only / hidden inputs).",
+      inputSchema: { ...GROUND, checked: z.boolean().optional().describe("true (default) = check; false = uncheck.") }
+    },
+    ({ checked, ...g }) => guard(() => c.check(g, checked !== false))
+  );
+  server2.registerTool(
+    "assert_visible",
+    {
+      description: "Assert a control/text is visible now \u2014 captures an expect(...).toBeVisible() into the saved spec.",
+      inputSchema: GROUND
+    },
+    (g) => guard(() => c.assertVisible(g))
+  );
+  server2.registerTool(
+    "recall_business_knowledge",
+    {
+      description: "Recall what earlier Hover runs learned about this app (business rules, expected behaviors, access policies). Call this at the START so you do not re-ask settled questions. Treat what it returns as ground truth.",
+      inputSchema: {}
+    },
+    () => guard(() => c.recall())
+  );
+  server2.registerTool(
+    "record_fact",
+    {
+      description: "Remember a durable BUSINESS RULE about this app so neither you nor a future run re-asks it \u2014 e.g. an expected behavior, a validation rule, an access policy, or the answer to a 'bug or by-design?' the user just confirmed. State it as a clean self-contained rule. RULES ONLY \u2014 never store secrets, passwords, tokens, or personal data.",
+      inputSchema: {
+        title: z.string().describe("Short title for the rule (becomes its memory filename + index entry)."),
+        rule: z.string().describe("The rule itself, stated clearly and self-contained (no secrets/PII)."),
+        type: z.enum(["business-rule", "expected-behavior", "validation", "access-policy"]).optional().describe("What kind of knowledge this is. Defaults to business-rule.")
+      }
+    },
+    ({ title, rule, type }) => guard(() => c.recordFact(title, rule, type ?? "business-rule"))
+  );
+  server2.registerTool(
+    "crystallize_spec",
+    {
+      description: 'Save the flow you JUST performed (the grounded click/fill/select/check/assert actions since the last crystallize) as a plain Playwright .spec.ts in __vibe_tests__/. Call it the moment you finish a coherent end-to-end flow. Name it in English, imperative (e.g. "Log in").',
+      inputSchema: {
+        name: z.string().describe("Short imperative flow name in English \u2014 becomes the spec filename + test name."),
+        description: z.string().optional().describe("One line on what this flow verifies.")
+      }
+    },
+    ({ name, description }) => guard(() => c.crystallize(name, description))
+  );
+  server2.registerPrompt(
+    "test_app",
+    {
+      title: "Hover \u2014 map & crystallize a test suite",
+      description: "Map this app's business lines and crystallize a Playwright suite (incremental, scales to large apps).",
+      argsSchema: { scope: z.string().optional().describe("An area/flow to focus on. Omit to cover the whole app.") }
+    },
+    ({ scope }) => ({
+      messages: [{ role: "user", content: { type: "text", text: workflowPrompt(scope) } }]
+    })
+  );
+  return server2;
+}
+function workflowPrompt(scope) {
+  const target = scope?.trim() ? scope.trim() : "the whole app";
+  return `Build (or extend) a Playwright test suite for this web app using the **Hover MCP tools**.
+Drive the browser ONLY through these tools \u2014 they actuate via grounded selectors
+(role+name \u2192 testId \u2192 text), so every spec you save replays EXACTLY what you did
+(record==replay). Never write spec files yourself; only \`crystallize_spec\` does.
+
+Tools: \`recall_business_knowledge\` \xB7 \`browser_navigate\` \xB7 \`browser_snapshot\` (ARIA
+tree \u2014 read before acting) \xB7 \`click_control\` / \`fill_control\` / \`select_control\` /
+\`check_control\` (grounded target from the snapshot) \xB7 \`assert_visible\` \xB7
+\`record_fact\` \xB7 \`crystallize_spec(name, description?)\`.
+
+Target: the app at HOVER_TARGET (set in the server's env). Scope: ${target}.
+
+Work in PHASES \u2014 this is what lets it scale from a tiny app to a large one.
+
+## Phase 1 \u2014 Map the business lines (read the CODE, don't click around)
+- FIRST call \`recall_business_knowledge\` \u2014 rules earlier runs learned (and read \`.hover/hover-map.md\` if it exists, the running map; CONTINUE it, don't start over). Treat both as ground truth; don't re-ask what they already answer.
+- Use YOUR OWN file tools (read / grep / glob) to find the app's ROUTES + navigation: the router config, route/page files, the nav components. Enumerate the user-facing BUSINESS LINES (a coherent task a user performs), each with its entry route, grouped by area. Reading code is cheaper + more complete than clicking around, and finds areas behind auth / nav you'd otherwise miss.
+- Write/update \`.hover/hover-map.md\` as a checklist (4-space indent = a code block):
+
+        # Business map \u2014 <app>
+        ## Auth
+        - [ ] Log in \u2014 /login
+        - [x] Checkout \u2014 /checkout \u2014 checkout.spec.ts
+
+- Don't test yet. For a large app, this map IS the plan.
+
+## Phase 2 \u2014 Pick the scope
+- If a scope was given, cover that. Otherwise show the uncovered lines and ask which to cover now (offer "all uncovered"). For a small app, just cover them all.
+
+## Phase 3 \u2014 Cover each chosen line, ONE AT A TIME
+For each line: \`browser_navigate\` to its route \u2192 \`browser_snapshot\` \u2192 EXERCISE the real flow (click / fill / select / check \u2014 you are a tester, never just describe the page) \u2192 \`assert_visible\` on the OUTCOME (a success message, the new row, the next screen) \u2192 \`crystallize_spec("<short imperative English name>")\`. Crystallize the MOMENT each flow is done, before the next \u2014 the buffer is per-flow. The tools share ONE browser, so cover lines SEQUENTIALLY.
+
+## Phase 4 \u2014 Update coverage
+- Mark each covered line \`[x]\` in \`.hover/hover-map.md\` with its spec filename. Report covered vs still-open. A LARGE app doesn't have to finish in one go \u2014 covering a batch + updating the map is a complete, resumable unit; re-invoke to continue the uncovered lines.
+
+## Understand the business \u2014 ASK, then REMEMBER
+When you genuinely can't resolve something on your own \u2014 is this a bug or by-design? which flows matter? what does this domain term mean? \u2014 ASK the user (don't guess, don't stop). When they confirm a durable business RULE, call \`record_fact\` to persist it (RULES ONLY \u2014 never credentials/secrets/PII). Also ASK when blocked on something only they can provide (login credentials, a file). Stay on the app under test \u2014 never navigate to external origins.`;
+}
+
+// src/mcp.ts
+var TARGET = process.env.HOVER_TARGET || "http://localhost:5173";
+var PORT = Number(process.env.HOVER_CDP_PORT || 9222);
+var DEV_ROOT = process.env.HOVER_PROJECT_ROOT || process.cwd();
+var CDP_URL = `http://localhost:${PORT}`;
+var originOf = (u) => {
+  try {
+    return new URL(u).origin;
+  } catch {
+    return null;
+  }
+};
+var browser = null;
+async function getPage() {
+  if (!browser || !browser.isConnected()) {
+    await launchDebugChrome({ port: PORT, url: TARGET });
+    browser = await chromium.connectOverCDP(CDP_URL, { timeout: 8e3 });
+  }
+  const pages = browser.contexts().flatMap((ctx2) => ctx2.pages());
+  const want = originOf(TARGET);
+  const match = want ? pages.find((p) => originOf(p.url()) === want) : void 0;
+  if (match) return match;
+  if (pages.length) return pages[pages.length - 1];
+  const ctx = browser.contexts()[0] ?? await browser.newContext();
+  return ctx.newPage();
+}
+var controller = new HoverMcpController({
+  getPage,
+  crystallize: async (name, description, steps) => {
+    const res = await writeSpec({ devRoot: DEV_ROOT, name, description, steps, startUrl: TARGET, overwrite: true });
+    return { path: res.path };
+  },
+  recordFact: (title, rule, type) => writeFact(DEV_ROOT, { name: title, description: title, type, body: rule }),
+  recall: async () => formatMemoryForPrompt(await loadMemory(DEV_ROOT))
+});
+var server = createHoverMcpServer(controller);
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts","../src/mcp/controller.ts","../src/mcp/server.ts"],"sourcesContent":["import { chromium, type Browser, type Page } from 'playwright-core';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  launchDebugChrome,\n  writeSpec,\n  writeFact,\n  loadMemory,\n  formatMemoryForPrompt,\n  type SkillStep,\n} from '@hover-dev/core/engine';\nimport { HoverMcpController } from './mcp/controller.js';\nimport { createHoverMcpServer } from './mcp/server.js';\n\n/*\n * `hover-mcp` — the MCP-first surface. Add it to your OWN agent (Claude Code,\n * Cursor, …); the agent drives the app through Hover's grounded tools and calls\n * crystallize_spec to save a plain Playwright spec. Hover spawns no agent here —\n * the calling agent IS the intelligence; Hover guarantees record==replay at the\n * output. Config via env: HOVER_TARGET, HOVER_CDP_PORT, HOVER_PROJECT_ROOT.\n *\n * NOTE: stdio is the MCP transport — never write to stdout from this process.\n */\n\nconst TARGET = process.env.HOVER_TARGET || 'http://localhost:5173';\nconst PORT = Number(process.env.HOVER_CDP_PORT || 9222);\nconst DEV_ROOT = process.env.HOVER_PROJECT_ROOT || process.cwd();\nconst CDP_URL = `http://localhost:${PORT}`;\n\nconst originOf = (u: string): string | null => {\n  try {\n    return new URL(u).origin;\n  } catch {\n    return null;\n  }\n};\n\nlet browser: Browser | null = null;\n\n/** Launch/connect the debug Chrome lazily and return the page on the app. */\nasync function getPage(): Promise<Page> {\n  if (!browser || !browser.isConnected()) {\n    await launchDebugChrome({ port: PORT, url: TARGET });\n    browser = await chromium.connectOverCDP(CDP_URL, { timeout: 8000 });\n  }\n  const pages = browser.contexts().flatMap((ctx) => ctx.pages());\n  const want = originOf(TARGET);\n  const match = want ? pages.find((p) => originOf(p.url()) === want) : undefined;\n  if (match) return match;\n  if (pages.length) return pages[pages.length - 1];\n  const ctx = browser.contexts()[0] ?? (await browser.newContext());\n  return ctx.newPage();\n}\n\nconst controller = new HoverMcpController({\n  getPage,\n  crystallize: async (name: string, description: string | undefined, steps: SkillStep[]) => {\n    const res = await writeSpec({ devRoot: DEV_ROOT, name, description, steps, startUrl: TARGET, overwrite: true });\n    return { path: res.path };\n  },\n  recordFact: (title, rule, type) =>\n    writeFact(DEV_ROOT, { name: title, description: title, type, body: rule }),\n  recall: async () => formatMemoryForPrompt(await loadMemory(DEV_ROOT)),\n});\n\nconst server = createHoverMcpServer(controller);\nawait server.connect(new StdioServerTransport());\n","import type { Page } from 'playwright-core';\nimport { groundedLocate, type GroundedTarget, type SkillStep } from '@hover-dev/core/engine';\n\n/*\n * The hover-mcp engine, decoupled from the MCP wire layer so it's testable with\n * a mock Page. The user's OWN agent (Claude Code / Cursor) calls these via MCP:\n * it reads the page (snapshot), actuates with GROUNDED targets (role+name →\n * testId → text), and Hover buffers each successful actuation as a SkillStep.\n * `crystallize` turns the buffer into a plain Playwright spec — record==replay,\n * because the buffered selectors ARE the ones that drove the page.\n */\n\nexport type FactType = 'business-rule' | 'expected-behavior' | 'validation' | 'access-policy';\n\nexport interface McpDeps {\n  /** Resolve the live page on the app under test (launch/connect lazily). */\n  getPage: () => Promise<Page>;\n  /** Write the buffered steps to a spec; returns the written path. */\n  crystallize: (name: string, description: string | undefined, steps: SkillStep[]) => Promise<{ path: string }>;\n  /** Persist a learned business rule to .hover/memory/ (rules only — no secrets). */\n  recordFact?: (title: string, rule: string, type: FactType) => Promise<{ path: string } | { error: string }>;\n  /** Recall known business knowledge from .hover/memory/ as a prompt block ('' if none). */\n  recall?: () => Promise<string>;\n}\n\nfunction describe(g: GroundedTarget): string {\n  if (g.role && g.name) return `${g.role} \"${g.name}\"`;\n  if (g.testId) return `testId \"${g.testId}\"`;\n  if (g.text) return `text \"${g.text}\"`;\n  return '(no target)';\n}\n\nexport class HoverMcpController {\n  /** The grounded-action buffer — sliced by `crystallize`. */\n  readonly steps: SkillStep[] = [];\n\n  constructor(private readonly deps: McpDeps) {}\n\n  private push(tool: string, input: unknown): void {\n    this.steps.push({ kind: 'step', tool, input });\n  }\n\n  private async resolve(g: GroundedTarget) {\n    const page = await this.deps.getPage();\n    const loc = groundedLocate(page, g);\n    if (!loc) throw new Error(`pass role+name (preferred), or testId, or text — taken from the snapshot`);\n    return loc;\n  }\n\n  async navigate(url: string): Promise<string> {\n    const page = await this.deps.getPage();\n    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 20000 });\n    this.push('browser_navigate', { url });\n    return `navigated to ${url}`;\n  }\n\n  /** ARIA snapshot of the page — the agent reads role+name from here. */\n  async snapshot(): Promise<string> {\n    const page = await this.deps.getPage();\n    return await page.locator('body').ariaSnapshot();\n  }\n\n  async click(g: GroundedTarget): Promise<string> {\n    const loc = await this.resolve(g);\n    await loc.click({ timeout: 8000 });\n    this.push('click_control', g);\n    return `✓ clicked ${describe(g)}`;\n  }\n\n  async fill(g: GroundedTarget, value: string): Promise<string> {\n    const loc = await this.resolve(g);\n    await loc.fill(value, { timeout: 8000 });\n    this.push('fill_control', { ...g, value });\n    return `✓ filled ${describe(g)}`;\n  }\n\n  async select(g: GroundedTarget, value: string): Promise<string> {\n    const loc = await this.resolve(g);\n    await loc.selectOption(value, { timeout: 8000 });\n    this.push('select_control', { ...g, value });\n    return `✓ selected ${value} in ${describe(g)}`;\n  }\n\n  async check(g: GroundedTarget, checked: boolean): Promise<string> {\n    const loc = await this.resolve(g);\n    if (checked) await loc.check({ timeout: 8000 });\n    else await loc.uncheck({ timeout: 8000 });\n    this.push('check_control', { ...g, checked });\n    return `✓ ${checked ? 'checked' : 'unchecked'} ${describe(g)}`;\n  }\n\n  async assertVisible(g: GroundedTarget): Promise<string> {\n    const loc = await this.resolve(g);\n    const visible = await loc.first().isVisible();\n    if (!visible) throw new Error(`${describe(g)} is not visible`);\n    this.push('assert_visible', { ...g, matcher: 'visible' });\n    return `✓ ${describe(g)} is visible`;\n  }\n\n  /** Recall what earlier runs learned about this app's business rules. */\n  async recall(): Promise<string> {\n    if (!this.deps.recall) return 'No business memory available.';\n    const known = await this.deps.recall();\n    return known || 'No business knowledge recorded yet for this app.';\n  }\n\n  /** Persist a confirmed business RULE so future runs don't re-ask it. Rules\n   *  only — never secrets / credentials / PII. */\n  async recordFact(title: string, rule: string, type: FactType = 'business-rule'): Promise<string> {\n    if (!this.deps.recordFact) return 'Memory channel unavailable; continuing.';\n    const res = await this.deps.recordFact(title, rule, type);\n    return 'error' in res ? `✗ could not save fact: ${res.error}` : `✓ remembered: ${title}`;\n  }\n\n  /** Crystallize the buffered flow → a plain Playwright spec, then clear the\n   *  buffer for the next flow. */\n  async crystallize(name: string, description?: string): Promise<string> {\n    if (this.steps.length === 0) return 'Nothing to crystallize yet — actuate some controls first.';\n    const flow = [...this.steps];\n    const { path } = await this.deps.crystallize(name, description, flow);\n    this.steps.length = 0;\n    return `✓ wrote ${path} (${flow.length} step${flow.length === 1 ? '' : 's'})`;\n  }\n}\n","import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport type { HoverMcpController } from './controller.js';\n\n/* Wrap the controller as an MCP server. Tool names + the GROUNDED target shape\n * mirror Hover's control MCP so an agent that knows one knows the other. Every\n * handler returns text (✓/✗) and never throws — a failed locate/action becomes\n * a ✗ message the calling agent can react to, not an MCP transport error. */\n\nconst md = (text: string) => ({ content: [{ type: 'text' as const, text }] });\nconst errLine = (e: unknown) => (e instanceof Error ? e.message.split('\\n')[0] : String(e));\n\nconst GROUND = {\n  role: z.string().optional().describe(\"ARIA role from the snapshot, e.g. 'button', 'textbox', 'link'. Pair with `name`.\"),\n  name: z.string().optional().describe('Accessible name from the snapshot, exactly as shown. Pair with `role`.'),\n  testId: z.string().optional().describe('A data-testid, if the element has one and no clean role+name.'),\n  text: z.string().optional().describe('Real visible text on the element — last resort.'),\n  within: z\n    .object({ role: z.string(), name: z.string() })\n    .optional()\n    .describe('Scope the search to a container first (role+name) when a label repeats across groups.'),\n};\n\nexport function createHoverMcpServer(c: HoverMcpController): McpServer {\n  const server = new McpServer({ name: 'hover', version: '0.1.0' });\n  const guard = (fn: () => Promise<string>) => fn().then(md, (e) => md(`✗ ${errLine(e)}`));\n\n  server.registerTool(\n    'browser_navigate',\n    { description: 'Open a URL in the app under test (the debug Chrome).', inputSchema: { url: z.string() } },\n    ({ url }) => guard(() => c.navigate(url)),\n  );\n\n  server.registerTool(\n    'browser_snapshot',\n    {\n      description:\n        'Read the current page as an ARIA snapshot (role + accessible-name tree). Call this BEFORE actuating to get the exact role+name to pass to the *_control tools.',\n      inputSchema: {},\n    },\n    () => guard(() => c.snapshot()),\n  );\n\n  server.registerTool(\n    'click_control',\n    {\n      description:\n        'Click a control by a GROUNDED target read off the snapshot (role+name preferred → testId → text). Grounded so the saved spec replays exactly what you did.',\n      inputSchema: GROUND,\n    },\n    (g) => guard(() => c.click(g)),\n  );\n\n  server.registerTool(\n    'fill_control',\n    { description: 'Type a value into a textbox/field by a grounded target.', inputSchema: { ...GROUND, value: z.string() } },\n    ({ value, ...g }) => guard(() => c.fill(g, value)),\n  );\n\n  server.registerTool(\n    'select_control',\n    { description: 'Choose an option in a <select> by a grounded target.', inputSchema: { ...GROUND, value: z.string() } },\n    ({ value, ...g }) => guard(() => c.select(g, value)),\n  );\n\n  server.registerTool(\n    'check_control',\n    {\n      description: 'Check or uncheck a checkbox/radio by a grounded target (handles sr-only / hidden inputs).',\n      inputSchema: { ...GROUND, checked: z.boolean().optional().describe('true (default) = check; false = uncheck.') },\n    },\n    ({ checked, ...g }) => guard(() => c.check(g, checked !== false)),\n  );\n\n  server.registerTool(\n    'assert_visible',\n    {\n      description: 'Assert a control/text is visible now — captures an expect(...).toBeVisible() into the saved spec.',\n      inputSchema: GROUND,\n    },\n    (g) => guard(() => c.assertVisible(g)),\n  );\n\n  server.registerTool(\n    'recall_business_knowledge',\n    {\n      description:\n        'Recall what earlier Hover runs learned about this app (business rules, expected behaviors, access policies). Call this at the START so you do not re-ask settled questions. Treat what it returns as ground truth.',\n      inputSchema: {},\n    },\n    () => guard(() => c.recall()),\n  );\n\n  server.registerTool(\n    'record_fact',\n    {\n      description:\n        \"Remember a durable BUSINESS RULE about this app so neither you nor a future run re-asks it — e.g. an expected behavior, a validation rule, an access policy, or the answer to a 'bug or by-design?' the user just confirmed. State it as a clean self-contained rule. RULES ONLY — never store secrets, passwords, tokens, or personal data.\",\n      inputSchema: {\n        title: z.string().describe('Short title for the rule (becomes its memory filename + index entry).'),\n        rule: z.string().describe('The rule itself, stated clearly and self-contained (no secrets/PII).'),\n        type: z\n          .enum(['business-rule', 'expected-behavior', 'validation', 'access-policy'])\n          .optional()\n          .describe('What kind of knowledge this is. Defaults to business-rule.'),\n      },\n    },\n    ({ title, rule, type }) => guard(() => c.recordFact(title, rule, type ?? 'business-rule')),\n  );\n\n  server.registerTool(\n    'crystallize_spec',\n    {\n      description:\n        'Save the flow you JUST performed (the grounded click/fill/select/check/assert actions since the last crystallize) as a plain Playwright .spec.ts in __vibe_tests__/. Call it the moment you finish a coherent end-to-end flow. Name it in English, imperative (e.g. \"Log in\").',\n      inputSchema: {\n        name: z.string().describe('Short imperative flow name in English — becomes the spec filename + test name.'),\n        description: z.string().optional().describe('One line on what this flow verifies.'),\n      },\n    },\n    ({ name, description }) => guard(() => c.crystallize(name, description)),\n  );\n\n  // The workflow ships WITH the server as an MCP prompt — Claude Code surfaces\n  // it as `/mcp__hover__test_app`, so adding the server brings both the tools\n  // AND the command. No project scaffolding needed.\n  server.registerPrompt(\n    'test_app',\n    {\n      title: 'Hover — map & crystallize a test suite',\n      description: 'Map this app\\'s business lines and crystallize a Playwright suite (incremental, scales to large apps).',\n      argsSchema: { scope: z.string().optional().describe('An area/flow to focus on. Omit to cover the whole app.') },\n    },\n    ({ scope }) => ({\n      messages: [{ role: 'user', content: { type: 'text', text: workflowPrompt(scope) } }],\n    }),\n  );\n\n  return server;\n}\n\n/** The phased, scale-aware workflow, delivered as the prompt body. Mirrors the\n *  hover-mcp tool surface; the agent's own file tools do the code-reading. */\nfunction workflowPrompt(scope?: string): string {\n  const target = scope?.trim() ? scope.trim() : 'the whole app';\n  return `Build (or extend) a Playwright test suite for this web app using the **Hover MCP tools**.\nDrive the browser ONLY through these tools — they actuate via grounded selectors\n(role+name → testId → text), so every spec you save replays EXACTLY what you did\n(record==replay). Never write spec files yourself; only \\`crystallize_spec\\` does.\n\nTools: \\`recall_business_knowledge\\` · \\`browser_navigate\\` · \\`browser_snapshot\\` (ARIA\ntree — read before acting) · \\`click_control\\` / \\`fill_control\\` / \\`select_control\\` /\n\\`check_control\\` (grounded target from the snapshot) · \\`assert_visible\\` ·\n\\`record_fact\\` · \\`crystallize_spec(name, description?)\\`.\n\nTarget: the app at HOVER_TARGET (set in the server's env). Scope: ${target}.\n\nWork in PHASES — this is what lets it scale from a tiny app to a large one.\n\n## Phase 1 — Map the business lines (read the CODE, don't click around)\n- FIRST call \\`recall_business_knowledge\\` — rules earlier runs learned (and read \\`.hover/hover-map.md\\` if it exists, the running map; CONTINUE it, don't start over). Treat both as ground truth; don't re-ask what they already answer.\n- Use YOUR OWN file tools (read / grep / glob) to find the app's ROUTES + navigation: the router config, route/page files, the nav components. Enumerate the user-facing BUSINESS LINES (a coherent task a user performs), each with its entry route, grouped by area. Reading code is cheaper + more complete than clicking around, and finds areas behind auth / nav you'd otherwise miss.\n- Write/update \\`.hover/hover-map.md\\` as a checklist (4-space indent = a code block):\n\n        # Business map — <app>\n        ## Auth\n        - [ ] Log in — /login\n        - [x] Checkout — /checkout — checkout.spec.ts\n\n- Don't test yet. For a large app, this map IS the plan.\n\n## Phase 2 — Pick the scope\n- If a scope was given, cover that. Otherwise show the uncovered lines and ask which to cover now (offer \"all uncovered\"). For a small app, just cover them all.\n\n## Phase 3 — Cover each chosen line, ONE AT A TIME\nFor each line: \\`browser_navigate\\` to its route → \\`browser_snapshot\\` → EXERCISE the real flow (click / fill / select / check — you are a tester, never just describe the page) → \\`assert_visible\\` on the OUTCOME (a success message, the new row, the next screen) → \\`crystallize_spec(\"<short imperative English name>\")\\`. Crystallize the MOMENT each flow is done, before the next — the buffer is per-flow. The tools share ONE browser, so cover lines SEQUENTIALLY.\n\n## Phase 4 — Update coverage\n- Mark each covered line \\`[x]\\` in \\`.hover/hover-map.md\\` with its spec filename. Report covered vs still-open. A LARGE app doesn't have to finish in one go — covering a batch + updating the map is a complete, resumable unit; re-invoke to continue the uncovered lines.\n\n## Understand the business — ASK, then REMEMBER\nWhen you genuinely can't resolve something on your own — is this a bug or by-design? which flows matter? what does this domain term mean? — ASK the user (don't guess, don't stop). When they confirm a durable business RULE, call \\`record_fact\\` to persist it (RULES ONLY — never credentials/secrets/PII). Also ASK when blocked on something only they can provide (login credentials, a file). Stay on the app under test — never navigate to external origins.`;\n}\n"],"mappings":"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","names":["server","ctx"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@hover-dev/mcp",
+  "version": "0.17.0",
+  "description": "Hover MCP server — grounded browser actuation + crystallize a Playwright suite, for your own coding agent",
+  "license": "Apache-2.0",
+  "author": "Hyperyond",
+  "homepage": "https://github.com/Hyperyond/Hover#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hyperyond/Hover.git",
+    "directory": "packages/mcp"
+  },
+  "keywords": [
+    "hover",
+    "mcp",
+    "playwright",
+    "browser-testing",
+    "claude",
+    "model-context-protocol"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "bin": {
+    "hover-mcp": "./dist/mcp.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "playwright-core": "^1.50.0",
+    "zod": "^4.4.3",
+    "@hover-dev/core": "0.17.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}