@ai-setting/roy-plugin-task-show 0.6.12 → 0.8.5

package/dist/cli-tasks-tree-adapter.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview CLI adapter for `roy-agent tasks tree [--json] [--root-id N]`.
+ *
+ * Used by the Web homepage to render a hierarchical task list instead of
+ * the flat per-task tool-call view. Mirrors the design of
+ * `cli-tasks-adapter.ts` (typed errors, timeouts, byte caps, injectable
+ * runner) so the HTTP layer can map errors the same way.
+ *
+ * The CLI's `--json` output for `tasks tree` is:
+ *   {
+ *     "total": <number>,           // total tasks in the filtered set
+ *     "rootCount": <number>,       // number of root nodes in the returned tree
+ *     "tree": [                    // array of root nodes (recursively nested)
+ *       {
+ *         "task": { id, title, status, priority, type, progress, ... },
+ *         "children": [ /* same shape, recursively *\/ ]
+ *       },
+ *       ...
+ *     ]
+ *   }
+ *
+ * If `--root-id N` is provided, the response is a 1-element array whose
+ * only root is task #N, and the rest of the tree hangs below it. We
+ * transparently pass `--root-id` through to the CLI — callers don't have
+ * to filter the result themselves.
+ *
+ * Design goals (matching cli-tasks-adapter.ts):
+ *   - Spawn the host CLI as a discrete arg array — never via shell string.
+ *   - Enforce a wall-clock timeout and a maximum stdout size.
+ *   - Locate the leading `{` in stdout to skip INFO/log lines the real
+ *     CLI emits before its JSON envelope.
+ *   - Validate the parsed envelope against a stable schema.
+ *   - Surface typed errors so callers can map them to HTTP status codes.
+ *
+ * The adapter is intentionally narrow: it knows nothing about HTTP, the
+ * server, or the frontend. The `runner` is injectable so tests never
+ * need a real subprocess.
+ */
+import type { TaskShowConfig } from "./types.js";
+/** Subset of the CLI's `task` payload that we surface to the UI. */
+export interface TaskTreeNodeTask {
+    id: number;
+    title: string;
+    description?: string;
+    status: string;
+    priority: string;
+    type: string;
+    progress?: number;
+    current_status?: string;
+    createdAt: string;
+    updatedAt: string;
+    tags: string[];
+    project_path?: string;
+    parent_task_id?: number;
+}
+/** One node in the returned tree (recursive). */
+export interface TaskTreeNode {
+    task: TaskTreeNodeTask;
+    children: TaskTreeNode[];
+}
+/** Successful parse result. */
+export interface TasksTreeEnvelope {
+    total: number;
+    rootCount: number;
+    tree: TaskTreeNode[];
+    /** When the source data was last fetched (ISO 8601). */
+    fetchedAt: string;
+    /** True if this entry is past TTL but still served. */
+    stale: boolean;
+}
+/** Filter parameters understood by the underlying CLI. */
+export interface TasksTreeFilter {
+    status?: "todo" | "active" | "completed" | "paused" | "cancelled";
+    priority?: "low" | "medium" | "high";
+    type?: "normal" | "cycle" | "longterm";
+    /** Restrict the tree to one root (and its descendants). */
+    rootId?: number;
+    includeArchived?: boolean;
+}
+export { AdapterError, TimeoutError, ParseError, SchemaError, } from "./cli-tasks-adapter.js";
+export interface AdapterRunnerResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export type AdapterRunner = (args: string[]) => Promise<AdapterRunnerResult>;
+export interface TasksTreeAdapterOptions {
+    /** Absolute path to the `roy-agent` executable. */
+    cliPath: string;
+    /** Mockable subprocess runner (defaults to `defaultRunner`). */
+    runner?: AdapterRunner;
+    /** Wall-clock timeout (default 30000 ms — the tree JSON is large and the CLI runs migrations). */
+    timeoutMs?: number;
+    /** Maximum stdout bytes to keep (default 8 MiB). */
+    maxBytes?: number;
+    /** TaskShowConfig for sharing limits / defaults. */
+    cfg: TaskShowConfig;
+}
+export interface TasksTreeSource {
+    getTasksTree(filter: TasksTreeFilter): Promise<TasksTreeEnvelope>;
+}
+/**
+ * Default subprocess runner. We deliberately avoid `shell: true` to keep
+ * argv as a literal array — no shell metacharacter interpretation.
+ *
+ * Two adaptations for Bun / large outputs:
+ *   1. File-descriptor stdio: under Bun, piping ≥1 MB via
+ *      `stdio: ["ignore", "pipe", "pipe"]` drops data because the
+ *      `data` and `end` events fire before every chunk has been
+ *      delivered. Redirecting stdout/stderr to temp files captures the
+ *      full output reliably.
+ *   2. Poll-until-stable read: on Bun, the child process's `close` event
+ *      can fire BEFORE all writes have been flushed to the file
+ *      descriptor. We poll the file size until it stabilizes, then
+ *      read with createReadStream (more robust than readFileSync for
+ *      large files). This guarantees we don't return truncated output.
+ *
+ * Both adaptations are no-ops under Node.js (no observable behavior
+ * change), so the same code runs reliably on either runtime.
+ *
+ * Temp files are cleaned up in `finally` so a crash doesn't leak dirs.
+ */
+export declare const defaultRunner: AdapterRunner;
+/**
+ * Build the argv array for `roy-agent tasks tree [--status] [--priority]
+ * [--type] [--root-id] [--include-archived] --json`. Pure function — easy
+ * to unit-test.
+ */
+export declare function buildTasksTreeArgs(cliPath: string, filter: TasksTreeFilter): string[];
+/**
+ * Run `roy-agent tasks tree [--json] [--filter...]` and return a parsed
+ * envelope. Errors are typed so the HTTP layer can map them to status
+ * codes.
+ *
+ * Pass `runner: defaultRunner` in production. Tests pass a `fixedRunner`.
+ */
+export declare function runTasksTree(filter: TasksTreeFilter, options: TasksTreeAdapterOptions): Promise<TasksTreeEnvelope>;
+/**
+ * Convenience wrapper used by TasksTreeCache: a `TasksTreeSource` whose
+ * `getTasksTree(filter)` returns the parsed envelope or throws.
+ */
+export declare function makeTasksTreeSource(opts: TasksTreeAdapterOptions): TasksTreeSource;
+//# sourceMappingURL=cli-tasks-tree-adapter.d.ts.map

package/dist/cli-tasks-tree-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tasks-tree-adapter.d.ts","sourceRoot":"","sources":["../src/cli-tasks-tree-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClE,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IACvC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAID,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnE;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,EAAE,aAyH3B,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAerF;AA4GD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAyD5B;AAiBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,eAAe,CAMlF"}

package/dist/cli-tasks-tree-adapter.js

@@ -0,0 +1,400 @@
+/**
+ * @fileoverview CLI adapter for `roy-agent tasks tree [--json] [--root-id N]`.
+ *
+ * Used by the Web homepage to render a hierarchical task list instead of
+ * the flat per-task tool-call view. Mirrors the design of
+ * `cli-tasks-adapter.ts` (typed errors, timeouts, byte caps, injectable
+ * runner) so the HTTP layer can map errors the same way.
+ *
+ * The CLI's `--json` output for `tasks tree` is:
+ *   {
+ *     "total": <number>,           // total tasks in the filtered set
+ *     "rootCount": <number>,       // number of root nodes in the returned tree
+ *     "tree": [                    // array of root nodes (recursively nested)
+ *       {
+ *         "task": { id, title, status, priority, type, progress, ... },
+ *         "children": [ /* same shape, recursively *\/ ]
+ *       },
+ *       ...
+ *     ]
+ *   }
+ *
+ * If `--root-id N` is provided, the response is a 1-element array whose
+ * only root is task #N, and the rest of the tree hangs below it. We
+ * transparently pass `--root-id` through to the CLI — callers don't have
+ * to filter the result themselves.
+ *
+ * Design goals (matching cli-tasks-adapter.ts):
+ *   - Spawn the host CLI as a discrete arg array — never via shell string.
+ *   - Enforce a wall-clock timeout and a maximum stdout size.
+ *   - Locate the leading `{` in stdout to skip INFO/log lines the real
+ *     CLI emits before its JSON envelope.
+ *   - Validate the parsed envelope against a stable schema.
+ *   - Surface typed errors so callers can map them to HTTP status codes.
+ *
+ * The adapter is intentionally narrow: it knows nothing about HTTP, the
+ * server, or the frontend. The `runner` is injectable so tests never
+ * need a real subprocess.
+ */
+// Re-exports so the HTTP layer can use the same error classes without
+// importing cli-tasks-adapter.ts directly (avoids a circular import).
+export { AdapterError, TimeoutError, ParseError, SchemaError, } from "./cli-tasks-adapter.js";
+import { AdapterError, TimeoutError, ParseError, SchemaError } from "./cli-tasks-adapter.js";
+// ---------------------------------------------------------------------------
+// Default runner — spawns the CLI as discrete args with timeout & byte cap
+// ---------------------------------------------------------------------------
+/**
+ * Default subprocess runner. We deliberately avoid `shell: true` to keep
+ * argv as a literal array — no shell metacharacter interpretation.
+ *
+ * Two adaptations for Bun / large outputs:
+ *   1. File-descriptor stdio: under Bun, piping ≥1 MB via
+ *      `stdio: ["ignore", "pipe", "pipe"]` drops data because the
+ *      `data` and `end` events fire before every chunk has been
+ *      delivered. Redirecting stdout/stderr to temp files captures the
+ *      full output reliably.
+ *   2. Poll-until-stable read: on Bun, the child process's `close` event
+ *      can fire BEFORE all writes have been flushed to the file
+ *      descriptor. We poll the file size until it stabilizes, then
+ *      read with createReadStream (more robust than readFileSync for
+ *      large files). This guarantees we don't return truncated output.
+ *
+ * Both adaptations are no-ops under Node.js (no observable behavior
+ * change), so the same code runs reliably on either runtime.
+ *
+ * Temp files are cleaned up in `finally` so a crash doesn't leak dirs.
+ */
+export const defaultRunner = async (args) => {
+    const { spawn } = await import("node:child_process");
+    const { mkdtempSync, openSync, rmSync, statSync, createReadStream } = await import("node:fs");
+    const { tmpdir } = await import("node:os");
+    const { join } = await import("node:path");
+    const executable = args[0];
+    const argv = args.slice(1);
+    const dir = mkdtempSync(join(tmpdir(), "roy-task-tree-"));
+    const stdoutPath = join(dir, "stdout");
+    const stderrPath = join(dir, "stderr");
+    const stdoutFd = openSync(stdoutPath, "w");
+    const stderrFd = openSync(stderrPath, "w");
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const MAX_BYTES_DEFAULT = 8 * 1024 * 1024;
+        const child = spawn(executable, argv, {
+            stdio: ["ignore", stdoutFd, stderrFd],
+            env: process.env,
+        });
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                /* ignore */
+            }
+            const err = new Error("CLI spawn timed out");
+            err.name = "AbortError";
+            reject(err);
+        }, 30_000);
+        child.on("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            // Poll the stdout file size until it stops growing. The Bun
+            // runtime can fire `close` before the child's buffered stdout
+            // has been fully written to the file descriptor, so we must wait
+            // for the writer side to flush before reading.
+            const waitForFlush = () => new Promise((done) => {
+                const deadline = Date.now() + 5000; // 5s safety net
+                let lastSize = -1;
+                let stableTicks = 0;
+                const tick = () => {
+                    let curSize = 0;
+                    try {
+                        curSize = statSync(stdoutPath).size;
+                    }
+                    catch {
+                        // file may have been removed by something — bail
+                        done();
+                        return;
+                    }
+                    if (curSize === lastSize) {
+                        stableTicks += 1;
+                        if (stableTicks >= 3) {
+                            done();
+                            return;
+                        }
+                    }
+                    else {
+                        stableTicks = 0;
+                        lastSize = curSize;
+                    }
+                    if (Date.now() >= deadline) {
+                        done();
+                        return;
+                    }
+                    setTimeout(tick, 25);
+                };
+                tick();
+            });
+            waitForFlush().then(() => {
+                try {
+                    const readUtf8 = (filePath) => new Promise((res, rej) => {
+                        const chunks = [];
+                        const stream = createReadStream(filePath);
+                        stream.on("data", (c) => chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c)));
+                        stream.on("end", () => res(Buffer.concat(chunks).toString("utf8")));
+                        stream.on("error", rej);
+                    });
+                    Promise.all([readUtf8(stdoutPath), readUtf8(stderrPath)]).then(([stdout, stderr]) => {
+                        if (stdout.length > MAX_BYTES_DEFAULT) {
+                            reject(new AdapterError(`CLI stdout exceeded maxBytes=${MAX_BYTES_DEFAULT} (got ${stdout.length})`, { code: "oversize" }));
+                            return;
+                        }
+                        resolve({
+                            stdout,
+                            stderr,
+                            exitCode: code ?? 0,
+                        });
+                    }, (err) => reject(err));
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        });
+    }).finally(() => {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            /* ignore — best-effort cleanup */
+        }
+    });
+};
+// ---------------------------------------------------------------------------
+// Arg builder
+// ---------------------------------------------------------------------------
+/**
+ * Build the argv array for `roy-agent tasks tree [--status] [--priority]
+ * [--type] [--root-id] [--include-archived] --json`. Pure function — easy
+ * to unit-test.
+ */
+export function buildTasksTreeArgs(cliPath, filter) {
+    const args = [cliPath, "tasks", "tree"];
+    if (filter.status)
+        args.push("--status", filter.status);
+    if (filter.priority)
+        args.push("--priority", filter.priority);
+    if (filter.type)
+        args.push("--type", filter.type);
+    if (typeof filter.rootId === "number" && Number.isFinite(filter.rootId) && filter.rootId > 0) {
+        args.push("--root-id", String(Math.trunc(filter.rootId)));
+    }
+    if (filter.includeArchived)
+        args.push("--include-archived");
+    args.push("--json");
+    // The CLI is noisy on stdout by default — force quiet mode so we only
+    // get the JSON envelope. Newer builds accept `--quiet`; older builds
+    // (default quiet=true) ignore it harmlessly.
+    args.push("--quiet");
+    return args;
+}
+// ---------------------------------------------------------------------------
+// Parsing helpers
+// ---------------------------------------------------------------------------
+/**
+ * Locate the JSON envelope in stdout. The CLI emits migration / OTel
+ * log lines before the envelope, and some runtimes (notably Bun) have
+ * been observed to append unrelated output (e.g. other plugins'
+ * `dispose` banners) AFTER the envelope's closing brace.
+ *
+ * Strategy:
+ *   1. Locate the leading `{` and skip the leading log lines.
+ *   2. Walk forward, tracking brace depth, to find the matching `}`.
+ *      This is robust against trailing content that isn't part of the
+ *      envelope — anything after the balanced close brace is dropped.
+ *   3. Bail with a ParseError if the brace depth never returns to 0.
+ *
+ * The implementation treats `{` and `}` that appear inside JSON strings
+ * conservatively (a real string can contain an unescaped brace in some
+ * shapes, but our CLI's envelope never does). This keeps the extractor
+ * simple while still handling the observed trailing-noise case.
+ */
+function extractJsonEnvelope(stdout) {
+    const start = stdout.indexOf("{");
+    if (start < 0) {
+        throw new ParseError("No JSON envelope found in CLI stdout (no leading `{`)");
+    }
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    let end = -1;
+    for (let i = start; i < stdout.length; i++) {
+        const ch = stdout[i];
+        if (inString) {
+            if (escape) {
+                escape = false;
+            }
+            else if (ch === "\\") {
+                escape = true;
+            }
+            else if (ch === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            continue;
+        }
+        if (ch === "{") {
+            depth += 1;
+        }
+        else if (ch === "}") {
+            depth -= 1;
+            if (depth === 0) {
+                end = i;
+                break;
+            }
+        }
+    }
+    if (end < 0) {
+        throw new ParseError("Unterminated JSON envelope (brace depth never returned to 0)");
+    }
+    return stdout.slice(start, end + 1);
+}
+/**
+ * Recursively validate + normalize a tree node. Throws SchemaError on the
+ * first structural problem so the caller can surface a 502-style error.
+ */
+function normalizeNode(raw, depth) {
+    if (depth > 16) {
+        // Defensive: a malicious / buggy CLI emitting 17+ levels deep would
+        // blow the stack on recursive normalizeNode. Bail with a clear error.
+        throw new SchemaError(`tree node depth > 16 (recursion guard)`);
+    }
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new SchemaError("tree node is not an object");
+    }
+    if (!raw.task || typeof raw.task !== "object") {
+        throw new SchemaError("tree node missing `task` object");
+    }
+    const t = raw.task;
+    const task = {
+        id: Number(t.id),
+        title: String(t.title ?? ""),
+        description: typeof t.description === "string" ? t.description : undefined,
+        status: String(t.status ?? "unknown"),
+        priority: String(t.priority ?? "medium"),
+        type: String(t.type ?? "normal"),
+        progress: typeof t.progress === "number" ? t.progress : undefined,
+        current_status: typeof t.current_status === "string" ? t.current_status : undefined,
+        createdAt: String(t.createdAt ?? ""),
+        updatedAt: String(t.updatedAt ?? ""),
+        tags: Array.isArray(t.tags) ? t.tags.map((x) => String(x)) : [],
+        project_path: typeof t.project_path === "string" ? t.project_path : undefined,
+        parent_task_id: typeof t.parent_task_id === "number" ? t.parent_task_id : undefined,
+    };
+    if (!Number.isInteger(task.id) || task.id <= 0) {
+        throw new SchemaError(`tree node task.id is invalid: ${String(task.id)}`);
+    }
+    const children = Array.isArray(raw.children) ? raw.children : [];
+    return { task, children: children.map((c) => normalizeNode(c, depth + 1)) };
+}
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+/**
+ * Run `roy-agent tasks tree [--json] [--filter...]` and return a parsed
+ * envelope. Errors are typed so the HTTP layer can map them to status
+ * codes.
+ *
+ * Pass `runner: defaultRunner` in production. Tests pass a `fixedRunner`.
+ */
+export async function runTasksTree(filter, options) {
+    const runner = options.runner ?? defaultRunner;
+    const args = buildTasksTreeArgs(options.cliPath, filter);
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const maxBytes = options.maxBytes ?? 8 * 1024 * 1024;
+    let raw;
+    try {
+        raw = await withTimeout(runner(args), timeoutMs);
+    }
+    catch (err) {
+        if (err?.name === "AbortError" || /timeout|abort/i.test(String(err?.message ?? ""))) {
+            throw new TimeoutError(`CLI timeout after ${timeoutMs}ms`, err);
+        }
+        if (err instanceof AdapterError)
+            throw err;
+        throw new AdapterError(`CLI runner failed: ${err?.message ?? String(err)}`, { cause: err });
+    }
+    if (raw.stdout.length > maxBytes) {
+        throw new AdapterError(`CLI stdout exceeded maxBytes=${maxBytes} (got ${raw.stdout.length})`, { code: "oversize" });
+    }
+    let parsed;
+    try {
+        const jsonText = extractJsonEnvelope(raw.stdout);
+        parsed = JSON.parse(jsonText);
+    }
+    catch (err) {
+        if (raw.exitCode !== 0) {
+            throw new AdapterError(`CLI exited with code ${raw.exitCode} and no parseable JSON envelope`, { code: "cli_failed", exitCode: raw.exitCode });
+        }
+        if (err instanceof ParseError || err instanceof SchemaError)
+            throw err;
+        throw new ParseError("Failed to parse CLI JSON envelope", err);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new SchemaError("envelope root is not an object");
+    }
+    if (!Array.isArray(parsed.tree)) {
+        throw new SchemaError("envelope missing `tree` array");
+    }
+    const tree = parsed.tree.map((n) => normalizeNode(n, 0));
+    const total = Number(parsed.total ?? tree.length);
+    const rootCount = Number(parsed.rootCount ?? tree.length);
+    return {
+        total,
+        rootCount,
+        tree,
+        fetchedAt: new Date().toISOString(),
+        stale: false,
+    };
+}
+/** Wrap a promise with a wall-clock timeout. */
+function withTimeout(p, ms) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            const err = new Error(`timed out after ${ms}ms`);
+            err.name = "AbortError";
+            reject(err);
+        }, ms);
+    });
+    return Promise.race([p, timeout]).finally(() => {
+        if (timer)
+            clearTimeout(timer);
+    });
+}
+/**
+ * Convenience wrapper used by TasksTreeCache: a `TasksTreeSource` whose
+ * `getTasksTree(filter)` returns the parsed envelope or throws.
+ */
+export function makeTasksTreeSource(opts) {
+    return {
+        async getTasksTree(filter) {
+            return runTasksTree(filter, opts);
+        },
+    };
+}
+//# sourceMappingURL=cli-tasks-tree-adapter.js.map

package/dist/cli-tasks-tree-adapter.js.map

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

package/dist/plugin.d.ts

@@ -104,6 +104,61 @@ export declare function resolveToolName(ctx: any, logger?: ResolveToolNameLogger
  * reach for it.
  */
 export declare function __resetResolveToolNameWarnDedupForTests(): void;
+/**
+ * Best-effort lookup of the `roy-agent` executable on the OS PATH.
+ *
+ * Implementation: shell out to the platform's native resolver:
+ *   - POSIX (Linux / macOS): `which roy-agent`
+ *   - Windows:               `where roy-agent`
+ *
+ * We avoid hand-rolling a `node:fs` + `process.env.PATH` parser because
+ * Windows PATH uses `;` (not `:`), `.bat` / `.cmd` shims need to be
+ * resolved, and PowerShell vs cmd semantics differ. The shell utils
+ * handle those edge cases correctly for us.
+ *
+ * Returns the absolute path of the first match, or `null` if:
+ *   - the binary is not installed
+ *   - the resolver command (`which` / `where`) is unavailable
+ *   - any unexpected error happens (caught silently — best-effort)
+ *
+ * v0.8.5+ — new export. Was previously inlined inside the class method.
+ */
+export declare function findRoyAgentOnPath(): string | null;
+/**
+ * Resolve the `roy-agent` executable to use for the operations pipeline.
+ *
+ * v0.8.5+ priority order (changed from v0.8.4):
+ *   1. Explicit override (`cfg.royAgentCliPath`) — used as-is regardless
+ *      of whether it exists on disk. The caller knows what they want.
+ *   2. `$ROY_AGENT_CLI` env var — same semantics: trust the operator.
+ *   3. **`roy-agent` on PATH** (the new priority-3 step). This is the
+ *      preferred choice in production because it always tracks the
+ *      latest globally-installed version, regardless of where the
+ *      plugin itself lives on disk.
+ *   4. Sibling-repo `.js` script:
+ *      `<cwd>/../roy-agent/packages/cli/dist/bin/roy-agent.js`
+ *      (typical when both repos live side-by-side — dev layout)
+ *   5. Monorepo `.js` script:
+ *      `<plugin>/../../../../packages/cli/dist/bin/roy-agent.js`
+ *      (dev layout when the plugin is checked out from a monorepo)
+ *   6. Final fallback: the literal string `"roy-agent"`. The OS spawn
+ *      will resolve it via PATH one more time as a last resort.
+ *
+ * **Why the priority changed in v0.8.5:**
+ *   In v0.8.4 the function preferred the sibling-repo / monorepo `.js`
+ *   scripts over the system PATH. That worked fine during local dev
+ *   but, after publishing the plugin globally via npm, it meant:
+ *     - The plugin would keep using the stale `.js` left in a sibling
+ *       checkout (because `fs.existsSync` returned true even though
+ *       `npm install -g @ai-setting/roy-agent-cli` had updated the
+ *       canonical copy).
+ *     - Users couldn't pick up CLI bug fixes without also reinstalling
+ *       the plugin or cleaning up the stale `.js`.
+ *   v0.8.5 flips the order: PATH first, `.js` files only as dev-time
+ *   fallbacks. The result is that the globally-installed CLI is
+ *   always the source of truth.
+ */
+export declare function resolveRoyAgentCliPath(override: string | undefined): string;
 /**
  * Public, friendly type used in README + tests.
  *
@@ -145,6 +200,8 @@ export declare class TaskShowPlugin implements TaskShowPluginInterface {
     private readonly eventBus;
     /** v0.7.0+: cache for parsed task operations envelopes. */
     private readonly operationsCache;
+    /** v0.8.0+: cache for parsed task tree envelopes (used by /api/tasks/tree). */
+    private readonly tasksTreeCache;
     private env;
     private disposed;
     /**
@@ -170,12 +227,11 @@ export declare class TaskShowPlugin implements TaskShowPluginInterface {
     constructor(config?: Partial<TaskShowConfig>);
     /**
      * Resolve the `roy-agent` executable to use for the operations pipeline.
-     * Resolution order:
-     *   1. Explicit override (`cfg.royAgentCliPath`) if it exists
-     *   2. `$ROY_AGENT_CLI` env var if it exists
-     *   3. `<cwd>/../roy-agent/packages/cli/dist/bin/roy-agent.js`
-     *      (the typical layout when both repos live side-by-side)
-     *   4. The global `roy-agent` on PATH (best-effort)
+     *
+     * v0.8.5+: delegates to the free function `resolveRoyAgentCliPath()`
+     * (also exported from this module) so the priority order is
+     * unit-testable in isolation. Kept as a method on the class so existing
+     * internal callers keep their semantics unchanged.
      */
     private resolveRoyAgentCliPath;
     /**