summaryrefslogtreecommitdiff
path: root/.github/policy/schema.json
blob: a3e1489b65f5d452d10617787b34123076213d1d (plain)
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
{
  "type": "object",
  "required": [
    "passes",
    "summary",
    "violations",
    "may_make_external_network_calls",
    "may_download_additional_software",
    "hooks",
    "has_broad_scope_hooks",
    "has_undisclosed_telemetry",
    "description_matches_behavior"
  ],
  "additionalProperties": true,
  "properties": {
    "passes": {
      "type": "boolean",
      "description": "true only if the plugin is safe AND has no broad-scope hooks AND has no undisclosed telemetry AND its description matches its behavior."
    },
    "summary": {
      "type": "string",
      "description": "Brief description of what the plugin does."
    },
    "violations": {
      "type": "string",
      "description": "Specific files/hooks and issues, or empty string if none. When passes=false this MUST cite the file/hook and state what the user was not told."
    },
    "may_make_external_network_calls": {
      "type": "boolean"
    },
    "may_download_additional_software": {
      "type": "boolean"
    },
    "hooks": {
      "type": "array",
      "items": { "type": "string" },
      "description": "One string per registered hook: 'EVENT:path — gated|ungated — network:yes(host)|no'. Empty array if the plugin registers no hooks."
    },
    "has_broad_scope_hooks": {
      "type": "boolean",
      "description": "true if any UserPromptSubmit/PreToolUse/PostToolUse hook runs without a project-relevance gate, or any hook reads user data beyond the plugin's stated scope."
    },
    "has_undisclosed_telemetry": {
      "type": "boolean",
      "description": "true if any hook or shipped code makes an outbound network call to a non-MCP host without explicit disclosure + opt-out in the description/README."
    },
    "description_matches_behavior": {
      "type": "boolean",
      "description": "false if a user reading only the plugin.json description would be surprised by the hooks/telemetry/data-access the plugin actually performs."
    }
  }
}