@agent-flow-board/bridge 0.1.0 → 0.3.0

package/dist/cli.js

@@ -8,6 +8,7 @@
 // agent-flow-board hook claude|antigravity|gemini [event]   one hook event from stdin, one JSON object to stdout
 // agent-flow-board hooks print claude|antigravity|gemini [--org <slug>]   the settings to paste into the tool
 // agent-flow-board git-hook install|uninstall|check          the warn-only post-commit hook
+// agent-flow-board check connect|run|pull|bind|watch|status|doctor|clear|setup|disconnect   browser checks on this machine (see check usage)
 // agent-flow-board mockup push <file.html> --server <url> --org <slug> --item <ref>   upload one mockup file (never queued)
 // agent-flow-board mockup kit <file.html> --server <url> --org <slug> --project <key>   upload the project's kit (colours, fonts, icons)
 // -- DEP-MODULES -- //
@@ -95,6 +96,22 @@ async function belongsToOrg(server, org, token) {
     }
 }
 async function main() {
+    if (cmd === 'check') {
+        // Loaded only here, so the hooks and the MCP forwarder never load the check code or Playwright
+        const { checkMain } = await import('./checks/command.js');
+        const code = await checkMain({
+            args: args.slice(1),
+            store,
+            fetch: fetchImpl,
+            personalToken: (server, org) => tokenFor(server.replace(/\/$/, ''), org, true),
+            log,
+            out: (line) => process.stdout.write(line + '\n')
+        });
+        // A browser or a preview may still hold a handle open: the exit code is what the caller reads, so end now
+        process.exitCode = code;
+        setTimeout(() => process.exit(code), 300).unref();
+        return;
+    }
     if (cmd === 'hook') {
         // A hook prints exactly one JSON object and always exits 0, so it can never break the tool that runs it
         let out = {};
@@ -258,7 +275,7 @@ async function main() {
         return;
     }
     if (cmd !== 'mcp' && cmd !== 'login') {
-        log('Usage: agent-flow-board mcp|login|logout --server <url>, setup --org <slug>, queue list|retry <id>|drop <id>, or mockup push <file.html>');
+        log('Usage: agent-flow-board mcp|login|logout --server <url>, setup --org <slug>, queue list|retry <id>|drop <id>, mockup push <file.html>, or check connect|run|watch|status');
         process.exit(2);
     }
     const server = serverUrl();

package/dist/hooks/adapters.js

@@ -75,7 +75,9 @@ export const claude = {
                     hookEventName: 'SessionStart',
                     additionalContext: a.context ?? '',
                     ...(a.title ? { sessionTitle: a.title } : {})
-                }
+                },
+                // The one line for the person (an older editor status mod), shown once as the conversation starts
+                ...(a.notice ? { systemMessage: a.notice } : {})
             };
         if (event === 'prompt' && a.title)
             return { hookSpecificOutput: { hookEventName: 'UserPromptSubmit', sessionTitle: a.title } };

package/dist/hooks/call.js

@@ -4,6 +4,7 @@ import { createHash } from 'node:crypto';
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { configDir } from '../tokenStore.js';
+import { installedModVersion } from './modVersion.js';
 // -- CONSTANTS -- //
 const TIMEOUT_MS = 4000;
 // -- FUNCTIONS -- //
@@ -57,10 +58,14 @@ export async function callHook(o, event) {
             warnOnce(`the server ${o.server} did not give an organisation for this sign-in.`);
             return null;
         }
+        // A Claude Code start tells the board which editor status mod is installed, so it can say when a newer one is served
+        const modVersion = event.tool === 'claude-code' && event.event === 'start'
+            ? installedModVersion(o.home)
+            : undefined;
         const res = await o.fetch(`${o.server}/api/v1/orgs/${org}/hooks`, {
             method: 'POST',
             headers: { authorization: `Bearer ${o.token}`, 'content-type': 'application/json' },
-            body: JSON.stringify(event),
+            body: JSON.stringify(modVersion ? { ...event, modVersion } : event),
             signal: AbortSignal.timeout(TIMEOUT_MS)
         });
         if (!res.ok)

package/dist/hooks/modVersion.js

@@ -0,0 +1,26 @@
+// THE VERSION OF THE EDITOR STATUS MOD THIS PERSON HAS INSTALLED (AFB-20261108-0856)
+// The setup prompt writes the mod to ~/.claude/skills/afb-flow-status. The hook sends the version on a start so the board can say
+// when a newer one is served. A hook must never fail or slow down because of this file, so every problem means "no version".
+// -- DEP-MODULES -- //
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// -- CONSTANTS -- //
+const MOD_FOLDER = ['.claude', 'skills', 'afb-flow-status'];
+const VERSION = /^\d{1,6}\.\d{1,6}\.\d{1,6}$/;
+/** A manifest is a few hundred bytes: a file far bigger than that is not read. */
+const MAX_BYTES = 64 * 1024;
+// -- FUNCTIONS -- //
+/** The installed mod's plain major.minor.patch version, or undefined when there is no mod, no readable manifest or no plain version. */
+export function installedModVersion(home = homedir()) {
+    try {
+        const text = readFileSync(join(home, ...MOD_FOLDER, '.claude-plugin', 'plugin.json'), 'utf8');
+        if (text.length > MAX_BYTES)
+            return undefined;
+        const version = JSON.parse(text).version;
+        return typeof version === 'string' && VERSION.test(version) ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@agent-flow-board/bridge",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"type": "module",
-	"description": "Local bridge to an agent-flow-board server: forwards MCP calls over stdio, runs the coding tool hooks and writes the editor status. It holds no tool code.",
+	"description": "Local bridge to an agent-flow-board server: forwards MCP calls over stdio, runs the coding tool hooks, writes the editor status and runs browser checks on this machine. It holds no board tool code.",
 	"license": "MIT",
 	"homepage": "https://afb.arbenger.com",
 	"repository": {