scc-universal 1.1.0 → 1.2.0

package/schemas/hooks.schema.json

@@ -5,119 +5,130 @@
   "description": "JSON Schema for SCC hooks.json — defines Claude Code lifecycle hooks for Salesforce development",
   "type": "object",
   "required": ["hooks"],
-  "additionalProperties": false,
   "properties": {
-    "$schema": {
+    "description": {
       "type": "string",
-      "description": "Schema reference URI"
+      "description": "Top-level description of this hooks configuration (plugin hooks only)"
     },
     "hooks": {
       "type": "object",
       "description": "Map of lifecycle event names to arrays of hook group definitions",
-      "additionalProperties": false,
       "properties": {
-        "SessionStart": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired when a Claude Code session begins"
-        },
-        "PreToolUse": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired before a tool is used"
-        },
-        "PostToolUse": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired after a tool completes"
-        },
-        "PostToolUseFailure": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired when a tool use fails"
-        },
-        "PreCompact": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired before context compaction"
-        },
-        "Stop": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired when Claude Code agent stops"
-        },
-        "SessionEnd": {
-          "$ref": "#/definitions/hookGroupArray",
-          "description": "Hooks fired when a session ends"
-        }
-      }
+        "SessionStart": { "$ref": "#/definitions/hookGroupArray" },
+        "UserPromptSubmit": { "$ref": "#/definitions/hookGroupArray" },
+        "PreToolUse": { "$ref": "#/definitions/hookGroupArray" },
+        "PermissionRequest": { "$ref": "#/definitions/hookGroupArray" },
+        "PermissionDenied": { "$ref": "#/definitions/hookGroupArray" },
+        "PostToolUse": { "$ref": "#/definitions/hookGroupArray" },
+        "PostToolUseFailure": { "$ref": "#/definitions/hookGroupArray" },
+        "Notification": { "$ref": "#/definitions/hookGroupArray" },
+        "SubagentStart": { "$ref": "#/definitions/hookGroupArray" },
+        "SubagentStop": { "$ref": "#/definitions/hookGroupArray" },
+        "TaskCreated": { "$ref": "#/definitions/hookGroupArray" },
+        "TaskCompleted": { "$ref": "#/definitions/hookGroupArray" },
+        "Stop": { "$ref": "#/definitions/hookGroupArray" },
+        "StopFailure": { "$ref": "#/definitions/hookGroupArray" },
+        "TeammateIdle": { "$ref": "#/definitions/hookGroupArray" },
+        "InstructionsLoaded": { "$ref": "#/definitions/hookGroupArray" },
+        "ConfigChange": { "$ref": "#/definitions/hookGroupArray" },
+        "CwdChanged": { "$ref": "#/definitions/hookGroupArray" },
+        "FileChanged": { "$ref": "#/definitions/hookGroupArray" },
+        "WorktreeCreate": { "$ref": "#/definitions/hookGroupArray" },
+        "WorktreeRemove": { "$ref": "#/definitions/hookGroupArray" },
+        "PreCompact": { "$ref": "#/definitions/hookGroupArray" },
+        "PostCompact": { "$ref": "#/definitions/hookGroupArray" },
+        "Elicitation": { "$ref": "#/definitions/hookGroupArray" },
+        "ElicitationResult": { "$ref": "#/definitions/hookGroupArray" },
+        "SessionEnd": { "$ref": "#/definitions/hookGroupArray" }
+      },
+      "additionalProperties": false
     }
   },
   "definitions": {
     "hookGroupArray": {
       "type": "array",
-      "items": {
-        "$ref": "#/definitions/hookGroup"
-      },
+      "items": { "$ref": "#/definitions/hookGroup" },
       "minItems": 1
     },
     "hookGroup": {
       "type": "object",
       "required": ["hooks"],
-      "additionalProperties": false,
       "properties": {
         "matcher": {
           "type": "string",
-          "description": "Optional tool name matcher (e.g., 'Bash', 'Write', 'Read')"
+          "description": "Regex pattern to filter when hooks fire. Use tool name for tool events, source for SessionStart, etc."
         },
         "hooks": {
           "type": "array",
-          "description": "Array of individual hook definitions in this group",
-          "items": {
-            "$ref": "#/definitions/hookDefinition"
-          },
+          "items": { "$ref": "#/definitions/hookDefinition" },
           "minItems": 1
-        },
-        "description": {
-          "type": "string",
-          "description": "Human-readable description of this hook group"
-        },
-        "profile": {
-          "type": "string",
-          "enum": ["minimal", "standard", "strict"],
-          "description": "Minimum profile level required for this hook group to run"
         }
-      }
+      },
+      "additionalProperties": false
     },
     "hookDefinition": {
       "type": "object",
-      "required": ["type", "command"],
-      "additionalProperties": false,
+      "required": ["type"],
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["command"],
-          "description": "Hook execution type — currently only 'command' is supported"
+          "enum": ["command", "http", "prompt", "agent"],
+          "description": "Hook execution type"
         },
         "command": {
           "type": "string",
-          "description": "Shell command to execute. Use ${CLAUDE_PLUGIN_ROOT} for the plugin root path.",
-          "minLength": 1
+          "description": "Shell command to execute (type: command)"
         },
-        "async": {
-          "type": "boolean",
-          "description": "Whether to run this hook asynchronously (non-blocking)",
-          "default": false
+        "url": {
+          "type": "string",
+          "description": "URL to POST to (type: http)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Prompt text for LLM evaluation (type: prompt or agent)"
+        },
+        "model": {
+          "type": "string",
+          "description": "Model to use for prompt/agent hooks"
+        },
+        "if": {
+          "type": "string",
+          "description": "Permission rule syntax filter, e.g. Bash(git *) or Edit(*.cls)"
         },
         "timeout": {
           "type": "integer",
-          "description": "Timeout in seconds before the hook is killed",
-          "minimum": 1,
-          "maximum": 120,
-          "default": 30
+          "description": "Timeout in seconds",
+          "minimum": 1
         },
-        "env": {
+        "async": {
+          "type": "boolean",
+          "description": "Run in background without blocking (command hooks only)"
+        },
+        "shell": {
+          "type": "string",
+          "enum": ["bash", "powershell"],
+          "description": "Shell to use (command hooks only)"
+        },
+        "statusMessage": {
+          "type": "string",
+          "description": "Custom spinner message while hook runs"
+        },
+        "once": {
+          "type": "boolean",
+          "description": "Run only once per session (skills/agents only)"
+        },
+        "headers": {
           "type": "object",
-          "description": "Additional environment variables to set for this hook",
-          "additionalProperties": {
-            "type": "string"
-          }
+          "description": "HTTP headers (type: http)",
+          "additionalProperties": { "type": "string" }
+        },
+        "allowedEnvVars": {
+          "type": "array",
+          "description": "Env vars allowed in header interpolation (type: http)",
+          "items": { "type": "string" }
         }
-      }
+      },
+      "additionalProperties": false
     }
   }
 }

package/schemas/plugin.schema.json

@@ -2,10 +2,9 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://scc-universal/schemas/plugin.schema.json",
   "title": "SCC Plugin Manifest",
-  "description": "JSON Schema for .claude-plugin/plugin.json — describes the SCC plugin for the Claude Code marketplace",
+  "description": "JSON Schema for plugin.json — describes the SCC plugin for Claude Code and Cursor marketplaces",
   "type": "object",
-  "required": ["name", "version", "displayName", "description", "license", "engines", "main"],
-  "additionalProperties": false,
+  "required": ["name", "version", "description"],
   "properties": {
     "$schema": {
       "type": "string",
@@ -35,13 +34,27 @@
       "maxLength": 300
     },
     "author": {
-      "type": "string",
-      "description": "Plugin author name or organization"
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Plugin author name or organization"
+        },
+        {
+          "type": "object",
+          "description": "Plugin author details",
+          "required": ["name"],
+          "properties": {
+            "name": { "type": "string" },
+            "email": { "type": "string", "format": "email" },
+            "url": { "type": "string", "format": "uri" }
+          },
+          "additionalProperties": false
+        }
+      ]
     },
     "license": {
       "type": "string",
-      "description": "SPDX license identifier",
-      "enum": ["MIT", "Apache-2.0", "BSD-2-Clause", "BSD-3-Clause", "ISC", "GPL-3.0", "LGPL-3.0", "MPL-2.0"]
+      "description": "SPDX license identifier"
     },
     "keywords": {
       "type": "array",
@@ -53,15 +66,17 @@
       "minItems": 1,
       "maxItems": 20
     },
+    "logo": {
+      "type": "string",
+      "description": "Relative path to the plugin logo image (SVG or PNG)"
+    },
     "engines": {
       "type": "object",
       "description": "Required harness versions",
-      "additionalProperties": false,
       "properties": {
         "claude-code": {
           "type": "string",
-          "description": "Required Claude Code version (semver range)",
-          "pattern": "^[>=^~]?\\d+\\.\\d+\\.\\d+.*$"
+          "description": "Required Claude Code version (semver range)"
         },
         "node": {
           "type": "string",
@@ -71,17 +86,37 @@
     },
     "main": {
       "type": "string",
-      "description": "Relative path to the primary plugin entry file (hooks.json)",
+      "description": "Relative path to the primary plugin entry file",
       "minLength": 1
     },
     "agents": {
-      "type": "string",
-      "description": "Relative path to agents directory"
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Relative path to agents directory"
+        },
+        {
+          "type": "array",
+          "description": "Array of relative paths to individual agent files",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      ]
     },
     "skills": {
       "type": "string",
       "description": "Relative path to skills directory"
     },
+    "hooks": {
+      "type": "string",
+      "description": "Relative path to hooks configuration file"
+    },
+    "mcpServers": {
+      "type": "string",
+      "description": "Relative path to MCP servers configuration file"
+    },
     "commands": {
       "type": "string",
       "description": "Relative path to commands directory"
@@ -91,17 +126,20 @@
       "description": "Relative path to rules directory"
     },
     "repository": {
-      "type": "object",
-      "description": "Source repository information",
-      "properties": {
-        "type": {
+      "oneOf": [
+        {
           "type": "string",
-          "enum": ["git", "svn"]
+          "description": "Repository URL"
         },
-        "url": {
-          "type": "string"
+        {
+          "type": "object",
+          "description": "Source repository information",
+          "properties": {
+            "type": { "type": "string", "enum": ["git", "svn"] },
+            "url": { "type": "string" }
+          }
         }
-      }
+      ]
     },
     "homepage": {
       "type": "string",

package/scripts/cli/install-apply.js

@@ -17,11 +17,11 @@ const { loadInstallConfig } = require('../lib/install-config');
 
 function showHelp(exitCode = 0) {
   console.log(`
-scc install — Install SCC content
+scc-universal install — Install SCC content
 
 Usage:
-  scc install [target] [options]
-  scc install --profile <name> --target <name>
+  scc-universal install [target] [options]
+  scc-universal install --profile <name> --target <name>
 
 Shorthand targets:
   apex              Install Apex profile content
@@ -37,12 +37,12 @@ Options:
   --help, -h        Show this help
 
 Examples:
-  scc install apex
-  scc install all
-  scc install --config scc-install.json
-  scc install --config scc-install.json --target cursor
-  scc install --profile security --target claude
-  scc install --profile lwc --target cursor --dry-run
+  scc-universal install apex
+  scc-universal install all
+  scc-universal install --config scc-install.json
+  scc-universal install --config scc-install.json --target cursor
+  scc-universal install --profile security --target claude
+  scc-universal install --profile lwc --target cursor --dry-run
 `);
   process.exit(exitCode);
 }

package/scripts/hooks/doc-file-warning.js

@@ -48,7 +48,9 @@ process.stdin.on('data', c => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(data);
-    const filePath = String((input.tool_input && input.tool_input.file_path) || '');
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    const filePath = ctx.filePath;
 
     if (filePath && !isAllowedDocPath(filePath)) {
       console.error('[Hook] WARNING: Non-standard documentation file detected');

package/scripts/hooks/governor-check.js

@@ -195,8 +195,9 @@ function checkGovernorLimits(filePath) {
 function run(rawInput) {
   try {
     const input = JSON.parse(rawInput);
-    const filePath = String(input.tool_input?.file_path || '');
-    checkGovernorLimits(filePath);
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    checkGovernorLimits(ctx.filePath);
   } catch {
     // Ignore errors
   }

package/scripts/hooks/post-bash-build-complete.js

@@ -22,8 +22,9 @@ process.stdin.on('data', chunk => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(raw);
-    const cmd = String(input.tool_input?.command || '');
-    if (/(sf\s+project\s+deploy|sf\s+deploy|sfdx\s+force:source:deploy|npm run build|pnpm build|yarn build)/.test(cmd)) {
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    if (/(sf\s+project\s+deploy|sf\s+deploy|sfdx\s+force:source:deploy|npm run build|pnpm build|yarn build)/.test(ctx.command)) {
       console.error('[Hook] Build/deploy completed - review results above');
     }
   } catch {

package/scripts/hooks/post-bash-pr-created.js

@@ -22,10 +22,12 @@ process.stdin.on('data', chunk => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(raw);
-    const cmd = String(input.tool_input?.command || '');
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    const cmd = ctx.command;
 
     if (/\bgh\s+pr\s+create\b/.test(cmd)) {
-      const out = String(input.tool_output?.output || '');
+      const out = ctx.output;
       const match = out.match(/https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+/);
       if (match) {
         const prUrl = match[0];

package/scripts/hooks/post-edit-console-warn.js

@@ -25,7 +25,9 @@ process.stdin.on('data', chunk => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(data);
-    const filePath = input.tool_input?.file_path;
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    const filePath = ctx.filePath;
 
     if (filePath && /\.(ts|tsx|js|jsx)$/.test(filePath)) {
       let content;

package/scripts/hooks/post-edit-format.js

@@ -54,8 +54,9 @@ function tryFormat(filePath) {
 function run(rawInput) {
   try {
     const input = JSON.parse(rawInput);
-    const filePath = String(input.tool_input?.file_path || '');
-    tryFormat(filePath);
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    tryFormat(ctx.filePath);
   } catch {
     // Ignore errors
   }

package/scripts/hooks/post-edit-typecheck.js

@@ -73,8 +73,9 @@ function checkFile(filePath) {
 function run(rawInput) {
   try {
     const input = JSON.parse(rawInput);
-    const filePath = String(input.tool_input?.file_path || '');
-    checkFile(filePath);
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    checkFile(ctx.filePath);
   } catch {
     // Ignore parse errors
   }

package/scripts/hooks/post-write.js

@@ -153,7 +153,9 @@ rl.on('close', () => {
     process.exit(0);
   }
 
-  const filePath = (input.tool_input && input.tool_input.file_path) || '';
+  const { normalizeInput } = require('../lib/hook-input');
+  const ctx = normalizeInput(input);
+  const filePath = ctx.filePath;
   if (!filePath) process.exit(0);
 
   const fileType = classifyFile(filePath);

package/scripts/hooks/pre-bash-git-push-reminder.js

@@ -22,8 +22,9 @@ process.stdin.on('data', chunk => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(raw);
-    const cmd = String(input.tool_input?.command || '');
-    if (/\bgit\s+push\b/.test(cmd)) {
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    if (/\bgit\s+push\b/.test(ctx.command)) {
       console.error('[Hook] Review changes before push...');
       console.error('[Hook] Continuing with push (remove this hook to add interactive review)');
     }

package/scripts/hooks/pre-bash-tmux-reminder.js

@@ -28,7 +28,9 @@ process.stdin.on('data', chunk => {
 process.stdin.on('end', () => {
   try {
     const input = JSON.parse(raw);
-    const cmd = String(input.tool_input?.command || '');
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    const cmd = ctx.command;
 
     if (
       process.platform !== 'win32' &&

package/scripts/hooks/pre-tool-use.js

@@ -105,7 +105,9 @@ function processInput(input) {
     return null;
   }
 
-  const command = (input.tool_input && input.tool_input.command) || '';
+  const { normalizeInput } = require('../lib/hook-input');
+  const ctx = normalizeInput(input);
+  const command = ctx.command;
   if (!command) return null;
 
   // Skip if command doesn't involve SF/SFDX

package/scripts/hooks/quality-gate.js

@@ -226,8 +226,9 @@ function maybeRunQualityGate(filePath) {
 function run(rawInput) {
   try {
     const input = JSON.parse(rawInput);
-    const filePath = String(input.tool_input?.file_path || '');
-    maybeRunQualityGate(filePath);
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    maybeRunQualityGate(ctx.filePath);
   } catch {
     // Ignore parse errors
   }

package/scripts/hooks/sfdx-scanner-check.js

@@ -84,7 +84,9 @@ function runScanner(files) {
 function run(rawInput) {
   try {
     const input = JSON.parse(rawInput);
-    const command = String(input.tool_input?.command || '');
+    const { normalizeInput } = require('../lib/hook-input');
+    const ctx = normalizeInput(input);
+    const command = ctx.command;
 
     // Only intercept git push and sf deploy commands
     const isGitPush = /\bgit\s+push\b/.test(command);

package/scripts/hooks/sfdx-validate.js

@@ -100,7 +100,9 @@ rl.on('close', () => {
     process.exit(0);
   }
 
-  const command = (input.tool_input && input.tool_input.command) || '';
+  const { normalizeInput } = require('../lib/hook-input');
+  const ctx = normalizeInput(input);
+  const command = ctx.command;
   const warnings = validateCommand(command);
 
   if (warnings.length === 0) {