wildcrane-runner 0.4.0 → 0.6.0

package/README.md

@@ -4,9 +4,9 @@ WildCrane's Local Runner. It connects this computer to WildCrane and runs the ta
 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
@@ -23,9 +23,17 @@ names, and falls back to the previous one if the new one does not start.
   `~/.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 its inbox's own folder, `~/.wildcrane/<account>/inboxes/<project>/.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 whichever of those the task's runtime names.
 
@@ -34,8 +42,10 @@ names, and falls back to the previous one if the new one does not start.
 `npm install` here (it builds `dist/`), `npm test`, `npm run lint`. The Runner bundles the CLI's
 harness, session and Realtime code from `../cli/src`, and the CLI itself into `dist/akb/`, so
 `cli/` needs its own `npm install`.
-Releasing: raise `version`, push the tag `runner-v<version>`, then in `cloud/` run
-`npm run runner-release candidate <version> <percent>` and widen it to `stable`.
+Releasing: raise `version`, `npm run build`, and `npm publish --provenance=false` from this
+folder with an npm token (trusted publishing is not set up, so the `runner-v*` workflow cannot
+publish). Then in `cloud/` run `npm run runner-release candidate <version> <percent>` and widen
+it to `stable`; raise `RUNNER_MIN_PROTOCOL` only after that, and after a plugin release.
 
 The desktop app is `desktop/`: a Tauri 2 shell running the bundled Node on `dist/launcher.mjs`
 with `WILDCRANE_DESKTOP=1`; the two speak JSON lines (`src/desktop.ts`). It needs Rust.

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
   }