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.
Files changed (39) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/.cursor/hooks.json +105 -64
  3. package/.cursor/skills/configure-scc/SKILL.md +20 -20
  4. package/.cursor/skills/mcp-server-patterns/SKILL.md +1 -1
  5. package/.cursor/skills/sf-harness-audit/SKILL.md +6 -6
  6. package/.cursor/skills/sf-quickstart/SKILL.md +7 -7
  7. package/.cursor-plugin/plugin.json +2 -2
  8. package/README.md +51 -37
  9. package/docs/ARCHITECTURE.md +4 -4
  10. package/docs/authoring-guide.md +2 -2
  11. package/docs/workflow-examples.md +38 -38
  12. package/hooks/hooks.json +56 -71
  13. package/manifests/install-modules.json +10 -8
  14. package/package.json +4 -3
  15. package/schemas/hooks.schema.json +83 -72
  16. package/schemas/plugin.schema.json +59 -21
  17. package/scripts/cli/install-apply.js +9 -9
  18. package/scripts/hooks/doc-file-warning.js +3 -1
  19. package/scripts/hooks/governor-check.js +3 -2
  20. package/scripts/hooks/post-bash-build-complete.js +3 -2
  21. package/scripts/hooks/post-bash-pr-created.js +4 -2
  22. package/scripts/hooks/post-edit-console-warn.js +3 -1
  23. package/scripts/hooks/post-edit-format.js +3 -2
  24. package/scripts/hooks/post-edit-typecheck.js +3 -2
  25. package/scripts/hooks/post-write.js +3 -1
  26. package/scripts/hooks/pre-bash-git-push-reminder.js +3 -2
  27. package/scripts/hooks/pre-bash-tmux-reminder.js +3 -1
  28. package/scripts/hooks/pre-tool-use.js +3 -1
  29. package/scripts/hooks/quality-gate.js +3 -2
  30. package/scripts/hooks/sfdx-scanner-check.js +3 -1
  31. package/scripts/hooks/sfdx-validate.js +3 -1
  32. package/scripts/lib/hook-input.js +105 -0
  33. package/scripts/lib/hooks-adapter.js +265 -0
  34. package/scripts/lib/install-executor.js +164 -1
  35. package/scripts/scc.js +14 -14
  36. package/skills/configure-scc/SKILL.md +20 -20
  37. package/skills/mcp-server-patterns/SKILL.md +1 -1
  38. package/skills/sf-harness-audit/SKILL.md +6 -6
  39. 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/hooks.json && echo "Hooks: ACTIVE" || echo "Hooks: MISSING (run npx scc install)"
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/hooks/hooks.json 2>/dev/null && echo "Governor Check: ACTIVE" || echo "Governor Check: MISSING"
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/hooks/hooks.json 2>/dev/null && echo "Quality Gate: ACTIVE" || echo "Quality Gate: MISSING"
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)