@bojackduy/opencode-loopd 1.7.0 → 1.7.2

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.7.0 (2026-08-25) — Scheduled Intervals
+
+> Interval requeue for repetitive dialogues — one `/goal` covers `monitor deploy` `periodic tests` `keep going` without manual re-prompt. `5s` `createScheduleWorker` resurrects `complete → active` with `Scheduled tick N/M`.
+
+### Added
+
+- **Scheduled intervals** — `GoalConfig.schedule {everyMs, maxRuns}` (`src/domain/goal.ts:100`), `scheduleEveryMs`/`scheduleMaxRuns` args on `loopd_create_goal` (`src/server/goal-tools.ts:56`), min 1000, `maxRuns` total incl initial (`src/server/goal-tools.ts:83` validation).
+- **Schedule worker** — `src/application/schedule-worker.ts:28` `createScheduleWorker` `intervalMs 5000` scans `complete` scheduled goals, `skip-if-running` (lease/`phase` `running/queued/compacting` + `workspaceWrite` single-writer gate `src/application/goal-service.ts:83`), resurrects `complete→active` `phase=idle` `lastScheduleAt`, injects inbox `Scheduled tick N/M — re-execute objective`, then `continueTurn`.
+- **State v6** — `CURRENT_VERSION 6` `src/infrastructure/state-repository.ts:12`, `scheduleRunCount`/`nextRunAt`/`lastScheduleAt` on `GoalRuntimeState` (`src/domain/runtime.ts:115`), `v5→v6` migration with validation, `createRuntimeState` init `scheduleRunCount 0` (`src/application/goal-service.ts:225`), `complete_goal` counts `scheduleRunCount` and sets `nextRunAt=now+everyMs` while `count < maxRuns` and clears stale lease `leaseExpiresAt`/`activeRunID` (`src/server/goal-tools.ts:377` fix).
+- **Plugin wiring** — `createScheduleWorker` started lazily with `engine`+`worker` in `src/server/plugin.ts:31`, `dispose` stops it.
+- **Owner visibility** — `inspect_background_goal` exposes `config.schedule` + `runtime scheduleRunCount/nextRunAt/lastScheduleAt` (`src/server/owner-tools.ts:105`, `src/server/goal-tools.ts:540`).
+- **Tests** — `test/application/schedule-worker.test.ts:1` 6 tests (resurrect due, skip-if-running, maxRuns, writer serialization, concurrent `workspaceWrite:false`, future `nextRunAt`); `test/infrastructure/state-store.test.ts:42` updated to `version 6`; total `165` pass.
+
+### Fixed
+
+- **Stale lease blocked schedule** — `complete_goal` now clears `leaseExpiresAt`/`turnStartedAt`/`activeRunID`/`activePromptMessageID` on `complete`; previous left `5m` lease valid while `phase idle`, so `schedule.tick` saw `leaseIsValid` and skipped until expiry.
+
+### Live proof
+
+- `sched-live-verify` `09cb837c` `10s` `maxRuns 3` `workspaceWrite:false` → `tick.txt` `3` lines `02:00:56` `02:03:43` `02:05:47` `runCount 3` `scheduleRunCount 3` `nextRunAt None` `165` tests still pass; `schedule.tick` events `02:01:29` `02:04:29`.
+
 ## 1.6.0 (2026-08-24) — Hardened Lifecycle
 
 > Merge `feat/goal-evaluation` (43 files, +5516 / -1001 since `1.5.3` `5461e0d`). Hardens prompt correlation, maintenance recovery, workspace serialization, and evaluator verification.

package/README.md

@@ -19,13 +19,14 @@
 - **Codex-style engine-driven loop** — idle detection → continuation steering with accumulated context (progress history, transcript tail, inbox). No prompt spam in the parent.
 - **Parent ↔ child visibility** — `list/inspect/read_transcript/send_input` give the parent full observability. Bidirectional inbox lets you steer mid-run.
 - **Safe by default** — per-goal artifact isolation (`.opencode/loopd/goals/<id>/`), `maxTurns`/`maxFailures`/`maxNoProgress`, force-finish → semantic `complete_goal` summary → parent notification via wake-up injection.
+- **Scheduled intervals** — `scheduleEveryMs`/`scheduleMaxRuns` auto-requeues the same goal every N ms (e.g., `10s` monitor, `1h` report) without manual `/goal` spam — `5s` poll, `skip-if-running`, `workspaceWrite` serialization, inbox `Scheduled tick N/M`.
 - **Modal TUI dashboard** — `<leader>d` or `/loop` opens a focused dialog (no leak to chat prompt). Vim-style navigation, live running indicator, per-status borders.
 
 Keywords: `opencode` `opencode-plugin` `background-agent` `autonomous` `subagent` `loop` `goal` `tui` `codex` `claude-code` `worker`
 
 ## What it is
 
-opencode-loopd is an **OpenCode plugin** (server + TUI) that adds **background goals** to OpenCode. Each goal owns a **worker (child) subagent** that loops autonomously; the **loop engine** drives continuations; the **dashboard** and **owner tools** keep the parent in control. Think *Codex goals* or *Claude Code loop*, but native to OpenCode's session model.
+opencode-loopd is an **OpenCode plugin** (server + TUI) that adds **background goals** to OpenCode. Each goal owns a **worker (child) subagent** that loops autonomously; the **loop engine** drives continuations; the **schedule worker** requeues the same goal on an interval (`scheduleEveryMs`); the **dashboard** and **owner tools** keep the parent in control. Think *Codex goals* or *Claude Code loop*, but native to OpenCode's session model — with scheduled intervals for repetitive dialogues.
 
 ## Install
 
@@ -211,6 +212,7 @@ Completion is semantic: the child writes the summary; the plugin forwards it to
 ```
 
 - **Engine-driven loop** (like Codex): `session.idle` → lease + retry + polling → re-prompt child. Not a parent-driven re-prompt machine.
+- **Scheduled requeue** (1.7): `createScheduleWorker` `5s` scans `complete` goals with `scheduleEveryMs`/`maxRuns`; `complete→active` resurrect with `Scheduled tick N/M` inbox, `skip-if-running` and `workspaceWrite` gate.
 - **Accumulated context**: each continuation includes progress history, transcript tail, inbox messages, and artifact dir (unless objective names another dir).
 - **Parent wake-up**: when the child calls `complete_goal`/`block_goal`, `tool.execute.after` injects the child's semantic summary into the owner's session — you see "Loop goal … completed: …" without polling.
 
@@ -245,6 +247,8 @@ Goals accept:
 | `maxNoProgress` | `3` | Turns without progress before force-finish |
 | `timeoutMs` | `300000` | Per-turn lease (5 min) |
 | `compactEvery` | — | Compact child every N turns |
+| `scheduleEveryMs` | — | Interval in ms to auto-requeue the same goal after each completion. Minimum 1000. Enables repetitive dialogue reduction without manual re-prompt |
+| `scheduleMaxRuns` | — | Maximum total runs including the initial run. Undefined = unlimited. Requires `scheduleEveryMs` |
 | `checks` | `[]` | Shell commands that must pass for `complete_goal` |
 | `checkCwd` | artifact directory | Directory where completion checks run; workspace writes default to project root |
 | `workspaceWrite` | `true` | Marks shared-workspace mutation; only one active workspace writer is allowed. Set `false` explicitly for artifact-only/read-only work |
@@ -259,6 +263,29 @@ prevent concurrent agents or `git stash` operations from overwriting each
 other. Artifact-only research goals may run concurrently by setting
 `workspaceWrite: false` explicitly.
 
+## Scheduled goals — repetitive dialogues without manual re-prompt
+
+One `/goal` can now loop on an interval — the engine requeues the **same goal** after each `complete`:
+
+```
+loopd_create_goal({
+  name: "hourly-report",
+  objective: "Append date -u to tick.txt each run",
+  agent: "smart-agent",
+  checks: ["test -f tick.txt"],
+  scheduleEveryMs: 3600000, // 1h, min 1000
+  scheduleMaxRuns: 24,      // total incl initial, omit for unlimited
+  workspaceWrite: false
+})
+```
+
+- **Poll:** `5s` `createScheduleWorker` scans `complete` scheduled goals; `skip-if-running` (lease/`phase`/`workspaceWrite` gate).
+- **Resurrect:** `complete → active` `phase=idle`, injects inbox `Scheduled tick N/M — re-execute objective`, then `continueTurn`.
+- **State:** `scheduleRunCount`/`nextRunAt`/`lastScheduleAt` (`v6` `state.json`), `schedule.tick` events, `schedule.resurrected` server log.
+- **Live proof:** `sched-live-verify` `09cb837c` `10s` `maxRuns 3` → `tick.txt` `3` lines `02:00:56` `02:03:43` `02:05:47` with `runCount 3`.
+
+Without schedule you’d send `/goal` 3× manually; with schedule one creation covers `monitor deploy`, `periodic tests`, `keep going until done`.
+
 ## Dashboard tips
 
 - Press `:` then type bare text → sent as `send_goal_input` to the selected goal.

package/dist/server.js

@@ -499,7 +499,7 @@ function resolveGoalCreationConfig(input) {
   const agent = explicitAgent || defaultAgent || undefined;
   const workspaceWrite = requested.workspaceWrite ?? true;
   const explicitChecks = cleanList(requested.checks);
-  const defaultChecks = workspaceWrite ? cleanList(defaults.defaultChecks) : [];
+  const defaultChecks = workspaceWrite ? cleanList(defaults.defaultChecks || ["bun test"]) : [];
   const checks = explicitChecks.length > 0 ? explicitChecks : defaultChecks;
   if (workspaceWrite && checks.length === 0) {
     return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@bojackduy/opencode-loopd",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "Codex-inspired background goal engine for OpenCode — autonomous subagents, engine-driven loop, child worker sessions and modal TUI dashboard. Like Claude Code loop for OpenCode.",
   "type": "module",
   "license": "AGPL-3.0-only",

package/scripts/fix-lease.mjs

@@ -1,15 +0,0 @@
-import { mutateState } from "../src/infrastructure/state-repository.ts"
-const dir = "/Users/duytrinh/Code/opencode-loopd"
-const id = "54118aa8-ff7b-471c-b9f4-eab9cf537c41"
-await mutateState(dir, "fix-lease", async (s)=>{
-  const r = s.runtimes.find(x=>x.goalID===id)
-  if (r) {
-    r.leaseExpiresAt = undefined
-    r.turnStartedAt = undefined
-    r.activeRunID = undefined
-    r.activePromptMessageID = undefined
-    console.log("cleared lease", r.phase, r.leaseExpiresAt)
-  }
-  return s
-})
-console.log("fixed")

package/scripts/manual-tick.mjs

@@ -1,15 +0,0 @@
-import { readState } from "../src/infrastructure/state-repository.ts"
-import { createScheduleWorker } from "../src/application/schedule-worker.ts"
-import { createGoalService } from "../src/application/goal-service.ts"
-const dir = "/Users/duytrinh/Code/opencode-loopd"
-const mockHost = { createWorker: async()=>{}, promptWorker: async()=>{}, sessionStatus: async()=>"idle", abortSession: async()=>{}, readMessages: async()=>[], compactSession: async()=>{}, notifyOwner: async(e)=>console.log("notify",e)}
-const svc = createGoalService(mockHost)
-svc.continueTurn = async (d, id)=>{ console.log("continueTurn", id)}
-const w = createScheduleWorker({directory: dir, goalService: svc})
-const state = await readState(dir)
-for (const g of state.goals) if (g.id==="54118aa8-ff7b-471c-b9f4-eab9cf537c41") console.log("goal", g.config.schedule, state.runtimes.find(r=>r.goalID===g.id))
-console.log("tick...")
-const n = await w.tick()
-console.log("resurrected", n)
-const after = await readState(dir)
-console.log("after", after.goals.find(g=>g.id==="54118aa8-ff7b-471c-b9f4-eab9cf537c41").status, after.runtimes.find(r=>r.goalID==="54118aa8-ff7b-471c-b9f4-eab9cf537c41"))

package/scripts/patch-schedule.mjs

@@ -1,19 +0,0 @@
-import { readState, mutateState } from "../src/infrastructure/state-repository.ts"
-const dir = "/Users/duytrinh/Code/opencode-loopd"
-const id = "54118aa8-ff7b-471c-b9f4-eab9cf537c41"
-await mutateState(dir, "patch-schedule", async (s)=>{
-  const g = s.goals.find(x=>x.id===id)
-  if (g) {
-    g.config.schedule = { everyMs: 10000, maxRuns: 3 }
-    console.log("patched", g.config.schedule)
-  }
-  const r = s.runtimes.find(x=>x.goalID===id)
-  if (r) {
-    r.scheduleRunCount = 0
-    console.log("runtime before", r.scheduleRunCount)
-  }
-  return s
-})
-const state = await readState(dir)
-const g = state.goals.find(x=>x.id===id)
-console.log("after", g.config.schedule)