# 1. Check installed CLI version: dmint --version # 2. Verify policy validity and simulate a command offline (LLM-free): dmint verify-policy policy.json dmint check -p policy.json -t shell.execute -r "git status" # 2b. Check installed coding-agent PreToolUse hooks: dmint hook status # 3. Check pending approvals in store: dmint pending --db-path approvals.sqlite3 # 4. Verify signing key permissions (must be mode 0600): ls -la ~/.config/dmint/
| Error Message or Symptom | Likely Cause | Solution |
DMT_APPROVAL_REQUEST_MISMATCH | Arguments changed between approval and execution retry. | Ensure retried call uses identical arguments as approved. |
DMT_APPROVAL_CONSUMED | Approval token was already used. | Approvals are single-use; re-request approval for subsequent call. |
DMT_APPROVAL_EXPIRED | Configured approval_ttl elapsed before retry. | Approvals expire after approval_ttl; re-request approval. |
DMT_APPROVAL_POLICY_INVALID | policy.json modified after approval issued. | Re-request approval under the updated policy. |
DMT_KEY_PERMISSION_ERROR | Key file permissions looser than 0600. | Run chmod 0600 ~/.config/dmint/*.key. |
DMT_MCP_PROTOCOL_ERROR: duplicate JSON key | Inbound MCP JSON contains duplicate keys. | Strip duplicate dictionary keys in caller payload. |
DMT_MCP_SCHEMA_MISMATCH | Downstream MCP tool schema changed. | Inspect changes and update tool_schema_hash in mcp_protection.json. |
ApprovalStoreConfigurationError: connection refused | PostgreSQL unreachable on port 5432. | Ensure PostgreSQL container or service is running. |
PolicyError: constraints cannot be applied to DENY rules | policy.json defines constraints on DENY. | Remove constraints from the DENY rule. |
DMT_APPROVAL_REQUEST_MISMATCHdmint.core.errors.ApprovalRequestMismatchError: DMT_APPROVAL_REQUEST_MISMATCH
DMT_KEY_PERMISSION_ERRORdmint.core.errors.KeyPermissionError: key file '/home/user/.config/dmint/signing.key' has insecure permissions
chmod 0600 ~/.config/dmint/signing.key chmod 0600 ~/.config/dmint/integrity.key chmod 0700 ~/.config/dmint/
DMT_MCP_SCHEMA_MISMATCHdmint.mcp.errors.MCPProxyError: [DMT_MCP_SCHEMA_MISMATCH] downstream tool 'query' schema does not match pinned hash
tool_schema_hash in mcp_protection.json.dmint create-mcp-policy --config-output mcp_protection.json
DMT_APPROVAL_POLICY_INVALIDdmint.core.errors.ApprovalPolicyInvalidError: DMT_APPROVAL_POLICY_INVALID
policy.json. A new policy was loaded, which automatically changes the policy SHA-256 digest and epoch.ApprovalStoreConfigurationError: connection refuseddmint.core.errors.ApprovalStoreConfigurationError: Failed to connect to database: (psycopg2.OperationalError) connection to server at "localhost", port 5432 failed: Connection refused
DMINT_DATABASE_URL pointing to PostgreSQL, but the database daemon is unreachable.docker ps | grep postgres
DMINT_DATABASE_URL.