hoi4-agent-tools 0.0.0-bootstrap.1 → 0.1.2

package/dist/hoi4_agent_tools/core/transactions.d.ts

@@ -0,0 +1,162 @@
+import { ArtifactStore } from './artifacts.js';
+import type { Diagnostic } from './diagnostics.js';
+import type { ScannedFile } from './scanner.js';
+import type { ServerState } from './server-state.js';
+import type { ArtifactLink, ValidationSummary } from './result.js';
+import type { ResolvedWorkspace, WorkspaceResolver } from './workspace.js';
+import type { RootKind } from './workspace.js';
+export type TransactionState = 'planned' | 'applying' | 'applied' | 'rolling_back' | 'rolled_back' | 'failed';
+export interface ProposedFileChange {
+    relativePath: string;
+    content: Uint8Array | null;
+    operationIds: string[];
+    mediaType?: string;
+}
+export interface TransactionFileChange {
+    relativePath: string;
+    operationIds: string[];
+    beforeSha256: string | null;
+    afterSha256: string | null;
+    beforeSize: number | null;
+    afterSize: number | null;
+    beforeBlob: string | null;
+    afterBlob: string | null;
+    mediaType: string;
+    diffArtifact?: ArtifactLink;
+}
+export interface TransactionReadDependency {
+    rootKind: RootKind;
+    loadOrder: number;
+    relativePath: string;
+    sha256: string;
+}
+export declare function readDependenciesFromScannedFiles(files: readonly Pick<ScannedFile, 'rootKind' | 'loadOrder' | 'relativePath' | 'sha256'>[]): TransactionReadDependency[];
+export interface TransactionManifest {
+    version: number;
+    revision: number;
+    transactionId: string;
+    workspaceId: string;
+    principal?: string;
+    rootFingerprint: string;
+    createdAt: string;
+    expiresAt: string;
+    state: TransactionState;
+    planPayload: TransactionPlanPayload;
+    planHash: string;
+    integrityHash: string;
+    authenticationTag: string;
+    operationKind: string;
+    operations: Array<{
+        id: string;
+        kind: string;
+        summary: string;
+        data: Record<string, unknown>;
+    }>;
+    readDependencies: TransactionReadDependency[];
+    files: TransactionFileChange[];
+    diagnostics: Diagnostic[];
+    validation: ValidationSummary;
+    artifacts: ArtifactLink[];
+    appliedFiles: string[];
+    rollbackStatus: 'available' | 'applied' | 'failed';
+    failure?: {
+        code: string;
+        message: string;
+    };
+}
+export interface TransactionPlanPayload {
+    version: number;
+    workspaceId: string;
+    principal: string | null;
+    rootFingerprint: string;
+    operationKind: string;
+    operations: TransactionManifest['operations'];
+    readDependencies: TransactionReadDependency[];
+    files: Array<Omit<TransactionFileChange, 'diffArtifact'>>;
+    diagnostics: Diagnostic[];
+    validation: ValidationSummary;
+    artifacts: ArtifactLink[];
+}
+export interface TransactionValidation {
+    diagnostics: Diagnostic[];
+    checks: ValidationSummary['checks'];
+}
+export interface PlanTransactionInput {
+    workspaceId: string;
+    principal?: string;
+    operationKind: string;
+    operations: TransactionManifest['operations'];
+    changes: ProposedFileChange[];
+    readDependencies?: TransactionReadDependency[];
+    artifacts?: ArtifactLink[];
+    diagnostics?: Diagnostic[];
+    validate: (proposed: ReadonlyMap<string, Buffer | null>, signal?: AbortSignal) => Promise<TransactionValidation>;
+    signal?: AbortSignal;
+}
+export interface TransactionHooks {
+    afterStage?: (relativePath: string, index: number) => Promise<void>;
+    afterBackup?: (relativePath: string, index: number) => Promise<void>;
+    afterReplace?: (relativePath: string, index: number) => Promise<void>;
+    beforePostValidation?: () => Promise<void>;
+    beforeManifestCacheWrite?: () => Promise<void>;
+    afterManifestCacheWrite?: () => Promise<void>;
+    beforeProtectedHeadCommit?: () => Promise<void>;
+    afterProtectedHeadCommit?: () => Promise<void>;
+}
+export interface ApplyTransactionOptions {
+    principal?: string;
+    postValidate: (manifest: TransactionManifest, signal?: AbortSignal) => Promise<TransactionValidation>;
+    hooks?: TransactionHooks;
+    signal?: AbortSignal;
+}
+export declare function transactionRootFingerprint(workspace: ResolvedWorkspace): string;
+export declare class TransactionManager {
+    #private;
+    private readonly resolver;
+    private readonly artifacts;
+    private readonly ttlSeconds;
+    private readonly maxJournalBytes;
+    private readonly maxJournals;
+    private readonly serverState;
+    constructor(resolver: WorkspaceResolver, artifacts?: ArtifactStore, ttlSeconds?: number, maxJournalBytes?: number, maxJournals?: number, serverState?: ServerState | undefined);
+    plan(input: PlanTransactionInput): Promise<TransactionManifest>;
+    apply(workspaceId: string, transactionId: string, expectedPlanHash: string, options: ApplyTransactionOptions): Promise<TransactionManifest>;
+    rollback(workspaceId: string, transactionId: string, expectedPlanHash: string, principal?: string, signal?: AbortSignal): Promise<TransactionManifest>;
+    status(workspaceId: string, transactionId: string, principal?: string, signal?: AbortSignal): Promise<TransactionManifest>;
+    readManifestRange(workspaceId: string, transactionId: string, range: {
+        offset: number;
+        length: number;
+    }, principal?: string, signal?: AbortSignal): Promise<{
+        bytes: Buffer;
+        totalSize: number;
+    }>;
+    recover(workspaceId: string, principal?: string, signal?: AbortSignal): Promise<TransactionManifest[]>;
+    private restoreBeforeState;
+    private safeFailure;
+    private assertBinding;
+    private verifyCurrentFiles;
+    private verifyReadDependencies;
+    private commitPlannedJournal;
+    private pruneExpiredJournals;
+    private removeOrphanJournalHeads;
+    private journalUsage;
+    private directoryBytes;
+    private readVerifiedBlob;
+    private rootFingerprint;
+    private requireServerState;
+    private authenticateManifest;
+    private journalHeadInput;
+    private recordInitialManifestHead;
+    private recordManifestSuccessor;
+    private verifyManifestHead;
+    private transactionDirectory;
+    private manifestPath;
+    private manifestCacheKey;
+    private removeManifestByteCache;
+    private storeManifestByteCache;
+    private writeManifest;
+    private load;
+    private withWorkspaceLock;
+    private clearCrashedProcessLock;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/hoi4_agent_tools/core/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/hoi4_agent_tools/core/transactions.ts"],"names":[],"mappings":"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"}