@unbrained/pm-cli 2026.8.7 → 2026.8.8

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

@@ -4,7 +4,7 @@
  * Generated by scripts/generate-error-code-catalog.mjs. Do not edit manually.
  */
 
-!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]="93c784d2-8f0f-5bf4-875e-3d83a675c9eb")}catch(e){}}();
+!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]="8a086b83-e46b-5694-be66-9114b0d87e12")}catch(e){}}();
 import { definePmErrorCodeCatalog } from "./error-code-catalog.js";
 /** Exhaustive catalog generated from literal error guidance declarations. */
 export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
@@ -17,6 +17,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -27,6 +29,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -37,6 +41,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -47,6 +53,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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_flag_like_value",
@@ -57,6 +65,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -67,6 +77,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: "append_empty_body",
@@ -77,6 +89,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: "body_file_conflicts_with_body",
@@ -87,6 +101,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -97,6 +113,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -107,6 +125,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -117,6 +137,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -127,6 +149,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -137,6 +161,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -147,6 +173,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -157,6 +185,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -167,6 +197,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -177,6 +209,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -187,6 +221,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: "command_failed",
@@ -197,6 +233,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -207,6 +245,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -217,6 +257,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -227,6 +269,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -237,6 +281,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -247,6 +293,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -257,6 +305,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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_takes_no_item_argument",
@@ -267,6 +317,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -277,6 +329,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -287,6 +341,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -297,6 +353,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: "duplicate_command",
@@ -307,6 +365,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -317,6 +377,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -327,6 +389,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -337,6 +401,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -347,6 +413,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -357,6 +425,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -367,6 +437,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -377,6 +449,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -387,6 +461,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -397,6 +473,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -407,6 +485,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -417,6 +497,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -427,6 +509,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -437,6 +521,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -447,6 +533,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -457,6 +545,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -467,6 +557,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -477,6 +569,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -487,6 +581,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -497,6 +593,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -507,6 +605,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -517,6 +617,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -527,6 +629,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -537,6 +641,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -547,6 +653,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -557,6 +665,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -567,6 +677,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -577,6 +689,32 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -585,8 +723,34 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         exit_code: 2,
         class: "usage",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["cli/register-history-author.ts"],
+        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",
@@ -597,6 +761,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -607,6 +773,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -617,6 +785,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -627,6 +797,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -637,6 +809,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -647,6 +821,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -657,6 +833,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -667,6 +845,56 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -677,6 +905,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -687,6 +917,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -697,6 +929,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -707,6 +941,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -717,6 +953,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -727,6 +965,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -737,6 +977,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -747,6 +989,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -757,6 +1001,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -767,6 +1013,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -777,6 +1025,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -787,6 +1037,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -797,6 +1049,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -807,6 +1061,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -822,6 +1078,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "sdk/lifecycle/create.ts",
         ],
         emitting_commands: ["*", "create"],
+        canonical_code: "invalid_argument_value",
+        aliases: [],
     },
     {
         code: "invalid_command_usage",
@@ -832,6 +1090,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -842,6 +1102,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -852,6 +1114,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -862,6 +1126,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -872,6 +1138,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -882,6 +1150,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -892,6 +1162,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -902,6 +1174,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -912,6 +1186,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -922,6 +1198,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -932,6 +1210,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -942,6 +1222,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -952,6 +1234,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -962,6 +1246,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -972,6 +1258,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -982,6 +1270,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -992,6 +1282,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1002,6 +1294,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1012,6 +1306,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1022,6 +1318,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1032,6 +1330,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1042,6 +1342,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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_value_not_quoted",
@@ -1052,6 +1354,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1062,6 +1366,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1072,6 +1378,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1082,6 +1390,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1096,6 +1406,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "core/telemetry/observability.ts",
         ],
         emitting_commands: ["*"],
+        canonical_code: "lock_conflict",
+        aliases: [],
     },
     {
         code: "locks_stale_count",
@@ -1106,6 +1418,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1116,6 +1430,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1126,6 +1442,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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",
@@ -1136,6 +1454,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/compose.ts"],
         emitting_commands: ["*"],
+        canonical_code: "manifest_capabilities_absent",
+        aliases: [],
     },
     {
         code: "merge_conflict_markers_detected",
@@ -1146,6 +1466,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/item/item-format.ts"],
         emitting_commands: ["*"],
+        canonical_code: "merge_conflict_markers_detected",
+        aliases: ["history_merge_conflict_markers_detected"],
     },
     {
         code: "merge_git_config_unwritable",
@@ -1156,6 +1478,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/merge/install.ts"],
         emitting_commands: ["*"],
+        canonical_code: "merge_git_config_unwritable",
+        aliases: [],
     },
     {
         code: "merge_root_not_found",
@@ -1166,6 +1490,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/merge/install.ts"],
         emitting_commands: ["*"],
+        canonical_code: "merge_root_not_found",
+        aliases: [],
     },
     {
         code: "missing_directory",
@@ -1176,6 +1502,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "missing_directory",
+        aliases: [],
     },
     {
         code: "missing_lifecycle_target",
@@ -1186,6 +1514,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/extension.ts"],
         emitting_commands: ["*"],
+        canonical_code: "missing_lifecycle_target",
+        aliases: [],
     },
     {
         code: "missing_required_argument",
@@ -1203,6 +1533,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "sdk/invocation-author.ts",
         ],
         emitting_commands: ["*"],
+        canonical_code: "missing_required_argument",
+        aliases: [],
     },
     {
         code: "missing_required_option",
@@ -1219,6 +1551,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "sdk/lifecycle/plan.ts",
         ],
         emitting_commands: ["*", "create", "plan"],
+        canonical_code: "missing_required_option",
+        aliases: [],
     },
     {
         code: "module_import_failed",
@@ -1229,6 +1563,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/error-guidance.ts"],
         emitting_commands: ["*"],
+        canonical_code: "module_import_failed",
+        aliases: [],
     },
     {
         code: "multi_target_github_install_ambiguous",
@@ -1239,6 +1575,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/register-setup.ts"],
         emitting_commands: ["*"],
+        canonical_code: "multi_target_github_install_ambiguous",
+        aliases: [],
     },
     {
         code: "mutation_author_required",
@@ -1249,6 +1587,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/mutation-guard.ts"],
         emitting_commands: ["*"],
+        canonical_code: "mutation_author_required",
+        aliases: [],
     },
     {
         code: "mutation_secret_guard_blocked",
@@ -1259,6 +1599,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/mutation-guard.ts"],
         emitting_commands: ["*"],
+        canonical_code: "mutation_secret_guard_blocked",
+        aliases: [],
     },
     {
         code: "no_matching_tests",
@@ -1269,6 +1611,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/test/execution.ts"],
         emitting_commands: ["*"],
+        canonical_code: "no_matching_tests",
+        aliases: [],
     },
     {
         code: "no_projects_matched_filters",
@@ -1279,6 +1623,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/test/execution.ts"],
         emitting_commands: ["*"],
+        canonical_code: "no_projects_matched_filters",
+        aliases: [],
     },
     {
         code: "no_test_files_found",
@@ -1289,6 +1635,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/test/execution.ts"],
         emitting_commands: ["*"],
+        canonical_code: "no_test_files_found",
+        aliases: [],
     },
     {
         code: "no_tests_found",
@@ -1299,6 +1647,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/test/execution.ts"],
         emitting_commands: ["*"],
+        canonical_code: "no_tests_found",
+        aliases: [],
     },
     {
         code: "no_update_fields",
@@ -1309,6 +1659,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/error-guidance.ts", "core/telemetry/observability.ts"],
         emitting_commands: ["*"],
+        canonical_code: "no_update_fields",
+        aliases: [],
     },
     {
         code: "npm_package_not_found",
@@ -1319,6 +1671,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/extension/install-sources.ts"],
         emitting_commands: ["*"],
+        canonical_code: "npm_package_not_found",
+        aliases: [],
     },
     {
         code: "ownership_conflict",
@@ -1333,6 +1687,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "sdk/annotations.ts",
         ],
         emitting_commands: ["*"],
+        canonical_code: "ownership_conflict",
+        aliases: [],
     },
     {
         code: "ownership_dependency_bypass_restricted_options",
@@ -1343,6 +1699,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/lifecycle/update.ts"],
         emitting_commands: ["update"],
+        canonical_code: "ownership_dependency_bypass_restricted_options",
+        aliases: [],
     },
     {
         code: "ownership_metadata_bypass_restricted_options",
@@ -1353,6 +1711,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/lifecycle/update.ts"],
         emitting_commands: ["update"],
+        canonical_code: "ownership_metadata_bypass_restricted_options",
+        aliases: [],
     },
     {
         code: "package_spec_empty",
@@ -1363,6 +1723,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "package_spec_empty",
+        aliases: [],
     },
     {
         code: "profile_name_empty",
@@ -1373,6 +1735,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "profile_name_empty",
+        aliases: [],
     },
     {
         code: "profile_name_not_normalized",
@@ -1383,6 +1747,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "profile_name_not_normalized",
+        aliases: [],
     },
     {
         code: "profile_summary_empty",
@@ -1393,6 +1759,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "profile_summary_empty",
+        aliases: [],
     },
     {
         code: "profile_title_empty",
@@ -1403,6 +1771,32 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "profile_title_empty",
+        aliases: [],
+    },
+    {
+        code: "project_runtime_stale_mutation",
+        meaning: "Project runtime stale mutation condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/environment/project-runtime-compatibility.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "project_runtime_stale_mutation",
+        aliases: [],
+    },
+    {
+        code: "project_runtime_stale_read",
+        meaning: "Project runtime stale read condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/environment/project-runtime-compatibility.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "project_runtime_stale_read",
+        aliases: [],
     },
     {
         code: "redundant_edge",
@@ -1413,6 +1807,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/graph/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "redundant_edge",
+        aliases: [],
     },
     {
         code: "reindex_already_running",
@@ -1423,6 +1819,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/governance/reindex.ts"],
         emitting_commands: ["*"],
+        canonical_code: "reindex_already_running",
+        aliases: [],
     },
     {
         code: "reserved_item_field",
@@ -1433,6 +1831,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/compose.ts"],
         emitting_commands: ["*"],
+        canonical_code: "reserved_item_field",
+        aliases: [],
     },
     {
         code: "schema_migration_input_required",
@@ -1443,6 +1843,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/migration-gates.ts"],
         emitting_commands: ["*"],
+        canonical_code: "schema_migration_input_required",
+        aliases: [],
     },
     {
         code: "settings_read_fs_error",
@@ -1453,6 +1855,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "settings_read_fs_error",
+        aliases: [],
     },
     {
         code: "settings_read_invalid_json",
@@ -1463,6 +1867,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "settings_read_invalid_json",
+        aliases: [],
     },
     {
         code: "settings_read_invalid_schema",
@@ -1473,6 +1879,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "settings_read_invalid_schema",
+        aliases: [],
     },
     {
         code: "settings_read_merge_failed",
@@ -1483,6 +1891,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "settings_read_merge_failed",
+        aliases: [],
     },
     {
         code: "status_duplicate",
@@ -1493,6 +1903,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "status_duplicate",
+        aliases: [],
     },
     {
         code: "status_invalid",
@@ -1503,6 +1915,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "status_invalid",
+        aliases: [],
     },
     {
         code: "stdin_json_invalid",
@@ -1513,6 +1927,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/structured-mutations.ts"],
         emitting_commands: ["*"],
+        canonical_code: "stdin_json_invalid",
+        aliases: [],
     },
     {
         code: "stdin_json_unknown_key",
@@ -1523,6 +1939,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/structured-mutations.ts"],
         emitting_commands: ["*"],
+        canonical_code: "stdin_json_unknown_key",
+        aliases: [],
     },
     {
         code: "structured_event_immutable",
@@ -1533,6 +1951,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/annotations.ts"],
         emitting_commands: ["*"],
+        canonical_code: "structured_event_immutable",
+        aliases: [],
     },
     {
         code: "structured_event_input_conflict",
@@ -1543,6 +1963,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/notes.ts"],
         emitting_commands: ["*"],
+        canonical_code: "structured_event_input_conflict",
+        aliases: [],
     },
     {
         code: "structured_event_json_empty",
@@ -1553,6 +1975,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/notes.ts"],
         emitting_commands: ["*"],
+        canonical_code: "structured_event_json_empty",
+        aliases: [],
     },
     {
         code: "structured_event_json_invalid",
@@ -1563,6 +1987,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/notes.ts"],
         emitting_commands: ["*"],
+        canonical_code: "structured_event_json_invalid",
+        aliases: [],
     },
     {
         code: "structured_event_since_invalid",
@@ -1573,6 +1999,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/notes.ts"],
         emitting_commands: ["*"],
+        canonical_code: "structured_event_since_invalid",
+        aliases: [],
     },
     {
         code: "telemetry_endpoint_probe_failed",
@@ -1583,6 +2011,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_endpoint_probe_failed",
+        aliases: [],
     },
     {
         code: "telemetry_endpoint_probe_http_status",
@@ -1593,6 +2023,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_endpoint_probe_http_status",
+        aliases: [],
     },
     {
         code: "telemetry_otel_export_failing",
@@ -1603,6 +2035,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_otel_export_failing",
+        aliases: [],
     },
     {
         code: "telemetry_queue_high_retries",
@@ -1613,6 +2047,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_queue_high_retries",
+        aliases: [],
     },
     {
         code: "telemetry_queue_invalid_rows",
@@ -1623,6 +2059,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_queue_invalid_rows",
+        aliases: [],
     },
     {
         code: "telemetry_queue_pending",
@@ -1633,6 +2071,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_queue_pending",
+        aliases: [],
     },
     {
         code: "telemetry_schema_version_behind",
@@ -1643,6 +2083,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_schema_version_behind",
+        aliases: [],
     },
     {
         code: "telemetry_state_invalid_json",
@@ -1653,6 +2095,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "telemetry_state_invalid_json",
+        aliases: [],
     },
     {
         code: "template_type_unknown",
@@ -1663,6 +2107,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "template_type_unknown",
+        aliases: [],
     },
     {
         code: "terminal_plan_mutation",
@@ -1673,6 +2119,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/lifecycle/plan.ts"],
         emitting_commands: ["plan"],
+        canonical_code: "terminal_plan_mutation",
+        aliases: [],
     },
     {
         code: "terminal_state_conflict",
@@ -1683,6 +2131,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/telemetry/observability.ts"],
         emitting_commands: ["*"],
+        canonical_code: "terminal_state_conflict",
+        aliases: [],
     },
     {
         code: "tracked_runtime_cache_files",
@@ -1693,6 +2143,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "tracked_runtime_cache_files",
+        aliases: ["validate_storage_tracked_runtime_cache_files"],
     },
     {
         code: "tracker_not_initialized",
@@ -1703,6 +2155,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/error-guidance.ts", "core/telemetry/observability.ts"],
         emitting_commands: ["*"],
+        canonical_code: "tracker_not_initialized",
+        aliases: [],
     },
     {
         code: "tracker_root_missing",
@@ -1713,6 +2167,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/store/item-store.ts"],
         emitting_commands: ["*"],
+        canonical_code: "tracker_root_missing",
+        aliases: [],
     },
     {
         code: "tracker_root_not_directory",
@@ -1723,6 +2179,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/store/item-store.ts"],
         emitting_commands: ["*"],
+        canonical_code: "tracker_root_not_directory",
+        aliases: [],
     },
     {
         code: "type_duplicate",
@@ -1733,6 +2191,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "type_duplicate",
+        aliases: [],
     },
     {
         code: "type_invalid",
@@ -1743,6 +2203,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "type_invalid",
+        aliases: [],
     },
     {
         code: "unknown_command",
@@ -1757,6 +2219,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "sdk/cli-contracts/runtime-contracts.ts",
         ],
         emitting_commands: ["*"],
+        canonical_code: "unknown_command",
+        aliases: [],
     },
     {
         code: "unknown_context_intent",
@@ -1767,6 +2231,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/context-intent-contracts.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_context_intent",
+        aliases: [],
     },
     {
         code: "unknown_error",
@@ -1777,6 +2243,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/error-guidance.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_error",
+        aliases: [],
     },
     {
         code: "unknown_field",
@@ -1787,6 +2255,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/schema.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_field",
+        aliases: [],
     },
     {
         code: "unknown_field_projection",
@@ -1797,6 +2267,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/query/get.ts", "sdk/query/list.ts"],
         emitting_commands: ["get", "list"],
+        canonical_code: "unknown_field_projection",
+        aliases: [],
     },
     {
         code: "unknown_item_type",
@@ -1807,6 +2279,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/schema.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_item_type",
+        aliases: [],
     },
     {
         code: "unknown_lifecycle_action",
@@ -1817,6 +2291,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/extension.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_lifecycle_action",
+        aliases: [],
     },
     {
         code: "unknown_option",
@@ -1827,6 +2303,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/error-guidance.ts", "core/telemetry/observability.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_option",
+        aliases: [],
     },
     {
         code: "unknown_plan_template",
@@ -1837,6 +2315,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/lifecycle/plan.ts"],
         emitting_commands: ["plan"],
+        canonical_code: "unknown_plan_template",
+        aliases: [],
     },
     {
         code: "unknown_provenance_dimension",
@@ -1847,6 +2327,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/history-provenance.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_provenance_dimension",
+        aliases: [],
     },
     {
         code: "unknown_status",
@@ -1857,6 +2339,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/schema.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unknown_status",
+        aliases: [],
     },
     {
         code: "unknown_subcommand",
@@ -1872,6 +2356,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
             "sdk/telemetry.ts",
         ],
         emitting_commands: ["*"],
+        canonical_code: "unknown_subcommand",
+        aliases: [],
     },
     {
         code: "unsupported_update_option",
@@ -1882,6 +2368,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["cli/error-guidance.ts"],
         emitting_commands: ["*"],
+        canonical_code: "unsupported_update_option",
+        aliases: [],
     },
     {
         code: "validate_command_references_stale_pm_ids",
@@ -1892,6 +2380,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_command_references_stale_pm_ids",
+        aliases: [],
     },
     {
         code: "validate_files_missing_linked_paths",
@@ -1902,6 +2392,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_files_missing_linked_paths",
+        aliases: [],
     },
     {
         code: "validate_files_orphaned_paths",
@@ -1912,6 +2404,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_files_orphaned_paths",
+        aliases: [],
     },
     {
         code: "validate_files_tracked_all_strict_forces_pm_internals",
@@ -1922,6 +2416,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_files_tracked_all_strict_forces_pm_internals",
+        aliases: [],
     },
     {
         code: "validate_format_version_ahead_items",
@@ -1932,6 +2428,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_format_version_outdated_items",
@@ -1942,6 +2440,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_hierarchy_parent_cycle",
@@ -1952,6 +2452,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_hierarchy_parent_cycle",
+        aliases: [],
     },
     {
         code: "validate_hierarchy_parent_cycle_error",
@@ -1962,6 +2464,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_hierarchy_parent_cycle_error",
+        aliases: [],
     },
     {
         code: "validate_history_drift_chain_mismatches",
@@ -1972,6 +2476,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_history_drift_hash_mismatches",
@@ -1982,6 +2488,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_history_drift_missing_streams",
@@ -1992,6 +2500,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_history_drift_unreadable_streams",
@@ -2002,6 +2512,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_history_unknown_author_events",
@@ -2012,6 +2524,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_lifecycle_active_closure_like_metadata",
@@ -2022,6 +2536,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_lifecycle_active_closure_like_metadata",
+        aliases: [],
     },
     {
         code: "validate_lifecycle_active_terminal_parent",
@@ -2032,6 +2548,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_lifecycle_active_terminal_parent",
+        aliases: [],
     },
     {
         code: "validate_lifecycle_dependency_cycles",
@@ -2042,6 +2560,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_lifecycle_dependency_cycles",
+        aliases: [],
     },
     {
         code: "validate_lifecycle_dependency_cycles_error",
@@ -2052,6 +2572,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_lifecycle_dependency_cycles_error",
+        aliases: [],
     },
     {
         code: "validate_lifecycle_stale_blockers",
@@ -2062,6 +2584,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_lifecycle_stale_blockers",
+        aliases: [],
     },
     {
         code: "validate_merge_fence_drift",
@@ -2072,6 +2596,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_merge_fence_drift",
+        aliases: [],
     },
     {
         code: "validate_metadata_custom_profile_missing_required_fields",
@@ -2082,6 +2608,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_custom_profile_missing_required_fields",
+        aliases: [],
     },
     {
         code: "validate_metadata_duplicate_issue_codes",
@@ -2092,6 +2620,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_duplicate_issue_codes",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_acceptance_criteria",
@@ -2102,6 +2632,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_acceptance_criteria",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_close_reason",
@@ -2112,6 +2644,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_close_reason",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_confidence",
@@ -2122,6 +2656,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_confidence",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_estimate",
@@ -2132,6 +2668,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_estimate",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_release",
@@ -2142,6 +2680,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_release",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_reviewer",
@@ -2152,6 +2692,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_reviewer",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_risk",
@@ -2162,6 +2704,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_risk",
+        aliases: [],
     },
     {
         code: "validate_metadata_missing_sprint",
@@ -2172,6 +2716,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_metadata_missing_sprint",
+        aliases: [],
     },
     {
         code: "validate_resolution_missing_fields",
@@ -2182,6 +2728,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_resolution_missing_fields",
+        aliases: [],
     },
     {
         code: "validate_storage_duplicate_item_ids",
@@ -2192,6 +2740,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_storage_duplicate_item_ids",
+        aliases: [],
     },
     {
         code: "validate_storage_history_conflict_markers",
@@ -2202,6 +2752,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         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: [],
     },
     {
         code: "validate_storage_resurrected_items",
@@ -2212,6 +2764,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_storage_resurrected_items",
+        aliases: [],
     },
     {
         code: "validate_storage_tracked_runtime_cache_files",
@@ -2222,6 +2776,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "tracked_runtime_cache_files",
+        aliases: [],
     },
     {
         code: "validate_storage_unparseable_config",
@@ -2232,6 +2788,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_storage_unparseable_config",
+        aliases: [],
     },
     {
         code: "validate_storage_unparseable_history",
@@ -2242,6 +2800,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_storage_unparseable_history",
+        aliases: [],
     },
     {
         code: "validate_storage_unreadable_items",
@@ -2252,6 +2812,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "validate_storage_unreadable_items",
+        aliases: [],
     },
     {
         code: "vectorization_embedding_identity_changed",
@@ -2262,6 +2824,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "vectorization_embedding_identity_changed",
+        aliases: [],
     },
     {
         code: "vectorization_stale_items_remaining",
@@ -2272,6 +2836,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
+        canonical_code: "vectorization_stale_items_remaining",
+        aliases: [],
     },
     {
         code: "workflow_duplicate_type",
@@ -2282,6 +2848,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workflow_duplicate_type",
+        aliases: [],
     },
     {
         code: "workflow_status_unknown",
@@ -2292,6 +2860,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workflow_status_unknown",
+        aliases: [],
     },
     {
         code: "workflow_transition_malformed",
@@ -2302,6 +2872,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workflow_transition_malformed",
+        aliases: [],
     },
     {
         code: "workflow_type_empty",
@@ -2312,6 +2884,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workflow_type_empty",
+        aliases: [],
     },
     {
         code: "workflow_type_unknown",
@@ -2322,6 +2896,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/profile/profile-lint.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workflow_type_unknown",
+        aliases: [],
     },
     {
         code: "workspace_history_state_conflict",
@@ -2332,6 +2908,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["core/history/workspace-history.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workspace_history_state_conflict",
+        aliases: [],
     },
     {
         code: "workspace_root_pm_path",
@@ -2342,6 +2920,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/init.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workspace_root_pm_path",
+        aliases: [],
     },
     {
         code: "workspace_snapshot_force_required",
@@ -2352,6 +2932,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/workspace-snapshot.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_force_required",
+        aliases: [],
     },
     {
         code: "workspace_snapshot_manifest_mismatch",
@@ -2362,6 +2944,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/workspace-snapshot.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_manifest_mismatch",
+        aliases: [],
     },
     {
         code: "workspace_snapshot_name_reserved_fingerprint",
@@ -2372,6 +2956,8 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/workspace-snapshot.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_name_reserved_fingerprint",
+        aliases: [],
     },
     {
         code: "workspace_snapshot_not_found",
@@ -2382,6 +2968,44 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/workspace-snapshot.ts"],
         emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_not_found",
+        aliases: [],
+    },
+    {
+        code: "workspace_snapshot_permission_denied",
+        meaning: "Workspace snapshot permission denied condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/workspace-snapshot.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_permission_denied",
+        aliases: [],
+    },
+    {
+        code: "workspace_snapshot_resource_exhausted",
+        meaning: "Workspace snapshot resource exhausted condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/workspace-snapshot.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_resource_exhausted",
+        aliases: [],
+    },
+    {
+        code: "workspace_snapshot_storage_exhausted",
+        meaning: "Workspace snapshot storage exhausted condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/workspace-snapshot.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "workspace_snapshot_storage_exhausted",
+        aliases: [],
     },
     {
         code: "wrong_item_type",
@@ -2392,7 +3016,9 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         recovery: "Inspect the structured error guidance and retry the suggested command.",
         sources: ["sdk/lifecycle/plan.ts"],
         emitting_commands: ["plan"],
+        canonical_code: "wrong_item_type",
+        aliases: [],
     },
 ]);
 //# sourceMappingURL=generated-error-code-catalog.js.map
-//# debugId=93c784d2-8f0f-5bf4-875e-3d83a675c9eb
+//# debugId=8a086b83-e46b-5694-be66-9114b0d87e12