c8ctl-plugin-nano 1.25.0 → 1.26.0

package/README.md

@@ -106,6 +106,10 @@ c8ctl nano clean
 c8ctl nano set bin   ~/workspace/nanobpmn/server/target/release/nanobpm-gateway-rest-server
 c8ctl nano set model-dir ~/bpmn-workspace
 
+# Clear a custom setting (back to the managed/release binary, or default workspace)
+c8ctl nano unset bin
+c8ctl nano unset model-dir
+
 # Show current configuration and on-disk locations
 c8ctl nano config
 ```
@@ -575,17 +579,23 @@ c8ctl nano start --console off        # headless: no console router at all
   env var is honored when the flag is not passed. The plugin passes the choice
   through as `NANOBPMN_CONSOLE` on every node.
 
-## Configuration (`set` / `config`)
+## Configuration (`set` / `unset` / `config`)
 
 Persistent settings are stored in `<state home>/config.json`:
 
-| Setting             | Env mapping              | Set with                          |
-|---------------------|--------------------------|-----------------------------------|
-| Binary path         | (used to launch nodes)   | `c8ctl nano set bin <path>`       |
-| Workspace directory | `NANOBPMN_WORKSPACE_DIR` | `c8ctl nano set model-dir <path>` |
+| Setting             | Env mapping              | Set with                          | Clear with                    |
+|---------------------|--------------------------|-----------------------------------|-------------------------------|
+| Binary path         | (used to launch nodes)   | `c8ctl nano set bin <path>`       | `c8ctl nano unset bin`        |
+| Workspace directory | `NANOBPMN_WORKSPACE_DIR` | `c8ctl nano set model-dir <path>` | `c8ctl nano unset model-dir`  |
 
 Show the effective configuration and all on-disk locations with `c8ctl nano config`.
 
+`unset bin` clears a custom binary path so node launches fall back to the
+managed platform binary — i.e. back on the release train that `c8ctl nano
+update` tracks. (Note: a `NANOBPMN_BINARY` environment variable still overrides
+even after `unset`.) `unset model-dir` returns the workspace to its default
+(`<state home>/workspace`).
+
 ## Updating to a new release (`update`)
 
 The plugin and the bundled server binary (delivered via the matching platform

package/c8ctl-plugin.js

@@ -450,7 +450,7 @@ function launcherEnvMarkers(resolved) {
 // Argument parsing
 // ---------------------------------------------------------------------------
 
-const VALID_SUBCOMMANDS = ['start', 'stop', 'status', 'logs', 'log', 'restart', 'pause', 'resume', 'clean', 'set', 'config', 'update', 'hire', 'assign', 'work', 'supervisor'];
+const VALID_SUBCOMMANDS = ['start', 'stop', 'status', 'logs', 'log', 'restart', 'pause', 'resume', 'clean', 'set', 'unset', 'config', 'update', 'hire', 'assign', 'work', 'supervisor'];
 
 /**
  * Parse positional args + flags into a normalized request.
@@ -1387,7 +1387,7 @@ function setConfig(req) {
   const key = req.positional[0];
   const value = req.positional[1];
 
-  if (!key || !(key in SETTING_ALIASES)) {
+  if (!key || !Object.hasOwn(SETTING_ALIASES, key)) {
     logger.error('Usage: c8ctl nano set <bin|model-dir> <path>');
     logger.info('Settings:');
     logger.info('  bin <path>        Path to the nanobpmn server binary');
@@ -1423,12 +1423,69 @@ function setConfig(req) {
   }
 }
 
+/**
+ * Clear a configured setting so resolution falls back to the default. The
+ * headline use is `unset bin`: after `set bin <path>` pins a self-managed
+ * binary (source 'configured', which disables self-update), clearing it lets
+ * the plugin fall back to the managed npm platform package — i.e. back on the
+ * release train. `unset model-dir` returns the workspace to its default.
+ */
+function unsetConfig(req) {
+  const logger = getLogger();
+  const key = req.positional[0];
+
+  if (!key || !Object.hasOwn(SETTING_ALIASES, key)) {
+    logger.error('Usage: c8ctl nano unset <bin|model-dir>');
+    logger.info('Settings:');
+    logger.info('  bin        Clear the custom server binary (back to the managed/release binary)');
+    logger.info('  model-dir  Clear the custom workspace dir (back to the default)');
+    process.exit(1);
+  }
+
+  const field = SETTING_ALIASES[key];
+  const cfg = readConfig();
+  const prev = cfg[field];
+  const wasSet = prev !== undefined && prev !== null && prev !== '';
+  const label = field === 'binary' ? 'custom binary override' : 'custom workspace override';
+
+  if (!wasSet) {
+    logger.info(`No ${label} is configured — nothing to clear.`);
+  } else {
+    delete cfg[field];
+    writeConfig(cfg);
+    logger.info(`Cleared ${label} (was ${prev}).`);
+  }
+
+  if (field === 'binary') {
+    // Report what resolves now, so the operator can see they are back on the
+    // managed release train (or what still overrides it).
+    try {
+      const r = resolveBinary({});
+      logger.info(`Now using: ${r.path} (${r.from}).`);
+      if (r.source === 'managed-npm') {
+        logger.info('Back on the managed release train — "c8ctl nano update" now tracks the published release.');
+      } else if (r.source === 'configured') {
+        logger.warn('Still pinned by NANOBPMN_BINARY in your environment; unset that to use the managed binary.');
+      }
+    } catch (err) {
+      logger.warn(`No binary resolves now: ${err instanceof Error ? err.message : err}`);
+      logger.info('Reinstall the plugin to fetch the managed platform binary, or set one again with "c8ctl nano set bin <path>".');
+    }
+  } else if (field === 'workspaceDir') {
+    logger.info(`Workspace is now the default: ${getWorkspaceDir()}.`);
+    const running = readState();
+    if (running && liveNodeCount(running) > 0) {
+      logger.warn('A cluster is running — restart it for the new workspace to take effect.');
+    }
+  }
+}
+
 function showConfig() {
   const cfg = readConfig();
   console.log('Nano plugin configuration:');
   console.log('');
   console.log(`  state home   ${getStateHome()}`);
-  console.log(`  binary       ${cfg.binary || '(auto-detect: $NANOBPMN_BINARY or repo build)'}`);
+  console.log(`  binary       ${cfg.binary || '(auto-detect: $NANOBPMN_BINARY, managed platform package, or repo build)'}`);
   const bundled = readBundledBinaryInfo();
   if (bundled) {
     const at = bundled.commit && bundled.commit !== 'unknown' ? ` (${bundled.commit})` : '';
@@ -1441,6 +1498,7 @@ function showConfig() {
   console.log(`  config file  ${getConfigFile()}`);
   console.log('');
   console.log('  Change with: c8ctl nano set bin <path> | c8ctl nano set model-dir <path>');
+  console.log('  Clear with:  c8ctl nano unset bin | c8ctl nano unset model-dir');
 }
 
 // ---------------------------------------------------------------------------
@@ -1730,13 +1788,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 +1806,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 +1837,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.`);
 }
 
 /**
@@ -6120,6 +6179,7 @@ function parseProcessosRequest(args, flags) {
 // Internal helpers exported for tests/tooling only. c8ctl consumes just
 // `metadata` and `commands`; these named exports are inert to it.
 export { resolveBinary, findBinary, launcherEnvMarkers };
+export { setConfig, unsetConfig, readConfig, writeConfig, getConfigFile, SETTING_ALIASES };
 export { buildNpmInvocation };
 export {
   webConsoleUrl,
@@ -6230,6 +6290,7 @@ export const metadata = {
         { command: 'c8ctl nano restart --purge', description: 'Restart the cluster from a clean slate (delete engine data)' },
         { command: 'c8ctl nano clean', description: 'Wipe journal/data + logs on disk (keeps models/workers)' },
         { command: 'c8ctl nano set bin <path>', description: 'Set the nanobpmn server binary path' },
+        { command: 'c8ctl nano unset bin', description: 'Clear a custom binary path and return to the managed/release binary' },
         { command: 'c8ctl nano set model-dir <path>', description: 'Set the workspace dir (models + workers)' },
         { command: 'c8ctl nano config', description: 'Show current plugin configuration and paths' },
         { command: 'c8ctl nano update', description: 'Pull the latest published nano release (re-installs via npm)' },
@@ -6240,6 +6301,7 @@ 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' },
@@ -6358,6 +6420,9 @@ export const commands = {
           case 'set':
             setConfig(req);
             break;
+          case 'unset':
+            unsetConfig(req);
+            break;
           case 'config':
             showConfig();
             break;
@@ -6462,10 +6527,11 @@ function printUsage() {
   console.log('  c8ctl nano restart [<nodes>] [--purge] ...');
   console.log('  c8ctl nano clean [--workspace]');
   console.log('  c8ctl nano set <bin|model-dir> <path>');
+  console.log('  c8ctl nano unset <bin|model-dir>');
   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('');
@@ -6479,10 +6545,11 @@ function printUsage() {
   console.log('  restart  Stop then start');
   console.log('  clean    Wipe journal/data + logs on disk (keeps models/workers)');
   console.log('  set      Persist a setting: "bin <path>" or "model-dir <path>"');
+  console.log('  unset    Clear a setting ("bin" or "model-dir") back to its default');
   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.25.0",
+  "version": "1.26.0",
   "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.25.0",
-    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.25.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.25.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.25.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.25.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.25.0",
-    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.25.0"
+    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.26.0",
+    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.26.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.26.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.26.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.26.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.26.0",
+    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.26.0"
   }
 }