@sleds/cli 0.1.50 → 0.1.51

package/dist/sleds.mjs

@@ -769,6 +769,14 @@ var init_verbs = __esm(() => {
       app: "Work › Moving (the runs on each sled) · Record › Receipts once they land",
       how: "Newest first: id, status, route, cost. Hand-offs meant for you are listed first."
     },
+    {
+      id: "metrics",
+      group: "meter",
+      want: "See how a workspace or the whole org ships — DORA and batch size for a period",
+      mcp: "metrics {workspace?, range?, from?, to?} — range 2w · 1m · 3m · 6m · 1y, or from/to days",
+      app: "Metrics",
+      how: "Deploy frequency, lead time, change failure rate, time to recover and production deploys by batch size, each against the same length just before. A workspace gives one line; no workspace gives the org, one line per workspace you see."
+    },
     {
       id: "status",
       group: "meter",
@@ -1616,6 +1624,128 @@ var init_format = __esm(() => {
   OFFLINE_LINE = `${PREFIX}offline`;
 });
 
+// ../../packages/shared/src/item/outcome.ts
+var OUTCOME_WINDOW_DAYS = 14, OUTCOME_WINDOW_MS;
+var init_outcome = __esm(() => {
+  OUTCOME_WINDOW_MS = OUTCOME_WINDOW_DAYS * 86400000;
+});
+
+// ../../packages/shared/src/deploys/metrics.ts
+var WEEK_MS;
+var init_metrics = __esm(() => {
+  WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+});
+
+// ../../packages/shared/src/deploys/batchSize.ts
+var TIERS;
+var init_batchSize = __esm(() => {
+  init_outcome();
+  init_metrics();
+  TIERS = ["S", "M", "L", "G"];
+});
+
+// ../../packages/shared/src/deploys/period.ts
+function periodChange(cur, prev, better) {
+  if (cur == null || prev == null)
+    return { pct: null, dir: "flat", tone: "neutral" };
+  if (prev === 0)
+    return { pct: null, dir: cur > 0 ? "up" : cur < 0 ? "down" : "flat", tone: "neutral" };
+  const pct = (cur - prev) / Math.abs(prev) * 100;
+  if (Math.abs(pct) < FLAT_PCT)
+    return { pct, dir: "flat", tone: "neutral" };
+  const dir = pct > 0 ? "up" : "down";
+  return { pct, dir, tone: dir === better ? "success" : "error" };
+}
+var DAY_MS2, FLAT_PCT = 0.5;
+var init_period = __esm(() => {
+  DAY_MS2 = 24 * 60 * 60 * 1000;
+});
+
+// ../../packages/shared/src/deploys/report.ts
+function duration(ms) {
+  const min = ms / 60000;
+  if (min < 60)
+    return `${Math.round(min)}m`;
+  const hours = min / 60;
+  if (hours < 48)
+    return `${hours.toFixed(1)}h`;
+  return `${(hours / 24).toFixed(1)}d`;
+}
+function change(pair, better) {
+  const { current, previous } = pair;
+  if (current == null)
+    return "";
+  if (previous == null)
+    return " (none before)";
+  const c = periodChange(current, previous, better);
+  if (c.dir === "flat")
+    return " (flat)";
+  if (c.pct == null)
+    return " (none before)";
+  return ` (${c.pct > 0 ? "+" : "−"}${Math.round(Math.abs(c.pct))}%)`;
+}
+function timeFigure(label, pair) {
+  if (pair.current == null)
+    return `${label} none`;
+  return `${label} ${duration(pair.current)}${change(pair, "down")}`;
+}
+function rateFigure(pair) {
+  const { current, previous } = pair;
+  if (current == null)
+    return "failure rate none";
+  const pct = Math.round(current * 100);
+  if (previous == null)
+    return `failure rate ${pct}% (none before)`;
+  const pts = pct - Math.round(previous * 100);
+  return `failure rate ${pct}% (${pts === 0 ? "flat" : `${pts > 0 ? "+" : "−"}${Math.abs(pts)} pts`})`;
+}
+function batchFigure(pair) {
+  if (total(pair.current) === 0)
+    return "batch none";
+  const before = total(pair.previous) === 0 ? "none before" : `was ${tiers(pair.previous)}`;
+  return `batch ${tiers(pair.current)} (${before})`;
+}
+function lineText(l) {
+  const head = `${l.name} (${l.slug})`;
+  if (l.production == null)
+    return `${head} · no production environment set, so no deploy metrics`;
+  const deploys = `${l.deploys.current} deploy${l.deploys.current === 1 ? "" : "s"}${change(l.deploys, "up")}`;
+  return [
+    `${head} · ${l.production}: ${deploys}`,
+    timeFigure("lead time", l.leadTime),
+    rateFigure(l.failRate),
+    timeFigure("time to recover", l.recover),
+    batchFigure(l.batch)
+  ].join(" · ");
+}
+function metricsText(r) {
+  const sameYear = r.from.slice(0, 4) === r.to.slice(0, 4);
+  const span = `${dayLabel(r.from, !sameYear)} – ${dayLabel(r.to, true)}`;
+  const days = `${r.days} day${r.days === 1 ? "" : "s"}`;
+  const header = `${r.scope === "org" ? "Org" : "Workspace"} · ${span} (${days}), against the ${days} before`;
+  const lines = r.lines.length ? r.lines.map(lineText) : [r.scope === "org" ? "No workspaces in this org." : "No workspace."];
+  return [header, ...lines].join(`
+`);
+}
+var DAY_MS3, METRICS_RANGES, tiers = (c) => TIERS.map((t) => `${t}${c[t]}`).join(" "), total = (c) => TIERS.reduce((n, t) => n + c[t], 0), dayLabel = (day, year) => new Date(`${day}T00:00:00Z`).toLocaleDateString("en-US", {
+  month: "short",
+  day: "numeric",
+  ...year ? { year: "numeric" } : {},
+  timeZone: "UTC"
+});
+var init_report = __esm(() => {
+  init_batchSize();
+  init_period();
+  DAY_MS3 = 24 * 60 * 60 * 1000;
+  METRICS_RANGES = [
+    { key: "2w", days: 14 },
+    { key: "1m", days: 30 },
+    { key: "3m", days: 91 },
+    { key: "6m", days: 182 },
+    { key: "1y", days: 365 }
+  ];
+});
+
 // ../../packages/shared/src/guidance/model.ts
 var CARD_FIELDS;
 var init_model = __esm(() => {
@@ -2120,7 +2250,7 @@ var read = (title) => ({
   destructiveHint: false,
   idempotentHint: idempotent,
   openWorldHint: false
-}), change = (title, idempotent = false) => ({
+}), change2 = (title, idempotent = false) => ({
   title,
   readOnlyHint: false,
   destructiveHint: true,
@@ -2130,6 +2260,7 @@ var read = (title) => ({
 var init_annotations = __esm(() => {
   TOOL_ANNOTATIONS = {
     usage: read("Seat usage"),
+    metrics: read("Delivery metrics"),
     jobs: read("Overnight jobs"),
     status: read("Where is it"),
     touches: read("What it touches"),
@@ -2158,9 +2289,9 @@ var init_annotations = __esm(() => {
     buddy: add("Pair with a buddy"),
     pickup: add("Pick up a hand-off"),
     reopen: add("Reopen an item", true),
-    update: change("Change an item", true),
-    archive: change("Archive an item", true),
-    withdraw: change("Withdraw a hand-off", true)
+    update: change2("Change an item", true),
+    archive: change2("Archive an item", true),
+    withdraw: change2("Withdraw a hand-off", true)
   };
 });
 
@@ -2421,19 +2552,23 @@ var init_plan2 = __esm(() => {
 });
 
 // ../../packages/shared/src/mcp/sled.ts
-function section(label, rows, now) {
+function section(label, rows, now, count = rows.length) {
   if (rows.length === 0)
     return null;
-  return `${label} (${rows.length}):
+  const total = Math.max(count, rows.length);
+  const more = total > rows.length ? `
+
+…and ${total - rows.length} more` : "";
+  return `${label} (${total}):
 
 ${rows.map((r) => statusLine(r, now)).join(`
 
-`)}`;
+`)}${more}`;
 }
 function sledText(s, now) {
   const parts = [
     section("On your sled", s.mine, now),
-    section("Proposed to you", s.proposed, now),
+    section("Proposed to you", s.proposed, now, s.proposedCount),
     section("Sent to you", s.sent, now)
   ].filter((p) => p !== null);
   if (parts.length === 0)
@@ -2706,6 +2841,60 @@ async function usageTool(ctx) {
   return { text: formatMeter(m, (ctx.now ?? Date.now)()).join(`
 `) };
 }
+function asMetricsReport(j) {
+  if (!j || j.scope !== "workspace" && j.scope !== "org")
+    return null;
+  if (typeof j.from !== "string" || typeof j.to !== "string" || num3(j.days) === undefined)
+    return null;
+  if (!Array.isArray(j.lines) || !j.lines.every(isObject4))
+    return null;
+  return j;
+}
+async function metricsTool(ctx, args) {
+  if (!ctx.client)
+    return NOT_SET_UP;
+  const qs = new URLSearchParams;
+  for (const k of ["workspace", "range", "from", "to"]) {
+    const v = str5(args[k])?.trim();
+    if (v)
+      qs.set(k, v);
+  }
+  const query = qs.toString();
+  const path = query ? `/proxy/metrics?${query}` : "/proxy/metrics";
+  const noReport = { text: "SLEDS answered without a metrics report.", isError: true };
+  if (!ctx.client.getFull) {
+    const j = await ctx.client.get(path);
+    if (!j)
+      return UNREACHABLE;
+    const report = asMetricsReport(j);
+    return report ? { text: metricsText(report) } : noReport;
+  }
+  const r = await ctx.client.getFull(path);
+  if ("error" in r)
+    return {
+      text: `Control plane unreachable: ${r.error} → try again in a moment.`,
+      isError: true
+    };
+  const why = errorMessage(r.json);
+  if (r.status === 200) {
+    const report = asMetricsReport(r.json);
+    return report ? { text: metricsText(report) } : noReport;
+  }
+  const workspace = qs.get("workspace");
+  if (r.status === 404)
+    return {
+      text: workspace ? `No workspace "${workspace}" that this seat sees. Leave workspace out for the whole org, one line per workspace.` : `${why ?? "Not found"} (HTTP 404).`,
+      isError: true
+    };
+  if (r.status === 400)
+    return { text: why ?? "Bad request (HTTP 400).", isError: true };
+  if (r.status >= 500)
+    return {
+      text: `${why ?? "Control plane unreachable"} (HTTP ${r.status}) → try once more in a moment, then move on and say so.`,
+      isError: true
+    };
+  return { text: `${why ?? "SLEDS refused it"} (HTTP ${r.status}).`, isError: true };
+}
 function bandLine(band) {
   if (!isObject4(band))
     return null;
@@ -3328,7 +3517,12 @@ async function sledTool(ctx, args) {
     return UNREACHABLE;
   const rows = (k) => Array.isArray(r[k]) ? r[k].filter(isObject4) : [];
   return {
-    text: sledText({ mine: rows("mine"), proposed: rows("proposed"), sent: rows("sent") }, (ctx.now ?? Date.now)())
+    text: sledText({
+      mine: rows("mine"),
+      proposed: rows("proposed"),
+      ...typeof r.proposedCount === "number" ? { proposedCount: r.proposedCount } : {},
+      sent: rows("sent")
+    }, (ctx.now ?? Date.now)())
   };
 }
 function checkWarningsOf(ctx, drafts) {
@@ -4300,6 +4494,8 @@ async function callTool(name, args, ctx) {
   switch (name) {
     case "usage":
       return usageTool(ctx);
+    case "metrics":
+      return metricsTool(ctx, args);
     case "estimate":
       return estimateTool(ctx, args);
     case "intake":
@@ -4439,6 +4635,7 @@ async function handleLine(line, ctx) {
 }
 var PROTOCOL_VERSION = "2025-06-18", SERVER_INFO, SERVER_INSTRUCTIONS, MCP_TIMEOUT_MS = 5000, sourceSchema, specSchema, TOOLS, VIEW_TOOLS, NOT_SET_UP, UNREACHABLE, isObject4 = (v) => typeof v === "object" && v !== null && !Array.isArray(v), num3 = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined, str5 = (v) => typeof v === "string" ? v : undefined, errorMessage = (j) => isObject4(j?.error) ? str5(j.error.message) : str5(j?.error), proposalText = (t) => (t ?? "").replace(/\n*Nothing runs until a person says yes:[^\n]*$/, ""), PROPOSED_NEXT = (key) => `Nothing runs until a person approves it: Approve in the SLEDS app or on the item page, or \`sleds route approve ${key}\`. If you are a planning session, stop here.`, strList = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : undefined, RELATION_HOWS, UI_RESOURCES, response = (id, result) => JSON.stringify({ jsonrpc: "2.0", id, result }), errorResponse = (id, code, message) => JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } });
 var init_server = __esm(() => {
+  init_report();
   init_worth();
   init_intake();
   init_model();
@@ -4506,6 +4703,32 @@ var init_server = __esm(() => {
       description: "The SLEDS meter for this seat: built today, month against the ceiling, window and reset, allowance, queued/running/delivered jobs, the last wall, and the seat's own Pro/Max limit bars.",
       inputSchema: { type: "object", properties: {} }
     },
+    {
+      name: "metrics",
+      description: "DORA and batch-size metrics for a period, against the same length just before it: deploy frequency, lead time, change failure rate, time to recover and production deploys by batch size. For one workspace, or — with no `workspace` — the whole org, one line per workspace. Only the workspaces this seat sees. The same days the Metrics page counts.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          workspace: {
+            type: "string",
+            description: "The workspace's slug. Leave it out for the whole org."
+          },
+          range: {
+            type: "string",
+            enum: METRICS_RANGES.map((r) => r.key),
+            description: "A preset period ending today; default 2w. Leave it out when giving from."
+          },
+          from: {
+            type: "string",
+            description: "First day of a custom period, YYYY-MM-DD (UTC). At most 366 days."
+          },
+          to: {
+            type: "string",
+            description: "Last day of a custom period, YYYY-MM-DD, included; default today."
+          }
+        }
+      }
+    },
     {
       name: "estimate",
       description: "Call this BEFORE starting any build that will take more than a few minutes — before the first line of work, not after. Sizes the task: the org estimator's cost and time band with confidence and a spend cap, never a point figure. Pass a stable `source` (kind · project · doc · item) so the item has a home on the sled and the later `actual` finds it. Recorded, so actuals calibrate the next estimate.",
@@ -5443,12 +5666,6 @@ var init_recommend = __esm(() => {
 var init_profile2 = __esm(() => {
   init_profile();
 });
-// ../../packages/shared/src/item/outcome.ts
-var OUTCOME_WINDOW_DAYS = 14, OUTCOME_WINDOW_MS;
-var init_outcome = __esm(() => {
-  OUTCOME_WINDOW_MS = OUTCOME_WINDOW_DAYS * 86400000;
-});
-
 // ../../packages/shared/src/slack/mention.ts
 var MENTION_HELP;
 var init_mention = __esm(() => {
@@ -6534,30 +6751,12 @@ var init_deploys = __esm(() => {
   SERVICE_RE = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,39}$/;
 });
 
-// ../../packages/shared/src/deploys/metrics.ts
-var WEEK_MS;
-var init_metrics = __esm(() => {
-  WEEK_MS = 7 * 24 * 60 * 60 * 1000;
-});
-
-// ../../packages/shared/src/deploys/period.ts
-var DAY_MS2;
-var init_period = __esm(() => {
-  DAY_MS2 = 24 * 60 * 60 * 1000;
-});
-
 // ../../packages/shared/src/deploys/stability.ts
 var init_stability = __esm(() => {
   init_outcome();
   init_metrics();
 });
 
-// ../../packages/shared/src/deploys/batchSize.ts
-var init_batchSize = __esm(() => {
-  init_outcome();
-  init_metrics();
-});
-
 // ../../packages/shared/src/newrelic/newrelic.ts
 var init_newrelic = () => {};
 
@@ -7968,6 +8167,7 @@ var init_src = __esm(() => {
   init_period();
   init_stability();
   init_batchSize();
+  init_report();
   init_sentry();
   init_newrelic();
   init_musher();
@@ -8692,6 +8892,7 @@ init_metrics();
 init_period();
 init_stability();
 init_batchSize();
+init_report();
 init_sentry();
 init_newrelic();
 init_musher();
@@ -11248,7 +11449,7 @@ function beatBody(state, flags, host = {}, cap = {}) {
     name: flags.name,
     os: host.os ?? process.platform,
     runner: flags.runner,
-    version: host.version ?? "0.1.50" ?? "dev",
+    version: host.version ?? "0.1.51" ?? "dev",
     running: live.length,
     items: live.slice(0, BEAT_ITEMS).map((r) => `${r.item}/${r.node}`),
     ...cap.atOnce !== undefined ? { atOnce: cap.atOnce } : {},
@@ -16973,7 +17174,7 @@ async function fetchVersion(o) {
   const platform = o.platform ?? process.platform;
   const arch = o.arch ?? process.arch;
   const publicKey = o.publicKey ?? RELEASE_PUBLIC_KEY;
-  const running = o.running ?? "0.1.50";
+  const running = o.running ?? "0.1.51";
   if (!publicKey)
     return { ok: false, why: "no release key yet" };
   if (!VERSION_RE2.test(o.version))
@@ -18557,7 +18758,7 @@ function engineClient(o, org) {
     return fetchClient({
       ...src,
       timeoutMs: ENGINE_TIMEOUT_MS,
-      version: "0.1.50"
+      version: "0.1.51"
     });
   const asked = org?.trim() || env.SLEDS_ORG?.trim();
   if (asked && !selectOrg(readConfig(o.home), org, env).seat)
@@ -18848,7 +19049,7 @@ async function driveEngine(o, flags, deps, until = {}) {
     runner: deps.runner.name,
     atOnce: flags.atOnce,
     interval: flags.interval,
-    cliVersion: "0.1.50"
+    cliVersion: "0.1.51"
   };
   const beat = (checkedAt) => {
     const m = deps.machine;
@@ -20705,7 +20906,7 @@ function engineClient2(o, org) {
     return fetchClient({
       ...src,
       timeoutMs: ENGINE_TIMEOUT_MS2,
-      version: "0.1.50"
+      version: "0.1.51"
     });
   const asked = org?.trim() || env.SLEDS_ORG?.trim();
   if (asked && !selectOrg(readConfig(o.home), org, env).seat)
@@ -21031,7 +21232,7 @@ async function driveEngine2(o, flags, deps, until = {}) {
     runner: deps.runner.name,
     atOnce: flags.atOnce,
     interval: flags.interval,
-    cliVersion: "0.1.50"
+    cliVersion: "0.1.51"
   };
   const beat = (checkedAt) => {
     const m = deps.machine;
@@ -23119,7 +23320,7 @@ function contextFor(deps) {
     ...src,
     fetchFn: deps.fetchFn,
     timeoutMs: deps.timeoutMs,
-    version: "0.1.50"
+    version: "0.1.51"
   }), deps.home, now) : null;
   return {
     channel: "code",
@@ -27205,7 +27406,7 @@ var realPidAlive4 = (pid) => {
 };
 function machineClient(home, env) {
   const src = meterSource(home, undefined, { env });
-  return src ? fetchClient({ ...src, version: "0.1.50" }) : null;
+  return src ? fetchClient({ ...src, version: "0.1.51" }) : null;
 }
 async function noteAnswer2(home, a, now) {
   try {
@@ -28050,7 +28251,7 @@ var main = async (argv) => {
     now: Date.now(),
     stderr: (line) => console.error(line),
     isTTY: !!process.stderr.isTTY,
-    version: "0.1.50"
+    version: "0.1.51"
   });
   switch (cmd) {
     case "update":
@@ -28283,7 +28484,7 @@ ${renderHelpText(argv[1])}`);
     case "version":
     case "--version":
     case "-v":
-      console.log("sleds 0.1.50");
+      console.log("sleds 0.1.51");
       return 0;
     default:
       console.error(`unknown command: ${cmd}
@@ -28304,10 +28505,18 @@ var isMain = () => {
     return false;
   }
 };
+var drained = (stream) => new Promise((resolve) => {
+  stream.once("error", () => resolve());
+  stream.write("", () => resolve());
+});
+var exitDrained = async (code) => {
+  await Promise.all([drained(process.stdout), drained(process.stderr)]);
+  process.exit(code);
+};
 if (isMain()) {
-  main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+  main(process.argv.slice(2)).then((code) => exitDrained(code), (err) => {
     console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+    return exitDrained(1);
   });
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleds/cli",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "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",