@wibeco/bridge 0.2.1 → 0.2.2

package/dist/{chunk-FLTLCZ6E.js → chunk-A7KGZ7NX.js}

@@ -15,6 +15,7 @@ var hookEventKindSchema = z.enum([
   "shell.completed",
   "mcp.started",
   "mcp.completed",
+  "progress.shared",
   "unknown"
 ]);
 var safeScalarSchema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
@@ -328,6 +329,7 @@ function eventTypeForHook(event) {
   if (event.kind === "presence.heartbeat") return "presence.heartbeat";
   if (event.kind === "session.ended") return "presence.stopped";
   if (event.kind === "file.changed") return "workspace.files_changed";
+  if (event.kind === "progress.shared") return "agent.progress_shared";
   if (event.kind === "shell.completed" && event.outcome && isTestHookEvent(event)) {
     return "workspace.test_completed";
   }
@@ -352,7 +354,13 @@ function toEnvelope(event, options) {
     ...Array.isArray(event.metadata.paths) ? event.metadata.paths.filter((path) => typeof path === "string") : [],
     ...typeof event.metadata.path === "string" ? [event.metadata.path] : []
   ];
-  const payload = event.kind === "file.changed" ? {
+  const payload = event.kind === "progress.shared" ? {
+    title: event.metadata.title,
+    summary: event.metadata.summary,
+    paths,
+    phase: event.metadata.phase,
+    confidence: event.metadata.confidence
+  } : event.kind === "file.changed" ? {
     paths,
     tool: event.source,
     agent_name: event.source,
@@ -556,6 +564,7 @@ import { homedir } from "os";
 import { join } from "path";
 var PRESENCE_HEARTBEAT_INTERVAL_MS = 45e3;
 var MAX_SESSION_DURATION_MS = 12 * 60 * 60 * 1e3;
+var MAX_SESSION_LINE_COUNT = 1e7;
 async function startPresenceSession(source, sessionId, cwd = process.cwd()) {
   const statePath = presenceStatePath(source, sessionId, cwd);
   await rm(statePath, { force: true });
@@ -611,11 +620,14 @@ async function updatePresenceSession(source, sessionId, event, cwd = process.cwd
   const state = await readPresenceState(statePath);
   if (!state) return void 0;
   const measuredAt = (/* @__PURE__ */ new Date()).toISOString();
-  accrueModelTime(state, measuredAt);
+  const isHeartbeat = event.kind === "presence.heartbeat";
+  if (!isHeartbeat) accrueModelTime(state, measuredAt);
   const model = typeof event.metadata.model === "string" ? event.metadata.model : void 0;
   if (model) state.model = model;
-  state.linesAdded += safeCount(event.metadata.lines_added);
-  state.linesDeleted += safeCount(event.metadata.lines_deleted);
+  if (!isHeartbeat) {
+    state.linesAdded += safeCount(event.metadata.lines_added);
+    state.linesDeleted += safeCount(event.metadata.lines_deleted);
+  }
   const workingLinesAdded = optionalCount(
     event.metadata.working_tree_lines_added
   );
@@ -624,17 +636,19 @@ async function updatePresenceSession(source, sessionId, event, cwd = process.cwd
   );
   if (workingLinesAdded !== void 0) {
     state.baselineLinesAdded ??= workingLinesAdded;
-    state.linesAdded = Math.max(
-      state.linesAdded,
+    const workingDelta = Math.max(
+      0,
       workingLinesAdded - state.baselineLinesAdded
     );
+    state.linesAdded = isHeartbeat && state.linesAdded > MAX_SESSION_LINE_COUNT ? workingDelta : Math.max(state.linesAdded, workingDelta);
   }
   if (workingLinesDeleted !== void 0) {
     state.baselineLinesDeleted ??= workingLinesDeleted;
-    state.linesDeleted = Math.max(
-      state.linesDeleted,
+    const workingDelta = Math.max(
+      0,
       workingLinesDeleted - state.baselineLinesDeleted
     );
+    state.linesDeleted = isHeartbeat && state.linesDeleted > MAX_SESSION_LINE_COUNT ? workingDelta : Math.max(state.linesDeleted, workingDelta);
   }
   const paths = [
     ...Array.isArray(event.metadata.paths) ? event.metadata.paths.filter(

package/dist/{chunk-YV3UV2XJ.js → chunk-XMEA243L.js}

@@ -17,7 +17,7 @@ import {
   startPresenceSession,
   stopPresenceSession,
   updatePresenceSession
-} from "./chunk-FLTLCZ6E.js";
+} from "./chunk-A7KGZ7NX.js";
 
 // src/cli/commands.ts
 import { access, cp, mkdir, readFile, writeFile } from "fs/promises";
@@ -64,7 +64,8 @@ async function setupCommand(requestedAdapter, options = {}) {
       adapter,
       source,
       cwd,
-      appUrl
+      appUrl,
+      options.projectId
     );
     const heartbeat2 = await sendVerificationHeartbeat(
       existingCredential,
@@ -153,7 +154,8 @@ Confirm code ${authorization.user_code}
     adapter,
     source,
     cwd,
-    appUrl
+    appUrl,
+    token.projectId
   );
   const heartbeat = await sendVerificationHeartbeat(credential, adapter, "setup");
   return {
@@ -235,7 +237,16 @@ async function emitCommand(adapter, eventName, input) {
       mappedEvent.sessionId,
       mappedEvent
     );
-    if (mappedEvent.kind === "presence.heartbeat" && metrics) {
+    if (mappedEvent.kind === "file.changed" && metrics) {
+      mappedEvent = {
+        ...mappedEvent,
+        metadata: {
+          ...mappedEvent.metadata,
+          lines_added: metrics.lines_added,
+          lines_deleted: metrics.lines_deleted
+        }
+      };
+    } else if (mappedEvent.kind === "presence.heartbeat" && metrics) {
       const publicMetadata = { ...mappedEvent.metadata };
       delete publicMetadata.working_tree_paths;
       delete publicMetadata.paths;
@@ -274,6 +285,62 @@ async function emitCommand(adapter, eventName, input) {
     message: result.error ? `Queued ${event.kind}; delivery failed: ${result.error}` : `Delivered ${result.sent} event(s); ${result.remaining} queued.`
   };
 }
+async function shareProgressCommand(options, cwd = process.cwd()) {
+  const projectConfig = await readProjectConfig(
+    join(cwd, ".wibe", "project.json")
+  );
+  const credential = await loadCredential(cwd);
+  if (!projectConfig || !credential) {
+    throw new Error("Wibe is not authorized in this repository. Run wibe setup first.");
+  }
+  const summary = options.summary?.trim() ?? "";
+  const wordCount = summary.split(/\s+/).filter(Boolean).length;
+  if (wordCount < 8 || wordCount > 22 || summary.length > 500) {
+    throw new Error("Progress summary must contain 8\u201322 words.");
+  }
+  const title = options.title?.trim();
+  if (title && title.length > 120) {
+    throw new Error("Progress title must be 120 characters or fewer.");
+  }
+  const phases = [
+    "planning",
+    "implementing",
+    "validating",
+    "blocked",
+    "shipped"
+  ];
+  if (options.phase && !phases.includes(options.phase)) {
+    throw new Error(`Progress phase must be one of: ${phases.join(", ")}.`);
+  }
+  if (options.confidence !== void 0 && (!Number.isFinite(options.confidence) || options.confidence < 0 || options.confidence > 1)) {
+    throw new Error("Progress confidence must be between 0 and 1.");
+  }
+  const repo = await detectRepository(cwd);
+  const event = createHookEvent({
+    source: projectConfig.adapter,
+    kind: "progress.shared",
+    metadata: {
+      summary,
+      ...title ? { title } : {},
+      ...options.phase ? { phase: options.phase } : {},
+      ...options.confidence !== void 0 ? { confidence: options.confidence } : {}
+    },
+    ...repo ? { repo } : {}
+  });
+  const result = await new SignedBatchClient({
+    endpoint: `${credential.appUrl}/api/events/batch`,
+    accessToken: credential.accessToken,
+    organizationId: credential.organizationId,
+    projectId: credential.projectId,
+    repositoryId: credential.repositoryId,
+    deviceId: credential.deviceId,
+    queue: new JsonFileOfflineQueue(queuePath())
+  }).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.`
+  };
+}
 async function doctorCommand(cwd = process.cwd(), requestedRepository) {
   const credential = await loadCredential(cwd);
   const projectConfig = await readProjectConfig(join(cwd, ".wibe", "project.json"));
@@ -293,7 +360,7 @@ async function doctorCommand(cwd = process.cwd(), requestedRepository) {
     adapterError = error instanceof Error ? error.message : String(error);
   }
   const heartbeat = credential && adapter && repositoryMatches ? await sendVerificationHeartbeat(credential, adapter, "doctor") : void 0;
-  const nativeConfig = adapter ? await validateNativeConfigs(adapter, cwd) : { hooks: false, mcp: false };
+  const nativeConfig = adapter ? await validateNativeConfigs(adapter, cwd) : { hooks: false, mcp: false, activityRule: false };
   const checks = [
     ["node", Number(process.versions.node.split(".")[0]) >= 20],
     ["git repository", Boolean(repository)],
@@ -312,6 +379,7 @@ async function doctorCommand(cwd = process.cwd(), requestedRepository) {
     ],
     ["agent hooks configuration", nativeConfig.hooks],
     ["MCP endpoint configuration", nativeConfig.mcp],
+    ["agent activity instructions", nativeConfig.activityRule],
     [
       heartbeat?.error ? `verification heartbeat (${heartbeat.error})` : "verification heartbeat",
       Boolean(heartbeat && !heartbeat.error)
@@ -358,10 +426,11 @@ function openBrowser(url) {
   }
   execFile(executable, args, () => void 0);
 }
-async function installNativeConfigs(adapter, source, cwd, appUrl) {
+async function installNativeConfigs(adapter, source, cwd, appUrl, projectId) {
   const files = adapter === "cursor" ? [
     ["hooks.json.example", ".cursor/hooks.json"],
-    ["mcp.json.example", ".cursor/mcp.json"]
+    ["mcp.json.example", ".cursor/mcp.json"],
+    ["wibe-activity.mdc.example", ".cursor/rules/wibe-activity.mdc"]
   ] : adapter === "claude-code" ? [
     ["settings.json.example", ".claude/settings.json"],
     ["mcp.json.example", ".mcp.json"]
@@ -377,7 +446,7 @@ async function installNativeConfigs(adapter, source, cwd, appUrl) {
     await mkdir(resolve(destinationPath, ".."), { recursive: true });
     await writeFile(
       destinationPath,
-      template.replaceAll("${env:WIBE_APP_URL}", appUrl).replaceAll("${WIBE_APP_URL}", appUrl),
+      template.replaceAll("${env:WIBE_APP_URL}", appUrl).replaceAll("${WIBE_APP_URL}", appUrl).replaceAll("${WIBE_PROJECT_ID}", projectId),
       { mode: 384 }
     );
     installed.push(destinationName);
@@ -408,7 +477,7 @@ async function validateNativeConfigs(adapter, cwd) {
     } catch {
       mcp = false;
     }
-    return { hooks, mcp };
+    return { hooks, mcp, activityRule: true };
   }
   const hookPath = adapter === "cursor" ? join(cwd, ".cursor", "hooks.json") : join(cwd, ".claude", "settings.json");
   const mcpPath = adapter === "cursor" ? join(cwd, ".cursor", "mcp.json") : join(cwd, ".mcp.json");
@@ -418,9 +487,20 @@ async function validateNativeConfigs(adapter, cwd) {
       if (!isRecord(value.mcpServers)) return false;
       const wibe = value.mcpServers.wibe;
       return isRecord(wibe) && typeof wibe.url === "string" && wibe.url.replace(/\/$/, "").endsWith("/api/mcp");
-    })
+    }),
+    activityRule: adapter !== "cursor" || await validText(
+      join(cwd, ".cursor", "rules", "wibe-activity.mdc"),
+      (value) => value.includes("alwaysApply: true") && value.includes("wibe_share_progress") && value.includes("wibe share-progress")
+    )
   };
 }
+async function validText(path, predicate) {
+  try {
+    return predicate(await readFile(path, "utf8"));
+  } catch {
+    return false;
+  }
+}
 async function validJson(path, predicate) {
   try {
     const value = JSON.parse(await readFile(path, "utf8"));
@@ -573,6 +653,7 @@ export {
   setupCommand,
   statusCommand,
   emitCommand,
+  shareProgressCommand,
   doctorCommand,
   parseAdapter
 };

package/dist/cli.js

@@ -4,11 +4,12 @@ import {
   emitCommand,
   parseAdapter,
   setupCommand,
+  shareProgressCommand,
   statusCommand
-} from "./chunk-YV3UV2XJ.js";
+} from "./chunk-XMEA243L.js";
 import {
   runPresenceHeartbeat
-} from "./chunk-FLTLCZ6E.js";
+} from "./chunk-A7KGZ7NX.js";
 
 // src/cli.ts
 var HELP = `wibe-bridge <command>
@@ -20,6 +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 <8-22 words> [--title <title>] [--phase <phase>] [--confidence <0-1>]
   doctor [--repository <owner/repo>]`;
 async function main() {
   const [command, ...args] = process.argv.slice(2);
@@ -46,6 +48,14 @@ async function main() {
     return;
   } else if (command === "doctor") {
     result = await doctorCommand(process.cwd(), option(args, "--repository"));
+  } else if (command === "share-progress") {
+    const confidence = option(args, "--confidence");
+    result = await shareProgressCommand({
+      summary: option(args, "--summary"),
+      title: option(args, "--title"),
+      phase: option(args, "--phase"),
+      confidence: confidence === void 0 ? void 0 : Number(confidence)
+    });
   } else if (command === "_presence-heartbeat") {
     parseAdapter(option(args, "--adapter"));
     const statePath = option(args, "--state");

package/dist/codex-hook.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   emitCommand
-} from "./chunk-YV3UV2XJ.js";
-import "./chunk-FLTLCZ6E.js";
+} from "./chunk-XMEA243L.js";
+import "./chunk-A7KGZ7NX.js";
 
 // src/codex-hook.ts
 async function main() {

package/dist/index.d.ts

@@ -19,6 +19,7 @@ declare const hookEventKindSchema: z.ZodEnum<{
     "shell.completed": "shell.completed";
     "mcp.started": "mcp.started";
     "mcp.completed": "mcp.completed";
+    "progress.shared": "progress.shared";
     unknown: "unknown";
 }>;
 type HookEventKind = z.infer<typeof hookEventKindSchema>;
@@ -48,6 +49,7 @@ declare const canonicalHookEventSchema: z.ZodObject<{
         "shell.completed": "shell.completed";
         "mcp.started": "mcp.started";
         "mcp.completed": "mcp.completed";
+        "progress.shared": "progress.shared";
         unknown: "unknown";
     }>;
     occurredAt: z.ZodString;
@@ -74,7 +76,7 @@ declare function mapClaudeCodeHook(eventName: string, input: unknown): {
     id: string;
     version: 1;
     source: "cursor" | "claude-code" | "codex";
-    kind: "presence.heartbeat" | "session.started" | "session.ended" | "lifecycle.before" | "lifecycle.after" | "tool.started" | "tool.completed" | "file.changed" | "shell.started" | "shell.completed" | "mcp.started" | "mcp.completed" | "unknown";
+    kind: "presence.heartbeat" | "session.started" | "session.ended" | "lifecycle.before" | "lifecycle.after" | "tool.started" | "tool.completed" | "file.changed" | "shell.started" | "shell.completed" | "mcp.started" | "mcp.completed" | "progress.shared" | "unknown";
     occurredAt: string;
     metadata: Record<string, SafeValue>;
     sessionId?: string | undefined;
@@ -92,7 +94,7 @@ declare function mapCodexHook(eventName: string, input: unknown): {
     id: string;
     version: 1;
     source: "cursor" | "claude-code" | "codex";
-    kind: "presence.heartbeat" | "session.started" | "session.ended" | "lifecycle.before" | "lifecycle.after" | "tool.started" | "tool.completed" | "file.changed" | "shell.started" | "shell.completed" | "mcp.started" | "mcp.completed" | "unknown";
+    kind: "presence.heartbeat" | "session.started" | "session.ended" | "lifecycle.before" | "lifecycle.after" | "tool.started" | "tool.completed" | "file.changed" | "shell.started" | "shell.completed" | "mcp.started" | "mcp.completed" | "progress.shared" | "unknown";
     occurredAt: string;
     metadata: Record<string, SafeValue>;
     sessionId?: string | undefined;
@@ -110,7 +112,7 @@ declare function mapCursorHook(eventName: string, input: unknown): {
     id: string;
     version: 1;
     source: "cursor" | "claude-code" | "codex";
-    kind: "presence.heartbeat" | "session.started" | "session.ended" | "lifecycle.before" | "lifecycle.after" | "tool.started" | "tool.completed" | "file.changed" | "shell.started" | "shell.completed" | "mcp.started" | "mcp.completed" | "unknown";
+    kind: "presence.heartbeat" | "session.started" | "session.ended" | "lifecycle.before" | "lifecycle.after" | "tool.started" | "tool.completed" | "file.changed" | "shell.started" | "shell.completed" | "mcp.started" | "mcp.completed" | "progress.shared" | "unknown";
     occurredAt: string;
     metadata: Record<string, SafeValue>;
     sessionId?: string | undefined;
@@ -237,7 +239,7 @@ interface SignedBatchClientOptions {
     batchSize?: number;
     timeoutMs?: number;
 }
-declare function eventTypeForHook(event: CanonicalHookEvent): "presence.heartbeat" | "presence.started" | "presence.stopped" | "workspace.files_changed" | "workspace.test_completed" | null;
+declare function eventTypeForHook(event: CanonicalHookEvent): "presence.heartbeat" | "presence.started" | "presence.stopped" | "workspace.files_changed" | "agent.progress_shared" | "workspace.test_completed" | null;
 interface FlushResult {
     sent: number;
     remaining: number;

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   startPresenceSession,
   stopPresenceSession,
   updatePresenceSession
-} from "./chunk-FLTLCZ6E.js";
+} from "./chunk-A7KGZ7NX.js";
 export {
   JsonFileOfflineQueue,
   MemoryOfflineQueue,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wibeco/bridge",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Privacy-first live activity bridge for Cursor, Claude Code, and Codex.",
   "repository": {
     "type": "git",

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

@@ -0,0 +1,14 @@
+---
+description: Share meaningful coding-agent milestones with Wibe
+alwaysApply: true
+---
+
+# Wibe activity
+
+- This repository is connected to Wibe project `${WIBE_PROJECT_ID}`.
+- After a plan is settled, share it with `wibe_share_plan` when that tool is available.
+- After a meaningful implementation, validation, blocker, or completion milestone, call `wibe_share_progress`.
+- Write one concrete 8–22 word sentence. Use present progressive for active work and past tense for completed work.
+- Mention validation or blockers when material. Never include prompts, source code, secrets, raw commands, praise, hype, or speculation.
+- Do not publish routine tool calls or repeated updates. Wait at least 90 seconds between progress updates unless reporting a blocker or completion.
+- If the Wibe MCP tools are unavailable, run `npx --yes --package @wibeco/bridge@latest wibe share-progress --summary "<summary>" --phase <planning|implementing|validating|blocked|shipped>`.