@knowsuchagency/fulcrum 4.1.0 → 4.1.2

package/README.md

@@ -270,6 +270,7 @@ Both plugins include an MCP server with 100+ tools:
 | **Memory** | Read/update master memory file; store ephemeral knowledge with tags |
 | **Calendar** | Manage CalDAV accounts, sync calendars, configure event copy rules |
 | **Gmail** | List Google accounts, manage Gmail drafts, send emails |
+| **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 `search_tools` to discover available tools by keyword or category.
@@ -315,9 +316,9 @@ For browser-only access, use Tailscale or Cloudflare Tunnels to expose your serv
 <details>
 <summary><strong>Configuration</strong></summary>
 
-Sensitive credentials (API keys, tokens, webhook URLs) are encrypted using [fnox](https://github.com/yarlson/fnox) with age encryption. The age key and encrypted secrets live in the fulcrum directory (`age.txt` and `fnox.toml`). Non-sensitive settings are stored in `settings.json`. Existing plain-text secrets are automatically migrated to fnox on server start.
+All configuration is managed by [fnox](https://github.com/yarlson/fnox) — a single `fnox.toml` file stores both plain and encrypted settings. Sensitive credentials (API keys, tokens, webhook URLs) are encrypted with age; the age key (`age.txt`) lives alongside `fnox.toml` in the fulcrum directory. Existing `settings.json` files are automatically migrated to fnox on server start.
 
-Settings are stored in `.fulcrum/settings.json`. The fulcrum directory is resolved in this order:
+The fulcrum directory is resolved in this order:
 
 1. `FULCRUM_DIR` environment variable
 2. `.fulcrum` in current working directory

package/bin/fulcrum.js

@@ -1670,6 +1670,65 @@ class FulcrumClient {
       body: JSON.stringify({ heading, content })
     });
   }
+  async listJobs(scope) {
+    const params = new URLSearchParams;
+    if (scope)
+      params.set("scope", scope);
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.fetch(`/api/jobs${query}`);
+  }
+  async getJob(name, scope) {
+    const params = new URLSearchParams;
+    if (scope)
+      params.set("scope", scope);
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}${query}`);
+  }
+  async getJobLogs(name, scope, lines) {
+    const params = new URLSearchParams;
+    if (scope)
+      params.set("scope", scope);
+    if (lines)
+      params.set("lines", String(lines));
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}/logs${query}`);
+  }
+  async createJob(data) {
+    return this.fetch("/api/jobs", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateJob(name, updates) {
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}`, {
+      method: "PATCH",
+      body: JSON.stringify(updates)
+    });
+  }
+  async deleteJob(name) {
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}`, { method: "DELETE" });
+  }
+  async enableJob(name, scope) {
+    const params = new URLSearchParams;
+    if (scope)
+      params.set("scope", scope);
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}/enable${query}`, { method: "POST" });
+  }
+  async disableJob(name, scope) {
+    const params = new URLSearchParams;
+    if (scope)
+      params.set("scope", scope);
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}/disable${query}`, { method: "POST" });
+  }
+  async runJobNow(name, scope) {
+    const params = new URLSearchParams;
+    if (scope)
+      params.set("scope", scope);
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.fetch(`/api/jobs/${encodeURIComponent(name)}/run${query}`, { method: "POST" });
+  }
   async search(input) {
     const params = new URLSearchParams({ q: input.query });
     if (input.entities?.length)
@@ -44413,6 +44472,69 @@ var init_registry = __esm(() => {
       category: "email",
       keywords: ["gmail", "draft", "delete", "remove", "email", "google"],
       defer_loading: true
+    },
+    {
+      name: "list_jobs",
+      description: "List scheduled jobs (systemd timers on Linux, launchd on macOS)",
+      category: "jobs",
+      keywords: ["job", "timer", "schedule", "cron", "systemd", "launchd", "list"],
+      defer_loading: true
+    },
+    {
+      name: "get_job",
+      description: "Get details of a scheduled job including schedule, command, and execution stats",
+      category: "jobs",
+      keywords: ["job", "timer", "schedule", "details", "get"],
+      defer_loading: true
+    },
+    {
+      name: "get_job_logs",
+      description: "Get execution logs for a scheduled job",
+      category: "jobs",
+      keywords: ["job", "timer", "logs", "output", "journalctl"],
+      defer_loading: true
+    },
+    {
+      name: "create_job",
+      description: "Create a new scheduled job (Linux systemd only)",
+      category: "jobs",
+      keywords: ["job", "timer", "schedule", "create", "new", "systemd"],
+      defer_loading: true
+    },
+    {
+      name: "update_job",
+      description: "Update a scheduled job (Linux systemd only)",
+      category: "jobs",
+      keywords: ["job", "timer", "schedule", "update", "edit", "modify"],
+      defer_loading: true
+    },
+    {
+      name: "delete_job",
+      description: "Delete a scheduled job (Linux systemd user jobs only)",
+      category: "jobs",
+      keywords: ["job", "timer", "schedule", "delete", "remove"],
+      defer_loading: true
+    },
+    {
+      name: "enable_job",
+      description: "Enable a scheduled job so it runs on schedule",
+      category: "jobs",
+      keywords: ["job", "timer", "enable", "start", "activate"],
+      defer_loading: true
+    },
+    {
+      name: "disable_job",
+      description: "Disable a scheduled job so it stops running",
+      category: "jobs",
+      keywords: ["job", "timer", "disable", "stop", "deactivate"],
+      defer_loading: true
+    },
+    {
+      name: "run_job_now",
+      description: "Trigger immediate execution of a scheduled job",
+      category: "jobs",
+      keywords: ["job", "timer", "run", "trigger", "execute", "now"],
+      defer_loading: true
     }
   ];
 });
@@ -46395,6 +46517,138 @@ var init_search = __esm(() => {
   EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories", "conversations", "gmail"]);
 });
 
+// cli/src/mcp/tools/jobs.ts
+var JobScopeSchema, registerJobTools = (server, client) => {
+  server.tool("list_jobs", "List scheduled jobs (systemd timers on Linux, launchd on macOS)", {
+    scope: exports_external.optional(JobScopeSchema).describe("Filter by scope: all, user, or system (default: all)")
+  }, async ({ scope }) => {
+    try {
+      const jobs = await client.listJobs(scope);
+      return formatSuccess(jobs);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("get_job", "Get details of a scheduled job including schedule, command, execution stats, and unit file contents", {
+    name: exports_external.string().describe("Job/timer name"),
+    scope: exports_external.optional(exports_external.enum(["user", "system"])).describe("Job scope (default: user)")
+  }, async ({ name, scope }) => {
+    try {
+      const job = await client.getJob(name, scope);
+      return formatSuccess(job);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("get_job_logs", "Get execution logs for a scheduled job (from journalctl)", {
+    name: exports_external.string().describe("Job/timer name"),
+    scope: exports_external.optional(exports_external.enum(["user", "system"])).describe("Job scope (default: user)"),
+    lines: exports_external.optional(exports_external.number()).describe("Number of log lines to return (default: 100)")
+  }, async ({ name, scope, lines }) => {
+    try {
+      const result = await client.getJobLogs(name, scope, lines);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("create_job", "Create a new scheduled job (Linux systemd only). Creates a .timer and .service unit file.", {
+    name: exports_external.string().describe("Job name (alphanumeric, hyphens, underscores only)"),
+    description: exports_external.string().describe("Human-readable description"),
+    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"),
+    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 {
+      const result = await client.createJob({
+        name,
+        description,
+        schedule,
+        command,
+        workingDirectory,
+        environment,
+        persistent
+      });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("update_job", "Update a scheduled job (Linux systemd only)", {
+    name: exports_external.string().describe("Job name to update"),
+    description: exports_external.optional(exports_external.string()).describe("New description"),
+    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"),
+    persistent: exports_external.optional(exports_external.boolean()).describe("Run missed executions on next boot")
+  }, async ({ name, description, schedule, command, workingDirectory, environment, persistent }) => {
+    try {
+      const result = await client.updateJob(name, {
+        description,
+        schedule,
+        command,
+        workingDirectory,
+        environment,
+        persistent
+      });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("delete_job", "Delete a scheduled job (Linux systemd user jobs only)", {
+    name: exports_external.string().describe("Job name to delete")
+  }, async ({ name }) => {
+    try {
+      const result = await client.deleteJob(name);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("enable_job", "Enable a scheduled job's timer so it runs on schedule", {
+    name: exports_external.string().describe("Job name"),
+    scope: exports_external.optional(exports_external.enum(["user", "system"])).describe("Job scope (default: user)")
+  }, async ({ name, scope }) => {
+    try {
+      const result = await client.enableJob(name, scope);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("disable_job", "Disable a scheduled job's timer so it stops running", {
+    name: exports_external.string().describe("Job name"),
+    scope: exports_external.optional(exports_external.enum(["user", "system"])).describe("Job scope (default: user)")
+  }, async ({ name, scope }) => {
+    try {
+      const result = await client.disableJob(name, scope);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+  server.tool("run_job_now", "Trigger immediate execution of a scheduled job", {
+    name: exports_external.string().describe("Job name"),
+    scope: exports_external.optional(exports_external.enum(["user", "system"])).describe("Job scope (default: user)")
+  }, async ({ name, scope }) => {
+    try {
+      const result = await client.runJobNow(name, scope);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+};
+var init_jobs = __esm(() => {
+  init_zod2();
+  init_utils();
+  JobScopeSchema = exports_external.enum(["all", "user", "system"]);
+});
+
 // cli/src/mcp/tools/index.ts
 function registerTools(server, client) {
   registerCoreTools(server, client);
@@ -46415,6 +46669,7 @@ function registerTools(server, client) {
   registerMemoryTools(server, client);
   registerMemoryFileTools(server, client);
   registerSearchTools(server, client);
+  registerJobTools(server, client);
 }
 var init_tools = __esm(() => {
   init_core5();
@@ -46435,6 +46690,7 @@ var init_tools = __esm(() => {
   init_memory_file();
   init_messaging();
   init_search();
+  init_jobs();
   init_types4();
 });
 
@@ -46453,7 +46709,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "4.1.0"
+    version: "4.1.2"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48802,7 +49058,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "4.1.0",
+      "version": "4.1.2",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -50115,7 +50371,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "4.1.0",
+  version: "4.1.2",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",