@unbrained/pm-cli 2026.9.25 → 2026.9.27

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

@@ -1,2 +1,2 @@
-!(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]="5ee07a8c-75d5-5da8-822f-344e2bdf6a58")}catch(e2){}})();const PM_ERROR_CODE_CATALOG_PART_2=[{code:"missing_allowed_values",meaning:"Missing allowed values condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"missing_allowed_values",aliases:[]},{code:"missing_budget",meaning:"Missing budget condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_budget",aliases:[]},{code:"missing_cli_flag",meaning:"Missing cli flag condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/tool-option-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_cli_flag",aliases:[]},{code:"missing_destination",meaning:"Missing destination condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_destination",aliases:[]},{code:"missing_directory",meaning:"Missing directory condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"missing_directory",aliases:[]},{code:"missing_init_recovery",meaning:"Missing init recovery condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_init_recovery",aliases:[]},{code:"missing_lifecycle_target",meaning:"Missing lifecycle target condition.",stability:"stable",exit_code:2,class:"usage",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_observation",meaning:"Missing observation condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/flag-invocation-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_observation",aliases:[]},{code:"missing_observed_signature",meaning:"Missing observed signature condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_observed_signature",aliases:[]},{code:"missing_parameter_alias",meaning:"Missing parameter alias condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/tool-option-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_parameter_alias",aliases:[]},{code:"missing_positive_execution_receipt",meaning:"Missing positive execution receipt condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"missing_positive_execution_receipt",aliases:[]},{code:"missing_probe",meaning:"Missing probe condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_probe",aliases:[]},{code:"missing_required_argument",meaning:"Missing required argument condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","cli/main.ts","cli/register-mutation.ts","cli/schema/registration.ts","core/telemetry/observability.ts","sdk/governance/assurance-action.ts","sdk/history-redact.ts","sdk/invocation-author.ts"],emitting_commands:["*"],canonical_code:"missing_required_argument",aliases:[]},{code:"missing_required_option",meaning:"Missing required option condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts","sdk/context-intent-contracts.ts","sdk/lifecycle/create.ts","sdk/lifecycle/plan.ts"],emitting_commands:["*","create","plan"],canonical_code:"missing_required_option",aliases:[]},{code:"missing_suggested_retry",meaning:"Missing suggested retry condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"missing_suggested_retry",aliases:[]},{code:"missing_suggested_retry_args",meaning:"Missing suggested retry args condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"missing_suggested_retry_args",aliases:[]},{code:"module_import_failed",meaning:"Module import failed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts"],emitting_commands:["*"],canonical_code:"module_import_failed",aliases:[]},{code:"multi_target_github_install_ambiguous",meaning:"Multi target github install ambiguous condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Mutation author required condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Mutation secret guard blocked condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"No matching tests condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_matching_tests",aliases:[]},{code:"no_projects_matched_filters",meaning:"No projects matched filters condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_projects_matched_filters",aliases:[]},{code:"no_test_files_found",meaning:"No test files found condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_test_files_found",aliases:[]},{code:"no_tests_found",meaning:"No tests found condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_tests_found",aliases:[]},{code:"no_update_fields",meaning:"No update fields condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts"],emitting_commands:["*"],canonical_code:"no_update_fields",aliases:[]},{code:"no_version_bounds_declared",meaning:"No version bounds declared condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/extensions/manifest-schema.ts"],emitting_commands:["*"],canonical_code:"no_version_bounds_declared",aliases:[],owned_states:[{state:"author_workspace_manifest_omits_canonical_pm_version_bounds",probe_id:"author-manifest-version-bounds-missing",entrypoints:["health"],expected_exit_class:"generic_failure"}]},{code:"non_refusal_exit",meaning:"Non refusal exit condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"non_refusal_exit",aliases:[]},{code:"npm_pack_json_shape_unsupported",meaning:"Npm pack json shape unsupported condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_pack_json_shape_unsupported",aliases:[]},{code:"npm_package_archive_missing",meaning:"Npm package archive missing condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_package_archive_missing",aliases:[]},{code:"npm_package_archive_unsafe",meaning:"Npm package archive unsafe condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_package_archive_unsafe",aliases:[]},{code:"npm_package_not_found",meaning:"Npm package not found condition.",stability:"stable",exit_code:3,class:"not_found",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_package_not_found",aliases:[]},{code:"ownership_conflict",meaning:"Ownership conflict condition.",stability:"stable",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts","sdk/annotations.ts"],emitting_commands:["*"],canonical_code:"ownership_conflict",aliases:[]},{code:"ownership_dependency_bypass_restricted_options",meaning:"Ownership dependency bypass restricted options condition.",stability:"stable",exit_code:1,class:"generic_failure",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",meaning:"Ownership metadata bypass restricted options condition.",stability:"stable",exit_code:1,class:"generic_failure",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",meaning:"Package spec empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"package_spec_empty",aliases:[]},{code:"package_upgrade_modes_mutually_exclusive",meaning:"Package upgrade modes mutually exclusive condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/governance/upgrade.ts"],emitting_commands:["*"],canonical_code:"package_upgrade_modes_mutually_exclusive",aliases:[]},{code:"positional_shape_budget_exceeded",meaning:"Positional shape budget exceeded condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"positional_shape_budget_exceeded",aliases:[]},{code:"positional_signature_mismatch",meaning:"Positional signature mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"positional_signature_mismatch",aliases:[]},{code:"profile_name_empty",meaning:"Profile name empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_name_empty",aliases:[]},{code:"profile_name_not_normalized",meaning:"Profile name not normalized condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_name_not_normalized",aliases:[]},{code:"profile_summary_empty",meaning:"Profile summary empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_summary_empty",aliases:[]},{code:"profile_title_empty",meaning:"Profile title empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_title_empty",aliases:[]},{code:"project_runtime_history_epoch_incompatible",meaning:"Project runtime history epoch incompatible 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_history_epoch_incompatible",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:"projection_options_mutually_exclusive",meaning:"Projection options mutually exclusive condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/query/get.ts","sdk/query/list.ts","sdk/query/search-contracts.ts"],emitting_commands:["get","list","search"],canonical_code:"projection_options_mutually_exclusive",aliases:[]},{code:"provenance_value_domain_invalid",meaning:"Provenance value domain invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"provenance_value_domain_invalid",aliases:[]},{code:"read_output_cursor_command_mismatch",meaning:"Read output cursor command mismatch condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/read-output/continuation.ts"],emitting_commands:["*"],canonical_code:"read_output_cursor_command_mismatch",aliases:[]},{code:"read_output_cursor_invalid",meaning:"Read output cursor invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/read-output/continuation.ts"],emitting_commands:["*"],canonical_code:"read_output_cursor_invalid",aliases:[]},{code:"read_output_cursor_stale",meaning:"Read output cursor stale condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/read-output/continuation.ts"],emitting_commands:["*"],canonical_code:"read_output_cursor_stale",aliases:[]},{code:"recovery_kind_mismatch",meaning:"Recovery kind mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"recovery_kind_mismatch",aliases:[]},{code:"redundant_edge",meaning:"Redundant edge condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/graph/remediation.ts"],emitting_commands:["*"],canonical_code:"redundant_edge",aliases:[]},{code:"refusal_allowed_values_mismatch",meaning:"Refusal allowed values mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_allowed_values_mismatch",aliases:[]},{code:"refusal_error_code_mismatch",meaning:"Refusal error code mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_error_code_mismatch",aliases:[]},{code:"refusal_exit_code_mismatch",meaning:"Refusal exit code mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_exit_code_mismatch",aliases:[]},{code:"refusal_mutated_state",meaning:"Refusal mutated state condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_mutated_state",aliases:[]},{code:"refusal_probe_missing",meaning:"Refusal probe missing condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_probe_missing",aliases:[]},{code:"refusal_recovery_failed",meaning:"Refusal recovery failed condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_recovery_failed",aliases:[]},{code:"reindex_already_running",meaning:"Reindex already running condition.",stability:"stable",exit_code:4,class:"conflict",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:"removed_canonical_spelling",meaning:"Removed canonical spelling condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"removed_canonical_spelling",aliases:[]},{code:"removed_compatibility_spelling",meaning:"Removed compatibility spelling condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"removed_compatibility_spelling",aliases:[]},{code:"reopen_reason_required",meaning:"Reopen reason required condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/reopen.ts"],emitting_commands:["item reopen"],canonical_code:"reopen_reason_required",aliases:[]},{code:"reopen_receipt_missing",meaning:"Reopen receipt missing condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/update.ts"],emitting_commands:["update"],canonical_code:"reopen_receipt_missing",aliases:[]},{code:"reopen_target_status_invalid",meaning:"Reopen target status invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/reopen.ts"],emitting_commands:["item reopen"],canonical_code:"reopen_target_status_invalid",aliases:[]},{code:"reported_zero_passes",meaning:"Reported zero passes condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"reported_zero_passes",aliases:[]},{code:"reported_zero_tests",meaning:"Reported zero tests condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"reported_zero_tests",aliases:[]},{code:"reserved_item_field",meaning:"Reserved item field condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/compose.ts"],emitting_commands:["*"],canonical_code:"reserved_item_field",aliases:[]},{code:"retry_failed",meaning:"Retry failed condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts","sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"retry_failed",aliases:[]},{code:"schema_migration_input_required",meaning:"Schema migration input required condition.",stability:"stable",exit_code:2,class:"usage",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:"semantic_spelling_collision",meaning:"Semantic spelling collision condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"semantic_spelling_collision",aliases:[]},{code:"settings_read_fs_error",meaning:"Settings read fs error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_fs_error",aliases:[]},{code:"settings_read_invalid_json",meaning:"Settings read invalid json condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_invalid_json",aliases:[]},{code:"settings_read_invalid_schema",meaning:"Settings read invalid schema condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_invalid_schema",aliases:[]},{code:"settings_read_merge_failed",meaning:"Settings read merge failed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_merge_failed",aliases:[]},{code:"stale_budget",meaning:"Stale budget condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"stale_budget",aliases:[]},{code:"stale_destination",meaning:"Stale destination condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"stale_destination",aliases:[]},{code:"stale_observed_signature",meaning:"Stale observed signature condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"stale_observed_signature",aliases:[]},{code:"status_duplicate",meaning:"Status duplicate condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"status_duplicate",aliases:[]},{code:"status_invalid",meaning:"Status invalid condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"status_invalid",aliases:[]},{code:"status_lifecycle_role_required",meaning:"Status lifecycle role required condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/schema.ts"],emitting_commands:["*"],canonical_code:"status_lifecycle_role_required",aliases:[]},{code:"stdin_json_invalid",meaning:"Stdin json invalid condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Stdin json unknown key condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event immutable condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/annotations.ts"],emitting_commands:["*"],canonical_code:"structured_event_immutable",aliases:[]},{code:"structured_event_input_conflict",meaning:"Structured event input conflict condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event json empty condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event json invalid condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event since invalid condition.",stability:"stable",exit_code:2,class:"usage",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:"suggested_retry_args_mismatch",meaning:"Suggested retry args mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"suggested_retry_args_mismatch",aliases:[]},{code:"telemetry_endpoint_probe_failed",meaning:"Telemetry endpoint probe failed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_endpoint_probe_failed",aliases:[]},{code:"telemetry_endpoint_probe_http_status",meaning:"Telemetry endpoint probe http status condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_endpoint_probe_http_status",aliases:[]},{code:"telemetry_otel_export_failing",meaning:"Telemetry otel export failing condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_otel_export_failing",aliases:[]},{code:"telemetry_queue_high_retries",meaning:"Telemetry queue high retries condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_queue_high_retries",aliases:[]},{code:"telemetry_queue_invalid_rows",meaning:"Telemetry queue invalid rows condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_queue_invalid_rows",aliases:[]},{code:"telemetry_queue_pending",meaning:"Telemetry queue pending condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_queue_pending",aliases:[]},{code:"telemetry_schema_version_behind",meaning:"Telemetry schema version behind condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_schema_version_behind",aliases:[]},{code:"telemetry_state_invalid_json",meaning:"Telemetry state invalid json condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_state_invalid_json",aliases:[]},{code:"template_type_unknown",meaning:"Template type unknown condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"template_type_unknown",aliases:[]},{code:"terminal_plan_mutation",meaning:"Terminal plan mutation condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"Terminal state conflict condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"Tracked runtime cache files condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"tracked_runtime_cache_files",aliases:["validate_storage_tracked_runtime_cache_files"]},{code:"tracker_not_initialized",meaning:"Tracker not initialized condition.",stability:"stable",exit_code:3,class:"not_found",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/store/tracker-preflight.ts","core/telemetry/observability.ts"],emitting_commands:["*"],canonical_code:"tracker_not_initialized",aliases:[],owned_states:[{state:"selected_tracker_root_exists_without_settings",probe_id:"tracker-root-settings-missing",entrypoints:["list"],expected_exit_class:"not_found"}]},{code:"tracker_root_missing",meaning:"Tracker root missing condition.",stability:"stable",exit_code:3,class:"not_found",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/store/tracker-preflight.ts"],emitting_commands:["*"],canonical_code:"tracker_root_missing",aliases:[],owned_states:[{state:"selected_tracker_root_does_not_exist",probe_id:"tracker-root-missing",entrypoints:["list"],expected_exit_class:"not_found"}]},{code:"tracker_root_not_directory",meaning:"Tracker root not directory condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/store/tracker-preflight.ts"],emitting_commands:["*"],canonical_code:"tracker_root_not_directory",aliases:[],owned_states:[{state:"selected_tracker_root_is_a_regular_file",probe_id:"tracker-root-not-directory",entrypoints:["list"],expected_exit_class:"usage"}]},{code:"tracker_root_unreadable",meaning:"Tracker root unreadable condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/store/tracker-preflight.ts"],emitting_commands:["*"],canonical_code:"tracker_root_unreadable",aliases:[],owned_states:[{state:"selected_tracker_root_is_not_readable",probe_id:"tracker-root-unreadable",entrypoints:["list"],expected_exit_class:"generic_failure"}]},{code:"type_duplicate",meaning:"Type duplicate condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"type_duplicate",aliases:[]},{code:"type_invalid",meaning:"Type invalid condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"type_invalid",aliases:[]},{code:"undeclared_observation",meaning:"Undeclared observation condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/flag-invocation-contracts.ts"],emitting_commands:["*"],canonical_code:"undeclared_observation",aliases:[]},{code:"unexpected_refusal_probe",meaning:"Unexpected refusal probe condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"unexpected_refusal_probe",aliases:[]},{code:"unknown_command",meaning:"Unknown command condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts","sdk/cli-contracts/runtime-contracts.ts"],emitting_commands:["*"],canonical_code:"unknown_command",aliases:[]},{code:"unknown_context_intent",meaning:"Unknown context intent condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Unknown error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts"],emitting_commands:["*"],canonical_code:"unknown_error",aliases:[]},{code:"unknown_field",meaning:"Unknown field condition.",stability:"stable",exit_code:3,class:"not_found",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",meaning:"Unknown field projection condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/query/get.ts","sdk/query/list.ts","sdk/query/search-contracts.ts"],emitting_commands:["get","list","search"],canonical_code:"unknown_field_projection",aliases:[]},{code:"unknown_item_type",meaning:"Unknown item type condition.",stability:"stable",exit_code:3,class:"not_found",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",meaning:"Unknown lifecycle action condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/subcommand-recovery.ts"],emitting_commands:["*"],canonical_code:"unknown_subcommand",aliases:[]},{code:"unknown_noun",meaning:"Unknown noun condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"unknown_noun",aliases:[]},{code:"unknown_option",meaning:"Unknown option condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts"],emitting_commands:["*"],canonical_code:"unknown_option",aliases:[],owned_states:[{state:"declared_option_is_rejected_on_the_selected_command_path",probe_id:"cross-command-unknown-option",entrypoints:["deps"],expected_exit_class:"usage"}]},{code:"unknown_plan_template",meaning:"Unknown plan template condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/plan.ts"],emitting_commands:["plan"],canonical_code:"unknown_plan_template",aliases:[]},{code:"unknown_provenance_dimension",meaning:"Unknown provenance dimension condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/history-provenance.ts"],emitting_commands:["*"],canonical_code:"unknown_provenance_dimension",aliases:[]},{code:"unknown_status",meaning:"Unknown status condition.",stability:"stable",exit_code:3,class:"not_found",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",meaning:"Unknown subcommand condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","sdk/agent/subcommand-recovery.ts"],emitting_commands:["*"],canonical_code:"unknown_subcommand",aliases:["unknown_lifecycle_action"],owned_states:[{state:"config_action_token_is_not_declared",probe_id:"config-unknown-action",entrypoints:["config"],expected_exit_class:"usage"},{state:"graph_command_token_is_not_declared",probe_id:"graph-unknown-subcommand",entrypoints:["graph"],expected_exit_class:"usage"},{state:"nested_command_token_is_not_declared_by_its_family",probe_id:"schema-unknown-subcommand",entrypoints:["schema"],expected_exit_class:"usage"},{state:"package_lifecycle_token_is_not_declared",probe_id:"package-unknown-action",entrypoints:["package"],expected_exit_class:"usage"}]},{code:"unsafe_init_recovery",meaning:"Unsafe init recovery condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"unsafe_init_recovery",aliases:[]},{code:"unsupported_update_option",meaning:"Unsupported update option condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts"],emitting_commands:["*"],canonical_code:"unsupported_update_option",aliases:[]},{code:"validate_command_references_stale_pm_ids",meaning:"Validate command references stale pm ids condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_command_references_stale_pm_ids",aliases:[]},{code:"validate_files_missing_linked_paths",meaning:"Validate files missing linked paths condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_files_missing_linked_paths",aliases:[]},{code:"validate_files_orphaned_paths",meaning:"Validate files orphaned paths condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_files_orphaned_paths",aliases:[]},{code:"validate_files_tracked_all_strict_forces_pm_internals",meaning:"Validate files tracked all strict forces pm internals condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_files_tracked_all_strict_forces_pm_internals",aliases:[]},{code:"validate_format_version_ahead_items",meaning:"Validate format version ahead items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"integrity_item_ahead_format_version",aliases:[]},{code:"validate_format_version_outdated_items",meaning:"Validate format version outdated items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"integrity_item_outdated_format_version",aliases:[]},{code:"validate_hierarchy_parent_cycle",meaning:"Validate hierarchy parent cycle condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_hierarchy_parent_cycle",aliases:[]},{code:"validate_hierarchy_parent_cycle_error",meaning:"Validate hierarchy parent cycle error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_hierarchy_parent_cycle_error",aliases:[]},{code:"validate_history_drift_chain_mismatches",meaning:"Validate history drift chain mismatches condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_chain_mismatch",aliases:[]},{code:"validate_history_drift_hash_mismatches",meaning:"Validate history drift hash mismatches condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_hash_mismatch",aliases:[]},{code:"validate_history_drift_missing_streams",meaning:"Validate history drift missing streams condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_missing_stream",aliases:[]},{code:"validate_history_drift_unreadable_streams",meaning:"Validate history drift unreadable streams condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_unreadable_stream",aliases:[]},{code:"validate_history_drift_version_skews",meaning:"Validate history drift version skews condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_version_skew",aliases:[]},{code:"validate_history_unknown_author_events",meaning:"Validate history unknown author events condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_unknown_author_events",aliases:[]},{code:"validate_lifecycle_active_closure_like_metadata",meaning:"Validate lifecycle active closure like metadata condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_active_closure_like_metadata",aliases:[]},{code:"validate_lifecycle_active_terminal_parent",meaning:"Validate lifecycle active terminal parent condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_active_terminal_parent",aliases:[]},{code:"validate_lifecycle_dependency_cycles",meaning:"Validate lifecycle dependency cycles condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_dependency_cycles",aliases:[]},{code:"validate_lifecycle_dependency_cycles_error",meaning:"Validate lifecycle dependency cycles error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_dependency_cycles_error",aliases:[]},{code:"validate_lifecycle_stale_blockers",meaning:"Validate lifecycle stale blockers condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_stale_blockers",aliases:[]},{code:"validate_merge_decisions_unreviewed",meaning:"Validate merge decisions unreviewed condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_merge_decisions_unreviewed",aliases:[]},{code:"validate_merge_driver_configuration",meaning:"Validate merge driver configuration condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_merge_driver_configuration",aliases:[]},{code:"validate_merge_fence_drift",meaning:"Validate merge fence drift condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_merge_fence_drift",aliases:[]},{code:"validate_metadata_custom_profile_missing_required_fields",meaning:"Validate metadata custom profile missing required fields condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_custom_profile_missing_required_fields",aliases:[]},{code:"validate_metadata_duplicate_issue_codes",meaning:"Validate metadata duplicate issue codes condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_duplicate_issue_codes",aliases:[]},{code:"validate_metadata_missing_acceptance_criteria",meaning:"Validate metadata missing acceptance criteria condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_acceptance_criteria",aliases:[]},{code:"validate_metadata_missing_close_reason",meaning:"Validate metadata missing close reason condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_close_reason",aliases:[]},{code:"validate_metadata_missing_closed_at",meaning:"Validate metadata missing closed at condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_closed_at",aliases:[]},{code:"validate_metadata_missing_confidence",meaning:"Validate metadata missing confidence condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_confidence",aliases:[]},{code:"validate_metadata_missing_estimate",meaning:"Validate metadata missing estimate condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_estimate",aliases:[]},{code:"validate_metadata_missing_release",meaning:"Validate metadata missing release condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_release",aliases:[]},{code:"validate_metadata_missing_reviewer",meaning:"Validate metadata missing reviewer condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_reviewer",aliases:[]},{code:"validate_metadata_missing_risk",meaning:"Validate metadata missing risk condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_risk",aliases:[]},{code:"validate_metadata_missing_sprint",meaning:"Validate metadata missing sprint condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_sprint",aliases:[]},{code:"validate_resolution_missing_fields",meaning:"Validate resolution missing fields condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_resolution_missing_fields",aliases:[]},{code:"validate_storage_duplicate_item_ids",meaning:"Validate storage duplicate item ids condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_duplicate_item_ids",aliases:[]},{code:"validate_storage_history_conflict_markers",meaning:"Validate storage history conflict markers condition.",stability:"stable",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"integrity_history_conflict_marker",aliases:[]},{code:"validate_storage_resurrected_items",meaning:"Validate storage resurrected items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_resurrected_items",aliases:[]},{code:"validate_storage_tracked_runtime_cache_files",meaning:"Validate storage tracked runtime cache files condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"tracked_runtime_cache_files",aliases:[]},{code:"validate_storage_unparseable_config",meaning:"Validate storage unparseable config condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_unparseable_config",aliases:[]},{code:"validate_storage_unparseable_history",meaning:"Validate storage unparseable history condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_unparseable_history",aliases:[]},{code:"validate_storage_unreadable_items",meaning:"Validate storage unreadable items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_unreadable_items",aliases:[]},{code:"vectorization_embedding_identity_changed",meaning:"Vectorization embedding identity changed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"vectorization_embedding_identity_changed",aliases:[]},{code:"vectorization_stale_items_remaining",meaning:"Vectorization stale items remaining condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"vectorization_stale_items_remaining",aliases:[]},{code:"visible_surface_ceiling_exceeded",meaning:"Visible surface ceiling exceeded condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"visible_surface_ceiling_exceeded",aliases:[]},{code:"workflow_duplicate_type",meaning:"Workflow duplicate type condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_duplicate_type",aliases:[]},{code:"workflow_policy_approval_history_invalid",meaning:"Workflow policy approval history invalid condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_approval_history_invalid",aliases:[]},{code:"workflow_policy_audit_failed",meaning:"Workflow policy audit failed condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_audit_failed",aliases:[]},{code:"workflow_policy_input_unreadable",meaning:"Workflow policy input unreadable condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_input_unreadable",aliases:[]},{code:"workflow_policy_invalid",meaning:"Workflow policy invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_invalid",aliases:[]},{code:"workflow_policy_refused",meaning:"Workflow policy refused condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_refused",aliases:[]},{code:"workflow_policy_registry_invalid",meaning:"Workflow policy registry invalid condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_registry_invalid",aliases:[]},{code:"workflow_status_unknown",meaning:"Workflow status unknown condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_status_unknown",aliases:[]},{code:"workflow_transition_malformed",meaning:"Workflow transition malformed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_transition_malformed",aliases:[]},{code:"workflow_type_empty",meaning:"Workflow type empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_type_empty",aliases:[]},{code:"workflow_type_unknown",meaning:"Workflow type unknown condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_type_unknown",aliases:[]},{code:"workspace_history_chain_invalid",meaning:"Workspace history chain invalid condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/history/workspace-history.ts"],emitting_commands:["*"],canonical_code:"workspace_history_chain_invalid",aliases:[]},{code:"workspace_history_state_conflict",meaning:"Workspace history state conflict condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"Workspace root pm path condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/init.ts"],emitting_commands:["*"],canonical_code:"workspace_root_pm_path",aliases:[]},{code:"workspace_snapshot_force_required",meaning:"Workspace snapshot force required condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/workspace-snapshot.ts"],emitting_commands:["*"],canonical_code:"workspace_snapshot_force_required",aliases:[]},{code:"workspace_snapshot_manifest_mismatch",meaning:"Workspace snapshot manifest mismatch condition.",stability:"provisional",exit_code:4,class:"conflict",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",meaning:"Workspace snapshot name reserved fingerprint condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/workspace-snapshot.ts"],emitting_commands:["*"],canonical_code:"workspace_snapshot_name_reserved_fingerprint",aliases:[]},{code:"workspace_snapshot_not_found",meaning:"Workspace snapshot not found condition.",stability:"provisional",exit_code:3,class:"not_found",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",meaning:"Wrong item type condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/plan.ts"],emitting_commands:["plan"],canonical_code:"wrong_item_type",aliases:[]}];export{PM_ERROR_CODE_CATALOG_PART_2};
+!(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]="a3d7a93f-9524-56cd-a2b8-7d2dc21c5215")}catch(e2){}})();const PM_ERROR_CODE_CATALOG_PART_2=[{code:"merge_root_not_found",meaning:"Merge root not found condition.",stability:"stable",exit_code:3,class:"not_found",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_allowed_values",meaning:"Missing allowed values condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"missing_allowed_values",aliases:[]},{code:"missing_budget",meaning:"Missing budget condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_budget",aliases:[]},{code:"missing_cli_flag",meaning:"Missing cli flag condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/tool-option-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_cli_flag",aliases:[]},{code:"missing_destination",meaning:"Missing destination condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_destination",aliases:[]},{code:"missing_directory",meaning:"Missing directory condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"missing_directory",aliases:[]},{code:"missing_init_recovery",meaning:"Missing init recovery condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_init_recovery",aliases:[]},{code:"missing_lifecycle_target",meaning:"Missing lifecycle target condition.",stability:"stable",exit_code:2,class:"usage",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_observation",meaning:"Missing observation condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/flag-invocation-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_observation",aliases:[]},{code:"missing_observed_signature",meaning:"Missing observed signature condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_observed_signature",aliases:[]},{code:"missing_parameter_alias",meaning:"Missing parameter alias condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/tool-option-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_parameter_alias",aliases:[]},{code:"missing_positive_execution_receipt",meaning:"Missing positive execution receipt condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"missing_positive_execution_receipt",aliases:[]},{code:"missing_probe",meaning:"Missing probe condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"missing_probe",aliases:[]},{code:"missing_required_argument",meaning:"Missing required argument condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","cli/main.ts","cli/register-mutation.ts","cli/schema/registration.ts","core/telemetry/observability.ts","sdk/governance/assurance-action.ts","sdk/history-redact.ts","sdk/invocation-author.ts"],emitting_commands:["*"],canonical_code:"missing_required_argument",aliases:[]},{code:"missing_required_option",meaning:"Missing required option condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts","sdk/context-intent-contracts.ts","sdk/lifecycle/create.ts","sdk/lifecycle/plan.ts"],emitting_commands:["*","create","plan"],canonical_code:"missing_required_option",aliases:[]},{code:"missing_suggested_retry",meaning:"Missing suggested retry condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"missing_suggested_retry",aliases:[]},{code:"missing_suggested_retry_args",meaning:"Missing suggested retry args condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"missing_suggested_retry_args",aliases:[]},{code:"module_import_failed",meaning:"Module import failed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts"],emitting_commands:["*"],canonical_code:"module_import_failed",aliases:[]},{code:"multi_target_github_install_ambiguous",meaning:"Multi target github install ambiguous condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Mutation author required condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Mutation secret guard blocked condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"No matching tests condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_matching_tests",aliases:[]},{code:"no_projects_matched_filters",meaning:"No projects matched filters condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_projects_matched_filters",aliases:[]},{code:"no_test_files_found",meaning:"No test files found condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_test_files_found",aliases:[]},{code:"no_tests_found",meaning:"No tests found condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"no_tests_found",aliases:[]},{code:"no_update_fields",meaning:"No update fields condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts"],emitting_commands:["*"],canonical_code:"no_update_fields",aliases:[]},{code:"no_version_bounds_declared",meaning:"No version bounds declared condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/extensions/manifest-schema.ts"],emitting_commands:["*"],canonical_code:"no_version_bounds_declared",aliases:[],owned_states:[{state:"author_workspace_manifest_omits_canonical_pm_version_bounds",probe_id:"author-manifest-version-bounds-missing",entrypoints:["health"],expected_exit_class:"generic_failure"}]},{code:"non_refusal_exit",meaning:"Non refusal exit condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"non_refusal_exit",aliases:[]},{code:"npm_pack_json_shape_unsupported",meaning:"Npm pack json shape unsupported condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_pack_json_shape_unsupported",aliases:[]},{code:"npm_package_archive_missing",meaning:"Npm package archive missing condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_package_archive_missing",aliases:[]},{code:"npm_package_archive_unsafe",meaning:"Npm package archive unsafe condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_package_archive_unsafe",aliases:[]},{code:"npm_package_not_found",meaning:"Npm package not found condition.",stability:"stable",exit_code:3,class:"not_found",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/install-sources.ts"],emitting_commands:["*"],canonical_code:"npm_package_not_found",aliases:[]},{code:"ownership_conflict",meaning:"Ownership conflict condition.",stability:"stable",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts","sdk/annotations.ts"],emitting_commands:["*"],canonical_code:"ownership_conflict",aliases:[]},{code:"ownership_dependency_bypass_restricted_options",meaning:"Ownership dependency bypass restricted options condition.",stability:"stable",exit_code:1,class:"generic_failure",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",meaning:"Ownership metadata bypass restricted options condition.",stability:"stable",exit_code:1,class:"generic_failure",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",meaning:"Package spec empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"package_spec_empty",aliases:[]},{code:"package_upgrade_modes_mutually_exclusive",meaning:"Package upgrade modes mutually exclusive condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/governance/upgrade.ts"],emitting_commands:["*"],canonical_code:"package_upgrade_modes_mutually_exclusive",aliases:[]},{code:"positional_shape_budget_exceeded",meaning:"Positional shape budget exceeded condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"positional_shape_budget_exceeded",aliases:[]},{code:"positional_signature_mismatch",meaning:"Positional signature mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"positional_signature_mismatch",aliases:[]},{code:"profile_name_empty",meaning:"Profile name empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_name_empty",aliases:[]},{code:"profile_name_not_normalized",meaning:"Profile name not normalized condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_name_not_normalized",aliases:[]},{code:"profile_summary_empty",meaning:"Profile summary empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_summary_empty",aliases:[]},{code:"profile_title_empty",meaning:"Profile title empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"profile_title_empty",aliases:[]},{code:"project_runtime_history_epoch_incompatible",meaning:"Project runtime history epoch incompatible 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_history_epoch_incompatible",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:"projection_options_mutually_exclusive",meaning:"Projection options mutually exclusive condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/query/get.ts","sdk/query/list.ts","sdk/query/search-contracts.ts"],emitting_commands:["get","list","search"],canonical_code:"projection_options_mutually_exclusive",aliases:[]},{code:"provenance_value_domain_invalid",meaning:"Provenance value domain invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"provenance_value_domain_invalid",aliases:[]},{code:"read_output_cursor_command_mismatch",meaning:"Read output cursor command mismatch condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/read-output/continuation.ts"],emitting_commands:["*"],canonical_code:"read_output_cursor_command_mismatch",aliases:[]},{code:"read_output_cursor_invalid",meaning:"Read output cursor invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/read-output/continuation.ts"],emitting_commands:["*"],canonical_code:"read_output_cursor_invalid",aliases:[]},{code:"read_output_cursor_stale",meaning:"Read output cursor stale condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/read-output/continuation.ts"],emitting_commands:["*"],canonical_code:"read_output_cursor_stale",aliases:[]},{code:"recovery_kind_mismatch",meaning:"Recovery kind mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"recovery_kind_mismatch",aliases:[]},{code:"redundant_edge",meaning:"Redundant edge condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/graph/remediation.ts"],emitting_commands:["*"],canonical_code:"redundant_edge",aliases:[]},{code:"refusal_allowed_values_mismatch",meaning:"Refusal allowed values mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_allowed_values_mismatch",aliases:[]},{code:"refusal_error_code_mismatch",meaning:"Refusal error code mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_error_code_mismatch",aliases:[]},{code:"refusal_exit_code_mismatch",meaning:"Refusal exit code mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_exit_code_mismatch",aliases:[]},{code:"refusal_mutated_state",meaning:"Refusal mutated state condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_mutated_state",aliases:[]},{code:"refusal_probe_missing",meaning:"Refusal probe missing condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_probe_missing",aliases:[]},{code:"refusal_recovery_failed",meaning:"Refusal recovery failed condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"refusal_recovery_failed",aliases:[]},{code:"reindex_already_running",meaning:"Reindex already running condition.",stability:"stable",exit_code:4,class:"conflict",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:"removed_canonical_spelling",meaning:"Removed canonical spelling condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"removed_canonical_spelling",aliases:[]},{code:"removed_compatibility_spelling",meaning:"Removed compatibility spelling condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"removed_compatibility_spelling",aliases:[]},{code:"reopen_reason_required",meaning:"Reopen reason required condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/reopen.ts"],emitting_commands:["item reopen"],canonical_code:"reopen_reason_required",aliases:[]},{code:"reopen_receipt_missing",meaning:"Reopen receipt missing condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/update.ts"],emitting_commands:["update"],canonical_code:"reopen_receipt_missing",aliases:[]},{code:"reopen_target_status_invalid",meaning:"Reopen target status invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/reopen.ts"],emitting_commands:["item reopen"],canonical_code:"reopen_target_status_invalid",aliases:[]},{code:"reported_zero_passes",meaning:"Reported zero passes condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"reported_zero_passes",aliases:[]},{code:"reported_zero_tests",meaning:"Reported zero tests condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/test/execution.ts"],emitting_commands:["*"],canonical_code:"reported_zero_tests",aliases:[]},{code:"reserved_item_field",meaning:"Reserved item field condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/compose.ts"],emitting_commands:["*"],canonical_code:"reserved_item_field",aliases:[]},{code:"retry_failed",meaning:"Retry failed condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts","sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"retry_failed",aliases:[]},{code:"schema_migration_input_required",meaning:"Schema migration input required condition.",stability:"stable",exit_code:2,class:"usage",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:"semantic_spelling_collision",meaning:"Semantic spelling collision condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"semantic_spelling_collision",aliases:[]},{code:"settings_invalid",meaning:"Settings invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/static-inventory.ts"],emitting_commands:["*"],canonical_code:"settings_invalid",aliases:[]},{code:"settings_read_fs_error",meaning:"Settings read fs error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_fs_error",aliases:[]},{code:"settings_read_invalid_json",meaning:"Settings read invalid json condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_invalid_json",aliases:[]},{code:"settings_read_invalid_schema",meaning:"Settings read invalid schema condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_invalid_schema",aliases:[]},{code:"settings_read_merge_failed",meaning:"Settings read merge failed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"settings_read_merge_failed",aliases:[]},{code:"settings_unreadable",meaning:"Settings unreadable condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/extension/static-inventory.ts"],emitting_commands:["*"],canonical_code:"settings_unreadable",aliases:[]},{code:"stale_budget",meaning:"Stale budget condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/flag-lexicon-contracts.ts"],emitting_commands:["*"],canonical_code:"stale_budget",aliases:[]},{code:"stale_destination",meaning:"Stale destination condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"stale_destination",aliases:[]},{code:"stale_observed_signature",meaning:"Stale observed signature condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"stale_observed_signature",aliases:[]},{code:"status_duplicate",meaning:"Status duplicate condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"status_duplicate",aliases:[]},{code:"status_invalid",meaning:"Status invalid condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"status_invalid",aliases:[]},{code:"status_lifecycle_role_required",meaning:"Status lifecycle role required condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/schema.ts"],emitting_commands:["*"],canonical_code:"status_lifecycle_role_required",aliases:[]},{code:"stdin_json_invalid",meaning:"Stdin json invalid condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Stdin json unknown key condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event immutable condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/annotations.ts"],emitting_commands:["*"],canonical_code:"structured_event_immutable",aliases:[]},{code:"structured_event_input_conflict",meaning:"Structured event input conflict condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event json empty condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event json invalid condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Structured event since invalid condition.",stability:"stable",exit_code:2,class:"usage",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:"suggested_retry_args_mismatch",meaning:"Suggested retry args mismatch condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-closure.ts"],emitting_commands:["*"],canonical_code:"suggested_retry_args_mismatch",aliases:[]},{code:"telemetry_endpoint_probe_failed",meaning:"Telemetry endpoint probe failed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_endpoint_probe_failed",aliases:[]},{code:"telemetry_endpoint_probe_http_status",meaning:"Telemetry endpoint probe http status condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_endpoint_probe_http_status",aliases:[]},{code:"telemetry_otel_export_failing",meaning:"Telemetry otel export failing condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_otel_export_failing",aliases:[]},{code:"telemetry_queue_high_retries",meaning:"Telemetry queue high retries condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_queue_high_retries",aliases:[]},{code:"telemetry_queue_invalid_rows",meaning:"Telemetry queue invalid rows condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_queue_invalid_rows",aliases:[]},{code:"telemetry_queue_pending",meaning:"Telemetry queue pending condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_queue_pending",aliases:[]},{code:"telemetry_schema_version_behind",meaning:"Telemetry schema version behind condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_schema_version_behind",aliases:[]},{code:"telemetry_state_invalid_json",meaning:"Telemetry state invalid json condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"telemetry_state_invalid_json",aliases:[]},{code:"template_type_unknown",meaning:"Template type unknown condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"template_type_unknown",aliases:[]},{code:"terminal_plan_mutation",meaning:"Terminal plan mutation condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"Terminal state conflict condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"Tracked runtime cache files condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"tracked_runtime_cache_files",aliases:["validate_storage_tracked_runtime_cache_files"]},{code:"tracker_not_initialized",meaning:"Tracker not initialized condition.",stability:"stable",exit_code:3,class:"not_found",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/store/tracker-preflight.ts","core/telemetry/observability.ts"],emitting_commands:["*"],canonical_code:"tracker_not_initialized",aliases:[],owned_states:[{state:"selected_tracker_root_exists_without_settings",probe_id:"tracker-root-settings-missing",entrypoints:["list"],expected_exit_class:"not_found"}]},{code:"tracker_root_missing",meaning:"Tracker root missing condition.",stability:"stable",exit_code:3,class:"not_found",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/store/tracker-preflight.ts"],emitting_commands:["*"],canonical_code:"tracker_root_missing",aliases:[],owned_states:[{state:"selected_tracker_root_does_not_exist",probe_id:"tracker-root-missing",entrypoints:["list"],expected_exit_class:"not_found"}]},{code:"tracker_root_not_directory",meaning:"Tracker root not directory condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/store/tracker-preflight.ts"],emitting_commands:["*"],canonical_code:"tracker_root_not_directory",aliases:[],owned_states:[{state:"selected_tracker_root_is_a_regular_file",probe_id:"tracker-root-not-directory",entrypoints:["list"],expected_exit_class:"usage"}]},{code:"tracker_root_unreadable",meaning:"Tracker root unreadable condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/store/tracker-preflight.ts"],emitting_commands:["*"],canonical_code:"tracker_root_unreadable",aliases:[],owned_states:[{state:"selected_tracker_root_is_not_readable",probe_id:"tracker-root-unreadable",entrypoints:["list"],expected_exit_class:"generic_failure"}]},{code:"type_duplicate",meaning:"Type duplicate condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"type_duplicate",aliases:[]},{code:"type_invalid",meaning:"Type invalid condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"type_invalid",aliases:[]},{code:"undeclared_observation",meaning:"Undeclared observation condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/flag-invocation-contracts.ts"],emitting_commands:["*"],canonical_code:"undeclared_observation",aliases:[]},{code:"unexpected_refusal_probe",meaning:"Unexpected refusal probe condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/refusal-corpus-contracts.ts"],emitting_commands:["*"],canonical_code:"unexpected_refusal_probe",aliases:[]},{code:"unknown_command",meaning:"Unknown command condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts","sdk/cli-contracts/runtime-contracts.ts"],emitting_commands:["*"],canonical_code:"unknown_command",aliases:[]},{code:"unknown_context_intent",meaning:"Unknown context intent condition.",stability:"stable",exit_code:2,class:"usage",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",meaning:"Unknown error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts"],emitting_commands:["*"],canonical_code:"unknown_error",aliases:[]},{code:"unknown_field",meaning:"Unknown field condition.",stability:"stable",exit_code:3,class:"not_found",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",meaning:"Unknown field projection condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/query/get.ts","sdk/query/list.ts","sdk/query/search-contracts.ts"],emitting_commands:["get","list","search"],canonical_code:"unknown_field_projection",aliases:[]},{code:"unknown_item_type",meaning:"Unknown item type condition.",stability:"stable",exit_code:3,class:"not_found",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",meaning:"Unknown lifecycle action condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/subcommand-recovery.ts"],emitting_commands:["*"],canonical_code:"unknown_subcommand",aliases:[]},{code:"unknown_noun",meaning:"Unknown noun condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"unknown_noun",aliases:[]},{code:"unknown_option",meaning:"Unknown option condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","core/telemetry/observability.ts"],emitting_commands:["*"],canonical_code:"unknown_option",aliases:[],owned_states:[{state:"declared_option_is_rejected_on_the_selected_command_path",probe_id:"cross-command-unknown-option",entrypoints:["deps"],expected_exit_class:"usage"}]},{code:"unknown_plan_template",meaning:"Unknown plan template condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/plan.ts"],emitting_commands:["plan"],canonical_code:"unknown_plan_template",aliases:[]},{code:"unknown_provenance_dimension",meaning:"Unknown provenance dimension condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/history-provenance.ts"],emitting_commands:["*"],canonical_code:"unknown_provenance_dimension",aliases:[]},{code:"unknown_status",meaning:"Unknown status condition.",stability:"stable",exit_code:3,class:"not_found",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",meaning:"Unknown subcommand condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts","sdk/agent/subcommand-recovery.ts"],emitting_commands:["*"],canonical_code:"unknown_subcommand",aliases:["unknown_lifecycle_action"],owned_states:[{state:"config_action_token_is_not_declared",probe_id:"config-unknown-action",entrypoints:["config"],expected_exit_class:"usage"},{state:"graph_command_token_is_not_declared",probe_id:"graph-unknown-subcommand",entrypoints:["graph"],expected_exit_class:"usage"},{state:"nested_command_token_is_not_declared_by_its_family",probe_id:"schema-unknown-subcommand",entrypoints:["schema"],expected_exit_class:"usage"},{state:"package_lifecycle_token_is_not_declared",probe_id:"package-unknown-action",entrypoints:["package"],expected_exit_class:"usage"}]},{code:"unsafe_init_recovery",meaning:"Unsafe init recovery condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/agent/tracker-preflight-contracts.ts"],emitting_commands:["*"],canonical_code:"unsafe_init_recovery",aliases:[]},{code:"unsupported_update_option",meaning:"Unsupported update option condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["cli/error-guidance.ts"],emitting_commands:["*"],canonical_code:"unsupported_update_option",aliases:[]},{code:"validate_command_references_stale_pm_ids",meaning:"Validate command references stale pm ids condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_command_references_stale_pm_ids",aliases:[]},{code:"validate_files_missing_linked_paths",meaning:"Validate files missing linked paths condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_files_missing_linked_paths",aliases:[]},{code:"validate_files_orphaned_paths",meaning:"Validate files orphaned paths condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_files_orphaned_paths",aliases:[]},{code:"validate_files_tracked_all_strict_forces_pm_internals",meaning:"Validate files tracked all strict forces pm internals condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_files_tracked_all_strict_forces_pm_internals",aliases:[]},{code:"validate_format_version_ahead_items",meaning:"Validate format version ahead items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"integrity_item_ahead_format_version",aliases:[]},{code:"validate_format_version_outdated_items",meaning:"Validate format version outdated items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"integrity_item_outdated_format_version",aliases:[]},{code:"validate_hierarchy_parent_cycle",meaning:"Validate hierarchy parent cycle condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_hierarchy_parent_cycle",aliases:[]},{code:"validate_hierarchy_parent_cycle_error",meaning:"Validate hierarchy parent cycle error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_hierarchy_parent_cycle_error",aliases:[]},{code:"validate_history_drift_chain_mismatches",meaning:"Validate history drift chain mismatches condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_chain_mismatch",aliases:[]},{code:"validate_history_drift_hash_mismatches",meaning:"Validate history drift hash mismatches condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_hash_mismatch",aliases:[]},{code:"validate_history_drift_missing_streams",meaning:"Validate history drift missing streams condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_missing_stream",aliases:[]},{code:"validate_history_drift_unreadable_streams",meaning:"Validate history drift unreadable streams condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_unreadable_stream",aliases:[]},{code:"validate_history_drift_version_skews",meaning:"Validate history drift version skews condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_drift_version_skew",aliases:[]},{code:"validate_history_unknown_author_events",meaning:"Validate history unknown author events condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"history_unknown_author_events",aliases:[]},{code:"validate_lifecycle_active_closure_like_metadata",meaning:"Validate lifecycle active closure like metadata condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_active_closure_like_metadata",aliases:[]},{code:"validate_lifecycle_active_terminal_parent",meaning:"Validate lifecycle active terminal parent condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_active_terminal_parent",aliases:[]},{code:"validate_lifecycle_dependency_cycles",meaning:"Validate lifecycle dependency cycles condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_dependency_cycles",aliases:[]},{code:"validate_lifecycle_dependency_cycles_error",meaning:"Validate lifecycle dependency cycles error condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_dependency_cycles_error",aliases:[]},{code:"validate_lifecycle_stale_blockers",meaning:"Validate lifecycle stale blockers condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_lifecycle_stale_blockers",aliases:[]},{code:"validate_merge_decisions_unreviewed",meaning:"Validate merge decisions unreviewed condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_merge_decisions_unreviewed",aliases:[]},{code:"validate_merge_driver_configuration",meaning:"Validate merge driver configuration condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_merge_driver_configuration",aliases:[]},{code:"validate_merge_fence_drift",meaning:"Validate merge fence drift condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_merge_fence_drift",aliases:[]},{code:"validate_metadata_custom_profile_missing_required_fields",meaning:"Validate metadata custom profile missing required fields condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_custom_profile_missing_required_fields",aliases:[]},{code:"validate_metadata_duplicate_issue_codes",meaning:"Validate metadata duplicate issue codes condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_duplicate_issue_codes",aliases:[]},{code:"validate_metadata_missing_acceptance_criteria",meaning:"Validate metadata missing acceptance criteria condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_acceptance_criteria",aliases:[]},{code:"validate_metadata_missing_close_reason",meaning:"Validate metadata missing close reason condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_close_reason",aliases:[]},{code:"validate_metadata_missing_closed_at",meaning:"Validate metadata missing closed at condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_closed_at",aliases:[]},{code:"validate_metadata_missing_confidence",meaning:"Validate metadata missing confidence condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_confidence",aliases:[]},{code:"validate_metadata_missing_estimate",meaning:"Validate metadata missing estimate condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_estimate",aliases:[]},{code:"validate_metadata_missing_release",meaning:"Validate metadata missing release condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_release",aliases:[]},{code:"validate_metadata_missing_reviewer",meaning:"Validate metadata missing reviewer condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_reviewer",aliases:[]},{code:"validate_metadata_missing_risk",meaning:"Validate metadata missing risk condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_risk",aliases:[]},{code:"validate_metadata_missing_sprint",meaning:"Validate metadata missing sprint condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_metadata_missing_sprint",aliases:[]},{code:"validate_resolution_missing_fields",meaning:"Validate resolution missing fields condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_resolution_missing_fields",aliases:[]},{code:"validate_storage_duplicate_item_ids",meaning:"Validate storage duplicate item ids condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_duplicate_item_ids",aliases:[]},{code:"validate_storage_history_conflict_markers",meaning:"Validate storage history conflict markers condition.",stability:"stable",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"integrity_history_conflict_marker",aliases:[]},{code:"validate_storage_resurrected_items",meaning:"Validate storage resurrected items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_resurrected_items",aliases:[]},{code:"validate_storage_tracked_runtime_cache_files",meaning:"Validate storage tracked runtime cache files condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"tracked_runtime_cache_files",aliases:[]},{code:"validate_storage_unparseable_config",meaning:"Validate storage unparseable config condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_unparseable_config",aliases:[]},{code:"validate_storage_unparseable_history",meaning:"Validate storage unparseable history condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_unparseable_history",aliases:[]},{code:"validate_storage_unreadable_items",meaning:"Validate storage unreadable items condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"validate_storage_unreadable_items",aliases:[]},{code:"vectorization_embedding_identity_changed",meaning:"Vectorization embedding identity changed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"vectorization_embedding_identity_changed",aliases:[]},{code:"vectorization_stale_items_remaining",meaning:"Vectorization stale items remaining condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/diagnostics/remediation.ts"],emitting_commands:["*"],canonical_code:"vectorization_stale_items_remaining",aliases:[]},{code:"visible_surface_ceiling_exceeded",meaning:"Visible surface ceiling exceeded condition.",stability:"provisional",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/cli-contracts/grammar-contracts.ts"],emitting_commands:["*"],canonical_code:"visible_surface_ceiling_exceeded",aliases:[]},{code:"workflow_duplicate_type",meaning:"Workflow duplicate type condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_duplicate_type",aliases:[]},{code:"workflow_policy_approval_history_invalid",meaning:"Workflow policy approval history invalid condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_approval_history_invalid",aliases:[]},{code:"workflow_policy_audit_failed",meaning:"Workflow policy audit failed condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_audit_failed",aliases:[]},{code:"workflow_policy_input_unreadable",meaning:"Workflow policy input unreadable condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_input_unreadable",aliases:[]},{code:"workflow_policy_invalid",meaning:"Workflow policy invalid condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_invalid",aliases:[]},{code:"workflow_policy_refused",meaning:"Workflow policy refused condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_refused",aliases:[]},{code:"workflow_policy_registry_invalid",meaning:"Workflow policy registry invalid condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/policy/workflow-policy-store.ts"],emitting_commands:["*"],canonical_code:"workflow_policy_registry_invalid",aliases:[]},{code:"workflow_status_unknown",meaning:"Workflow status unknown condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_status_unknown",aliases:[]},{code:"workflow_transition_malformed",meaning:"Workflow transition malformed condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_transition_malformed",aliases:[]},{code:"workflow_type_empty",meaning:"Workflow type empty condition.",stability:"stable",exit_code:1,class:"generic_failure",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_type_empty",aliases:[]},{code:"workflow_type_unknown",meaning:"Workflow type unknown condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/profile/profile-lint.ts"],emitting_commands:["*"],canonical_code:"workflow_type_unknown",aliases:[]},{code:"workspace_history_chain_invalid",meaning:"Workspace history chain invalid condition.",stability:"provisional",exit_code:4,class:"conflict",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["core/history/workspace-history.ts"],emitting_commands:["*"],canonical_code:"workspace_history_chain_invalid",aliases:[]},{code:"workspace_history_state_conflict",meaning:"Workspace history state conflict condition.",stability:"stable",exit_code:4,class:"conflict",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",meaning:"Workspace root pm path condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/init.ts"],emitting_commands:["*"],canonical_code:"workspace_root_pm_path",aliases:[]},{code:"workspace_snapshot_force_required",meaning:"Workspace snapshot force required condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/workspace-snapshot.ts"],emitting_commands:["*"],canonical_code:"workspace_snapshot_force_required",aliases:[]},{code:"workspace_snapshot_manifest_mismatch",meaning:"Workspace snapshot manifest mismatch condition.",stability:"provisional",exit_code:4,class:"conflict",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",meaning:"Workspace snapshot name reserved fingerprint condition.",stability:"provisional",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/workspace-snapshot.ts"],emitting_commands:["*"],canonical_code:"workspace_snapshot_name_reserved_fingerprint",aliases:[]},{code:"workspace_snapshot_not_found",meaning:"Workspace snapshot not found condition.",stability:"provisional",exit_code:3,class:"not_found",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",meaning:"Wrong item type condition.",stability:"stable",exit_code:2,class:"usage",recovery:"Inspect the structured error guidance and retry the suggested command.",sources:["sdk/lifecycle/plan.ts"],emitting_commands:["plan"],canonical_code:"wrong_item_type",aliases:[]}];export{PM_ERROR_CODE_CATALOG_PART_2};
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map

package/dist/sdk/governance/reindex.d.ts

@@ -1,4 +1,4 @@
-import { resolveEmbeddingProviders, resolveVectorStores, type VectorizationEmbeddingIdentity, type GlobalOptions, type CachedDocumentCandidate } from "../runtime-primitives.js";
+import { type EmbeddingBatchReceipt, resolveEmbeddingProviders, resolveVectorStores, type VectorizationEmbeddingIdentity, type GlobalOptions, type CachedDocumentCandidate } from "../runtime-primitives.js";
 import type { ItemDocument, PmSettings } from "../../types/index.js";
 type ReindexMode = "keyword" | "semantic" | "hybrid";
 /** Documents the reindex options payload exchanged by command, SDK, and package integrations. */
@@ -26,6 +26,8 @@ export interface ReindexResult {
         embedded_items: number;
         vector_upserted: number;
         batches_completed: number;
+        /** Actual built-in provider requests, splits, throughput, and byte ceiling. */
+        batching?: EmbeddingBatchReceipt;
     };
     /** Value that configures or reports artifacts for this contract. */
     artifacts: {
@@ -109,6 +111,7 @@ declare function resolveReindexEmbeddingIdentity(settings: PmSettings, activeEmb
     name: string;
 } | null): VectorizationEmbeddingIdentity;
 declare function collectLedgerOrphanIds(ledgerEntries: Record<string, string>, currentIds: Set<string>): string[];
+/** Embed the selected corpus through extension or built-in providers, preserving cardinality and execution receipts. */
 declare function executeReindexEmbedding(settings: PmSettings, requestedMode: "keyword" | "semantic" | "hybrid", activeEmbeddingProvider: ReturnType<typeof resolveEmbeddingProviders>["active"], extensionEmbedding: {
     name: string;
     embedBatch?: ExtensionEmbedBatch;

package/dist/sdk/governance/reindex.js

@@ -1,5 +1,5 @@
-!(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]="02e6f711-7e60-5bb7-a439-9b23d23575f5")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{toNonEmptyStringOrUndefined,getActiveExtensionRegistrations,runActiveOnIndexHooks,runActiveOnWriteHooks,collectRegisteredItemFieldNames,resolveRegisteredSearchProvider,resolveRegisteredVectorStoreAdapter,writeFileAtomic,resolveItemTypeRegistry,parseItemDocument,acquireLock,buildSearchCorpus,buildSemanticCorpusInput,resolveSearchCorpusFields,resolveSemanticCorpusCharacterLimit,executeEmbeddingBatchesWithRetry,readVectorizationStatusLedger,writeVectorizationStatusLedger,REINDEX_LOCK_ID,resolveEmbeddingProviders,resolveSettingsWithSemanticRuntimeDefaults,executeVectorDelete,executeVectorReset,executeVectorUpsert,resolveVectorStores,buildVectorizationEmbeddingIdentity,buildVectorizationEmbeddingMetadata,hasVectorizationEmbeddingIdentityChanged,hasVectorizationVectorDimensionChanged,inferConsistentVectorDimension,EXIT_CODE,PmCliError,nowIso,listAllDocumentCandidatesCached,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";const MANIFEST_PATH="index/manifest.json";const EMBEDDINGS_PATH="search/embeddings.jsonl";const EMBEDDING_MIGRATION_REINDEX_HINT="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function shouldEmitReindexProgress(options){return options.progress===true||process.stderr.isTTY===true}function emitReindexProgress(enabled,message){if(!enabled){return}try{process.stderr.write(`[pm reindex] ${message}
-`)}catch{}}function parseMode(raw){const normalized=(raw??"keyword").trim().toLowerCase();if(normalized==="keyword"){return"keyword"}if(normalized==="semantic"||normalized==="hybrid"){return normalized}throw new PmCliError("Reindex mode must be one of keyword|semantic|hybrid",EXIT_CODE.USAGE)}async function loadDocumentCandidates(pmRoot,itemFormat,typeToFolder,schema){const warnings=[];const candidates=await listAllDocumentCandidatesCached(pmRoot,itemFormat,typeToFolder,warnings,schema);return{candidates,warnings}}async function hydrateDocuments(pmRoot,candidates,schema,warnings,itemIds){const extensionFieldNames=collectRegisteredItemFieldNames(getActiveExtensionRegistrations());const hydrated=[];for(const candidate of candidates){if(itemIds&&!itemIds.has(candidate.metadata.id)){continue}if(typeof candidate.body==="string"){hydrated.push({metadata:candidate.metadata,body:candidate.body});continue}try{const raw=await fs.readFile(candidate.item_path,"utf8");const parsed=parseItemDocument(raw,{format:candidate.item_format,schema,extensionFieldNames,onWarning:warning=>warnings.push(warning)});hydrated.push({metadata:candidate.metadata,body:parsed.body})}catch{warnings.push(`item_list_item_read_failed:${path.relative(pmRoot,candidate.item_path)}`);hydrated.push({metadata:candidate.metadata,body:""})}}return hydrated}function buildKeywordRecord(document,mode,corpusFields){const item=document.metadata;return{id:item.id,mode,updated_at:item.updated_at,corpus:buildSearchCorpus(document,{fields:corpusFields})}}const toOptionalNonEmptyString=toNonEmptyStringOrUndefined;const _testOnly={shouldEmitReindexProgress,emitReindexProgress,parseMode,hydrateDocuments,buildKeywordRecord,resolveExtensionSearchEmbedding,resolveExtensionVectorAdapter,assertVector,executeExtensionEmbedding,resolveExtensionEmbeddingModel,resolveReindexEmbeddingIdentity,executeReindexEmbedding,collectLedgerOrphanIds,resetVectorStoreForReindex,pruneReindexOrphanVectors,upsertReindexVectors};function resolveExtensionSearchEmbedding(settings){const registrations=getActiveExtensionRegistrations();const providerName=toOptionalNonEmptyString(settings.search?.provider);if(!providerName){return null}const registration=resolveRegisteredSearchProvider(registrations,providerName);if(!registration){return null}const runtimeDefinition=registration.runtime_definition??registration.definition;const name=toOptionalNonEmptyString(runtimeDefinition.name)??toOptionalNonEmptyString(registration.definition.name);if(!name){return null}const embedBatch=runtimeDefinition.embedBatch;const embedBatchSnake=runtimeDefinition.embed_batch;const embed=runtimeDefinition.embed;const resolvedEmbedBatch=typeof embedBatch==="function"?embedBatch:typeof embedBatchSnake==="function"?embedBatchSnake:void 0;const resolvedEmbed=typeof embed==="function"?embed:void 0;if(!resolvedEmbedBatch&&!resolvedEmbed){return null}return{name,embedBatch:resolvedEmbedBatch,embed:resolvedEmbed}}function resolveExtensionVectorAdapter(settings){const registrations=getActiveExtensionRegistrations();const adapterName=toOptionalNonEmptyString(settings.vector_store?.adapter);if(!adapterName){return null}const registration=resolveRegisteredVectorStoreAdapter(registrations,adapterName);if(!registration){return null}const runtimeDefinition=registration.runtime_definition??registration.definition;const adapterDisplayName=toOptionalNonEmptyString(runtimeDefinition.name)??toOptionalNonEmptyString(registration.definition.name);if(!adapterDisplayName){return null}const upsert=runtimeDefinition.upsert;const deleteHandler=runtimeDefinition.delete;return{adapterName:adapterDisplayName,...typeof upsert==="function"?{upsert}:{},...typeof deleteHandler==="function"?{delete:deleteHandler}:{}}}function assertVector(value,context){if(!Array.isArray(value)||value.some(entry=>typeof entry!=="number"||!Number.isFinite(entry))){throw new PmCliError(`Invalid vector returned by ${context}`,EXIT_CODE.GENERIC_FAILURE)}return value}async function executeExtensionEmbedding(extensionEmbedding,settings,corpusInputs){const model=settings.search?.embedding_model?.trim()||"text-embedding-3-small";if(extensionEmbedding.embedBatch){const vectors2=await Promise.resolve(extensionEmbedding.embedBatch({inputs:corpusInputs,settings,model}));if(!Array.isArray(vectors2)){throw new PmCliError(`Extension search provider "${extensionEmbedding.name}" embedBatch must return an array of vectors`,EXIT_CODE.GENERIC_FAILURE)}return vectors2.map((vector,index)=>assertVector(vector,`extension search provider "${extensionEmbedding.name}" embedBatch output at index ${index}`))}if(!extensionEmbedding.embed){throw new PmCliError(`Extension search provider "${extensionEmbedding.name}" does not implement embed/embedBatch`,EXIT_CODE.GENERIC_FAILURE)}const vectors=[];for(const[index,input]of corpusInputs.entries()){const vector=await Promise.resolve(extensionEmbedding.embed({input,settings,model}));vectors.push(assertVector(vector,`extension search provider "${extensionEmbedding.name}" embed output at index ${index}`))}return vectors}function resolveExtensionEmbeddingModel(settings){return settings.search?.embedding_model?.trim()||"text-embedding-3-small"}function resolveReindexEmbeddingIdentity(settings,activeEmbeddingProvider,extensionEmbedding){const identity=extensionEmbedding?buildVectorizationEmbeddingIdentity(extensionEmbedding.name,resolveExtensionEmbeddingModel(settings)):activeEmbeddingProvider?buildVectorizationEmbeddingIdentity(activeEmbeddingProvider.name,activeEmbeddingProvider.model):null;if(!identity){throw new PmCliError(`No embedding identity available for semantic reindex mode`,EXIT_CODE.USAGE)}return identity}function collectLedgerOrphanIds(ledgerEntries,currentIds){return Object.keys(ledgerEntries).filter(id=>!currentIds.has(id)).sort((left,right)=>left.localeCompare(right))}async function executeReindexEmbedding(settings,requestedMode,activeEmbeddingProvider,extensionEmbedding,documents,semanticWarnings,semanticSummary,progressEnabled){const semanticProviderName=extensionEmbedding?.name??activeEmbeddingProvider?.name;const corpusCharacterLimit=resolveSemanticCorpusCharacterLimit(semanticProviderName,settings.search.embedding_corpus_max_characters).maxCharacters;const corpusFields=resolveSearchCorpusFields(settings);const corpusInputs=documents.map(document=>buildSemanticCorpusInput(document,{providerName:semanticProviderName,maxCharacters:corpusCharacterLimit,fields:corpusFields}));let vectors=[];let embeddingIdentity=null;if(extensionEmbedding){try{vectors=await executeExtensionEmbedding(extensionEmbedding,settings,corpusInputs);embeddingIdentity=buildVectorizationEmbeddingIdentity(extensionEmbedding.name,resolveExtensionEmbeddingModel(settings))}catch(error){if(!activeEmbeddingProvider){throw new PmCliError(`Extension search provider "${extensionEmbedding.name}" failed to generate embeddings: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}semanticWarnings.push(`Extension search provider "${extensionEmbedding.name}" failed; falling back to built-in provider (${error instanceof Error?error.message:String(error)})`)}}if(vectors.length===0){if(!activeEmbeddingProvider){throw new PmCliError(`No embedding executor available for reindex mode '${requestedMode}'`,EXIT_CODE.USAGE)}const embeddingResult=await executeEmbeddingBatchesWithRetry(activeEmbeddingProvider,settings,corpusInputs,{onProgress:event=>{if(event.phase==="complete"){semanticSummary.batches_completed=event.batch_index}emitReindexProgress(progressEnabled,`embedding_batch_${event.phase} batch=${event.batch_index}/${event.batch_total} size=${event.batch_size} completed_inputs=${event.completed_inputs}/${event.total_inputs}`)}});semanticWarnings.push(...embeddingResult.warnings);vectors=embeddingResult.vectors;embeddingIdentity=buildVectorizationEmbeddingIdentity(activeEmbeddingProvider.name,activeEmbeddingProvider.model)}emitReindexProgress(progressEnabled,`embedding_complete vectors=${vectors.length}`);if(vectors.length!==documents.length){throw new PmCliError(`Embedding output size mismatch (expected ${documents.length}, received ${vectors.length})`,EXIT_CODE.GENERIC_FAILURE)}if(!embeddingIdentity){throw new PmCliError(`No embedding identity available for reindex mode '${requestedMode}'`,EXIT_CODE.USAGE)}return{vectors,embeddingIdentity}}async function resetVectorStoreForReindex(activeVectorStore,extensionVectorAdapter,ledgerEntries,settings,semanticWarnings,vectorDimension){const knownIds=Object.keys(ledgerEntries);if(extensionVectorAdapter){if(knownIds.length>0&&extensionVectorAdapter.delete){try{await Promise.resolve(extensionVectorAdapter.delete({ids:knownIds.sort((left,right)=>left.localeCompare(right)),settings}))}catch(error){throw new PmCliError(`Extension vector adapter "${extensionVectorAdapter.adapterName}" failed to delete vectors during reindex reset: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}}else if(knownIds.length>0){semanticWarnings.push(`search_semantic_reindex_reset_skipped:adapter=${extensionVectorAdapter.adapterName}:known_ids=${knownIds.length}`)}if(!activeVectorStore){return}}if(activeVectorStore){await executeVectorReset(activeVectorStore,knownIds,{},vectorDimension)}}async function pruneReindexOrphanVectors(activeVectorStore,extensionVectorAdapter,orphanIds,settings,semanticWarnings){if(orphanIds.length===0){return}if(extensionVectorAdapter){if(extensionVectorAdapter.delete){try{await Promise.resolve(extensionVectorAdapter.delete({ids:orphanIds,settings}))}catch(error){throw new PmCliError(`Extension vector adapter "${extensionVectorAdapter.adapterName}" failed to delete orphan vectors during reindex: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}}else{semanticWarnings.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${extensionVectorAdapter.adapterName}:count=${orphanIds.length}`)}if(!activeVectorStore){return}}if(activeVectorStore){await executeVectorDelete(activeVectorStore,orphanIds)}}function createReindexSemanticSummary(mode){return{enabled:mode!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function buildReindexManifest(mode,generatedAt,metadataDocuments){return{version:1,mode,generated_at:generatedAt,total_items:metadataDocuments.length,items:metadataDocuments.map(document=>({id:document.metadata.id,type:document.metadata.type,status:document.metadata.status,priority:document.metadata.priority,updated_at:document.metadata.updated_at}))}}function assertSemanticRuntimeAvailable(params){if(params.requestedMode==="keyword"){return{activeEmbeddingProvider:null,activeVectorStore:null}}const providerResolution=resolveEmbeddingProviders(params.settings);if(!providerResolution.active&&!params.extensionEmbedding){throw new PmCliError(`Reindex mode '${params.requestedMode}' requires a configured embedding provider in settings.providers.openai/settings.providers.ollama or an extension provider selected by settings.search.provider`,EXIT_CODE.USAGE)}const vectorResolution=resolveVectorStores(params.settings,params.pmRoot);if(!vectorResolution.active&&!params.extensionVectorAdapter){throw new PmCliError(`Reindex mode '${params.requestedMode}' requires a configured vector store in settings.vector_store.qdrant/settings.vector_store.lancedb or an extension adapter selected by settings.vector_store.adapter`,EXIT_CODE.USAGE)}return{activeEmbeddingProvider:providerResolution.active,activeVectorStore:vectorResolution.active}}async function loadReindexCorpus(params){const typeRegistry=resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations());const loadedCandidates=await loadDocumentCandidates(params.pmRoot,params.settings.item_format,typeRegistry.type_to_folder,params.settings.schema);return{documentCandidates:loadedCandidates.candidates,warnings:[...loadedCandidates.warnings],metadataDocuments:loadedCandidates.candidates.map(candidate=>({metadata:candidate.metadata,body:typeof candidate.body==="string"?candidate.body:""}))}}async function appendKeywordLedgerWarnings(params){const ledger=await readVectorizationStatusLedger(params.pmRoot);params.reindexWarnings.push(...ledger.warnings);if(params.forceFullSemantic){params.reindexWarnings.push("search_semantic_reindex_full_ignored:mode_keyword")}if(!ledger.embedding){return}const currentEmbeddingIdentity=(()=>{try{return resolveReindexEmbeddingIdentity(params.settings,resolveEmbeddingProviders(params.settings).active,params.extensionEmbedding)}catch{return null}})();if(currentEmbeddingIdentity&&hasVectorizationEmbeddingIdentityChanged(ledger.embedding,currentEmbeddingIdentity)){params.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed");params.reindexWarnings.push(EMBEDDING_MIGRATION_REINDEX_HINT)}}async function planSemanticReindex(params){const ledger=await readVectorizationStatusLedger(params.pmRoot);params.semanticWarnings.push(...ledger.warnings);const embeddingIdentity=resolveReindexEmbeddingIdentity(params.settings,params.activeEmbeddingProvider,params.extensionEmbedding);const currentIds=new Set(params.metadataDocuments.map(document=>document.metadata.id));const orphanIds=collectLedgerOrphanIds(ledger.entries,currentIds);const resetRequired=hasVectorizationEmbeddingIdentityChanged(ledger.embedding,embeddingIdentity);if(params.forceFullSemantic&&!resetRequired){params.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced")}const staleSourceDocuments=params.forceFullSemantic||resetRequired?params.metadataDocuments:params.metadataDocuments.filter(document=>ledger.entries[document.metadata.id]!==document.metadata.updated_at);const staleIds=new Set(staleSourceDocuments.map(document=>document.metadata.id));const staleDocuments=staleIds.size>0?await hydrateDocuments(params.pmRoot,params.documentCandidates,params.settings.schema,params.reindexWarnings,staleIds):[];return{ledgerEntries:ledger.entries,ledgerEmbedding:ledger.embedding,orphanIds,resetRequired,staleDocuments,freshDocuments:params.metadataDocuments.length-staleDocuments.length}}async function rerunSemanticEmbeddingAfterDimensionChange(params){const staleIds=new Set(params.metadataDocuments.map(document=>document.metadata.id));const staleDocuments=await hydrateDocuments(params.pmRoot,params.documentCandidates,params.settings.schema,params.reindexWarnings,staleIds);params.semanticSummary.stale_items=staleDocuments.length;params.semanticSummary.unchanged_items=0;emitReindexProgress(params.progressEnabled,`embedding_dimension_changed reset_items=${staleDocuments.length}`);const embeddingResult=await executeReindexEmbedding(params.settings,params.requestedMode,params.activeEmbeddingProvider,params.extensionEmbedding,staleDocuments,params.semanticWarnings,params.semanticSummary,params.progressEnabled);return{...embeddingResult,staleDocuments,vectorDimension:inferConsistentVectorDimension(embeddingResult.vectors,"Reindex embeddings")}}async function resolveSemanticEmbeddingForUpsert(params){const embeddingResult=await executeReindexEmbedding(params.settings,params.requestedMode,params.activeEmbeddingProvider,params.extensionEmbedding,params.staleDocuments,params.semanticWarnings,params.semanticSummary,params.progressEnabled);let vectors=embeddingResult.vectors;let actualEmbeddingIdentity=embeddingResult.embeddingIdentity;let vectorDimension=inferConsistentVectorDimension(vectors,"Reindex embeddings");const dimensionChanged=!params.resetRequired&&(hasVectorizationEmbeddingIdentityChanged(params.ledgerEmbedding,actualEmbeddingIdentity)||hasVectorizationVectorDimensionChanged(params.ledgerEmbedding,vectorDimension));if(!dimensionChanged){return{vectors,embeddingIdentity:actualEmbeddingIdentity,staleDocuments:params.staleDocuments,vectorDimension,resetRequired:params.resetRequired}}const rerun=await rerunSemanticEmbeddingAfterDimensionChange(params);vectors=rerun.vectors;actualEmbeddingIdentity=rerun.embeddingIdentity;vectorDimension=rerun.vectorDimension;return{vectors,embeddingIdentity:actualEmbeddingIdentity,staleDocuments:rerun.staleDocuments,vectorDimension,resetRequired:true}}async function upsertReindexVectors(params){if(params.extensionVectorAdapter){try{const adapterName=params.extensionVectorAdapter.adapterName;emitReindexProgress(params.progressEnabled,`vector_upsert_start adapter=${adapterName} points=${params.points.length}`);if(typeof params.extensionVectorAdapter.upsert!=="function"){throw new PmCliError(`Extension vector adapter "${adapterName}" does not support upserting vectors.`,EXIT_CODE.USAGE)}await Promise.resolve(params.extensionVectorAdapter.upsert({points:params.points,settings:params.settings}));params.semanticSummary.vector_upserted=params.points.length;emitReindexProgress(params.progressEnabled,`vector_upsert_complete adapter=${adapterName}`);return}catch(error){if(error instanceof PmCliError){throw error}if(!params.activeVectorStore){throw new PmCliError(`Extension vector adapter "${params.extensionVectorAdapter.adapterName}" failed to upsert vectors: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}params.semanticWarnings.push(`Extension vector adapter "${params.extensionVectorAdapter.adapterName}" failed; falling back to built-in vector store (${error instanceof Error?error.message:String(error)})`);emitReindexProgress(params.progressEnabled,"vector_upsert_fallback built_in_store")}}if(params.activeVectorStore){emitReindexProgress(params.progressEnabled,`vector_upsert_start adapter=${params.activeVectorStore.name} points=${params.points.length}`);await executeVectorUpsert(params.activeVectorStore,params.points);params.semanticSummary.vector_upserted=params.points.length;emitReindexProgress(params.progressEnabled,`vector_upsert_complete adapter=${params.activeVectorStore.name}`);return}throw new PmCliError(`No vector upsert executor available for reindex mode '${params.requestedMode}'`,EXIT_CODE.USAGE)}function buildReindexVectorPoints(staleDocuments,vectors){return staleDocuments.map((document,index)=>({id:document.metadata.id,vector:assertVector(vectors[index],`reindex embeddings output at index ${index}`),payload:{id:document.metadata.id,type:document.metadata.type,status:document.metadata.status,priority:document.metadata.priority,updated_at:document.metadata.updated_at}}))}async function executeSemanticVectorRefresh(params){emitReindexProgress(params.progressEnabled,`embedding_start items=${params.plan.staleDocuments.length} unchanged_items=${params.plan.freshDocuments}`);const embedding=await resolveSemanticEmbeddingForUpsert({pmRoot:params.pmRoot,settings:params.settings,requestedMode:params.requestedMode,activeEmbeddingProvider:params.activeEmbeddingProvider,extensionEmbedding:params.extensionEmbedding,documentCandidates:params.documentCandidates,metadataDocuments:params.metadataDocuments,staleDocuments:params.plan.staleDocuments,ledgerEmbedding:params.plan.ledgerEmbedding,resetRequired:params.plan.resetRequired,semanticWarnings:params.semanticWarnings,reindexWarnings:params.reindexWarnings,semanticSummary:params.semanticSummary,progressEnabled:params.progressEnabled});if(embedding.resetRequired){emitReindexProgress(params.progressEnabled,"vector_reset_start");await resetVectorStoreForReindex(params.activeVectorStore,params.extensionVectorAdapter,params.plan.ledgerEntries,params.settings,params.semanticWarnings,params.plan.ledgerEmbedding?embedding.vectorDimension:void 0);emitReindexProgress(params.progressEnabled,"vector_reset_complete")}else{await pruneReindexOrphanVectors(params.activeVectorStore,params.extensionVectorAdapter,params.plan.orphanIds,params.settings,params.semanticWarnings)}const points=buildReindexVectorPoints(embedding.staleDocuments,embedding.vectors);params.semanticSummary.embedded_items=embedding.vectors.length;await upsertReindexVectors({requestedMode:params.requestedMode,activeVectorStore:params.activeVectorStore,extensionVectorAdapter:params.extensionVectorAdapter,settings:params.settings,points,semanticWarnings:params.semanticWarnings,semanticSummary:params.semanticSummary,progressEnabled:params.progressEnabled});return{staleDocuments:embedding.staleDocuments,embeddingMetadata:buildVectorizationEmbeddingMetadata(embedding.embeddingIdentity,embedding.vectorDimension)}}async function runSemanticReindex(params){const plan=await planSemanticReindex(params);params.semanticSummary.stale_items=plan.staleDocuments.length;params.semanticSummary.unchanged_items=plan.freshDocuments;const vectorizationLedgerEntries=Object.fromEntries(params.metadataDocuments.map(document=>[document.metadata.id,document.metadata.updated_at]));emitReindexProgress(params.progressEnabled,`semantic_stale_items stale=${plan.staleDocuments.length} total=${params.metadataDocuments.length} unchanged=${plan.freshDocuments} full=${params.forceFullSemantic||plan.resetRequired}`);if(plan.staleDocuments.length===0){emitReindexProgress(params.progressEnabled,`embedding_skipped unchanged_items=${plan.freshDocuments}`);params.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${plan.freshDocuments}`);await pruneReindexOrphanVectors(params.activeVectorStore,params.extensionVectorAdapter,plan.orphanIds,params.settings,params.semanticWarnings);return{documentsForKeywordArtifacts:params.documentsForKeywordArtifacts,vectorizationLedgerEntries,vectorizationEmbeddingMetadata:plan.ledgerEmbedding}}const refresh=await executeSemanticVectorRefresh({...params,plan});if(plan.freshDocuments>0){params.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${plan.freshDocuments}`)}const staleDocumentsById=new Map(refresh.staleDocuments.map(document=>[document.metadata.id,document]));return{documentsForKeywordArtifacts:params.metadataDocuments.map(document=>staleDocumentsById.get(document.metadata.id)??document),vectorizationLedgerEntries,vectorizationEmbeddingMetadata:refresh.embeddingMetadata}}async function writeReindexArtifacts(params){const manifestPath=path.join(params.pmRoot,MANIFEST_PATH);const embeddingsPath=path.join(params.pmRoot,EMBEDDINGS_PATH);const keywordCorpusFields=resolveSearchCorpusFields(params.settings);const embeddingsLines=params.documentsForKeywordArtifacts.map(document=>JSON.stringify(buildKeywordRecord(document,params.mode,keywordCorpusFields))).join("\n");emitReindexProgress(params.progressEnabled,"writing keyword artifacts");await writeFileAtomic(manifestPath,`${JSON.stringify(params.manifest,null,2)}
+!(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]="dae5fa09-fdac-58db-9dbe-5c5c12eb6c9b")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{toNonEmptyStringOrUndefined,getActiveExtensionRegistrations,runActiveOnIndexHooks,runActiveOnWriteHooks,collectRegisteredItemFieldNames,resolveRegisteredSearchProvider,resolveRegisteredVectorStoreAdapter,writeFileAtomic,resolveItemTypeRegistry,parseItemDocument,acquireLock,buildSearchCorpus,buildSemanticCorpusInput,resolveSearchCorpusFields,resolveSemanticCorpusCharacterLimit,executeEmbeddingBatchesWithRetry,readVectorizationStatusLedger,writeVectorizationStatusLedger,REINDEX_LOCK_ID,resolveEmbeddingProviders,resolveSettingsWithSemanticRuntimeDefaults,executeVectorDelete,executeVectorReset,executeVectorUpsert,resolveVectorStores,buildVectorizationEmbeddingIdentity,buildVectorizationEmbeddingMetadata,hasVectorizationEmbeddingIdentityChanged,hasVectorizationVectorDimensionChanged,inferConsistentVectorDimension,EXIT_CODE,PmCliError,nowIso,listAllDocumentCandidatesCached,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";const MANIFEST_PATH="index/manifest.json";const EMBEDDINGS_PATH="search/embeddings.jsonl";const EMBEDDING_MIGRATION_REINDEX_HINT="Provider or model has changed since last index. Run pm reindex --mode semantic to rebuild.";function shouldEmitReindexProgress(options){return options.progress===true||process.stderr.isTTY===true}function emitReindexProgress(enabled,message){if(!enabled){return}try{process.stderr.write(`[pm reindex] ${message}
+`)}catch{}}function parseMode(raw){const normalized=(raw??"keyword").trim().toLowerCase();if(normalized==="keyword"){return"keyword"}if(normalized==="semantic"||normalized==="hybrid"){return normalized}throw new PmCliError("Reindex mode must be one of keyword|semantic|hybrid",EXIT_CODE.USAGE)}async function loadDocumentCandidates(pmRoot,itemFormat,typeToFolder,schema){const warnings=[];const candidates=await listAllDocumentCandidatesCached(pmRoot,itemFormat,typeToFolder,warnings,schema);return{candidates,warnings}}async function hydrateDocuments(pmRoot,candidates,schema,warnings,itemIds){const extensionFieldNames=collectRegisteredItemFieldNames(getActiveExtensionRegistrations());const hydrated=[];for(const candidate of candidates){if(itemIds&&!itemIds.has(candidate.metadata.id)){continue}if(typeof candidate.body==="string"){hydrated.push({metadata:candidate.metadata,body:candidate.body});continue}try{const raw=await fs.readFile(candidate.item_path,"utf8");const parsed=parseItemDocument(raw,{format:candidate.item_format,schema,extensionFieldNames,onWarning:warning=>warnings.push(warning)});hydrated.push({metadata:candidate.metadata,body:parsed.body})}catch{warnings.push(`item_list_item_read_failed:${path.relative(pmRoot,candidate.item_path)}`);hydrated.push({metadata:candidate.metadata,body:""})}}return hydrated}function buildKeywordRecord(document,mode,corpusFields){const item=document.metadata;return{id:item.id,mode,updated_at:item.updated_at,corpus:buildSearchCorpus(document,{fields:corpusFields})}}const toOptionalNonEmptyString=toNonEmptyStringOrUndefined;const _testOnly={shouldEmitReindexProgress,emitReindexProgress,parseMode,hydrateDocuments,buildKeywordRecord,resolveExtensionSearchEmbedding,resolveExtensionVectorAdapter,assertVector,executeExtensionEmbedding,resolveExtensionEmbeddingModel,resolveReindexEmbeddingIdentity,executeReindexEmbedding,collectLedgerOrphanIds,resetVectorStoreForReindex,pruneReindexOrphanVectors,upsertReindexVectors};function resolveExtensionSearchEmbedding(settings){const registrations=getActiveExtensionRegistrations();const providerName=toOptionalNonEmptyString(settings.search?.provider);if(!providerName){return null}const registration=resolveRegisteredSearchProvider(registrations,providerName);if(!registration){return null}const runtimeDefinition=registration.runtime_definition??registration.definition;const name=toOptionalNonEmptyString(runtimeDefinition.name)??toOptionalNonEmptyString(registration.definition.name);if(!name){return null}const embedBatch=runtimeDefinition.embedBatch;const embedBatchSnake=runtimeDefinition.embed_batch;const embed=runtimeDefinition.embed;const resolvedEmbedBatch=typeof embedBatch==="function"?embedBatch:typeof embedBatchSnake==="function"?embedBatchSnake:void 0;const resolvedEmbed=typeof embed==="function"?embed:void 0;if(!resolvedEmbedBatch&&!resolvedEmbed){return null}return{name,embedBatch:resolvedEmbedBatch,embed:resolvedEmbed}}function resolveExtensionVectorAdapter(settings){const registrations=getActiveExtensionRegistrations();const adapterName=toOptionalNonEmptyString(settings.vector_store?.adapter);if(!adapterName){return null}const registration=resolveRegisteredVectorStoreAdapter(registrations,adapterName);if(!registration){return null}const runtimeDefinition=registration.runtime_definition??registration.definition;const adapterDisplayName=toOptionalNonEmptyString(runtimeDefinition.name)??toOptionalNonEmptyString(registration.definition.name);if(!adapterDisplayName){return null}const upsert=runtimeDefinition.upsert;const deleteHandler=runtimeDefinition.delete;return{adapterName:adapterDisplayName,...typeof upsert==="function"?{upsert}:{},...typeof deleteHandler==="function"?{delete:deleteHandler}:{}}}function assertVector(value,context){if(!Array.isArray(value)||value.some(entry=>typeof entry!=="number"||!Number.isFinite(entry))){throw new PmCliError(`Invalid vector returned by ${context}`,EXIT_CODE.GENERIC_FAILURE)}return value}async function executeExtensionEmbedding(extensionEmbedding,settings,corpusInputs){const model=settings.search?.embedding_model?.trim()||"text-embedding-3-small";if(extensionEmbedding.embedBatch){const vectors2=await Promise.resolve(extensionEmbedding.embedBatch({inputs:corpusInputs,settings,model}));if(!Array.isArray(vectors2)){throw new PmCliError(`Extension search provider "${extensionEmbedding.name}" embedBatch must return an array of vectors`,EXIT_CODE.GENERIC_FAILURE)}return vectors2.map((vector,index)=>assertVector(vector,`extension search provider "${extensionEmbedding.name}" embedBatch output at index ${index}`))}if(!extensionEmbedding.embed){throw new PmCliError(`Extension search provider "${extensionEmbedding.name}" does not implement embed/embedBatch`,EXIT_CODE.GENERIC_FAILURE)}const vectors=[];for(const[index,input]of corpusInputs.entries()){const vector=await Promise.resolve(extensionEmbedding.embed({input,settings,model}));vectors.push(assertVector(vector,`extension search provider "${extensionEmbedding.name}" embed output at index ${index}`))}return vectors}function resolveExtensionEmbeddingModel(settings){return settings.search?.embedding_model?.trim()||"text-embedding-3-small"}function resolveReindexEmbeddingIdentity(settings,activeEmbeddingProvider,extensionEmbedding){const identity=extensionEmbedding?buildVectorizationEmbeddingIdentity(extensionEmbedding.name,resolveExtensionEmbeddingModel(settings)):activeEmbeddingProvider?buildVectorizationEmbeddingIdentity(activeEmbeddingProvider.name,activeEmbeddingProvider.model):null;if(!identity){throw new PmCliError(`No embedding identity available for semantic reindex mode`,EXIT_CODE.USAGE)}return identity}function collectLedgerOrphanIds(ledgerEntries,currentIds){return Object.keys(ledgerEntries).filter(id=>!currentIds.has(id)).sort((left,right)=>left.localeCompare(right))}async function executeReindexEmbedding(settings,requestedMode,activeEmbeddingProvider,extensionEmbedding,documents,semanticWarnings,semanticSummary,progressEnabled){const semanticProviderName=extensionEmbedding?.name??activeEmbeddingProvider?.name;const corpusCharacterLimit=resolveSemanticCorpusCharacterLimit(semanticProviderName,settings.search.embedding_corpus_max_characters).maxCharacters;const corpusFields=resolveSearchCorpusFields(settings);const corpusInputs=documents.map(document=>buildSemanticCorpusInput(document,{providerName:semanticProviderName,maxCharacters:corpusCharacterLimit,fields:corpusFields}));let vectors=[];let embeddingIdentity=null;if(extensionEmbedding){try{vectors=await executeExtensionEmbedding(extensionEmbedding,settings,corpusInputs);embeddingIdentity=buildVectorizationEmbeddingIdentity(extensionEmbedding.name,resolveExtensionEmbeddingModel(settings))}catch(error){if(!activeEmbeddingProvider){throw new PmCliError(`Extension search provider "${extensionEmbedding.name}" failed to generate embeddings: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}semanticWarnings.push(`Extension search provider "${extensionEmbedding.name}" failed; falling back to built-in provider (${error instanceof Error?error.message:String(error)})`)}}if(vectors.length===0){if(!activeEmbeddingProvider){throw new PmCliError(`No embedding executor available for reindex mode '${requestedMode}'`,EXIT_CODE.USAGE)}const embeddingResult=await executeEmbeddingBatchesWithRetry(activeEmbeddingProvider,settings,corpusInputs,{onProgress:event=>{if(event.phase==="complete"){semanticSummary.batches_completed=event.batch_index}emitReindexProgress(progressEnabled,`embedding_batch_${event.phase} batch=${event.batch_index}/${event.batch_total} size=${event.batch_size} completed_inputs=${event.completed_inputs}/${event.total_inputs}`)}});semanticWarnings.push(...embeddingResult.warnings);semanticSummary.batching=embeddingResult.receipt;vectors=embeddingResult.vectors;embeddingIdentity=buildVectorizationEmbeddingIdentity(activeEmbeddingProvider.name,activeEmbeddingProvider.model)}emitReindexProgress(progressEnabled,`embedding_complete vectors=${vectors.length}`);if(vectors.length!==documents.length){throw new PmCliError(`Embedding output size mismatch (expected ${documents.length}, received ${vectors.length})`,EXIT_CODE.GENERIC_FAILURE)}if(!embeddingIdentity){throw new PmCliError(`No embedding identity available for reindex mode '${requestedMode}'`,EXIT_CODE.USAGE)}return{vectors,embeddingIdentity}}async function resetVectorStoreForReindex(activeVectorStore,extensionVectorAdapter,ledgerEntries,settings,semanticWarnings,vectorDimension){const knownIds=Object.keys(ledgerEntries);if(extensionVectorAdapter){if(knownIds.length>0&&extensionVectorAdapter.delete){try{await Promise.resolve(extensionVectorAdapter.delete({ids:knownIds.sort((left,right)=>left.localeCompare(right)),settings}))}catch(error){throw new PmCliError(`Extension vector adapter "${extensionVectorAdapter.adapterName}" failed to delete vectors during reindex reset: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}}else if(knownIds.length>0){semanticWarnings.push(`search_semantic_reindex_reset_skipped:adapter=${extensionVectorAdapter.adapterName}:known_ids=${knownIds.length}`)}if(!activeVectorStore){return}}if(activeVectorStore){await executeVectorReset(activeVectorStore,knownIds,{},vectorDimension)}}async function pruneReindexOrphanVectors(activeVectorStore,extensionVectorAdapter,orphanIds,settings,semanticWarnings){if(orphanIds.length===0){return}if(extensionVectorAdapter){if(extensionVectorAdapter.delete){try{await Promise.resolve(extensionVectorAdapter.delete({ids:orphanIds,settings}))}catch(error){throw new PmCliError(`Extension vector adapter "${extensionVectorAdapter.adapterName}" failed to delete orphan vectors during reindex: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}}else{semanticWarnings.push(`search_semantic_reindex_orphan_prune_skipped:adapter=${extensionVectorAdapter.adapterName}:count=${orphanIds.length}`)}if(!activeVectorStore){return}}if(activeVectorStore){await executeVectorDelete(activeVectorStore,orphanIds)}}function createReindexSemanticSummary(mode){return{enabled:mode!=="keyword",stale_items:0,unchanged_items:0,embedded_items:0,vector_upserted:0,batches_completed:0}}function buildReindexManifest(mode,generatedAt,metadataDocuments){return{version:1,mode,generated_at:generatedAt,total_items:metadataDocuments.length,items:metadataDocuments.map(document=>({id:document.metadata.id,type:document.metadata.type,status:document.metadata.status,priority:document.metadata.priority,updated_at:document.metadata.updated_at}))}}function assertSemanticRuntimeAvailable(params){if(params.requestedMode==="keyword"){return{activeEmbeddingProvider:null,activeVectorStore:null}}const providerResolution=resolveEmbeddingProviders(params.settings);if(!providerResolution.active&&!params.extensionEmbedding){throw new PmCliError(`Reindex mode '${params.requestedMode}' requires a configured embedding provider in settings.providers.openai/settings.providers.ollama or an extension provider selected by settings.search.provider`,EXIT_CODE.USAGE)}const vectorResolution=resolveVectorStores(params.settings,params.pmRoot);if(!vectorResolution.active&&!params.extensionVectorAdapter){throw new PmCliError(`Reindex mode '${params.requestedMode}' requires a configured vector store in settings.vector_store.qdrant/settings.vector_store.lancedb or an extension adapter selected by settings.vector_store.adapter`,EXIT_CODE.USAGE)}return{activeEmbeddingProvider:providerResolution.active,activeVectorStore:vectorResolution.active}}async function loadReindexCorpus(params){const typeRegistry=resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations());const loadedCandidates=await loadDocumentCandidates(params.pmRoot,params.settings.item_format,typeRegistry.type_to_folder,params.settings.schema);return{documentCandidates:loadedCandidates.candidates,warnings:[...loadedCandidates.warnings],metadataDocuments:loadedCandidates.candidates.map(candidate=>({metadata:candidate.metadata,body:typeof candidate.body==="string"?candidate.body:""}))}}async function appendKeywordLedgerWarnings(params){const ledger=await readVectorizationStatusLedger(params.pmRoot);params.reindexWarnings.push(...ledger.warnings);if(params.forceFullSemantic){params.reindexWarnings.push("search_semantic_reindex_full_ignored:mode_keyword")}if(!ledger.embedding){return}const currentEmbeddingIdentity=(()=>{try{return resolveReindexEmbeddingIdentity(params.settings,resolveEmbeddingProviders(params.settings).active,params.extensionEmbedding)}catch{return null}})();if(currentEmbeddingIdentity&&hasVectorizationEmbeddingIdentityChanged(ledger.embedding,currentEmbeddingIdentity)){params.reindexWarnings.push("search_semantic_reindex_requires_rebuild:embedding_identity_changed");params.reindexWarnings.push(EMBEDDING_MIGRATION_REINDEX_HINT)}}async function planSemanticReindex(params){const ledger=await readVectorizationStatusLedger(params.pmRoot);params.semanticWarnings.push(...ledger.warnings);const embeddingIdentity=resolveReindexEmbeddingIdentity(params.settings,params.activeEmbeddingProvider,params.extensionEmbedding);const currentIds=new Set(params.metadataDocuments.map(document=>document.metadata.id));const orphanIds=collectLedgerOrphanIds(ledger.entries,currentIds);const resetRequired=hasVectorizationEmbeddingIdentityChanged(ledger.embedding,embeddingIdentity);if(params.forceFullSemantic&&!resetRequired){params.semanticWarnings.push("search_semantic_reindex_full_rebuild_forced")}const staleSourceDocuments=params.forceFullSemantic||resetRequired?params.metadataDocuments:params.metadataDocuments.filter(document=>ledger.entries[document.metadata.id]!==document.metadata.updated_at);const staleIds=new Set(staleSourceDocuments.map(document=>document.metadata.id));const staleDocuments=staleIds.size>0?await hydrateDocuments(params.pmRoot,params.documentCandidates,params.settings.schema,params.reindexWarnings,staleIds):[];return{ledgerEntries:ledger.entries,ledgerEmbedding:ledger.embedding,orphanIds,resetRequired,staleDocuments,freshDocuments:params.metadataDocuments.length-staleDocuments.length}}async function rerunSemanticEmbeddingAfterDimensionChange(params){const staleIds=new Set(params.metadataDocuments.map(document=>document.metadata.id));const staleDocuments=await hydrateDocuments(params.pmRoot,params.documentCandidates,params.settings.schema,params.reindexWarnings,staleIds);params.semanticSummary.stale_items=staleDocuments.length;params.semanticSummary.unchanged_items=0;emitReindexProgress(params.progressEnabled,`embedding_dimension_changed reset_items=${staleDocuments.length}`);const embeddingResult=await executeReindexEmbedding(params.settings,params.requestedMode,params.activeEmbeddingProvider,params.extensionEmbedding,staleDocuments,params.semanticWarnings,params.semanticSummary,params.progressEnabled);return{...embeddingResult,staleDocuments,vectorDimension:inferConsistentVectorDimension(embeddingResult.vectors,"Reindex embeddings")}}async function resolveSemanticEmbeddingForUpsert(params){const embeddingResult=await executeReindexEmbedding(params.settings,params.requestedMode,params.activeEmbeddingProvider,params.extensionEmbedding,params.staleDocuments,params.semanticWarnings,params.semanticSummary,params.progressEnabled);let vectors=embeddingResult.vectors;let actualEmbeddingIdentity=embeddingResult.embeddingIdentity;let vectorDimension=inferConsistentVectorDimension(vectors,"Reindex embeddings");const dimensionChanged=!params.resetRequired&&(hasVectorizationEmbeddingIdentityChanged(params.ledgerEmbedding,actualEmbeddingIdentity)||hasVectorizationVectorDimensionChanged(params.ledgerEmbedding,vectorDimension));if(!dimensionChanged){return{vectors,embeddingIdentity:actualEmbeddingIdentity,staleDocuments:params.staleDocuments,vectorDimension,resetRequired:params.resetRequired}}const rerun=await rerunSemanticEmbeddingAfterDimensionChange(params);vectors=rerun.vectors;actualEmbeddingIdentity=rerun.embeddingIdentity;vectorDimension=rerun.vectorDimension;return{vectors,embeddingIdentity:actualEmbeddingIdentity,staleDocuments:rerun.staleDocuments,vectorDimension,resetRequired:true}}async function upsertReindexVectors(params){if(params.extensionVectorAdapter){try{const adapterName=params.extensionVectorAdapter.adapterName;emitReindexProgress(params.progressEnabled,`vector_upsert_start adapter=${adapterName} points=${params.points.length}`);if(typeof params.extensionVectorAdapter.upsert!=="function"){throw new PmCliError(`Extension vector adapter "${adapterName}" does not support upserting vectors.`,EXIT_CODE.USAGE)}await Promise.resolve(params.extensionVectorAdapter.upsert({points:params.points,settings:params.settings}));params.semanticSummary.vector_upserted=params.points.length;emitReindexProgress(params.progressEnabled,`vector_upsert_complete adapter=${adapterName}`);return}catch(error){if(error instanceof PmCliError){throw error}if(!params.activeVectorStore){throw new PmCliError(`Extension vector adapter "${params.extensionVectorAdapter.adapterName}" failed to upsert vectors: ${error instanceof Error?error.message:String(error)}`,EXIT_CODE.GENERIC_FAILURE)}params.semanticWarnings.push(`Extension vector adapter "${params.extensionVectorAdapter.adapterName}" failed; falling back to built-in vector store (${error instanceof Error?error.message:String(error)})`);emitReindexProgress(params.progressEnabled,"vector_upsert_fallback built_in_store")}}if(params.activeVectorStore){emitReindexProgress(params.progressEnabled,`vector_upsert_start adapter=${params.activeVectorStore.name} points=${params.points.length}`);await executeVectorUpsert(params.activeVectorStore,params.points);params.semanticSummary.vector_upserted=params.points.length;emitReindexProgress(params.progressEnabled,`vector_upsert_complete adapter=${params.activeVectorStore.name}`);return}throw new PmCliError(`No vector upsert executor available for reindex mode '${params.requestedMode}'`,EXIT_CODE.USAGE)}function buildReindexVectorPoints(staleDocuments,vectors){return staleDocuments.map((document,index)=>({id:document.metadata.id,vector:assertVector(vectors[index],`reindex embeddings output at index ${index}`),payload:{id:document.metadata.id,type:document.metadata.type,status:document.metadata.status,priority:document.metadata.priority,updated_at:document.metadata.updated_at}}))}async function executeSemanticVectorRefresh(params){emitReindexProgress(params.progressEnabled,`embedding_start items=${params.plan.staleDocuments.length} unchanged_items=${params.plan.freshDocuments}`);const embedding=await resolveSemanticEmbeddingForUpsert({pmRoot:params.pmRoot,settings:params.settings,requestedMode:params.requestedMode,activeEmbeddingProvider:params.activeEmbeddingProvider,extensionEmbedding:params.extensionEmbedding,documentCandidates:params.documentCandidates,metadataDocuments:params.metadataDocuments,staleDocuments:params.plan.staleDocuments,ledgerEmbedding:params.plan.ledgerEmbedding,resetRequired:params.plan.resetRequired,semanticWarnings:params.semanticWarnings,reindexWarnings:params.reindexWarnings,semanticSummary:params.semanticSummary,progressEnabled:params.progressEnabled});if(embedding.resetRequired){emitReindexProgress(params.progressEnabled,"vector_reset_start");await resetVectorStoreForReindex(params.activeVectorStore,params.extensionVectorAdapter,params.plan.ledgerEntries,params.settings,params.semanticWarnings,params.plan.ledgerEmbedding?embedding.vectorDimension:void 0);emitReindexProgress(params.progressEnabled,"vector_reset_complete")}else{await pruneReindexOrphanVectors(params.activeVectorStore,params.extensionVectorAdapter,params.plan.orphanIds,params.settings,params.semanticWarnings)}const points=buildReindexVectorPoints(embedding.staleDocuments,embedding.vectors);params.semanticSummary.embedded_items=embedding.vectors.length;await upsertReindexVectors({requestedMode:params.requestedMode,activeVectorStore:params.activeVectorStore,extensionVectorAdapter:params.extensionVectorAdapter,settings:params.settings,points,semanticWarnings:params.semanticWarnings,semanticSummary:params.semanticSummary,progressEnabled:params.progressEnabled});return{staleDocuments:embedding.staleDocuments,embeddingMetadata:buildVectorizationEmbeddingMetadata(embedding.embeddingIdentity,embedding.vectorDimension)}}async function runSemanticReindex(params){const plan=await planSemanticReindex(params);params.semanticSummary.stale_items=plan.staleDocuments.length;params.semanticSummary.unchanged_items=plan.freshDocuments;const vectorizationLedgerEntries=Object.fromEntries(params.metadataDocuments.map(document=>[document.metadata.id,document.metadata.updated_at]));emitReindexProgress(params.progressEnabled,`semantic_stale_items stale=${plan.staleDocuments.length} total=${params.metadataDocuments.length} unchanged=${plan.freshDocuments} full=${params.forceFullSemantic||plan.resetRequired}`);if(plan.staleDocuments.length===0){emitReindexProgress(params.progressEnabled,`embedding_skipped unchanged_items=${plan.freshDocuments}`);params.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${plan.freshDocuments}`);await pruneReindexOrphanVectors(params.activeVectorStore,params.extensionVectorAdapter,plan.orphanIds,params.settings,params.semanticWarnings);return{documentsForKeywordArtifacts:params.documentsForKeywordArtifacts,vectorizationLedgerEntries,vectorizationEmbeddingMetadata:plan.ledgerEmbedding}}const refresh=await executeSemanticVectorRefresh({...params,plan});if(plan.freshDocuments>0){params.semanticWarnings.push(`search_semantic_reindex_skipped_unchanged:count=${plan.freshDocuments}`)}const staleDocumentsById=new Map(refresh.staleDocuments.map(document=>[document.metadata.id,document]));return{documentsForKeywordArtifacts:params.metadataDocuments.map(document=>staleDocumentsById.get(document.metadata.id)??document),vectorizationLedgerEntries,vectorizationEmbeddingMetadata:refresh.embeddingMetadata}}async function writeReindexArtifacts(params){const manifestPath=path.join(params.pmRoot,MANIFEST_PATH);const embeddingsPath=path.join(params.pmRoot,EMBEDDINGS_PATH);const keywordCorpusFields=resolveSearchCorpusFields(params.settings);const embeddingsLines=params.documentsForKeywordArtifacts.map(document=>JSON.stringify(buildKeywordRecord(document,params.mode,keywordCorpusFields))).join("\n");emitReindexProgress(params.progressEnabled,"writing keyword artifacts");await writeFileAtomic(manifestPath,`${JSON.stringify(params.manifest,null,2)}
 `);await writeFileAtomic(embeddingsPath,`${embeddingsLines}
 `);const vectorizationWarnings=[];if(params.mode!=="keyword"){try{emitReindexProgress(params.progressEnabled,"writing vectorization status ledger");await writeVectorizationStatusLedger(params.pmRoot,params.vectorizationLedgerEntries,params.vectorizationEmbeddingMetadata)}catch(error){vectorizationWarnings.push(`search_vectorization_status_ledger_write_failed:${error instanceof Error?error.message:String(error)}`)}}return vectorizationWarnings}async function runReindex(options,global2){const requestedMode=parseMode(options.mode);const progressEnabled=shouldEmitReindexProgress(options);const forceFullSemantic=options.full===true;emitReindexProgress(progressEnabled,`start mode=${requestedMode}`);const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=resolveSettingsWithSemanticRuntimeDefaults(await readSettings(pmRoot)).settings;let releaseReindexLock=null;try{releaseReindexLock=await acquireLock(pmRoot,REINDEX_LOCK_ID,settings.locks.ttl_seconds,resolveAuthor(void 0,"pm-reindex"),false,settings.governance.force_required_for_stale_lock,settings.locks.wait_ms)}catch(error){if(error instanceof PmCliError&&error.exitCode===EXIT_CODE.CONFLICT){throw new PmCliError("Another pm reindex run is already active for this project. Wait for it to finish before starting a new keyword, semantic, or hybrid reindex.",EXIT_CODE.CONFLICT,{code:"reindex_already_running",type:"urn:pm-cli:error:reindex_already_running",why:"Semantic reindex can be expensive and duplicate runs compete for the same local embedding model and vector store.",nextSteps:["Check active pm reindex processes before starting another reindex.","Rerun with --progress when you need non-interactive visibility."]})}throw error}try{const extensionEmbedding=resolveExtensionSearchEmbedding(settings);const extensionVectorAdapter=resolveExtensionVectorAdapter(settings);const semanticRuntime=assertSemanticRuntimeAvailable({requestedMode,pmRoot,settings,extensionEmbedding,extensionVectorAdapter});const mode=requestedMode;emitReindexProgress(progressEnabled,"loading item corpus");const corpus=await loadReindexCorpus({pmRoot,settings});const reindexWarnings=corpus.warnings;const{documentCandidates,metadataDocuments}=corpus;emitReindexProgress(progressEnabled,`loaded_items=${metadataDocuments.length}`);const generatedAt=nowIso();const manifest=buildReindexManifest(mode,generatedAt,metadataDocuments);const manifestPath=path.join(pmRoot,MANIFEST_PATH);const embeddingsPath=path.join(pmRoot,EMBEDDINGS_PATH);let documentsForKeywordArtifacts=mode==="keyword"?await hydrateDocuments(pmRoot,documentCandidates,settings.schema,reindexWarnings):metadataDocuments;const semanticWarnings=[];let vectorizationLedgerEntries={};let vectorizationEmbeddingMetadata=null;const semanticSummary=createReindexSemanticSummary(mode);if(mode==="keyword"){await appendKeywordLedgerWarnings({pmRoot,settings,forceFullSemantic,extensionEmbedding,reindexWarnings})}if(mode!=="keyword"){const semantic=await runSemanticReindex({pmRoot,settings,requestedMode,activeEmbeddingProvider:semanticRuntime.activeEmbeddingProvider,activeVectorStore:semanticRuntime.activeVectorStore,extensionEmbedding,extensionVectorAdapter,documentCandidates,metadataDocuments,documentsForKeywordArtifacts,forceFullSemantic,reindexWarnings,semanticWarnings,semanticSummary,progressEnabled});documentsForKeywordArtifacts=semantic.documentsForKeywordArtifacts;vectorizationLedgerEntries=semantic.vectorizationLedgerEntries;vectorizationEmbeddingMetadata=semantic.vectorizationEmbeddingMetadata}const vectorizationWarnings=await writeReindexArtifacts({pmRoot,mode,manifest,documentsForKeywordArtifacts,settings,vectorizationLedgerEntries,vectorizationEmbeddingMetadata,progressEnabled});const hookWarnings=[...await runActiveOnWriteHooks({path:manifestPath,scope:"project",op:"reindex:manifest"}),...await runActiveOnWriteHooks({path:embeddingsPath,scope:"project",op:"reindex:embeddings"}),...await runActiveOnIndexHooks({mode,total_items:metadataDocuments.length})];emitReindexProgress(progressEnabled,"done");return{ok:true,mode,total_items:metadataDocuments.length,semantic:semanticSummary,artifacts:{manifest:MANIFEST_PATH,embeddings:EMBEDDINGS_PATH},warnings:[...reindexWarnings,...semanticWarnings,...vectorizationWarnings,...hookWarnings],generated_at:generatedAt}}finally{await releaseReindexLock?.()}}export{_testOnly,runReindex};
 //# sourceMappingURL=reindex.js.map