scc-universal 1.1.0

package/hooks/hooks.json

@@ -0,0 +1,338 @@
+{
+  "$schema": "../schemas/hooks.schema.json",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-start.js\"",
+            "async": true,
+            "timeout": 15
+          }
+        ],
+        "description": "Display Salesforce project context: detected org, scratch orgs, CLI version"
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/check-platform-docs-age.js\"",
+            "async": true,
+            "timeout": 5
+          }
+        ],
+        "description": "Warn if platform reference docs (deprecations, API versions) are outdated"
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx block-no-verify@1.1.2"
+          }
+        ],
+        "description": "Block git hook-bypass flag to protect pre-commit, commit-msg, and pre-push hooks from being skipped"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"pre:mcp-health-check\" standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/mcp-health-check.js\""
+          }
+        ],
+        "description": "Check MCP server health before MCP tool execution and block unhealthy MCP calls"
+      },
+      {
+        "matcher": "*",
+        "hooks": [{ "type": "command", "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags-shell.sh\" \"pre:observe\" \"scripts/hooks/learning-observe.sh\" \"standard,strict\"", "async": true, "timeout": 10 }],
+        "description": "Capture tool use observations for continuous learning"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-tool-use.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Validate Salesforce CLI commands before execution (deprecation + danger warnings)"
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" doc-file-warning standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/doc-file-warning.js\"",
+            "async": true,
+            "timeout": 5
+          }
+        ],
+        "description": "Warn about non-standard documentation files"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" sfdx-validate standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/sfdx-validate.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Validate SFDX commands for best practices (deploy flags, dry-run suggestions)"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-bash-git-push-reminder standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-bash-git-push-reminder.js\"",
+            "async": true,
+            "timeout": 5
+          }
+        ],
+        "description": "Remind to review changes before git push"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" sfdx-scanner-check standard,strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/sfdx-scanner-check.js\"",
+            "async": true,
+            "timeout": 45
+          }
+        ],
+        "description": "Run sfdx-scanner PMD analysis before git push/sf deploy (standard and strict profiles)"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-bash-tmux-reminder strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-bash-tmux-reminder.js\"",
+            "async": true,
+            "timeout": 5
+          }
+        ],
+        "description": "Remind to use tmux for long-running Salesforce CLI commands (deploy, test, scratch org)"
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" suggest-compact standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/suggest-compact.js\"",
+            "async": true,
+            "timeout": 5
+          }
+        ],
+        "description": "Track tool call count and suggest strategic compaction"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [{ "type": "command", "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags-shell.sh\" \"post:observe\" \"scripts/hooks/learning-observe.sh\" \"standard,strict\"", "async": true, "timeout": 10 }],
+        "description": "Capture tool use results for continuous learning"
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-write.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Detect Apex/LWC file writes and remind about test coverage"
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" quality-gate standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/quality-gate.js\"",
+            "async": true,
+            "timeout": 15
+          }
+        ],
+        "description": "Run quality checks on edited Apex/LWC files (anti-patterns, common issues)"
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" governor-check standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/governor-check.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Check edited Apex files for governor limit violations (SOQL/DML in loops)"
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-console-warn standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-edit-console-warn.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Warn about console.log statements in edited JS/LWC files"
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-format strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-edit-format.js\"",
+            "async": true,
+            "timeout": 15
+          }
+        ],
+        "description": "Auto-format edited files with Prettier (strict profile only)"
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-typecheck strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-edit-typecheck.js\"",
+            "async": true,
+            "timeout": 30
+          }
+        ],
+        "description": "Type-check edited TypeScript/LWC files (strict profile only)"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-bash-build-complete standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-bash-build-complete.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Detect build/deploy completion and log notice"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-bash-pr-created standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-bash-pr-created.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Detect PR creation and log review command"
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"post:mcp-health-check\" standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/mcp-health-check.js\""
+          }
+        ],
+        "description": "Track failed MCP tool calls, mark unhealthy servers, and attempt reconnect"
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-compact minimal \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-compact.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Save session state before context compaction"
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/stop-hook.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Summarize Salesforce changes and suggest next steps"
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" check-console-log standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/check-console-log.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Check for console.log statements in modified LWC/JS files"
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" session-end standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-end.js\"",
+            "async": true,
+            "timeout": 15
+          }
+        ],
+        "description": "Persist session summary for cross-session continuity"
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" cost-tracker minimal \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/cost-tracker.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Track token usage and estimated costs per session"
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" evaluate-session standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/evaluate-session.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Evaluate session for extractable patterns and learned skills"
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" session-end-marker minimal \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-end-marker.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Session end lifecycle marker (non-blocking)"
+      }
+    ]
+  }
+}

package/hooks/memory-persistence/README.md

@@ -0,0 +1,73 @@
+# Memory Persistence Hooks
+
+This directory documents the memory persistence hook lifecycle used by SCC to maintain cross-session continuity for Salesforce development work.
+
+## Overview
+
+SCC persists session state through three coordinated hooks:
+
+```
+SessionStart
+    └── session-start.js  ← Restores prior session context (org, branch, last task)
+
+Stop / SessionEnd
+    ├── session-end.js    ← Captures session summary (files changed, commands run, next steps)
+    └── evaluate-session.js ← Scores session for extractable patterns, triggers learning
+```
+
+## Hook Scripts
+
+### `scripts/hooks/session-start.js`
+
+Runs at `SessionStart`. Reads the persisted session state from `~/.claude/sessions/<project-hash>/last-session.json` and:
+
+- Displays detected Salesforce org (scratch org or sandbox)
+- Shows the branch currently checked out
+- Reminds about any open tasks from the prior session
+- Prints CLI version check results
+
+### `scripts/hooks/session-end.js`
+
+Runs at `Stop`. Captures:
+
+- Files modified during the session (Apex, LWC, SOQL, Flow)
+- Salesforce CLI commands executed
+- Test run outcomes (pass/fail counts)
+- Suggested next steps for the next session
+
+Writes to `~/.claude/sessions/<project-hash>/last-session.json`.
+
+### `scripts/hooks/evaluate-session.js`
+
+Runs at `Stop` after `session-end.js`. Reads the session summary and scores it for extractable patterns:
+
+- Detects repeated workflows (e.g., always runs tests after deploy)
+- Flags anti-patterns corrected during session
+- Feeds signal to learning-engine observer if enabled
+
+## Storage Layout
+
+```
+~/.claude/sessions/
+  <project-hash>/
+    last-session.json   ← Last session summary (restored on next SessionStart)
+    history.jsonl       ← Append-only session history log
+```
+
+## Configuration
+
+Memory persistence is always enabled. It cannot be disabled via `SCC_HOOK_PROFILE`.
+
+To clear session state for a project:
+
+```bash
+rm ~/.claude/sessions/<project-hash>/last-session.json
+```
+
+## Profile Gating
+
+| Hook | minimal | standard | strict |
+|------|---------|----------|--------|
+| session-start.js | enabled | enabled | enabled |
+| session-end.js | — | enabled | enabled |
+| evaluate-session.js | — | enabled | enabled |

package/manifests/install-modules.json

@@ -0,0 +1,217 @@
+{
+  "version": 2,
+  "modules": [
+    {
+      "id": "core",
+      "kind": "bundle",
+      "description": "Core baseline — architect, review agent, core skills, lifecycle hooks",
+      "pathGroups": [
+        {
+          "paths": [
+            "agents/sf-architect.md",
+            "agents/sf-review-agent.md",
+            "agents/sf-bugfix-agent.md"
+          ],
+          "targets": { "claude": ".claude/agents/", "cursor": ".agents/" }
+        },
+        {
+          "paths": [
+            "skills/sf-help/",
+            "skills/sf-quickstart/",
+            "skills/model-route/",
+            "skills/_reference/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        },
+        {
+          "paths": ["hooks/hooks.json", "scripts/hooks/"],
+          "targets": { "claude": ".claude/hooks/", "cursor": null }
+        }
+      ],
+      "dependencies": [],
+      "defaultInstall": true,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "apex",
+      "kind": "bundle",
+      "description": "Apex development — agent, skills, SOQL optimization",
+      "pathGroups": [
+        {
+          "paths": [
+            "agents/sf-apex-agent.md"
+          ],
+          "targets": { "claude": ".claude/agents/", "cursor": ".agents/" }
+        },
+        {
+          "paths": [
+            "skills/sf-trigger-frameworks/",
+            "skills/sf-apex-async-patterns/",
+            "skills/sf-apex-testing/",
+            "skills/sf-apex-best-practices/",
+            "skills/sf-apex-constraints/",
+            "skills/sf-trigger-constraints/",
+            "skills/sf-testing-constraints/",
+            "skills/sf-soql-constraints/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        }
+      ],
+      "dependencies": ["core"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "lwc",
+      "kind": "bundle",
+      "description": "Lightning Web Components — agent, skills",
+      "pathGroups": [
+        {
+          "paths": ["agents/sf-lwc-agent.md"],
+          "targets": { "claude": ".claude/agents/", "cursor": ".agents/" }
+        },
+        {
+          "paths": [
+            "skills/sf-lwc-development/",
+            "skills/sf-lwc-testing/",
+            "skills/sf-lwc-constraints/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        }
+      ],
+      "dependencies": ["core"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "platform",
+      "kind": "bundle",
+      "description": "Cross-domain platform agents, universal skills, and Salesforce platform skills",
+      "pathGroups": [
+        {
+          "paths": [
+            "agents/deep-researcher.md",
+            "agents/eval-runner.md",
+            "agents/learning-engine.md",
+            "agents/doc-updater.md",
+            "agents/sf-integration-agent.md",
+            "agents/loop-operator.md",
+            "agents/refactor-cleaner.md"
+          ],
+          "targets": { "claude": ".claude/agents/", "cursor": ".agents/" }
+        },
+        {
+          "paths": [
+            "skills/sf-apex-cursor/",
+            "skills/sf-apex-enterprise-patterns/",
+            "skills/sf-metadata-management/",
+            "skills/sf-data-modeling/",
+            "skills/sf-debugging/",
+            "skills/sf-integration/",
+            "skills/sf-e2e-testing/",
+            "skills/sf-tdd-workflow/",
+            "skills/configure-scc/",
+            "skills/continuous-agent-loop/",
+            "skills/mcp-server-patterns/",
+            "skills/prompt-optimizer/",
+            "skills/search-first/",
+            "skills/security-scan/",
+            "skills/strategic-compact/",
+            "skills/aside/",
+            "skills/sf-build-fix/",
+            "skills/checkpoint/",
+            "skills/sf-docs-lookup/",
+            "skills/sf-harness-audit/",
+            "skills/refactor-clean/",
+            "skills/resume-session/",
+            "skills/save-session/",
+            "skills/sessions/",
+            "skills/update-docs/",
+            "skills/update-platform-docs/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        }
+      ],
+      "dependencies": ["core"],
+      "defaultInstall": false,
+      "cost": "heavy",
+      "stability": "stable"
+    },
+    {
+      "id": "devops",
+      "kind": "bundle",
+      "description": "Salesforce DevOps — skills for CI/CD, deployments, scratch orgs",
+      "pathGroups": [
+        {
+          "paths": [
+            "skills/sf-devops-ci-cd/",
+            "skills/sf-deployment/",
+            "skills/sf-deployment-constraints/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        }
+      ],
+      "dependencies": ["core"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "security",
+      "kind": "bundle",
+      "description": "Security — skills for CRUD/FLS, sharing, injection prevention, governor limits",
+      "pathGroups": [
+        {
+          "paths": [
+            "skills/sf-security/",
+            "skills/sf-governor-limits/",
+            "skills/sf-soql-optimization/",
+            "skills/sf-security-constraints/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        }
+      ],
+      "dependencies": ["core"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "extended",
+      "kind": "bundle",
+      "description": "Extended domains — Flow, Visualforce, Aura, Agentforce, Admin, Events, API design",
+      "pathGroups": [
+        {
+          "paths": [
+            "agents/sf-agentforce-agent.md",
+            "agents/sf-flow-agent.md",
+            "agents/sf-visualforce-reviewer.md",
+            "agents/sf-aura-reviewer.md",
+            "agents/sf-admin-agent.md"
+          ],
+          "targets": { "claude": ".claude/agents/", "cursor": ".agents/" }
+        },
+        {
+          "paths": [
+            "skills/sf-flow-development/",
+            "skills/sf-agentforce-development/",
+            "skills/sf-api-design/",
+            "skills/sf-visualforce-development/",
+            "skills/sf-aura-development/",
+            "skills/sf-platform-events-cdc/",
+            "skills/sf-approval-processes/",
+            "skills/sf-experience-cloud/"
+          ],
+          "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
+        }
+      ],
+      "dependencies": ["core"],
+      "defaultInstall": false,
+      "cost": "heavy",
+      "stability": "stable"
+    }
+  ]
+}

package/manifests/install-profiles.json

@@ -0,0 +1,17 @@
+{
+  "version": 2,
+  "profiles": {
+    "apex": {
+      "description": "Apex development — includes core, Apex, platform, DevOps, security bundles",
+      "modules": ["core", "apex", "platform", "devops", "security"]
+    },
+    "lwc": {
+      "description": "LWC development — includes core, LWC, platform, DevOps, security bundles",
+      "modules": ["core", "lwc", "platform", "devops", "security"]
+    },
+    "full": {
+      "description": "Complete SCC suite — all 7 bundles",
+      "modules": ["core", "apex", "lwc", "platform", "devops", "security", "extended"]
+    }
+  }
+}

package/mcp-configs/mcp-servers.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "salesforce-dx": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@salesforce/mcp",
+        "--orgs", "DEFAULT_TARGET_ORG",
+        "--toolsets", "orgs,metadata,data,users,testing,code-analysis,lwc-experts,devops",
+        "--allow-non-ga-tools"
+      ],
+      "description": "Official Salesforce DX MCP Server — org management, metadata, data, testing, code analysis, LWC, DevOps"
+    },
+    "salesforce-cli": {
+      "command": "sf",
+      "description": "Salesforce CLI v2 — direct CLI access for commands not covered by MCP toolsets"
+    }
+  }
+}