@loucompanion/forge-bridge 0.1.3-dev.fbe15023cdfe → 0.1.4-dev.04a1e5b9e484

package/dist/session/pre-publication-validation.d.ts

@@ -0,0 +1,75 @@
+import type { DockerEngineProbe } from "../runtime/docker-engine-probe.js";
+import { type NativeTestPostgresFallback } from "../runtime/native-test-postgres-fallback.js";
+import type { ProviderProcessRunner } from "./provider-cli/provider-cli.process.js";
+import { ForgeFailureError, type RunnerDispatchEvent } from "./session.types.js";
+export type PrePublicationProfile = "implementation" | "comment_repair" | "ci_repair" | "conflict_repair";
+interface ValidationStep {
+    readonly command: string;
+    readonly fallbackCommand?: string;
+    readonly args: readonly string[];
+    readonly fallbackArgs?: readonly string[];
+    readonly assertUnchangedPaths?: readonly string[];
+}
+interface ValidationCheck {
+    readonly id: string;
+    readonly profiles: readonly string[];
+    readonly changedPathPatterns: readonly string[];
+    readonly requiredCapability?: string;
+    readonly requiredPrerequisite?: "docker_engine" | "isolated_postgres";
+    readonly providerOnly?: boolean;
+    readonly steps: readonly ValidationStep[];
+}
+interface ValidationContract {
+    readonly schemaVersion: number;
+    readonly contractId: string;
+    readonly checks: readonly ValidationCheck[];
+}
+export interface PrePublicationCommandResult {
+    readonly exitCode: number;
+    readonly stdout?: string;
+    readonly stderr?: string;
+}
+export interface PrePublicationCommandRunner {
+    run(command: string, args: readonly string[], cwd: string, signal?: AbortSignal, environment?: Readonly<Record<string, string>>): Promise<PrePublicationCommandResult>;
+}
+export interface PrePublicationExecutionContext {
+    readonly baselineRevision?: string;
+    readonly environment?: Readonly<Record<string, string>>;
+    readonly processRunner?: ProviderProcessRunner;
+}
+export declare class PrePublicationValidationError extends ForgeFailureError {
+    readonly checkId: string;
+    readonly exitCode: number;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly detail: string;
+    readonly code = "prepublication_validation_failed";
+    constructor(checkId: string, exitCode: number, command: string, args: readonly string[], detail: string);
+}
+export declare class PrePublicationInfrastructureError extends ForgeFailureError {
+    readonly checkId: string;
+    readonly exitCode: number;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly detail: string;
+    readonly code = "prepublication_infrastructure_failed";
+    constructor(checkId: string, exitCode: number, command: string, args: readonly string[], detail: string);
+}
+export declare class PrePublicationValidator {
+    private readonly commands;
+    private readonly dockerEngineProbe?;
+    private readonly nativeTestPostgresFallback;
+    constructor(commands?: PrePublicationCommandRunner, dockerEngineProbe?: DockerEngineProbe | undefined, nativeTestPostgresFallback?: () => NativeTestPostgresFallback | null);
+    validate(worktreePath: string, profile: PrePublicationProfile, capabilities: ReadonlySet<string>, emit?: (event: RunnerDispatchEvent) => Promise<void>, signal?: AbortSignal, execution?: PrePublicationExecutionContext): Promise<readonly string[]>;
+    /** Returns the native fallback connection when this check must use it instead of Docker. */
+    private ensurePrerequisite;
+    private throwIfPrerequisiteWasLost;
+    private assertNoTestOnlyExports;
+    private changedPaths;
+    private assertContractMatchesDispatchBaseline;
+    private runStep;
+    private runCommand;
+}
+export declare function applicableChecks(contract: ValidationContract, profile: PrePublicationProfile | "github_actions", changedPaths: readonly string[]): readonly ValidationCheck[];
+export declare function loadValidationContract(worktreePath: string): Promise<ValidationContract | null>;
+export {};