Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

feat(hooks): add config protection hook to block linter config manipulation (#758)

Charlie Tonneslanfdb10ba11624
diff --git a/hooks/hooks.json b/hooks/hooks.json
index 2efd0bdb7..b44e6bf02 100644
--- a/hooks/hooks.json
+++ b/hooks/hooks.json
@@ -96,6 +96,17 @@
],
"description": "Capture governance events (secrets, policy violations, approval requests). Enable with ECC_GOVERNANCE_CAPTURE=1"
},
+ {
+ "matcher": "Write|Edit|MultiEdit",
+ "hooks": [
+ {
+ "type": "command",
+ "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"pre:config-protection\" \"scripts/hooks/config-protection.js\" \"standard,strict\"",
+ "timeout": 5
+ }
+ ],
+ "description": "Block modifications to linter/formatter config files. Steers agent to fix code instead of weakening configs."
+ },
{
"matcher": "*",
"hooks": [
diff --git a/scripts/hooks/config-protection.js b/scripts/hooks/config-protection.js
new file mode 100644
index 000000000..f5fbcf4af
--- /dev/null
+++ b/scripts/hooks/config-protection.js
@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Config Protection Hook
+ *
+ * Blocks modifications to linter/formatter config files.
+ * Agents frequently modify these to make checks pass instead of fixing
+ * the actual code. This hook steers the agent back to fixing the source.
+ *
+ * Exit codes:
+ * 0 = allow (not a config file)
+ * 2 = block (config file modification attempted)
+ */
+
+'use strict';
+
+const path = require('path');
+
+const MAX_STDIN = 1024 * 1024;
+let raw = '';
+
+const PROTECTED_FILES = new Set([
+ // ESLint (legacy + v9 flat config, JS/TS/MJS/CJS)
+ '.eslintrc',
+ '.eslintrc.js',
+ '.eslintrc.cjs',
+ '.eslintrc.json',
+ '.eslintrc.yml',
+ '.eslintrc.yaml',
+ 'eslint.config.js',
+ 'eslint.config.mjs',
+ 'eslint.config.cjs',
+ 'eslint.config.ts',
+ 'eslint.config.mts',
+ 'eslint.config.cts',
+ // Prettier (all config variants including ESM)
+ '.prettierrc',
+ '.prettierrc.js',
+ '.prettierrc.cjs',
+ '.prettierrc.json',
+ '.prettierrc.yml',
+ '.prettierrc.yaml',
+ 'prettier.config.js',
+ 'prettier.config.cjs',
+ 'prettier.config.mjs',
+ // Biome
+ 'biome.json',
+ 'biome.jsonc',
+ // Ruff (Python)
+ '.ruff.toml',
+ 'ruff.toml',
+ // Note: pyproject.toml is intentionally NOT included here because it
+ // contains project metadata alongside linter config. Blocking all edits
+ // to pyproject.toml would prevent legitimate dependency changes.
+ // Shell / Style / Markdown
+ '.shellcheckrc',
+ '.stylelintrc',
+ '.stylelintrc.json',
+ '.stylelintrc.yml',
+ '.markdownlint.json',
+ '.markdownlint.yaml',
+ '.markdownlintrc',
+]);
+
+/**
+ * Exportable run() for in-process execution via run-with-flags.js.
+ * Avoids the ~50-100ms spawnSync overhead when available.
+ */
+function run(input) {
+ const filePath = input?.tool_input?.file_path || input?.tool_input?.file || '';
+ if (!filePath) return { exitCode: 0 };
+
+ const basename = path.basename(filePath);
+ if (PROTECTED_FILES.has(basename)) {
+ return {
+ exitCode: 2,
+ stderr:
+ `BLOCKED: Modifying ${basename} is not allowed. ` +
+ `Fix the source code to satisfy linter/formatter rules instead of ` +
+ `weakening the config. If this is a legitimate config change, ` +
+ `disable the config-protection hook temporarily.`,
+ };
+ }
+
+ return { exitCode: 0 };
+}
+
+module.exports = { run };
+
+// Stdin fallback for spawnSync execution
+let truncated = false;
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => {
+ if (raw.length < MAX_STDIN) {
+ const remaining = MAX_STDIN - raw.length;
+ raw += chunk.substring(0, remaining);
+ if (chunk.length > remaining) truncated = true;
+ } else {
+ truncated = true;
+ }
+});
+
+process.stdin.on('end', () => {
+ // If stdin was truncated, the JSON is likely malformed. Fail open but
+ // log a warning so the issue is visible. The run() path (used by
+ // run-with-flags.js in-process) is not affected by this.
+ if (truncated) {
+ process.stderr.write('[config-protection] Warning: stdin exceeded 1MB, skipping check\n');
+ process.stdout.write(raw);
+ return;
+ }
+
+ try {
+ const input = raw.trim() ? JSON.parse(raw) : {};
+ const result = run(input);
+
+ if (result.exitCode === 2) {
+ process.stderr.write(result.stderr + '\n');
+ process.exit(2);
+ }
+ } catch {
+ // Keep hook non-blocking on parse errors.
+ }
+
+ process.stdout.write(raw);
+});