@wibeco/bridge 0.2.10 → 0.2.14

package/dist/{chunk-ODX3HMDN.js → chunk-7LWUGOKM.js}

@@ -19,15 +19,71 @@ import {
   startPresenceSession,
   stopPresenceSession,
   updatePresenceSession
-} from "./chunk-FIT6PBBW.js";
+} from "./chunk-K7TK7FHF.js";
 
 // src/cli/commands.ts
 import { access, cp, mkdir, readFile, writeFile } from "fs/promises";
 import { homedir, hostname } from "os";
-import { join, resolve } from "path";
+import { basename, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { execFile } from "child_process";
 var ADAPTERS = ["cursor", "claude-code", "codex"];
+var MAX_SCREENSHOT_BYTES = 5 * 1024 * 1024;
+function screenshotMimeType(bytes) {
+  if ([137, 80, 78, 71, 13, 10, 26, 10].every(
+    (byte, index) => bytes[index] === byte
+  )) {
+    return "image/png";
+  }
+  if (bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255) {
+    return "image/jpeg";
+  }
+  if (new TextDecoder().decode(bytes.slice(0, 4)) === "RIFF" && new TextDecoder().decode(bytes.slice(8, 12)) === "WEBP") {
+    return "image/webp";
+  }
+  return void 0;
+}
+async function uploadProgressScreenshot(screenshotPath, altText, credential, cwd) {
+  try {
+    const resolvedPath = resolve(cwd, screenshotPath);
+    const bytes = await readFile(resolvedPath);
+    if (!bytes.length || bytes.length > MAX_SCREENSHOT_BYTES) {
+      return {
+        warning: "Screenshot skipped: image must be between 1 byte and 5 MB."
+      };
+    }
+    const mimeType = screenshotMimeType(bytes);
+    if (!mimeType) {
+      return {
+        warning: "Screenshot skipped: only PNG, JPEG, and WebP are supported."
+      };
+    }
+    const form = new FormData();
+    form.set(
+      "screenshot",
+      new Blob([new Uint8Array(bytes)], { type: mimeType }),
+      basename(resolvedPath)
+    );
+    form.set("alt_text", altText);
+    const response = await fetch(`${credential.appUrl}/api/artifacts`, {
+      method: "POST",
+      headers: { authorization: `Bearer ${credential.accessToken}` },
+      body: form,
+      signal: AbortSignal.timeout(1e4)
+    });
+    const body = await response.json().catch(() => ({}));
+    if (!response.ok || typeof body.artifact_id !== "string") {
+      return {
+        warning: `Screenshot skipped: ${typeof body.error === "string" ? body.error : `upload failed with status ${response.status}`}.`
+      };
+    }
+    return { artifactId: body.artifact_id };
+  } catch (error) {
+    return {
+      warning: `Screenshot skipped: ${error instanceof Error ? error.message : "upload failed"}.`
+    };
+  }
+}
 async function setupCommand(requestedAdapter, options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const expectedRepository = options.expectedRepository ? normalizeGitHubRepository(options.expectedRepository) : void 0;
@@ -352,6 +408,10 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
   if (title && title.length > 120) {
     throw new Error("Progress title must be 120 characters or fewer.");
   }
+  const screenshotAlt = options.screenshotAlt?.trim() || (title ? `${title} screenshot` : "Agent update screenshot");
+  if (screenshotAlt.length > 240) {
+    throw new Error("Screenshot alt text must be 240 characters or fewer.");
+  }
   const phases = [
     "planning",
     "implementing",
@@ -371,6 +431,12 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
     projectConfig.adapter,
     cwd
   );
+  const screenshot = options.screenshot?.trim() ? await uploadProgressScreenshot(
+    options.screenshot.trim(),
+    screenshotAlt,
+    credential,
+    cwd
+  ) : {};
   const event = createHookEvent({
     source: projectConfig.adapter,
     kind: "progress.shared",
@@ -380,6 +446,7 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
       ...title ? { title } : {},
       ...options.phase ? { phase: options.phase } : {},
       ...options.confidence !== void 0 ? { confidence: options.confidence } : {},
+      ...screenshot.artifactId ? { artifact_id: screenshot.artifactId } : {},
       ...workingTree ? {
         paths: workingTree.paths,
         lines_added: workingTree.linesAdded,
@@ -399,7 +466,7 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
   }).capture(event);
   return {
     exitCode: result.error ? 1 : 0,
-    message: result.error ? `Progress was queued; delivery failed: ${result.error}` : `Shared progress with Wibe; ${result.remaining} event(s) queued.`
+    message: result.error ? `Progress was queued; delivery failed: ${result.error}` : `Shared progress with Wibe; ${result.remaining} event(s) queued.${screenshot.warning ? ` ${screenshot.warning}` : ""}`
   };
 }
 async function doctorCommand(cwd = process.cwd(), requestedRepository) {
@@ -502,7 +569,15 @@ async function installNativeConfigs(adapter, source, cwd, appUrl, projectId) {
   const installed = [];
   for (const [sourceName, destinationName] of files) {
     const destinationPath = join(cwd, destinationName);
-    if (await exists(destinationPath)) continue;
+    const destinationExists = await exists(destinationPath);
+    const isCursorActivityRule = adapter === "cursor" && destinationName === ".cursor/rules/wibe-activity.mdc";
+    if (destinationExists) {
+      if (!isCursorActivityRule) continue;
+      const existingRule = await readFile(destinationPath, "utf8");
+      if (!existingRule.includes("# Wibe activity") || !existingRule.includes("wibe_share_progress")) {
+        continue;
+      }
+    }
     const template = await readFile(join(source, sourceName), "utf8");
     await mkdir(resolve(destinationPath, ".."), { recursive: true });
     await writeFile(

package/dist/{chunk-FIT6PBBW.js → chunk-K7TK7FHF.js}

@@ -389,6 +389,7 @@ function toEnvelope(event, options) {
     paths,
     phase: event.metadata.phase,
     confidence: event.metadata.confidence,
+    artifact_id: typeof event.metadata.artifact_id === "string" ? event.metadata.artifact_id : void 0,
     lines_added: typeof event.metadata.lines_added === "number" ? event.metadata.lines_added : void 0,
     lines_deleted: typeof event.metadata.lines_deleted === "number" ? event.metadata.lines_deleted : void 0
   } : event.kind === "file.changed" ? {
@@ -434,6 +435,7 @@ function toEnvelope(event, options) {
     hook_kind: event.kind
   } : event.kind.startsWith("git.") ? {
     title: event.metadata.title,
+    commit_title: event.metadata.commit_title,
     previous_branch: event.metadata.previous_branch,
     branch: event.repo?.branch,
     previous_commit: event.metadata.previous_commit,
@@ -1139,6 +1141,7 @@ async function observeRepositoryTransitions(source, sessionId, current) {
         kind,
         metadata: {
           title: kind === "git.rebase_completed" ? "Rebased" : kind === "git.merge_completed" ? "Merged" : current.commitTitle || "Committed",
+          ...current.commitTitle ? { commit_title: current.commitTitle } : {},
           previous_commit: previous.commit,
           commit_sha: current.commit,
           paths_known: change.pathsKnown,
@@ -1166,6 +1169,7 @@ async function observeRepositoryTransitions(source, sessionId, current) {
       kind: "git.push_completed",
       metadata: {
         title: `Pushed to ${current.branch ?? "remote"}`,
+        ...current.commitTitle ? { commit_title: current.commitTitle } : {},
         commit_sha: current.commit,
         paths_known: change.pathsKnown,
         paths: change.paths,

package/dist/cli.js

@@ -6,10 +6,10 @@ import {
   setupCommand,
   shareProgressCommand,
   statusCommand
-} from "./chunk-ODX3HMDN.js";
+} from "./chunk-7LWUGOKM.js";
 import {
   runPresenceHeartbeat
-} from "./chunk-FIT6PBBW.js";
+} from "./chunk-K7TK7FHF.js";
 
 // src/cli.ts
 var HELP = `wibe-bridge <command>
@@ -21,7 +21,7 @@ Commands:
         Use --reauthorize only to replace a rejected or revoked device token.
   status
   emit --adapter <name> --event <hook-name>  (JSON payload on stdin)
-  share-progress --summary <20-55 words> [--title <title>] [--phase <phase>] [--confidence <0-1>]
+  share-progress --summary <20-55 words> [--title <title>] [--phase <phase>] [--confidence <0-1>] [--screenshot <path>] [--screenshot-alt <text>]
   doctor [--repository <owner/repo>]`;
 async function main() {
   const [command, ...args] = process.argv.slice(2);
@@ -54,7 +54,9 @@ async function main() {
       summary: option(args, "--summary"),
       title: option(args, "--title"),
       phase: option(args, "--phase"),
-      confidence: confidence === void 0 ? void 0 : Number(confidence)
+      confidence: confidence === void 0 ? void 0 : Number(confidence),
+      screenshot: option(args, "--screenshot"),
+      screenshotAlt: option(args, "--screenshot-alt")
     });
   } else if (command === "_presence-heartbeat") {
     parseAdapter(option(args, "--adapter"));

package/dist/codex-hook.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   emitCommand
-} from "./chunk-ODX3HMDN.js";
-import "./chunk-FIT6PBBW.js";
+} from "./chunk-7LWUGOKM.js";
+import "./chunk-K7TK7FHF.js";
 
 // src/codex-hook.ts
 async function main() {

package/dist/index.js

@@ -33,7 +33,7 @@ import {
   startPresenceSession,
   stopPresenceSession,
   updatePresenceSession
-} from "./chunk-FIT6PBBW.js";
+} from "./chunk-K7TK7FHF.js";
 export {
   JsonFileOfflineQueue,
   MemoryOfflineQueue,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wibeco/bridge",
-  "version": "0.2.10",
+  "version": "0.2.14",
   "description": "Privacy-first live activity bridge for Cursor, Claude Code, and Codex.",
   "repository": {
     "type": "git",
@@ -28,7 +28,7 @@
   ],
   "scripts": {
     "build": "node scripts/copy-templates.mjs && tsup src/index.ts src/cli.ts src/codex-hook.ts --format esm --target node20 --dts --clean --tsconfig tsconfig.json",
-    "prepack": "npm run build",
+    "prepack": "npm run build 1>&2",
     "test": "vitest run test --config vitest.config.ts"
   },
   "dependencies": {

package/templates/cursor/wibe-activity.mdc.example

@@ -7,7 +7,11 @@ alwaysApply: true
 
 - This repository is connected to Wibe project `${WIBE_PROJECT_ID}`.
 - For most tasks, publish one update only after the requested outcome is complete. Do not publish plans, routine progress, or separate updates for editing, testing, committing, or pushing.
-- Use `wibe_share_progress` with phase `shipped` at completion. Publish earlier only with phase `blocked` when a material blocker leaves the task unfinished.
+- For text-only outcomes, use `wibe_share_progress` with phase `shipped` at completion. Publish earlier only with phase `blocked` when a material blocker leaves the task unfinished.
 - Write one self-contained paragraph of 20–55 words in past tense. Lead with what now works, then explain the user or team impact and meaningful validation. Mention important limitations when present.
 - Describe the outcome, not the agent’s process. Never include first-person narration, prompts, source code, secrets, raw commands, routine tool calls, filenames, line counts, praise, hype, or speculation; Wibe displays code and file changes separately.
+- Bias frontend outcomes toward visual evidence without asking for per-task approval. For UI components, pages, styling, responsive behavior, interactions, and visual fixes, attach one screenshot when the app or preview is already runnable. Prefer a screenshot already made during visual QA; otherwise capture the clearest final state.
+- Frame screenshots around the feature, not the whole application. Use the browser snapshot to identify the smallest element that contains the changed component and the context needed to understand it, then call `browser_take_screenshot` with that element’s `ref` and a descriptive `element` name. Include the trigger with an open menu, popover, or dialog when practical. Use viewport or full-page screenshots only for page-wide work, and reject captures dominated by blank space.
+- Skip screenshots for backend, infrastructure, documentation, refactors, and non-visual frontend logic. Never launch or repair an app solely for Wibe, and omit the image when navigation needs manual authentication, the state contains sensitive data, visual validation is blocked, or the project has visual updates disabled.
+- When a screenshot is available, do not call `wibe_share_progress`. Instead run `npx --yes --package @wibeco/bridge@latest wibe share-progress --summary "<summary>" --phase <shipped|blocked> --screenshot "<path>"` so the local bridge uploads the image and publishes the outcome together.
 - If the Wibe MCP tool is unavailable, run `npx --yes --package @wibeco/bridge@latest wibe share-progress --summary "<summary>" --phase <shipped|blocked>`.