@wardby/cli 0.6.0 → 0.7.0

package/dist/viewer/api-schema.js

@@ -6,6 +6,7 @@
  * `npm run build:viewer-schemas`, and commit the regenerated files.
  */
 import { z } from "zod";
+import { legacyJsonSchema } from "../core/zod-json-schema.js";
 export const RunStatusSchema = z.enum([
     "pending",
     "running",
@@ -210,3 +211,9 @@ export const VIEWER_SCHEMAS = {
     "viewer-event": ViewerEventSchema,
     "infra-info": InfraInfoSchema,
 };
+/** A viewer schema's JSON Schema (draft-07 keywords, no `$schema`), as the published files spell it. */
+export function viewerJsonSchema(schema) {
+    const json = legacyJsonSchema(z.toJSONSchema(schema, { target: "draft-07", io: "output" }));
+    delete json.$schema;
+    return json;
+}

package/dist/viewer/build-schemas.js

@@ -2,14 +2,18 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { zodToJsonSchema } from "zod-to-json-schema";
 import { VIEWER_SCHEMAS } from "./api-schema.js";
+import { viewerJsonSchema } from "./api-schema.js";
 import { OPENAPI_PATH, renderViewerOpenApi } from "./openapi.js";
 export const SCHEMA_DIR = join(dirname(fileURLToPath(import.meta.url)), "schemas");
 export function renderSchemas() {
     return Object.fromEntries(Object.entries(VIEWER_SCHEMAS).map(([name, schema]) => [
         `${name}.schema.json`,
-        `${JSON.stringify(zodToJsonSchema(schema, { name, $refStrategy: "none" }), null, 2)}\n`,
+        `${JSON.stringify({
+            $ref: `#/definitions/${name}`,
+            definitions: { [name]: viewerJsonSchema(schema) },
+            $schema: "http://json-schema.org/draft-07/schema#",
+        }, null, 2)}\n`,
     ]));
 }
 if (process.argv[1] === fileURLToPath(import.meta.url)) {

package/dist/viewer/openapi.js

@@ -6,8 +6,8 @@
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { stringify } from "yaml";
-import { zodToJsonSchema } from "zod-to-json-schema";
 import { VIEWER_SCHEMAS } from "./api-schema.js";
+import { viewerJsonSchema } from "./api-schema.js";
 import { DEFAULT_GRAPH_LIMIT, MAX_GRAPH_LIMIT, SSE_HEARTBEAT_MS } from "./limits.js";
 export const OPENAPI_PATH = join(dirname(fileURLToPath(import.meta.url)), "../../docs/viewer-api.openapi.yml");
 const AUTH_NOTE = "Requires a bearer token with the `admin:view` scope, held by a caller with the admin role.";
@@ -103,9 +103,7 @@ export const VIEWER_ROUTES = [
 function componentSchemas() {
     const schemas = {};
     for (const [name, schema] of Object.entries(VIEWER_SCHEMAS)) {
-        const json = zodToJsonSchema(schema, { target: "jsonSchema2019-09", $refStrategy: "none" });
-        delete json.$schema;
-        schemas[name] = json;
+        schemas[name] = viewerJsonSchema(schema);
     }
     schemas.ViewerError = {
         type: "object",

package/dist/wardby-bin.js

@@ -42,6 +42,16 @@ async function main() {
         const { helpCommand } = await import("./help/cli.js");
         await helpCommand(process.argv.slice(3));
     }
+    else if (command === "resume") {
+        // Runs on a developer's machine: no environment, database, or server runtime.
+        const { resumeCommand } = await import("./coding/transcript/resume/command.js");
+        process.exitCode = await resumeCommand(process.argv.slice(3));
+    }
+    else if (command === "resume-tools") {
+        // Hidden: the stand-in tool server `wardby resume` configures Claude Code to start.
+        const { resumeToolsCommand } = await import("./coding/transcript/resume/stand-in.js");
+        await resumeToolsCommand(process.argv.slice(3));
+    }
     else if (command === "knowledge") {
         // Offline bundle validation: no environment, database, or HTTP runtime.
         const { knowledgeCommand } = await import("./knowledge/cli.js");

package/docs/agent-recipes.md

@@ -231,22 +231,32 @@ to include secrets or internal details. See
 <details>
 <summary>Builder (coding agent) fields that matter</summary>
 
-| Field (`codingProfile`) | What to set                                                                                                                                                  |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `model` (agent field)   | A capable coding model the chosen provider supports, for example `gpt-5.6-terra` with `codex` or `claude-sonnet-5` with `claude-code`; a mismatch is refused |
-| `provider`              | `codex` or `claude-code`; the agent's `model` must be one that provider supports                                                                             |
-| `repository`            | `your-org/your-repo`; your linked GitHub account needs write access                                                                                          |
-| `baseRef`               | The branch runs start from, usually your default branch                                                                                                      |
-| `toolchain`             | `node` or `node-python` (per language below)                                                                                                                 |
-| `toolchainVersion`      | `"3.12"` for `node-python`; omit for `node`                                                                                                                  |
-| `packageAllowlist`      | Top-level packages per ecosystem (`npm`, `pypi`). Needs `packages:approve` or `agents:admin`                                                                 |
-| `packagePolicy`         | Optional `minReleaseAgeDays` (0 to 30)                                                                                                                       |
-| `services`              | Catalog service names the agent may start, for example `["postgres"]`; see [Services](coding-services.md)                                                    |
-| `protectedPaths`        | Globs a run may not change, for example `[".github/**", "CODEOWNERS"]`. `.wardby/**` is always protected except `.wardby/services.yaml`                      |
-| `timeoutSec`            | 60 to 7200; for example `1800`                                                                                                                               |
-| `workerImageRef`        | Digest-pinned custom image; needs `agents:admin` (see "Other languages")                                                                                     |
-| `defaultTask`           | Needed only to schedule the agent                                                                                                                            |
-| Agent `budgetUsd`       | Per-run budget, reserved at dispatch, for example `5`                                                                                                        |
+| Field (`codingProfile`)       | What to set                                                                                                                                                                                                                                                                                                                                                                                       |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `model` (agent field)         | A capable coding model the chosen provider supports, for example `gpt-5.6-terra` with `codex` or `claude-sonnet-5` with `claude-code`; a mismatch is refused                                                                                                                                                                                                                                      |
+| `provider`                    | `codex` or `claude-code`; the agent's `model` must be one that provider supports                                                                                                                                                                                                                                                                                                                  |
+| `repository`                  | `your-org/your-repo`; your linked GitHub account needs write access                                                                                                                                                                                                                                                                                                                               |
+| `baseRef`                     | The branch runs start from, usually your default branch                                                                                                                                                                                                                                                                                                                                           |
+| `toolchain`                   | `node` or `node-python` (per language below)                                                                                                                                                                                                                                                                                                                                                      |
+| `toolchainVersion`            | `"3.12"` for `node-python`; omit for `node`                                                                                                                                                                                                                                                                                                                                                       |
+| `packageAllowlist`            | Top-level packages per ecosystem (`npm`, `pypi`). Needs `packages:approve` or `agents:admin`                                                                                                                                                                                                                                                                                                      |
+| `packagePolicy`               | Optional `minReleaseAgeDays` (0 to 30)                                                                                                                                                                                                                                                                                                                                                            |
+| `services`                    | Catalog service names the agent may start, for example `["postgres"]`; see [Services](coding-services.md)                                                                                                                                                                                                                                                                                         |
+| `protectedPaths`              | Globs a run may not change, for example `[".github/**", "CODEOWNERS"]`. `.wardby/**` is always protected except `.wardby/services.yaml`                                                                                                                                                                                                                                                           |
+| `timeoutSec`                  | 60 to 7200; for example `1800`                                                                                                                                                                                                                                                                                                                                                                    |
+| `workerImageRef`              | Digest-pinned custom image; needs `agents:admin` (see "Other languages")                                                                                                                                                                                                                                                                                                                          |
+| `defaultTask`                 | Needed only to schedule the agent                                                                                                                                                                                                                                                                                                                                                                 |
+| Agent `budgetUsd`             | Per-run budget, reserved at dispatch, for example `5`                                                                                                                                                                                                                                                                                                                                             |
+| Agent `allowedOverrunPercent` | Optional whole percent (0 to 100, default 0) beyond `budgetUsd`, for example `10`. On a coding agent it raises each run's limit; on a lead agent that delegates, it raises its run tree's ceiling for coding sub-agents. It is never reserved: a run is topped up past its base only from room its budget group and run tree have when it needs it. Native runs' own model calls are not affected |
+
+To allow a small overrun on an existing coding agent, call `update_agent`
+(it needs the same permission as changing `budgetUsd`):
+
+```json
+{ "id": "<coding agent id>", "allowedOverrunPercent": 10 }
+```
+
+See [Budgets](coding-agent-setup.md#budgets).
 
 The agent's `systemPrompt` is placed ahead of each request as standing
 instructions. The template below is generic.
@@ -407,8 +417,10 @@ the lead's `maxDelegationsPerRun` (1 to 20) with `create_agent` or
 - Each coding sub-agent's result tells the lead its `status`, its summary
   (`finalText`), cost and tokens, and, when it opened or pushed to a pull
   request, `pullRequest` (`outcome` `opened` or `updated`, `repository`,
-  `number`, `url`) taken from Wardby's own record of the run. A lead prompt can
-  ask the agent to report those links.
+  `number`, `url`) taken from Wardby's own record of the run. A failed builder's
+  result also carries `errorCode`, the leading code of its error (such as
+  `coding_queue_timeout`); the full error stays on the run (`get_run`). A lead
+  prompt can ask the agent to report those links and codes.
 - The whole run tree shares one budget: give the lead a `budgetUsd` that
   covers every builder it may start, plus its own planning. Builders started
   together each reserve their own `budgetUsd` up front, so the ones admitted
@@ -424,8 +436,8 @@ the lead's `maxDelegationsPerRun` (1 to 20) with `create_agent` or
   boundary (routes, field names and types, error codes), word for word the same.
 - Wardby adds a **Related pull requests** section to each pull request the
   builders open, listing the others with links, states (open, draft, merged,
-  closed) and the originating issue. With a Jira issue, the list covers every
-  pull request recorded for that issue in any run. When no pull request in the
+  closed) and the originating issue. With a Jira or GitHub issue, the list
+  covers every pull request recorded for that issue in any run. When no pull request in the
   set carries a `mergeOrder` (see below), open ones are numbered as a
   **Suggested merge order** — the order the lead delegated in, not a
   guarantee. When any pull request in the set carries one (open, merged or
@@ -480,6 +492,14 @@ the lead's `maxDelegationsPerRun` (1 to 20) with `create_agent` or
   blocks a merge by itself: add `wardby merge order` as a required status
   check in branch protection to gate on it. See
   [The wardby merge order check](../help/merge-order-check.md).
+- With Wardby 0.7.0 or later, set `markReadyWhenPassing: true` on the
+  lead's write link (`link_repository`) to have Wardby mark the draft pull
+  requests its builders open ready for review once they pass, instead of
+  leaving that to a person; the coding builders need no link of their own.
+  With a `mergeOrder` set, a later step only becomes ready this way once the
+  `wardby merge order` check above reports `success` on it — that is, once
+  the steps it depends on have merged. See [Mark ready
+  when passing](code-review-agents.md#mark-ready-when-passing-markreadywhenpassing).
 - The section, and the follow-up hints below, list every pull request in the
   set by repository name and number. A request that spans repositories of
   different visibility can therefore show a private repository's name in a
@@ -512,6 +532,11 @@ fails with category `continuation_closed` and pushes nothing — see
 
 #### Limits
 
+- If two executions of one delegation step overlap (for example a stalled
+  process and the process that took the run over) and the call id is already
+  held by a run of a different sub-agent, the call returns
+  `delegation_conflict` to the lead without starting a run or failing it; see
+  [Delegation conflict](../help/errors/delegation-conflict.md).
 - Cancelling the lead run does not stop a native sub-agent that is already
   running; it keeps running to completion. A coding sub-agent is stopped.
 - If Wardby restarts mid-batch, the batch's delegation calls replay and each
@@ -546,6 +571,19 @@ the run; the pull request description says which. A person
 reviews and merges; Wardby never merges for you. A later mention on that pull
 request continues the same branch.
 
+When a mention run finishes without opening a pull request or failing a
+sub-run and its reply is longer than about 2,000 characters (for example a
+plan), the status comment does not cut the reply short. It says "✅ Finished
+without opening a pull request. The full reply follows in the next
+comment(s)." (in a review thread: "...follows in this pull request's
+conversation."), and the reply is posted in up to four numbered comments
+("Reply, part i of n") of about 60,000 characters each, split at headings,
+paragraphs or lines. Anything beyond four parts is cut with a note; the full
+text stays on the run (`get_run`, `finalText`). `@`-mentions in the reply are
+defused. Each part is posted once; if one cannot be posted, the rest are
+skipped. Shorter replies, and runs that opened a pull request or had a failed
+sub-run, keep the status comment that quotes up to 2,000 characters.
+
 ## Next steps
 
 - [Architecture knowledge bundles](knowledge.md)