sdd-agent-platform 0.3.0 → 0.4.1

package/dist/packages/core/src/index.d.ts

@@ -1,1986 +0,0 @@
-import { type AiProjectionResult, type AiToolSelection } from './ai-tools.js';
-export * from './ai-tools.js';
-export * from './instructions.js';
-export declare const RUNTIME_VERSION = "phase-1.2-runtime-skeleton";
-export declare const PROJECT_CONFIG_CONTRACT = "phase-1.2-project-contract";
-export declare const RUN_STATE_CONTRACT = "phase-1.2-run-state-contract";
-export declare const EVENT_LOG_CONTRACT = "phase-1.2-event-log-contract";
-export declare const ARTIFACT_PATH_CONTRACT = "phase-1.2-artifact-path-contract";
-export declare const LEGACY_LIFECYCLE_DECISION_CONTRACT = "phase-1.2-lifecycle-decision-contract";
-export declare const LIFECYCLE_DECISION_CONTRACT = "sdd-lifecycle-decision-v1";
-export declare const LIFECYCLE_DECISION_VERSION = "1.3.0";
-export declare const SDD_RESULT_CONTRACT = "sdd-result-v1";
-export declare const SDD_RESULT_VERSION = "1.3.0";
-export declare const DELEGATION_LIVENESS_CONTRACT = "sdd-delegation-liveness-v1";
-export declare const DELEGATION_LIVENESS_VERSION = "1.3.0";
-export declare const ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION = "phase-3.6-artifact-result-ingestion-v1";
-export declare const TASK_GRAPH_PLANNER_CONTRACT_VERSION = "phase-3.9-task-graph-planner-v1";
-export declare const WAVE_PLANNER_CONTRACT_VERSION = "phase-3.10-wave-planner-v1";
-export declare const BACKGROUND_EXECUTOR_CONTRACT_VERSION = "phase-3.11-background-executor-v1";
-export declare const WAVE_EXECUTOR_CONTRACT_VERSION = "phase-3.12-wave-executor-v1";
-export declare const LOCAL_RUN_INDEX_CONTRACT_VERSION = "phase-3.13-local-run-index-v1";
-export declare const GOVERNANCE_POLICY_CONTRACT_VERSION = "phase-3.14-governance-policy-v1";
-export declare const CONTEXT_RESOLVER_CONTRACT_VERSION = "phase-5.1-context-resolver-v1";
-export declare const LIFECYCLE_RISK_GATE_CONTRACT_VERSION = "phase-5.1-lifecycle-risk-gate-v1";
-export declare const OUTPUT_QUALITY_CONTRACT_VERSION = "phase-5.1-output-quality-v1";
-export declare const WORKFLOW_GATE_CONTRACT_VERSION = "phase-5.2-workflow-gate-v1";
-export declare const AGENT_REGISTRY_CONTRACT_VERSION = "phase-5.2-agent-registry-v1";
-export declare const TASK_GRAPH_CONTRACT_VERSION = "phase-5.3-task-graph-v1";
-export declare const TASK_RUN_EVIDENCE_CONTRACT_VERSION = "phase-5.3-task-run-evidence-v1";
-export declare const QUERY_STATUS_CONTRACT_VERSION = "phase-5.4-query-status-v1";
-export declare const SKILL_AGENT_EVAL_CONTRACT_VERSION = "phase-5.5-skill-agent-eval-v1";
-export declare const HARNESS_LEARNING_CONTRACT_VERSION = "phase-5.5-harness-learning-v1";
-export declare const PROJECT_CONTEXT_PACK_CONTRACT_VERSION = "phase-5.5-project-context-pack-v1";
-export declare const AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION = "phase-6.0-agent-skill-team-runtime-v1";
-export declare const CAPABILITY_SOURCE_CATALOG_VERSION = "phase-6.0-capability-source-catalog-v1";
-export declare const EXTERNAL_AGENT_PACK_IMPORT_POLICY_VERSION = "phase-6.0-external-agent-pack-import-policy-v1";
-export declare const TOOL_PERMISSION_SPEC_VERSION = "phase-6.0-tool-permission-spec-v1";
-export declare const HOST_ADAPTER_CONTRACT_VERSION = "phase-6.0-host-adapter-contract-v1";
-export declare const AGENT_ROUTER_CONTRACT_VERSION = "phase-6.0-agent-router-v1";
-export declare const TEAM_MODE_POLICY_VERSION = "phase-6.0-team-mode-policy-v1";
-export declare const EVIDENCE_INGESTION_CONTRACT_VERSION = "phase-6.0-evidence-ingestion-v1";
-export declare const AGENT_EXECUTION_RECORD_CONTRACT_VERSION = "phase-6.0-agent-execution-record-v1";
-export declare const TEAM_SESSION_RECORD_CONTRACT_VERSION = "phase-6.0-team-session-record-v1";
-export declare const RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION = "phase-6.1-resident-worker-runtime-v1";
-export declare const SDD_EVIDENCE_CONTRACT = "sdd-evidence-v1";
-export declare const SDD_EVIDENCE_VERSION = "1.0.0";
-export declare const ACCEPTANCE_POLICY_RULESET_VERSION = "acceptance-policy-v1";
-export declare const INVOCATION_LEDGER_CONTRACT_VERSION = "phase-6.9-invocation-ledger-v1";
-export declare const ROUTE_CACHE_CONTRACT_VERSION = "phase-6.9-route-cache-v1";
-export declare const RUNTIME_PROFILE_CONTRACT_VERSION = "phase-6.9-runtime-profile-v1";
-export declare const CONTEXT_BUDGET_CONTRACT_VERSION = "phase-6.10-context-budget-v1";
-export declare const COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION = "sdd-command-output-summary-v1";
-export declare const EVIDENCE_SUMMARY_CONTRACT_VERSION = "sdd-evidence-summary-v1";
-export declare const CONTEXT_PACKAGE_CONTRACT_VERSION = "sdd-context-package-v1";
-export declare const LOG_WORKER_SUMMARY_CONTRACT_VERSION = "sdd-log-worker-summary-v1";
-export type DoctorLevel = 'PASS' | 'WARN' | 'FAIL';
-export type RunStatus = 'created' | 'running' | 'completed' | 'blocked' | 'failed' | 'archived';
-export type LifecycleProfile = 'direct' | 'compact' | 'full' | 'research';
-export type LifecycleConfidence = 'high' | 'medium' | 'low';
-export type SddResultStatus = 'PASS' | 'PASS_WITH_GAPS' | 'FAIL' | 'BLOCKED' | 'TIMED_OUT' | 'CANCELLED';
-export type DelegationRunMode = 'foreground' | 'background';
-export type DelegationStatus = 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'CANCELLED' | 'RECOVERABLE' | 'STALE';
-export type GoalVerifyStatus = 'PASS' | 'PASS_WITH_GAPS' | 'FAIL' | 'BLOCKED';
-export type HarnessVerifyStatus = 'PASS' | 'GAPS' | 'BLOCKED' | 'HUMAN_NEEDED';
-export type ArtifactResultIngestionStatus = 'accepted' | 'rejected';
-export type EvidenceCoverageStatus = 'PASS' | 'FAIL' | 'BLOCKED' | 'REFERENCED_ONLY' | 'MISSING';
-export type EvidenceQualityIssue = 'EMPTY_EVIDENCE' | 'TODO_PLACEHOLDER' | 'TEMPLATE_TEXT' | 'MENTION_ONLY' | 'UNSOURCED_PASS' | 'MISSING_COMMAND_OUTPUT' | 'MISSING_ARTIFACT_REFERENCE' | 'MISSING_MATERIAL_REFERENCE' | 'PROVENANCE_GAP' | 'POLICY_RULE_FAILED' | 'DERIVED_SOURCE_EVIDENCE' | 'PARTITION_SCOPE_VIOLATION';
-export type ContextProfile = 'brief' | 'normal' | 'forensic';
-export type ContextBuildMode = 'do' | 'verify' | 'sync-back' | 'doctor';
-export type ContextSourceKind = 'artifact' | 'run_state' | 'ledger' | 'document' | 'command_output' | 'derived';
-export type ContextSummaryStatus = 'PASS' | 'FAIL' | 'BLOCKED' | 'UNKNOWN';
-export type DetectionConfidence = 'high' | 'medium' | 'low';
-export interface DetectionEvidence {
-    kind: string;
-    detail: string;
-    weight: number;
-}
-export interface ProjectDetectionCandidate {
-    id: string;
-    language: string;
-    framework: string;
-    score: number;
-    confidence: DetectionConfidence;
-    evidence: DetectionEvidence[];
-    validationDefault: string[];
-}
-export interface ProjectDetection {
-    primary: ProjectDetectionCandidate;
-    candidates: ProjectDetectionCandidate[];
-    mixed_stack: boolean;
-}
-export interface ProjectConfig {
-    contract: typeof PROJECT_CONFIG_CONTRACT;
-    project: {
-        name: string;
-        language: string;
-        framework: string;
-    };
-    detection?: {
-        confidence: DetectionConfidence;
-        mixed_stack: boolean;
-        primary: string;
-        candidates: Array<{
-            id: string;
-            confidence: DetectionConfidence;
-            score: number;
-        }>;
-    };
-    sdd: {
-        spec_dir: string;
-        default_branch?: string;
-        docs_language: string;
-        compatible_with: string;
-    };
-    validation: {
-        default: string[];
-    };
-    editing: {
-        prefer_hashline: boolean;
-        native_edit_fallback: boolean;
-    };
-    runtime: {
-        background_write: boolean;
-        worktree_isolation: boolean;
-        sync_back_mode: 'proposal';
-    };
-    lifecycle: {
-        decision_required: boolean;
-        profiles: LifecycleProfile[];
-    };
-    agentRuntime?: ProjectAgentRuntimeConfig;
-}
-export type ToolCapabilityCategory = 'runtime' | 'editing' | 'git' | 'validation' | 'browser' | 'artifact' | 'governance';
-export type ToolCapabilitySideEffect = 'read_only' | 'local_write' | 'command_execution' | 'external_interaction';
-export interface ToolCapability {
-    id: string;
-    title: string;
-    category: ToolCapabilityCategory;
-    summary: string;
-    sideEffect: ToolCapabilitySideEffect;
-    defaultAvailable: boolean;
-    allowedStages: string[];
-    requiredEvidence: string[];
-    forbiddenUses: string[];
-}
-export interface ToolCapabilityRegistry {
-    version: string;
-    capabilities: ToolCapability[];
-}
-export type ToolPluginEntryKind = 'cli' | 'adapter' | 'command' | 'manual';
-export type ToolPluginLoadMode = 'static_manifest' | 'readonly_asset';
-export interface ToolPluginContract {
-    id: string;
-    title: string;
-    version: string;
-    capabilityId: string;
-    entryKind: ToolPluginEntryKind;
-    assetPath: string;
-    loadMode: ToolPluginLoadMode;
-    checksum: string | null;
-    requiredEvidence: string[];
-    forbiddenUses: string[];
-}
-export interface ToolPluginContractRegistry {
-    version: string;
-    contracts: ToolPluginContract[];
-}
-export type DelegationQueueStatusSource = 'run_state_delegation';
-export interface DelegationQueueItem {
-    id: string;
-    runId: string;
-    delegationId: string;
-    taskId: string;
-    agent: string;
-    requestedCapabilityId: string;
-    dedupeKey: string;
-    status: DelegationStatus;
-    statusSource: DelegationQueueStatusSource;
-    runMode: DelegationRunMode;
-    expectedArtifact: string;
-    requiredEvidence: string[];
-    createdAt: string;
-    updatedAt: string;
-}
-export interface DelegationQueueSnapshot {
-    version: string;
-    items: DelegationQueueItem[];
-}
-export interface DelegationStateTransition {
-    from: DelegationStatus;
-    to: DelegationStatus;
-    event: string;
-    terminal: boolean;
-}
-export interface DelegationStateMachine {
-    version: string;
-    statuses: DelegationStatus[];
-    terminalStatuses: DelegationStatus[];
-    transitions: DelegationStateTransition[];
-}
-export interface DelegationStateTransitionValidation {
-    valid: boolean;
-    from: DelegationStatus;
-    to: DelegationStatus;
-    event: string | null;
-    issues: ContractValidationIssue[];
-}
-export type WorkerAdapterKind = 'claude_code_subagent' | 'sdd_cli_task' | 'manual_handoff';
-export type WorkerAdapterExitStatus = 'completed' | 'failed' | 'cancelled' | 'timed_out' | 'blocked';
-export interface WorkerAdapterPayloadContract {
-    queueItemId: string;
-    runId: string;
-    taskId: string;
-    delegationId: string;
-    stateMachineVersion: string;
-}
-export interface WorkerAdapterOutputContract {
-    artifactReference: string;
-    terminalStatus: DelegationStatus[];
-    exitStatuses: WorkerAdapterExitStatus[];
-    requiredEvents: string[];
-}
-export interface WorkerAdapterContract {
-    id: string;
-    title: string;
-    version: string;
-    kind: WorkerAdapterKind;
-    capabilityId: string;
-    pluginContractId: string;
-    input: WorkerAdapterPayloadContract;
-    output: WorkerAdapterOutputContract;
-    sideEffect: ToolCapabilitySideEffect;
-    permissionPrompt: string;
-    requiredEvidence: string[];
-    forbiddenUses: string[];
-}
-export interface WorkerAdapterContractRegistry {
-    version: string;
-    adapters: WorkerAdapterContract[];
-}
-export type WorktreeIsolationMode = 'none' | 'required' | 'blocked' | 'manual';
-export interface WorktreeIsolationPeer {
-    taskId: string;
-    affectedFiles: string[];
-    risk: string[];
-}
-export interface WorktreeIsolationGate {
-    name: string;
-    passed: boolean;
-    message: string;
-}
-export interface WorktreeIsolationDecision {
-    version: string;
-    taskId: string;
-    mode: WorktreeIsolationMode;
-    safeConcurrency: boolean;
-    capabilityId: string;
-    capabilitySideEffect: ToolCapabilitySideEffect;
-    affectedFiles: string[];
-    risk: string[];
-    peers: WorktreeIsolationPeer[];
-    overlaps: Array<{
-        peerTaskId: string;
-        files: string[];
-    }>;
-    gates: WorktreeIsolationGate[];
-    reasons: string[];
-}
-export type WorktreeLifecycleStatus = 'created' | 'kept' | 'removed';
-export interface WorktreeLifecycleRecord {
-    contract: typeof WORKTREE_LIFECYCLE_CONTRACT_VERSION;
-    runId: string;
-    taskId: string;
-    worktreeId: string;
-    status: WorktreeLifecycleStatus;
-    branchName: string;
-    worktreePath: string;
-    baseRef: string;
-    createdAt: string;
-    updatedAt: string;
-    removedAt: string | null;
-    keepReason: string | null;
-    dirty: boolean;
-}
-export interface WorktreeLifecycleInspection {
-    runId: string;
-    contract: typeof WORKTREE_LIFECYCLE_CONTRACT_VERSION;
-    records: WorktreeLifecycleRecord[];
-    valid: boolean;
-    issues: ContractValidationIssue[];
-}
-export interface ArtifactResultIngestionRecord {
-    contract: typeof ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION;
-    runId: string;
-    delegationId: string;
-    task: string;
-    agent: string;
-    artifactPath: string;
-    status: ArtifactResultIngestionStatus;
-    resultStatus: SddResultStatus | null;
-    delegationStatus: DelegationStatus | null;
-    ingestedAt: string;
-    issues: ContractValidationIssue[];
-    gaps: SddTaskGap[];
-}
-export interface ArtifactResultIngestionResult {
-    valid: boolean;
-    duplicate: boolean;
-    record: ArtifactResultIngestionRecord;
-    delegation: DelegationRecord | null;
-}
-export interface ArtifactResultIngestionInspection {
-    runId: string;
-    contract: typeof ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION;
-    records: ArtifactResultIngestionRecord[];
-    valid: boolean;
-    issues: ContractValidationIssue[];
-}
-export interface LifecycleDecisionRecord {
-    contract: typeof LIFECYCLE_DECISION_CONTRACT | typeof LEGACY_LIFECYCLE_DECISION_CONTRACT;
-    version?: typeof LIFECYCLE_DECISION_VERSION;
-    model_version: string;
-    input_summary: Record<string, unknown>;
-    decision: {
-        profile: LifecycleProfile | null;
-        confidence: LifecycleConfidence | null;
-        hard_gate_hits: string[];
-        required_stages: string[];
-        skipped_stages: string[];
-        human_checkpoint_required: boolean;
-    };
-    reasons: string[];
-    escalation_triggers: string[];
-    downgrade_reason: string | null;
-    audit: {
-        decided_at: string | null;
-        decided_by: 'command' | 'runtime' | 'user_override' | null;
-        policy_version: string;
-        source_artifacts: string[];
-    };
-}
-export type SignalClarity = 'high' | 'medium' | 'low';
-export type EstimatedChangeSize = 'tiny' | 'small' | 'medium' | 'large';
-export type ImpactConfidence = 'high' | 'medium' | 'low';
-export type ValidationClarity = 'clear' | 'partial' | 'unclear';
-export type OrchestrationUncertainty = 'low' | 'medium' | 'high';
-export type Reversibility = 'reversible' | 'irreversible' | 'unknown';
-export type ContextBranchSource = 'explicit_option' | 'cli_option' | 'project_config' | 'git_branch';
-export interface ContextResolverContract {
-    contract: typeof CONTEXT_RESOLVER_CONTRACT_VERSION;
-    branch: string;
-    partition: string;
-    rawBranch: string;
-    branchSource: ContextBranchSource;
-    currentGitBranch: string | null;
-    workingTreeMatched: boolean | null;
-    specDir: string;
-}
-export type LifecycleRiskCategory = 'state_machine' | 'concurrency' | 'database_data_loss' | 'security' | 'sql' | 'api_schema' | 'ci_build' | 'external_unknown';
-export type LifecycleRiskExtractionSource = 'from_text' | 'from_file' | 'none';
-export interface LifecycleRiskExtractionEvidence {
-    category: LifecycleRiskCategory;
-    matched: string;
-    riskTag: string;
-}
-export interface LifecycleRiskGateExtraction {
-    contract: typeof LIFECYCLE_RISK_GATE_CONTRACT_VERSION;
-    source: LifecycleRiskExtractionSource;
-    riskTags: string[];
-    affectedContracts: string[];
-    externalUnknown: boolean;
-    architectureDecisionRequired: boolean;
-    reversibility?: Reversibility;
-    validationClarity?: ValidationClarity;
-    impactConfidence?: ImpactConfidence;
-    evidence: LifecycleRiskExtractionEvidence[];
-    signals: Partial<LifecycleDecisionSignals>;
-}
-export type LifecycleAutonomyCeiling = 'direct_execution_allowed' | 'compact_boundary_only' | 'full_sdd_with_checkpoint' | 'research_before_implementation';
-export interface LifecycleDecisionSignals {
-    intent_clarity: SignalClarity;
-    acceptance_clarity: SignalClarity;
-    estimated_change_size: EstimatedChangeSize;
-    task_count_estimate: number;
-    file_count_estimate: number;
-    affected_layers: string[];
-    affected_contracts: string[];
-    dependency_fanout: 'none' | 'local' | 'multi_component' | 'unknown';
-    impact_confidence: ImpactConfidence;
-    risk_tags: string[];
-    reversibility: Reversibility;
-    validation_clarity: ValidationClarity;
-    validation_available: boolean;
-    validation_cost: 'cheap' | 'moderate' | 'expensive' | 'unknown';
-    policy_hits: string[];
-    permission_required: string[];
-    requires_agents: boolean;
-    handoff_count: number;
-    artifact_dependency: boolean;
-    runtime_recovery_need: boolean;
-    orchestration_uncertainty: OrchestrationUncertainty;
-    human_checkpoint_required: boolean;
-    approval_reason: string[];
-    source_artifacts: string[];
-    can_scout_impact: boolean;
-    architecture_decision_required: boolean;
-    external_unknown: boolean;
-}
-export interface LifecycleDecisionGateResult {
-    record: LifecycleDecisionRecord;
-    checkpointRequired: boolean;
-    boundaries: string[];
-    autonomyCeiling: LifecycleAutonomyCeiling;
-}
-export interface ArtifactIndexEntry {
-    path: string;
-    kind: string;
-    task: string | null;
-    agent: string | null;
-    createdAt: string;
-}
-export interface RunDocumentSnapshot {
-    specHash: string | null;
-    planHash: string | null;
-    tasksHash: string | null;
-    planBasedOnSpecHash: string | null;
-    tasksBasedOnPlanHash: string | null;
-}
-export interface RunState {
-    contract: typeof RUN_STATE_CONTRACT;
-    runtimeVersion: typeof RUNTIME_VERSION;
-    runId: string;
-    status: RunStatus;
-    phase: string | null;
-    currentTask: string | null;
-    partition: string | null;
-    gitBranch: string | null;
-    taskId: string | null;
-    affectedFiles: string[];
-    documentSnapshot: RunDocumentSnapshot;
-    createdAt: string;
-    updatedAt: string;
-    projectRoot: string;
-    projectConfigPath: string;
-    eventLogPath: string;
-    artifactRoot: string;
-    lifecycleDecision: LifecycleDecisionRecord | null;
-    tasks: Record<string, unknown>;
-    agents: Record<string, unknown>;
-    delegations: Record<string, DelegationRecord>;
-    artifacts: ArtifactIndexEntry[];
-    artifactIngestions: Record<string, ArtifactResultIngestionRecord>;
-    worktrees: Record<string, WorktreeLifecycleRecord>;
-    validation: {
-        status: 'not_run' | 'pass' | 'pass_with_gaps' | 'fail' | 'blocked';
-        commands: string[];
-        evidence: string[];
-    };
-    syncBack: {
-        mode: 'proposal';
-        proposalPath: string | null;
-        proposalDigest?: string | null;
-        sourceVerifyStatus?: GoalVerifyStatus | SingleTaskLoopStatus | null;
-        status: 'not_created' | 'proposed' | 'applied';
-    };
-}
-export interface RuntimeEvent {
-    contract: typeof EVENT_LOG_CONTRACT;
-    time: string;
-    event: string;
-    runId: string;
-    summary?: string;
-    data?: Record<string, unknown>;
-}
-export interface DoctorCheck {
-    level: DoctorLevel;
-    check: string;
-    message: string;
-    action?: string;
-}
-export interface DoctorReport {
-    status: DoctorLevel;
-    checks: DoctorCheck[];
-}
-export type SddTaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'deferred' | 'unknown';
-export type SddGapSeverity = 'blocking' | 'warning';
-export type SddGapType = 'Document Gap' | 'Task Gap' | 'Dependency Gap';
-export interface SddTaskSourceLocation {
-    filePath: string;
-    heading: string | null;
-    lineStart: number;
-    lineEnd: number;
-}
-export interface SddTask {
-    id: string;
-    title: string | null;
-    status: SddTaskStatus;
-    wave: number | null;
-    dependsOn: string[];
-    affectedFiles: string[];
-    validation: string[];
-    risk: string[];
-    acceptanceRefs: string[];
-    planRefs: string[];
-    fileOwnership: string[];
-    agentFit: string[];
-    verificationAvailability: string[];
-    autonomy: string | null;
-    allowedAgents: string[];
-    requiredArtifacts: string[];
-    gapState: string | null;
-    boundary: string | null;
-    acceptance: string[];
-    implementationNotes: string | null;
-    rawMetadata: Record<string, string | string[]>;
-    source: SddTaskSourceLocation;
-}
-export interface SddTaskGap {
-    type: SddGapType;
-    severity: SddGapSeverity;
-    taskId: string | null;
-    field: string;
-    message: string;
-    recommendation: string;
-}
-export interface SddTaskModel {
-    branch: string;
-    specPath: string;
-    planPath: string;
-    tasksPath: string;
-    documents: {
-        specExists: boolean;
-        planExists: boolean;
-        tasksExists: boolean;
-        specHash?: string | null;
-        planHash?: string | null;
-        tasksHash?: string | null;
-        planBasedOnSpecHash?: string | null;
-        tasksBasedOnPlanHash?: string | null;
-        planStale?: boolean;
-        tasksStale?: boolean;
-    };
-    tasks: SddTask[];
-    gaps: SddTaskGap[];
-}
-export type TaskGraphEdgeType = 'depends_on' | 'file_overlap';
-export interface TaskGraphNode {
-    taskId: string;
-    title: string | null;
-    status: SddTaskStatus;
-    wave: number | null;
-    dependsOn: string[];
-    affectedFiles: string[];
-    risk: string[];
-    validation: string[];
-    acceptanceRefs: string[];
-    planRefs: string[];
-    fileOwnership: string[];
-    agentFit: string[];
-    verificationAvailability: string[];
-    autonomy: string | null;
-    allowedAgents: string[];
-    requiredArtifacts: string[];
-    gapState: string | null;
-    source: SddTaskSourceLocation;
-}
-export interface TaskGraphEdge {
-    from: string;
-    to: string;
-    type: TaskGraphEdgeType;
-    files: string[];
-}
-export interface TaskGraphDiagnostic {
-    severity: SddGapSeverity;
-    taskId: string | null;
-    field: string;
-    message: string;
-    recommendation: string;
-}
-export interface TaskGraphPlan {
-    contract: typeof TASK_GRAPH_CONTRACT_VERSION;
-    version: typeof TASK_GRAPH_PLANNER_CONTRACT_VERSION;
-    branch: string;
-    valid: boolean;
-    nodes: TaskGraphNode[];
-    dependencyEdges: TaskGraphEdge[];
-    fileOverlapEdges: TaskGraphEdge[];
-    diagnostics: TaskGraphDiagnostic[];
-    summary: {
-        tasks: number;
-        dependencies: number;
-        fileOverlaps: number;
-        highRiskTasks: string[];
-        validationCommands: string[];
-    };
-}
-export interface WavePlanTask {
-    taskId: string;
-    isolationMode: WorktreeIsolationMode;
-    reasons: string[];
-}
-export interface WavePlanWave {
-    index: number;
-    tasks: WavePlanTask[];
-}
-export interface WavePlanGate {
-    taskId: string;
-    gate: 'manual' | 'blocked';
-    reasons: string[];
-}
-export interface WavePlan {
-    version: typeof WAVE_PLANNER_CONTRACT_VERSION;
-    branch: string;
-    valid: boolean;
-    waves: WavePlanWave[];
-    manualGates: WavePlanGate[];
-    blockedTasks: WavePlanGate[];
-    diagnostics: TaskGraphDiagnostic[];
-    summary: {
-        tasks: number;
-        waves: number;
-        plannedTasks: number;
-        manualTasks: number;
-        blockedTasks: number;
-    };
-}
-export type BackgroundExecutorStatus = 'claimed' | 'completed' | 'failed' | 'blocked';
-export interface BackgroundExecutorRunOptions {
-    branch?: string;
-    runId?: string;
-    taskId: string;
-    agent?: string;
-    workerAdapterId?: string;
-    artifactPath?: string;
-    delegationId?: string;
-    timeoutSeconds?: number;
-}
-export interface BackgroundExecutorResult {
-    version: typeof BACKGROUND_EXECUTOR_CONTRACT_VERSION;
-    runId: string;
-    taskId: string;
-    delegationId: string | null;
-    queueItemId: string | null;
-    workerAdapterId: string;
-    status: BackgroundExecutorStatus;
-    artifactPath: string | null;
-    ingestion: ArtifactResultIngestionRecord | null;
-    issues: ContractValidationIssue[];
-    message: string;
-}
-export interface BackgroundExecutorInspection {
-    version: typeof BACKGROUND_EXECUTOR_CONTRACT_VERSION;
-    runId: string;
-    delegations: DelegationQueueItem[];
-    artifactIngestions: ArtifactResultIngestionRecord[];
-    runningDelegations: number;
-    terminalDelegations: number;
-    valid: boolean;
-    issues: ContractValidationIssue[];
-}
-export type ResidentWorkerRuntimeStatus = 'claimed' | 'active' | 'stale' | 'terminal' | 'blocked';
-export interface ResidentWorkerRuntimeRecord {
-    version: typeof RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION;
-    runtimeId: string;
-    runId: string;
-    taskId: string;
-    agent: string;
-    workerAdapterId: string;
-    delegationId: string;
-    queueItemId: string;
-    expectedArtifact: string;
-    status: ResidentWorkerRuntimeStatus;
-    claimedAt: string;
-    lastHeartbeatAt: string | null;
-    leaseSeconds: number;
-    leaseExpiresAt: string;
-    updatedAt: string;
-    evidenceSummary: string;
-}
-export interface ResidentWorkerRuntimeClaimOptions {
-    branch?: string;
-    runId?: string;
-    taskId: string;
-    runtimeId?: string;
-    agent?: string;
-    workerAdapterId?: string;
-    delegationId?: string;
-    leaseSeconds?: number;
-}
-export interface ResidentWorkerRuntimeClaimResult {
-    version: typeof RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION;
-    runId: string;
-    runtimeId: string | null;
-    taskId: string;
-    agent: string;
-    workerAdapterId: string;
-    delegationId: string | null;
-    queueItemId: string | null;
-    expectedArtifact: string | null;
-    status: ResidentWorkerRuntimeStatus;
-    leaseExpiresAt: string | null;
-    runtime: ResidentWorkerRuntimeRecord | null;
-    issues: ContractValidationIssue[];
-    message: string;
-}
-export interface ResidentWorkerRuntimeHeartbeatOptions {
-    runId: string;
-    runtimeId: string;
-    leaseSeconds?: number;
-}
-export interface ResidentWorkerRuntimeHeartbeatResult {
-    version: typeof RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION;
-    runId: string;
-    runtimeId: string;
-    status: ResidentWorkerRuntimeStatus;
-    leaseExpiresAt: string | null;
-    runtime: ResidentWorkerRuntimeRecord | null;
-    issues: ContractValidationIssue[];
-    message: string;
-}
-export interface ResidentWorkerRuntimeInspection {
-    version: typeof RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION;
-    runId: string;
-    runtimeId: string;
-    runtime: ResidentWorkerRuntimeRecord | null;
-    queueItem: DelegationQueueItem | null;
-    workerAdapter: WorkerAdapterContract | null;
-    status: ResidentWorkerRuntimeStatus;
-    leaseExpired: boolean;
-    valid: boolean;
-    issues: ContractValidationIssue[];
-    recommendedNextCommand: string;
-}
-export interface ResidentWorkerRuntimeList {
-    version: typeof RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION;
-    runId: string;
-    runtimes: ResidentWorkerRuntimeRecord[];
-    activeRuntimes: number;
-    staleRuntimes: number;
-    terminalRuntimes: number;
-    blockedRuntimes: number;
-    valid: boolean;
-    issues: ContractValidationIssue[];
-}
-export type WaveExecutorStrategy = 'fast-stop' | 'safe-continue';
-export type WaveExecutorStatus = 'claimed' | 'completed' | 'failed' | 'blocked';
-export interface WaveExecutorRunOptions {
-    branch?: string;
-    runId?: string;
-    capabilityId?: string;
-    agent?: string;
-    workerAdapterId?: string;
-    strategy?: WaveExecutorStrategy;
-    artifactPaths?: Record<string, string>;
-}
-export interface WaveExecutorTaskResult {
-    waveIndex: number;
-    taskId: string;
-    result: BackgroundExecutorResult;
-}
-export interface WaveExecutorResult {
-    version: typeof WAVE_EXECUTOR_CONTRACT_VERSION;
-    runId: string;
-    branch: string;
-    strategy: WaveExecutorStrategy;
-    status: WaveExecutorStatus;
-    plannedWaves: number;
-    executedWaves: number;
-    taskResults: WaveExecutorTaskResult[];
-    manualGates: WavePlanGate[];
-    blockedTasks: WavePlanGate[];
-    issues: ContractValidationIssue[];
-    message: string;
-}
-export interface WaveExecutorInspection {
-    version: typeof WAVE_EXECUTOR_CONTRACT_VERSION;
-    runId: string;
-    background: BackgroundExecutorInspection;
-    waveEvents: RuntimeEvent[];
-    valid: boolean;
-    issues: ContractValidationIssue[];
-}
-export type GovernancePolicyOperation = 'background_executor' | 'wave_executor' | 'sync_back_apply' | 'destructive_git' | 'external_interaction' | 'cleanup';
-export type GovernancePolicyDecisionStatus = 'allow' | 'block' | 'confirm';
-export interface GovernancePolicy {
-    version: typeof GOVERNANCE_POLICY_CONTRACT_VERSION;
-    concurrency: {
-        maxBackgroundDelegations: number;
-        maxWaveExecutors: number;
-    };
-    manualConfirmation: {
-        operations: GovernancePolicyOperation[];
-        workerAdapters: string[];
-        riskTags: string[];
-    };
-    cleanup: {
-        archiveOnly: true;
-        deleteRunHistory: false;
-    };
-    retry: {
-        reopenTerminalDelegation: false;
-        maxAttemptsPerDelegation: number;
-    };
-    stopConditions: string[];
-    audit: {
-        requiredEvents: string[];
-        requiredEvidence: string[];
-    };
-}
-export interface GovernancePolicyDecisionInput {
-    operation: GovernancePolicyOperation;
-    runId?: string;
-    taskId?: string;
-    workerAdapterId?: string;
-    riskTags?: string[];
-    approved?: boolean;
-    excludeQueueItemId?: string;
-}
-export interface GovernancePolicyDecision {
-    version: typeof GOVERNANCE_POLICY_CONTRACT_VERSION;
-    operation: GovernancePolicyOperation;
-    status: GovernancePolicyDecisionStatus;
-    allowed: boolean;
-    reasons: string[];
-    issues: ContractValidationIssue[];
-    policy: GovernancePolicy;
-}
-export type WorkflowGateId = 'spec' | 'plan' | 'tasks' | 'do' | 'verify' | 'doctor';
-export interface WorkflowGateContract {
-    version: typeof WORKFLOW_GATE_CONTRACT_VERSION;
-    id: WorkflowGateId;
-    command: string;
-    requiredInputs: string[];
-    allowedAgents: string[];
-    requiredArtifacts: string[];
-    gateConditions: string[];
-    gapClosureBehavior: string;
-    nextAction: string;
-}
-export interface WorkflowGateRegistry {
-    version: typeof WORKFLOW_GATE_CONTRACT_VERSION;
-    workflows: WorkflowGateContract[];
-}
-export interface WorkflowGateValidation {
-    version: typeof WORKFLOW_GATE_CONTRACT_VERSION;
-    valid: boolean;
-    workflows: WorkflowGateContract[];
-    issues: ContractValidationIssue[];
-}
-export type AgentAutonomyCeiling = 'read_only' | 'foreground_write' | 'validation_only' | 'review_only';
-export interface AgentRegistryEntry {
-    version: typeof AGENT_REGISTRY_CONTRACT_VERSION;
-    id: string;
-    role: string;
-    allowedStages: string[];
-    capabilities: string[];
-    readBoundary: string[];
-    writeBoundary: string[];
-    toolAllowlist: string[];
-    requiredArtifact: string;
-    verificationExpectation: string;
-    autonomyCeiling: AgentAutonomyCeiling;
-    stopCondition: string;
-}
-export interface AgentRegistry {
-    version: typeof AGENT_REGISTRY_CONTRACT_VERSION;
-    agents: AgentRegistryEntry[];
-}
-export interface AgentRegistryValidation {
-    version: typeof AGENT_REGISTRY_CONTRACT_VERSION;
-    valid: boolean;
-    agents: AgentRegistryEntry[];
-    issues: ContractValidationIssue[];
-}
-export type BuiltInAgentProfileId = 'planner' | 'architect' | 'implementer' | 'reviewer' | 'validator' | 'researcher' | 'orchestrator' | 'security' | 'domain_expert';
-export type AgentProfileId = BuiltInAgentProfileId | string;
-export type CapabilityReuseDecision = 'reuse_direct' | 'adapt_via_host_adapter' | 'borrow_mechanism' | 'avoid';
-export type SkillCapabilityKind = 'skill' | 'mcp' | 'cli_tool' | 'host_tool' | 'project_agent' | 'external_pattern';
-export type SkillCapabilitySource = 'project' | 'user_global' | 'claude_code' | 'mcp' | 'open_source' | 'host';
-export type SkillCapabilityEvidenceType = 'none' | 'command_output' | 'test_result' | 'browser_snapshot' | 'artifact' | 'external_source' | 'execution_record';
-export type CapabilitySourceKind = 'native_host' | 'mcp_tool' | 'open_source_material' | 'mechanism_reference' | 'future_adapter' | 'project_material';
-export type ExternalPackImportStatus = 'approved' | 'quarantined' | 'denied';
-export type ExternalPackCheckStatus = 'pass' | 'warn' | 'fail' | 'not_run';
-export type ToolPermissionPolicy = 'allow' | 'ask' | 'deny';
-export type AgentRouterCategory = 'planning' | 'implementation' | 'implementation_review' | 'validation' | 'security_research' | 'external_research' | 'blocked';
-export type TeamModeDecisionStatus = 'disabled' | 'enabled' | 'blocked';
-export type TeamModeActivation = 'auto' | 'force' | 'off';
-export type TeamModeSelection = 'off' | 'inspect' | 'review-lite' | 'hyperplan' | 'security-research';
-export type TeamModeCostClass = 'none' | 'low' | 'medium' | 'high';
-export type TeamModeCostRoute = 'not_applicable' | 'downgraded' | 'no_downgrade' | 'blocked';
-export type AgentExecutionRecordStatus = 'claimed' | 'completed' | 'failed' | 'blocked' | 'skipped';
-export type TeamSessionRecordStatus = 'created' | 'completed' | 'blocked' | 'disabled';
-export interface AgentProfileContract {
-    version: typeof AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION;
-    id: AgentProfileId;
-    stageScope: string[];
-    riskCeiling: LifecycleAutonomyCeiling;
-    defaultAutonomy: LifecycleAutonomyCeiling;
-    requiredArtifacts: string[];
-    toolScope: string[];
-    modelPolicyId: string;
-    hostCapabilityRequirements: string[];
-    boundaries: string[];
-}
-export interface SkillCapabilityContract {
-    version: typeof AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION;
-    id: string;
-    name: string;
-    kind: SkillCapabilityKind;
-    source: SkillCapabilitySource;
-    sourceRef: string;
-    capabilityDomain: string[];
-    allowedStages: string[];
-    requiredRiskCeiling: LifecycleAutonomyCeiling;
-    evidenceType: SkillCapabilityEvidenceType;
-    reuseDecision: CapabilityReuseDecision;
-    buildExceptionReason: string | null;
-}
-export interface CapabilitySourceCatalogEntry {
-    version: typeof CAPABILITY_SOURCE_CATALOG_VERSION;
-    id: string;
-    name: string;
-    kind: CapabilitySourceKind;
-    sourceRef: string;
-    reuseDecision: CapabilityReuseDecision;
-    quarantineRequired: boolean;
-    allowedUse: string;
-    attribution: string;
-    rationale: string;
-}
-export type RuntimeRegistryOrigin = 'built_in' | 'project_config' | 'external_manifest';
-export interface RuntimeRegistryEntrySource {
-    id: string;
-    kind: 'profile' | 'skill_capability' | 'capability_source';
-    origin: RuntimeRegistryOrigin;
-    sourceId: string | null;
-    quarantineRequired: boolean;
-}
-export interface AgentRuntimeRoutingRuleWhen {
-    keywords: string[];
-    affectedFileGlobs: string[];
-}
-export interface AgentRuntimeRoutingRule {
-    id: string;
-    when: AgentRuntimeRoutingRuleWhen;
-    preferProfile: AgentProfileId;
-    requireCapabilities: string[];
-    category: AgentRouterCategory | null;
-}
-export interface AgentRuntimeAdapterMapping {
-    profile: AgentProfileId;
-    hostAdapter: string;
-    projection: string;
-    permissionPolicy: string;
-}
-export interface AgentRuntimeAliasResolution {
-    input: string;
-    resolved: AgentProfileId;
-    source: 'built_in' | 'project_config';
-}
-export interface ProjectAgentRuntimeConfig {
-    profiles: AgentProfileContract[];
-    skillCapabilities: SkillCapabilityContract[];
-    capabilitySources: CapabilitySourceCatalogEntry[];
-    aliases: Record<string, string>;
-    routingRules: AgentRuntimeRoutingRule[];
-    adapterMappings: AgentRuntimeAdapterMapping[];
-}
-export interface ExternalAgentPackImportCheck {
-    check: string;
-    status: ExternalPackCheckStatus;
-    evidence: string;
-}
-export interface ExternalAgentPackImportInspection {
-    version: typeof EXTERNAL_AGENT_PACK_IMPORT_POLICY_VERSION;
-    sourceId: string;
-    status: ExternalPackImportStatus;
-    checks: ExternalAgentPackImportCheck[];
-    mappingResult: string;
-    allowedProfiles: AgentProfileId[];
-    riskCeiling: LifecycleAutonomyCeiling;
-    reason: string;
-}
-export interface ModelPolicyContract {
-    id: string;
-    category: string;
-    fallbackPolicy: string;
-    hostProjection: string;
-}
-export interface ToolPermissionSpec {
-    version: typeof TOOL_PERMISSION_SPEC_VERSION;
-    profile: AgentProfileId;
-    risk: string[];
-    toolGroups: string[];
-    fileScope: string[];
-    policy: ToolPermissionPolicy;
-    approvalPolicy: string;
-    runtimeValidationRequired: boolean;
-    deniedTools: string[];
-    hostPermissionProjection: string;
-}
-export interface HostAdapterContract {
-    version: typeof HOST_ADAPTER_CONTRACT_VERSION;
-    id: string;
-    host: string;
-    responsibilities: string[];
-    forbiddenAuthority: string[];
-    projections: string[];
-}
-export interface DelegationWavePolicy {
-    id: string;
-    waveKind: 'hyperplan' | 'security_research' | 'implementation_review' | 'validation';
-    memberProfiles: AgentProfileId[];
-    requiredArtifacts: string[];
-    fileOwnershipRequired: boolean;
-    mergeGate: string;
-}
-export interface TeamModePolicy {
-    version: typeof TEAM_MODE_POLICY_VERSION;
-    enabled: boolean;
-    decision: TeamModeDecisionStatus;
-    mode: TeamModeSelection;
-    activation: TeamModeActivation;
-    costClass: TeamModeCostClass;
-    reason: string;
-    costRoute: TeamModeCostRoute;
-    downgradeReason: string | null;
-    trustPolicyEnforced: boolean;
-    chiefProfile: AgentProfileId;
-    memberProfiles: AgentProfileId[];
-    allowedWaves: DelegationWavePolicy[];
-    maxMembers: number;
-    requireArtifacts: boolean;
-    blockedReason: string | null;
-    waveRecommendation: string[];
-}
-export interface EvidenceIngestionContract {
-    version: typeof EVIDENCE_INGESTION_CONTRACT_VERSION;
-    sourceOutputs: string[];
-    evidenceTargets: string[];
-    canonicalTruth: string;
-    forbiddenTruthSources: string[];
-}
-export interface AgentExecutionRecord {
-    version: typeof AGENT_EXECUTION_RECORD_CONTRACT_VERSION;
-    executionId: string;
-    runId: string;
-    taskId: string;
-    profile: AgentProfileId;
-    category: AgentRouterCategory;
-    host: string;
-    hostSessionId: string | null;
-    hostTaskId: string | null;
-    modelPolicy: ModelPolicyContract;
-    toolPermission: ToolPermissionSpec | null;
-    capabilitiesUsed: string[];
-    sourceAttribution: string[];
-    artifacts: string[];
-    status: AgentExecutionRecordStatus;
-    delegationId: string | null;
-    queueItemId: string | null;
-    ingestionStatus: ArtifactResultIngestionStatus | null;
-    resultStatus: SddResultStatus | null;
-    routeId: string;
-    routeDecision: Pick<AgentRouterDecision, 'version' | 'category' | 'recommendedProfile' | 'autonomyCeiling' | 'requiredCapabilities' | 'blockedReason'>;
-    evidenceSummary: string;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface TeamMessageRecord {
-    sender: AgentProfileId | 'runtime';
-    receiver: AgentProfileId | 'team' | 'runtime';
-    taskRef: string | null;
-    artifactRefs: string[];
-    blocker: string | null;
-    evidenceSummary: string;
-    createdAt: string;
-}
-export interface TeamSessionRecord {
-    version: typeof TEAM_SESSION_RECORD_CONTRACT_VERSION;
-    teamId: string;
-    runId: string;
-    taskId: string | null;
-    status: TeamSessionRecordStatus;
-    chiefProfile: AgentProfileId;
-    memberProfiles: AgentProfileId[];
-    hostLayout: string | null;
-    teamMode: TeamModePolicy;
-    waves: DelegationWavePolicy[];
-    messages: TeamMessageRecord[];
-    artifacts: string[];
-    evidenceSummary: string;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface AgentRouterRejectedProfile {
-    profile: AgentProfileId;
-    reason: string;
-}
-export interface AgentRouterDecision {
-    version: typeof AGENT_ROUTER_CONTRACT_VERSION;
-    taskId: string;
-    branch: string;
-    category: AgentRouterCategory;
-    recommendedProfile: AgentProfileId | null;
-    allowedProfiles: AgentProfileId[];
-    rejectedProfiles: AgentRouterRejectedProfile[];
-    requiredCapabilities: string[];
-    sourceCapability: string | null;
-    reuseDecision: CapabilityReuseDecision | null;
-    toolPermission: ToolPermissionSpec | null;
-    modelPolicy: ModelPolicyContract;
-    teamMode: TeamModePolicy;
-    autonomyCeiling: LifecycleAutonomyCeiling;
-    requiredArtifacts: string[];
-    blockedReason: string | null;
-    nextAction: string;
-    registrySources?: RuntimeRegistryEntrySource[];
-    resolvedAliases?: AgentRuntimeAliasResolution[];
-    routingRuleHits?: string[];
-    quarantineWarnings?: string[];
-    adapterMapping?: AgentRuntimeAdapterMapping | null;
-    cache?: RouteCacheMetadata;
-    profile?: RuntimeProfileSpan[];
-}
-export interface RouteCacheMetadata {
-    contract: typeof ROUTE_CACHE_CONTRACT_VERSION;
-    key: string;
-    status: 'hit' | 'miss' | 'stored';
-    source: 'content_addressed_derived_route';
-    authoritative: false;
-}
-export interface RuntimeProfileSpan {
-    contract: typeof RUNTIME_PROFILE_CONTRACT_VERSION;
-    name: string;
-    startedAt: string;
-    endedAt: string;
-    durationMs: number;
-}
-export interface AgentSkillTeamRuntimeInspection {
-    version: typeof AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION;
-    profiles: AgentProfileContract[];
-    skillCapabilities: SkillCapabilityContract[];
-    capabilitySources: CapabilitySourceCatalogEntry[];
-    hostAdapter: HostAdapterContract;
-    evidenceIngestion: EvidenceIngestionContract;
-    teamMode: TeamModePolicy;
-    reusePolicy: string;
-    registrySources?: RuntimeRegistryEntrySource[];
-    aliases?: Record<string, string>;
-    routingRules?: AgentRuntimeRoutingRule[];
-    adapterMappings?: AgentRuntimeAdapterMapping[];
-}
-export interface SkillCapabilityRegistry {
-    version: typeof AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION;
-    capabilities: SkillCapabilityContract[];
-    registrySources?: RuntimeRegistryEntrySource[];
-}
-export interface CapabilitySourceCatalog {
-    version: typeof CAPABILITY_SOURCE_CATALOG_VERSION;
-    sources: CapabilitySourceCatalogEntry[];
-    registrySources?: RuntimeRegistryEntrySource[];
-}
-export interface AgentSkillTeamRuntimeValidation {
-    version: typeof AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION;
-    valid: boolean;
-    inspection: AgentSkillTeamRuntimeInspection;
-    issues: ContractValidationIssue[];
-}
-export type QuerySurfaceId = 'status' | 'doctor' | 'run_inspect' | 'debug';
-export interface QueryStatusSurface {
-    id: QuerySurfaceId;
-    command: string;
-    responsibility: string;
-    includes: string[];
-    excludes: string[];
-    nextActionRule: string;
-}
-export interface QueryStatusContract {
-    version: typeof QUERY_STATUS_CONTRACT_VERSION;
-    sourceDocument: string;
-    surfaces: QueryStatusSurface[];
-}
-export interface QueryStatusValidation {
-    version: typeof QUERY_STATUS_CONTRACT_VERSION;
-    valid: boolean;
-    surfaces: QueryStatusSurface[];
-    issues: ContractValidationIssue[];
-}
-export type SkillAgentEvalDimensionId = 'novel_judgment' | 'risk_identification' | 'task_slicing' | 'agent_evidence' | 'output_concision' | 'verification_executability' | 'autonomy_correctness' | 'agent_fit' | 'verification_availability' | 'gap_closure';
-export interface SkillAgentEvalDimension {
-    id: SkillAgentEvalDimensionId;
-    expectation: string;
-    baselineFinding: string;
-    passThreshold: number;
-}
-export interface SkillAgentEvalContract {
-    version: typeof SKILL_AGENT_EVAL_CONTRACT_VERSION;
-    corpus: string[];
-    sourceReport: string;
-    dimensions: SkillAgentEvalDimension[];
-    regressionAssertions: string[];
-}
-export interface SkillAgentEvalValidation {
-    version: typeof SKILL_AGENT_EVAL_CONTRACT_VERSION;
-    valid: boolean;
-    contract: SkillAgentEvalContract;
-    issues: ContractValidationIssue[];
-}
-export type HarnessLearningSinkId = 'project_context_pack' | 'risk_vocabulary' | 'checklist' | 'doctor_check' | 'eval_assertion' | 'generated_entry_guidance';
-export interface HarnessLearningSink {
-    id: HarnessLearningSinkId;
-    output: string;
-    boundary: string;
-}
-export interface HarnessLearningContract {
-    version: typeof HARNESS_LEARNING_CONTRACT_VERSION;
-    sourceTrial: string;
-    allowedSinks: HarnessLearningSink[];
-    forbiddenOutputs: string[];
-    promotionRule: string;
-}
-export interface HarnessLearningValidation {
-    version: typeof HARNESS_LEARNING_CONTRACT_VERSION;
-    valid: boolean;
-    contract: HarnessLearningContract;
-    issues: ContractValidationIssue[];
-}
-export interface ProjectContextPackContract {
-    version: typeof PROJECT_CONTEXT_PACK_CONTRACT_VERSION;
-    entryPoint: string;
-    durableContext: string[];
-    runtimeSourcesOfTruth: string[];
-    boundaries: string[];
-}
-export interface ProjectContextPackValidation {
-    version: typeof PROJECT_CONTEXT_PACK_CONTRACT_VERSION;
-    valid: boolean;
-    contract: ProjectContextPackContract;
-    issues: ContractValidationIssue[];
-}
-export interface SddResult {
-    contract: typeof SDD_RESULT_CONTRACT;
-    version: typeof SDD_RESULT_VERSION;
-    agent: string;
-    task: string;
-    status: SddResultStatus;
-    artifacts: string[];
-    rawMetadata: Record<string, string | string[]>;
-}
-export interface ContractValidationIssue {
-    field: string;
-    message: string;
-    recommendation: string;
-}
-export interface SddResultValidationReport {
-    valid: boolean;
-    result: SddResult | null;
-    issues: ContractValidationIssue[];
-    trust?: ArtifactTrustValidationReport;
-}
-export interface EvidenceItem {
-    kind: string;
-    ref: string;
-    summary: string | null;
-}
-export interface EvidenceClaim {
-    contract: typeof SDD_EVIDENCE_CONTRACT;
-    version: typeof SDD_EVIDENCE_VERSION;
-    task: string;
-    acceptance: string;
-    status: EvidenceCoverageStatus;
-    claim: string;
-    sourceArtifact: string;
-    evidence: EvidenceItem[];
-    provenance: string[];
-    policy: string[];
-    rawMetadata: Record<string, string | string[]>;
-}
-export interface EvidenceReasoning {
-    summary: string;
-    ruleIds: string[];
-    issueCodes: EvidenceQualityIssue[];
-}
-export interface PolicyRuleSet {
-    id: typeof ACCEPTANCE_POLICY_RULESET_VERSION;
-    version: string;
-    ruleIds: string[];
-}
-export interface PolicyDecision {
-    status: EvidenceCoverageStatus;
-    ruleSet: PolicyRuleSet;
-    passedRules: string[];
-    failedRules: string[];
-    issueCodes: EvidenceQualityIssue[];
-}
-export interface EvidenceCoverage {
-    acceptanceId: string;
-    status: EvidenceCoverageStatus;
-    claim?: EvidenceClaim;
-    evidence: EvidenceItem[];
-    reasoning?: EvidenceReasoning;
-    policyDecision: PolicyDecision;
-}
-export interface ProvenanceEntity {
-    id: string;
-    kind: 'spec' | 'plan' | 'tasks' | 'artifact' | 'command_output' | 'run_state' | 'material' | string;
-    hash?: string;
-    path?: string;
-}
-export interface ProvenanceActivity {
-    id: string;
-    kind: 'inspect' | 'route' | 'do' | 'verify' | 'artifact_validate' | 'sync_back' | 'policy_evaluate' | 'cache' | string;
-    startedAt?: string;
-    endedAt?: string;
-}
-export interface ProvenanceAgent {
-    id: string;
-    kind: 'runtime' | 'implementer' | 'reviewer' | 'validator' | 'tool' | string;
-}
-export interface ProvenanceLink {
-    relation: 'used' | 'wasGeneratedBy' | 'wasAssociatedWith' | 'wasDerivedFrom' | string;
-    from: string;
-    to: string;
-}
-export interface SddEvidenceAttestation {
-    subject: string;
-    materials: ProvenanceEntity[];
-    invocation: ProvenanceActivity;
-    builder: ProvenanceAgent;
-}
-export interface ArtifactTrustValidationReport {
-    valid: boolean;
-    claims: EvidenceClaim[];
-    issues: ContractValidationIssue[];
-}
-export type InvocationLedgerKind = 'command' | 'tool_invocation' | 'agent' | 'skill' | 'material' | 'policy_evaluation' | 'cache' | 'artifact_hash';
-export interface InvocationLedgerEntry {
-    contract: 'sdd-invocation-ledger-v1';
-    version: typeof INVOCATION_LEDGER_CONTRACT_VERSION;
-    entryId: string;
-    runId: string;
-    taskId: string | null;
-    branch: string | null;
-    kind: InvocationLedgerKind;
-    ref: string;
-    status: string;
-    timestamp: string;
-    artifactPath?: string | null;
-    inputHash?: string | null;
-    outputHash?: string | null;
-    materialRefs: string[];
-    metadata: Record<string, string | number | boolean | null>;
-}
-export interface ContextBudget {
-    contract: typeof CONTEXT_BUDGET_CONTRACT_VERSION;
-    profile: ContextProfile;
-    maxBytes: number;
-    preserve: string[];
-}
-export interface ContextSourceRef {
-    path: string;
-    hash: string;
-    kind: ContextSourceKind;
-}
-export interface CommandOutputSummary {
-    contract: typeof COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION;
-    authoritative: false;
-    usableForPass: false;
-    source: ContextSourceRef;
-    status: ContextSummaryStatus;
-    highlights: string[];
-    omittedLines: number;
-}
-export interface EvidenceSummaryProjection {
-    contract: typeof EVIDENCE_SUMMARY_CONTRACT_VERSION;
-    authoritative: false;
-    usableForPass: false;
-    runId: string;
-    taskId: string | null;
-    sources: ContextSourceRef[];
-    passCount: number;
-    blockedCount: number;
-    failCount: number;
-    issueCodes: EvidenceQualityIssue[];
-    policyRefs: string[];
-    highlights: string[];
-}
-export interface ContextBuildPackage {
-    contract: typeof CONTEXT_PACKAGE_CONTRACT_VERSION;
-    profile: ContextProfile;
-    mode: ContextBuildMode;
-    agent: string | null;
-    authoritative: false;
-    usableForPass: false;
-    taskId: string;
-    branch: string;
-    mustRead: ContextSourceRef[];
-    optionalRead: ContextSourceRef[];
-    doNotReadUnlessNeeded: ContextSourceRef[];
-    nextCommands: string[];
-    warnings: string[];
-}
-export interface LogWorkerSummary {
-    contract: typeof LOG_WORKER_SUMMARY_CONTRACT_VERSION;
-    authoritative: false;
-    usableForPass: false;
-    runId: string;
-    taskId: string | null;
-    workerId: string;
-    sources: ContextSourceRef[];
-    highlights: string[];
-    forbiddenAuthority: string[];
-}
-export interface EvidenceSummaryOptions {
-    runId: string;
-    taskId?: string;
-}
-export interface ContextBuildOptions {
-    taskId: string;
-    branch?: string;
-    mode: ContextBuildMode;
-    agent?: string;
-    profile?: ContextProfile;
-}
-export interface LogWorkerSummaryValidation {
-    valid: boolean;
-    issues: ContractValidationIssue[];
-}
-export interface SddResultArtifactTemplateOptions {
-    branch?: string;
-    runId?: string;
-    taskId: string;
-    agent: string;
-    artifactPath: string;
-    status?: SddResultStatus;
-}
-export interface DelegationRecord {
-    contract: typeof DELEGATION_LIVENESS_CONTRACT;
-    version: typeof DELEGATION_LIVENESS_VERSION;
-    delegationId: string;
-    task: string;
-    agent: string;
-    runMode: DelegationRunMode;
-    blocking: boolean;
-    requiredForPhaseExit: boolean;
-    status: DelegationStatus;
-    startedAt: string;
-    lastHeartbeatAt: string | null;
-    timeoutSeconds: number;
-    expectedArtifact: string;
-    terminalEventRequired: boolean;
-    terminalEventAt?: string | null;
-}
-export interface DelegationValidationReport {
-    valid: boolean;
-    delegation: DelegationRecord;
-    terminal: boolean;
-    stale: boolean;
-    issues: ContractValidationIssue[];
-}
-export type SingleTaskLoopStatus = 'completed' | 'blocked' | 'failed';
-export interface SingleTaskLoopOptions {
-    branch?: string;
-    taskId: string;
-    runId?: string;
-    implementArtifact?: string;
-    reviewArtifact?: string;
-    validationArtifact?: string;
-    debugArtifact?: string;
-    teamModeEnabled?: boolean;
-    teamModeActivation?: TeamModeActivation;
-}
-export interface SingleTaskLoopResult {
-    runId: string;
-    taskId: string;
-    status: SingleTaskLoopStatus;
-    task: SddTask | null;
-    gaps: SddTaskGap[];
-    requiredArtifacts: string[];
-    acceptedArtifacts: string[];
-    syncBackProposalPath: string;
-    routeDecision: AgentRouterDecision;
-    message: string;
-}
-export interface GoalVerifyOptions {
-    branch?: string;
-    taskId: string;
-    runId?: string;
-    reviewArtifact?: string;
-    validationArtifact?: string;
-}
-export interface AcceptanceCoverageItem {
-    acceptance: string;
-    status: EvidenceCoverageStatus;
-    evidence: string;
-    policyDecision?: PolicyDecision;
-    issueCodes?: EvidenceQualityIssue[];
-}
-export interface GoalVerifyResult {
-    runId: string;
-    taskId: string;
-    status: GoalVerifyStatus;
-    task: SddTask | null;
-    reviewArtifact: string | null;
-    validationArtifact: string | null;
-    coverageArtifactPath: string;
-    syncBackProposalPath: string;
-    acceptanceCoverage: AcceptanceCoverageItem[];
-    gaps: SddTaskGap[];
-    commands: string[];
-    standardStatus: HarnessVerifyStatus;
-    message: string;
-}
-export interface RunSummary {
-    runId: string;
-    status: RunStatus;
-    phase: string | null;
-    currentTask: string | null;
-    partition: string | null;
-    gitBranch: string | null;
-    taskId: string | null;
-    affectedFiles: string[];
-    documentSnapshot: RunDocumentSnapshot;
-    createdAt: string;
-    updatedAt: string;
-    validationStatus: RunState['validation']['status'];
-    syncBackStatus: RunState['syncBack']['status'];
-    taskIds: string[];
-    artifactCount: number;
-}
-export interface LocalRunIndexTaskEntry {
-    taskId: string;
-    partition: string | null;
-    gitBranch: string | null;
-    affectedFiles: string[];
-    status: string | null;
-    runId: string;
-    runStatus: RunStatus;
-    updatedAt: string;
-}
-export interface LocalRunIndexArtifactEntry {
-    path: string;
-    kind: string;
-    task: string | null;
-    agent: string | null;
-    runId: string;
-    createdAt: string;
-}
-export interface LocalRunIndexWaveSummary {
-    runId: string;
-    eventCount: number;
-    lastEvent: string | null;
-}
-export interface LocalRunIndexPartitionTaskEntry {
-    partition: string;
-    gitBranch: string | null;
-    taskId: string;
-    runId: string;
-    runStatus: RunStatus;
-    validationStatus: RunState['validation']['status'];
-    syncBackStatus: RunState['syncBack']['status'];
-    affectedFiles: string[];
-    updatedAt: string;
-}
-export interface LocalRunIndexAffectedFileEntry {
-    file: string;
-    partition: string;
-    gitBranch: string | null;
-    taskId: string;
-    runId: string;
-    runStatus: RunStatus;
-    syncBackStatus: RunState['syncBack']['status'];
-    updatedAt: string;
-}
-export interface LocalRunIndexQuery {
-    runId?: string;
-    taskId?: string;
-    partition?: string;
-    status?: RunStatus;
-    artifact?: string;
-}
-export interface LocalRunIndex {
-    contract: typeof LOCAL_RUN_INDEX_CONTRACT_VERSION;
-    generatedAt: string;
-    runs: RunSummary[];
-    tasks: LocalRunIndexTaskEntry[];
-    delegations: DelegationQueueItem[];
-    artifacts: LocalRunIndexArtifactEntry[];
-    waves: LocalRunIndexWaveSummary[];
-    latestByPartitionTask: LocalRunIndexPartitionTaskEntry[];
-    activeByAffectedFile: LocalRunIndexAffectedFileEntry[];
-}
-export interface LocalRunIndexInspection {
-    valid: boolean;
-    exists: boolean;
-    indexPath: string;
-    index: LocalRunIndex | null;
-    issues: ContractValidationIssue[];
-}
-export interface TaskRunEvidenceContract {
-    version: typeof TASK_RUN_EVIDENCE_CONTRACT_VERSION;
-    runId: string;
-    state: {
-        status: RunStatus;
-        phase: string | null;
-        currentTask: string | null;
-    };
-    events: Array<{
-        event: string;
-        summary: string | null;
-        task: string | null;
-        agent: string | null;
-        gate: string | null;
-        validation: string | null;
-        gap: string | null;
-    }>;
-    artifacts: ArtifactIndexEntry[];
-    validation: RunState['validation'];
-    gaps: SddTaskGap[];
-    syncBackProposal: string | null;
-    invocationLedger: InvocationLedgerEntry[];
-    agentExecutions: AgentExecutionRecord[];
-    teamSessions: TeamSessionRecord[];
-    workerRuntimes: ResidentWorkerRuntimeRecord[];
-}
-export interface RunInspection {
-    summary: RunSummary;
-    state: RunState;
-    events: RuntimeEvent[];
-    eventCount: number;
-    recentEvents: RuntimeEvent[];
-    artifacts: ArtifactIndexEntry[];
-    artifactIngestions: ArtifactResultIngestionRecord[];
-    worktrees: WorktreeLifecycleRecord[];
-    validation: RunState['validation'];
-    syncBack: RunState['syncBack'];
-    tasks: Record<string, unknown>;
-    taskRunEvidence: TaskRunEvidenceContract;
-    agentExecutions: AgentExecutionRecord[];
-    invocationLedger: InvocationLedgerEntry[];
-    teamSessions: TeamSessionRecord[];
-    workerRuntimes: ResidentWorkerRuntimeRecord[];
-}
-export interface RunEvidenceSummary {
-    agentExecutions: number;
-    teamSessions: number;
-    artifactIngestions: number;
-    workerRuntimes: number;
-    staleWorkerRuntimes: number;
-    routePreflight: boolean;
-    tasksChangedAfterRun: boolean;
-    tasksUpdatedAt: string | null;
-    runUpdatedAt: string | null;
-}
-export interface ResolvedTaskRun {
-    runId: string;
-    state: RunState;
-    context: ContextResolverContract;
-    model: SddTaskModel;
-    task: SddTask | null;
-    explicitRunId: boolean;
-    staleReasons: string[];
-    affectedFileConflicts: LocalRunIndexAffectedFileEntry[];
-}
-export interface ProjectStatus {
-    branch: string;
-    workflowStatus: 'active' | 'not_started';
-    context: ContextResolverContract;
-    gitRoot: string | null;
-    documents: SddTaskModel['documents'];
-    tasks: {
-        total: number;
-        pending: number;
-        inProgress: number;
-        completed: number;
-        blocked: number;
-        deferred: number;
-        unknown: number;
-        gaps: number;
-    };
-    latestRun: RunSummary | null;
-    latestRunsByTask: LocalRunIndexPartitionTaskEntry[];
-    latestRunEvidence: RunEvidenceSummary | null;
-    latestRunStaleReasons: string[];
-    affectedFileConflicts: LocalRunIndexAffectedFileEntry[];
-    recommendedNextCommand: string;
-    gaps: SddTaskGap[];
-}
-export interface SyncBackApplyPolicy {
-    mode: 'direct' | 'confirm';
-    requiresApproval: boolean;
-    reasons: string[];
-}
-export interface SyncBackInspection {
-    runId: string;
-    branch: string;
-    taskId: string | null;
-    status: 'ready' | 'blocked' | 'applied';
-    reasons: string[];
-    proposalPath: string | null;
-    proposal: string | null;
-    proposalDigest: string | null;
-    proposalDigestValid: boolean | null;
-    runTaskStatus: string | null;
-    markdownTask: SddTask | null;
-    markdownStatus: SddTaskStatus | null;
-    targetTasksPath: string;
-    artifacts: string[];
-    gaps: SddTaskGap[];
-    applyPolicy: SyncBackApplyPolicy;
-    staleReasons: string[];
-    affectedFileConflicts: LocalRunIndexAffectedFileEntry[];
-}
-export interface SyncBackApplyResult {
-    runId: string;
-    taskId: string;
-    applied: boolean;
-    tasksPath: string;
-    inspection: SyncBackInspection;
-    message: string;
-}
-export declare function getWorktreesDir(projectRoot: string): string;
-export declare function getSddDir(projectRoot: string): string;
-export declare function getProjectConfigPath(projectRoot: string): string;
-export declare function getRunsDir(projectRoot: string): string;
-export declare function getLocalRunIndexPath(projectRoot: string): string;
-export declare function getRuntimeStorePath(projectRoot: string): string;
-export declare function getRunDir(projectRoot: string, runId: string): string;
-export declare function getArtifactsDir(projectRoot: string, runId: string): string;
-export declare function getAgentExecutionsDir(projectRoot: string, runId: string): string;
-export declare function getTeamSessionsDir(projectRoot: string, runId: string): string;
-export declare function getWorkerRuntimesDir(projectRoot: string, runId: string): string;
-export declare function getInvocationLedgerPath(projectRoot: string, runId: string): string;
-export declare function getRouteCacheDir(projectRoot: string): string;
-export declare function getWorkerRuntimeRecordPath(projectRoot: string, runId: string, runtimeId: string): string;
-export declare function getAgentExecutionRecordPath(projectRoot: string, runId: string, executionId: string): string;
-export declare function getTeamSessionRecordPath(projectRoot: string, runId: string, teamId: string): string;
-export declare function getArtifactPath(projectRoot: string, runId: string, relativeArtifactPath: string): string;
-export declare function getRunRelativeArtifactPath(artifactRootRelativePath: string): string;
-export declare function toArtifactRootRelativePath(runRelativeArtifactPath: string): string;
-export declare function writeArtifact(projectRoot: string, runId: string, artifactRootRelativePath: string, content: string): Promise<{
-    absolutePath: string;
-    runRelativePath: string;
-}>;
-export declare function readArtifact(projectRoot: string, runId: string, artifactRootRelativePath: string): Promise<string>;
-export declare function appendInvocationLedgerEntry(projectRoot: string, input: Omit<InvocationLedgerEntry, 'contract' | 'version' | 'entryId' | 'timestamp'>): Promise<InvocationLedgerEntry>;
-export declare function listInvocationLedgerEntries(projectRoot: string, runId: string): Promise<InvocationLedgerEntry[]>;
-export declare function writeAgentExecutionRecord(projectRoot: string, record: AgentExecutionRecord): Promise<AgentExecutionRecord>;
-export declare function writeTeamSessionRecord(projectRoot: string, record: TeamSessionRecord): Promise<TeamSessionRecord>;
-export declare function writeResidentWorkerRuntimeRecord(projectRoot: string, record: ResidentWorkerRuntimeRecord): Promise<ResidentWorkerRuntimeRecord>;
-export declare function listAgentExecutionRecords(projectRoot: string, runId: string): Promise<AgentExecutionRecord[]>;
-export declare function listTeamSessionRecords(projectRoot: string, runId: string): Promise<TeamSessionRecord[]>;
-export declare function readResidentWorkerRuntimeRecord(projectRoot: string, runId: string, runtimeId: string): Promise<ResidentWorkerRuntimeRecord>;
-export declare function listResidentWorkerRuntimeRecords(projectRoot: string, runId: string): Promise<ResidentWorkerRuntimeRecord[]>;
-export type InitDocumentStatus = 'created' | 'unchanged' | 'overwritten' | 'skipped';
-export interface InitDocumentReport {
-    branch: string;
-    relativePath: string;
-    status: InitDocumentStatus;
-    message: string;
-}
-export interface InitDocumentsResult {
-    branch: string;
-    root: string;
-    documents: InitDocumentReport[];
-}
-export interface InitProjectResult {
-    configPath: string;
-    created: boolean;
-    documents: InitDocumentsResult;
-    aiTools: AiProjectionResult[];
-}
-export declare function initProject(projectRoot: string, options?: {
-    force?: boolean;
-    aiTool?: AiToolSelection;
-    branch?: string;
-    scaffoldDocuments?: boolean;
-}): Promise<InitProjectResult>;
-export declare function readProjectConfig(projectRoot: string): Promise<ProjectConfig>;
-export declare function createRun(projectRoot: string, options?: {
-    runId?: string;
-    lifecycleDecision?: LifecycleDecisionRecord;
-}): Promise<RunState>;
-export declare function readRunState(projectRoot: string, runId: string): Promise<RunState>;
-export declare function writeRunState(projectRoot: string, state: RunState): Promise<void>;
-export declare function appendEvent(projectRoot: string, runId: string, event: Omit<RuntimeEvent, 'contract' | 'time'>): Promise<RuntimeEvent>;
-export declare function archiveRun(projectRoot: string, runId: string, options?: {
-    reason?: string;
-}): Promise<RunState>;
-export declare function listRuns(projectRoot: string): Promise<RunSummary[]>;
-export declare function rebuildLocalRunIndex(projectRoot: string): Promise<LocalRunIndex>;
-export declare function readLocalRunIndex(projectRoot: string): Promise<LocalRunIndex>;
-export declare function queryLocalRunIndex(projectRoot: string, query?: LocalRunIndexQuery): Promise<LocalRunIndex>;
-export declare function inspectLocalRunIndex(projectRoot: string): Promise<LocalRunIndexInspection>;
-export declare function inspectRun(projectRoot: string, runId: string): Promise<RunInspection>;
-export declare function parseContextProfile(value: string | null | undefined): ContextProfile;
-export declare function contextBudgetForProfile(profile: ContextProfile): ContextBudget;
-export declare function summarizeCommandOutput(rawOutput: string, source: ContextSourceRef, profile?: ContextProfile): CommandOutputSummary;
-export declare function buildEvidenceSummaryProjection(projectRoot: string, options: EvidenceSummaryOptions): Promise<EvidenceSummaryProjection>;
-export declare function buildContextBuildPackage(projectRoot: string, options: ContextBuildOptions): Promise<ContextBuildPackage>;
-export declare function validateLogWorkerSummary(summary: LogWorkerSummary): LogWorkerSummaryValidation;
-export declare function resolveSddContext(projectRoot: string, options?: {
-    branch?: string | null;
-    branchSource?: ContextBranchSource;
-}): Promise<ContextResolverContract>;
-export declare function getProjectStatus(projectRoot: string, options?: {
-    branch?: string | null;
-    branchSource?: ContextBranchSource;
-}): Promise<ProjectStatus>;
-export declare function resolveTaskRun(projectRoot: string, options: {
-    runId?: string;
-    branch?: string;
-    taskId: string;
-}): Promise<ResolvedTaskRun>;
-export declare function inspectSyncBack(projectRoot: string, options: {
-    runId?: string;
-    branch?: string;
-    taskId?: string;
-}): Promise<SyncBackInspection>;
-export declare function applySyncBack(projectRoot: string, options: {
-    runId?: string;
-    branch?: string;
-    taskId?: string;
-    approved?: boolean;
-}): Promise<SyncBackApplyResult>;
-export declare function doctor(projectRoot: string, options?: {
-    allRuns?: boolean;
-    latestOnly?: boolean;
-    branch?: string | null;
-}): Promise<DoctorReport>;
-export declare function parseSddBranch(projectRoot: string, branch?: string): Promise<SddTaskModel>;
-export declare function parseSddTasksMarkdown(raw: string, options?: {
-    branch?: string;
-    tasksPath?: string;
-    validateDependencies?: boolean;
-}): Pick<SddTaskModel, 'tasks' | 'gaps'>;
-export declare function renderSddResultArtifactTemplate(projectRoot: string, options: SddResultArtifactTemplateOptions): Promise<string>;
-export declare function validateSddResultArtifact(projectRoot: string, runId: string, runRelativeArtifactPath: string, options?: {
-    expectedTask?: string;
-    expectedAgent?: string;
-}): Promise<SddResultValidationReport>;
-export declare function parseSddResultMarkdown(raw: string): SddResultValidationReport;
-export declare function validateSddResult(result: SddResult, options?: {
-    expectedTask?: string;
-    expectedAgent?: string;
-    runRelativeArtifactPath?: string;
-}): ContractValidationIssue[];
-export declare function parseSddEvidenceMarkdown(raw: string, options?: {
-    expectedTask?: string;
-    sourceArtifact?: string;
-}): ArtifactTrustValidationReport;
-export declare function createDelegationRecord(input: {
-    delegationId: string;
-    task: string;
-    agent: string;
-    expectedArtifact: string;
-    runMode?: DelegationRunMode;
-    blocking?: boolean;
-    requiredForPhaseExit?: boolean;
-    startedAt?: string;
-    timeoutSeconds?: number;
-    status?: DelegationStatus;
-}): DelegationRecord;
-export declare function isDelegationTerminal(status: DelegationStatus): boolean;
-export declare function isDelegationStale(delegation: DelegationRecord, now?: Date): boolean;
-export declare function validateDelegationRecord(projectRoot: string, runId: string, delegation: DelegationRecord, now?: Date): Promise<DelegationValidationReport>;
-export declare function ingestArtifactResult(projectRoot: string, runId: string, input: {
-    delegationId: string;
-    artifactPath: string;
-}): Promise<ArtifactResultIngestionResult>;
-export declare function inspectArtifactResultIngestions(projectRoot: string, runId: string): Promise<ArtifactResultIngestionInspection>;
-export declare function evaluateLifecycleDecisionGate(input?: Partial<LifecycleDecisionSignals>, decidedAt?: Date): LifecycleDecisionGateResult;
-export declare function recordLifecycleDecision(projectRoot: string, runId: string, record: LifecycleDecisionRecord): Promise<RunState>;
-export declare function runSingleTaskLoop(projectRoot: string, options: SingleTaskLoopOptions): Promise<SingleTaskLoopResult>;
-export declare function runGoalVerify(projectRoot: string, options: GoalVerifyOptions): Promise<GoalVerifyResult>;
-export declare function renderGoalVerifyResult(result: GoalVerifyResult): string;
-export declare function renderSingleTaskLoopResult(result: SingleTaskLoopResult): string;
-export declare function renderLifecycleDecisionGate(result: LifecycleDecisionGateResult): string;
-export declare function inspectSddTask(model: SddTaskModel, taskId: string): {
-    task: SddTask | null;
-    gaps: SddTaskGap[];
-};
-export declare function renderTaskList(model: SddTaskModel): string;
-export declare function renderTaskInspect(task: SddTask | null, gaps?: SddTaskGap[]): string;
-export declare function renderTaskGapReport(model: SddTaskModel): string;
-export declare function inspectTaskGraph(projectRoot: string, options?: {
-    branch?: string;
-}): Promise<TaskGraphPlan>;
-export declare function inspectWavePlan(projectRoot: string, options?: {
-    branch?: string;
-    capabilityId?: string;
-}): Promise<WavePlan>;
-export declare function runBackgroundExecutor(projectRoot: string, options: BackgroundExecutorRunOptions): Promise<BackgroundExecutorResult>;
-export declare function inspectBackgroundExecutor(projectRoot: string, runId: string): Promise<BackgroundExecutorInspection>;
-export declare function claimResidentWorkerRuntime(projectRoot: string, options: ResidentWorkerRuntimeClaimOptions): Promise<ResidentWorkerRuntimeClaimResult>;
-export declare function heartbeatResidentWorkerRuntime(projectRoot: string, options: ResidentWorkerRuntimeHeartbeatOptions): Promise<ResidentWorkerRuntimeHeartbeatResult>;
-export declare function listResidentWorkerRuntimes(projectRoot: string, options: {
-    runId: string;
-}): Promise<ResidentWorkerRuntimeList>;
-export declare function inspectResidentWorkerRuntime(projectRoot: string, options: {
-    runId: string;
-    runtimeId: string;
-}): Promise<ResidentWorkerRuntimeInspection>;
-export declare function runWaveExecutor(projectRoot: string, options?: WaveExecutorRunOptions): Promise<WaveExecutorResult>;
-export declare function inspectWaveExecutor(projectRoot: string, runId: string): Promise<WaveExecutorInspection>;
-export declare function renderDoctorReport(report: DoctorReport): string;
-export declare function defaultProjectConfig(projectName: string): ProjectConfig;
-export declare const TOOL_CAPABILITY_REGISTRY_VERSION = "phase-3.1-tool-capability-registry-v1";
-export declare const TOOL_PLUGIN_CONTRACT_REGISTRY_VERSION = "phase-3.2-tool-plugin-loading-contract-v1";
-export declare const DELEGATION_QUEUE_CONTRACT_VERSION = "phase-3.3-delegation-queue-contract-v1";
-export declare const DELEGATION_STATE_MACHINE_VERSION = "phase-3.4-delegation-state-machine-v1";
-export declare const WORKER_ADAPTER_CONTRACT_REGISTRY_VERSION = "phase-3.5-worker-adapter-contract-v1";
-export declare const ARTIFACT_RESULT_INGESTION_REGISTRY_VERSION = "phase-3.6-artifact-result-ingestion-v1";
-export declare const WORKTREE_ISOLATION_CONTRACT_VERSION = "phase-3.7-worktree-isolation-contract-v1";
-export declare const WORKTREE_LIFECYCLE_CONTRACT_VERSION = "phase-3.8-worktree-lifecycle-v1";
-export declare function listToolCapabilities(projectRoot: string): Promise<ToolCapabilityRegistry>;
-export declare function inspectToolCapability(projectRoot: string, capabilityId: string): Promise<ToolCapability | null>;
-export declare function inspectWorktreeIsolation(projectRoot: string, options: {
-    branch?: string;
-    taskId: string;
-    capabilityId?: string;
-    peerTaskIds?: string[];
-}): Promise<WorktreeIsolationDecision>;
-export declare function createWorktreeLifecycle(projectRoot: string, runId: string, options: {
-    taskId: string;
-    baseRef?: string;
-    worktreeId?: string;
-}): Promise<WorktreeLifecycleRecord>;
-export declare function inspectWorktreeLifecycle(projectRoot: string, runId: string): Promise<WorktreeLifecycleInspection>;
-export declare function keepWorktreeLifecycle(projectRoot: string, runId: string, worktreeId: string, options?: {
-    reason?: string;
-}): Promise<WorktreeLifecycleRecord>;
-export declare function removeWorktreeLifecycle(projectRoot: string, runId: string, worktreeId: string): Promise<WorktreeLifecycleRecord>;
-export declare function listToolPluginContracts(projectRoot: string): Promise<ToolPluginContractRegistry>;
-export declare function inspectToolPluginContract(projectRoot: string, pluginId: string): Promise<ToolPluginContract | null>;
-export declare function listWorkerAdapterContracts(projectRoot: string): Promise<WorkerAdapterContractRegistry>;
-export declare function inspectWorkerAdapterContract(projectRoot: string, adapterId: string): Promise<WorkerAdapterContract | null>;
-export declare function listWorkflowGates(projectRoot: string): Promise<WorkflowGateRegistry>;
-export declare function inspectWorkflowGate(projectRoot: string, workflowId: string): Promise<WorkflowGateContract | null>;
-export declare function validateWorkflowGates(projectRoot: string): Promise<WorkflowGateValidation>;
-export declare function listAgentRegistry(projectRoot: string): Promise<AgentRegistry>;
-export declare function inspectAgentRegistryEntry(projectRoot: string, agentId: string): Promise<AgentRegistryEntry | null>;
-export declare function validateAgentRegistry(projectRoot: string): Promise<AgentRegistryValidation>;
-export declare function inspectAgentSkillTeamRuntime(projectRoot: string): Promise<AgentSkillTeamRuntimeInspection>;
-export declare function validateAgentSkillTeamRuntime(projectRoot: string): Promise<AgentSkillTeamRuntimeValidation>;
-export declare function listSkillCapabilities(projectRoot: string): Promise<SkillCapabilityRegistry>;
-export declare function inspectSkillCapability(projectRoot: string, capabilityId: string): Promise<SkillCapabilityContract | null>;
-export declare function listCapabilitySources(projectRoot: string): Promise<CapabilitySourceCatalog>;
-export declare function inspectCapabilitySource(projectRoot: string, sourceId: string): Promise<CapabilitySourceCatalogEntry | null>;
-export declare function inspectExternalAgentPackImport(projectRoot: string, sourceId: string): Promise<ExternalAgentPackImportInspection>;
-export declare function inspectTeamModePolicy(projectRoot: string, options?: {
-    taskId?: string;
-    branch?: string;
-    enabled?: boolean;
-    teamModeActivation?: TeamModeActivation;
-}): Promise<TeamModePolicy>;
-export declare function routeSddTask(projectRoot: string, options?: {
-    taskId: string;
-    branch?: string;
-    agent?: string;
-    teamModeEnabled?: boolean;
-    teamModeActivation?: TeamModeActivation;
-    profile?: boolean;
-    cache?: boolean;
-}): Promise<AgentRouterDecision>;
-export declare function inspectQueryStatusContract(projectRoot: string): Promise<QueryStatusContract>;
-export declare function inspectSkillAgentEvalContract(projectRoot: string): Promise<SkillAgentEvalContract>;
-export declare function validateSkillAgentEvalContract(projectRoot: string): Promise<SkillAgentEvalValidation>;
-export declare function inspectHarnessLearningContract(projectRoot: string): Promise<HarnessLearningContract>;
-export declare function validateHarnessLearningContract(projectRoot: string): Promise<HarnessLearningValidation>;
-export declare function inspectProjectContextPackContract(projectRoot: string): Promise<ProjectContextPackContract>;
-export declare function validateProjectContextPackContract(projectRoot: string): Promise<ProjectContextPackValidation>;
-export declare function validateQueryStatusContract(projectRoot: string): Promise<QueryStatusValidation>;
-export declare function inspectGovernancePolicy(projectRoot: string): Promise<GovernancePolicy>;
-export declare function evaluateGovernancePolicy(projectRoot: string, input: GovernancePolicyDecisionInput): Promise<GovernancePolicyDecision>;
-export declare function listDelegationQueueItems(projectRoot: string, options?: {
-    runId?: string;
-}): Promise<DelegationQueueSnapshot>;
-export declare function inspectDelegationQueueItem(projectRoot: string, queueItemId: string): Promise<DelegationQueueItem | null>;
-export declare function getDelegationStateMachine(): DelegationStateMachine;
-export declare function validateDelegationStateTransition(from: DelegationStatus, to: DelegationStatus, event?: string | null): DelegationStateTransitionValidation;
-export declare function emptyLifecycleDecisionRecord(): LifecycleDecisionRecord;
-export declare function readRunEvents(projectRoot: string, runId: string): Promise<RuntimeEvent[]>;
-export declare function extractLifecycleRiskSignalsFromText(text: string, source?: LifecycleRiskExtractionSource): LifecycleRiskGateExtraction;
-export declare function lifecycleAutonomyCeiling(record: LifecycleDecisionRecord): LifecycleAutonomyCeiling;