specmem-hardwicksoftware 3.5.99

package/dist/hooks/simpleContextHook.js

@@ -0,0 +1,194 @@
+/**
+ * SIMPLE CONTEXT HOOK
+ * ===================
+ *
+ * PreToolUse hook that searches SpecMem for relevant context
+ * before ANY tool executes. Outputs in Chinese Compactor format
+ * for maximum token efficiency.
+ *
+ * This is a LIGHTWEIGHT alternative to the full ContextInjectionHook -
+ * it runs on every tool call and returns compact Chinese context.
+ *
+ * Flow:
+ *   1.  calls a tool (any tool)
+ *   2. Hook extracts query from tool args
+ *   3. Search SpecMem for semantically similar memories
+ *   4. Return Chinese-compacted context to 
+ *   5.  uses context to inform tool execution
+ *
+ * For  Code integration, create a hook script that:
+ *   - Reads tool name and arguments from stdin (JSON)
+ *   - Calls this hook
+ *   - Outputs context to stdout
+ */
+import { searchRelatedMemories } from './contextInjectionHook.js';
+import { smartCompress } from '../utils/tokenCompressor.js';
+import { logger } from '../utils/logger.js';
+const DEFAULT_SIMPLE_CONFIG = {
+    maxMemories: 3,
+    maxContentPerMemory: 150,
+    threshold: 0.2,
+    compressOutput: true,
+    excludeTools: ['send_message', 'list_tools', 'get_tool_schema'] // Skip meta tools
+};
+/**
+ * Extract a searchable query from tool arguments
+ * Different tools have different argument structures
+ */
+function extractQueryFromToolArgs(toolName, args) {
+    // Common patterns for query extraction
+    const queryFields = [
+        'query',
+        'search',
+        'prompt',
+        'input',
+        'text',
+        'content',
+        'command',
+        'message',
+        'path',
+        'file_path',
+        'pattern'
+    ];
+    // Try each field
+    for (const field of queryFields) {
+        const value = args[field];
+        if (typeof value === 'string' && value.length > 3) {
+            return value;
+        }
+    }
+    // Fallback: combine all string values
+    const stringValues = Object.values(args)
+        .filter((v) => typeof v === 'string' && v.length > 3)
+        .slice(0, 3);
+    if (stringValues.length > 0) {
+        return stringValues.join(' ');
+    }
+    // Use tool name as last resort
+    return toolName.replace(/_/g, ' ');
+}
+/**
+ * Format memories as Chinese-compacted context
+ * This is the CORE output format for the hook
+ */
+function formatChineseContext(toolName, query, memories, config) {
+    if (memories.length === 0) {
+        return ''; // No context to inject
+    }
+    const lines = [];
+    // Header (Chinese)
+    lines.push(`<specmem-simple query="${query.substring(0, 50)}">`);
+    lines.push(`工具: ${toolName} | 相關記憶: ${memories.length}條`);
+    // Compact memory summaries
+    for (let i = 0; i < memories.length && i < config.maxMemories; i++) {
+        const mem = memories[i];
+        let content = mem.content.substring(0, config.maxContentPerMemory);
+        // Compress content if enabled
+        if (config.compressOutput) {
+            const compressed = smartCompress(content, {
+                threshold: 0.85,
+                minLength: 20
+            });
+            content = compressed.result;
+        }
+        // Format: [sim%] tag1,tag2 | content...
+        const sim = Math.round(mem.similarity * 100);
+        const tags = mem.tags.slice(0, 2).join(',') || 'none';
+        lines.push(`  ${sim}% [${tags}]: ${content}${mem.content.length > config.maxContentPerMemory ? '...' : ''}`);
+    }
+    // Footer with hint
+    if (memories.length > 0 && memories[0].similarity > 0.5) {
+        lines.push(`  ✓ 高相關性 - 直接使用此上下文`);
+    }
+    else if (memories.length > 0 && memories[0].similarity > 0.3) {
+        lines.push(`  → 中等相關 - 可能需要驗證`);
+    }
+    else {
+        lines.push(`  ⚠ 低相關性 - 謹慎使用`);
+    }
+    lines.push(`</specmem-simple>`);
+    return lines.join('\n');
+}
+/**
+ * Main hook function - call this from your PreToolUse script
+ *
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @param config - Optional configuration override
+ * @returns Chinese-compacted context string (empty if no relevant context)
+ */
+export async function simpleContextHook(toolName, args, config = {}) {
+    const cfg = { ...DEFAULT_SIMPLE_CONFIG, ...config };
+    // Skip excluded tools
+    if (cfg.excludeTools.includes(toolName)) {
+        return '';
+    }
+    // Extract query from tool arguments
+    const query = extractQueryFromToolArgs(toolName, args);
+    if (!query || query.length < 4) {
+        return '';
+    }
+    try {
+        const startTime = Date.now();
+        // Search SpecMem
+        const memories = await searchRelatedMemories(query, {
+            searchLimit: cfg.maxMemories,
+            threshold: cfg.threshold,
+            maxContentLength: cfg.maxContentPerMemory
+        });
+        const duration = Date.now() - startTime;
+        logger.debug({
+            tool: toolName,
+            query: query.substring(0, 50),
+            memoriesFound: memories.length,
+            duration
+        }, '[SimpleContextHook] 搜索完成');
+        // Format as Chinese context
+        return formatChineseContext(toolName, query, memories, cfg);
+    }
+    catch (error) {
+        logger.error({ error, tool: toolName }, '[SimpleContextHook] 錯誤');
+        return '';
+    }
+}
+/**
+ * CLI entry point for  Code PreToolUse hook
+ * Reads JSON from stdin: { "tool_name": "...", "tool_input": {...} }
+ * Outputs context to stdout (or empty if none)
+ */
+export async function runFromCLI() {
+    try {
+        // Read from stdin
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const input = Buffer.concat(chunks).toString('utf8').trim();
+        if (!input) {
+            return;
+        }
+        // Parse JSON input
+        const data = JSON.parse(input);
+        const toolName = data.tool_name || data.toolName || '';
+        const args = data.tool_input || data.toolInput || data.arguments || {};
+        // Run hook
+        const context = await simpleContextHook(toolName, args);
+        // Output context (only if non-empty)
+        if (context) {
+            console.log(context);
+        }
+    }
+    catch (error) {
+        // Silent fail - don't break 's flow
+        logger.error({ error }, '[SimpleContextHook CLI] Error');
+    }
+}
+// Export for programmatic use
+export default {
+    simpleContextHook,
+    runFromCLI,
+    extractQueryFromToolArgs,
+    formatChineseContext,
+    DEFAULT_SIMPLE_CONFIG
+};
+//# sourceMappingURL=simpleContextHook.js.map

package/dist/hooks/simpleContextHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simpleContextHook.js","sourceRoot":"","sources":["../../src/hooks/simpleContextHook.ts"],"names":[],"mappings":"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"}

package/dist/hooks/teamFramingCli.d.ts

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * SPECMEM TEAM FRAMING CLI
+ * ========================
+ *
+ * CLI entry point for the Team Member Preprompt Hook.
+ * This allows the hook to be called directly from  Code settings.
+ *
+ * Usage in ~/.claude/settings.json:
+ *
+ * For all tools (general PreToolUse hook):
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [
+ *       {
+ *         "matcher": "*",
+ *         "hooks": [
+ *           {
+ *             "type": "command",
+ *             "command": "node /path/to/specmem/dist/hooks/teamFramingCli.js"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * Or for targeted Task tool interception only:
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [
+ *       {
+ *         "matcher": "Task",
+ *         "hooks": [
+ *           {
+ *             "type": "command",
+ *             "command": "node /path/to/specmem/dist/hooks/teamFramingCli.js"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * CLI Commands:
+ *   (no args)          Run as hook (read from stdin)
+ *   enable             Enable team framing
+ *   disable            Disable team framing
+ *   status             Show current configuration
+ *   set-channel NAME   Set communication channel name
+ *   set-preprompt      Set custom preprompt (reads from stdin)
+ *   reset              Reset to default configuration
+ *   help               Show help
+ */
+export {};
+//# sourceMappingURL=teamFramingCli.d.ts.map

package/dist/hooks/teamFramingCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamFramingCli.d.ts","sourceRoot":"","sources":["../../src/hooks/teamFramingCli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG"}

package/dist/hooks/teamFramingCli.js

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+/**
+ * SPECMEM TEAM FRAMING CLI
+ * ========================
+ *
+ * CLI entry point for the Team Member Preprompt Hook.
+ * This allows the hook to be called directly from  Code settings.
+ *
+ * Usage in ~/.claude/settings.json:
+ *
+ * For all tools (general PreToolUse hook):
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [
+ *       {
+ *         "matcher": "*",
+ *         "hooks": [
+ *           {
+ *             "type": "command",
+ *             "command": "node /path/to/specmem/dist/hooks/teamFramingCli.js"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * Or for targeted Task tool interception only:
+ * {
+ *   "hooks": {
+ *     "PreToolUse": [
+ *       {
+ *         "matcher": "Task",
+ *         "hooks": [
+ *           {
+ *             "type": "command",
+ *             "command": "node /path/to/specmem/dist/hooks/teamFramingCli.js"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * CLI Commands:
+ *   (no args)          Run as hook (read from stdin)
+ *   enable             Enable team framing
+ *   disable            Disable team framing
+ *   status             Show current configuration
+ *   set-channel NAME   Set communication channel name
+ *   set-preprompt      Set custom preprompt (reads from stdin)
+ *   reset              Reset to default configuration
+ *   help               Show help
+ */
+import { teamMemberPrepromptHook, loadTeamConfig, saveTeamConfig, resetTeamConfig, enableTeamFraming, disableTeamFraming, setChannelName, setCustomPreprompt } from './teamMemberPrepromptHook.js';
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8').trim();
+}
+async function runHook() {
+    try {
+        const input = await readStdin();
+        if (!input) {
+            return;
+        }
+        // Parse JSON input from  Code
+        const data = JSON.parse(input);
+        const toolName = data.tool_name || '';
+        const toolInput = data.tool_input || {};
+        // Run the hook
+        const result = await teamMemberPrepromptHook(toolName, toolInput);
+        // Output modified tool input if modified
+        if (result.modified && result.modifiedInput) {
+            const output = {
+                tool_name: toolName,
+                tool_input: result.modifiedInput
+            };
+            console.log(JSON.stringify(output));
+        }
+        // If not modified, output nothing (tool proceeds unchanged)
+    }
+    catch (error) {
+        // Silent fail - don't break 's flow
+        console.error(`[TeamFraming Hook Error] ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+function showStatus() {
+    const config = loadTeamConfig();
+    console.log(`
+Team Framing Configuration
+==========================
+Enabled:           ${config.enabled ? 'YES' : 'NO'}
+Channel Name:      ${config.channelName}
+Team Name:         ${config.teamName}
+Senior Engineer:   ${config.seniorEngineerName}
+Trigger Tools:     ${config.triggerTools.join(', ')}
+MCP Instructions:  ${config.includeMcpToolInstructions ? 'YES' : 'NO'}
+Custom Preprompt:  ${config.customPreprompt ? `${config.customPreprompt.length} chars` : 'Using default'}
+Additional Context: ${config.additionalContext ? `${config.additionalContext.length} chars` : 'None'}
+`);
+}
+function showHelp() {
+    console.log(`
+SpecMem Team Framing Hook CLI
+=============================
+
+This hook intercepts Task tool calls and injects a "dev team" framing
+prompt to spawned teamMembers, creating a psychological context for collaboration.
+
+Usage: team-framing-cli [command] [options]
+
+Commands:
+  (no args)          Run as hook (read JSON from stdin)
+  enable             Enable team framing
+  disable            Disable team framing
+  status             Show current configuration
+  set-channel NAME   Set communication channel name
+  set-team NAME      Set team name
+  set-senior NAME    Set senior engineer name
+  set-preprompt      Set custom preprompt (reads from stdin)
+  reset              Reset to default configuration
+  test               Run a test with sample input
+  help               Show this help
+
+Examples:
+  # Enable team framing
+  team-framing-cli enable
+
+  # Set custom channel
+  team-framing-cli set-channel dev-team-alpha
+
+  # Set custom preprompt
+  echo "You are on team Alpha..." | team-framing-cli set-preprompt
+
+  # Check status
+  team-framing-cli status
+
+Environment Variables:
+  SPECMEM_TEAM_ENABLED     Override enabled status (true/false)
+  SPECMEM_TEAM_CHANNEL     Override channel name
+
+Default Framing Prompt:
+${'-'.repeat(60)}
+You are a developer on a software development team. The senior
+engineer on this team is skeptical of AI assistance, so you must
+perform your tasks efficiently and communicate well with your
+fellow developers.
+
+Other developers may be working on related parts of this task.
+To coordinate and avoid conflicts:
+
+1. Use the \`send_team_message\` tool to share your progress
+2. Use the \`read_team_messages\` tool to see what others are working on
+3. Use the \`request_code_review\` tool to get feedback from teammates
+4. Use the \`claim_task\` tool to indicate what you're working on
+
+Our team uses a custom Slack-like communication channel.
+Always check for messages from teammates before making major changes.
+
+Your current task assignment: [TASK DESCRIPTION HERE]
+${'-'.repeat(60)}
+`);
+}
+async function runTest() {
+    console.log('Running test with sample Task tool input...\n');
+    const testInput = {
+        tool_name: 'Task',
+        tool_input: {
+            prompt: 'Implement the user authentication feature',
+            description: 'Create login and registration flows'
+        }
+    };
+    console.log('Input:');
+    console.log(JSON.stringify(testInput, null, 2));
+    console.log('\n');
+    const result = await teamMemberPrepromptHook(testInput.tool_name, testInput.tool_input);
+    console.log('Result:');
+    console.log(`Modified: ${result.modified}`);
+    if (result.debug?.framedPrompt) {
+        console.log('\nFramed Prompt:');
+        console.log('-'.repeat(60));
+        console.log(result.debug.framedPrompt);
+        console.log('-'.repeat(60));
+    }
+}
+async function main() {
+    const command = process.argv[2];
+    const arg = process.argv[3];
+    switch (command) {
+        case 'enable':
+            enableTeamFraming();
+            console.log('Team framing enabled');
+            break;
+        case 'disable':
+            disableTeamFraming();
+            console.log('Team framing disabled');
+            break;
+        case 'status':
+            showStatus();
+            break;
+        case 'set-channel':
+            if (!arg) {
+                console.error('Error: Channel name required');
+                process.exit(1);
+            }
+            setChannelName(arg);
+            console.log(`Channel name set to: ${arg}`);
+            break;
+        case 'set-team':
+            if (!arg) {
+                console.error('Error: Team name required');
+                process.exit(1);
+            }
+            saveTeamConfig({ teamName: arg });
+            console.log(`Team name set to: ${arg}`);
+            break;
+        case 'set-senior':
+            if (!arg) {
+                console.error('Error: Senior engineer name required');
+                process.exit(1);
+            }
+            saveTeamConfig({ seniorEngineerName: arg });
+            console.log(`Senior engineer name set to: ${arg}`);
+            break;
+        case 'set-preprompt':
+            const preprompt = await readStdin();
+            if (!preprompt) {
+                console.error('Error: Preprompt content required (pipe via stdin)');
+                process.exit(1);
+            }
+            setCustomPreprompt(preprompt);
+            console.log(`Custom preprompt set (${preprompt.length} chars)`);
+            break;
+        case 'reset':
+            resetTeamConfig();
+            console.log('Configuration reset to defaults');
+            break;
+        case 'test':
+            await runTest();
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+            showHelp();
+            break;
+        case undefined:
+        case '':
+            // No command - run as hook
+            await runHook();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.error('Run with "help" for usage information');
+            process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error(`[TeamFraming] Fatal error: ${error.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=teamFramingCli.js.map

package/dist/hooks/teamFramingCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamFramingCli.js","sourceRoot":"","sources":["../../src/hooks/teamFramingCli.ts"],"names":[],"mappings":"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"}

package/dist/hooks/teamMemberPrepromptHook.d.ts

@@ -0,0 +1,150 @@
+/**
+ * SPECMEM TEAM_MEMBER PREPROMPT HOOK
+ * ===================================
+ *
+ * Pre-tool hook that intercepts Task tool calls and injects a "dev team"
+ * framing prompt to all spawned team members (teamMembers).
+ *
+ * The framing creates a psychological context where:
+ *   - Each team member believes they are a developer on a software team
+ *   - A skeptical senior engineer motivates efficient, quality work
+ *   - Team communication tools encourage coordination
+ *   - The artificial nature of the team is not revealed
+ *
+ * Hook Type: PreToolUse (intercepts Task tool calls before execution)
+ *
+ * Flow:
+ *   1.  calls Task tool to spawn a team member
+ *   2. This hook intercepts the call
+ *   3. The prompt is modified to include team framing
+ *   4. TeamMember spawns with team context + original task
+ */
+/**
+ * Team framing configuration
+ */
+export interface TeamFramingConfig {
+    /** Enable/disable team framing injection */
+    enabled: boolean;
+    /** The team communication channel/room name */
+    channelName: string;
+    /** Custom pre-prompt text (if empty, uses default) */
+    customPreprompt: string;
+    /** Additional context to append after the framing */
+    additionalContext: string;
+    /** Tool names that trigger framing (default: Task) */
+    triggerTools: string[];
+    /** Whether to include MCP tool instructions */
+    includeMcpToolInstructions: boolean;
+    /** Senior engineer's name (for framing) */
+    seniorEngineerName: string;
+    /** Team name */
+    teamName: string;
+}
+/**
+ * Default team framing configuration
+ */
+export declare const DEFAULT_TEAM_CONFIG: TeamFramingConfig;
+/**
+ * The core team framing prompt
+ * This creates the psychological context for team member collaboration
+ */
+export declare function generateTeamFramingPrompt(taskDescription: string, config: TeamFramingConfig): string;
+/**
+ * Load team framing configuration from file
+ */
+export declare function loadTeamConfig(): TeamFramingConfig;
+/**
+ * Save team framing configuration to file
+ */
+export declare function saveTeamConfig(config: Partial<TeamFramingConfig>): TeamFramingConfig;
+/**
+ * Update specific config fields
+ */
+export declare function updateTeamConfig(updates: Partial<TeamFramingConfig>): TeamFramingConfig;
+/**
+ * Reset config to defaults
+ */
+export declare function resetTeamConfig(): TeamFramingConfig;
+/**
+ *  Code PreToolUse hook input format
+ */
+export interface PreToolUseInput {
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+    session_id?: string;
+    conversation_id?: string;
+}
+/**
+ * Hook output format
+ */
+export interface TeamFramingResult {
+    /** Whether the tool call was modified */
+    modified: boolean;
+    /** The modified tool input (if modified) */
+    modifiedInput?: Record<string, unknown>;
+    /** Any additional context to inject */
+    injectedContext?: string;
+    /** Debug info */
+    debug?: {
+        originalPrompt?: string;
+        framedPrompt?: string;
+        config: TeamFramingConfig;
+    };
+}
+/**
+ * Main hook function - intercepts Task tool calls and injects team framing
+ *
+ * @param toolName - Name of the tool being called
+ * @param toolInput - Tool arguments/input
+ * @param config - Optional configuration override
+ * @returns Modified tool input with team framing injected
+ */
+export declare function teamMemberPrepromptHook(toolName: string, toolInput: Record<string, unknown>, config?: Partial<TeamFramingConfig>): Promise<TeamFramingResult>;
+/**
+ * CLI entry point for  Code PreToolUse hook
+ * Reads JSON from stdin: { "tool_name": "...", "tool_input": {...} }
+ * Outputs modified tool input to stdout (as JSON)
+ */
+export declare function runFromCLI(): Promise<void>;
+/**
+ * Enable team framing
+ */
+export declare function enableTeamFraming(): void;
+/**
+ * Disable team framing
+ */
+export declare function disableTeamFraming(): void;
+/**
+ * Set custom pre-prompt text
+ */
+export declare function setCustomPreprompt(preprompt: string): void;
+/**
+ * Set communication channel name
+ */
+export declare function setChannelName(channelName: string): void;
+/**
+ * Get current configuration
+ */
+export declare function getTeamConfig(): TeamFramingConfig;
+/**
+ * Check if team framing is enabled
+ */
+export declare function isTeamFramingEnabled(): boolean;
+export declare const teamFramingTools: {
+    teamMemberPrepromptHook: typeof teamMemberPrepromptHook;
+    runFromCLI: typeof runFromCLI;
+    enableTeamFraming: typeof enableTeamFraming;
+    disableTeamFraming: typeof disableTeamFraming;
+    setCustomPreprompt: typeof setCustomPreprompt;
+    setChannelName: typeof setChannelName;
+    getTeamConfig: typeof getTeamConfig;
+    isTeamFramingEnabled: typeof isTeamFramingEnabled;
+    loadTeamConfig: typeof loadTeamConfig;
+    saveTeamConfig: typeof saveTeamConfig;
+    updateTeamConfig: typeof updateTeamConfig;
+    resetTeamConfig: typeof resetTeamConfig;
+    generateTeamFramingPrompt: typeof generateTeamFramingPrompt;
+    DEFAULT_TEAM_CONFIG: TeamFramingConfig;
+};
+export default teamFramingTools;
+//# sourceMappingURL=teamMemberPrepromptHook.d.ts.map