@seamward/cli 0.1.0-alpha.9

package/dist/setup-engine.d.ts

@@ -0,0 +1,127 @@
+import { scanProject } from "./discovery.js";
+import { type ProjectMetadata } from "./project-metadata.js";
+import { discoverIntegrationScopes, inspectSetupActionEvidence, inspectSetupRemoteLifecycle, type ApplySetupResult, type IntegrationProtocol, type SetupPlan } from "./setup-plan.js";
+export interface LocalSetupEngineOptions {
+    root: string;
+    setupId?: string;
+}
+export interface SetupSelection {
+    direction: "inbound" | "outbound";
+    protocol: IntegrationProtocol;
+    contractFiles?: string[];
+    findingIds?: string[];
+}
+export interface SetupAnalysis {
+    project: ProjectMetadata;
+    discovery: Awaited<ReturnType<typeof scanProject>>;
+    integrationScopes: ReturnType<typeof discoverIntegrationScopes>;
+    privacy: {
+        sourceContentReturned: false;
+        environmentFilesRead: false;
+        absolutePathsReturned: false;
+        credentialsReturned: false;
+    };
+}
+export interface SetupVerification {
+    planFingerprint: string;
+    stateFingerprint: string;
+    artifactsValid: boolean;
+    collectorDependency: {
+        present: boolean;
+        compatible: boolean;
+        version: string | null;
+        minimumVersion: string;
+    };
+    generatedFiles: Array<{
+        file: string;
+        present: boolean;
+        matches: boolean;
+    }>;
+    instrumentationActions: Awaited<ReturnType<typeof inspectSetupActionEvidence>>;
+    contractActions: Awaited<ReturnType<typeof inspectSetupActionEvidence>>;
+    sourceBackedComplete: boolean;
+    localSetupComplete: boolean;
+    setupComplete: boolean;
+    remoteLifecycle: Awaited<ReturnType<typeof inspectSetupRemoteLifecycle>>;
+    blockers: Array<{
+        code: string;
+        file?: string;
+    }>;
+}
+export type LocalApplyResult = {
+    status: "verified";
+    files: string[];
+    verification: SetupVerification;
+} | {
+    status: "source_changes_required";
+    files: string[];
+    sourceChanges: Array<{
+        file: string;
+        line: number;
+        adapter: string;
+    }>;
+    verification: SetupVerification;
+};
+export declare class LocalSetupEngineError extends Error {
+    readonly code: "plan_not_found" | "legacy_plan_requires_replan" | "confirmation_required" | "no_matching_actions" | "generated_file_conflict" | "apply_in_progress" | "verification_failed" | "internal_error";
+    constructor(code: "plan_not_found" | "legacy_plan_requires_replan" | "confirmation_required" | "no_matching_actions" | "generated_file_conflict" | "apply_in_progress" | "verification_failed" | "internal_error", message: string, options?: ErrorOptions);
+}
+export declare function readSetupPlan(root: string, expectedFingerprint?: string, setupId?: string): Promise<SetupPlan>;
+export declare function readSetupPlans(root: string): Promise<SetupPlan[]>;
+export declare function verifySetup(root: string, plan: SetupPlan): Promise<SetupVerification>;
+export interface LocalSetupEngine {
+    analyze(): Promise<SetupAnalysis>;
+    plan(selection: SetupSelection): Promise<{
+        plan: SetupPlan;
+        applyPreview: ApplySetupResult;
+    }>;
+    applyGenerated(input: {
+        planFingerprint: string;
+        confirmation: "write_generated_setup";
+    }): Promise<ApplySetupResult>;
+    replaceGenerated(input: {
+        previousPlanFingerprint: string;
+        planFingerprint: string;
+        confirmation: "replace_generated_setup";
+    }): Promise<ApplySetupResult>;
+    recordEvidence(input: {
+        planFingerprint: string;
+        expectedStateFingerprint: string;
+        implementationFiles: string[];
+        note?: string;
+        confirmation: "record_source_evidence";
+    }): Promise<{
+        applied: true;
+        planFingerprint: string;
+        recordedActions: Array<{
+            file: string | null;
+            status: "recorded";
+        }>;
+    }>;
+    applyLocal(input: {
+        planFingerprint: string;
+    }): Promise<LocalApplyResult>;
+    verify(input: {
+        planFingerprint: string;
+    }): Promise<SetupVerification>;
+}
+export declare function applyLocalSetupBatch(rootDirectory: string, entries: Array<{
+    engine: LocalSetupEngine;
+    plan: SetupPlan;
+}>, retiredPlans?: SetupPlan[]): Promise<{
+    applied: Array<{
+        setupId?: string;
+        result: LocalApplyResult;
+    }>;
+    retired: Array<{
+        setupId: string;
+        files: string[];
+        remoteAction: "left_active";
+    }>;
+}>;
+export declare function retireLocalSetupBindings(rootDirectory: string, plans: SetupPlan[]): Promise<Array<{
+    setupId: string;
+    files: string[];
+    remoteAction: "left_active";
+}>>;
+export declare function createLocalSetupEngine(options: LocalSetupEngineOptions): Promise<LocalSetupEngine>;