@ai-setting/roy-plugin-task-show 0.8.10 → 0.9.6

package/dist/task-session-store.js

@@ -0,0 +1,177 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { TracedAs, withTraceSync } from "./tracing/decorator.js";
+import { formatTaskMetadata } from "./task-metadata.js";
+export class TaskSessionStore {
+    opts;
+    latestLeafId = null;
+    constructor(opts) {
+        this.opts = {
+            sessionStartedAt: opts.sessionStartedAt,
+            maxAncestors: opts.maxAncestors ?? 32,
+            listTasks: opts.listTasks,
+            taskFetcher: opts.taskFetcher ?? (async () => null),
+        };
+    }
+    /**
+     * Returns the id of the most recently recorded leaf task in this session,
+     * or undefined if no task has been recorded yet. The v0.9.0 home page
+     * highlights this task with a `data-leaf="1"` attribute.
+     */
+    getLatestLeafId() {
+        return this.latestLeafId ?? undefined;
+    }
+    /**
+     * Record a leaf task id (called by the host plugin as new tasks appear).
+     * Idempotent — only the most recent call wins.
+     */
+    recordLeaf(taskId) {
+        this.latestLeafId = taskId;
+    }
+    async buildSessionForest() {
+        const cutoff = Date.parse(this.opts.sessionStartedAt);
+        const raw = await this.opts.listTasks({ sinceIso: this.opts.sessionStartedAt });
+        const tasks = raw.filter((t) => {
+            const ts = Date.parse(t.createdAt);
+            return Number.isFinite(ts) && ts >= cutoff;
+        });
+        const byId = new Map();
+        for (const t of tasks)
+            byId.set(t.id, t);
+        const children = new Map();
+        for (const t of tasks) {
+            if (t.parent_task_id === undefined || t.parent_task_id === null)
+                continue;
+            const arr = children.get(t.parent_task_id) ?? [];
+            arr.push(t);
+            children.set(t.parent_task_id, arr);
+        }
+        // v0.9.0: bounded BFS for external ancestors. For every in-session
+        // task whose parent is not in `byId`, BFS up the parent chain,
+        // fetching each ancestor through `taskFetcher` and inserting it
+        // (deduplicated) into `byId` and `children` until we run out of
+        // ancestors or hit `maxAncestors`.
+        const maxAncestors = this.opts.maxAncestors;
+        let fetchedAncestors = 0;
+        // FIFO queue of parent_ids we still need to look up.
+        const queue = [];
+        const queued = new Set();
+        for (const t of tasks) {
+            if (t.parent_task_id === undefined || t.parent_task_id === null)
+                continue;
+            if (byId.has(t.parent_task_id))
+                continue;
+            if (queued.has(t.parent_task_id))
+                continue;
+            queue.push(t.parent_task_id);
+            queued.add(t.parent_task_id);
+        }
+        while (queue.length > 0 && fetchedAncestors < maxAncestors) {
+            const id = queue.shift();
+            const fetched = await this.opts.taskFetcher(id);
+            if (!fetched)
+                continue;
+            byId.set(fetched.id, fetched);
+            fetchedAncestors += 1;
+            // Index as a child of its own parent (so the tree walks correctly).
+            if (fetched.parent_task_id !== undefined && fetched.parent_task_id !== null) {
+                const arr = children.get(fetched.parent_task_id) ?? [];
+                arr.push(fetched);
+                children.set(fetched.parent_task_id, arr);
+                if (!byId.has(fetched.parent_task_id) && !queued.has(fetched.parent_task_id) && fetchedAncestors + queue.length < maxAncestors) {
+                    queue.push(fetched.parent_task_id);
+                    queued.add(fetched.parent_task_id);
+                }
+            }
+        }
+        // Assemble roots: any task (in-session or fetched) whose parent is
+        // not present in byId becomes a root.
+        const roots = [];
+        for (const t of byId.values()) {
+            if (t.parent_task_id === undefined || t.parent_task_id === null || !byId.has(t.parent_task_id)) {
+                roots.push(t);
+            }
+        }
+        const buildChildren = (parentId, depth = 0) => {
+            const arr = children.get(parentId) ?? [];
+            const out = [];
+            for (const t of arr) {
+                if (depth > maxAncestors + 4)
+                    break; // hard ceiling for defensive recursion
+                out.push({ task: t, children: buildChildren(t.id, depth + 1) });
+            }
+            out.sort((a, b) => a.task.id - b.task.id);
+            return out;
+        };
+        return roots
+            .sort((a, b) => a.id - b.id)
+            .map((t) => ({ task: t, children: buildChildren(t.id, 0) }));
+    }
+}
+__decorate([
+    TracedAs("session.forest.build", { recordParams: false, recordResult: false })
+], TaskSessionStore.prototype, "buildSessionForest", null);
+function esc(s) {
+    const str = s === undefined || s === null ? "" : String(s);
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+export function renderSessionForestPage(args) {
+    return withTraceSync("html.session-forest.render", () => _renderSessionForestPageImpl(args));
+}
+function _renderSessionForestPageImpl(args) {
+    const rows = [];
+    const walk = (node, depth) => {
+        const t = node.task;
+        const checked = t.id === args.leafTaskId ? ' data-leaf="1"' : "";
+        rows.push(`<li class="session-row" data-depth="${depth}"${checked}>
+  <a class="session-title" href="/task/${t.id}">#${t.id} ${esc(t.title)}</a>
+  <button type="button" class="session-toggle" data-toggle="${t.id}">显示全部栏位</button>
+  <details class="session-details" data-details="${t.id}">
+    <summary>metadata</summary>
+    <dl>
+      <dt>project_path</dt><dd>${esc(t.project_path)}</dd>
+      <dt>context</dt><dd><pre class="metadata-json">${esc(formatTaskMetadata(t.context))}</pre></dd>
+      <dt>description</dt><dd>${esc(t.description)}</dd>
+      <dt>goals</dt><dd><pre class="metadata-text">${esc(formatTaskMetadata(t.goals_and_expected_deliverables))}</pre></dd>
+      <dt>tags</dt><dd>${esc((t.tags ?? []).join(", "))}</dd>
+      <dt>createdAt</dt><dd>${esc(t.createdAt)}</dd>
+      <dt>updatedAt</dt><dd>${esc(t.updatedAt)}</dd>
+    </dl>
+  </details>
+  <ul class="session-operations" data-task-operations="${t.id}"></ul>
+</li>`);
+        for (const child of node.children)
+            walk(child, depth + 1);
+    };
+    for (const node of args.forest)
+        walk(node, 0);
+    const forestHtml = `<section class="session-forest" data-session-forest="1"><h2>本会话任务</h2><ul>${rows.join("")}</ul></section>`;
+    return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>roy-plugin-task-show · session forest</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body data-live-refresh data-view="session-forest">
+  <header class="topbar">
+    <h1>🌳 roy-plugin-task-show · 本会话任务</h1>
+    <p class="meta">只显示插件加载后创建的任务及其必要祖先；展开每行可查看完整 metadata。</p>
+  </header>
+  ${forestHtml}
+  <script src="/static/task-operations.js"></script>
+  <script src="/static/session-forest.js"></script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=task-session-store.js.map

package/dist/task-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-session-store.js","sourceRoot":"","sources":["../src/task-session-store.ts"],"names":[],"mappings":"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"}

package/dist/tracing/decorator.d.ts

@@ -0,0 +1,48 @@
+export interface TracedAsOptions {
+    recordParams?: boolean;
+    recordResult?: boolean;
+    recordError?: boolean;
+}
+/**
+ * @TracedAs(name, options) decorator factory.
+ *
+ * Usage:
+ *   @TracedAs("server.home.render", { recordParams: false, recordResult: false })
+ *   private async sendIndex(res: http.ServerResponse): Promise<void> { ... }
+ *
+ * If the spans.db is unreachable (no host, no env, schema mismatch),
+ * the decorator becomes a transparent passthrough — the wrapped
+ * function is called with its original `this` and arguments.
+ */
+export declare function TracedAs(name: string, _options?: TracedAsOptions): <T extends (...args: any[]) => any>(_target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * For tests: reset the module-level db cache so test fixtures
+ * can simulate a fresh host install. Not used in production.
+ */
+export declare function __resetTracedAsCacheForTests(): void;
+/**
+ * For tests: returns the resolved spans.db path or null. Allows
+ * tests to assert the decorator located the host DB.
+ */
+export declare function __getResolvedSpansDbPathForTests(): string | null;
+/**
+ * Ensure the parent dir of a candidate spans.db path exists
+ * (used by tests that point at a temp file). Best-effort.
+ */
+export declare function __ensureSpansDbDirForTests(path: string): void;
+/**
+ * `withTrace(name, fn)` — manual instrumentation helper for free
+ * functions (which TS decorators cannot decorate). Runs `fn` and
+ * records a span around the invocation. Mirrors the @TracedAs
+ * contract: never throws, no-ops when spans.db is unavailable.
+ *
+ * Used by `renderSessionForestPage` and `encodeMermaidLabelText`
+ * (top-level exports that cannot carry a class-method decorator).
+ */
+export declare function withTrace<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+/**
+ * Synchronous variant of `withTrace`. Used for top-level
+ * non-async exports.
+ */
+export declare function withTraceSync<T>(name: string, fn: () => T): T;
+//# sourceMappingURL=decorator.d.ts.map

package/dist/tracing/decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../../src/tracing/decorator.ts"],"names":[],"mappings":"AAqDA,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA8HD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,IAC9C,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChD,SAAS,GAAG,EACZ,aAAa,MAAM,EACnB,YAAY,uBAAuB,CAAC,CAAC,CAAC,KACrC,uBAAuB,CAAC,CAAC,CAAC,CAyD9B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAUnD;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAEhE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM7D;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAgB7D"}

package/dist/tracing/decorator.js

@@ -0,0 +1,310 @@
+/**
+ * @fileoverview @TracedAs decorator stub for the roy-plugin-task-show v0.9.0.
+ *
+ * The plugin is a standalone npm package with `dependencies: {}`, so it
+ * cannot import the host's `roy-agent-core` tracing module statically.
+ * This module provides a minimal local `@TracedAs(name, options)`
+ * decorator that:
+ *
+ *   1. At module load, locates a writable `spans.db` (SQLite) using:
+ *        a. `process.env.ROY_TRACE_DB` if set
+ *        b. `~/.config/roy-agent/spans.db` (host default)
+ *      If none of these resolve to a writable file, the decorator
+ *      degrades to a no-op that just calls the wrapped function.
+ *
+ *   2. Wraps the target method so that every invocation writes a
+ *      single row to the `spans` table mirroring the host's
+ *      OpenTelemetry-compatible schema:
+ *
+ *         trace_id       (16 bytes hex)
+ *         span_id        (8 bytes hex, unique per row)
+ *         parent_span_id (always NULL for top-level spans)
+ *         name           (the span_name passed to @TracedAs)
+ *         kind           (always "internal")
+ *         status         ("ok" or "error")
+ *         start_time     (Unix epoch ms)
+ *         end_time       (Unix epoch ms)
+ *         duration_ms    (end - start)
+ *         created_at     (now)
+ *
+ *      If the DB write throws (locked, missing schema, permission
+ *      denied), the error is swallowed — the decorator must never
+ *      break the wrapped function. This is critical for tests,
+ *      CI, and any environment where the host spans.db is absent.
+ *
+ *   3. Generates a process-lifetime `trace_id` (16 bytes hex) at
+ *      module init. The host's spans.db queries by `name`, so a
+ *      shared trace_id is sufficient.
+ *
+ * The plugin runs in the Bun runtime (declared in `package.json
+ * engines.bun`), so we use `bun:sqlite` for the writer. If Bun is
+ * not available, the decorator degrades to no-op (tests don't
+ * need to write spans to pass).
+ *
+ * Why not import from `@ai-setting/roy-agent-core`? See the
+ * plan doc §3.1 / review op #20182: keeping the plugin zero-dep
+ * is a hard contract. A 90-line local stub is cheaper than
+ * carrying a runtime dep that may not exist in every install
+ * target (e.g. the plugin's own test suite).
+ */
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+let cachedDb = null;
+let resolvedSpansDbPath = null;
+/**
+ * Process-lifetime trace_id (16 random bytes hex). The host's
+ * trace_check queries spans by `name`, so a single trace_id per
+ * process is sufficient and matches the host's per-process model.
+ */
+const PROCESS_TRACE_ID = (() => {
+    const bytes = new Uint8Array(16);
+    const c = globalThis.crypto;
+    if (c && typeof c.getRandomValues === "function") {
+        c.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i += 1)
+            bytes[i] = Math.floor(Math.random() * 256);
+    }
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+})();
+/**
+ * Generate a unique 8-byte hex span_id per call.
+ */
+function newSpanId() {
+    const bytes = new Uint8Array(8);
+    const c = globalThis.crypto;
+    if (c && typeof c.getRandomValues === "function") {
+        c.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i += 1)
+            bytes[i] = Math.floor(Math.random() * 256);
+    }
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+/**
+ * Locate the spans.db path. Returns null if no candidate exists
+ * or is writable. The lookup is cached after the first successful
+ * resolution.
+ */
+function resolveSpansDbPath() {
+    if (resolvedSpansDbPath !== null)
+        return resolvedSpansDbPath;
+    const candidates = [];
+    if (process.env.ROY_TRACE_DB)
+        candidates.push(process.env.ROY_TRACE_DB);
+    if (process.env.ROY_AGENT_DATA) {
+        candidates.push(join(process.env.ROY_AGENT_DATA, "spans.db"));
+    }
+    candidates.push(join(homedir(), ".config", "roy-agent", "spans.db"));
+    for (const c of candidates) {
+        if (c && existsSync(c)) {
+            resolvedSpansDbPath = c;
+            return c;
+        }
+    }
+    return null;
+}
+/**
+ * Lazily open the spans.db. Returns null if Bun is not available,
+ * the file cannot be opened, or the `spans` table does not exist.
+ */
+function getDb() {
+    if (cachedDb)
+        return cachedDb;
+    if (typeof globalThis.Bun === "undefined")
+        return null;
+    const path = resolveSpansDbPath();
+    if (!path)
+        return null;
+    try {
+        const { Database } = require("bun:sqlite");
+        const db = new Database(path);
+        try {
+            db.exec("SELECT 1 FROM span LIMIT 0");
+        }
+        catch {
+            db.close();
+            return null;
+        }
+        cachedDb = db;
+        return cachedDb;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a single span row. Never throws — decorator must not
+ * break the wrapped function.
+ */
+function writeSpan(row) {
+    const db = getDb();
+    if (!db)
+        return;
+    const spanId = newSpanId();
+    const durationMs = row.endTime - row.startTime;
+    try {
+        db.prepare(`INSERT INTO span (trace_id, span_id, parent_span_id, name, kind, status, start_time, end_time, attributes, time_created)
+       VALUES (?, ?, NULL, ?, 'internal', ?, ?, ?, ?, ?)`).run(PROCESS_TRACE_ID, spanId, row.name, row.status, row.startTime, row.endTime, JSON.stringify({ duration_ms: durationMs, ...(row.errorMessage ? { error: row.errorMessage } : {}) }), Date.now());
+    }
+    catch {
+        // Swallow — see file header.
+    }
+}
+/**
+ * @TracedAs(name, options) decorator factory.
+ *
+ * Usage:
+ *   @TracedAs("server.home.render", { recordParams: false, recordResult: false })
+ *   private async sendIndex(res: http.ServerResponse): Promise<void> { ... }
+ *
+ * If the spans.db is unreachable (no host, no env, schema mismatch),
+ * the decorator becomes a transparent passthrough — the wrapped
+ * function is called with its original `this` and arguments.
+ */
+export function TracedAs(name, _options) {
+    return function (_target, propertyKey, descriptor) {
+        const originalFn = descriptor.value;
+        if (!originalFn)
+            return descriptor;
+        const spanName = name || propertyKey;
+        const wrapped = function (...args) {
+            const startTime = Date.now();
+            let result;
+            try {
+                result = originalFn.apply(this, args);
+            }
+            catch (err) {
+                const endTime = Date.now();
+                writeSpan({
+                    name: spanName,
+                    status: "error",
+                    startTime,
+                    endTime,
+                    errorMessage: err instanceof Error ? err.message : String(err),
+                });
+                throw err;
+            }
+            if (result && typeof result.then === "function") {
+                return Promise.resolve(result).then((value) => {
+                    writeSpan({
+                        name: spanName,
+                        status: "ok",
+                        startTime,
+                        endTime: Date.now(),
+                    });
+                    return value;
+                }, (err) => {
+                    writeSpan({
+                        name: spanName,
+                        status: "error",
+                        startTime,
+                        endTime: Date.now(),
+                        errorMessage: err instanceof Error ? err.message : String(err),
+                    });
+                    throw err;
+                });
+            }
+            writeSpan({
+                name: spanName,
+                status: "ok",
+                startTime,
+                endTime: Date.now(),
+            });
+            return result;
+        };
+        wrapped.__tracedAsName = spanName;
+        return {
+            ...descriptor,
+            value: wrapped,
+        };
+    };
+}
+/**
+ * For tests: reset the module-level db cache so test fixtures
+ * can simulate a fresh host install. Not used in production.
+ */
+export function __resetTracedAsCacheForTests() {
+    if (cachedDb) {
+        try {
+            cachedDb.close();
+        }
+        catch {
+            // ignore
+        }
+    }
+    cachedDb = null;
+    resolvedSpansDbPath = null;
+}
+/**
+ * For tests: returns the resolved spans.db path or null. Allows
+ * tests to assert the decorator located the host DB.
+ */
+export function __getResolvedSpansDbPathForTests() {
+    return resolveSpansDbPath();
+}
+/**
+ * Ensure the parent dir of a candidate spans.db path exists
+ * (used by tests that point at a temp file). Best-effort.
+ */
+export function __ensureSpansDbDirForTests(path) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * `withTrace(name, fn)` — manual instrumentation helper for free
+ * functions (which TS decorators cannot decorate). Runs `fn` and
+ * records a span around the invocation. Mirrors the @TracedAs
+ * contract: never throws, no-ops when spans.db is unavailable.
+ *
+ * Used by `renderSessionForestPage` and `encodeMermaidLabelText`
+ * (top-level exports that cannot carry a class-method decorator).
+ */
+export async function withTrace(name, fn) {
+    const startTime = Date.now();
+    try {
+        const result = await fn();
+        writeSpan({ name, status: "ok", startTime, endTime: Date.now() });
+        return result;
+    }
+    catch (err) {
+        writeSpan({
+            name,
+            status: "error",
+            startTime,
+            endTime: Date.now(),
+            errorMessage: err instanceof Error ? err.message : String(err),
+        });
+        throw err;
+    }
+}
+/**
+ * Synchronous variant of `withTrace`. Used for top-level
+ * non-async exports.
+ */
+export function withTraceSync(name, fn) {
+    const startTime = Date.now();
+    try {
+        const result = fn();
+        writeSpan({ name, status: "ok", startTime, endTime: Date.now() });
+        return result;
+    }
+    catch (err) {
+        writeSpan({
+            name,
+            status: "error",
+            startTime,
+            endTime: Date.now(),
+            errorMessage: err instanceof Error ? err.message : String(err),
+        });
+        throw err;
+    }
+}
+//# sourceMappingURL=decorator.js.map

package/dist/tracing/decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.js","sourceRoot":"","sources":["../../src/tracing/decorator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-plugin-task-show",
-  "version": "0.8.10",
+  "version": "0.9.6",
   "description": "roy-agent plugin: visualize task solving process via tool call flow on a local web service",
   "type": "module",
   "main": "dist/index.js",

package/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "@ai-setting/roy-plugin-task-show",
-  "version": "0.8.10",
+  "version": "0.9.6",
   "type": "tool-plugin",
-  "description": "Visualize the tool call chain of a task on a local web service with real-time SSE updates. v0.5.0+: page refreshes stream over GET /api/events (Server-Sent Events). Subscribes to tool:before.execute, tool:after.execute, task:before.create, task:after.create, task:after.complete (preferred, 2026-07-10+), and task:after.update (legacy fallback). v0.6.11: Mermaid re-rendering is delegated to a self-contained controller (public/mermaid-renderer.js) that prevents the SVG→raw-source regression on async updates and surfaces recoverable .mermaid-error states. v0.6.12: Task lifecycle pipeline (operations timeline) server now emits data-task-id on the pipeline section; client preserves it on swap, so the page actually fetches /api/tasks/<id>/operations and renders the 7-op timeline (previously silently bailed). v0.7.0: Home page redesigned as a hierarchical task tree (driven by `roy-agent tasks tree --json`); new /api/tasks/tree endpoint with status / priority / type / root-id filters, expand/collapse UI, search, and live 30s polling. v0.8.0: per-task page Mermaid area now renders the hierarchical 'Task lifecycle + tools' view — each operation record owns a subgraph that nests its tool calls, with click callbacks (`window.__toolClick`) that scroll-into-view + highlight + auto-expand the matching row in the tool-call table below. Operation record descriptions (`description` + `processDescription`) are now always rendered inline (no `<details>` collapse) so the user sees the lifecycle state at a glance; a fallback `<details>` kicks in only for descriptions longer than 600 chars. v0.8.1: hotfix for two pre-existing bugs in v0.8.0 (browser smoke test surfaced after merge). (a) Mermaid click directives were emitted as `click t1 __toolClick(1)` (missing `call` keyword) — Mermaid 10's parser rejects this with `got 'PS'`. Fixed to `click t1 call __toolClick(1)` (the v10 grammar requires `call` to invoke a callback with arguments). (b) `buildMermaidSource` lived inside the `attachTaskPageTimeline` IIFE but was also called from a listener in the `attachToolClickBridge` IIFE — sibling IIFEs cannot see each other's locals, so the listener threw `ReferenceError: buildMermaidSource is not defined` and the Mermaid diagram silently failed to re-render after `task-show:lifecycle-ops-loaded`. Fixed by hoisting the function (and its three helpers) to script top-level so both IIFEs can see it via the script-wide closure; the function is also exposed on `window.buildMermaidSource` for tests + tooling. v0.8.3: tree-display fix (Task #2426). The home page used to look like a flat list of root tasks because `autoExpandFirstLevels(..., 2)` only opened the first 2 levels — 30/47 roots were leaf nodes and the remaining 17 collapsed to one level so grandchildren were never visible. Default expand depth is now 3 (root + child + grandchild + great-grandchild are visible on first paint), the summary line now shows per-depth count pills (root / child / grandchild / great-grandchild / level-N), each `tree-row` carries a `data-depth` attribute so CSS can paint coloured left rails per level, and the duplicated 'Live tool-call sessions (legacy view)' panel that made the page look like both a flat table AND a tree is now hidden behind `#legacy-sessions[hidden]` (kept for future debug-toggle restoration). v0.8.10: bug-fix release (Task #2537 + Task #2534). (a) Heap-bounded plugin caches: OperationsCache and TasksTreeCache now enforce a hard maxEntries cap (default 256 / 64). Oldest stale entries are evicted before inserting a new one, so long-lived roy-agent sessions (BackgroundTaskManager + MemorySessionStore) no longer leak Map entries through the plugin's per-task caches — see Task #2537 for the heap-unbounded-state RED→GREEN repro. (b) Mermaid CJK font-family: server.ts renderTaskPage now configures mermaid.initialize({ themeVariables: { fontFamily: '\"PingFang SC\", \"Microsoft YaHei\", \"Noto Sans CJK SC\", \"Source Han Sans CN\", \"WenQuanYi Micro Hei\", sans-serif' } }) so Chinese node labels render correctly in browsers that have at least one of those fonts installed (see Task #2534).",
+  "description": "Visualize the tool call chain of a task on a local web service with real-time SSE updates. v0.9.0: Session-scoped home page (only show tasks created after plugin load + their external ancestors), with per-row 「显示全部栏位」 toggle and lazy-loaded operations timeline; per-task Mermaid labels now correctly render CJK / mixed-Latin / emoji text (encoded as \\uXXXX before emission, decoded by the browser); detail page layout reordered to lifecycle → pipeline → stats → toolcalls → rawjson. v0.5.0+: page refreshes stream over GET /api/events (Server-Sent Events). Subscribes to tool:before.execute, tool:after.execute, task:before.create, task:after.create, task:after.complete (preferred, 2026-07-10+), and task:after.update (legacy fallback). v0.6.11: Mermaid re-rendering is delegated to a self-contained controller (public/mermaid-renderer.js) that prevents the SVG→raw-source regression on async updates and surfaces recoverable .mermaid-error states. v0.6.12: Task lifecycle pipeline (operations timeline) server now emits data-task-id on the pipeline section; client preserves it on swap, so the page actually fetches /api/tasks/<id>/operations and renders the 7-op timeline (previously silently bailed). v0.7.0: Home page redesigned as a hierarchical task tree (driven by `roy-agent tasks tree --json`); new /api/tasks/tree endpoint with status / priority / type / root-id filters, expand/collapse UI, search, and live 30s polling. v0.8.0: per-task page Mermaid area now renders the hierarchical 'Task lifecycle + tools' view — each operation record owns a subgraph that nests its tool calls, with click callbacks (`window.__toolClick`) that scroll-into-view + highlight + auto-expand the matching row in the tool-call table below. Operation record descriptions (`description` + `processDescription`) are now always rendered inline (no `<details>` collapse) so the user sees the lifecycle state at a glance; a fallback `<details>` kicks in only for descriptions longer than 600 chars. v0.8.1: hotfix for two pre-existing bugs in v0.8.0 (browser smoke test surfaced after merge). (a) Mermaid click directives were emitted as `click t1 __toolClick(1)` (missing `call` keyword) — Mermaid 10's parser rejects this with `got 'PS'`. Fixed to `click t1 call __toolClick(1)` (the v10 grammar requires `call` to invoke a callback with arguments). (b) `buildMermaidSource` lived inside the `attachTaskPageTimeline` IIFE but was also called from a listener in the `attachToolClickBridge` IIFE — sibling IIFEs cannot see each other's locals, so the listener threw `ReferenceError: buildMermaidSource is not defined` and the Mermaid diagram silently failed to re-render after `task-show:lifecycle-ops-loaded`. Fixed by hoisting the function (and its three helpers) to script top-level so both IIFEs can see it via the script-wide closure; the function is also exposed on `window.buildMermaidSource` for tests + tooling. v0.8.3: tree-display fix (Task #2426). The home page used to look like a flat list of root tasks because `autoExpandFirstLevels(..., 2)` only opened the first 2 levels — 30/47 roots were leaf nodes and the remaining 17 collapsed to one level so grandchildren were never visible. Default expand depth is now 3 (root + child + grandchild + great-grandchild are visible on first paint), the summary line now shows per-depth count pills (root / child / grandchild / great-grandchild / level-N), each `tree-row` carries a `data-depth` attribute so CSS can paint coloured left rails per level, and the duplicated 'Live tool-call sessions (legacy view)' panel that made the page look like both a flat table AND a tree is now hidden behind `#legacy-sessions[hidden]` (kept for future debug-toggle restoration). v0.8.10: bug-fix release (Task #2537 + Task #2534). (a) Heap-bounded plugin caches: OperationsCache and TasksTreeCache now enforce a hard maxEntries cap (default 256 / 64). Oldest stale entries are evicted before inserting a new one, so long-lived roy-agent sessions (BackgroundTaskManager + MemorySessionStore) no longer leak Map entries through the plugin's per-task caches — see Task #2537 for the heap-unbounded-state RED→GREEN repro. (b) Mermaid CJK font-family: server.ts renderTaskPage now configures mermaid.initialize({ themeVariables: { fontFamily: '\"PingFang SC\", \"Microsoft YaHei\", \"Noto Sans CJK SC\", \"Source Han Sans CN\", \"WenQuanYi Micro Hei\", sans-serif' } }) so Chinese node labels render correctly in browsers that have at least one of those fonts installed (see Task #2534). v0.9.6: preserve task context/goals end-to-end with safe structured rendering, and ship a complete packaged session-home shell with reliable CSS/controller assets.",
   "main": "dist/index.js",
   "hooks": [
     {