feat: add C++ language support and hook tests (#539)

- agents: cpp-build-resolver, cpp-reviewer
- commands: cpp-build, cpp-review, cpp-test
- rules: cpp/ (coding-style, hooks, patterns, security, testing)
- tests: 9 new hook test files with comprehensive coverage

Cherry-picked from PR #436.

tests/hooks/doc-file-warning.test.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+'use strict';
+
+const assert = require('assert');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const script = path.join(__dirname, '..', '..', 'scripts', 'hooks', 'doc-file-warning.js');
+
+function test(name, fn) {
+  try {
+    fn();
+    console.log(`  ✓ ${name}`);
+    return true;
+  } catch (err) {
+    console.log(`  ✗ ${name}`);
+    console.log(`    Error: ${err.message}`);
+    return false;
+  }
+}
+
+function runScript(input) {
+  const result = spawnSync('node', [script], {
+    encoding: 'utf8',
+    input: JSON.stringify(input),
+    timeout: 10000,
+  });
+  return { code: result.status || 0, stdout: result.stdout || '', stderr: result.stderr || '' };
+}
+
+function runTests() {
+  console.log('\n=== Testing doc-file-warning.js ===\n');
+  let passed = 0;
+  let failed = 0;
+
+  // 1. Allowed standard doc files - no warning in stderr
+  const standardFiles = [
+    'README.md',
+    'CLAUDE.md',
+    'AGENTS.md',
+    'CONTRIBUTING.md',
+    'CHANGELOG.md',
+    'LICENSE.md',
+    'SKILL.md',
+    'MEMORY.md',
+    'WORKLOG.md',
+  ];
+  for (const file of standardFiles) {
+    (test(`allows standard doc file: ${file}`, () => {
+      const { code, stderr } = runScript({ tool_input: { file_path: file } });
+      assert.strictEqual(code, 0, `expected exit code 0, got ${code}`);
+      assert.strictEqual(stderr, '', `expected no warning for ${file}, got: ${stderr}`);
+    }) ? passed++ : failed++);
+  }
+
+  // 2. Allowed directory paths - no warning
+  const allowedDirPaths = [
+    'docs/foo.md',
+    'docs/guide/setup.md',
+    'skills/bar.md',
+    'skills/testing/tdd.md',
+    '.history/session.md',
+    'memory/patterns.md',
+    '.claude/commands/deploy.md',
+    '.claude/plans/roadmap.md',
+    '.claude/projects/myproject.md',
+  ];
+  for (const file of allowedDirPaths) {
+    (test(`allows directory path: ${file}`, () => {
+      const { code, stderr } = runScript({ tool_input: { file_path: file } });
+      assert.strictEqual(code, 0, `expected exit code 0, got ${code}`);
+      assert.strictEqual(stderr, '', `expected no warning for ${file}, got: ${stderr}`);
+    }) ? passed++ : failed++);
+  }
+
+  // 3. Allowed .plan.md files - no warning
+  (test('allows .plan.md files', () => {
+    const { code, stderr } = runScript({ tool_input: { file_path: 'feature.plan.md' } });
+    assert.strictEqual(code, 0);
+    assert.strictEqual(stderr, '', `expected no warning for .plan.md, got: ${stderr}`);
+  }) ? passed++ : failed++);
+
+  (test('allows nested .plan.md files', () => {
+    const { code, stderr } = runScript({ tool_input: { file_path: 'src/refactor.plan.md' } });
+    assert.strictEqual(code, 0);
+    assert.strictEqual(stderr, '', `expected no warning for nested .plan.md, got: ${stderr}`);
+  }) ? passed++ : failed++);
+
+  // 4. Non-md/txt files always pass - no warning
+  const nonDocFiles = ['foo.js', 'app.py', 'styles.css', 'data.json', 'image.png'];
+  for (const file of nonDocFiles) {
+    (test(`allows non-doc file: ${file}`, () => {
+      const { code, stderr } = runScript({ tool_input: { file_path: file } });
+      assert.strictEqual(code, 0);
+      assert.strictEqual(stderr, '', `expected no warning for ${file}, got: ${stderr}`);
+    }) ? passed++ : failed++);
+  }
+
+  // 5. Non-standard doc files - warning in stderr
+  const nonStandardFiles = ['random-notes.md', 'TODO.md', 'notes.txt', 'scratch.md', 'ideas.txt'];
+  for (const file of nonStandardFiles) {
+    (test(`warns on non-standard doc file: ${file}`, () => {
+      const { code, stderr } = runScript({ tool_input: { file_path: file } });
+      assert.strictEqual(code, 0, 'should still exit 0 (warn only)');
+      assert.ok(stderr.includes('WARNING'), `expected warning in stderr for ${file}, got: ${stderr}`);
+      assert.ok(stderr.includes(file), `expected file path in stderr for ${file}`);
+    }) ? passed++ : failed++);
+  }
+
+  // 6. Invalid/empty input - passes through without error
+  (test('handles empty object input without error', () => {
+    const { code, stderr } = runScript({});
+    assert.strictEqual(code, 0);
+    assert.strictEqual(stderr, '', `expected no warning for empty input, got: ${stderr}`);
+  }) ? passed++ : failed++);
+
+  (test('handles missing file_path without error', () => {
+    const { code, stderr } = runScript({ tool_input: {} });
+    assert.strictEqual(code, 0);
+    assert.strictEqual(stderr, '', `expected no warning for missing file_path, got: ${stderr}`);
+  }) ? passed++ : failed++);
+
+  (test('handles empty file_path without error', () => {
+    const { code, stderr } = runScript({ tool_input: { file_path: '' } });
+    assert.strictEqual(code, 0);
+    assert.strictEqual(stderr, '', `expected no warning for empty file_path, got: ${stderr}`);
+  }) ? passed++ : failed++);
+
+  // 7. Stdout always contains the original input (pass-through)
+  (test('passes through input to stdout for allowed file', () => {
+    const input = { tool_input: { file_path: 'README.md' } };
+    const { stdout } = runScript(input);
+    assert.strictEqual(stdout, JSON.stringify(input));
+  }) ? passed++ : failed++);
+
+  (test('passes through input to stdout for warned file', () => {
+    const input = { tool_input: { file_path: 'random-notes.md' } };
+    const { stdout } = runScript(input);
+    assert.strictEqual(stdout, JSON.stringify(input));
+  }) ? passed++ : failed++);
+
+  (test('passes through input to stdout for empty input', () => {
+    const input = {};
+    const { stdout } = runScript(input);
+    assert.strictEqual(stdout, JSON.stringify(input));
+  }) ? passed++ : failed++);
+
+  console.log(`\nResults: Passed: ${passed}, Failed: ${failed}`);
+  process.exit(failed > 0 ? 1 : 0);
+}
+
+runTests();