taphound 0.2.0-dev.1 → 0.2.0-dev.12

package/dist/cli/dependencies.d.ts

@@ -1,19 +1,54 @@
+import { type DiagnosticsExportInput } from "../application/diagnostics/diagnostics-exporter.js";
+import type { DiagnosticsBundle } from "../domain/diagnostics.js";
+import { type CliDiagnostics } from "./diagnostics-recorder.js";
+import type { MobileMcpTools } from "../adapters/runtime/mobile-mcp/mobile-mcp-tools.js";
+import type { Clock } from "../ports/clock.js";
+import { type AlignCameraResult } from "../application/align/align-service.js";
+import { type ObserveInput } from "../application/observe/observe-service.js";
+import type { ObserveReport } from "../domain/observation.js";
+import { ContextGenerator } from "../application/context/context-generator.js";
+import { ContextRehasher } from "../application/context/context-rehasher.js";
 import { ContextValidator } from "../application/context/context-validator.js";
+import { ContextLoader } from "../application/context/context-loader.js";
+import { ContextRefresher } from "../application/context/context-refresher.js";
 import type { DoctorReport, DoctorRunInput } from "../application/doctor/doctor-service.js";
 import { GenerationConfirmationService } from "../application/generation/generation-confirmation-service.js";
 import { GenerationFinalizer } from "../application/generation/generation-finalizer.js";
+import { GenerationRecoveryService } from "../application/generation/generation-recovery-service.js";
+import { GenerationReopenService } from "../application/generation/generation-reopen-service.js";
+import { type GenerationIdlePolicyPatch } from "../application/generation/generation-config-service.js";
+import { type GenerationReplaceResult } from "../application/generation/generation-replace-service.js";
 import { GenerationStarter, type GenerationStartInput } from "../application/generation/generation-starter.js";
+import type { ResolvedProjectContext } from "../domain/project-context.js";
 import { GenerationStepExecutor } from "../application/generation/generation-step-executor.js";
 import { RuntimeObserver, type RuntimeObservation, type RuntimeObserveInput } from "../application/generation/runtime-observer.js";
 import { type InitInput } from "../application/init/init-service.js";
+import { JourneyResolver } from "../application/journey/journey-resolver.js";
+import { ExternalFlowResolver } from "../application/journey/external-flow-resolver.js";
 import { ProjectDescriber } from "../application/project/project-describer.js";
 import { type RecordInput, type RecordResult } from "../application/recorder/recorder-service.js";
+import { type ContractVerifyInput, type ContractVerifyResult } from "../application/contract/contract-verifier.js";
+import { ContractLoader } from "../application/contract/contract-loader.js";
+import { ContractReviewMerger } from "../application/contract/contract-review.js";
+import { BaselineService } from "../application/checkpoint/baseline-service.js";
+import type { ContractVerdictView } from "../domain/contract.js";
+import type { FailureClassification } from "../domain/failure-classification.js";
 import { type VerifyInput, type VerifyResult } from "../application/runtime/verify-runtime.js";
 import type { TapHoundConfig } from "../domain/config.js";
+import { type RuntimeBackendChoice } from "../domain/runtime.js";
+import type { GitDiffPort } from "../ports/git-diff.js";
+import type { ImpactSet, ChangeSet } from "../domain/impact.js";
+import { type RuntimeBackend } from "../ports/runtime-backend.js";
+import type { UiBackendSelection } from "../domain/ui-backend.js";
 import type { InitResult } from "../domain/init.js";
-import type { GenerationSession } from "../domain/generation.js";
+import { type GenerationSession } from "../domain/generation.js";
 import type { InitPromptPort } from "../ports/init-prompt.js";
+import type { RecorderPromptPort } from "../ports/recorder-prompt.js";
 import type { GenerationSessionStore } from "../ports/generation-session-store.js";
+import type { DetachedProcessLauncher } from "../ports/detached-process-launcher.js";
+import type { WorkspaceLayoutPort } from "../ports/workspace-layout.js";
+import type { JourneyCompositionStore } from "../ports/journey-composition-store.js";
+import type { KnowledgeRehashResult, LoadedKnowledgeBundle } from "../ports/knowledge-registry.js";
 export interface TextOutput {
     write: (content: string) => void;
 }
@@ -22,8 +57,23 @@ export interface GenerationCliRuntime {
     executor: Pick<GenerationStepExecutor, "execute">;
     observer: Pick<RuntimeObserver, "observe">;
     finalizer: Pick<GenerationFinalizer, "finalize">;
+    recovery: Pick<GenerationRecoveryService, "status" | "retry">;
+    reopen: Pick<GenerationReopenService, "reopen">;
+    archive: (id: string) => Promise<GenerationSession>;
+    list: () => Promise<readonly GenerationSession[]>;
     readSession: (id: string) => Promise<GenerationSession>;
+    readContextSnapshot: (id: string) => Promise<ResolvedProjectContext>;
     assertConfigIdentity: (id: string) => Promise<void>;
+    updateIdlePolicy: (id: string, patch: GenerationIdlePolicyPatch) => Promise<GenerationSession>;
+    replace: (input: {
+        generationId: string;
+        stepIndex: number;
+        projectRoot: string;
+        config: TapHoundConfig;
+        toolVersions: Record<string, string>;
+        manualReplay?: boolean | undefined;
+        signal?: AbortSignal | undefined;
+    }) => Promise<GenerationReplaceResult>;
 }
 export interface CliDependencies {
     signal?: AbortSignal | undefined;
@@ -36,8 +86,30 @@ export interface CliDependencies {
     verifier: {
         verify: (input: VerifyInput) => Promise<VerifyResult>;
     };
+    contractVerifier?: {
+        verify: (input: ContractVerifyInput) => Promise<ContractVerifyResult>;
+    } | undefined;
+    contractLoader?: Pick<ContractLoader, "load"> | undefined;
+    baselineService?: Pick<BaselineService, "captureFromReport" | "write" | "compare"> | undefined;
+    failureClassifier?: {
+        classify: (reportPath: string) => Promise<FailureClassification>;
+    } | undefined;
+    contractReview?: {
+        merge: ContractReviewMerger["merge"];
+        writeVerdict: (input: {
+            verdictPath: string;
+            view: ContractVerdictView;
+        }) => Promise<void>;
+    } | undefined;
     projectDescriber: Pick<ProjectDescriber, "describe">;
     contextValidator: Pick<ContextValidator, "validate">;
+    contextLoader: Pick<ContextLoader, "load" | "readIndex">;
+    contextRefresher: Pick<ContextRefresher, "refresh">;
+    contextGenerator: Pick<ContextGenerator, "generate">;
+    contextRehasher: Pick<ContextRehasher, "rehash">;
+    journeyResolver?: Pick<JourneyResolver, "resolve" | "resolveFlow" | "listFlows"> | undefined;
+    journeyCompositionStore?: Pick<JourneyCompositionStore, "writeText" | "read" | "listJourneyPaths" | "readJourneyMeta"> | undefined;
+    externalFlowResolver?: Pick<ExternalFlowResolver, "resolve" | "list"> | undefined;
     generationStarter: {
         start: (input: GenerationStartInput) => Promise<Awaited<ReturnType<GenerationStarter["start"]>>>;
     };
@@ -50,17 +122,80 @@ export interface CliDependencies {
         projectRoot: string;
         config: TapHoundConfig;
     }) => GenerationCliRuntime;
+    detachedProcess?: DetachedProcessLauncher | undefined;
+    cliEntryPath?: string | undefined;
+    createDetachedJobId?: (() => string) | undefined;
     init: {
         install: (input: InitInput) => Promise<InitResult>;
     };
     initPrompt: Pick<InitPromptPort, "selectAgents">;
+    align: {
+        alignCamera: (input: {
+            projectRoot: string;
+            deviceSerial?: string | undefined;
+            force?: boolean | undefined;
+            json: boolean;
+            signal?: AbortSignal | undefined;
+        }) => Promise<AlignCameraResult>;
+    };
+    observer: (layoutTimeoutMs: number, backend?: UiBackendSelection, cacheEnabled?: boolean) => {
+        observe: (input: ObserveInput) => Promise<ObserveReport>;
+    };
+    workspaceLayout: WorkspaceLayoutPort;
+    impact?: {
+        resolve: (input: {
+            projectRoot: string;
+            packageName: string;
+            changeSet: ChangeSet;
+        }) => Promise<ImpactSet>;
+    } | undefined;
+    gitDiff?: GitDiffPort | undefined;
+    knowledge?: {
+        load: (input: {
+            projectRoot: string;
+            packageName?: string | undefined;
+            expectedKnowledgeHash?: string | undefined;
+        }) => Promise<LoadedKnowledgeBundle>;
+        rehash: (input: {
+            projectRoot: string;
+            packageName: string;
+        }) => Promise<KnowledgeRehashResult>;
+    } | undefined;
     readJson: (path: string) => Promise<unknown>;
+    readFile: (path: string) => Promise<Buffer>;
+    /** Atomically publishes a verify process receipt beside its report. */
+    writeVerifyReceipt?: ((path: string, content: string) => Promise<void>) | undefined;
     cwd: () => string;
     stdout: TextOutput;
     stderr: TextOutput;
     setExitCode: (code: number) => void;
+    close?: (() => Promise<void>) | undefined;
+    /** Local diagnostics journal; absent in tests and when disabled. */
+    diagnostics?: CliDiagnostics | undefined;
+    diagnosticsExport?: {
+        export: (input: DiagnosticsExportInput) => Promise<DiagnosticsBundle>;
+        write: (path: string, content: string) => Promise<void>;
+    } | undefined;
 }
 export interface ProductionDependencyOptions {
     generationStoreFactory?: (projectRoot: string) => GenerationSessionStore;
+    runtimeBackendChoice?: RuntimeBackendChoice | undefined;
+    mobileMcpToolsFactory?: (() => MobileMcpTools) | undefined;
+    /**
+     * Replaces the device backend while keeping every other production wire.
+     * Used by the simulated-device parity harness; the CLI never sets it.
+     */
+    runtimeBackend?: RuntimeBackend | undefined;
+    /** Single time source for waits, polling, and cache TTLs (tests inject a virtual clock). */
+    clock?: Clock | undefined;
+    /** Replaces the interactive Recorder prompt (the parity harness scripts it). */
+    recorderPrompt?: RecorderPromptPort | undefined;
 }
+export declare function loadKnowledgeResilient(load: (input: {
+    projectRoot: string;
+    packageName: string;
+}) => Promise<LoadedKnowledgeBundle>, input: {
+    projectRoot: string;
+    packageName: string;
+}): Promise<LoadedKnowledgeBundle>;
 export declare function createProductionDependencies(signal?: AbortSignal, options?: ProductionDependencyOptions): CliDependencies;