opencode-jobs 0.1.2 → 1.0.0

package/dist/internals.d.ts

@@ -1,6 +1,6 @@
 import { deriveScopeId, shQuote, slugify } from "./paths.js";
 import { cronToOnCalendar, describeCron, parseCron } from "./cron.js";
-import { validateGuard, validateRunSpec, validateSession } from "./job.js";
+import { validateGuard, validateRunSpec, validateSession, validateWorktree } from "./job.js";
 import { buildOpencodeArguments, runScriptContent, serviceContent, timerContent } from "./systemd.js";
 export declare const internals: {
     slugify: typeof slugify;
@@ -12,6 +12,7 @@ export declare const internals: {
     validateRunSpec: typeof validateRunSpec;
     validateGuard: typeof validateGuard;
     validateSession: typeof validateSession;
+    validateWorktree: typeof validateWorktree;
     buildOpencodeArguments: typeof buildOpencodeArguments;
     runScriptContent: typeof runScriptContent;
     serviceContent: typeof serviceContent;

package/dist/job.d.ts

@@ -12,6 +12,11 @@ export interface CommandRun extends RunOptions {
 export type RunSpec = PromptRun | CommandRun;
 export declare const SESSION_MODES: readonly ["new", "persist", "compact", "compact+last"];
 export type SessionMode = (typeof SESSION_MODES)[number];
+export interface WorktreeOptions {
+    base?: string;
+    ref?: string;
+    commitMessage?: string;
+}
 export interface Job {
     slug: string;
     name: string;
@@ -19,6 +24,7 @@ export interface Job {
     run: RunSpec;
     session?: SessionMode;
     guard?: string;
+    worktree?: WorktreeOptions;
     timeoutSeconds?: number;
     createdAt: string;
     updatedAt: string;
@@ -34,6 +40,7 @@ export declare function validateRunSpec(run: unknown, context: string): RunSpec;
 export declare function validateSession(value: unknown, context: string): SessionMode;
 export declare function validateTimeout(value: unknown, context: string): number | undefined;
 export declare function validateGuard(value: unknown, context: string): string | undefined;
+export declare function validateWorktree(value: unknown, context: string): WorktreeOptions | undefined;
 export declare function loadJobFile(file: string, expectedSlug?: string): JobResult;
 export declare function loadJobs(workdir: string): {
     jobs: Job[];

package/dist/migration.d.ts

@@ -0,0 +1,9 @@
+export interface StorageMigration {
+    moved: {
+        from: string;
+        to: string;
+    }[];
+    resyncedProjects: string[];
+    warnings: string[];
+}
+export declare function migrateStorage(projectDirectory: string, shouldResync: boolean): StorageMigration;

package/dist/paths.d.ts

@@ -1,5 +1,8 @@
 export declare function configRoot(): string;
-export declare function schedulerDirectory(): string;
+export declare function stateRoot(): string;
+export declare function worktreesDirectory(scopeId: string): string;
+export declare function locksDirectory(scopeId: string): string;
+export declare function jobsStateDirectory(): string;
 export declare function registryPath(): string;
 export declare function scopeDirectory(scopeId: string): string;
 export declare function runsDirectory(scopeId: string): string;

package/dist/registry.d.ts

@@ -9,6 +9,7 @@ export interface Registry {
     version: 1;
     projects: Record<string, RegistryEntry>;
 }
+export declare function readRegistryFile(file: string): Registry;
 export declare function loadRegistry(): Registry;
 export declare function saveRegistry(registry: Registry): void;
 export declare function registryEntry(workdir: string): RegistryEntry | undefined;

package/dist/runs.d.ts

@@ -10,6 +10,8 @@ declare const runRecordSchema: z.ZodObject<{
     exitCode: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
     sessionId: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     startedBy: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    worktreeBranch: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    worktreeCommit: z.ZodCatch<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type RunRecord = z.infer<typeof runRecordSchema>;
 export declare function readRunRecords(scopeId: string, slug: string, limit: number): RunRecord[];

package/dist/tools.d.ts

@@ -1,2 +1,2 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
-export declare const schedulerTools: Record<string, ToolDefinition>;
+export declare const jobsTools: Record<string, ToolDefinition>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-jobs",
-  "version": "0.1.2",
+  "version": "1.0.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": {

package/skill/opencode-jobs/SKILL.md

@@ -7,13 +7,13 @@ compatibility: opencode on Linux with systemd
 
 # OpenCode Jobs
 
-Use the `opencode-jobs` tools instead of editing systemd units or global
-scheduler state directly.
+Use the `opencode-jobs` tools instead of editing systemd units or global job
+state directly.
 
 ## Workflow
 
 1. Create or update a definition with `schedule_job`. Definitions belong in
-   `.opencode/scheduler/jobs/<slug>.json` and should be committed with the
+   `.opencode/jobs/<slug>.json` and should be committed with the
    project.
 2. Inspect definitions with `list_jobs` or `get_job`.
 3. Run `enable_project` after the first job is created. Run it again to
@@ -34,6 +34,13 @@ scheduler state directly.
   `compact` for summary continuity, or `compact+last` when the previous final
   result must also remain visible.
 - A `guard` is a shell command that must exit zero for the job to run.
+- Set `worktree: true` when the job should not touch the user's checkout:
+  each run gets a fresh git worktree (default base
+  `~/.local/state/opencode/jobs/worktrees/…`, override with
+  `worktree.base`), all changes are committed to a per-run branch
+  `opencode-jobs/<slug>/…`, and the worktree is removed. Overlapping runs
+  of the same job are skipped via a lock; subdirectory projects run in
+  the matching worktree subdirectory. Requires a git repository.
 - Scheduled jobs require Linux, a systemd user session, and an `opencode`
   executable available to the timer environment.