cmp-standards 3.5.1 → 3.7.0

package/templates/hooks/README.md

@@ -1,158 +1,158 @@
-# Claude Code Hooks Configuration
-
-This directory contains hook templates for Claude Code integration.
-
-## Available Hooks
-
-| Hook | When | Purpose |
-|:---|:---|:---|
-| `SessionStart` | Session begins | Load context, memories, work plan |
-| `PreToolUse` | Before tool runs | Guards, validation, knowledge injection |
-| `PostToolUse` | After tool runs | Change tracking, checkpoints |
-| `NotificationReceived` | On notifications | Custom notification handling |
-| `PromptSubmit` | Before prompt | Pre-processing user input |
-| `SubagentStop` | Agent completes | Post-agent processing |
-
-## Configuration
-
-Add to your `.claude/settings.local.json`:
-
-```json
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory session-context"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory pre-tool-guard $EVENT"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory post-tool-record $EVENT"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
-## Environment Variables
-
-Required for full functionality:
-
-```bash
-# Database connection (for memory persistence)
-DATABASE_URL="mysql://user:pass@host:port/database"
-
-# Embedding (for semantic search - optional)
-OPENAI_API_KEY="sk-..."
-# or
-GEMINI_API_KEY="..."
-```
-
-## Guard Rules
-
-Define guards in `project.config.json`:
-
-```json
-{
-  "guards": {
-    "enabled": true,
-    "rules": [
-      {
-        "id": "no-modify-auth",
-        "type": "block",
-        "filePattern": "**/auth/**",
-        "message": "Auth files require explicit approval",
-        "excludeFiles": ["**/*.test.ts"]
-      },
-      {
-        "id": "no-raw-sql",
-        "type": "warn",
-        "filePattern": "**/*.ts",
-        "contentTrigger": "\\$\\{[^}]+\\}.*(?:SELECT|INSERT|UPDATE|DELETE)",
-        "message": "Potential SQL injection - use parameterized queries"
-      }
-    ]
-  }
-}
-```
-
-## Custom Hooks
-
-Create custom hook scripts in `.claude/hooks/`:
-
-```bash
-#!/bin/bash
-# .claude/hooks/my-custom-hook.sh
-
-# Access event data
-EVENT_DATA="$1"
-
-# Parse with jq if needed
-TOOL_NAME=$(echo "$EVENT_DATA" | jq -r '.tool_name')
-
-# Your logic here
-echo "Tool called: $TOOL_NAME"
-```
-
-Register in settings:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": ".claude/hooks/my-custom-hook.sh $EVENT"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
-## Troubleshooting
-
-### Hook not running
-- Check that hook command is executable
-- Verify matcher pattern matches the tool name
-- Check `.claude/settings.local.json` syntax
-
-### Guards not blocking
-- Ensure `guards.enabled: true` in `project.config.json`
-- Verify file patterns match (use glob syntax)
-- Check that rule `type` is "block" not "warn"
-
-### Memory not persisting
-- Verify `DATABASE_URL` is set
-- Check database connection with `npx cmp-memory status`
-
----
-
-For more information, see the [cmp-memory-system documentation](https://github.com/carlosmartinpavon/carlosmartinpavon).
+# Claude Code Hooks Configuration
+
+This directory contains hook templates for Claude Code integration.
+
+## Available Hooks
+
+| Hook | When | Purpose |
+|:---|:---|:---|
+| `SessionStart` | Session begins | Load context, memories, work plan |
+| `PreToolUse` | Before tool runs | Guards, validation, knowledge injection |
+| `PostToolUse` | After tool runs | Change tracking, checkpoints |
+| `NotificationReceived` | On notifications | Custom notification handling |
+| `PromptSubmit` | Before prompt | Pre-processing user input |
+| `SubagentStop` | Agent completes | Post-agent processing |
+
+## Configuration
+
+Add to your `.claude/settings.local.json`:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory session-context"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory pre-tool-guard $EVENT"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory post-tool-record $EVENT"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Environment Variables
+
+Required for full functionality:
+
+```bash
+# Database connection (for memory persistence)
+DATABASE_URL="mysql://user:pass@host:port/database"
+
+# Embedding (for semantic search - optional)
+OPENAI_API_KEY="sk-..."
+# or
+GEMINI_API_KEY="..."
+```
+
+## Guard Rules
+
+Define guards in `project.config.json`:
+
+```json
+{
+  "guards": {
+    "enabled": true,
+    "rules": [
+      {
+        "id": "no-modify-auth",
+        "type": "block",
+        "filePattern": "**/auth/**",
+        "message": "Auth files require explicit approval",
+        "excludeFiles": ["**/*.test.ts"]
+      },
+      {
+        "id": "no-raw-sql",
+        "type": "warn",
+        "filePattern": "**/*.ts",
+        "contentTrigger": "\\$\\{[^}]+\\}.*(?:SELECT|INSERT|UPDATE|DELETE)",
+        "message": "Potential SQL injection - use parameterized queries"
+      }
+    ]
+  }
+}
+```
+
+## Custom Hooks
+
+Create custom hook scripts in `.claude/hooks/`:
+
+```bash
+#!/bin/bash
+# .claude/hooks/my-custom-hook.sh
+
+# Access event data
+EVENT_DATA="$1"
+
+# Parse with jq if needed
+TOOL_NAME=$(echo "$EVENT_DATA" | jq -r '.tool_name')
+
+# Your logic here
+echo "Tool called: $TOOL_NAME"
+```
+
+Register in settings:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/my-custom-hook.sh $EVENT"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Troubleshooting
+
+### Hook not running
+- Check that hook command is executable
+- Verify matcher pattern matches the tool name
+- Check `.claude/settings.local.json` syntax
+
+### Guards not blocking
+- Ensure `guards.enabled: true` in `project.config.json`
+- Verify file patterns match (use glob syntax)
+- Check that rule `type` is "block" not "warn"
+
+### Memory not persisting
+- Verify `DATABASE_URL` is set
+- Check database connection with `npx cmp-memory status`
+
+---
+
+For more information, see the [cmp-memory-system documentation](https://github.com/carlosmartinpavon/carlosmartinpavon).

package/templates/hooks/project.config.json.template

@@ -1,77 +1,77 @@
-{
-  "$schema": "https://raw.githubusercontent.com/carlosmartinpavon/carlosmartinpavon/main/packages/cmp-memory-system/schemas/config.json",
-  "projectName": "{{PROJECT_NAME}}",
-  "system": "{{SYSTEM_ID}}",
-  "domains": [
-    "api",
-    "components",
-    "hooks",
-    "schema",
-    "utils"
-  ],
-  "sessionContext": {
-    "loadMemoriesOnStart": true,
-    "maxMemoriesLoaded": 10,
-    "showAvailableCommands": true,
-    "showWorkPlan": true
-  },
-  "guards": {
-    "enabled": true,
-    "rules": [
-      {
-        "id": "no-modify-auth",
-        "type": "warn",
-        "filePattern": "**/auth/**",
-        "message": "Auth files are sensitive - ensure changes are reviewed",
-        "excludeFiles": ["**/*.test.ts", "**/*.spec.ts"]
-      },
-      {
-        "id": "schema-protection",
-        "type": "warn",
-        "filePattern": "**/schema/**",
-        "message": "Schema changes affect database - run migrations carefully"
-      },
-      {
-        "id": "no-raw-sql",
-        "type": "warn",
-        "filePattern": "**/*.ts",
-        "contentTrigger": "\\$\\{[^}]+\\}.*(?:SELECT|INSERT|UPDATE|DELETE)",
-        "message": "Potential SQL injection - use parameterized queries or Drizzle ORM"
-      },
-      {
-        "id": "no-hardcoded-secrets",
-        "type": "block",
-        "filePattern": "**/*.{ts,tsx,js,jsx}",
-        "contentTrigger": "(sk-[a-zA-Z0-9]{32,}|ghp_[a-zA-Z0-9]{36}|npm_[a-zA-Z0-9]{36})",
-        "message": "BLOCKED: Hardcoded API key detected - use environment variables"
-      }
-    ]
-  },
-  "checkpoint": {
-    "enabled": true,
-    "criticalPaths": [
-      "**/schema/**",
-      "**/finance/**",
-      "**/auth/**",
-      "**/migrations/**"
-    ],
-    "excludePaths": [
-      "**/*.test.ts",
-      "**/*.spec.ts",
-      "**/node_modules/**",
-      "**/dist/**"
-    ],
-    "minLinesChanged": 20
-  },
-  "embedding": {
-    "enabled": false,
-    "threshold": 0.7,
-    "maxSections": 5,
-    "prioritizeCritical": true
-  },
-  "autoImprovement": {
-    "enabled": true,
-    "violationThreshold": 3,
-    "generateEslintRules": true
-  }
-}
+{
+  "$schema": "https://raw.githubusercontent.com/carlosmartinpavon/carlosmartinpavon/main/packages/cmp-memory-system/schemas/config.json",
+  "projectName": "{{PROJECT_NAME}}",
+  "system": "{{SYSTEM_ID}}",
+  "domains": [
+    "api",
+    "components",
+    "hooks",
+    "schema",
+    "utils"
+  ],
+  "sessionContext": {
+    "loadMemoriesOnStart": true,
+    "maxMemoriesLoaded": 10,
+    "showAvailableCommands": true,
+    "showWorkPlan": true
+  },
+  "guards": {
+    "enabled": true,
+    "rules": [
+      {
+        "id": "no-modify-auth",
+        "type": "warn",
+        "filePattern": "**/auth/**",
+        "message": "Auth files are sensitive - ensure changes are reviewed",
+        "excludeFiles": ["**/*.test.ts", "**/*.spec.ts"]
+      },
+      {
+        "id": "schema-protection",
+        "type": "warn",
+        "filePattern": "**/schema/**",
+        "message": "Schema changes affect database - run migrations carefully"
+      },
+      {
+        "id": "no-raw-sql",
+        "type": "warn",
+        "filePattern": "**/*.ts",
+        "contentTrigger": "\\$\\{[^}]+\\}.*(?:SELECT|INSERT|UPDATE|DELETE)",
+        "message": "Potential SQL injection - use parameterized queries or Drizzle ORM"
+      },
+      {
+        "id": "no-hardcoded-secrets",
+        "type": "block",
+        "filePattern": "**/*.{ts,tsx,js,jsx}",
+        "contentTrigger": "(sk-[a-zA-Z0-9]{32,}|ghp_[a-zA-Z0-9]{36}|npm_[a-zA-Z0-9]{36})",
+        "message": "BLOCKED: Hardcoded API key detected - use environment variables"
+      }
+    ]
+  },
+  "checkpoint": {
+    "enabled": true,
+    "criticalPaths": [
+      "**/schema/**",
+      "**/finance/**",
+      "**/auth/**",
+      "**/migrations/**"
+    ],
+    "excludePaths": [
+      "**/*.test.ts",
+      "**/*.spec.ts",
+      "**/node_modules/**",
+      "**/dist/**"
+    ],
+    "minLinesChanged": 20
+  },
+  "embedding": {
+    "enabled": false,
+    "threshold": 0.7,
+    "maxSections": 5,
+    "prioritizeCritical": true
+  },
+  "autoImprovement": {
+    "enabled": true,
+    "violationThreshold": 3,
+    "generateEslintRules": true
+  }
+}

package/templates/hooks/settings.local.json.template

@@ -1,57 +1,57 @@
-{
-  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.json",
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory session-context"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory pre-tool-guard"
-          }
-        ]
-      },
-      {
-        "matcher": "Task",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory inject-knowledge"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx cmp-memory checkpoint"
-          }
-        ]
-      }
-    ]
-  },
-  "allowedTools": [
-    "Read",
-    "Glob",
-    "Grep",
-    "WebSearch",
-    "WebFetch"
-  ],
-  "denyTools": [],
-  "contextWindow": 200000,
-  "model": "opus"
-}
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.json",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory session-context"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory pre-tool-guard"
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory inject-knowledge"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory checkpoint"
+          }
+        ]
+      }
+    ]
+  },
+  "allowedTools": [
+    "Read",
+    "Glob",
+    "Grep",
+    "WebSearch",
+    "WebFetch"
+  ],
+  "denyTools": [],
+  "contextWindow": 200000,
+  "model": "opus"
+}

package/templates/hooks.config.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "./hooks.config.schema.json",
+  "enabled": true,
+  "timeout": 2000,
+  "silentFail": true,
+  "features": {
+    "sessionTracking": false,
+    "taskTracking": false,
+    "fileTracking": true,
+    "knowledgeInjection": true
+  },
+  "_comment": {
+    "enabled": "Master switch to enable/disable all hooks",
+    "timeout": "Maximum time (ms) for hook execution before fallback",
+    "silentFail": "If true, hooks never block tool execution on errors",
+    "sessionTracking": "Track sessions in Redis (requires network)",
+    "taskTracking": "Track active tasks in Turso (requires network)",
+    "fileTracking": "Track file modifications locally",
+    "knowledgeInjection": "Inject relevant knowledge on Task tool calls"
+  }
+}