@sightmap/mcp 0.5.1 → 0.6.0

package/README.md

@@ -57,6 +57,18 @@ Walks an author through writing a Sightmap Enhancement Proposal (SEP), the match
 
 **Why this exists:** SEPs require coordinated edits across three trees (`seps/`, `spec/`, `conformance/`). The track encodes the order, the dependencies, and the user check-in points so neither the author nor the agent can short-circuit them. Pattern adapted from Archcore's `architecture_track`.
 
+## Running curation-only (no browser)
+
+If you're integrating with a tool that already drives the browser
+(Subtext, agent-browser, or a custom harness), you only need sightmap's
+curation surface — not its Playwright wrapping. Spawn with `--curate-only`:
+
+    sightmap-mcp --sightmap-dir .sightmap --curate-only
+
+Only the `sightmap_list_views`, `sightmap_get_view`, `sightmap_update_view`,
+`sightmap_check`, `sightmap_init_project`, and `sightmap_match` tools are
+registered. No `@playwright/mcp` subprocess is launched.
+
 ## Usage
 
 ```sh
@@ -73,6 +85,8 @@ sightmap-mcp \
                           Default: .sightmap
 --curate-root <path>      Writable .sightmap/ for curation tools.
                           Default: the first --sightmap-dir.
+--curate-only             Register only curation tools; do not spawn
+                          an upstream browser MCP.
 --upstream-command <cmd>  Command to spawn the upstream MCP server. Default: npx
 -- <args...>              Args for the upstream command.
                           Default: -y @playwright/mcp@latest

package/dist/cli.js

@@ -54,7 +54,11 @@ import { readFileSync, realpathSync } from "fs";
 import { fileURLToPath } from "url";
 
 // src/server.ts
-import { match as sightmapMatch4 } from "@sightmap/sightmap";
+import {
+  match as sightmapMatch2,
+  resolveSightmapAct,
+  buildInPageEvalFunction
+} from "@sightmap/sightmap";
 
 // src/tools/match.ts
 import { match as sightmapMatch } from "@sightmap/sightmap";
@@ -87,72 +91,20 @@ function handleSightmapMatch(sightmap, input) {
 }
 
 // src/tools/snapshot.ts
-import { match as sightmapMatch2 } from "@sightmap/sightmap";
+import {
+  enrichSnapshot
+} from "@sightmap/sightmap";
 function buildSightmapSnapshotResponse(opts) {
-  const { sightmap, currentUrl, ariaSnapshotText, inPageMatches } = opts;
-  const result = sightmapMatch2(sightmap, { url: currentUrl });
-  const inPageByName = /* @__PURE__ */ new Map();
-  for (const m of inPageMatches) inPageByName.set(m.name, m);
-  const components = result.components.map((c) => {
-    const inPage = inPageByName.get(c.name);
-    return {
-      name: c.name,
-      selector: c.selector,
-      memory: c.memory ?? [],
-      scope: c.scope,
-      matchCount: inPage?.matchCount ?? 0,
-      ...inPage?.samplePosition !== void 0 ? { samplePosition: inPage.samplePosition } : {}
-    };
+  const enriched = enrichSnapshot({
+    sightmap: opts.sightmap,
+    currentUrl: opts.currentUrl,
+    inPageMatches: opts.inPageMatches
   });
-  return {
-    view: result.view ? {
-      name: result.view.name,
-      route: result.view.route,
-      memory: result.view.memory ?? []
-    } : null,
-    components,
-    memory: result.memory ?? [],
-    ariaSnapshot: ariaSnapshotText
-  };
-}
-
-// src/tools/act.ts
-function resolveSightmapAct(sightmap, input) {
-  const found = findComponentByName(sightmap, input.componentName);
-  if (found === null) {
-    return {
-      kind: "error",
-      message: `Component "${input.componentName}" not found in the loaded sightmap.`
-    };
-  }
-  const selectors = Array.isArray(found.selector) ? found.selector : [];
-  if (selectors.length === 0) {
-    return {
-      kind: "error",
-      message: `Component "${input.componentName}" has no selector \u2014 cannot dispatch an action.`
-    };
-  }
-  return {
-    kind: "ok",
-    componentName: input.componentName,
-    selector: selectors[0],
-    allSelectors: selectors
-  };
-}
-function findComponentByName(sightmap, name) {
-  for (const c of sightmap.globalComponents) {
-    if (c.name === name) return c;
-  }
-  for (const v of sightmap.views) {
-    for (const c of v.components ?? []) {
-      if (c.name === name) return c;
-    }
-  }
-  return null;
+  return { ...enriched, ariaSnapshot: opts.ariaSnapshotText };
 }
 
 // src/tools/network.ts
-import { match as sightmapMatch3 } from "@sightmap/sightmap";
+import { annotateNetworkRequests } from "@sightmap/sightmap";
 function parseNetworkRequestsText(text) {
   const lines = text.split(/\r?\n/);
   const requests = [];
@@ -169,18 +121,6 @@ function parseNetworkRequestsText(text) {
   }
   return requests;
 }
-function annotateNetworkRequests(sightmap, requests) {
-  return requests.map((req) => {
-    const result = sightmapMatch3(sightmap, { url: req.url, method: req.method });
-    const first = result.requests[0];
-    if (first === void 0) return req;
-    const annotated = { ...req, sightmapName: first.name };
-    if (first.memory && first.memory.length > 0) {
-      annotated.sightmapMemory = first.memory;
-    }
-    return annotated;
-  });
-}
 
 // src/tools/curate/list.ts
 function handleListViews(sightmap, input) {
@@ -966,7 +906,7 @@ var SightmapMcpServer = class {
     }
     const ariaSnapshotText = snapResult.content.map((b) => b.text).join("\n");
     const currentUrl = parsePageUrl(ariaSnapshotText) ?? "";
-    const matchResult = sightmapMatch4(this.sightmap, { url: currentUrl });
+    const matchResult = sightmapMatch2(this.sightmap, { url: currentUrl });
     const componentSelectors = matchResult.components.map((c) => ({
       name: c.name,
       selector: c.selector
@@ -1110,43 +1050,6 @@ function parsePageUrl(text) {
   const m = /Page URL:\s*(\S+)/.exec(text);
   return m?.[1] ?? null;
 }
-function buildInPageEvalFunction(components) {
-  const componentsJson = JSON.stringify(components);
-  return `() => {
-    const components = ${componentsJson};
-    const matches = components.map((c) => {
-      const selectors = c.selector || [];
-      const seen = new Set();
-      const elements = [];
-      for (const sel of selectors) {
-        try {
-          const found = document.querySelectorAll(sel);
-          for (const el of Array.from(found)) {
-            if (!seen.has(el)) {
-              seen.add(el);
-              elements.push(el);
-            }
-          }
-        } catch {
-          // Invalid selector \u2014 skip silently.
-        }
-      }
-      const first = elements[0];
-      let samplePosition;
-      if (first && typeof first.getBoundingClientRect === "function") {
-        const r = first.getBoundingClientRect();
-        samplePosition = { x: r.x, y: r.y, width: r.width, height: r.height };
-      }
-      return {
-        name: c.name,
-        selector: selectors,
-        matchCount: elements.length,
-        samplePosition,
-      };
-    });
-    return { url: window.location.href, matches };
-  }`;
-}
 function parseInPageEvalResult(text) {
   const afterResult = text.split(/^###\s*Result/im)[1] ?? text;
   const start = afterResult.indexOf("{");