@knowsuchagency/fulcrum 4.14.2 → 5.0.0

package/bin/fulcrum.js

@@ -951,10 +951,6 @@ var init_errors = __esm(() => {
 });
 
 // cli/src/client.ts
-var exports_client = {};
-__export(exports_client, {
-  FulcrumClient: () => FulcrumClient
-});
 import { readFileSync } from "fs";
 import { basename } from "path";
 
@@ -43618,8 +43614,7 @@ var init_types4 = __esm(() => {
     "messaging",
     "assistant",
     "caldav",
-    "memory",
-    "board"
+    "memory"
   ]);
   AgentTypeSchema = exports_external.enum(["claude", "opencode"]);
 });
@@ -44581,27 +44576,6 @@ var init_registry = __esm(() => {
       category: "jobs",
       keywords: ["job", "timer", "run", "trigger", "execute", "now"],
       defer_loading: true
-    },
-    {
-      name: "board_read",
-      description: "Read the agent coordination board for recent messages from other agents",
-      category: "board",
-      keywords: ["board", "coordination", "agent", "read", "messages", "status", "conflict"],
-      defer_loading: false
-    },
-    {
-      name: "board_post",
-      description: "Post a message to the agent coordination board (claims, status, warnings)",
-      category: "board",
-      keywords: ["board", "coordination", "agent", "post", "claim", "resource", "port", "announce"],
-      defer_loading: false
-    },
-    {
-      name: "board_check",
-      description: "Check if a resource is claimed by another agent on the coordination board",
-      category: "board",
-      keywords: ["board", "coordination", "agent", "check", "claim", "resource", "port", "conflict"],
-      defer_loading: false
     }
   ];
 });
@@ -46792,326 +46766,6 @@ var init_jobs = __esm(() => {
   JobScopeSchema = exports_external.enum(["all", "user", "system"]);
 });
 
-// cli/src/board/types.ts
-var DEFAULT_TTLS;
-var init_types6 = __esm(() => {
-  DEFAULT_TTLS = {
-    claim: 7200,
-    release: 300,
-    info: 3600,
-    warning: 7200,
-    request: 14400
-  };
-});
-
-// cli/src/board/index.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, readdirSync, readFileSync as readFileSync6, writeFileSync as writeFileSync5, unlinkSync as unlinkSync3, renameSync as renameSync3 } from "fs";
-import { join as join7 } from "path";
-import { homedir as homedir4, tmpdir } from "os";
-function getGlobalFulcrumDir() {
-  if (process.env.FULCRUM_DIR) {
-    return process.env.FULCRUM_DIR.replace(/^~/, homedir4());
-  }
-  return join7(homedir4(), ".fulcrum");
-}
-function getBoardDir() {
-  return join7(getGlobalFulcrumDir(), "board", "messages");
-}
-function getRefsDir() {
-  return join7(getGlobalFulcrumDir(), "board", "refs");
-}
-function ensureBoardDirs() {
-  mkdirSync5(getBoardDir(), { recursive: true });
-  mkdirSync5(getRefsDir(), { recursive: true });
-}
-function generateId() {
-  return Math.random().toString(36).substring(2, 6);
-}
-function detectAgent() {
-  if (process.env.CLAUDE_CODE)
-    return "claude";
-  if (process.env.CLAUDE_CODE_ENTRY_POINT)
-    return "claude";
-  return "unknown";
-}
-async function getTaskContext() {
-  const taskId = process.env.FULCRUM_TASK_ID;
-  if (!taskId)
-    return {};
-  try {
-    const { FulcrumClient: FulcrumClient2 } = await Promise.resolve().then(() => (init_client(), exports_client));
-    const client = new FulcrumClient2;
-    const task = await client.getTask(taskId);
-    return {
-      taskId,
-      taskTitle: task.title,
-      project: task.projectId ?? undefined,
-      repository: task.repoName ?? undefined,
-      worktree: task.worktreePath ?? undefined
-    };
-  } catch {
-    return { taskId };
-  }
-}
-function parseDuration(duration5) {
-  let seconds = 0;
-  const hourMatch = duration5.match(/(\d+)h/);
-  const minuteMatch = duration5.match(/(\d+)m/);
-  const secondMatch = duration5.match(/(\d+)s/);
-  if (hourMatch)
-    seconds += parseInt(hourMatch[1], 10) * 3600;
-  if (minuteMatch)
-    seconds += parseInt(minuteMatch[1], 10) * 60;
-  if (secondMatch)
-    seconds += parseInt(secondMatch[1], 10);
-  if (seconds === 0 && /^\d+$/.test(duration5)) {
-    seconds = parseInt(duration5, 10);
-  }
-  return seconds || 3600;
-}
-function readBoard(options = {}) {
-  const dir = getBoardDir();
-  if (!existsSync7(dir))
-    return [];
-  const now = Date.now();
-  const sinceMs = options.since ? now - parseDuration(options.since) * 1000 : now - 3600000;
-  const limit = options.limit ?? 50;
-  let entries;
-  try {
-    entries = readdirSync(dir).filter((f3) => f3.endsWith(".json")).sort();
-  } catch {
-    return [];
-  }
-  const messages = [];
-  const expired = [];
-  for (const filename of entries) {
-    const tsStr = filename.split("-")[0];
-    const fileTs = parseInt(tsStr, 10);
-    const filePath = join7(dir, filename);
-    try {
-      const content = readFileSync6(filePath, "utf-8");
-      const msg = JSON.parse(content);
-      const msgTs = new Date(msg.timestamp).getTime();
-      const expiresAt = msgTs + msg.ttl * 1000;
-      if (expiresAt < now) {
-        expired.push(filePath);
-        continue;
-      }
-      if (fileTs < sinceMs)
-        continue;
-      if (options.type && msg.type !== options.type)
-        continue;
-      if (options.project && msg.project !== options.project)
-        continue;
-      if (options.tag && (!msg.tags || !msg.tags.includes(options.tag)))
-        continue;
-      messages.push(msg);
-    } catch {}
-  }
-  for (const path of expired) {
-    try {
-      unlinkSync3(path);
-    } catch {}
-  }
-  return messages.reverse().slice(0, limit);
-}
-async function postMessage(input) {
-  ensureBoardDirs();
-  const id = generateId();
-  const now = new Date;
-  const type = input.type ?? "info";
-  const ttl = input.ttl ?? DEFAULT_TTLS[type];
-  const context = await getTaskContext();
-  const agent = detectAgent();
-  const message = {
-    id,
-    timestamp: now.toISOString(),
-    type,
-    agent,
-    ...context,
-    ttl,
-    body: input.body,
-    tags: input.tags
-  };
-  if (input.refContent) {
-    const refFilename = `${id}-ref.txt`;
-    const refPath = join7(getRefsDir(), refFilename);
-    writeFileSync5(refPath, input.refContent, "utf-8");
-    message.refs = [refFilename];
-  }
-  const filename = `${now.getTime()}-${id}.json`;
-  const finalPath = join7(getBoardDir(), filename);
-  const tempPath = join7(tmpdir(), `fulcrum-board-${filename}`);
-  writeFileSync5(tempPath, JSON.stringify(message, null, 2), "utf-8");
-  renameSync3(tempPath, finalPath);
-  return message;
-}
-function checkResource(resource) {
-  const dir = getBoardDir();
-  if (!existsSync7(dir))
-    return null;
-  const now = Date.now();
-  let entries;
-  try {
-    entries = readdirSync(dir).filter((f3) => f3.endsWith(".json")).sort().reverse();
-  } catch {
-    return null;
-  }
-  for (const filename of entries) {
-    const filePath = join7(dir, filename);
-    try {
-      const content = readFileSync6(filePath, "utf-8");
-      const msg = JSON.parse(content);
-      if (msg.type !== "claim")
-        continue;
-      const msgTs = new Date(msg.timestamp).getTime();
-      if (msgTs + msg.ttl * 1000 < now)
-        continue;
-      if (msg.tags && msg.tags.includes(resource)) {
-        return msg;
-      }
-    } catch {}
-  }
-  return null;
-}
-function releaseAllByTask(taskId) {
-  const dir = getBoardDir();
-  if (!existsSync7(dir))
-    return 0;
-  let entries;
-  try {
-    entries = readdirSync(dir).filter((f3) => f3.endsWith(".json"));
-  } catch {
-    return 0;
-  }
-  let deleted = 0;
-  for (const filename of entries) {
-    const filePath = join7(dir, filename);
-    try {
-      const content = readFileSync6(filePath, "utf-8");
-      const msg = JSON.parse(content);
-      if (msg.type === "claim" && msg.taskId === taskId) {
-        unlinkSync3(filePath);
-        deleted++;
-      }
-    } catch {}
-  }
-  return deleted;
-}
-function cleanBoard(all) {
-  const dir = getBoardDir();
-  if (!existsSync7(dir))
-    return 0;
-  let entries;
-  try {
-    entries = readdirSync(dir).filter((f3) => f3.endsWith(".json"));
-  } catch {
-    return 0;
-  }
-  const now = Date.now();
-  let deleted = 0;
-  for (const filename of entries) {
-    const filePath = join7(dir, filename);
-    if (all) {
-      try {
-        unlinkSync3(filePath);
-        deleted++;
-      } catch {}
-      continue;
-    }
-    try {
-      const content = readFileSync6(filePath, "utf-8");
-      const msg = JSON.parse(content);
-      const msgTs = new Date(msg.timestamp).getTime();
-      if (msgTs + msg.ttl * 1000 < now) {
-        unlinkSync3(filePath);
-        deleted++;
-      }
-    } catch {
-      try {
-        unlinkSync3(filePath);
-        deleted++;
-      } catch {}
-    }
-  }
-  if (all) {
-    const refsDir = getRefsDir();
-    if (existsSync7(refsDir)) {
-      try {
-        for (const ref of readdirSync(refsDir)) {
-          try {
-            unlinkSync3(join7(refsDir, ref));
-            deleted++;
-          } catch {}
-        }
-      } catch {}
-    }
-  }
-  return deleted;
-}
-var init_board = __esm(() => {
-  init_types6();
-});
-
-// cli/src/mcp/tools/board.ts
-var registerBoardTools = (server, _client) => {
-  server.tool("board_read", "Read the agent coordination board. Returns recent messages from other agents working in the same project. Use before claiming resources (ports, services) to avoid conflicts.", {
-    since: exports_external.optional(exports_external.string()).describe('Time window, e.g. "1h", "30m", "2h". Default: "1h"'),
-    type: exports_external.optional(exports_external.enum(["claim", "release", "info", "warning", "request"])).describe("Filter by message type"),
-    project: exports_external.optional(exports_external.string()).describe("Filter by project name"),
-    tag: exports_external.optional(exports_external.string()).describe('Filter by tag, e.g. "port:5173"'),
-    limit: exports_external.optional(exports_external.number().min(1).max(200)).describe("Max messages to return (default: 50)")
-  }, async ({ since, type, project, tag, limit }) => {
-    try {
-      const messages = readBoard({
-        since,
-        type,
-        project,
-        tag,
-        limit
-      });
-      return formatSuccess(messages);
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
-  server.tool("board_post", "Post a message to the agent coordination board. Announce resource claims, share status updates, or coordinate with other agents working on the same project.", {
-    body: exports_external.string().describe("Message body describing what you are doing or claiming"),
-    type: exports_external.optional(exports_external.enum(["claim", "release", "info", "warning", "request"])).describe('Message type. Default: "info". Use "claim" to reserve resources, "release" to free them.'),
-    tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Tags for categorization and resource matching, e.g. ["port:5173", "dev-server"]'),
-    ttl: exports_external.optional(exports_external.number()).describe("Time-to-live in seconds. Defaults vary by type: claim=7200, release=300, info=3600"),
-    refContent: exports_external.optional(exports_external.string()).describe("Large content to store as a ref file (e.g., error logs)")
-  }, async ({ body, type, tags, ttl, refContent }) => {
-    try {
-      const message = await postMessage({
-        body,
-        type,
-        tags,
-        ttl,
-        refContent
-      });
-      return formatSuccess(message);
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
-  server.tool("board_check", "Check if a resource is claimed by another agent. Returns the active claim if found, null if the resource is free. Use before starting dev servers, database operations, etc.", {
-    resource: exports_external.string().describe('Resource tag to check, e.g. "port:5173", "db:migration"')
-  }, async ({ resource }) => {
-    try {
-      const claim = checkResource(resource);
-      return formatSuccess(claim ? { claimed: true, claim } : { claimed: false });
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
-};
-var init_board2 = __esm(() => {
-  init_zod2();
-  init_utils();
-  init_board();
-});
-
 // cli/src/mcp/tools/index.ts
 function registerTools(server, client) {
   registerCoreTools(server, client);
@@ -47134,7 +46788,6 @@ function registerTools(server, client) {
   registerMemoryFileTools(server, client);
   registerSearchTools(server, client);
   registerJobTools(server, client);
-  registerBoardTools(server, client);
 }
 var init_tools = __esm(() => {
   init_core5();
@@ -47157,7 +46810,6 @@ var init_tools = __esm(() => {
   init_messaging();
   init_search();
   init_jobs();
-  init_board2();
   init_types4();
 });
 
@@ -47176,7 +46828,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "4.14.2"
+    version: "5.0.0"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48599,15 +48251,6 @@ function setJsonOutput(value) {
 function isJsonOutput() {
   return jsonOutput;
 }
-function prettyLog(type, message) {
-  const prefixes = {
-    success: "\u2713",
-    info: "\u2192",
-    error: "\u2717",
-    warning: "\u26A0"
-  };
-  console.log(`${prefixes[type]} ${message}`);
-}
 function output(data) {
   const response = {
     success: true,
@@ -49534,7 +49177,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "4.14.2",
+      "version": "5.0.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49557,7 +49200,7 @@ var marketplace_default = `{
 var plugin_default = `{
   "name": "fulcrum",
   "description": "Fulcrum task orchestration for Claude Code",
-  "version": "4.14.2",
+  "version": "5.0.0",
   "author": {
     "name": "Fulcrum"
   },
@@ -49573,10 +49216,6 @@ var hooks_default = `{
     "Stop": [
       {
         "hooks": [
-          {
-            "type": "command",
-            "command": "fulcrum board release-all 2>/dev/null || true"
-          },
           {
             "type": "command",
             "command": "fulcrum current-task review 2>/dev/null || true"
@@ -49726,42 +49365,6 @@ fulcrum notify "Task Complete" "Implemented the new feature and created PR #123"
 fulcrum notify "Need Input" "Which approach should I use for the database migration?"
 \`\`\`
 
-## Agent Coordination Board
-
-When multiple agents work on the same project in separate worktrees, use the coordination board to avoid conflicts (port collisions, concurrent migrations, etc.).
-
-### When to Use
-
-- **Before starting a dev server** \u2014 check if the port is already claimed
-- **Before running database migrations** \u2014 check if another agent is migrating
-- **When using shared resources** \u2014 claim them first, release when done
-
-### CLI Commands
-
-\`\`\`bash
-fulcrum board                              # Read recent messages (last 1h)
-fulcrum board read --since 2h              # Custom time window
-fulcrum board read --type claim            # Filter by type
-fulcrum board read --tag port:5173         # Filter by tag
-
-fulcrum board post "Using port 5173" --type claim --tag port:5173
-fulcrum board post "Migration complete" --type info
-
-fulcrum board check port:5173              # Check if resource is claimed
-
-fulcrum board release-all                  # Release all your claims (auto-runs on Stop)
-
-fulcrum board clean                        # Remove expired messages
-fulcrum board clean --all                  # Remove ALL messages
-\`\`\`
-
-### Best Practices
-
-1. **Always check before claiming** \u2014 \`fulcrum board check port:<N>\` before starting a dev server
-2. **Always release when done** \u2014 Post a \`release\` message or use \`fulcrum board release-all\`
-3. **Claims auto-expire** \u2014 TTL is 2 hours for claims, so crashes won't permanently block resources
-4. **The Stop hook auto-releases** \u2014 When your session ends, claims are released automatically
-
 ## Global Options
 
 - \`--port=<port>\` \u2014 Server port (default: 7777)
@@ -50609,7 +50212,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "4.14.2",
+  version: "5.0.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",
@@ -50625,7 +50228,7 @@ var package_default = {
     "db:studio": "drizzle-kit studio"
   },
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "0.2.110",
+    "@anthropic-ai/claude-agent-sdk": "0.2.114",
     "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
     "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
     "@azurity/pure-nerd-font": "^3.0.5",
@@ -51353,176 +50956,6 @@ var mcpCommand = defineCommand({
   }
 });
 
-// cli/src/commands/board.ts
-init_board();
-function formatMessage(msg) {
-  const age = getAge(msg.timestamp);
-  const typeColor = {
-    claim: "[CLAIM]",
-    release: "[RELEASE]",
-    info: "[INFO]",
-    warning: "[WARNING]",
-    request: "[REQUEST]"
-  };
-  const prefix = typeColor[msg.type] ?? `[${msg.type.toUpperCase()}]`;
-  const agent = msg.agent !== "unknown" ? ` (${msg.agent})` : "";
-  const task = msg.taskTitle ? ` | ${msg.taskTitle}` : "";
-  const tags = msg.tags?.length ? ` [${msg.tags.join(", ")}]` : "";
-  console.log(`${prefix} ${msg.body}${agent}${task}${tags} (${age} ago)`);
-}
-function getAge(timestamp) {
-  const ms = Date.now() - new Date(timestamp).getTime();
-  const seconds = Math.floor(ms / 1000);
-  if (seconds < 60)
-    return `${seconds}s`;
-  const minutes = Math.floor(seconds / 60);
-  if (minutes < 60)
-    return `${minutes}m`;
-  const hours = Math.floor(minutes / 60);
-  const remainingMinutes = minutes % 60;
-  if (remainingMinutes > 0)
-    return `${hours}h${remainingMinutes}m`;
-  return `${hours}h`;
-}
-var readCommand = defineCommand({
-  meta: { name: "read", description: "Read recent messages from the coordination board" },
-  args: {
-    since: { type: "string", description: "Time window (e.g., 1h, 30m, 2h). Default: 1h" },
-    type: { type: "string", description: "Filter by type: claim, release, info, warning, request" },
-    project: { type: "string", description: "Filter by project name" },
-    tag: { type: "string", description: "Filter by tag (e.g., port:5173)" },
-    limit: { type: "string", description: "Max messages to return (default: 50)" },
-    json: { type: "boolean", description: "Output as JSON" }
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    const messages = readBoard({
-      since: args.since,
-      type: args.type,
-      project: args.project,
-      tag: args.tag,
-      limit: args.limit ? parseInt(args.limit, 10) : undefined
-    });
-    if (isJsonOutput()) {
-      output(messages);
-    } else {
-      if (messages.length === 0) {
-        prettyLog("info", "No messages on the board");
-      } else {
-        for (const msg of messages) {
-          formatMessage(msg);
-        }
-      }
-    }
-  }
-});
-var postCommand = defineCommand({
-  meta: { name: "post", description: "Post a message to the coordination board" },
-  args: {
-    body: { type: "positional", description: "Message body", required: true },
-    type: { type: "string", description: "Message type: claim, release, info, warning, request. Default: info" },
-    tag: { type: "string", description: "Add a tag (repeatable with comma separation, e.g., port:5173,dev-server)" },
-    ttl: { type: "string", description: "TTL in seconds (overrides default for type)" },
-    json: { type: "boolean", description: "Output as JSON" }
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    const tags = args.tag ? args.tag.split(",").map((t2) => t2.trim()).filter(Boolean) : undefined;
-    const message = await postMessage({
-      body: args.body,
-      type: args.type ?? "info",
-      tags,
-      ttl: args.ttl ? parseInt(args.ttl, 10) : undefined
-    });
-    if (isJsonOutput()) {
-      output(message);
-    } else {
-      prettyLog("success", `Posted: ${message.body}`);
-    }
-  }
-});
-var checkCommand = defineCommand({
-  meta: { name: "check", description: "Check if a resource is claimed by another agent" },
-  args: {
-    resource: { type: "positional", description: "Resource tag to check (e.g., port:5173)", required: true },
-    json: { type: "boolean", description: "Output as JSON" }
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    const claim = checkResource(args.resource);
-    if (isJsonOutput()) {
-      output(claim ? { claimed: true, claim } : { claimed: false });
-    } else {
-      if (claim) {
-        prettyLog("warning", `Resource "${args.resource}" is claimed`);
-        formatMessage(claim);
-        process.exit(0);
-      } else {
-        prettyLog("success", `Resource "${args.resource}" is free`);
-        process.exit(1);
-      }
-    }
-  }
-});
-var releaseAllCommand = defineCommand({
-  meta: { name: "release-all", description: "Release all claims by the current task" },
-  args: {
-    json: { type: "boolean", description: "Output as JSON" }
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    const taskId = process.env.FULCRUM_TASK_ID;
-    if (!taskId) {
-      if (isJsonOutput()) {
-        output({ released: 0, message: "No FULCRUM_TASK_ID set" });
-      } else {
-        prettyLog("info", "No FULCRUM_TASK_ID set \u2014 nothing to release");
-      }
-      return;
-    }
-    const count = releaseAllByTask(taskId);
-    if (isJsonOutput()) {
-      output({ released: count, taskId });
-    } else {
-      if (count > 0) {
-        prettyLog("success", `Released ${count} claim(s) for task ${taskId}`);
-      } else {
-        prettyLog("info", "No active claims to release");
-      }
-    }
-  }
-});
-var cleanCommand = defineCommand({
-  meta: { name: "clean", description: "Remove expired messages from the board" },
-  args: {
-    all: { type: "boolean", description: "Remove ALL messages (not just expired)" },
-    json: { type: "boolean", description: "Output as JSON" }
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    const count = cleanBoard(args.all);
-    if (isJsonOutput()) {
-      output({ deleted: count });
-    } else {
-      if (count > 0) {
-        prettyLog("success", `Removed ${count} message(s)`);
-      } else {
-        prettyLog("info", "Nothing to clean");
-      }
-    }
-  }
-});
-var boardCommand = defineCommand({
-  meta: { name: "board", description: "Agent coordination board for multi-agent environments" },
-  subCommands: {
-    read: readCommand,
-    post: postCommand,
-    check: checkCommand,
-    "release-all": releaseAllCommand,
-    clean: cleanCommand
-  }
-});
-
 // cli/src/commands/migrate-from-vibora.ts
 init_server();
 async function handleMigrateFromViboraCommand(flags) {
@@ -51617,7 +51050,6 @@ var main = defineCommand({
     config: configCommand,
     opencode: opencodeCommand,
     claude: claudeCommand,
-    board: boardCommand,
     notifications: notificationsCommand,
     notify: notifyCommand,
     up: upCommand,