@stringsync/splates 0.0.51 → 0.0.52

package/index.js

@@ -25,7 +25,7 @@ import {
   MIGRATING,
   MIGRATION_LIMIT,
   migrateRecords,
-  repository as repository9
+  repository as repository10
 } from "@stringsync/splates-server/records";
 import {
   newest,
@@ -358,8 +358,8 @@ import { fail as fail4 } from "@stringsync/splates-server/exit";
 import {
   HookStore,
   hookAdd,
-  hookAudit,
   hookEdit,
+  hookGardener,
   hookGroomer,
   hookList,
   hookPause,
@@ -484,7 +484,7 @@ splatesHook.command("groomer").use(repository3({ needs: "tasks" })).description(
   }
   await hookGroomer({ hooks: storeOf(ctx), log: ctx.log }, pick ?? null);
 });
-splatesHook.command("audit").use(repository3({ needs: "tasks" })).description("turn on the notes audit, built-in automation `notes-audit`, or set the agent it runs as and its schedule, as the Automations page does: on each run, an agent in the main tree reads each project note no open task names by its path, checks it against the code and the other notes, and defers a task for each one gone stale or contradicting another, never fixing one itself. Off by default, since each run reads code for every note on your tokens; it runs every 7d until you set `--every` or `--cron`. `--off` turns it off").option("agent", z5.string(), {
+splatesHook.command("gardener").use(repository3({ needs: "tasks" })).description("turn on the notes gardener, built-in automation `notes-gardener`, or set the agent it runs as and its schedule, as the Automations page does: on each run, an agent reads each project note no open task names by its path, checks it against the code and the other notes, and drafts the fixes in one task, `notes-garden`: rewriting what went stale, merging notes that say one thing, splitting one that says several, settling a contradiction the code settles and sharpening descriptions, then asks you to review the change rather than merge it, asking about any contradiction the code does not settle. No run starts while `notes-garden` is open. Off by default, since each run reads code for every note on your tokens; it runs every 7d until you set `--every` or `--cron`. `--off` turns it off").option("agent", z5.string(), {
   default: "",
   description: "the agent it runs as, as `splates agents` names it"
 }).option("model", z5.string(), {
@@ -507,7 +507,7 @@ splatesHook.command("audit").use(repository3({ needs: "tasks" })).description("t
   if (opts.off === (pick != null)) {
     fail4("usage", "say how it runs with --agent, or turn it off with --off", {});
   }
-  await hookAudit({ hooks: storeOf(ctx), log: ctx.log }, pick ?? null, {
+  await hookGardener({ hooks: storeOf(ctx), log: ctx.log }, pick ?? null, {
     every: opts.every,
     cron: opts.cron
   });
@@ -674,6 +674,7 @@ splatesQueue.command("move").use(repository6({ needs: "tasks" })).description("m
 import {
   BoxShell,
   CoordinatorBox as CoordinatorBox2,
+  coordinatorMoved,
   deployKey,
   machineMove,
   neededCreds
@@ -685,7 +686,6 @@ import {
   RUNNING,
   serveDev
 } from "@stringsync/splates-server/server";
-import { coordinatorMoved } from "@stringsync/splates-server/setup";
 import { LOCAL_SLOTS } from "@stringsync/splates-server/workers";
 import { cli as cli9 } from "webappwiz/cmd";
 import { z as z10 } from "zod";
@@ -694,26 +694,35 @@ import { z as z10 } from "zod";
 import { resolve as resolve2 } from "node:path";
 import { commaList as commaList4 } from "@stringsync/splates-server/comma-list";
 import {
+  ACCESS_ENVIRONMENT,
+  accessEnvironmentExists,
   CoordinatorBox,
+  pulumiOrg,
   writeInfraConfig
 } from "@stringsync/splates-server/coordinator";
 import { fail as fail5 } from "@stringsync/splates-server/exit";
-import { infraInit } from "@stringsync/splates-server/infra/init";
+import { infraConfigure } from "@stringsync/splates-server/infra/configure";
+import { Projects } from "@stringsync/splates-server/projects";
+import { repository as repository7 } from "@stringsync/splates-server/records";
+import { savedTunnelOf } from "@stringsync/splates-server/server";
+import { FsStorage as FsStorage2 } from "@stringsync/splates-server/storage";
 import { cli as cli8 } from "webappwiz/cmd";
 import { z as z9 } from "zod";
 var splatesInfra = cli8("infra").description("the Pulumi project that makes everything the server's box needs in AWS, Cloudflare and GitHub, which `splates server deploy` then installs splates on");
-splatesInfra.command("init").description("write a Pulumi project in <dir>, its program a dozen lines using the components of @stringsync/splates-server/infra, and the stack's config from the flags; run again, it writes only what is not so already and keeps values you changed. It prints each id and secret left to set with `pulumi config set`. It records the directory in ~/.splates/coordinator/infra.json, where `splates server deploy` finds the stack. Then `bun add @stringsync/splates-server @pulumi/pulumi @pulumi/aws @pulumi/awsx @pulumi/cloudflare @pulumi/github @pulumi/tls @pulumi/random` there and `pulumi up`").arg("dir", z9.string(), { description: "where the Pulumi project goes" }).option("stack", z9.string(), { default: "prod", description: "the stack" }).option("host", z9.string(), {
-  description: "the public host name, as in splates.example.com"
+splatesInfra.command("init").use(repository7({ needs: "own" })).description("write a Pulumi project in <dir>, its program a dozen lines using the components of @stringsync/splates-server/infra, and the stack's config from the flags; run again, it writes only what is not so already and keeps values you changed. It fills the stack's config from what splates keeps (the projects, the saved tunnel, the Cloudflare ids, and each secret from the creds store), requesting on the Creds page any cred not kept and exiting `requested`; run again once saved. When the Pulumi ESC environment `coordinator-access` makes (splates/aws) is there, the stack imports it. It records the directory in ~/.splates/coordinator/infra.json, where `splates server deploy` finds the stack. Then `bun add @stringsync/splates-server @pulumi/pulumi @pulumi/aws @pulumi/awsx @pulumi/cloudflare @pulumi/github @pulumi/tls @pulumi/random` there and `pulumi up`").arg("dir", z9.string(), { description: "where the Pulumi project goes" }).option("stack", z9.string(), { default: "prod", description: "the stack" }).option("host", z9.string(), {
+  default: "",
+  description: "the public host name, as in splates.example.com; the saved tunnel's by default"
 }).option("email", z9.string(), {
-  description: "the email address Access lets in"
+  default: "",
+  description: "the email address Access lets in; the tunnel's Access application's by default"
 }).option("region", z9.string(), {
   default: "us-east-1",
   description: "the AWS region"
 }).option("projects", z9.string(), {
   default: "",
-  description: "comma-separated slug=owner/repo, each a project the box pushes trunk of"
+  description: "comma-separated slug=owner/repo, each a project the box pushes trunk of; every project registered here with a GitHub origin by default"
 }).action(async (opts, ctx) => {
-  const projects = commaList4(opts.projects).map((entry) => {
+  const listed = commaList4(opts.projects).map((entry) => {
     const [slug, repository] = entry.split("=");
     if (!slug || !repository?.includes("/")) {
       fail5("usage", `--projects wants slug=owner/repo, not ${entry}`, {
@@ -722,16 +731,28 @@ splatesInfra.command("init").description("write a Pulumi project in <dir>, its p
     }
     return { slug, repository };
   });
-  const { written, todo } = await infraInit({
+  const org = await pulumiOrg(ctx.ps);
+  const home = new CoordinatorBox({ ps: ctx.ps, fs: ctx.fs }).home;
+  const { written, todo } = await infraConfigure({
     dir: opts.dir,
     stack: opts.stack,
     host: opts.host,
     email: opts.email,
     region: opts.region,
-    projects,
-    fs: ctx.fs
+    projects: listed.length === 0 ? null : listed,
+    registered: async () => (await Projects.in(new FsStorage2(home, ctx.fs), ctx.fs).list()).filter((project) => !project.gone),
+    creds: ctx.creds,
+    saved: savedTunnelOf(ctx),
+    ...org !== null && await accessEnvironmentExists(ctx.ps, org) ? { environment: ACCESS_ENVIRONMENT } : {},
+    fs: ctx.fs,
+    ps: ctx.ps,
+    log: ctx.log,
+    fetch: ctx.fetch
+  });
+  await writeInfraConfig(ctx.fs, home, {
+    dir: resolve2(opts.dir),
+    stack: opts.stack
   });
-  await writeInfraConfig(ctx.fs, new CoordinatorBox({ ps: ctx.ps, fs: ctx.fs }).home, { dir: resolve2(opts.dir), stack: opts.stack });
   ctx.log.info(written.length === 0 ? "already so: nothing written" : `wrote ${written.join(", ")}`);
   for (const command of todo) {
     ctx.log.info(`still to run in ${opts.dir}: ${command}`);
@@ -886,7 +907,7 @@ import { dirname } from "node:path";
 import { SYSTEM_STORES as SYSTEM_STORES3 } from "@stringsync/splates-server/creds";
 import { fail as fail7 } from "@stringsync/splates-server/exit";
 import { splatesHome as splatesHome2 } from "@stringsync/splates-server/models";
-import { Projects } from "@stringsync/splates-server/projects";
+import { Projects as Projects2 } from "@stringsync/splates-server/projects";
 import {
   SETUP_AREAS,
   Setup,
@@ -947,7 +968,7 @@ async function setup(deps, opts) {
 }
 async function setupOf(deps) {
   const { fs, ps, secrets = SYSTEM_STORES3, fetch } = deps;
-  const root = deps.project === undefined ? await repoRoot(ps) : (await Projects.ofMachine(deps).named(deps.project)).root;
+  const root = deps.project === undefined ? await repoRoot(ps) : (await Projects2.ofMachine(deps).named(deps.project)).root;
   return new Setup({
     fs,
     ps,
@@ -1093,7 +1114,7 @@ import {
 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 repository7 } from "@stringsync/splates-server/records";
+import { repository as repository8 } from "@stringsync/splates-server/records";
 import {
   DEFAULT_TIMEOUT as DEFAULT_TIMEOUT2,
   taskWait,
@@ -1110,7 +1131,7 @@ async function projectFrom(ctx) {
   return (await ctx.projects.list()).find((each) => each.root === ctx.git.root)?.slug;
 }
 function adding(name, description, ready) {
-  splatesTask.command(name).use(repository7({ needs: "queue" })).description(description).arg("subject", z12.string(), {
+  splatesTask.command(name).use(repository8({ needs: "queue" })).description(description).arg("subject", z12.string(), {
     description: "what is left to do, in a line"
   }).arg("text", z12.string(), {
     default: "",
@@ -1164,7 +1185,7 @@ function adding(name, description, ready) {
 }
 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);
 adding("defer", "queue a task as it is, rough, in the backlog for whoever grooms it: to check for one that already asks it, link what blocks it, and mark it ready; run from a worktree, it records the task it came up in", false);
-splatesTask.command("list").use(repository7({ needs: "read" })).description("every queued task, top of the list first, with the task it came from and the started one that took it up").option("json", z12.boolean(), { default: false, description: "emit JSON" }).option("open", z12.boolean(), {
+splatesTask.command("list").use(repository8({ needs: "read" })).description("every queued task, top of the list first, with the task it came from and the started one that took it up").option("json", z12.boolean(), { default: false, description: "emit JSON" }).option("open", z12.boolean(), {
   default: false,
   description: "only tasks no started one has taken up: the ones free to pick up"
 }).option("ready", z12.boolean(), {
@@ -1176,12 +1197,12 @@ splatesTask.command("list").use(repository7({ needs: "read" })).description("eve
   ready: opts.ready,
   project: await projectFrom(ctx)
 }));
-splatesTask.command("show").use(repository7({ 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, {
+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("update").use(repository7({ 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(), {
+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"
 }).option("subject", z12.string(), {
@@ -1246,11 +1267,11 @@ splatesTask.command("update").use(repository7({ needs: "tasks" })).description("
     manual: opts.manual ? true : opts.auto ? false : undefined
   }));
 });
-splatesTask.command("remove").use(repository7({ 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) => {
+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));
   await ctx.journal.record("task remove", null, () => taskRemove(ctx, opts.id), (removed) => ({ tasks: tasksNamed2([removed]) }));
 });
-splatesTask.command("wait").use(repository7({ needs: "read" })).description("block until a task leaves the queue, which it does when the task that took it merges: for a task blocked by one another lane is on; ends early when that task waits on a person to answer its questions, and gives up with `timeout`").arg("id", z12.coerce.number().int().positive(), { description: "task number" }).option("timeout-secs", z12.coerce.number(), {
+splatesTask.command("wait").use(repository8({ needs: "read" })).description("block until a task leaves the queue, which it does when the task that took it merges: for a task blocked by one another lane is on; ends early when that task waits on a person to answer its questions, and gives up with `timeout`").arg("id", z12.coerce.number().int().positive(), { description: "task number" }).option("timeout-secs", z12.coerce.number(), {
   default: DEFAULT_TIMEOUT2.secs,
   description: "how long to wait before giving up"
 }).action(async (opts, ctx) => {
@@ -1264,8 +1285,8 @@ splatesTask.command("wait").use(repository7({ needs: "read" })).description("blo
 });
 
 // tunnel.ts
-import { repository as repository8 } from "@stringsync/splates-server/records";
-import { savedTunnelOf } from "@stringsync/splates-server/server";
+import { repository as repository9 } from "@stringsync/splates-server/records";
+import { savedTunnelOf as savedTunnelOf2 } from "@stringsync/splates-server/server";
 import {
   API_TOKEN,
   tunnelRemove,
@@ -1274,7 +1295,7 @@ import {
 import { cli as cli12 } from "webappwiz/cmd";
 import { z as z13 } from "zod";
 var splatesTunnel = cli12("tunnel").description("reach `splates server` from elsewhere: a Cloudflare tunnel with Cloudflare Access in front, set up once per machine");
-splatesTunnel.command("setup").use(repository8({ needs: "own" })).description(`make a Cloudflare tunnel to \`splates server\`, the DNS record routing <host> to it, and an Access application letting in only --email, through the API with the token kept as the cred ${API_TOKEN}, then save them for this machine, so a bare \`splates server\` comes up tunneled; run again, it changes only what is not so already. Without that token it requests it on the Creds page of \`splates server\`, with how to make it, and exits \`requested\`: \`splates creds wait ${API_TOKEN}\`, then run it again`).arg("host", z13.string(), {
+splatesTunnel.command("setup").use(repository9({ needs: "own" })).description(`make a Cloudflare tunnel to \`splates server\`, the DNS record routing <host> to it, and an Access application letting in only --email, through the API with the token kept as the cred ${API_TOKEN}, then save them for this machine, so a bare \`splates server\` comes up tunneled; run again, it changes only what is not so already. Without that token it requests it on the Creds page of \`splates server\`, with how to make it, and exits \`requested\`: \`splates creds wait ${API_TOKEN}\`, then run it again`).arg("host", z13.string(), {
   description: "the public host name, in a zone of the account, as in splates.example.com"
 }).option("email", z13.string(), {
   default: "",
@@ -1289,12 +1310,12 @@ splatesTunnel.command("setup").use(repository8({ needs: "own" })).description(`m
   ...opts,
   creds: ctx.creds,
   task: await here(ctx),
-  saved: savedTunnelOf(ctx),
+  saved: savedTunnelOf2(ctx),
   log: ctx.log,
   fetch: ctx.fetch
 })));
 splatesTunnel.command("status").description("print the tunnel `splates tunnel setup` saved for this machine, which a bare `splates server` runs, and whether its token is in the system's secret store").option("json", z13.boolean(), { default: false, description: "emit JSON" }).action(async (opts, ctx) => {
-  const saved = savedTunnelOf(ctx);
+  const saved = savedTunnelOf2(ctx);
   const record = await saved.read();
   const token = record === null ? false : await saved.token() !== undefined;
   if (opts.json) {
@@ -1314,8 +1335,8 @@ splatesTunnel.command("status").description("print the tunnel `splates tunnel se
   ].join(`
 `));
 });
-splatesTunnel.command("remove").use(repository8({ needs: "own" })).description(`delete what \`splates tunnel setup\` and \`splates server --slot\` made in Cloudflare by what they saved: each tunnel, the DNS record routing to it, the Access applications and their policy, then forget the saved files and the tunnels' tokens; the API token kept as ${API_TOKEN} stays. Run again after a failure, it finishes what is left`).action(async (_opts, ctx) => ctx.journal.record("tunnel remove", null, async () => tunnelRemove({
-  saved: savedTunnelOf(ctx),
+splatesTunnel.command("remove").use(repository9({ needs: "own" })).description(`delete what \`splates tunnel setup\` and \`splates server --slot\` made in Cloudflare by what they saved: each tunnel, the DNS record routing to it, the Access applications and their policy, then forget the saved files and the tunnels' tokens; the API token kept as ${API_TOKEN} stays. Run again after a failure, it finishes what is left`).action(async (_opts, ctx) => ctx.journal.record("tunnel remove", null, async () => tunnelRemove({
+  saved: savedTunnelOf2(ctx),
   slots: slotTunnelsOf(ctx),
   creds: ctx.creds,
   task: await here(ctx),
@@ -1546,15 +1567,15 @@ function projectArgs(argv) {
   return { argv };
 }
 var splates = cli15("splates").use(exits());
-splates.command("notes").use(repository9({ needs: "read" })).description("print each project note's frontmatter description, one per line; notesDir in splates.config.ts defaults to notes; an absent directory prints nothing").action((_opts, ctx) => notes(ctx));
-splates.command("init").use(repository9({ creates: true, needs: "own" })).description("make this repository a splates project: set up its records under .git/splates when it has none, install the splates skill of this release with `bunx skills add`, and register it in ~/.splates/projects.json, so `splates server` serves it beside every other; run again, it changes only what is not so already").action((_opts, ctx) => init(ctx));
+splates.command("notes").use(repository10({ needs: "read" })).description("print each project note's frontmatter description, one per line; notesDir in splates.config.ts defaults to notes; an absent directory prints nothing").action((_opts, ctx) => notes(ctx));
+splates.command("init").use(repository10({ creates: true, needs: "own" })).description("make this repository a splates project: set up its records under .git/splates when it has none, install the splates skill of this release with `bunx skills add`, and register it in ~/.splates/projects.json, so `splates server` serves it beside every other; run again, it changes only what is not so already").action((_opts, ctx) => init(ctx));
 splates.command("migrate").description(`move this repository's records under .git/splates to this splates's format, as \`splates server\` does as it starts: backed up first, the steps run with ${MIGRATION_LIMIT.human()} to finish, and the backup put back if one fails or runs over, with why kept in .git/splates-migration.json; it tries again past a failure kept there, which the server and every other command leave alone. Run it only while no older \`splates server\` serves the repository, which would refuse the records once moved; \`splates update\` restarts one first`).action(async (_opts, ctx) => {
   const format = await migrateRecords(ctx);
   if (ctx.ps.env(MIGRATING) === undefined) {
     ctx.log.info(`splates's records are in format ${format}`);
   }
 });
-splates.command("update").use(recordsFirst()).use(repository9({ needs: "own" })).description("bring this repository up to the newest splates on npm: run `update` on that release when it is newer than this one, which moves the records under .git/splates to its format, as `splates migrate` does, unless an older `splates server` serves the repository, which it asks to restart onto that release once its agents have checkpointed, migrating them as it starts; then installs its splates skill with `bunx skills add` over the copy there, leaving one that links to your own; commit what changed").action(async (_opts, ctx) => {
+splates.command("update").use(recordsFirst()).use(repository10({ needs: "own" })).description("bring this repository up to the newest splates on npm: run `update` on that release when it is newer than this one, which moves the records under .git/splates to its format, as `splates migrate` does, unless an older `splates server` serves the repository, which it asks to restart onto that release once its agents have checkpointed, migrating them as it starts; then installs its splates skill with `bunx skills add` over the copy there, leaving one that links to your own; commit what changed").action(async (_opts, ctx) => {
   const code = await update({
     root: ctx.git.root,
     fs: ctx.fs,
@@ -1574,8 +1595,8 @@ splates.command("heavy").description("run a heavy command (a full test run, an i
     ctx.ps.exit(code);
   }
 });
-splates.command("forget").use(repository9({ 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(repository9({ 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(), {
+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)"
 }).option("base", z16.string(), {
   default: "",
@@ -1643,11 +1664,11 @@ splates.command("add").use(repository9({ needs: "tasks" })).description("start a
     await serveProject(ctx);
   }
 });
-splates.command("claim").use(repository9({ needs: "own" })).description("resume an existing task: take ownership of its worktree and print its path, status and any half-finished rebase; refuses while another agent holds the lease, but takes a stale one silently, so `splates show` first if the tree may not be abandoned").arg("task", z16.string(), { description: "task name" }).action(async (opts, ctx) => {
+splates.command("claim").use(repository10({ needs: "own" })).description("resume an existing task: take ownership of its worktree and print its path, status and any half-finished rebase; refuses while another agent holds the lease, but takes a stale one silently, so `splates show` first if the tree may not be abandoned").arg("task", z16.string(), { description: "task name" }).action(async (opts, ctx) => {
   await ctx.journal.record("claim", opts.task, () => claim(ctx, opts.task), (claimed) => claimed);
   await follow(ctx, opts.task);
 });
-splates.command("merge").use(repository9({ needs: "own" })).description("land this worktree's branch on its base (trunk unless created with --base): rebase onto it, run tests on the rebased code, fast-forward it in whichever worktree has it checked out, then discard the worktree, branch and record (linear history, never a merge commit, no flag to skip tests); requires committed work, refusing a dirty worktree").option("message", z16.string(), {
+splates.command("merge").use(repository10({ needs: "own" })).description("land this worktree's branch on its base (trunk unless created with --base): rebase onto it, run tests on the rebased code, fast-forward it in whichever worktree has it checked out, then discard the worktree, branch and record (linear history, never a merge commit, no flag to skip tests); requires committed work, refusing a dirty worktree").option("message", z16.string(), {
   default: "",
   description: "squash the task's commits into one with this message before landing, saying what the base gains in at least 5 characters"
 }).action(async (opts, ctx) => {
@@ -1660,7 +1681,7 @@ splates.command("merge").use(repository9({ needs: "own" })).description("land th
     await follow(ctx, null, { from: task });
   }
 });
-splates.command("remove").use(repository9({ needs: "tasks" })).description("discard a task: worktree, branch and state file; cheap and encouraged, since redoing a task against current trunk often beats a hard rebase").arg("task", z16.string(), { description: "task name" }).option("force", z16.boolean(), {
+splates.command("remove").use(repository10({ needs: "tasks" })).description("discard a task: worktree, branch and state file; cheap and encouraged, since redoing a task against current trunk often beats a hard rebase").arg("task", z16.string(), { description: "task name" }).option("force", z16.boolean(), {
   default: false,
   description: "discard even when another agent holds the lease"
 }).option("reason", z16.optional(z16.enum(REMOVE_REASONS)), {
@@ -1669,19 +1690,19 @@ splates.command("remove").use(repository9({ needs: "tasks" })).description("disc
   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 });
 });
-splates.command("list").use(repository9({ 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(), {
+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,
   description: "add each task's Goal and changed files (committed or not), to check for overlap before starting"
 }).action((opts, ctx) => list(ctx, { json: opts.json, files: opts.files }));
-splates.command("show").use(repository9({ needs: "read" })).description("read one task without touching it: everything `list` shows for it, plus the SPLATES.md its agent left at the worktree root; takes no lease, so it cannot knock that agent off its own tree; for a task no longer live, the newest finished one of that name: how it ended, its base, the commit it landed as, its conversation and the SPLATES.md it ended on").arg("task", z16.string(), { description: "task name" }).option("json", z16.boolean(), { default: false, description: "emit JSON" }).action((opts, ctx) => show(ctx, opts.task, { json: opts.json }));
-splates.command("wait").use(repository9({ needs: "read" })).description("block until a task stops moving: waiting on a person to answer its questions, or gone (merged or removed), or broken; takes no lease, and gives up with `timeout` rather than waiting forever").arg("task", z16.string(), { description: "task name" }).option("timeout-secs", z16.coerce.number(), {
+splates.command("show").use(repository10({ needs: "read" })).description("read one task without touching it: everything `list` shows for it, plus the SPLATES.md its agent left at the worktree root; takes no lease, so it cannot knock that agent off its own tree; for a task no longer live, the newest finished one of that name: how it ended, its base, the commit it landed as, its conversation and the SPLATES.md it ended on").arg("task", z16.string(), { description: "task name" }).option("json", z16.boolean(), { default: false, description: "emit JSON" }).action((opts, ctx) => show(ctx, opts.task, { json: opts.json }));
+splates.command("wait").use(repository10({ needs: "read" })).description("block until a task stops moving: waiting on a person to answer its questions, or gone (merged or removed), or broken; takes no lease, and gives up with `timeout` rather than waiting forever").arg("task", z16.string(), { description: "task name" }).option("timeout-secs", z16.coerce.number(), {
   default: DEFAULT_TIMEOUT3.secs,
   description: "how long to wait before giving up"
 }).action((opts, ctx) => {
   const timeout = Duration3.secs(opts["timeout-secs"]);
   return ctx.journal.waiting("wait", opts.task, { until: untilAfter3(timeout) }, () => wait(ctx, opts.task, { timeout }));
 });
-splates.command("log").use(repository9({ needs: "read" })).description("show what has been done here recently: one line per add, claim, merge, remove, retry, queued task and more, with how it ended; outlives the tasks themselves").option("count", z16.coerce.number(), {
+splates.command("log").use(repository10({ needs: "read" })).description("show what has been done here recently: one line per add, claim, merge, remove, retry, queued task and more, with how it ended; outlives the tasks themselves").option("count", z16.coerce.number(), {
   default: DEFAULT_COUNT,
   description: "how many entries to show"
 }).option("json", z16.boolean(), { default: false, description: "emit JSON" }).action((opts, ctx) => showLog(ctx, { count: opts.count, json: opts.json }));
@@ -1719,14 +1740,14 @@ splates.command("setup").description("set splates up on this machine, one step a
   default: false,
   description: "with an area's id in place of a step: print what undoing it would remove, the creds it forgets and keeps, and what only the user can remove; the Setup page's Undo does it, after the user confirms"
 }).action((opts, ctx) => setup(ctx, opts));
-splates.command("path").use(repository9({ needs: "read" })).description("print a task's worktree path, or the main tree with no task; names another agent's tree without taking its lease").arg("task", z16.string(), {
+splates.command("path").use(repository10({ needs: "read" })).description("print a task's worktree path, or the main tree with no task; names another agent's tree without taking its lease").arg("task", z16.string(), {
   default: "",
   description: "task name; omit for the main tree"
 }).action((opts, ctx) => path(ctx, opts.task || undefined));
-splates.command("checkpoint").use(repository9({ needs: "own" })).description("save this task to the central remote (`remote` in splates.config.ts) before a stop: commit what is uncommitted as a `WIP: checkpoint` commit, to squash before merging, and push the branch as `splates/<task>`, so a worker that dies loses nothing; with no remote configured, leaves the tree as it is").action(async (_opts, ctx) => {
+splates.command("checkpoint").use(repository10({ needs: "own" })).description("save this task to the central remote (`remote` in splates.config.ts) before a stop: commit what is uncommitted as a `WIP: checkpoint` commit, to squash before merging, and push the branch as `splates/<task>`, so a worker that dies loses nothing; with no remote configured, leaves the tree as it is").action(async (_opts, ctx) => {
   await checkpoint(ctx, ctx.ps.cwd());
 });
-splates.command("attach").use(repository9({ needs: "own" })).description("store screenshots and recordings for this task's questions to show: prints the path each was stored at, under .git/splates, which the `splates server` page shows inline; from a conversation (its $SPLATES_CONVERSATION, or --conversation) they stay with it past the task, otherwise they go when the task merges or is removed; those the task's final SPLATES.md shows are copied to keep with its finished record. A task holds at most attachmentCapacity bytes; with no files, lists what it holds. A file the user will come back for on its own is an artifact instead (`splates artifact add`)").arg("files", z16.string(), {
+splates.command("attach").use(repository10({ needs: "own" })).description("store screenshots and recordings for this task's questions to show: prints the path each was stored at, under .git/splates, which the `splates server` page shows inline; from a conversation (its $SPLATES_CONVERSATION, or --conversation) they stay with it past the task, otherwise they go when the task merges or is removed; those the task's final SPLATES.md shows are copied to keep with its finished record. A task holds at most attachmentCapacity bytes; with no files, lists what it holds. A file the user will come back for on its own is an artifact instead (`splates artifact add`)").arg("files", z16.string(), {
   default: "",
   description: "files to store, comma separated"
 }).option("task", z16.string(), {
@@ -1743,7 +1764,7 @@ splates.command("attach").use(repository9({ needs: "own" })).description("store
   remove: commaList6(opts.remove),
   conversation: opts.conversation || undefined
 }), (stored) => ({ stored, removed: commaList6(opts.remove) })));
-splates.command("retry").use(repository9({ 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("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.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("budget", splatesBudget);
 
 // index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@stringsync/splates",
-	"version": "0.0.51",
+	"version": "0.0.52",
 	"description": "Runs several AI coding agents on one repository at once, each in its own git worktree",
 	"license": "MIT",
 	"author": "stringsync LLC",
@@ -17,7 +17,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@stringsync/splates-server": "^0.0.51",
+		"@stringsync/splates-server": "^0.0.52",
 		"webappwiz": "0.0.47",
 		"zod": "^4.4.3"
 	},