@jterrats/open-orchestra 0.4.2-beta.1 → 0.5.0-beta.0

package/dist/types.d.ts

@@ -1,98 +1,14 @@
-export type TaskStatus = "pending" | "ready" | "in_progress" | "blocked" | "review" | "approved" | "rejected" | "done" | "canceled" | "archived";
-export type ReviewResult = "approve" | "block" | "changes";
-export type Severity = "info" | "low" | "medium" | "high" | "critical";
-export type EvidenceType = "command" | "file" | "screenshot" | "trace" | "video" | "log" | "report";
-export type SkillLoadBudget = "small" | "normal" | "large";
-export type SkillRenderTarget = "generic" | "claude" | "cursor" | "codex" | "vscode" | "windsurf";
-export type RuntimeAdapterKind = "llm" | "ide" | "cli";
-export type RuntimeExecutionId = "claude-cli" | "codex-cli" | "cursor-cli" | "vscode-agent" | "windsurf-agent" | "generic-runtime";
-export type RuntimeDelegationMode = "runtime-native" | "brief-only";
-export interface RuntimeAdapter {
-    target: SkillRenderTarget;
-    label: string;
-    kind: RuntimeAdapterKind;
-    defaultInstructionFiles: string[];
-    supportsStructuredPayload: boolean;
-    supportsManagedBlocks: boolean;
-    supportsImports: boolean;
-    guidance: string;
-}
-export interface RuntimeExecutionCapabilities {
-    nonInteractive: boolean;
-    promptInjection: boolean;
-    structuredOutput: boolean;
-    fileEdits: boolean;
-    testExecution: boolean;
-    evidenceReturn: boolean;
-    requiresTty: boolean;
-    requiresUserApproval: boolean;
-    resumeSession: boolean;
-}
-export interface RuntimeSubagentCapabilities {
-    runtimeNative: boolean;
-    parallel: boolean;
-    namedRoles: boolean;
-    forkedContext: boolean;
-    structuredHandoff: boolean;
-    fileOwnership: boolean;
-    requiresParentApproval: boolean;
-}
-export interface RuntimeExecutionAdapter {
-    id: RuntimeExecutionId;
-    target: SkillRenderTarget;
-    label: string;
-    kind: RuntimeAdapterKind;
-    summary: string;
-    execution: RuntimeExecutionCapabilities;
-    subagents: RuntimeSubagentCapabilities;
-    briefOnlyFallback: boolean;
-    directProviderApiAllowed: false;
-    guidance: string;
-}
-export interface RuntimeExecutorConfig {
-    executor?: RuntimeExecutionId;
-}
-export interface RuntimeDelegationPolicy {
-    mode: RuntimeDelegationMode;
-    allowDirectProviderApi: boolean;
-}
-export interface RuntimeExecutionPolicy {
-    defaults?: RuntimeExecutorConfig;
-    byRole: Record<string, RuntimeExecutorConfig>;
-    byTask: Record<string, RuntimeExecutorConfig>;
-    delegation: RuntimeDelegationPolicy;
-}
-export interface RuntimeSelection {
-    taskId: string;
-    role: string;
-    runtime: RuntimeExecutionAdapter;
-    source: "explicit" | "task" | "role" | "default" | "fallback";
-    directProviderApiAllowed: false;
-}
-export interface RuntimeDelegationAssignment {
-    role: string;
-    paths: string[];
-    allowedCommands: string[];
-    expectedArtifacts: string[];
-}
-export interface RuntimeBrief {
-    taskId: string;
-    runtime: RuntimeExecutionId;
-    artifact: string;
-    content: string;
-    mode: "brief-only";
-    directProviderApiAllowed: false;
-}
-export interface RuntimeDelegationPacket {
-    taskId: string;
-    runtime: RuntimeExecutionId;
-    artifact: string;
-    content: string;
-    mode: RuntimeDelegationMode;
-    directProviderApiAllowed: false;
-    assignments: RuntimeDelegationAssignment[];
-    requiresApproval: boolean;
-}
+import type { ContextBudgetMetadata } from "./types/context.js";
+import type { ModelProvenanceRecord, TelemetryConsentState } from "./types/model-config.js";
+import type { CollaborationFlowRecommendation, MemoryPacket, SkillPlan, SkillRenderTarget, WorkflowTemplateSelection } from "./types/skills.js";
+import type { EventEntry, LockEntry, Task, TaskStatus } from "./types/tasks.js";
+export type { ContextBudgetMetadata, ContextBudgetSection, } from "./types/context.js";
+export type { BudgetLimit, BudgetPolicy, ConfiguredProviderSummary, GitHubConfig, GitHubNotificationConfig, ModelMessage, ModelProvider, ModelProviderCapabilities, ModelProviderError, ModelProvenanceInput, ModelProvenanceRecord, ModelRequest, ModelResponse, ModelStreamEvent, NotificationChannelResult, NotificationsConfig, PhaseExecutionMode, PhaseExecutorPhase, PhaseLlmResult, PhaseOutcome, PhaseStructuredOutput, ProviderFallbackResult, ProviderPolicyConfig, ProviderRouting, SlackNotificationConfig, TelemetryConsentState, TelemetryLevel, ToolConfig, WorkflowConfig, WorkflowProvidersConfig, } from "./types/model-config.js";
+export type { RuntimeAdapter, RuntimeAdapterKind, RuntimeBrief, RuntimeDelegationAssignment, RuntimeDelegationMode, RuntimeDelegationPacket, RuntimeDelegationPolicy, RuntimeExecutionAdapter, RuntimeExecutionCapabilities, RuntimeExecutionId, RuntimeExecutionPolicy, RuntimeExecutorConfig, RuntimeSelection, RuntimeSubagentCapabilities, } from "./types/runtime.js";
+export type { AgentLesson, AgentLessonInput, CollaborationFlow, CollaborationFlowRecommendation, CollaborationFlowStep, MemoryHookPoint, MemoryLessonSnippet, MemoryPacket, MemoryPromptSnippet, MemorySectionReport, Skill, SkillLoadBudget, SkillPlan, SkillPlanItem, SkillRenderTarget, SkillValidationReport, RenderedWorkflowTemplate, WorkflowTemplate, WorkflowTemplateSelection, } from "./types/skills.js";
+export { SIZING_LABELS, type BenchmarkQualitySignals, type BenchmarkResult, type BenchmarkSummary, type BurndownPoint, type BurndownSeries, type CalibrationReport, type CalibrationRoleReport, type EstimateConfidence, type EstimateInput, type EstimateRecord, type SizingLabel, type SprintRecord, type SprintVelocity, type SprintVelocityReport, type TaskEstimateBreakdown, type VelocityReport, type VelocityWeek, } from "./types/metrics.js";
+export type { AddTaskInput, ArchitectureApproval, ArtifactResult, ClaimLockInput, DecisionInput, DecisionRecord, EventEntry, EventInput, EvidenceInput, EvidenceType, ExternalTaskReferences, HandoffInput, LockEntry, MechanicalOverride, PlaywrightEvidenceInput, QaGateMetadata, ReviewInput, ReviewResult, RiskAcceptance, RiskGateMetadata, RiskImpactArea, SetupAgentsTaskReference, Severity, Task, TaskStatus, UpdateTaskInput, } from "./types/tasks.js";
+export type { AutonomousGateMode, AutonomousPhase, AutonomousPhaseStatus, AutonomousRun, AutonomousRunResult, BenchmarkPhaseDuration, ClarificationAnswerInput, ClarificationInput, ClarificationRecord, ClarificationStatus, ClarificationTarget, WorkflowGateApprovalInput, WorkflowGateApprovalResult, } from "./types/workflow-run.js";
 export type WorkspaceClassificationKind = "project" | "advisory" | "unsafe" | "unknown";
 export type WorkspaceWritePolicy = "allow" | "confirm_required" | "blocked";
 export interface WorkspaceClassification {
@@ -106,140 +22,6 @@ export interface WorkspaceClassification {
     recommendedAction: string;
     supportedTargets: SkillRenderTarget[];
 }
-export interface Skill {
-    id: string;
-    name: string;
-    summary: string;
-    triggers: string[];
-    roles: string[];
-    capabilities: string[];
-    riskAreas: string[];
-    sourceGroups: string[];
-    entry: string;
-    assets: string[];
-    evidence: EvidenceType[];
-    loadBudget: SkillLoadBudget;
-    instructions: string[];
-}
-export interface SkillPlanItem {
-    skill: Skill;
-    score: number;
-    rationale: string[];
-}
-export interface SkillPlan {
-    taskId: string;
-    selected: SkillPlanItem[];
-    skipped: SkillPlanItem[];
-    sourceGroups: string[];
-}
-export interface SkillValidationReport {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-export interface CollaborationFlowStep {
-    from: string;
-    to: string;
-    purpose: string;
-    requiredContext: string[];
-    requiredArtifacts: string[];
-    exitCriteria: string[];
-}
-export interface CollaborationFlow {
-    id: string;
-    name: string;
-    summary: string;
-    triggers: string[];
-    roles: string[];
-    riskAreas: string[];
-    requiredContext: string[];
-    requiredArtifacts: string[];
-    exitCriteria: string[];
-    optionalReviewers: string[];
-    steps: CollaborationFlowStep[];
-}
-export interface CollaborationFlowRecommendation {
-    flow: CollaborationFlow;
-    score: number;
-    rationale: string[];
-    missingArtifacts: string[];
-    requiredHandoffFields: string[];
-    optionalReviewers: string[];
-}
-export interface WorkflowTemplate {
-    id: string;
-    name: string;
-    summary: string;
-    triggers: string[];
-    roles: string[];
-    riskAreas: string[];
-    inputs: string[];
-    outputs: string[];
-    evidenceRequirements: EvidenceType[];
-    gates: string[];
-    compatibleSkills: string[];
-    steps: string[];
-}
-export interface WorkflowTemplateSelection {
-    template: WorkflowTemplate;
-    score: number;
-    rationale: string[];
-    missingEvidence: EvidenceType[];
-}
-export interface RenderedWorkflowTemplate {
-    target: SkillRenderTarget;
-    taskId?: string;
-    selected: WorkflowTemplateSelection[];
-    content: string;
-}
-export interface AgentLessonInput {
-    taskId?: string;
-    actor: string;
-    operation: string;
-    failedAction: string;
-    errorSignature: string;
-    rootCause: string;
-    fix: string;
-    prevention: string;
-    appliesTo: string[];
-    verifiedBy: string[];
-}
-export interface AgentLesson extends AgentLessonInput {
-    id: string;
-    timestamp: string;
-}
-export type MemoryHookPoint = "before_plan" | "before_implementation" | "before_handoff" | "before_final" | "after_failure";
-export interface MemoryLessonSnippet {
-    type: "lesson";
-    score: number;
-    operation: string;
-    errorSignature: string;
-    fix: string;
-    prevention: string;
-    appliesTo: string[];
-    taskId?: string;
-    timestamp: string;
-}
-export interface MemoryPromptSnippet {
-    type: "prompt";
-    score: number;
-    file: string;
-    artifact: string;
-    summary: string;
-}
-export interface MemoryPacket {
-    taskId?: string;
-    hook: MemoryHookPoint;
-    queryTerms: string[];
-    tokenBudget: number;
-    estimatedTokens: number;
-    lessons: MemoryLessonSnippet[];
-    prompts: MemoryPromptSnippet[];
-    redaction: {
-        applied: boolean;
-        patterns: string[];
-    };
-}
 export interface Role {
     id: string;
     name: string;
@@ -251,290 +33,6 @@ export interface Role {
     expectedEvidence?: string[];
     gateParticipation?: string[];
 }
-export interface MechanicalOverride {
-    rationale: string;
-}
-export interface ArchitectureApproval {
-    proposal?: string;
-    userApproved?: boolean;
-    approvedBy?: string;
-    approvedAt?: string;
-}
-export interface QaGateMetadata {
-    plan?: string;
-    executionStatus?: "not_run" | "passed" | "failed" | "deferred";
-    deferredRationale?: string;
-    deferredOwner?: string;
-}
-export type RiskImpactArea = "security" | "sre" | "dba" | "data" | "devops" | "compliance" | "accessibility" | "ux";
-export interface RiskAcceptance {
-    acceptedBy?: string;
-    rationale?: string;
-}
-export interface RiskGateMetadata {
-    impactAreas?: RiskImpactArea[];
-    acceptance?: RiskAcceptance;
-}
-export interface Task {
-    id: string;
-    title: string;
-    ownerRole: string;
-    status: TaskStatus;
-    dependencies: string[];
-    backlogItem?: string;
-    goal?: string;
-    scope?: string;
-    acceptanceCriteria?: string[];
-    assumptions?: string[];
-    risks?: string[];
-    paths?: string[];
-    testStrategy?: string;
-    blockedReason?: string;
-    mechanicalOverride?: MechanicalOverride;
-    architectureApproval?: ArchitectureApproval;
-    qaGate?: QaGateMetadata;
-    riskGate?: RiskGateMetadata;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface LockEntry {
-    id: string;
-    taskId: string;
-    ownerRole: string;
-    path: string;
-    reason: string;
-    createdAt: string;
-    expiresAt?: string;
-}
-export interface EventEntry {
-    id: string;
-    type: string;
-    timestamp: string;
-    actor: string;
-    summary: string;
-    taskId: string | null;
-    artifacts?: string[];
-    metadata: Record<string, unknown>;
-}
-export interface EventInput {
-    type: string;
-    actor: string;
-    summary: string;
-    taskId?: string;
-    artifacts?: string[];
-    metadata?: Record<string, unknown>;
-}
-export interface ToolConfig {
-    enabled?: boolean;
-    command: string;
-    args: string[];
-    cwd: string;
-    allowedRoles: string[];
-    timeoutMs: number;
-    evidence: string;
-    risk: string;
-}
-export interface ModelProviderCapabilities {
-    streaming: boolean;
-    tools: boolean;
-    vision: boolean;
-    jsonMode: boolean;
-    maxContextTokens: number;
-    timeoutMs: number;
-}
-export interface ModelMessage {
-    role: "system" | "user" | "assistant" | "tool";
-    content: string;
-}
-export interface ModelRequest {
-    messages: ModelMessage[];
-    model: string;
-    temperature?: number;
-    maxTokens?: number;
-    jsonMode?: boolean;
-    tools?: unknown[];
-    timeoutMs?: number;
-}
-export interface ModelResponse {
-    id: string;
-    provider: string;
-    model: string;
-    content: string;
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    finishReason: "stop" | "length" | "tool_call" | "error";
-}
-export interface ModelStreamEvent {
-    type: "content" | "tool_call" | "done" | "error";
-    content?: string;
-    error?: string;
-}
-export interface ModelProviderError {
-    provider: string;
-    code: string;
-    message: string;
-    retryable: boolean;
-}
-export interface ProviderFallbackResult {
-    provider: string;
-    model: string;
-    response: ModelResponse;
-    fallbackUsed: boolean;
-    failedProviders: {
-        provider: string;
-        reason: string;
-    }[];
-}
-export interface ModelProvenanceInput {
-    task: string;
-    role: string;
-    provider: string;
-    model: string;
-    promptId: string;
-    responseId: string;
-    inputTokens: number;
-    outputTokens: number;
-    estimatedCostUsd: number;
-    finishReason: ModelResponse["finishReason"];
-}
-export interface ModelProvenanceRecord extends ModelProvenanceInput {
-    timestamp: string;
-}
-export type PhaseOutcome = {
-    kind: "done";
-    notes: string;
-} | {
-    kind: "gate_pause";
-    reviewArtifact: string;
-} | {
-    kind: "qa_fail";
-    notes: string;
-};
-export type PhaseExecutionMode = "deterministic" | "llm";
-export interface PhaseExecutorPhase {
-    phase: string;
-    role: string;
-    summary: string;
-}
-export interface PhaseStructuredOutput {
-    summary: string;
-    notes: string;
-    verdict: "pass" | "fail";
-    findings: string[];
-    decisions: string[];
-    evidence: string[];
-    handoff: string;
-    sizing?: string;
-}
-export interface PhaseLlmResult {
-    mode: PhaseExecutionMode;
-    outcome: PhaseOutcome;
-    artifact?: string;
-    output?: PhaseStructuredOutput;
-}
-export interface ModelProvider {
-    id: string;
-    capabilities: ModelProviderCapabilities;
-    complete(request: ModelRequest): Promise<ModelResponse>;
-    stream?(request: ModelRequest): AsyncIterable<ModelStreamEvent>;
-}
-export interface ConfiguredProviderSummary {
-    scope: string;
-    provider: string;
-    model: string;
-    fallbacks: string[];
-    maxTokens: number;
-    maxCostUsd: number;
-    timeoutMs: number;
-    retries: number;
-    requiredCapabilities: string[];
-}
-export interface ProviderRouting {
-    provider: string;
-    model: string;
-    fallbacks: string[];
-    maxTokens: number;
-    maxCostUsd: number;
-    timeoutMs: number;
-    retries: number;
-    requiredCapabilities: string[];
-}
-export interface WorkflowProvidersConfig {
-    defaults: ProviderRouting;
-    byRole: Record<string, ProviderRouting>;
-}
-export interface ProviderPolicyConfig {
-    allowedProviders?: string[];
-    blockedProviders?: string[];
-    allowVendorFallbackWithoutApproval?: boolean;
-}
-export interface BudgetLimit {
-    maxRequests?: number;
-    maxInputTokens?: number;
-    maxOutputTokens?: number;
-    maxTotalTokens?: number;
-    maxEstimatedCostUsd?: number;
-}
-export interface BudgetPolicy {
-    defaults?: BudgetLimit;
-    byRole: Record<string, BudgetLimit>;
-    byTask: Record<string, BudgetLimit>;
-}
-export type TelemetryLevel = "off" | "metadata" | "prompt-summary" | "prompt-sample" | "eval-dataset";
-export interface TelemetryConsentState {
-    enabled: boolean;
-    level: TelemetryLevel;
-    policyVersion: string;
-    actor: string;
-    updatedAt?: string;
-}
-export interface GitHubConfig {
-    autoCreatePr?: boolean;
-    baseBranch?: string;
-}
-export interface NotificationChannelResult {
-    channel: "slack" | "github";
-    status: "sent" | "skipped" | "failed";
-    detail: string;
-}
-export interface SlackNotificationConfig {
-    webhookUrl?: string;
-    webhookUrlEnv?: string;
-}
-export interface GitHubNotificationConfig {
-    issueComment?: boolean;
-}
-export interface NotificationsConfig {
-    slack?: SlackNotificationConfig;
-    github?: GitHubNotificationConfig;
-}
-export interface WorkflowConfig {
-    version: number;
-    providers: WorkflowProvidersConfig;
-    budgets?: BudgetPolicy;
-    workflow?: {
-        phaseSequence?: string[];
-        phaseTimeoutMinutes?: number;
-    };
-    tools: Record<string, ToolConfig>;
-    telemetry?: TelemetryConsentState;
-    github?: GitHubConfig;
-    notifications?: NotificationsConfig;
-    providerPolicy?: ProviderPolicyConfig;
-    runtimePolicy?: RuntimeExecutionPolicy;
-    staticAnalysis: {
-        preCommit: {
-            required: boolean;
-            checks: string[];
-            disallowNoVerifyWithoutApproval: boolean;
-        };
-        ci: {
-            checks: string[];
-        };
-    };
-}
 export interface Workspace {
     base: string;
     roles: Role[];
@@ -572,6 +70,7 @@ export interface WorkflowGate {
     evaluate(context: GateEvaluationContext): GateEvaluationResult;
 }
 export interface WorkflowStatus {
+    mode?: "project" | "advisory";
     tasks: {
         total: number;
         byStatus: Record<string, number>;
@@ -710,99 +209,6 @@ export interface PlaywrightTestPlan {
     fixtures: string[];
     notes: string[];
 }
-export interface AddTaskInput {
-    id: string;
-    title: string;
-    ownerRole: string;
-    dependencies: string[];
-    backlogItem?: string;
-    goal?: string;
-    scope?: string;
-    acceptanceCriteria?: string[];
-    assumptions?: string[];
-    risks?: string[];
-    paths?: string[];
-    testStrategy?: string;
-    architectureApproval?: ArchitectureApproval;
-    qaGate?: QaGateMetadata;
-    riskGate?: RiskGateMetadata;
-}
-export interface UpdateTaskInput {
-    id: string;
-    title?: string;
-    ownerRole?: string;
-    goal?: string;
-    scope?: string;
-    paths?: string[];
-    acceptanceCriteria?: string[];
-    assumptions?: string[];
-    risks?: string[];
-    testStrategy?: string;
-    status?: TaskStatus;
-    blockedReason?: string;
-}
-export interface ClaimLockInput {
-    id?: string;
-    taskId: string;
-    ownerRole: string;
-    path: string;
-    reason: string;
-    expiresAt?: string;
-}
-export interface HandoffInput {
-    task: string;
-    from: string;
-    to: string;
-    changed: string;
-    behavior: string;
-    tests: string;
-    commands: string;
-    status?: string;
-    gaps?: string;
-    risks?: string;
-    playwright?: string;
-    updateOwner?: boolean;
-}
-export interface ReviewInput {
-    task: string;
-    role: string;
-    result: string;
-    severity: string;
-    findings: string;
-    recommendation: string;
-}
-export interface EvidenceInput {
-    task: string;
-    role: string;
-    type: string;
-    summary: string;
-    path?: string | boolean | string[];
-    command?: string | boolean | string[];
-    exitCode?: string | boolean | string[];
-}
-export interface PlaywrightEvidenceInput {
-    task: string;
-    kind: "screenshot" | "trace" | "video" | "report";
-    path: string;
-    summary: string;
-    runId?: string;
-}
-export interface ArtifactResult {
-    artifact: string;
-    content: string;
-}
-export interface DecisionInput {
-    task: string;
-    title: string;
-    context: string;
-    decision: string;
-    consequences: string;
-    status: "proposed" | "accepted" | "superseded";
-    owner: string;
-}
-export interface DecisionRecord extends DecisionInput {
-    artifact: string;
-}
 export type DelegationRecommendation = "local" | "single_delegate" | "parallel_delegate" | "review_delegate" | "no_delegation";
 export type DelegationMode = "execute" | "review";
 export interface DelegationAssignment {
@@ -841,6 +247,7 @@ export interface TaskContext {
     delegation?: DelegationDecision;
     collaborationFlow: CollaborationFlowRecommendation | null;
     workflowTemplates: WorkflowTemplateSelection[];
+    contextBudget: ContextBudgetMetadata;
 }
 export interface ExecutionPlanStep {
     id: string;
@@ -959,195 +366,3 @@ export interface ApprovalDecisionInput {
     approver: string;
     rationale: string;
 }
-export type SizingLabel = "xs" | "s" | "m" | "l" | "xl";
-export declare const SIZING_LABELS: SizingLabel[];
-export type AutonomousGateMode = "none" | "phase" | "all";
-export type AutonomousPhaseStatus = "pending" | "running" | "done" | "skipped" | "failed" | "gate_paused" | "qa_failed" | "blocked" | "awaiting_clarification" | "canceled";
-export interface AutonomousPhase {
-    phase: string;
-    role: string;
-    status: AutonomousPhaseStatus;
-    taskId: string;
-    gateId?: string;
-    handoffArtifact?: string;
-    reviewArtifact?: string;
-    approvedBy?: string;
-    approvedAt?: string;
-    approvalRationale?: string;
-    startedAt: string;
-    completedAt?: string;
-    skippedAt?: string;
-    notes?: string;
-}
-export interface WorkflowGateApprovalInput {
-    runId: string;
-    gateId: string;
-    approver: string;
-    rationale: string;
-}
-export interface WorkflowGateApprovalResult {
-    run: AutonomousRun;
-    gateId: string;
-    approver: string;
-    approvedAt: string;
-    alreadyApproved: boolean;
-}
-export interface AutonomousRun {
-    id: string;
-    taskId: string;
-    gates: AutonomousGateMode;
-    maxIterations: number;
-    phaseSequence?: string[];
-    qaIterations: number;
-    phases: AutonomousPhase[];
-    status: "running" | "paused" | "done" | "failed" | "canceled";
-    createdAt: string;
-    updatedAt: string;
-}
-export interface AutonomousRunResult {
-    run: AutonomousRun;
-    file: string;
-    cwd: string;
-}
-export interface BenchmarkPhaseDuration {
-    phase: string;
-    startedAt: string;
-    completedAt?: string;
-    durationMs: number | null;
-}
-export type ClarificationStatus = "open" | "answered";
-export type ClarificationTarget = string;
-export interface ClarificationRecord {
-    id: string;
-    runId: string;
-    taskId: string;
-    fromRole: string;
-    toRole: string;
-    question: string;
-    answer?: string;
-    status: ClarificationStatus;
-    createdAt: string;
-    answeredAt?: string;
-}
-export interface ClarificationInput {
-    runId: string;
-    taskId: string;
-    fromRole: string;
-    to: ClarificationTarget;
-    question: string;
-}
-export interface ClarificationAnswerInput {
-    id: string;
-    answer: string;
-}
-export type EstimateConfidence = "low" | "medium" | "high";
-export interface EstimateRecord {
-    id: string;
-    taskId: string;
-    sizingLabel: SizingLabel;
-    soloEstimateDays: number;
-    aiUnguidedEstimateDays: number;
-    confidence: EstimateConfidence;
-    declaredBy: string;
-    declaredAt: string;
-}
-export interface EstimateInput {
-    taskId: string;
-    sizingLabel: SizingLabel;
-    soloEstimateDays: number;
-    aiUnguidedEstimateDays: number;
-    confidence: EstimateConfidence;
-    declaredBy: string;
-}
-export interface BenchmarkQualitySignals {
-    reviewCount: number;
-    blockingReviews: number;
-    evidenceCount: number;
-    gateBlockCount: number;
-    lessonCount: number;
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    estimatedCostUsd: number;
-}
-export interface BenchmarkResult {
-    taskId: string;
-    sizingLabel: SizingLabel;
-    soloEstimateDays: number;
-    aiUnguidedEstimateDays: number;
-    actualDays: number | null;
-    vsSoloPct: number | null;
-    vsAiUnguidedPct: number | null;
-    qaIterations: number;
-    phaseDurations: BenchmarkPhaseDuration[];
-    quality: BenchmarkQualitySignals;
-    status: "pending" | "complete";
-}
-export interface BenchmarkSummary {
-    stories: BenchmarkResult[];
-    totalWithActuals: number;
-    avgVsSoloPct: number | null;
-    avgVsAiUnguidedPct: number | null;
-}
-export interface VelocityWeek {
-    week: string;
-    storiesCompleted: number;
-    pointsCompleted: number;
-}
-export interface VelocityReport {
-    totalStoriesCompleted: number;
-    totalPointsCompleted: number;
-    avgActualDaysPerStory: number | null;
-    avgVsSoloPct: number | null;
-    avgVsAiUnguidedPct: number | null;
-    weeks: VelocityWeek[];
-    trend: "improving" | "stable" | "declining" | "insufficient_data";
-}
-export interface SprintRecord {
-    id: string;
-    taskIds: string[];
-    status: "active" | "closed";
-    startedAt: string;
-    closedAt: string | null;
-}
-export interface SprintVelocity {
-    sprintId: string;
-    taskIds: string[];
-    storiesCompleted: number;
-    pointsCompleted: number;
-}
-export interface SprintVelocityReport {
-    sprints: SprintVelocity[];
-    trend: "improving" | "stable" | "declining" | "insufficient_data";
-}
-export interface CalibrationRoleReport {
-    role: string;
-    stories: number;
-    avgDeclaredDays: number;
-    avgActualDays: number;
-    avgErrorPct: number;
-    bias: "over" | "under" | "balanced" | "insufficient_data";
-    lessonRecorded: boolean;
-}
-export interface CalibrationReport {
-    roles: CalibrationRoleReport[];
-}
-export interface BurndownPoint {
-    day: number;
-    remaining: number;
-    completedTaskIds?: string[];
-}
-export interface TaskEstimateBreakdown {
-    taskId: string;
-    architectPoints: number | null;
-    developerPoints: number | null;
-    resolvedPoints: number;
-    completedAt: string | null;
-}
-export interface BurndownSeries {
-    sprintTaskIds: string[];
-    totalPoints: number;
-    idealLine: BurndownPoint[];
-    actualLine: BurndownPoint[];
-    taskBreakdown: TaskEstimateBreakdown[];
-    warnings: string[];
-}