destructive_command_guard 0.4.3

A Claude Code hook that blocks destructive commands before they execute
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/Dicklesworthstone/destructive_command_guard/docs/json-schema/error.json",
  "title": "DCG Error Response",
  "description": "JSON error format used by dcg CLI commands when errors occur. Errors are typically written to stderr, but some commands include error fields in their JSON output.",
  "type": "object",
  "oneOf": [
    {
      "title": "CLI Error Output",
      "description": "Standard error output format for CLI commands",
      "type": "object",
      "required": ["error"],
      "properties": {
        "error": {
          "type": "string",
          "description": "Human-readable error message"
        },
        "code": {
          "type": "string",
          "enum": ["parse_error", "config_error", "io_error", "validation_error"],
          "description": "Machine-readable error code for programmatic handling"
        },
        "details": {
          "type": "object",
          "description": "Additional context about the error",
          "properties": {
            "file": {
              "type": "string",
              "description": "File path where the error occurred"
            },
            "line": {
              "type": "integer",
              "description": "Line number where the error occurred"
            },
            "column": {
              "type": "integer",
              "description": "Column number where the error occurred"
            }
          }
        }
      }
    },
    {
      "title": "Simulate Command Error",
      "description": "Error tracking in simulate command JSON output",
      "type": "object",
      "required": ["malformed_count", "ignored_count", "stopped_at_limit"],
      "properties": {
        "malformed_count": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of malformed JSON entries that could not be parsed"
        },
        "ignored_count": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of entries ignored due to filters or unsupported types"
        },
        "stopped_at_limit": {
          "type": "boolean",
          "description": "True if processing stopped early due to reaching error limit"
        }
      }
    },
    {
      "title": "Allowlist Error",
      "description": "Error in allowlist configuration",
      "type": "object",
      "required": ["layer", "path", "message"],
      "properties": {
        "layer": {
          "type": "string",
          "enum": ["project", "user", "system"],
          "description": "Which allowlist layer had the error"
        },
        "path": {
          "type": "string",
          "description": "Path to the allowlist file"
        },
        "entry_index": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the problematic entry in the allowlist"
        },
        "message": {
          "type": "string",
          "description": "Human-readable error message"
        }
      }
    }
  ],
  "examples": [
    {
      "error": "JSON parse error: expected ':' at line 1 column 15",
      "code": "parse_error"
    },
    {
      "error": "IO error: Permission denied (os error 13)",
      "code": "io_error",
      "details": {
        "file": "/etc/dcg/config.toml"
      }
    },
    {
      "malformed_count": 3,
      "ignored_count": 12,
      "stopped_at_limit": false
    },
    {
      "layer": "project",
      "path": ".dcg/allowlist.toml",
      "entry_index": 5,
      "message": "Invalid rule ID format: missing colon separator"
    }
  ]
}