Files
reverse-engineering-anything/src/artifacts/StableArtifactFailure.ts
T
morluto bab49aaf7c refactor(artifacts): unify stable read failure ownership
Centralize completed file observations and cleanup error projection across stable-file providers while preserving each provider’s failure classification and exact cleanup leases. Cover BEAM finalization cancellation and devicetree cleanup retries.

Validated 223 focused lifecycle and MCP tests and check:fast.
2026-10-27 03:02:05 +08:00

51 lines
1.9 KiB
TypeScript

import type { AnalysisError } from "../domain/analysisErrorBase.js";
import { analysisErrorWithCleanupFailure } from "../domain/analysisErrorCleanup.js";
import { ProviderCleanupError } from "../domain/providerCleanupError.js";
import { ArtifactReaderFailure } from "./ArtifactReader.js";
import { bindArtifactFileCleanup } from "./ArtifactFileOperation.js";
import { completedStableArtifactObservation } from "./StableArtifactObservation.js";
const artifactCleanupFailure = (
cause: unknown,
providerId: string,
operation: string,
): ProviderCleanupError | undefined => {
if (!(cause instanceof ArtifactReaderFailure) || cause.cleanup === undefined)
return undefined;
return new ProviderCleanupError(
providerId,
cause.cleanup.resources,
{ reason: cause.cleanup.reason },
{ cause, operation },
);
};
/** Project descriptor cleanup while keeping its exact leases bound to the error. */
export const projectArtifactCloseFailure = (
cause: unknown,
providerId: string,
operation: string,
): unknown => {
const error = artifactCleanupFailure(cause, providerId, operation);
if (error === undefined) return cause;
bindArtifactFileCleanup(cause, error);
return error;
};
/** Preserve completed physical identity and exact cleanup ownership around a provider's primary failure. */
export const projectStableArtifactFailure = (
cause: unknown,
primary: AnalysisError,
path: string,
providerId: string,
operation: string,
): AnalysisError => {
const observation = completedStableArtifactObservation(cause, path);
if (observation !== undefined) primary.retainPartialObservation(observation);
const cleanup = artifactCleanupFailure(cause, providerId, operation);
if (cleanup === undefined) return primary;
const error = analysisErrorWithCleanupFailure(primary, cleanup, operation);
bindArtifactFileCleanup(cause, error);
return error;
};