vibeview 0.9.0 → 0.10.1

package/README.md

@@ -95,6 +95,7 @@ Output formats: `human`, `json`, and `junit` for any CI system. The exit code re
 | `vibeview agent-setup` | Make VibeView discoverable to your coding agent (skill + MCP) |
 | `vibeview mcp` | Run the MCP server so an agent can drive the device |
 | `vibeview ui-tree` | The current screen's elements, each with a ref to act on |
+| `vibeview logs` | Recent app logs from the device (console output, errors, crashes) |
 | `vibeview screenshot` | Capture the screen to a PNG |
 | `vibeview tap` / `type` / `scroll` / `press` | Drive the device |
 | `vibeview scroll-to` / `drag` / `alert` / `find` | Search, precise gestures, iOS system alerts |

package/dist/{chunk-WG2XR45H.js → chunk-NA3JOV5Z.js}

@@ -495,6 +495,8 @@ function fail(opts, message, code) {
 
 // src/commands/dev.ts
 import { spawn as spawn3 } from "child_process";
+import { createWriteStream, mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname4 } from "path";
 import { createInterface as createInterface3 } from "readline";
 import { select as select3 } from "@inquirer/prompts";
 import chalk2 from "chalk";
@@ -676,6 +678,9 @@ var STATE_FILE2 = "metro-state.json";
 function statePath2(cwd) {
   return join5(cwd, STATE_DIR2, STATE_FILE2);
 }
+function metroLogPath(cwd) {
+  return join5(cwd, STATE_DIR2, "metro.log");
+}
 function isPidAlive2(pid) {
   try {
     process.kill(pid, 0);
@@ -720,6 +725,11 @@ function killOwnedMetro(cwd) {
 
 // src/lib/metro-manager.ts
 var TAIL_LINES2 = 20;
+var METRO_ECHO_RE = /error|failed|unable to|exception|bundled |bundling failed/i;
+function shouldEchoMetroLine(line, debug) {
+  if (debug) return true;
+  return METRO_ECHO_RE.test(line);
+}
 async function ensureMetro(cwd, metro, log, timeoutMs = 9e4) {
   const warnings = [];
   const status = await checkMetro(metro.port);
@@ -1151,6 +1161,18 @@ async function runDevInProcess(opts) {
   const metroPort = cfg.metroPort ?? 8081;
   let metroResult;
   try {
+    let metroLogStream = null;
+    const captureMetroLine = (line) => {
+      try {
+        if (!metroLogStream) {
+          mkdirSync3(dirname4(metroLogPath(process.cwd())), { recursive: true });
+          metroLogStream = createWriteStream(metroLogPath(process.cwd()), { flags: "w" });
+        }
+        metroLogStream.write(line.replace(/^\[metro\] /, "") + "\n");
+      } catch {
+      }
+      if (shouldEchoMetroLine(line, opts.debug === true)) console.error(chalk2.dim(line));
+    };
     metroResult = await ensureMetro(
       process.cwd(),
       {
@@ -1158,7 +1180,7 @@ async function runDevInProcess(opts) {
         port: metroPort,
         platformHasOverride: cfg.platformHasMetroOverride
       },
-      (line) => console.error(chalk2.dim(line))
+      captureMetroLine
     );
   } catch (err) {
     const message = err.message;
@@ -1169,6 +1191,9 @@ async function runDevInProcess(opts) {
   for (const w of metroResult.warnings) console.error(chalk2.yellow(`\u26A0 ${w}`));
   if (metroResult.status === "spawned" || metroResult.status === "respawned") {
     console.error(chalk2.green(`\u2713 started Metro (${cfg.metroCommand})`));
+    console.error(
+      chalk2.dim(`  full Metro output: ${metroLogPath(process.cwd())} (--debug echoes it here)`)
+    );
   }
   const metroOwnedThisRun = metroResult.status === "spawned" || metroResult.status === "respawned";
   console.error(chalk2.dim(`Starting a ${cfg.platform} dev session for ${cfg.appId}...`));
@@ -1352,6 +1377,28 @@ var AGENT_COMMANDS = [
     mutating: false,
     params: []
   },
+  {
+    verb: "logs",
+    tool: "logs",
+    summary: "Read recent app logs from the device \u2014 JS console output, native errors, and crash messages from the app under test (not full system logs). Check after a crash, a frozen screen, or an unexpected blank tree, and to confirm an expected log line fired. Pass the previous response's cursor as --since to get only lines that arrived after it.",
+    mutating: false,
+    params: [
+      {
+        name: "tail",
+        cli: "--tail",
+        type: "number",
+        required: false,
+        description: "Maximum lines to return, newest kept (default 100, max 500)."
+      },
+      {
+        name: "since",
+        cli: "--since",
+        type: "number",
+        required: false,
+        description: "Only lines newer than this cursor (use the previous response's `cursor` value)."
+      }
+    ]
+  },
   {
     verb: "screenshot",
     tool: "screenshot",
@@ -1749,6 +1796,20 @@ function resultLines(result) {
   if (!result || typeof result !== "object") return [];
   const r = result;
   const lines = [];
+  if (Array.isArray(r.entries) && typeof r.cursor === "number") {
+    if (r.entries.length === 0) {
+      lines.push(chalk3.dim("(no log lines)"));
+    }
+    for (const e of r.entries) {
+      if (!e || typeof e !== "object") continue;
+      const entry = e;
+      const ts = typeof entry.timestamp === "number" ? new Date(entry.timestamp).toISOString().slice(11, 23) : "??:??:??.???";
+      const level = typeof entry.level === "string" ? entry.level : "info";
+      const levelTag = level === "error" ? chalk3.red(level) : level === "warn" ? chalk3.yellow(level) : chalk3.dim(level);
+      lines.push(`${chalk3.dim(ts)} ${levelTag} ${String(entry.message ?? "")}`);
+    }
+    lines.push(chalk3.dim(`cursor: ${r.cursor}`));
+  }
   if (r.found === true && typeof r.ref === "string" && r.ref) {
     let found = `found: @${r.ref}`;
     if (typeof r.text === "string" && r.text) found += ` ${JSON.stringify(r.text)}`;

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-WG2XR45H.js";
+} from "./chunk-NA3JOV5Z.js";
 import {
   ApiClient,
   EXIT_INFRA_ERROR,
@@ -1448,7 +1448,7 @@ program.command("dev-stop").description("Stop a `vibeview dev --detach` session
 program.command("mcp").description(
   "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop as tools"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
-  const { runMcpServer } = await import("./server-S3D724K3.js");
+  const { runMcpServer } = await import("./server-B2PDQJLR.js");
   await runMcpServer(opts);
 });
 program.command("agent-setup").description(

package/dist/{server-S3D724K3.js → server-B2PDQJLR.js}

@@ -10,7 +10,7 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-WG2XR45H.js";
+} from "./chunk-NA3JOV5Z.js";
 import {
   ApiClient,
   resolveAuth

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "description": "VibeView CLI -- run mobile tests from CI/CD pipelines",
   "type": "module",
   "bin": {

package/skills/vibeview-agent/SKILL.md

@@ -50,6 +50,11 @@ https://vibeview.io/docs/preparing-your-build.
    fires once the session accepts commands (device up, app installed) —
    no need to poll `dev-status` first. If the app ships no native changes
    since the last run, skip step 1 and just do steps 2–4.
+5. **Immediately tell the developer the session `url`** — "watch or take
+   over at any time: `<url>`". The page is a live, fully interactive view
+   of the device; the developer watching along is a feature, not a risk.
+   (For a session you attached to with `--session` instead of starting,
+   the page is `https://vibeview.io/sandbox/<session_id>`.)
 
 Running `dev` writes two things into the project root: a `.vibeview/`
 directory (live session state — local machine state, never commit) and a
@@ -103,6 +108,17 @@ it rather than letting it appear unexplained in their `git status`.
   way you will ever see the screen. It costs a lot of context, so use it
   when appearance matters — not to confirm a tap landed, which the
   response's observation already tells you.
+- **When something breaks — a crash, a frozen screen, an unexpectedly empty
+  tree — read the app logs before guessing.** `logs` returns the app's own
+  output from the device: JS console lines, native errors, and crash
+  messages (not full system logs, and not Metro's terminal — native crashes
+  never appear there). The response ends with a `cursor`; pass it back as
+  `--since` to see only lines that arrived after your last read, which is
+  the natural loop for "did my action log what I expected".
+  ```bash
+  vibeview logs --session <id>                 # recent lines (default 100)
+  vibeview logs --since 42 --session <id>      # only lines after cursor 42
+  ```
 - **Off-screen elements**: use `scroll-to <text>` rather than repeating
   `scroll down`. It scrolls until an element whose label, value, or
   accessibility id contains that text is visible, and stops early when the
@@ -139,7 +155,26 @@ it rather than letting it appear unexplained in their `git status`.
   focus directly with `tap-focused` (moves focus AND activates) / `focus`
   (moves focus only, no activation).
 
-## 4. Cleanup
+## 4. When only a human can act — stop and hand off
+
+Some screens need things you must never guess or invent: **login
+credentials, 2FA/OTP codes, CAPTCHAs, destructive confirmations
+("Delete account?"), anything payment- or real-account-shaped.** When you
+hit one:
+
+1. **Stop driving.** Do not type guessed credentials, do not tap through a
+   destructive confirmation to "see what happens".
+2. **Ask the developer, naming exactly what you need and where**: "I'm at
+   the login screen — please sign in at `<session url>` and tell me when
+   you're done." The session page is fully interactive; the developer can
+   drive the device directly while you wait.
+3. **On resume, run `ui-tree` FIRST** — the human just changed the screen,
+   so every ref you held is stale — and **verify the blocker is actually
+   gone from the tree** (e.g. the login form is absent) instead of trusting
+   the confirmation alone. If it's still there, say what you still see and
+   ask again.
+
+## 5. Cleanup
 
 **Always** stop the session when done verifying — a running session bills
 streaming minutes even when idle:
@@ -147,7 +182,7 @@ streaming minutes even when idle:
 vibeview dev-stop
 ```
 
-## 5. Command reference
+## 6. Command reference
 
 Every verb accepts `--session <id>` to target a specific session (falls
 back to the current project's `vibeview dev --detach` session if omitted)
@@ -157,6 +192,7 @@ human-readable text.
 | Verb | Args | Purpose |
 |------|------|---------|
 | `ui-tree` | — | Fetch the ref-annotated UI tree for the current screen. |
+| `logs` | `[--tail <n>] [--since <cursor>]` | Read recent app logs from the device (JS console, native errors, crash messages). The response's `cursor` feeds the next call's `--since`. |
 | `screenshot` | `[--out <path>]` | Capture a screenshot of the current screen and save it to disk. |
 | `tap` | `<target>` | Tap an element by ref (e.g. `@e5`), or raw coordinates (e.g. `100,200`). |
 | `long-press` | `<ref>` `[--ms <n>]` | Long-press (touch and hold) an element by its ref. |
@@ -182,7 +218,7 @@ Dev-loop lifecycle commands (not registry verbs, but needed for every run):
 | `dev-status` | Check on the current project's detached dev session. |
 | `dev-stop` | End the current project's detached dev session. |
 
-## 6. If you're calling VibeView over MCP
+## 7. If you're calling VibeView over MCP
 
 Everything above is also exposed as MCP tools by `vibeview mcp`, so an agent
 with no shell can run the whole loop. Tool names are the CLI verbs with
@@ -198,7 +234,7 @@ steps the CLI does with plain shell commands:
 | MCP tool | Args | Purpose |
 |----------|------|---------|
 | `upload_app` | `file` (required path), `name` | Upload a debug build. The MCP equivalent of `vibeview upload-app`, so step 1 of the loop needs no shell. Returns the `app_id` to pass to `dev_start`. |
-| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`), `app`, `metro_port` | Start a dev-loop session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`. |
+| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`), `app`, `metro_port` | Start a dev-loop session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`. Returns `page_url` — relay it to the developer immediately, same as step 5 of the loop. |
 | `dev_stop` | — | Stop the session `dev_start` started. The MCP equivalent of `vibeview dev-stop`. |
 
 **`dev_start` is stateful — it changes the default session for every later