cloving 1.4.0 → 1.5.0

package/dist/src/cli/render.js

@@ -5,6 +5,8 @@ import { workflowRefusals } from "../workflow-refusals.js";
 import { commandText, shownCommands } from "./command-effects.js";
 import { scheduledText, statusScheduleLines, scheduleLines, } from "./schedule-render.js";
 import { show, oneLine, visible } from "./terminal-text.js";
+import { queueHeadline, queueStateLines } from "./queue-render.js";
+import { reloadFieldLines } from "./reload-render.js";
 export { oneLine } from "./terminal-text.js";
 export function errorText(error) {
     const { candidates } = error;
@@ -78,21 +80,33 @@ export function runOverview(result) {
         hiddenRuns: Math.max(0, finished.length - 20),
     };
 }
+function refusalLines(value) {
+    const refusals = workflowRefusals(value);
+    if (refusals.length === 0)
+        return [];
+    return [
+        "Refused workflows:",
+        ...refusals.map((entry) => `  ${entry.scope} ${entry.label}: ${entry.codes.join(", ")}`),
+    ];
+}
+function reloadLines(result) {
+    return [
+        `Reload: ${show(result["status"])}`,
+        `Bundle digest: ${show(result["previousBundleDigest"])} -> ${show(result["bundleDigest"])}`,
+        `Workflows: ${visible(listing(result["workflows"]))}`,
+        ...reloadFieldLines(result),
+        ...refusalLines(result["workflowRefusals"]),
+    ];
+}
 function runList(result) {
     const runs = result["runs"];
     const lines = Array.isArray(runs) ? runs.map(runLine) : [];
     const hiddenRuns = result["hiddenRuns"];
-    const refusals = workflowRefusals(result["workflowRefusals"]);
     return [
         `Workflows: ${visible(listing(result["workflows"]))}`,
         ...queueLines(result["queue"]),
         ...statusScheduleLines(result["schedules"]).map(oneLine),
-        ...(refusals.length === 0
-            ? []
-            : [
-                "Refused workflows:",
-                ...refusals.map((entry) => `  ${entry.scope} ${entry.label}: ${entry.codes.join(", ")}`),
-            ]),
+        ...refusalLines(result["workflowRefusals"]),
         "Runs:",
         ...(lines.length === 0 ? ["  none"] : lines),
         ...(typeof hiddenRuns === "number" && hiddenRuns > 0
@@ -108,7 +122,8 @@ export function queueLines(value) {
         return [];
     const skipped = queue["skipped"];
     return [
-        `Queue: ${visible(queue["busy"])} of ${visible(queue["lanes"])} lanes busy`,
+        queueHeadline(queue),
+        ...queueStateLines(queue),
         ...queueSpendLines(queue["spend"]),
         ...(Array.isArray(skipped)
             ? skipped.map((item) => {
@@ -172,6 +187,16 @@ function modelLines(attempts) {
     });
 }
 export { statusJson } from "./usage-render.js";
+function turnDetailsLines(value) {
+    const state = part(value, "state");
+    if (state === "deleted")
+        return ["Turn details were deleted by the retention rule"];
+    if (state !== "archived")
+        return [];
+    return [
+        `Turn details are archived in the journal folder of the archive: ${visible(part(value, "folder"))}`,
+    ];
+}
 function inputText(value) {
     const text = visible(record(value) ?? null);
     const characters = Array.from(text);
@@ -204,6 +229,7 @@ export function runStatus(result) {
         `Cost${suffix}: ${priceText(part(run, "claudeCostUsd"), part(run, "estimatedCostUsd"))}`,
         `Token usage${suffix}: ${usageText(part(run, "usage"))}`,
         ...workerLines(part(run, "workerTurns")),
+        ...turnDetailsLines(part(run, "turnDetails")),
         ...shownCommandWaits(part(run, "commandWaits")).map((wait) => visible(commandWaitText(wait))),
         ...(record(part(run, "budget")) === undefined
             ? []
@@ -289,7 +315,10 @@ const renderers = new Map([
     ["decision-list", decisionList],
     ["decision-recorded", decisionRecorded],
     ["run-command", runCommand],
+    ["queue", (result) => queueLines(result["queue"])],
+    ["queue-command", (result) => queueLines(result["queue"])],
     ["event-page", eventPage],
+    ["reload", reloadLines],
 ]);
 export function rendered(result) {
     const lines = renderers.get(show(result["kind"]))?.(result) ?? [];

package/dist/src/cli/report-github-reader.js

@@ -128,7 +128,7 @@ async function readEndpoint(input, request) {
             });
             if (output.status !== 0 || output.errorCode !== null)
                 throw Object.assign(new Error("github-call-failed"), {
-                    status: Number(/\(HTTP (\d{3})\)/.exec(output.stderr)?.[1]),
+                    status: Number(/\bHTTP (\d{3})\b/.exec(output.stderr)?.[1]),
                     detail: output.stderr,
                 });
             return output.stdout;

package/dist/src/cli/runtime-arguments.d.ts

@@ -1,4 +1,5 @@
 import { type ScheduleInvocation } from "./schedule-arguments.ts";
+import { type QueueInvocation } from "./queue-arguments.ts";
 export type RunSource = {
     readonly kind: "prompt";
     readonly text: string;
@@ -9,12 +10,15 @@ export type RunSource = {
     readonly kind: "input";
     readonly file: string;
 };
-type DecisionCommand = "answer" | "approve" | "deny";
-type RunCommand = "pause" | "resume" | "drop";
-export type RuntimeInvocation = ScheduleInvocation | {
+export type DecisionCommand = "answer" | "approve" | "deny";
+export type RunCommand = "pause" | "resume" | "drop";
+export type RuntimeInvocation = ScheduleInvocation | QueueInvocation | {
     readonly kind: "report";
     readonly since: number;
     readonly json: boolean;
+} | {
+    readonly kind: "reload";
+    readonly json: boolean;
 } | {
     readonly kind: "command-help";
     readonly command: string;
@@ -29,6 +33,7 @@ export type RuntimeInvocation = ScheduleInvocation | {
     readonly runId: string | null;
     readonly limit: number | null;
     readonly after: string | null;
+    readonly active: boolean;
     readonly json: boolean;
 } | {
     readonly kind: "questions";
@@ -73,6 +78,15 @@ export interface RuntimeRequest {
     readonly options: readonly GivenOption[];
 }
 type Outcome = RuntimeInvocation | string;
+export declare const argumentRules: {
+    identifier: RegExp;
+    decisionReference: RegExp;
+    sha256Digest: RegExp;
+    revisions: {
+        minimum: number;
+        maximum: number;
+    };
+};
 export declare function isRuntimeCommand(command: string): boolean;
 export declare function runtimeInvocation(request: RuntimeRequest): Outcome;
 export {};

package/dist/src/cli/runtime-arguments.js

@@ -1,5 +1,6 @@
 import { isRecordKey } from "../authority/commands.js";
 import { scheduleInvocation, } from "./schedule-arguments.js";
+import { queueInvocation } from "./queue-arguments.js";
 const identifier = /^[A-Za-z0-9._:/-]{1,128}$/;
 const decisionReference = /^[A-Za-z0-9._:/-]{1,256}$/;
 const sha256Digest = /^sha256:[0-9a-f]{64}$/;
@@ -9,6 +10,12 @@ const revisions = { minimum: 1, maximum: Number.MAX_SAFE_INTEGER };
 const sequences = { minimum: 0, maximum: Number.MAX_SAFE_INTEGER };
 const bindingOptions = ["expected-revision", "generation", "subject-digest"];
 const mutationOptions = ["command-id", "json"];
+export const argumentRules = {
+    identifier,
+    decisionReference,
+    sha256Digest,
+    revisions,
+};
 const shapes = new Map([
     [
         "run",
@@ -52,27 +59,21 @@ const shapes = new Map([
             build: events,
         },
     ],
+    ["report", noSubjectShape(["since", "json"], report)],
     [
-        "report",
-        {
-            subject: "none",
-            required: [],
-            allowed: () => ["since", "json"],
-            build: report,
-        },
-    ],
-    [
-        "watch",
-        {
-            subject: "none",
-            required: [],
-            allowed: () => ["port"],
-            build: watch,
-        },
+        "reload",
+        noSubjectShape(["json"], (request) => ({
+            kind: "reload",
+            json: given(request, "json"),
+        })),
     ],
+    ["watch", noSubjectShape(["port"], watch)],
 ]);
+function noSubjectShape(allowed, build) {
+    return { subject: "none", required: [], allowed: () => allowed, build };
+}
 export function isRuntimeCommand(command) {
-    return command === "schedule" || shapes.has(command);
+    return command === "schedule" || command === "queue" || shapes.has(command);
 }
 export function runtimeInvocation(request) {
     const shape = shapes.get(request.command);
@@ -85,6 +86,8 @@ export function runtimeInvocation(request) {
         return { kind: "command-help", command: request.command };
     if (request.command === "schedule")
         return scheduleInvocation(request);
+    if (request.command === "queue")
+        return queueInvocation(request);
     if (shape === undefined)
         return "unknown-command";
     return shapeFailure(shape, request) ?? shape.build(request);
@@ -123,7 +126,7 @@ function runCommandShape(command) {
 }
 function statusOptions(request) {
     return request.positionals.length === 0
-        ? ["limit", "after", "json"]
+        ? ["active", "limit", "after", "json"]
         : ["json"];
 }
 function eventOptions(request) {
@@ -197,8 +200,9 @@ function status(request) {
     const after = matching(valueOf(request, "after"), identifier);
     if (runId === invalid || limit === invalid || after === invalid)
         return "invalid-option-value";
+    const active = given(request, "active");
     const json = given(request, "json");
-    return { kind: "status", runId, limit, after, json };
+    return { kind: "status", runId, limit, after, active, json };
 }
 function watch(request) {
     const port = whole(valueOf(request, "port"), { minimum: 0, maximum: 65535 });

package/dist/src/cli/toolchain.d.ts

@@ -1,5 +1,6 @@
 import type { ToolchainIdentity } from "../workflow-admission.ts";
 export declare const supportedNodes: string;
+export declare const clovingVersion: string;
 export declare function supportedNode(version: string): boolean;
 export declare function observedToolchain(start: string): Promise<ToolchainIdentity>;
 export declare function qualifiedToolchain(observed: ToolchainIdentity, start: string): Promise<ToolchainIdentity>;

package/dist/src/cli/toolchain.js

@@ -4,6 +4,7 @@ import { access, readFile, realpath } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import packageMetadata from "#package" with { type: "json" };
 export const supportedNodes = packageMetadata.engines.node;
+export const clovingVersion = packageMetadata.version;
 export function supportedNode(version) {
     const release = /^v(\d+)\.(\d+)\.(\d+)$/.exec(version);
     if (release === null)

package/dist/src/cli/usage.d.ts

@@ -1,5 +1,5 @@
-export declare const configUsage = "Usage: cloving config list [--json]\n       cloving config get <field> [--json]\n       cloving config set <field> <value> [--private] [--json]\n       cloving config unset <field> [--private] [--json]\n\nReads and changes settings for the current repository; --repository selects another repository.\nValues use JSON when valid, otherwise text. Every change is checked before writing.\nFields use their default project or private file; --private selects the private file.\nlist and get show the effective source and hidden file values. Unconfigured values use defaults; null means no value.\nChanges keep the previous file as .bak and replace the file atomically under a lock.\nA live lock waits at most ten seconds, then exits with settings-locked.\nPrivate files, backups and temporary files have mode 0600. Changes require a service restart.\n";
+export declare const configUsage = "Usage: cloving config list [--json]\n       cloving config get <field> [--json]\n       cloving config set <field> <value> [--private] [--json]\n       cloving config unset <field> [--private] [--json]\n\nReads and changes settings for the current repository; --repository selects another repository.\nValues use JSON when valid, otherwise text. Every change is checked before writing.\nFields use their default project or private file; --private selects the private file.\nlist and get show the effective source and hidden file values. Unconfigured values use defaults; null means no value.\nChanges keep the previous file as .bak and replace the file atomically under a lock.\nA live lock waits at most ten seconds, then exits with settings-locked.\nPrivate files, backups and temporary files have mode 0600.\ncloving reload applies changes of profiles, fallbackModels, tokenPrices and workflows.folder. Other changes require a service restart.\n";
 export declare const commandUsage: Readonly<Record<string, string>>;
-export declare const usage = "Usage: cloving [--help] [--version]\n       cloving workflows list [--json] [--repository <directory>]\n       cloving workflows test [<id>] [--repository <directory>]\n       cloving workflows validate <manifest-path> [--input <json-file>] [--json]\n       cloving init [--harness <name or path>] [--repository <directory>]\n       cloving init-prompt [--repository <directory>]\n       cloving templates list [--json]\n       cloving templates show <name> [--json]\n       cloving templates copy <name> [--id <workflow-id>] [--json] [--repository <directory>]\n       cloving red-green\n       cloving <command> [--help]\n\nCommands:\n  workflows list      List project and user workflows and refusal codes.\n  workflows test      Run project and user workflow tests without a service.\n  workflows validate  Check a compiled workflow manifest, its artifacts and optional runtime input.\n  templates list      List the workflow templates of the package.\n  templates show      Show the decision points and the files of one template.\n  templates copy      Copy one template into .cloving/workflows of the repository.\n  red-green  Check assertion failure on the base and success on the head.\n  init             Start the setup agent\n  init-prompt Print setup instructions for an agent.\n  doctor     Check repository requirements before starting or submitting work.\n  run        Submit one run of an admitted workflow.\n  status     List the runs or show one run.\n  mcp        Serve the read tools over stdio.\n  schedule   List, pause and resume workflow schedules.\n  report     Report loop facts and seven-day baselines.\n  questions  List the pending decisions.\n  answer     Answer one design question.\n  approve    Approve one pending approval.\n  deny       Deny one pending approval.\n  pause      Stop new dispatch for a run.\n  resume     Resume a paused run.\n  drop       Cancel a run and keep its files.\n  events     Print the committed events.\n  watch      Serve a page that shows the runs live.\n  phone      Show, list, remove and reset the connected phones.\n  config     Read and change repository settings.\n  start      Start the service for a repository.\n\nThe runtime commands need a Cloving service. They use the current git repository; --repository <directory> selects another repository. CLOVING_RUNTIME_DIR overrides its runtime directory.\nUse npm exec -- cloving ... for a project-local installation.\n";
+export declare const usage = "Usage: cloving [--help] [--version]\n       cloving workflows list [--json] [--repository <directory>]\n       cloving workflows test [<id>] [--repository <directory>]\n       cloving workflows validate <manifest-path> [--input <json-file>] [--json]\n       cloving init [--harness <name or path>] [--repository <directory>]\n       cloving init-prompt [--repository <directory>]\n       cloving templates list [--json]\n       cloving templates show <name> [--json]\n       cloving templates copy <name> [--id <workflow-id>] [--json] [--repository <directory>]\n       cloving red-green\n       cloving <command> [--help]\n\nCommands:\n  workflows list      List project and user workflows and refusal codes.\n  workflows test      Run project and user workflow tests without a service.\n  workflows validate  Check a compiled workflow manifest, its artifacts and optional runtime input.\n  templates list      List the workflow templates of the package.\n  templates show      Show the decision points and the files of one template.\n  templates copy      Copy one template into .cloving/workflows of the repository.\n  red-green  Check assertion failure on the base and success on the head.\n  init             Start the setup agent\n  init-prompt Print setup instructions for an agent.\n  doctor     Check repository requirements before starting or submitting work.\n  run        Submit one run of an admitted workflow.\n  status     List the runs or show one run.\n  mcp        Serve the Cloving tools over stdio.\n  schedule   List, pause and resume workflow schedules.\n  queue      Show, resume and drain the queue.\n  report     Report loop facts and seven-day baselines.\n  questions  List the pending decisions.\n  answer     Answer one design question.\n  approve    Approve one pending approval.\n  deny       Deny one pending approval.\n  pause      Stop new dispatch for a run.\n  resume     Resume a paused run.\n  drop       Cancel a run and keep its files.\n  events     Print the committed events.\n  watch      Serve a page that shows the runs live.\n  reload     Check and compile the workflow files again.\n  phone      Show, list, remove and reset the connected phones.\n  config     Read and change repository settings.\n  start      Start the service for a repository.\n\nThe runtime commands need a Cloving service. They use the current git repository; --repository <directory> selects another repository. CLOVING_RUNTIME_DIR overrides its runtime directory.\nUse npm exec -- cloving ... for a project-local installation.\n";
 export declare const validateUsage = "Usage: cloving workflows validate <manifest-path> [--input <json-file>] [--json]\n\nChecks a Cloving workflow manifest, its compiled SDK artifacts, declared resources and toolchain, and an optional runtime input file. Relative paths resolve against the current directory.\n\nOptions:\n  --input <json-file>  Validate this runtime input file.\n  --json               Print one versioned JSON result on stdout.\n\nValidation does not admit a run, dispatch effects, import workflow code or call a model.\n\nExample:\n  cloving workflows validate cloving.workflow.json --input input.json\n";
 export declare const phoneUsage = "Usage: cloving phone status [--json]\n       cloving phone list [--json]\n       cloving phone remove <device-id> [--json]\n       cloving phone reset [--json]\n\nShows and changes the phones that answer the questions of this computer.\nstatus shows the registration with cloving.ai and the number of phones.\nlist shows each phone with its device ID, name, platform, state and pairing time.\nremove marks one phone removed on this computer, then asks cloving.ai to remove it. A failure at cloving.ai keeps the phone removed and shows a warning.\nreset removes the registration with cloving.ai, marks all phones removed and deletes phone/link.json and phone/daemon-keys.json.\nConnect a phone with the Connect a phone button of the watch page.\ncloving start runs the phone relay as a child process. With CLOVING_PHONE_RELAY=off, the relay does not start, and status says that the relay is off or not started.\n";

package/dist/src/cli/usage.js

@@ -10,12 +10,16 @@ Fields use their default project or private file; --private selects the private
 list and get show the effective source and hidden file values. Unconfigured values use defaults; null means no value.
 Changes keep the previous file as .bak and replace the file atomically under a lock.
 A live lock waits at most ten seconds, then exits with settings-locked.
-Private files, backups and temporary files have mode 0600. Changes require a service restart.
+Private files, backups and temporary files have mode 0600.
+cloving reload applies changes of profiles, fallbackModels, tokenPrices and workflows.folder. Other changes require a service restart.
 `;
 export const commandUsage = {
     mcp: `Usage: cloving mcp [--repository <directory>]
 
 Serves cloving_status, cloving_questions and cloving_events as read tools over stdio.
+Serves cloving_run, cloving_answer, cloving_approve, cloving_deny, cloving_pause,
+cloving_resume and cloving_drop to submit runs and decisions. Each of these tools
+needs a commandId. After a lost reply, send the same commandId again.
 The server binds to one repository at startup. It needs an existing Cloving service.
 Standard output contains only JSON-RPC messages. Diagnostics use standard error.
 `,
@@ -41,6 +45,19 @@ Prints facts, rules and setup steps for an agent. Does not change settings, call
 
 Checks repository requirements without repairs, model turns or GitHub writes.
 Required failures or skipped prerequisites exit with status 1.
+`,
+    queue: `Usage: cloving queue [--json]
+       cloving queue resume [--command-id <id>] [--json]
+       cloving queue drain [--command-id <id>] [--json]
+
+Shows the state of the queue: running, stopped, draining or drained, with the busy lanes.
+A stopped queue shows the reason and the failed runs in a row.
+resume sets the failure count to 0 and ends a stop or a drain. The next queue check can start a run.
+drain starts no new queue run. The runs in work continue to their end.
+When no lane is busy, the queue records the drain time, writes "Queue drained" one time and shows drained.
+A drained queue is a safe point for a restart. A drain stays in place after a restart.
+The queue keeps the newest 32 command IDs. A repeated kept ID does not apply the command again.
+The reply shows the current state. A different command with a kept ID is refused.
 `,
     report: `Usage: cloving report [--since <hours>] [--json]
 
@@ -55,9 +72,10 @@ With --ticket, the daemon reads the ticket at admission. A declared ticket field
 With --next (the same as --ticket next), ticket workflows select a ready ticket through CLOVING_NEXT_COMMAND.
 Success means a committed receipt. It does not mean completed work.
 `,
-    status: `Usage: cloving status [<run-id>] [--limit <n>] [--after <cursor>] [--json]
+    status: `Usage: cloving status [<run-id>] [--active] [--limit <n>] [--after <cursor>] [--json]
 
 Lists the runs, or shows one run with its reason, evidence and next action.
+With --active, lists only the runs that are not completed, failed or cancelled.
 `,
     schedule: `Usage: cloving schedule [--json]
        cloving schedule pause <workflowId> [--json]
@@ -100,6 +118,17 @@ Cancels the run and its pending dispatch. It keeps the workspace and the evidenc
     events: `Usage: cloving events [<run-id>] [--after <sequence>] [--limit <n>] [--follow] [--json]
 
 Prints the committed events after a sequence. With --json, each line is one event.
+`,
+    reload: `Usage: cloving reload [--json]
+
+Checks and compiles the workflow files again while the service runs.
+New runs use the new bundle. A run that started before the reload stays on the bundle of its pin.
+A new refusal of a workflow file keeps the current workflows and shows the reason.
+A change of the queue workflow or of a schedule needs a restart.
+It also reads the settings files and the profiles file again, and applies changes of profiles, fallbackModels, tokenPrices and workflows.folder.
+New turns use the new values. A turn in work keeps the values of its start.
+The reply lists each other changed field as a field that needs a restart. The service keeps its old value.
+An invalid settings file, an invalid profiles file or a profile harness with no worker at the start refuses the reload. Then nothing changes.
 `,
     watch: `Usage: cloving watch [--port <n>]
 
@@ -116,7 +145,8 @@ Stop it with Control-C.
 
 The queue continues after unsuccessful runs and stops after three runs in a row
 without a successful handoff. A successful handoff resets the count; ordinary restarts preserve the count.
-Stop the service, inspect the failures and reconcile affected issues, then start with --reset-queue and the same queue settings to clear the failure streak once. Tracked commands are preserved.
+Inspect the failures and reconcile affected issues. To clear the failure streak with no restart, run cloving queue resume.
+Stop the service and start with --reset-queue and the same queue settings to clear the failure streak once at a restart; --reset-queue also ends a drain. Tracked commands are preserved.
 
 The command reads these settings from the environment:
 Settings files: .cloving/config.json in the repository and <config>/cloving/projects/<name>-<id>.json for private settings. Both require version 1. Precedence: environment, private, project, defaults. <config> is an absolute XDG_CONFIG_HOME or ~/.config. The start guide shows each configured field's source. See the packaged project-config.schema.json and private-config.schema.json in dist/src.
@@ -131,9 +161,12 @@ Settings files: .cloving/config.json in the repository and <config>/cloving/proj
   CLOVING_WORKFLOW_FOLDER          An absolute folder path; when set, it replaces the user workflow folder. The private setting workflows.folder sets it. The folder itself must not be a symbolic link.
   CLOVING_SCHEDULES                A JSON object mapping declared workflow IDs to {everySeconds, input}; replaces declaration schedules. Intervals are whole seconds from 60 to 86400. Unset keeps declaration schedules. Scheduled runs skip overlapping slots and retain their progress across restart.
   CLOVING_SELF_UPDATE_SECONDS      A whole number from 30 to 3600 seconds between checks of the own checkout; unset means no update. An update stops the daemon and restarts with new code. A change of package-lock.json needs the operator to update and install by hand.
+  CLOVING_RETENTION_DAYS           A whole number of at least 1, or null. The default is 30. The daemon archives or deletes a journal or GitHub record folder of a completed, failed or cancelled run when the end of the run and the newest file of the folder are older than this count of days. It never touches the records of a run that is not finished. The value null keeps all records. The daemon sweeps once at start, before the watch page starts, and then each hour, with at most 200 folders in each pass.
+  CLOVING_RETENTION_ACTION         archive or delete. The default is archive. An archive keeps the relative path of the folder in the archive folder.
+  CLOVING_RETENTION_ARCHIVE_FOLDER An absolute folder path, or null for <state>/archive. The folder can be on another volume. When the folder is not available, the sweep moves nothing, logs the reason and tries again in the next hour.
   CLOVING_GROK_COMMAND             A JSON list of a command and its arguments for Grok. The default uses streaming-messages-json, --always-approve and -p; the turn text follows -p or --single as one argument, or is appended if neither flag is present.
   CLOVING_CLAUDE_COMMAND           A JSON list of a command and its arguments for the Claude worker. The default is the claude command with a limit of 5 USD for each turn.
-  CLOVING_PROFILES                 The path of a JSON file of operator-defined Claude turn profiles, read once at start. The setting has no default.
+  CLOVING_PROFILES                 The path of a JSON file of operator-defined Claude turn profiles, read at start and at each cloving reload. A relative path starts at the folder of cloving start. The setting has no default.
   CLOVING_COMMANDS                A JSON object mapping names to argument arrays with an absolute executable path. Invalid values refuse startup with invalid-commands. Unset means no commands. Command execution is not available yet.
   CLOVING_COMMAND_SECONDS         A whole number from 1 to 3600 seconds; the default is 60. Invalid values refuse startup with invalid-command-seconds. Reserved for command execution.
   CLOVING_TOKEN_PRICES             A JSON object from model names to input, cachedInput and output USD prices per million tokens for estimates; entries override matching built-in prices.
@@ -181,8 +214,9 @@ Commands:
   doctor     Check repository requirements before starting or submitting work.
   run        Submit one run of an admitted workflow.
   status     List the runs or show one run.
-  mcp        Serve the read tools over stdio.
+  mcp        Serve the Cloving tools over stdio.
   schedule   List, pause and resume workflow schedules.
+  queue      Show, resume and drain the queue.
   report     Report loop facts and seven-day baselines.
   questions  List the pending decisions.
   answer     Answer one design question.
@@ -193,6 +227,7 @@ Commands:
   drop       Cancel a run and keep its files.
   events     Print the committed events.
   watch      Serve a page that shows the runs live.
+  reload     Check and compile the workflow files again.
   phone      Show, list, remove and reset the connected phones.
   config     Read and change repository settings.
   start      Start the service for a repository.