Documentation
¶
Index ¶
- Constants
- func DiagnosticCodeCategory(code string) (string, bool)
- func DiagnosticCodes() []string
- func IsDiagnosticCategory(category string) bool
- func IsDiagnosticCode(code string) bool
- func IsDiagnosticFreshness(freshness string) bool
- func IsDiagnosticSeverity(severity string) bool
- func ValidateDiagnosticItem(item DiagnosticItem) error
- func ValidateDiagnosticRegistry() error
- type DiagnosticCodeSpec
- type DiagnosticItem
Constants ¶
const ( SeverityOK = "ok" SeverityInfo = "info" SeverityWarn = "warn" SeverityError = "error" SeverityCritical = "critical" )
const ( FreshnessLive = "live" FreshnessOffline = "offline" FreshnessStale = "stale" )
const ( CategoryProvider = "provider" CategoryDaemon = "daemon" CategoryConfig = "config" CategoryVault = "vault" CategoryMCP = "mcp" CategoryBridge = "bridge" CategoryExtension = "extension" CategorySession = "session" CategoryTask = "task" CategoryHome = "home" CategorySecrets = "secrets" CategoryMigrations = "migrations" CategoryNetwork = "network" )
const ( CodeAgentNameReserved = "agent_name_reserved" CodeBinaryVersionMismatch = "binary_version_mismatch" CodeBridgeNotFound = "bridge_not_found" CodeBridgeNotificationSuppressed = "bridge_notification_suppressed" CodeBridgeReady = "bridge_ready" CodeBulkTooLarge = "bulk_too_large" CodeBundleConsentRequired = "bundle_consent_required" CodeBundlePartialFailure = "bundle_partial_failure" CodeBundleSizeExceeded = "bundle_size_exceeded" CodeConfigActiveSessionsBlock = "config_active_sessions_block" CodeConfigApplyUnsupported = "config_apply_unsupported" CodeConfigDriftPresent = "config_drift_present" CodeConfigDriftStale = "config_drift_stale" CodeConfigInvalid = "config_invalid" CodeConfigPartialFailure = "config_partial_failure" CodeConfigProfileLayerOrphaned = "config_profile_layer_orphaned" CodeConfigReloadTimeout = "config_reload_timeout" CodeConfigRestartRequired = "config_restart_required" CodeConfigValidateFailed = "config_validate_failed" CodeConfigValidated = "config_validated" CodeCursorConflict = "cursor_conflict" CodeDaemonDraining = "daemon_draining" CodeDaemonStateSuspect = "daemon_state_suspect" CodeDaemonStatusOK = "daemon_status_ok" CodeDiskWriteFailed = "disk_write_failed" CodeExtensionChecksumUnverified = "extension_checksum_unverified" CodeExtensionGitVersionUnsupported = "extension_git_version_unsupported" CodeExtensionInstallFailed = "extension_install_failed" CodeExtensionInstallCleanupFailed = "extension_install_cleanup_failed" CodeExtensionRemoveCleanupFailed = "extension_remove_cleanup_failed" CodeExtensionUpdateFailed = "extension_update_failed" CodeExtensionUpdateCleanupFailed = "extension_update_cleanup_failed" CodeExtensionInUse = "extension_in_use" CodeExtensionNotFound = "extension_not_found" CodeExtensionMCPServerUnhealthy = "extension_mcp_server_unhealthy" CodeFlagNotApplicable = "flag_not_applicable" CodeForbiddenOperatorAction = "forbidden_operator_action" CodeForceOpRateLimited = "force_op_rate_limited" CodeForceOpRequiresReason = "force_op_requires_reason" CodeHomeDiskSpaceCritical = "home_disk_space_critical" CodeHomeDiskSpaceLow = "home_disk_space_low" CodeHomePathMissing = "home_path_missing" CodeHomePermsWrong = "home_perms_wrong" CodeIDFormatUnknown = "id_format_unknown" CodeIdentityMismatch = "identity_mismatch" CodeIdentityRequired = "identity_required" CodeIdentityStale = "identity_stale" CodeLegacyDatabase = "legacy_database" CodeMarketplacePluginDuplicate = "duplicate_plugin" CodeMarketplacePluginInvalid = "invalid_plugin" CodeMarketplacePluginSourceUnsupported = "unsupported_source" CodeModelNotFound = "model_not_found" CodeMCPAuthRequired = "mcp_auth_required" CodeMCPInstallEventPersistFailed = "mcp_install_event_persist_failed" CodeMCPServerReady = "mcp_server_ready" CodeMigrationsPending = "migrations_pending" CodeNetworkDisabled = "network_disabled" CodeNetworkReady = "network_ready" CodePresetBuiltinProtected = "preset_builtin_protected" CodePresetDuplicateName = "preset_duplicate_name" CodePresetFilterInvalid = "preset_filter_invalid" CodePresetNotFound = "preset_not_found" CodeProbeFailed = "probe_failed" CodeProbeTimeout = "probe_timeout" CodePromptDispatchIndeterminate = "prompt_dispatch_indeterminate" CodePromptIdempotencyConflict = "prompt_idempotency_conflict" CodePromptMessageIdentityConflict = "prompt_message_identity_conflict" CodeProviderClassificationUnknown = "provider_classification_unknown" CodeProviderCLIMissing = "provider_cli_missing" CodeProviderCredentialUnresolved = "provider_credential_unresolved" CodeProviderLoginRequiresLocalTTY = "provider_login_requires_local_tty" CodeProviderAuthenticated = "provider_authenticated" CodeProviderNotAuthenticated = "provider_not_authenticated" CodeProviderNotInstalled = "provider_not_installed" CodeProviderPermissionDenied = "provider_permission_denied" CodeProviderRateLimited = "provider_rate_limited" CodeProviderTransientFailure = "provider_transient_failure" CodeReasoningEffortUnsupported = "reasoning_effort_unsupported" CodeReasoningOptionMissing = "reasoning_option_missing" CodeSpeedRejected = "speed_rejected" CodeRoleAgentNotFound = "role_agent_not_found" CodeRoleResolutionFailed = "role_resolution_failed" CodeRoleUnknown = "role_unknown" CodeRetryChainTooDeep = "retry_chain_too_deep" CodeSchedulerReady = "scheduler_ready" CodeSchedulerPaused = "scheduler_paused" CodeSchemaAhead = "schema_ahead" // #nosec G101 -- diagnostic code label, not credential material. CodeSecretsPermsWrong = "secrets_perms_wrong" CodeSessionBusy = "session_busy" CodeSessionLocked = "session_locked" CodeSessionQueueFull = "session_queue_full" CodeSessionResumeAmbiguous = "session_resume_ambiguous" CodeSkillRegistryReady = "skill_registry_ready" CodeSkillNotFound = "skill_not_found" CodeSocketPathUnwritable = "socket_path_unwritable" CodeTargetAmbiguous = "target_ambiguous" CodeTargetUnknown = "target_unknown" CodeTaskRunAlreadyTerminal = "task_run_already_terminal" CodeTaskRunCrashed = "task_run_crashed" CodeTaskRunNotRecoverable = "task_run_not_recoverable" CodeTaskRunNotReleasable = "task_run_not_releasable" CodeTaskRunOrphan = "task_run_orphan" CodeTaskRunStaleLease = "task_run_stale_lease" CodeTaskRunStillActive = "task_run_still_active" CodeTaskRunStranded = "task_run_stranded" CodeTaskRunStuck = "task_run_stuck" CodeUnknownActorFormat = "unknown_actor_format" CodeUnknownComponent = "unknown_component" CodeVaultRefUnresolved = "vault_ref_unresolved" )
const ( CodeExtensionClientComponentIgnored = "client_component_ignored" CodeExtensionAgentPluginComponentSkipped = "extension_agent_plugin_component_skipped" CodeExtensionAgentPluginManifestInvalid = "extension_agent_plugin_manifest_invalid" CodeExtensionAgentPluginNotManifest = "extension_agent_plugin_not_manifest" CodeExtensionAgentPluginSchemaUnsupported = "extension_agent_plugin_schema_unsupported" )
const ( CodeExtensionArchiveDigestMismatch = "extension_archive_digest_mismatch" CodeExtensionNameConflict = "extension_name_conflict" CodeExtensionSourceChanged = "extension_source_changed" CodeExtensionInputsRequired = "extension_inputs_required" CodeExtensionInputInvalid = "extension_input_invalid" CodeExtensionAgentConflict = "extension_agent_conflict" CodeExtensionEnvBindingDangling = "extension_env_binding_dangling" CodeExtensionEnvBindingInvalid = "extension_env_binding_invalid" CodeExtensionEnvBindingUndeclared = "extension_env_binding_undeclared" CodeExtensionNetworkConfirmRequired = "extension_network_confirmation_required" CodeExtensionRegistryTierUnverified = "extension_registry_tier_unverified" CodeExtensionUnverifiedPolicyBlocked = "extension_unverified_policy_blocked" )
Variables ¶
This section is empty.
Functions ¶
func DiagnosticCodeCategory ¶
DiagnosticCodeCategory returns the canonical category for code.
func DiagnosticCodes ¶
func DiagnosticCodes() []string
DiagnosticCodes returns all registered deterministic diagnostic codes.
func IsDiagnosticCategory ¶
IsDiagnosticCategory reports whether category belongs to the closed set.
func IsDiagnosticCode ¶
IsDiagnosticCode reports whether code belongs to the canonical registry.
func IsDiagnosticFreshness ¶
IsDiagnosticFreshness reports whether freshness belongs to the closed set.
func IsDiagnosticSeverity ¶
IsDiagnosticSeverity reports whether severity belongs to the closed set.
func ValidateDiagnosticItem ¶
func ValidateDiagnosticItem(item DiagnosticItem) error
ValidateDiagnosticItem checks the public contract without mutating it.
func ValidateDiagnosticRegistry ¶
func ValidateDiagnosticRegistry() error
ValidateDiagnosticRegistry checks duplicate codes and unknown categories.
Types ¶
type DiagnosticCodeSpec ¶
DiagnosticCodeSpec records the canonical owner metadata for one code.
func DiagnosticCodeSpecs ¶
func DiagnosticCodeSpecs() []DiagnosticCodeSpec
DiagnosticCodeSpecs returns the sorted canonical diagnostic code registry.
type DiagnosticItem ¶
type DiagnosticItem struct {
ID string `json:"id"`
Code string `json:"code"`
Severity string `json:"severity"`
Category string `json:"category"`
Title string `json:"title"`
Message string `json:"message"`
SuggestedCommand string `json:"suggested_command,omitempty"`
DocURL string `json:"doc_url,omitempty"`
DataFreshness string `json:"data_freshness"`
Evidence map[string]any `json:"evidence,omitempty"`
}
DiagnosticItem is the canonical actionable-diagnostic wire shape.