@wrongstack/core 0.284.0 → 0.285.0

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

@@ -0,0 +1,239 @@
+/**
+ * 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 { 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;
+}
+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 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":"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"}

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

@@ -0,0 +1,74 @@
+/**
+ * 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 (v1):
+ *   - 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.
+ *
+ * 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 { EventBus } from '../kernel/events.js';
+import type { BrainArbiter } from './brain.js';
+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;
+    /** 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 lastEngagedAt;
+    private readonly unsubscribers;
+    private engaging;
+    private readonly toolFailureStreak;
+    private readonly errorStormCount;
+    private readonly errorStormWindowMs;
+    private readonly cooldownMs;
+    constructor(opts: BrainMonitorOptions);
+    start(): void;
+    stop(): void;
+    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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAuC,MAAM,YAAY,CAAC;AAEpF,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,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,qBAAa,YAAY;IAYX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAS;IAEzB,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,UAAU,CAAS;IAEpC,YAA6B,IAAI,EAAE,mBAAmB,EAKrD;IAED,KAAK,IAAI,IAAI,CA2CZ;IAED,IAAI,IAAI,IAAI,CAKX;YAEa,MAAM;YAqDN,cAAc;CA+B7B"}

package/dist/coordination/brain.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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;
+}
+/**
+ * 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;
+}
+/**
+ * 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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"}

package/dist/coordination/change-manager.d.ts

@@ -0,0 +1,151 @@
+/**
+ * ChangeManager — autonomous code change lifecycle management.
+ *
+ * Manages the full lifecycle of proposed code changes:
+ *   PROPOSE → REVIEW (consensus) → APPLY → VERIFY → (ROLLBACK on failure)
+ *
+ * The manager does NOT write files directly — it publishes change nodes to the
+ * KnowledgeGraph and uses the ConsensusProtocol for approvals. File mutations
+ * are performed by agents acting on approved change nodes.
+ *
+ * Quality gates run automatically before approval:
+ * - Tests must pass (or be explicitly waived)
+ * - TypeScript must compile
+ * - No new critical/high security findings
+ * - Lint must pass (or be explicitly ignored)
+ *
+ * Rollback: on failure detection, the manager can propose a rollback change
+ * that reverses the applied change. Rollback changes also go through consensus.
+ *
+ * @module change-manager
+ */
+import type { ChangeNode, QualityGateResult } from './knowledge-graph.js';
+import type { KnowledgeGraph } from './knowledge-graph.js';
+import type { ConsensusProtocol } from './consensus-protocol.js';
+import type { FleetBus } from './fleet-bus.js';
+export interface ChangeFile {
+    path: string;
+    action: 'create' | 'modify' | 'delete';
+    /** For modify: unified diff string */
+    diff?: string;
+    /** For create/modify: full file content */
+    content?: string;
+}
+export interface ChangeProposal {
+    title: string;
+    description: string;
+    files: ChangeFile[];
+    proposedBy: string;
+    satisfiesGoals: string[];
+    tags: string[];
+    /** Quality gate waivers (e.g., ['no-tests', 'lint-errors']) */
+    waivers?: string[];
+    /** Skip consensus vote (for automated/internal refactors only) */
+    skipVote?: boolean;
+}
+export interface ApplyResult {
+    changeId: string;
+    success: boolean;
+    appliedAt: string;
+    filesTouched: string[];
+    verificationResult?: QualityGateResult;
+    rollbackChangeId?: string | undefined;
+    error?: string | undefined;
+}
+export interface RollbackResult {
+    originalChangeId: string;
+    rollbackChangeId: string;
+    success: boolean;
+    rolledBackAt: string;
+    error?: string;
+}
+/** Quality checks performed before applying a change. */
+export interface QualityGateChecks {
+    runTests: boolean;
+    runTypecheck: boolean;
+    runLint: boolean;
+    runSecurityScan: boolean;
+    checkTestCoverage: boolean;
+    minCoveragePercent?: number;
+}
+export interface ChangeManagerOptions {
+    graph: KnowledgeGraph;
+    consensus: ConsensusProtocol;
+    fleet?: FleetBus | undefined;
+    checks?: Partial<QualityGateChecks> | undefined;
+}
+/**
+ * Default quality gate: tests + typecheck + security scan.
+ * Lint and coverage are informational warnings, not blockers.
+ */
+export declare const DEFAULT_QUALITY_CHECKS: QualityGateChecks;
+/**
+ * ChangeManager orchestrates the full change lifecycle.
+ *
+ * ## Workflow
+ * ```
+ * propose() → knowledge graph (proposed)
+ *            → consensus.vote() (approved/rejected)
+ *            → apply() → knowledge graph (applied)
+ *            → verify() → on failure: proposeRollback()
+ * ```
+ */
+export declare class ChangeManager {
+    private readonly graph;
+    private readonly consensus;
+    private readonly fleet?;
+    private readonly checks;
+    /** Track applied changes for rollback lookup. */
+    private readonly appliedChanges;
+    constructor(opts: ChangeManagerOptions);
+    /**
+     * Propose a new code change. Creates a ChangeNode in the knowledge graph.
+     * Does NOT automatically initiate voting — call `submitForReview()` for that.
+     */
+    propose(input: ChangeProposal): Promise<ChangeNode>;
+    /**
+     * Submit an approved change for application.
+     * Returns the change node — actual file mutations are performed by agents
+     * acting on this node's data from the knowledge graph.
+     */
+    submitForReview(changeId: string): Promise<void>;
+    /**
+     * Apply an approved change. Updates the change node to 'applied'.
+     * Agents should watch for 'applied' status and perform the actual file mutations.
+     */
+    markApplied(changeId: string, appliedAt: string): Promise<ChangeNode | null>;
+    /**
+     * Mark a change as applied and trigger rollback for any satisfied goal
+     * that turns out to be broken.
+     */
+    markAppliedWithVerification(changeId: string, verify: () => Promise<QualityGateResult>): Promise<ApplyResult>;
+    /**
+     * Propose a rollback for an applied change. Creates a new change that
+     * reverses the original. Goes through full consensus.
+     */
+    proposeRollback(appliedChangeId: string, reason: string): Promise<ChangeNode | null>;
+    /**
+     * Mark a change as rolled back.
+     */
+    markRolledBack(changeId: string, rolledBackAt: string): Promise<ChangeNode | null>;
+    getPendingReviews(): ChangeNode[];
+    getAppliedChanges(): ChangeNode[];
+    getChange(id: string): ChangeNode | undefined;
+    getChangesForGoal(goalId: string): ChangeNode[];
+    /**
+     * Run quality gate checks. This is informational — actual test/lint/typecheck
+     * execution is done by agents spawned for this purpose. This method stores
+     * the result in the change node.
+     */
+    private _runQualityGate;
+    /**
+     * Update quality gate result for a change. Called by verify agents
+     * after running their checks.
+     */
+    updateQualityGate(changeId: string, checkName: string, result: {
+        passed: boolean;
+        detail?: string;
+    }): Promise<void>;
+    private _emit;
+}
+//# sourceMappingURL=change-manager.d.ts.map

package/dist/coordination/change-manager.d.ts.map

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

package/dist/coordination/checkpoint-wiring.d.ts

@@ -0,0 +1,61 @@
+import type { DirectorStateCheckpoint, DirectorStateSnapshot } from '../storage/director-state.js';
+import type { TaskResult } from '../types/multi-agent.js';
+import type { SessionWriter } from '../types/session.js';
+/**
+ * Narrow interface the helpers in this file need from the Director.
+ * Kept here (instead of importing the full Director class) to avoid a
+ * circular import: director.ts re-exports the helpers.
+ */
+export interface DirectorCheckpointHost {
+    readonly id: string;
+    readonly manifestPath?: string | undefined;
+    readonly manifestDebounceMs: number;
+    readonly stateCheckpoint: DirectorStateCheckpoint | null;
+    readonly sessionWriter: SessionWriter | null;
+    readonly usage: {
+        snapshot(): unknown;
+    };
+    /** The set of { subagentId, taskIds, ... } manifest rows. */
+    readonly manifestEntries: Map<string, unknown>;
+    /** Final status of completed tasks, indexed by taskId. */
+    readonly completed: Map<string, TaskResult>;
+    /**
+     * Called from async failure paths in the manifest writer — when the
+     * debounced flush or atomic write fails. Implementations funnel
+     * through `process.emitWarning` so the director can be torn down
+     * even when manifests are unwritable.
+     */
+    logShutdownError(phase: string, err: unknown): void;
+}
+/** Best-effort session-writer append. Swallows failures — the director
+ *  must not break a fleet run because the session JSONL handle closed. */
+export declare function appendSessionEvent(host: DirectorCheckpointHost, event: Parameters<SessionWriter['append']>[0]): Promise<void>;
+/** Debounced manifest writer. A burst of spawn/assign/complete events
+ *  collapses into one write. Set `manifestDebounceMs` to 0 to write
+ *  synchronously (no debounce); set to negative to disable entirely.
+ *
+ * Returns the new `setTimeout` handle (or `null` if no timer was
+ * scheduled) so the caller can cancel it on shutdown. */
+export declare function scheduleManifest(host: DirectorCheckpointHost): NodeJS.Timeout | null;
+/**
+ * Write the fleet manifest to `manifestPath`. Returns the path written
+ * or null when no path was configured. Captures every spawn + its
+ * assigned tasks — paired with per-subagent JSONLs, this is enough to
+ * replay an entire director run.
+ */
+export declare function writeManifest(host: DirectorCheckpointHost): Promise<string | null>;
+/** Push a snapshot into the on-disk checkpoint (delegated). */
+export declare function setCheckpointState(host: DirectorCheckpointHost, snapshot: DirectorStateSnapshot): void;
+/**
+ * Attempt to acquire the checkpoint lock. Must be called before
+ * resuming — if another director process is alive, this returns
+ * false and the caller should not proceed with the resume.
+ */
+export declare function acquireCheckpointLock(host: DirectorCheckpointHost): Promise<boolean>;
+/**
+ * Resume from a prior checkpoint snapshot (loaded via
+ * `loadDirectorState()`). Re-attach to the fleet mid-flight so
+ * subsequent spawn/assign calls update the checkpoint normally.
+ */
+export declare function resumeFromCheckpoint(host: DirectorCheckpointHost, snapshot: DirectorStateSnapshot): void;
+//# sourceMappingURL=checkpoint-wiring.d.ts.map

package/dist/coordination/checkpoint-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-wiring.d.ts","sourceRoot":"","sources":["../../src/coordination/checkpoint-wiring.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACnG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,IAAI,OAAO,CAAA;KAAE,CAAC;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD;AAED;0EAC0E;AAC1E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;yDAKyD;AACzD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAWpF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuCxF;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,EAC5B,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,sBAAsB,EAC5B,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAEN"}