Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
refactor(domain): split error taxonomy into thematic modules (#636)
morluto735c10059ca1
diff --git a/src/application/AnalysisClientCleanup.ts b/src/application/AnalysisClientCleanup.tsindex d2aa7e8ef..fedc8cef8 100644--- a/src/application/AnalysisClientCleanup.ts+++ b/src/application/AnalysisClientCleanup.ts@@ -1,6 +1,6 @@import { ProviderCleanupError } from "../domain/providerCleanupError.js";import { err, ok, type Result } from "../domain/result.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { AnalysisClient, ExecutionOptions } from "./AnalysisProvider.js";/** Close one provider client and normalize unexpected adapter rejection. */diff --git a/src/application/AnalysisContextQueries.test.ts b/src/application/AnalysisContextQueries.test.tsindex 62734ce9c..3305c9684 100644--- a/src/application/AnalysisContextQueries.test.ts+++ b/src/application/AnalysisContextQueries.test.ts@@ -13,7 +13,7 @@ import {AnalysisCancelledError,AnalysisOutputError,AnalysisProtocolError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";import { err, ok } from "../domain/result.js";const provider = { id: "fixture", name: "Fixture", version: "1" };diff --git a/src/application/AnalysisContextQueries.ts b/src/application/AnalysisContextQueries.tsindex 412b89c3f..a48a19541 100644--- a/src/application/AnalysisContextQueries.ts+++ b/src/application/AnalysisContextQueries.ts@@ -6,8 +6,8 @@ import type {import {AnalysisCapabilityUnavailableError,AnalysisOutputError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { JsonValue } from "../domain/jsonValue.js";import { parseDocuments } from "../domain/hopperValues.js";import { err, ok, type Result } from "../domain/result.js";diff --git a/src/application/AnalysisProvider.ts b/src/application/AnalysisProvider.tsindex 9c226165d..0b2922ab9 100644--- a/src/application/AnalysisProvider.ts+++ b/src/application/AnalysisProvider.ts@@ -4,7 +4,7 @@ import type { EnhancedToolName } from "../contracts/enhancedInputs.js";import type { NativeToolName } from "../contracts/nativeToolContracts.js";import type { ArtifactAnalysisOperation } from "../contracts/artifactToolContracts.js";import type { ManagedToolName } from "../contracts/managedToolContracts.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { JsonValue } from "../domain/jsonValue.js";import type { Result } from "../domain/result.js";diff --git a/src/application/AnalysisProviderEvaluation.ts b/src/application/AnalysisProviderEvaluation.tsindex 63e726e70..08a7a5493 100644--- a/src/application/AnalysisProviderEvaluation.ts+++ b/src/application/AnalysisProviderEvaluation.ts@@ -3,7 +3,7 @@ import {type AnalysisProfileCommitment,} from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import { AnalysisCancelledError } from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";import { jsonObjectSchema, type JsonValue } from "../domain/jsonValue.js";import { err, ok, type Result } from "../domain/result.js";import type { AnalysisProviderCandidate } from "./AnalysisProvider.js";diff --git a/src/application/AnalysisProviderRegistry.test.ts b/src/application/AnalysisProviderRegistry.test.tsindex 2dc8802e7..a079f43c0 100644--- a/src/application/AnalysisProviderRegistry.test.ts+++ b/src/application/AnalysisProviderRegistry.test.ts@@ -15,11 +15,9 @@ import {} from "./AnalysisProvider.js";import { createAnalysisProfile } from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import {- ProviderAdapterError,- ProviderSelectionError,- projectAnalysisError,-} from "../domain/errors.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { ProviderSelectionError } from "../domain/providerSelectionError.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import { err, ok } from "../domain/result.js";const DATABASE_TARGET: BinaryTarget = {diff --git a/src/application/AnalysisProviderRegistry.ts b/src/application/AnalysisProviderRegistry.tsindex de254e764..d39b201f8 100644--- a/src/application/AnalysisProviderRegistry.ts+++ b/src/application/AnalysisProviderRegistry.ts@@ -5,12 +5,12 @@ import {} from "../contracts/providerSelection.js";import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";import {- AnalysisCancelledError,ProviderSelectionError,type ProviderSelectionFailureReason,type ProviderSelectionRejection,-} from "../domain/errors.js";+} from "../domain/providerSelectionError.js";import { jsonObjectSchema, type JsonValue } from "../domain/jsonValue.js";import { err, ok, type Result } from "../domain/result.js";import type {diff --git a/src/application/AnalysisSnapshotCache.ts b/src/application/AnalysisSnapshotCache.tsindex 88ae8998c..a51929c08 100644--- a/src/application/AnalysisSnapshotCache.ts+++ b/src/application/AnalysisSnapshotCache.ts@@ -2,11 +2,9 @@ import type { BinaryTarget } from "../domain/binaryTarget.js";import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { JsonValue } from "../domain/jsonValue.js";import type { EvidenceBundle } from "../domain/evidenceBundle.js";-import {- EvidenceIntegrityError,- NoBinaryOpenError,- type AnalysisError,-} from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { NoBinaryOpenError } from "../domain/configurationErrors.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";import {analysisQueryId,diff --git a/src/application/AnalysisSnapshotFiles.ts b/src/application/AnalysisSnapshotFiles.tsindex 02d3c0130..6907ea005 100644--- a/src/application/AnalysisSnapshotFiles.ts+++ b/src/application/AnalysisSnapshotFiles.ts@@ -3,7 +3,10 @@ import {serializeAnalysisSnapshot,type AnalysisSnapshot,} from "../domain/analysisSnapshot.js";-import { EvidenceFileError, EvidenceIntegrityError } from "../domain/errors.js";+import {+ EvidenceFileError,+ EvidenceIntegrityError,+} from "../domain/evidenceErrors.js";import { err, ok, type Result } from "../domain/result.js";import { readJsonFile, writeTextFile } from "./JsonFiles.js";diff --git a/src/application/AndroidApplicationService.ts b/src/application/AndroidApplicationService.tsindex 269b65f66..0d21c73ce 100644--- a/src/application/AndroidApplicationService.ts+++ b/src/application/AndroidApplicationService.ts@@ -1,4 +1,4 @@-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import {androidApplicationProjectionInputSchema,diff --git a/src/application/AppleApplicationService.ts b/src/application/AppleApplicationService.tsindex f90db3c39..593daa709 100644--- a/src/application/AppleApplicationService.ts+++ b/src/application/AppleApplicationService.ts@@ -1,4 +1,4 @@-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import {appleApplicationProjectionInputSchema,diff --git a/src/application/BinarySession.ts b/src/application/BinarySession.tsindex 480b72adb..f379a1dbd 100644--- a/src/application/BinarySession.ts+++ b/src/application/BinarySession.ts@@ -5,10 +5,8 @@ import {analysisProfilesEqual,type AnalysisProfileCommitment,} from "../domain/analysisProfile.js";-import {- AnalysisCancelledError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";import type { JsonValue } from "../domain/jsonValue.js";import { createEvidence } from "../domain/evidence.js";diff --git a/src/application/BinarySessionExecution.ts b/src/application/BinarySessionExecution.tsindex 11fcbe405..410bf0223 100644--- a/src/application/BinarySessionExecution.ts+++ b/src/application/BinarySessionExecution.ts@@ -1,11 +1,9 @@import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import {- AnalysisCapabilityUnavailableError,- NoBinaryOpenError,- ProviderAdapterError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { NoBinaryOpenError } from "../domain/configurationErrors.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { JsonValue } from "../domain/jsonValue.js";import type { EvidenceSubjectTarget } from "../domain/evidence.js";import { err, ok, type Result } from "../domain/result.js";diff --git a/src/application/BinarySessionOpen.ts b/src/application/BinarySessionOpen.tsindex 25cdd8d5c..46f74dcaf 100644--- a/src/application/BinarySessionOpen.ts+++ b/src/application/BinarySessionOpen.ts@@ -8,10 +8,8 @@ import {import type { AnalysisSnapshot } from "../domain/analysisSnapshot.js";import { parseBinaryTarget } from "./BinaryTargetResolver.js";import { type BinaryTarget } from "../domain/binaryTarget.js";-import {- EvidenceIntegrityError,- type AnalysisError,-} from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, type Result } from "../domain/result.js";import type { SessionProviderRoute } from "./SessionProviderRouter.js";import { SessionProviderRouter } from "./SessionProviderRouter.js";diff --git a/src/application/BinarySessionPort.ts b/src/application/BinarySessionPort.tsindex 3352f8be0..5104a197c 100644--- a/src/application/BinarySessionPort.ts+++ b/src/application/BinarySessionPort.ts@@ -5,11 +5,9 @@ import type { EvidenceBundle } from "../domain/evidenceBundle.js";import type { AnalysisSnapshot } from "../domain/analysisSnapshot.js";import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { AnalysisProviderSelector } from "../contracts/providerSelection.js";-import type {- AnalysisError,- EvidenceIntegrityError,- UnknownRegistryError,-} from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";+import type { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import type { UnknownRegistryError } from "../domain/unknownRegistryError.js";import type { Result } from "../domain/result.js";import type {RecordUnknownInput,diff --git a/src/application/BinarySessionRecords.ts b/src/application/BinarySessionRecords.tsindex 0439e4370..dd2bbfbc6 100644--- a/src/application/BinarySessionRecords.ts+++ b/src/application/BinarySessionRecords.ts@@ -4,11 +4,9 @@ import type { BinaryTarget } from "../domain/binaryTarget.js";import { createEvidence, type Evidence } from "../domain/evidence.js";import type { EvidenceBundle } from "../domain/evidenceBundle.js";import { evidenceBundleForTarget } from "../domain/evidenceBundle.js";-import {- EvidenceIntegrityError,- type AnalysisError,- type UnknownRegistryError,-} from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";+import { type UnknownRegistryError } from "../domain/unknownRegistryError.js";import type {RecordUnknownInput,ResidualUnknown,diff --git a/src/application/BinaryTargetResolver.ts b/src/application/BinaryTargetResolver.tsindex 76b5b00f8..841837b22 100644--- a/src/application/BinaryTargetResolver.ts+++ b/src/application/BinaryTargetResolver.ts@@ -13,7 +13,7 @@ import { extname, isAbsolute, join, resolve } from "node:path";import { promisify } from "node:util";import { isPathWithinRoot } from "../domain/localPath.js";-import { BinaryTargetError } from "../domain/errors.js";+import { BinaryTargetError } from "../domain/configurationErrors.js";import type { BinaryTarget } from "../domain/binaryTargetTypes.js";import { err, ok, type Result } from "../domain/result.js";import { mzWindowsHeaderOffset } from "../domain/dosMz.js";diff --git a/src/application/BrowserObservationPort.ts b/src/application/BrowserObservationPort.tsindex 1d72e4f4d..1d33e12af 100644--- a/src/application/BrowserObservationPort.ts+++ b/src/application/BrowserObservationPort.ts@@ -1,4 +1,4 @@-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type {BrowserTargetList,InspectWebPageInput,diff --git a/src/application/BrowserObservationService.ts b/src/application/BrowserObservationService.tsindex 8dfaabe20..1852dab26 100644--- a/src/application/BrowserObservationService.ts+++ b/src/application/BrowserObservationService.ts@@ -11,10 +11,8 @@ import type {CaptureWebScreenshotInput,CompareWebScreenshotsInput,} from "../domain/webScreenshot.js";-import {- AnalysisCapabilityUnavailableError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";import type { ExecutionOptions } from "./AnalysisProvider.js";import type { BrowserObservationPort } from "./BrowserObservationPort.js";diff --git a/src/application/BrowserScenarioCapturePort.ts b/src/application/BrowserScenarioCapturePort.tsindex c48df87d3..99260e5ab 100644--- a/src/application/BrowserScenarioCapturePort.ts+++ b/src/application/BrowserScenarioCapturePort.ts@@ -1,5 +1,5 @@import type { ExecutionOptions, ProviderIdentity } from "./AnalysisProvider.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { BrowserScenario } from "../domain/browserScenario.js";import type { BrowserScenarioCapture } from "../domain/browserScenarioCapture.js";import type { Result } from "../domain/result.js";diff --git a/src/application/BrowserScenarioCaptureService.ts b/src/application/BrowserScenarioCaptureService.tsindex 7f0b00d47..ae3500625 100644--- a/src/application/BrowserScenarioCaptureService.ts+++ b/src/application/BrowserScenarioCaptureService.ts@@ -1,10 +1,8 @@import type { ExecutionOptions } from "./AnalysisProvider.js";import type { BrowserScenarioCapturePort } from "./BrowserScenarioCapturePort.js";import { createBrowserScenarioEvidence } from "./BrowserScenarioEvidence.js";-import {- AnalysisCapabilityUnavailableError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import type { BrowserScenario } from "../domain/browserScenario.js";import { err, type Result } from "../domain/result.js";diff --git a/src/application/CallPathTracing.ts b/src/application/CallPathTracing.tsindex 43fcf0695..ce31885c6 100644--- a/src/application/CallPathTracing.ts+++ b/src/application/CallPathTracing.ts@@ -1,5 +1,6 @@import type { AnalysisOperation } from "./AnalysisProvider.js";-import { projectAnalysisError, type AnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { parseRelatedAddresses } from "../domain/hopperValues.js";import type { JsonValue } from "../domain/jsonValue.js";import { ok, type Result } from "../domain/result.js";diff --git a/src/application/CompositeProvider.ts b/src/application/CompositeProvider.tsindex 28db5671b..75c5992f3 100644--- a/src/application/CompositeProvider.ts+++ b/src/application/CompositeProvider.ts@@ -1,4 +1,4 @@-import { AnalysisCapabilityUnavailableError } from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";import { err, ok } from "../domain/result.js";import type { BinaryTarget } from "../domain/binaryTarget.js";import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";diff --git a/src/application/DirectAnalysis.ts b/src/application/DirectAnalysis.tsindex cb6313fae..b7a9263d8 100644--- a/src/application/DirectAnalysis.ts+++ b/src/application/DirectAnalysis.ts@@ -11,11 +11,9 @@ import {isManagedToolName,type ManagedToolName,} from "../contracts/managedToolContracts.js";-import {- EvidenceIntegrityError,- projectAnalysisError,- type AnalysisError,-} from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { access } from "node:fs/promises";import {readAnalysisSnapshot,diff --git a/src/application/DirectAnalysisStatus.ts b/src/application/DirectAnalysisStatus.tsindex 5c36443d6..b90c87218 100644--- a/src/application/DirectAnalysisStatus.ts+++ b/src/application/DirectAnalysisStatus.ts@@ -1,5 +1,5 @@import { parseConfig } from "../config.js";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import { jsonObjectSchema, type JsonValue } from "../domain/jsonValue.js";import { createServerIdentity } from "../serverIdentity.js";import { silentLogger, type Logger } from "../logger.js";diff --git a/src/application/ElectronActiveObservationPort.ts b/src/application/ElectronActiveObservationPort.tsindex ad54031c8..584568a05 100644--- a/src/application/ElectronActiveObservationPort.ts+++ b/src/application/ElectronActiveObservationPort.ts@@ -1,5 +1,5 @@import type { ExecutionOptions, ProviderIdentity } from "./AnalysisProvider.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type {ElectronActiveObservationInput,ElectronActiveObservationResult,diff --git a/src/application/ElectronActiveObservationService.ts b/src/application/ElectronActiveObservationService.tsindex 482cf53a0..f1081be2f 100644--- a/src/application/ElectronActiveObservationService.ts+++ b/src/application/ElectronActiveObservationService.ts@@ -6,8 +6,8 @@ import type { ElectronActiveObservationPort } from "./ElectronActiveObservationPimport {AnalysisCapabilityUnavailableError,AnalysisInputError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import type { ElectronActiveObservationInput } from "../domain/electronActiveObservation.js";import { err, type Result } from "../domain/result.js";diff --git a/src/application/ElectronObservationPort.ts b/src/application/ElectronObservationPort.tsindex 3b882cae9..f6ed7bf06 100644--- a/src/application/ElectronObservationPort.ts+++ b/src/application/ElectronObservationPort.ts@@ -1,5 +1,5 @@import type { ExecutionOptions, ProviderIdentity } from "./AnalysisProvider.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type {ElectronPageInspection,ElectronTargetList,diff --git a/src/application/ElectronObservationService.ts b/src/application/ElectronObservationService.tsindex 7e0b615da..87d7263be 100644--- a/src/application/ElectronObservationService.ts+++ b/src/application/ElectronObservationService.ts@@ -5,10 +5,8 @@ import type {InspectElectronPageInput,ListElectronTargetsInput,} from "../domain/electronObservation.js";-import {- AnalysisCapabilityUnavailableError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";import { createElectronEvidence } from "./ElectronEvidence.js";diff --git a/src/application/EnhancedLiteralTracing.ts b/src/application/EnhancedLiteralTracing.tsindex e1ea1fdb7..ccede81ae 100644--- a/src/application/EnhancedLiteralTracing.ts+++ b/src/application/EnhancedLiteralTracing.ts@@ -1,6 +1,7 @@import { z } from "zod";import type { AnalysisOperation } from "./AnalysisProvider.js";-import { AnalysisOutputError, type AnalysisError } from "../domain/errors.js";+import { AnalysisOutputError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { JsonValue } from "../domain/jsonValue.js";import { err, ok, type Result } from "../domain/result.js";import type {diff --git a/src/application/EnhancedNativeInvestigation.test.ts b/src/application/EnhancedNativeInvestigation.test.tsindex ee1c7308f..5e75de903 100644--- a/src/application/EnhancedNativeInvestigation.test.ts+++ b/src/application/EnhancedNativeInvestigation.test.ts@@ -8,7 +8,11 @@ import {type AnalysisExecution,type AnalysisOperation,} from "./AnalysisProvider.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";+import {+ AnalysisCancelledError,+ AnalysisCapabilityUnavailableError,+} from "../domain/analysisErrorCore.js";import { EnhancedTools } from "./EnhancedTools.js";import {nativeInvestigationGraphSchema,@@ -16,10 +20,6 @@ import {} from "../domain/nativeInvestigationGraph.js";import { err, ok } from "../domain/result.js";import type { Result } from "../domain/result.js";-import {- AnalysisCancelledError,- AnalysisCapabilityUnavailableError,-} from "../domain/errors.js";const target = "a".repeat(64);const provider = { id: "fixture", name: "Fixture", version: "1" };diff --git a/src/application/EnhancedToolTypes.ts b/src/application/EnhancedToolTypes.tsindex 32498eca4..05cad4303 100644--- a/src/application/EnhancedToolTypes.ts+++ b/src/application/EnhancedToolTypes.ts@@ -1,6 +1,7 @@import type { z } from "zod";-import { AnalysisInputError, type AnalysisError } from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { JsonValue } from "../domain/jsonValue.js";import { err, type Result } from "../domain/result.js";import {diff --git a/src/application/EnhancedTools.ts b/src/application/EnhancedTools.tsindex b4e774cd8..fa758d19f 100644--- a/src/application/EnhancedTools.ts+++ b/src/application/EnhancedTools.ts@@ -9,9 +9,9 @@ import { enhancedInputSchemas } from "../contracts/enhancedInputs.js";import {AnalysisCancelledError,AnalysisOutputError,- projectAnalysisError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import {addressDistance,functionDossierSchema,diff --git a/src/application/EvidenceBundleCommands.ts b/src/application/EvidenceBundleCommands.tsindex d24c00dc6..33fce9bbc 100644--- a/src/application/EvidenceBundleCommands.ts+++ b/src/application/EvidenceBundleCommands.ts@@ -1,7 +1,5 @@-import {- EvidenceIntegrityError,- type AnalysisError,-} from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { EvidenceBundle } from "../domain/evidenceBundle.js";import type { JsonValue } from "../domain/jsonValue.js";import { jsonValueSchema } from "../domain/jsonValue.js";diff --git a/src/application/EvidenceBundleFiles.ts b/src/application/EvidenceBundleFiles.tsindex 35a478dc6..cf59d4109 100644--- a/src/application/EvidenceBundleFiles.ts+++ b/src/application/EvidenceBundleFiles.ts@@ -3,7 +3,10 @@ import {serializeEvidenceBundle,type EvidenceBundle,} from "../domain/evidenceBundle.js";-import { EvidenceFileError, EvidenceIntegrityError } from "../domain/errors.js";+import {+ EvidenceFileError,+ EvidenceIntegrityError,+} from "../domain/evidenceErrors.js";import { err, ok, type Result } from "../domain/result.js";import { parseProcessCapture } from "../domain/processCapture.js";import { readJsonFile, writeTextFile } from "./JsonFiles.js";diff --git a/src/application/EvidenceLedger.ts b/src/application/EvidenceLedger.tsindex e8c570ff5..b8b9cfb1c 100644--- a/src/application/EvidenceLedger.ts+++ b/src/application/EvidenceLedger.ts@@ -6,10 +6,8 @@ import {validateResidualUnknownAddition,type EvidenceBundle,} from "../domain/evidenceBundle.js";-import {- EvidenceIntegrityError,- UnknownRegistryError,-} from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { UnknownRegistryError } from "../domain/unknownRegistryError.js";import { parseEvidence, type Evidence } from "../domain/evidence.js";import {createResidualUnknown,diff --git a/src/application/InventoryProjectionEvidence.ts b/src/application/InventoryProjectionEvidence.tsindex a51d3fdde..40d22de24 100644--- a/src/application/InventoryProjectionEvidence.ts+++ b/src/application/InventoryProjectionEvidence.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import {createEvidence,type Evidence,diff --git a/src/application/JavaScriptApplicationService.ts b/src/application/JavaScriptApplicationService.tsindex fb71bce1b..8e51a6d0f 100644--- a/src/application/JavaScriptApplicationService.ts+++ b/src/application/JavaScriptApplicationService.ts@@ -8,9 +8,9 @@ import {import {AnalysisInputError,AnalysisProtocolError,- ArtifactOperationError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { ArtifactOperationError } from "../domain/artifactOperationError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import { projectInputIssues } from "../domain/inputIssueProjection.js";import { err, ok, type Result } from "../domain/result.js";diff --git a/src/application/JavaScriptApplicationWorkflowService.ts b/src/application/JavaScriptApplicationWorkflowService.tsindex 6a48d9d10..d01a2497c 100644--- a/src/application/JavaScriptApplicationWorkflowService.ts+++ b/src/application/JavaScriptApplicationWorkflowService.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import { projectInputIssues } from "../domain/inputIssueProjection.js";import { compareJavaScriptApplicationVersions } from "../domain/javascriptApplicationVersionComparison.js";diff --git a/src/application/JavaScriptRuntimeObservationPort.ts b/src/application/JavaScriptRuntimeObservationPort.tsindex 7bb3cfec2..5772cbce0 100644--- a/src/application/JavaScriptRuntimeObservationPort.ts+++ b/src/application/JavaScriptRuntimeObservationPort.ts@@ -5,7 +5,7 @@ import type {ListJavaScriptRuntimeTargetsInput,ObserveJavaScriptRuntimeInput,} from "../domain/javascriptRuntimeObservation.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Result } from "../domain/result.js";/** Provider-neutral boundary for passive Node/Electron Inspector observation. */diff --git a/src/application/JavaScriptRuntimeObservationService.ts b/src/application/JavaScriptRuntimeObservationService.tsindex b3d991f44..486a366a8 100644--- a/src/application/JavaScriptRuntimeObservationService.ts+++ b/src/application/JavaScriptRuntimeObservationService.ts@@ -2,10 +2,8 @@ import type { ExecutionOptions } from "./AnalysisProvider.js";import type { JavaScriptRuntimeObservationPort } from "./JavaScriptRuntimeObservationPort.js";import { createJavaScriptRuntimeObservationEvidence } from "./JavaScriptRuntimeObservationEvidence.js";import type { Evidence } from "../domain/evidence.js";-import {- AnalysisCapabilityUnavailableError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type {ListJavaScriptRuntimeTargetsInput,ObserveJavaScriptRuntimeInput,diff --git a/src/application/JavaScriptRuntimeReconciliationService.ts b/src/application/JavaScriptRuntimeReconciliationService.tsindex 5af941acb..72e5e5992 100644--- a/src/application/JavaScriptRuntimeReconciliationService.ts+++ b/src/application/JavaScriptRuntimeReconciliationService.ts@@ -4,8 +4,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import { projectInputIssues } from "../domain/inputIssueProjection.js";import { reconcileJavaScriptRuntime } from "../domain/javascriptRuntimeReconciliation.js";diff --git a/src/application/JavaScriptSemanticTraceService.ts b/src/application/JavaScriptSemanticTraceService.tsindex baa5f54ac..cfab1ddb4 100644--- a/src/application/JavaScriptSemanticTraceService.ts+++ b/src/application/JavaScriptSemanticTraceService.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import { jsonValueSchema } from "../domain/jsonValue.js";import { queryJavaScriptSemanticGraph } from "../domain/javascriptSemanticQuery.js";diff --git a/src/application/JsonFiles.ts b/src/application/JsonFiles.tsindex ca8ff6771..23a3514dd 100644--- a/src/application/JsonFiles.ts+++ b/src/application/JsonFiles.ts@@ -3,7 +3,7 @@ import { basename, dirname, resolve } from "node:path";import writeFileAtomic from "write-file-atomic";-import { EvidenceFileError } from "../domain/errors.js";+import { EvidenceFileError } from "../domain/evidenceErrors.js";import { err, ok, type Result } from "../domain/result.js";/** Read JSON data from a regular file at the caller-supplied path. */diff --git a/src/application/LazyAnalysisProvider.test.ts b/src/application/LazyAnalysisProvider.test.tsindex 36ee32fe9..0808ac1b0 100644--- a/src/application/LazyAnalysisProvider.test.ts+++ b/src/application/LazyAnalysisProvider.test.ts@@ -3,7 +3,7 @@ import { expect, it } from "vitest";import { parseBinaryTarget } from "./BinaryTargetResolver.js";import type { AnalysisProvider, ProviderIdentity } from "./AnalysisProvider.js";import { LazyAnalysisProvider } from "./LazyAnalysisProvider.js";-import { AnalysisCancelledError } from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";import { err } from "../domain/result.js";const identity: ProviderIdentity = {diff --git a/src/application/LazyAnalysisProvider.ts b/src/application/LazyAnalysisProvider.tsindex 0d9426eb5..1cdc3b9c8 100644--- a/src/application/LazyAnalysisProvider.ts+++ b/src/application/LazyAnalysisProvider.ts@@ -1,10 +1,8 @@import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import {- AnalysisCancelledError,- AnalysisError,- ProviderAdapterError,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";import { err } from "../domain/result.js";import { ABORTED, waitForAbortable } from "./AbortablePromise.js";import type {diff --git a/src/application/ManagedApplicationGraphService.ts b/src/application/ManagedApplicationGraphService.tsindex 97de9a545..9bd42fe6a 100644--- a/src/application/ManagedApplicationGraphService.ts+++ b/src/application/ManagedApplicationGraphService.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { createEvidence, type Evidence } from "../domain/evidence.js";import { jsonValueSchema } from "../domain/jsonValue.js";import {diff --git a/src/application/ManagedMemberComparisonService.ts b/src/application/ManagedMemberComparisonService.tsindex 8933316e0..47426a909 100644--- a/src/application/ManagedMemberComparisonService.ts+++ b/src/application/ManagedMemberComparisonService.ts@@ -12,9 +12,9 @@ import {import {AnalysisInputError,AnalysisProtocolError,- EvidenceIntegrityError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { createEvidence, type Evidence } from "../domain/evidence.js";import { jsonValueSchema } from "../domain/jsonValue.js";import { parseBinaryTarget } from "./BinaryTargetResolver.js";diff --git a/src/application/ManagedNativeVerificationService.ts b/src/application/ManagedNativeVerificationService.tsindex c1b9cd6e0..63ddc799c 100644--- a/src/application/ManagedNativeVerificationService.ts+++ b/src/application/ManagedNativeVerificationService.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { createEvidence, type Evidence } from "../domain/evidence.js";import { jsonValueSchema } from "../domain/jsonValue.js";import {diff --git a/src/application/ManagedReconstructionService.ts b/src/application/ManagedReconstructionService.tsindex 6d6c48eed..e28527197 100644--- a/src/application/ManagedReconstructionService.ts+++ b/src/application/ManagedReconstructionService.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { createEvidence, type Evidence } from "../domain/evidence.js";import { jsonValueSchema } from "../domain/jsonValue.js";import {diff --git a/src/application/NativeCallRoutes.test.ts b/src/application/NativeCallRoutes.test.tsindex daf68a1e4..d23921873 100644--- a/src/application/NativeCallRoutes.test.ts+++ b/src/application/NativeCallRoutes.test.ts@@ -4,7 +4,7 @@ import { createAnalysisExecution } from "./AnalysisProvider.js";import { ghidraReferenceEdge } from "../domain/ghidraValues.fixture.js";import { jsonValueSchema } from "../domain/jsonValue.js";import { err, ok } from "../domain/result.js";-import { AnalysisCancelledError } from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";const provider = { id: "fixture", name: "Fixture", version: "1" };describe("typed native call routes", () => {diff --git a/src/application/NativeCallRoutes.ts b/src/application/NativeCallRoutes.tsindex 4ff1e9427..8ac1bcd4f 100644--- a/src/application/NativeCallRoutes.ts+++ b/src/application/NativeCallRoutes.ts@@ -5,7 +5,7 @@ import {referenceKindSchema,} from "../domain/hopperValues.js";import { err, ok } from "../domain/result.js";-import { AnalysisOutputError } from "../domain/errors.js";+import { AnalysisOutputError } from "../domain/analysisErrorCore.js";const referencesSchema = z.object({reference_kinds_available: z.boolean().optional(),diff --git a/src/application/NativeDispatchMetadataInspection.ts b/src/application/NativeDispatchMetadataInspection.tsindex a4340ebb8..8f2ea0dbd 100644--- a/src/application/NativeDispatchMetadataInspection.ts+++ b/src/application/NativeDispatchMetadataInspection.ts@@ -3,7 +3,7 @@ import {nativeDispatchMetadataResultSchema,inspectNativeDispatchMetadata,} from "../domain/objcSwiftMetadata.js";-import { AnalysisOutputError } from "../domain/errors.js";+import { AnalysisOutputError } from "../domain/analysisErrorCore.js";import { jsonValueSchema } from "../domain/jsonValue.js";import { err, ok } from "../domain/result.js";import type { AnalysisOperationPort } from "./AnalysisProvider.js";diff --git a/src/application/NativeUiActionTrace.ts b/src/application/NativeUiActionTrace.tsindex d59af5b5c..f94051a12 100644--- a/src/application/NativeUiActionTrace.ts+++ b/src/application/NativeUiActionTrace.ts@@ -15,7 +15,8 @@ import { inspectNativeDispatch } from "./NativeDispatchMetadataInspection.js";import { jsonValueSchema } from "../domain/jsonValue.js";import { readNativeCallRoutes } from "./NativeCallRoutes.js";import { err, ok } from "../domain/result.js";-import { AnalysisOutputError, projectAnalysisError } from "../domain/errors.js";+import { AnalysisOutputError } from "../domain/analysisErrorCore.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";type Input = z.output<typeof enhancedInputSchemas.trace_native_ui_action>;/** Build a UI-to-code trace from the active app and selected native provider. */diff --git a/src/application/NativeValueTrace.test.ts b/src/application/NativeValueTrace.test.tsindex 3c403a359..2d4d0e08a 100644--- a/src/application/NativeValueTrace.test.ts+++ b/src/application/NativeValueTrace.test.ts@@ -7,7 +7,7 @@ import {import { ghidraFunctionDossier } from "../domain/ghidraValues.fixture.js";import { functionDossierSchema } from "../domain/hopperValues.js";import { jsonValueSchema } from "../domain/jsonValue.js";-import { AnalysisCancelledError } from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";import { ok, err } from "../domain/result.js";const subject = {diff --git a/src/application/NativeValueTrace.ts b/src/application/NativeValueTrace.tsindex 39163e221..9da1db7ce 100644--- a/src/application/NativeValueTrace.ts+++ b/src/application/NativeValueTrace.ts@@ -8,7 +8,7 @@ import { createEvidence } from "../domain/evidence.js";import {AnalysisCancelledError,AnalysisOutputError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";import { err, ok } from "../domain/result.js";import type { AnalysisOperationPort } from "./AnalysisProvider.js";import type { EnhancedResult } from "./EnhancedToolTypes.js";diff --git a/src/application/ProcessCaptureError.test.ts b/src/application/ProcessCaptureError.test.tsindex 0156484c1..3dedc4260 100644--- a/src/application/ProcessCaptureError.test.ts+++ b/src/application/ProcessCaptureError.test.ts@@ -1,6 +1,6 @@import { describe, expect, it } from "vitest";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import {ProcessCaptureError,processCaptureCancelled,diff --git a/src/application/ProcessCaptureError.ts b/src/application/ProcessCaptureError.tsindex bb1f32144..da57679ab 100644--- a/src/application/ProcessCaptureError.ts+++ b/src/application/ProcessCaptureError.ts@@ -1,4 +1,4 @@-import { AnalysisError } from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";interface ProcessCaptureErrorOptions extends ErrorOptions {readonly userMessage?: string;diff --git a/src/application/ProcessCli.ts b/src/application/ProcessCli.tsindex 4f3ebbe94..eb5af8c80 100644--- a/src/application/ProcessCli.ts+++ b/src/application/ProcessCli.ts@@ -1,10 +1,8 @@import { readFile } from "node:fs/promises";-import {- AnalysisError,- AnalysisInputError,- projectAnalysisError,-} from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import { createEvidence, parseEvidence } from "../domain/evidence.js";import { jsonValueSchema } from "../domain/jsonValue.js";import { projectInputIssues } from "../domain/inputIssueProjection.js";diff --git a/src/application/ProcessHarness.test.ts b/src/application/ProcessHarness.test.tsindex fe96c8194..0f62497c1 100644--- a/src/application/ProcessHarness.test.ts+++ b/src/application/ProcessHarness.test.ts@@ -1,6 +1,6 @@import { expect, it } from "vitest";import { processScenarioSchema } from "../domain/processScenario.js";-import { AnalysisCapabilityUnavailableError } from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";import { captureProcessScenario } from "./ProcessHarness.js";import { settleProcessCaptureJournal } from "./ProcessCaptureLifecycle.js";import { processCaptureSchema } from "../domain/processCapture.js";diff --git a/src/application/ProcessHarness.ts b/src/application/ProcessHarness.tsindex b162c918d..4ea9c8279 100644--- a/src/application/ProcessHarness.ts+++ b/src/application/ProcessHarness.ts@@ -11,10 +11,8 @@ import type {} from "../domain/processCapture.js";import { parseProcessCapture } from "../domain/processCapture.js";import { err, ok, type Result } from "../domain/result.js";-import {- AnalysisCapabilityUnavailableError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import {ProcessCaptureError,processCaptureCancelled,diff --git a/src/application/ReconstructionCoverageService.ts b/src/application/ReconstructionCoverageService.tsindex f4ac172d5..5706b008e 100644--- a/src/application/ReconstructionCoverageService.ts+++ b/src/application/ReconstructionCoverageService.ts@@ -1,6 +1,7 @@import { z } from "zod";-import { AnalysisInputError, type AnalysisError } from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import {evaluateReconstructionClosure,reconstructionCoverageDataSchema,diff --git a/src/application/ReconstructionObligationLedgerService.ts b/src/application/ReconstructionObligationLedgerService.tsindex 64f667ab6..2b4c9a50d 100644--- a/src/application/ReconstructionObligationLedgerService.ts+++ b/src/application/ReconstructionObligationLedgerService.ts@@ -3,8 +3,8 @@ import { z } from "zod";import {AnalysisInputError,AnalysisProtocolError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { createEvidence, type Evidence } from "../domain/evidence.js";import { jsonObjectSchema, jsonValueSchema } from "../domain/jsonValue.js";import {diff --git a/src/application/SessionProviderRouter.ts b/src/application/SessionProviderRouter.tsindex fbfd7fd65..936bb5438 100644--- a/src/application/SessionProviderRouter.ts+++ b/src/application/SessionProviderRouter.ts@@ -7,10 +7,10 @@ import type { BinaryTarget } from "../domain/binaryTarget.js";import {AnalysisCancelledError,AnalysisCapabilityUnavailableError,- ProviderAdapterError,- ProviderSelectionError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { ProviderSelectionError } from "../domain/providerSelectionError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { jsonObjectSchema, type JsonValue } from "../domain/jsonValue.js";import { err, ok, type Result } from "../domain/result.js";import type {diff --git a/src/artifacts/ArtifactProvider.ts b/src/artifacts/ArtifactProvider.tsindex ad4a458fd..e095d0dfe 100644--- a/src/artifacts/ArtifactProvider.ts+++ b/src/artifacts/ArtifactProvider.ts@@ -20,11 +20,9 @@ import {type ArtifactAnalysisOperation,} from "../contracts/artifactToolContracts.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import {- AnalysisCapabilityUnavailableError,- ArtifactOperationError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";+import { ArtifactOperationError } from "../domain/artifactOperationError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { JsonValue } from "../domain/jsonValue.js";import { interfaceBuilderLimitsSchema } from "../domain/interfaceBuilderGraph.js";import { err, ok } from "../domain/result.js";diff --git a/src/browser/CdpAuthorizedMainFrame.ts b/src/browser/CdpAuthorizedMainFrame.tsindex 33e0adc6c..dc869f56c 100644--- a/src/browser/CdpAuthorizedMainFrame.ts+++ b/src/browser/CdpAuthorizedMainFrame.ts@@ -1,5 +1,5 @@import type { BrowserObservationOperation } from "../domain/browserObservationErrors.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import type { CdpConnection } from "./CdpConnection.js";import { mainFrameUrl } from "./CdpCaptureDocuments.js";import {diff --git a/src/browser/CdpBrowserProvider.ts b/src/browser/CdpBrowserProvider.tsindex c8129d978..de37f524e 100644--- a/src/browser/CdpBrowserProvider.ts+++ b/src/browser/CdpBrowserProvider.ts@@ -40,12 +40,10 @@ import {type WebScreenshot,type WebScreenshotDiff,} from "../domain/webScreenshot.js";-import {- AnalysisError,- BrowserObservationError,- ProviderAdapterError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { err, ok, type Result } from "../domain/result.js";import {discoverCdpEndpoint,diff --git a/src/browser/CdpCaptureValues.ts b/src/browser/CdpCaptureValues.tsindex 3d0e7c5d2..e0cb122fe 100644--- a/src/browser/CdpCaptureValues.ts+++ b/src/browser/CdpCaptureValues.ts@@ -1,8 +1,6 @@-import {- AnalysisCancelledError,- BrowserObservationError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { sanitizeBrowserUrl } from "../domain/browserObservation.js";import { createWebTextArtifact } from "../domain/webContentArtifact.js";diff --git a/src/browser/CdpConnection.ts b/src/browser/CdpConnection.tsindex 3ed527513..5a363c48b 100644--- a/src/browser/CdpConnection.ts+++ b/src/browser/CdpConnection.ts@@ -1,11 +1,9 @@import WebSocket, { type RawData } from "ws";-import {- AnalysisCancelledError,- AnalysisError,- BrowserObservationError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { safeParseJson } from "../domain/safeJson.js";export interface CdpEvent {diff --git a/src/browser/CdpElectronInspection.ts b/src/browser/CdpElectronInspection.tsindex ab50e5918..9851909e3 100644--- a/src/browser/CdpElectronInspection.ts+++ b/src/browser/CdpElectronInspection.ts@@ -4,7 +4,7 @@ import type {ElectronPageInspection,InspectElectronPageInput,} from "../domain/electronObservation.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import type { CdpConnection, CdpEvent } from "./CdpConnection.js";import type { CdpEndpointDiscovery, CdpEndpointTarget } from "./CdpEndpoint.js";import { CdpCaptureCompleteness } from "./CdpCaptureCompleteness.js";diff --git a/src/browser/CdpElectronProvider.ts b/src/browser/CdpElectronProvider.tsindex efc8beaec..088bf29a3 100644--- a/src/browser/CdpElectronProvider.ts+++ b/src/browser/CdpElectronProvider.ts@@ -11,12 +11,10 @@ import {type InspectElectronPageInput,type ListElectronTargetsInput,} from "../domain/electronObservation.js";-import {- AnalysisError,- BrowserObservationError,- ProviderAdapterError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { err, ok, type Result } from "../domain/result.js";import {discoverCdpEndpoint,diff --git a/src/browser/CdpEndpoint.ts b/src/browser/CdpEndpoint.tsindex a208f9ba7..b95711c32 100644--- a/src/browser/CdpEndpoint.ts+++ b/src/browser/CdpEndpoint.ts@@ -2,12 +2,10 @@ import { request } from "node:http";import { z } from "zod";-import {- AnalysisCancelledError,- AnalysisError,- BrowserObservationError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { sanitizeBrowserUrl } from "../domain/browserObservation.js";import { safeParseJson } from "../domain/safeJson.js";diff --git a/src/browser/CdpObservationSession.ts b/src/browser/CdpObservationSession.tsindex b98103d49..0ba238912 100644--- a/src/browser/CdpObservationSession.ts+++ b/src/browser/CdpObservationSession.ts@@ -3,10 +3,8 @@ import type {ObserveWebSessionInput,WebObservationSession,} from "../domain/browserSession.js";-import {- AnalysisCancelledError,- BrowserObservationError,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import type { CdpEndpointDiscovery, CdpEndpointTarget } from "./CdpEndpoint.js";import { CdpConnection, type CdpEvent } from "./CdpConnection.js";import { CdpCaptureCompleteness } from "./CdpCaptureCompleteness.js";diff --git a/src/browser/CdpOptionalCommand.ts b/src/browser/CdpOptionalCommand.tsindex 240c3d338..b02b2f78f 100644--- a/src/browser/CdpOptionalCommand.ts+++ b/src/browser/CdpOptionalCommand.ts@@ -1,4 +1,4 @@-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import { CdpConnection } from "./CdpConnection.js";/** Execute an optional CDP method while preserving transport and cancellation failures. */diff --git a/src/browser/CdpPageCapture.ts b/src/browser/CdpPageCapture.tsindex 2789fbde6..e1914b55a 100644--- a/src/browser/CdpPageCapture.ts+++ b/src/browser/CdpPageCapture.ts@@ -3,10 +3,8 @@ import type {WebPageInspection,} from "../domain/browserObservation.js";import type { ProgressReporter } from "../application/ProgressReporter.js";-import {- BrowserObservationError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { stableWebResources } from "../domain/webInventory.js";import type { CdpEndpointDiscovery, CdpEndpointTarget } from "./CdpEndpoint.js";import { CdpConnection } from "./CdpConnection.js";diff --git a/src/browser/CdpScreenshot.ts b/src/browser/CdpScreenshot.tsindex 54c3278da..19b5ad91e 100644--- a/src/browser/CdpScreenshot.ts+++ b/src/browser/CdpScreenshot.ts@@ -4,7 +4,7 @@ import type {WebScreenshot,} from "../domain/webScreenshot.js";import { createWebScreenshotArtifact } from "../domain/webScreenshot.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import { isMainFrameNavigation } from "./CdpCaptureEventHelpers.js";import type { CdpEndpointDiscovery, CdpEndpointTarget } from "./CdpEndpoint.js";import type { CdpConnection, CdpEvent } from "./CdpConnection.js";diff --git a/src/browser/CdpTargetSession.ts b/src/browser/CdpTargetSession.tsindex 71542f41c..9983f3765 100644--- a/src/browser/CdpTargetSession.ts+++ b/src/browser/CdpTargetSession.ts@@ -1,7 +1,5 @@-import {- BrowserObservationError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { CdpConnection } from "./CdpConnection.js";import {cdpTargetWebSocket,diff --git a/src/browser/CdpWebMcpDiscovery.ts b/src/browser/CdpWebMcpDiscovery.tsindex 6d3dd686b..ddbc6fabf 100644--- a/src/browser/CdpWebMcpDiscovery.ts+++ b/src/browser/CdpWebMcpDiscovery.ts@@ -9,7 +9,7 @@ import { inferJsonShape } from "../domain/jsonShape.js";import type { CdpEndpointDiscovery, CdpEndpointTarget } from "./CdpEndpoint.js";import type { CdpConnection, CdpEvent } from "./CdpConnection.js";import { CdpCaptureCompleteness } from "./CdpCaptureCompleteness.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import {allowedSanitizedUrl,delayWithCancellation,diff --git a/src/browser/PlaywrightBrowserScenarioProvider.ts b/src/browser/PlaywrightBrowserScenarioProvider.tsindex 71b602698..909210f3e 100644--- a/src/browser/PlaywrightBrowserScenarioProvider.ts+++ b/src/browser/PlaywrightBrowserScenarioProvider.ts@@ -19,11 +19,9 @@ import {type BrowserScenarioStepOutcome,type BrowserStepArtifacts,} from "../domain/browserScenarioCapture.js";-import {- AnalysisError,- BrowserObservationError,- ProviderAdapterError,-} from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";import { err, ok, type Result } from "../domain/result.js";import type {BrowserScenarioSessionFactory,diff --git a/src/browser/PlaywrightElectronActiveActions.ts b/src/browser/PlaywrightElectronActiveActions.tsindex 86ab89dfc..7f4a953ff 100644--- a/src/browser/PlaywrightElectronActiveActions.ts+++ b/src/browser/PlaywrightElectronActiveActions.ts@@ -2,7 +2,7 @@ import type { ElectronApplication, Page } from "playwright-core";import { z } from "zod";import type { ExecutionOptions } from "../application/AnalysisProvider.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import type {ElectronActiveObservationInput,ElectronActiveObservationResult,diff --git a/src/browser/PlaywrightElectronActiveProvider.ts b/src/browser/PlaywrightElectronActiveProvider.tsindex ab20ae7a0..88850ee23 100644--- a/src/browser/PlaywrightElectronActiveProvider.ts+++ b/src/browser/PlaywrightElectronActiveProvider.ts@@ -15,11 +15,9 @@ import {type ElectronActiveObservationInput,type ElectronActiveObservationResult,} from "../domain/electronActiveObservation.js";-import {- AnalysisError,- BrowserObservationError,- ProviderAdapterError,-} from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";import { err, ok, type Result } from "../domain/result.js";import {cleanupOwnedProcessGroup,diff --git a/src/browser/PlaywrightExecutionBoundary.test.ts b/src/browser/PlaywrightExecutionBoundary.test.tsindex f9cfe9c5d..323b4506c 100644--- a/src/browser/PlaywrightExecutionBoundary.test.ts+++ b/src/browser/PlaywrightExecutionBoundary.test.ts@@ -4,7 +4,7 @@ import { withPlaywrightExecutionBoundary } from "./PlaywrightExecutionBoundary.jimport {AnalysisCancelledError,AnalysisTimeoutError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";describe("withPlaywrightExecutionBoundary", () => {afterEach(() => vi.useRealTimers());diff --git a/src/browser/PlaywrightExecutionBoundary.ts b/src/browser/PlaywrightExecutionBoundary.tsindex 4adde394a..9fd21fcf3 100644--- a/src/browser/PlaywrightExecutionBoundary.ts+++ b/src/browser/PlaywrightExecutionBoundary.ts@@ -1,7 +1,7 @@import {AnalysisCancelledError,AnalysisTimeoutError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";const OPERATION = "capture_browser_scenario" as const;diff --git a/src/browser/PlaywrightScenarioBrowser.ts b/src/browser/PlaywrightScenarioBrowser.tsindex 7719e1d00..b89d99e99 100644--- a/src/browser/PlaywrightScenarioBrowser.ts+++ b/src/browser/PlaywrightScenarioBrowser.ts@@ -10,7 +10,7 @@ import {} from "playwright-core";import type { BrowserScenario } from "../domain/browserScenario.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import { withPlaywrightExecutionBoundary } from "./PlaywrightExecutionBoundary.js";const OPERATION = "capture_browser_scenario" as const;diff --git a/src/browser/PlaywrightScenarioSession.ts b/src/browser/PlaywrightScenarioSession.tsindex a87c09a47..8ca64e036 100644--- a/src/browser/PlaywrightScenarioSession.ts+++ b/src/browser/PlaywrightScenarioSession.ts@@ -4,7 +4,7 @@ import type {BrowserScenario,BrowserScenarioAction,} from "../domain/browserScenario.js";-import { BrowserObservationError } from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";import type {BrowserScenarioSessionFactory,BrowserScenarioSessionPort,diff --git a/src/browser/V8InspectorEndpoint.ts b/src/browser/V8InspectorEndpoint.tsindex 42dc209da..481cc1594 100644--- a/src/browser/V8InspectorEndpoint.ts+++ b/src/browser/V8InspectorEndpoint.ts@@ -4,10 +4,8 @@ import type {JavaScriptRuntimeTargetList,JavaScriptRuntimeTargetLocation,} from "../domain/javascriptRuntimeObservation.js";-import {- BrowserObservationError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { parseCdpEndpointValue, readCdpJson } from "./CdpEndpoint.js";const versionSchema = zdiff --git a/src/browser/V8InspectorProvider.ts b/src/browser/V8InspectorProvider.tsindex d846f9622..a6f957edf 100644--- a/src/browser/V8InspectorProvider.ts+++ b/src/browser/V8InspectorProvider.ts@@ -11,12 +11,10 @@ import {type ListJavaScriptRuntimeTargetsInput,type ObserveJavaScriptRuntimeInput,} from "../domain/javascriptRuntimeObservation.js";-import {- AnalysisError,- BrowserObservationError,- ProviderAdapterError,- type BrowserObservationOperation,-} from "../domain/errors.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";+import { BrowserObservationError } from "../domain/browserObservationError.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type BrowserObservationOperation } from "../domain/browserObservationErrors.js";import { err, ok, type Result } from "../domain/result.js";import {numberValue,diff --git a/src/cli/applicationCommands.ts b/src/cli/applicationCommands.tsindex cc11b458d..68aed7911 100644--- a/src/cli/applicationCommands.ts+++ b/src/cli/applicationCommands.ts@@ -15,11 +15,9 @@ import { buildReconstructionObligationLedgerEvidenceValidated } from "../applicaimport { CLI_COMMANDS } from "../cliCommandNames.js";import { parseCliJsonInput } from "../cliJsonInput.js";import { logCliCommand } from "../cliLogging.js";-import {- AnalysisInputError,- projectAnalysisError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { jsonValueSchema, type JsonValue } from "../domain/jsonValue.js";import type { Logger } from "../logger.js";import { traceApplicationFeatureInputSchema } from "../domain/javascriptFeatureTraceSchemas.js";diff --git a/src/cli/browserAdvancedCommands.ts b/src/cli/browserAdvancedCommands.tsindex b69923086..2d299503f 100644--- a/src/cli/browserAdvancedCommands.ts+++ b/src/cli/browserAdvancedCommands.ts@@ -10,7 +10,7 @@ import {} from "../application/BrowserObservationService.js";import { CdpBrowserProvider } from "../browser/CdpBrowserProvider.js";import { logCliCommand } from "../cliLogging.js";-import { AnalysisInputError } from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";import { browserCaptureComparisonInputSchema } from "../domain/browserCaptureComparison.js";import { discoverWebMcpToolsInputSchema } from "../domain/webMcpDiscovery.js";import {diff --git a/src/cli/browserCommands.ts b/src/cli/browserCommands.tsindex eb7b01827..e06e0498d 100644--- a/src/cli/browserCommands.ts+++ b/src/cli/browserCommands.ts@@ -14,7 +14,7 @@ import {} from "../domain/browserObservation.js";import { analyzeWebBundleInputSchema } from "../domain/webBundleAnalysis.js";import { observeWebSessionInputSchema } from "../domain/browserSession.js";-import { AnalysisInputError } from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";import type { Logger } from "../logger.js";import { CLI_COMMANDS } from "../cliCommandNames.js";import {diff --git a/src/cli/electronCommands.ts b/src/cli/electronCommands.tsindex 277246750..899cd0b9a 100644--- a/src/cli/electronCommands.ts+++ b/src/cli/electronCommands.ts@@ -14,7 +14,8 @@ import {listElectronTargetsInputSchema,} from "../domain/electronObservation.js";import { electronActiveObservationInputSchema } from "../domain/electronActiveObservation.js";-import { AnalysisInputError, projectAnalysisError } from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import type { JsonValue } from "../domain/jsonValue.js";import type { Logger } from "../logger.js";import { CLI_COMMANDS } from "../cliCommandNames.js";diff --git a/src/cli/javascriptApplicationAnalysis.ts b/src/cli/javascriptApplicationAnalysis.tsindex baf861db6..30a680e64 100644--- a/src/cli/javascriptApplicationAnalysis.ts+++ b/src/cli/javascriptApplicationAnalysis.ts@@ -1,5 +1,5 @@import { analyzeJavaScriptApplication } from "../application/JavaScriptApplicationService.js";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import type { JsonValue } from "../domain/jsonValue.js";/** Execute the shared one-shot CLI boundary for static JavaScript analysis. */diff --git a/src/cli/managedCommands.ts b/src/cli/managedCommands.tsindex ca6791d39..f1c65b107 100644--- a/src/cli/managedCommands.ts+++ b/src/cli/managedCommands.ts@@ -5,7 +5,7 @@ import { verifyManagedNativeBoundariesEvidence } from "../application/ManagedNatimport { importManagedReconstructionEvidence } from "../application/ManagedReconstructionService.js";import { runProviderAnalysis } from "../application/DirectAnalysis.js";import { parseCliJsonInput } from "../cliJsonInput.js";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import { CLI_COMMANDS } from "../cliCommandNames.js";import { logCliCommand } from "../cliLogging.js";import type { Logger } from "../logger.js";diff --git a/src/cli/managedProjectGraphCommand.ts b/src/cli/managedProjectGraphCommand.tsindex 8c89794eb..d41d99d99 100644--- a/src/cli/managedProjectGraphCommand.ts+++ b/src/cli/managedProjectGraphCommand.ts@@ -4,7 +4,7 @@ import { projectManagedApplicationGraphEvidence } from "../application/ManagedApimport { CLI_COMMANDS } from "../cliCommandNames.js";import { parseCliJsonInput } from "../cliJsonInput.js";import { logCliCommand } from "../cliLogging.js";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import type { Logger } from "../logger.js";import type { CliInstance } from "./types.js";diff --git a/src/cli/utilityCommands.ts b/src/cli/utilityCommands.tsindex 372a97c98..d5ee22407 100644--- a/src/cli/utilityCommands.ts+++ b/src/cli/utilityCommands.ts@@ -9,7 +9,7 @@ import {import { importReferenceSource } from "../application/ReferenceSourceImport.js";import { projectReferenceSourceImportError } from "../application/ReferenceSourceImportTypes.js";import { parseConfig } from "../config.js";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";import { PRODUCT_IDENTITY } from "../identity.js";import { logCliCommand } from "../cliLogging.js";import { CLI_COMMANDS } from "../cliCommandNames.js";diff --git a/src/cliBrowserContext.ts b/src/cliBrowserContext.tsindex b9baa895f..85bbe155d 100644--- a/src/cliBrowserContext.ts+++ b/src/cliBrowserContext.ts@@ -1,5 +1,5 @@import { CdpBrowserProvider } from "./browser/CdpBrowserProvider.js";-import { projectAnalysisError } from "./domain/errors.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";import type { JsonValue } from "./domain/jsonValue.js";/** Build the passive browser provider; scope is supplied on each request. */diff --git a/src/cliBrowserScenarioCommands.ts b/src/cliBrowserScenarioCommands.tsindex 5ac21842d..fbf11ae5c 100644--- a/src/cliBrowserScenarioCommands.ts+++ b/src/cliBrowserScenarioCommands.ts@@ -6,7 +6,8 @@ import { PlaywrightBrowserScenarioProvider } from "./browser/PlaywrightBrowserScimport { CLI_COMMANDS } from "./cliCommandNames.js";import { parseCliJsonInput } from "./cliJsonInput.js";import { logCliCommand } from "./cliLogging.js";-import { AnalysisInputError, projectAnalysisError } from "./domain/errors.js";+import { AnalysisInputError } from "./domain/analysisErrorCore.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";import { browserScenarioSchema } from "./domain/browserScenario.js";import type { JsonValue } from "./domain/jsonValue.js";import type { Logger } from "./logger.js";diff --git a/src/cliEvidenceCommands.ts b/src/cliEvidenceCommands.tsindex 75557969d..acf8658a2 100644--- a/src/cliEvidenceCommands.ts+++ b/src/cliEvidenceCommands.ts@@ -9,7 +9,8 @@ import { logCliCommand } from "./cliLogging.js";import type { Logger } from "./logger.js";import { CLI_COMMANDS } from "./cliCommandNames.js";import type { JsonValue } from "./domain/jsonValue.js";-import { projectAnalysisError, type AnalysisError } from "./domain/errors.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";+import { type AnalysisError } from "./domain/analysisErrorBase.js";/** Register caller-path Evidence commands. */export const registerEvidenceCommands = (diff --git a/src/cliJavaScriptRuntimeCommands.ts b/src/cliJavaScriptRuntimeCommands.tsindex 42ceb8873..342fc751b 100644--- a/src/cliJavaScriptRuntimeCommands.ts+++ b/src/cliJavaScriptRuntimeCommands.ts@@ -12,7 +12,8 @@ import {listJavaScriptRuntimeTargetsInputSchema,observeJavaScriptRuntimeInputSchema,} from "./domain/javascriptRuntimeObservation.js";-import { AnalysisInputError, projectAnalysisError } from "./domain/errors.js";+import { AnalysisInputError } from "./domain/analysisErrorCore.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";import type { JsonValue } from "./domain/jsonValue.js";import type { Logger } from "./logger.js";diff --git a/src/cliJsonInput.ts b/src/cliJsonInput.tsindex 3b89cfc2a..370a2f1b0 100644--- a/src/cliJsonInput.ts+++ b/src/cliJsonInput.ts@@ -1,6 +1,7 @@import { readFile } from "node:fs/promises";-import { AnalysisInputError, projectAnalysisError } from "./domain/errors.js";+import { AnalysisInputError } from "./domain/analysisErrorCore.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";import type { JsonValue } from "./domain/jsonValue.js";import { safeParseJson } from "./domain/safeJson.js";diff --git a/src/cliLogging.test.ts b/src/cliLogging.test.tsindex f8b3a1dbc..c02cb2041 100644--- a/src/cliLogging.test.ts+++ b/src/cliLogging.test.ts@@ -1,10 +1,8 @@import { describe, expect, it } from "vitest";-import {- ArtifactOperationError,- ConfigurationError,- projectAnalysisError,-} from "./domain/errors.js";+import { ArtifactOperationError } from "./domain/artifactOperationError.js";+import { ConfigurationError } from "./domain/configurationErrors.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";import { isCliOperationFailure, logCliCommand } from "./cliLogging.js";import { silentLogger } from "./logger.js";diff --git a/src/cliLogging.ts b/src/cliLogging.tsindex f7e2279bc..6dbb24039 100644--- a/src/cliLogging.ts+++ b/src/cliLogging.ts@@ -2,11 +2,11 @@ import {analysisCliErrorEnvelopeSchema,analysisErrorProjectionSchema,} from "./contracts/errorSchemas.js";+import { AnalysisError } from "./domain/analysisErrorBase.js";import {- AnalysisError,projectAnalysisError,type AnalysisErrorProjection,-} from "./domain/errors.js";+} from "./domain/analysisErrorProjection.js";import type { Logger } from "./logger.js";const isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>diff --git a/src/config/environment.ts b/src/config/environment.tsindex fb73dedb6..0207b7e4c 100644--- a/src/config/environment.ts+++ b/src/config/environment.ts@@ -1,7 +1,7 @@import { z } from "zod";import { isAbsolute } from "node:path";-import { ConfigurationError } from "../domain/errors.js";+import { ConfigurationError } from "../domain/configurationErrors.js";import { err, ok, type Result } from "../domain/result.js";import { analysisProviderSelectorSchema } from "../contracts/providerSelection.js";diff --git a/src/config/parseConfig.ts b/src/config/parseConfig.tsindex 502354917..d0334a619 100644--- a/src/config/parseConfig.ts+++ b/src/config/parseConfig.ts@@ -1,4 +1,4 @@-import { ConfigurationError } from "../domain/errors.js";+import { ConfigurationError } from "../domain/configurationErrors.js";import { ok, type Result } from "../domain/result.js";import { parseEnvironment } from "./environment.js";import { parseStringArray, parseLoaderArgs } from "./parsers.js";diff --git a/src/config/parsers.ts b/src/config/parsers.tsindex 64f373422..41637d513 100644--- a/src/config/parsers.ts+++ b/src/config/parsers.ts@@ -1,6 +1,6 @@import { z } from "zod";-import { ConfigurationError } from "../domain/errors.js";+import { ConfigurationError } from "../domain/configurationErrors.js";import { err, ok, type Result } from "../domain/result.js";export const parseStringArray = (diff --git a/src/domain/analysisErrorBase.ts b/src/domain/analysisErrorBase.tsnew file mode 100644index 000000000..2c423fc3d--- /dev/null+++ b/src/domain/analysisErrorBase.ts@@ -0,0 +1,38 @@+/** Stable tags exposed by safe analysis-error projections. */+const ANALYSIS_ERROR_TAGS = [+ "AnalysisProtocolError",+ "AnalysisInputError",+ "AnalysisOutputError",+ "AnalysisCapabilityUnavailableError",+ "AnalysisCancelledError",+ "AnalysisTimeoutError",+ "ProviderSelectionError",+ "ProviderAdapterError",+ "BrowserObservationError",+ "ArtifactOperationError",+ "ProcessCaptureError",+ "EvidenceIntegrityError",+ "EvidenceFileError",+ "UnknownRegistryError",+ "HopperTimeoutError",+ "HopperCancelledError",+ "HopperProtocolError",+ "HopperRemoteError",+ "HopperProcessError",+ "HopperStartError",+ "ConfigurationError",+ "NoBinaryOpenError",+ "BinaryTargetError",+] as const;++/** Stable tag for an expected analysis failure. */+export type AnalysisErrorTag = (typeof ANALYSIS_ERROR_TAGS)[number];++/** Base class for expected analysis, provider, and session failures. */+export abstract class AnalysisError extends Error {+ abstract readonly _tag: AnalysisErrorTag;+ readonly userMessage: string | undefined = undefined;+ readonly userCategory: "cancelled" | undefined = undefined;+ readonly cleanupIncomplete: boolean = false;+ readonly cleanupResources: readonly string[] = [];+}diff --git a/src/domain/analysisErrorCore.ts b/src/domain/analysisErrorCore.tsnew file mode 100644index 000000000..b9cdea561--- /dev/null+++ b/src/domain/analysisErrorCore.ts@@ -0,0 +1,86 @@+import type { JsonValue } from "./jsonValue.js";+import { AnalysisError } from "./analysisErrorBase.js";++/** Provider-neutral invalid analysis input or output at an application boundary. */+export class AnalysisProtocolError extends AnalysisError {+ readonly _tag = "AnalysisProtocolError";+}++/** Caller input failed provider-neutral application parsing. */+export class AnalysisInputError extends AnalysisError {+ readonly _tag = "AnalysisInputError";++ constructor(+ readonly operation: string,+ options?: ErrorOptions,+ readonly issues: readonly AnalysisInputIssue[] = [],+ ) {+ super(`Invalid analysis input for ${operation}`, options);+ }+}++/** Secret-safe correction metadata for one rejected caller argument. */+export interface AnalysisInputIssue {+ readonly path: readonly (string | number)[];+ readonly reason:+ | "unknown_argument"+ | "missing_argument"+ | "invalid_type"+ | "out_of_range"+ | "invalid_value"+ | "invalid_format";+ /** Schema-authored correction guidance for cross-field or custom checks. */+ readonly message?: string;+ readonly expected?: JsonValue;+ readonly minimum?: number;+ readonly maximum?: number;+}++/** Provider output failed provider-neutral application parsing. */+export class AnalysisOutputError extends AnalysisError {+ readonly _tag = "AnalysisOutputError";++ constructor(+ readonly operation: string,+ readonly reason: string,+ options?: ErrorOptions,+ ) {+ super(`Invalid analysis output for ${operation}: ${reason}`, options);+ }+}++/** Selected provider cannot execute a declared analysis operation. */+export class AnalysisCapabilityUnavailableError extends AnalysisError {+ readonly _tag = "AnalysisCapabilityUnavailableError";++ constructor(+ readonly providerId: string,+ readonly operation: string,+ readonly reason: string,+ ) {+ super(`Provider ${providerId} cannot execute ${operation}: ${reason}`);+ }+}++/** Caller cancellation won before provider-neutral work completed. */+export class AnalysisCancelledError extends AnalysisError {+ readonly _tag = "AnalysisCancelledError";++ constructor(readonly operation: string) {+ super(`Analysis operation was cancelled: ${operation}`);+ }+}++/** Provider-neutral operation exceeded its declared execution deadline. */+export class AnalysisTimeoutError extends AnalysisError {+ readonly _tag = "AnalysisTimeoutError";++ constructor(+ readonly operation: string,+ readonly timeoutMs: number,+ ) {+ super(+ `Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}`,+ );+ }+}diff --git a/src/domain/analysisErrorPresentation.ts b/src/domain/analysisErrorPresentation.tsindex f9fa8af1d..9fc1c1879 100644--- a/src/domain/analysisErrorPresentation.ts+++ b/src/domain/analysisErrorPresentation.ts@@ -1,22 +1,25 @@+import { AnalysisInputError } from "./analysisErrorCore.js";+import { ArtifactOperationError } from "./artifactOperationError.js";import {- AnalysisInputError,- ArtifactOperationError,BinaryTargetError,- BrowserObservationError,ConfigurationError,- EvidenceFileError,- EvidenceIntegrityError,+ NoBinaryOpenError,+} from "./configurationErrors.js";+import { BrowserObservationError } from "./browserObservationError.js";+import { EvidenceFileError, EvidenceIntegrityError } from "./evidenceErrors.js";+import {HopperRemoteError,HopperProcessError,HopperStartError,HopperTimeoutError,- NoBinaryOpenError,- ProviderSelectionError,- UnknownRegistryError,+} from "./hopperErrors.js";+import { ProviderSelectionError } from "./providerSelectionError.js";+import { UnknownRegistryError } from "./unknownRegistryError.js";+import {type AnalysisError,- type AnalysisErrorProjection,type AnalysisErrorTag,-} from "./errors.js";+} from "./analysisErrorBase.js";+import { type AnalysisErrorProjection } from "./analysisErrorProjection.js";export const analysisErrorRemediationAction = (error: AnalysisError,diff --git a/src/domain/analysisErrorProjection.test.ts b/src/domain/analysisErrorProjection.test.tsindex 3a4398aa3..f05d35bf4 100644--- a/src/domain/analysisErrorProjection.test.ts+++ b/src/domain/analysisErrorProjection.test.ts@@ -1,19 +1,20 @@import { describe, expect, it } from "vitest";-import {AnalysisCapabilityUnavailableError,AnalysisInputError,- ArtifactOperationError,- BinaryTargetError,- BrowserObservationError,+} from "./analysisErrorCore.js";+import { ArtifactOperationError } from "./artifactOperationError.js";+import { BinaryTargetError } from "./configurationErrors.js";+import { BrowserObservationError } from "./browserObservationError.js";+import {HopperProcessError,HopperRemoteError,HopperStartError,HopperTimeoutError,- ProviderAdapterError,- UnknownRegistryError,- projectAnalysisError,-} from "./errors.js";+} from "./hopperErrors.js";+import { ProviderAdapterError } from "./providerAdapterError.js";+import { UnknownRegistryError } from "./unknownRegistryError.js";+import { projectAnalysisError } from "./analysisErrorProjection.js";describe("analysis error projection: provider failures", () => {it("projects the primary browser failure alongside incomplete cleanup", () => {diff --git a/src/domain/analysisErrorProjection.ts b/src/domain/analysisErrorProjection.tsindex 9a302254a..7bc9eed76 100644--- a/src/domain/analysisErrorProjection.ts+++ b/src/domain/analysisErrorProjection.ts@@ -1,31 +1,34 @@import type { JsonValue } from "./jsonValue.js";++import {+ analysisErrorCategory,+ analysisErrorRemediationAction,+ analysisErrorUserMessage,+ assertKnownAnalysisErrorTag,+} from "./analysisErrorPresentation.js";import {AnalysisCancelledError,AnalysisCapabilityUnavailableError,AnalysisInputError,AnalysisTimeoutError,- ArtifactOperationError,- BinaryTargetError,- BrowserObservationError,- EvidenceFileError,- EvidenceReferenceError,+} from "./analysisErrorCore.js";+import { ArtifactOperationError } from "./artifactOperationError.js";+import { BinaryTargetError } from "./configurationErrors.js";+import { BrowserObservationError } from "./browserObservationError.js";+import { EvidenceFileError, EvidenceReferenceError } from "./evidenceErrors.js";+import {HopperCancelledError,HopperProcessError,HopperRemoteError,HopperTimeoutError,- ProviderAdapterError,- ProviderSelectionError,- UnknownRegistryError,+} from "./hopperErrors.js";+import { ProviderAdapterError } from "./providerAdapterError.js";+import { ProviderSelectionError } from "./providerSelectionError.js";+import { UnknownRegistryError } from "./unknownRegistryError.js";+import {type AnalysisError,- type AnalysisErrorProjection,type AnalysisErrorTag,-} from "./errors.js";-import {- analysisErrorCategory,- analysisErrorRemediationAction,- analysisErrorUserMessage,- assertKnownAnalysisErrorTag,-} from "./analysisErrorPresentation.js";+} from "./analysisErrorBase.js";/** Project expected failures into exhaustive, secret-safe caller fields. */export const projectAnalysisError = (@@ -342,3 +345,40 @@ const RETRYABLE_CODES: ReadonlySet<AnalysisErrorProjection["code"]> = new Set(["revision_conflict","provider_unavailable",]);++export interface AnalysisErrorProjection extends Readonly<+ Record<string, JsonValue>+> {+ readonly code:+ | "invalid_request"+ | "unreadable_output"+ | "capability_unavailable"+ | "provider_unavailable"+ | "provider_timeout"+ | "cancelled"+ | "artifact_integrity_mismatch"+ | "artifact_operation_failed"+ | "evidence_integrity_mismatch"+ | "truncated"+ | "process_capture_failed"+ | "cleanup_incomplete"+ | "revision_conflict"+ | "configuration_invalid"+ | "target_unavailable"+ | "execution_failure";+ readonly category:+ | "invalid_input"+ | "unsupported_provider"+ | "integrity_mismatch"+ | "truncated"+ | "cancelled"+ | "timeout"+ | "unavailable"+ | "execution_failure";+ readonly message: string;+ readonly retryable: boolean;+ readonly remediation: Readonly<{+ action: string;+ }>;+ readonly details?: Readonly<Record<string, JsonValue>>;+}diff --git a/src/domain/appleAssetCatalog.ts b/src/domain/appleAssetCatalog.tsindex 0312b90ad..12439fce0 100644--- a/src/domain/appleAssetCatalog.ts+++ b/src/domain/appleAssetCatalog.ts@@ -1,7 +1,7 @@import { z } from "zod";import { jsonValueSchema } from "./jsonValue.js";-import { AnalysisOutputError } from "./errors.js";+import { AnalysisOutputError } from "./analysisErrorCore.js";/** Caller-controlled page bounds for compiled Apple asset metadata. */export const appleAssetCatalogInputSchema = z.strictObject({diff --git a/src/domain/artifactOperationError.ts b/src/domain/artifactOperationError.tsnew file mode 100644index 000000000..a40f9c569--- /dev/null+++ b/src/domain/artifactOperationError.ts@@ -0,0 +1,37 @@+import { AnalysisError } from "./analysisErrorBase.js";++/** Artifact inventory or extraction failed a typed safety boundary. */+export class ArtifactOperationError extends AnalysisError {+ readonly _tag = "ArtifactOperationError";++ constructor(+ readonly operation:+ | "inventory_artifact"+ | "inspect_artifact"+ | "extract_artifact"+ | "decode_interface_builder"+ | "inspect_asset_catalog"+ | "inspect_keyed_archive"+ | "analyze_javascript_application",+ readonly reason:+ | "cancelled"+ | "format"+ | "integrity"+ | "limit"+ | "path"+ | "unavailable"+ | "io",+ readonly artifactDetails?: Readonly<{+ logicalPath: string;+ declaredSha256: string | null;+ calculatedSha256: string | null;+ unpacked: boolean;+ }>,+ ) {+ super(+ artifactDetails === undefined+ ? `Artifact ${operation} failed: ${reason}`+ : `Artifact ${operation} failed: ${reason} at ${artifactDetails.logicalPath} (declared_sha256=${artifactDetails.declaredSha256 ?? "unavailable"}, calculated_sha256=${artifactDetails.calculatedSha256 ?? "unavailable"}, unpacked=${String(artifactDetails.unpacked)})`,+ );+ }+}diff --git a/src/domain/browserObservationError.ts b/src/domain/browserObservationError.tsnew file mode 100644index 000000000..16218e776--- /dev/null+++ b/src/domain/browserObservationError.ts@@ -0,0 +1,29 @@+import type {+ BrowserObservationFailureReason,+ BrowserObservationOperation,+} from "./browserObservationErrors.js";+import { AnalysisError } from "./analysisErrorBase.js";+import { AnalysisCancelledError } from "./analysisErrorCore.js";++/** A bounded passive browser observation failed at its CDP boundary. */+export class BrowserObservationError extends AnalysisError {+ readonly _tag = "BrowserObservationError";+ override readonly cleanupIncomplete: boolean;+ override readonly cleanupResources: readonly string[];+ override readonly userCategory: "cancelled" | undefined;++ constructor(+ readonly operation: BrowserObservationOperation,+ readonly reason: BrowserObservationFailureReason,+ options?: ErrorOptions,+ ) {+ super(`Browser observation ${operation} failed: ${reason}`, options);+ this.cleanupIncomplete = reason === "cleanup_failed";+ this.cleanupResources =+ reason === "cleanup_failed" ? ["browser_transport"] : [];+ this.userCategory =+ reason === "cancelled" || options?.cause instanceof AnalysisCancelledError+ ? "cancelled"+ : undefined;+ }+}diff --git a/src/domain/configurationErrors.ts b/src/domain/configurationErrors.tsnew file mode 100644index 000000000..4592715ec--- /dev/null+++ b/src/domain/configurationErrors.ts@@ -0,0 +1,28 @@+import { AnalysisError } from "./analysisErrorBase.js";++/** Runtime configuration could not be parsed safely. */+export class ConfigurationError extends AnalysisError {+ readonly _tag = "ConfigurationError";+}++/** No app or binary session exists for an analysis request. */+export class NoBinaryOpenError extends AnalysisError {+ readonly _tag = "NoBinaryOpenError";+ constructor() {+ super(+ "No app is open. Ask the user which app to investigate, then call open_binary with its local path.",+ );+ }+}++/** A supplied target path could not be safely opened as a supported app or binary. */+export class BinaryTargetError extends AnalysisError {+ readonly _tag = "BinaryTargetError";+ constructor(+ readonly path: string,+ reason: string,+ options?: ErrorOptions,+ ) {+ super(`Cannot open artifact: ${reason}`, options);+ }+}diff --git a/src/domain/errors.ts b/src/domain/errors.tsdeleted file mode 100644index 561c77468..000000000--- a/src/domain/errors.ts+++ /dev/null@@ -1,516 +0,0 @@-import type { JsonValue } from "./jsonValue.js";-import type {- BrowserObservationFailureReason,- BrowserObservationOperation,-} from "./browserObservationErrors.js";--export type { BrowserObservationOperation } from "./browserObservationErrors.js";-import {- hopperStartupFailure,- type HopperStartupDiagnostic,- type HopperStartupFailureDiagnostic,- type HopperStartupFailureCode,-} from "./hopperStartupFailure.js";-export {- hopperStartupFailure,- type HopperStartupDiagnostic,- type HopperStartupFailureDiagnostic,- type HopperStartupFailureCode,-};-export { projectAnalysisError } from "./analysisErrorProjection.js";--/** Stable tags exposed by safe analysis-error projections. */-const ANALYSIS_ERROR_TAGS = [- "AnalysisProtocolError",- "AnalysisInputError",- "AnalysisOutputError",- "AnalysisCapabilityUnavailableError",- "AnalysisCancelledError",- "AnalysisTimeoutError",- "ProviderSelectionError",- "ProviderAdapterError",- "BrowserObservationError",- "ArtifactOperationError",- "ProcessCaptureError",- "EvidenceIntegrityError",- "EvidenceFileError",- "UnknownRegistryError",- "HopperTimeoutError",- "HopperCancelledError",- "HopperProtocolError",- "HopperRemoteError",- "HopperProcessError",- "HopperStartError",- "ConfigurationError",- "NoBinaryOpenError",- "BinaryTargetError",-] as const;--/** Stable tag for an expected analysis failure. */-export type AnalysisErrorTag = (typeof ANALYSIS_ERROR_TAGS)[number];--/** Base class for expected analysis, provider, and session failures. */-export abstract class AnalysisError extends Error {- abstract readonly _tag: AnalysisErrorTag;- readonly userMessage: string | undefined = undefined;- readonly userCategory: "cancelled" | undefined = undefined;- readonly cleanupIncomplete: boolean = false;- readonly cleanupResources: readonly string[] = [];-}--/** Base class for failures produced specifically by the Hopper provider. */-export abstract class HopperError extends AnalysisError {}--/** Provider-neutral invalid analysis input or output at an application boundary. */-export class AnalysisProtocolError extends AnalysisError {- readonly _tag = "AnalysisProtocolError";-}--/** Caller input failed provider-neutral application parsing. */-export class AnalysisInputError extends AnalysisError {- readonly _tag = "AnalysisInputError";-- constructor(- readonly operation: string,- options?: ErrorOptions,- readonly issues: readonly AnalysisInputIssue[] = [],- ) {- super(`Invalid analysis input for ${operation}`, options);- }-}--/** Secret-safe correction metadata for one rejected caller argument. */-export interface AnalysisInputIssue {- readonly path: readonly (string | number)[];- readonly reason:- | "unknown_argument"- | "missing_argument"- | "invalid_type"- | "out_of_range"- | "invalid_value"- | "invalid_format";- /** Schema-authored correction guidance for cross-field or custom checks. */- readonly message?: string;- readonly expected?: JsonValue;- readonly minimum?: number;- readonly maximum?: number;-}--/** Provider output failed provider-neutral application parsing. */-export class AnalysisOutputError extends AnalysisError {- readonly _tag = "AnalysisOutputError";-- constructor(- readonly operation: string,- readonly reason: string,- options?: ErrorOptions,- ) {- super(`Invalid analysis output for ${operation}: ${reason}`, options);- }-}--/** Selected provider cannot execute a declared analysis operation. */-export class AnalysisCapabilityUnavailableError extends AnalysisError {- readonly _tag = "AnalysisCapabilityUnavailableError";-- constructor(- readonly providerId: string,- readonly operation: string,- readonly reason: string,- ) {- super(`Provider ${providerId} cannot execute ${operation}: ${reason}`);- }-}--/** Caller cancellation won before provider-neutral work completed. */-export class AnalysisCancelledError extends AnalysisError {- readonly _tag = "AnalysisCancelledError";-- constructor(readonly operation: string) {- super(`Analysis operation was cancelled: ${operation}`);- }-}--/** Provider-neutral operation exceeded its declared execution deadline. */-export class AnalysisTimeoutError extends AnalysisError {- readonly _tag = "AnalysisTimeoutError";-- constructor(- readonly operation: string,- readonly timeoutMs: number,- ) {- super(- `Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}`,- );- }-}--/** Stable failure classes for target-bound deep-provider selection. */-export type ProviderSelectionFailureReason =- | "unknown_provider"- | "provider_unavailable"- | "target_unsupported"- | "ambiguous"- | "invalid_options";--/** One actionable candidate rejection retained in caller diagnostics. */-export interface ProviderSelectionRejection {- readonly providerId: string;- readonly code: string;- readonly reason: string;- readonly diagnostics: Readonly<Record<string, JsonValue>>;-}--/** Complete typed context for one failed deep-provider selection. */-export interface ProviderSelectionErrorOptions {- readonly operation?: string;- readonly reason: ProviderSelectionFailureReason;- readonly requestedProviderId: string;- readonly candidateIds: readonly string[];- readonly rejections?: readonly ProviderSelectionRejection[];-}--/** No configured provider can satisfy a requested operation or target binding. */-export class ProviderSelectionError extends AnalysisError {- readonly _tag = "ProviderSelectionError";- readonly operation: string;- readonly reason: ProviderSelectionFailureReason;- readonly requestedProviderId: string;- readonly candidateIds: readonly string[];- readonly rejections: readonly ProviderSelectionRejection[];- override readonly userMessage: string;-- constructor(options: ProviderSelectionErrorOptions) {- const operation = options.operation ?? "open_binary";- super(providerSelectionDiagnostic(options));- this.operation = operation;- this.reason = options.reason;- this.requestedProviderId = options.requestedProviderId;- this.candidateIds = [...options.candidateIds];- this.rejections = [...(options.rejections ?? [])].map((rejection) => ({- ...rejection,- diagnostics: structuredClone(rejection.diagnostics),- }));- this.userMessage = providerSelectionUserMessage(options);- }-}--const providerSelectionDiagnostic = (- options: ProviderSelectionErrorOptions,-): string => {- const candidates =- options.candidateIds.length === 0- ? "none"- : options.candidateIds.join(", ");- return `Analysis provider selection failed (${options.reason}) for ${options.requestedProviderId}; candidates: ${candidates}`;-};--const providerSelectionUserMessage = (- options: ProviderSelectionErrorOptions,-): string => {- switch (options.reason) {- case "ambiguous":- return "Multiple analysis providers support this target. Choose one with provider_id, --provider, or REA_ANALYSIS_PROVIDER.";- case "unknown_provider":- return `The requested analysis provider is unknown. Choose one of: ${options.candidateIds.join(", ") || "no configured providers"}.`;- case "provider_unavailable":- return "The selected analysis provider is unavailable. Review the reported local diagnostics or run `rea doctor`, then retry.";- case "target_unsupported":- return "The selected analysis provider does not support this target. Choose another provider or open a supported extracted binary.";- case "invalid_options":- return "The analysis provider selection or open options are invalid. Correct them and try again.";- }-};--/** A provider adapter failed outside its more precise typed variants. */-export interface ProviderAdapterErrorOptions extends ErrorOptions {- readonly diagnostics?: Readonly<Record<string, JsonValue>>;-}--/** A provider adapter failed outside its more precise typed variants. */-export class ProviderAdapterError extends AnalysisError {- readonly _tag = "ProviderAdapterError";- readonly diagnostics: Readonly<Record<string, JsonValue>> | undefined;-- constructor(- readonly providerId: string,- readonly operation: string,- options: ProviderAdapterErrorOptions = {},- ) {- super(`Provider ${providerId} adapter failed during ${operation}`, options);- this.diagnostics =- options.diagnostics === undefined- ? undefined- : structuredClone(options.diagnostics);- }-}--/** A bounded passive browser observation failed at its CDP boundary. */-export class BrowserObservationError extends AnalysisError {- readonly _tag = "BrowserObservationError";- override readonly cleanupIncomplete: boolean;- override readonly cleanupResources: readonly string[];- override readonly userCategory: "cancelled" | undefined;-- constructor(- readonly operation: BrowserObservationOperation,- readonly reason: BrowserObservationFailureReason,- options?: ErrorOptions,- ) {- super(`Browser observation ${operation} failed: ${reason}`, options);- this.cleanupIncomplete = reason === "cleanup_failed";- this.cleanupResources =- reason === "cleanup_failed" ? ["browser_transport"] : [];- this.userCategory =- reason === "cancelled" || options?.cause instanceof AnalysisCancelledError- ? "cancelled"- : undefined;- }-}--/** Artifact inventory or extraction failed a typed safety boundary. */-export class ArtifactOperationError extends AnalysisError {- readonly _tag = "ArtifactOperationError";-- constructor(- readonly operation:- | "inventory_artifact"- | "inspect_artifact"- | "extract_artifact"- | "decode_interface_builder"- | "inspect_asset_catalog"- | "inspect_keyed_archive"- | "analyze_javascript_application",- readonly reason:- | "cancelled"- | "format"- | "integrity"- | "limit"- | "path"- | "unavailable"- | "io",- readonly artifactDetails?: Readonly<{- logicalPath: string;- declaredSha256: string | null;- calculatedSha256: string | null;- unpacked: boolean;- }>,- ) {- super(- artifactDetails === undefined- ? `Artifact ${operation} failed: ${reason}`- : `Artifact ${operation} failed: ${reason} at ${artifactDetails.logicalPath} (declared_sha256=${artifactDetails.declaredSha256 ?? "unavailable"}, calculated_sha256=${artifactDetails.calculatedSha256 ?? "unavailable"}, unpacked=${String(artifactDetails.unpacked)})`,- );- }-}--/** Evidence identity, schema, or bundle manifests failed integrity checks. */-export class EvidenceIntegrityError extends AnalysisError {- readonly _tag = "EvidenceIntegrityError";-}--/** A session Evidence reference is missing or has the wrong semantic identity. */-export class EvidenceReferenceError extends EvidenceIntegrityError {- constructor(- readonly evidenceId: string,- readonly reason: "missing" | "wrong_operation" | "wrong_predicate",- readonly expected: string,- readonly actual: string | null,- ) {- super(`Evidence reference ${reason}: ${evidenceId}`);- }-}--/** Evidence bundle filesystem access failed within the configured policy. */-export class EvidenceFileError extends AnalysisError {- readonly _tag = "EvidenceFileError";-- constructor(- readonly operation: "read" | "write",- readonly reason: "not-file" | "exists" | "invalid-json" | "io",- options?: ErrorOptions,- ) {- super(`Evidence bundle ${operation} failed: ${reason}`, options);- }-}--/** Residual-unknown mutation failed a lifecycle, reference, or CAS invariant. */-export class UnknownRegistryError extends AnalysisError {- readonly _tag = "UnknownRegistryError";-- constructor(- readonly reason:- | "not-found"- | "already-exists"- | "revision-conflict"- | "invalid-transition"- | "integrity"- | "limit",- options?: ErrorOptions,- ) {- super(`Residual unknown registry mutation failed: ${reason}`, options);- }-}--/** Hopper did not respond within the configured operation deadline. */-export class HopperTimeoutError extends HopperError {- readonly _tag = "HopperTimeoutError";-- constructor(- readonly timeoutMs: number,- readonly operation?: string,- readonly requestId?: number,- readonly providerState: "busy" | "not_started" = "not_started",- ) {- super(- `Hopper ${operation === undefined ? "startup" : operation} timed out after ${String(timeoutMs)}ms`,- );- }-}--/** The caller cancelled a Hopper operation before it completed. */-export class HopperCancelledError extends HopperError {- readonly _tag = "HopperCancelledError";-- constructor() {- super("Hopper operation was cancelled");- }-}--/** Hopper returned bytes or JSON that do not satisfy the NDJSON RPC contract. */-export class HopperProtocolError extends HopperError {- readonly _tag = "HopperProtocolError";-}--export type HopperDiagnosticType =- | "remote"- | "authorization"- | "invalid_request"- | "capability_unavailable"- | "bridge_exception";--/** Hopper's JSON-RPC endpoint returned an expected remote error response. */-export interface HopperRemoteErrorContext {- readonly diagnosticType?: HopperDiagnosticType;- readonly operation?: string;- readonly requestId?: number;-}--export class HopperRemoteError extends HopperError {- readonly _tag = "HopperRemoteError";- readonly diagnosticType: HopperDiagnosticType;- readonly operation: string | undefined;- readonly requestId: number | undefined;-- constructor(- readonly code: number,- readonly safeMessage: string,- context: HopperRemoteErrorContext = {},- ) {- super(`Hopper request failed (${String(code)}): ${safeMessage}`);- this.diagnosticType = context.diagnosticType ?? "remote";- this.operation = context.operation;- this.requestId = context.requestId;- }-}--/** The owned Hopper bridge stopped before its client was closed. */-export class HopperProcessError extends HopperError {- readonly _tag = "HopperProcessError";- readonly failureCode: HopperStartupFailureCode | undefined;- override readonly userMessage: string | undefined;-- constructor(- readonly exitCode: number | null,- readonly diagnostic?: HopperStartupFailureDiagnostic,- readonly operation?: string,- readonly requestId?: number,- ) {- super(`Hopper bridge stopped unexpectedly with code ${String(exitCode)}`);- const failure = hopperStartupFailure(exitCode);- this.failureCode = failure?.code;- this.userMessage = failure?.message;- }-}--/** Hopper or the repository bridge could not be started. */-export class HopperStartError extends HopperError {- readonly _tag = "HopperStartError";- override readonly userMessage: string | undefined;- readonly ownerRunId: string | undefined;-- constructor(- options?: ErrorOptions & {- readonly userMessage?: string;- readonly ownerRunId?: string;- },- ) {- super("Hopper application bridge could not be started", options);- this.userMessage = options?.userMessage;- this.ownerRunId = options?.ownerRunId;- }-}--/** Runtime configuration could not be parsed safely. */-export class ConfigurationError extends AnalysisError {- readonly _tag = "ConfigurationError";-}--/** No app or binary session exists for an analysis request. */-export class NoBinaryOpenError extends AnalysisError {- readonly _tag = "NoBinaryOpenError";- constructor() {- super(- "No app is open. Ask the user which app to investigate, then call open_binary with its local path.",- );- }-}--/** A supplied target path could not be safely opened as a supported app or binary. */-export class BinaryTargetError extends AnalysisError {- readonly _tag = "BinaryTargetError";- constructor(- readonly path: string,- reason: string,- options?: ErrorOptions,- ) {- super(`Cannot open artifact: ${reason}`, options);- }-}--export interface AnalysisErrorProjection extends Readonly<- Record<string, JsonValue>-> {- readonly code:- | "invalid_request"- | "unreadable_output"- | "capability_unavailable"- | "provider_unavailable"- | "provider_timeout"- | "cancelled"- | "artifact_integrity_mismatch"- | "artifact_operation_failed"- | "evidence_integrity_mismatch"- | "truncated"- | "process_capture_failed"- | "cleanup_incomplete"- | "revision_conflict"- | "configuration_invalid"- | "target_unavailable"- | "execution_failure";- readonly category:- | "invalid_input"- | "unsupported_provider"- | "integrity_mismatch"- | "truncated"- | "cancelled"- | "timeout"- | "unavailable"- | "execution_failure";- readonly message: string;- readonly retryable: boolean;- readonly remediation: Readonly<{- action: string;- }>;- readonly details?: Readonly<Record<string, JsonValue>>;-}diff --git a/src/domain/evidenceErrors.ts b/src/domain/evidenceErrors.tsnew file mode 100644index 000000000..73ecf5fba--- /dev/null+++ b/src/domain/evidenceErrors.ts@@ -0,0 +1,31 @@+import { AnalysisError } from "./analysisErrorBase.js";++/** Evidence identity, schema, or bundle manifests failed integrity checks. */+export class EvidenceIntegrityError extends AnalysisError {+ readonly _tag = "EvidenceIntegrityError";+}++/** A session Evidence reference is missing or has the wrong semantic identity. */+export class EvidenceReferenceError extends EvidenceIntegrityError {+ constructor(+ readonly evidenceId: string,+ readonly reason: "missing" | "wrong_operation" | "wrong_predicate",+ readonly expected: string,+ readonly actual: string | null,+ ) {+ super(`Evidence reference ${reason}: ${evidenceId}`);+ }+}++/** Evidence bundle filesystem access failed within the configured policy. */+export class EvidenceFileError extends AnalysisError {+ readonly _tag = "EvidenceFileError";++ constructor(+ readonly operation: "read" | "write",+ readonly reason: "not-file" | "exists" | "invalid-json" | "io",+ options?: ErrorOptions,+ ) {+ super(`Evidence bundle ${operation} failed: ${reason}`, options);+ }+}diff --git a/src/domain/hopperErrors.ts b/src/domain/hopperErrors.tsnew file mode 100644index 000000000..a34f5a707--- /dev/null+++ b/src/domain/hopperErrors.ts@@ -0,0 +1,109 @@+import { AnalysisError } from "./analysisErrorBase.js";+import {+ hopperStartupFailure,+ type HopperStartupDiagnostic,+ type HopperStartupFailureCode,+ type HopperStartupFailureDiagnostic,+} from "./hopperStartupFailure.js";++/** Base class for failures produced specifically by the Hopper provider. */+export abstract class HopperError extends AnalysisError {}++/** Hopper did not respond within the configured operation deadline. */+export class HopperTimeoutError extends HopperError {+ readonly _tag = "HopperTimeoutError";++ constructor(+ readonly timeoutMs: number,+ readonly operation?: string,+ readonly requestId?: number,+ readonly providerState: "busy" | "not_started" = "not_started",+ ) {+ super(+ `Hopper ${operation === undefined ? "startup" : operation} timed out after ${String(timeoutMs)}ms`,+ );+ }+}++/** The caller cancelled a Hopper operation before it completed. */+export class HopperCancelledError extends HopperError {+ readonly _tag = "HopperCancelledError";++ constructor() {+ super("Hopper operation was cancelled");+ }+}++/** Hopper returned bytes or JSON that do not satisfy the NDJSON RPC contract. */+export class HopperProtocolError extends HopperError {+ readonly _tag = "HopperProtocolError";+}++export type HopperDiagnosticType =+ | "remote"+ | "authorization"+ | "invalid_request"+ | "capability_unavailable"+ | "bridge_exception";++/** Hopper's JSON-RPC endpoint returned an expected remote error response. */+export interface HopperRemoteErrorContext {+ readonly diagnosticType?: HopperDiagnosticType;+ readonly operation?: string;+ readonly requestId?: number;+}++export class HopperRemoteError extends HopperError {+ readonly _tag = "HopperRemoteError";+ readonly diagnosticType: HopperDiagnosticType;+ readonly operation: string | undefined;+ readonly requestId: number | undefined;++ constructor(+ readonly code: number,+ readonly safeMessage: string,+ context: HopperRemoteErrorContext = {},+ ) {+ super(`Hopper request failed (${String(code)}): ${safeMessage}`);+ this.diagnosticType = context.diagnosticType ?? "remote";+ this.operation = context.operation;+ this.requestId = context.requestId;+ }+}++/** The owned Hopper bridge stopped before its client was closed. */+export class HopperProcessError extends HopperError {+ readonly _tag = "HopperProcessError";+ readonly failureCode: HopperStartupFailureCode | undefined;+ override readonly userMessage: string | undefined;++ constructor(+ readonly exitCode: number | null,+ readonly diagnostic?: HopperStartupFailureDiagnostic,+ readonly operation?: string,+ readonly requestId?: number,+ ) {+ super(`Hopper bridge stopped unexpectedly with code ${String(exitCode)}`);+ const failure = hopperStartupFailure(exitCode);+ this.failureCode = failure?.code;+ this.userMessage = failure?.message;+ }+}++/** Hopper or the repository bridge could not be started. */+export class HopperStartError extends HopperError {+ readonly _tag = "HopperStartError";+ override readonly userMessage: string | undefined;+ readonly ownerRunId: string | undefined;++ constructor(+ options?: ErrorOptions & {+ readonly userMessage?: string;+ readonly ownerRunId?: string;+ },+ ) {+ super("Hopper application bridge could not be started", options);+ this.userMessage = options?.userMessage;+ this.ownerRunId = options?.ownerRunId;+ }+}diff --git a/src/domain/hopperValues.ts b/src/domain/hopperValues.tsindex b1d2dc5ef..8161a796f 100644--- a/src/domain/hopperValues.ts+++ b/src/domain/hopperValues.ts@@ -1,10 +1,12 @@import { z } from "zod";import type { JsonValue } from "./jsonValue.js";-import { AnalysisOutputError, HopperProtocolError } from "./errors.js";+import { err, ok, type Result } from "./result.js";import { nativeApiBoundarySchema } from "./nativeApiBoundary.js";import { nativeValueFlowSchema } from "./nativeValueFlow.js";+import { AnalysisOutputError } from "./analysisErrorCore.js";+import { HopperProtocolError } from "./hopperErrors.js";export interface AddressedName {readonly address: string;diff --git a/src/domain/inputIssueProjection.ts b/src/domain/inputIssueProjection.tsindex 13214d198..1fff45e1c 100644--- a/src/domain/inputIssueProjection.ts+++ b/src/domain/inputIssueProjection.ts@@ -1,6 +1,5 @@import type { z } from "zod";--import type { AnalysisInputIssue } from "./errors.js";+import type { AnalysisInputIssue } from "./analysisErrorCore.js";/** Project Zod failures to secret-safe caller correction metadata. */export const projectInputIssues = (diff --git a/src/domain/providerAdapterError.ts b/src/domain/providerAdapterError.tsnew file mode 100644index 000000000..f999d00ba--- /dev/null+++ b/src/domain/providerAdapterError.ts@@ -0,0 +1,25 @@+import type { JsonValue } from "./jsonValue.js";+import { AnalysisError } from "./analysisErrorBase.js";++/** A provider adapter failed outside its more precise typed variants. */+export interface ProviderAdapterErrorOptions extends ErrorOptions {+ readonly diagnostics?: Readonly<Record<string, JsonValue>>;+}++/** A provider adapter failed outside its more precise typed variants. */+export class ProviderAdapterError extends AnalysisError {+ readonly _tag = "ProviderAdapterError";+ readonly diagnostics: Readonly<Record<string, JsonValue>> | undefined;++ constructor(+ readonly providerId: string,+ readonly operation: string,+ options: ProviderAdapterErrorOptions = {},+ ) {+ super(`Provider ${providerId} adapter failed during ${operation}`, options);+ this.diagnostics =+ options.diagnostics === undefined+ ? undefined+ : structuredClone(options.diagnostics);+ }+}diff --git a/src/domain/providerCleanupError.ts b/src/domain/providerCleanupError.tsindex 71e51d698..ce79e44df 100644--- a/src/domain/providerCleanupError.ts+++ b/src/domain/providerCleanupError.ts@@ -1,5 +1,5 @@-import { ProviderAdapterError } from "./errors.js";import type { JsonValue } from "./jsonValue.js";+import { ProviderAdapterError } from "./providerAdapterError.js";/** Provider resources could not be proven closed after bounded cleanup. */export class ProviderCleanupError extends ProviderAdapterError {diff --git a/src/domain/providerSelectionError.ts b/src/domain/providerSelectionError.tsnew file mode 100644index 000000000..2dbb182fa--- /dev/null+++ b/src/domain/providerSelectionError.ts@@ -0,0 +1,79 @@+import type { JsonValue } from "./jsonValue.js";+import { AnalysisError } from "./analysisErrorBase.js";++/** Stable failure classes for target-bound deep-provider selection. */+export type ProviderSelectionFailureReason =+ | "unknown_provider"+ | "provider_unavailable"+ | "target_unsupported"+ | "ambiguous"+ | "invalid_options";++/** One actionable candidate rejection retained in caller diagnostics. */+export interface ProviderSelectionRejection {+ readonly providerId: string;+ readonly code: string;+ readonly reason: string;+ readonly diagnostics: Readonly<Record<string, JsonValue>>;+}++/** Complete typed context for one failed deep-provider selection. */+export interface ProviderSelectionErrorOptions {+ readonly operation?: string;+ readonly reason: ProviderSelectionFailureReason;+ readonly requestedProviderId: string;+ readonly candidateIds: readonly string[];+ readonly rejections?: readonly ProviderSelectionRejection[];+}++/** No configured provider can satisfy a requested operation or target binding. */+export class ProviderSelectionError extends AnalysisError {+ readonly _tag = "ProviderSelectionError";+ readonly operation: string;+ readonly reason: ProviderSelectionFailureReason;+ readonly requestedProviderId: string;+ readonly candidateIds: readonly string[];+ readonly rejections: readonly ProviderSelectionRejection[];+ override readonly userMessage: string;++ constructor(options: ProviderSelectionErrorOptions) {+ const operation = options.operation ?? "open_binary";+ super(providerSelectionDiagnostic(options));+ this.operation = operation;+ this.reason = options.reason;+ this.requestedProviderId = options.requestedProviderId;+ this.candidateIds = [...options.candidateIds];+ this.rejections = [...(options.rejections ?? [])].map((rejection) => ({+ ...rejection,+ diagnostics: structuredClone(rejection.diagnostics),+ }));+ this.userMessage = providerSelectionUserMessage(options);+ }+}++const providerSelectionDiagnostic = (+ options: ProviderSelectionErrorOptions,+): string => {+ const candidates =+ options.candidateIds.length === 0+ ? "none"+ : options.candidateIds.join(", ");+ return `Analysis provider selection failed (${options.reason}) for ${options.requestedProviderId}; candidates: ${candidates}`;+};++const providerSelectionUserMessage = (+ options: ProviderSelectionErrorOptions,+): string => {+ switch (options.reason) {+ case "ambiguous":+ return "Multiple analysis providers support this target. Choose one with provider_id, --provider, or REA_ANALYSIS_PROVIDER.";+ case "unknown_provider":+ return `The requested analysis provider is unknown. Choose one of: ${options.candidateIds.join(", ") || "no configured providers"}.`;+ case "provider_unavailable":+ return "The selected analysis provider is unavailable. Review the reported local diagnostics or run `rea doctor`, then retry.";+ case "target_unsupported":+ return "The selected analysis provider does not support this target. Choose another provider or open a supported extracted binary.";+ case "invalid_options":+ return "The analysis provider selection or open options are invalid. Correct them and try again.";+ }+};diff --git a/src/domain/unknownRegistryError.ts b/src/domain/unknownRegistryError.tsnew file mode 100644index 000000000..9803690c2--- /dev/null+++ b/src/domain/unknownRegistryError.ts@@ -0,0 +1,19 @@+import { AnalysisError } from "./analysisErrorBase.js";++/** Residual-unknown mutation failed a lifecycle, reference, or CAS invariant. */+export class UnknownRegistryError extends AnalysisError {+ readonly _tag = "UnknownRegistryError";++ constructor(+ readonly reason:+ | "not-found"+ | "already-exists"+ | "revision-conflict"+ | "invalid-transition"+ | "integrity"+ | "limit",+ options?: ErrorOptions,+ ) {+ super(`Residual unknown registry mutation failed: ${reason}`, options);+ }+}diff --git a/src/dotnet/ManagedStaticProvider.ts b/src/dotnet/ManagedStaticProvider.tsindex fa3bed384..a4c38471c 100644--- a/src/dotnet/ManagedStaticProvider.ts+++ b/src/dotnet/ManagedStaticProvider.ts@@ -23,9 +23,9 @@ import type { BinaryTarget } from "../domain/binaryTarget.js";import {AnalysisCancelledError,AnalysisCapabilityUnavailableError,- EvidenceIntegrityError,- ProviderAdapterError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";import type { EvidenceLocation } from "../domain/evidence.js";import type { JsonValue } from "../domain/jsonValue.js";import type {diff --git a/src/ghidra/GhidraAnalysisProfile.ts b/src/ghidra/GhidraAnalysisProfile.tsindex d1e57b901..369055d76 100644--- a/src/ghidra/GhidraAnalysisProfile.ts+++ b/src/ghidra/GhidraAnalysisProfile.ts@@ -4,11 +4,9 @@ import type {} from "../application/AnalysisProvider.js";import { createAnalysisProfile } from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import {- AnalysisCancelledError,- ProviderAdapterError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";import type { GhidraInstallationInspection } from "./GhidraInstallation.js";diff --git a/src/ghidra/GhidraFunctionValues.ts b/src/ghidra/GhidraFunctionValues.tsindex 23406b4a3..6db1e8775 100644--- a/src/ghidra/GhidraFunctionValues.ts+++ b/src/ghidra/GhidraFunctionValues.ts@@ -5,7 +5,10 @@ import {nativeCallTargetsSchema,} from "../domain/nativeInstruction.js";-import { AnalysisInputError, AnalysisOutputError } from "../domain/errors.js";+import {+ AnalysisInputError,+ AnalysisOutputError,+} from "../domain/analysisErrorCore.js";import {functionBodyEntryAgrees,functionInstructionWindowSchema,diff --git a/src/ghidra/GhidraInventoryValues.ts b/src/ghidra/GhidraInventoryValues.tsindex cb14426ed..8566d99b3 100644--- a/src/ghidra/GhidraInventoryValues.ts+++ b/src/ghidra/GhidraInventoryValues.ts@@ -1,6 +1,9 @@import { z } from "zod";-import { AnalysisInputError, AnalysisOutputError } from "../domain/errors.js";+import {+ AnalysisInputError,+ AnalysisOutputError,+} from "../domain/analysisErrorCore.js";import {functionBodySchema,functionBodyEntryAgrees,diff --git a/src/ghidra/GhidraLauncher.ts b/src/ghidra/GhidraLauncher.tsindex 304fa2d6b..5f3f54b32 100644--- a/src/ghidra/GhidraLauncher.ts+++ b/src/ghidra/GhidraLauncher.ts@@ -3,7 +3,7 @@ import { basename, dirname, join, win32 } from "node:path";import writeFileAtomic from "write-file-atomic";-import { AnalysisCancelledError } from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";import { err, ok, type Result } from "../domain/result.js";import {cleanupOwnedProcessGroup,diff --git a/src/ghidra/GhidraProvider.ts b/src/ghidra/GhidraProvider.tsindex abadd2d83..080f832ad 100644--- a/src/ghidra/GhidraProvider.ts+++ b/src/ghidra/GhidraProvider.ts@@ -20,10 +20,10 @@ import {AnalysisCancelledError,AnalysisCapabilityUnavailableError,AnalysisInputError,- type AnalysisError,AnalysisTimeoutError,- ProviderAdapterError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";import { err, ok, type Result } from "../domain/result.js";import type { Logger } from "../logger.js";import { GhidraClient } from "./GhidraClient.js";diff --git a/src/hopper/BridgeLauncher.ts b/src/hopper/BridgeLauncher.tsindex fbd75265f..78a6a7c41 100644--- a/src/hopper/BridgeLauncher.ts+++ b/src/hopper/BridgeLauncher.ts@@ -7,7 +7,7 @@ import {HopperCancelledError,HopperProcessError,HopperStartError,-} from "../domain/errors.js";+} from "../domain/hopperErrors.js";import { err, ok, type Result } from "../domain/result.js";import { cleanupOwnedProcessGroup } from "../process/ProcessOwnership.js";import { execFileOutput } from "../process/ExecFileOutput.js";diff --git a/src/hopper/HopperAnalysisProfile.ts b/src/hopper/HopperAnalysisProfile.tsindex f99d1bab7..506105dff 100644--- a/src/hopper/HopperAnalysisProfile.ts+++ b/src/hopper/HopperAnalysisProfile.ts@@ -10,11 +10,9 @@ import type {BinaryArchitecture,BinaryTarget,} from "../domain/binaryTarget.js";-import {- AnalysisCancelledError,- ProviderAdapterError,- type AnalysisError,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";interface HopperProfileOptions {diff --git a/src/hopper/HopperCleanup.ts b/src/hopper/HopperCleanup.tsindex 0ac15ab23..588c25afa 100644--- a/src/hopper/HopperCleanup.ts+++ b/src/hopper/HopperCleanup.ts@@ -1,8 +1,10 @@import type { Socket } from "node:net";import type { ProgressReporter } from "../application/ProgressReporter.js";-import type { AnalysisError, HopperError } from "../domain/errors.js";-import { HopperProcessError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";+import type { HopperError } from "../domain/hopperErrors.js";+import { HopperProcessError } from "../domain/hopperErrors.js";+import type { JsonValue } from "../domain/jsonValue.js";import { ProviderCleanupError } from "../domain/providerCleanupError.js";import { err, ok, type Result } from "../domain/result.js";diff --git a/src/hopper/HopperClient.ts b/src/hopper/HopperClient.tsindex fdb17236c..d259389f4 100644--- a/src/hopper/HopperClient.ts+++ b/src/hopper/HopperClient.ts@@ -4,19 +4,21 @@ import type { Socket } from "node:net";import { tmpdir } from "node:os";import { join } from "node:path";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";import {- AnalysisCapabilityUnavailableError,HopperCancelledError,- type AnalysisError,type HopperError,HopperProcessError,HopperProtocolError,HopperRemoteError,HopperStartError,- hopperStartupFailure,HopperTimeoutError,+} from "../domain/hopperErrors.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";+import {+ hopperStartupFailure,type HopperStartupFailureDiagnostic,-} from "../domain/errors.js";+} from "../domain/hopperStartupFailure.js";import { err, ok, type Result } from "../domain/result.js";import type { JsonValue } from "../domain/jsonValue.js";import type { ProgressReporter } from "../application/ProgressReporter.js";diff --git a/src/hopper/HopperDiagnostics.ts b/src/hopper/HopperDiagnostics.tsindex 7b8323d13..b40e607d3 100644--- a/src/hopper/HopperDiagnostics.ts+++ b/src/hopper/HopperDiagnostics.ts@@ -1,4 +1,4 @@-import type { HopperDiagnosticType } from "../domain/errors.js";+import type { HopperDiagnosticType } from "../domain/hopperErrors.js";import type { ProcessCleanupResult } from "../process/ProcessOwnership.js";import type {ProviderProcessLaunch,diff --git a/src/hopper/HopperProcessDiagnostic.ts b/src/hopper/HopperProcessDiagnostic.tsindex f92938733..2bfc2426d 100644--- a/src/hopper/HopperProcessDiagnostic.ts+++ b/src/hopper/HopperProcessDiagnostic.ts@@ -1,7 +1,7 @@import {hopperStartupFailure,type HopperStartupFailureDiagnostic,-} from "../domain/errors.js";+} from "../domain/hopperStartupFailure.js";import type { ProviderProcessDiagnostic } from "../process/ProviderProcess.js";import { parseLinuxPrivateDisplayDiagnostic } from "./LinuxPrivateDisplayDiagnostic.js";diff --git a/src/hopper/HopperProvider.ts b/src/hopper/HopperProvider.tsindex 6955247c6..439287fc9 100644--- a/src/hopper/HopperProvider.ts+++ b/src/hopper/HopperProvider.ts@@ -16,7 +16,7 @@ import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { AppConfig } from "../config.js";import type { BinaryTarget } from "../domain/binaryTarget.js";import type { Logger } from "../logger.js";-import { AnalysisCapabilityUnavailableError } from "../domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../domain/analysisErrorCore.js";import { err } from "../domain/result.js";import { GENERATED_MCP_TOOL_CATALOG } from "../generatedMcpToolCatalog.js";import { HopperApplicationLauncher } from "./BridgeLauncher.js";diff --git a/src/hopper/HopperRequestQueue.ts b/src/hopper/HopperRequestQueue.tsindex a12737458..0ae4c22fb 100644--- a/src/hopper/HopperRequestQueue.ts+++ b/src/hopper/HopperRequestQueue.ts@@ -9,7 +9,7 @@ import {HopperProcessError,HopperProtocolError,HopperRemoteError,-} from "../domain/errors.js";+} from "../domain/hopperErrors.js";import type { JsonValue } from "../domain/jsonValue.js";import { err, type Result } from "../domain/result.js";diff --git a/src/hopper/HopperSessionValues.ts b/src/hopper/HopperSessionValues.tsindex cac9ba182..d8e748c91 100644--- a/src/hopper/HopperSessionValues.ts+++ b/src/hopper/HopperSessionValues.ts@@ -1,4 +1,4 @@-import { HopperProtocolError } from "../domain/errors.js";+import { HopperProtocolError } from "../domain/hopperErrors.js";import type { JsonValue } from "../domain/jsonValue.js";import { err, ok, type Result } from "../domain/result.js";diff --git a/src/hopper/HopperSocketConnection.ts b/src/hopper/HopperSocketConnection.tsindex a59d50831..8333bb164 100644--- a/src/hopper/HopperSocketConnection.ts+++ b/src/hopper/HopperSocketConnection.ts@@ -1,6 +1,9 @@import { createConnection, type Socket } from "node:net";-import { HopperCancelledError, HopperStartError } from "../domain/errors.js";+import {+ HopperCancelledError,+ HopperStartError,+} from "../domain/hopperErrors.js";import { err, ok, type Result } from "../domain/result.js";/** Open one abort-aware Hopper Unix-socket connection attempt. */diff --git a/src/hopper/HopperTargetLease.ts b/src/hopper/HopperTargetLease.tsindex 9edff5b6f..9203c7c77 100644--- a/src/hopper/HopperTargetLease.ts+++ b/src/hopper/HopperTargetLease.ts@@ -7,7 +7,7 @@ import {type Socket,} from "node:net";import { join, resolve } from "node:path";-import { HopperStartError } from "../domain/errors.js";+import { HopperStartError } from "../domain/hopperErrors.js";import { safeParseJson } from "../domain/safeJson.js";interface HopperTargetLeaseOwner {diff --git a/src/hopper/protocol.ts b/src/hopper/protocol.tsindex 9c74111e9..10c109bc4 100644--- a/src/hopper/protocol.ts+++ b/src/hopper/protocol.ts@@ -1,6 +1,9 @@import { z } from "zod";-import { HopperProtocolError, HopperRemoteError } from "../domain/errors.js";+import {+ HopperProtocolError,+ HopperRemoteError,+} from "../domain/hopperErrors.js";import { jsonValueSchema, type JsonValue } from "../domain/jsonValue.js";import { err, ok, type Result } from "../domain/result.js";import { safeParseJson } from "../domain/safeJson.js";diff --git a/src/main.ts b/src/main.tsindex 0188a0aa8..920b0a694 100644--- a/src/main.ts+++ b/src/main.ts@@ -8,7 +8,7 @@ import { serveStdio } from "@modelcontextprotocol/server/stdio";import { parseConfig } from "./config.js";import { createBinarySession } from "./application/runtime.js";import { createLogger } from "./logger.js";-import { projectAnalysisError } from "./domain/errors.js";+import { projectAnalysisError } from "./domain/analysisErrorProjection.js";import type { RuntimeDependencies } from "./main/types.js";import { SERVER_START_FAILED } from "./main/messages.js";import { createRuntimeState } from "./main/state.js";diff --git a/src/main/startup.ts b/src/main/startup.tsindex d0ff96a81..e05915fb3 100644--- a/src/main/startup.ts+++ b/src/main/startup.ts@@ -1,7 +1,7 @@import type { BinarySession } from "../application/BinarySession.js";import type { AppConfig } from "../config.js";import type { Logger } from "../logger.js";-import { projectAnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";export const openInitialTarget = async (session: BinarySession,diff --git a/src/native/AppleDispatchMetadata.ts b/src/native/AppleDispatchMetadata.tsindex 8ad2f57b3..3bd301c6d 100644--- a/src/native/AppleDispatchMetadata.ts+++ b/src/native/AppleDispatchMetadata.ts@@ -7,10 +7,8 @@ import {type ObjcSwiftMetadata,} from "../domain/objcSwiftMetadata.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import {- AnalysisCancelledError,- EvidenceIntegrityError,-} from "../domain/errors.js";+import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";import { decodeSwiftClassVtables } from "./AppleSwiftVtables.js";import { createObjcProtocolReader } from "./AppleObjcProtocols.js";diff --git a/src/native/NativeMacOSProvider.ts b/src/native/NativeMacOSProvider.tsindex e92500f8e..4a0e4b016 100644--- a/src/native/NativeMacOSProvider.ts+++ b/src/native/NativeMacOSProvider.ts@@ -24,9 +24,9 @@ import {AnalysisCancelledError,AnalysisCapabilityUnavailableError,AnalysisOutputError,- ProviderAdapterError,- AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { AnalysisError } from "../domain/analysisErrorBase.js";import { jsonValueSchema, type JsonValue } from "../domain/jsonValue.js";import {demangleSwiftSchema,diff --git a/src/native/NativeMachoInspection.ts b/src/native/NativeMachoInspection.tsindex 29d909b09..4593069d3 100644--- a/src/native/NativeMachoInspection.ts+++ b/src/native/NativeMachoInspection.ts@@ -1,6 +1,6 @@import type { BinaryTarget } from "../domain/binaryTarget.js";import type { EvidenceLocation } from "../domain/evidence.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import {inspectMachoSchema,type NativeCommandInvocation,diff --git a/src/native/NativeUiObservation.ts b/src/native/NativeUiObservation.tsindex 1ddf7d1b8..b58964d11 100644--- a/src/native/NativeUiObservation.ts+++ b/src/native/NativeUiObservation.ts@@ -11,9 +11,9 @@ import {AnalysisCancelledError,AnalysisCapabilityUnavailableError,AnalysisInputError,- ProviderAdapterError,- type AnalysisError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";+import { ProviderAdapterError } from "../domain/providerAdapterError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import { err, ok, type Result } from "../domain/result.js";import { createNativeUiHelperRuntime } from "./NativeUiHelperRuntime.js";diff --git a/src/native/parsers/plist.ts b/src/native/parsers/plist.tsindex 89244c1dd..65f4748e2 100644--- a/src/native/parsers/plist.ts+++ b/src/native/parsers/plist.ts@@ -1,6 +1,6 @@import { z } from "zod";-import { AnalysisOutputError } from "../../domain/errors.js";+import { AnalysisOutputError } from "../../domain/analysisErrorCore.js";import { err, ok, type Result } from "../../domain/result.js";import { safeParseJson } from "../../domain/safeJson.js";diff --git a/src/server/recordDerivedEvidence.ts b/src/server/recordDerivedEvidence.tsindex 877be2acf..9f7b3fdde 100644--- a/src/server/recordDerivedEvidence.ts+++ b/src/server/recordDerivedEvidence.ts@@ -1,5 +1,5 @@import type { BinarySessionPort } from "../application/BinarySession.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import type { RecordUnknownInput } from "../domain/residualUnknown.js";import { ok, type Result } from "../domain/result.js";diff --git a/src/server/registerBrowserTools.ts b/src/server/registerBrowserTools.tsindex 4fa2c900e..80f7eff24 100644--- a/src/server/registerBrowserTools.ts+++ b/src/server/registerBrowserTools.ts@@ -15,7 +15,7 @@ import {import type { ProgressReporter } from "../application/ProgressReporter.js";import { BROWSER_TOOL_CONTRACTS } from "../contracts/browserToolContracts.js";import type { ToolContract } from "../contracts/toolContracts.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import { analyzeWebBundleInputSchema } from "../domain/webBundleAnalysis.js";import { inspectWebPageInputSchema } from "../domain/browserObservation.js";diff --git a/src/server/registerElectronTools.ts b/src/server/registerElectronTools.tsindex 647ac5641..e6ce905e2 100644--- a/src/server/registerElectronTools.ts+++ b/src/server/registerElectronTools.ts@@ -13,7 +13,7 @@ import { reconcileJavaScriptRuntimeEvidenceValidated } from "../application/Javaimport type { ProgressReporter } from "../application/ProgressReporter.js";import { ELECTRON_TOOL_CONTRACTS } from "../contracts/electronToolContracts.js";import type { ToolContract } from "../contracts/toolContracts.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import type { Result } from "../domain/result.js";import { inspectElectronPageInputSchema } from "../domain/electronObservation.js";diff --git a/src/server/registerEnhancedTools.ts b/src/server/registerEnhancedTools.tsindex f43e8f4dc..eb73a6f85 100644--- a/src/server/registerEnhancedTools.ts+++ b/src/server/registerEnhancedTools.ts@@ -17,7 +17,7 @@ import {import { toolContract, type ToolContract } from "../contracts/toolContracts.js";import type { AnalysisProfileCommitment } from "../domain/analysisProfile.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import { UnknownRegistryError } from "../domain/errors.js";+import { UnknownRegistryError } from "../domain/unknownRegistryError.js";import { createEvidence } from "../domain/evidence.js";import type { JsonValue } from "../domain/jsonValue.js";import type { Logger } from "../logger.js";diff --git a/src/server/registerFunctionComparisonTool.ts b/src/server/registerFunctionComparisonTool.tsindex c43e8ab32..72b67f33f 100644--- a/src/server/registerFunctionComparisonTool.ts+++ b/src/server/registerFunctionComparisonTool.ts@@ -7,7 +7,7 @@ import {parseEvidence,type Evidence,} from "../domain/evidence.js";-import { EvidenceIntegrityError } from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";import { err } from "../domain/result.js";import { compareFunctions } from "../domain/functionComparison.js";import { jsonValueSchema } from "../domain/jsonValue.js";diff --git a/src/server/registerInvestigationTools/helpers.ts b/src/server/registerInvestigationTools/helpers.tsindex 602b1e5b7..211b5bfeb 100644--- a/src/server/registerInvestigationTools/helpers.ts+++ b/src/server/registerInvestigationTools/helpers.ts@@ -1,9 +1,7 @@import type { BinarySessionPort } from "../../application/BinarySession.js";import type { Evidence } from "../../domain/evidence.js";-import {- EvidenceIntegrityError,- type AnalysisError,-} from "../../domain/errors.js";+import { EvidenceIntegrityError } from "../../domain/evidenceErrors.js";+import { type AnalysisError } from "../../domain/analysisErrorBase.js";import { err, ok, type Result } from "../../domain/result.js";import { recordDerivedEvidence } from "../recordDerivedEvidence.js";import type { WorkflowUnknownInput } from "./types.js";diff --git a/src/server/registerJavaScriptRuntimeObservationTools.ts b/src/server/registerJavaScriptRuntimeObservationTools.tsindex 4eed516d3..e33a50363 100644--- a/src/server/registerJavaScriptRuntimeObservationTools.ts+++ b/src/server/registerJavaScriptRuntimeObservationTools.ts@@ -8,7 +8,7 @@ import {} from "../application/JavaScriptRuntimeObservationService.js";import { JAVASCRIPT_RUNTIME_OBSERVATION_TOOL_CONTRACTS } from "../contracts/javascriptRuntimeObservationToolContracts.js";import type { ToolContract } from "../contracts/toolContracts.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import type { Result } from "../domain/result.js";import { observeJavaScriptRuntimeInputSchema } from "../domain/javascriptRuntimeObservation.js";diff --git a/src/server/registerManagedTools.ts b/src/server/registerManagedTools.tsindex 73ec0010e..2fe9dcb64 100644--- a/src/server/registerManagedTools.ts+++ b/src/server/registerManagedTools.ts@@ -4,7 +4,7 @@ import type { AnalysisOperationPort } from "../application/AnalysisProvider.js";import type { BinarySessionPort } from "../application/BinarySession.js";import { MANAGED_TOOL_CONTRACTS } from "../contracts/managedToolContracts.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import { AnalysisInputError } from "../domain/errors.js";+import { AnalysisInputError } from "../domain/analysisErrorCore.js";import { err } from "../domain/result.js";import type { Logger } from "../logger.js";import { registerEvidenceTools } from "./registerEvidenceTools.js";diff --git a/src/server/registerManagedWorkflowTools/evidence.ts b/src/server/registerManagedWorkflowTools/evidence.tsindex aa76d2eca..7b6e3fd78 100644--- a/src/server/registerManagedWorkflowTools/evidence.ts+++ b/src/server/registerManagedWorkflowTools/evidence.ts@@ -1,6 +1,6 @@import type { Evidence } from "../../domain/evidence.js";import { parseEvidence } from "../../domain/evidence.js";-import { EvidenceIntegrityError } from "../../domain/errors.js";+import { EvidenceIntegrityError } from "../../domain/evidenceErrors.js";import type { Result } from "../../domain/result.js";import { err, ok } from "../../domain/result.js";diff --git a/src/server/registerOfficialTools.ts b/src/server/registerOfficialTools.tsindex 838af67cb..f415c5e53 100644--- a/src/server/registerOfficialTools.ts+++ b/src/server/registerOfficialTools.ts@@ -10,7 +10,7 @@ import type { ProgressReporter } from "../application/ProgressReporter.js";import type { ToolContract } from "../contracts/toolContracts.js";import { OFFICIAL_TOOL_CONTRACTS } from "../contracts/officialToolContracts.js";import type { BinaryTarget } from "../domain/binaryTarget.js";-import type { AnalysisError } from "../domain/errors.js";+import type { AnalysisError } from "../domain/analysisErrorBase.js";import { createEvidence } from "../domain/evidence.js";import {jsonObjectSchema,diff --git a/src/server/registerProcessComparisonTool.ts b/src/server/registerProcessComparisonTool.tsindex 306b46da1..6fe33e8d6 100644--- a/src/server/registerProcessComparisonTool.ts+++ b/src/server/registerProcessComparisonTool.ts@@ -2,7 +2,7 @@ import type { McpServer } from "@modelcontextprotocol/server";import type { BinarySessionPort } from "../application/BinarySession.js";import { toolContract } from "../contracts/toolContracts.js";-import { EvidenceIntegrityError } from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";import {createEvidence,parseEvidence,diff --git a/src/server/registerSessionTools.ts b/src/server/registerSessionTools.tsindex 3c8ef1138..98ec5a637 100644--- a/src/server/registerSessionTools.ts+++ b/src/server/registerSessionTools.ts@@ -11,7 +11,8 @@ import { createProcessCaptureEvidence } from "../application/ProcessEvidence.js"import { captureProcessScenario } from "../application/ProcessHarness.js";import { toolContract } from "../contracts/toolContracts.js";import type { AnalysisSnapshot } from "../domain/analysisSnapshot.js";-import { UnknownRegistryError, type AnalysisError } from "../domain/errors.js";+import { UnknownRegistryError } from "../domain/unknownRegistryError.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { Evidence } from "../domain/evidence.js";import type { ProcessCapture } from "../domain/processCapture.js";import { ok, type Result } from "../domain/result.js";diff --git a/src/server/runDerivedOperation.ts b/src/server/runDerivedOperation.tsindex f2c8ac319..1fbdf39ba 100644--- a/src/server/runDerivedOperation.ts+++ b/src/server/runDerivedOperation.ts@@ -4,7 +4,7 @@ import { setImmediate } from "node:timers/promises";import {AnalysisCancelledError,AnalysisInputError,-} from "../domain/errors.js";+} from "../domain/analysisErrorCore.js";import { err, ok, type Result } from "../domain/result.js";import { mcpProgressReporter, type McpProgressContext } from "./mcpProgress.js";diff --git a/src/server/sessionEvidence.ts b/src/server/sessionEvidence.tsindex 8f24cbca8..b0669a6db 100644--- a/src/server/sessionEvidence.ts+++ b/src/server/sessionEvidence.ts@@ -1,5 +1,5 @@import type { BinarySessionPort } from "../application/BinarySession.js";-import { EvidenceIntegrityError } from "../domain/errors.js";+import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";import type { Evidence } from "../domain/evidence.js";import { ok, type Result } from "../domain/result.js";diff --git a/src/server/toolResult.ts b/src/server/toolResult.tsindex d0e671dda..f74dfe32d 100644--- a/src/server/toolResult.ts+++ b/src/server/toolResult.ts@@ -1,7 +1,8 @@import type { CallToolResult } from "@modelcontextprotocol/server";import type { ToolContract } from "../contracts/toolContracts.js";-import { projectAnalysisError, type AnalysisError } from "../domain/errors.js";+import { projectAnalysisError } from "../domain/analysisErrorProjection.js";+import { type AnalysisError } from "../domain/analysisErrorBase.js";import type { JsonValue } from "../domain/jsonValue.js";import type { Result } from "../domain/result.js";diff --git a/tests/acceptance/applications/javascriptApplicationWorkflows.test.ts b/tests/acceptance/applications/javascriptApplicationWorkflows.test.tsindex e42b4cf3b..bea1b8e73 100644--- a/tests/acceptance/applications/javascriptApplicationWorkflows.test.ts+++ b/tests/acceptance/applications/javascriptApplicationWorkflows.test.ts@@ -13,7 +13,7 @@ import {} from "../../../src/application/JavaScriptApplicationWorkflowService.js";import { reconcileJavaScriptRuntimeEvidence } from "../../../src/application/JavaScriptRuntimeReconciliationService.js";import { createEvidence } from "../../../src/domain/evidence.js";-import { AnalysisInputError } from "../../../src/domain/errors.js";+import { AnalysisInputError } from "../../../src/domain/analysisErrorCore.js";import { jsonValueSchema } from "../../../src/domain/jsonValue.js";import { javascriptApplicationAnalysisResultSchema } from "../../../src/domain/javascriptApplicationAnalysis.js";import {diff --git a/tests/boundary/mcp/browserScenarioMcp.test.ts b/tests/boundary/mcp/browserScenarioMcp.test.tsindex 71c967b8b..aa1b76ec3 100644--- a/tests/boundary/mcp/browserScenarioMcp.test.ts+++ b/tests/boundary/mcp/browserScenarioMcp.test.ts@@ -14,7 +14,7 @@ import {browserScenarioCaptureSchema,type BrowserScenarioCapture,} from "../../../src/domain/browserScenarioCapture.js";-import type { AnalysisError } from "../../../src/domain/errors.js";+import type { AnalysisError } from "../../../src/domain/analysisErrorBase.js";import { ok, type Result } from "../../../src/domain/result.js";import { createServer } from "../../../src/server/createServer.js";import { observed } from "../../fixtures/analysisExecution.js";diff --git a/tests/boundary/mcp/enhancedTools.01-lists-the-complete-target-open.test.ts b/tests/boundary/mcp/enhancedTools.01-lists-the-complete-target-open.test.tsindex ea07d543a..a5d5aac0f 100644--- a/tests/boundary/mcp/enhancedTools.01-lists-the-complete-target-open.test.ts+++ b/tests/boundary/mcp/enhancedTools.01-lists-the-complete-target-open.test.ts@@ -13,7 +13,7 @@ import { observed as ok } from "../../fixtures/analysisExecution.js";import { createAnalysisExecution } from "../../../src/application/AnalysisProvider.js";import { ok as resultOk } from "../../../src/domain/result.js";import { err } from "../../../src/domain/result.js";-import { AnalysisCapabilityUnavailableError } from "../../../src/domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../../../src/domain/analysisErrorCore.js";const targetObservation = (value: unknown) =>resultOk(diff --git a/tests/boundary/mcp/enhancedTools.03-returns-typed-graph-failures-and.test.ts b/tests/boundary/mcp/enhancedTools.03-returns-typed-graph-failures-and.test.tsindex 6606b3401..9c13b8b70 100644--- a/tests/boundary/mcp/enhancedTools.03-returns-typed-graph-failures-and.test.ts+++ b/tests/boundary/mcp/enhancedTools.03-returns-typed-graph-failures-and.test.ts@@ -2,7 +2,7 @@ import { afterEach, describe, expect, it } from "vitest";import type { AnalysisOperationPort } from "../../../src/application/AnalysisProvider.js";import { EnhancedTools } from "../../../src/application/EnhancedTools.js";-import { AnalysisOutputError } from "../../../src/domain/errors.js";+import { AnalysisOutputError } from "../../../src/domain/analysisErrorCore.js";import { err } from "../../../src/domain/result.js";import {diff --git a/tests/boundary/mcp/enhancedTools.callPathsAndBatches.test.ts b/tests/boundary/mcp/enhancedTools.callPathsAndBatches.test.tsindex 1ee7dc413..25d71764e 100644--- a/tests/boundary/mcp/enhancedTools.callPathsAndBatches.test.ts+++ b/tests/boundary/mcp/enhancedTools.callPathsAndBatches.test.ts@@ -2,7 +2,7 @@ import { afterEach, describe, expect, it } from "vitest";import type { AnalysisOperationPort } from "../../../src/application/AnalysisProvider.js";import { EnhancedTools } from "../../../src/application/EnhancedTools.js";-import { AnalysisOutputError } from "../../../src/domain/errors.js";+import { AnalysisOutputError } from "../../../src/domain/analysisErrorCore.js";import { err } from "../../../src/domain/result.js";import { closeEnhancedToolResources, connect } from "./enhancedToolsHarness.js";diff --git a/tests/boundary/mcp/officialTools.test.ts b/tests/boundary/mcp/officialTools.test.tsindex 95eac48ef..7c3c7caba 100644--- a/tests/boundary/mcp/officialTools.test.ts+++ b/tests/boundary/mcp/officialTools.test.ts@@ -3,7 +3,7 @@ import { afterEach, describe, expect, it } from "vitest";import type { AnalysisOperationPort } from "../../../src/application/AnalysisProvider.js";import { OFFICIAL_TOOL_CONTRACTS } from "../../../src/contracts/officialToolContracts.js";-import { HopperRemoteError } from "../../../src/domain/errors.js";+import { HopperRemoteError } from "../../../src/domain/hopperErrors.js";import { err } from "../../../src/domain/result.js";import { observed as ok } from "../../fixtures/analysisExecution.js";import type { JsonValue } from "../../../src/domain/jsonValue.js";diff --git a/tests/boundary/mcp/progressMcp.test.ts b/tests/boundary/mcp/progressMcp.test.tsindex f03ad83d5..ff0a94216 100644--- a/tests/boundary/mcp/progressMcp.test.ts+++ b/tests/boundary/mcp/progressMcp.test.ts@@ -2,7 +2,7 @@ import { Client, InMemoryTransport } from "@modelcontextprotocol/client";import { describe, expect, it } from "vitest";import type { AnalysisOperationPort } from "../../../src/application/AnalysisProvider.js";-import { AnalysisCancelledError } from "../../../src/domain/errors.js";+import { AnalysisCancelledError } from "../../../src/domain/analysisErrorCore.js";import { err } from "../../../src/domain/result.js";import { createServer } from "../../../src/server/createServer.js";import { observed } from "../../fixtures/analysisExecution.js";diff --git a/tests/boundary/mcp/serverLifecycleMcp.test.ts b/tests/boundary/mcp/serverLifecycleMcp.test.tsindex 539b1b1dc..af5ba7c13 100644--- a/tests/boundary/mcp/serverLifecycleMcp.test.ts+++ b/tests/boundary/mcp/serverLifecycleMcp.test.ts@@ -3,7 +3,7 @@ import type { CallToolResult } from "@modelcontextprotocol/server";import { afterEach, expect, it } from "vitest";import type { AnalysisOperationPort } from "../../../src/application/AnalysisProvider.js";-import { HopperRemoteError } from "../../../src/domain/errors.js";+import { HopperRemoteError } from "../../../src/domain/hopperErrors.js";import { err } from "../../../src/domain/result.js";import { observed as ok } from "../../fixtures/analysisExecution.js";import { createServer } from "../../../src/server/createServer.js";diff --git a/tests/boundary/mcp/serverUnknownsMcp.test.ts b/tests/boundary/mcp/serverUnknownsMcp.test.tsindex ecc905944..88286dd86 100644--- a/tests/boundary/mcp/serverUnknownsMcp.test.ts+++ b/tests/boundary/mcp/serverUnknownsMcp.test.ts@@ -9,7 +9,7 @@ import type {AnalysisProvider,CapabilityDescriptor,} from "../../../src/application/AnalysisProvider.js";-import { AnalysisCapabilityUnavailableError } from "../../../src/domain/errors.js";+import { AnalysisCapabilityUnavailableError } from "../../../src/domain/analysisErrorCore.js";import { err } from "../../../src/domain/result.js";import { observed as ok } from "../../fixtures/analysisExecution.js";import { createServer } from "../../../src/server/createServer.js";diff --git a/tests/boundary/mcp/toolResult.test.ts b/tests/boundary/mcp/toolResult.test.tsindex b4168d9a3..224f47380 100644--- a/tests/boundary/mcp/toolResult.test.ts+++ b/tests/boundary/mcp/toolResult.test.ts@@ -4,7 +4,7 @@ import { z } from "zod";import type { ToolContract } from "../../../src/contracts/toolContracts.js";import { ok } from "../../../src/domain/result.js";import { err } from "../../../src/domain/result.js";-import { HopperProcessError } from "../../../src/domain/errors.js";+import { HopperProcessError } from "../../../src/domain/hopperErrors.js";import { toCallToolResult } from "../../../src/server/toolResult.js";import { createEvidence, parseEvidence } from "../../../src/domain/evidence.js";import type { JsonValue } from "../../../src/domain/jsonValue.js";diff --git a/tests/boundary/providers/hopper/hopperClient.cleanup.test.ts b/tests/boundary/providers/hopper/hopperClient.cleanup.test.tsindex a7d8ff75f..ae8f3cd99 100644--- a/tests/boundary/providers/hopper/hopperClient.cleanup.test.ts+++ b/tests/boundary/providers/hopper/hopperClient.cleanup.test.ts@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";import { afterEach, describe, expect, it } from "vitest";-import { projectAnalysisError } from "../../../../src/domain/errors.js";+import { projectAnalysisError } from "../../../../src/domain/analysisErrorProjection.js";import { ok } from "../../../../src/domain/result.js";import type {BridgeLauncher,diff --git a/tests/boundary/providers/hopper/hopperClient.startupFailures.test.ts b/tests/boundary/providers/hopper/hopperClient.startupFailures.test.tsindex 226ab96a2..a0d157e1c 100644--- a/tests/boundary/providers/hopper/hopperClient.startupFailures.test.ts+++ b/tests/boundary/providers/hopper/hopperClient.startupFailures.test.ts@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";import { afterEach, describe, expect, it } from "vitest";-import { projectAnalysisError } from "../../../../src/domain/errors.js";+import { projectAnalysisError } from "../../../../src/domain/analysisErrorProjection.js";import type { HopperStartupDiagnostic } from "../../../../src/domain/hopperStartupFailure.js";import { ok } from "../../../../src/domain/result.js";import type {diff --git a/tests/composition/analysis-sessions/binarySession.test.ts b/tests/composition/analysis-sessions/binarySession.test.tsindex c0635deb9..0f6c47e53 100644--- a/tests/composition/analysis-sessions/binarySession.test.ts+++ b/tests/composition/analysis-sessions/binarySession.test.ts@@ -6,10 +6,8 @@ import type { BinarySession } from "../../../src/application/BinarySession.js";import type { JsonValue } from "../../../src/domain/jsonValue.js";import type { RecordUnknownInput } from "../../../src/domain/residualUnknown.js";import { createAnalysisProfile } from "../../../src/domain/analysisProfile.js";-import {- HopperStartError,- ProviderAdapterError,-} from "../../../src/domain/errors.js";+import { HopperStartError } from "../../../src/domain/hopperErrors.js";+import { ProviderAdapterError } from "../../../src/domain/providerAdapterError.js";import { ProviderCleanupError } from "../../../src/domain/providerCleanupError.js";import { err, ok as resultOk } from "../../../src/domain/result.js";import { observed as ok } from "../../fixtures/analysisExecution.js";diff --git a/tests/composition/analysis-sessions/providerBinding.test.ts b/tests/composition/analysis-sessions/providerBinding.test.tsindex f58f4ff13..e677f1609 100644--- a/tests/composition/analysis-sessions/providerBinding.test.ts+++ b/tests/composition/analysis-sessions/providerBinding.test.ts@@ -20,10 +20,8 @@ import type { BinarySession } from "../../../src/application/BinarySession.js";import { composeBinarySession } from "../../../src/application/BinarySessionComposition.js";import { SessionProviderRouter } from "../../../src/application/SessionProviderRouter.js";import { createAnalysisProfile } from "../../../src/domain/analysisProfile.js";-import {- AnalysisCancelledError,- ProviderAdapterError,-} from "../../../src/domain/errors.js";+import { AnalysisCancelledError } from "../../../src/domain/analysisErrorCore.js";+import { ProviderAdapterError } from "../../../src/domain/providerAdapterError.js";import { err, ok } from "../../../src/domain/result.js";type DeclaredOperation = Exclude<AnalysisOperation, "health">;diff --git a/tests/conformance/contracts/analysisErrorProjection.test.ts b/tests/conformance/contracts/analysisErrorProjection.test.tsindex ba8a38080..228cd7ca8 100644--- a/tests/conformance/contracts/analysisErrorProjection.test.ts+++ b/tests/conformance/contracts/analysisErrorProjection.test.ts@@ -2,14 +2,12 @@ import { describe, expect, it } from "vitest";import { ProcessCaptureError } from "../../../src/application/ProcessCaptureError.js";import { analysisErrorProjectionSchema } from "../../../src/contracts/errorSchemas.js";-import {- ArtifactOperationError,- EvidenceFileError,- HopperRemoteError,- UnknownRegistryError,- projectAnalysisError,- type AnalysisError,-} from "../../../src/domain/errors.js";+import { ArtifactOperationError } from "../../../src/domain/artifactOperationError.js";+import { EvidenceFileError } from "../../../src/domain/evidenceErrors.js";+import { HopperRemoteError } from "../../../src/domain/hopperErrors.js";+import { UnknownRegistryError } from "../../../src/domain/unknownRegistryError.js";+import { projectAnalysisError } from "../../../src/domain/analysisErrorProjection.js";+import { type AnalysisError } from "../../../src/domain/analysisErrorBase.js";describe("analysis error projection contract", () => {it("accepts every closed error-reason variant without exposing diagnostics", () => {diff --git a/tests/fixtures/binarySession.ts b/tests/fixtures/binarySession.tsindex a118a609a..1e6ee2a5b 100644--- a/tests/fixtures/binarySession.ts+++ b/tests/fixtures/binarySession.ts@@ -3,7 +3,8 @@ import { join } from "node:path";import { createAnalysisProfile } from "../../src/domain/analysisProfile.js";import type { BinaryTarget } from "../../src/domain/binaryTarget.js";-import type { AnalysisError } from "../../src/domain/errors.js";+import type { AnalysisError } from "../../src/domain/analysisErrorBase.js";+import { HopperStartError } from "../../src/domain/hopperErrors.js";import type { Result } from "../../src/domain/result.js";import type {AnalysisClient,@@ -15,7 +16,7 @@ import type {} from "../../src/application/AnalysisProvider.js";import { BinarySession } from "../../src/application/BinarySession.js";import { SessionProviderRouter } from "../../src/application/SessionProviderRouter.js";-import { HopperStartError } from "../../src/domain/errors.js";+import { err, ok as resultOk } from "../../src/domain/result.js";import { observed } from "./analysisExecution.js";import { createTestTempDirectory } from "./temporaryDirectory.js";diff --git a/tests/process-global/cliLogging.test.ts b/tests/process-global/cliLogging.test.tsindex 591f5a040..84363d3fd 100644--- a/tests/process-global/cliLogging.test.ts+++ b/tests/process-global/cliLogging.test.ts@@ -2,10 +2,8 @@ import { afterEach, describe, expect, it } from "vitest";import { logCliCommand } from "../../src/cliLogging.js";import { silentLogger } from "../../src/logger.js";-import {- ArtifactOperationError,- projectAnalysisError,-} from "../../src/domain/errors.js";+import { ArtifactOperationError } from "../../src/domain/artifactOperationError.js";+import { projectAnalysisError } from "../../src/domain/analysisErrorProjection.js";import { runSetup } from "../../src/application/Setup.js";import { isSetupFailure } from "../../src/application/SetupTypes.js";import {diff --git a/tests/support/applicationSessionFixture.ts b/tests/support/applicationSessionFixture.tsindex 364426a54..d7a23371a 100644--- a/tests/support/applicationSessionFixture.ts+++ b/tests/support/applicationSessionFixture.ts@@ -5,7 +5,7 @@ import { TextReader, Uint8ArrayWriter, ZipWriter } from "@zip.js/zip.js";import { expect } from "vitest";import { runProviderAnalysis } from "../../src/application/DirectAnalysis.js";-import type { AnalysisError } from "../../src/domain/errors.js";+import type { AnalysisError } from "../../src/domain/analysisErrorBase.js";import { type Evidence, parseEvidence } from "../../src/domain/evidence.js";import type { Result } from "../../src/domain/result.js";import { createTestTempDirectory } from "../fixtures/temporaryDirectory.js";