snipara-companion 3.2.19 → 3.2.20

package/dist/index.d.ts

@@ -2747,1640 +2747,1672 @@ interface CodingLedgerExportCommandOptions extends CodingLedgerBuildOptions {
 declare function buildCodingIntelligenceLedger(options?: CodingLedgerBuildOptions): CodingIntelligenceLedger;
 declare function codingLedgerExportCommand(options: CodingLedgerExportCommandOptions): Promise<void>;
 
-declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
-type TeamSyncAttention = "note" | "watch" | "review" | "proof";
-type TeamSyncWorkStatus = "active" | "completed" | "archived";
-interface TeamSyncRecordInput {
-    summary: string;
-    files?: string[];
-    branch?: string;
-    actor?: string;
-    next?: string;
-    attention?: string;
-    risk?: string;
-    now?: Date;
-}
-interface TeamSyncWorkRecord {
-    id: string;
-    type: "work";
-    summary: string;
-    files: string[];
-    branch?: string;
-    actor?: string;
-    status: TeamSyncWorkStatus;
-    createdAt: string;
-    updatedAt: string;
-    completedAt?: string;
-    completionReason?: string;
-    archivedAt?: string;
-    archiveReason?: string;
-}
-interface TeamSyncHandoffRecord {
-    id: string;
-    type: "handoff";
-    summary: string;
-    files: string[];
-    next?: string;
-    attention?: TeamSyncAttention;
-    actor?: string;
-    createdAt: string;
-}
-interface TeamSyncState {
-    schemaVersion: "snipara.team-sync.v1";
-    updatedAt: string;
-    work: TeamSyncWorkRecord[];
-    handoffs: TeamSyncHandoffRecord[];
-}
-interface TeamSyncSummary {
-    activeWorkCount: number;
-    staleWorkCount: number;
-    completedWorkCount: number;
-    archivedWorkCount: number;
-    handoffCount: number;
-    files: string[];
-    staleWorkExplanation: TeamSyncStaleWorkExplanation;
-    hygieneActions: TeamSyncHygieneAction[];
-    latestActiveWork?: TeamSyncWorkRecord;
-    latestStaleWork?: TeamSyncWorkRecord;
-    latestCompletedWork?: TeamSyncWorkRecord;
-    latestArchivedWork?: TeamSyncWorkRecord;
-    latestHandoff?: TeamSyncHandoffRecord;
-}
-interface TeamSyncStaleWorkExplanation {
-    staleAfterHours: number;
-    autoArchiveAfterDays: number;
-    activeStaleCount: number;
-    autoArchivableCount: number;
-    completedIgnoredCount: number;
-    archivedIgnoredCount: number;
-    latestStaleWorkAgeHours?: number;
-    message: string;
-}
-interface TeamSyncHygieneAction {
-    kind: "sweep-preview" | "sweep-archive" | "complete-work" | "handoff";
-    command: string;
+declare const COLLABORATION_STATE_RELATIVE_PATH: string;
+type CollaborationGuardActionKind = "safe_to_ack" | "needs_handoff" | "needs_test" | "needs_package_review" | "blocking_conflict" | "guard_unavailable";
+interface CollaborationGuardActionCard {
+    kind: CollaborationGuardActionKind;
+    title: string;
     reason: string;
-    mutates: boolean;
-}
-interface TeamSyncCommandOptions {
-    id?: string;
-    summary?: string;
-    files?: string[];
-    branch?: string;
-    actor?: string;
-    next?: string;
-    attention?: string;
-    risk?: string;
-    adapterPack?: boolean;
-    adapterTarget?: string;
-    context?: string[];
-    proof?: string[];
-    acceptance?: string[];
-    conflictPosture?: string;
-    since?: string;
-    dir?: string;
-    includeSessionContext?: boolean;
-    emitOrchestratorHandoff?: boolean;
-    autoRouteOrchestrator?: boolean;
-    orchestratorPolicySource?: string;
-    output?: string;
-    days?: string;
-    dryRun?: boolean;
-    json?: boolean;
+    severity: "info" | "watch" | "warning" | "critical";
+    safeToAck: boolean;
+    command?: string;
+    conflictCode?: string;
+    resource?: string;
 }
-interface HostedAttempt<T> {
+interface HostedAttempt$1<T> {
     status: "skipped" | "ok" | "error";
     data?: T;
     error?: string;
 }
-interface TeamSyncSweepResult {
-    action: "sweep";
+interface WorkflowCollaborationReceipt {
+    workSessionId?: string;
+    hostedSessionStatus: HostedAttempt$1<CollaborationSessionResponse>["status"];
+    hostedClaimStatus?: HostedAttempt$1<CollaborationLeaseResponse>["status"];
+    hostedReleaseStatus?: HostedAttempt$1<Array<{
+        lease: CollaborationLeaseSummary;
+    }>>["status"];
+    hostedError?: string;
+    files: string[];
+    resourceCount: number;
+    leaseCount: number;
     statePath: string;
-    dryRun: boolean;
-    thresholdDays: number;
-    thresholdMs: number;
-    archivedCount: number;
-    archivedWork: TeamSyncWorkRecord[];
-    explanation: TeamSyncSweepExplanation;
-    summary: TeamSyncSummary;
-}
-interface TeamSyncSweepExplanation {
-    mode: "preview" | "archive";
-    candidateCount: number;
-    archivedCount: number;
-    remainingStaleCount: number;
-    message: string;
-}
-type AgenticHandoffAdapterTarget = "codex" | "claude-code" | "cursor" | "orca" | "windsurf" | "custom";
-type AgenticHandoffConflictPosture = "continue" | "wait" | "split_work" | "review_only" | "handoff";
-interface AgenticHandoffAdapterPack {
-    version: "snipara.ade_adapter_pack.v1";
-    target: {
-        id: AgenticHandoffAdapterTarget;
-        label: string;
-        profile: string;
-        instruction: string;
-        runtimeControl: "handoff_only";
-    };
-    contextPack: {
-        summary: string;
-        files: string[];
-        contextRefs: string[];
-        workflow?: {
-            goal?: string;
-            status?: string;
-            currentPhaseId?: string;
-            currentPhaseTitle?: string;
-        };
-        resumeCommands: string[];
-        constraints: string[];
-    };
-    conflictPosture: AgenticHandoffConflictPosture;
-    proofGates: string[];
-    acceptanceCriteria: string[];
-    receiptExpectation: {
-        required: boolean;
-        command: string;
-        requiredFields: string[];
-    };
-    prompt: string;
-    caveats: string[];
+    recordedAt: string;
 }
-interface TeamSyncCompletionEvidenceOptions {
+interface CollaborationCommandOptions {
     summary?: string;
-    workflowGoal?: string;
     files?: string[];
+    resources?: string[];
+    actor?: string;
+    actorId?: string;
+    actorType?: string;
+    sessionId?: string;
+    workSessionId?: string;
+    swarmId?: string;
+    client?: string;
+    repository?: string;
+    branch?: string;
+    worktree?: string;
+    action?: string;
+    profile?: string;
+    mode?: string;
     reason?: string;
-    now?: Date;
+    ttlSeconds?: string;
+    heartbeatTtlSeconds?: string;
+    intervalSeconds?: string;
+    maxFiles?: string;
+    leaseId?: string;
+    all?: boolean;
+    once?: boolean;
+    autoClaim?: boolean;
+    releaseStale?: boolean;
+    persist?: boolean;
+    enforce?: boolean;
+    ackReviewOnly?: boolean;
+    dir?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+interface CollaborationHooksInstallOptions {
+    dir?: string;
     dryRun?: boolean;
+    json?: boolean;
 }
-interface AgenticHandoffArtifact {
-    version: "snipara.agentic_handoff.v1";
-    generatedAt: string;
-    command: "snipara-companion handoff";
-    record: TeamSyncHandoffRecord;
-    statePath: string;
-    hosted: {
-        status: HostedAttempt<TeamSyncHandoffResponse>["status"];
-        handoffId?: string;
-        error?: string;
-    };
-    sections: {
-        whatChanged: string[];
-        verified: string[];
-        risky: string[];
-        remains: string[];
-        whereToResume: string[];
+interface CollaborationLocalLeaseRecord {
+    id: string;
+    mode: CollaborationLeaseMode;
+    status: CollaborationLeaseStatus;
+    resources: CollaborationResource[];
+    reason?: string;
+    claimedAt?: string;
+    expiresAt?: string | null;
+    workSessionId?: string;
+}
+interface CollaborationLocalState {
+    schemaVersion: "snipara.collaboration.v1";
+    updatedAt: string;
+    workSessionId?: string;
+    sessionId?: string;
+    actorId?: string;
+    actorType?: CollaborationActorType;
+    actorLabel?: string;
+    client?: string;
+    repository?: string;
+    branch?: string;
+    worktree?: string;
+    task?: string;
+    files: string[];
+    resources: CollaborationResource[];
+    leases: CollaborationLocalLeaseRecord[];
+    lastGuard?: {
+        decision: CollaborationGuardDecision;
+        severity: string;
+        checkedAt: string;
+        action: string;
+        resources: CollaborationResource[];
+        conflictCount: number;
     };
-    suggestedCommands: string[];
-    adapter?: AgenticHandoffAdapterPack;
 }
-declare function buildTeamSyncStartWorkRecord(input: TeamSyncRecordInput): TeamSyncWorkRecord;
-declare function buildTeamSyncHandoffRecord(input: TeamSyncRecordInput): TeamSyncHandoffRecord;
-declare function createEmptyTeamSyncState(now?: Date): TeamSyncState;
-declare function buildTeamSyncSummary(state: TeamSyncState, since?: Date, now?: Date): TeamSyncSummary;
-declare function archiveInactiveTeamSyncWork(state: TeamSyncState, options?: {
-    now?: Date;
-    thresholdMs?: number;
-    dryRun?: boolean;
-}): TeamSyncSweepResult["archivedWork"];
-declare function completeTeamSyncWorkFromEvidence(state: TeamSyncState, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
-declare function completeTeamSyncStateFromEvidence(rootDir?: string, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
-declare function autoArchiveTeamSyncState(rootDir?: string, now?: Date): TeamSyncSweepResult["archivedWork"];
-declare function loadTeamSyncState(rootDir?: string): TeamSyncState;
-declare function saveTeamSyncState(state: TeamSyncState, rootDir?: string): void;
-declare function getTeamSyncStatePath(rootDir?: string): string;
-declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
-declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
-
-type SyncDocumentKind = "DOC" | "BINARY";
-type WorkflowMode = "lite" | "standard" | "auto" | "full" | "orchestrate";
-type OnboardFolderMode = "auto" | "business_context" | "code_project" | "mixed";
-type DetectedOnboardFolderMode = "business_context" | "code_project" | "mixed" | "unknown";
-type ManagedWorkflowStatus = "active" | "completed" | "blocked";
-type ManagedWorkflowPhaseStatus = "pending" | "in_progress" | "completed" | "blocked" | "skipped";
-type ReindexKind = "doc" | "code";
-type ReindexMode = "incremental" | "full";
-type ManagedWorkflowPlanSource = "file" | "inline";
-type TaskCommitOutcome = "completed" | "partial" | "blocked" | "abandoned";
-type ManagedWorkflowSchemaVersion = "snipara.workflow.v1" | "snipara.workflow.v2";
-declare const WORKFLOW_STATE_RELATIVE_PATH: string;
-declare const WORKFLOW_PLANS_RELATIVE_DIR: string;
-declare const PRODUCER_LOOP_ARTIFACT_VERSION: "snipara.producer_loop_artifact.v0";
-declare const PRODUCER_LOOP_REPORT_VERSION: "snipara.producer_loop_report.v0";
-declare const PRODUCER_LOOP_RELATIVE_DIR: string;
-type ProducerLoopProducerKind = "workflow_phase_commit" | "workflow_final_commit" | "pr_answer_pack_decision_capture";
-type ProducerLoopSampleReviewStatus = "sample_unreviewed" | "sample_reviewed" | "sample_rejected";
-interface ProducerLoopArtifactWriteResult {
-    status: "written" | "error";
-    schemaVersion: typeof PRODUCER_LOOP_ARTIFACT_VERSION;
-    artifactId?: string;
-    path?: string;
-    relativePath?: string;
-    artifactHash?: string;
-    ledgerHash?: string;
-    error?: string;
-    caveats: string[];
+interface ResolvedCollaborationContext {
+    rootDir: string;
+    config: RLMConfig;
+    actor: Required<Pick<CollaborationActorPayload, "actorId" | "actorType" | "actorLabel">> & {
+        sessionId?: string;
+    };
+    client: string;
+    branch?: string;
+    repository?: string;
+    worktree?: string;
 }
-interface ProducerLoopArtifactReportSummary {
-    artifactId: string;
-    generatedAt: string;
-    producerKind: ProducerLoopProducerKind;
-    workflowId?: string;
-    phaseId?: string;
-    phaseTitle?: string;
-    outcome?: TaskCommitOutcome;
-    summary?: string;
-    path: string;
-    relativePath: string;
-    artifactHash: string;
-    ledgerHash?: string;
-    reasonCodes: string[];
+declare function createEmptyCollaborationState(now?: Date): CollaborationLocalState;
+declare function getCollaborationStatePath(rootDir?: string): string;
+declare function loadCollaborationState(rootDir?: string): CollaborationLocalState;
+declare function saveCollaborationState(state: CollaborationLocalState, rootDir?: string): void;
+declare function buildCollaborationActor(options: Pick<CollaborationCommandOptions, "actor" | "actorId" | "actorType" | "sessionId" | "client">, config: RLMConfig): ResolvedCollaborationContext["actor"];
+declare function normalizeCollaborationFiles(files: string[] | undefined): string[];
+declare function parseCollaborationResources(values: string[] | undefined): CollaborationResource[];
+declare function deriveLocalCollaborationResourcesFromFiles(files: string[] | undefined, rootDir?: string, maxFiles?: number): CollaborationResource[];
+declare function buildCollaborationHooksInstallPlan(options?: CollaborationHooksInstallOptions): Record<string, unknown>;
+declare function collaborationIdeStatusCommand(options: CollaborationCommandOptions): Promise<void>;
+declare function buildCollaborationGuardActionCards(evaluation: CollaborationGuardEvaluation | undefined, context?: {
+    profile?: string;
+    enforced?: boolean;
+    ackReviewOnly?: boolean;
+    reviewOnlyAcknowledged?: boolean;
+}): CollaborationGuardActionCard[];
+interface HostedGuardPayload {
     files: string[];
-    calibrationStatus?: string;
-    reviewStatus: ProducerLoopSampleReviewStatus;
-    reviewOutcome?: string;
-    reviewedAt?: string;
-    reviewer?: string;
+    resources: CollaborationResource[];
+    fileCount: number;
+    resourceCount: number;
+    filesTruncated: boolean;
+    resourcesTruncated: boolean;
 }
-interface ProducerLoopReport {
-    version: typeof PRODUCER_LOOP_REPORT_VERSION;
-    generatedAt: string;
-    source: {
-        directory: string;
-        localOnly: true;
+declare function buildHostedGuardPayload(files: string[], resources: CollaborationResource[]): HostedGuardPayload;
+declare function compactHostedGuardResources(resources: CollaborationResource[]): CollaborationResource[];
+
+type RuntimeEnvironment = Record<string, string | undefined>;
+type ProviderKeySource = "environment" | "env-file";
+type OrchestratorRecommendationLevel = "suggest" | "confirm" | "auto";
+type OrchestratorRecommendationReason = "workflow_mode_orchestrate" | "production_validation_intent" | "proof_gate_intent" | "htask_or_swarm_intent" | "multi_agent_intent" | "parallel_worker_intent" | "changed_files_threshold" | "team_sync_collision" | "policy_auto_route";
+interface OrchestratorRecommendation {
+    level: OrchestratorRecommendationLevel;
+    reasons: OrchestratorRecommendationReason[];
+    score: number;
+    orchestratorRequired: boolean;
+    policySource?: string;
+}
+interface OrchestratorRecommendationOptions {
+    changedFilesCount?: number;
+    hasActiveCollisions?: boolean;
+    policyAutoRoute?: boolean;
+    policySource?: string;
+    adaptiveRoutingDryRun?: boolean;
+}
+interface RuntimeDetectionReport {
+    cwd: string;
+    workspaceRoot: string | null;
+    companion: {
+        configured: boolean;
+        configPath: string;
     };
-    adoption: {
-        status: "missing" | "active";
-        artifactCount: number;
-        producerKinds: ProducerLoopProducerKind[];
-        workflowIds: string[];
+    runtime: {
+        cliAvailable: boolean;
+        command?: string;
+        legacyCommand?: boolean;
+        version?: string;
+        cliVersion?: string;
+        installedPackageVersion?: string;
+        versionMismatch?: boolean;
+        mcpConfigured: boolean;
+        mcpConfigPaths: string[];
     };
-    artifacts: ProducerLoopArtifactReportSummary[];
-    latestArtifact?: ProducerLoopArtifactReportSummary;
-    invalidArtifacts: Array<{
-        path: string;
-        relativePath: string;
-        error: string;
-    }>;
-    reasonCodes: {
-        counts: Record<string, number>;
+    orchestrator: {
+        cliAvailable: boolean;
+        command?: string;
+        version?: string;
+        source?: "path" | "workspace_venv";
+        workspacePackageVersion?: string;
+        versionMismatch?: boolean;
     };
-    calibration: {
-        status: "no_samples" | "insufficient_samples" | "reviewable_sample_set";
-        sampleSize: number;
-        reviewedSampleSize: number;
-        rejectedSampleSize: number;
-        unreviewedSampleSize: number;
-        minReviewSampleSize: number;
-        reviewOutcomes: Record<string, number>;
-        hardGateReady: false;
-        notes: string[];
+    providerKeys: {
+        openai: boolean;
+        anthropic: boolean;
+        any: boolean;
+        sources: {
+            openai?: ProviderKeySource;
+            anthropic?: ProviderKeySource;
+        };
+        envFilesLoaded: string[];
     };
-    recommendedActions: string[];
-    caveats: string[];
-}
-type WorkflowPlanPreset = "memory-backend-unification" | "project-intelligence-continuity-layer";
-interface WorkflowPlanScaffoldDocument {
-    preset: WorkflowPlanPreset;
-    mode: "full";
-    goal: string;
-    steps: Array<{
-        id: string;
-        title: string;
-        query: string;
-        acceptance?: string;
-        files?: string[];
-        gates?: string[];
-        needs_runtime?: boolean;
-    }>;
-}
-interface ManagedWorkflowRuntimeCheckpoint {
-    summary: string;
-    capturedAt: string;
-    automationSessionId?: string;
-    hostedEventId?: string;
-    hostedRecordedAt?: string;
-    environment?: string;
-    profile?: string;
-    bootstrapQuery?: string;
-    files?: string[];
-    commands?: string[];
-    artifacts?: string[];
-    contextPackReceipts?: LocalContextPackReceiptPayload[];
-    rehydratableState?: Record<string, unknown>;
-}
-interface ManagedWorkflowSandboxRuntimeBinding {
-    phaseId: string;
-    sessionId: string;
-    automationSessionId?: string;
-    boundAt: string;
-    bootstrapQuery: string;
-    environment?: string;
-    profile?: string;
-    artifacts?: string[];
-    lastCheckpoint?: ManagedWorkflowRuntimeCheckpoint;
-}
-interface ManagedWorkflowRuntimeState {
-    sandbox?: {
-        provider: "snipara-sandbox";
-        bindings: ManagedWorkflowSandboxRuntimeBinding[];
+    docker: {
+        available: boolean;
     };
 }
-interface ManagedWorkflowPhase {
+declare function detectRuntimeEnvironment(cwd?: string, env?: RuntimeEnvironment): RuntimeDetectionReport;
+declare function shouldSuggestRuntimeForWorkflow(query: string, mode: WorkflowMode): boolean;
+/**
+ * Recommend whether work should be routed to snipara-orchestrator.
+ *
+ * Scores intent signals from the query and workflow mode (orchestrate mode,
+ * production / proof / htask / multi-agent / parallel patterns) plus contextual
+ * signals (changed-file count, active Team Sync collisions, policy auto-route).
+ * The returned recommendation's level escalates with the accumulated score
+ * (suggest → confirm → auto).
+ *
+ * @returns A recommendation with its reasons, or `null` when no signal fires.
+ */
+declare function getOrchestratorRecommendation(query: string, mode: WorkflowMode, options?: OrchestratorRecommendationOptions): OrchestratorRecommendation | null;
+declare function formatOrchestratorRecommendationReason(reason: OrchestratorRecommendationReason): string;
+declare function shouldSuggestOrchestratorForWorkflow(query: string, mode: WorkflowMode): boolean;
+
+declare const ORCHESTRATOR_HANDOFF_RELATIVE_PATH: string;
+interface OrchestratorHandoffWorkflowPhase {
     id: string;
     title: string;
     query: string;
-    status: ManagedWorkflowPhaseStatus;
+    status: string;
     acceptance?: string;
-    files?: string[];
-    gates?: string[];
-    needsRuntime?: boolean;
-    startedAt?: string;
-    completedAt?: string;
-    summary?: string;
-    outcome?: TaskCommitOutcome;
-}
-interface ManagedWorkflowState {
-    schemaVersion: ManagedWorkflowSchemaVersion;
-    workflowId: string;
-    goal: string;
-    status: ManagedWorkflowStatus;
-    currentPhaseId?: string;
-    planSource: ManagedWorkflowPlanSource;
-    planFile?: string;
-    createdAt: string;
-    updatedAt: string;
-    phases: ManagedWorkflowPhase[];
-    runtime?: ManagedWorkflowRuntimeState;
-    lastCommit?: {
-        category: string;
-        outcome: TaskCommitOutcome;
-        summary: string;
-        committedAt: string;
-    };
-}
-interface AgenticWorkStatus {
-    version: "snipara.agentic_status.v1";
-    generatedAt: string;
-    branch?: string;
-    git: {
-        head?: string;
-        dirtyFileCount: number;
-        statusLines: string[];
-        error?: string;
-    };
-    workflow: {
-        id: string;
-        goal: string;
-        status: ManagedWorkflowStatus;
-        currentPhase?: {
-            id: string;
-            title: string;
-            status: ManagedWorkflowPhaseStatus;
-        };
-        lastPhaseCommit?: {
-            phaseId: string;
-            title: string;
-            summary?: string;
-            outcome?: TaskCommitOutcome;
-            completedAt?: string;
-        };
-        resumeCommand: string;
-    } | null;
-    teamSync: {
-        activeWorkCount: number;
-        staleWorkCount: number;
-        staleWorkExplanation: TeamSyncStaleWorkExplanation;
-        archivedWorkCount: number;
-        handoffCount: number;
-        latestHandoff?: {
-            summary: string;
-            next?: string;
-            attention?: string;
-            createdAt: string;
-        };
-    };
-    risks: string[];
-    openDecisions: {
-        count?: number;
-        note: string;
-    };
-    operationalLoop: {
-        status: "clear" | "attention" | "blocked";
-        decisionRequestCount: number;
-        receiptGapCount: number;
-        nextActions: string[];
-        receiptActions: string[];
-        caveats: string[];
-    };
-    suggestedNextAction: string;
+    files: string[];
+    gates: string[];
+    needsRuntime: boolean;
 }
-interface AgenticTimelineEvent {
-    time: string;
-    kind: string;
+interface OrchestratorHandoffRuntimeSandboxPhase {
+    phaseId: string;
     title: string;
-    detail?: string;
-    source: ActivityEventSource;
-    files?: string[];
+    bootstrapQuery: string;
+    files: string[];
+    artifacts: string[];
+    contextPacks: string[];
+    sessionId: string | null;
+    environment: string | null;
+    profile: string | null;
+    hasCheckpoint: boolean;
+    checkpointSummary: string | null;
+    checkpointCapturedAt: string | null;
 }
-interface AgenticTimeline {
-    version: "snipara.agentic_timeline.v1";
-    generatedAt: string;
-    events: AgenticTimelineEvent[];
-    limit: number;
+interface AdaptiveWorkProfile {
+    taskType: string;
+    risk: string;
+    scope: string[];
+    contextBudget: string;
+    reasoningDepth: string;
+    evidenceRequirements?: string[];
+    preferredProfileStrengths?: string[];
+    notes?: string[];
 }
-interface WorkflowImpactGateCommit {
-    sha: string;
-    shortSha: string;
-    subject: string;
-    author?: string;
-    authoredAt?: string;
+interface AdaptiveModelRequirements {
+    workerRole: string;
+    reasoning: string;
+    plannerRetainsReasoning: boolean;
+    speed: string;
+    cost: string;
+    contextBudget: string;
+    capabilities: string[];
+    forbiddenCapabilities: string[];
+    writeScope: string[];
+    structuredOutputRequired?: boolean;
+    preferredEndpointTypes?: string[];
+    allowedEndpointTypes?: string[];
+    catalogLimit?: number;
+    dailyBudgetCents?: number;
+    monthlyBudgetCents?: number;
+    fallback: "main_agent";
 }
-interface WorkflowImpactGatePhase {
-    id: string;
-    title: string;
-    summary?: string;
-    outcome?: TaskCommitOutcome;
-    completedAt?: string;
-    files: string[];
-    filesInUnpushedDiff: string[];
+interface AdaptiveRoutingCostEstimate {
+    currency: "USD";
+    confidence: "low" | "medium" | "high";
 }
-interface WorkflowImpactGateResult {
-    version: "snipara.workflow_impact_gate.v1";
-    generatedAt: string;
-    gate: {
-        status: "pass" | "attention";
-        reasonCodes: string[];
-    };
-    repo: {
-        root: string;
-        branch?: string;
-        upstream: string;
-        baseSha?: string;
-        headSha?: string;
-    };
-    unpushed: {
-        commitCount: number;
-        commits: WorkflowImpactGateCommit[];
-        changedFiles: string[];
-        codeChangedFiles: string[];
-        nonCodeChangedFiles: string[];
-    };
-    dirtyWorkingTree: {
-        fileCount: number;
-        statusLines: string[];
-        files: string[];
-        includedInLocalImpact: false;
-    };
-    workflow: {
-        id?: string;
-        goal?: string;
-        status?: ManagedWorkflowStatus;
-        completedPhases: WorkflowImpactGatePhase[];
-        changedFilesWithoutPhase: string[];
-        phaseFilesOutsideUnpushedDiff: string[];
-    };
-    localImpact: Record<string, unknown> | null;
-    recommendedActions: string[];
-    caveats: string[];
-    hostedFollowUpCommand?: string;
+interface AdaptiveRoutingCard {
+    mode: "dry_run";
+    workProfile: AdaptiveWorkProfile;
+    requirements: AdaptiveModelRequirements;
+    recommendedWorkerClass: string;
+    costEstimate: AdaptiveRoutingCostEstimate;
+    humanApprovalRequired: boolean;
+    fallback: "main_agent";
+    rejectedReasons?: Record<string, string[]>;
+    reasons: string[];
+    warnings: string[];
 }
-interface WorkflowPlanScaffoldResult {
-    preset: WorkflowPlanPreset;
-    goal: string;
-    outputPath: string;
-    relativeOutputPath: string;
-    plan: WorkflowPlanScaffoldDocument;
+interface AdaptiveRoutingGatewayStatus {
+    source: "hosted_mcp" | "local_orchestrator";
+    success: boolean;
+    resolutionStatus?: string;
+    candidateCount: number;
+    fallback?: string;
+    warnings: string[];
 }
-interface SyncDocumentsManifestOptions {
-    metadataDefaults: Record<string, unknown>;
-    deleteMissing?: boolean;
-    dryRun?: boolean;
-    reindex?: boolean;
-    reindexKind?: ReindexKind;
-    reindexMode?: ReindexMode;
+interface AdaptiveRoutingRuntimeCatalog {
+    version?: string;
+    source?: string;
+    provider?: string;
+    baseUrl?: string;
+    models?: string[];
+    apiPaths?: Record<string, unknown>;
+    workerEndpoints?: Record<string, Record<string, unknown>>;
+    workerProfiles?: Record<string, Record<string, unknown>>;
+    candidates: Array<Record<string, unknown>>;
 }
-interface CollectedSyncDocuments {
-    documents: SyncDocumentInput[];
-    manifestOptions: SyncDocumentsManifestOptions;
+interface AdaptiveRoutingResolution {
+    status?: string;
+    selected?: Record<string, unknown>;
+    policyDecision?: Record<string, unknown>;
+    evaluatedCount?: number;
+    rejectedCount?: number;
+    fallback?: string;
+    reasons?: string[];
+    warnings?: string[];
+    rejectedReasons?: Record<string, string[]>;
 }
-interface SyncDocumentsDryRunItem {
-    path: string;
-    status: "valid" | "invalid_metadata";
-    recommended_action: "none" | "reupload" | "review_source_metadata";
-    reasons: string[];
-    kind?: SyncDocumentKind;
-    format?: string;
-    size_bytes: number;
-    content_hash: string;
-    assetClass?: string;
-    usageMode?: string;
-    sourceKind?: string;
+interface AdaptiveWorkRoutingRecommendation {
+    workProfile: AdaptiveWorkProfile;
+    requirements: AdaptiveModelRequirements;
+    routingCard: AdaptiveRoutingCard;
+    gateway?: AdaptiveRoutingGatewayStatus;
+    runtimeCatalog?: AdaptiveRoutingRuntimeCatalog;
+    resolution?: AdaptiveRoutingResolution;
 }
-interface SyncDocumentsDryRunSummary {
-    dry_run: true;
-    remote_diff_available: false;
-    total: number;
-    would_sync: number;
-    invalid_metadata: number;
-    stale: number;
-    needs_reupload: number;
-    needs_metadata_review: number;
-    delete_missing: boolean;
-    reindex_requested: boolean;
-    reindex_kind: ReindexKind;
-    reindex_mode: ReindexMode;
-    created: null;
-    updated: null;
-    unchanged: null;
-    missing_from_manifest: null;
-    note: string;
-    documents: SyncDocumentsDryRunItem[];
-}
-interface OnboardFolderScannedFile {
-    path: string;
-    size_bytes: number;
-    supported: boolean;
-    kind?: SyncDocumentKind;
-    format?: string;
-}
-interface OnboardFolderClassification {
-    mode: DetectedOnboardFolderMode;
-    detected_mode: DetectedOnboardFolderMode;
-    confidence: number;
-    code_score: number;
-    business_score: number;
-    signals: {
-        code: string[];
-        business: string[];
-    };
+interface AdaptiveWorkRoutingOptions {
+    query: string;
+    mode?: string;
+    changedFiles?: string[];
+    preferredEndpointTypes?: string[];
+    allowedEndpointTypes?: string[];
+    workerRole?: string;
+    plannerRetainsReasoning?: boolean;
+    preferredProfileStrengths?: string[];
+    structuredOutputRequired?: boolean;
+    catalogLimit?: number;
+    dailyBudgetCents?: number;
+    monthlyBudgetCents?: number;
 }
-interface OnboardFolderManifest {
-    schemaVersion: "snipara.onboard-folder.v1";
+interface OrchestratorHandoffArtifact {
+    schemaVersion: "snipara.orchestrator.handoff.v1";
     source: {
-        root: string;
-        sourceKind: string;
-        sourceProvider: string;
-        sourceUri?: string;
-        snapshotAt: string;
-        recursive: boolean;
+        client: "snipara-companion";
+        command: string;
+        generatedAt: string;
     };
-    classification: OnboardFolderClassification;
-    summary: {
-        total_files: number;
-        supported_documents: number;
-        ignored_files: number;
-        unsupported_business_files: number;
+    workflow: {
+        mode: string;
+        workflowId: string | null;
+        currentPhaseId: string | null;
+        phases: OrchestratorHandoffWorkflowPhase[];
     };
-    warnings: string[];
-    ignored: OnboardFolderScannedFile[];
-    sync: {
-        dryRun: boolean;
-        reindex: boolean;
-        reindexKind: ReindexKind;
-        reindexMode: ReindexMode;
-        deleteMissing: boolean;
-        metadata: Record<string, unknown>;
-        documents: SyncDocumentInput[];
+    runtime: {
+        sandbox: {
+            provider: "snipara-sandbox";
+            phases: OrchestratorHandoffRuntimeSandboxPhase[];
+        } | null;
     };
-    dryRun: SyncDocumentsDryRunSummary;
-}
-declare function getPlanStepDisplayTitle(step: unknown, index?: number): string;
-interface PlanQualityReport {
-    valid: boolean;
-    issues: string[];
-    warnings: string[];
-    stepCount: number;
-    actions: string[];
-    planId?: string;
-}
-interface WorkflowTokenBudgetReport {
-    requested_max_tokens: number;
-    allocations: {
-        critical_memory_tokens: number;
-        session_context_tokens: number;
-        context_query_tokens: number;
-        shared_context_tokens: number;
-        plan_tokens: number;
+    routing: {
+        level: OrchestratorRecommendation["level"];
+        reasons: OrchestratorRecommendation["reasons"];
+        policySource: string | null;
+        workProfile?: AdaptiveWorkProfile;
+        requirements?: AdaptiveModelRequirements;
+        routingCard?: AdaptiveRoutingCard;
+        gateway?: AdaptiveRoutingGatewayStatus;
+        runtimeCatalog?: AdaptiveRoutingRuntimeCatalog;
+        resolution?: AdaptiveRoutingResolution;
     };
-    estimated_max_tokens: number;
-    include_session_context: boolean;
-    explicit: {
-        max_critical_tokens: boolean;
-        max_context_tokens: boolean;
+    task: {
+        title: string;
+        query: string;
+        summary: string;
     };
-    warnings: string[];
-}
-interface SessionBootstrapQualityReport {
-    warnings: string[];
-    counts: {
-        critical_memories: number;
-        session_context_memories: number;
-        low_confidence_memories: number;
-        stale_memories: number;
-        test_memories: number;
+    repo: {
+        root: string;
+        branch: string | null;
+        headSha: string | null;
+        changedFiles: string[];
+    };
+    coordination: {
+        swarmId: string | null;
+        claimScope: {
+            files: string[];
+            symbols: string[];
+        };
+        htask: {
+            featureTitle: string | null;
+            workstreams: string[];
+        };
+    };
+    validation: {
+        requiresProofGate: boolean;
+        requiresDriftCheck: boolean;
+        liveChecks: string[];
+        requiredEvidence: Array<{
+            type: string;
+            description: string;
+        }>;
+    };
+    memory: {
+        decisionIds: string[];
+        contextRefs: string[];
+        resumeSummary: string | null;
     };
-    total_tokens?: number;
-    oldest_memory_age_days?: number;
 }
-interface SessionBootstrapBrief {
-    entries: SessionMemoryEntry[];
-    availableCount: number;
-    hiddenCount: number;
-    estimatedTokens: number;
-    budgetTokens: number;
+interface OrchestratorHandoffOptions {
+    sourceCommand: string;
+    recommendation: OrchestratorRecommendation;
+    query: string;
+    summary: string;
+    title?: string;
+    mode?: string;
+    rootDir?: string;
+    changedFiles?: string[];
+    contextRefs?: string[];
+    decisionIds?: string[];
+    resumeSummary?: string;
+    featureTitle?: string;
+    workstreams?: string[];
+    adaptiveRouting?: AdaptiveWorkRoutingRecommendation | null;
 }
-interface GeneratedWorkflowPlanDocument {
-    mode: "full";
-    goal: string;
-    source: "snipara_plan";
-    plan_id?: string;
-    generatedAt: string;
-    steps: Array<{
-        id: string;
-        title: string;
-        query: string;
-        acceptance?: string;
-        files?: string[];
-        needs_runtime?: boolean;
-    }>;
+interface WrittenOrchestratorHandoff {
+    handoff: OrchestratorHandoffArtifact;
+    path: string;
+    relativePath: string;
+    command: string;
 }
-declare function resolveFullWorkflowTokenBudget(options: {
-    maxTokens?: number;
-    includeSessionContext?: boolean;
-    includeSharedContext?: boolean;
-    maxCriticalTokens?: number;
-    maxContextTokens?: number;
-}): WorkflowTokenBudgetReport;
-declare function validatePlanResult(plan: unknown, options?: {
-    query?: string;
+declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions): OrchestratorHandoffArtifact;
+declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
+declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
+
+interface JournalCheckpointPayload {
+    action: string;
+    summary: string;
+    outcome?: string;
+    workflowId?: string;
+    phaseId?: string;
+    phaseTitle?: string;
+    branch?: string;
+    actor?: string;
+    next?: string;
+    attention?: string;
+    files?: string[];
     cwd?: string;
-}): PlanQualityReport;
-declare function buildSessionBootstrapBrief(result: SessionMemoriesResult, options: {
-    includeSessionContext: boolean;
-    maxTokens?: number;
-    maxEntries?: number;
+}
+declare function buildJournalCheckpointEntry(payload: JournalCheckpointPayload): {
+    text: string;
+    tags: string[];
+};
+
+declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
+type TeamSyncAttention = "note" | "watch" | "review" | "proof";
+type TeamSyncWorkStatus = "active" | "completed" | "archived";
+interface TeamSyncRecordInput {
+    summary: string;
+    files?: string[];
+    branch?: string;
+    actor?: string;
+    next?: string;
+    attention?: string;
+    risk?: string;
     now?: Date;
-}): SessionBootstrapBrief;
-declare function buildSessionBootstrapQuality(result: SessionMemoriesResult, options?: {
-    expectedMaxTokens?: number;
-    now?: Date;
-}): SessionBootstrapQualityReport;
-declare function buildGeneratedWorkflowPlanDocument(plan: Record<string, unknown>, fallbackGoal: string): GeneratedWorkflowPlanDocument;
-declare function normalizeWorkflowPlanInput(input: unknown, fallbackGoal: string): ManagedWorkflowPhase[];
-declare function buildWorkflowPlanScaffold(preset: WorkflowPlanPreset, options?: {
-    goal?: string;
-    outputPath?: string;
-    cwd?: string;
-}): WorkflowPlanScaffoldResult;
-declare function writeProducerLoopArtifact(options: {
-    kind: ProducerLoopProducerKind;
-    command: "workflow phase-commit" | "workflow final-commit";
-    state?: ManagedWorkflowState;
-    phase?: ManagedWorkflowPhase;
-    category: string;
-    outcome: TaskCommitOutcome;
+}
+interface TeamSyncWorkRecord {
+    id: string;
+    type: "work";
     summary: string;
-    files?: string[];
-    journalAttempted: boolean;
-    teamSyncCompletionAttempted: boolean;
-}): ProducerLoopArtifactWriteResult;
-declare function buildProducerLoopReport(options?: {
-    cwd?: string;
-    minReviewSampleSize?: number;
-}): ProducerLoopReport;
-declare function buildWorkflowPhaseCommitSummary(args: {
-    workflowId: string;
-    phase: Pick<ManagedWorkflowPhase, "id" | "title">;
+    files: string[];
+    branch?: string;
+    actor?: string;
+    status: TeamSyncWorkStatus;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    completionReason?: string;
+    archivedAt?: string;
+    archiveReason?: string;
+}
+interface TeamSyncHandoffRecord {
+    id: string;
+    type: "handoff";
     summary: string;
-}): string;
-declare function resolveAutoWorkflowMode(query: string): Exclude<WorkflowMode, "auto">;
-/**
- * Compute the impact gate for committed-but-unpushed workflow phases.
- *
- * Compares `upstream..HEAD`, separates unpushed code changes from non-code and
- * dirty working-tree files, runs local code-overlay impact on the committed
- * code files, and maps the result back to completed workflow phases. Surfaces
- * reason codes such as `dirty_working_tree_not_included` and phase files that
- * fall outside the unpushed diff, so a phase is not treated as verified on
- * stale or partial evidence.
- *
- * @returns A `WorkflowImpactGateResult` with changed files, local impact,
- *   matched phases, and reason codes.
- */
-declare function buildWorkflowImpactGate(options?: {
-    cwd?: string;
-    base?: string;
-    maxFiles?: number;
-}): WorkflowImpactGateResult;
-declare function collectSyncDocuments(options: {
-    file?: string;
-    dir?: string;
-    prefix?: string;
-    recursive?: boolean;
-}): SyncDocumentInput[];
-declare function collectSyncDocumentsInput(options: {
-    file?: string;
-    dir?: string;
-    prefix?: string;
-    recursive?: boolean;
-}): CollectedSyncDocuments;
-interface OnboardFolderOptions {
-    dir: string;
-    recursive?: boolean;
-    mode?: OnboardFolderMode;
-    prefix?: string;
-    usageMode?: string;
-    sourceKind?: string;
-    sourceProvider?: string;
-    sourceUri?: string;
-    clientId?: string;
-    snapshotAt?: string;
-    deleteMissing?: boolean;
-    reindex?: boolean;
-    reindexKind?: ReindexKind;
-    reindexMode?: ReindexMode;
+    files: string[];
+    next?: string;
+    attention?: TeamSyncAttention;
+    actor?: string;
+    createdAt: string;
 }
-declare function buildOnboardFolderManifest(options: OnboardFolderOptions): OnboardFolderManifest;
-declare function buildSyncDocumentsDryRun(documents: SyncDocumentInput[], options?: {
-    deleteMissing?: boolean;
-    reindex?: boolean;
-    reindexKind?: ReindexKind;
-    reindexMode?: ReindexMode;
-    now?: Date;
-}): SyncDocumentsDryRunSummary;
-declare function buildAgenticWorkStatus(cwd?: string): AgenticWorkStatus;
-declare function buildAgenticTimeline(options?: {
-    limit?: number;
-    cwd?: string;
-}): AgenticTimeline;
-
-type LocalSourceProvider = "local_folder";
-type LocalSourceFileKind = "DOC" | "BINARY" | "CODE" | "CONFIG" | "OTHER";
-type LocalSourceSkippedReason = "ignored" | "too_large" | "read_error";
-type LocalSourceReindexKind = "doc" | "code";
-type LocalSourceReindexMode = "incremental" | "full";
-interface LocalSourceFile {
-    path: string;
-    kind: LocalSourceFileKind;
-    format: string | null;
-    sizeBytes: number;
-    modifiedAt: string;
-    sha256: string;
+interface TeamSyncState {
+    schemaVersion: "snipara.team-sync.v1";
+    updatedAt: string;
+    work: TeamSyncWorkRecord[];
+    handoffs: TeamSyncHandoffRecord[];
 }
-interface LocalSourceSkippedFile {
-    path: string;
-    reason: LocalSourceSkippedReason;
-    sizeBytes?: number;
+interface TeamSyncSummary {
+    activeWorkCount: number;
+    staleWorkCount: number;
+    completedWorkCount: number;
+    archivedWorkCount: number;
+    handoffCount: number;
+    files: string[];
+    staleWorkExplanation: TeamSyncStaleWorkExplanation;
+    hygieneActions: TeamSyncHygieneAction[];
+    latestActiveWork?: TeamSyncWorkRecord;
+    latestStaleWork?: TeamSyncWorkRecord;
+    latestCompletedWork?: TeamSyncWorkRecord;
+    latestArchivedWork?: TeamSyncWorkRecord;
+    latestHandoff?: TeamSyncHandoffRecord;
 }
-interface LocalSourceSummary {
-    totalFiles: number;
-    totalBytes: number;
-    byKind: Record<LocalSourceFileKind, number>;
-    skipped: number;
+interface TeamSyncStaleWorkExplanation {
+    staleAfterHours: number;
+    autoArchiveAfterDays: number;
+    activeStaleCount: number;
+    autoArchivableCount: number;
+    completedIgnoredCount: number;
+    archivedIgnoredCount: number;
+    latestStaleWorkAgeHours?: number;
+    message: string;
 }
-interface LocalSourceSnapshot {
-    version: "snipara.local_source_snapshot.v1";
-    generatedAt: string;
-    root: string;
-    provider: LocalSourceProvider;
-    revision: string;
-    recursive: boolean;
-    maxFiles: number;
-    maxFileBytes: number;
-    summary: LocalSourceSummary;
-    files: LocalSourceFile[];
-    skipped: {
-        total: number;
-        byReason: Record<LocalSourceSkippedReason, number>;
-        samples: LocalSourceSkippedFile[];
-    };
-    warnings: string[];
+interface TeamSyncHygieneAction {
+    kind: "sweep-preview" | "sweep-archive" | "complete-work" | "handoff";
+    command: string;
+    reason: string;
+    mutates: boolean;
 }
-interface LocalSourceSnapshotOptions {
+interface TeamSyncCommandOptions {
+    id?: string;
+    summary?: string;
+    files?: string[];
+    branch?: string;
+    actor?: string;
+    next?: string;
+    attention?: string;
+    risk?: string;
+    adapterPack?: boolean;
+    adapterTarget?: string;
+    context?: string[];
+    proof?: string[];
+    acceptance?: string[];
+    conflictPosture?: string;
+    since?: string;
     dir?: string;
-    recursive?: boolean;
-    maxFiles?: number;
-    maxFileBytes?: number;
+    includeSessionContext?: boolean;
+    emitOrchestratorHandoff?: boolean;
+    autoRouteOrchestrator?: boolean;
+    orchestratorPolicySource?: string;
+    output?: string;
+    days?: string;
+    dryRun?: boolean;
+    json?: boolean;
 }
-interface LocalSourceComparison {
-    added: string[];
-    modified: string[];
-    deleted: string[];
-    unchanged: number;
+interface HostedAttempt<T> {
+    status: "skipped" | "ok" | "error";
+    data?: T;
+    error?: string;
 }
-interface LocalSourceStatusResult {
-    root: string;
-    snapshotPath: string;
-    previous: LocalSourceSnapshot | null;
-    current: LocalSourceSnapshot;
-    comparison: LocalSourceComparison;
+interface TeamSyncSweepResult {
+    action: "sweep";
+    statePath: string;
+    dryRun: boolean;
+    thresholdDays: number;
+    thresholdMs: number;
+    archivedCount: number;
+    archivedWork: TeamSyncWorkRecord[];
+    explanation: TeamSyncSweepExplanation;
+    summary: TeamSyncSummary;
 }
-interface LocalSourceSyncOptions extends LocalSourceSnapshotOptions {
-    prefix?: string;
-    mode?: OnboardFolderMode;
-    deleteMissing?: boolean;
-    apply?: boolean;
-    reindex?: boolean;
-    reindexKind?: LocalSourceReindexKind;
-    reindexMode?: LocalSourceReindexMode;
-    includeGraph?: boolean;
-    json?: boolean;
+interface TeamSyncSweepExplanation {
+    mode: "preview" | "archive";
+    candidateCount: number;
+    archivedCount: number;
+    remainingStaleCount: number;
+    message: string;
 }
-interface LocalSourceSyncResult {
-    root: string;
-    snapshotPath: string;
-    snapshot: LocalSourceSnapshot;
-    comparison: LocalSourceComparison;
-    documents: {
-        onboarding: Pick<OnboardFolderManifest, "source" | "classification" | "summary" | "warnings">;
-        dryRun: OnboardFolderManifest["dryRun"];
+type AgenticHandoffAdapterTarget = "codex" | "claude-code" | "cursor" | "orca" | "windsurf" | "custom";
+type AgenticHandoffConflictPosture = "continue" | "wait" | "split_work" | "review_only" | "handoff";
+interface AgenticHandoffAdapterPack {
+    version: "snipara.ade_adapter_pack.v1";
+    target: {
+        id: AgenticHandoffAdapterTarget;
+        label: string;
+        profile: string;
+        instruction: string;
+        runtimeControl: "handoff_only";
     };
-    codeOverlay: {
-        cachePath: string;
-        summary: LocalCodeOverlaySummary;
+    contextPack: {
+        summary: string;
+        files: string[];
+        contextRefs: string[];
+        workflow?: {
+            goal?: string;
+            status?: string;
+            currentPhaseId?: string;
+            currentPhaseTitle?: string;
+        };
+        resumeCommands: string[];
+        constraints: string[];
     };
-    apply: null | {
-        sync: Record<string, unknown>;
-        reindex?: Record<string, unknown>;
+    conflictPosture: AgenticHandoffConflictPosture;
+    proofGates: string[];
+    acceptanceCriteria: string[];
+    receiptExpectation: {
+        required: boolean;
+        command: string;
+        requiredFields: string[];
     };
-    warnings: string[];
-}
-declare function getLocalSourceSnapshotPath(cwd?: string): string;
-declare function buildLocalSourceSnapshot(options?: LocalSourceSnapshotOptions): LocalSourceSnapshot;
-declare function writeLocalSourceSnapshot(snapshot: LocalSourceSnapshot): string;
-declare function readLocalSourceSnapshot(cwd?: string): LocalSourceSnapshot | null;
-declare function compareLocalSourceSnapshots(previous: LocalSourceSnapshot | null, current: LocalSourceSnapshot): LocalSourceComparison;
-declare function buildLocalSourceStatus(options?: LocalSourceSnapshotOptions): LocalSourceStatusResult;
-declare function buildLocalSourceSyncResult(options?: LocalSourceSyncOptions): Promise<LocalSourceSyncResult>;
-
-interface LocalWorkerDeclaration {
-    id: string;
-    workerRole: string;
-    endpointType: "local";
-    provider: string;
-    baseUrl: string;
-    command?: string;
-    model?: string;
-    preferModel?: string;
-    capabilities: string[];
-    reasoning: "low" | "medium" | "high";
-    writeScope: string[];
-    createdAt: string;
-    updatedAt: string;
+    prompt: string;
+    caveats: string[];
 }
-interface LocalWorkersConfig {
-    schemaVersion: "snipara.local_workers.v1";
-    updatedAt: string;
-    defaultWorkerId: string;
-    workers: LocalWorkerDeclaration[];
+interface TeamSyncCompletionEvidenceOptions {
+    summary?: string;
+    workflowGoal?: string;
+    files?: string[];
+    reason?: string;
+    now?: Date;
+    dryRun?: boolean;
 }
-interface LocalWorkerRoutingDefaults {
-    worker: LocalWorkerDeclaration;
-    routeLocalWorkers: true;
-    routingWorkerRole: string;
-    routingLocalBaseUrl: string;
-    routingLocalModel?: string;
-    routingLocalPreferModel?: string;
-    routingLocalProvider: string;
-    routingPreferredEndpoints: string[];
-    routingAllowedEndpoints: string[];
-    plannerRetainsReasoning: true;
+interface AgenticHandoffArtifact {
+    version: "snipara.agentic_handoff.v1";
+    generatedAt: string;
+    command: "snipara-companion handoff";
+    record: TeamSyncHandoffRecord;
+    statePath: string;
+    hosted: {
+        status: HostedAttempt<TeamSyncHandoffResponse>["status"];
+        handoffId?: string;
+        error?: string;
+    };
+    sections: {
+        whatChanged: string[];
+        verified: string[];
+        risky: string[];
+        remains: string[];
+        whereToResume: string[];
+    };
+    suggestedCommands: string[];
+    adapter?: AgenticHandoffAdapterPack;
 }
-interface LocalWorkerAddOptions {
-    id?: string;
-    role?: string;
-    provider?: string;
-    baseUrl?: string;
-    model?: string;
-    preferModel?: string;
-    capabilities?: string[];
-    writeScope?: string[];
-    contextWindow?: number;
-    reasoning?: "low" | "medium" | "high";
-    default?: boolean;
-    json?: boolean;
-    transport?: "openai_http" | "cli";
-    command?: string;
+declare function buildTeamSyncStartWorkRecord(input: TeamSyncRecordInput): TeamSyncWorkRecord;
+declare function buildTeamSyncHandoffRecord(input: TeamSyncRecordInput): TeamSyncHandoffRecord;
+declare function createEmptyTeamSyncState(now?: Date): TeamSyncState;
+declare function buildTeamSyncSummary(state: TeamSyncState, since?: Date, now?: Date): TeamSyncSummary;
+declare function archiveInactiveTeamSyncWork(state: TeamSyncState, options?: {
+    now?: Date;
+    thresholdMs?: number;
+    dryRun?: boolean;
+}): TeamSyncSweepResult["archivedWork"];
+declare function completeTeamSyncWorkFromEvidence(state: TeamSyncState, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
+declare function completeTeamSyncStateFromEvidence(rootDir?: string, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
+declare function autoArchiveTeamSyncState(rootDir?: string, now?: Date): TeamSyncSweepResult["archivedWork"];
+declare function loadTeamSyncState(rootDir?: string): TeamSyncState;
+declare function saveTeamSyncState(state: TeamSyncState, rootDir?: string): void;
+declare function getTeamSyncStatePath(rootDir?: string): string;
+declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
+declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
+
+type SyncDocumentKind = "DOC" | "BINARY";
+type WorkflowMode = "lite" | "standard" | "auto" | "full" | "orchestrate";
+type OnboardFolderMode = "auto" | "business_context" | "code_project" | "mixed";
+type DetectedOnboardFolderMode = "business_context" | "code_project" | "mixed" | "unknown";
+type ManagedWorkflowStatus = "active" | "completed" | "blocked";
+type ManagedWorkflowPhaseStatus = "pending" | "in_progress" | "completed" | "blocked" | "skipped";
+type ReindexKind = "doc" | "code";
+type ReindexMode = "incremental" | "full";
+type ManagedWorkflowPlanSource = "file" | "inline";
+type TaskCommitOutcome = "completed" | "partial" | "blocked" | "abandoned";
+type ManagedWorkflowSchemaVersion = "snipara.workflow.v1" | "snipara.workflow.v2";
+declare const WORKFLOW_STATE_RELATIVE_PATH: string;
+declare const WORKFLOW_PLANS_RELATIVE_DIR: string;
+declare const PRODUCER_LOOP_ARTIFACT_VERSION: "snipara.producer_loop_artifact.v0";
+declare const PRODUCER_LOOP_REPORT_VERSION: "snipara.producer_loop_report.v0";
+declare const PRODUCER_LOOP_RELATIVE_DIR: string;
+type ProducerLoopProducerKind = "workflow_phase_commit" | "workflow_final_commit" | "pr_answer_pack_decision_capture";
+type ProducerLoopSampleReviewStatus = "sample_unreviewed" | "sample_reviewed" | "sample_rejected";
+interface ProducerLoopArtifactWriteResult {
+    status: "written" | "error";
+    schemaVersion: typeof PRODUCER_LOOP_ARTIFACT_VERSION;
+    artifactId?: string;
+    path?: string;
+    relativePath?: string;
+    artifactHash?: string;
+    ledgerHash?: string;
+    error?: string;
+    caveats: string[];
 }
-interface LocalWorkerStatusOptions {
-    json?: boolean;
+interface ProducerLoopArtifactReportSummary {
+    artifactId: string;
+    generatedAt: string;
+    producerKind: ProducerLoopProducerKind;
+    workflowId?: string;
+    phaseId?: string;
+    phaseTitle?: string;
+    outcome?: TaskCommitOutcome;
+    summary?: string;
+    path: string;
+    relativePath: string;
+    artifactHash: string;
+    ledgerHash?: string;
+    reasonCodes: string[];
+    files: string[];
+    calibrationStatus?: string;
+    reviewStatus: ProducerLoopSampleReviewStatus;
+    reviewOutcome?: string;
+    reviewedAt?: string;
+    reviewer?: string;
 }
-interface LocalWorkerListOptions {
-    json?: boolean;
+interface ProducerLoopReport {
+    version: typeof PRODUCER_LOOP_REPORT_VERSION;
+    generatedAt: string;
+    source: {
+        directory: string;
+        localOnly: true;
+    };
+    adoption: {
+        status: "missing" | "active";
+        artifactCount: number;
+        producerKinds: ProducerLoopProducerKind[];
+        workflowIds: string[];
+    };
+    artifacts: ProducerLoopArtifactReportSummary[];
+    latestArtifact?: ProducerLoopArtifactReportSummary;
+    invalidArtifacts: Array<{
+        path: string;
+        relativePath: string;
+        error: string;
+    }>;
+    reasonCodes: {
+        counts: Record<string, number>;
+    };
+    calibration: {
+        status: "no_samples" | "insufficient_samples" | "reviewable_sample_set";
+        sampleSize: number;
+        reviewedSampleSize: number;
+        rejectedSampleSize: number;
+        unreviewedSampleSize: number;
+        minReviewSampleSize: number;
+        reviewOutcomes: Record<string, number>;
+        hardGateReady: false;
+        notes: string[];
+    };
+    recommendedActions: string[];
+    caveats: string[];
 }
-interface LocalWorkerRemoveOptions {
-    id: string;
-    json?: boolean;
+type WorkflowPlanPreset = "memory-backend-unification" | "project-intelligence-continuity-layer";
+interface WorkflowPlanScaffoldDocument {
+    preset: WorkflowPlanPreset;
+    mode: "full";
+    goal: string;
+    steps: Array<{
+        id: string;
+        title: string;
+        query: string;
+        acceptance?: string;
+        files?: string[];
+        gates?: string[];
+        needs_runtime?: boolean;
+    }>;
 }
-interface LocalWorkerProbeOptions {
-    baseUrl?: string;
-    provider?: string;
-    model?: string;
-    preferModel?: string;
-    role?: string;
-    workerId?: string;
-    capabilities?: string[];
-    writeScope?: string[];
-    reasoning?: "low" | "medium" | "high";
-    contextWindow?: number;
-    json?: boolean;
+interface ManagedWorkflowRuntimeCheckpoint {
+    summary: string;
+    capturedAt: string;
+    automationSessionId?: string;
+    hostedEventId?: string;
+    hostedRecordedAt?: string;
+    environment?: string;
+    profile?: string;
+    bootstrapQuery?: string;
+    files?: string[];
+    commands?: string[];
+    artifacts?: string[];
+    contextPackReceipts?: LocalContextPackReceiptPayload[];
+    rehydratableState?: Record<string, unknown>;
 }
-declare function workersLocalAddCommand(options: LocalWorkerAddOptions): void;
-declare function workersLocalStatusCommand(options?: LocalWorkerStatusOptions): void;
-declare function workersLocalListCommand(options?: LocalWorkerListOptions): void;
-declare function workersLocalRemoveCommand(options: LocalWorkerRemoveOptions): void;
-declare function workersLocalProbePrintCommand(options: LocalWorkerProbeOptions): void;
-declare function addLocalWorker(options: LocalWorkerAddOptions): {
-    worker: LocalWorkerDeclaration;
-    config: LocalWorkersConfig;
-    workerConfigPath: string;
-    policyPath: string;
-};
-declare function resolveLocalWorkerRoutingDefaults(options?: {
-    workerId?: string;
-    workerRole?: string;
-}): LocalWorkerRoutingDefaults | null;
-declare function readLocalWorkersConfig(): LocalWorkersConfig | null;
-
-interface ControlledWorkerExecuteOptions {
-    task: string;
-    workerId?: string;
-    workerRole?: string;
-    endpointType?: "local" | "cloud" | "self_hosted" | "unknown";
-    mode?: ControlledWorkerExecutionMode;
-    command?: string;
-    execute?: boolean;
-    approvalReceipt?: string;
-    outcomeReceipt?: string;
-    writeScope?: string[];
-    acceptance?: string[];
-    proof?: string[];
-    output?: string;
-    projectId?: string;
-    unifiedOutput?: string;
-    dir?: string;
-    json?: boolean;
+interface ManagedWorkflowSandboxRuntimeBinding {
+    phaseId: string;
+    sessionId: string;
+    automationSessionId?: string;
+    boundAt: string;
+    bootstrapQuery: string;
+    environment?: string;
+    profile?: string;
+    artifacts?: string[];
+    lastCheckpoint?: ManagedWorkflowRuntimeCheckpoint;
 }
-interface ControlledWorkerExecuteResult {
-    executed: boolean;
-    blocked: boolean;
-    receiptPath: string;
-    unifiedReceiptPath: string | null;
-    receipt: ControlledWorkerExecutionReceipt;
-    unifiedReceipt: UnifiedReceiptEnvelope<ControlledWorkerExecutionReceipt> | null;
+interface ManagedWorkflowRuntimeState {
+    sandbox?: {
+        provider: "snipara-sandbox";
+        bindings: ManagedWorkflowSandboxRuntimeBinding[];
+    };
 }
-declare function controlledWorkerExecuteCommand(options: ControlledWorkerExecuteOptions): ControlledWorkerExecuteResult;
-
-declare const MANIFEST_VERSION = "snipara.references.v1";
-type ReferenceStatus = "allowed" | "pending" | "denied" | "unsupported";
-interface ReferenceOccurrence {
-    file: string;
-    line: number;
-    label?: string;
+type ManagedWorkflowCoordinationMode = "standard" | "full" | "orchestrate";
+interface ManagedWorkflowCoordinationState {
+    mode: ManagedWorkflowCoordinationMode;
+    autoPublish: boolean;
+    startedAt?: string;
+    lastUpdatedAt?: string;
+    workSessionId?: string;
+    startReceipt?: WorkflowCollaborationReceipt;
+    teamSyncReceipt?: Record<string, unknown>;
+    releaseReceipt?: WorkflowCollaborationReceipt;
 }
-interface ReferenceManifestItem {
+interface ManagedWorkflowPhase {
     id: string;
-    url: string;
-    normalizedUrl: string;
-    domain: string;
-    status: ReferenceStatus;
-    reason: string;
-    discoveredAt: string;
-    occurrences: ReferenceOccurrence[];
-    latestSnapshotPath?: string;
-    latestFetchStatus?: number;
-    latestFetchAt?: string;
-    latestContentHash?: string;
-    latestError?: string;
+    title: string;
+    query: string;
+    status: ManagedWorkflowPhaseStatus;
+    acceptance?: string;
+    files?: string[];
+    gates?: string[];
+    needsRuntime?: boolean;
+    startedAt?: string;
+    completedAt?: string;
+    summary?: string;
+    outcome?: TaskCommitOutcome;
 }
-interface ReferenceManifest {
-    version: typeof MANIFEST_VERSION;
-    generatedAt: string;
-    root: string;
-    allowDomains: string[];
-    denyDomains: string[];
-    items: ReferenceManifestItem[];
+interface ManagedWorkflowState {
+    schemaVersion: ManagedWorkflowSchemaVersion;
+    workflowId: string;
+    goal: string;
+    status: ManagedWorkflowStatus;
+    currentPhaseId?: string;
+    planSource: ManagedWorkflowPlanSource;
+    planFile?: string;
+    createdAt: string;
+    updatedAt: string;
+    phases: ManagedWorkflowPhase[];
+    runtime?: ManagedWorkflowRuntimeState;
+    coordination?: ManagedWorkflowCoordinationState;
+    lastCommit?: {
+        category: string;
+        outcome: TaskCommitOutcome;
+        summary: string;
+        committedAt: string;
+    };
 }
-interface ScanReferencesOptions {
-    root?: string;
-    output?: string;
-    allowDomain?: string[];
-    denyDomain?: string[];
-    extensions?: string[];
-    maxFiles?: number;
-    json?: boolean;
+interface AgenticWorkStatus {
+    version: "snipara.agentic_status.v1";
+    generatedAt: string;
+    branch?: string;
+    git: {
+        head?: string;
+        dirtyFileCount: number;
+        statusLines: string[];
+        error?: string;
+    };
+    workflow: {
+        id: string;
+        goal: string;
+        status: ManagedWorkflowStatus;
+        currentPhase?: {
+            id: string;
+            title: string;
+            status: ManagedWorkflowPhaseStatus;
+        };
+        lastPhaseCommit?: {
+            phaseId: string;
+            title: string;
+            summary?: string;
+            outcome?: TaskCommitOutcome;
+            completedAt?: string;
+        };
+        resumeCommand: string;
+    } | null;
+    teamSync: {
+        activeWorkCount: number;
+        staleWorkCount: number;
+        staleWorkExplanation: TeamSyncStaleWorkExplanation;
+        archivedWorkCount: number;
+        handoffCount: number;
+        latestHandoff?: {
+            summary: string;
+            next?: string;
+            attention?: string;
+            createdAt: string;
+        };
+    };
+    risks: string[];
+    openDecisions: {
+        count?: number;
+        note: string;
+    };
+    operationalLoop: {
+        status: "clear" | "attention" | "blocked";
+        decisionRequestCount: number;
+        receiptGapCount: number;
+        nextActions: string[];
+        receiptActions: string[];
+        caveats: string[];
+    };
+    suggestedNextAction: string;
 }
-interface IngestReferencesOptions {
-    manifest?: string;
-    outputDir?: string;
-    allowDomain?: string[];
-    ids?: string[];
-    max?: number;
-    timeoutMs?: number;
-    maxBytes?: number;
-    destinationPrefix?: string;
-    upload?: boolean;
-    reindex?: boolean;
-    dryRun?: boolean;
-    json?: boolean;
+interface AgenticTimelineEvent {
+    time: string;
+    kind: string;
+    title: string;
+    detail?: string;
+    source: ActivityEventSource;
+    files?: string[];
 }
-interface ScanSummary {
-    manifest: ReferenceManifest;
-    outputPath: string;
-    scannedFiles: number;
-    foundUrls: number;
-    allowed: number;
-    pending: number;
-    denied: number;
-    unsupported: number;
+interface AgenticTimeline {
+    version: "snipara.agentic_timeline.v1";
+    generatedAt: string;
+    events: AgenticTimelineEvent[];
+    limit: number;
 }
-interface IngestSummary {
-    manifestPath: string;
-    selected: number;
-    fetched: number;
-    uploaded: number;
-    failed: number;
-    dryRun: boolean;
-    snapshots: Array<{
-        id: string;
-        url: string;
-        snapshotPath?: string;
-        destinationPath?: string;
-        status?: number;
-        uploaded?: boolean;
-        error?: string;
-    }>;
+interface WorkflowImpactGateCommit {
+    sha: string;
+    shortSha: string;
+    subject: string;
+    author?: string;
+    authoredAt?: string;
 }
-declare function scanReferences(options?: ScanReferencesOptions): ScanSummary;
-declare function ingestReferences(options?: IngestReferencesOptions): Promise<IngestSummary>;
-declare function referencesScanCommand(options: ScanReferencesOptions): Promise<void>;
-declare function referencesIngestCommand(options: IngestReferencesOptions): Promise<void>;
-
-declare const POLICY_LEDGER_SYNC_REPORT_VERSION: "snipara.workflow_policy_ledger_sync.v0";
-interface PolicyLedgerSyncSummary {
-    total: number;
-    pendingRequests: number;
-    resolvedDecisions: number;
-    applyReceipts: number;
-    policyDrafts: number;
+interface WorkflowImpactGatePhase {
+    id: string;
+    title: string;
+    summary?: string;
+    outcome?: TaskCommitOutcome;
+    completedAt?: string;
+    files: string[];
+    filesInUnpushedDiff: string[];
 }
-interface PolicyLedgerSyncReport {
-    version: typeof POLICY_LEDGER_SYNC_REPORT_VERSION;
+interface WorkflowImpactGateResult {
+    version: "snipara.workflow_impact_gate.v1";
     generatedAt: string;
-    dryRun: boolean;
-    summary: PolicyLedgerSyncSummary;
-    artifacts: ProjectPolicyLedgerSyncArtifactInput[];
-    hosted?: Record<string, unknown>;
+    gate: {
+        status: "pass" | "attention";
+        reasonCodes: string[];
+    };
+    repo: {
+        root: string;
+        branch?: string;
+        upstream: string;
+        baseSha?: string;
+        headSha?: string;
+    };
+    unpushed: {
+        commitCount: number;
+        commits: WorkflowImpactGateCommit[];
+        changedFiles: string[];
+        codeChangedFiles: string[];
+        nonCodeChangedFiles: string[];
+    };
+    dirtyWorkingTree: {
+        fileCount: number;
+        statusLines: string[];
+        files: string[];
+        includedInLocalImpact: false;
+    };
+    workflow: {
+        id?: string;
+        goal?: string;
+        status?: ManagedWorkflowStatus;
+        completedPhases: WorkflowImpactGatePhase[];
+        changedFilesWithoutPhase: string[];
+        phaseFilesOutsideUnpushedDiff: string[];
+    };
+    localImpact: Record<string, unknown> | null;
+    recommendedActions: string[];
     caveats: string[];
+    hostedFollowUpCommand?: string;
 }
-declare function buildPolicyLedgerSyncReport(options?: {
-    cwd?: string;
-    dryRun?: boolean;
-}): PolicyLedgerSyncReport;
-declare function workflowSyncPolicyLedgerCommand(options: {
-    dryRun?: boolean;
-    json?: boolean;
-}): Promise<void>;
-declare function collectPolicyLedgerSyncArtifacts(cwd?: string): ProjectPolicyLedgerSyncArtifactInput[];
-
-type CacheStrategy = "exact" | "nearby" | "warm";
-interface QueryCacheScope {
-    cwd?: string;
-    projectId?: string;
-    sessionId?: string;
-}
-interface QueryCacheLookup {
-    query: string;
-    maxTokens: number;
-}
-interface QueryCacheHit {
-    strategy: CacheStrategy;
-    result: ContextQueryResult;
-    sourceQuery: string;
-    similarity?: number;
+interface WorkflowPlanScaffoldResult {
+    preset: WorkflowPlanPreset;
+    goal: string;
+    outputPath: string;
+    relativeOutputPath: string;
+    plan: WorkflowPlanScaffoldDocument;
 }
-interface WarmSnapshotResult {
-    storedEntries: number;
-    fileName?: string;
+interface SyncDocumentsManifestOptions {
+    metadataDefaults: Record<string, unknown>;
+    deleteMissing?: boolean;
+    dryRun?: boolean;
+    reindex?: boolean;
+    reindexKind?: ReindexKind;
+    reindexMode?: ReindexMode;
 }
-declare class LocalQueryCache {
-    private readonly scope;
-    private readonly ttlMs;
-    private readonly warmTtlMs;
-    private readonly maxEntries;
-    private readonly maxBytes;
-    constructor(scope?: QueryCacheScope);
-    lookup(options: QueryCacheLookup): QueryCacheHit | null;
-    save(options: QueryCacheLookup, result: ContextQueryResult): void;
-    storeWarmSnapshot(result: SessionMemoriesResult): WarmSnapshotResult;
-    clear(): number;
-    private loadIndex;
-    private persistIndex;
-    private pruneIndex;
-    private readEntry;
-    private findNearbyEntry;
-    private lookupWarmSnapshot;
+interface CollectedSyncDocuments {
+    documents: SyncDocumentInput[];
+    manifestOptions: SyncDocumentsManifestOptions;
 }
-declare function createLocalQueryCache(scope?: QueryCacheScope): LocalQueryCache;
-
-declare const AUTOMATION_MANIFEST_RELATIVE_PATH = ".snipara/automations/manifest.json";
-type AutomationFileState = "create" | "update" | "unchanged" | "conflict";
-interface AutomationManifestFile {
+interface SyncDocumentsDryRunItem {
     path: string;
-    sha256: string;
+    status: "valid" | "invalid_metadata";
+    recommended_action: "none" | "reupload" | "review_source_metadata";
+    reasons: string[];
+    kind?: SyncDocumentKind;
+    format?: string;
+    size_bytes: number;
+    content_hash: string;
+    assetClass?: string;
+    usageMode?: string;
+    sourceKind?: string;
 }
-interface AutomationManifest {
-    version: number;
-    client: string;
-    projectId?: string;
-    apiUrl?: string;
-    installedAt: string;
-    files: AutomationManifestFile[];
+interface SyncDocumentsDryRunSummary {
+    dry_run: true;
+    remote_diff_available: false;
+    total: number;
+    would_sync: number;
+    invalid_metadata: number;
+    stale: number;
+    needs_reupload: number;
+    needs_metadata_review: number;
+    delete_missing: boolean;
+    reindex_requested: boolean;
+    reindex_kind: ReindexKind;
+    reindex_mode: ReindexMode;
+    created: null;
+    updated: null;
+    unchanged: null;
+    missing_from_manifest: null;
+    note: string;
+    documents: SyncDocumentsDryRunItem[];
 }
-interface AutomationFilePlan {
+interface OnboardFolderScannedFile {
     path: string;
-    targetPath: string;
-    state: AutomationFileState;
-    reason: string;
-    currentSha256?: string;
-    previousSha256?: string;
-    nextSha256: string;
-    writeContent?: string;
-}
-interface AutomationInstallResult {
-    manifest: AutomationManifest;
-    plan: AutomationFilePlan[];
-    written: number;
-    unchanged: number;
-    dryRun: boolean;
+    size_bytes: number;
+    supported: boolean;
+    kind?: SyncDocumentKind;
+    format?: string;
 }
-interface AutomationStatusResult {
-    manifest: AutomationManifest | null;
-    files: Array<{
-        path: string;
-        targetPath: string;
-        state: "up-to-date" | "modified" | "missing";
-        expectedSha256: string;
-        currentSha256?: string;
-    }>;
+interface OnboardFolderClassification {
+    mode: DetectedOnboardFolderMode;
+    detected_mode: DetectedOnboardFolderMode;
+    confidence: number;
+    code_score: number;
+    business_score: number;
+    signals: {
+        code: string[];
+        business: string[];
+    };
 }
-declare class AutomationInstallConflictError extends Error {
-    conflicts: AutomationFilePlan[];
-    constructor(conflicts: AutomationFilePlan[]);
+interface OnboardFolderManifest {
+    schemaVersion: "snipara.onboard-folder.v1";
+    source: {
+        root: string;
+        sourceKind: string;
+        sourceProvider: string;
+        sourceUri?: string;
+        snapshotAt: string;
+        recursive: boolean;
+    };
+    classification: OnboardFolderClassification;
+    summary: {
+        total_files: number;
+        supported_documents: number;
+        ignored_files: number;
+        unsupported_business_files: number;
+    };
+    warnings: string[];
+    ignored: OnboardFolderScannedFile[];
+    sync: {
+        dryRun: boolean;
+        reindex: boolean;
+        reindexKind: ReindexKind;
+        reindexMode: ReindexMode;
+        deleteMissing: boolean;
+        metadata: Record<string, unknown>;
+        documents: SyncDocumentInput[];
+    };
+    dryRun: SyncDocumentsDryRunSummary;
 }
-declare class AutomationUnsupportedHookBundleError extends Error {
-    client: string;
-    files: string[];
-    constructor(client: string, files: string[]);
+declare function getPlanStepDisplayTitle(step: unknown, index?: number): string;
+interface PlanQualityReport {
+    valid: boolean;
+    issues: string[];
+    warnings: string[];
+    stepCount: number;
+    actions: string[];
+    planId?: string;
 }
-declare function getAutomationManifestPath(projectDir?: string): string;
-declare function loadAutomationManifest(projectDir?: string): AutomationManifest | null;
-declare function buildAutomationInstallPlan(args: {
-    projectDir: string;
-    bundle: AutomationConfigBundle;
-    manifest?: AutomationManifest | null;
-    force?: boolean;
-}): AutomationFilePlan[];
-declare function installAutomationBundle(args: {
-    client: string;
-    projectDir?: string;
-    bundle?: AutomationConfigBundle;
-    force?: boolean;
-    dryRun?: boolean;
-}): Promise<AutomationInstallResult>;
-declare function getAutomationStatus(projectDir?: string): AutomationStatusResult;
-
-declare const COLLABORATION_STATE_RELATIVE_PATH: string;
-type CollaborationGuardActionKind = "safe_to_ack" | "needs_handoff" | "needs_test" | "needs_package_review" | "blocking_conflict" | "guard_unavailable";
-interface CollaborationGuardActionCard {
-    kind: CollaborationGuardActionKind;
-    title: string;
-    reason: string;
-    severity: "info" | "watch" | "warning" | "critical";
-    safeToAck: boolean;
-    command?: string;
-    conflictCode?: string;
-    resource?: string;
+interface WorkflowTokenBudgetReport {
+    requested_max_tokens: number;
+    allocations: {
+        critical_memory_tokens: number;
+        session_context_tokens: number;
+        context_query_tokens: number;
+        shared_context_tokens: number;
+        plan_tokens: number;
+    };
+    estimated_max_tokens: number;
+    include_session_context: boolean;
+    explicit: {
+        max_critical_tokens: boolean;
+        max_context_tokens: boolean;
+    };
+    warnings: string[];
 }
-interface CollaborationCommandOptions {
-    summary?: string;
+interface SessionBootstrapQualityReport {
+    warnings: string[];
+    counts: {
+        critical_memories: number;
+        session_context_memories: number;
+        low_confidence_memories: number;
+        stale_memories: number;
+        test_memories: number;
+    };
+    total_tokens?: number;
+    oldest_memory_age_days?: number;
+}
+interface SessionBootstrapBrief {
+    entries: SessionMemoryEntry[];
+    availableCount: number;
+    hiddenCount: number;
+    estimatedTokens: number;
+    budgetTokens: number;
+}
+interface GeneratedWorkflowPlanDocument {
+    mode: "full";
+    goal: string;
+    source: "snipara_plan";
+    plan_id?: string;
+    generatedAt: string;
+    steps: Array<{
+        id: string;
+        title: string;
+        query: string;
+        acceptance?: string;
+        files?: string[];
+        needs_runtime?: boolean;
+    }>;
+}
+declare function resolveFullWorkflowTokenBudget(options: {
+    maxTokens?: number;
+    includeSessionContext?: boolean;
+    includeSharedContext?: boolean;
+    maxCriticalTokens?: number;
+    maxContextTokens?: number;
+}): WorkflowTokenBudgetReport;
+declare function validatePlanResult(plan: unknown, options?: {
+    query?: string;
+    cwd?: string;
+}): PlanQualityReport;
+declare function buildSessionBootstrapBrief(result: SessionMemoriesResult, options: {
+    includeSessionContext: boolean;
+    maxTokens?: number;
+    maxEntries?: number;
+    now?: Date;
+}): SessionBootstrapBrief;
+declare function buildSessionBootstrapQuality(result: SessionMemoriesResult, options?: {
+    expectedMaxTokens?: number;
+    now?: Date;
+}): SessionBootstrapQualityReport;
+declare function buildGeneratedWorkflowPlanDocument(plan: Record<string, unknown>, fallbackGoal: string): GeneratedWorkflowPlanDocument;
+declare function normalizeWorkflowPlanInput(input: unknown, fallbackGoal: string): ManagedWorkflowPhase[];
+declare function buildWorkflowPlanScaffold(preset: WorkflowPlanPreset, options?: {
+    goal?: string;
+    outputPath?: string;
+    cwd?: string;
+}): WorkflowPlanScaffoldResult;
+declare function writeProducerLoopArtifact(options: {
+    kind: ProducerLoopProducerKind;
+    command: "workflow phase-commit" | "workflow final-commit";
+    state?: ManagedWorkflowState;
+    phase?: ManagedWorkflowPhase;
+    category: string;
+    outcome: TaskCommitOutcome;
+    summary: string;
     files?: string[];
-    resources?: string[];
-    actor?: string;
-    actorId?: string;
-    actorType?: string;
-    sessionId?: string;
-    workSessionId?: string;
-    swarmId?: string;
-    client?: string;
-    repository?: string;
-    branch?: string;
-    worktree?: string;
-    action?: string;
-    profile?: string;
-    mode?: string;
-    reason?: string;
-    ttlSeconds?: string;
-    heartbeatTtlSeconds?: string;
-    intervalSeconds?: string;
-    maxFiles?: string;
-    leaseId?: string;
-    all?: boolean;
-    once?: boolean;
-    autoClaim?: boolean;
-    releaseStale?: boolean;
-    persist?: boolean;
-    enforce?: boolean;
-    ackReviewOnly?: boolean;
+    journalAttempted: boolean;
+    teamSyncCompletionAttempted: boolean;
+}): ProducerLoopArtifactWriteResult;
+declare function buildProducerLoopReport(options?: {
+    cwd?: string;
+    minReviewSampleSize?: number;
+}): ProducerLoopReport;
+declare function buildWorkflowPhaseCommitSummary(args: {
+    workflowId: string;
+    phase: Pick<ManagedWorkflowPhase, "id" | "title">;
+    summary: string;
+}): string;
+declare function resolveAutoWorkflowMode(query: string): Exclude<WorkflowMode, "auto">;
+/**
+ * Compute the impact gate for committed-but-unpushed workflow phases.
+ *
+ * Compares `upstream..HEAD`, separates unpushed code changes from non-code and
+ * dirty working-tree files, runs local code-overlay impact on the committed
+ * code files, and maps the result back to completed workflow phases. Surfaces
+ * reason codes such as `dirty_working_tree_not_included` and phase files that
+ * fall outside the unpushed diff, so a phase is not treated as verified on
+ * stale or partial evidence.
+ *
+ * @returns A `WorkflowImpactGateResult` with changed files, local impact,
+ *   matched phases, and reason codes.
+ */
+declare function buildWorkflowImpactGate(options?: {
+    cwd?: string;
+    base?: string;
+    maxFiles?: number;
+}): WorkflowImpactGateResult;
+declare function collectSyncDocuments(options: {
+    file?: string;
     dir?: string;
-    json?: boolean;
-    verbose?: boolean;
+    prefix?: string;
+    recursive?: boolean;
+}): SyncDocumentInput[];
+declare function collectSyncDocumentsInput(options: {
+    file?: string;
+    dir?: string;
+    prefix?: string;
+    recursive?: boolean;
+}): CollectedSyncDocuments;
+interface OnboardFolderOptions {
+    dir: string;
+    recursive?: boolean;
+    mode?: OnboardFolderMode;
+    prefix?: string;
+    usageMode?: string;
+    sourceKind?: string;
+    sourceProvider?: string;
+    sourceUri?: string;
+    clientId?: string;
+    snapshotAt?: string;
+    deleteMissing?: boolean;
+    reindex?: boolean;
+    reindexKind?: ReindexKind;
+    reindexMode?: ReindexMode;
 }
-interface CollaborationHooksInstallOptions {
+declare function buildOnboardFolderManifest(options: OnboardFolderOptions): OnboardFolderManifest;
+declare function buildSyncDocumentsDryRun(documents: SyncDocumentInput[], options?: {
+    deleteMissing?: boolean;
+    reindex?: boolean;
+    reindexKind?: ReindexKind;
+    reindexMode?: ReindexMode;
+    now?: Date;
+}): SyncDocumentsDryRunSummary;
+declare function buildAgenticWorkStatus(cwd?: string): AgenticWorkStatus;
+declare function buildAgenticTimeline(options?: {
+    limit?: number;
+    cwd?: string;
+}): AgenticTimeline;
+
+type LocalSourceProvider = "local_folder";
+type LocalSourceFileKind = "DOC" | "BINARY" | "CODE" | "CONFIG" | "OTHER";
+type LocalSourceSkippedReason = "ignored" | "too_large" | "read_error";
+type LocalSourceReindexKind = "doc" | "code";
+type LocalSourceReindexMode = "incremental" | "full";
+interface LocalSourceFile {
+    path: string;
+    kind: LocalSourceFileKind;
+    format: string | null;
+    sizeBytes: number;
+    modifiedAt: string;
+    sha256: string;
+}
+interface LocalSourceSkippedFile {
+    path: string;
+    reason: LocalSourceSkippedReason;
+    sizeBytes?: number;
+}
+interface LocalSourceSummary {
+    totalFiles: number;
+    totalBytes: number;
+    byKind: Record<LocalSourceFileKind, number>;
+    skipped: number;
+}
+interface LocalSourceSnapshot {
+    version: "snipara.local_source_snapshot.v1";
+    generatedAt: string;
+    root: string;
+    provider: LocalSourceProvider;
+    revision: string;
+    recursive: boolean;
+    maxFiles: number;
+    maxFileBytes: number;
+    summary: LocalSourceSummary;
+    files: LocalSourceFile[];
+    skipped: {
+        total: number;
+        byReason: Record<LocalSourceSkippedReason, number>;
+        samples: LocalSourceSkippedFile[];
+    };
+    warnings: string[];
+}
+interface LocalSourceSnapshotOptions {
     dir?: string;
-    dryRun?: boolean;
+    recursive?: boolean;
+    maxFiles?: number;
+    maxFileBytes?: number;
+}
+interface LocalSourceComparison {
+    added: string[];
+    modified: string[];
+    deleted: string[];
+    unchanged: number;
+}
+interface LocalSourceStatusResult {
+    root: string;
+    snapshotPath: string;
+    previous: LocalSourceSnapshot | null;
+    current: LocalSourceSnapshot;
+    comparison: LocalSourceComparison;
+}
+interface LocalSourceSyncOptions extends LocalSourceSnapshotOptions {
+    prefix?: string;
+    mode?: OnboardFolderMode;
+    deleteMissing?: boolean;
+    apply?: boolean;
+    reindex?: boolean;
+    reindexKind?: LocalSourceReindexKind;
+    reindexMode?: LocalSourceReindexMode;
+    includeGraph?: boolean;
     json?: boolean;
 }
-interface CollaborationLocalLeaseRecord {
+interface LocalSourceSyncResult {
+    root: string;
+    snapshotPath: string;
+    snapshot: LocalSourceSnapshot;
+    comparison: LocalSourceComparison;
+    documents: {
+        onboarding: Pick<OnboardFolderManifest, "source" | "classification" | "summary" | "warnings">;
+        dryRun: OnboardFolderManifest["dryRun"];
+    };
+    codeOverlay: {
+        cachePath: string;
+        summary: LocalCodeOverlaySummary;
+    };
+    apply: null | {
+        sync: Record<string, unknown>;
+        reindex?: Record<string, unknown>;
+    };
+    warnings: string[];
+}
+declare function getLocalSourceSnapshotPath(cwd?: string): string;
+declare function buildLocalSourceSnapshot(options?: LocalSourceSnapshotOptions): LocalSourceSnapshot;
+declare function writeLocalSourceSnapshot(snapshot: LocalSourceSnapshot): string;
+declare function readLocalSourceSnapshot(cwd?: string): LocalSourceSnapshot | null;
+declare function compareLocalSourceSnapshots(previous: LocalSourceSnapshot | null, current: LocalSourceSnapshot): LocalSourceComparison;
+declare function buildLocalSourceStatus(options?: LocalSourceSnapshotOptions): LocalSourceStatusResult;
+declare function buildLocalSourceSyncResult(options?: LocalSourceSyncOptions): Promise<LocalSourceSyncResult>;
+
+interface LocalWorkerDeclaration {
     id: string;
-    mode: CollaborationLeaseMode;
-    status: CollaborationLeaseStatus;
-    resources: CollaborationResource[];
-    reason?: string;
-    claimedAt?: string;
-    expiresAt?: string | null;
+    workerRole: string;
+    endpointType: "local";
+    provider: string;
+    baseUrl: string;
+    command?: string;
+    model?: string;
+    preferModel?: string;
+    capabilities: string[];
+    reasoning: "low" | "medium" | "high";
+    writeScope: string[];
+    createdAt: string;
+    updatedAt: string;
 }
-interface CollaborationLocalState {
-    schemaVersion: "snipara.collaboration.v1";
+interface LocalWorkersConfig {
+    schemaVersion: "snipara.local_workers.v1";
     updatedAt: string;
-    workSessionId?: string;
-    sessionId?: string;
-    actorId?: string;
-    actorType?: CollaborationActorType;
-    actorLabel?: string;
-    client?: string;
-    repository?: string;
-    branch?: string;
-    worktree?: string;
-    task?: string;
-    files: string[];
-    resources: CollaborationResource[];
-    leases: CollaborationLocalLeaseRecord[];
-    lastGuard?: {
-        decision: CollaborationGuardDecision;
-        severity: string;
-        checkedAt: string;
-        action: string;
-        resources: CollaborationResource[];
-        conflictCount: number;
-    };
+    defaultWorkerId: string;
+    workers: LocalWorkerDeclaration[];
 }
-interface ResolvedCollaborationContext {
-    rootDir: string;
-    config: RLMConfig;
-    actor: Required<Pick<CollaborationActorPayload, "actorId" | "actorType" | "actorLabel">> & {
-        sessionId?: string;
-    };
-    client: string;
-    branch?: string;
-    repository?: string;
-    worktree?: string;
+interface LocalWorkerRoutingDefaults {
+    worker: LocalWorkerDeclaration;
+    routeLocalWorkers: true;
+    routingWorkerRole: string;
+    routingLocalBaseUrl: string;
+    routingLocalModel?: string;
+    routingLocalPreferModel?: string;
+    routingLocalProvider: string;
+    routingPreferredEndpoints: string[];
+    routingAllowedEndpoints: string[];
+    plannerRetainsReasoning: true;
 }
-declare function createEmptyCollaborationState(now?: Date): CollaborationLocalState;
-declare function getCollaborationStatePath(rootDir?: string): string;
-declare function loadCollaborationState(rootDir?: string): CollaborationLocalState;
-declare function saveCollaborationState(state: CollaborationLocalState, rootDir?: string): void;
-declare function buildCollaborationActor(options: Pick<CollaborationCommandOptions, "actor" | "actorId" | "actorType" | "sessionId" | "client">, config: RLMConfig): ResolvedCollaborationContext["actor"];
-declare function normalizeCollaborationFiles(files: string[] | undefined): string[];
-declare function parseCollaborationResources(values: string[] | undefined): CollaborationResource[];
-declare function deriveLocalCollaborationResourcesFromFiles(files: string[] | undefined, rootDir?: string, maxFiles?: number): CollaborationResource[];
-declare function buildCollaborationHooksInstallPlan(options?: CollaborationHooksInstallOptions): Record<string, unknown>;
-declare function collaborationIdeStatusCommand(options: CollaborationCommandOptions): Promise<void>;
-declare function buildCollaborationGuardActionCards(evaluation: CollaborationGuardEvaluation | undefined, context?: {
-    profile?: string;
-    enforced?: boolean;
-    ackReviewOnly?: boolean;
-    reviewOnlyAcknowledged?: boolean;
-}): CollaborationGuardActionCard[];
-interface HostedGuardPayload {
-    files: string[];
-    resources: CollaborationResource[];
-    fileCount: number;
-    resourceCount: number;
-    filesTruncated: boolean;
-    resourcesTruncated: boolean;
+interface LocalWorkerAddOptions {
+    id?: string;
+    role?: string;
+    provider?: string;
+    baseUrl?: string;
+    model?: string;
+    preferModel?: string;
+    capabilities?: string[];
+    writeScope?: string[];
+    contextWindow?: number;
+    reasoning?: "low" | "medium" | "high";
+    default?: boolean;
+    json?: boolean;
+    transport?: "openai_http" | "cli";
+    command?: string;
+}
+interface LocalWorkerStatusOptions {
+    json?: boolean;
+}
+interface LocalWorkerListOptions {
+    json?: boolean;
+}
+interface LocalWorkerRemoveOptions {
+    id: string;
+    json?: boolean;
+}
+interface LocalWorkerProbeOptions {
+    baseUrl?: string;
+    provider?: string;
+    model?: string;
+    preferModel?: string;
+    role?: string;
+    workerId?: string;
+    capabilities?: string[];
+    writeScope?: string[];
+    reasoning?: "low" | "medium" | "high";
+    contextWindow?: number;
+    json?: boolean;
+}
+declare function workersLocalAddCommand(options: LocalWorkerAddOptions): void;
+declare function workersLocalStatusCommand(options?: LocalWorkerStatusOptions): void;
+declare function workersLocalListCommand(options?: LocalWorkerListOptions): void;
+declare function workersLocalRemoveCommand(options: LocalWorkerRemoveOptions): void;
+declare function workersLocalProbePrintCommand(options: LocalWorkerProbeOptions): void;
+declare function addLocalWorker(options: LocalWorkerAddOptions): {
+    worker: LocalWorkerDeclaration;
+    config: LocalWorkersConfig;
+    workerConfigPath: string;
+    policyPath: string;
+};
+declare function resolveLocalWorkerRoutingDefaults(options?: {
+    workerId?: string;
+    workerRole?: string;
+}): LocalWorkerRoutingDefaults | null;
+declare function readLocalWorkersConfig(): LocalWorkersConfig | null;
+
+interface ControlledWorkerExecuteOptions {
+    task: string;
+    workerId?: string;
+    workerRole?: string;
+    endpointType?: "local" | "cloud" | "self_hosted" | "unknown";
+    mode?: ControlledWorkerExecutionMode;
+    command?: string;
+    execute?: boolean;
+    approvalReceipt?: string;
+    outcomeReceipt?: string;
+    writeScope?: string[];
+    acceptance?: string[];
+    proof?: string[];
+    output?: string;
+    projectId?: string;
+    unifiedOutput?: string;
+    dir?: string;
+    json?: boolean;
 }
-declare function buildHostedGuardPayload(files: string[], resources: CollaborationResource[]): HostedGuardPayload;
-declare function compactHostedGuardResources(resources: CollaborationResource[]): CollaborationResource[];
-
-interface JournalCheckpointPayload {
-    action: string;
-    summary: string;
-    outcome?: string;
-    workflowId?: string;
-    phaseId?: string;
-    phaseTitle?: string;
-    branch?: string;
-    actor?: string;
-    next?: string;
-    attention?: string;
-    files?: string[];
-    cwd?: string;
+interface ControlledWorkerExecuteResult {
+    executed: boolean;
+    blocked: boolean;
+    receiptPath: string;
+    unifiedReceiptPath: string | null;
+    receipt: ControlledWorkerExecutionReceipt;
+    unifiedReceipt: UnifiedReceiptEnvelope<ControlledWorkerExecutionReceipt> | null;
 }
-declare function buildJournalCheckpointEntry(payload: JournalCheckpointPayload): {
-    text: string;
-    tags: string[];
-};
+declare function controlledWorkerExecuteCommand(options: ControlledWorkerExecuteOptions): ControlledWorkerExecuteResult;
 
-type RuntimeEnvironment = Record<string, string | undefined>;
-type ProviderKeySource = "environment" | "env-file";
-type OrchestratorRecommendationLevel = "suggest" | "confirm" | "auto";
-type OrchestratorRecommendationReason = "workflow_mode_orchestrate" | "production_validation_intent" | "proof_gate_intent" | "htask_or_swarm_intent" | "multi_agent_intent" | "parallel_worker_intent" | "changed_files_threshold" | "team_sync_collision" | "policy_auto_route";
-interface OrchestratorRecommendation {
-    level: OrchestratorRecommendationLevel;
-    reasons: OrchestratorRecommendationReason[];
-    score: number;
-    orchestratorRequired: boolean;
-    policySource?: string;
+declare const MANIFEST_VERSION = "snipara.references.v1";
+type ReferenceStatus = "allowed" | "pending" | "denied" | "unsupported";
+interface ReferenceOccurrence {
+    file: string;
+    line: number;
+    label?: string;
 }
-interface OrchestratorRecommendationOptions {
-    changedFilesCount?: number;
-    hasActiveCollisions?: boolean;
-    policyAutoRoute?: boolean;
-    policySource?: string;
-    adaptiveRoutingDryRun?: boolean;
+interface ReferenceManifestItem {
+    id: string;
+    url: string;
+    normalizedUrl: string;
+    domain: string;
+    status: ReferenceStatus;
+    reason: string;
+    discoveredAt: string;
+    occurrences: ReferenceOccurrence[];
+    latestSnapshotPath?: string;
+    latestFetchStatus?: number;
+    latestFetchAt?: string;
+    latestContentHash?: string;
+    latestError?: string;
 }
-interface RuntimeDetectionReport {
-    cwd: string;
-    workspaceRoot: string | null;
-    companion: {
-        configured: boolean;
-        configPath: string;
-    };
-    runtime: {
-        cliAvailable: boolean;
-        command?: string;
-        legacyCommand?: boolean;
-        version?: string;
-        cliVersion?: string;
-        installedPackageVersion?: string;
-        versionMismatch?: boolean;
-        mcpConfigured: boolean;
-        mcpConfigPaths: string[];
-    };
-    orchestrator: {
-        cliAvailable: boolean;
-        command?: string;
-        version?: string;
-        source?: "path" | "workspace_venv";
-        workspacePackageVersion?: string;
-        versionMismatch?: boolean;
-    };
-    providerKeys: {
-        openai: boolean;
-        anthropic: boolean;
-        any: boolean;
-        sources: {
-            openai?: ProviderKeySource;
-            anthropic?: ProviderKeySource;
-        };
-        envFilesLoaded: string[];
-    };
-    docker: {
-        available: boolean;
-    };
+interface ReferenceManifest {
+    version: typeof MANIFEST_VERSION;
+    generatedAt: string;
+    root: string;
+    allowDomains: string[];
+    denyDomains: string[];
+    items: ReferenceManifestItem[];
 }
-declare function detectRuntimeEnvironment(cwd?: string, env?: RuntimeEnvironment): RuntimeDetectionReport;
-declare function shouldSuggestRuntimeForWorkflow(query: string, mode: WorkflowMode): boolean;
-/**
- * Recommend whether work should be routed to snipara-orchestrator.
- *
- * Scores intent signals from the query and workflow mode (orchestrate mode,
- * production / proof / htask / multi-agent / parallel patterns) plus contextual
- * signals (changed-file count, active Team Sync collisions, policy auto-route).
- * The returned recommendation's level escalates with the accumulated score
- * (suggest → confirm → auto).
- *
- * @returns A recommendation with its reasons, or `null` when no signal fires.
- */
-declare function getOrchestratorRecommendation(query: string, mode: WorkflowMode, options?: OrchestratorRecommendationOptions): OrchestratorRecommendation | null;
-declare function formatOrchestratorRecommendationReason(reason: OrchestratorRecommendationReason): string;
-declare function shouldSuggestOrchestratorForWorkflow(query: string, mode: WorkflowMode): boolean;
+interface ScanReferencesOptions {
+    root?: string;
+    output?: string;
+    allowDomain?: string[];
+    denyDomain?: string[];
+    extensions?: string[];
+    maxFiles?: number;
+    json?: boolean;
+}
+interface IngestReferencesOptions {
+    manifest?: string;
+    outputDir?: string;
+    allowDomain?: string[];
+    ids?: string[];
+    max?: number;
+    timeoutMs?: number;
+    maxBytes?: number;
+    destinationPrefix?: string;
+    upload?: boolean;
+    reindex?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+}
+interface ScanSummary {
+    manifest: ReferenceManifest;
+    outputPath: string;
+    scannedFiles: number;
+    foundUrls: number;
+    allowed: number;
+    pending: number;
+    denied: number;
+    unsupported: number;
+}
+interface IngestSummary {
+    manifestPath: string;
+    selected: number;
+    fetched: number;
+    uploaded: number;
+    failed: number;
+    dryRun: boolean;
+    snapshots: Array<{
+        id: string;
+        url: string;
+        snapshotPath?: string;
+        destinationPath?: string;
+        status?: number;
+        uploaded?: boolean;
+        error?: string;
+    }>;
+}
+declare function scanReferences(options?: ScanReferencesOptions): ScanSummary;
+declare function ingestReferences(options?: IngestReferencesOptions): Promise<IngestSummary>;
+declare function referencesScanCommand(options: ScanReferencesOptions): Promise<void>;
+declare function referencesIngestCommand(options: IngestReferencesOptions): Promise<void>;
 
-declare const ORCHESTRATOR_HANDOFF_RELATIVE_PATH: string;
-interface OrchestratorHandoffWorkflowPhase {
-    id: string;
-    title: string;
-    query: string;
-    status: string;
-    acceptance?: string;
-    files: string[];
-    gates: string[];
-    needsRuntime: boolean;
+declare const POLICY_LEDGER_SYNC_REPORT_VERSION: "snipara.workflow_policy_ledger_sync.v0";
+interface PolicyLedgerSyncSummary {
+    total: number;
+    pendingRequests: number;
+    resolvedDecisions: number;
+    applyReceipts: number;
+    policyDrafts: number;
 }
-interface OrchestratorHandoffRuntimeSandboxPhase {
-    phaseId: string;
-    title: string;
-    bootstrapQuery: string;
-    files: string[];
-    artifacts: string[];
-    contextPacks: string[];
-    sessionId: string | null;
-    environment: string | null;
-    profile: string | null;
-    hasCheckpoint: boolean;
-    checkpointSummary: string | null;
-    checkpointCapturedAt: string | null;
+interface PolicyLedgerSyncReport {
+    version: typeof POLICY_LEDGER_SYNC_REPORT_VERSION;
+    generatedAt: string;
+    dryRun: boolean;
+    summary: PolicyLedgerSyncSummary;
+    artifacts: ProjectPolicyLedgerSyncArtifactInput[];
+    hosted?: Record<string, unknown>;
+    caveats: string[];
 }
-interface AdaptiveWorkProfile {
-    taskType: string;
-    risk: string;
-    scope: string[];
-    contextBudget: string;
-    reasoningDepth: string;
-    evidenceRequirements?: string[];
-    preferredProfileStrengths?: string[];
-    notes?: string[];
+declare function buildPolicyLedgerSyncReport(options?: {
+    cwd?: string;
+    dryRun?: boolean;
+}): PolicyLedgerSyncReport;
+declare function workflowSyncPolicyLedgerCommand(options: {
+    dryRun?: boolean;
+    json?: boolean;
+}): Promise<void>;
+declare function collectPolicyLedgerSyncArtifacts(cwd?: string): ProjectPolicyLedgerSyncArtifactInput[];
+
+type CacheStrategy = "exact" | "nearby" | "warm";
+interface QueryCacheScope {
+    cwd?: string;
+    projectId?: string;
+    sessionId?: string;
 }
-interface AdaptiveModelRequirements {
-    workerRole: string;
-    reasoning: string;
-    plannerRetainsReasoning: boolean;
-    speed: string;
-    cost: string;
-    contextBudget: string;
-    capabilities: string[];
-    forbiddenCapabilities: string[];
-    writeScope: string[];
-    structuredOutputRequired?: boolean;
-    preferredEndpointTypes?: string[];
-    allowedEndpointTypes?: string[];
-    catalogLimit?: number;
-    dailyBudgetCents?: number;
-    monthlyBudgetCents?: number;
-    fallback: "main_agent";
+interface QueryCacheLookup {
+    query: string;
+    maxTokens: number;
 }
-interface AdaptiveRoutingCostEstimate {
-    currency: "USD";
-    confidence: "low" | "medium" | "high";
+interface QueryCacheHit {
+    strategy: CacheStrategy;
+    result: ContextQueryResult;
+    sourceQuery: string;
+    similarity?: number;
 }
-interface AdaptiveRoutingCard {
-    mode: "dry_run";
-    workProfile: AdaptiveWorkProfile;
-    requirements: AdaptiveModelRequirements;
-    recommendedWorkerClass: string;
-    costEstimate: AdaptiveRoutingCostEstimate;
-    humanApprovalRequired: boolean;
-    fallback: "main_agent";
-    rejectedReasons?: Record<string, string[]>;
-    reasons: string[];
-    warnings: string[];
+interface WarmSnapshotResult {
+    storedEntries: number;
+    fileName?: string;
 }
-interface AdaptiveRoutingGatewayStatus {
-    source: "hosted_mcp" | "local_orchestrator";
-    success: boolean;
-    resolutionStatus?: string;
-    candidateCount: number;
-    fallback?: string;
-    warnings: string[];
+declare class LocalQueryCache {
+    private readonly scope;
+    private readonly ttlMs;
+    private readonly warmTtlMs;
+    private readonly maxEntries;
+    private readonly maxBytes;
+    constructor(scope?: QueryCacheScope);
+    lookup(options: QueryCacheLookup): QueryCacheHit | null;
+    save(options: QueryCacheLookup, result: ContextQueryResult): void;
+    storeWarmSnapshot(result: SessionMemoriesResult): WarmSnapshotResult;
+    clear(): number;
+    private loadIndex;
+    private persistIndex;
+    private pruneIndex;
+    private readEntry;
+    private findNearbyEntry;
+    private lookupWarmSnapshot;
 }
-interface AdaptiveRoutingRuntimeCatalog {
-    version?: string;
-    source?: string;
-    provider?: string;
-    baseUrl?: string;
-    models?: string[];
-    apiPaths?: Record<string, unknown>;
-    workerEndpoints?: Record<string, Record<string, unknown>>;
-    workerProfiles?: Record<string, Record<string, unknown>>;
-    candidates: Array<Record<string, unknown>>;
+declare function createLocalQueryCache(scope?: QueryCacheScope): LocalQueryCache;
+
+declare const AUTOMATION_MANIFEST_RELATIVE_PATH = ".snipara/automations/manifest.json";
+type AutomationFileState = "create" | "update" | "unchanged" | "conflict";
+interface AutomationManifestFile {
+    path: string;
+    sha256: string;
 }
-interface AdaptiveRoutingResolution {
-    status?: string;
-    selected?: Record<string, unknown>;
-    policyDecision?: Record<string, unknown>;
-    evaluatedCount?: number;
-    rejectedCount?: number;
-    fallback?: string;
-    reasons?: string[];
-    warnings?: string[];
-    rejectedReasons?: Record<string, string[]>;
+interface AutomationManifest {
+    version: number;
+    client: string;
+    projectId?: string;
+    apiUrl?: string;
+    installedAt: string;
+    files: AutomationManifestFile[];
 }
-interface AdaptiveWorkRoutingRecommendation {
-    workProfile: AdaptiveWorkProfile;
-    requirements: AdaptiveModelRequirements;
-    routingCard: AdaptiveRoutingCard;
-    gateway?: AdaptiveRoutingGatewayStatus;
-    runtimeCatalog?: AdaptiveRoutingRuntimeCatalog;
-    resolution?: AdaptiveRoutingResolution;
+interface AutomationFilePlan {
+    path: string;
+    targetPath: string;
+    state: AutomationFileState;
+    reason: string;
+    currentSha256?: string;
+    previousSha256?: string;
+    nextSha256: string;
+    writeContent?: string;
 }
-interface AdaptiveWorkRoutingOptions {
-    query: string;
-    mode?: string;
-    changedFiles?: string[];
-    preferredEndpointTypes?: string[];
-    allowedEndpointTypes?: string[];
-    workerRole?: string;
-    plannerRetainsReasoning?: boolean;
-    preferredProfileStrengths?: string[];
-    structuredOutputRequired?: boolean;
-    catalogLimit?: number;
-    dailyBudgetCents?: number;
-    monthlyBudgetCents?: number;
+interface AutomationInstallResult {
+    manifest: AutomationManifest;
+    plan: AutomationFilePlan[];
+    written: number;
+    unchanged: number;
+    dryRun: boolean;
 }
-interface OrchestratorHandoffArtifact {
-    schemaVersion: "snipara.orchestrator.handoff.v1";
-    source: {
-        client: "snipara-companion";
-        command: string;
-        generatedAt: string;
-    };
-    workflow: {
-        mode: string;
-        workflowId: string | null;
-        currentPhaseId: string | null;
-        phases: OrchestratorHandoffWorkflowPhase[];
-    };
-    runtime: {
-        sandbox: {
-            provider: "snipara-sandbox";
-            phases: OrchestratorHandoffRuntimeSandboxPhase[];
-        } | null;
-    };
-    routing: {
-        level: OrchestratorRecommendation["level"];
-        reasons: OrchestratorRecommendation["reasons"];
-        policySource: string | null;
-        workProfile?: AdaptiveWorkProfile;
-        requirements?: AdaptiveModelRequirements;
-        routingCard?: AdaptiveRoutingCard;
-        gateway?: AdaptiveRoutingGatewayStatus;
-        runtimeCatalog?: AdaptiveRoutingRuntimeCatalog;
-        resolution?: AdaptiveRoutingResolution;
-    };
-    task: {
-        title: string;
-        query: string;
-        summary: string;
-    };
-    repo: {
-        root: string;
-        branch: string | null;
-        headSha: string | null;
-        changedFiles: string[];
-    };
-    coordination: {
-        swarmId: string | null;
-        claimScope: {
-            files: string[];
-            symbols: string[];
-        };
-        htask: {
-            featureTitle: string | null;
-            workstreams: string[];
-        };
-    };
-    validation: {
-        requiresProofGate: boolean;
-        requiresDriftCheck: boolean;
-        liveChecks: string[];
-        requiredEvidence: Array<{
-            type: string;
-            description: string;
-        }>;
-    };
-    memory: {
-        decisionIds: string[];
-        contextRefs: string[];
-        resumeSummary: string | null;
-    };
+interface AutomationStatusResult {
+    manifest: AutomationManifest | null;
+    files: Array<{
+        path: string;
+        targetPath: string;
+        state: "up-to-date" | "modified" | "missing";
+        expectedSha256: string;
+        currentSha256?: string;
+    }>;
 }
-interface OrchestratorHandoffOptions {
-    sourceCommand: string;
-    recommendation: OrchestratorRecommendation;
-    query: string;
-    summary: string;
-    title?: string;
-    mode?: string;
-    rootDir?: string;
-    changedFiles?: string[];
-    contextRefs?: string[];
-    decisionIds?: string[];
-    resumeSummary?: string;
-    featureTitle?: string;
-    workstreams?: string[];
-    adaptiveRouting?: AdaptiveWorkRoutingRecommendation | null;
+declare class AutomationInstallConflictError extends Error {
+    conflicts: AutomationFilePlan[];
+    constructor(conflicts: AutomationFilePlan[]);
 }
-interface WrittenOrchestratorHandoff {
-    handoff: OrchestratorHandoffArtifact;
-    path: string;
-    relativePath: string;
-    command: string;
+declare class AutomationUnsupportedHookBundleError extends Error {
+    client: string;
+    files: string[];
+    constructor(client: string, files: string[]);
 }
-declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions): OrchestratorHandoffArtifact;
-declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
-declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
+declare function getAutomationManifestPath(projectDir?: string): string;
+declare function loadAutomationManifest(projectDir?: string): AutomationManifest | null;
+declare function buildAutomationInstallPlan(args: {
+    projectDir: string;
+    bundle: AutomationConfigBundle;
+    manifest?: AutomationManifest | null;
+    force?: boolean;
+}): AutomationFilePlan[];
+declare function installAutomationBundle(args: {
+    client: string;
+    projectDir?: string;
+    bundle?: AutomationConfigBundle;
+    force?: boolean;
+    dryRun?: boolean;
+}): Promise<AutomationInstallResult>;
+declare function getAutomationStatus(projectDir?: string): AutomationStatusResult;
 
 export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, POLICY_LEDGER_SYNC_REPORT_VERSION, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildPolicyLedgerSyncReport, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectPolicyLedgerSyncArtifacts, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, controlledWorkerExecuteCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, workflowSyncPolicyLedgerCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };