Error Diagnostics Wizard

The diagnostics wizard (F-18) explains Nomotic errors in plain language with resolution steps.

Usage

nomotic diagnose <error-code-or-alias>

Alias matching supports partial strings:

nomotic diagnose constitutional     # matches ConstitutionalViolationError
nomotic diagnose budget             # matches BudgetExhaustedError
nomotic diagnose veto               # matches GovernanceVetoError

Registered Error Classes

Error Class
Aliases
Description

ConstitutionalViolationError

constitutional, constitution, CVE

A constitutional rule was violated

ConstitutionalIntegrityError

integrity, ruleset_signature

Constitutional ruleset integrity check failed

BudgetExhaustedError

budget, budget_exhausted, cost_limit

Action exceeds cost budget limit

ContinuityViolationError

continuity, state_continuity

State continuity check failed

DelegationDepthError

delegation, delegation_depth, delegation_limit

Delegation chain exceeds max depth

CertificateStatusError

cert_status, certificate_status, cert_inactive

Certificate is not in ACTIVE status

PermissionDeniedError

permission, permission_denied, role_denied, unauthorized

Insufficient role permissions

RoleConfigError

role_config, roles_config

Role registry configuration error

WorkflowDependencyError

workflow, workflow_dependency, dependency

Workflow dependency not satisfied

GovernanceVetoError

veto, governance_veto, denied, blocked

Action denied by governance evaluation

GovernanceDeniedError

governance_denied, tool_denied, tool_governance

Tool-level governance denial

PolicyLoadError

policy_load, policy_file, policy_parse

Failed to load policy file

FrameworkLoadError

framework_load, compliance_framework

Failed to load compliance framework

AGICOMPLYError

agicomply, agicomply_push

AGICOMPLY integration error

NomoticSDKError

sdk, sdk_error, nomotic_sdk

SDK-level error

CertificateLoadError

cert_load, certificate_load, key_load

Failed to load certificate or key

GovernedRequestError

governed_request, http_error, network_error

HTTP request governance error

Doctor Integration

nomotic doctor runs health checks that detect potential issues before they become errors:

Doctor checks include: certificate store integrity, issuer key validity, audit trail chain verification, role registry configuration, constitutional rule integrity, and delegation depth limits.

Last updated