@jaggerxtrm/specialists 3.7.1 → 3.10.0

package/dist/types/constants.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Constants and configuration for Specialists MCP server
+ */
+export declare const LOG_PREFIX = "[specialists]";
+export declare const AI_MODELS: {
+    readonly GEMINI: {
+        readonly PRIMARY: "gemini-3-pro-preview";
+        readonly FLASH: "gemini-3-flash-preview";
+        readonly PRO_2_5: "gemini-2.5-pro";
+        readonly FLASH_2_5: "gemini-2.5-flash";
+        readonly FLASH_LITE: "gemini-2.5-flash-lite";
+    };
+    readonly CURSOR_AGENT: {
+        readonly GPT_5_1: "gpt-5.1";
+        readonly GPT_5: "gpt-5";
+        readonly COMPOSER_1: "composer-1";
+        readonly SONNET_4_5: "sonnet-4.5";
+        readonly HAIKU_5: "haiku-5";
+        readonly DEEPSEEK_V3: "deepseek-v3";
+    };
+    readonly DROID: {
+        readonly PRIMARY: "glm-4.6";
+    };
+};
+export declare const CLI: {
+    readonly COMMANDS: {
+        readonly GEMINI: "gemini";
+        readonly CURSOR_AGENT: "cursor-agent";
+        readonly DROID: "droid";
+        readonly ECHO: "echo";
+    };
+    readonly FLAGS: {
+        readonly GEMINI: {
+            readonly SANDBOX: "-s";
+            readonly HELP: "-help";
+            readonly MODEL: "--model";
+        };
+        readonly CURSOR: {
+            readonly PROMPT: "-p";
+            readonly OUTPUT: "--output-format";
+            readonly PRINT: "--print";
+            readonly FORCE: "--force";
+            readonly FILE: "--file";
+        };
+        readonly DROID: {
+            readonly EXEC: "exec";
+            readonly AUTO: "--auto";
+            readonly OUTPUT: "--output-format";
+            readonly SESSION: "--session-id";
+            readonly SKIP_PERMISSIONS: "--skip-permissions-unsafe";
+            readonly FILE: "--file";
+            readonly CWD: "--cwd";
+        };
+        readonly ROVODEV: {
+            readonly RUN: "run";
+            readonly YOLO: "--yolo";
+            readonly RESTORE: "--restore";
+            readonly CONFIG: "--config-file";
+        };
+        readonly QWEN: {
+            readonly SANDBOX: "-s";
+            readonly YOLO: "-y";
+            readonly OUTPUT: "-o";
+            readonly INTERACTIVE: "-i";
+        };
+    };
+};
+export declare const ERROR_MESSAGES: {
+    readonly NO_PROMPT_PROVIDED: "No prompt provided. Please include a prompt in your request.";
+    readonly TOOL_NOT_FOUND: "Tool not found in registry";
+    readonly INVALID_ARGUMENTS: "Invalid tool arguments";
+    readonly EXECUTION_FAILED: "Tool execution failed";
+    readonly QUOTA_EXCEEDED: "Quota exceeded for primary model, attempting fallback...";
+    readonly VALIDATION_FAILED: "Tool response validation failed";
+};
+export declare const STATUS_MESSAGES: {
+    readonly THINKING: "🤔 Thinking...";
+    readonly PROCESSING: "⚙️ Processing...";
+    readonly SEARCHING: "🔍 Searching...";
+    readonly EXECUTING: "🚀 Executing...";
+    readonly COMPLETED: "✅ Analysis complete";
+    readonly FAILED: "❌ Analysis failed";
+    readonly STARTING_ANALYSIS: "🚀 Starting analysis...";
+};
+export declare const MCP_CONFIG: {
+    readonly SERVER_NAME: "specialists";
+    readonly VERSION: "1.0.0";
+    readonly CAPABILITIES: {
+        readonly tools: {};
+        readonly prompts: {};
+        readonly logging: {};
+    };
+    readonly KEEP_ALIVE_INTERVAL: 25000;
+};
+export declare const APPROVAL_MODES: {
+    readonly PLAN: "plan";
+    readonly DEFAULT: "default";
+    readonly AUTO_EDIT: "auto-edit";
+    readonly YOLO: "yolo";
+};
+export declare const BACKENDS: {
+    readonly GEMINI: "ask-gemini";
+    readonly CURSOR: "ask-cursor";
+    readonly DROID: "ask-droid";
+    readonly ROVODEV: "ask-rovodev";
+    readonly QWEN: "ask-qwen";
+};
+export { BACKENDS as default };
+export type GeminiModel = typeof AI_MODELS.GEMINI[keyof typeof AI_MODELS.GEMINI];
+export type ApprovalMode = typeof APPROVAL_MODES[keyof typeof APPROVAL_MODES];
+export type BackendType = typeof BACKENDS[keyof typeof BACKENDS];
+/**
+ * Agent role descriptions and configurations
+ *
+ * Defines the specialization and preferred backend for each agent type
+ */
+export declare const AGENT_ROLES: {
+    readonly ARCHITECT: {
+        /**
+         * AI backend used for execution (e.g., "gemini", "cursor-agent", "droid")
+         */
+        readonly backend: "ask-gemini";
+        readonly specialization: "High-level system design, architecture analysis, and strategic planning";
+        readonly description: "Uses Gemini for deep architectural reasoning, security analysis, and long-term design decisions";
+    };
+    readonly IMPLEMENTER: {
+        readonly name: "ImplementerAgent";
+        readonly backend: "ask-droid";
+        readonly fallbackBackend: undefined;
+        readonly specialization: "Precise code implementation with production-quality standards";
+        readonly description: "Uses Droid (GLM-4.6) for autonomous agentic tasks and implementation";
+    };
+    readonly TESTER: {
+        readonly name: "TesterAgent";
+        readonly backend: "ask-cursor";
+        readonly specialization: "Fast test generation and validation";
+        readonly description: "Uses Cursor Agent (Sonnet 4.5) for rapid test case generation and validation";
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAE1C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;CAmBZ,CAAC;AAEX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CN,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;;CAQlB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAGX,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,CAAC;AAE/B,MAAM,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAC9E,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,WAAW;;QAEpB;;WAEG;;;;;;;;;;;;;;;;;;CAkBG,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Specialists MCP Server — entry point
+ * Subcommands: install, version, list, view, models, init, db, validate, edit, config, run,
+ *              status, ps, result, feed, poll, clean, merge, epic, end, stop, attach, quickstart, serve, script, help
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/types/lib.d.ts

@@ -0,0 +1,5 @@
+export { runScriptSpecialist as runScript, } from './specialist/script-runner.js';
+export type { ScriptGenerateRequest, ScriptGenerateResult, ScriptGenerateSuccess, ScriptGenerateFailure, ScriptSpecialistErrorType, ScriptRunnerOptions, } from './specialist/script-runner.js';
+export { SpecialistLoader } from './specialist/loader.js';
+export type { Specialist } from './specialist/schema.js';
+//# sourceMappingURL=lib.d.ts.map

package/dist/types/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,mBAAmB,IAAI,SAAS,GACjC,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/pi/backendMap.d.ts

@@ -0,0 +1,3 @@
+export declare function mapSpecialistBackend(model: string): string;
+export declare function getProviderArgs(model: string): string[];
+//# sourceMappingURL=backendMap.d.ts.map

package/dist/types/pi/backendMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendMap.d.ts","sourceRoot":"","sources":["../../../src/pi/backendMap.ts"],"names":[],"mappings":"AAcA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASvD"}

package/dist/types/pi/session.d.ts

@@ -0,0 +1,209 @@
+export declare class SessionKilledError extends Error {
+    constructor();
+}
+export declare class StallTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export interface AgentSessionMeta {
+    backend: string;
+    model: string;
+    sessionId: string;
+    startedAt: Date;
+}
+export interface SessionTokenUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_creation_tokens?: number;
+    cache_read_tokens?: number;
+    total_tokens?: number;
+    cost_usd?: number;
+}
+export interface SessionRunMetrics {
+    token_usage?: SessionTokenUsage;
+    finish_reason?: string;
+    exit_reason?: string;
+    turns?: number;
+    tool_calls?: number;
+    tool_call_names?: string[];
+    auto_compactions?: number;
+    auto_retries?: number;
+    api_error?: string;
+}
+export type SessionMetricEvent = {
+    type: 'token_usage';
+    token_usage: SessionTokenUsage;
+    source: 'message_done' | 'turn_end' | 'agent_end';
+} | {
+    type: 'finish_reason';
+    finish_reason: string;
+    source: 'message_done' | 'turn_end' | 'agent_end';
+} | {
+    type: 'turn_summary';
+    turn_index: number;
+    token_usage?: SessionTokenUsage;
+    finish_reason?: string;
+} | {
+    type: 'compaction';
+    phase: 'start' | 'end';
+    tokensBefore?: number;
+    summary?: string;
+    firstKeptEntryId?: string;
+} | {
+    type: 'retry';
+    phase: 'start' | 'end';
+    attempt?: number;
+    maxAttempts?: number;
+    delayMs?: number;
+    errorMessage?: string;
+} | {
+    type: 'model_change';
+    action: 'set_model' | 'cycle_model';
+    model?: string;
+    previousModel?: string;
+} | {
+    type: 'extension_error';
+    extension?: string;
+    errorMessage?: string;
+} | {
+    type: 'api_error';
+    source: 'rpc' | 'stderr';
+    errorMessage: string;
+};
+export interface PiSessionOptions {
+    model: string;
+    systemPrompt?: string;
+    /** Absolute path boundary for write-side tools; undefined disables enforcement */
+    worktreeBoundary?: string;
+    /** Permission level from specialist YAML — controls which pi tools are enabled */
+    permissionLevel?: string;
+    /** Skill files loaded via pi --skill (injected into system prompt natively) */
+    skillPaths?: string[];
+    /** Thinking level passed as pi --thinking <level> */
+    thinkingLevel?: string;
+    /** Working directory for the pi process — defaults to process.cwd() if not set */
+    cwd?: string;
+    /** Extra environment variables injected into the pi process */
+    env?: Record<string, string>;
+    /** npm extension package names to skip when assembling pi -e args */
+    excludeExtensions?: string[];
+    /** Called with each text token as it arrives */
+    onToken?: (delta: string) => void;
+    /** Called with each thinking token */
+    onThinking?: (delta: string) => void;
+    /** Called with tool name, optional args payload, and optional tool call ID when a tool starts executing */
+    onToolStart?: (tool: string, args?: Record<string, unknown>, toolCallId?: string) => void;
+    /** Called with tool name, error flag, optional tool call ID, summarized result content, and optional raw result payload */
+    onToolEnd?: (tool: string, isError: boolean, toolCallId?: string, resultContent?: string, resultRaw?: Record<string, unknown>) => void;
+    /** Called with the raw pi event type (for job status tracking) */
+    onEvent?: (type: string, details?: {
+        charCount?: number;
+        toolCallId?: string;
+        model?: string;
+        previousModel?: string;
+        action?: 'set_model' | 'cycle_model';
+        extension?: string;
+        errorMessage?: string;
+        tokensBefore?: number;
+        summary?: string;
+        firstKeptEntryId?: string;
+        attempt?: number;
+        maxAttempts?: number;
+        delayMs?: number;
+    }) => void;
+    /** Called with additive observability metrics derived from RPC events */
+    onMetric?: (event: SessionMetricEvent) => void;
+    /** Called once with actual backend/model from the first assistant message_start */
+    onMeta?: (meta: {
+        backend: string;
+        model: string;
+    }) => void;
+    /** Kill and fail if no streaming/protocol activity occurs within this window */
+    stallTimeoutMs?: number;
+    /** Extended stall timeout used while known test commands run via bash tool */
+    testCommandStallTimeoutMs?: number;
+}
+export declare function validateWriteToolPathAgainstBoundary(toolName: string, toolArgs: Record<string, unknown> | undefined, worktreeBoundary: string | undefined): string | undefined;
+export declare class PiAgentSession {
+    private options;
+    private proc?;
+    private _lastOutput;
+    private _donePromise?;
+    private _doneResolve?;
+    private _doneReject?;
+    private _agentEndReceived;
+    private _killed;
+    private _lineBuffer;
+    private _pendingRequests;
+    private _nextRequestId;
+    private _stderrBuffer;
+    private _apiError?;
+    private _stallTimer?;
+    private _stallError?;
+    private _testWindowToolCallIds;
+    private _testWindowWithoutIdCount;
+    private _metrics;
+    readonly meta: AgentSessionMeta;
+    private constructor();
+    static create(options: PiSessionOptions): Promise<PiAgentSession>;
+    start(): Promise<void>;
+    private _clearStallTimer;
+    private _isTestWindowActive;
+    private _resolveStallTimeoutMs;
+    private _activateTestWindow;
+    private _deactivateTestWindow;
+    private _markActivity;
+    private _updateTokenUsage;
+    private _updateFinishReason;
+    private _handleEvent;
+    /**
+     * Send a JSON command to pi's stdin and return a promise for the response.
+     * Each call is assigned a unique ID; concurrent calls are supported.
+     */
+    private sendCommand;
+    /**
+     * Write the prompt to pi's stdin and await the RPC ack.
+     * Stdin is kept open for subsequent RPC commands.
+     * Call waitForDone() to block until agent_end, then close() to terminate.
+     */
+    prompt(task: string): Promise<void>;
+    /**
+     * Wait for the agent to finish. Optionally times out (throws Error on timeout).
+     */
+    waitForDone(timeout?: number): Promise<void>;
+    /**
+     * Get the last assistant output text. Tries RPC first, falls back to in-memory capture.
+     */
+    getLastOutput(): Promise<string>;
+    /**
+     * Get current session state via RPC.
+     */
+    getState(): Promise<any>;
+    getMetrics(): SessionRunMetrics;
+    /**
+     * Close the pi process cleanly by ending stdin (EOF) and waiting for exit.
+     */
+    close(): Promise<void>;
+    kill(reason?: Error): void;
+    /** Returns accumulated stderr output from the pi process. */
+    getStderr(): string;
+    /**
+     * Send a mid-run steering message to the Pi agent and await the RPC ack.
+     * Pi delivers it after the current assistant turn finishes tool calls.
+     */
+    steer(message: string): Promise<void>;
+    /**
+     * Queue a follow_up on the Pi session using pi's native follow_up RPC command.
+     * This is distinct from resume(): follow_up queues work during a still-running turn,
+     * while resume() sends a next-turn prompt to a waiting (idle) session.
+     *
+     * Not yet implemented — reserved to prevent semantic drift with pi's native follow_up.
+     */
+    followUp(_task: string): never;
+    /**
+     * Start a new turn on the same Pi session (keep-alive multi-turn).
+     * Resets done state and sends a new prompt — Pi retains full conversation history.
+     * Only valid after waitForDone() has resolved for the previous turn.
+     */
+    resume(task: string, timeout?: number): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/types/pi/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/pi/session.ts"],"names":[],"mappings":"AACA,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,SAAS,EAAE,MAAM;CAI9B;AA2CD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,CAAA;CAAE,GAC1G;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,CAAA;CAAE,GACnG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAClH;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1H;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sCAAsC;IACtC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,2GAA2G;IAC3G,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1F,2HAA2H;IAC3H,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACvI,kEAAkE;IAClE,OAAO,CAAC,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;QACrC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KACE,IAAI,CAAC;IACV,yEAAyE;IACzE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,mFAAmF;IACnF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5D,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAmQD,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,MAAM,GAAG,SAAS,CAcpB;AAkED,qBAAa,cAAc;IA0BvB,OAAO,CAAC,OAAO;IAzBjB,OAAO,CAAC,IAAI,CAAC,CAAe;IAC5B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,WAAW,CAAC,CAAqB;IACzC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,gBAAgB,CAAsH;IAC9I,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAgC;IACpD,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,sBAAsB,CAAqB;IACnD,OAAO,CAAC,yBAAyB,CAAK;IACtC,OAAO,CAAC,QAAQ,CAKd;IACF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,OAAO;WAOM,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAYjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmI5B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,YAAY;IAoPpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC;;OAEG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAetC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;IAY9B,UAAU,IAAI,iBAAiB;IAI/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI;IAqB1B,6DAA6D;IAC7D,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK;IAI9B;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB5D"}

package/dist/types/server.d.ts

@@ -0,0 +1,10 @@
+export declare class SpecialistsServer {
+    private server;
+    private tools;
+    constructor();
+    private toolSchemas;
+    private setupHandlers;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AA6BA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAY;;IAqBzB,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,aAAa;IAwDf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/types/specialist/beads.d.ts

@@ -0,0 +1,60 @@
+export interface BeadDependency {
+    id: string;
+    title?: string;
+    description?: string;
+    notes?: string;
+    status?: string;
+    dependency_type?: string;
+}
+export interface BeadRecord {
+    id: string;
+    title: string;
+    description?: string;
+    notes?: string;
+    parent?: string;
+    status?: string;
+    dependencies?: BeadDependency[];
+}
+export declare function buildBeadContext(bead: BeadRecord, completedBlockers?: BeadRecord[]): string;
+export declare class BeadsClient {
+    private readonly available;
+    constructor();
+    private static checkAvailable;
+    isAvailable(): boolean;
+    /** Create a bead for a specialist run. Returns the bead ID or null on failure. */
+    createBead(specialistName: string): string | null;
+    /** Read a bead by ID. Returns null on any failure. */
+    readBead(id: string): BeadRecord | null;
+    /**
+     * Fetch completed blockers of a bead at the given depth.
+     * depth=1 returns immediate completed blockers only.
+     * depth=2 also includes their completed blockers, etc.
+     */
+    getCompletedBlockers(id: string, depth?: number): BeadRecord[];
+    /** Link a tracking bead back to the input bead that supplied the prompt. */
+    addDependency(trackingBeadId: string, inputBeadId: string): void;
+    /** Close a bead with COMPLETE or ERROR status. */
+    closeBead(id: string, status: 'COMPLETE' | 'ERROR' | 'CANCELLED', durationMs: number, model: string): void;
+    /**
+     * Close a bead only if it is currently open or in_progress.
+     * Idempotent: no-op when bead is already closed/deferred/blocked or unreadable.
+     * Used by supervisor terminal-state writes and `sp stop` to retire linked beads automatically (unitAI-9truh).
+     */
+    closeBeadIfInProgress(id: string, reason: string): boolean;
+    /** Append bead notes with specialist output or metadata. */
+    updateBeadNotes(id: string, notes: string): {
+        ok: boolean;
+        error?: string;
+    };
+    /** Record a bd audit entry linking the bead to the specialist invocation. */
+    auditBead(id: string, toolName: string, model: string, exitCode: number): void;
+}
+/**
+ * Determine whether to create a bead for this specialist run.
+ *
+ * auto   — create bead only for non-READ_ONLY specialists (write-capable)
+ * always — always create (discovery specialists: codebase-explorer, init-session)
+ * never  — skip entirely (utility one-offs, fast runs)
+ */
+export declare function shouldCreateBead(beadsIntegration: 'auto' | 'always' | 'never', permissionRequired: string): boolean;
+//# sourceMappingURL=beads.d.ts.map

package/dist/types/specialist/beads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads.d.ts","sourceRoot":"","sources":["../../../src/specialist/beads.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,GAAE,UAAU,EAAO,GAAG,MAAM,CA6B/F;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;;IASpC,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,WAAW,IAAI,OAAO;IAItB,kFAAkF;IAClF,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAYjD,sDAAsD;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAsBvC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,UAAU,EAAE;IAgCzD,4EAA4E;IAC5E,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKhE,kDAAkD;IAClD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1G;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAS1D,4DAA4D;IAC5D,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAgB3E,6EAA6E;IAC7E,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAe/E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAC7C,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAIT"}

package/dist/types/specialist/chain-identity.d.ts

@@ -0,0 +1,18 @@
+import type { SupervisorStatus } from './supervisor.js';
+export declare const CHAIN_KINDS: readonly ["chain", "prep"];
+export type ChainKind = (typeof CHAIN_KINDS)[number];
+export interface PersistedChainIdentity {
+    chain_kind: ChainKind;
+    chain_id?: string;
+    chain_root_job_id?: string;
+    chain_root_bead_id?: string;
+}
+export interface ChainIdentityResolverInput extends Pick<SupervisorStatus, 'id' | 'bead_id' | 'worktree_path' | 'worktree_owner_job_id' | 'chain_id' | 'chain_root_job_id' | 'chain_root_bead_id'> {
+}
+export interface ChainRootSnapshot {
+    bead_id?: string;
+    chain_root_bead_id?: string;
+}
+export declare function isChainKind(value: string | undefined): value is ChainKind;
+export declare function derivePersistedChainIdentity(status: ChainIdentityResolverInput, chainRootSnapshot?: ChainRootSnapshot): PersistedChainIdentity;
+//# sourceMappingURL=chain-identity.d.ts.map

package/dist/types/specialist/chain-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-identity.d.ts","sourceRoot":"","sources":["../../../src/specialist/chain-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,eAAO,MAAM,WAAW,4BAA6B,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,eAAe,GAAG,uBAAuB,GAAG,UAAU,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;CAAG;AAErM,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAEzE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,0BAA0B,EAClC,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,sBAAsB,CAuBxB"}

package/dist/types/specialist/epic-lifecycle.d.ts

@@ -0,0 +1,57 @@
+import type { SupervisorStatus } from './supervisor.js';
+/**
+ * Epic lifecycle is independent from node lifecycle:
+ * - epic: merge-gated publication lifecycle for wave-bound chain groups
+ * - chain: worktree lineage rooted at worktree_owner_job_id
+ * - job: one specialist run
+ * - node: coordinator/member runtime lifecycle
+ */
+export declare const EPIC_STATES: readonly ["open", "resolving", "merge_ready", "merged", "failed", "abandoned"];
+export type EpicState = (typeof EPIC_STATES)[number];
+export declare const EPIC_TERMINAL_STATES: readonly ["merged", "failed", "abandoned"];
+export declare const VALID_EPIC_TRANSITIONS: Record<EpicState, readonly EpicState[]>;
+export interface EpicRunRecord {
+    epic_id: string;
+    status: EpicState;
+    updated_at_ms: number;
+    status_json: string;
+}
+export interface EpicChainRecord {
+    chain_id: string;
+    epic_id: string;
+    chain_root_bead_id?: string;
+    chain_root_job_id?: string;
+    updated_at_ms: number;
+}
+export interface EpicReadinessInput {
+    epicId: string;
+    epicStatus: EpicState;
+    chainStatuses: ReadonlyArray<{
+        chainId: string;
+        hasRunningJob: boolean;
+    }>;
+}
+export interface EpicReadinessResult {
+    epicId: string;
+    epicStatus: EpicState;
+    isReady: boolean;
+    blockingChains: string[];
+    summary: string;
+}
+export declare function isEpicTerminalState(status: EpicState): boolean;
+export declare function isEpicUnresolvedState(status: EpicState): boolean;
+export declare function canTransitionEpicState(from: EpicState, to: EpicState): boolean;
+export declare function transitionEpicState(from: EpicState, to: EpicState): EpicState;
+export declare function resolveChainId(status: Pick<SupervisorStatus, 'id' | 'worktree_path' | 'worktree_owner_job_id' | 'chain_id'>): string | undefined;
+export declare function evaluateEpicMergeReadiness(input: EpicReadinessInput): EpicReadinessResult;
+export interface EpicTransitionAuditEntry {
+    from: EpicState;
+    to: EpicState;
+    at_ms: number;
+    reason?: string;
+    trigger?: string;
+    forced?: boolean;
+}
+export declare function appendEpicTransitionAudit(statusJson: string | undefined, entry: EpicTransitionAuditEntry): string;
+export declare function summarizeEpicTransition(epicId: string, from: EpicState, to: EpicState): string;
+//# sourceMappingURL=epic-lifecycle.d.ts.map

package/dist/types/specialist/epic-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/specialist/epic-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,gFAAiF,CAAC;AAE1G,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,oBAAoB,4CAA6C,CAAC;AAE/E,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAO1E,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAE9D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAE9E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAK7E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,eAAe,GAAG,uBAAuB,GAAG,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAKhJ;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAkCzF;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAyBjH;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,MAAM,CAE9F"}

package/dist/types/specialist/epic-readiness.d.ts

@@ -0,0 +1,55 @@
+import type { EpicRunRecord, EpicState } from './epic-lifecycle.js';
+import type { ObservabilitySqliteClient } from './observability-sqlite.js';
+import type { SupervisorStatus } from './supervisor.js';
+export type ReviewerVerdict = 'pass' | 'partial' | 'fail' | 'missing';
+export type ChainReadinessState = 'pending' | 'blocked' | 'pass' | 'failed';
+export type EpicReadinessState = 'unresolved' | 'resolving' | 'merge_ready' | 'blocked' | 'failed' | 'merged' | 'abandoned';
+interface EvaluatorJob {
+    id: string;
+    specialist: string;
+    status: SupervisorStatus['status'];
+    pid?: number;
+    started_at_ms: number;
+    result_text?: string;
+}
+export interface ChainReadinessSummary {
+    chain_id: string;
+    chain_root_bead_id?: string;
+    state: ChainReadinessState;
+    reviewer_verdict: ReviewerVerdict;
+    blocking_reason?: string;
+    has_active_jobs: boolean;
+    job_ids: string[];
+}
+export interface PrepReadinessSummary {
+    total: number;
+    done: number;
+    running: number;
+    failed: number;
+    blocker_job_ids: string[];
+}
+export interface EpicReadinessSummary {
+    epic_id: string;
+    persisted_state: EpicState;
+    readiness_state: EpicReadinessState;
+    next_state: EpicState;
+    can_transition: boolean;
+    prep: PrepReadinessSummary;
+    chains: ChainReadinessSummary[];
+    blockers: string[];
+    summary: string;
+}
+export declare function evaluateEpicReadinessSummary(input: {
+    epicId: string;
+    persistedState: EpicState;
+    prepJobs: readonly SupervisorStatus[];
+    chainInputs: ReadonlyArray<{
+        chain_id: string;
+        chain_root_bead_id?: string;
+        jobs: readonly EvaluatorJob[];
+    }>;
+}): EpicReadinessSummary;
+export declare function loadEpicReadinessSummary(sqlite: ObservabilitySqliteClient, epicId: string): EpicReadinessSummary;
+export declare function syncEpicStateFromReadiness(sqlite: ObservabilitySqliteClient, summary: EpicReadinessSummary): EpicRunRecord;
+export {};
+//# sourceMappingURL=epic-readiness.d.ts.map

package/dist/types/specialist/epic-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-readiness.d.ts","sourceRoot":"","sources":["../../../src/specialist/epic-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOxD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5H,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,gBAAgB,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,SAAS,CAAC;IAC3B,eAAe,EAAE,kBAAkB,CAAC;IACpC,UAAU,EAAE,SAAS,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAgMD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,SAAS,CAAC;IAC1B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,WAAW,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9G,GAAG,oBAAoB,CAuBvB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAwChH;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAwB1H"}