@unbrained/pm-cli 2026.8.10 → 2026.8.12

package/dist/sdk/generated/generated-error-code-catalog-part-1.js

@@ -0,0 +1,1585 @@
+/** Generated partition 1 of the exhaustive error-code catalog. */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1822a3b2-8164-56f7-96e3-d4c657f95fa6")}catch(e){}}();
+export const PM_ERROR_CODE_CATALOG_PART_1 = [
+    {
+        code: "acceptance_criteria_mutation_conflict",
+        meaning: "Acceptance criteria mutation conflict condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/update.ts"],
+        emitting_commands: ["update", "update-many"],
+        canonical_code: "acceptance_criteria_mutation_conflict",
+        aliases: [],
+    },
+    {
+        code: "acceptance_criteria_remove_unmatched",
+        meaning: "Acceptance criteria remove unmatched condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/update-many.ts", "sdk/lifecycle/update.ts"],
+        emitting_commands: ["update", "update-many"],
+        canonical_code: "acceptance_criteria_remove_unmatched",
+        aliases: [],
+    },
+    {
+        code: "acceptance_criteria_semicolon_forbidden",
+        meaning: "Acceptance criteria semicolon forbidden condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/item/parse.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "acceptance_criteria_semicolon_forbidden",
+        aliases: [],
+    },
+    {
+        code: "already_claimed_by",
+        meaning: "Already claimed by condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/claim.ts"],
+        emitting_commands: ["claim"],
+        canonical_code: "already_claimed_by",
+        aliases: [],
+    },
+    {
+        code: "ambiguous_list_all",
+        meaning: "Ambiguous list all condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/register-list-query.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "ambiguous_list_all",
+        aliases: [],
+    },
+    {
+        code: "ambiguous_option_combination",
+        meaning: "Ambiguous option combination condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/plan.ts"],
+        emitting_commands: ["plan"],
+        canonical_code: "ambiguous_option_combination",
+        aliases: [],
+    },
+    {
+        code: "annotation_alias_conflict",
+        meaning: "Annotation alias conflict condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/register-annotations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "annotation_alias_conflict",
+        aliases: [],
+    },
+    {
+        code: "annotation_flag_like_value",
+        meaning: "Annotation flag like value condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/annotations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "annotation_flag_like_value",
+        aliases: [],
+    },
+    {
+        code: "annotation_message_without_text",
+        meaning: "Annotation message without text condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/annotations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "annotation_message_without_text",
+        aliases: [],
+    },
+    {
+        code: "annotation_transposed_subcommand",
+        meaning: "Annotation transposed subcommand condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/register-annotations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "annotation_transposed_subcommand",
+        aliases: [],
+    },
+    {
+        code: "append_empty_body",
+        meaning: "Append empty body condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/append.ts"],
+        emitting_commands: ["append"],
+        canonical_code: "append_empty_body",
+        aliases: [],
+    },
+    {
+        code: "assurance_registry_invalid",
+        meaning: "Assurance registry invalid condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/governance/assurance.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "assurance_registry_invalid",
+        aliases: [],
+    },
+    {
+        code: "body_file_conflicts_with_body",
+        meaning: "Body file conflicts with body condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/body-file.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "body_file_conflicts_with_body",
+        aliases: [],
+    },
+    {
+        code: "body_file_missing_path",
+        meaning: "Body file missing path condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/body-file.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "body_file_missing_path",
+        aliases: [],
+    },
+    {
+        code: "body_file_unreadable",
+        meaning: "Body file unreadable condition.",
+        stability: "stable",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/body-file.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "body_file_unreadable",
+        aliases: [],
+    },
+    {
+        code: "bundle_integrity_torn_install",
+        meaning: "Bundle integrity torn install condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/bundle-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bundle_integrity_torn_install",
+        aliases: [],
+    },
+    {
+        code: "capability_undeclared",
+        meaning: "Capability undeclared condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/compose.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "capability_undeclared",
+        aliases: [],
+    },
+    {
+        code: "capability_unused",
+        meaning: "Capability unused condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/compose.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "capability_unused",
+        aliases: [],
+    },
+    {
+        code: "child_projection_item_bound_exceeded",
+        meaning: "Child projection item bound exceeded condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/item-children.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "child_projection_item_bound_exceeded",
+        aliases: [],
+    },
+    {
+        code: "close_reason_required",
+        meaning: "Close reason required condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle-policy.ts", "sdk/lifecycle/close-many.ts"],
+        emitting_commands: ["*", "close-many"],
+        canonical_code: "close_reason_required",
+        aliases: [],
+    },
+    {
+        code: "close_through_update",
+        meaning: "Close through update condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/telemetry/observability.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "close_through_update",
+        aliases: [],
+    },
+    {
+        code: "close_validation_missing_fields",
+        meaning: "Close validation missing fields condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/close.ts"],
+        emitting_commands: ["close"],
+        canonical_code: "close_validation_missing_fields",
+        aliases: [],
+    },
+    {
+        code: "collected_zero_items",
+        meaning: "Collected zero items condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/test/execution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "collected_zero_items",
+        aliases: [],
+    },
+    {
+        code: "collection_transposed_subcommand",
+        meaning: "Collection transposed subcommand condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "collection_transposed_subcommand",
+        aliases: [],
+    },
+    {
+        code: "command_failed",
+        meaning: "Command failed condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "command_failed",
+        aliases: [],
+    },
+    {
+        code: "command_namespace",
+        meaning: "Command namespace condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/runtime-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "command_namespace",
+        aliases: [],
+    },
+    {
+        code: "command_override_conflict",
+        meaning: "Command override conflict condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/compose.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "command_override_conflict",
+        aliases: [],
+    },
+    {
+        code: "config_duplicate",
+        meaning: "Config duplicate condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/profile/profile-lint.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "config_duplicate",
+        aliases: [],
+    },
+    {
+        code: "config_key_unknown",
+        meaning: "Config key unknown condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/profile/profile-lint.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "config_key_unknown",
+        aliases: [],
+    },
+    {
+        code: "config_value_invalid",
+        meaning: "Config value invalid condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/profile/profile-lint.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "config_value_invalid",
+        aliases: [],
+    },
+    {
+        code: "conflicting_lifecycle_owner",
+        meaning: "Conflicting lifecycle owner condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/register-operations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "conflicting_lifecycle_owner",
+        aliases: [],
+    },
+    {
+        code: "context_signal_store_invalid",
+        meaning: "Context signal store invalid condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/context-signal-store.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_signal_store_invalid",
+        aliases: [],
+    },
+    {
+        code: "context_signal_store_stale",
+        meaning: "Context signal store stale condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/context-signal-store.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_signal_store_stale",
+        aliases: [],
+    },
+    {
+        code: "context_signal_store_write_failed",
+        meaning: "Context signal store write failed condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/context-signal-store.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_signal_store_write_failed",
+        aliases: [],
+    },
+    {
+        code: "context_takes_no_item_argument",
+        meaning: "Context takes no item argument condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_takes_no_item_argument",
+        aliases: [],
+    },
+    {
+        code: "core_item_field_requires_dedicated_flag",
+        meaning: "Core item field requires dedicated flag condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/item-fields.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "core_item_field_requires_dedicated_flag",
+        aliases: [],
+    },
+    {
+        code: "create_positional_type_without_title",
+        meaning: "Create positional type without title condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/register-mutation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "create_positional_type_without_title",
+        aliases: [],
+    },
+    {
+        code: "dependency_edge_not_allowed",
+        meaning: "Dependency edge not allowed condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/dependency-flag-validation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "dependency_edge_not_allowed",
+        aliases: [],
+    },
+    {
+        code: "dependency_target_not_found",
+        meaning: "Dependency target not found condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/dependency-flag-validation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "dependency_target_not_found",
+        aliases: [],
+    },
+    {
+        code: "duplicate_command",
+        meaning: "Duplicate command condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/compose.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "duplicate_command",
+        aliases: [],
+    },
+    {
+        code: "duplicate_edge",
+        meaning: "Duplicate edge condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "duplicate_edge",
+        aliases: [],
+    },
+    {
+        code: "duplicate_sweep_cost_limit",
+        meaning: "Duplicate sweep cost limit condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/similarity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "duplicate_sweep_cost_limit",
+        aliases: [],
+    },
+    {
+        code: "duplicate_target_circular",
+        meaning: "Duplicate target circular condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/close.ts"],
+        emitting_commands: ["close"],
+        canonical_code: "duplicate_target_circular",
+        aliases: [],
+    },
+    {
+        code: "duplicate_target_is_duplicate",
+        meaning: "Duplicate target is duplicate condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/close.ts"],
+        emitting_commands: ["close"],
+        canonical_code: "duplicate_target_is_duplicate",
+        aliases: [],
+    },
+    {
+        code: "duplicate_target_missing",
+        meaning: "Duplicate target missing condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/close.ts"],
+        emitting_commands: ["close"],
+        canonical_code: "duplicate_target_missing",
+        aliases: [],
+    },
+    {
+        code: "duplicate_target_self",
+        meaning: "Duplicate target self condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/close.ts"],
+        emitting_commands: ["close"],
+        canonical_code: "duplicate_target_self",
+        aliases: [],
+    },
+    {
+        code: "empty_surface",
+        meaning: "Empty surface condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/compose.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "empty_surface",
+        aliases: [],
+    },
+    {
+        code: "event_cursor_query_mismatch",
+        meaning: "Event cursor query mismatch condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mutation-events.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "event_cursor_query_mismatch",
+        aliases: [],
+    },
+    {
+        code: "event_index_unavailable",
+        meaning: "Event index unavailable condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mutation-events.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "event_index_unavailable",
+        aliases: [],
+    },
+    {
+        code: "extension_command_activation_failed",
+        meaning: "Extension command activation failed condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/commander-usage.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_command_activation_failed",
+        aliases: [],
+    },
+    {
+        code: "extension_dependency_name_unsafe",
+        meaning: "Extension dependency name unsafe condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/install-sources.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_dependency_name_unsafe",
+        aliases: [],
+    },
+    {
+        code: "extension_dependency_spec_invalid",
+        meaning: "Extension dependency spec invalid condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/install-sources.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_dependency_spec_invalid",
+        aliases: [],
+    },
+    {
+        code: "extension_dependency_version_unsafe",
+        meaning: "Extension dependency version unsafe condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/install-sources.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_dependency_version_unsafe",
+        aliases: [],
+    },
+    {
+        code: "extension_install_soft_failed",
+        meaning: "Extension install soft failed condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/register-setup.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_install_soft_failed",
+        aliases: [],
+    },
+    {
+        code: "extension_install_source_contains_destination",
+        meaning: "Extension install source contains destination condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/install-runtime.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_install_source_contains_destination",
+        aliases: [],
+    },
+    {
+        code: "extension_item_field_reserved",
+        meaning: "Extension item field reserved condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/item-fields.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_item_field_reserved",
+        aliases: [],
+    },
+    {
+        code: "extension_item_field_type_conflict",
+        meaning: "Extension item field type conflict condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/item-fields.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_item_field_type_conflict",
+        aliases: [],
+    },
+    {
+        code: "extension_item_field_unknown",
+        meaning: "Extension item field unknown condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/item-fields.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_item_field_unknown",
+        aliases: [],
+    },
+    {
+        code: "extension_mutation_guard_failed",
+        meaning: "Extension mutation guard failed condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/extension-hook-runtime.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_mutation_guard_failed",
+        aliases: [],
+    },
+    {
+        code: "extension_mutation_guard_invalid_decision",
+        meaning: "Extension mutation guard invalid decision condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/extension-hook-runtime.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_mutation_guard_invalid_decision",
+        aliases: [],
+    },
+    {
+        code: "extension_mutation_guard_invalid_denial",
+        meaning: "Extension mutation guard invalid denial condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/extension-hook-runtime.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_mutation_guard_invalid_denial",
+        aliases: [],
+    },
+    {
+        code: "extension_mutation_guard_timed_out",
+        meaning: "Extension mutation guard timed out condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/extensions/extension-hook-runtime.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_mutation_guard_timed_out",
+        aliases: [],
+    },
+    {
+        code: "extension_update_health_partial_coverage",
+        meaning: "Extension update health partial coverage condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "extension_update_health_partial_coverage",
+        aliases: [],
+    },
+    {
+        code: "field_duplicate",
+        meaning: "Field duplicate condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/profile/profile-lint.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "field_duplicate",
+        aliases: [],
+    },
+    {
+        code: "field_invalid",
+        meaning: "Field invalid condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/profile/profile-lint.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "field_invalid",
+        aliases: [],
+    },
+    {
+        code: "field_mcp_input_collision",
+        meaning: "Field mcp input collision condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/profile/profile-lint.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "field_mcp_input_collision",
+        aliases: [],
+    },
+    {
+        code: "github_source_entry_unbuilt",
+        meaning: "Github source entry unbuilt condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/shared.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "github_source_entry_unbuilt",
+        aliases: [],
+    },
+    {
+        code: "history_author_acknowledge_required_values_missing",
+        meaning: "History author acknowledge required values missing condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/author-attribution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_author_acknowledge_required_values_missing",
+        aliases: [],
+    },
+    {
+        code: "history_author_acknowledge_selector_conflict",
+        meaning: "History author acknowledge selector conflict condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/author-attribution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_author_acknowledge_selector_conflict",
+        aliases: [],
+    },
+    {
+        code: "history_author_acknowledge_selector_required",
+        meaning: "History author acknowledge selector required condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/author-attribution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_author_acknowledge_selector_required",
+        aliases: [],
+    },
+    {
+        code: "history_author_acknowledge_target_not_actionable",
+        meaning: "History author acknowledge target not actionable condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/author-attribution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_author_acknowledge_target_not_actionable",
+        aliases: [],
+    },
+    {
+        code: "history_author_acknowledge_target_unreadable",
+        meaning: "History author acknowledge target unreadable condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/author-attribution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_author_acknowledge_target_unreadable",
+        aliases: [],
+    },
+    {
+        code: "history_drift_chain_mismatch",
+        meaning: "History drift chain mismatch condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_drift_chain_mismatch",
+        aliases: ["validate_history_drift_chain_mismatches"],
+    },
+    {
+        code: "history_drift_hash_mismatch",
+        meaning: "History drift hash mismatch condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_drift_hash_mismatch",
+        aliases: ["validate_history_drift_hash_mismatches"],
+    },
+    {
+        code: "history_drift_missing_stream",
+        meaning: "History drift missing stream condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_drift_missing_stream",
+        aliases: ["validate_history_drift_missing_streams"],
+    },
+    {
+        code: "history_drift_unreadable_stream",
+        meaning: "History drift unreadable stream condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_drift_unreadable_stream",
+        aliases: ["validate_history_drift_unreadable_streams"],
+    },
+    {
+        code: "history_merge_conflict_markers_detected",
+        meaning: "History merge conflict markers detected condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/history/read.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "merge_conflict_markers_detected",
+        aliases: [],
+    },
+    {
+        code: "history_stream_over_compact_threshold",
+        meaning: "History stream over compact threshold condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_stream_over_compact_threshold",
+        aliases: [],
+    },
+    {
+        code: "history_target_out_of_range",
+        meaning: "History target out of range condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/history/projection.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_target_out_of_range",
+        aliases: [],
+    },
+    {
+        code: "history_unknown_author_events",
+        meaning: "History unknown author events condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_unknown_author_events",
+        aliases: ["validate_history_unknown_author_events"],
+    },
+    {
+        code: "host_environment_capacity_fault",
+        meaning: "Host environment capacity fault condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/environment/host-environment-errors.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "host_environment_capacity_fault",
+        aliases: [],
+    },
+    {
+        code: "host_environment_operation_invalid",
+        meaning: "Host environment operation invalid condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/environment/host-environment-errors.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "host_environment_operation_invalid",
+        aliases: [],
+    },
+    {
+        code: "host_environment_permission_fault",
+        meaning: "Host environment permission fault condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/environment/host-environment-errors.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "host_environment_permission_fault",
+        aliases: [],
+    },
+    {
+        code: "host_environment_resource_fault",
+        meaning: "Host environment resource fault condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/environment/host-environment-errors.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "host_environment_resource_fault",
+        aliases: [],
+    },
+    {
+        code: "improvement_metric_contract_conflict",
+        meaning: "Improvement metric contract conflict condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "improvement_metric_contract_conflict",
+        aliases: [],
+    },
+    {
+        code: "improvement_observation_conflict",
+        meaning: "Improvement observation conflict condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "improvement_observation_conflict",
+        aliases: [],
+    },
+    {
+        code: "init_existing_settings_requires_force",
+        meaning: "Init existing settings requires force condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/init.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "init_existing_settings_requires_force",
+        aliases: [],
+    },
+    {
+        code: "init_gitignore_unwritable",
+        meaning: "Init gitignore unwritable condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/workspace.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "init_gitignore_unwritable",
+        aliases: [],
+    },
+    {
+        code: "init_id_prefix_conflict",
+        meaning: "Init id prefix conflict condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/init.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "init_id_prefix_conflict",
+        aliases: [],
+    },
+    {
+        code: "init_id_prefix_path_like",
+        meaning: "Init id prefix path like condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/init.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "init_id_prefix_path_like",
+        aliases: [],
+    },
+    {
+        code: "integrity_history_conflict_marker",
+        meaning: "Integrity history conflict marker condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_history_conflict_marker",
+        aliases: ["validate_storage_history_conflict_markers"],
+    },
+    {
+        code: "integrity_history_invalid_json",
+        meaning: "Integrity history invalid json condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_history_invalid_json",
+        aliases: [],
+    },
+    {
+        code: "integrity_history_unreadable",
+        meaning: "Integrity history unreadable condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_history_unreadable",
+        aliases: [],
+    },
+    {
+        code: "integrity_item_ahead_format_version",
+        meaning: "Integrity item ahead format version condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_item_ahead_format_version",
+        aliases: ["validate_format_version_ahead_items"],
+    },
+    {
+        code: "integrity_item_conflict_marker",
+        meaning: "Integrity item conflict marker condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_item_conflict_marker",
+        aliases: [],
+    },
+    {
+        code: "integrity_item_outdated_format_version",
+        meaning: "Integrity item outdated format version condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_item_outdated_format_version",
+        aliases: ["validate_format_version_outdated_items"],
+    },
+    {
+        code: "integrity_item_parse_failed",
+        meaning: "Integrity item parse failed condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_item_parse_failed",
+        aliases: [],
+    },
+    {
+        code: "integrity_item_unreadable",
+        meaning: "Integrity item unreadable condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "integrity_item_unreadable",
+        aliases: [],
+    },
+    {
+        code: "invalid_argument_value",
+        meaning: "Invalid argument value condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: [
+            "cli/error-guidance.ts",
+            "core/telemetry/observability.ts",
+            "sdk/context-intent-contracts.ts",
+            "sdk/governance/assurance-mutation-error.ts",
+            "sdk/lifecycle/create.ts",
+        ],
+        emitting_commands: ["*", "create"],
+        canonical_code: "invalid_argument_value",
+        aliases: [],
+    },
+    {
+        code: "invalid_command_usage",
+        meaning: "Invalid command usage condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts", "core/telemetry/observability.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_command_usage",
+        aliases: [],
+    },
+    {
+        code: "invalid_event_cursor",
+        meaning: "Invalid event cursor condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mutation-events.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_event_cursor",
+        aliases: [],
+    },
+    {
+        code: "invalid_event_follow_interval",
+        meaning: "Invalid event follow interval condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mutation-events.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_event_follow_interval",
+        aliases: [],
+    },
+    {
+        code: "invalid_event_limit",
+        meaning: "Invalid event limit condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mutation-events.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_event_limit",
+        aliases: [],
+    },
+    {
+        code: "invalid_event_since",
+        meaning: "Invalid event since condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mutation-events.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_event_since",
+        aliases: [],
+    },
+    {
+        code: "invalid_history_analytics_limit",
+        meaning: "Invalid history analytics limit condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/history-analytics.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_history_analytics_limit",
+        aliases: [],
+    },
+    {
+        code: "invalid_history_analytics_minimum_sample",
+        meaning: "Invalid history analytics minimum sample condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/history-analytics.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_history_analytics_minimum_sample",
+        aliases: [],
+    },
+    {
+        code: "invalid_history_analytics_since",
+        meaning: "Invalid history analytics since condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/history-analytics.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_history_analytics_since",
+        aliases: [],
+    },
+    {
+        code: "invalid_improvement_ledger",
+        meaning: "Invalid improvement ledger condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger-validation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_improvement_ledger",
+        aliases: [],
+    },
+    {
+        code: "invalid_improvement_metric",
+        meaning: "Invalid improvement metric condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_improvement_metric",
+        aliases: [],
+    },
+    {
+        code: "invalid_improvement_observation",
+        meaning: "Invalid improvement observation condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_improvement_observation",
+        aliases: [],
+    },
+    {
+        code: "invalid_improvement_observation_limit",
+        meaning: "Invalid improvement observation limit condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_improvement_observation_limit",
+        aliases: [],
+    },
+    {
+        code: "invalid_improvement_observation_timestamp",
+        meaning: "Invalid improvement observation timestamp condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/improvement-ledger.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_improvement_observation_timestamp",
+        aliases: [],
+    },
+    {
+        code: "invalid_provenance_predicate",
+        meaning: "Invalid provenance predicate condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/history-provenance.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_provenance_predicate",
+        aliases: [],
+    },
+    {
+        code: "invalid_query_cursor",
+        meaning: "Invalid query cursor condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/pagination.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_query_cursor",
+        aliases: [],
+    },
+    {
+        code: "invalid_read_output_session",
+        meaning: "Invalid read output session condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/read-output-session.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_read_output_session",
+        aliases: [],
+    },
+    {
+        code: "invalid_workspace_snapshot_target",
+        meaning: "Invalid workspace snapshot target condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/workspace-snapshot.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_workspace_snapshot_target",
+        aliases: [],
+    },
+    {
+        code: "item_document_invalid",
+        meaning: "Item document invalid condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/item/item-format.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "item_document_invalid",
+        aliases: [],
+    },
+    {
+        code: "item_document_roundtrip_failed",
+        meaning: "Item document roundtrip failed condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/item/item-format.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "item_document_roundtrip_failed",
+        aliases: [],
+    },
+    {
+        code: "item_id_collision",
+        meaning: "Item id collision condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/copy.ts"],
+        emitting_commands: ["copy"],
+        canonical_code: "item_id_collision",
+        aliases: [],
+    },
+    {
+        code: "item_not_found",
+        meaning: "Item not found condition.",
+        stability: "stable",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts", "core/telemetry/observability.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "item_not_found",
+        aliases: [],
+    },
+    {
+        code: "likely_duplicate",
+        meaning: "Likely duplicate condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/similarity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "likely_duplicate",
+        aliases: [],
+    },
+    {
+        code: "linked_test_remove_no_match",
+        meaning: "Linked test remove no match condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/test/execution.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "linked_test_remove_no_match",
+        aliases: [],
+    },
+    {
+        code: "linked_test_value_not_quoted",
+        meaning: "Linked test value not quoted condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "linked_test_value_not_quoted",
+        aliases: [],
+    },
+    {
+        code: "list_source_incomplete",
+        meaning: "List source incomplete condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/query/list.ts"],
+        emitting_commands: ["list"],
+        canonical_code: "list_source_incomplete",
+        aliases: [],
+    },
+    {
+        code: "local_package_archive_unsafe",
+        meaning: "Local package archive unsafe condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/install-sources.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "local_package_archive_unsafe",
+        aliases: [],
+    },
+    {
+        code: "local_source_not_found_bare_name",
+        meaning: "Local source not found bare name condition.",
+        stability: "stable",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/extension/install-sources.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "local_source_not_found_bare_name",
+        aliases: [],
+    },
+    {
+        code: "lock_conflict",
+        meaning: "Lock conflict condition.",
+        stability: "stable",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["cli/error-guidance.ts", "core/lock/lock.ts", "core/telemetry/observability.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "lock_conflict",
+        aliases: [],
+    },
+    {
+        code: "locks_stale_count",
+        meaning: "Locks stale count condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "locks_stale_count",
+        aliases: [],
+    },
+    {
+        code: "locks_unreadable",
+        meaning: "Locks unreadable condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "locks_unreadable",
+        aliases: [],
+    },
+    {
+        code: "malformed_plan_step_evidence",
+        meaning: "Malformed plan step evidence condition.",
+        stability: "stable",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/plan.ts"],
+        emitting_commands: ["plan"],
+        canonical_code: "malformed_plan_step_evidence",
+        aliases: [],
+    },
+    {
+        code: "manifest_capabilities_absent",
+        meaning: "Manifest capabilities absent condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/compose.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "manifest_capabilities_absent",
+        aliases: [],
+    },
+];
+//# sourceMappingURL=generated-error-code-catalog-part-1.js.map
+//# debugId=1822a3b2-8164-56f7-96e3-d4c657f95fa6