The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat(install): hermes-hooks install module — installer-native delivery
ravitejarenangidf77893e0a39
diff --git a/docs/HERMES-HOOKS.md b/docs/HERMES-HOOKS.mdindex 0c7570650..6d9926b19 100644--- a/docs/HERMES-HOOKS.md+++ b/docs/HERMES-HOOKS.md@@ -30,18 +30,23 @@ These two are harness-independent policy:## Install+Preferred — through the ECC installer (module `hermes-hooks`):+```bash-# 1. Put the scripts anywhere stable (they are referenced by absolute path):-mkdir -p ~/.hermes/hooks-cp hooks/hermes/config-protection.py ~/.hermes/hooks/ecc-config-protection.py-cp hooks/hermes/check-console-log.py ~/.hermes/hooks/ecc-check-console-log.py-chmod +x ~/.hermes/hooks/ecc-*.py+./install.sh --target hermes --modules hermes-hooks --enable-hooks+# or: node scripts/install-apply.js --target hermes --modules hermes-hooks --enable-hooks+```-# 2. Point the commands at the copies you just made. Substitute YOUR absolute-# home path — Hermes resolves hook commands verbatim, without ~ expansion.-HOOK_DIR="$HOME/.hermes/hooks"+This lands `hooks/hermes/*.py` under `~/.hermes/hooks/hermes/` and this guide+under `~/.hermes/docs/`. Then register the hooks (the installer deliberately+never edits your `config.yaml`):++```bash+# Scripts are already at ~/.hermes/hooks/hermes/. Point the commands at them —+# Hermes resolves hook commands verbatim, without ~ expansion.+HOOK_DIR="$HOME/.hermes/hooks/hermes"-# 3. Append to ~/.hermes/config.yaml (Hermes wants the mapping keyed by event):+# Append to ~/.hermes/config.yaml (Hermes wants the mapping keyed by event):cat >> ~/.hermes/config.yaml <<EOFhooks:pre_tool_call:diff --git a/manifests/install-modules.json b/manifests/install-modules.jsonindex 0e45965a5..9c477f780 100644--- a/manifests/install-modules.json+++ b/manifests/install-modules.json@@ -106,6 +106,23 @@"cost": "medium","stability": "stable"},+ {+ "id": "hermes-hooks",+ "kind": "hooks",+ "description": "Hermes-native guard hooks (config protection, console.log warning) plus install guide.",+ "paths": [+ "hooks/hermes",+ "docs/HERMES-HOOKS.md"+ ],+ "targets": [+ "hermes",+ "openclaw"+ ],+ "dependencies": [],+ "defaultInstall": true,+ "cost": "light",+ "stability": "stable"+ },{"id": "platform-configs","kind": "platform",diff --git a/manifests/install-profiles.json b/manifests/install-profiles.jsonindex 25091775e..66974cf0d 100644--- a/manifests/install-profiles.json+++ b/manifests/install-profiles.json@@ -98,7 +98,8 @@"devops-infra","machine-learning","supply-chain-domain",- "document-processing"+ "document-processing",+ "hermes-hooks"]}}diff --git a/tests/hermes-hooks.test.js b/tests/hermes-hooks.test.jsindex 64d8cb3d1..ce8d90b6b 100644--- a/tests/hermes-hooks.test.js+++ b/tests/hermes-hooks.test.js@@ -237,5 +237,28 @@ run('unreadable file: skips AND reports on stderr', () => {assert.ok(/not a regular file|skipping/.test(stderr), 'diagnostic required');});++// --- installer integration: the hermes-hooks module installs and the landed copy runs ---+run('hermes-hooks module installs via the real installer and the landed guard blocks', () => {+ const home = fs.mkdtempSync(path.join(os.tmpdir(), 'ecc-mod-'));+ const inst = spawnSync('node', ['scripts/install-apply.js', '--target', 'hermes', '--modules', 'hermes-hooks', '--enable-hooks'], {+ cwd: repoRoot, encoding: 'utf8', env: { ...process.env, HOME: home }, timeout: 60000,+ });+ assert.strictEqual(inst.status, 0, 'installer must exit 0');+ const landed = path.join(home, '.hermes', 'hooks', 'hermes', 'config-protection.py');+ assert.ok(fs.existsSync(landed), 'guard must land under ~/.hermes/hooks/hermes/');+ assert.ok(fs.existsSync(path.join(home, '.hermes', 'docs', 'HERMES-HOOKS.md')), 'doc must land');+ const t = fs.mkdtempSync(path.join(os.tmpdir(), 'ecc-guard-'));+ const target = path.join(t, 'eslint.config.mjs');+ fs.writeFileSync(target, 'export default {}\n');+ const g = spawnSync('python3', [landed], {+ input: JSON.stringify({ hook_event_name: 'pre_tool_call', tool_name: 'patch', tool_input: { path: target, old_string: 'a', new_string: 'b' } }),+ encoding: 'utf8', timeout: 15000,+ });+ assert.ok((g.stdout || '').includes('"decision": "block"'), 'landed guard must block');+ fs.rmSync(home, { recursive: true, force: true });+ fs.rmSync(t, { recursive: true, force: true });+});+console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);if (failed > 0) process.exit(1);