c8ctl-plugin-nano 1.24.2 → 1.25.1

package/README.md

@@ -479,6 +479,7 @@ c8ctl nano supervisor
 c8ctl nano supervisor status                       # id, state, pid, restarts, uptime
 c8ctl nano supervisor add reviewer --max-parallel 2 # add + spawn a worker (forwards work flags)
 c8ctl nano supervisor add reviewer --name reviewer-2 # a SECOND reviewer, named so it stays distinct
+c8ctl nano supervisor add reviewer --instances 3    # add 3 distinct auto-named reviewers in one call
 c8ctl nano supervisor restart reviewer             # by worker id or profile name
 c8ctl nano supervisor remove coder                 # stop + drop a worker (also: `all`)
 c8ctl nano supervisor logs reviewer --follow       # tail a worker's log (or the daemon's)
@@ -489,9 +490,13 @@ Each worker has a **name** — its supervisor id and the broker `workerName` it
 registers under. Pass `--name` on `supervisor add` (or `work`) to set it;
 omit it and one is auto-generated as `‹host›-‹profile›-‹random›`, so you can
 run **several instances of the same profile** and they stay distinct
-end-to-end (status, logs, and at the broker). `restart`/`remove` accept either
-a worker id **or** a profile name — targeting a profile affects *every*
-instance of it.
+end-to-end (status, logs, and at the broker). To scale a hire to several
+instances in one call, pass `--instances N` on `supervisor add` — it spawns N
+distinct auto-named workers of the profile at once (default 1, capped per call).
+Because each instance needs its own distinct name, `--instances N` (for N > 1)
+cannot be combined with `--name`; omit `--name` to let them auto-name.
+`restart`/`remove` accept either a worker id **or** a profile name — targeting a
+profile affects *every* instance of it.
 
 Each worker takes the **same flags as `nano work`** (`--max-parallel`,
 `--recovery-window`, `--idle-timeout`, `--job-timeout`, `--poll-timeout`,

package/c8ctl-plugin.js

@@ -1730,13 +1730,14 @@ function resolveAssignInputs(req, flags) {
  * capabilities are the remaining positionals and/or `--capabilities a,b`.
  * Capabilities are unioned with the profile's existing set (additive; assign
  * never removes a role) and the updated rank×capability job-type matrix is
- * printed. Re-run `work` to pick up the new job types.
+ * printed. Running workers hot-reload the new job types within ~1.5s — no
+ * restart needed.
  */
 async function assignCapabilities(req, flags) {
   const logger = getLogger();
   const { name, incomingRaw } = resolveAssignInputs(req, flags);
   if (!name) {
-    logger.error('Usage: c8ctl nano assign <profileName> [<capability> ...] [--name <n>] [--capabilities <a,b>]');
+    logger.error('Usage: c8ctl nano assign <profileName> <cap[,cap...]> [--name <n>] [--capabilities <a,b>]');
     logger.info('Grant new capabilities to an existing hire. List profiles with: c8ctl nano hire --list');
     process.exit(1);
   }
@@ -1747,7 +1748,7 @@ async function assignCapabilities(req, flags) {
 
   if (normalizeCapabilities(incomingRaw).length === 0) {
     logger.error('Provide at least one capability to assign.');
-    logger.info(`Example: c8ctl nano assign ${name} code-review testing`);
+    logger.info(`Example: c8ctl nano assign ${name} code-review,testing`);
     process.exit(1);
   }
 
@@ -1778,7 +1779,7 @@ async function assignCapabilities(req, flags) {
   logger.info(`Assigned to "${name}" [${profile.rank}]: +${added.join(', ')}`);
   logger.info(`  capabilities: ${profile.capabilities.join(', ')}`);
   logger.info(`  job types (${matrix.length}): ${matrix.join('  ')}`);
-  logger.info(`Restart its workers to pick up the new roles: c8ctl nano work ${name}`);
+  logger.info(`Running workers pick this up automatically within ~1.5s — no restart needed.`);
 }
 
 /**
@@ -3701,6 +3702,58 @@ function extractNameFlag(parts) {
   return { name: name != null && name.trim() !== '' ? name.trim() : undefined, rest };
 }
 
+/**
+ * Upper bound on how many workers a single `supervisor add --instances N` may
+ * spawn. Not a fleet cap (add again to grow further) — a typo guard, so a
+ * fat-fingered `--instances 100000` can't fork-bomb the host in one keystroke.
+ */
+const MAX_ADD_INSTANCES = 64;
+
+/**
+ * Parse the `--instances N` count for `supervisor add`. Accepts undefined/blank
+ * (defaults to 1), and a whole number in `[1, MAX_ADD_INSTANCES]`. Rejects
+ * non-integers, zero/negatives, and anything over the cap with a clear message.
+ * When a flag is repeated the last occurrence wins (arrays are tolerated).
+ * Returns `{ count }` on success or `{ error }` on rejection. Pure.
+ */
+function parseInstancesCount(raw) {
+  const v = Array.isArray(raw) ? raw[raw.length - 1] : raw;
+  if (v === undefined || v === null || (typeof v === 'string' && v.trim() === '')) {
+    return { count: 1 };
+  }
+  const s = String(v).trim();
+  if (!/^\d+$/.test(s)) return { error: `Invalid --instances "${v}": use a whole number between 1 and ${MAX_ADD_INSTANCES}.` };
+  const n = Number.parseInt(s, 10);
+  if (n < 1) return { error: `Invalid --instances "${v}": use a whole number between 1 and ${MAX_ADD_INSTANCES}.` };
+  if (n > MAX_ADD_INSTANCES) return { error: `--instances ${n} exceeds the ${MAX_ADD_INSTANCES}-per-command cap; run "supervisor add" again to add more.` };
+  return { count: n };
+}
+
+/**
+ * Split `--instances N` / `--instances=N` out of a raw token list, returning
+ * `{ count, rest, error }` where `rest` is the remaining work flags (with the
+ * flag removed so it is never forwarded to `nano work`). Used by the interactive
+ * console's `add`, whose tokens aren't parsed by the CLI flag layer. Last
+ * occurrence wins; a trailing `--instances` with no value is treated as absent
+ * (count 1), mirroring `extractNameFlag`. Pure.
+ */
+function extractInstancesFlag(parts) {
+  const rest = [];
+  let raw;
+  const list = Array.isArray(parts) ? parts : [];
+  for (let i = 0; i < list.length; i++) {
+    const tok = String(list[i]);
+    const eq = /^--instances=(.*)$/.exec(tok);
+    if (eq) { raw = eq[1]; continue; }
+    if (tok === '--instances') {
+      if (i + 1 < list.length) { raw = String(list[i + 1]); i++; }
+      continue;
+    }
+    rest.push(tok);
+  }
+  return { ...parseInstancesCount(raw), rest };
+}
+
 /** Assign a unique, stable worker id from a profile name (pure). */
 function supervisorWorkerId(profile, taken) {
   const base = String(profile || '').trim() || 'worker';
@@ -4479,14 +4532,31 @@ async function supervisorAddCmd(req, flags) {
   const logger = getLogger();
   // The positional profile is what runs; `--name` names this worker instance
   // (forwarded to the child as `nano work … --name`, and used as its supervisor
-  // id). Omit `--name` to auto-generate ‹host›-‹profile›-‹random›.
+  // id). Omit `--name` to auto-generate ‹host›-‹profile›-‹random›. `--instances N`
+  // spawns N distinct auto-named workers of the profile in one call.
   const profile = req.positional[1];
-  if (!profile) { logger.error('Usage: c8ctl nano supervisor add <profile> [--name <worker>] [work flags]'); process.exit(1); }
+  if (!profile) { logger.error('Usage: c8ctl nano supervisor add <profile> [--name <worker>] [--instances <n>] [work flags]'); process.exit(1); }
+  const { count, error } = parseInstancesCount(flags?.instances);
+  if (error) { logger.error(error); process.exit(1); }
   const name = flags?.name ? String(flags.name).trim() : undefined;
+  // A single `--name` can't apply to several distinct workers (each needs its
+  // own broker workerName / supervisor id), so reject the combination and steer
+  // the operator to auto-naming.
+  if (name && count > 1) {
+    logger.error('--name cannot be combined with --instances > 1 (each instance needs a distinct name); omit --name to auto-name them.');
+    process.exit(1);
+  }
   await startSupervisorDaemon();
-  const res = await supervisorRequest({ op: 'add', profile, name, args: reconstructWorkArgs(flags) });
-  if (res.ok) logger.info(`Added worker "${res.worker.id}" (profile ${profile}); pid ${res.worker.pid ?? 'starting'}.`);
-  else { logger.error(`Could not add "${profile}": ${res.error}`); process.exit(1); }
+  const workArgs = reconstructWorkArgs(flags);
+  let added = 0;
+  let failed = 0;
+  for (let i = 0; i < count; i++) {
+    const res = await supervisorRequest({ op: 'add', profile, name, args: workArgs });
+    if (res.ok) { added++; logger.info(`Added worker "${res.worker.id}" (profile ${profile}); pid ${res.worker.pid ?? 'starting'}.`); }
+    else { failed++; logger.error(`Could not add "${profile}": ${res.error}`); }
+  }
+  if (count > 1) logger.info(`Added ${added}/${count} instance(s) of "${profile}".`);
+  if (failed > 0) process.exit(1);
 }
 
 async function supervisorRemoveCmd(req) {
@@ -4636,16 +4706,21 @@ async function attachSupervisorConsole(state) {
       switch (cmd) {
         case '': break;
         case 'help':
-          out('Commands: status | add <profile> [--name <worker>] [work flags] |');
+          out('Commands: status | add <profile> [--name <worker>] [--instances <n>] [work flags] |');
           out('          remove <id|profile|all> | restart <id|profile|all> |');
           out('          logs [id] | detach | stop | help');
           break;
         case 'status': sock.write(encodeFrame({ op: 'status' })); break;
         case 'add': {
           const profile = parts.shift();
-          if (!profile) { out('usage: add <profile> [--name <worker>] [work flags]'); break; }
+          if (!profile) { out('usage: add <profile> [--name <worker>] [--instances <n>] [work flags]'); break; }
           const { name, rest } = extractNameFlag(parts);
-          sock.write(encodeFrame({ op: 'add', profile, name, args: rest }));
+          const { count, rest: workArgs, error } = extractInstancesFlag(rest);
+          if (error) { out(error); break; }
+          if (name && count > 1) { out('--name cannot be combined with --instances > 1; omit --name to auto-name them.'); break; }
+          for (let i = 0; i < count; i++) {
+            sock.write(encodeFrame({ op: 'add', profile, name, args: workArgs }));
+          }
           break;
         }
         case 'remove': case 'rm': {
@@ -6107,6 +6182,8 @@ export {
   isValidWorkerName,
   randomNameSuffix,
   extractNameFlag,
+  parseInstancesCount,
+  extractInstancesFlag,
   redactWorkArgs,
   supervisorBackoffMs,
   encodeFrame,
@@ -6120,6 +6197,7 @@ export {
   runSupervisorDaemon,
   startSupervisorDaemon,
   supervisorRequest,
+  supervisorAddCmd,
   runningSupervisor,
   readSupervisorState,
   clearSupervisorState,
@@ -6163,12 +6241,14 @@ export const metadata = {
         { command: 'c8ctl nano hire --name coder --rank senior --command copilot --env COPILOT_ENABLE_ALL_TOOLS=1', description: 'Persist a harness startup env var (e.g. permissions) on the profile' },
         { command: 'c8ctl nano hire --list', description: 'List hired agent profiles' },
         { command: 'c8ctl nano hire --name coder --rank senior --command "agent-harness" --sandbox docker --image ghcr.io/acme/agent:1', description: 'Create a profile that runs each job in a throwaway Docker container' },
+        { command: 'c8ctl nano assign reviewer code-review,testing', description: 'Grant more capabilities (comma-separated, like hire) to an existing hire — additive; running workers hot-reload it' },
         { command: 'c8ctl nano work reviewer', description: 'Spawn Nano job workers for the "reviewer" profile and poll for work' },
         { command: 'c8ctl nano work coder --sandbox docker --image ghcr.io/acme/agent:1', description: 'Run jobs in isolated containers with disk-hygiene reaping' },
         { command: 'c8ctl nano supervisor start --worker reviewer --worker coder', description: 'Start a detached supervisor managing several workers from one terminal' },
         { command: 'c8ctl nano supervisor', description: 'Attach an interactive console to the supervisor (detach with Ctrl-D, leaving it running)' },
         { command: 'c8ctl nano supervisor status', description: 'List supervised workers (pid, state, serviced job / idle, restarts, uptime) without the console' },
         { command: 'c8ctl nano supervisor add decider --max-parallel 2', description: 'Add a supervised worker (forwarding work flags) to the running supervisor' },
+        { command: 'c8ctl nano supervisor add reviewer --instances 3', description: 'Add 3 distinct auto-named instances of a profile in one call' },
         { command: 'c8ctl nano supervisor restart reviewer', description: 'Restart a supervised worker by id or profile' },
         { command: 'c8ctl nano supervisor stop', description: 'Stop the supervisor daemon and all its workers' },
       ],
@@ -6236,6 +6316,7 @@ export const commands = {
       'poll-timeout': { type: 'string', description: 'work: broker long-poll window in ms each activateJobs request is held open (fewer reconnects → fewer transient connect errors); default 30000, 0 = broker default, negative = return immediately' },
       'job-type': { type: 'string', multiple: true, description: 'work: extra job type to service alongside the rank×capability matrix (repeatable)' },
       worker: { type: 'string', multiple: true, description: 'supervisor start: profile to launch as a supervised worker (repeatable)' },
+      instances: { type: 'string', description: `supervisor add: spawn N distinct auto-named instances of the profile in one call (default 1, max ${MAX_ADD_INSTANCES}; cannot combine with --name)` },
       attach: { type: 'boolean', description: 'supervisor start: attach the interactive console after starting the daemon' },
     },
     handler: async (args, flags) => {
@@ -6386,7 +6467,7 @@ function printUsage() {
   console.log('  c8ctl nano config');
   console.log('  c8ctl nano update [--check]');
   console.log('  c8ctl nano hire [--name <n>] [--rank <r>] [--command <c>] [--arg <switch> ...] [--model <m>] [--capabilities <a,b>] [--sandbox none|docker|podman] [--image <ref>] [--env NAME=VALUE ...] [--list]');
-  console.log('  c8ctl nano assign <profileName> [<capability> ...] [--name <n>] [--capabilities <a,b>]');
+  console.log('  c8ctl nano assign <profileName> <cap[,cap...]> [--name <n>] [--capabilities <a,b>]');
   console.log('  c8ctl nano work <profileName> [--arg <switch> ...] [--max-parallel <n>] [--recovery-window <ms>] [--idle-timeout <ms>] [--job-timeout <ms>] [--poll-timeout <ms>] [--job-type <token> ...] [--sandbox none|docker|podman] [--image <ref>] [--env NAME=VALUE ...] [--secret-resolver host] [--min-free-mb <n>] [--clone-timeout <ms>] [--keep-runs] [--stream]');
   console.log('  c8ctl nano supervisor [start|status|add|remove|restart|stop|logs|attach] ... (manage many workers from one terminal)');
   console.log('');
@@ -6403,7 +6484,7 @@ function printUsage() {
   console.log('  config   Show current configuration and on-disk locations');
   console.log('  update   Pull the latest published nano release (--check to only report)');
   console.log('  hire     Create a CLI agent worker profile (rank + capabilities → job-type matrix)');
-  console.log('  assign   Grant new capabilities (roles) to an existing hire (additive)');
+  console.log('  assign   Grant new capabilities (roles) to an existing hire (additive; comma-separated; workers hot-reload)');
   console.log('  work     Run a hired profile as Nano job workers, polling for work until Ctrl-C');
   console.log('  supervisor  Run/manage a fleet of workers from one terminal (detachable console + non-interactive control)');
   console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c8ctl-plugin-nano",
-  "version": "1.24.2",
+  "version": "1.25.1",
   "type": "module",
   "description": "c8ctl plugin to start, inspect, and stop a local Nano BPM (nanobpmn) cluster",
   "main": "c8ctl-plugin.js",
@@ -47,12 +47,12 @@
     "semantic-release": "^25.0.3"
   },
   "optionalDependencies": {
-    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.24.2",
-    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.24.2",
-    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.24.2",
-    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.24.2",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.24.2",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.24.2",
-    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.24.2"
+    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.25.1",
+    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.25.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.25.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.25.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.25.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.25.1",
+    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.25.1"
   }
 }