bootproof 0.3.0 → 0.4.1

package/dist/repair-safety.d.ts

@@ -0,0 +1,130 @@
+import type { FailureClass } from "./types.js";
+export type RepairActionType = "command" | "patch" | "instruction";
+export type RepairActionSource = "deterministic_playbook" | "ai_suggested";
+export declare const ACTION_MUTATION_SCOPES: readonly ["none", "repo_only", "project_cache", "container_runtime", "host_tool_install", "host_network", "kubernetes_cluster", "database", "service", "credentials", "unknown"];
+export declare const ACTION_RISK_LEVELS: readonly ["none", "low", "medium", "high", "blocked"];
+export type RepairMutationScope = typeof ACTION_MUTATION_SCOPES[number];
+export type RepairRiskLevel = typeof ACTION_RISK_LEVELS[number];
+export interface RepairCommand {
+    executable: string;
+    args: string[];
+    display: string;
+}
+export interface RepairPatch {
+    format: "unified-diff";
+    content: string;
+    files: string[];
+}
+export interface RepairAction {
+    schema: "bootproof/repair-action/v1";
+    actionType: RepairActionType;
+    mutationScope: RepairMutationScope;
+    riskLevel: RepairRiskLevel;
+    requiresApproval: boolean;
+    approvalPrompt: string;
+    blockedReason: string;
+    verificationStep: string;
+    command: RepairCommand | null;
+    patch: RepairPatch | null;
+    instruction: string | null;
+    explanation: string;
+    evidenceRefs: string[];
+    deterministic: boolean;
+    source: RepairActionSource;
+}
+export interface RepairActionInput {
+    actionType: RepairActionType;
+    mutationScope: RepairMutationScope;
+    riskLevel: RepairRiskLevel;
+    requiresApproval?: boolean;
+    blockedReason?: string;
+    verificationStep?: string;
+    command?: RepairCommand | null;
+    patch?: RepairPatch | null;
+    instruction?: string | null;
+    explanation: string;
+    evidenceRefs: string[];
+}
+export type RepairApplyStatus = "not_applied" | "applied" | "failed";
+export interface RepairApplyResultRecord {
+    status: RepairApplyStatus;
+    exitCode: number | null;
+    filesChanged: string[];
+    evidence: string | null;
+}
+export interface RepairReceiptBase {
+    schema: "bootproof/repair-receipt/v1";
+    repairId: string;
+    createdAt: string;
+    bootproofVersion: string;
+    source: RepairActionSource;
+    beforeFailureClass: FailureClass;
+    beforeEvidenceHash: string;
+    proposedAction: RepairAction;
+    actionType: RepairActionType;
+    mutationScope: RepairMutationScope;
+    riskLevel: RepairRiskLevel;
+    userApprovalRequired: boolean;
+    approvedAt?: string;
+    appliedAt?: string;
+    applyResult: RepairApplyResultRecord;
+    afterFailureClass?: FailureClass;
+    progressed: boolean;
+    verified: boolean;
+    explanation: string;
+    redactionsApplied: string[];
+}
+export interface RepairReceiptBaseInput {
+    repairId: string;
+    createdAt: string;
+    bootproofVersion: string;
+    beforeFailureClass: FailureClass;
+    beforeEvidenceHash: string;
+    proposedAction: RepairAction;
+    approvedAt?: string;
+    appliedAt?: string;
+    applyResult?: RepairApplyResultRecord;
+    afterFailureClass?: FailureClass;
+    progressed?: boolean;
+    verified?: boolean;
+    explanation: string;
+    redactionsApplied?: string[];
+}
+export interface RepairSafetyValidation {
+    valid: boolean;
+    errors: string[];
+}
+export interface ActionRiskAssessment {
+    actionType: RepairActionType;
+    command: string;
+    riskLevel: RepairRiskLevel;
+    mutationScope: RepairMutationScope;
+    requiresApproval: boolean;
+    approvalPrompt: string;
+    blockedReason: string;
+    verificationStep: string;
+}
+export interface ActionRiskInput {
+    actionType: RepairActionType;
+    command?: RepairCommand | null;
+    mutationScope?: RepairMutationScope;
+    riskLevel?: RepairRiskLevel;
+    requiresApproval?: boolean;
+    blockedReason?: string;
+    verificationStep?: string;
+}
+export declare function renderRepairCommand(executable: string, args: string[]): string;
+export declare function createRepairCommand(executable: string, args: string[]): RepairCommand;
+export declare function isProtectedEnvPath(value: string): boolean;
+export declare function isBlockedRepairPath(value: string): boolean;
+export declare function assessActionRisk(input: ActionRiskInput): ActionRiskAssessment;
+export declare function validateActionRiskAssessment(value: unknown): RepairSafetyValidation;
+export declare function validateRepairCommand(command: unknown): RepairSafetyValidation;
+export declare function validateRepairPatch(patchValue: unknown): RepairSafetyValidation;
+export declare function validateRepairAction(value: unknown): RepairSafetyValidation;
+export declare function buildRepairAction(input: RepairActionInput): RepairAction;
+export declare const createRepairAction: typeof buildRepairAction;
+export declare function buildAiSuggestedRepairAction(input: RepairActionInput): RepairAction;
+export declare function validateRepairReceiptBase(value: unknown): RepairSafetyValidation;
+export declare function buildRepairReceiptBase(input: RepairReceiptBaseInput): RepairReceiptBase;
+export declare function serializeRepairReceiptBase(receipt: RepairReceiptBase): string;