c8ctl-plugin-nano 1.14.1 → 1.16.0

package/README.md

@@ -169,6 +169,18 @@ capabilities `code-review, testing` the matrix is:
 so a BPMN service task can target a worker at any granularity by setting its job
 type to the matching token.
 
+To also service a job type the matrix can't express — for example a code-first
+[`@nanobpm/workflow`](https://www.npmjs.com/package/@nanobpm/workflow) flow whose
+external task type is `<flowId>:<taskName>`, or any bespoke token — add one or
+more `--job-type <token>` flags. They are serviced **in addition to** the
+rank×capability matrix, so a single hired reviewer can drive both a model-first
+`senior:pr-review` task and a code-first flow's task without re-hiring:
+
+```bash
+c8ctl nano work reviewer --job-type convergence-loop:review-round
+c8ctl nano work reviewer --job-type senior:pr-review --job-type senior:triage
+```
+
 ```bash
 c8ctl nano work reviewer                     # poll for work until Ctrl-C
 c8ctl nano work reviewer --max-parallel 2 --job-timeout 600000

package/c8ctl-plugin.js

@@ -120,15 +120,6 @@ const PROCESSOS_STATE_FILE = 'processos.json';
 const PROCESSOS_DEFAULT_PORT = 8090;
 const DEFAULT_NANO_URL = 'http://localhost:8080';
 
-// Guided-journey deep links (ADR 0049 §2). The console renders a first-run tour
-// chosen by `…/console?tour=<journeyId>`, and the *command the user ran* already
-// encodes the persona — so the CLI bakes the journey into the console URL it
-// prints rather than making the console guess. These ids are a contract with the
-// console (`console/src/lib/tour`): an unknown id is silently ignored, so they
-// are asserted verbatim in the tests.
-const JOURNEY_LOCALDEV = 'localdev';
-const JOURNEY_AGENTIC_AUTHOR = 'agentic-author';
-
 // Passive update notifier (npm-style): refresh the latest published version
 // from the registry in a detached background process at most once per day, and
 // surface a one-line "update available" notice at most once per day. Never
@@ -459,27 +450,15 @@ function liveNodeCount(state) {
 }
 
 /**
- * Compose a web-console URL for a node's base URL, optionally carrying a guided
- * journey (`?tour=<id>`, ADR 0049 §2). Never hardcodes a port: `baseUrl` is the
- * real address the node came up on.
- */
-function webConsoleUrl(baseUrl, journey) {
-  const base = `${baseUrl}/console`;
-  return journey ? `${base}?tour=${encodeURIComponent(journey)}` : base;
-}
-
-/**
- * Base URL of the running cluster the user would actually open: the first
- * still-alive node, falling back to the first recorded node, then to the default
- * gateway URL when no cluster has been started. Used by hire/work, which surface
- * a console link for the agentic-SDLC journey.
+ * Compose a web-console URL for a node's base URL. Never hardcodes a port:
+ * `baseUrl` is the real address the node came up on.
+ *
+ * No longer carries a `?tour=<id>` deep link: onboarding is chosen in the
+ * console's own startup persona panel (nano-bpm #464), not sprayed across every
+ * command's output.
  */
-function runningConsoleBaseUrl(state = readState()) {
-  if (state && Array.isArray(state.nodes) && state.nodes.length > 0) {
-    const alive = state.nodes.find((n) => isPidAlive(n.pid));
-    return (alive || state.nodes[0]).url;
-  }
-  return DEFAULT_NANO_URL;
+function webConsoleUrl(baseUrl) {
+  return `${baseUrl}/console`;
 }
 
 /** Probe a node's always-on GET /v2/topology endpoint for reachability. */
@@ -861,7 +840,7 @@ async function printSummary(state) {
   console.log(`  REST API     ${entry.url}/v2`);
   console.log(`  Topology     ${entry.url}/v2/topology`);
   if (hasConsole) {
-    console.log(`  Web console  ${webConsoleUrl(entry.url, JOURNEY_LOCALDEV)}`);
+    console.log(`  Web console  ${webConsoleUrl(entry.url)}`);
     console.log(`  User guide   ${entry.url}/docs`);
   }
   if (state.workspaceDir) {
@@ -1401,6 +1380,35 @@ function parseEnvPairs(input) {
   return { env, errors };
 }
 
+// A worker job-type token: rank/capability tokens use `:` (rank↔cap) and `+`
+// (combined caps) as delimiters, and code-first `@nanobpm/workflow` job types
+// are `<flowId>:<taskName>` or an explicit override. The first character must be
+// a letter, digit, or `_`; the remainder may also include `. : + -`. Mirrors the
+// SDK's assertJobType so a token authored on one side is accepted on the other.
+const JOB_TYPE_TOKEN_RE = /^[A-Za-z0-9_][A-Za-z0-9_.:+-]*$/;
+
+// Parse repeatable `--job-type <token>` CLI input (string | string[]) into a
+// deduped, validated list of explicit job types a worker should also service,
+// in addition to its rank×capability matrix. Returns { jobTypes, errors }.
+function parseJobTypeFlags(input) {
+  const list = input == null ? [] : (Array.isArray(input) ? input : [input]);
+  const seen = new Set();
+  const jobTypes = [];
+  const errors = [];
+  for (const item of list) {
+    const token = String(item).trim();
+    if (!token) { errors.push('--job-type must be a non-empty token'); continue; }
+    if (!JOB_TYPE_TOKEN_RE.test(token)) {
+      errors.push(`--job-type "${token}" is invalid (must match ${JOB_TYPE_TOKEN_RE.source})`);
+      continue;
+    }
+    if (seen.has(token)) continue;
+    seen.add(token);
+    jobTypes.push(token);
+  }
+  return { jobTypes, errors };
+}
+
 /** A profile name must be a safe, filesystem/token-friendly slug. */
 function isValidProfileName(name) {
   return typeof name === 'string' && /^[a-z0-9][a-z0-9._-]*$/i.test(name);
@@ -1633,7 +1641,6 @@ async function hireWorker(req, flags) {
   if (envKeys.length > 0) logger.info(`  env: ${envKeys.join(', ')}`);
   logger.info(`  job types (${matrix.length}): ${matrix.join('  ')}`);
   logger.info(`Put it to work with: c8ctl nano work ${name}`);
-  logger.info(`Open the console:    ${webConsoleUrl(runningConsoleBaseUrl(), JOURNEY_AGENTIC_AUTHOR)}`);
 }
 
 /**
@@ -2658,6 +2665,16 @@ async function workAgent(req, flags) {
   }
 
   const matrix = jobTypeMatrix(profile.rank, profile.capabilities);
+  // Optional explicit job types (repeatable `--job-type`), serviced in addition
+  // to the rank×capability matrix. This lets a hired profile also drive a pool
+  // keyed on a token the matrix can't express — e.g. a code-first
+  // `@nanobpm/workflow` flow whose external task type isn't a `rank:cap` token.
+  const { jobTypes: extraJobTypes, errors: jobTypeErrors } = parseJobTypeFlags(flags?.['job-type']);
+  if (jobTypeErrors.length > 0) {
+    logger.error(jobTypeErrors.join('; '));
+    process.exit(1);
+  }
+  const jobTypes = [...new Set([...matrix, ...extraJobTypes])];
   const camunda = globalThis.c8ctl.createClient();
 
   logger.info(`Putting "${name}" [${profile.rank}] to work → ${profile.command}`);
@@ -2665,12 +2682,12 @@ async function workAgent(req, flags) {
   logger.info(`  sandbox: ${sandbox}${isContainer ? ` (image ${image})` : ''}`);
   const profileEnvKeys = Object.keys(profileEnv);
   if (profileEnvKeys.length > 0) logger.info(`  harness env: ${profileEnvKeys.join(', ')}`);
-  logger.info(`  listening on ${matrix.length} job type(s): ${matrix.join('  ')}`);
+  const extraNote = extraJobTypes.length > 0 ? ` (${extraJobTypes.length} via --job-type)` : '';
+  logger.info(`  listening on ${jobTypes.length} job type(s)${extraNote}: ${jobTypes.join('  ')}`);
   logger.info(`  max parallel: ${maxParallelJobs}; job timeout: ${jobTimeoutMs}ms`);
-  logger.info(`  console: ${webConsoleUrl(runningConsoleBaseUrl(), JOURNEY_AGENTIC_AUTHOR)}`);
   logger.info('Polling for work — press Ctrl-C to stop.');
 
-  const workers = matrix.map((jobType) =>
+  const workers = jobTypes.map((jobType) =>
     camunda.createJobWorker({
       jobType,
       workerName: `${name}:${jobType}`,
@@ -4200,10 +4217,7 @@ export { resolveBinary, findBinary, launcherEnvMarkers };
 export { buildNpmInvocation };
 export {
   webConsoleUrl,
-  runningConsoleBaseUrl,
   hireWorker,
-  JOURNEY_LOCALDEV,
-  JOURNEY_AGENTIC_AUTHOR,
 };
 export {
   normalizeTaskEnvelope,
@@ -4236,6 +4250,7 @@ export {
   ProvisionError,
   normalizeStoredProfile,
   jobTypeMatrix,
+  parseJobTypeFlags,
   AGENT_TASK_NS,
   AGENT_RESULT_KEY,
   RESULT_SENTINEL,
@@ -4338,6 +4353,7 @@ export const commands = {
       list: { type: 'boolean', description: 'hire: list existing agent profiles instead of creating one' },
       'max-parallel': { type: 'string', description: 'work: max concurrent jobs per worker (default 1)' },
       'job-timeout': { type: 'string', description: 'work: max harness runtime per job in ms; the spawned process is killed past this (default 300000)' },
+      'job-type': { type: 'string', multiple: true, description: 'work: extra job type to service alongside the rank×capability matrix (repeatable)' },
     },
     handler: async (args, flags) => {
       const logger = getLogger();
@@ -4481,7 +4497,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>] [--model <m>] [--capabilities <a,b>] [--sandbox none|docker|podman] [--image <ref>] [--env NAME=VALUE ...] [--list]');
-  console.log('  c8ctl nano work <profileName> [--max-parallel <n>] [--job-timeout <ms>] [--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 work <profileName> [--max-parallel <n>] [--job-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('');
   console.log('Subcommands:');
   console.log('  start    Spawn an N-node local cluster wired to talk to each other on localhost');
@@ -4522,6 +4538,7 @@ function printUsage() {
   console.log('  --env NAME=VALUE     hire/work: static env var for the harness (repeatable); persisted on hire, work extends/overrides');
   console.log('  --list               hire: list existing agent profiles instead of creating one');
   console.log('  --max-parallel <n>   work: max concurrent jobs per worker (default 1)');
+  console.log('  --job-type <token>   work: extra job type to service alongside the rank×capability matrix (repeatable)');
   console.log('  --job-timeout <ms>   work: max harness runtime per job in ms (default 300000)');
   console.log('  --secret-resolver <r> work: secret resolver for task secretRefs (host; default host)');
   console.log('  --reap-age <ms>      work: age before a finished agent container/workspace is reaped (default 3600000)');

package/package.json

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