@openwop/cli 1.7.0 → 1.8.0

package/README.md

@@ -498,7 +498,7 @@ The `goals` group drives the host's standing goals — an objective the host pur
 openwop goals list --state active                      # the goal list (also satisfied | escalated | bound-exceeded | paused)
 openwop goals get goal_123 --json                      # inspect (objective, judge, continuation, bounds, iterations)
 openwop goals create --objective "Keep the triage backlog under 20" \
-  --judge verifier --continuation schedule --max-iterations 50 --max-cost 5.00 --timeout-ms 600000
+  --verifier-ref <ref> --continuation schedule --max-iterations 50 --max-cost 5.00 --timeout-ms 600000
 openwop goals pause goal_123                            # suspend continuation (resume to restart)
 openwop goals abandon goal_123 --yes                   # close the goal
 ```

package/dist/cli.js

@@ -578,7 +578,7 @@ function errText(err) {
 // package.json
 var package_default = {
   name: "@openwop/cli",
-  version: "1.7.0",
+  version: "1.8.0",
   description: "OpenWOP CLI for operating the workflow-engine demo app and OpenWOP-compatible hosts.",
   license: "Apache-2.0",
   type: "module",
@@ -20501,7 +20501,7 @@ var GOALS_ROUTES = [
 var GOALS_HELP = `Usage:
   openwop goals list [--state <s>] [--json]
   openwop goals get <goalId> [--json]
-  openwop goals create --objective <text> [--judge host|verifier] [--continuation <mode>]
+  openwop goals create --objective <text> --verifier-ref <ref> [--continuation schedule|manual]
                        [--max-iterations <n>] [--max-cost <usd>] [--timeout-ms <ms>] [--json]
   openwop goals pause <goalId> [--json]
   openwop goals resume <goalId> [--json]
@@ -20528,13 +20528,16 @@ Endpoints:
   resume   POST   /v1/host/openwop-app/goals/{id}/resume
   abandon  POST   /v1/host/openwop-app/goals/{id}/abandon
 
-  --state <s>            (list) Filter by state (e.g. active, satisfied, escalated, bound-exceeded, paused).
+  --state <s>            (list) Filter by state: active, satisfied, escalated, abandoned, bound-exceeded.
   --objective <text>     (create) The goal objective (required).
-  --judge host|verifier  (create) completion.check \u2014 who decides completion (default: host).
-  --continuation <mode>  (create) continuation.mode \u2014 the arm that re-engages work (e.g. schedule | commitment | manual).
-  --max-iterations <n>   (create) Bound: bounds.maxLoopIterations.
+  --verifier-ref <ref>   (create) completion.verifierRef \u2014 the verifier registered on the host that
+                         judges this goal (required; the host refuses a ref it has not registered).
+  --judge verifier       (create) completion.check \u2014 who decides completion. 'verifier' is the only
+                         judge a host advertising agents.goals.judge=verifier honours (the default).
+  --continuation <mode>  (create) continuation.mode \u2014 schedule | manual (default: manual).
+  --max-iterations <n>   (create) Bound: bounds.maxLoopIterations (positive integer).
   --max-cost <usd>       (create) Bound: bounds.maxCostUsd (accumulated USD).
-  --timeout-ms <ms>      (create) Bound: bounds.runTimeoutMs (wall-clock, milliseconds).
+  --timeout-ms <ms>      (create) Bound: bounds.runTimeoutMs (wall-clock, positive milliseconds).
   --yes                  (abandon) Required to confirm.
   --json                 Print the raw host response instead of the rendered view.
 
@@ -20544,13 +20547,14 @@ termination guarantee (bounds).
 
 Exit codes (get/create/pause/resume reflect the goal's state, so scripts can gate
 on the verdict):
-  0  satisfied      3  escalated or still open (active/paused)      1  bound-exceeded/abandoned or error
+  0  satisfied      3  escalated or still open (active)      1  bound-exceeded/abandoned or error
+A paused goal is still 'active' (pause stops its continuation, not the goal).
 \`list\` exits 0 on success.
 
 Examples:
   openwop goals list --state active
   openwop goals get goal_123 --json
-  openwop goals create --objective "Keep the triage backlog under 20" --judge verifier --continuation schedule --max-iterations 50 --max-cost 5.00 --timeout-ms 600000
+  openwop goals create --objective "Keep the triage backlog under 20" --verifier-ref <ref> --continuation schedule --max-iterations 50 --max-cost 5.00 --timeout-ms 600000
   openwop goals pause goal_123
   openwop goals abandon goal_123 --yes
 `;
@@ -20696,18 +20700,24 @@ function renderGoal(ctx, g, fallbackId) {
 async function runGoalsCreate(ctx, argv) {
   const { options } = parseOptions(argv, {
     bool: ["--help"],
-    value: ["--objective", "--judge", "--continuation", "--max-iterations", "--max-cost", "--timeout-ms"]
+    value: ["--objective", "--judge", "--verifier-ref", "--continuation", "--max-iterations", "--max-cost", "--timeout-ms"]
   });
   if (options.help || !options.objective) {
-    write(ctx.io.stdout, "Usage: openwop goals create --objective <text> [--judge host|verifier] [--continuation <mode>] [--max-iterations <n>] [--max-cost <usd>] [--timeout-ms <ms>] [--json]\n");
+    write(ctx.io.stdout, "Usage: openwop goals create --objective <text> --verifier-ref <ref> [--continuation schedule|manual] [--max-iterations <n>] [--max-cost <usd>] [--timeout-ms <ms>] [--json]\n");
     return options.help ? 0 : 2;
   }
-  if (options.judge !== void 0 && !["host", "verifier"].includes(options.judge)) {
-    throw new CliError("--judge must be one of: host, verifier", 2);
+  if (options.judge !== void 0 && options.judge !== "verifier") {
+    throw new CliError("--judge must be: verifier", 2);
+  }
+  if (!options.verifierRef) {
+    throw new CliError("goals create needs --verifier-ref <ref> \u2014 the verifier registered on the host that judges the goal", 2);
+  }
+  if (options.continuation !== void 0 && !["schedule", "manual"].includes(options.continuation)) {
+    throw new CliError("--continuation must be one of: schedule, manual", 2);
   }
   const body = {
     objective: options.objective,
-    completion: { check: options.judge ?? "host" },
+    completion: { check: "verifier", verifierRef: options.verifierRef },
     continuation: { mode: options.continuation ?? "manual" }
   };
   const bounds = {};
@@ -20723,7 +20733,7 @@ async function runGoalsCreate(ctx, argv) {
   }
   if (options.timeoutMs !== void 0) {
     const t = Number(options.timeoutMs);
-    if (!Number.isInteger(t) || t < 0) throw new CliError("--timeout-ms must be a non-negative integer (milliseconds)", 2);
+    if (!Number.isInteger(t) || t <= 0) throw new CliError("--timeout-ms must be a positive integer (milliseconds)", 2);
     bounds.runTimeoutMs = t;
   }
   if (Object.keys(bounds).length) body.bounds = bounds;
@@ -20732,8 +20742,8 @@ async function runGoalsCreate(ctx, argv) {
   try {
     res = await requestJson(ctx, "/v1/host/openwop-app/goals", { method: "POST", body });
   } catch (err) {
-    if (err instanceof HttpError && err.status === 422) {
-      const detail2 = err.body?.message ?? "this host requires bounds on an active goal \u2014 pass --max-iterations, --max-cost, and/or --timeout-ms";
+    if (err instanceof HttpError && (err.status === 422 || err.status === 400)) {
+      const detail2 = err.body?.message ?? (err.status === 422 ? "this host requires bounds on an active goal \u2014 pass --max-iterations, --max-cost, and/or --timeout-ms" : "the host refused the goal as malformed");
       throw new CliError(`goals: ${detail2}`, 1);
     }
     gate4045(err);
@@ -20743,7 +20753,7 @@ async function runGoalsCreate(ctx, argv) {
     writeJson(ctx.io.stdout, g);
     return exitForState2(g.state);
   }
-  writeLine(ctx.io.stdout, `\u2713 Created goal ${g.goalId ?? g.id ?? ""} (state ${g.state ?? "active"}, check ${g.completion?.check ?? options.judge ?? "host"}).`);
+  writeLine(ctx.io.stdout, `\u2713 Created goal ${g.goalId ?? g.id ?? ""} (state ${g.state ?? "active"}, check ${g.completion?.check ?? "verifier"}).`);
   return exitForState2(g.state);
 }
 async function runGoalsTransition(ctx, argv, verb) {

package/dist/openwop.js

@@ -579,7 +579,7 @@ function errText(err) {
 // package.json
 var package_default = {
   name: "@openwop/cli",
-  version: "1.7.0",
+  version: "1.8.0",
   description: "OpenWOP CLI for operating the workflow-engine demo app and OpenWOP-compatible hosts.",
   license: "Apache-2.0",
   type: "module",
@@ -20501,7 +20501,7 @@ var GOALS_ROUTES = [
 var GOALS_HELP = `Usage:
   openwop goals list [--state <s>] [--json]
   openwop goals get <goalId> [--json]
-  openwop goals create --objective <text> [--judge host|verifier] [--continuation <mode>]
+  openwop goals create --objective <text> --verifier-ref <ref> [--continuation schedule|manual]
                        [--max-iterations <n>] [--max-cost <usd>] [--timeout-ms <ms>] [--json]
   openwop goals pause <goalId> [--json]
   openwop goals resume <goalId> [--json]
@@ -20528,13 +20528,16 @@ Endpoints:
   resume   POST   /v1/host/openwop-app/goals/{id}/resume
   abandon  POST   /v1/host/openwop-app/goals/{id}/abandon
 
-  --state <s>            (list) Filter by state (e.g. active, satisfied, escalated, bound-exceeded, paused).
+  --state <s>            (list) Filter by state: active, satisfied, escalated, abandoned, bound-exceeded.
   --objective <text>     (create) The goal objective (required).
-  --judge host|verifier  (create) completion.check \u2014 who decides completion (default: host).
-  --continuation <mode>  (create) continuation.mode \u2014 the arm that re-engages work (e.g. schedule | commitment | manual).
-  --max-iterations <n>   (create) Bound: bounds.maxLoopIterations.
+  --verifier-ref <ref>   (create) completion.verifierRef \u2014 the verifier registered on the host that
+                         judges this goal (required; the host refuses a ref it has not registered).
+  --judge verifier       (create) completion.check \u2014 who decides completion. 'verifier' is the only
+                         judge a host advertising agents.goals.judge=verifier honours (the default).
+  --continuation <mode>  (create) continuation.mode \u2014 schedule | manual (default: manual).
+  --max-iterations <n>   (create) Bound: bounds.maxLoopIterations (positive integer).
   --max-cost <usd>       (create) Bound: bounds.maxCostUsd (accumulated USD).
-  --timeout-ms <ms>      (create) Bound: bounds.runTimeoutMs (wall-clock, milliseconds).
+  --timeout-ms <ms>      (create) Bound: bounds.runTimeoutMs (wall-clock, positive milliseconds).
   --yes                  (abandon) Required to confirm.
   --json                 Print the raw host response instead of the rendered view.
 
@@ -20544,13 +20547,14 @@ termination guarantee (bounds).
 
 Exit codes (get/create/pause/resume reflect the goal's state, so scripts can gate
 on the verdict):
-  0  satisfied      3  escalated or still open (active/paused)      1  bound-exceeded/abandoned or error
+  0  satisfied      3  escalated or still open (active)      1  bound-exceeded/abandoned or error
+A paused goal is still 'active' (pause stops its continuation, not the goal).
 \`list\` exits 0 on success.
 
 Examples:
   openwop goals list --state active
   openwop goals get goal_123 --json
-  openwop goals create --objective "Keep the triage backlog under 20" --judge verifier --continuation schedule --max-iterations 50 --max-cost 5.00 --timeout-ms 600000
+  openwop goals create --objective "Keep the triage backlog under 20" --verifier-ref <ref> --continuation schedule --max-iterations 50 --max-cost 5.00 --timeout-ms 600000
   openwop goals pause goal_123
   openwop goals abandon goal_123 --yes
 `;
@@ -20696,18 +20700,24 @@ function renderGoal(ctx, g, fallbackId) {
 async function runGoalsCreate(ctx, argv) {
   const { options } = parseOptions(argv, {
     bool: ["--help"],
-    value: ["--objective", "--judge", "--continuation", "--max-iterations", "--max-cost", "--timeout-ms"]
+    value: ["--objective", "--judge", "--verifier-ref", "--continuation", "--max-iterations", "--max-cost", "--timeout-ms"]
   });
   if (options.help || !options.objective) {
-    write(ctx.io.stdout, "Usage: openwop goals create --objective <text> [--judge host|verifier] [--continuation <mode>] [--max-iterations <n>] [--max-cost <usd>] [--timeout-ms <ms>] [--json]\n");
+    write(ctx.io.stdout, "Usage: openwop goals create --objective <text> --verifier-ref <ref> [--continuation schedule|manual] [--max-iterations <n>] [--max-cost <usd>] [--timeout-ms <ms>] [--json]\n");
     return options.help ? 0 : 2;
   }
-  if (options.judge !== void 0 && !["host", "verifier"].includes(options.judge)) {
-    throw new CliError("--judge must be one of: host, verifier", 2);
+  if (options.judge !== void 0 && options.judge !== "verifier") {
+    throw new CliError("--judge must be: verifier", 2);
+  }
+  if (!options.verifierRef) {
+    throw new CliError("goals create needs --verifier-ref <ref> \u2014 the verifier registered on the host that judges the goal", 2);
+  }
+  if (options.continuation !== void 0 && !["schedule", "manual"].includes(options.continuation)) {
+    throw new CliError("--continuation must be one of: schedule, manual", 2);
   }
   const body = {
     objective: options.objective,
-    completion: { check: options.judge ?? "host" },
+    completion: { check: "verifier", verifierRef: options.verifierRef },
     continuation: { mode: options.continuation ?? "manual" }
   };
   const bounds = {};
@@ -20723,7 +20733,7 @@ async function runGoalsCreate(ctx, argv) {
   }
   if (options.timeoutMs !== void 0) {
     const t = Number(options.timeoutMs);
-    if (!Number.isInteger(t) || t < 0) throw new CliError("--timeout-ms must be a non-negative integer (milliseconds)", 2);
+    if (!Number.isInteger(t) || t <= 0) throw new CliError("--timeout-ms must be a positive integer (milliseconds)", 2);
     bounds.runTimeoutMs = t;
   }
   if (Object.keys(bounds).length) body.bounds = bounds;
@@ -20732,8 +20742,8 @@ async function runGoalsCreate(ctx, argv) {
   try {
     res = await requestJson(ctx, "/v1/host/openwop-app/goals", { method: "POST", body });
   } catch (err) {
-    if (err instanceof HttpError && err.status === 422) {
-      const detail2 = err.body?.message ?? "this host requires bounds on an active goal \u2014 pass --max-iterations, --max-cost, and/or --timeout-ms";
+    if (err instanceof HttpError && (err.status === 422 || err.status === 400)) {
+      const detail2 = err.body?.message ?? (err.status === 422 ? "this host requires bounds on an active goal \u2014 pass --max-iterations, --max-cost, and/or --timeout-ms" : "the host refused the goal as malformed");
       throw new CliError(`goals: ${detail2}`, 1);
     }
     gate4045(err);
@@ -20743,7 +20753,7 @@ async function runGoalsCreate(ctx, argv) {
     writeJson(ctx.io.stdout, g);
     return exitForState2(g.state);
   }
-  writeLine(ctx.io.stdout, `\u2713 Created goal ${g.goalId ?? g.id ?? ""} (state ${g.state ?? "active"}, check ${g.completion?.check ?? options.judge ?? "host"}).`);
+  writeLine(ctx.io.stdout, `\u2713 Created goal ${g.goalId ?? g.id ?? ""} (state ${g.state ?? "active"}, check ${g.completion?.check ?? "verifier"}).`);
   return exitForState2(g.state);
 }
 async function runGoalsTransition(ctx, argv, verb) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openwop/cli",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "OpenWOP CLI for operating the workflow-engine demo app and OpenWOP-compatible hosts.",
   "license": "Apache-2.0",
   "type": "module",