opencode-jobs 1.0.0 → 1.1.0

package/README.md

@@ -79,11 +79,16 @@ opencode-jobs uninstall --purge
 ```text
 opencode-jobs install [projectDir]
 opencode-jobs uninstall [projectDir] [--purge]
+opencode-jobs list [projectDir]
+opencode-jobs enable [projectDir]
+opencode-jobs disable [projectDir]
+opencode-jobs run <slug> [projectDir]
 ```
 
 The CLI is installed as the `opencode-jobs` npm executable. `projectDir`
-defaults to the current directory. Both commands print a JSON result so they
-can also be used from setup scripts and CI.
+defaults to the current directory. The management commands mirror the plugin's
+list, project enable/disable, and immediate-run operations. All commands print
+JSON results so they can also be used from setup scripts and CI.
 
 ## Tools
 

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import path8 from "node:path";
+import path9 from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/install.ts
@@ -39,6 +39,9 @@ function scopeDirectory(scopeId) {
 function runsDirectory(scopeId) {
   return path.join(jobsStateDirectory(), "runs", scopeId);
 }
+function runsFile(scopeId, slug) {
+  return path.join(runsDirectory(scopeId), `${slug}.jsonl`);
+}
 function sessionStateDirectory(scopeId) {
   return path.join(jobsStateDirectory(), "sessions", scopeId);
 }
@@ -843,6 +846,16 @@ Hint: no systemd user session is reachable. Over SSH try enabling lingering: log
   }
   return "";
 }
+function isTimerLoaded(base) {
+  const result = systemctl([
+    "show",
+    timerUnit(base),
+    "-p",
+    "LoadState",
+    "--value"
+  ]);
+  return result.ok && result.stdout !== "not-found";
+}
 function timerStatus(base) {
   const result = systemctl([
     "show",
@@ -880,17 +893,25 @@ function writeJobUnits(job, workdir, scopeId, opencodeBin, pathEnvironment) {
 }
 function removeJobUnits(scopeId, slug) {
   const base = unitBase(scopeId, slug);
-  systemctl(["disable", "--now", timerUnit(base)]);
-  for (const file of [
+  const files = [
     path4.join(systemdUserDirectory(), timerUnit(base)),
     path4.join(systemdUserDirectory(), serviceUnit(base))
-  ]) {
+  ];
+  const script = runScriptPath(scopeId, slug);
+  if ([...files, script].every((file) => !existsSync2(file)) && !isTimerLoaded(base)) {
+    return;
+  }
+  const disable = systemctl(["disable", "--now", timerUnit(base)]);
+  if (!disable.ok) {
+    return `${timerUnit(base)}: ${disable.stderr}${systemdHint(disable.stderr)}`;
+  }
+  for (const file of files) {
     if (existsSync2(file))
       rmSync(file);
   }
-  const script = runScriptPath(scopeId, slug);
   if (existsSync2(script))
     rmSync(script);
+  return;
 }
 function removeStaleUnits(scopeId, expectedSlugs) {
   const prefix = `opencode-sched-${scopeId}-`;
@@ -966,7 +987,7 @@ ${errors.join(`
     lines.push(`Removed stale units for deleted jobs: ${removed.join(", ")}`);
   lines.push(...describeJobSchedules(jobs, scopeId));
   if (failures.length > 0)
-    lines.push(`Timer activation failures:
+    throw new Error(`Timer activation failures:
 ${failures.join(`
 `)}`);
   return lines.join(`
@@ -987,9 +1008,19 @@ function disableProject(workdir) {
   const entry = registryEntry(abs);
   if (entry === undefined)
     return `Project is not enabled: ${abs}`;
-  for (const slug of entry.jobs)
-    removeJobUnits(entry.scopeId, slug);
-  systemctl(["daemon-reload"]);
+  const failures = entry.jobs.flatMap((slug) => {
+    const failure = removeJobUnits(entry.scopeId, slug);
+    return failure === undefined ? [] : [failure];
+  });
+  if (failures.length > 0) {
+    throw new Error(`Timer removal failures:
+${failures.join(`
+`)}`);
+  }
+  const reload = systemctl(["daemon-reload"]);
+  if (!reload.ok) {
+    throw new Error(`systemctl --user daemon-reload failed: ${reload.stderr}${systemdHint(reload.stderr)}`);
+  }
   const registry = loadRegistry();
   const { [abs]: _omitted, ...remainingProjects } = registry.projects;
   registry.projects = remainingProjects;
@@ -1252,6 +1283,159 @@ function uninstallProject(projectDirectory, packageDirectory, shouldPurge) {
   return uninstall;
 }
 
+// src/management.ts
+import { spawn } from "node:child_process";
+import { closeSync, existsSync as existsSync6, mkdirSync as mkdirSync4, openSync } from "node:fs";
+import path8 from "node:path";
+
+// src/runs.ts
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { z as z4 } from "zod";
+var optionalString = z4.string().optional().catch(undefined);
+var optionalNumber = z4.number().optional().catch(undefined);
+var runRecordSchema = z4.object({
+  runId: optionalString,
+  slug: optionalString,
+  scopeId: optionalString,
+  startedAt: optionalNumber,
+  finishedAt: optionalNumber,
+  durationMs: optionalNumber,
+  status: optionalString,
+  exitCode: optionalNumber,
+  sessionId: optionalString,
+  startedBy: optionalString,
+  worktreeBranch: optionalString,
+  worktreeCommit: optionalString
+});
+function readRunRecords(scopeId, slug, limit) {
+  const file = runsFile(scopeId, slug);
+  if (!existsSync5(file))
+    return [];
+  const records = [];
+  for (const line of readFileSync4(file, "utf8").split(`
+`)) {
+    if (line.trim().length === 0)
+      continue;
+    try {
+      const value = JSON.parse(line);
+      const result = runRecordSchema.safeParse(value);
+      if (result.success)
+        records.push(result.data);
+    } catch {}
+  }
+  return records.slice(-limit);
+}
+function lastFinishedRun(records) {
+  for (const record of records.toReversed()) {
+    if (record.status !== undefined && record.status !== "running")
+      return record;
+  }
+  return;
+}
+function timestampOf(record) {
+  if (record.finishedAt !== undefined)
+    return new Date(record.finishedAt * 1000).toISOString();
+  if (record.startedAt !== undefined)
+    return new Date(record.startedAt * 1000).toISOString();
+  return "?";
+}
+function formatRunLine(record) {
+  const duration = record.durationMs === undefined ? "" : ` (${String(Math.round(record.durationMs / 1000))}s)`;
+  const code = record.exitCode === undefined ? "" : ` exit ${String(record.exitCode)}`;
+  const session = record.sessionId === undefined || record.sessionId.length === 0 ? "" : ` session ${record.sessionId}`;
+  const worktree = record.worktreeBranch === undefined || record.worktreeBranch.length === 0 ? "" : ` worktree ${record.worktreeBranch}` + (record.worktreeCommit === undefined || record.worktreeCommit.length === 0 ? "" : `@${record.worktreeCommit.slice(0, 7)}`);
+  return `${timestampOf(record)} ${record.status ?? "?"}${code}${duration}${session}${worktree} via ${record.startedBy ?? "?"}`;
+}
+function tailFile(file, lines, maxChars) {
+  if (!existsSync5(file))
+    return;
+  const content = readFileSync4(file, "utf8").trimEnd();
+  if (content.length === 0)
+    return "";
+  const tail = content.split(`
+`).slice(-lines).join(`
+`);
+  return tail.length > maxChars ? `...${tail.slice(-maxChars)}` : tail;
+}
+
+// src/management.ts
+function tryParseCron(schedule) {
+  try {
+    return parseCron(schedule);
+  } catch {
+    return;
+  }
+}
+function listJobs(directory) {
+  const { jobs, errors } = loadJobs(directory);
+  const entry = registryEntry(directory);
+  const header = entry ? `Project enabled (scope ${entry.scopeId}). Job definitions: ${jobsDirectory(directory)}` : `Project not enabled. Job definitions: ${jobsDirectory(directory)}`;
+  const lines = [header];
+  if (jobs.length === 0)
+    lines.push("No job definitions. Create one with schedule_job.");
+  for (const job of jobs) {
+    const scopeId = entry?.scopeId ?? deriveScopeId(directory);
+    const sets = tryParseCron(job.schedule);
+    if (sets === undefined) {
+      lines.push(`- ${job.slug}: INVALID schedule "${job.schedule}"`);
+      continue;
+    }
+    const records = readRunRecords(scopeId, job.slug, 20);
+    const last = lastFinishedRun(records);
+    const lastDesc = last === undefined ? ", last: never" : `, last: ${last.status ?? "?"} ${formatRunLine(last)}`;
+    const next = entry === undefined ? undefined : timerStatus(unitBase(scopeId, job.slug)).next;
+    const nextDesc = next === undefined ? "" : `, next: ${next}`;
+    lines.push(`- ${job.slug}: ${job.schedule} (${describeCron(sets)})${nextDesc}${lastDesc}`);
+  }
+  lines.push(...errors.map((error) => `! ${error}`));
+  return { ok: true, output: lines.join(`
+`) };
+}
+function runJobNow(slugInput, directory) {
+  const slug = slugify(slugInput);
+  const file = path8.join(jobsDirectory(directory), `${slug}.json`);
+  if (!existsSync6(file)) {
+    return {
+      ok: false,
+      output: `No job "${slug}" in ${jobsDirectory(directory)}`
+    };
+  }
+  const entry = registryEntry(directory);
+  if (entry === undefined) {
+    return {
+      ok: false,
+      output: `Project is not enabled, so no run script exists for "${slug}". Run enable_project first.`
+    };
+  }
+  const script = runScriptPath(entry.scopeId, slug);
+  if (!existsSync6(script)) {
+    return {
+      ok: false,
+      output: `Run script missing for "${slug}". Run enable_project to (re)install units.`
+    };
+  }
+  const log = logFile(entry.scopeId, slug);
+  mkdirSync4(logDirectory(entry.scopeId), { recursive: true });
+  const fd = openSync(log, "a");
+  const child = spawn("/bin/sh", [script], {
+    cwd: path8.resolve(directory),
+    env: { ...process.env, OPENCODE_JOBS_STARTED_BY: "manual" },
+    stdio: ["ignore", fd, fd]
+  });
+  child.unref();
+  closeSync(fd);
+  const tail = tailFile(log, 5, 2000);
+  const parts = [
+    `Started "${slug}" manually (pid ${String(child.pid)})`,
+    `Log: ${log}`
+  ];
+  if (tail?.length)
+    parts.push(`Log tail:
+${tail}`);
+  return { ok: true, output: parts.join(`
+`) };
+}
+
 // src/cli.ts
 var USAGE = `Usage: opencode-jobs <command> [projectDir]
 
@@ -1259,16 +1443,45 @@ Commands:
   install [projectDir]            Add the plugin and bundled skill to a project (default: current directory)
   uninstall [projectDir] [--purge]  Remove the plugin entry, skill, and systemd units from a project;
                                   --purge also deletes job definitions and job data
+  list [projectDir]               List jobs and their enabled, next-run, and last-run state
+  enable [projectDir]             Enable or re-sync all jobs in a project
+  disable [projectDir]            Disable all jobs in a project while keeping definitions and history
+  run <slug> [projectDir]         Run one enabled job immediately
   help                            Show this help`;
 function packageDirectory() {
-  return path8.resolve(path8.dirname(fileURLToPath(import.meta.url)), "..");
+  return path9.resolve(path9.dirname(fileURLToPath(import.meta.url)), "..");
 }
 function printError(message) {
-  console.error(`Error: ${message}
-
-${USAGE}`);
+  console.log(JSON.stringify({ ok: false, output: `Error: ${message}` }, undefined, 2));
+  console.error(USAGE);
   process.exitCode = 1;
 }
+function projectArgument(command, arguments_) {
+  if (arguments_.some((argument) => argument.startsWith("--"))) {
+    throw new Error(`${command} does not accept options`);
+  }
+  if (arguments_.length > 1) {
+    throw new Error(`${command} accepts at most one project directory`);
+  }
+  return arguments_[0] ?? process.cwd();
+}
+function runArguments(arguments_) {
+  if (arguments_.some((argument) => argument.startsWith("--"))) {
+    throw new Error("run does not accept options");
+  }
+  if (arguments_.length === 0 || arguments_.length > 2) {
+    throw new Error("run requires a job slug and accepts one project directory");
+  }
+  return {
+    slug: arguments_[0] ?? "",
+    project: arguments_[1] ?? process.cwd()
+  };
+}
+function printManagementResult(result) {
+  console.log(JSON.stringify(result, undefined, 2));
+  if (!result.ok)
+    process.exitCode = 1;
+}
 function parseUninstallArguments(arguments_) {
   let project;
   let shouldPurge = false;
@@ -1318,6 +1531,43 @@ if ([undefined, "help", "--help"].includes(command)) {
   } catch (error) {
     printError(errorMessage(error));
   }
+} else if (command !== undefined && ["list", "enable", "disable", "run"].includes(command)) {
+  try {
+    let slug;
+    let project;
+    if (command === "run") {
+      ({ slug, project } = runArguments(rest));
+    } else {
+      project = projectArgument(command, rest);
+    }
+    const migration = migrateStorage(project, true);
+    for (const warning of migration.warnings) {
+      console.error(`storage migration warning: ${warning}`);
+    }
+    switch (command) {
+      case "list": {
+        printManagementResult(listJobs(project));
+        break;
+      }
+      case "enable": {
+        printManagementResult({ ok: true, output: enableProject(project) });
+        break;
+      }
+      case "disable": {
+        printManagementResult({ ok: true, output: disableProject(project) });
+        break;
+      }
+      case "run": {
+        printManagementResult(runJobNow(slug ?? "", project));
+        break;
+      }
+      default: {
+        throw new Error(`unknown management command: ${command}`);
+      }
+    }
+  } catch (error) {
+    printError(errorMessage(error));
+  }
 } else {
   printError(`unknown command: ${command ?? "(missing)"}`);
 }

package/dist/index.js

@@ -3,16 +3,8 @@
 import {
   tool
 } from "@opencode-ai/plugin";
-import {
-  closeSync,
-  existsSync as existsSync4,
-  mkdirSync as mkdirSync3,
-  openSync,
-  readFileSync as readFileSync4,
-  rmSync as rmSync2
-} from "fs";
-import { spawn } from "child_process";
-import path6 from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, rmSync as rmSync2 } from "fs";
+import path7 from "path";
 
 // src/cron.ts
 var DOW_LABELS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
@@ -951,6 +943,16 @@ Hint: no systemd user session is reachable. Over SSH try enabling lingering: log
   }
   return "";
 }
+function isTimerLoaded(base) {
+  const result = systemctl([
+    "show",
+    timerUnit(base),
+    "-p",
+    "LoadState",
+    "--value"
+  ]);
+  return result.ok && result.stdout !== "not-found";
+}
 function timerStatus(base) {
   const result = systemctl([
     "show",
@@ -988,17 +990,25 @@ function writeJobUnits(job, workdir, scopeId, opencodeBin, pathEnvironment) {
 }
 function removeJobUnits(scopeId, slug) {
   const base = unitBase(scopeId, slug);
-  systemctl(["disable", "--now", timerUnit(base)]);
-  for (const file of [
+  const files = [
     path4.join(systemdUserDirectory(), timerUnit(base)),
     path4.join(systemdUserDirectory(), serviceUnit(base))
-  ]) {
+  ];
+  const script = runScriptPath(scopeId, slug);
+  if ([...files, script].every((file) => !existsSync3(file)) && !isTimerLoaded(base)) {
+    return;
+  }
+  const disable = systemctl(["disable", "--now", timerUnit(base)]);
+  if (!disable.ok) {
+    return `${timerUnit(base)}: ${disable.stderr}${systemdHint(disable.stderr)}`;
+  }
+  for (const file of files) {
     if (existsSync3(file))
       rmSync(file);
   }
-  const script = runScriptPath(scopeId, slug);
   if (existsSync3(script))
     rmSync(script);
+  return;
 }
 function removeStaleUnits(scopeId, expectedSlugs) {
   const prefix = `opencode-sched-${scopeId}-`;
@@ -1075,7 +1085,7 @@ ${errors.join(`
     lines.push(`Removed stale units for deleted jobs: ${removed.join(", ")}`);
   lines.push(...describeJobSchedules(jobs, scopeId));
   if (failures.length > 0)
-    lines.push(`Timer activation failures:
+    throw new Error(`Timer activation failures:
 ${failures.join(`
 `)}`);
   return lines.join(`
@@ -1096,9 +1106,19 @@ function disableProject(workdir) {
   const entry = registryEntry(abs);
   if (entry === undefined)
     return `Project is not enabled: ${abs}`;
-  for (const slug of entry.jobs)
-    removeJobUnits(entry.scopeId, slug);
-  systemctl(["daemon-reload"]);
+  const failures = entry.jobs.flatMap((slug) => {
+    const failure = removeJobUnits(entry.scopeId, slug);
+    return failure === undefined ? [] : [failure];
+  });
+  if (failures.length > 0) {
+    throw new Error(`Timer removal failures:
+${failures.join(`
+`)}`);
+  }
+  const reload = systemctl(["daemon-reload"]);
+  if (!reload.ok) {
+    throw new Error(`systemctl --user daemon-reload failed: ${reload.stderr}${systemdHint(reload.stderr)}`);
+  }
   const registry = loadRegistry();
   const { [abs]: _omitted, ...remainingProjects } = registry.projects;
   registry.projects = remainingProjects;
@@ -1111,13 +1131,10 @@ function disableProject(workdir) {
 `);
 }
 
-// src/tools.ts
-function ok(output) {
-  return { output };
-}
-function fail(message) {
-  return { output: `Error: ${message}`, metadata: { error: true } };
-}
+// src/management.ts
+import { spawn } from "child_process";
+import { closeSync, existsSync as existsSync4, mkdirSync as mkdirSync3, openSync } from "fs";
+import path6 from "path";
 function tryParseCron(schedule) {
   try {
     return parseCron(schedule);
@@ -1125,7 +1142,7 @@ function tryParseCron(schedule) {
     return;
   }
 }
-function listJobsOutput(directory) {
+function listJobs(directory) {
   const { jobs, errors } = loadJobs(directory);
   const entry = registryEntry(directory);
   const header = entry ? `Project enabled (scope ${entry.scopeId}). Job definitions: ${jobsDirectory(directory)}` : `Project not enabled. Job definitions: ${jobsDirectory(directory)}`;
@@ -1147,8 +1164,63 @@ function listJobsOutput(directory) {
     lines.push(`- ${job.slug}: ${job.schedule} (${describeCron(sets)})${nextDesc}${lastDesc}`);
   }
   lines.push(...errors.map((error) => `! ${error}`));
-  return ok(lines.join(`
-`));
+  return { ok: true, output: lines.join(`
+`) };
+}
+function runJobNow(slugInput, directory) {
+  const slug = slugify(slugInput);
+  const file = path6.join(jobsDirectory(directory), `${slug}.json`);
+  if (!existsSync4(file)) {
+    return {
+      ok: false,
+      output: `No job "${slug}" in ${jobsDirectory(directory)}`
+    };
+  }
+  const entry = registryEntry(directory);
+  if (entry === undefined) {
+    return {
+      ok: false,
+      output: `Project is not enabled, so no run script exists for "${slug}". Run enable_project first.`
+    };
+  }
+  const script = runScriptPath(entry.scopeId, slug);
+  if (!existsSync4(script)) {
+    return {
+      ok: false,
+      output: `Run script missing for "${slug}". Run enable_project to (re)install units.`
+    };
+  }
+  const log = logFile(entry.scopeId, slug);
+  mkdirSync3(logDirectory(entry.scopeId), { recursive: true });
+  const fd = openSync(log, "a");
+  const child = spawn("/bin/sh", [script], {
+    cwd: path6.resolve(directory),
+    env: { ...process.env, OPENCODE_JOBS_STARTED_BY: "manual" },
+    stdio: ["ignore", fd, fd]
+  });
+  child.unref();
+  closeSync(fd);
+  const tail = tailFile(log, 5, 2000);
+  const parts = [
+    `Started "${slug}" manually (pid ${String(child.pid)})`,
+    `Log: ${log}`
+  ];
+  if (tail?.length)
+    parts.push(`Log tail:
+${tail}`);
+  return { ok: true, output: parts.join(`
+`) };
+}
+
+// src/tools.ts
+function ok(output) {
+  return { output };
+}
+function fail(message) {
+  return { output: `Error: ${message}`, metadata: { error: true } };
+}
+function managementToolResult(result) {
+  return result.ok ? ok(result.output) : fail(result.output);
 }
 function scheduleJobOutput(input, directory) {
   const slug = slugify(input.slug ?? input.name);
@@ -1192,7 +1264,7 @@ function scheduleJobOutput(input, directory) {
   } catch (error) {
     return fail(errorMessage(error));
   }
-  const existing = loadJobFile(path6.join(jobsDirectory(directory), `${slug}.json`), slug);
+  const existing = loadJobFile(path7.join(jobsDirectory(directory), `${slug}.json`), slug);
   const job = {
     slug,
     name: input.name,
@@ -1221,7 +1293,7 @@ function scheduleJobOutput(input, directory) {
     return ok(lines.join(`
 `));
   }
-  const abs = path6.resolve(directory);
+  const abs = path7.resolve(directory);
   const opencodeBin = findOpencode();
   const pathEnvironment = process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin";
   const base = writeJobUnits(job, abs, entry.scopeId, opencodeBin, pathEnvironment);
@@ -1247,8 +1319,8 @@ function scheduleJobOutput(input, directory) {
 `));
 }
 function showJobOutput(slugInput, directory) {
-  const file = path6.join(jobsDirectory(directory), `${slugify(slugInput)}.json`);
-  if (!existsSync4(file)) {
+  const file = path7.join(jobsDirectory(directory), `${slugify(slugInput)}.json`);
+  if (!existsSync5(file)) {
     return fail(`No job "${slugInput}" in ${jobsDirectory(directory)}. Use list_jobs to see definitions.`);
   }
   const result = loadJobFile(file);
@@ -1273,7 +1345,7 @@ function showJobOutput(slugInput, directory) {
   }
   if (job.session !== undefined) {
     const state = sessionStateFile(scopeId, job.slug);
-    const sessionId = existsSync4(state) ? readFileSync4(state, "utf8").trim() : "";
+    const sessionId = existsSync5(state) ? readFileSync4(state, "utf8").trim() : "";
     lines.push(`Session: ${job.session}${sessionId.length > 0 ? ` \u2014 current ${sessionId}` : " \u2014 no session yet"}`);
   }
   if (job.run.agent !== undefined)
@@ -1308,22 +1380,30 @@ function showJobOutput(slugInput, directory) {
 }
 function removeJobDefinitionOutput(slugInput, directory) {
   const slug = slugify(slugInput);
-  const file = path6.join(jobsDirectory(directory), `${slug}.json`);
-  if (!existsSync4(file))
+  const file = path7.join(jobsDirectory(directory), `${slug}.json`);
+  if (!existsSync5(file))
     return fail(`No job "${slug}" in ${jobsDirectory(directory)}`);
+  const abs = path7.resolve(directory);
+  const entry = registryEntry(directory);
+  if (entry?.jobs.includes(slug)) {
+    const removalFailure = removeJobUnits(entry.scopeId, slug);
+    if (removalFailure !== undefined) {
+      return fail(`Failed to remove systemd units: ${removalFailure}`);
+    }
+    const reload = systemctl(["daemon-reload"]);
+    if (!reload.ok) {
+      return fail(`Removed the units but systemd reload failed: ${reload.stderr}${systemdHint(reload.stderr)}`);
+    }
+  }
   rmSync2(file);
   const lines = [`Deleted job definition .opencode/jobs/${slug}.json`];
-  const scopeId = registryEntry(directory)?.scopeId ?? deriveScopeId(directory);
+  const scopeId = entry?.scopeId ?? deriveScopeId(directory);
   const state = sessionStateFile(scopeId, slug);
-  if (existsSync4(state)) {
+  if (existsSync5(state)) {
     rmSync2(state);
     lines.push(`Removed session state ${state}`);
   }
-  const abs = path6.resolve(directory);
-  const entry = registryEntry(directory);
   if (entry?.jobs.includes(slug)) {
-    removeJobUnits(entry.scopeId, slug);
-    systemctl(["daemon-reload"]);
     const registry = loadRegistry();
     const current = registry.projects[abs];
     if (current !== undefined) {
@@ -1342,40 +1422,6 @@ function omitProject(registry, workdir) {
   const { [workdir]: _omitted, ...remaining } = registry.projects;
   registry.projects = remaining;
 }
-function runJobNowOutput(slugInput, directory) {
-  const slug = slugify(slugInput);
-  const file = path6.join(jobsDirectory(directory), `${slug}.json`);
-  if (!existsSync4(file))
-    return fail(`No job "${slug}" in ${jobsDirectory(directory)}`);
-  const entry = registryEntry(directory);
-  if (entry === undefined) {
-    return fail(`Project is not enabled, so no run script exists for "${slug}". Run enable_project first.`);
-  }
-  const script = runScriptPath(entry.scopeId, slug);
-  if (!existsSync4(script)) {
-    return fail(`Run script missing for "${slug}". Run enable_project to (re)install units.`);
-  }
-  const log = logFile(entry.scopeId, slug);
-  mkdirSync3(logDirectory(entry.scopeId), { recursive: true });
-  const fd = openSync(log, "a");
-  const child = spawn("/bin/sh", [script], {
-    cwd: path6.resolve(directory),
-    env: { ...process.env, OPENCODE_JOBS_STARTED_BY: "manual" },
-    stdio: ["ignore", fd, fd]
-  });
-  child.unref();
-  closeSync(fd);
-  const tail = tailFile(log, 5, 2000);
-  const parts = [
-    `Started "${slug}" manually (pid ${String(child.pid)})`,
-    `Log: ${log}`
-  ];
-  if (tail?.length)
-    parts.push(`Log tail:
-${tail}`);
-  return ok(parts.join(`
-`));
-}
 function jobLogsOutput(slugInput, lineCountInput, directory) {
   const entry = registryEntry(directory);
   const scopeId = entry?.scopeId ?? deriveScopeId(directory);
@@ -1396,7 +1442,7 @@ function listProjectsOutput() {
     return ok("No projects with scheduled jobs are registered.");
   const lines = ["Registry: ~/.config/opencode/jobs/registry.json"];
   for (const entry of entries) {
-    const missing = existsSync4(entry.workdir) ? "" : " [WORKDIR MISSING]";
+    const missing = existsSync5(entry.workdir) ? "" : " [WORKDIR MISSING]";
     lines.push(`- ${entry.workdir}${missing}`, `  scope ${entry.scopeId}, ${String(entry.jobs.length)} job(s): ${entry.jobs.join(", ")}`);
   }
   return ok(lines.join(`
@@ -1405,7 +1451,7 @@ function listProjectsOutput() {
 var listJobsTool = tool({
   description: "List scheduled job definitions for the current project (from .opencode/jobs/), including enabled state, next run, and last run status.",
   args: {},
-  execute: (_input, context) => Promise.resolve(listJobsOutput(context.directory))
+  execute: (_input, context) => Promise.resolve(managementToolResult(listJobs(context.directory)))
 });
 var scheduleJobTool = tool({
   description: "Create or update a scheduled job definition in the current project (.opencode/jobs/<slug>.json, git-committable). Schedule is a 5-field cron expression. Set either prompt (natural language) or command (custom command name). If the project is enabled, systemd units are re-synced automatically.",
@@ -1447,7 +1493,7 @@ var runJobTool = tool({
   args: {
     slug: tool.schema.string().describe("Job slug to run now")
   },
-  execute: (input, context) => Promise.resolve(runJobNowOutput(input.slug, context.directory))
+  execute: (input, context) => Promise.resolve(managementToolResult(runJobNow(input.slug, context.directory)))
 });
 var jobLogsTool = tool({
   description: "Show the tail of a scheduled job's log file (scheduled and manual runs both append to it).",
@@ -1499,16 +1545,16 @@ var jobsTools = {
 };
 
 // src/migration.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, renameSync as renameSync2, rmdirSync } from "fs";
-import path7 from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, renameSync as renameSync2, rmdirSync } from "fs";
+import path8 from "path";
 function legacyJobsStateDirectory() {
-  return path7.join(configRoot(), "opencode", "scheduler");
+  return path8.join(configRoot(), "opencode", "scheduler");
 }
 function legacyRegistryPath() {
-  return path7.join(legacyJobsStateDirectory(), "registry.json");
+  return path8.join(legacyJobsStateDirectory(), "registry.json");
 }
 function legacyDefinitionsDirectory(workdir) {
-  return path7.join(workdir, ".opencode", "scheduler", "jobs");
+  return path8.join(workdir, ".opencode", "scheduler", "jobs");
 }
 function migrationMoves(projects) {
   return [
@@ -1517,12 +1563,12 @@ function migrationMoves(projects) {
       to: jobsStateDirectory()
     },
     {
-      from: path7.join(configRoot(), "opencode", "logs", "scheduler"),
-      to: path7.join(configRoot(), "opencode", "logs", "jobs")
+      from: path8.join(configRoot(), "opencode", "logs", "scheduler"),
+      to: path8.join(configRoot(), "opencode", "logs", "jobs")
     },
     {
-      from: path7.join(stateRoot(), "opencode", "scheduler", "worktrees"),
-      to: path7.join(stateRoot(), "opencode", "jobs", "worktrees")
+      from: path8.join(stateRoot(), "opencode", "scheduler", "worktrees"),
+      to: path8.join(stateRoot(), "opencode", "jobs", "worktrees")
     },
     ...[...projects].map((workdir) => ({
       from: legacyDefinitionsDirectory(workdir),
@@ -1532,25 +1578,25 @@ function migrationMoves(projects) {
 }
 function removeLegacyProjectDirectory(workdir) {
   try {
-    rmdirSync(path7.join(workdir, ".opencode", "scheduler"));
+    rmdirSync(path8.join(workdir, ".opencode", "scheduler"));
   } catch {}
 }
 function migrateStorage(projectDirectory, shouldResync) {
-  const project = path7.resolve(projectDirectory);
+  const project = path8.resolve(projectDirectory);
   const legacyRegistry = legacyRegistryPath();
-  const canonicalRegistry = path7.join(jobsStateDirectory(), "registry.json");
-  const registryFile = existsSync5(legacyRegistry) ? legacyRegistry : canonicalRegistry;
-  const registry = existsSync5(registryFile) ? readRegistryFile(registryFile) : { version: 1, projects: {} };
+  const canonicalRegistry = path8.join(jobsStateDirectory(), "registry.json");
+  const registryFile = existsSync6(legacyRegistry) ? legacyRegistry : canonicalRegistry;
+  const registry = existsSync6(registryFile) ? readRegistryFile(registryFile) : { version: 1, projects: {} };
   const registeredProjects = new Set(Object.keys(registry.projects));
   const projects = new Set([project, ...registeredProjects]);
-  const moves = migrationMoves(projects).filter(({ from }) => existsSync5(from));
+  const moves = migrationMoves(projects).filter(({ from }) => existsSync6(from));
   for (const { from, to } of moves) {
-    if (existsSync5(to)) {
+    if (existsSync6(to)) {
       throw new Error(`Cannot migrate legacy job storage because both paths exist: ${from} and ${to}. Reconcile or back up one path, then retry; neither path was changed.`);
     }
   }
   for (const { from, to } of moves) {
-    mkdirSync4(path7.dirname(to), { recursive: true });
+    mkdirSync4(path8.dirname(to), { recursive: true });
     renameSync2(from, to);
   }
   for (const workdir of projects)

package/dist/management.d.ts

@@ -0,0 +1,9 @@
+export type ManagementResult = {
+    ok: true;
+    output: string;
+} | {
+    ok: false;
+    output: string;
+};
+export declare function listJobs(directory: string): ManagementResult;
+export declare function runJobNow(slugInput: string, directory: string): ManagementResult;

package/dist/systemd.d.ts

@@ -22,5 +22,5 @@ export interface TimerStatus {
 }
 export declare function timerStatus(base: string): TimerStatus;
 export declare function writeJobUnits(job: Job, workdir: string, scopeId: string, opencodeBin: string, pathEnvironment: string): string;
-export declare function removeJobUnits(scopeId: string, slug: string): void;
+export declare function removeJobUnits(scopeId: string, slug: string): string | undefined;
 export declare function removeStaleUnits(scopeId: string, expectedSlugs: Set<string>): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-jobs",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "opencode plugin that schedules recurring agent jobs as systemd user timers, with git-committable job definitions, run history, and session continuity",
   "type": "module",
   "engines": {