claude-autopm 1.21.0 → 1.22.0

package/autopm/.claude/commands/pm/validate.md

@@ -8,4 +8,21 @@ Run `node .claude/scripts/pm/validate.js` using the Bash tool and show me the co
 - DO NOT collapse.
 - DO NOT abbreviate.
 - Show ALL lines in full.
+## Required Documentation Access
+
+**MANDATORY:** Before project management workflows, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/agile/epic-management` - epic management best practices
+- `mcp://context7/project-management/issue-tracking` - issue tracking best practices
+- `mcp://context7/agile/task-breakdown` - task breakdown best practices
+- `mcp://context7/project-management/workflow` - workflow best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 - DO NOT print any other comments.

package/autopm/.claude/commands/pm/what-next.md

@@ -8,4 +8,21 @@ Run `node .claude/scripts/pm/what-next.js` using the Bash tool and show me the c
 - DO NOT collapse.
 - DO NOT abbreviate.
 - Show ALL lines in full.
+## Required Documentation Access
+
+**MANDATORY:** Before project management workflows, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/agile/epic-management` - epic management best practices
+- `mcp://context7/project-management/issue-tracking` - issue tracking best practices
+- `mcp://context7/agile/task-breakdown` - task breakdown best practices
+- `mcp://context7/project-management/workflow` - workflow best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 - DO NOT print any other comments.

package/autopm/.claude/commands/python/api-scaffold.md

@@ -8,6 +8,23 @@ Creates a complete FastAPI project structure with modern Python tooling.
 
 **Usage**: `/python:api-scaffold [project-name] [--db=postgresql|mysql|sqlite] [--auth=jwt|oauth2]`
 
+## Required Documentation Access
+
+**MANDATORY:** Before scaffolding Python APIs, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/python/api-scaffolding` - api scaffolding best practices
+- `mcp://context7/fastapi/structure` - structure best practices
+- `mcp://context7/api-design/rest` - rest best practices
+- `mcp://context7/python/best-practices` - best practices best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 **Example**: `/python:api-scaffold task-manager --db=postgresql --auth=jwt`
 
 **What this does**:

package/autopm/.claude/commands/python/docs-query.md

@@ -8,6 +8,23 @@ Queries latest Python/FastAPI documentation via context7 before implementation.
 
 **Usage**: `/python:docs-query [--topic=fastapi|sqlalchemy|pydantic|uv|pytest] [--pattern=search-pattern] [--examples]`
 
+## Required Documentation Access
+
+**MANDATORY:** Before Python API development, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/python/api-development` - api development best practices
+- `mcp://context7/fastapi/best-practices` - best practices best practices
+- `mcp://context7/python/documentation` - documentation best practices
+- `mcp://context7/api-design/rest` - rest best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 **Examples**: 
 - `/python:docs-query --topic=fastapi --pattern=authentication`
 - `/python:docs-query --topic=sqlalchemy --pattern=async --examples`

package/autopm/.claude/commands/react/app-scaffold.md

@@ -8,6 +8,23 @@ Creates a complete React application with TypeScript and modern tooling.
 
 **Usage**: `/react:app-scaffold [app-name] [--framework=vite|next] [--styling=tailwind|styled] [--state=zustand|redux]`
 
+## Required Documentation Access
+
+**MANDATORY:** Before scaffolding React applications, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/react/project-setup` - project setup best practices
+- `mcp://context7/react/application-structure` - application structure best practices
+- `mcp://context7/frontend/tooling` - tooling best practices
+- `mcp://context7/react/best-practices` - best practices best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 **Example**: `/react:app-scaffold dashboard-app --framework=vite --styling=tailwind --state=zustand`
 
 **What this does**:

package/autopm/.claude/commands/testing/prime.md

@@ -53,6 +53,23 @@ If dependencies missing:
 - Tell user: "❌ Test dependencies not installed"
 - Suggest: "Run: npm install (or pip install -r requirements.txt)"
 
+## Required Documentation Access
+
+**MANDATORY:** Before testing workflows, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/testing/strategy` - strategy best practices
+- `mcp://context7/testing/automation` - automation best practices
+- `mcp://context7/tdd/workflow` - workflow best practices
+- `mcp://context7/testing/best-practices` - best practices best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 ## Instructions
 
 ### 1. Framework-Specific Configuration

package/autopm/.claude/commands/testing/run.md

@@ -17,6 +17,23 @@ Where `test_target` can be:
 - Test pattern
 - Test suite name
 
+## Required Documentation Access
+
+**MANDATORY:** Before testing workflows, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/testing/strategy` - strategy best practices
+- `mcp://context7/testing/automation` - automation best practices
+- `mcp://context7/tdd/workflow` - workflow best practices
+- `mcp://context7/testing/best-practices` - best practices best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 ## Quick Check
 
 ```bash

package/autopm/.claude/commands/ui/bootstrap-scaffold.md

@@ -31,6 +31,23 @@ Use the react-ui-expert agent with framework=bootstrap to create a complete Boot
 
 ## Example Usage
 ```
+## Required Documentation Access
+
+**MANDATORY:** Before UI framework setup, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/ui/bootstrap` - bootstrap best practices
+- `mcp://context7/ui/tailwind` - tailwind best practices
+- `mcp://context7/frontend/design-systems` - design systems best practices
+- `mcp://context7/css/frameworks` - frameworks best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 Task: Create Bootstrap dashboard with sidebar navigation, responsive cards grid, and contact forms
 Agent: react-ui-expert
 Parameters: framework=bootstrap, theme=corporate, components=navbar,sidebar,cards,forms,modals, responsive=all, features=dark-mode,validation

package/autopm/.claude/commands/ui/tailwind-system.md

@@ -31,6 +31,23 @@ Use the tailwindcss-expert agent to create a comprehensive TailwindCSS design sy
 
 ## Example Usage
 ```
+## Required Documentation Access
+
+**MANDATORY:** Before UI framework setup, query Context7 for best practices:
+
+**Documentation Queries:**
+- `mcp://context7/ui/bootstrap` - bootstrap best practices
+- `mcp://context7/ui/tailwind` - tailwind best practices
+- `mcp://context7/frontend/design-systems` - design systems best practices
+- `mcp://context7/css/frameworks` - frameworks best practices
+
+**Why This is Required:**
+- Ensures adherence to current industry standards and best practices
+- Prevents outdated or incorrect implementation patterns
+- Provides access to latest framework/tool documentation
+- Reduces errors from stale knowledge or assumptions
+
+
 Task: Create TailwindCSS design system with custom color palette, typography scale, and component library
 Agent: tailwindcss-expert
 Parameters: theme=modern, utilities=custom-spacing,gradients,animations, components=buttons,cards,forms, plugins=forms,typography

package/autopm/.claude/hooks/pre-agent-context7.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-Agent Context7 Hook
+ *
+ * MANDATORY: This hook enforces Context7 documentation queries BEFORE agent invocation.
+ *
+ * Workflow:
+ * 1. Intercept agent invocation (e.g., @aws-cloud-architect)
+ * 2. Extract agent file path from .claude/agents/{category}/{agent}.md
+ * 3. Parse "Documentation Queries" section
+ * 4. Query Context7 MCP for each link
+ * 5. Inject results into agent context
+ * 6. Allow agent to proceed with Context7 knowledge
+ *
+ * Zero Tolerance: If Context7 query fails, agent invocation STOPS.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Parse agent invocation
+ * @param {string} agentInvocation - e.g., "@aws-cloud-architect design VPC"
+ * @returns {object} { agentName, task }
+ */
+function parseAgentInvocation(agentInvocation) {
+  // Remove @ symbol and split
+  const cleaned = agentInvocation.replace(/^@/, '');
+  const parts = cleaned.split(/\s+/);
+  const agentName = parts[0];
+  const task = parts.slice(1).join(' ');
+
+  return {
+    agentName,
+    task,
+    fullInvocation: agentInvocation
+  };
+}
+
+/**
+ * Find agent file in .claude/agents/
+ * @param {string} agentName - Agent name (aws-cloud-architect, test-runner, etc.)
+ * @returns {string|null} - Path to agent file or null
+ */
+function findAgentFile(agentName) {
+  const baseDir = path.join(process.cwd(), '.claude', 'agents');
+
+  // Search recursively in all subdirectories
+  function searchDir(dir) {
+    if (!fs.existsSync(dir)) return null;
+
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+
+      if (entry.isDirectory()) {
+        const found = searchDir(fullPath);
+        if (found) return found;
+      } else if (entry.isFile() && entry.name.endsWith('.md')) {
+        // Check if filename matches (with or without .md extension)
+        const basename = path.basename(entry.name, '.md');
+        if (basename === agentName || basename.replace(/-/g, '_') === agentName) {
+          return fullPath;
+        }
+      }
+    }
+
+    return null;
+  }
+
+  return searchDir(baseDir);
+}
+
+/**
+ * Extract Documentation Queries from agent file
+ * @param {string} filePath - Path to agent .md file
+ * @returns {Array<{url: string, description: string}>}
+ */
+function extractDocumentationQueries(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const queries = [];
+
+  // Find the Documentation Queries section (agent format)
+  const querySection = content.match(/\*\*Documentation Queries:\*\*\s*\n([\s\S]*?)(?=\n\n|\*\*|##|$)/);
+
+  if (!querySection) {
+    return queries; // No Documentation Queries section found
+  }
+
+  // Extract each mcp://context7/... line
+  const lines = querySection[1].split('\n');
+  for (const line of lines) {
+    const match = line.match(/`(mcp:\/\/context7\/[^`]+)`\s*-\s*(.+)/);
+    if (match) {
+      queries.push({
+        url: match[1],
+        description: match[2].trim()
+      });
+    }
+  }
+
+  return queries;
+}
+
+/**
+ * Query Context7 MCP server
+ * @param {string} mcpUrl - e.g., "mcp://context7/aws/compute"
+ * @returns {Promise<object>} - Context7 response
+ */
+async function queryContext7(mcpUrl) {
+  // Parse MCP URL: mcp://context7/category/topic
+  const urlMatch = mcpUrl.match(/mcp:\/\/context7\/(.+)/);
+  if (!urlMatch) {
+    throw new Error(`Invalid Context7 URL format: ${mcpUrl}`);
+  }
+
+  const topicPath = urlMatch[1]; // e.g., "aws/compute"
+
+  // In real implementation, this would call the MCP server
+  // For now, return a placeholder that instructs Claude to query
+  return {
+    url: mcpUrl,
+    topic: topicPath,
+    instruction: `MANDATORY: Query Context7 MCP for topic "${topicPath}" before implementing solution.`,
+    placeholder: true
+  };
+}
+
+/**
+ * Main hook execution
+ * @param {string} agentInvocation - Full agent invocation from user
+ */
+async function main(agentInvocation) {
+  console.log('\n🔒 Context7 Pre-Agent Hook Activated\n');
+
+  // Parse agent invocation
+  const { agentName, task, fullInvocation } = parseAgentInvocation(agentInvocation || process.argv[2] || '');
+
+  console.log(`🤖 Agent: @${agentName}`);
+  if (task) {
+    console.log(`   Task: ${task}`);
+  }
+
+  // Find agent file
+  const agentFile = findAgentFile(agentName);
+  if (!agentFile) {
+    console.log(`\n⚠️  Warning: Agent file not found for @${agentName}`);
+    console.log(`   Searched: .claude/agents/**/${agentName}.md`);
+    console.log(`   Proceeding without Context7 enforcement (agent may not exist)\n`);
+    return;
+  }
+
+  console.log(`   File: ${path.relative(process.cwd(), agentFile)}`);
+
+  // Extract Documentation Queries
+  const queries = extractDocumentationQueries(agentFile);
+
+  if (queries.length === 0) {
+    console.log(`\n❌ CRITICAL: No Documentation Queries found in agent file!`);
+    console.log(`   This violates Context7 enforcement policy.`);
+    console.log(`   ALL agents MUST have Documentation Queries section.`);
+    console.log(`\n   Please add to ${path.basename(agentFile)}:`);
+    console.log(`   **Documentation Queries:**`);
+    console.log(`   - \`mcp://context7/...\` - Description`);
+    console.log(`\n   Blocking agent invocation until fixed.\n`);
+    process.exit(1);
+  }
+
+  console.log(`\n📚 Context7 Documentation Queries Required: ${queries.length}\n`);
+
+  // Query Context7 for each link
+  const results = [];
+  for (const query of queries) {
+    console.log(`   ➜ ${query.url}`);
+    console.log(`     ${query.description}`);
+
+    try {
+      const result = await queryContext7(query.url);
+      results.push(result);
+    } catch (error) {
+      console.log(`\n❌ Context7 query FAILED: ${error.message}`);
+      console.log(`   Cannot proceed without Context7 documentation.`);
+      console.log(`   Please ensure Context7 MCP server is running.\n`);
+      process.exit(1);
+    }
+  }
+
+  console.log(`\n✅ Context7 Queries Complete\n`);
+  console.log(`📖 REMINDER: @${agentName} MUST use Context7 documentation:`);
+  console.log(`   • Apply patterns from Context7 examples`);
+  console.log(`   • Verify API signatures against Context7 results`);
+  console.log(`   • Follow best practices documented in Context7`);
+  console.log(`   • Flag any conflicts between training data and Context7`);
+  console.log(`\n🚀 Proceeding with agent invocation...\n`);
+
+  // In production, this would inject Context7 results into agent's context
+  // For now, we output instruction for Claude to see
+  if (results.length > 0 && results[0].placeholder) {
+    console.log(`⚡ ACTION REQUIRED FOR @${agentName}:`);
+    console.log(`   Before implementing "${task || 'task'}", you MUST:`);
+    for (const result of results) {
+      console.log(`   • ${result.instruction}`);
+    }
+    console.log();
+  }
+}
+
+// Execute if run directly
+if (require.main === module) {
+  const agentInvocation = process.argv.slice(2).join(' ');
+  main(agentInvocation).catch(error => {
+    console.error('\n❌ Hook execution failed:', error.message);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  parseAgentInvocation,
+  findAgentFile,
+  extractDocumentationQueries,
+  queryContext7
+};

package/autopm/.claude/hooks/pre-command-context7.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-Command Context7 Hook
+ *
+ * MANDATORY: This hook enforces Context7 documentation queries BEFORE command execution.
+ *
+ * Workflow:
+ * 1. Intercept command execution (e.g., /pm:epic-decompose)
+ * 2. Extract command file path from .claude/commands/{category}/{command}.md
+ * 3. Parse "Documentation Queries" section
+ * 4. Query Context7 MCP for each link
+ * 5. Inject results into execution context
+ * 6. Allow command to proceed with Context7 knowledge
+ *
+ * Zero Tolerance: If Context7 query fails, execution STOPS.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Extract command metadata from invocation
+ * @param {string} commandInvocation - e.g., "/pm:epic-decompose feature-name"
+ * @returns {object} { category, command, args }
+ */
+function parseCommandInvocation(commandInvocation) {
+  // Remove leading slash and split
+  const cleaned = commandInvocation.replace(/^\//, '');
+  const [categoryCommand, ...args] = cleaned.split(/\s+/);
+  const [category, command] = categoryCommand.split(':');
+
+  return {
+    category: category || 'pm', // Default to pm if no category
+    command: command || categoryCommand,
+    args: args,
+    fullCommand: categoryCommand
+  };
+}
+
+/**
+ * Find command file in .claude/commands/
+ * @param {string} category - Command category (pm, azure, cloud, etc.)
+ * @param {string} command - Command name (epic-decompose, issue-start, etc.)
+ * @returns {string|null} - Path to command file or null
+ */
+function findCommandFile(category, command) {
+  const baseDir = path.join(process.cwd(), '.claude', 'commands');
+
+  // Try exact match first
+  let commandPath = path.join(baseDir, category, `${command}.md`);
+  if (fs.existsSync(commandPath)) {
+    return commandPath;
+  }
+
+  // Try with underscores (epic-decompose → epic_decompose)
+  const underscored = command.replace(/-/g, '_');
+  commandPath = path.join(baseDir, category, `${underscored}.md`);
+  if (fs.existsSync(commandPath)) {
+    return commandPath;
+  }
+
+  // Try without category prefix if command includes it
+  if (command.includes('-')) {
+    const [, actualCommand] = command.split('-', 2);
+    if (actualCommand) {
+      commandPath = path.join(baseDir, category, `${actualCommand}.md`);
+      if (fs.existsSync(commandPath)) {
+        return commandPath;
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Extract Documentation Queries from command file
+ * @param {string} filePath - Path to command .md file
+ * @returns {Array<{url: string, description: string}>}
+ */
+function extractDocumentationQueries(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const queries = [];
+
+  // Find the Documentation Queries section
+  const querySection = content.match(/\*\*Documentation Queries:\*\*\s*\n([\s\S]*?)(?=\n\n|\*\*Why This is Required|\n##|$)/);
+
+  if (!querySection) {
+    return queries; // No Documentation Queries section found
+  }
+
+  // Extract each mcp://context7/... line
+  const lines = querySection[1].split('\n');
+  for (const line of lines) {
+    const match = line.match(/`(mcp:\/\/context7\/[^`]+)`\s*-\s*(.+)/);
+    if (match) {
+      queries.push({
+        url: match[1],
+        description: match[2].trim()
+      });
+    }
+  }
+
+  return queries;
+}
+
+/**
+ * Query Context7 MCP server
+ * @param {string} mcpUrl - e.g., "mcp://context7/agile/epic-decomposition"
+ * @returns {Promise<object>} - Context7 response
+ */
+async function queryContext7(mcpUrl) {
+  // Parse MCP URL: mcp://context7/category/topic
+  const urlMatch = mcpUrl.match(/mcp:\/\/context7\/(.+)/);
+  if (!urlMatch) {
+    throw new Error(`Invalid Context7 URL format: ${mcpUrl}`);
+  }
+
+  const topicPath = urlMatch[1]; // e.g., "agile/epic-decomposition"
+
+  // In real implementation, this would call the MCP server
+  // For now, return a placeholder that instructs Claude to query
+  return {
+    url: mcpUrl,
+    topic: topicPath,
+    instruction: `MANDATORY: Query Context7 MCP for topic "${topicPath}" before proceeding with implementation.`,
+    placeholder: true
+  };
+}
+
+/**
+ * Main hook execution
+ * @param {string} commandInvocation - Full command string from user
+ */
+async function main(commandInvocation) {
+  console.log('\n🔒 Context7 Pre-Command Hook Activated\n');
+
+  // Parse command
+  const { category, command, args, fullCommand } = parseCommandInvocation(commandInvocation || process.argv[2] || '');
+
+  console.log(`📋 Command: /${fullCommand}`);
+  console.log(`   Category: ${category}`);
+  console.log(`   Command: ${command}`);
+  if (args.length > 0) {
+    console.log(`   Arguments: ${args.join(' ')}`);
+  }
+
+  // Find command file
+  const commandFile = findCommandFile(category, command);
+  if (!commandFile) {
+    console.log(`\n⚠️  Warning: Command file not found for /${fullCommand}`);
+    console.log(`   Searched: .claude/commands/${category}/${command}.md`);
+    console.log(`   Proceeding without Context7 enforcement (file may not exist yet)\n`);
+    return;
+  }
+
+  console.log(`   File: ${path.relative(process.cwd(), commandFile)}`);
+
+  // Extract Documentation Queries
+  const queries = extractDocumentationQueries(commandFile);
+
+  if (queries.length === 0) {
+    console.log(`\n❌ CRITICAL: No Documentation Queries found in command file!`);
+    console.log(`   This violates Context7 enforcement policy.`);
+    console.log(`   ALL commands MUST have Documentation Queries section.`);
+    console.log(`\n   Please add to ${path.basename(commandFile)}:`);
+    console.log(`   ## Required Documentation Access`);
+    console.log(`   **MANDATORY:** Before [action], query Context7 for best practices:`);
+    console.log(`   **Documentation Queries:**`);
+    console.log(`   - \`mcp://context7/...\` - Description`);
+    console.log(`\n   Blocking execution until fixed.\n`);
+    process.exit(1);
+  }
+
+  console.log(`\n📚 Context7 Documentation Queries Required: ${queries.length}\n`);
+
+  // Query Context7 for each link
+  const results = [];
+  for (const query of queries) {
+    console.log(`   ➜ ${query.url}`);
+    console.log(`     ${query.description}`);
+
+    try {
+      const result = await queryContext7(query.url);
+      results.push(result);
+    } catch (error) {
+      console.log(`\n❌ Context7 query FAILED: ${error.message}`);
+      console.log(`   Cannot proceed without Context7 documentation.`);
+      console.log(`   Please ensure Context7 MCP server is running.\n`);
+      process.exit(1);
+    }
+  }
+
+  console.log(`\n✅ Context7 Queries Complete\n`);
+  console.log(`📖 REMINDER: You MUST use Context7 documentation in your implementation:`);
+  console.log(`   • Apply patterns from Context7 examples`);
+  console.log(`   • Verify API signatures against Context7 results`);
+  console.log(`   • Follow best practices documented in Context7`);
+  console.log(`   • Flag any conflicts between training data and Context7`);
+  console.log(`\n🚀 Proceeding with command execution...\n`);
+
+  // In production, this would inject Context7 results into Claude's context
+  // For now, we output instruction for Claude to see
+  if (results.length > 0 && results[0].placeholder) {
+    console.log(`⚡ ACTION REQUIRED:`);
+    console.log(`   Before implementing /${fullCommand}, you MUST:`);
+    for (const result of results) {
+      console.log(`   • ${result.instruction}`);
+    }
+    console.log();
+  }
+}
+
+// Execute if run directly
+if (require.main === module) {
+  const commandInvocation = process.argv.slice(2).join(' ');
+  main(commandInvocation).catch(error => {
+    console.error('\n❌ Hook execution failed:', error.message);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  parseCommandInvocation,
+  findCommandFile,
+  extractDocumentationQueries,
+  queryContext7
+};