feat(hooks): auto-ingest docs on WebFetch + /ingest-docs command

doc-ingest.js hook fires on PostToolUse(WebFetch) — if URL matches
docs patterns (docs.*, /api/, /reference/), auto-ingests into wiki.
Rate-limited to 1 ingest per hostname per session, max 5 pages.

/ingest-docs slash command for manual use.

Author: StackMemory Bot (CLI)

src/utils/__tests__/hook-installer.test.ts

@@ -18,8 +18,8 @@ const HOOKS_DIR = path.join(os.homedir(), '.claude', 'hooks');
 
 describe('hook-installer', () => {
   describe('CANONICAL_HOOKS', () => {
-    it('defines all 12 hooks', () => {
-      expect(CANONICAL_HOOKS).toHaveLength(12);
+    it('defines all 13 hooks', () => {
+      expect(CANONICAL_HOOKS).toHaveLength(13);
       const names = CANONICAL_HOOKS.map((h) => h.scriptName);
       expect(names).toContain('session-rescue.sh');
       expect(names).toContain('stop-checkpoint.js');
@@ -33,13 +33,14 @@ describe('hook-installer', () => {
       expect(names).toContain('desire-path-trace.js');
       expect(names).toContain('daemon-auto-start.js');
       expect(names).toContain('wiki-update.js');
+      expect(names).toContain('doc-ingest.js');
     });
 
     it('core hooks are required, optional hooks are not', () => {
       const required = CANONICAL_HOOKS.filter((h) => h.required);
       const optional = CANONICAL_HOOKS.filter((h) => !h.required);
       expect(required).toHaveLength(5);
-      expect(optional).toHaveLength(7);
+      expect(optional).toHaveLength(8);
       const optionalNames = optional.map((h) => h.scriptName);
       expect(optionalNames).toContain('theory-capture.js');
       expect(optionalNames).toContain('team-subagent-stop.js');
@@ -48,6 +49,7 @@ describe('hook-installer', () => {
       expect(optionalNames).toContain('desire-path-trace.js');
       expect(optionalNames).toContain('daemon-auto-start.js');
       expect(optionalNames).toContain('wiki-update.js');
+      expect(optionalNames).toContain('doc-ingest.js');
     });
 
     it('js hooks have node commandPrefix', () => {

src/utils/hook-installer.ts

@@ -112,6 +112,14 @@ export const CANONICAL_HOOKS: HookEntry[] = [
     commandPrefix: 'node',
     required: false,
   },
+  {
+    scriptName: 'doc-ingest.js',
+    eventType: 'PostToolUse',
+    matcher: 'WebFetch',
+    timeout: 15,
+    commandPrefix: 'node',
+    required: false,
+  },
 ];
 
 /** Script names that should be removed from settings (dead/deprecated hooks) */

templates/claude-hooks/doc-ingest.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+/**
+ * Doc Ingest Hook
+ *
+ * Fires on PostToolUse when WebFetch is used. If the fetched URL looks like
+ * documentation (docs.*, /api/, /reference/, /guide/), auto-ingests it into
+ * the project wiki via stackmemory wiki ingest.
+ *
+ * Lightweight: only runs if .stackmemory/config.yaml has obsidian.vaultPath.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Doc URL patterns
+const DOC_PATTERNS = [
+  /^https?:\/\/docs\./i,
+  /^https?:\/\/[^/]+\/docs\//i,
+  /^https?:\/\/[^/]+\/api\//i,
+  /^https?:\/\/[^/]+\/reference\//i,
+  /^https?:\/\/[^/]+\/guide/i,
+  /^https?:\/\/[^/]+\/tutorial/i,
+  /^https?:\/\/developer\./i,
+];
+
+// Rate limit: max 1 ingest per URL per session
+const seen = new Set();
+
+function main() {
+  try {
+    // Only fire on WebFetch tool
+    const toolName = process.env.TOOL_NAME || '';
+    if (toolName !== 'WebFetch') return;
+
+    // Check wiki is configured
+    const configPath = path.join(process.cwd(), '.stackmemory', 'config.yaml');
+    if (!fs.existsSync(configPath)) return;
+    const config = fs.readFileSync(configPath, 'utf-8');
+    if (!config.includes('vaultPath:')) return;
+
+    // Extract URL from tool input
+    const input = process.env.TOOL_INPUT || '';
+    let url;
+    try {
+      const parsed = JSON.parse(input);
+      url = parsed.url;
+    } catch {
+      // Try regex fallback
+      const match = input.match(/https?:\/\/[^\s"']+/);
+      url = match ? match[0] : null;
+    }
+
+    if (!url) return;
+
+    // Check if URL matches doc patterns
+    const isDoc = DOC_PATTERNS.some((p) => p.test(url));
+    if (!isDoc) return;
+
+    // Dedupe per session
+    const host = new URL(url).hostname;
+    if (seen.has(host)) return;
+    seen.add(host);
+
+    // Run ingest (fire-and-forget, max 1 page for auto-ingest)
+    execSync(`stackmemory wiki ingest "${url}" -n 5`, {
+      timeout: 15000,
+      stdio: 'ignore',
+    });
+  } catch {
+    // Silent fail
+  }
+}
+
+main();