taphound 0.2.0-dev.1 → 0.2.0-dev.12

package/dist/domain/external-flow.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { ExternalStepSchema } from "./journey.js";
+import { FlowNameSchema, IncludesSchema } from "./journey-composition.js";
+const QualifiedActivitySchema = z.string().regex(/^(?:[A-Za-z_$][\w$]*\.)+[A-Za-z_$][\w$]*$/, "Activity checkpoint must be fully qualified");
+const QualifiedNameSchema = z.string().regex(/^(?:[A-Za-z_$][\w$]*\.)+[A-Za-z_$][\w$]*$/, "Value must be fully qualified");
+export const ExternalFlowSchema = z.strictObject({
+    version: z.literal(1),
+    kind: z.literal("externalFlow"),
+    name: FlowNameSchema,
+    description: z.string().min(1),
+    escapedPackageName: QualifiedNameSchema,
+    expectedEscapeActivity: QualifiedActivitySchema.optional(),
+    includes: IncludesSchema,
+    steps: z.array(ExternalStepSchema).min(1)
+});

package/dist/domain/failure-classification.d.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+/**
+ * Failure taxonomy: the deterministic classification of a failed run.
+ *
+ * The taxonomy is driven by the failure code + report facts, never by a
+ * model. A Coding Agent consumes the structured classification, not raw logs
+ * (architecture doc §20).
+ */
+export declare const FailureTypeSchema: z.ZodEnum<{
+    timeout: "timeout";
+    launch: "launch";
+    target_not_found: "target_not_found";
+    target_ambiguous: "target_ambiguous";
+    target_unresolved: "target_unresolved";
+    activity_mismatch: "activity_mismatch";
+    app_crash: "app_crash";
+    environment_missing: "environment_missing";
+    capability_missing: "capability_missing";
+    interaction: "interaction";
+    action_failed: "action_failed";
+    expect_failed: "expect_failed";
+    checkpoint_failed: "checkpoint_failed";
+    contract_invalid: "contract_invalid";
+    evidence_failed: "evidence_failed";
+    alignment_failed: "alignment_failed";
+    collection_failed: "collection_failed";
+    internal_error: "internal_error";
+}>;
+export declare const FailureStageSchema: z.ZodEnum<{
+    unknown: "unknown";
+    evidence: "evidence";
+    navigation: "navigation";
+    launch: "launch";
+    interaction: "interaction";
+    setup: "setup";
+    assertion: "assertion";
+    finalize: "finalize";
+}>;
+export declare const FailureClassificationSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    classificationId: z.ZodString;
+    type: z.ZodEnum<{
+        timeout: "timeout";
+        launch: "launch";
+        target_not_found: "target_not_found";
+        target_ambiguous: "target_ambiguous";
+        target_unresolved: "target_unresolved";
+        activity_mismatch: "activity_mismatch";
+        app_crash: "app_crash";
+        environment_missing: "environment_missing";
+        capability_missing: "capability_missing";
+        interaction: "interaction";
+        action_failed: "action_failed";
+        expect_failed: "expect_failed";
+        checkpoint_failed: "checkpoint_failed";
+        contract_invalid: "contract_invalid";
+        evidence_failed: "evidence_failed";
+        alignment_failed: "alignment_failed";
+        collection_failed: "collection_failed";
+        internal_error: "internal_error";
+    }>;
+    stage: z.ZodEnum<{
+        unknown: "unknown";
+        evidence: "evidence";
+        navigation: "navigation";
+        launch: "launch";
+        interaction: "interaction";
+        setup: "setup";
+        assertion: "assertion";
+        finalize: "finalize";
+    }>;
+    code: z.ZodEnum<{
+        UI_BACKEND_UNAVAILABLE: "UI_BACKEND_UNAVAILABLE";
+        UI_SNAPSHOT_FAILED: "UI_SNAPSHOT_FAILED";
+        UI_SNAPSHOT_INVALID: "UI_SNAPSHOT_INVALID";
+        CONFIG_INVALID: "CONFIG_INVALID";
+        ENVIRONMENT_MISSING_TOOL: "ENVIRONMENT_MISSING_TOOL";
+        DEVICE_UNAVAILABLE: "DEVICE_UNAVAILABLE";
+        RUNTIME_CAPABILITY_MISSING: "RUNTIME_CAPABILITY_MISSING";
+        APP_NOT_INSTALLED: "APP_NOT_INSTALLED";
+        APP_LAUNCH_FAILED: "APP_LAUNCH_FAILED";
+        APP_CRASHED: "APP_CRASHED";
+        LOCATOR_NOT_FOUND: "LOCATOR_NOT_FOUND";
+        LOCATOR_AMBIGUOUS: "LOCATOR_AMBIGUOUS";
+        ANCHOR_NOT_FOUND: "ANCHOR_NOT_FOUND";
+        ANCHOR_AMBIGUOUS: "ANCHOR_AMBIGUOUS";
+        SCROLL_TARGET_NOT_FOUND: "SCROLL_TARGET_NOT_FOUND";
+        ACTION_FAILED: "ACTION_FAILED";
+        IDLE_TIMEOUT: "IDLE_TIMEOUT";
+        ACTIVITY_BEFORE_MISMATCH: "ACTIVITY_BEFORE_MISMATCH";
+        ACTIVITY_AFTER_MISMATCH: "ACTIVITY_AFTER_MISMATCH";
+        EXPECT_ACTIVITY_FAILED: "EXPECT_ACTIVITY_FAILED";
+        EXPECT_ELEMENT_FAILED: "EXPECT_ELEMENT_FAILED";
+        EXPECT_LOGCAT_FAILED: "EXPECT_LOGCAT_FAILED";
+        EXPECT_LOGCAT_AMBIGUOUS: "EXPECT_LOGCAT_AMBIGUOUS";
+        BRIDGE_NO_ESCAPE: "BRIDGE_NO_ESCAPE";
+        BRIDGE_NOT_RETURNED: "BRIDGE_NOT_RETURNED";
+        WAIT_TIMEOUT: "WAIT_TIMEOUT";
+        DEVICE_ROLE_UNMAPPED: "DEVICE_ROLE_UNMAPPED";
+        EXTERNAL_FLOW_NOT_FOUND: "EXTERNAL_FLOW_NOT_FOUND";
+        EXTERNAL_FLOW_STALE: "EXTERNAL_FLOW_STALE";
+        EXTERNAL_LOCATOR_STRICTNESS: "EXTERNAL_LOCATOR_STRICTNESS";
+        EXTERNAL_PACKAGE_MISMATCH: "EXTERNAL_PACKAGE_MISMATCH";
+        EXTERNAL_ACTIVITY_MISMATCH: "EXTERNAL_ACTIVITY_MISMATCH";
+        EXTERNAL_STEP_FAILED: "EXTERNAL_STEP_FAILED";
+        CONTEXT_INVALID: "CONTEXT_INVALID";
+        CONTEXT_STALE: "CONTEXT_STALE";
+        BRIEF_INVALID: "BRIEF_INVALID";
+        CONTEXT_MODULE_NOT_FOUND: "CONTEXT_MODULE_NOT_FOUND";
+        CONTEXT_MODULE_INCOMPLETE: "CONTEXT_MODULE_INCOMPLETE";
+        CONTEXT_SCHEMA_INVALID: "CONTEXT_SCHEMA_INVALID";
+        CONTEXT_IDENTITY_MISMATCH: "CONTEXT_IDENTITY_MISMATCH";
+        PROJECT_ROOT_UNREADABLE: "PROJECT_ROOT_UNREADABLE";
+        PROJECT_ROOT_NOT_DIRECTORY: "PROJECT_ROOT_NOT_DIRECTORY";
+        EVIDENCE_SECRET_PATH: "EVIDENCE_SECRET_PATH";
+        EVIDENCE_NOT_FOUND: "EVIDENCE_NOT_FOUND";
+        EVIDENCE_UNREADABLE: "EVIDENCE_UNREADABLE";
+        EVIDENCE_NOT_FILE: "EVIDENCE_NOT_FILE";
+        EVIDENCE_PATH_ESCAPE: "EVIDENCE_PATH_ESCAPE";
+        EVIDENCE_CHANGED_IDENTITY: "EVIDENCE_CHANGED_IDENTITY";
+        EVIDENCE_TOO_LARGE: "EVIDENCE_TOO_LARGE";
+        EVIDENCE_HASH_MISMATCH: "EVIDENCE_HASH_MISMATCH";
+        MANUAL_STEP_REQUIRED: "MANUAL_STEP_REQUIRED";
+        ALIGN_DEVICE_UNAVAILABLE: "ALIGN_DEVICE_UNAVAILABLE";
+        ALIGN_CAMERA_INTENT_FAILED: "ALIGN_CAMERA_INTENT_FAILED";
+        ALIGN_CAMERA_NOT_LAUNCHED: "ALIGN_CAMERA_NOT_LAUNCHED";
+        ALIGN_SHUTTER_NOT_FOUND: "ALIGN_SHUTTER_NOT_FOUND";
+        ALIGN_SHUTTER_AMBIGUOUS: "ALIGN_SHUTTER_AMBIGUOUS";
+        ALIGN_SHUTTER_NO_RESOURCE_ID: "ALIGN_SHUTTER_NO_RESOURCE_ID";
+        ALIGN_CONFIRM_NOT_FOUND: "ALIGN_CONFIRM_NOT_FOUND";
+        ALIGN_CONFIRM_AMBIGUOUS: "ALIGN_CONFIRM_AMBIGUOUS";
+        ALIGN_CONFIRM_NO_RESOURCE_ID: "ALIGN_CONFIRM_NO_RESOURCE_ID";
+        ALIGN_FLOW_EXISTS: "ALIGN_FLOW_EXISTS";
+        CONTRACT_INVALID: "CONTRACT_INVALID";
+        CONTRACT_JOURNEY_MISSING: "CONTRACT_JOURNEY_MISSING";
+        CONTRACT_JOURNEY_DRIFT: "CONTRACT_JOURNEY_DRIFT";
+        CONTRACT_EVIDENCE_INSUFFICIENT: "CONTRACT_EVIDENCE_INSUFFICIENT";
+        CONTRACT_KNOWLEDGE_UNAVAILABLE: "CONTRACT_KNOWLEDGE_UNAVAILABLE";
+        REPLAY_POLICY_UNAVAILABLE: "REPLAY_POLICY_UNAVAILABLE";
+        CHECKPOINT_FAILED: "CHECKPOINT_FAILED";
+        CHECKPOINT_UNRESOLVED: "CHECKPOINT_UNRESOLVED";
+        BASELINE_INCOMPARABLE: "BASELINE_INCOMPARABLE";
+        BASELINE_EMPTY: "BASELINE_EMPTY";
+        GIT_ROOT_NOT_FOUND: "GIT_ROOT_NOT_FOUND";
+        GIT_REF_INVALID: "GIT_REF_INVALID";
+        COLLECTION_FAILED: "COLLECTION_FAILED";
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+    }>;
+    message: z.ZodString;
+    stepIndex: z.ZodOptional<z.ZodNumber>;
+    expected: z.ZodOptional<z.ZodString>;
+    actual: z.ZodOptional<z.ZodString>;
+    locator: z.ZodOptional<z.ZodType<import("./layout.js").Locator, unknown, z.core.$ZodTypeInternals<import("./layout.js").Locator, unknown>>>;
+    evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    requestOutcome: z.ZodOptional<z.ZodObject<{
+        errorClass: z.ZodEnum<{
+            unknown: "unknown";
+            client: "client";
+            auth: "auth";
+            network: "network";
+            server: "server";
+        }>;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    sourceReportPath: z.ZodString;
+}, z.core.$strict>;
+export type FailureType = z.infer<typeof FailureTypeSchema>;
+export type FailureStage = z.infer<typeof FailureStageSchema>;
+export type FailureClassification = z.infer<typeof FailureClassificationSchema>;
+/** Canonical map from failure code to taxonomy type (deterministic). */
+export declare const FAILURE_CODE_TYPES: Readonly<Record<string, FailureType>>;
+/** Canonical map from failure type to likely stage (deterministic). */
+export declare const FAILURE_TYPE_STAGES: Readonly<Record<FailureType, FailureStage>>;
+/** Families that carry step-level detail (stepIndex / locator). */
+export declare const STEP_INDEXED_FAILURE_TYPES: ReadonlySet<FailureType>;

package/dist/domain/failure-classification.js

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { FAILURE_CODES } from "./failure.js";
+import { LocatorSchema } from "./layout.js";
+/**
+ * Failure taxonomy: the deterministic classification of a failed run.
+ *
+ * The taxonomy is driven by the failure code + report facts, never by a
+ * model. A Coding Agent consumes the structured classification, not raw logs
+ * (architecture doc §20).
+ */
+export const FailureTypeSchema = z.enum([
+    "target_not_found",
+    "target_ambiguous",
+    "target_unresolved",
+    "activity_mismatch",
+    "app_crash",
+    "launch",
+    "environment_missing",
+    "capability_missing",
+    "timeout",
+    "interaction",
+    "action_failed",
+    "expect_failed",
+    "checkpoint_failed",
+    "contract_invalid",
+    "evidence_failed",
+    "alignment_failed",
+    "collection_failed",
+    "internal_error"
+]);
+export const FailureStageSchema = z.enum([
+    "setup",
+    "launch",
+    "navigation",
+    "interaction",
+    "assertion",
+    "evidence",
+    "finalize",
+    "unknown"
+]);
+export const FailureClassificationSchema = z.strictObject({
+    version: z.literal(1),
+    runId: z.string().trim().min(1),
+    classificationId: z.string().trim().min(1),
+    type: FailureTypeSchema,
+    stage: FailureStageSchema,
+    code: z.enum(FAILURE_CODES),
+    message: z.string().trim().min(1),
+    stepIndex: z.number().int().nonnegative().optional(),
+    expected: z.string().trim().min(1).optional(),
+    actual: z.string().trim().min(1).optional(),
+    locator: LocatorSchema.optional(),
+    evidenceRefs: z.array(z.string().trim().min(1)).default([]),
+    requestOutcome: z.strictObject({
+        errorClass: z.enum(["client", "auth", "network", "server", "unknown"]),
+        evidenceRefs: z.array(z.string().trim().min(1))
+    }).optional(),
+    sourceReportPath: z.string().trim().min(1)
+});
+/** Canonical map from failure code to taxonomy type (deterministic). */
+export const FAILURE_CODE_TYPES = {
+    CONFIG_INVALID: "internal_error",
+    ENVIRONMENT_MISSING_TOOL: "environment_missing",
+    DEVICE_UNAVAILABLE: "environment_missing",
+    UI_BACKEND_UNAVAILABLE: "environment_missing",
+    RUNTIME_CAPABILITY_MISSING: "capability_missing",
+    UI_SNAPSHOT_FAILED: "environment_missing",
+    UI_SNAPSHOT_INVALID: "environment_missing",
+    APP_NOT_INSTALLED: "environment_missing",
+    APP_LAUNCH_FAILED: "launch",
+    APP_CRASHED: "app_crash",
+    LOCATOR_NOT_FOUND: "target_not_found",
+    LOCATOR_AMBIGUOUS: "target_ambiguous",
+    ANCHOR_NOT_FOUND: "target_unresolved",
+    ANCHOR_AMBIGUOUS: "target_ambiguous",
+    SCROLL_TARGET_NOT_FOUND: "target_not_found",
+    ACTION_FAILED: "interaction",
+    IDLE_TIMEOUT: "timeout",
+    ACTIVITY_BEFORE_MISMATCH: "activity_mismatch",
+    ACTIVITY_AFTER_MISMATCH: "activity_mismatch",
+    EXPECT_ACTIVITY_FAILED: "expect_failed",
+    EXPECT_ELEMENT_FAILED: "expect_failed",
+    EXPECT_LOGCAT_FAILED: "expect_failed",
+    EXPECT_LOGCAT_AMBIGUOUS: "expect_failed",
+    BRIDGE_NO_ESCAPE: "interaction",
+    BRIDGE_NOT_RETURNED: "timeout",
+    WAIT_TIMEOUT: "timeout",
+    DEVICE_ROLE_UNMAPPED: "environment_missing",
+    EXTERNAL_FLOW_NOT_FOUND: "target_not_found",
+    EXTERNAL_FLOW_STALE: "contract_invalid",
+    EXTERNAL_LOCATOR_STRICTNESS: "target_unresolved",
+    EXTERNAL_PACKAGE_MISMATCH: "activity_mismatch",
+    EXTERNAL_ACTIVITY_MISMATCH: "activity_mismatch",
+    EXTERNAL_STEP_FAILED: "interaction",
+    CONTEXT_INVALID: "internal_error",
+    CONTEXT_STALE: "contract_invalid",
+    BRIEF_INVALID: "contract_invalid",
+    CONTEXT_MODULE_NOT_FOUND: "internal_error",
+    CONTEXT_MODULE_INCOMPLETE: "internal_error",
+    CONTEXT_SCHEMA_INVALID: "internal_error",
+    CONTEXT_IDENTITY_MISMATCH: "contract_invalid",
+    PROJECT_ROOT_UNREADABLE: "environment_missing",
+    PROJECT_ROOT_NOT_DIRECTORY: "environment_missing",
+    EVIDENCE_SECRET_PATH: "evidence_failed",
+    EVIDENCE_NOT_FOUND: "evidence_failed",
+    EVIDENCE_UNREADABLE: "evidence_failed",
+    EVIDENCE_NOT_FILE: "evidence_failed",
+    EVIDENCE_PATH_ESCAPE: "evidence_failed",
+    EVIDENCE_CHANGED_IDENTITY: "evidence_failed",
+    EVIDENCE_TOO_LARGE: "evidence_failed",
+    EVIDENCE_HASH_MISMATCH: "evidence_failed",
+    MANUAL_STEP_REQUIRED: "timeout",
+    ALIGN_DEVICE_UNAVAILABLE: "alignment_failed",
+    ALIGN_CAMERA_INTENT_FAILED: "alignment_failed",
+    ALIGN_CAMERA_NOT_LAUNCHED: "alignment_failed",
+    ALIGN_SHUTTER_NOT_FOUND: "alignment_failed",
+    ALIGN_SHUTTER_AMBIGUOUS: "alignment_failed",
+    ALIGN_SHUTTER_NO_RESOURCE_ID: "alignment_failed",
+    ALIGN_CONFIRM_NOT_FOUND: "alignment_failed",
+    ALIGN_CONFIRM_AMBIGUOUS: "alignment_failed",
+    ALIGN_CONFIRM_NO_RESOURCE_ID: "alignment_failed",
+    ALIGN_FLOW_EXISTS: "alignment_failed",
+    GIT_ROOT_NOT_FOUND: "environment_missing",
+    GIT_REF_INVALID: "environment_missing",
+    CONTRACT_INVALID: "contract_invalid",
+    CONTRACT_JOURNEY_MISSING: "contract_invalid",
+    CONTRACT_JOURNEY_DRIFT: "contract_invalid",
+    CONTRACT_EVIDENCE_INSUFFICIENT: "evidence_failed",
+    CONTRACT_KNOWLEDGE_UNAVAILABLE: "capability_missing",
+    REPLAY_POLICY_UNAVAILABLE: "contract_invalid",
+    CHECKPOINT_FAILED: "checkpoint_failed",
+    CHECKPOINT_UNRESOLVED: "checkpoint_failed",
+    BASELINE_INCOMPARABLE: "contract_invalid",
+    BASELINE_EMPTY: "contract_invalid",
+    COLLECTION_FAILED: "collection_failed",
+    INTERNAL_ERROR: "internal_error"
+};
+/** Canonical map from failure type to likely stage (deterministic). */
+export const FAILURE_TYPE_STAGES = {
+    target_not_found: "interaction",
+    target_ambiguous: "interaction",
+    target_unresolved: "interaction",
+    activity_mismatch: "navigation",
+    app_crash: "launch",
+    launch: "launch",
+    environment_missing: "setup",
+    capability_missing: "setup",
+    timeout: "interaction",
+    interaction: "interaction",
+    action_failed: "interaction",
+    expect_failed: "assertion",
+    checkpoint_failed: "assertion",
+    contract_invalid: "setup",
+    evidence_failed: "evidence",
+    alignment_failed: "setup",
+    collection_failed: "evidence",
+    internal_error: "unknown"
+};
+/** Families that carry step-level detail (stepIndex / locator). */
+export const STEP_INDEXED_FAILURE_TYPES = new Set([
+    "target_not_found",
+    "target_ambiguous",
+    "target_unresolved",
+    "activity_mismatch",
+    "app_crash",
+    "timeout",
+    "expect_failed",
+    "checkpoint_failed"
+]);

package/dist/domain/failure.d.ts

@@ -1,4 +1,5 @@
-export declare const FAILURE_CODES: readonly ["CONFIG_INVALID", "ENVIRONMENT_MISSING_TOOL", "DEVICE_UNAVAILABLE", "APP_NOT_INSTALLED", "APP_LAUNCH_FAILED", "APP_CRASHED", "LOCATOR_NOT_FOUND", "LOCATOR_AMBIGUOUS", "SCROLL_TARGET_NOT_FOUND", "ACTION_FAILED", "IDLE_TIMEOUT", "ACTIVITY_BEFORE_MISMATCH", "ACTIVITY_AFTER_MISMATCH", "EXPECT_ACTIVITY_FAILED", "EXPECT_ELEMENT_FAILED", "EXPECT_LOGCAT_FAILED", "COLLECTION_FAILED", "INTERNAL_ERROR"];
+export declare const FAILURE_CODES: readonly ["CONFIG_INVALID", "ENVIRONMENT_MISSING_TOOL", "DEVICE_UNAVAILABLE", "UI_BACKEND_UNAVAILABLE", "RUNTIME_CAPABILITY_MISSING", "UI_SNAPSHOT_FAILED", "UI_SNAPSHOT_INVALID", "APP_NOT_INSTALLED", "APP_LAUNCH_FAILED", "APP_CRASHED", "LOCATOR_NOT_FOUND", "LOCATOR_AMBIGUOUS", "ANCHOR_NOT_FOUND", "ANCHOR_AMBIGUOUS", "SCROLL_TARGET_NOT_FOUND", "ACTION_FAILED", "IDLE_TIMEOUT", "ACTIVITY_BEFORE_MISMATCH", "ACTIVITY_AFTER_MISMATCH", "EXPECT_ACTIVITY_FAILED", "EXPECT_ELEMENT_FAILED", "EXPECT_LOGCAT_FAILED", "EXPECT_LOGCAT_AMBIGUOUS", "BRIDGE_NO_ESCAPE", "BRIDGE_NOT_RETURNED", "WAIT_TIMEOUT", "DEVICE_ROLE_UNMAPPED", "EXTERNAL_FLOW_NOT_FOUND", "EXTERNAL_FLOW_STALE", "EXTERNAL_LOCATOR_STRICTNESS", "EXTERNAL_PACKAGE_MISMATCH", "EXTERNAL_ACTIVITY_MISMATCH", "EXTERNAL_STEP_FAILED", "CONTEXT_INVALID", "CONTEXT_STALE", "BRIEF_INVALID", "CONTEXT_MODULE_NOT_FOUND", "CONTEXT_MODULE_INCOMPLETE", "CONTEXT_SCHEMA_INVALID", "CONTEXT_IDENTITY_MISMATCH", "PROJECT_ROOT_UNREADABLE", "PROJECT_ROOT_NOT_DIRECTORY", "EVIDENCE_SECRET_PATH", "EVIDENCE_NOT_FOUND", "EVIDENCE_UNREADABLE", "EVIDENCE_NOT_FILE", "EVIDENCE_PATH_ESCAPE", "EVIDENCE_CHANGED_IDENTITY", "EVIDENCE_TOO_LARGE", "EVIDENCE_HASH_MISMATCH", "MANUAL_STEP_REQUIRED", "ALIGN_DEVICE_UNAVAILABLE", "ALIGN_CAMERA_INTENT_FAILED", "ALIGN_CAMERA_NOT_LAUNCHED", "ALIGN_SHUTTER_NOT_FOUND", "ALIGN_SHUTTER_AMBIGUOUS", "ALIGN_SHUTTER_NO_RESOURCE_ID", "ALIGN_CONFIRM_NOT_FOUND", "ALIGN_CONFIRM_AMBIGUOUS", "ALIGN_CONFIRM_NO_RESOURCE_ID", "ALIGN_FLOW_EXISTS", "CONTRACT_INVALID", "CONTRACT_JOURNEY_MISSING", "CONTRACT_JOURNEY_DRIFT", "CONTRACT_EVIDENCE_INSUFFICIENT", "CONTRACT_KNOWLEDGE_UNAVAILABLE", "REPLAY_POLICY_UNAVAILABLE", "CHECKPOINT_FAILED", "CHECKPOINT_UNRESOLVED", "BASELINE_INCOMPARABLE", "BASELINE_EMPTY", "GIT_ROOT_NOT_FOUND", "GIT_REF_INVALID", "COLLECTION_FAILED", "INTERNAL_ERROR"];
 export type FailureCode = (typeof FAILURE_CODES)[number];
 export type TapHoundExitCode = 1 | 2 | 3 | 4;
 export declare function exitCodeForFailure(failure: FailureCode): TapHoundExitCode;
+export declare function failureCodeFromUnknown(error: unknown): FailureCode | undefined;

package/dist/domain/failure.js

@@ -2,11 +2,17 @@ export const FAILURE_CODES = [
     "CONFIG_INVALID",
     "ENVIRONMENT_MISSING_TOOL",
     "DEVICE_UNAVAILABLE",
+    "UI_BACKEND_UNAVAILABLE",
+    "RUNTIME_CAPABILITY_MISSING",
+    "UI_SNAPSHOT_FAILED",
+    "UI_SNAPSHOT_INVALID",
     "APP_NOT_INSTALLED",
     "APP_LAUNCH_FAILED",
     "APP_CRASHED",
     "LOCATOR_NOT_FOUND",
     "LOCATOR_AMBIGUOUS",
+    "ANCHOR_NOT_FOUND",
+    "ANCHOR_AMBIGUOUS",
     "SCROLL_TARGET_NOT_FOUND",
     "ACTION_FAILED",
     "IDLE_TIMEOUT",
@@ -15,6 +21,57 @@ export const FAILURE_CODES = [
     "EXPECT_ACTIVITY_FAILED",
     "EXPECT_ELEMENT_FAILED",
     "EXPECT_LOGCAT_FAILED",
+    "EXPECT_LOGCAT_AMBIGUOUS",
+    "BRIDGE_NO_ESCAPE",
+    "BRIDGE_NOT_RETURNED",
+    "WAIT_TIMEOUT",
+    "DEVICE_ROLE_UNMAPPED",
+    "EXTERNAL_FLOW_NOT_FOUND",
+    "EXTERNAL_FLOW_STALE",
+    "EXTERNAL_LOCATOR_STRICTNESS",
+    "EXTERNAL_PACKAGE_MISMATCH",
+    "EXTERNAL_ACTIVITY_MISMATCH",
+    "EXTERNAL_STEP_FAILED",
+    "CONTEXT_INVALID",
+    "CONTEXT_STALE",
+    "BRIEF_INVALID",
+    "CONTEXT_MODULE_NOT_FOUND",
+    "CONTEXT_MODULE_INCOMPLETE",
+    "CONTEXT_SCHEMA_INVALID",
+    "CONTEXT_IDENTITY_MISMATCH",
+    "PROJECT_ROOT_UNREADABLE",
+    "PROJECT_ROOT_NOT_DIRECTORY",
+    "EVIDENCE_SECRET_PATH",
+    "EVIDENCE_NOT_FOUND",
+    "EVIDENCE_UNREADABLE",
+    "EVIDENCE_NOT_FILE",
+    "EVIDENCE_PATH_ESCAPE",
+    "EVIDENCE_CHANGED_IDENTITY",
+    "EVIDENCE_TOO_LARGE",
+    "EVIDENCE_HASH_MISMATCH",
+    "MANUAL_STEP_REQUIRED",
+    "ALIGN_DEVICE_UNAVAILABLE",
+    "ALIGN_CAMERA_INTENT_FAILED",
+    "ALIGN_CAMERA_NOT_LAUNCHED",
+    "ALIGN_SHUTTER_NOT_FOUND",
+    "ALIGN_SHUTTER_AMBIGUOUS",
+    "ALIGN_SHUTTER_NO_RESOURCE_ID",
+    "ALIGN_CONFIRM_NOT_FOUND",
+    "ALIGN_CONFIRM_AMBIGUOUS",
+    "ALIGN_CONFIRM_NO_RESOURCE_ID",
+    "ALIGN_FLOW_EXISTS",
+    "CONTRACT_INVALID",
+    "CONTRACT_JOURNEY_MISSING",
+    "CONTRACT_JOURNEY_DRIFT",
+    "CONTRACT_EVIDENCE_INSUFFICIENT",
+    "CONTRACT_KNOWLEDGE_UNAVAILABLE",
+    "REPLAY_POLICY_UNAVAILABLE",
+    "CHECKPOINT_FAILED",
+    "CHECKPOINT_UNRESOLVED",
+    "BASELINE_INCOMPARABLE",
+    "BASELINE_EMPTY",
+    "GIT_ROOT_NOT_FOUND",
+    "GIT_REF_INVALID",
     "COLLECTION_FAILED",
     "INTERNAL_ERROR"
 ];
@@ -22,11 +79,17 @@ const EXIT_CODES = {
     CONFIG_INVALID: 2,
     ENVIRONMENT_MISSING_TOOL: 3,
     DEVICE_UNAVAILABLE: 3,
+    UI_BACKEND_UNAVAILABLE: 3,
+    RUNTIME_CAPABILITY_MISSING: 3,
+    UI_SNAPSHOT_FAILED: 3,
+    UI_SNAPSHOT_INVALID: 1,
     APP_NOT_INSTALLED: 3,
     APP_LAUNCH_FAILED: 1,
     APP_CRASHED: 1,
     LOCATOR_NOT_FOUND: 1,
     LOCATOR_AMBIGUOUS: 1,
+    ANCHOR_NOT_FOUND: 1,
+    ANCHOR_AMBIGUOUS: 1,
     SCROLL_TARGET_NOT_FOUND: 1,
     ACTION_FAILED: 1,
     IDLE_TIMEOUT: 1,
@@ -35,9 +98,69 @@ const EXIT_CODES = {
     EXPECT_ACTIVITY_FAILED: 1,
     EXPECT_ELEMENT_FAILED: 1,
     EXPECT_LOGCAT_FAILED: 1,
+    EXPECT_LOGCAT_AMBIGUOUS: 1,
+    BRIDGE_NO_ESCAPE: 1,
+    BRIDGE_NOT_RETURNED: 1,
+    WAIT_TIMEOUT: 1,
+    DEVICE_ROLE_UNMAPPED: 3,
+    EXTERNAL_FLOW_NOT_FOUND: 2,
+    EXTERNAL_FLOW_STALE: 2,
+    EXTERNAL_LOCATOR_STRICTNESS: 2,
+    EXTERNAL_PACKAGE_MISMATCH: 1,
+    EXTERNAL_ACTIVITY_MISMATCH: 1,
+    EXTERNAL_STEP_FAILED: 1,
+    MANUAL_STEP_REQUIRED: 1,
+    ALIGN_DEVICE_UNAVAILABLE: 2,
+    ALIGN_CAMERA_INTENT_FAILED: 2,
+    ALIGN_CAMERA_NOT_LAUNCHED: 2,
+    ALIGN_SHUTTER_NOT_FOUND: 2,
+    ALIGN_SHUTTER_AMBIGUOUS: 2,
+    ALIGN_SHUTTER_NO_RESOURCE_ID: 2,
+    ALIGN_CONFIRM_NOT_FOUND: 2,
+    ALIGN_CONFIRM_AMBIGUOUS: 2,
+    ALIGN_CONFIRM_NO_RESOURCE_ID: 2,
+    ALIGN_FLOW_EXISTS: 2,
+    CONTRACT_INVALID: 2,
+    CONTRACT_JOURNEY_MISSING: 2,
+    CONTRACT_JOURNEY_DRIFT: 2,
+    CONTRACT_EVIDENCE_INSUFFICIENT: 2,
+    CONTRACT_KNOWLEDGE_UNAVAILABLE: 2,
+    REPLAY_POLICY_UNAVAILABLE: 2,
+    CHECKPOINT_FAILED: 1,
+    CHECKPOINT_UNRESOLVED: 1,
+    BASELINE_INCOMPARABLE: 2,
+    BASELINE_EMPTY: 2,
+    GIT_ROOT_NOT_FOUND: 2,
+    GIT_REF_INVALID: 2,
+    CONTEXT_INVALID: 2,
+    CONTEXT_STALE: 2,
+    BRIEF_INVALID: 2,
+    CONTEXT_MODULE_NOT_FOUND: 2,
+    CONTEXT_MODULE_INCOMPLETE: 2,
+    CONTEXT_SCHEMA_INVALID: 2,
+    CONTEXT_IDENTITY_MISMATCH: 2,
+    PROJECT_ROOT_UNREADABLE: 2,
+    PROJECT_ROOT_NOT_DIRECTORY: 2,
+    EVIDENCE_SECRET_PATH: 2,
+    EVIDENCE_NOT_FOUND: 2,
+    EVIDENCE_UNREADABLE: 2,
+    EVIDENCE_NOT_FILE: 2,
+    EVIDENCE_PATH_ESCAPE: 2,
+    EVIDENCE_CHANGED_IDENTITY: 2,
+    EVIDENCE_TOO_LARGE: 2,
+    EVIDENCE_HASH_MISMATCH: 2,
     COLLECTION_FAILED: 1,
     INTERNAL_ERROR: 4
 };
 export function exitCodeForFailure(failure) {
     return EXIT_CODES[failure];
 }
+export function failureCodeFromUnknown(error) {
+    if (error === null
+        || typeof error !== "object"
+        || !("code" in error)
+        || typeof error.code !== "string") {
+        return undefined;
+    }
+    return FAILURE_CODES.find((code) => code === error.code);
+}