@stringsync/splates 0.0.58 → 0.0.59

package/README.md

@@ -281,6 +281,16 @@ better or worse, and say what to change when one stands out. Fixed rules over
 the counts make those calls, not a model, so the same outcomes always read
 the same.
 
+### Kimi Code
+
+Kimi Code is on the default roster beside Claude and Codex, started as
+`kimi acp`, Kimi's own ACP server. Its installer leaves `kimi` off the PATH,
+so splates runs `KIMI_PATH` when set, else `kimi` on the PATH, else
+`~/.kimi-code/bin/kimi`. A roster written before Kimi joined gains it once,
+when the server starts on a machine with Kimi installed; take it off and it
+stays off. Its models go by their full ids, such as `kimi-code/k3.1-pro`.
+Sign in first with `kimi login`: splates never signs in for it.
+
 ### Optional OpenCode ACP agent
 
 Open **Settings → Setup** and visit the optional OpenCode steps. Check this

package/blockers.d.ts

@@ -0,0 +1,32 @@
+import type { ElsewhereBlocker, ElsewhereBoards } from "@stringsync/splates-server/board";
+/**
+ * Reads `--blocked-by` and `--remove-blocked-by` in the project at `here`:
+ * a number names a task here, `webappwiz#404` or `webappwiz #404` one of
+ * another project, as `boards` finds it, and this project's own slug a task
+ * here. A task of another project that `--blocked-by` names has to be open
+ * there; one `--remove-blocked-by` names need not.
+ */
+export declare function blockerFlags({ boards, here, blockedBy, removeBlockedBy, }: BlockerFlagsOptions): Promise<BlockerFlags>;
+/** What `blockerFlags` reads, and where. */
+export interface BlockerFlagsOptions {
+    boards: ElsewhereBoards;
+    /** This project's main tree. */
+    here: string;
+    /** `--blocked-by`, as given. */
+    blockedBy?: readonly string[];
+    /** `--remove-blocked-by`, as given. */
+    removeBlockedBy?: readonly string[];
+}
+/** The tasks the flags name, here and in other projects. */
+export interface BlockerFlags {
+    blockedBy: number[];
+    blockedElsewhere: ElsewhereBlocker[];
+    /** Those no longer to block it. */
+    unblocked: {
+        ids: number[];
+        elsewhere: {
+            project: string;
+            id: number;
+        }[];
+    };
+}

package/index.js

@@ -1,5 +1,42 @@
 #!/usr/bin/env bun
 // @bun
+var __dispose = Symbol.dispose || /* @__PURE__ */ Symbol.for("Symbol.dispose");
+var __asyncDispose = Symbol.asyncDispose || /* @__PURE__ */ Symbol.for("Symbol.asyncDispose");
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function")
+      throw TypeError('Object expected to be assigned to "using" declaration');
+    var dispose;
+    if (async)
+      dispose = value[__asyncDispose];
+    if (dispose === undefined)
+      dispose = value[__dispose];
+    if (typeof dispose !== "function")
+      throw TypeError("Object not disposable");
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  }, fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e), next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0])
+          return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError)
+      throw error;
+  };
+  return next();
+};
 
 // index.ts
 import { basename as basename2 } from "path";
@@ -48,9 +85,9 @@ async function handOffDev(argv, cwd) {
 // splates.ts
 import { agents } from "@stringsync/splates-server/agents";
 import { attach } from "@stringsync/splates-server/artifacts";
-import { commaList as commaList5 } from "@stringsync/splates-server/comma-list";
+import { commaList as commaList6 } from "@stringsync/splates-server/comma-list";
 import { refuseGroomer as refuseGroomer4 } from "@stringsync/splates-server/conversations";
-import { exits, fail as fail9 } from "@stringsync/splates-server/exit";
+import { exits, fail as fail10 } from "@stringsync/splates-server/exit";
 import { DEFAULT_COUNT, log as showLog } from "@stringsync/splates-server/log";
 import { merge } from "@stringsync/splates-server/merge";
 import { portsLs } from "@stringsync/splates-server/ports";
@@ -59,15 +96,18 @@ import {
   MIGRATING,
   MIGRATION_LIMIT,
   migrateRecords,
+  OpenBoards as OpenBoards2,
   repository as repository10
 } from "@stringsync/splates-server/records";
 import {
   newest,
   recordsFirst,
+  refreshHere,
   rosterOf as rosterOf2,
   seeded as seeded2,
   update
 } from "@stringsync/splates-server/server";
+import { ship } from "@stringsync/splates-server/ship";
 import { addFactTasks } from "@stringsync/splates-server/stats";
 import {
   add,
@@ -244,9 +284,87 @@ splatesArtifact.command("remove").use(repository({ needs: "own" })).description(
 splatesArtifact.command("list").use(repository({ needs: "own" })).description("the artifacts this conversation lists, and their current version").option(...conversation).action(async (opts, ctx) => listArtifacts(ctx, await conversationOf(ctx.service, opts.conversation)));
 splatesArtifact.command("show").use(repository({ needs: "own" })).description("every version of an artifact, and which is current").arg("name", z2.string(), { description: "the artifact's name" }).option(...conversation).action(async (opts, ctx) => listArtifacts(ctx, await conversationOf(ctx.service, opts.conversation), opts.name));
 
+// blockers.ts
+import { commaList as commaList3 } from "@stringsync/splates-server/comma-list";
+import { fail as fail3 } from "@stringsync/splates-server/exit";
+async function blockerFlags({
+  boards,
+  here,
+  blockedBy = [],
+  removeBlockedBy = []
+}) {
+  const ids = [];
+  const blockedElsewhere = [];
+  for (const named of await namedIn(boards, here, blockedBy)) {
+    if (named.project === null) {
+      ids.push(named.id);
+      continue;
+    }
+    const found = await boards.find(named.project, named.id);
+    if (found === null) {
+      fail3("not_found", `the tasks of ${named.written} cannot be read: is ${named.slug} set up with \`splates init\`?`, { blockedBy: named.written });
+    }
+    if (found.status === "merged" || found.status === "removed") {
+      fail3("not_found", `${named.written} is ${found.status === "merged" ? `merged, as ${found.commit}` : "gone, removed without merging"}: nothing waits on it any more`, { blockedBy: named.written });
+    }
+    blockedElsewhere.push({
+      project: named.project,
+      id: named.id,
+      subject: found.subject
+    });
+  }
+  const unblocked = { ids: [], elsewhere: [] };
+  for (const named of await namedIn(boards, here, removeBlockedBy)) {
+    if (named.project === null) {
+      unblocked.ids.push(named.id);
+    } else {
+      unblocked.elsewhere.push({ project: named.project, id: named.id });
+    }
+  }
+  return { blockedBy: ids, blockedElsewhere, unblocked };
+}
+function id(digits) {
+  const parsed = Number(digits);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    fail3("usage", `'${digits}' is not a task number`, { number: digits });
+  }
+  return parsed;
+}
+async function namedIn(boards, here, raw) {
+  const named = [];
+  for (const value of commaList3(raw.join(","))) {
+    const local = /^#?(\d+)$/.exec(value);
+    if (local !== null) {
+      named.push({
+        project: null,
+        slug: "",
+        id: id(local[1]),
+        written: value
+      });
+      continue;
+    }
+    const other = /^#?([\w.-]+)(?:\s+task)?\s*#(\d+)$/i.exec(value);
+    if (other === null) {
+      fail3("usage", `'${value}' is not a task: pass its number, or <project>#<number> for one of another project`, { blockedBy: value });
+    }
+    const slug = other[1];
+    const root = await boards.root(slug);
+    if (root === null) {
+      fail3("not_found", `no splates project '${slug}' on this machine: \`splates projects\` lists them`, { blockedBy: value });
+    }
+    named.push({
+      project: root === here ? null : root,
+      slug,
+      id: id(other[2]),
+      written: `${slug} #${other[2]}`
+    });
+  }
+  return named;
+}
+
 // creds.ts
 import { DEFAULT_TIMEOUT, PROVIDERS } from "@stringsync/splates-server/creds";
-import { fail as fail3 } from "@stringsync/splates-server/exit";
+import { fail as fail4 } from "@stringsync/splates-server/exit";
 import { repository as repository2 } from "@stringsync/splates-server/records";
 import { untilAfter } from "@stringsync/splates-server/tasks";
 import { cli as cli2 } from "webappwiz/cmd";
@@ -296,7 +414,7 @@ splatesCreds.command("wait").use(repository2({ needs: "own" })).description("blo
   await ctx.journal.waiting("creds wait", null, { name: opts.name, until: untilAfter(timeout) }, async () => {
     const ended = await ctx.creds.wait(opts.name, { timeout });
     if (ended === "dismissed") {
-      fail3("dismissed", `${opts.name} was dismissed: carry on without it, or ask the person why`, { name: opts.name });
+      fail4("dismissed", `${opts.name} was dismissed: carry on without it, or ask the person why`, { name: opts.name });
     }
   });
   ctx.log.info(`${color.green("saved")} ${opts.name}`);
@@ -328,7 +446,7 @@ import {
   inspectBatch,
   writeImported
 } from "@stringsync/splates-server/evals";
-import { fail as fail4 } from "@stringsync/splates-server/exit";
+import { fail as fail5 } from "@stringsync/splates-server/exit";
 import { cli as cli3 } from "webappwiz/cmd";
 import { color as color2 } from "webappwiz/log";
 import { z as z4 } from "zod";
@@ -344,7 +462,7 @@ splatesEvals.command("import").description("turn a framework's results into a sp
   const file = resolve3(ctx.ps.cwd(), opts.file);
   const dir = resolve3(ctx.ps.cwd(), opts["batch-dir"]);
   if (!await ctx.fs.exists(file)) {
-    fail4("not_found", `no file at ${file}`, { file });
+    fail5("not_found", `no file at ${file}`, { file });
   }
   const imported = inspectBatch(await inspectLog(ctx, file), opts["pass-at"]);
   await writeImported(dir, imported);
@@ -358,12 +476,12 @@ async function inspectLog(ctx, file) {
       return log;
     }
   } catch {}
-  return fail4("usage", `${file} is no Inspect eval log`, { file });
+  return fail5("usage", `${file} is no Inspect eval log`, { file });
 }
 async function dumped(ctx, file) {
-  const { exitCode, stdout, stderr } = await ctx.ps.spawnCapture(["inspect", "log", "dump", file]).catch(() => fail4("usage", "`inspect` is not on PATH: activate the environment Inspect is installed in, or pass a log written with --log-format json"));
+  const { exitCode, stdout, stderr } = await ctx.ps.spawnCapture(["inspect", "log", "dump", file]).catch(() => fail5("usage", "`inspect` is not on PATH: activate the environment Inspect is installed in, or pass a log written with --log-format json"));
   if (exitCode !== 0) {
-    fail4("usage", `inspect log dump ${file} failed: ${stderr.trim()}`, {
+    fail5("usage", `inspect log dump ${file} failed: ${stderr.trim()}`, {
       file
     });
   }
@@ -371,8 +489,8 @@ async function dumped(ctx, file) {
 }
 
 // hook.ts
-import { commaList as commaList3 } from "@stringsync/splates-server/comma-list";
-import { fail as fail5 } from "@stringsync/splates-server/exit";
+import { commaList as commaList4 } from "@stringsync/splates-server/comma-list";
+import { fail as fail6 } from "@stringsync/splates-server/exit";
 import {
   HookStore,
   hookAdd,
@@ -425,13 +543,13 @@ splatesHook.command("add").use(repository3({ needs: "tasks" })).description("run
   let hook;
   if (opts.run !== "") {
     if (pick != null || opts.prompt !== "") {
-      fail5("usage", "--run goes alone: a shell command runs no agent", {});
+      fail6("usage", "--run goes alone: a shell command runs no agent", {});
     }
     hook = { kind: "run", command: opts.run };
   } else if (pick == null) {
-    fail5("usage", "say what runs: --agent with --prompt, or --run", {});
+    fail6("usage", "say what runs: --agent with --prompt, or --run", {});
   } else if (opts.prompt === "") {
-    fail5("usage", "an agent hook needs --prompt: what to tell it", {});
+    fail6("usage", "an agent hook needs --prompt: what to tell it", {});
   } else {
     hook = { kind: "agent", prompt: opts.prompt, ...pick };
   }
@@ -471,7 +589,7 @@ splatesHook.command("edit").use(repository3({ needs: "tasks" })).description("ch
   const { id, agent, model, effort, ...change } = opts;
   const pick = await assigneeIn(ctx, agent, model, effort);
   if (pick === null) {
-    fail5("usage", "an agent automation needs an agent: name one, or --run", {});
+    fail6("usage", "an agent automation needs an agent: name one, or --run", {});
   }
   await hookEdit({ hooks: storeOf(ctx), log: ctx.log }, id, {
     ...change,
@@ -501,24 +619,24 @@ splatesHook.command("groomer").use(repository3({ needs: "tasks" })).description(
 }).action(async (opts, ctx) => {
   const pick = await assigneeIn(ctx, opts.agent, opts.model, opts.effort);
   if (opts.off === (pick != null)) {
-    fail5("usage", "say how it runs with --agent, or turn it off with --off", {});
+    fail6("usage", "say how it runs with --agent, or turn it off with --off", {});
   }
   await hookGroomer({ hooks: storeOf(ctx), log: ctx.log }, pick ?? null);
 });
 function triggerOf(opts) {
   const given = [opts.event, opts.every, opts.cron].filter((each) => each !== undefined && each !== "");
   if (given.length !== 1) {
-    fail5("usage", "say what sets it off: a task event, --every or --cron, one of them", {});
+    fail6("usage", "say what sets it off: a task event, --every or --cron, one of them", {});
   }
   if (opts.event === undefined || opts.event === "") {
     if (opts.stage !== "" || opts.lane !== "") {
-      fail5("usage", "--stage and --lane narrow a task event, not a schedule", {});
+      fail6("usage", "--stage and --lane narrow a task event, not a schedule", {});
     }
     return opts.every !== "" ? { every: opts.every } : { cron: opts.cron };
   }
   const filter = {};
   if (opts.stage !== "") {
-    filter.stages = stagesNamed(commaList3(opts.stage));
+    filter.stages = stagesNamed(commaList4(opts.stage));
   }
   if (opts.lane !== "") {
     filter.lanes = lanesNamed(opts.lane);
@@ -672,7 +790,7 @@ for (const command of ["pause", "resume"]) {
 import { dirname as dirname2 } from "node:path";
 import { loadConfig } from "@stringsync/splates-server/config";
 import { SYSTEM_STORES as SYSTEM_STORES2 } from "@stringsync/splates-server/creds";
-import { fail as fail6 } from "@stringsync/splates-server/exit";
+import { fail as fail7 } from "@stringsync/splates-server/exit";
 import { Projects } from "@stringsync/splates-server/projects";
 import {
   FORMAT,
@@ -714,7 +832,7 @@ splatesReplica.command("restore").description("with `splates server` stopped, re
   ]);
   const config = await loadConfig(root, { fs: ctx.fs });
   if (config.replica === null) {
-    fail6("usage", "no replica: name one as `replica` in splates.config.ts first");
+    fail7("usage", "no replica: name one as `replica` in splates.config.ts first");
   }
   const replica = openReplica(config.replica, {
     root,
@@ -741,7 +859,7 @@ splatesReplica.command("restore").description("with `splates server` stopped, re
     ].join(`
 `));
   } catch (error) {
-    fail6("usage", error instanceof Error ? error.message : String(error));
+    fail7("usage", error instanceof Error ? error.message : String(error));
   }
 });
 splatesReplica.command("retire").use(repository7({ needs: "own" })).description("after the server moved elsewhere (stop it and check `splates replica status` says caught up first), leave this project's records aside as state.db.moved, so a splates run here finds no stale records and says where the server went").arg("to", z9.string(), {
@@ -762,7 +880,7 @@ async function mainTree(ctx) {
     "--git-common-dir"
   ]);
   if (exitCode !== 0) {
-    fail6("usage", `not a git repository: ${ctx.ps.cwd()}`);
+    fail7("usage", `not a git repository: ${ctx.ps.cwd()}`);
   }
   return dirname2(stdout.trim());
 }
@@ -807,7 +925,7 @@ splatesServer.command("run").description("serve every splates project on this ma
 // setup.ts
 import { dirname as dirname3 } from "node:path";
 import { SYSTEM_STORES as SYSTEM_STORES3 } from "@stringsync/splates-server/creds";
-import { fail as fail7 } from "@stringsync/splates-server/exit";
+import { fail as fail8 } from "@stringsync/splates-server/exit";
 import { splatesHome as splatesHome2 } from "@stringsync/splates-server/models";
 import { Projects as Projects2 } from "@stringsync/splates-server/projects";
 import {
@@ -823,15 +941,15 @@ import { fetchWorkers } from "@stringsync/splates-server/workers";
 import { color as color3 } from "webappwiz/log";
 async function setup(deps, opts) {
   if (opts.step === "" && (opts.skip || opts.unskip || opts.undo)) {
-    fail7("usage", "--skip and --unskip name a step, --undo an area", {});
+    fail8("usage", "--skip and --unskip name a step, --undo an area", {});
   }
   if (opts.undo && (opts.skip || opts.unskip)) {
-    fail7("usage", "--undo names an area, not a step to skip", {
+    fail8("usage", "--undo names an area, not a step to skip", {
       area: opts.step
     });
   }
   if (opts.skip && opts.unskip) {
-    fail7("usage", "--skip or --unskip, not both", { step: opts.step });
+    fail8("usage", "--skip or --unskip, not both", { step: opts.step });
   }
   const machine = await setupOf(deps);
   const { log } = deps;
@@ -1024,10 +1142,10 @@ import {
   tasksNamed as tasksNamed2,
   taskUpdate
 } from "@stringsync/splates-server/board";
-import { commaList as commaList4 } from "@stringsync/splates-server/comma-list";
+import { commaList as commaList5 } from "@stringsync/splates-server/comma-list";
 import { refuseGroomer as refuseGroomer3 } from "@stringsync/splates-server/conversations";
-import { fail as fail8 } from "@stringsync/splates-server/exit";
-import { repository as repository8 } from "@stringsync/splates-server/records";
+import { fail as fail9 } from "@stringsync/splates-server/exit";
+import { OpenBoards, repository as repository8 } from "@stringsync/splates-server/records";
 import {
   DEFAULT_TIMEOUT as DEFAULT_TIMEOUT2,
   taskWait,
@@ -1056,7 +1174,7 @@ function adding(name, description, ready) {
   }).repeated("file", z12.string(), {
     description: "files to attach, comma separated or the flag repeated: copied under .git/splates/tasks/<n>/"
   }).repeated("blocked-by", z12.string(), {
-    description: "numbers of the tasks blocking it, comma separated or the flag repeated: each has to merge before this one starts"
+    description: "the tasks blocking it, comma separated or the flag repeated: a number for one here, <project>#<number> for one of another project (`webappwiz#404`); each has to merge before this one starts"
   }).option("lane", z12.string(), {
     default: "",
     description: "the lane it goes in, at the bottom: a lane's number, `backlog` for the permanent catch-all, or `new` for one of its own (default: none, untriaged)"
@@ -1070,28 +1188,43 @@ function adding(name, description, ready) {
     default: "",
     description: "with --agent: the thinking level, one the agent offers (default: the agent's own)"
   }).action(async (opts, ctx) => {
-    if (ctx.elsewhere !== null && opts.lane !== "") {
-      fail8("not_granted", "a task from another project goes in its untriaged lane, for whoever orchestrates it there to place: leave --lane off", { subject: opts.subject });
+    let __stack = [];
+    try {
+      if (ctx.elsewhere !== null && opts.lane !== "") {
+        fail9("not_granted", "a task from another project goes in its untriaged lane, for whoever orchestrates it there to place: leave --lane off", { subject: opts.subject });
+      }
+      const from = await here(ctx);
+      const assignee = await assigneeIn(ctx, opts.agent, opts.model, opts.effort);
+      const origin = ctx.elsewhere === null ? undefined : {
+        project: ctx.elsewhere,
+        task: ctx.project === undefined ? null : ctx.service.taskFor(await ctx.git.currentBranch(ctx.ps.cwd()))
+      };
+      const project = await projectFrom(ctx);
+      const boards = __using(__stack, new OpenBoards(ctx, ctx.projects), 0);
+      const { blockedBy, blockedElsewhere } = await blockerFlags({
+        boards,
+        here: ctx.git.root,
+        blockedBy: opts["blocked-by"]
+      });
+      await ctx.journal.record("task add", from, () => taskAdd(ctx, opts.subject, from, {
+        slug: opts.slug,
+        text: opts.text,
+        position: opts.position,
+        files: commaList5(opts.file.join(",")),
+        blockedBy,
+        blockedElsewhere,
+        lane: laneIn(opts.lane) ?? null,
+        assignee,
+        origin,
+        ready,
+        project,
+        boards
+      }), addedFacts);
+    } catch (_catch) {
+      var _err = _catch, _hasErr = 1;
+    } finally {
+      __callDispose(__stack, _err, _hasErr);
     }
-    const from = await here(ctx);
-    const assignee = await assigneeIn(ctx, opts.agent, opts.model, opts.effort);
-    const origin = ctx.elsewhere === null ? undefined : {
-      project: ctx.elsewhere,
-      task: ctx.project === undefined ? null : ctx.service.taskFor(await ctx.git.currentBranch(ctx.ps.cwd()))
-    };
-    const project = await projectFrom(ctx);
-    await ctx.journal.record("task add", from, () => taskAdd(ctx, opts.subject, from, {
-      slug: opts.slug,
-      text: opts.text,
-      position: opts.position,
-      files: commaList4(opts.file.join(",")),
-      blockedBy: taskIds(opts["blocked-by"].join(",")),
-      lane: laneIn(opts.lane) ?? null,
-      assignee,
-      origin,
-      ready,
-      project
-    }), addedFacts);
   });
 }
 adding("add", "queue a task to do later and move on, groomed, so it goes in ready: you checked no task already asks it, and linked what blocks it; run from a worktree, it records the task it came up in", true);
@@ -1108,11 +1241,23 @@ splatesTask.command("list").use(repository8({ needs: "read" })).description("eve
   ready: opts.ready,
   project: await projectFrom(ctx)
 }));
-splatesTask.command("show").use(repository8({ needs: "read" })).description("one task in full: where it stands, its files, and its detail").arg("id", z12.coerce.number().int().positive(), { description: "task number" }).option("json", z12.boolean(), { default: false, description: "emit JSON" }).action(async (opts, ctx) => taskShow(ctx, opts.id, {
-  json: opts.json,
-  project: await projectFrom(ctx),
-  others: (await ctx.projects.list()).filter((project) => project.root !== ctx.git.root).map((project) => project.slug)
-}));
+splatesTask.command("show").use(repository8({ needs: "read" })).description("one task in full: where it stands, its files, and its detail").arg("id", z12.coerce.number().int().positive(), { description: "task number" }).option("json", z12.boolean(), { default: false, description: "emit JSON" }).action(async (opts, ctx) => {
+  let __stack = [];
+  try {
+    const boards = __using(__stack, new OpenBoards(ctx, ctx.projects), 0);
+    await taskShow(ctx, opts.id, {
+      json: opts.json,
+      project: await projectFrom(ctx),
+      others: (await ctx.projects.list()).filter((project) => project.root !== ctx.git.root).map((project) => project.slug),
+      boards,
+      root: ctx.git.root
+    });
+  } catch (_catch) {
+    var _err = _catch, _hasErr = 1;
+  } finally {
+    __callDispose(__stack, _err, _hasErr);
+  }
+});
 splatesTask.command("update").use(repository8({ needs: "tasks" })).description("say what a queued task is in other words, move it up or down the list, or attach and drop files; it keeps its number").arg("id", z12.coerce.number().int().positive(), { description: "task number" }).arg("text", z12.string(), {
   default: "",
   description: "whatever more there is to say about it, in markdown; leave out to keep the detail"
@@ -1129,9 +1274,9 @@ splatesTask.command("update").use(repository8({ needs: "tasks" })).description("
 }).repeated("remove-file", z12.string(), {
   description: "attached files to drop, comma separated or the flag repeated, by path or stored name"
 }).repeated("blocked-by", z12.string(), {
-  description: "numbers of more tasks blocking it, comma separated or the flag repeated: each has to merge before this one starts; refused when that makes a loop"
+  description: "more tasks blocking it, comma separated or the flag repeated: a number for one here, <project>#<number> for one of another project (`webappwiz#404`); each has to merge before this one starts; refused when that makes a loop"
 }).repeated("remove-blocked-by", z12.string(), {
-  description: "numbers of tasks no longer blocking it, comma separated or the flag repeated"
+  description: "tasks no longer blocking it, as --blocked-by names them, comma separated or the flag repeated"
 }).option("lane", z12.string(), {
   default: "",
   description: "move it to a lane, at the bottom: a lane's number, `backlog` for the permanent catch-all, `new` for one of its own, or `none` for untriaged"
@@ -1154,25 +1299,42 @@ splatesTask.command("update").use(repository8({ needs: "tasks" })).description("
   default: false,
   description: "let a queued lane queue it again, undoing --manual"
 }).action(async (opts, ctx) => {
-  if (opts.manual && opts.auto) {
-    fail8("usage", "pass --manual or --auto, not both", { number: opts.id });
-  }
-  await refuseGroomer3(ctx.service, "task update", await ctx.tasks.find(opts.id));
-  const assignee = await assigneeIn(ctx, opts.agent, opts.model, opts.effort);
-  await recordUpdate(ctx.journal, ctx.tasks, opts.id, () => taskUpdate(ctx, opts.id, {
-    subject: opts.subject,
-    slug: opts.slug,
-    text: opts.text,
-    position: opts.position,
-    files: commaList4(opts.file.join(",")),
-    removeFiles: commaList4(opts["remove-file"].join(",")),
-    blockedBy: taskIds(opts["blocked-by"].join(",")),
-    removeBlockedBy: taskIds(opts["remove-blocked-by"].join(",")),
-    lane: laneIn(opts.lane),
-    assignee,
-    ready: opts.ready,
-    manual: opts.manual ? true : opts.auto ? false : undefined
-  }));
+  let __stack = [];
+  try {
+    if (opts.manual && opts.auto) {
+      fail9("usage", "pass --manual or --auto, not both", { number: opts.id });
+    }
+    await refuseGroomer3(ctx.service, "task update", await ctx.tasks.find(opts.id));
+    const assignee = await assigneeIn(ctx, opts.agent, opts.model, opts.effort);
+    const boards = __using(__stack, new OpenBoards(ctx, ctx.projects), 0);
+    const { blockedBy, blockedElsewhere, unblocked } = await blockerFlags({
+      boards,
+      here: ctx.git.root,
+      blockedBy: opts["blocked-by"],
+      removeBlockedBy: opts["remove-blocked-by"]
+    });
+    await recordUpdate(ctx.journal, ctx.tasks, opts.id, () => taskUpdate(ctx, opts.id, {
+      subject: opts.subject,
+      slug: opts.slug,
+      text: opts.text,
+      position: opts.position,
+      files: commaList5(opts.file.join(",")),
+      removeFiles: commaList5(opts["remove-file"].join(",")),
+      blockedBy,
+      removeBlockedBy: unblocked.ids,
+      blockedElsewhere,
+      removeElsewhere: unblocked.elsewhere,
+      lane: laneIn(opts.lane),
+      assignee,
+      ready: opts.ready,
+      manual: opts.manual ? true : opts.auto ? false : undefined,
+      boards
+    }));
+  } catch (_catch) {
+    var _err = _catch, _hasErr = 1;
+  } finally {
+    __callDispose(__stack, _err, _hasErr);
+  }
 });
 splatesTask.command("remove").use(repository8({ needs: "tasks" })).description("drop a queued task that was done some other way or no longer applies").arg("id", z12.coerce.number().int().positive(), { description: "task number" }).action(async (opts, ctx) => {
   await refuseGroomer3(ctx.service, "task remove", await ctx.tasks.find(opts.id));
@@ -1407,6 +1569,7 @@ splates.command("update").use(recordsFirst()).use(repository10({ needs: "own" })
     ctx.ps.exit(code);
   }
 });
+splates.command("refresh").description("bring the tree you stand in, a task's worktree included, up to this splates: install its splates skill with `bunx skills add` over the copy there and move what an older config holds to where it reads it, leaving the records and any `splates server` alone; what a project runs once a ship's bump task has installed a newer splates, as splates's `afterBump` names; commit what changed").action((_opts, ctx) => refreshHere(ctx));
 splates.command("forget").use(repository10({ needs: "own" })).description("take this repository off ~/.splates/projects.json, so `splates server` no longer offers it; its records stay, and `splates init` brings it back").action((_opts, ctx) => forget(ctx));
 splates.command("add").use(repository10({ needs: "tasks" })).description("start a task: a new one, or with --task one from the queue; create branch task/<slug>, a worktree at ../<repo>-splates.noindex/<slug> and a state record").arg("slug", z16.string(), {
   description: "the task's name, for its branch and worktree (lowercase-with-dashes)"
@@ -1437,12 +1600,12 @@ splates.command("add").use(repository10({ needs: "tasks" })).description("start
 }).action(async (opts, ctx) => {
   await refuseGroomer4(ctx.service, "add");
   if (opts.agent === "" && (opts.model !== "" || opts.effort !== "" || opts.prompt !== "" || opts.held !== "")) {
-    fail9("usage", "--model, --effort, --prompt and --held go with --agent", {
+    fail10("usage", "--model, --effort, --prompt and --held go with --agent", {
       task: opts.slug
     });
   }
   if (opts.goal.trim() === "" && opts.task === "") {
-    fail9("usage", `say what done means: \`splates add ${opts.slug} --goal "<one or two lines>"\`, or start queued tasks with --task`, { task: opts.slug });
+    fail10("usage", `say what done means: \`splates add ${opts.slug} --goal "<one or two lines>"\`, or start queued tasks with --task`, { task: opts.slug });
   }
   const dispatch = opts.agent === "" ? undefined : {
     agent: opts.agent,
@@ -1499,10 +1662,46 @@ splates.command("remove").use(repository10({ needs: "tasks" })).description("dis
   default: false,
   description: "discard even when another agent holds the lease"
 }).option("reason", z16.optional(z16.enum(REMOVE_REASONS)), {
-  description: "why, for the Stats page: nothing (nothing to change), moot (no longer needed), superseded (done some other way), redo (better redone against current trunk), blocked (set aside until what it waits on lands, so back on the list)"
+  description: "why, for the Stats page: nothing (nothing to change), moot (no longer needed), superseded (done some other way), redo (better redone against current trunk), blocked (set aside until what it waits on lands, so back on the list, which takes --why and at least one blocker)"
+}).option("why", z16.string(), {
+  default: "",
+  description: "with --reason blocked: what you found that stops the work, in a sentence or two, for the person and whoever takes it next"
+}).repeated("blocked-by", z16.string(), {
+  description: "with --reason blocked: the tasks it waits on to merge, comma separated or the flag repeated: a number for one here, <project>#<number> for one of another project"
+}).repeated("ask", z16.string(), {
+  description: "with --reason blocked: a question only the person can answer, in the skill's question format; repeat the flag for each"
+}).repeated("waiting-on", z16.string(), {
+  description: "with --reason blocked: something outside splates it waits on, such as a key or an upstream release; repeat the flag for each"
+}).option("detail", z16.string(), {
+  default: "",
+  description: "with --reason blocked: the task's detail rewritten for whoever takes it next: why it stopped, what you found, the steps done and left, and where any pushed work is"
 }).action(async (opts, ctx) => {
-  await ctx.journal.record("remove", opts.task, () => remove(ctx, opts.task, { force: opts.force, reason: opts.reason }), ({ released }) => ({ why: opts.reason ?? null, released }));
-  await follow(ctx, null, { from: opts.task });
+  let __stack = [];
+  try {
+    const boards = __using(__stack, new OpenBoards2(ctx, ctx.projects), 0);
+    const { blockedBy, blockedElsewhere } = await blockerFlags({
+      boards,
+      here: ctx.git.root,
+      blockedBy: opts["blocked-by"]
+    });
+    await ctx.journal.record("remove", opts.task, () => remove(ctx, opts.task, {
+      force: opts.force,
+      reason: opts.reason,
+      deferral: {
+        why: opts.why,
+        blockedBy,
+        blockedElsewhere,
+        questions: opts.ask,
+        outside: opts["waiting-on"],
+        detail: opts.detail === "" ? undefined : opts.detail
+      }
+    }), ({ released }) => ({ why: opts.reason ?? null, released }));
+    await follow(ctx, null, { from: opts.task });
+  } catch (_catch) {
+    var _err = _catch, _hasErr = 1;
+  } finally {
+    __callDispose(__stack, _err, _hasErr);
+  }
 });
 splates.command("list").use(repository10({ needs: "read" })).description("list every started task: its number, name, status, lease (held: an agent is on it now; stale: gone quiet, normal for a task mid-edit; none), commits ahead of trunk, age; `splates task list` lists the queue").option("json", z16.boolean(), { default: false, description: "emit JSON" }).option("files", z16.boolean(), {
   default: false,
@@ -1572,12 +1771,42 @@ splates.command("attach").use(repository10({ needs: "own" })).description("store
 }).option("conversation", z16.string(), {
   default: "",
   description: "conversation to keep the files with, when $SPLATES_CONVERSATION is not set"
-}).action(async (opts, ctx) => ctx.journal.record("attach", opts.task || await here(ctx), () => attach(ctx, commaList5(opts.files), ctx.ps.cwd(), {
+}).action(async (opts, ctx) => ctx.journal.record("attach", opts.task || await here(ctx), () => attach(ctx, commaList6(opts.files), ctx.ps.cwd(), {
   task: opts.task || undefined,
-  remove: commaList5(opts.remove),
+  remove: commaList6(opts.remove),
   conversation: opts.conversation || undefined
-}), (stored) => ({ stored, removed: commaList5(opts.remove) })));
+}), (stored) => ({ stored, removed: commaList6(opts.remove) })));
 splates.command("retry").use(repository10({ needs: "own" })).description("give a task that spent its merge attempts another mergeRetryCount of them; the way out of `budget_exhausted` that is not remove and redo, for a person to run once they have seen the tree").arg("task", z16.string(), { description: "task name" }).action((opts, ctx) => recordRetry(ctx, opts.task));
+splates.command("ship").use(repository10({ needs: "read" })).description("ship a project and its cascade: `splates server` runs its `ship` command from splates.config.ts on its machine, under your own npm sign-in, signing in with `npm login --auth-type=web` first when npm knows no one, and shows npm's sign-in and 2FA links on the page for any device; this prints that ship's output until it ends. The server then carries the release through every registered project that depends on it, in dependency order: a bump task queued in each once all it takes from are shipped, and, once that merges, each public one with a `ship` command and dependents of its own ships in turn. A bump that asks you, or is removed, stops the cascade at that project until it merges or you retry or drop it, as does a failed ship. While a cascade is under way, this prints where it stands instead of starting another, or changes one of its pending publishes with `--bump`. `--plan` prints the cascade and runs nothing. The person's alone to start, refused an agent, which asks with a run-command card").arg("project", z16.string(), {
+  default: "",
+  description: "the registered project's slug; this one by default"
+}).option("plan", z16.boolean(), {
+  default: false,
+  description: "print the plan without running anything"
+}).option("json", z16.boolean(), { default: false, description: "emit JSON" }).option("dev", z16.string(), {
+  default: "",
+  description: "the `splates server` to run the ship on, a URL such as http://localhost:4310; by default the one from SPLATES_DEV, else this machine's on its default port"
+}).option("bump", z16.optional(z16.enum(["patch", "minor", "major"])), {
+  description: "how far to move the starting project's version, patch by default; while its cascade runs, change this pending publish instead"
+}).option("drop", z16.string(), {
+  default: "",
+  description: "take this registered project out of the cascade under way, so those after it go on without its new version"
+}).option("retry", z16.string(), {
+  default: "",
+  description: "run this registered project's part of the cascade under way again: its ship again when that failed, or a new bump task when its last was removed"
+}).option("abandon", z16.boolean(), {
+  default: false,
+  description: "end the cascade under way: what shipped stays published, a running ship is stopped, its open bump tasks are removed, and history files it as abandoned"
+}).action((opts, ctx) => ship(ctx, {
+  project: opts.project || undefined,
+  plan: opts.plan,
+  json: opts.json,
+  dev: opts.dev,
+  bump: opts.bump,
+  drop: opts.drop || undefined,
+  retry: opts.retry || undefined,
+  abandon: opts.abandon
+}));
 splates.mount("artifact", splatesArtifact).mount("task", splatesTask).mount("lane", splatesLane).mount("projects", splatesProjects).mount("creds", splatesCreds).mount("tunnel", splatesTunnel).mount("slots", splatesSlots).mount("worker", splatesWorker).mount("queue", splatesQueue).mount("hook", splatesHook).mount("replica", splatesReplica).mount("evals", splatesEvals);
 
 // index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@stringsync/splates",
-	"version": "0.0.58",
+	"version": "0.0.59",
 	"description": "Runs several AI coding agents on one repository at once, each in its own git worktree",
 	"license": "MIT",
 	"author": "stringsync LLC",
@@ -17,8 +17,8 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@stringsync/splates-server": "^0.0.58",
-		"webappwiz": "0.0.50",
+		"@stringsync/splates-server": "^0.0.59",
+		"webappwiz": "0.0.53",
 		"zod": "^4.4.3"
 	},
 	"main": "./index.js",