@pcircle/memesh 2.10.0 → 2.11.0

package/scripts/hooks/subagent-stop.js

@@ -1,184 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * SubagentStop Hook - Capture Subagent Results to MeMesh Knowledge Graph
- *
- * Triggered when a subagent finishes execution.
- *
- * Features:
- * - Saves code review findings to MeMesh KG (high-value results)
- * - Tracks code review completion for pre-commit enforcement
- * - Updates session state with subagent activity
- * - Silent operation (no console output)
- */
-
-import {
-  STATE_DIR,
-  MEMESH_DB_PATH,
-  readJSONFile,
-  writeJSONFile,
-  sqliteBatchEntity,
-  getDateString,
-  readStdin,
-  logError,
-  logMemorySave,
-} from './hook-utils.js';
-import fs from 'fs';
-import path from 'path';
-
-// ============================================================================
-// Constants
-// ============================================================================
-
-const CURRENT_SESSION_FILE = path.join(STATE_DIR, 'current-session.json');
-
-/** Agent types that count as code review */
-const CODE_REVIEWER_TYPES = [
-  'code-reviewer',
-  'code-review',
-  'superpowers:code-reviewer',
-  'pr-review-toolkit:code-reviewer',
-  'feature-dev:code-reviewer',
-];
-
-// ============================================================================
-// Code Review Detection
-// ============================================================================
-
-/**
- * Check if this subagent is a code reviewer
- * @param {string} agentType - Subagent type identifier
- * @returns {boolean}
- */
-function isCodeReviewer(agentType) {
-  if (!agentType) return false;
-  const lower = agentType.toLowerCase();
-  return CODE_REVIEWER_TYPES.some(t => lower.includes(t.toLowerCase()));
-}
-
-/**
- * Mark code review as done in session state.
- * This flag is checked by pre-tool-use.js before git commits.
- */
-function markCodeReviewDone() {
-  const session = readJSONFile(CURRENT_SESSION_FILE, {});
-  session.codeReviewDone = true;
-  session.codeReviewTimestamp = new Date().toISOString();
-  writeJSONFile(CURRENT_SESSION_FILE, session);
-}
-
-// ============================================================================
-// MeMesh KG Save
-// ============================================================================
-
-/**
- * Save code review results to MeMesh knowledge graph.
- * Only saves code reviewer subagent results (high-value findings).
- *
- * @param {string} agentType - Subagent type
- * @param {string} lastMessage - Agent's final response
- * @returns {boolean} True if saved
- */
-function saveSubagentToKG(agentType, lastMessage) {
-  try {
-    if (!fs.existsSync(MEMESH_DB_PATH)) return false;
-    if (!lastMessage || lastMessage.length < 50) return false;
-
-    // Truncate very long messages
-    const shortMessage = lastMessage.length > 1000
-      ? lastMessage.substring(0, 1000) + '...'
-      : lastMessage;
-
-    const entityName = `Code Review: ${getDateString()} ${Date.now()} ${agentType}`;
-    const metadata = JSON.stringify({
-      agentType,
-      messageLength: lastMessage.length,
-      source: 'subagent-stop-hook',
-    });
-
-    const tags = [
-      'code-review',
-      `agent:${agentType}`,
-      `date:${getDateString()}`,
-      'auto-tracked',
-      'scope:project',
-    ];
-
-    const entityId = sqliteBatchEntity(
-      MEMESH_DB_PATH,
-      { name: entityName, type: 'code_review', metadata },
-      [`[${agentType}] ${shortMessage}`],
-      tags
-    );
-
-    if (entityId === null) return false;
-
-    logMemorySave(`Code review saved: ${agentType} (${lastMessage.length} chars)`);
-    return true;
-  } catch (error) {
-    logError('saveSubagentToKG', error);
-    return false;
-  }
-}
-
-// ============================================================================
-// Session State Update
-// ============================================================================
-
-/**
- * Track subagent activity in session state
- * @param {string} agentType - Subagent type
- */
-function trackSubagentInSession(agentType) {
-  const session = readJSONFile(CURRENT_SESSION_FILE, { subagents: [] });
-  if (!session.subagents) session.subagents = [];
-
-  session.subagents.push({
-    type: agentType,
-    completedAt: new Date().toISOString(),
-  });
-
-  // Keep only last 20 subagent entries
-  if (session.subagents.length > 20) {
-    session.subagents = session.subagents.slice(-20);
-  }
-
-  writeJSONFile(CURRENT_SESSION_FILE, session);
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-async function subagentStop() {
-  try {
-    const input = await readStdin(3000);
-    if (!input || input.trim() === '') {
-      process.exit(0);
-    }
-
-    const data = JSON.parse(input);
-    const agentType = data.agent_type || data.agentType || 'unknown';
-    const lastMessage = data.last_assistant_message || data.lastAssistantMessage || '';
-
-    // Track all subagent completions in session state
-    trackSubagentInSession(agentType);
-
-    // Track code review completion (for pre-commit enforcement)
-    if (isCodeReviewer(agentType)) {
-      markCodeReviewDone();
-    }
-
-    // Save code reviewer results to MeMesh KG (high-value findings)
-    if (isCodeReviewer(agentType) && lastMessage.length > 50) {
-      saveSubagentToKG(agentType, lastMessage);
-    }
-
-    process.exit(0);
-  } catch (error) {
-    logError('SubagentStop', error);
-    process.exit(0); // Never block on hook errors
-  }
-}
-
-subagentStop();

package/scripts/hooks/templates/planning-template.md

@@ -1,46 +0,0 @@
-## Required Plan Sections
-
-Your plan MUST include all of the following sections. Incomplete plans will be rejected.
-
-### 1. System Design Description (SDD)
-- Component architecture and responsibilities
-- Data flow between components
-- Interface contracts (input/output types)
-- Dependencies and integration points
-
-### 2. Behavior-Driven Design (BDD)
-For EACH feature, write Gherkin scenarios:
-
-```gherkin
-Scenario: [descriptive name]
-  Given [precondition]
-  When [action]
-  Then [expected outcome]
-```
-
-Cover: happy path, error path, edge cases.
-
-### 3. Edge Case Handling
-
-| Edge Case | How Handled | Test Coverage |
-|-----------|------------|---------------|
-| [case] | [strategy] | [yes/no] |
-
-Include at minimum: empty input, null/undefined, boundary values, concurrent access, timeout, large data.
-
-### 4. Dry-Run Test Plan
-Before dispatching heavy tasks, verify:
-- [ ] Core function compiles (`tsc --noEmit` or `node --check`)
-- [ ] Unit test for critical path passes
-- [ ] Integration point verified with real call
-- [ ] No regressions in existing tests
-
-### 5. Risk Assessment
-
-| Risk | Probability | Impact | Mitigation |
-|------|------------|--------|------------|
-| [risk] | High/Med/Low | High/Med/Low | [strategy] |
-
----
-
-**IMPORTANT**: After completing this plan, present it to the user and wait for explicit approval before proceeding to implementation. Do NOT auto-execute.

package/scripts/postinstall-lib.js

@@ -1,242 +0,0 @@
-/**
- * Postinstall Library - Core Functions
- *
- * Implements plugin installation logic with backward compatibility
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync, symlinkSync, unlinkSync, copyFileSync, lstatSync, realpathSync } from 'fs';
-import { join, dirname } from 'path';
-import { homedir } from 'os';
-// ============================================================================
-// Environment Detection
-// ============================================================================
-/**
- * Detect install mode (global vs local dev)
- */
-export function detectInstallMode(installPath) {
-    // Check if path contains 'node_modules' - indicates global install
-    if (installPath.includes('node_modules')) {
-        return 'global';
-    }
-    // Check if in project root (has package.json, src/, etc.)
-    const hasPackageJson = existsSync(join(installPath, 'package.json'));
-    const hasSrcDir = existsSync(join(installPath, 'src'));
-    if (hasPackageJson && hasSrcDir) {
-        return 'local';
-    }
-    // Default to global
-    return 'global';
-}
-/**
- * Get plugin install path based on mode
- * @param mode Install mode ('global' or 'local')
- * @param scriptDir Directory where this script is located (for global mode)
- */
-export function getPluginInstallPath(mode, scriptDir) {
-    if (mode === 'local') {
-        // Local dev: current working directory
-        return process.cwd();
-    }
-    // Global: use provided scriptDir or fallback to cwd
-    // For postinstall script, scriptDir will be the scripts/ directory
-    if (scriptDir) {
-        return dirname(scriptDir); // Parent of scripts/ directory
-    }
-    // Fallback: assume we're in the package root
-    return process.cwd();
-}
-// ============================================================================
-// File Utilities
-// ============================================================================
-/**
- * Ensure directory exists
- */
-export function ensureDirectory(path) {
-    if (!existsSync(path)) {
-        mkdirSync(path, { recursive: true });
-    }
-}
-/**
- * Read JSON file safely
- */
-export function readJSONFile(path) {
-    try {
-        if (!existsSync(path)) {
-            return null;
-        }
-        const content = readFileSync(path, 'utf-8').trim();
-        if (!content) {
-            return null;
-        }
-        return JSON.parse(content);
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        process.stderr.write(`[readJSONFile] Failed to parse ${path}: ${msg}\n`);
-        return null;
-    }
-}
-/**
- * Write JSON file
- */
-export function writeJSONFile(path, data) {
-    ensureDirectory(dirname(path));
-    writeFileSync(path, JSON.stringify(data, null, 2) + '\n', 'utf-8');
-}
-/**
- * Backup file with timestamp
- */
-export function backupFile(path) {
-    if (!existsSync(path)) {
-        return null;
-    }
-    const backupPath = `${path}.backup-${Date.now()}`;
-    try {
-        copyFileSync(path, backupPath);
-        return backupPath;
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        process.stderr.write(`[backupFile] Failed to backup ${path}: ${msg}\n`);
-        return null;
-    }
-}
-// ============================================================================
-// Marketplace Registration
-// ============================================================================
-/**
- * Ensure marketplace is registered in known_marketplaces.json
- */
-export async function ensureMarketplaceRegistered(installPath, claudeDir = join(homedir(), '.claude')) {
-    const marketplacesFile = join(claudeDir, 'plugins', 'known_marketplaces.json');
-    const marketplacesDir = join(claudeDir, 'plugins', 'marketplaces');
-    const symlinkPath = join(marketplacesDir, 'pcircle-ai');
-    // Ensure directories exist
-    ensureDirectory(join(claudeDir, 'plugins'));
-    // Read existing marketplaces or create new
-    let marketplaces = readJSONFile(marketplacesFile) || {};
-    // If file exists but parse failed, backup and start fresh
-    if (existsSync(marketplacesFile) && marketplaces === null) {
-        backupFile(marketplacesFile);
-        marketplaces = {};
-    }
-    // Register or update pcircle-ai entry
-    marketplaces['pcircle-ai'] = {
-        source: {
-            source: 'directory',
-            path: installPath
-        },
-        installLocation: symlinkPath,
-        lastUpdated: new Date().toISOString()
-    };
-    // Write back
-    writeJSONFile(marketplacesFile, marketplaces);
-}
-// ============================================================================
-// Symlink Management
-// ============================================================================
-/**
- * Ensure symlink exists and points to correct location
- */
-export async function ensureSymlinkExists(installPath, marketplacesDir) {
-    const symlinkPath = join(marketplacesDir, 'pcircle-ai');
-    // Ensure marketplaces directory exists
-    ensureDirectory(marketplacesDir);
-    // Check if symlink exists
-    if (existsSync(symlinkPath)) {
-        try {
-            // Check if it's a symlink
-            const stats = lstatSync(symlinkPath);
-            if (stats.isSymbolicLink()) {
-                // Check if it points to the correct location
-                const target = realpathSync(symlinkPath);
-                const expectedTarget = realpathSync(installPath);
-                if (target === expectedTarget) {
-                    // Symlink correct, nothing to do
-                    return;
-                }
-                // Points to wrong location, remove and recreate
-                unlinkSync(symlinkPath);
-            }
-            else {
-                // Not a symlink, remove it
-                unlinkSync(symlinkPath);
-            }
-        }
-        catch (error) {
-            // Error reading symlink, try to remove and recreate
-            try {
-                unlinkSync(symlinkPath);
-            }
-            catch {
-                // Ignore errors
-            }
-        }
-    }
-    // Create symlink
-    try {
-        symlinkSync(installPath, symlinkPath, 'dir');
-    }
-    catch (error) {
-        throw new Error(`Failed to create symlink: ${error.message}`);
-    }
-}
-// ============================================================================
-// Plugin Enablement
-// ============================================================================
-/**
- * Ensure plugin is enabled in settings.json
- */
-export async function ensurePluginEnabled(claudeDir = join(homedir(), '.claude')) {
-    const settingsFile = join(claudeDir, 'settings.json');
-    // Read existing settings or create new
-    let settings = readJSONFile(settingsFile) || {};
-    // Ensure enabledPlugins object exists
-    if (!settings.enabledPlugins) {
-        settings.enabledPlugins = {};
-    }
-    // Enable memesh plugin
-    settings.enabledPlugins['memesh@pcircle-ai'] = true;
-    // Write back
-    writeJSONFile(settingsFile, settings);
-}
-// ============================================================================
-// Backward Compatibility
-// ============================================================================
-/**
- * Detect and fix legacy installations.
- * Only fixes marketplace, symlink, and plugin enablement.
- * MCP and hooks are handled by the plugin system via .mcp.json and hooks/hooks.json.
- */
-export async function detectAndFixLegacyInstall(installPath, claudeDir = join(homedir(), '.claude')) {
-    const marketplacesFile = join(claudeDir, 'plugins', 'known_marketplaces.json');
-    const symlinkPath = join(claudeDir, 'plugins', 'marketplaces', 'pcircle-ai');
-    // Check if marketplace registered
-    const marketplaces = readJSONFile(marketplacesFile);
-    const hasMarketplace = marketplaces && marketplaces['pcircle-ai'];
-    // Check if symlink exists
-    const hasSymlink = existsSync(symlinkPath);
-    // If everything is correct, return ok
-    if (hasMarketplace && hasSymlink) {
-        return 'ok';
-    }
-    // Legacy installation detected - fix it
-    // Fix marketplace
-    if (!hasMarketplace) {
-        await ensureMarketplaceRegistered(installPath, claudeDir);
-    }
-    // Fix symlink
-    if (!hasSymlink) {
-        await ensureSymlinkExists(installPath, join(claudeDir, 'plugins', 'marketplaces'));
-    }
-    // Fix plugin enablement
-    await ensurePluginEnabled(claudeDir);
-    // Clean up legacy MCP config if it exists (plugin system handles MCP now)
-    const mcpSettingsFile = join(claudeDir, 'mcp_settings.json');
-    const mcpSettings = readJSONFile(mcpSettingsFile);
-    if (mcpSettings?.mcpServers?.memesh || mcpSettings?.mcpServers?.['claude-code-buddy']) {
-        delete mcpSettings.mcpServers.memesh;
-        delete mcpSettings.mcpServers['claude-code-buddy'];
-        writeJSONFile(mcpSettingsFile, mcpSettings);
-    }
-    return 'fixed';
-}

package/scripts/postinstall-new.js

@@ -1,191 +0,0 @@
-#!/usr/bin/env node
-/**
- * Post-install script for MeMesh Plugin
- *
- * Following official Claude Code Plugin spec:
- * - MCP servers: handled by plugin system via .mcp.json
- * - Hooks: handled by plugin system via hooks/hooks.json
- * - Skills: auto-discovered by plugin system from skills/
- *
- * This script only does:
- * 1. Detect install mode (global/local)
- * 2. Register marketplace
- * 3. Create symlink
- * 4. Enable plugin
- * 5. Fix legacy installations
- */
-
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { homedir } from 'os';
-import chalk from 'chalk';
-import boxen from 'boxen';
-
-// Get directory path in ESM
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Import functions from postinstall-lib.js
-import {
-  detectInstallMode,
-  getPluginInstallPath,
-  ensureMarketplaceRegistered,
-  ensureSymlinkExists,
-  ensurePluginEnabled,
-  detectAndFixLegacyInstall
-} from './postinstall-lib.js';
-
-// ============================================================================
-// Main Installation Flow
-// ============================================================================
-
-async function main() {
-  console.log(chalk.cyan('\n🚀 MeMesh Plugin Installation Starting...\n'));
-
-  const results = {
-    mode: null,
-    installPath: null,
-    marketplace: false,
-    symlink: false,
-    pluginEnabled: false,
-    legacyFixed: null,
-    errors: []
-  };
-
-  try {
-    // Step 1: Detect install mode
-    // Pass __dirname to getPluginInstallPath for global mode detection
-    const installPath = getPluginInstallPath('global', __dirname);
-    const mode = detectInstallMode(installPath);
-    results.mode = mode;
-    results.installPath = installPath;
-
-    console.log(chalk.dim(`  Mode: ${mode}`));
-    console.log(chalk.dim(`  Path: ${installPath}\n`));
-
-    const claudeDir = join(homedir(), '.claude');
-    const marketplacesDir = join(claudeDir, 'plugins', 'marketplaces');
-
-    // Step 2: Marketplace Registration
-    try {
-      await ensureMarketplaceRegistered(installPath, claudeDir);
-      results.marketplace = true;
-      console.log(chalk.green('  ✅ Marketplace registered'));
-    } catch (error) {
-      results.errors.push(`Marketplace: ${error.message}`);
-      console.log(chalk.yellow(`  ⚠️  Marketplace registration failed (non-fatal)`));
-    }
-
-    // Step 3: Symlink Creation
-    try {
-      await ensureSymlinkExists(installPath, marketplacesDir);
-      results.symlink = true;
-      console.log(chalk.green('  ✅ Symlink created'));
-    } catch (error) {
-      results.errors.push(`Symlink: ${error.message}`);
-      console.log(chalk.yellow(`  ⚠️  Symlink creation failed (non-fatal)`));
-    }
-
-    // Step 4: Plugin Enablement
-    try {
-      await ensurePluginEnabled(claudeDir);
-      results.pluginEnabled = true;
-      console.log(chalk.green('  ✅ Plugin enabled'));
-    } catch (error) {
-      results.errors.push(`Plugin Enable: ${error.message}`);
-      console.log(chalk.yellow(`  ⚠️  Plugin enablement failed (non-fatal)`));
-    }
-
-    // Step 5: Legacy Installation Fix
-    try {
-      const legacyStatus = await detectAndFixLegacyInstall(installPath, claudeDir);
-      results.legacyFixed = legacyStatus;
-
-      if (legacyStatus === 'fixed') {
-        console.log(chalk.green('  ✅ Legacy installation upgraded'));
-      } else if (legacyStatus === 'ok') {
-        console.log(chalk.dim('  ℹ️  No legacy issues detected'));
-      }
-    } catch (error) {
-      console.log(chalk.dim('  ℹ️  Legacy check skipped'));
-    }
-
-  } catch (error) {
-    console.error(chalk.red('\n❌ Installation failed:'), error.message);
-    console.error(chalk.yellow('\n💡 You can configure manually (see instructions below)\n'));
-  }
-
-  // ============================================================================
-  // Display Installation Summary
-  // ============================================================================
-
-  const allSuccess = results.marketplace && results.symlink && results.pluginEnabled;
-
-  const statusIcon = allSuccess ? '✅' : (results.errors.length > 0 ? '⚠️' : '✅');
-  const statusText = allSuccess
-    ? chalk.green('Installation Complete!')
-    : chalk.yellow('Installation completed with warnings');
-
-  const message = `
-${chalk.bold(statusIcon + '  ' + statusText)}
-
-${chalk.bold('Installation Summary:')}
-  ${results.marketplace ? '✅' : '⚠️'}  Marketplace: ${results.marketplace ? 'Registered' : 'Failed'}
-  ${results.symlink ? '✅' : '⚠️'}  Symlink: ${results.symlink ? 'Created' : 'Failed'}
-  ${results.pluginEnabled ? '✅' : '⚠️'}  Plugin: ${results.pluginEnabled ? 'Enabled' : 'Failed'}
-
-${chalk.bold('Plugin Components (auto-managed by Claude Code):')}
-  ${chalk.cyan('•')} MCP Server: 8 tools (persistent memory, semantic search, task routing)
-  ${chalk.cyan('•')} Hooks: 6 auto-hooks (session recall, commit tracking, smart routing)
-  ${chalk.cyan('•')} Skills: Comprehensive code review
-  ${chalk.cyan('•')} Vector semantic search with ONNX embeddings (runs 100% locally)
-  ${chalk.cyan('•')} Auto-relation inference in knowledge graph
-
-${chalk.bold('Next Steps:')}
-  ${chalk.yellow('1.')} ${chalk.bold('Restart Claude Code')}
-     Completely quit and reopen to load the plugin
-
-  ${chalk.yellow('2.')} ${chalk.bold('Verify Installation')}
-     Run: ${chalk.cyan('node scripts/health-check.js')}
-
-  ${chalk.yellow('3.')} ${chalk.bold('Test MeMesh Tools')}
-     Ask Claude: ${chalk.italic('"List available MeMesh tools"')}
-
-${chalk.bold('Documentation:')}
-  ${chalk.cyan('•')} User Guide: ${chalk.underline('https://github.com/PCIRCLE-AI/claude-code-buddy/blob/main/docs/USER_GUIDE.md')}
-  ${chalk.cyan('•')} Commands: ${chalk.underline('https://github.com/PCIRCLE-AI/claude-code-buddy/blob/main/docs/COMMANDS.md')}
-
-${results.errors.length > 0 ? chalk.yellow('\n⚠️  Warnings:\n  ' + results.errors.join('\n  ')) : ''}
-
-${chalk.dim('Need help? Open an issue: https://github.com/PCIRCLE-AI/claude-code-buddy/issues')}
-`;
-
-  console.log(
-    boxen(message, {
-      padding: 1,
-      margin: 1,
-      borderStyle: 'round',
-      borderColor: allSuccess ? 'green' : 'yellow',
-    })
-  );
-
-  // Exit with appropriate code
-  // Critical failures (plugin registration) → exit 1
-  // Non-critical failures (symlink already exists) → exit 0
-  const hasCriticalFailure = !results.marketplace && !results.symlink;
-  const hasPluginFailure = !results.pluginEnabled;
-  if (hasCriticalFailure || hasPluginFailure) {
-    process.exit(1);
-  }
-  process.exit(0);
-}
-
-// ============================================================================
-// Execute
-// ============================================================================
-
-main().catch((error) => {
-  console.error(chalk.red('\n💥 Fatal error during installation:'));
-  console.error(error);
-  process.exit(1);
-});