@knowsuchagency/fulcrum 4.3.0 → 4.4.0

package/README.md

@@ -20,19 +20,19 @@ Fulcrum doesn't replace your tools—it gives you leverage over them. You config
 - **Project Management** — Tasks with dependencies, due dates, time estimates, priority levels, recurrence, labels, and attachments. Visual kanban boards.
 - **Production Deployment** — Docker Compose with automatic Traefik routing and Cloudflare DNS/tunnels.
 - **Agent Memory** — Persistent knowledge store with full-text search. Agents remember across sessions.
-- **Skills-First Architecture** — Agents discover capabilities through skills and the `fulcrum api` CLI. MCP available for clients that support it.
+- **MCP-First Architecture** — 100+ tools exposed via Model Context Protocol. Agents discover what they need.
 
-## Skills-First Architecture
+## MCP-First Architecture
 
-Fulcrum's capabilities are exposed through skills and a unified CLI:
+Everything in Fulcrum is exposed through MCP (Model Context Protocol):
 
-- **`fulcrum api` CLI** — Resource/action CLI to all 100+ API endpoints. `fulcrum api tools` prints a compact reference (~2K tokens) for context injection
-- **Skills for Claude Code** — The Fulcrum skill teaches agents how to use `current-task`, notifications, config, and the API
-- **MCP for other clients** — Claude Desktop, OpenCode, and other MCP-compatible agents can use the full MCP server
-- **No context bloat** — Skills load on demand; `fulcrum api tools` replaces ~45K tokens of MCP definitions with ~2K tokens
+- **100+ MCP tools** for tasks, projects, apps, repos, notifications, and remote execution
+- **Smart tool discovery** — `search_tools` lets agents find relevant tools without loading everything into context
 - **Integrated assistant** — Built-in AI assistant with full context of your tasks, projects, and apps
+- **External agent support** — Connect Claude Desktop, Clawdbot, or any MCP-compatible agent
+- **No context bloat** — Agents discover and use only the tools they need
 
-Whether you use Claude Code with skills, Claude Desktop with MCP, or any other agent, Fulcrum provides seamless access to your entire workflow.
+Whether you use Fulcrum's built-in assistant or an external agent like Claude Desktop, AI has seamless access to your entire workflow.
 
 ## Proactive Digital Concierge
 
@@ -250,9 +250,9 @@ fulcrum opencode install    # Install plugin + MCP server
 fulcrum opencode uninstall  # Remove both
 ```
 
-## Skills & API
+## MCP Tools
 
-Fulcrum exposes 100+ API endpoints that agents access through skills and the `fulcrum api` CLI:
+Both plugins include an MCP server with 100+ tools:
 
 | Category | Description |
 |----------|-------------|
@@ -273,9 +273,9 @@ Fulcrum exposes 100+ API endpoints that agents access through skills and the `fu
 | **Jobs** | List, create, update, delete, enable/disable, and run systemd timers and launchd jobs |
 | **Assistant** | Send messages via channels (WhatsApp, Discord, Telegram, Slack, Gmail); query sweep history |
 
-Use `fulcrum api tools` for a compact reference of all resources and actions, or `fulcrum api routes --search <keyword>` for detailed route discovery.
+Use `search_tools` to discover available tools by keyword or category.
 
-For Claude Desktop (MCP), add to your `claude_desktop_config.json`:
+For Claude Desktop, add to your `claude_desktop_config.json`:
 
 ```json
 {

package/bin/fulcrum.js

@@ -43850,6 +43850,13 @@ var init_registry = __esm(() => {
       keywords: ["app", "create", "new", "deploy", "docker", "compose"],
       defer_loading: true
     },
+    {
+      name: "update_app",
+      description: "Update app settings including service exposure, environment variables, and deployment options",
+      category: "apps",
+      keywords: ["app", "update", "configure", "service", "exposure", "domain", "tunnel", "dns", "environment"],
+      defer_loading: true
+    },
     {
       name: "deploy_app",
       description: "Trigger a deployment for an app",
@@ -45531,6 +45538,31 @@ var registerAppTools = (server, client) => {
       return handleToolError(err);
     }
   });
+  server.tool("update_app", "Update app settings including service exposure, environment variables, and deployment options", {
+    id: exports_external.string().describe("App ID"),
+    name: exports_external.optional(exports_external.string()).describe("App name"),
+    branch: exports_external.optional(exports_external.string()).describe("Git branch"),
+    autoDeployEnabled: exports_external.optional(exports_external.boolean()).describe("Enable auto-deploy on git push"),
+    autoPortAllocation: exports_external.optional(exports_external.boolean()).describe("Auto-allocate host ports on conflicts"),
+    environmentVariables: exports_external.optional(exports_external.record(exports_external.string(), exports_external.string())).describe("Environment variables (key-value pairs)"),
+    noCacheBuild: exports_external.optional(exports_external.boolean()).describe("Disable Docker build cache"),
+    notificationsEnabled: exports_external.optional(exports_external.boolean()).describe("Send notifications on deploy success/failure"),
+    services: exports_external.optional(exports_external.array(exports_external.object({
+      id: exports_external.optional(exports_external.string()).describe("Service ID (for updating existing)"),
+      serviceName: exports_external.string().describe("Service name (must match compose file)"),
+      containerPort: exports_external.optional(exports_external.number()).describe("Port the container listens on"),
+      exposed: exports_external.boolean().describe("Make publicly accessible"),
+      domain: exports_external.optional(exports_external.string()).describe("Domain to route traffic to this service"),
+      exposureMethod: exports_external.optional(exports_external.enum(["dns", "tunnel"])).describe("Exposure method: dns (Traefik + Cloudflare A record) or tunnel (Cloudflare Tunnel)")
+    }))).describe("Service exposure configuration")
+  }, async ({ id, ...rest }) => {
+    try {
+      const app = await client.updateApp(id, rest);
+      return formatSuccess(app);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
   server.tool("deploy_app", "Trigger a deployment for an app", {
     id: exports_external.string().describe("App ID")
   }, async ({ id }) => {
@@ -46561,7 +46593,7 @@ var JobScopeSchema, registerJobTools = (server, client) => {
     schedule: exports_external.string().describe('systemd OnCalendar schedule (e.g., "daily", "*-*-* 09:00:00", "Mon..Fri 09:00")'),
     command: exports_external.string().describe("Command to execute"),
     workingDirectory: exports_external.optional(exports_external.string()).describe("Working directory for the command"),
-    environment: exports_external.optional(exports_external.record(exports_external.string())).describe("Environment variables as key-value pairs"),
+    environment: exports_external.optional(exports_external.record(exports_external.string(), exports_external.string())).describe("Environment variables as key-value pairs"),
     persistent: exports_external.optional(exports_external.boolean()).describe("Run missed executions on next boot (default: true)")
   }, async ({ name, description, schedule, command, workingDirectory, environment, persistent }) => {
     try {
@@ -46585,7 +46617,7 @@ var JobScopeSchema, registerJobTools = (server, client) => {
     schedule: exports_external.optional(exports_external.string()).describe("New schedule"),
     command: exports_external.optional(exports_external.string()).describe("New command"),
     workingDirectory: exports_external.optional(exports_external.string()).describe("New working directory"),
-    environment: exports_external.optional(exports_external.record(exports_external.string())).describe("New environment variables"),
+    environment: exports_external.optional(exports_external.record(exports_external.string(), exports_external.string())).describe("New environment variables"),
     persistent: exports_external.optional(exports_external.boolean()).describe("Run missed executions on next boot")
   }, async ({ name, description, schedule, command, workingDirectory, environment, persistent }) => {
     try {
@@ -46712,7 +46744,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "4.3.0"
+    version: "4.4.0"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -49061,7 +49093,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "4.3.0",
+      "version": "4.4.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49084,11 +49116,12 @@ var marketplace_default = `{
 var plugin_default = `{
   "name": "fulcrum",
   "description": "Fulcrum task orchestration for Claude Code",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "author": {
     "name": "Fulcrum"
   },
   "hooks": "./hooks/hooks.json",
+  "mcpServers": "./.mcp.json",
   "skills": "./skills/",
   "commands": "./commands/"
 }
@@ -49121,6 +49154,17 @@ var hooks_default = `{
 }
 `;
 
+// plugins/fulcrum/.mcp.json
+var _mcp_default = `{
+  "mcpServers": {
+    "fulcrum": {
+      "command": "fulcrum",
+      "args": ["mcp"]
+    }
+  }
+}
+`;
+
 // plugins/fulcrum/commands/pr.md
 var pr_default = `---
 description: Link a GitHub PR to the current fulcrum task
@@ -49313,6 +49357,44 @@ fulcrum notify "Need Input" "Which approach should I use for the database migrat
 - \`DONE\` \u2014 Task is finished
 - \`CANCELED\` \u2014 Task was abandoned
 
+## MCP Tools Reference
+
+When using Fulcrum via MCP (Claude Desktop, built-in assistant), these tools are available:
+
+**Tasks:** \`list_tasks\`, \`get_task\`, \`create_task\`, \`update_task\`, \`move_task\`, \`delete_task\`, \`add_task_tag\`, \`remove_task_tag\`, \`set_task_due_date\`, \`add_task_dependency\`, \`remove_task_dependency\`, \`upload_task_attachment\`, \`list_task_attachments\`, \`add_task_link\`, \`list_task_links\`
+
+**Projects:** \`list_projects\`, \`get_project\`, \`create_project\`, \`update_project\`, \`delete_project\`, \`add_project_tag\`, \`remove_project_tag\`, \`upload_project_attachment\`, \`list_project_attachments\`, \`add_project_link\`, \`list_project_links\`
+
+**Repos:** \`list_repositories\`, \`get_repository\`, \`add_repository\`, \`update_repository\`, \`link_repository_to_project\`, \`unlink_repository_from_project\`
+
+**Apps:** \`list_apps\`, \`get_app\`, \`create_app\`, \`update_app\`, \`delete_app\`, \`deploy_app\`, \`stop_app\`, \`get_app_logs\`, \`get_app_status\`, \`list_deployments\`
+
+**Jobs:** \`list_jobs\`, \`get_job\`, \`get_job_logs\`, \`create_job\`, \`update_job\`, \`delete_job\`, \`enable_job\`, \`disable_job\`, \`run_job_now\`
+
+**Files:** \`read_file\`, \`write_file\`, \`edit_file\`, \`list_directory\`, \`get_file_tree\`, \`file_stat\`
+
+**Exec:** \`execute_command\`, \`list_exec_sessions\`, \`destroy_exec_session\`
+
+**Notifications:** \`send_notification\`
+
+**Settings:** \`list_settings\`, \`get_setting\`, \`update_setting\`, \`reset_setting\`, \`get_notification_settings\`, \`update_notification_settings\`
+
+**Backup:** \`list_backups\`, \`create_backup\`, \`get_backup\`, \`restore_backup\`, \`delete_backup\`
+
+**Search:** \`search\` (unified FTS5 across tasks, projects, messages, events, memories, conversations, gmail)
+
+**Memory:** \`memory_file_read\`, \`memory_file_update\`, \`memory_store\`, \`memory_search\`, \`memory_list\`, \`memory_delete\`
+
+**Assistant:** \`message\` (send to WhatsApp/Discord/Telegram/Slack/Gmail), \`get_last_sweep\`
+
+**Calendar:** \`list_caldav_accounts\`, \`create_caldav_account\`, \`delete_caldav_account\`, \`sync_caldav_account\`, \`list_caldav_copy_rules\`, \`create_caldav_copy_rule\`, \`delete_caldav_copy_rule\`, \`execute_caldav_copy_rule\`
+
+**Gmail:** \`list_google_accounts\`, \`list_gmail_drafts\`, \`create_gmail_draft\`, \`update_gmail_draft\`, \`delete_gmail_draft\`
+
+**Email:** \`list_emails\`, \`get_email\`, \`search_emails\`, \`fetch_emails\`
+
+**Utilities:** \`list_tags\`, \`delete_tag\`, \`get_task_dependency_graph\`, \`is_git_repo\`
+
 ## Best Practices
 
 1. **Use \`current-task\` inside worktrees** \u2014 It auto-detects which task you're in
@@ -49331,6 +49413,7 @@ var PLUGIN_FILES = [
   { path: ".claude-plugin/marketplace.json", content: marketplace_default },
   { path: ".claude-plugin/plugin.json", content: plugin_default },
   { path: "hooks/hooks.json", content: hooks_default },
+  { path: ".mcp.json", content: _mcp_default },
   { path: "commands/pr.md", content: pr_default },
   { path: "commands/task-info.md", content: task_info_default },
   { path: "commands/notify.md", content: notify_default },
@@ -50139,7 +50222,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "4.3.0",
+  version: "4.4.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",
@@ -50155,7 +50238,7 @@ var package_default = {
     "db:studio": "drizzle-kit studio"
   },
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "0.2.45",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.47",
     "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
     "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
     "@azurity/pure-nerd-font": "^3.0.5",
@@ -50424,6 +50507,24 @@ function getPackageRoot() {
   }
   return dirname3(dirname3(dirname3(currentFile)));
 }
+async function ensureDependency(spec, autoYes) {
+  if (spec.isInstalled())
+    return;
+  const dep = getDependency(spec.name);
+  const method = getInstallMethod(dep);
+  console.error(spec.reason);
+  console.error(`  ${spec.description}`);
+  const shouldInstall = autoYes || await confirm(`Would you like to install ${spec.name} via ${method}?`);
+  if (shouldInstall) {
+    const success = spec.install();
+    if (!success) {
+      throw new CliError("INSTALL_FAILED", `Failed to install ${spec.name}`, ExitCodes.ERROR);
+    }
+    console.error(`${spec.name} installed successfully!`);
+  } else {
+    throw new CliError("MISSING_DEPENDENCY", `${spec.name} is required. Install manually: ${getInstallCommand(dep)}`, ExitCodes.ERROR);
+  }
+}
 async function handleUpCommand(flags) {
   const autoYes = flags.yes === "true" || flags.y === "true";
   const shouldUpdate = flags.update === "true";
@@ -50451,85 +50552,45 @@ Found existing Vibora data at ${viboraDir}`);
     console.error('Run "fulcrum migrate-from-vibora" to copy your data to ~/.fulcrum');
     console.error("");
   }
-  if (!isBunInstalled()) {
-    const bunDep = getDependency("bun");
-    const method = getInstallMethod(bunDep);
-    console.error("Bun is required to run Fulcrum but is not installed.");
-    console.error("  Bun is the JavaScript runtime that powers Fulcrum.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install bun via ${method}?`);
-    if (shouldInstall) {
-      const success = installBun();
-      if (!success) {
-        throw new CliError("INSTALL_FAILED", "Failed to install bun", ExitCodes.ERROR);
-      }
-      console.error("Bun installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `Bun is required. Install manually: ${getInstallCommand(bunDep)}`, ExitCodes.ERROR);
-    }
-  }
-  if (!isDtachInstalled()) {
-    const dtachDep = getDependency("dtach");
-    const method = getInstallMethod(dtachDep);
-    console.error("dtach is required for terminal persistence but is not installed.");
-    console.error("  dtach enables persistent terminal sessions that survive disconnects.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install dtach via ${method}?`);
-    if (shouldInstall) {
-      const success = installDtach();
-      if (!success) {
-        throw new CliError("INSTALL_FAILED", "Failed to install dtach", ExitCodes.ERROR);
-      }
-      console.error("dtach installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `dtach is required. Install manually: ${getInstallCommand(dtachDep)}`, ExitCodes.ERROR);
-    }
-  }
-  if (!isUvInstalled()) {
-    const uvDep = getDependency("uv");
-    const method = getInstallMethod(uvDep);
-    console.error("uv is required but is not installed.");
-    console.error("  uv is a fast Python package manager used by Claude Code.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install uv via ${method}?`);
-    if (shouldInstall) {
-      const success = installUv();
-      if (!success) {
-        throw new CliError("INSTALL_FAILED", "Failed to install uv", ExitCodes.ERROR);
-      }
-      console.error("uv installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `uv is required. Install manually: ${getInstallCommand(uvDep)}`, ExitCodes.ERROR);
-    }
-  }
-  if (!isFnoxInstalled()) {
-    const fnoxDep = getDependency("fnox");
-    const method = getInstallMethod(fnoxDep);
-    console.error("fnox is required for encrypted secrets management but is not installed.");
-    console.error("  fnox encrypts sensitive settings like API keys and tokens.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install fnox via ${method}?`);
-    if (shouldInstall) {
-      const success = installFnox();
-      if (!success) {
-        throw new CliError("INSTALL_FAILED", "Failed to install fnox", ExitCodes.ERROR);
-      }
-      console.error("fnox installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `fnox is required. Install manually: ${getInstallCommand(fnoxDep)}`, ExitCodes.ERROR);
-    }
-  }
-  if (!isAgeInstalled()) {
-    const ageDep = getDependency("age");
-    const method = getInstallMethod(ageDep);
-    console.error("age is required for encryption but is not installed.");
-    console.error("  age generates encryption keys used by fnox to encrypt secrets.");
-    const shouldInstall = autoYes || await confirm(`Would you like to install age via ${method}?`);
-    if (shouldInstall) {
-      const success = installAge();
-      if (!success) {
-        throw new CliError("INSTALL_FAILED", "Failed to install age", ExitCodes.ERROR);
-      }
-      console.error("age installed successfully!");
-    } else {
-      throw new CliError("MISSING_DEPENDENCY", `age is required. Install manually: ${getInstallCommand(ageDep)}`, ExitCodes.ERROR);
+  const requiredDeps = [
+    {
+      name: "bun",
+      isInstalled: isBunInstalled,
+      install: installBun,
+      reason: "Bun is required to run Fulcrum but is not installed.",
+      description: "Bun is the JavaScript runtime that powers Fulcrum."
+    },
+    {
+      name: "dtach",
+      isInstalled: isDtachInstalled,
+      install: installDtach,
+      reason: "dtach is required for terminal persistence but is not installed.",
+      description: "dtach enables persistent terminal sessions that survive disconnects."
+    },
+    {
+      name: "uv",
+      isInstalled: isUvInstalled,
+      install: installUv,
+      reason: "uv is required but is not installed.",
+      description: "uv is a fast Python package manager used by Claude Code."
+    },
+    {
+      name: "fnox",
+      isInstalled: isFnoxInstalled,
+      install: installFnox,
+      reason: "fnox is required for encrypted secrets management but is not installed.",
+      description: "fnox encrypts sensitive settings like API keys and tokens."
+    },
+    {
+      name: "age",
+      isInstalled: isAgeInstalled,
+      install: installAge,
+      reason: "age is required for encryption but is not installed.",
+      description: "age generates encryption keys used by fnox to encrypt secrets."
     }
+  ];
+  for (const dep of requiredDeps) {
+    await ensureDependency(dep, autoYes);
   }
   if (isClaudeInstalled() && needsPluginUpdate()) {
     console.error("Updating Fulcrum plugin for Claude Code...");
@@ -51408,28 +51469,6 @@ function getRawArgsAfterApi() {
     return [];
   return argv2.slice(apiIdx + 1);
 }
-var routesCommand = defineCommand({
-  meta: { name: "routes", description: "List available API routes" },
-  args: {
-    ...globalArgs,
-    category: { type: "string", description: "Filter by category" },
-    search: { type: "string", description: "Search routes by keyword" }
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    await handleRoutes(toFlags(args));
-  }
-});
-var toolsCommand = defineCommand({
-  meta: { name: "tools", description: "Print compact tool reference for context window injection" },
-  args: {
-    ...globalArgs
-  },
-  async run({ args }) {
-    setupJsonOutput(args);
-    await handleTools(toFlags(args));
-  }
-});
 var apiCommand = defineCommand({
   meta: { name: "api", description: "REST API access \u2014 route discovery, HTTP proxy, and resource/action CLI" },
   args: {
@@ -51440,10 +51479,6 @@ var apiCommand = defineCommand({
     category: { type: "string", description: "Filter routes by category" },
     search: { type: "string", description: "Search routes by keyword" }
   },
-  subCommands: {
-    routes: routesCommand,
-    tools: toolsCommand
-  },
   async run({ args }) {
     setupJsonOutput(args);
     const flags = toFlags(args);