@sightmap/mcp 0.8.0 → 0.10.0

package/README.md

@@ -9,29 +9,44 @@ browser-driving agents.
 
 | Tool | Purpose |
 |---|---|
-| `sightmap_match` | Pure-query: matches a URL against the loaded sightmap and returns view, components, requests, and aggregated memory. |
+| `sightmap_match` | Pure-query: matches a URL against the loaded sightmap and returns view, components, requests, and aggregated memory. No browser call. |
 | `sightmap_snapshot` | ARIA snapshot enriched with sightmap awareness (matched view, applicable components with live `matchCount`). |
 | `sightmap_act` | Click / type / hover by sightmap component name; raw `selector` is an escape hatch. |
 | `sightmap_network_requests` | Recent network requests, annotated with sightmap names where the request URL+method matches a sightmap `requests:` entry. |
+| `sightmap_runtime_snapshot` | Capture the live React fiber tree (components, ranked selectors, `data-sightmap` markers, unmarked candidates) for the agent to fold into `.sightmap/`. Three sources via `kind`: `"endpoint"` (fetch a `/__sightmap__/snapshot.json` served by `@sightmap/react`'s Vite plugin), `"browser"` (drive the upstream browser MCP, inject the bippy runtime, and read `window.__sightmap__.snapshot()`), or `"literal"` (accept a pre-captured snapshot from any other harness — e.g. Subtext's `live-eval-script`). |
 
 ### Curation tools
 
-The MCP also exposes a five-tool family for `.sightmap/` authoring:
+The MCP exposes a seven-tool family for `.sightmap/` authoring. The
+`sightmap-assistant` subagent has **full authority** over every view field
+(structural and semantic) via these tools.
 
 | Tool | Purpose |
 |---|---|
 | `sightmap_list_views` | List all views (compact summary by default; pass `detail: "full"` for the entire view). |
 | `sightmap_get_view` | Fetch a single view + its source file path. |
 | `sightmap_check` | Validate the sightmap (`level: "schema"` or `"quality"`; default `"quality"`). |
-| `sightmap_update_view` | Patch a view's agent-authored fields (`description`, `intent`, `memory_append`, `memory_replace`). |
+| `sightmap_add_view` | Create a new view file (full structural + semantic payload). |
+| `sightmap_update_view` | Patch any field on an existing view — `name`, `route`, `components` (incl. per-component `selector`/`memory`), `description`, `intent`, view-level `memory`. |
+| `sightmap_delete_view` | Remove a view file. |
 | `sightmap_init_project` | Scaffold an empty `.sightmap/` in a target project. |
 
 Curation write tools operate on the directory passed via `--curate-root`
 (defaults to the first `--sightmap-dir`).
 
-**Component / route / selector edits are not exposed via MCP** — those are
-codegen-owned. To track a new component, add a `data-sightmap` attribute to
-source and re-run `sightmap-react gen`.
+### Proposal tools (preview)
+
+A three-stage propose / review / commit flow lets a sub-agent gather edits
+in memory, surface them to the main thread for confirmation, and then apply
+them as a batch. Useful for bootstrap and audit-driven fix flows that touch
+multiple views in one turn.
+
+| Tool | Purpose |
+|---|---|
+| `sightmap_propose_view` | Stage a new-view proposal (no write yet). |
+| `sightmap_propose_component` | Stage a new-component proposal against an existing view. |
+| `sightmap_review_proposals` | List currently-staged proposals for the main thread to confirm or discard. |
+| `sightmap_commit_proposals` | Apply the staged proposals via the underlying `add_view` / `update_view` writes. |
 
 ## Prompts
 
@@ -65,9 +80,10 @@ 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.
+In `--curate-only` mode, only the curation tools, proposal tools, and
+`sightmap_match` are registered — every tool that needs an upstream browser
+(the four browser tools above plus `sightmap_runtime_snapshot kind: "browser"`)
+is omitted, and no `@playwright/mcp` subprocess is launched.
 
 ## Usage
 

package/dist/cli.d.ts

@@ -8,5 +8,17 @@ interface CliArgs {
 }
 /** Argv parser. Exposed for unit testing. */
 declare function parseArgv(argv: string[]): CliArgs;
+/**
+ * Write the bippy inject script to a uniquely-named temp directory and return
+ * the path. Returns undefined if the script can't be materialized (e.g., bippy
+ * IIFE missing in dev contexts) — the caller treats that as "skip pre-nav
+ * injection; rely on the post-nav fallback".
+ *
+ * Visible for unit testing.
+ */
+declare function writeInitScriptToTempDir(): Promise<{
+    dir: string;
+    scriptPath: string;
+} | undefined>;
 
-export { parseArgv };
+export { parseArgv, writeInitScriptToTempDir };