@herdingchats/friday 0.1.1 → 0.1.525

package/herd.mjs

@@ -18,7 +18,7 @@ var __export = (target, all) => {
 var define_HERD_PACKAGE_default;
 var init_define_HERD_PACKAGE = __esm({
   "<define:HERD_PACKAGE>"() {
-    define_HERD_PACKAGE_default = { version: "0.1.1", gitHead: "91b08aebd285af82cf2ea35b4b380b52acf2a33f" };
+    define_HERD_PACKAGE_default = { version: "0.1.525", gitHead: "cbd227dfdbed52c13e4cb3a2b388d6e7d4a6866e" };
   }
 });
 
@@ -513,6 +513,9 @@ import { z as z8 } from "zod";
 function agentShortName(cli) {
   return AGENTS[cli]?.short ?? cli;
 }
+function shareOf(harness) {
+  return harness?.share ?? (harness?.enabled === false ? "off" : "some");
+}
 function runnerCapacity(setting) {
   if (setting === void 0 || setting === true) return 1;
   return setting.max;
@@ -528,7 +531,7 @@ function workerKey(machineId, cli) {
 function machineShortName(name) {
   return name.trim().toLowerCase().replace(/\.local$/, "").replace(/\s+/g, "-");
 }
-var CAPABILITIES, capabilitySchema, PLATFORMS, platformSchema, TOOLS, toolSchema, CAPABILITY_WORDING, AGENTS, PHRASE_MAX, PHRASES_MAX, ABOUT_MAX, phrase, phrases, harnessConfigSchema, BUILDS_MAX, buildsSettingSchema, CONFIG_REPOS_MAX, configRepoSchema, herdConfigSchema, HERD_CONFIG_TYPE, PROFILE_LEVELS, profileEntrySchema, workerSchema;
+var CAPABILITIES, capabilitySchema, PLATFORMS, platformSchema, TOOLS, toolSchema, CAPABILITY_WORDING, AGENTS, PHRASE_MAX, PHRASES_MAX, ABOUT_MAX, phrase, phrases, SHARES, shareSchema, SHARE_LABELS, harnessConfigSchema, BUILDS_MAX, buildsSettingSchema, CONFIG_REPOS_MAX, configRepoSchema, herdConfigSchema, HERD_CONFIG_TYPE, PROFILE_LEVELS, profileEntrySchema, workerSchema;
 var init_workers = __esm({
   "../common-chat/src/workers.ts"() {
     "use strict";
@@ -566,7 +569,17 @@ var init_workers = __esm({
     ABOUT_MAX = 500;
     phrase = z8.string().trim().min(1).max(PHRASE_MAX, `at most ${PHRASE_MAX} characters`);
     phrases = z8.array(phrase).max(PHRASES_MAX, `at most ${PHRASES_MAX} phrases`);
+    SHARES = ["off", "little", "some", "lot"];
+    shareSchema = z8.enum(SHARES);
+    SHARE_LABELS = {
+      off: "off",
+      little: "a little",
+      some: "some",
+      lot: "a lot"
+    };
     harnessConfigSchema = z8.object({
+      share: shareSchema.optional(),
+      /** Read as `share: "off"` when false, from files written before shares. */
       enabled: z8.boolean().optional(),
       only: phrases.optional(),
       great: phrases.optional(),
@@ -619,10 +632,12 @@ var init_workers = __esm({
   /** Each harness by its short name, such as claude, codex or gemini. */
   harnesses?: Record<string, {
     /**
-     * Whether this machine runs the agent at all, as chosen in \`friday start\`. false means it's no
-     * worker here. Without a configuration file, every installed agent is.
+     * How much of this agent its owner has, as chosen in \`friday start\`: "off", "little", "some"
+     * or "lot". Routing gives each its share of the work several agents suit equally, weighted
+     * 1, 2 and 4. "off" means it's no worker here. Without a configuration file, every installed
+     * agent is at "some".
      */
-    enabled?: boolean;
+    share?: "off" | "little" | "some" | "lot";
     /** It takes only work about one of these, however good it is at other work. */
     only?: string[];
     /**
@@ -664,6 +679,8 @@ export default {
       /** What it's great, good and okay at, and can't do: its agent's defaults with its owner's word. */
       profile: z8.array(profileEntrySchema),
       priority: z8.number().int(),
+      /** How much of its agent its owner has. Servers from before shares send none, which is "some". */
+      share: shareSchema.default("some"),
       enabled: z8.boolean(),
       /** Whether its agent checked in from herd's terminal on this version, so it's offered work. */
       activated: z8.boolean(),
@@ -1002,6 +1019,7 @@ var init_events = __esm({
     init_prompts();
     init_usage();
     init_work_objects();
+    init_workers();
     routeSchema = z13.enum(["direct", "mention", "joined"]);
     deliveryModeSchema = z13.enum(["interrupt", "defer"]);
     eventSourceSchema = z13.enum(["slack", "discord", "web", "api", "cli", "mcp", "system"]);
@@ -1056,7 +1074,18 @@ var init_events = __esm({
       // The repos the work hinted, and the workers whose machine had cloned every one, which go first
       // among workers that tie on fit and priority.
       hints: z13.array(nonEmpty6).optional(),
-      warm: z13.array(nonEmpty6).optional()
+      warm: z13.array(nonEmpty6).optional(),
+      // Each ordered worker's share, how its weekly usage is pacing, and the weight that gives it. The
+      // first worker was drawn by weight from those in `drawn`, which suited the work equally.
+      shares: z13.array(
+        z13.object({
+          key: nonEmpty6,
+          share: shareSchema,
+          pacing: z13.enum(["ahead", "even", "under", "unknown"]),
+          weight: z13.number().nonnegative()
+        })
+      ).optional(),
+      drawn: z13.array(nonEmpty6).optional()
     });
     conversationEventSchema = z13.discriminatedUnion("type", [
       event("message.created", {
@@ -3171,9 +3200,9 @@ import { fileURLToPath as fileURLToPath3 } from "node:url";
 // src/friday/main.ts
 init_define_HERD_PACKAGE();
 import { spawn as spawn5 } from "node:child_process";
-import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync10 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname8, join as join13 } from "node:path";
+import { dirname as dirname9, join as join13 } from "node:path";
 import { z as z22 } from "zod";
 
 // src/auth.ts
@@ -3369,6 +3398,89 @@ async function apiFetch(path, init = {}) {
   return response;
 }
 
+// src/cli-flags.ts
+init_define_HERD_PACKAGE();
+var HERD_FLAGS = {
+  login: [],
+  logout: [],
+  daemon: ["--repo"],
+  attach: [],
+  builds: [],
+  inbox: [],
+  send: ["--json"],
+  automations: ["--json", "--wait"],
+  channels: [],
+  watch: [],
+  unwatch: [],
+  watching: [],
+  conversations: ["--about", "--json"],
+  github: ["--on", "--off", "--json"],
+  setup: ["--json"],
+  repo: [],
+  repos: ["--json"],
+  work: ["--kind", "--title", "--status", "--detail", "--phase", "--made", "--remove", "--json"],
+  check: [],
+  handoff: [],
+  delegate: ["--repo"],
+  tell: ["--json"],
+  workers: ["--json", "--types"],
+  status: ["--clear"],
+  title: [],
+  handled: [],
+  pass: [],
+  exit: [],
+  persona: []
+};
+var FRIDAY_FLAGS = {
+  start: ["--agents"],
+  stop: [],
+  status: [],
+  logs: ["--follow", "-f", "-n"]
+};
+var HERD_OWN_HELP = /* @__PURE__ */ new Set([
+  "builds",
+  "send",
+  "automations",
+  "watch",
+  "unwatch",
+  "watching",
+  "github",
+  "repo",
+  "repos",
+  "work",
+  "check",
+  "handoff",
+  "delegate",
+  "tell",
+  "workers",
+  "status",
+  "title"
+]);
+var FLAG = /^--?[A-Za-z][\w-]*(=.*)?$/;
+function unknownFlag(program, command, args, known) {
+  for (const arg of args) {
+    if (arg === "--") break;
+    if (!FLAG.test(arg)) continue;
+    const name = arg.split("=")[0] ?? arg;
+    if (name === "--help" || name === "-h" || known.includes(name)) continue;
+    const takes = known.length ? `It takes ${known.join(", ")}.` : "It takes no options.";
+    return `${program} ${command} doesn't have a "${name}" option, so nothing ran. ${takes} See ${program} ${command} --help.`;
+  }
+  return null;
+}
+var asksForHelp = (args) => args.some((arg) => arg === "--help" || arg === "-h");
+function commandHelp(overview, command) {
+  const lines = overview.split("\n");
+  const start = lines.findIndex((line2) => new RegExp(`^  ${command}(\\s|$)`).test(line2));
+  if (start === -1) return null;
+  const out = [lines[start] ?? ""];
+  for (const line2 of lines.slice(start + 1)) {
+    if (!/^ {4,}\S/.test(line2)) break;
+    out.push(line2);
+  }
+  return out.join("\n");
+}
+
 // src/commands/login.ts
 init_define_HERD_PACKAGE();
 import { spawn } from "node:child_process";
@@ -3402,9 +3514,9 @@ async function runLogout() {
 init_define_HERD_PACKAGE();
 import { execFileSync as execFileSync3 } from "node:child_process";
 import { randomUUID } from "node:crypto";
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir3, hostname } from "node:os";
-import { basename, join as join5, resolve } from "node:path";
+import { basename, dirname as dirname3, join as join5, resolve } from "node:path";
 import { z as z18 } from "zod";
 
 // src/machine-facts.ts
@@ -3649,7 +3761,7 @@ var ADAPTERS = [
   { cli: "agy", capabilities: ["image_generation"] }
 ];
 function chosenClis(clis, config) {
-  return clis.filter((cli) => config?.harnesses?.[agentShortName(cli.name)]?.enabled !== false);
+  return clis.filter((cli) => shareOf(config?.harnesses?.[agentShortName(cli.name)]) !== "off");
 }
 var runCommand = (command, args) => {
   try {
@@ -4111,6 +4223,20 @@ function readRoot() {
 function setRoot(path) {
   return save({ ...loadConfig(), root: resolve(path) });
 }
+async function waitForRoot(root, {
+  pollMs = 2e3,
+  exists = existsSync2,
+  sleep: sleep8 = (ms) => new Promise((done) => setTimeout(done, ms)),
+  log = (line2) => console.log(line2)
+} = {}) {
+  const parent = dirname3(root);
+  if (exists(parent)) return;
+  log(
+    `Waiting for ${parent}, which holds this machine's root, to be there, as when its drive mounts.`
+  );
+  while (!exists(parent)) await sleep8(pollMs);
+  log(`${parent} is there.`);
+}
 var machineRoot = () => readRoot() ?? defaultRoot();
 function describeRepo(path) {
   const full = resolve(path);
@@ -4267,15 +4393,15 @@ async function readSetup(fetch2, init) {
 // src/friday/agents.ts
 init_define_HERD_PACKAGE();
 init_src();
-import { existsSync as existsSync3, mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname4, join as join7 } from "node:path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname5, join as join7 } from "node:path";
 
 // src/activation.ts
 init_define_HERD_PACKAGE();
 init_src();
 import { randomBytes as randomBytes4, randomUUID as randomUUID3 } from "node:crypto";
 import { mkdirSync as mkdirSync4, readFileSync as readFileSync5, renameSync as renameSync2, rmSync as rmSync5, statSync as statSync4, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { dirname as dirname4, join as join6 } from "node:path";
 import { z as z21 } from "zod";
 
 // src/permissions.ts
@@ -4287,7 +4413,7 @@ import { z as z20 } from "zod";
 // src/local-socket.ts
 init_define_HERD_PACKAGE();
 import { randomBytes as randomBytes3 } from "node:crypto";
-import { chmodSync as chmodSync2, existsSync as existsSync2, rmSync as rmSync4 } from "node:fs";
+import { chmodSync as chmodSync2, existsSync as existsSync3, rmSync as rmSync4 } from "node:fs";
 import { connect, createServer as createServer2 } from "node:net";
 import { z as z19 } from "zod";
 var localRequestSchema = z19.object({
@@ -4423,7 +4549,7 @@ var LocalSocket = class {
     }
   }
   async listen() {
-    if (existsSync2(this.path)) rmSync4(this.path);
+    if (existsSync3(this.path)) rmSync4(this.path);
     this.server = createServer2((socket) => this.serve(socket));
     await new Promise((resolve6, reject) => {
       this.server?.once("error", reject);
@@ -4505,7 +4631,7 @@ function askDaemon(path, request) {
 }
 function isAnswering(path) {
   return new Promise((resolve6) => {
-    if (!existsSync2(path)) return resolve6(false);
+    if (!existsSync3(path)) return resolve6(false);
     const socket = connect(path);
     socket.on("connect", () => {
       socket.destroy();
@@ -4744,7 +4870,7 @@ var Activator = class {
   }
   record(agent, record) {
     const agents = { ...readActivations(this.path), [agent]: record };
-    mkdirSync4(dirname3(this.path), { recursive: true, mode: 448 });
+    mkdirSync4(dirname4(this.path), { recursive: true, mode: 448 });
     const temporary = `${this.path}.${process.pid}`;
     writeFileSync4(temporary, JSON.stringify({ agents }, null, 2), { mode: 384 });
     renameSync2(temporary, this.path);
@@ -4956,36 +5082,42 @@ var ACTIVATION_READ_MS = 500;
 var label2 = (cli) => AGENTS[cli]?.label ?? cli;
 function agentChoices(installed, saved) {
   const harnesses = saved?.harnesses ?? {};
-  const chosenBefore = Object.values(harnesses).some((harness) => harness.enabled !== void 0);
+  const chosenBefore = Object.values(harnesses).some(
+    (harness) => harness.enabled !== void 0 || harness.share !== void 0
+  );
   return ADAPTERS.map(({ cli }) => {
     const isInstalled = installed.includes(cli);
-    const enabled = harnesses[agentShortName(cli)]?.enabled;
+    const harness = harnesses[agentShortName(cli)];
+    const before = harness?.share ?? (harness?.enabled ? "some" : "off");
     return {
       cli,
       label: label2(cli),
       installed: isInstalled,
-      checked: chosenBefore ? enabled === true : isInstalled
+      share: chosenBefore ? before : isInstalled ? "some" : "off"
     };
   });
 }
 function parseAgents(value) {
-  const names = value.split(",").map((name) => name.trim().toLowerCase()).filter(Boolean);
-  const agents = [];
+  const parts = value.split(",").map((part) => part.trim().toLowerCase()).filter(Boolean);
+  const shares = Object.fromEntries(ADAPTERS.map(({ cli }) => [cli, "off"]));
   const unknown = [];
-  for (const name of names) {
+  for (const part of parts) {
+    const [name = "", share = "some"] = part.split("=", 2).map((piece) => piece.trim());
     const adapter = ADAPTERS.find(
       ({ cli }) => cli === name || agentShortName(cli) === name || label2(cli).toLowerCase() === name
     );
-    if (adapter) agents.push(adapter.cli);
-    else unknown.push(name);
+    if (adapter && SHARES.includes(share)) {
+      shares[adapter.cli] = share;
+    } else unknown.push(part);
   }
-  return unknown.length > 0 ? { unknown } : { agents: [...new Set(agents)] };
+  return unknown.length > 0 ? { unknown } : { shares };
 }
-function withChoice(config, chosen) {
+function withChoice(config, shares) {
   const harnesses = { ...config?.harnesses ?? {} };
   for (const { cli } of ADAPTERS) {
     const short = agentShortName(cli);
-    harnesses[short] = { ...harnesses[short], enabled: chosen.includes(cli) };
+    const { enabled: _, ...rest } = harnesses[short] ?? {};
+    harnesses[short] = { ...rest, share: shares[cli] ?? "off" };
   }
   return { ...config, harnesses };
 }
@@ -4994,9 +5126,10 @@ function configSource(config) {
 export default ${JSON.stringify(config, null, 2)};
 `;
 }
-var sameChoice = (config, chosen) => ADAPTERS.every(
-  ({ cli }) => config?.harnesses?.[agentShortName(cli)]?.enabled === chosen.includes(cli)
-);
+var sameChoice = (config, shares) => ADAPTERS.every(({ cli }) => {
+  const harness = config?.harnesses?.[agentShortName(cli)];
+  return harness?.enabled === void 0 && harness?.share === (shares[cli] ?? "off");
+});
 async function chooseAgents(options, print) {
   const [installed, loaded] = await Promise.all([options.installed(), options.load()]);
   if (loaded.status === "error") {
@@ -5006,14 +5139,15 @@ async function chooseAgents(options, print) {
   const saved = loaded.status === "ok" ? loaded.config : void 0;
   const choices = agentChoices(installed, saved);
   const asked = options.given ? null : await (options.pick?.(choices) ?? Promise.resolve(null));
-  const chosen = options.given ?? asked ?? // No terminal: what was chosen before, or what's installed.
-  choices.filter((choice) => choice.checked).map((choice) => choice.cli);
-  if (!sameChoice(saved, chosen) || !existsSync3(options.configPath)) {
-    mkdirSync5(dirname4(options.configPath), { recursive: true, mode: 448 });
-    writeFileSync5(options.configPath, configSource(withChoice(saved, chosen)), { mode: 384 });
+  const shares = options.given ?? asked ?? // No terminal: what was chosen before, or what's installed.
+  Object.fromEntries(choices.map((choice) => [choice.cli, choice.share]));
+  if (!sameChoice(saved, shares) || !existsSync4(options.configPath)) {
+    mkdirSync5(dirname5(options.configPath), { recursive: true, mode: 448 });
+    writeFileSync5(options.configPath, configSource(withChoice(saved, shares)), { mode: 384 });
   }
+  const chosen = ADAPTERS.map(({ cli }) => cli).filter((cli) => (shares[cli] ?? "off") !== "off");
   print(
-    chosen.length > 0 ? `This machine runs ${chosen.map(label2).join(", ")}.` : "This machine runs no agents, so it takes no work. Run this again to choose some."
+    chosen.length > 0 ? `This machine runs ${chosen.map((cli) => `${label2(cli)} (${SHARE_LABELS[shares[cli]]})`).join(", ")}.` : "This machine runs no agents, so it takes no work. Run this again to choose some."
   );
   return chosen;
 }
@@ -5081,7 +5215,7 @@ init_define_HERD_PACKAGE();
 import { spawnSync } from "node:child_process";
 import {
   closeSync as closeSync2,
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   mkdirSync as mkdirSync6,
   openSync as openSync2,
   readFileSync as readFileSync6,
@@ -5089,7 +5223,7 @@ import {
   statSync as statSync5,
   writeFileSync as writeFileSync6
 } from "node:fs";
-import { dirname as dirname5, join as join8, resolve as resolve2 } from "node:path";
+import { dirname as dirname6, join as join8, resolve as resolve2 } from "node:path";
 var PACKAGE_NAME = "@herdingchats/friday";
 function fridayPaths(herdHome2) {
   const logs = join8(herdHome2, "logs");
@@ -5118,8 +5252,8 @@ function alive2(pid) {
   }
 }
 function takeLock(path, staleMs = 10 * 6e4) {
-  mkdirSync6(dirname5(path), { recursive: true });
-  if (existsSync4(path)) {
+  mkdirSync6(dirname6(path), { recursive: true });
+  if (existsSync5(path)) {
     const holder2 = Number(readFileSync6(path, "utf8").trim());
     const old = Date.now() - statSync5(path).mtimeMs > staleMs;
     if (old || !alive2(holder2)) rmSync6(path, { force: true });
@@ -5169,7 +5303,7 @@ function writeRoot(paths, root) {
 }
 function insideWorkTree(folder) {
   let dir = resolve2(folder);
-  while (!existsSync4(dir) && dirname5(dir) !== dir) dir = dirname5(dir);
+  while (!existsSync5(dir) && dirname6(dir) !== dir) dir = dirname6(dir);
   const result = spawnSync("git", ["-C", dir, "rev-parse", "--show-toplevel"], {
     encoding: "utf8",
     stdio: ["ignore", "pipe", "ignore"]
@@ -5189,6 +5323,9 @@ var VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
 
 // src/friday/picker.ts
 init_define_HERD_PACKAGE();
+init_src();
+var LESS = /* @__PURE__ */ new Set(["-", "_", "\x1B[D"]);
+var MORE = /* @__PURE__ */ new Set(["+", "=", "\x1B[C"]);
 function pickerKey(state, key) {
   const { choices, cursor } = state;
   if (key === "" || key === "\x1B") return null;
@@ -5197,22 +5334,28 @@ function pickerKey(state, key) {
     return { ...state, cursor: (cursor + choices.length - 1) % choices.length };
   }
   if (key === "\x1B[B" || key === "j") return { ...state, cursor: (cursor + 1) % choices.length };
-  if (key === " ") {
-    return {
-      ...state,
-      choices: choices.map(
-        (choice, at) => at === cursor ? { ...choice, checked: !choice.checked } : choice
-      )
-    };
-  }
-  return state;
+  const step = LESS.has(key) ? -1 : MORE.has(key) ? 1 : 0;
+  if (step === 0) return state;
+  return {
+    ...state,
+    choices: choices.map((choice, at) => {
+      if (at !== cursor) return choice;
+      const next = Math.min(SHARES.length - 1, Math.max(0, SHARES.indexOf(choice.share) + step));
+      return { ...choice, share: SHARES[next] ?? choice.share };
+    })
+  };
 }
 function pickerLines(state) {
+  const width = Math.max(...state.choices.map((choice) => choice.label.length));
+  const cells = SHARES.length - 1;
   return [
-    "Which agents do you use on this computer? (\u2191/\u2193 to move, space to choose, Enter to accept)",
-    ...state.choices.map(
-      (choice, at) => `${at === state.cursor ? "\u276F" : " "} ${choice.checked ? "\u25C9" : "\u25CB"} ${choice.label}${choice.installed ? "" : " (not installed here)"}`
-    )
+    "How much of each agent do you have on this computer? (\u2191/\u2193 to move, -/+ to change, Enter to accept)",
+    ...state.choices.map((choice, at) => {
+      const filled = SHARES.indexOf(choice.share);
+      const bar = "\u25A0".repeat(filled) + "\u25A1".repeat(cells - filled);
+      const missing = choice.installed ? "" : " (not installed here)";
+      return `${at === state.cursor ? "\u276F" : " "} ${choice.label.padEnd(width)}  ${bar}  ${SHARE_LABELS[choice.share]}${missing}`;
+    })
   ];
 }
 function pickInTerminal(choices, input = process.stdin, output2 = process.stdout) {
@@ -5229,18 +5372,18 @@ function pickInTerminal(choices, input = process.stdin, output2 = process.stdout
     input.setRawMode(true);
     input.resume();
     draw(true);
-    const finish = (chosen) => {
+    const finish = (shares) => {
       input.off("data", onData);
       input.setRawMode(wasRaw);
       input.pause();
-      resolve6(chosen);
+      resolve6(shares);
     };
     const onData = (data) => {
       const next = pickerKey(state, data.toString("utf8"));
       if (!next) return finish(null);
       state = next;
       draw(false);
-      if (state.done) finish(state.choices.filter((c) => c.checked).map((c) => c.cli));
+      if (state.done) finish(Object.fromEntries(state.choices.map((c) => [c.cli, c.share])));
     };
     input.on("data", onData);
   });
@@ -5249,9 +5392,9 @@ function pickInTerminal(choices, input = process.stdin, output2 = process.stdout
 // src/friday/service.ts
 init_define_HERD_PACKAGE();
 import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync5, mkdirSync as mkdirSync7, openSync as openSync3, readFileSync as readFileSync7, rmSync as rmSync7, writeFileSync as writeFileSync7 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync7, openSync as openSync3, readFileSync as readFileSync7, rmSync as rmSync7, writeFileSync as writeFileSync7 } from "node:fs";
 import { userInfo } from "node:os";
-import { dirname as dirname6, join as join9 } from "node:path";
+import { dirname as dirname7, join as join9 } from "node:path";
 var LAUNCH_AGENT = "com.herdingchats.friday";
 var SYSTEMD_UNIT = "herdingchats-friday.service";
 async function detectService(run4, platform2 = process.platform, override = process.env.HERD_SERVICE) {
@@ -5266,7 +5409,7 @@ async function detectService(run4, platform2 = process.platform, override = proc
 }
 function servicePath(node) {
   return [
-    dirname6(node),
+    dirname7(node),
     "/opt/homebrew/bin",
     "/usr/local/bin",
     "/usr/bin",
@@ -5337,8 +5480,8 @@ WantedBy=default.target
 `;
 }
 function writeIfChanged(path, text4) {
-  if (existsSync5(path) && readFileSync7(path, "utf8") === text4) return false;
-  mkdirSync7(dirname6(path), { recursive: true });
+  if (existsSync6(path) && readFileSync7(path, "utf8") === text4) return false;
+  mkdirSync7(dirname7(path), { recursive: true });
   writeFileSync7(path, text4);
   return true;
 }
@@ -5393,7 +5536,7 @@ function systemd(context2) {
   };
 }
 function spawnInBackground(command, env, log) {
-  mkdirSync7(dirname6(log), { recursive: true });
+  mkdirSync7(dirname7(log), { recursive: true });
   const out = openSync3(log, "a");
   const [program = process.execPath, ...args] = command;
   spawn2(program, args, {
@@ -5442,20 +5585,20 @@ import { join as join12, resolve as resolve3 } from "node:path";
 
 // src/friday/legacy.ts
 init_define_HERD_PACKAGE();
-import { existsSync as existsSync6, readdirSync as readdirSync3, rmSync as rmSync8 } from "node:fs";
+import { existsSync as existsSync7, readdirSync as readdirSync3, rmSync as rmSync8 } from "node:fs";
 import { userInfo as userInfo2 } from "node:os";
 import { join as join10 } from "node:path";
 var OLD_LAUNCH_AGENT = "com.herdingchats.herd";
 var OLD_APPS = ["herd-daemon", "herd-updater"];
 function oldPm2s(paths) {
   const dir = join10(paths.herdHome, "daemon");
-  if (!existsSync6(dir)) return [];
-  return readdirSync3(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => join10(dir, entry.name, "node_modules", "pm2", "bin", "pm2")).filter((pm2) => existsSync6(pm2));
+  if (!existsSync7(dir)) return [];
+  return readdirSync3(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => join10(dir, entry.name, "node_modules", "pm2", "bin", "pm2")).filter((pm2) => existsSync7(pm2));
 }
 async function retireOldDaemon(paths, { home, run: run4 }) {
   const removed = [];
   const plist = join10(home, "Library", "LaunchAgents", `${OLD_LAUNCH_AGENT}.plist`);
-  if (existsSync6(plist)) {
+  if (existsSync7(plist)) {
     await run4("launchctl", ["bootout", `gui/${userInfo2().uid}/${OLD_LAUNCH_AGENT}`]);
     rmSync8(plist, { force: true });
     removed.push(`the login item ${OLD_LAUNCH_AGENT}`);
@@ -5481,7 +5624,7 @@ async function retireOldDaemon(paths, { home, run: run4 }) {
 init_define_HERD_PACKAGE();
 import { spawn as spawn3 } from "node:child_process";
 import {
-  existsSync as existsSync7,
+  existsSync as existsSync8,
   mkdirSync as mkdirSync8,
   readdirSync as readdirSync4,
   readFileSync as readFileSync8,
@@ -5492,7 +5635,7 @@ import {
   symlinkSync,
   writeFileSync as writeFileSync8
 } from "node:fs";
-import { basename as basename2, dirname as dirname7, join as join11 } from "node:path";
+import { basename as basename2, dirname as dirname8, join as join11 } from "node:path";
 var exec = (command, args, options = {}) => new Promise((resolve6) => {
   let stdout = "";
   let stderr = "";
@@ -5514,8 +5657,8 @@ var exec = (command, args, options = {}) => new Promise((resolve6) => {
   });
 });
 function npmCommand() {
-  const beside = join11(dirname7(process.execPath), "npm");
-  return existsSync7(beside) ? beside : "npm";
+  const beside = join11(dirname8(process.execPath), "npm");
+  return existsSync8(beside) ? beside : "npm";
 }
 function currentVersion(paths) {
   try {
@@ -5525,7 +5668,7 @@ function currentVersion(paths) {
   }
 }
 function installedVersions(paths) {
-  if (!existsSync7(paths.versions)) return [];
+  if (!existsSync8(paths.versions)) return [];
   return readdirSync4(paths.versions).filter((name) => VERSION.test(name)).sort(compareVersions);
 }
 var binOf = (versionDir, bin) => join11(packageDir(versionDir), `${bin}.mjs`);
@@ -5556,7 +5699,7 @@ async function installVersion(paths, version, { spec, integrity, run: run4 = exe
 } } = {}) {
   if (!VERSION.test(version)) return { ok: false, reason: `${version} isn't a version.` };
   const dir = join11(paths.versions, version);
-  if (existsSync7(dir)) {
+  if (existsSync8(dir)) {
     const installed2 = recordedIntegrity(dir);
     if (integrity && installed2 !== integrity)
       return { ok: false, reason: `the installed ${version} doesn't have the integrity named.` };
@@ -5609,7 +5752,7 @@ async function installVersion(paths, version, { spec, integrity, run: run4 = exe
   return { ok: true, dir };
 }
 function sweepStaging(paths) {
-  if (!existsSync7(paths.versions)) return;
+  if (!existsSync8(paths.versions)) return;
   for (const name of readdirSync4(paths.versions)) {
     const match = /^\.staging-.+-(\d+)$/.exec(name);
     if (match && !alive2(Number(match[1])))
@@ -5815,7 +5958,7 @@ init_define_HERD_PACKAGE();
 import { spawn as spawn4 } from "node:child_process";
 import {
   closeSync as closeSync3,
-  existsSync as existsSync8,
+  existsSync as existsSync9,
   mkdirSync as mkdirSync10,
   openSync as openSync4,
   readFileSync as readFileSync9,
@@ -5900,7 +6043,7 @@ var Supervisor = class {
     const { daemonLog, logs } = this.options.paths;
     mkdirSync10(logs, { recursive: true });
     try {
-      if (existsSync8(daemonLog) && statSync6(daemonLog).size > MAX_LOG_BYTES2)
+      if (existsSync9(daemonLog) && statSync6(daemonLog).size > MAX_LOG_BYTES2)
         renameSync4(daemonLog, `${daemonLog}.1`);
     } catch {
     }
@@ -6034,9 +6177,10 @@ Usage: friday <command>
 
   start       Make this computer a machine, with the folder this runs in as its root, where
               Friday keeps its repos and conversations. Signs in through your browser when
-              needed, asks which agents you use, starts the daemon now and whenever you log
-              in, waits for each agent to check in, then shows what's left to set up. Safe to
-              run again. --agents claude,codex chooses the agents without asking
+              needed, asks how much of each agent you have, starts the daemon now and whenever
+              you log in, waits for each agent to check in, then shows what's left to set up.
+              Safe to run again. --agents claude=lot,codex=little sets the shares without
+              asking: off, little, some or lot, where a bare name is some and one left out off
   stop        Stop the daemon until you log in again, or run friday start
   status      Whether the daemon is running, which version, and its root
   logs [-f]   Show the daemon's latest log lines. -f keeps following them
@@ -6072,6 +6216,18 @@ function passedEnv() {
 }
 async function friday(args, deps = defaults()) {
   const [command = "help", ...rest] = args;
+  const known = FRIDAY_FLAGS[command];
+  if (known) {
+    if (asksForHelp(rest)) {
+      deps.print(commandHelp(HELP, command) ?? HELP);
+      return 0;
+    }
+    const wrong = unknownFlag("friday", command, rest, known);
+    if (wrong) {
+      deps.print(wrong);
+      return 1;
+    }
+  }
   try {
     switch (command) {
       case "help":
@@ -6138,13 +6294,13 @@ function agentsFlag(args) {
   const parsed = parseAgents(value ?? "");
   if ("unknown" in parsed) {
     throw new StartError(
-      `friday start doesn't know the agent ${parsed.unknown.join(", ")}. Choose from claude, codex and agy.`
+      `friday start doesn't understand ${parsed.unknown.join(", ")}. Name claude, codex or agy, each with =off, =little, =some or =lot if you like.`
     );
   }
-  return parsed.agents;
+  return parsed.shares;
 }
 function attachTo(paths, terminal) {
-  const herd = existsSync9(binOf(paths.current, "herd")) ? binOf(paths.current, "herd") : join13(dirname8(process.argv[1] ?? ""), "herd.mjs");
+  const herd = existsSync10(binOf(paths.current, "herd")) ? binOf(paths.current, "herd") : join13(dirname9(process.argv[1] ?? ""), "herd.mjs");
   const child = spawn5(process.execPath, [herd, "attach", terminal], {
     stdio: "inherit",
     env: { ...process.env, HERD_HOME: paths.herdHome }
@@ -6200,7 +6356,7 @@ function runStatus(deps) {
   return running ? 0 : 1;
 }
 function tail(path, count) {
-  if (!existsSync9(path)) return [];
+  if (!existsSync10(path)) return [];
   const lines = readFileSync10(path, "utf8").split("\n");
   if (lines.at(-1) === "") lines.pop();
   return lines.slice(-count);
@@ -6208,7 +6364,7 @@ function tail(path, count) {
 async function runLogs(args, deps) {
   const { paths, print } = deps;
   const follow = args.includes("-f") || args.includes("--follow");
-  const files = [paths.supervisorLog, paths.daemonLog].filter((file) => existsSync9(file));
+  const files = [paths.supervisorLog, paths.daemonLog].filter((file) => existsSync10(file));
   if (files.length === 0) {
     print(`There are no logs in ${paths.logs} yet.`);
     return 0;
@@ -6258,7 +6414,7 @@ init_define_HERD_PACKAGE();
 init_define_HERD_PACKAGE();
 import { spawn as spawn6 } from "node:child_process";
 import { appendFileSync, readFileSync as readFileSync11 } from "node:fs";
-import { dirname as dirname9, join as join14 } from "node:path";
+import { dirname as dirname10, join as join14 } from "node:path";
 var DEPLOY_HOSTS = ["api.cloudflare.com", "api.github.com", "registry.npmjs.org"];
 function buildPolicy(input) {
   const platform2 = input.platform ?? process.platform;
@@ -6288,7 +6444,7 @@ function describePolicy(policy, platform2 = process.platform) {
   const hosts = policy.network.allowedDomains.join(", ");
   return `Sandboxed with ${kind}: the owner's home is unreadable, writes go only to the worktree and the build's home, and the only hosts it reaches are ${hosts}.`;
 }
-var nodePrefix = (execPath = process.execPath) => dirname9(dirname9(execPath));
+var nodePrefix = (execPath = process.execPath) => dirname10(dirname10(execPath));
 var shellQuote = (args) => args.map((arg) => `'${arg.replace(/'/g, "'\\''")}'`).join(" ");
 var BLOCKED_LOG = "blocked.log";
 async function runSandboxed(args) {
@@ -6779,7 +6935,7 @@ init_define_HERD_PACKAGE();
 // src/build-runner-key.ts
 init_define_HERD_PACKAGE();
 init_src();
-import { chmodSync as chmodSync3, existsSync as existsSync10, mkdirSync as mkdirSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync9 } from "node:fs";
+import { chmodSync as chmodSync3, existsSync as existsSync11, mkdirSync as mkdirSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync9 } from "node:fs";
 import { join as join15 } from "node:path";
 import { z as z24 } from "zod";
 var BUILDS_URL = "https://builds.herdingchats.com";
@@ -6791,7 +6947,7 @@ var runnerKeySchema = z24.object({
 var runnerKeyPath = () => join15(herdHome(), "build-runner.json");
 function readRunnerKey() {
   const path = runnerKeyPath();
-  if (!existsSync10(path)) return null;
+  if (!existsSync11(path)) return null;
   try {
     return runnerKeySchema.parse(JSON.parse(readFileSync13(path, "utf8")));
   } catch {
@@ -7765,7 +7921,7 @@ init_define_HERD_PACKAGE();
 import { execFile as execFile2, execFileSync as execFileSync4, spawn as spawn7 } from "node:child_process";
 import { createHash as createHash3, randomUUID as randomUUID4 } from "node:crypto";
 import {
-  existsSync as existsSync11,
+  existsSync as existsSync12,
   mkdirSync as mkdirSync15,
   mkdtempSync,
   readdirSync as readdirSync6,
@@ -7859,7 +8015,7 @@ var real2 = (path) => {
   }
 };
 function worktreeOf(dir, store) {
-  if (!existsSync11(join20(dir, ".git"))) return false;
+  if (!existsSync12(join20(dir, ".git"))) return false;
   try {
     return real2(git2(dir, "rev-parse", "--path-format=absolute", "--git-common-dir")) === real2(store);
   } catch {
@@ -7871,10 +8027,10 @@ function cloneFolder(from, to) {
   execFileSync4("cp", [...args, from, to]);
 }
 function moduleFolders(dir) {
-  const found = existsSync11(join20(dir, "node_modules")) ? ["node_modules"] : [];
+  const found = existsSync12(join20(dir, "node_modules")) ? ["node_modules"] : [];
   for (const entry of readdirSync6(dir, { withFileTypes: true })) {
     if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
-      if (existsSync11(join20(dir, entry.name, "node_modules")))
+      if (existsSync12(join20(dir, entry.name, "node_modules")))
         found.push(join20(entry.name, "node_modules"));
     }
   }
@@ -7970,11 +8126,11 @@ var BuildRunner = class _BuildRunner {
   async ensureModules(dir) {
     const wanted = lockHash(dir);
     const marker = join20(dir, "node_modules", ".herd-lock");
-    if (existsSync11(marker) && readFileSync16(marker, "utf8") === wanted) return;
+    if (existsSync12(marker) && readFileSync16(marker, "utf8") === wanted) return;
     const cache = join20(this.home(), "node_modules", wanted);
     for (const folder of moduleFolders(dir))
       rmSync12(join20(dir, folder), { recursive: true, force: true });
-    if (existsSync11(join20(cache, ".complete"))) {
+    if (existsSync12(join20(cache, ".complete"))) {
       for (const folder of readFileSync16(join20(cache, ".complete"), "utf8").split("\n").filter(Boolean)) {
         cloneFolder(join20(cache, folder), join20(dir, folder));
       }
@@ -8156,7 +8312,7 @@ var BuildRunner = class _BuildRunner {
       clearTimeout(timer);
       if (status2 === 10)
         return { ok: false, reason: "the sandbox let a build read the owner's files" };
-      if (status2 !== 0 || !existsSync11(join20(dir, "home", "ok"))) {
+      if (status2 !== 0 || !existsSync12(join20(dir, "home", "ok"))) {
         const why = stderr.trim().split("\n").at(-1) || `the probe exited with ${status2}`;
         return { ok: false, reason: why.slice(0, 300) };
       }
@@ -8929,7 +9085,7 @@ init_define_HERD_PACKAGE();
 import { execFileSync as execFileSync5 } from "node:child_process";
 import {
   appendFileSync as appendFileSync2,
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   mkdirSync as mkdirSync16,
   readFileSync as readFileSync17,
   renameSync as renameSync5,
@@ -8945,7 +9101,7 @@ var shellQuote2 = (value) => `'${value.replace(/'/g, `'\\''`)}'`;
 function writeWorktreeSettings(worktree, settings2, ownCommand) {
   const path = join22(worktree, LOCAL_SETTINGS);
   let current = {};
-  if (existsSync12(path)) {
+  if (existsSync13(path)) {
     try {
       const parsed = JSON.parse(readFileSync17(path, "utf8"));
       if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return false;
@@ -8990,7 +9146,7 @@ function ignoreLocalSettings(worktree) {
   const info = join22(isAbsolute3(common) ? common : join22(worktree, common), "info");
   const exclude = join22(info, "exclude");
   const line2 = "/.claude/settings.local.json";
-  const existing = existsSync12(exclude) ? readFileSync17(exclude, "utf8") : "";
+  const existing = existsSync13(exclude) ? readFileSync17(exclude, "utf8") : "";
   if (existing.split("\n").includes(line2)) return;
   mkdirSync16(info, { recursive: true });
   appendFileSync2(exclude, `${existing && !existing.endsWith("\n") ? "\n" : ""}${line2}
@@ -9039,7 +9195,7 @@ function loginShellEnv() {
 
 // src/machine-checks.ts
 init_define_HERD_PACKAGE();
-import { existsSync as existsSync13, rmSync as rmSync13 } from "node:fs";
+import { existsSync as existsSync14, rmSync as rmSync13 } from "node:fs";
 var REQUEST_POLL_MS = 2e3;
 var MachineChecks = class {
   constructor(options) {
@@ -9085,7 +9241,7 @@ var MachineChecks = class {
   /** `friday start` asked for every agent to be activated again. */
   takeRequest() {
     const path = activationRequestPath(this.options.herdHome);
-    if (!existsSync13(path)) return;
+    if (!existsSync14(path)) return;
     rmSync13(path, { force: true });
     this.activateChosen(true);
   }
@@ -10623,7 +10779,7 @@ import {
   statSync as statSync8,
   writeFileSync as writeFileSync16
 } from "node:fs";
-import { dirname as dirname10, join as join29, sep as sep2 } from "node:path";
+import { dirname as dirname11, join as join29, sep as sep2 } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 
@@ -10811,6 +10967,7 @@ function describe(worker, current) {
     );
     lines.push(`    ${label3}: ${listed.join(", ")}`);
   }
+  lines.push(`    share: ${SHARE_LABELS[worker.share]}`);
   if (worker.priority !== 0) lines.push(`    priority: ${worker.priority}`);
   const repos = worker.repos.map(
     (repo) => `${normalizeRemote(repo.remote) ?? repo.name} (${isCloned(repo) ? "cloned" : "not cloned"})`
@@ -11673,8 +11830,8 @@ async function download(ws, workspace, file) {
   if (lstatSync2(herd, { throwIfNoEntry: false })?.isSymbolicLink()) {
     throw new Error("its folder leads outside the worktree");
   }
-  mkdirSync20(dirname10(target), { recursive: true });
-  if (!realpathSync8(dirname10(target)).startsWith(realpathSync8(workspace.folder) + sep2)) {
+  mkdirSync20(dirname11(target), { recursive: true });
+  if (!realpathSync8(dirname11(target)).startsWith(realpathSync8(workspace.folder) + sep2)) {
     throw new Error("its folder leads outside the worktree");
   }
   writeFileSync16(join29(herd, ".gitignore"), "*\n");
@@ -12187,6 +12344,7 @@ async function runDaemon(args) {
     const root = setRoot(defaultRoot()).root;
     console.log(`No root folder is set for this machine, so it works from ${root}.`);
   }
+  await waitForRoot(machineRoot(), { pollMs: Number(process.env.HERD_ROOT_POLL_MS) || 2e3 });
   const api = apiUrl();
   const terminals = new HostTerminals({ log: (line2) => console.log(line2) });
   await terminals.ensureHost();
@@ -13837,6 +13995,18 @@ Inside a terminal the daemon started:
 Set HERD_API_URL to use another API, such as http://localhost:5174 for the local dev server.`;
 async function main(args) {
   const [command = "help", ...rest] = args;
+  const known = HERD_FLAGS[command];
+  if (known) {
+    if (asksForHelp(rest) && !HERD_OWN_HELP.has(command)) {
+      console.log(commandHelp(HELP5, command) ?? HELP5);
+      return 0;
+    }
+    const wrong = unknownFlag("herd", command, rest, known);
+    if (wrong) {
+      console.error(wrong);
+      return 1;
+    }
+  }
   try {
     switch (command) {
       case "help":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herdingchats/friday",
-  "version": "0.1.1",
+  "version": "0.1.525",
   "description": "Friday, HerdingChats' agent daemon, and the herd command it runs agents with.",
   "license": "MIT",
   "type": "module",
@@ -22,5 +22,5 @@
     "satori": "0.32.0",
     "zod": "4.6.7"
   },
-  "gitHead": "91b08aebd285af82cf2ea35b4b380b52acf2a33f"
+  "gitHead": "cbd227dfdbed52c13e4cb3a2b388d6e7d4a6866e"
 }