@rse/ase 2.0.6 → 2.0.8

package/dst/ase-task-board-web-server.js

@@ -13,6 +13,7 @@ import { userId } from "./ase-service-otel.js";
 import { Config } from "./ase-config-core.js";
 import { configSchema, webColorDefaults, webColorNames } from "./ase-config-schema.js";
 import { buildBoard, watchTasks, toneOf, laneMoves, cardMoves, BoardState, attachmentTabs, isDiff, diffTones, dataLang, dataLoad, dataSpans, newTaskText, createTask, saveTask, TaskConflict, watchAgents } from "./ase-task-board-core.js";
+import { diffHunks, diffMarkdown, diffMarksToHTML } from "./ase-task-board-diff.js";
 import { layoutGraph, drawGraphSVG } from "./ase-task-board-graph.js";
 import { flowOf, layoutFlow, drawFlowSVG } from "./ase-task-board-flow.js";
 import { filterBoard, dropStandalone } from "./ase-task-board-filter.js";
@@ -94,9 +95,9 @@ const markedLoad = async (remote) => {
                         (title ? ` title="${escapeHTML(title)}"` : "") + ">" : escapeHTML(text);
             },
             code({ text, lang }) {
-                if (lang === "mermaid") {
+                if (lang === "mermaid" && !text.includes("⟦chg:")) {
                     try {
-                        return `<div class="diagram">${renderMermaidSVG(text)}</div>`;
+                        return `<div class="diagram">${renderMermaidSVG(text, { bg: "var(--c-paper)", fg: "var(--c-text)" })}</div>`;
                     }
                     catch {
                         /*  fall through to the plain rendering of the source  */
@@ -119,12 +120,12 @@ const renderPlan = async (body, remote = false) => {
         const outside = fence === "";
         fence = TaskFormat.fenceTrack(fence, line);
         return !outside || fence !== "" ? line : line
-            .replace(/^(\s*(?:[-*]|\d+[.)])\s+)\[([ x/?\->])\]/, (_m, lead, box) => `${lead}⟦box:${boxes[box]}⟧`);
+            .replace(/^(\s*(?:[-*]|\d+[.)])\s+(?:⟦chg:[a-z-]+⟧)?)\[([ x/?\->])\]/, (_m, lead, box) => `${lead}⟦box:${boxes[box]}⟧`);
     }).join("\n");
     if (!marked.has(remote))
         marked.set(remote, markedLoad(remote));
     const html = (await marked.get(remote)).parse(prepared, { async: false });
-    return html.replace(/⟦box:([a-z]+)⟧/g, (_m, state) => `<span class="box ${state}" title="[${escapeHTML(boxChars[state] ?? " ")}]"></span>`);
+    return diffMarksToHTML(html.replace(/⟦box:([a-z]+)⟧/g, (_m, state) => `<span class="box ${state}" title="[${escapeHTML(boxChars[state] ?? " ")}]"></span>`));
 };
 const colorRoles = Object.keys(webColorDefaults);
 const colorBases = (log) => {
@@ -154,10 +155,18 @@ const editorKeymap = (log) => {
     const value = cfg.get("board.web.editor.keymap");
     return value === "vim" || value === "emacs" ? value : "default";
 };
-/*  render a standalone document (styled by the client stylesheet) out of
-    key/value fields, separated by a line from the content  */
+/*  the color theme of the web board, resolved from the
+    "board.web.theme" configuration (on each page load)  */
+const boardTheme = (log) => {
+    const cfg = new Config("config", configSchema, log);
+    cfg.read();
+    const value = cfg.get("board.web.theme");
+    return value === "light" || value === "dark" ? value : "auto";
+};
+/*  render a standalone document (styled by the client stylesheet) out of key/value
+    fields (optionally marked as added or removed), separated by a line from the content  */
 const fieldsDocument = (fields, content) => {
-    const rows = fields.map(([k, v]) => `<tr><td class="k">${escapeHTML(k)}</td><td>${escapeHTML(v)}</td></tr>`).join("");
+    const rows = fields.map(([k, v, mark]) => `<tr${mark !== undefined ? ` class="${mark}"` : ""}><td class="k">${escapeHTML(k)}</td><td>${escapeHTML(v)}</td></tr>`).join("");
     return "<!DOCTYPE html><html><head><meta charset=\"utf-8\">" +
         "<link rel=\"stylesheet\" href=\"/task-board/colors.css\">" +
         "<link rel=\"stylesheet\" href=\"/task-board/ase-task-board-web-client.css\"></head><body class=\"plan\"><article>" +
@@ -166,6 +175,16 @@ const fieldsDocument = (fields, content) => {
 };
 /*  render a task plan as a standalone document: frontmatter fields and the numbered plan sections  */
 const taskDocument = async (keys, body) => fieldsDocument([...keys].filter(([k]) => k !== "Type"), await renderPlan(body));
+const isPlanText = (value) => {
+    const plan = value;
+    return typeof plan?.body === "string" && Array.isArray(plan.keys) && plan.keys.every((field) => Array.isArray(field) && field.length === 2 && field.every((text) => typeof text === "string"));
+};
+/*  render the diff of two task plans as a standalone document, in the look of a task plan  */
+const diffDocument = async (before, after) => fieldsDocument(diffHunks(before.keys, after.keys, (field) => JSON.stringify(field)).flatMap(({ kept, removed, added }) => [
+    ...kept,
+    ...removed.map(([k, v]) => [k, v, "del"]),
+    ...added.map(([k, v]) => [k, v, "add"])
+]), await renderPlan(diffMarkdown(before.body, after.body)));
 /*  render a task plan attachment as a standalone document: its fields and
     its content, with images embedded, Markdown rendered, YAML or JSON data syntax-highlighted, a diff
     colored per line, binary content as a placeholder, and else verbatim text  */
@@ -335,11 +354,13 @@ const guarded = (handler) => async (request, h) => {
 };
 /*  register the page routes of the web board: its client assets and its colors  */
 const registerPageRoutes = (server, log) => {
-    /*  the single page of the web board, with its stylesheet and browser-side code  */
+    /*  the single page of the web board, with its stylesheet and browser-side code,
+        and with its color theme (resolved on each page load) on its root element  */
     server.route({
         method: "GET",
         path: "/task-board",
-        handler: (_request, h) => h.response(clientAsset("html")).type("text/html; charset=utf-8")
+        handler: (_request, h) => h.response(clientAsset("html")
+            .replace(/<html\b/, `<html data-theme="${boardTheme(log)}"`)).type("text/html; charset=utf-8")
     });
     server.route({
         method: "GET",
@@ -439,12 +460,26 @@ const registerViewRoutes = (server, log) => {
                 group: board.groups.find((g) => g.lanes.some((l) => l.status === card.status))?.title ?? "",
                 epic: card.group,
                 doc: await taskDocument(parts.keys, parts.body),
+                plan: { keys: [...parts.keys].filter(([k]) => k !== "Type"), body: parts.body },
                 tabs: attachmentTabs(await Task.attachments(log, id), parts.keys.get("Modified") ?? ""),
                 pred: ref(board.pred.get(id) ?? []),
                 succ: ref(board.succ.get(id) ?? [])
             });
         })
     });
+    /*  the diff of two states of a task plan, rendered statelessly out of the states
+        kept by the client, as the changes are followed per task dialog  */
+    server.route({
+        method: "POST",
+        path: "/task-board/api/diff",
+        options: { payload: { parse: true, allow: "application/json" } },
+        handler: guarded(async (request, h) => {
+            const p = request.payload;
+            if (!isPlanText(p?.before) || !isPlanText(p.after))
+                return h.response({ error: "invalid diff request" }).code(400);
+            return h.response({ doc: await diffDocument(p.before, p.after) });
+        })
+    });
     /*  one task plan as text for editing, with the entity tag it is based on and the editor key bindings  */
     server.route({
         method: "GET",

package/dst/ase-task-board.js

@@ -108,27 +108,35 @@ export default class TaskBoardCommand {
             .option("--agent-relay <url>", "agent relay to receive the live presence of the agents from, " +
             "as \"ase[s]://<addr>:<port>[/<token>]\" (default: the configured \"project.relay.url\", else none; " +
             "the web board always follows the configured one)")
+            .option("-T, --task <id>", "show only the task dialog of the given task as a task viewer, " +
+            "following all its changes live (with --text or without a terminal: print its plan and exit)")
             .action(async (opts) => {
+            /*  refuse the task viewer on an unknown task  */
+            const plan = opts.task !== undefined ? await Task.load(this.log, opts.task) : "";
+            if (opts.task !== undefined && plan === "")
+                throw new Error(`board: no task "${opts.task}"`);
             /*  serve and open the web board  */
             if (opts.web === true) {
                 if (opts.agentRelay !== undefined)
                     this.log.write("warning", "board: \"--agent-relay\" is ignored by the web board, " +
                         "which follows the configured \"project.relay.url\"");
-                const url = `http://${SERVICE_HOST}:${await this.servicePort()}/task-board`;
+                const url = `http://${SERVICE_HOST}:${await this.servicePort()}/task-board` +
+                    (opts.task !== undefined ? `?task=${encodeURIComponent(opts.task)}` : "");
                 await writeStdout(`${url}\n`);
                 await this.openBrowser(url);
                 return;
             }
-            /*  print the plain text overview if requested or without a terminal  */
+            /*  print the plain text overview (resp. the plan of the task
+                of the task viewer) if requested or without a terminal  */
             if (opts.text === true || !process.stdout.isTTY || !process.stdin.isTTY) {
-                await writeStdout(await textOverview(this.log, opts.agentRelay));
+                await writeStdout(opts.task !== undefined ? plan : await textOverview(this.log, opts.agentRelay));
                 return;
             }
             /*  run the interactive terminal board, with the production build of React
                 (its development build records a never cleared performance measure per render)  */
             process.env.NODE_ENV ??= "production";
             const { runTUI } = await import("./ase-task-board-tui.js");
-            await runTUI(this.log, opts.agentRelay);
+            await runTUI(this.log, opts.agentRelay, opts.task);
         });
     }
 }

package/dst/ase-task-store-client.js

@@ -5,10 +5,9 @@
 */
 import path from "node:path";
 import fs from "node:fs";
-import { ofetch } from "ofetch";
-import { Agent } from "undici";
 import { WebSocket } from "ws";
 import { LRUCache } from "lru-cache";
+import { dispatchFetch, insecureAgent } from "./ase-lib-fetch.js";
 import { Config } from "./ase-config-core.js";
 import { configSchema } from "./ase-config-schema.js";
 import { parseScope, userStateDir } from "./ase-config-scope.js";
@@ -217,7 +216,7 @@ export class RemoteTaskStoreClient {
         this.insecure = insecure;
         this.lifecycle = configured;
         this.idscheme = configuredIdScheme;
-        this.dispatcher = insecure ? new Agent({ connect: { rejectUnauthorized: false } }) : undefined;
+        this.dispatcher = insecure ? insecureAgent() : undefined;
     }
     /*  raise a failed connection as an unreachable store error,
         reporting the innermost cause (like "connect ECONNREFUSED")  */
@@ -232,7 +231,7 @@ export class RemoteTaskStoreClient {
         a null result, any other error response is raised as a problem carrying
         its status, and a failed connection is raised as an unreachable store error  */
     async request(method, url, body, headers = {}, tolerated = []) {
-        const r = await ofetch.raw(`${this.base}${url}`, {
+        const r = await dispatchFetch.raw(`${this.base}${url}`, {
             method,
             headers: {
                 Authorization: `Bearer ${this.token}`,
@@ -408,7 +407,7 @@ export class RemoteTaskStoreClient {
         return await this.task(await this.request("POST", `${this.tasks}/${encodeURIComponent(id)}/attachment${append ? "?append=true" : ""}`, attachment)) !== null;
     }
     async content(id, index) {
-        const r = await ofetch.raw(`${this.base}${this.tasks}/${encodeURIComponent(id)}/attachment/${index}/content`, {
+        const r = await dispatchFetch.raw(`${this.base}${this.tasks}/${encodeURIComponent(id)}/attachment/${index}/content`, {
             headers: { Authorization: `Bearer ${this.token}` },
             responseType: "arrayBuffer",
             dispatcher: this.dispatcher,

package/dst/ase-task-store-plugin-gitea.js

@@ -3,7 +3,7 @@
 **  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under Apache 2.0 <https://spdx.org/licenses/Apache-2.0>
 */
-import { giteaApi } from "gitea-js";
+import { giteaApi, ContentType } from "gitea-js";
 import { LRUCache } from "lru-cache";
 import * as TaskFormat from "./ase-task-format.js";
 import * as TaskIssues from "./ase-task-store-issues.js";
@@ -396,7 +396,7 @@ class GiteaTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
         for (const blocker of after) {
             if (have.has(blocker.number))
                 continue;
-            await this.call(loc, this.gt.repos.issueCreateIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker)))
+            await this.call(loc, this.gt.repos.issueCreateIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker), { type: ContentType.Json }))
                 .catch((err) => {
                 if (statusOf(err) === 404)
                     throw new Error(`Gitea rejected the dependency of issue #${issue.number} on issue #${blocker.number} ` +
@@ -406,7 +406,7 @@ class GiteaTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
         }
         for (const blocker of current)
             if (!want.has(blocker.number))
-                await found(this.call(loc, this.gt.repos.issueRemoveIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker))));
+                await found(this.call(loc, this.gt.repos.issueRemoveIssueDependencies(loc.owner, loc.repo, String(issue.number), meta(blocker), { type: ContentType.Json })));
     }
     /*  synchronize the comments with the attachments, touching changed ones only
         (see the common issue tracker parts)  */

package/dst/man/ase-agent-adhoc.md

@@ -19,6 +19,7 @@
 \[`--lifecycle` *model*\]
 \[`--serial`\]
 \[`--unclaimed`\]
+\[`-M`|`--model` *model*\]
 \[`--params` *name*`=`*value*\]
 \[`--state-`*item* *state*\]
 \[`--tag-`*item* *tag*\]
@@ -169,12 +170,12 @@ tags (except the request state tag) and, by default, gets its previous
 assignee back. An agent consumes the request prompts if its prompt
 template references `{prompt}` (except within the conditional
 `{?prompt:`*text*`}` only, which makes the prompt *optional*) or it
-has a hook `prepare`, `prompt`, or `finish` (which receive the request
-prompt in their *job*), where it then refuses a request with an empty
-prompt as failed, else it accepts requests with an empty prompt (which
-an agent with an optional prompt still passes on if non-empty), and
-announces this to the agent relay, so the task boards accept an empty
-prompt for its requests, too.
+has a hook `prepare`, `prompt`, `model`, or `finish` (which receive
+the request prompt in their *job*), where it then refuses a request
+with an empty prompt as failed, else it accepts requests with an empty
+prompt (which an agent with an optional prompt still passes on if
+non-empty), and announces this to the agent relay, so the task boards
+accept an empty prompt for its requests, too.
 
 Only the prompt (and `--state-incoming` for `--type phase`) is
 mandatory, while all other options default to the safe *annotate*
@@ -431,6 +432,16 @@ and `--prompt-skill` with `--prompt-args`, and `--tag-retry` and
   `passes`, and `--workdir changeset` resp. `target` (as the task can
   be claimed by another agent meanwhile).
 
+- \[`-M`|`--model` *model*\]:
+  The model of the agent tool, passed to it as `--model` *model*
+  verbatim (e.g., an alias like `sonnet` or a full model name), either a
+  *model* for all tasks, or comma-separated *size*`=`*model* pairs per
+  `Effort:` size of the task (`XS`, `S`, `M`, `L`, `XL`, or `*` for all
+  other tasks, e.g., `XS=haiku,S=haiku,M=sonnet,*=opus`), where a task
+  without a matching pair gets the default model of the agent tool (the
+  default for all tasks). The hook `model` can override it per task (see
+  **HOOKS**).
+
 - \[`--params` *name*`=`*value*\]:
   (repeatable) The value of the parameter *name* declared by the
   definition (see **PARAMETERS**), where a later value of the same
@@ -986,6 +997,14 @@ invocation:
   `{ text }`, a plain prompt text, or `undefined` to keep the
   configured one, where a thrown error fails the processing.
 
+- `model(task, model, job, ctx)`:
+  The model of the agent tool for the job, given the configured *model*
+  of `--model` for the `Effort:` size of the task (empty for the default
+  model of the agent tool): a model (empty for the default one), or
+  `undefined` to keep the configured one, where a thrown error fails the
+  processing. This allows choosing the model per task by any means,
+  e.g., by asking a cheap model via `ctx.exec`.
+
 - `verdict(task, result, ctx)`:
   (after a successful agent tool only) The verdict of the result (an
   upper-case word, accepted only if listed by `--verdict-allow`), an

package/dst/man/ase-agent-condenser.md

@@ -9,6 +9,7 @@
 \[`-T`|`--timeout` *duration*\]
 \[`-o`|`--one-shot`\]
 \[`--agent-relay` *url*\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -145,6 +146,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the condenser
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-editor.md

@@ -11,6 +11,7 @@
 \[`--agent-relay` *url*\]
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -192,6 +193,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the editor is
       of type `request`.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-estimator.md

@@ -10,6 +10,7 @@
 \[`-o`|`--one-shot`\]
 \[`--agent-relay` *url*\]
 \[`-m`|`--mode` `phase`|`request`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -204,6 +205,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: enabled (mode `phase`) resp. not set
       (mode `request`).
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-fleet.md

@@ -79,7 +79,7 @@ members) or `ase agent fleet stop`.
   (with all its options commented out, so they fall back to
   `project.relay.url`, `project.relay.crt`, and `project.relay.key`),
   the section `default` (with `tool`, `parallel: 1`, and `timeout: 60m`,
-  plus `repo` and `tempdir` commented out), the edit request agent
+  plus `model`, `repo`, and `tempdir` commented out), the edit request agent
   `editor`, the effort estimation agent `estimator` (mode `phase`,
   estimating the planned tasks, i.e., the `OPEN` tasks for `solo`, the
   `PLANNING` tasks for `team`, and the `PLANNED` tasks for `enterprise`,
@@ -201,8 +201,9 @@ value omits an option, and a list repeats an option:
   `project.relay.url` selecting HTTPS requires both.
 
 - `default`:
-  (optional) The default options of all agents: `tool`, `parallel`,
-  `timeout`, `repo`, `tempdir`, and `agent-relay` (see `ase-agent`(1)),
+  (optional) The default options of all agents: `tool`, `model`,
+  `parallel`, `timeout`, `repo`, `tempdir`, and `agent-relay` (see
+  `ase-agent`(1) and `ase-agent-adhoc`(1)),
   each one applied only to the agents supporting it (e.g., `repo` not to
   `rebooter`), and overridden by the section of an agent. The option
   `agent-relay` is not allowed together with the section `relay`.
@@ -315,7 +316,8 @@ $ ase agent fleet stop
 ```
 
 A configuration `.ase/fleet.yaml` with the agent relay, the built-in
-agents, two editors of different agent tools, an agent of the
+agents (with an implementer using cheaper models for smaller tasks),
+two editors of different agent tools, an agent of the
 definition file `.ase/agents/reviewer.mts`, and an ad-hoc request
 agent:
 
@@ -329,6 +331,7 @@ default:
 rebooter:
 implementer:
     parallel: 2
+    model:    XS=haiku,S=haiku,*=sonnet
 editor-claude:
     kind:     editor
 editor-codex:

package/dst/man/ase-agent-implementer.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `implement`|`draft`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -260,6 +261,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the implementer
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: `effort-wait`
       (`true` or `false`, default: `true`), whether to wait for the

package/dst/man/ase-agent-integrator.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `merge`|`rebase`|`squash`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -206,6 +207,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the integrator
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-qualifier.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `judge`|`qualify`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -187,6 +188,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the qualifier
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-rebooter.md

@@ -9,6 +9,7 @@
 \[`-T`|`--timeout` *duration*\]
 \[`-o`|`--one-shot`\]
 \[`--agent-relay` *url*\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -145,6 +146,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
       (`phase` only). Built-in: not set. Not allowed, as the rebooter
       claims the tasks into its activity state.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-agent-researcher.md

@@ -12,6 +12,7 @@
 \[`-r`|`--repo` *url*\]
 \[`-d`|`--tempdir` *dir*\]
 \[`-m`|`--mode` `phase`|`request`\]
+\[`-M`|`--model` *model*\]
 \[`--`*group*`-`*item* *value* \[...\]\]
 \[`-f`|`--foreground`\]
 
@@ -246,6 +247,12 @@ All other options belong to the sub-commands (see **COMMANDS**).
     - \[`--unclaimed`\]: Process the tasks of the incoming states
       without claiming them (`phase` only). Built-in: not set.
 
+    - \[`-M`|`--model` *model*\]: The model of the agent tool: a model
+      for all tasks, or comma-separated *size*`=`*model* pairs per
+      `Effort:` size (`XS`, `S`, `M`, `L`, `XL`, or `*` for all other
+      tasks), see `ase-agent-adhoc`(1). Generic default: the default
+      model of the agent tool. Built-in: none.
+
     - \[`--params` *name*`=`*value*\]: The value of a parameter
       declared by the definition (repeatable). Built-in: none declared.
 

package/dst/man/ase-config-init.md

@@ -63,7 +63,8 @@ file lock and atomically.
       `project.task.effort.line` `0.025`,
       `project.task.effort.iteration` `2.5`, the full set of
       `project.artifact.*` globs, the `board.tui.color.*`,
-      `board.web.color.*`, and `board.web.editor.keymap` defaults, and
+      `board.web.color.*`, `board.web.editor.keymap`, and
+      `board.web.theme` defaults, and
       `telemetry.enabled` `false`, `telemetry.prices.ai`
       `*=4.00/20.00/0.20/5.00`, and `telemetry.prices.hr` `*=110`.
     - `vibe`:

package/dst/man/ase-config.md

@@ -361,6 +361,11 @@ Task board (all writable on the `user` and `project` scopes only, see
   The key bindings of the task plan editor of the web board (default:
   `default`).
 
+- `board.web.theme` (`auto`, `light`, or `dark`):
+  The color theme of the web board, where `auto` follows the light or
+  dark preference of the operating system resp. browser (default:
+  `auto`).
+
 ## ENVIRONMENT
 
 - `EDITOR`, `VISUAL`:

package/dst/man/ase-task-board.md

@@ -7,6 +7,7 @@
 \[`-w`|`--web`\]
 \[`-t`|`--text`\]
 \[`--agent-relay` *url*\]
+\[`-T`|`--task` *id*\]
 
 ## DESCRIPTION
 
@@ -89,6 +90,11 @@ set snapshot `kind="changeset"` of the `implementer` and `integrator`
 agents) is colored per line, YAML and JSON data are syntax-highlighted,
 and a change set snapshot older than the plan is marked `(stale)`.
 
+While the task dialog is open, the last change of the shown plan is displayed
+as a diff in the plan tab, with the removed and added lines colored (in the
+terminal board also signed) and their changed words shown inverse, until `#` clears it or a next change
+replaces it. Closing the task dialog or switching to another task drops it.
+
 A task is moved into another state (changing its `Status:`) either by
 picking it up with `SPACE` and dropping it with a second `SPACE` onto
 the selected lane (only lanes whose state is reachable from the current
@@ -214,6 +220,26 @@ waiting) with their status and their last processing log line, and
 finally all warnings of the board (behind `⚠`, e.g. on dependency
 cycles).
 
+### Task Viewer
+
+With `--task`, the terminal and the web board act as a *task viewer*:
+instead of the board, they show only the task dialog of the given task,
+spanning the entire window and following all changes of the task live.
+All actions of the task dialog stay available, and a click onto a
+predecessor or successor shows that task instead. The shown view of the
+board stays untouched. An unknown task is refused with an error.
+
+The terminal board quits on `q` or `Ctrl`+`C` only, and with a warning
+once the shown task no longer exists (e.g. as it was deleted or renamed
+elsewhere).
+
+The web board has no closing keys, as a page cannot close its browser
+tab. Once the shown task no longer exists, it shows only a notice, and
+shows the task again as soon as it exists again.
+
+With `--text`, and also without an interactive terminal, the plan of the
+task is printed as plain text and the command exits.
+
 ### Statistics View
 
 The third view *statistics* shows the statistics of the tasks matching the
@@ -410,6 +436,10 @@ relay, the agent graph view is skipped.
   board always follows the configured `project.relay.url` (and hence
   warns about the option).
 
+- \[`-T`|`--task` *id*\]:
+  Show only the task dialog of the task *id* instead of the board, as a
+  viewer and watcher of the task (see **Task Viewer**).
+
 ## KEYS
 
 The following keys are supported by the terminal board (and, unless
@@ -426,6 +456,9 @@ letter under the kitty keyboard protocol.
   views).
 - `?`: Hide or show the key hint lines (persisted); while hidden, the
   information line ends with `?: show key hints`.
+- `L`: Cycle the color theme through `auto`, `light`, and `dark`,
+  overriding `board.web.theme` in the current browser until cycled back
+  to its value (web board only).
 - `D`: Delete the selected task, after a confirmation (not in the
   agent logs and statistics views).
 - `T`: Transfer the selected task to another state via the transfer
@@ -515,7 +548,8 @@ letter under the kitty keyboard protocol.
 - `↑`/`↓`: Scroll the content.
 - `PgUp`/`PgDn`: Scroll the content by one page.
 - `e`: Edit the task plan.
-- `D`, `T`, `A`, `E`, `R`, `M`: As in every view.
+- `#`: Clear the diff of the last change of the task plan.
+- `D`, `T`, `A`, `E`, `R`, `M`, `L`: As in every view.
 - `⏎`, `ESC`: Close the task dialog.
 
 ### Filter Field
@@ -594,6 +628,11 @@ The following configuration keys (on scope `user` or `project`, see
   The key bindings of the task plan editor of the web board: `default`,
   `vim`, or `emacs` (default: `default`).
 
+- `board.web.theme`:
+  The color theme of the web board: `light`, `dark`, or `auto`, which
+  follows the light or dark preference of the operating system resp.
+  browser (default: `auto`).
+
 - `project.relay.url`:
   The default agent relay of the boards (see `--agent-relay`).
 
@@ -625,7 +664,7 @@ The following configuration keys (on scope `user` or `project`, see
 The command exits with status `0` once the terminal board is quit, the
 text overview is printed, resp. the web board is opened, and with
 status `1` on any error (e.g. an *ASE* service without web board on
-`--web`).
+`--web`, or an unknown task on `--task`).
 
 ## EXAMPLES
 
@@ -636,6 +675,9 @@ $ ase task board
 # show the web board in the browser
 $ ase task board --web
 
+# view and watch a single task in the terminal
+$ ase task board --task T1
+
 # print the lane overview, including the agents of a remote agent relay
 $ ase task board --text --agent-relay ase://relay.example.com:42043
 ```