wildcrane-runner 0.3.1 → 0.5.0

package/README.md

@@ -1,12 +1,12 @@
 # wildcrane-runner
 
 WildCrane's Local Runner. It connects this computer to WildCrane and runs the tasks WildCrane
-sends on your local Codex or Claude Code.
+sends on your local Claude Code, Codex, OpenCode or Cursor.
 
 - **Mac and Windows**: download WildCrane from the
-  [releases](https://github.com/ai4kanban/ai4kanban/releases/latest). It sits in the menu bar
-  (tray), signs in once, and notifies you when something needs your review. The release notes
-  say how to open the unsigned build the first time.
+  [releases](https://github.com/ai4kanban/ai4kanban/releases?q=desktop-v&expanded=true). It sits
+  in the menu bar (tray), signs in once, and notifies you when something needs your review. The
+  release notes say how to open the unsigned build the first time.
 - **Linux, or no desktop**: run it from a terminal; it runs tasks and shows no notifications.
 
 ```sh
@@ -17,17 +17,25 @@ wildcrane-runner
 The first start opens your browser to sign in. Every start updates to the version WildCrane
 names, and falls back to the previous one if the new one does not start.
 
-- **Node**: 18 or newer.
+- **Node**: 22 or newer.
 - **One computer per account**: a second computer is refused while the first is connected.
 - **Folders**: tasks run in `~/.wildcrane/work/`, or in a project folder listed in
   `~/.wildcrane/projects.json` (`{ "projects": ["/path/to/project"] }`). Any other folder is
   refused. The desktop app writes that list when you add a project in its settings.
 - **Task folders**: a task's jobs share its board, `<project>/.akb/kanban` (kept out of git),
-  or for a task in no project the account's inbox, `~/.wildcrane/<account>/inbox/.akb/kanban`
+  or for a project with no folder here its own one, `~/.wildcrane/cache/<project>/.akb/kanban`
   (a git repository). They run one at a time and sync the card, memory and assets with
-  WildCrane before and after each job. Nothing deletes a task folder; remove old ones by hand.
+  WildCrane before and after each job.
+- **Cache**: what a project keeps here is rebuilt from WildCrane by its next job. At start and
+  once a day the Runner removes a project unused for 7 days or no longer in your account — its
+  whole `cache/<project>/`, or only a linked folder's `.akb/` — unless a job runs there, a
+  delivery is paused there, or its last sync failed.
+- **Runner files**: `~/.wildcrane/bin/` holds the downloaded versions and the `akb` shim.
+- **Periodic agents**: in each project folder it also runs the board's own agents (reflect,
+  describe-project, review-dismissals, prune-memory) and each workflow's scheduled agents, when
+  due by this computer's clock — on your runtime, so they use its quota.
 - **akb**: tasks started from WildCrane run akb's workflows with the copy of `akb` the Runner
-  carries (`dist/akb/`), on Claude Code or Codex.
+  carries (`dist/akb/`), on whichever of those the task's runtime names.
 
 ## Development
 

package/dist/akb/bin/ai4kanban.mjs

@@ -88,14 +88,16 @@ async function rules() {
 
 // The two trees, and the one word that picks between them. `akb raw` takes over the whole
 // command line: its moves take options that collide with the rest — `create`, `archive` and
-// `reject` are words on both sides — so it is handed the line untouched.
+// `reject` are words on both sides — so it is handed the line untouched, bar the shared
+// options typed before `raw`.
 async function main() {
   const argv = process.argv.slice(2)
   const loaded = await rules()
   const shared = { program: PROGRAM, installHint: `\`${PROGRAM} install\`` }
 
-  if (argv[0] === 'raw') {
-    process.exitCode = await loaded.runBoard(argv.slice(1), { ...shared, program: `${PROGRAM} raw` })
+  const raw = loaded.rawArgv(argv)
+  if (raw) {
+    process.exitCode = await loaded.runBoard(raw, { ...shared, program: `${PROGRAM} raw` })
     return
   }