scc-universal 1.1.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +2 -2
- package/.cursor/hooks.json +105 -64
- package/.cursor/skills/configure-scc/SKILL.md +20 -20
- package/.cursor/skills/mcp-server-patterns/SKILL.md +1 -1
- package/.cursor/skills/sf-harness-audit/SKILL.md +6 -6
- package/.cursor/skills/sf-quickstart/SKILL.md +7 -7
- package/.cursor-plugin/plugin.json +2 -2
- package/README.md +51 -37
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/authoring-guide.md +2 -2
- package/docs/workflow-examples.md +38 -38
- package/hooks/hooks.json +56 -71
- package/manifests/install-modules.json +10 -8
- package/package.json +4 -3
- package/schemas/hooks.schema.json +83 -72
- package/schemas/plugin.schema.json +59 -21
- package/scripts/cli/install-apply.js +9 -9
- package/scripts/hooks/doc-file-warning.js +3 -1
- package/scripts/hooks/governor-check.js +3 -2
- package/scripts/hooks/post-bash-build-complete.js +3 -2
- package/scripts/hooks/post-bash-pr-created.js +4 -2
- package/scripts/hooks/post-edit-console-warn.js +3 -1
- package/scripts/hooks/post-edit-format.js +3 -2
- package/scripts/hooks/post-edit-typecheck.js +3 -2
- package/scripts/hooks/post-write.js +3 -1
- package/scripts/hooks/pre-bash-git-push-reminder.js +3 -2
- package/scripts/hooks/pre-bash-tmux-reminder.js +3 -1
- package/scripts/hooks/pre-tool-use.js +3 -1
- package/scripts/hooks/quality-gate.js +3 -2
- package/scripts/hooks/sfdx-scanner-check.js +3 -1
- package/scripts/hooks/sfdx-validate.js +3 -1
- package/scripts/lib/hook-input.js +105 -0
- package/scripts/lib/hooks-adapter.js +265 -0
- package/scripts/lib/install-executor.js +164 -1
- package/scripts/scc.js +14 -14
- package/skills/configure-scc/SKILL.md +20 -20
- package/skills/mcp-server-patterns/SKILL.md +1 -1
- package/skills/sf-harness-audit/SKILL.md +6 -6
- package/skills/sf-quickstart/SKILL.md +7 -7
|
@@ -28,9 +28,9 @@ Interactive guide for installing and configuring Salesforce Claude Code.
|
|
|
28
28
|
npm install -g scc-universal
|
|
29
29
|
|
|
30
30
|
# Install with a profile
|
|
31
|
-
npx scc install all # Everything (all agents, skills, rules)
|
|
32
|
-
npx scc install apex # Apex-focused development
|
|
33
|
-
npx scc install lwc # LWC-focused development
|
|
31
|
+
npx scc-universal install all # Everything (all agents, skills, rules)
|
|
32
|
+
npx scc-universal install apex # Apex-focused development
|
|
33
|
+
npx scc-universal install lwc # LWC-focused development
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
### Profile Details
|
|
@@ -44,10 +44,10 @@ npx scc install lwc # LWC-focused development
|
|
|
44
44
|
### Diagnostics
|
|
45
45
|
|
|
46
46
|
```bash
|
|
47
|
-
npx scc doctor # Check for missing/drifted files
|
|
48
|
-
npx scc status # View installed components
|
|
49
|
-
npx scc repair # Restore drifted files
|
|
50
|
-
npx scc uninstall # Remove SCC-managed files
|
|
47
|
+
npx scc-universal doctor # Check for missing/drifted files
|
|
48
|
+
npx scc-universal status # View installed components
|
|
49
|
+
npx scc-universal repair # Restore drifted files
|
|
50
|
+
npx scc-universal uninstall # Remove SCC-managed files
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
## Hook Configuration
|
|
@@ -113,10 +113,10 @@ CLAUDE_PACKAGE_MANAGER=npm
|
|
|
113
113
|
|
|
114
114
|
| Problem | Cause | Fix |
|
|
115
115
|
|---------|-------|-----|
|
|
116
|
-
| `npx scc install` fails | Node.js < 20 | Upgrade: `nvm install 20` |
|
|
117
|
-
| Hooks not firing | SCC not installed in project | Run `npx scc doctor` to check |
|
|
118
|
-
| `Permission denied` on hooks | Script not executable | Run `npx scc repair` |
|
|
119
|
-
| Skills not loading | Wrong install profile | Run `npx scc install all` |
|
|
116
|
+
| `npx scc-universal install` fails | Node.js < 20 | Upgrade: `nvm install 20` |
|
|
117
|
+
| Hooks not firing | SCC not installed in project | Run `npx scc-universal doctor` to check |
|
|
118
|
+
| `Permission denied` on hooks | Script not executable | Run `npx scc-universal repair` |
|
|
119
|
+
| Skills not loading | Wrong install profile | Run `npx scc-universal install all` |
|
|
120
120
|
| `sf` command not found | SF CLI not installed | Install: `npm install -g @salesforce/cli` |
|
|
121
121
|
| `sf` commands fail with errors | SF CLI version too old | Upgrade: `npm update -g @salesforce/cli` (SCC requires SF CLI v2.x / `sf` not `sfdx`) |
|
|
122
122
|
| Hooks slow down session | Too many hooks enabled | Switch to `SCC_HOOK_PROFILE=minimal` |
|
|
@@ -125,19 +125,19 @@ CLAUDE_PACKAGE_MANAGER=npm
|
|
|
125
125
|
|
|
126
126
|
```bash
|
|
127
127
|
# Full diagnostic report
|
|
128
|
-
npx scc doctor
|
|
128
|
+
npx scc-universal doctor
|
|
129
129
|
|
|
130
130
|
# See exactly what's installed
|
|
131
|
-
npx scc list-installed
|
|
131
|
+
npx scc-universal list-installed
|
|
132
132
|
|
|
133
133
|
# Preview what WOULD be installed (dry run)
|
|
134
|
-
npx scc plan apex
|
|
134
|
+
npx scc-universal plan apex
|
|
135
135
|
|
|
136
136
|
# Check state store
|
|
137
|
-
npx scc status
|
|
137
|
+
npx scc-universal status
|
|
138
138
|
|
|
139
139
|
# Reset everything and reinstall
|
|
140
|
-
npx scc uninstall && npx scc install all
|
|
140
|
+
npx scc-universal uninstall && npx scc-universal install all
|
|
141
141
|
```
|
|
142
142
|
|
|
143
143
|
### Upgrading SCC
|
|
@@ -147,17 +147,17 @@ npx scc uninstall && npx scc install all
|
|
|
147
147
|
npm install -g scc-universal@latest
|
|
148
148
|
|
|
149
149
|
# Repair any drifted files after upgrade
|
|
150
|
-
npx scc repair
|
|
150
|
+
npx scc-universal repair
|
|
151
151
|
|
|
152
152
|
# Verify upgrade
|
|
153
|
-
npx scc doctor
|
|
153
|
+
npx scc-universal doctor
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
## Verification
|
|
157
157
|
|
|
158
158
|
```bash
|
|
159
159
|
npm test # Run all validators
|
|
160
|
-
npx scc doctor # Check installation health
|
|
160
|
+
npx scc-universal doctor # Check installation health
|
|
161
161
|
sf --version # Verify SF CLI is installed
|
|
162
|
-
npx scc status # Confirm installed components
|
|
162
|
+
npx scc-universal status # Confirm installed components
|
|
163
163
|
```
|
|
@@ -76,7 +76,7 @@ Use **Zod** (or the SDK's preferred schema format) for input validation.
|
|
|
76
76
|
|
|
77
77
|
### Official @salesforce/mcp Server
|
|
78
78
|
|
|
79
|
-
MCP config is auto-installed by `npx scc install` (`.mcp.json` for Claude Code, `.cursor/mcp.json` for Cursor). The official `@salesforce/mcp` server provides these toolsets:
|
|
79
|
+
MCP config is auto-installed by `npx scc-universal install` (`.mcp.json` for Claude Code, `.cursor/mcp.json` for Cursor). The official `@salesforce/mcp` server provides these toolsets:
|
|
80
80
|
|
|
81
81
|
| Toolset | What It Does |
|
|
82
82
|
|---------|-------------|
|
|
@@ -32,7 +32,7 @@ ls -la .claude/agents/ 2>/dev/null
|
|
|
32
32
|
ls -la .claude/skills/ 2>/dev/null
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
If using SCC CLI: `npx scc status`
|
|
35
|
+
If using SCC CLI: `npx scc-universal status`
|
|
36
36
|
|
|
37
37
|
### Step 2 — Score Each Category
|
|
38
38
|
|
|
@@ -113,7 +113,7 @@ SCC Harness Audit
|
|
|
113
113
|
|
|
114
114
|
Top Recommendations:
|
|
115
115
|
1. [+1.0] Enable strict hook profile: export SCC_HOOK_PROFILE=strict
|
|
116
|
-
2. [+0.5] Install all modules: npx scc install all
|
|
116
|
+
2. [+0.5] Install all modules: npx scc-universal install all
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
### Step 4 — Actionable Recommendations
|
|
@@ -122,11 +122,11 @@ For each gap, provide a specific command to fix it:
|
|
|
122
122
|
|
|
123
123
|
| Gap | Fix Command |
|
|
124
124
|
|-----|-------------|
|
|
125
|
-
| Missing hooks | `npx scc repair` |
|
|
126
|
-
| Missing domain rules | `npx scc install all` (or target: `npx scc install apex`, `npx scc install lwc`) |
|
|
127
|
-
| Low skill count | `npx scc install all` |
|
|
125
|
+
| Missing hooks | `npx scc-universal repair` |
|
|
126
|
+
| Missing domain rules | `npx scc-universal install all` (or target: `npx scc-universal install apex`, `npx scc-universal install lwc`) |
|
|
127
|
+
| Low skill count | `npx scc-universal install all` |
|
|
128
128
|
| Wrong hook profile | `export SCC_HOOK_PROFILE=strict` |
|
|
129
|
-
| Drifted files | `npx scc doctor` then `npx scc repair` |
|
|
129
|
+
| Drifted files | `npx scc-universal doctor` then `npx scc-universal repair` |
|
|
130
130
|
|
|
131
131
|
## Examples
|
|
132
132
|
|
|
@@ -82,9 +82,9 @@ Based on detection results, recommend the best SCC profile:
|
|
|
82
82
|
|
|
83
83
|
| Detected Stack | Recommended Profile | Command |
|
|
84
84
|
|---------------|--------------------|---------|
|
|
85
|
-
| Apex + LWC + Flows + triggers | `all` | `npx scc install all` |
|
|
86
|
-
| Primarily Apex (classes + triggers) | `apex` | `npx scc install apex` |
|
|
87
|
-
| Primarily LWC with some Apex | `lwc` | `npx scc install lwc` |
|
|
85
|
+
| Apex + LWC + Flows + triggers | `all` | `npx scc-universal install all` |
|
|
86
|
+
| Primarily Apex (classes + triggers) | `apex` | `npx scc-universal install apex` |
|
|
87
|
+
| Primarily LWC with some Apex | `lwc` | `npx scc-universal install lwc` |
|
|
88
88
|
|
|
89
89
|
**Profile details:**
|
|
90
90
|
|
|
@@ -114,16 +114,16 @@ Check that SCC is properly configured:
|
|
|
114
114
|
|
|
115
115
|
```bash
|
|
116
116
|
# Check hooks are loaded
|
|
117
|
-
test -f .claude/hooks/
|
|
117
|
+
test -f .claude/settings.json && grep -q '"hooks"' .claude/settings.json 2>/dev/null && echo "Hooks: ACTIVE (in settings.json)" || echo "Hooks: MISSING (run npx scc-universal install)"
|
|
118
118
|
|
|
119
119
|
# Check hook profile
|
|
120
120
|
echo "Hook Profile: ${SCC_HOOK_PROFILE:-standard (default)}"
|
|
121
121
|
|
|
122
122
|
# Check for governor-check hook
|
|
123
|
-
grep -q "governor-check" .claude/
|
|
123
|
+
grep -q "governor-check" .claude/settings.json 2>/dev/null && echo "Governor Check: ACTIVE" || echo "Governor Check: MISSING"
|
|
124
124
|
|
|
125
125
|
# Check for quality-gate hook
|
|
126
|
-
grep -q "quality-gate" .claude/
|
|
126
|
+
grep -q "quality-gate" .claude/settings.json 2>/dev/null && echo "Quality Gate: ACTIVE" || echo "Quality Gate: MISSING"
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
### Step 6 — Report
|
|
@@ -146,7 +146,7 @@ Tech Stack Detected:
|
|
|
146
146
|
Custom Objects: 15
|
|
147
147
|
|
|
148
148
|
Recommended Profile: all
|
|
149
|
-
-> npx scc install all
|
|
149
|
+
-> npx scc-universal install all
|
|
150
150
|
|
|
151
151
|
SCC Status:
|
|
152
152
|
Hooks: ACTIVE (standard profile)
|