@wrongstack/core 0.284.1 → 0.286.0

package/dist/coordination/autonomous-coordinator.d.ts

@@ -0,0 +1,243 @@
+/**
+ * CoordinatorEvent — union of all event types emitted by the AutonomousCoordinator.
+ * Consumed by the TUI to drive coordinator panel state and the reducer.
+ */
+export type CoordinatorEvent = {
+    type: 'goal:added';
+    goalId: string;
+    title?: string;
+    text?: string;
+    participants?: string[];
+} | {
+    type: 'goal:completed';
+    goalId: string;
+    text?: string;
+    participants?: string[];
+} | {
+    type: 'goal:failed';
+    goalId: string;
+    text?: string;
+} | {
+    type: 'task:ready';
+    goalId: string;
+    taskId: string;
+    title?: string;
+    assignedTo?: string;
+    text?: string;
+} | {
+    type: 'task:completed';
+    goalId: string;
+    taskId: string;
+    text?: string;
+} | {
+    type: 'knowledge:added';
+    knowledgeId: string;
+    title?: string;
+    text?: string;
+} | {
+    type: 'consensus:reached';
+    goalId: string;
+    text?: string;
+    participants?: string[];
+} | {
+    type: 'deadlock:detected';
+    goalId: string;
+    text?: string;
+} | {
+    type: 'coordinator:mode';
+    mode: 'standalone' | 'fleet';
+};
+import type { EventBus } from '../kernel/events.js';
+import type { Logger } from '../types/logger.js';
+import type { FleetBus } from './fleet-bus.js';
+import type { FleetManager } from './fleet-manager.js';
+import type { Mailbox } from './mailbox-types.js';
+import type { FactNode, GoalNode, FactCategory } from './knowledge-graph.js';
+import type { Director } from './director.js';
+import { KnowledgeGraph } from './knowledge-graph.js';
+import { TaskDAG } from './task-dag.js';
+import { TaskAuctioneer } from './task-auctioneer.js';
+import { ConsensusProtocol } from './consensus-protocol.js';
+import { ChangeManager } from './change-manager.js';
+import { AutonomousBrain, type LLMProvider } from './autonomous-brain.js';
+export interface AutonomousCoordinatorOptions {
+    sessionDir: string;
+    selfAgentId: string;
+    selfAgentName: string;
+    fleet?: FleetBus | undefined;
+    fleetManager?: FleetManager | undefined;
+    director?: Director | undefined;
+    mailbox?: Mailbox | undefined;
+    events?: EventBus | undefined;
+    llmProvider: LLMProvider;
+    /** Disable self-improvement. Default: false. */
+    disableSelfImprove?: boolean;
+    /** Max concurrent subagents. Default: 5. */
+    maxConcurrentAgents?: number;
+    /**
+     * Called with every CoordinatorEvent so the caller (e.g. execution.ts)
+     * can forward it to the TUI coordinator panel timeline.
+     */
+    onCoordinatorEvent?: (event: CoordinatorEvent) => void;
+    /** Logger for structured error events. Falls back to console.error when omitted. */
+    logger?: Logger | undefined;
+}
+export interface RunOptions {
+    /** Top-level goal description. Default: "Improve the codebase". */
+    goal?: string;
+    /** If true, the loop runs until all goals are done (no timeout). Default: false. */
+    runUntilComplete?: boolean;
+    /** Max iterations. Default: 100. */
+    maxIterations?: number;
+    /** Stop if cost exceeds this. Default: no limit. */
+    maxCostUsd?: number;
+}
+export interface CoordinatorStats {
+    goals: {
+        total: number;
+        done: number;
+        pending: number;
+        failed: number;
+        progress: number;
+    };
+    dag: ReturnType<TaskDAG['stats']>;
+    auction: ReturnType<TaskAuctioneer['getStats']>;
+    changes: {
+        proposed: number;
+        approved: number;
+        applied: number;
+        rejected: number;
+    };
+    decisions: number;
+    costSoFar?: number | undefined;
+}
+/**
+ * AutonomousCoordinator — wires all coordination components into one engine.
+ *
+ * ## Quick start
+ *
+ * ```typescript
+ * const coord = new AutonomousCoordinator({
+ *   sessionDir: '/tmp/session',
+ *   selfAgentId: 'director-1',
+ *   selfAgentName: 'Director',
+ *   llmProvider: myLLMProvider,
+ *   fleet: myFleetBus,
+ *   mailbox: myMailbox,
+ * });
+ *
+ * // Run a self-directing session
+ * await coord.run({ goal: 'Audit and fix all security issues in the auth module' });
+ * ```
+ */
+export declare class AutonomousCoordinator {
+    readonly graph: KnowledgeGraph;
+    readonly dag: TaskDAG;
+    readonly auction: TaskAuctioneer;
+    readonly consensus: ConsensusProtocol;
+    readonly changes: ChangeManager;
+    readonly brain: AutonomousBrain;
+    private readonly selfAgentId;
+    private readonly fleet?;
+    private readonly fleetManager?;
+    private readonly director?;
+    private readonly mailbox?;
+    private readonly events?;
+    private readonly onCoordinatorEvent?;
+    private readonly logger;
+    private running;
+    private iterationCount;
+    private lastSyncAt;
+    private static readonly SYNC_INTERVAL_MS;
+    /** Tasks already handled by _onSubagentTerminated (to avoid double goal:failed on fleet event). */
+    private readonly _handledBySubagent;
+    /** FleetBus subscription disposers, detached in dispose(). */
+    private readonly unsubs;
+    constructor(opts: AutonomousCoordinatorOptions);
+    /**
+     * Run the autonomous loop until the goal is satisfied or max iterations reached.
+     * This is the main entry point for a fully autonomous session.
+     */
+    run(opts?: RunOptions): Promise<CoordinatorStats>;
+    /** Stop the autonomous loop. */
+    stop(): void;
+    /**
+     * Report that a terminal worker (not a Director subagent) completed a claimed
+     * task. This updates the auction, DAG, publishes a task-result fact, and
+     * extracts follow-up goals — the same path as subagent completion.
+     */
+    reportTaskCompletion(taskId: string, result: string): Promise<void>;
+    /**
+     * Report that a terminal worker failed a claimed task.
+     */
+    reportTaskFailure(taskId: string, error: string): Promise<void>;
+    /**
+     * Reload the KnowledgeGraph from disk and sync the in-memory DAG with any
+     * changes published by other terminal sessions. New goals are added to the
+     * DAG; existing goals whose status changed (e.g. completed by another
+     * terminal) are transitioned accordingly.
+     *
+     * Safe to call at any time — also used internally by the run loop.
+     */
+    syncFromGraph(): Promise<void>;
+    private _syncDagStatuses;
+    private _maybeSyncFromGraph;
+    /**
+     * Tear down the coordinator for good: stop the loop and detach all FleetBus
+     * subscriptions (this coordinator's + the auctioneer's) plus any open bid
+     * timers. Call this when discarding the instance (e.g. `/coordinator stop`
+     * that recreates a fresh coordinator on the next start) so handlers and
+     * timers don't accumulate across cycles. `stop()` only pauses the loop.
+     */
+    dispose(): void;
+    /** Get a stats snapshot. */
+    getStats(): CoordinatorStats;
+    /**
+     * Publish a fact discovered by an agent. Facts are immutable and form
+     * the basis for other agents' decisions.
+     */
+    publishFact(input: {
+        category: FactCategory;
+        subject: string;
+        detail: string;
+        file?: string;
+        line?: number;
+        severity?: 'critical' | 'high' | 'medium' | 'low';
+        tags?: string[];
+    }): Promise<FactNode>;
+    /**
+     * Publish a goal and add it to the DAG.
+     */
+    createGoal(input: {
+        title: string;
+        description: string;
+        priority?: 'critical' | 'high' | 'medium' | 'low';
+        deps?: string[];
+        tags?: string[];
+    }): Promise<GoalNode>;
+    private _waitForDagProgress;
+    private _dagProgressKey;
+    private _rebuildDagFromGraph;
+    private _rebuildDagNode;
+    private _decomposeGoal;
+    private _inferCategory;
+    private _processGoal;
+    private _stringifyTaskResult;
+    private _completeTask;
+    private _publishTaskResultFact;
+    private _createFollowUpGoalsFromResult;
+    private _extractFollowUps;
+    private _failTask;
+    private _recordTaskFailed;
+    private _handlePendingChange;
+    private _onDagEvent;
+    private _onSubagentTerminated;
+    private _fleetStatus;
+    private _buildVoters;
+    private _goalToOptions;
+    private _optionToGoal;
+    private _mailboxBroadcast;
+    /** Emit a CoordinatorEvent to the subscriber (e.g. TUI panel timeline). */
+    private _emit;
+}
+//# sourceMappingURL=autonomous-coordinator.d.ts.map

package/dist/coordination/autonomous-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous-coordinator.d.ts","sourceRoot":"","sources":["../../src/coordination/autonomous-coordinator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1G;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAA;CAAE,CAAC;AAoC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAqB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACvD,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1F,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAkD;IACtF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IACjD,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,YAAY,IAAI,EAAE,4BAA4B,EAgF7C;IAID;;;OAGG;IACG,GAAG,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4I1D;IAED,gCAAgC;IAChC,IAAI,IAAI,IAAI,CAmBX;IAED;;;;OAIG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;IAED;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;IAED;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAInC;IAED,OAAO,CAAC,gBAAgB;YAeV,mBAAmB;IAOjC;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAUd;IAED,4BAA4B;IAC5B,QAAQ,IAAI,gBAAgB,CA4B3B;IAID;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE;QACvB,QAAQ,EAAE,YAAY,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0BpB;IAID;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBpB;IAID,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,eAAe;YAeT,cAAc;IAgC5B,OAAO,CAAC,cAAc;YAWR,YAAY;IA2C1B,OAAO,CAAC,oBAAoB;YAUd,aAAa;YAUb,sBAAsB;YAmBtB,8BAA8B;IAiB5C,OAAO,CAAC,iBAAiB;YAYX,SAAS;IAKvB,OAAO,CAAC,iBAAiB;YAOX,oBAAoB;IAuBlC,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;YAKP,iBAAiB;IAc/B,2EAA2E;IAC3E,OAAO,CAAC,KAAK;CAGd"}

package/dist/coordination/brain-ledger.d.ts

@@ -0,0 +1,142 @@
+/**
+ * BrainDecisionLedger — the Brain's persistent memory + learning loop.
+ *
+ * Every Brain decision already flows over the EventBus (`brain.decision_*`,
+ * `brain.intervention` — emitted by `ObservableBrainArbiter` and
+ * `BrainMonitor`). The ledger subscribes to those events, appends each
+ * decision to a JSONL file, and — the part that makes it a LEARNING loop —
+ * correlates decisions with their real-world outcomes using events the host
+ * already emits, with ZERO changes to the deciders:
+ *
+ *   - budget extensions — `subagent.budget_extended` carries subagentId +
+ *     kind, which deterministically reconstructs the director's decision id
+ *     (`director-budget-<subagentId>-<kind>`). When that subagent's task
+ *     later lands (`subagent.task_completed`), the extension decision gets a
+ *     success/failure outcome: "we granted more budget — did it help?"
+ *   - steers — a `brain.intervention` of the same kind re-triggering within
+ *     the retry window means the previous steer did NOT fix the problem →
+ *     failure outcome for the earlier intervention.
+ *
+ * Outcomes are appended as their own JSONL rows, re-emitted as
+ * `brain.outcome` events for the UI surfaces, and folded into
+ * `digestFor(request)` — a short text block the LLM/council tiers inject
+ * into their decision prompts so the Brain sees how its past similar calls
+ * actually turned out ("the last 3 extends all failed — stop extending").
+ *
+ * The file survives sessions: `start()` seeds the in-memory ring from the
+ * JSONL tail, so learning carries across runs of the same project.
+ *
+ * @module brain-ledger
+ */
+import type { EventBus } from '../kernel/events.js';
+import type { BrainArbiter, BrainDecisionRequest } from './brain.js';
+export interface BrainLedgerEntry {
+    at: number;
+    sessionId?: string | undefined;
+    /** `BrainDecisionRequest.id` this row belongs to. */
+    requestId: string;
+    kind: 'answered' | 'denied' | 'ask_human' | 'intervention' | 'outcome';
+    source?: string | undefined;
+    risk?: string | undefined;
+    question?: string | undefined;
+    optionId?: string | undefined;
+    /** Rationale / deny reason / outcome detail (truncated). */
+    detail?: string | undefined;
+    outcome?: 'success' | 'failure' | undefined;
+}
+export interface BrainDecisionLedgerOptions {
+    events: EventBus;
+    /** JSONL file the ledger appends to (e.g. `<projectDir>/brain-ledger.jsonl`). */
+    filePath: string;
+    /** In-memory ring size (also the seed size read from disk). Default 500. */
+    maxMemoryEntries?: number | undefined;
+    /**
+     * A same-kind BrainMonitor intervention re-triggering within this window
+     * marks the PREVIOUS steer as a failure. Default 10 minutes.
+     */
+    interventionRetryWindowMs?: number | undefined;
+    /** Override the clock for deterministic tests. */
+    now?: (() => number) | undefined;
+}
+/**
+ * Group similar decisions: identical questions about different subjects
+ * (subagent ids, task ids, counts) should share one history. Tokens that
+ * contain a digit are id/number-shaped — collapse them to `#`.
+ */
+export declare function brainDecisionKey(source: string | undefined, question: string): string;
+export interface LedgerGuardBrainArbiterOptions {
+    inner: BrainArbiter;
+    /** Typically `BrainDecisionLedger.failureStreakFor`. */
+    failureStreakFor: (request: Pick<BrainDecisionRequest, 'source' | 'question' | 'id'>) => number;
+    /**
+     * Deny deterministically once this many consecutive failure outcomes are
+     * on record for the request's decision group. Default 3. 0 disables.
+     */
+    denyAfter?: number | undefined;
+}
+/**
+ * Deterministic guard derived from the ledger's outcome history: when the
+ * last `denyAfter` approvals of a decision group ALL ended in observed
+ * failures, the request is denied outright — no LLM call, no council, no
+ * escalation. Deny is safe by contract at every Brain call site ("do not
+ * take the proposed action"), so this converts repeated observed waste
+ * (budget extensions that never help, steers that never stick) into a hard
+ * policy rule. A later observed success resets the streak and lifts the
+ * guard automatically.
+ *
+ * Position OUTSIDE the tiered arbiter (between it and the escalation
+ * router): a guard denial must be terminal, not a fall-through to the
+ * escalation tier where a `recommended: true` option could resurrect the
+ * very action the history condemned.
+ */
+export declare function createLedgerGuardBrainArbiter(opts: LedgerGuardBrainArbiterOptions): BrainArbiter;
+export declare class BrainDecisionLedger {
+    private readonly opts;
+    private readonly entries;
+    private readonly outcomeByRequest;
+    /** subagentId → decision request ids awaiting that subagent's task result. */
+    private readonly pendingBudgetOutcomes;
+    private readonly lastInterventionByKind;
+    private readonly unsubscribers;
+    /** Serialized fire-and-forget writes — awaited by `stop()` (drain). */
+    private writeChain;
+    private dirReady;
+    private readonly maxMemoryEntries;
+    private readonly retryWindowMs;
+    private readonly now;
+    constructor(opts: BrainDecisionLedgerOptions);
+    /**
+     * Subscribe to the EventBus and seed the in-memory ring from the JSONL
+     * tail. The returned promise resolves once the seed load finished
+     * (best-effort — a missing/corrupt file is an empty history, not an error).
+     */
+    start(): Promise<void>;
+    /** Unsubscribe and drain pending writes. Safe to call twice. */
+    stop(): Promise<void>;
+    /**
+     * Attach a real-world outcome to an earlier decision. Appended to the
+     * JSONL, folded into future digests, and re-emitted as `brain.outcome`.
+     */
+    recordOutcome(requestId: string, outcome: 'success' | 'failure', detail?: string, sessionId?: string): void;
+    /** Last `n` ledger rows, oldest first. */
+    tail(n: number): BrainLedgerEntry[];
+    /**
+     * Consecutive most-recent FAILURE outcomes among answered decisions of
+     * this request's group. Decisions whose outcome is still unknown are
+     * skipped (they neither extend nor break the streak); the first known
+     * SUCCESS ends it. Powers the deterministic ledger guard: "the last K
+     * times we approved this, it went wrong — stop approving".
+     */
+    failureStreakFor(request: Pick<BrainDecisionRequest, 'source' | 'question' | 'id'>): number;
+    /**
+     * Short decision-history block for the LLM/council prompt: how similar
+     * past decisions went and — when known — how they turned OUT. Returns
+     * undefined when there is no relevant history (no prompt noise).
+     */
+    digestFor(request: Pick<BrainDecisionRequest, 'source' | 'question' | 'id'>): string | undefined;
+    private record;
+    private append;
+    /** Seed the in-memory ring from the JSONL tail (cross-session learning). */
+    private load;
+}
+//# sourceMappingURL=brain-ledger.d.ts.map

package/dist/coordination/brain-ledger.d.ts.map

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

package/dist/coordination/brain-monitor.d.ts

@@ -0,0 +1,103 @@
+/**
+ * BrainMonitor — the Brain's SELF-ACTIVATION layer.
+ *
+ * The BrainArbiter alone is reactive: subsystems (director, autophase,
+ * eternal engine) ask it questions. The monitor closes the loop the other
+ * way — it WATCHES the live EventBus for distress signals, consults the
+ * Brain proactively, and when the decision calls for it, INTERVENES in the
+ * running work by delivering a corrective steer to the working agent
+ * (steers are folded into the agent's conversation before its next step
+ * via the mailbox loop, so no new plumbing is needed).
+ *
+ * Watched signals:
+ *   - tool-failure streak — the same tool failing N times consecutively
+ *     (default 3). Classic stuck-loop: the agent keeps retrying an
+ *     approach that does not work.
+ *   - error storm — N `error` events within a sliding window (default
+ *     4 in 60s). Something is systematically wrong.
+ *   - agent stall — a run is active (`agent.run.started` without its
+ *     matching completion) but no tool call or iteration progress has been
+ *     observed for `stallMs` (default 5 min). A wedged provider call or a
+ *     dead-loop that produces no work.
+ *   - file churn — the same file edited ≥ N times (default 5) within a
+ *     sliding window (default 10 min). Classic edit/revert oscillation:
+ *     the agent keeps rewriting the same file without converging.
+ *
+ * Decision contract: every consultation offers [steer | continue] with
+ * fallback `continue`, at `medium` risk. Degradation is safe by design:
+ *   - tiered brain with an LLM layer → a real judgement call, with the
+ *     LLM's rationale becoming the steer text;
+ *   - policy-only brain → fallback `continue` → observe, never interfere.
+ *
+ * Every engagement (whether or not it intervened) emits
+ * `brain.intervention` for the TUI/WebUI surfaces, and is rate-limited by
+ * a per-signal cooldown so the Brain never spams the agent.
+ *
+ * @module brain-monitor
+ */
+import type { BrainInterventionKind, EventBus } from '../kernel/events.js';
+import type { BrainArbiter } from './brain.js';
+export type { BrainInterventionKind };
+export interface BrainInterventionInput {
+    subject: string;
+    body: string;
+}
+export interface BrainMonitorOptions {
+    events: EventBus;
+    brain: BrainArbiter;
+    /** Active host session id, read lazily so resume/new-session switches are reflected. */
+    sessionId?: (() => string | undefined) | undefined;
+    /**
+     * Deliver a corrective steer to the working agent(s). Hosts typically
+     * send a `steer` mail to this session's leader via the project
+     * GlobalMailbox — the agent loop injects it before the next LLM call.
+     */
+    intervene: (input: BrainInterventionInput) => Promise<void>;
+    /** Consecutive failures of the SAME tool before engaging. Default 3. */
+    toolFailureStreak?: number | undefined;
+    /** Number of `error` events within the window before engaging. Default 4. */
+    errorStormCount?: number | undefined;
+    /** Sliding window for the error storm signal (ms). Default 60_000. */
+    errorStormWindowMs?: number | undefined;
+    /**
+     * Active run with no observable progress (tool call / iteration) for this
+     * long → agent-stall signal. Default 300_000 (5 min). 0 disables.
+     */
+    stallMs?: number | undefined;
+    /** How often the stall watchdog checks (ms). Default 30_000. */
+    stallCheckIntervalMs?: number | undefined;
+    /** Edits to the SAME file within the churn window before engaging. Default 5. */
+    fileChurnThreshold?: number | undefined;
+    /** Sliding window for the file-churn signal (ms). Default 600_000 (10 min). */
+    fileChurnWindowMs?: number | undefined;
+    /** Minimum gap between engagements of the same signal kind (ms). Default 120_000. */
+    cooldownMs?: number | undefined;
+}
+export declare class BrainMonitor {
+    private readonly opts;
+    private readonly failStreaks;
+    private errorTimestamps;
+    private readonly editTimestamps;
+    private readonly lastEngagedAt;
+    private readonly unsubscribers;
+    private engaging;
+    private activeRuns;
+    private lastProgressAt;
+    private stallTimer;
+    private readonly toolFailureStreak;
+    private readonly errorStormCount;
+    private readonly errorStormWindowMs;
+    private readonly stallMs;
+    private readonly stallCheckIntervalMs;
+    private readonly fileChurnThreshold;
+    private readonly fileChurnWindowMs;
+    private readonly cooldownMs;
+    constructor(opts: BrainMonitorOptions);
+    start(): void;
+    stop(): void;
+    /** Sliding-window count of successful edits per file → churn signal. */
+    private trackFileChurn;
+    private engage;
+    private maybeIntervene;
+}
+//# sourceMappingURL=brain-monitor.d.ts.map

package/dist/coordination/brain-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-monitor.d.ts","sourceRoot":"","sources":["../../src/coordination/brain-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAuC,MAAM,YAAY,CAAC;AAEpF,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,wFAAwF;IACxF,SAAS,CAAC,EAAE,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACnD;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAaD,qBAAa,YAAY;IAoBX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAA6C;IAE/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,YAA6B,IAAI,EAAE,mBAAmB,EASrD;IAED,KAAK,IAAI,IAAI,CAiFZ;IAED,IAAI,IAAI,IAAI,CAYX;IAED,wEAAwE;IACxE,OAAO,CAAC,cAAc;YAwBR,MAAM;YAqDN,cAAc;CA+B7B"}

package/dist/coordination/brain.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Brain coordination primitives.
+ *
+ * Brain is an authority layer above a leader/director but below the human. It is
+ * intentionally modeled as a decision interface first, not as an autonomous
+ * bypass: callers ask for a decision, Brain either answers within policy or
+ * escalates to the human.
+ */
+import type { EventBus } from '../kernel/events.js';
+export type BrainDecisionSource = 'autophase' | 'director' | 'tool' | 'user' | 'system';
+export type BrainRisk = 'low' | 'medium' | 'high' | 'critical';
+export type BrainFallback = 'ask_human' | 'deny' | 'continue';
+export interface BrainDecisionOption {
+    id: string;
+    label: string;
+    consequence?: string | undefined;
+    risk?: BrainRisk | undefined;
+    recommended?: boolean | undefined;
+}
+export interface BrainDecisionRequest {
+    id: string;
+    /** Active host session id for surfaces that multiplex multiple sessions. */
+    sessionId?: string | undefined;
+    source: BrainDecisionSource;
+    question: string;
+    context?: string | undefined;
+    options?: BrainDecisionOption[] | undefined;
+    risk: BrainRisk;
+    /** What a non-LLM/default Brain should do when policy cannot decide safely. */
+    fallback: BrainFallback;
+}
+export type BrainDecision = {
+    type: 'answer';
+    optionId?: string | undefined;
+    text: string;
+    rationale?: string | undefined;
+} | {
+    type: 'ask_human';
+    prompt: string;
+    options?: BrainDecisionOption[] | undefined;
+    rationale?: string | undefined;
+} | {
+    type: 'deny';
+    reason: string;
+};
+export interface BrainArbiter {
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+/**
+ * Event-emitting decorator for any Brain implementation. Hosts wire this around
+ * their actual arbiter so TUI/session surfaces can render Brain decisions
+ * without coupling to the caller that requested the decision.
+ */
+export declare class ObservableBrainArbiter implements BrainArbiter {
+    private readonly inner;
+    private readonly events;
+    constructor(inner: BrainArbiter, events: EventBus);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+export interface BrainDecisionQueueOptions {
+    /** Safety fallback if the human never answers. Default: no timeout. */
+    timeoutMs?: number | undefined;
+    /**
+     * Decision to resolve with when the timeout fires. Default: deny.
+     * Headless-leaning hosts pass `terminalPolicyDecision` here so an
+     * unanswered prompt degrades to the safe default instead of a bare deny.
+     */
+    onTimeout?: ((request: BrainDecisionRequest) => BrainDecision) | undefined;
+}
+/**
+ * Bridge between an `ask_human` Brain decision and the UI. It emits the visible
+ * ask-human event, then resolves when the TUI emits `brain.human_answered`.
+ */
+export declare class BrainDecisionQueue {
+    private readonly events;
+    private readonly opts;
+    private readonly pending;
+    private readonly offAnswer;
+    constructor(events: EventBus, opts?: BrainDecisionQueueOptions);
+    requestHumanDecision(request: BrainDecisionRequest): Promise<BrainDecision>;
+    dispose(): void;
+}
+/** Escalation routing for the outermost Brain tier. See `EscalationRoutingBrainArbiter`. */
+export type BrainEscalationMode = 'interactive' | 'headless';
+/**
+ * Resolve an `ask_human` escalation WITHOUT a human — the terminal policy of
+ * a headless Brain. The ladder is deliberately conservative:
+ *
+ *   1. A caller-recommended option at low/medium request risk is chosen —
+ *      the caller already declared it the safe default.
+ *   2. `fallback: 'continue'` requests continue (the caller stated that
+ *      continuing is the safe default when nobody can decide).
+ *   3. Everything else is denied. Denial is always safe by contract: every
+ *      Brain call site treats deny as "do not take the proposed action".
+ *
+ * The rationale names the terminal policy so decision logs/ledgers make the
+ * degradation visible instead of silent.
+ */
+export declare function terminalPolicyDecision(request: BrainDecisionRequest): BrainDecision;
+/**
+ * Outermost escalation tier that never lets an `ask_human` decision leak to
+ * the caller. Routing is read PER DECISION so `/brain mode` switches apply
+ * live:
+ *
+ *   - 'interactive' (and a queue is wired) → prompt the human via the
+ *     `BrainDecisionQueue`, exactly like `HumanEscalatingBrainArbiter`.
+ *   - 'headless' (or no queue) → resolve through `terminalPolicyDecision`.
+ *
+ * This is the layer that makes a fully unattended Brain possible: with mode
+ * 'headless' every decision terminates in answer/deny, never in a blocking
+ * prompt.
+ */
+export declare class EscalationRoutingBrainArbiter implements BrainArbiter {
+    private readonly inner;
+    private readonly queue;
+    private readonly getMode;
+    constructor(inner: BrainArbiter, queue: BrainDecisionQueue | undefined, getMode: () => BrainEscalationMode);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+/**
+ * Decorator that turns `ask_human` into an actual awaited human decision.
+ * The wrapped Brain remains policy-only; this layer owns the UI/event bridge.
+ */
+export declare class HumanEscalatingBrainArbiter implements BrainArbiter {
+    private readonly inner;
+    private readonly queue;
+    constructor(inner: BrainArbiter, queue: BrainDecisionQueue);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+export interface DefaultBrainArbiterOptions {
+    /** Allow deterministic auto-answering for low-risk requests. Default true. */
+    allowLowRiskAutoAnswer?: boolean | undefined;
+}
+/**
+ * Conservative deterministic Brain implementation.
+ *
+ * It only auto-answers low-risk requests when the caller provided a recommended
+ * option. Everything else follows the request fallback. This gives hosts a safe
+ * policy object to wire before an LLM-backed Brain exists.
+ */
+export declare class DefaultBrainArbiter implements BrainArbiter {
+    private readonly allowLowRiskAutoAnswer;
+    constructor(opts?: DefaultBrainArbiterOptions);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+export declare function formatHumanPrompt(request: BrainDecisionRequest): string;
+//# sourceMappingURL=brain.d.ts.map

package/dist/coordination/brain.d.ts.map

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