network-ai 4.15.3 → 5.1.0

package/dist/lib/work-tree-ui.d.ts

@@ -0,0 +1,107 @@
+/**
+ * WorkTreeUI — Terminal renderer for WorkTree hierarchies
+ *
+ * Renders a WorkTree as an ASCII/Unicode tree with:
+ *   - Box-drawing connectors (├─, └─, │)
+ *   - Status icons and color-coding
+ *   - Progress bars per branch node
+ *   - Token counts
+ *   - Agent assignments
+ *   - Live auto-refresh mode via WorkTree events
+ *
+ * Zero external dependencies — uses the {@link ansi} helpers from ConsoleUI.
+ *
+ * @module WorkTreeUI
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import type { WorkTree, WorkTreeStats } from './work-tree';
+/** Render options for WorkTreeUI */
+export interface WorkTreeUIOptions {
+    /** Output stream (default: process.stdout) */
+    output?: NodeJS.WritableStream;
+    /** Show token counts (default: true) */
+    showTokens?: boolean;
+    /** Show agent assignments (default: true) */
+    showAgents?: boolean;
+    /** Show progress bars (default: true) */
+    showProgress?: boolean;
+    /** Show stats footer (default: true) */
+    showStats?: boolean;
+    /** Progress bar width in characters (default: 10) */
+    progressBarWidth?: number;
+    /** Use color output (default: true) */
+    useColor?: boolean;
+    /** Indent size per depth level (default: 2) */
+    indentSize?: number;
+    /** Title override (default: root label) */
+    title?: string;
+    /** Compact mode — hide nodes at depth > maxDepth (default: Infinity) */
+    maxDepth?: number;
+    /** Auto-refresh on WorkTree events (default: false) */
+    live?: boolean;
+}
+/** Column-aligned render result for programmatic use */
+export interface RenderResult {
+    /** The rendered tree as a single string */
+    text: string;
+    /** Number of lines rendered */
+    lineCount: number;
+    /** Stats snapshot at render time */
+    stats: WorkTreeStats;
+}
+/**
+ * Terminal renderer for {@link WorkTree} hierarchies.
+ *
+ * ```typescript
+ * const tree = new WorkTree('root', 'My Project');
+ * // ... add children, set statuses ...
+ *
+ * const ui = new WorkTreeUI(tree);
+ * ui.render();            // print to stdout
+ *
+ * const result = ui.toString(); // get as string
+ *
+ * ui.startLive();         // auto-refresh on changes
+ * ui.stopLive();
+ * ```
+ */
+export declare class WorkTreeUI extends EventEmitter {
+    private readonly tree;
+    private readonly opts;
+    private liveCleanup;
+    private lastLineCount;
+    constructor(tree: WorkTree, options?: WorkTreeUIOptions);
+    /**
+     * Render the tree to the output stream.
+     * In live mode this clears previous output first.
+     */
+    render(): RenderResult;
+    /**
+     * Return the rendered tree as a string (no side effects).
+     */
+    toString(): string;
+    /**
+     * Start live mode — auto-refresh whenever the tree changes.
+     */
+    startLive(): void;
+    /**
+     * Stop live mode.
+     */
+    stopLive(): void;
+    /**
+     * Clean up resources.
+     */
+    destroy(): void;
+    private buildRender;
+    private renderNode;
+    private renderProgressBar;
+    private renderStatsLine;
+    private renderTokenLine;
+    private renderOverallProgress;
+    private isLastSibling;
+    private style;
+    private formatTokens;
+    private write;
+}
+//# sourceMappingURL=work-tree-ui.d.ts.map

package/dist/lib/work-tree-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-tree-ui.d.ts","sourceRoot":"","sources":["../../lib/work-tree-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,QAAQ,EAA4B,aAAa,EAAE,MAAM,aAAa,CAAC;AAMrF,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,KAAK,EAAE,aAAa,CAAC;CACtB;AA8CD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,aAAa,CAAK;gBAEd,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,iBAAiB;IA0BvD;;;OAGG;IACH,MAAM,IAAI,YAAY;IAkBtB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,SAAS,IAAI,IAAI;IAoBjB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB;;OAEG;IACH,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,UAAU;IAiElB,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,KAAK;CAGd"}

package/dist/lib/work-tree-ui.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * WorkTreeUI — Terminal renderer for WorkTree hierarchies
+ *
+ * Renders a WorkTree as an ASCII/Unicode tree with:
+ *   - Box-drawing connectors (├─, └─, │)
+ *   - Status icons and color-coding
+ *   - Progress bars per branch node
+ *   - Token counts
+ *   - Agent assignments
+ *   - Live auto-refresh mode via WorkTree events
+ *
+ * Zero external dependencies — uses the {@link ansi} helpers from ConsoleUI.
+ *
+ * @module WorkTreeUI
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkTreeUI = void 0;
+const events_1 = require("events");
+const console_ui_1 = require("./console-ui");
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const STATUS_ICONS = {
+    pending: '○',
+    running: '◑',
+    completed: '✔',
+    failed: '✘',
+    skipped: '⏭',
+    blocked: '⛔',
+};
+const STATUS_COLORS = {
+    pending: console_ui_1.ansi.gray,
+    running: console_ui_1.ansi.yellow,
+    completed: console_ui_1.ansi.green,
+    failed: console_ui_1.ansi.red,
+    skipped: console_ui_1.ansi.gray,
+    blocked: console_ui_1.ansi.red,
+};
+// Box-drawing characters
+const BOX = {
+    pipe: '│',
+    tee: '├',
+    corner: '└',
+    dash: '─',
+    space: ' ',
+};
+// Progress bar characters
+const BAR = {
+    full: '█',
+    seven: '▓',
+    half: '▒',
+    light: '░',
+    empty: '░',
+};
+// ============================================================================
+// WORK TREE UI
+// ============================================================================
+/**
+ * Terminal renderer for {@link WorkTree} hierarchies.
+ *
+ * ```typescript
+ * const tree = new WorkTree('root', 'My Project');
+ * // ... add children, set statuses ...
+ *
+ * const ui = new WorkTreeUI(tree);
+ * ui.render();            // print to stdout
+ *
+ * const result = ui.toString(); // get as string
+ *
+ * ui.startLive();         // auto-refresh on changes
+ * ui.stopLive();
+ * ```
+ */
+class WorkTreeUI extends events_1.EventEmitter {
+    tree;
+    opts;
+    liveCleanup = null;
+    lastLineCount = 0;
+    constructor(tree, options) {
+        super();
+        this.tree = tree;
+        this.opts = {
+            output: options?.output ?? process.stdout,
+            showTokens: options?.showTokens ?? true,
+            showAgents: options?.showAgents ?? true,
+            showProgress: options?.showProgress ?? true,
+            showStats: options?.showStats ?? true,
+            progressBarWidth: options?.progressBarWidth ?? 10,
+            useColor: options?.useColor ?? true,
+            indentSize: options?.indentSize ?? 2,
+            title: options?.title ?? '',
+            maxDepth: options?.maxDepth ?? Infinity,
+            live: options?.live ?? false,
+        };
+        if (this.opts.live) {
+            this.startLive();
+        }
+    }
+    // --------------------------------------------------------------------------
+    // PUBLIC API
+    // --------------------------------------------------------------------------
+    /**
+     * Render the tree to the output stream.
+     * In live mode this clears previous output first.
+     */
+    render() {
+        const result = this.buildRender();
+        if (this.liveCleanup && this.lastLineCount > 0) {
+            // Move cursor up and clear previous render
+            this.write(`\x1b[${this.lastLineCount}A`);
+            for (let i = 0; i < this.lastLineCount; i++) {
+                this.write(`${console_ui_1.ansi.clearLine}\n`);
+            }
+            this.write(`\x1b[${this.lastLineCount}A`);
+        }
+        this.write(result.text);
+        this.lastLineCount = result.lineCount;
+        this.emit('render', result);
+        return result;
+    }
+    /**
+     * Return the rendered tree as a string (no side effects).
+     */
+    toString() {
+        return this.buildRender().text;
+    }
+    /**
+     * Start live mode — auto-refresh whenever the tree changes.
+     */
+    startLive() {
+        if (this.liveCleanup)
+            return;
+        const handler = () => this.render();
+        this.tree.on('node:added', handler);
+        this.tree.on('node:removed', handler);
+        this.tree.on('node:status', handler);
+        this.tree.on('node:tokens', handler);
+        this.liveCleanup = () => {
+            this.tree.removeListener('node:added', handler);
+            this.tree.removeListener('node:removed', handler);
+            this.tree.removeListener('node:status', handler);
+            this.tree.removeListener('node:tokens', handler);
+        };
+        // Initial render
+        this.render();
+    }
+    /**
+     * Stop live mode.
+     */
+    stopLive() {
+        if (this.liveCleanup) {
+            this.liveCleanup();
+            this.liveCleanup = null;
+        }
+    }
+    /**
+     * Clean up resources.
+     */
+    destroy() {
+        this.stopLive();
+        this.removeAllListeners();
+    }
+    // --------------------------------------------------------------------------
+    // RENDERING
+    // --------------------------------------------------------------------------
+    buildRender() {
+        const lines = [];
+        const stats = this.tree.stats();
+        const root = this.tree.getRoot();
+        const title = this.opts.title || root.label;
+        // Header
+        lines.push('');
+        lines.push(this.style(`  ${title}`, console_ui_1.ansi.bold));
+        lines.push(`  ${this.style('─'.repeat(Math.max(title.length + 4, 50)), console_ui_1.ansi.dim)}`);
+        // Tree body
+        const flat = this.tree.flatten();
+        // Build a set of "has next sibling" per depth for pipe drawing
+        const pipeStack = [];
+        for (let i = 0; i < flat.length; i++) {
+            const node = flat[i];
+            if (node.depth > this.opts.maxDepth)
+                continue;
+            const line = this.renderNode(node, flat, i, pipeStack);
+            lines.push(line);
+        }
+        // Footer
+        if (this.opts.showStats) {
+            lines.push('');
+            lines.push(`  ${this.style('─'.repeat(Math.max(title.length + 4, 50)), console_ui_1.ansi.dim)}`);
+            lines.push(this.renderStatsLine(stats));
+            lines.push(this.renderTokenLine(stats));
+            lines.push(this.renderOverallProgress(stats));
+        }
+        lines.push('');
+        const text = lines.join('\n');
+        return { text, lineCount: lines.length, stats };
+    }
+    renderNode(node, flat, index, pipeStack) {
+        const depth = node.depth;
+        const isRoot = depth === 0;
+        // Determine if this node is the last child of its parent
+        const isLastChild = this.isLastSibling(node);
+        // Update pipe stack for connector drawing
+        pipeStack.length = depth;
+        if (!isRoot) {
+            // At depth-1, set whether we should continue drawing a pipe
+            if (depth > 0) {
+                pipeStack[depth - 1] = !isLastChild;
+            }
+        }
+        // Build prefix with connectors
+        let prefix = '  '; // left margin
+        if (!isRoot) {
+            for (let d = 0; d < depth - 1; d++) {
+                prefix += pipeStack[d]
+                    ? `${BOX.pipe}${BOX.space.repeat(this.opts.indentSize)}`
+                    : `${BOX.space}${BOX.space.repeat(this.opts.indentSize)}`;
+            }
+            prefix += isLastChild
+                ? `${BOX.corner}${BOX.dash} `
+                : `${BOX.tee}${BOX.dash} `;
+        }
+        // Status icon
+        const icon = STATUS_ICONS[node.status];
+        const statusColor = STATUS_COLORS[node.status];
+        // Label
+        const label = this.style(`${icon} ${node.label}`, statusColor);
+        // Inline metadata
+        const parts = [label];
+        // Progress bar for branch nodes
+        if (this.opts.showProgress && node.children.length > 0) {
+            parts.push(this.renderProgressBar(node.progress, node.status));
+        }
+        // Token count
+        if (this.opts.showTokens && node.totalTokens > 0) {
+            const tokenStr = node.children.length > 0
+                ? `${this.formatTokens(node.totalTokens)} tok`
+                : `${this.formatTokens(node.ownTokens)} tok`;
+            parts.push(this.style(tokenStr, console_ui_1.ansi.dim));
+        }
+        // Agent
+        if (this.opts.showAgents && node.agent) {
+            parts.push(this.style(`@${node.agent}`, console_ui_1.ansi.dim + console_ui_1.ansi.cyan));
+        }
+        return prefix + parts.join(' ');
+    }
+    renderProgressBar(progress, status) {
+        const width = this.opts.progressBarWidth;
+        const filled = Math.round(progress * width);
+        const empty = width - filled;
+        let barColor;
+        if (status === 'completed')
+            barColor = console_ui_1.ansi.green;
+        else if (status === 'failed')
+            barColor = console_ui_1.ansi.red;
+        else if (progress >= 0.5)
+            barColor = console_ui_1.ansi.yellow;
+        else
+            barColor = console_ui_1.ansi.gray;
+        const filledStr = BAR.full.repeat(filled);
+        const emptyStr = BAR.empty.repeat(empty);
+        const pct = `${Math.round(progress * 100)}%`;
+        return this.style(`${filledStr}`, barColor) +
+            this.style(emptyStr, console_ui_1.ansi.dim) +
+            ' ' +
+            this.style(pct, progress === 1 ? console_ui_1.ansi.green : console_ui_1.ansi.dim);
+    }
+    renderStatsLine(stats) {
+        const parts = [
+            this.style(`${stats.completed} done`, console_ui_1.ansi.green),
+            this.style(`${stats.running} running`, console_ui_1.ansi.yellow),
+            this.style(`${stats.failed} failed`, console_ui_1.ansi.red),
+            `${stats.pending} pending`,
+        ];
+        if (stats.blocked > 0) {
+            parts.push(this.style(`${stats.blocked} blocked`, console_ui_1.ansi.red + console_ui_1.ansi.dim));
+        }
+        if (stats.skipped > 0) {
+            parts.push(this.style(`${stats.skipped} skipped`, console_ui_1.ansi.dim));
+        }
+        return `  ${this.style(`${stats.total} nodes`, console_ui_1.ansi.bold)} │ ${parts.join(this.style(' │ ', console_ui_1.ansi.dim))}`;
+    }
+    renderTokenLine(stats) {
+        return `  Tokens: ${this.style(this.formatTokens(stats.totalTokens), console_ui_1.ansi.bold)} │ Depth: ${stats.maxDepth}`;
+    }
+    renderOverallProgress(stats) {
+        const width = 30;
+        const pct = stats.progress;
+        const filled = Math.round(pct * width);
+        const empty = width - filled;
+        let barColor;
+        if (pct === 1)
+            barColor = console_ui_1.ansi.green;
+        else if (pct >= 0.66)
+            barColor = console_ui_1.ansi.yellow;
+        else
+            barColor = console_ui_1.ansi.cyan;
+        const filledStr = BAR.full.repeat(filled);
+        const emptyStr = BAR.empty.repeat(empty);
+        const pctStr = `${Math.round(pct * 100)}%`;
+        return `  Progress: ${this.style(filledStr, barColor)}${this.style(emptyStr, console_ui_1.ansi.dim)} ${this.style(pctStr, console_ui_1.ansi.bold)}`;
+    }
+    // --------------------------------------------------------------------------
+    // HELPERS
+    // --------------------------------------------------------------------------
+    isLastSibling(node) {
+        if (!node.parentId)
+            return true;
+        const parent = this.tree.getNode(node.parentId);
+        if (!parent)
+            return true;
+        return parent.children[parent.children.length - 1] === node.id;
+    }
+    style(text, code) {
+        if (!this.opts.useColor)
+            return text;
+        return `${code}${text}${console_ui_1.ansi.reset}`;
+    }
+    formatTokens(n) {
+        if (n >= 1_000_000)
+            return `${(n / 1_000_000).toFixed(1)}M`;
+        if (n >= 1_000)
+            return `${(n / 1_000).toFixed(1)}k`;
+        return String(n);
+    }
+    write(text) {
+        this.opts.output.write(text);
+    }
+}
+exports.WorkTreeUI = WorkTreeUI;
+//# sourceMappingURL=work-tree-ui.js.map

package/dist/lib/work-tree-ui.js.map

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

package/dist/lib/work-tree.d.ts

@@ -0,0 +1,184 @@
+/**
+ * WorkTree — Hierarchical task decomposition tree with rollup stats
+ *
+ * Maintains a rooted tree of work items where each node can spawn children.
+ * Status, tokens, and progress roll up automatically from leaves to root.
+ * Integrates with {@link TopologyTracker} to add `subtask` edges and sync
+ * agent status.
+ *
+ * @module WorkTree
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+/** Status of a work node */
+export type WorkNodeStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'blocked';
+/** A single node in the work tree */
+export interface WorkNode {
+    /** Unique work-item identifier */
+    id: string;
+    /** Parent work-item id (undefined for root) */
+    parentId?: string;
+    /** Human-readable label */
+    label: string;
+    /** Agent assigned to this work item (if any) */
+    agent?: string;
+    /** Current status */
+    status: WorkNodeStatus;
+    /** Depth in the tree (root = 0) */
+    depth: number;
+    /** Direct children ids (ordered) */
+    children: string[];
+    /** Tokens consumed by this node alone (not including children) */
+    ownTokens: number;
+    /** Rollup: total tokens including all descendants */
+    totalTokens: number;
+    /** Rollup: progress 0–1 based on completed descendants */
+    progress: number;
+    /** ISO 8601 created timestamp */
+    createdAt: string;
+    /** ISO 8601 last status change */
+    updatedAt: string;
+    /** Arbitrary metadata */
+    metadata: Record<string, unknown>;
+}
+/** Summary statistics for the entire tree */
+export interface WorkTreeStats {
+    /** Total node count */
+    total: number;
+    /** By status */
+    pending: number;
+    running: number;
+    completed: number;
+    failed: number;
+    skipped: number;
+    blocked: number;
+    /** Overall progress 0–1 */
+    progress: number;
+    /** Aggregate tokens across all nodes */
+    totalTokens: number;
+    /** Max tree depth */
+    maxDepth: number;
+}
+/** Flat representation of the tree for serialisation */
+export interface WorkTreeSnapshot {
+    /** Root node id */
+    rootId: string;
+    /** All nodes keyed by id */
+    nodes: Record<string, WorkNode>;
+    /** Tree-wide stats */
+    stats: WorkTreeStats;
+    /** ISO 8601 snapshot timestamp */
+    timestamp: string;
+}
+/** Events emitted by WorkTree */
+export interface WorkTreeEvents {
+    'node:added': (node: WorkNode) => void;
+    'node:removed': (id: string) => void;
+    'node:status': (id: string, status: WorkNodeStatus, prev: WorkNodeStatus) => void;
+    'node:tokens': (id: string, ownTokens: number, totalTokens: number) => void;
+    'node:progress': (id: string, progress: number) => void;
+    'tree:complete': (stats: WorkTreeStats) => void;
+}
+/** Options for auto-status rollup behaviour */
+export interface WorkTreeOptions {
+    /** Auto-complete a parent when all children complete (default: true) */
+    autoCompleteParent?: boolean;
+    /** Auto-fail a parent when any child fails (default: false) */
+    autoFailParent?: boolean;
+    /** Auto-block children when parent is not running (default: true) */
+    autoBlockChildren?: boolean;
+}
+/**
+ * Hierarchical task decomposition tree.
+ *
+ * ```typescript
+ * const tree = new WorkTree('root', 'Build feature');
+ * tree.addChild('root', { id: 'design', label: 'Design API' });
+ * tree.addChild('root', { id: 'impl', label: 'Implement' });
+ * tree.addChild('impl', { id: 'impl-auth', label: 'Auth module', agent: 'worker-1' });
+ * tree.addChild('impl', { id: 'impl-db', label: 'DB schema', agent: 'worker-2' });
+ *
+ * tree.setStatus('impl-auth', 'running');
+ * tree.setStatus('impl-auth', 'completed');
+ * // impl.progress → 0.5 (1 of 2 children done)
+ * ```
+ */
+export declare class WorkTree extends EventEmitter {
+    private nodes;
+    private readonly rootId;
+    private readonly opts;
+    constructor(rootId: string, rootLabel: string, options?: WorkTreeOptions);
+    /**
+     * Add a child work item under a parent.
+     * @throws if parentId does not exist or id is already taken.
+     */
+    addChild(parentId: string, child: {
+        id: string;
+        label: string;
+        agent?: string;
+        metadata?: Record<string, unknown>;
+    }): WorkNode;
+    /**
+     * Remove a node and all its descendants.
+     * Cannot remove the root.
+     * @returns number of nodes removed
+     */
+    removeSubtree(id: string): number;
+    /**
+     * Set the status of a work node. Triggers rollup.
+     */
+    setStatus(id: string, status: WorkNodeStatus): void;
+    /**
+     * Add tokens to a work node. Rolls up totalTokens to ancestors.
+     */
+    addTokens(id: string, tokens: number): void;
+    /** Get a single node (copy). */
+    getNode(id: string): WorkNode | undefined;
+    /** Get the root node. */
+    getRoot(): WorkNode;
+    /** Get direct children of a node. */
+    getChildren(id: string): WorkNode[];
+    /** Get all ancestors from node to root (excluding the node itself). */
+    getAncestors(id: string): WorkNode[];
+    /** Get all descendants (depth-first). */
+    getDescendants(id: string): WorkNode[];
+    /** Get all leaf nodes (no children). */
+    getLeaves(): WorkNode[];
+    /** Total node count. */
+    size(): number;
+    /** The root node id. */
+    getRootId(): string;
+    /** Compute tree-wide statistics. */
+    stats(): WorkTreeStats;
+    /** Full snapshot for serialisation. */
+    snapshot(): WorkTreeSnapshot;
+    /**
+     * Flatten the tree into a depth-first ordered array (for rendering).
+     */
+    flatten(): WorkNode[];
+    /**
+     * Build the tree from a flat list of tasks with dependencies.
+     * Creates a virtual root if multiple top-level tasks exist.
+     * Compatible with TaskDAG nodes from GoalDecomposer.
+     */
+    static fromTaskList(tasks: Array<{
+        id: string;
+        description: string;
+        agent?: string;
+        dependencies: string[];
+        metadata?: Record<string, unknown>;
+    }>, rootLabel?: string, options?: WorkTreeOptions): WorkTree;
+    /** Collect all node ids in a subtree (including the root of the subtree). */
+    private collectSubtree;
+    /** Re-compute progress and auto-status from a node up to root. */
+    private rollupFrom;
+    /** Recompute totalTokens for a single node from its children. */
+    private recomputeTokens;
+    /** Rollup token totals from a node up to root. */
+    private rollupTokensFrom;
+    /** Block all pending descendants of a node. */
+    private blockDescendants;
+    /** Check if the entire tree is done and emit tree:complete. */
+    private checkTreeComplete;
+}
+//# sourceMappingURL=work-tree.d.ts.map

package/dist/lib/work-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-tree.d.ts","sourceRoot":"","sources":["../../lib/work-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,sBAAsB;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAClF,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,eAAe,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACjD;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;gBAG/C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe;IAiC3B;;;OAGG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,QAAQ;IAoCX;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAoCjC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAyBnD;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB3C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAKzC,yBAAyB;IACzB,OAAO,IAAI,QAAQ;IAInB,qCAAqC;IACrC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE;IAQnC,uEAAuE;IACvE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE;IAYpC,yCAAyC;IACzC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE;IAatC,wCAAwC;IACxC,SAAS,IAAI,QAAQ,EAAE;IAUvB,wBAAwB;IACxB,IAAI,IAAI,MAAM;IAId,wBAAwB;IACxB,SAAS,IAAI,MAAM;IAInB,oCAAoC;IACpC,KAAK,IAAI,aAAa;IA0BtB,uCAAuC;IACvC,QAAQ,IAAI,gBAAgB;IAa5B;;OAEG;IACH,OAAO,IAAI,QAAQ,EAAE;IAcrB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,EACF,SAAS,SAAS,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,QAAQ;IAsEX,6EAA6E;IAC7E,OAAO,CAAC,cAAc;IAUtB,kEAAkE;IAClE,OAAO,CAAC,UAAU;IA6DlB,iEAAiE;IACjE,OAAO,CAAC,eAAe;IASvB,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAUxB,+CAA+C;IAC/C,OAAO,CAAC,gBAAgB;IAkBxB,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;CAW1B"}