aihand 0.1.0 → 0.1.1

package/README.md

@@ -22,6 +22,22 @@ The bottleneck in agentic coding isn't the model — it's the **round-trips**. E
 
 It's fully self-contained — a static code-analysis engine (tree-sitter) and a runtime browser probe + AST refactorer (ts-morph), both vendored in. No peer tools to install.
 
+## vs. Playwright (in an agent loop)
+
+The engine isn't the bottleneck — `page.evaluate` is ~0–1ms, CDP ~0.3ms, an HTTP curl ~7ms. Playwright's engine is just as fast. What costs ~11s is **every agent round-trip** (read the last result, think, emit the next call). So the only number that matters is *how many round-trips the tool forces*.
+
+Same task — *open a page → see it → click a link → know where it went* — measured same machine, same site, browser already warm:
+
+| metric | aihand | Playwright MCP |
+|---|---|---|
+| agent round-trips | **2** | **4** |
+| round-trip time (~11s each) | ~22s | ~44s |
+| **full-chain wall-clock** | **~24s** | **~46s** — **~2× slower** |
+
+Playwright needs 4 because its tools were built for human scripts: `open` returns `{title,url}` (no page), so you must `snapshot` to get a clickable `ref`; `click` returns `{clicked:"e2"}` (no result), so you must `snapshot` *again* to learn you navigated. aihand fuses each: `open` returns the page (semantic tree + addressable knobs), and `click` returns the delta (`navigated: from → to` + the new page) — see-and-act in one round each.
+
+And when the steps are known up front (login `fill→fill→click`, search `fill→press`), `POST /chain` collapses an N-step sequence into **one round-trip** — Playwright pays one per step. The win scales with round-trips, not milliseconds.
+
 ## Install
 
 ```sh

package/dist/{cli-FDS2C2CZ.cjs → cli-3J7EYI6G.cjs}

@@ -59,8 +59,8 @@ var _webtreesitter = require('web-tree-sitter');
 // package.json
 var package_default = {
   name: "aihand",
-  version: "0.1.0",
-  description: "The hand of AI \u2014 read code, drive the live UI, and refactor source from one CLI (fuses repodex + aipeek + AST refactor)",
+  version: "0.1.1",
+  description: "The hand of AI \u2014 read code, drive the live UI (and any website), and refactor source, from one CLI",
   type: "module",
   main: "./dist/index.cjs",
   module: "./dist/index.js",

package/dist/{cli-HHRGYPSM.js → cli-FIJLKAGI.js}

@@ -57,8 +57,8 @@ import { Parser } from "web-tree-sitter";
 // package.json
 var package_default = {
   name: "aihand",
-  version: "0.1.0",
-  description: "The hand of AI \u2014 read code, drive the live UI, and refactor source from one CLI (fuses repodex + aipeek + AST refactor)",
+  version: "0.1.1",
+  description: "The hand of AI \u2014 read code, drive the live UI (and any website), and refactor source, from one CLI",
   type: "module",
   main: "./dist/index.cjs",
   module: "./dist/index.js",

package/dist/cli.cjs

@@ -53,7 +53,7 @@ async function main() {
       refuse("refactor");
     if (mod === "read" && !config.read.enabled)
       refuse("read");
-    const { runCli } = await Promise.resolve().then(() => _interopRequireWildcard(require("./cli-FDS2C2CZ.cjs")));
+    const { runCli } = await Promise.resolve().then(() => _interopRequireWildcard(require("./cli-3J7EYI6G.cjs")));
     await runCli(rest);
     return;
   }

package/dist/cli.js

@@ -53,7 +53,7 @@ async function main() {
       refuse("refactor");
     if (mod === "read" && !config.read.enabled)
       refuse("read");
-    const { runCli } = await import("./cli-HHRGYPSM.js");
+    const { runCli } = await import("./cli-FIJLKAGI.js");
     await runCli(rest);
     return;
   }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "aihand",
-    "version": "0.1.0",
-    "description": "The hand of AI — read code, drive the live UI, and refactor source from one CLI (fuses repodex + aipeek + AST refactor)",
+    "version": "0.1.1",
+    "description": "The hand of AI — read code, drive the live UI (and any website), and refactor source, from one CLI",
     "type": "module",
     "main": "./dist/index.cjs",
     "module": "./dist/index.js",