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.

fix(hooks): extract doc-warning hook to external script to fix CI

Affaan Mustafa3b2448dbb400
diff --git a/hooks/hooks.json b/hooks/hooks.json
index 334231816..26c8e6d72 100644
--- a/hooks/hooks.json
+++ b/hooks/hooks.json
@@ -37,7 +37,7 @@
"hooks": [
{
"type": "command",
- "command": "node -e \"let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const i=JSON.parse(d);const p=i.tool_input?.file_path||'';if(/\\.(md|txt)$/.test(p)&&!/(README|CLAUDE|AGENTS|CONTRIBUTING|CHANGELOG|LICENSE|SKILL)\\.md$/i.test(p)&&!/\\.claude[\\/\\\\]plans[\\/\\\\]/.test(p)&&!/(^|[\\/\\\\])(docs|skills)[\\/\\\\]/.test(p)){console.error('[Hook] WARNING: Non-standard documentation file detected');console.error('[Hook] File: '+p);console.error('[Hook] Consider consolidating into README.md or docs/ directory')}}catch{}console.log(d)})\""
+ "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-write-doc-warn.js\""
}
],
"description": "Doc file warning: warn about non-standard documentation files (exit code 0; warns only)"
diff --git a/scripts/hooks/pre-write-doc-warn.js b/scripts/hooks/pre-write-doc-warn.js
new file mode 100644
index 000000000..886258dd7
--- /dev/null
+++ b/scripts/hooks/pre-write-doc-warn.js
@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * PreToolUse Hook: Warn about non-standard documentation files
+ *
+ * Cross-platform (Windows, macOS, Linux)
+ *
+ * Runs before Write tool use. If the file is a .md or .txt file that isn't
+ * a standard documentation file (README, CLAUDE, AGENTS, etc.) or in an
+ * expected directory (docs/, skills/, .claude/plans/), warns the user.
+ *
+ * Exit code 0 — warn only, does not block.
+ */
+
+const path = require('path');
+
+const MAX_STDIN = 1024 * 1024; // 1MB limit
+let data = '';
+process.stdin.setEncoding('utf8');
+
+process.stdin.on('data', chunk => {
+ if (data.length < MAX_STDIN) {
+ const remaining = MAX_STDIN - data.length;
+ data += chunk.length > remaining ? chunk.slice(0, remaining) : chunk;
+ }
+});
+
+process.stdin.on('end', () => {
+ try {
+ const input = JSON.parse(data);
+ const filePath = input.tool_input?.file_path || '';
+
+ // Only check .md and .txt files
+ if (!/\.(md|txt)$/.test(filePath)) {
+ process.stdout.write(data);
+ return;
+ }
+
+ // Allow standard documentation files
+ const basename = path.basename(filePath);
+ if (/^(README|CLAUDE|AGENTS|CONTRIBUTING|CHANGELOG|LICENSE|SKILL)\.md$/i.test(basename)) {
+ process.stdout.write(data);
+ return;
+ }
+
+ // Allow files in .claude/plans/, docs/, and skills/ directories
+ const normalized = filePath.replace(/\\/g, '/');
+ if (/\.claude\/plans\//.test(normalized) || /(^|\/)(docs|skills)\//.test(normalized)) {
+ process.stdout.write(data);
+ return;
+ }
+
+ // Warn about non-standard documentation files
+ console.error('[Hook] WARNING: Non-standard documentation file detected');
+ console.error('[Hook] File: ' + filePath);
+ console.error('[Hook] Consider consolidating into README.md or docs/ directory');
+ } catch {
+ // Parse error — pass through
+ }
+
+ process.stdout.write(data);
+});