@sleds/cli 0.1.40 → 0.1.42

package/README.md

@@ -87,7 +87,7 @@ The flags `sleds route run` and `sleds engine` share:
 --repo <path> | --repos-dir <dir>   where the node's repo is checked out
 ```
 
-`sleds engine` also takes `--name <n>` (default the hostname; it signs as `engine:<n>`), `--interval <s>`, `--lease <min>`, `--idle <min>` (default 20: a session showing nothing new and no PR is parked for a person, its last message the question, and the answer is typed back into it) and `--once` for a single tick. `--jira` reads `JIRA_BASE_URL`, `JIRA_EMAIL` and `JIRA_TOKEN`. `sleds help` has the full list.
+`sleds engine` also takes `--name <n>` (default the hostname; it signs as `engine:<n>`), `--interval <s>`, `--lease <min>`, `--idle <min>` (default 20: a session showing nothing new and no PR is parked for a person, its last message the question, and the answer is typed back into it) and `--once` for a single tick. `--jira` reads `JIRA_BASE_URL`, `JIRA_EMAIL` and `JIRA_TOKEN`, and still needs a seat: before every write to Jira (a status move, a comment) it asks SLEDS, and writes nothing when the org runs Jira read only, the switch is off, the issue's project is not watched, SLEDS cannot be reached, or `JIRA_WRITES=off` is set in its environment (spec 39 rule 4). It will not start when SLEDS says no writes for the epic's project. `sleds help` has the full list.
 
 `sleds engine status [--name <n>] [--json]` says what that engine holds now: the nodes it runs (with where to watch each), the PRs it follows and their checks, the next check, and whether it is alive. It reads the engine's state file and the lock the engine keeps beside it (`<name>.lock`: its pid, written each tick, removed on a clean stop), not SLEDS, so it answers offline. `--json` is the contract a front end reads; both it and the state file carry a version, `v` (spec 28 §4.2). For a `sleds route run` engine, pass `--name <n>-<KEY>`.
 

package/dist/sleds.mjs

@@ -345,11 +345,11 @@ var init_guides = __esm(() => {
         {
           do: "Open `Work` and read the tabs",
           where: "Work",
-          note: "Four tabs, each with its count: Waiting for product · Ready · On sleds · Landed this week. The search at the top narrows the rows as you type; the chips beside the tabs narrow by source, worth, type and `filed by` (you first). Your own work, and what is in front of you, is on Sleds."
+          note: "Three tabs, each with its count: Ready · On sleds · Landed this week; what waits for product's yes is on Intake (a line above the tabs says how many). The search at the top narrows the rows as you type; the chips beside the tabs narrow by source, worth, type and `filed by` (you first). Your own work, and what is in front of you, is on Sleds."
         },
         {
           do: "Read a pool item: the band, the worth, the chip, the readiness",
-          note: "`suggested` (dashed, with a star) names the sled the rules (and the model) suggest, with why on hover; `waiting for product` needs a yes; the five boxes say what the item has (why · done · worth · repo · route) and `N gaps` names what is missing before anyone could start; an amber note says a related or duplicate item exists. `Take it` puts it on your sled; the ⋯ menu can put it on the suggested sled."
+          note: "`suggested` (dashed, with a star) names the sled the rules (and the model) suggest, with why on hover; `waiting for product` needs a yes (on Intake, where a row opens a modal to decide it); the five boxes say what the item has (why · done · worth · repo · route) and `N gaps` names what is missing before anyone could start; an amber note says a related or duplicate item exists. `Take it` puts it on your sled; the ⋯ menu can put it on the suggested sled."
         },
         {
           do: "Read a sled card: the seats, the jobs, the band spent",
@@ -679,16 +679,16 @@ var init_guides = __esm(() => {
           note: "Emails, comma-separated. Blank means any owner or admin of the workspace."
         },
         {
-          do: "Approvers decide from the board or the Overview",
-          where: "Overview › `Waiting on product`, or the item on Work",
-          note: "`Approve` opens the gate; `Defer` keeps it closed and carries the note back to the filer, who answers in the brief and it comes back. In chat the same is `approve {project, decision, note?}`."
+          do: "Approvers decide on Intake",
+          where: "Intake (the rail), or Overview › `Waiting on product`",
+          note: "A row opens the ask in a modal over the ledger: `Approve` opens the gate; `Defer` keeps it closed and carries the note back to the filer, who answers in the brief and it comes back; `Ask the filer` sends the one question. A, D and Q do the same from the keyboard and move to the next ask. In chat the same is `approve {project, decision, note?}`."
         },
         {
           do: "Plan after the yes",
           note: "An approved epic can be planned in chat (`plan`): its milestones are sized, filed under it, and inherit the yes — they do not queue again. The epic's cap is the sum."
         }
       ],
-      check: "File an ask from chat (`intake`): its item shows waiting for product in the pool on Work, the approvers see it under Waiting on product, and `run` on it is refused until someone approves."
+      check: "File an ask from chat (`intake`): its item shows waiting for product on Intake, the approvers see it under Waiting on product, and `run` on it is refused until someone approves."
     }
   ];
 });
@@ -1346,6 +1346,9 @@ var init_related = __esm(() => {
     "via"
   ]);
 });
+
+// ../../packages/shared/src/intake/rank.ts
+var init_rank = () => {};
 // ../../packages/shared/src/profile/profile.ts
 var LIGHT;
 var init_profile = __esm(() => {
@@ -5543,6 +5546,34 @@ var init_fieldMap = __esm(() => {
 var SEPT_30 = "/whats-new/2026-09-30", WHATS_NEW;
 var init_whatsNew = __esm(() => {
   WHATS_NEW = [
+    {
+      date: "2026-10-20",
+      title: "Intake: the gate gets its own page",
+      lede: "What waits for product's yes was the first tab on Work. It is a page now, Intake, between Work and Sleds on the rail: the same rows, with the policy an approver decides under on one line, the counts over them, and a modal that reads one ask fast and decides it without leaving the list. Work keeps what is ready and who is on it, and opens on Ready.",
+      sections: [
+        {
+          title: "One ask at a time, over the ledger",
+          where: "Intake › a row",
+          body: "A row on Intake opens a centred modal, not the item's page: what SLEDS says and why, the six steps from filed to landed with this one's place on them, the brief, and — folded, each with its answer on the fold — the ticket, the split and who takes it. Approve, Defer with a note and Ask the filer are at the foot, with Open the full item for anything deeper. ‹ › and the arrow keys walk the ledger in its order; A, D and Q decide and move on; Decide in order starts at the top. Esc goes back to the ledger as it was."
+        },
+        {
+          title: "The policy on the page",
+          where: "Intake, above the rows",
+          body: "Above the rows, one dashed line says whose yes is needed and for which asks, who the approvers are, and what a yes writes to Jira — read from Policy, with Change in Policy beside it. Under it, four counts: open, need a worth, waiting on a filer, and became work this week (which opens the Record)."
+        },
+        {
+          title: "Where things went on Work",
+          where: "Work",
+          body: "Work's tabs are Ready, On sleds and Landed. A line above them says how many wait in Intake and links there; the Board layout says the same in place of its Waiting column. The rail's count under Work is what is ready now; Intake's is what waits. Old links — Approvals, a waiting lane, a search hit on a waiting item — land on Intake."
+        }
+      ],
+      also: [
+        {
+          label: "Next",
+          text: "Worth from the modal and from Jira's Business Value, the return of each ask against its time, SLEDS's own suggested verdict, and auto-approve in shadow mode first — spec 41's later slices."
+        }
+      ]
+    },
     {
       date: "2026-10-10",
       title: "Docs beside the work, and webhooks for your own tools",
@@ -7523,6 +7554,7 @@ var init_src = __esm(() => {
   init_verbs();
   init_brief();
   init_related();
+  init_rank();
   init_markdown2();
   init_plan3();
   init_recommend();
@@ -8222,6 +8254,7 @@ init_guides();
 init_verbs();
 init_brief();
 init_related();
+init_rank();
 init_markdown2();
 init_plan3();
 init_recommend();
@@ -10267,28 +10300,17 @@ function cmuxRunner(exec, deps = {}) {
       }
       let id = parseCmuxWorkspace(r.stdout);
       const ref = id ? null : parseCmuxRef(r.stdout);
-      let closed = false;
       if (ref) {
-        let listed = null;
-        for (let i = 0;i < CMUX_LIST_TRIES; i++) {
+        for (let i = 0;i < CMUX_LIST_TRIES && !id; i++) {
           if (i > 0)
             sleep(CMUX_LIST_WAIT_MS);
           const l = cmux(["--id-format", "both", "list-workspaces"]);
-          if (l.status !== 0)
-            continue;
-          listed = l.stdout;
-          if (namedLines(l.stdout, o.name).length > 0)
-            break;
-        }
-        if (listed !== null) {
-          id = cmuxIdForRef(listed, ref, o.name);
-          const stray = id ? null : cmuxIdForName(listed, o.name);
-          if (stray)
-            closed = closeWorkspace(stray);
+          if (l.status === 0)
+            id = cmuxIdForRef(l.stdout, ref, o.name);
         }
       }
       if (!id) {
-        throw new Error(ref ? `cmux workspace create ${o.name} gave ${ref} but no workspace id for it; ${closed ? "that workspace was closed" : UNWATCHED}` : `cmux workspace create ${o.name} returned no workspace (${r.stdout.trim() || "nothing"}); ${UNWATCHED}`);
+        throw new Error(ref ? `cmux workspace create ${o.name} gave ${ref} but no workspace id for it; ${UNWATCHED}` : `cmux workspace create ${o.name} returned no workspace (${r.stdout.trim() || "nothing"}); ${UNWATCHED}`);
       }
       if (group && listed && !joined) {
         const c = cmux([
@@ -10422,7 +10444,7 @@ function beatBody(state, flags, host = {}, cap = {}) {
     name: flags.name,
     os: host.os ?? process.platform,
     runner: flags.runner,
-    version: host.version ?? "0.1.40" ?? "dev",
+    version: host.version ?? "0.1.42" ?? "dev",
     running: live.length,
     items: live.slice(0, BEAT_ITEMS).map((r) => `${r.item}/${r.node}`),
     ...cap.atOnce !== undefined ? { atOnce: cap.atOnce } : {},
@@ -11025,6 +11047,29 @@ function adfComment(text) {
     }
   };
 }
+function localWritesOff(env) {
+  return env.JIRA_WRITES?.trim().toLowerCase() === "off";
+}
+function sledsJiraGate(client, env = process.env) {
+  return {
+    async ask(w) {
+      if (localWritesOff(env))
+        return "JIRA_WRITES=off is set here";
+      const r = await client.postFull("/proxy/jira/write", { ...w }).catch(() => null);
+      if (!r)
+        return "SLEDS could not be reached to say whether writes to Jira are on";
+      if (r.status !== 200 || !r.json)
+        return `SLEDS would not say whether writes to Jira are on (HTTP ${r.status})`;
+      const refusal = r.json.refusal;
+      if (refusal === null)
+        return null;
+      return str6(r.json.why) ?? (typeof refusal === "string" ? refusal : "SLEDS refused the write");
+    },
+    async told(w, outcome) {
+      await client.postFull("/proxy/jira/write", { ...w, outcome }).catch(() => null);
+    }
+  };
+}
 function jiraSource(o) {
   const fetchFn = o.fetchFn ?? fetch;
   const base = o.baseUrl.replace(/\/+$/, "");
@@ -11065,23 +11110,35 @@ function jiraSource(o) {
       byNode.set(n.node, n);
     return [epicItem(epic, nodes)];
   };
+  const write = async (issue, sw, what, body) => {
+    const w = {
+      issueKey: issue,
+      switch: sw,
+      method: "POST",
+      endpoint: `/issue/{key}/${what}`
+    };
+    const refused = await o.gate.ask(w).catch((e) => `SLEDS could not be reached (${e instanceof Error ? e.message : String(e)})`);
+    if (refused)
+      return { ok: false, status: 0, json: null, refused };
+    const r = await call(`/rest/api/3/issue/${issue}/${what}`, { method: "POST", body });
+    await o.gate.told(w, r.ok ? "sent" : `failed:${r.status}`).catch(() => {
+      return;
+    });
+    return r;
+  };
   const transitionTo = async (issue, category) => {
     const t = await call(`/rest/api/3/issue/${issue}/transitions`);
     const list = Array.isArray(t.json?.transitions) ? t.json.transitions.filter(isObject8) : [];
     const hit = list.find((x) => isObject8(x.to) && categoryOf({ status: x.to }) === category && x.id !== undefined);
     if (!hit)
-      return false;
-    const r = await call(`/rest/api/3/issue/${issue}/transitions`, {
-      method: "POST",
-      body: { transition: { id: String(hit.id) } }
-    });
-    return r.ok;
+      return { ok: false };
+    const r = await write(issue, "status", "transitions", { transition: { id: String(hit.id) } });
+    return { ok: r.ok, ...r.refused ? { refused: r.refused } : {} };
   };
   const comment = async (issue, text) => {
-    const r = await call(`/rest/api/3/issue/${issue}/comment`, {
-      method: "POST",
-      body: adfComment(text)
-    });
+    const r = await write(issue, "comments", "comment", adfComment(text));
+    if (r.refused)
+      throw new Error(`Jira: not written to ${issue} — ${r.refused}`);
     if (!r.ok)
       throw new Error(`Jira: could not comment on ${issue} — ${errorOf(r)}`);
   };
@@ -11107,8 +11164,16 @@ function jiraSource(o) {
       const pack = `# ${n.issue} · ${n.summary}
 
 ${body}`.trimEnd();
-      const moved = await transitionTo(n.issue, "indeterminate").catch(() => false);
-      if (!moved)
+      const moved = await transitionTo(n.issue, "indeterminate").catch(() => ({
+        ok: false,
+        refused: undefined
+      }));
+      if (moved.refused)
+        return {
+          ok: false,
+          error: `not taken: not written to Jira (${n.issue}) — ${moved.refused}`
+        };
+      if (!moved.ok)
         return {
           ok: false,
           error: `Jira would not move ${n.issue} to In Progress (no such transition, or no permission) — the engine needs it to mark the node taken`
@@ -11135,8 +11200,8 @@ ${body}`.trimEnd();
       if (outcome.kind === "pr")
         return comment(issue, `PR opened by ${by}: ${outcome.ref}`);
       if (outcome.kind === "merged") {
-        const done = await transitionTo(issue, "done").catch(() => false);
-        return comment(issue, done ? `PR merged by ${by}'s engine: ${outcome.ref}` : `PR merged: ${outcome.ref}. Jira would not move this to Done (no such transition, or no permission) — move it so the nodes it blocks can start.`);
+        const done = await transitionTo(issue, "done").catch(() => ({ ok: false }));
+        return comment(issue, done.ok ? `PR merged by ${by}'s engine: ${outcome.ref}` : `PR merged: ${outcome.ref}. Jira would not move this to Done (no such transition, or no permission) — move it so the nodes it blocks can start.`);
       }
       if (outcome.kind === "park")
         return comment(issue, outcome.question);
@@ -11148,20 +11213,21 @@ ${outcome.log.slice(-JIRA_LOG_MAX)}`);
     }
   };
 }
-function jiraFromEnv(epic, env = process.env) {
-  const baseUrl = env.JIRA_BASE_URL?.trim();
-  const email = env.JIRA_EMAIL?.trim();
-  const token = env.JIRA_TOKEN?.trim();
-  const missing = [
-    baseUrl ? null : "JIRA_BASE_URL",
-    email ? null : "JIRA_EMAIL",
-    token ? null : "JIRA_TOKEN"
-  ].filter((m) => m !== null);
-  if (missing.length > 0 || !baseUrl || !email || !token)
-    return {
-      error: `Jira source needs ${missing.join(", ")} (e.g. JIRA_BASE_URL=https://qwick.atlassian.net, an API token in JIRA_TOKEN)`
-    };
-  return jiraSource({ epic, baseUrl, email, token });
+function jiraEnvError(env) {
+  const missing = ["JIRA_BASE_URL", "JIRA_EMAIL", "JIRA_TOKEN"].filter((k) => !env[k]?.trim());
+  return missing.length > 0 ? `Jira source needs ${missing.join(", ")} (e.g. JIRA_BASE_URL=https://qwick.atlassian.net, an API token in JIRA_TOKEN)` : null;
+}
+function jiraFromEnv(epic, gate, env = process.env) {
+  const error = jiraEnvError(env);
+  if (error)
+    return { error };
+  return jiraSource({
+    epic,
+    baseUrl: String(env.JIRA_BASE_URL).trim(),
+    email: String(env.JIRA_EMAIL).trim(),
+    token: String(env.JIRA_TOKEN).trim(),
+    gate
+  });
 }
 
 // src/engine/loop.ts
@@ -16270,7 +16336,7 @@ async function driveEngine(o, flags, deps, until = {}) {
     runner: deps.runner.name,
     atOnce: flags.atOnce,
     interval: flags.interval,
-    cliVersion: "0.1.40"
+    cliVersion: "0.1.42"
   };
   const beat = (checkedAt) => {
     const m = deps.machine;
@@ -18087,6 +18153,15 @@ function orgClient2(o, flag) {
   const org = engineOrg2(o, flag);
   return engineClient2(o, org.seated ? org.slug ?? undefined : flag);
 }
+async function jiraWritesAtStart(gate, epic) {
+  const no = await gate.ask({
+    issueKey: epic.trim().toUpperCase(),
+    switch: "status",
+    method: "POST",
+    endpoint: "/issue/{key}/transitions"
+  });
+  return no ? `--jira ${epic}: not starting — SLEDS says no writes to Jira: ${no}. A take moves the issue to In Progress, so the engine cannot take a node without one.` : null;
+}
 function realPidAlive2(pid) {
   try {
     process.kill(pid, 0);
@@ -18323,7 +18398,7 @@ async function driveEngine2(o, flags, deps, until = {}) {
     runner: deps.runner.name,
     atOnce: flags.atOnce,
     interval: flags.interval,
-    cliVersion: "0.1.40"
+    cliVersion: "0.1.42"
   };
   const beat = (checkedAt) => {
     const m = deps.machine;
@@ -18574,7 +18649,24 @@ var engineCmd = async (o) => {
   if (o.source)
     source = o.source;
   else if (flags.jira) {
-    const j = jiraFromEnv(flags.jira, o.env ?? process.env);
+    const env = o.env ?? process.env;
+    const missing = jiraEnvError(env);
+    if (missing) {
+      error(missing);
+      return 1;
+    }
+    const c = o.client ?? orgClient2(o, given);
+    if ("error" in c) {
+      error(`--jira asks SLEDS before every write to Jira (spec 39), so it needs a seat: ${c.error}`);
+      return 1;
+    }
+    const gate = sledsJiraGate(c, env);
+    const no = await jiraWritesAtStart(gate, flags.jira);
+    if (no) {
+      error(no);
+      return 1;
+    }
+    const j = jiraFromEnv(flags.jira, gate, env);
     if ("error" in j) {
       error(j.error);
       return 1;
@@ -24783,7 +24875,7 @@ ${renderHelpText(argv[1])}`);
     case "version":
     case "--version":
     case "-v":
-      console.log("sleds 0.1.40");
+      console.log("sleds 0.1.42");
       return 0;
     default:
       console.error(`unknown command: ${cmd}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleds/cli",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "SLEDS CLI — the cost and limits of AI agent work, decided at the wall. Point Claude Code at a SLEDS proxy; estimate before you run; hold, switch model, or run overnight when you hit a limit.",
   "license": "UNLICENSED",
   "type": "module",