@pcircle/memesh 2.10.1 → 3.0.0

package/dist/utils/validation.js

@@ -1,87 +0,0 @@
-import { ValidationError } from '../errors/index.js';
-export function validateFiniteNumber(value, name, options) {
-    if (!Number.isFinite(value)) {
-        throw new ValidationError(`${name} must be finite number`, {
-            providedValue: value,
-        });
-    }
-    if (options?.min !== undefined && value < options.min) {
-        throw new ValidationError(`${name} must be >= ${options.min}`, {
-            providedValue: value,
-            min: options.min,
-        });
-    }
-    if (options?.max !== undefined && value > options.max) {
-        throw new ValidationError(`${name} must be <= ${options.max}`, {
-            providedValue: value,
-            max: options.max,
-        });
-    }
-}
-export function validateSafeInteger(value, name) {
-    if (!Number.isSafeInteger(value)) {
-        throw new ValidationError(`${name} must be safe integer`, {
-            providedValue: value,
-            max: Number.MAX_SAFE_INTEGER,
-        });
-    }
-}
-export function validatePercentage(value, name) {
-    validateFiniteNumber(value, name, { min: 0, max: 100 });
-}
-export function validateNormalized(value, name) {
-    validateFiniteNumber(value, name, { min: 0, max: 1 });
-}
-export function validateNonEmptyString(value, name) {
-    if (typeof value !== 'string') {
-        throw new ValidationError(`${name} must be string`, {
-            providedType: typeof value,
-        });
-    }
-    if (value.trim() === '') {
-        throw new ValidationError(`${name} cannot be empty`, {
-            providedValue: value,
-        });
-    }
-}
-export function validateEnum(value, name, allowedValues) {
-    if (!allowedValues.includes(value)) {
-        throw new ValidationError(`Invalid ${name}`, {
-            providedValue: value,
-            allowedValues: [...allowedValues],
-        });
-    }
-}
-export function validateNonEmptyArray(value, name) {
-    if (!Array.isArray(value)) {
-        throw new ValidationError(`${name} must be array`, {
-            providedType: typeof value,
-        });
-    }
-    if (value.length === 0) {
-        throw new ValidationError(`${name} cannot be empty array`, {
-            providedLength: 0,
-        });
-    }
-}
-export function validateObjectSize(value, name, maxChars) {
-    let serialized;
-    try {
-        serialized = JSON.stringify(value);
-    }
-    catch (error) {
-        const reason = error instanceof Error ? error.message : String(error);
-        throw new ValidationError(`${name} cannot be serialized for size validation: ${reason}`, {
-            errorType: error instanceof Error ? error.constructor.name : typeof error,
-            hint: 'The object may contain circular references or non-serializable values (e.g., BigInt)',
-        });
-    }
-    const charCount = serialized.length;
-    if (charCount > maxChars) {
-        throw new ValidationError(`${name} exceeds character limit`, {
-            providedChars: charCount,
-            maxChars: maxChars,
-        });
-    }
-}
-//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/scripts/health-check.js

@@ -1,331 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * MeMesh Plugin Health Check
- *
- * Fast, non-invasive validation of plugin installation.
- * Supports both npm global install and local dev install.
- *
- * Exit codes:
- *   0 - All healthy
- *   1 - Repairable issues found
- *   2 - Fatal error (requires manual intervention)
- */
-
-import { existsSync, readFileSync, lstatSync, realpathSync } from 'fs';
-import { join, dirname } from 'path';
-import { homedir } from 'os';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const projectRoot = join(__dirname, '..');
-
-// Parse CLI flags
-const silent = process.argv.includes('--silent');
-const verbose = process.argv.includes('--verbose');
-const json = process.argv.includes('--json');
-
-/**
- * Detect installation mode based on directory structure.
- * - 'npm-global': installed via npm install -g (dist/ is in package root)
- * - 'dev': running from project source (needs .claude-plugin/memesh/dist/)
- * - 'plugin': installed via /plugin marketplace add (managed by Claude Code)
- */
-function detectInstallMode() {
-  // If dist/mcp/server-bootstrap.js exists at package root, it's npm or plugin install
-  if (existsSync(join(projectRoot, 'dist', 'mcp', 'server-bootstrap.js'))) {
-    // Check if we're inside node_modules (npm global)
-    if (projectRoot.includes('node_modules')) {
-      return 'npm-global';
-    }
-    // Check if src/ exists (dev environment)
-    if (existsSync(join(projectRoot, 'src'))) {
-      return 'dev';
-    }
-    return 'plugin';
-  }
-  // Fallback: dev mode without build
-  return 'dev';
-}
-
-const installMode = detectInstallMode();
-
-/**
- * Health check result structure
- */
-const result = {
-  healthy: true,
-  installMode,
-  issues: [],
-  timestamp: new Date().toISOString(),
-  checks: {
-    dist: false,
-    pluginJson: false,
-    mcpJson: false,
-    hooks: false,
-    marketplace: false,
-    symlink: false,
-    settings: false,
-  }
-};
-
-/**
- * Add an issue to the result
- */
-function addIssue(path, severity, message, repairable = true) {
-  result.issues.push({ path, severity, message, repairable });
-  result.healthy = false;
-  if (!silent && !json) {
-    const icon = severity === 'error' ? '❌' : '⚠️';
-    console.error(`   ${icon} ${path}: ${message}`);
-  }
-}
-
-/**
- * Log success message
- */
-function logSuccess(message) {
-  if (!silent && !json) {
-    if (verbose) {
-      console.log(`   ✅ ${message}`);
-    }
-  }
-}
-
-// ============================================================================
-// Start
-// ============================================================================
-
-if (!silent && !json) {
-  console.log('🔍 Checking MeMesh Plugin installation...\n');
-  console.log(`   Mode: ${installMode}`);
-  console.log(`   Path: ${projectRoot}\n`);
-}
-
-// ============================================================================
-// Check 1: Server bootstrap exists
-// ============================================================================
-
-const serverPath = installMode === 'dev'
-  ? join(projectRoot, '.claude-plugin', 'memesh', 'dist', 'mcp', 'server-bootstrap.js')
-  : join(projectRoot, 'dist', 'mcp', 'server-bootstrap.js');
-
-if (!existsSync(serverPath)) {
-  const hint = installMode === 'dev' ? 'Run: npm run build' : 'Reinstall: npm install -g @pcircle/memesh';
-  addIssue('dist', 'error', `server-bootstrap.js not found at ${serverPath}`, false);
-
-  if (!silent && !json) {
-    console.error(`\n❌ Plugin not built. ${hint}\n`);
-  }
-
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-  }
-
-  process.exit(2);
-} else {
-  result.checks.dist = true;
-  logSuccess('server-bootstrap.js exists');
-}
-
-// ============================================================================
-// Check 2: plugin.json exists and is valid
-// ============================================================================
-
-const pluginJsonPath = join(projectRoot, 'plugin.json');
-
-try {
-  if (!existsSync(pluginJsonPath)) {
-    addIssue('pluginJson', 'error', 'plugin.json not found');
-  } else {
-    const plugin = JSON.parse(readFileSync(pluginJsonPath, 'utf-8'));
-    if (!plugin.name || !plugin.version) {
-      addIssue('pluginJson', 'error', 'plugin.json missing name or version');
-    } else {
-      result.checks.pluginJson = true;
-      logSuccess(`plugin.json valid (${plugin.name} v${plugin.version})`);
-    }
-  }
-} catch (error) {
-  addIssue('pluginJson', 'error', `Failed to parse plugin.json: ${error.message}`);
-}
-
-// ============================================================================
-// Check 3: .mcp.json exists and is valid
-// ============================================================================
-
-const mcpJsonPath = join(projectRoot, '.mcp.json');
-
-try {
-  if (!existsSync(mcpJsonPath)) {
-    addIssue('mcpJson', 'error', '.mcp.json not found');
-  } else {
-    const mcp = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
-    if (!mcp.mcpServers?.memesh) {
-      addIssue('mcpJson', 'error', '.mcp.json missing memesh server definition');
-    } else {
-      result.checks.mcpJson = true;
-      logSuccess('.mcp.json valid');
-    }
-  }
-} catch (error) {
-  addIssue('mcpJson', 'error', `Failed to parse .mcp.json: ${error.message}`);
-}
-
-// ============================================================================
-// Check 4: hooks/hooks.json exists and scripts are present
-// ============================================================================
-
-const hooksJsonPath = join(projectRoot, 'hooks', 'hooks.json');
-
-try {
-  if (!existsSync(hooksJsonPath)) {
-    addIssue('hooks', 'error', 'hooks/hooks.json not found');
-  } else {
-    const hooksConfig = JSON.parse(readFileSync(hooksJsonPath, 'utf-8'));
-    const events = Object.keys(hooksConfig.hooks || {});
-
-    if (events.length === 0) {
-      addIssue('hooks', 'warning', 'No hook events defined');
-    } else {
-      let allScriptsExist = true;
-      for (const event of events) {
-        for (const entry of hooksConfig.hooks[event]) {
-          for (const hook of entry.hooks) {
-            const scriptPath = hook.command.replace('${CLAUDE_PLUGIN_ROOT}', projectRoot);
-            if (!existsSync(scriptPath)) {
-              addIssue('hooks', 'error', `Hook script missing: ${scriptPath}`);
-              allScriptsExist = false;
-            }
-          }
-        }
-      }
-      if (allScriptsExist) {
-        result.checks.hooks = true;
-        logSuccess(`hooks valid (${events.length} events)`);
-      }
-    }
-  }
-} catch (error) {
-  addIssue('hooks', 'error', `Failed to parse hooks.json: ${error.message}`);
-}
-
-// ============================================================================
-// Check 5: Marketplace registration (npm-global and dev modes)
-// ============================================================================
-
-const knownMarketplacesPath = join(homedir(), '.claude', 'plugins', 'known_marketplaces.json');
-
-try {
-  if (!existsSync(knownMarketplacesPath)) {
-    addIssue('marketplace', 'warning', 'known_marketplaces.json not found (plugin may be installed via /plugin command)');
-  } else {
-    const content = readFileSync(knownMarketplacesPath, 'utf-8');
-    const marketplaces = JSON.parse(content);
-
-    if (marketplaces['pcircle-ai']) {
-      result.checks.marketplace = true;
-      logSuccess('Marketplace registered');
-    } else {
-      addIssue('marketplace', 'warning', 'pcircle-ai not in known_marketplaces.json (may be installed via /plugin command)');
-    }
-  }
-} catch (error) {
-  addIssue('marketplace', 'error', `Failed to check marketplace: ${error.message}`);
-}
-
-// ============================================================================
-// Check 6: Symlink or plugin discovery
-// ============================================================================
-
-const symlinkPath = join(homedir(), '.claude', 'plugins', 'marketplaces', 'pcircle-ai');
-
-try {
-  if (!existsSync(symlinkPath)) {
-    addIssue('symlink', 'warning', 'Marketplace symlink not found (may be installed via /plugin command)');
-  } else {
-    const stats = lstatSync(symlinkPath);
-
-    if (stats.isSymbolicLink()) {
-      const target = realpathSync(symlinkPath);
-      if (!existsSync(target)) {
-        addIssue('symlink', 'error', 'Symlink target does not exist (broken symlink)');
-      } else {
-        result.checks.symlink = true;
-        logSuccess(`Symlink valid → ${target}`);
-      }
-    } else if (stats.isDirectory()) {
-      // Could be a direct clone (plugin marketplace install)
-      result.checks.symlink = true;
-      logSuccess('Plugin directory exists (marketplace install)');
-    } else {
-      addIssue('symlink', 'error', 'Marketplace path is not a symlink or directory');
-    }
-  }
-} catch (error) {
-  addIssue('symlink', 'error', `Failed to check symlink: ${error.message}`);
-}
-
-// ============================================================================
-// Check 7: Plugin enabled in settings
-// ============================================================================
-
-const settingsPath = join(homedir(), '.claude', 'settings.json');
-
-try {
-  if (!existsSync(settingsPath)) {
-    addIssue('settings', 'warning', 'settings.json not found');
-  } else {
-    const content = readFileSync(settingsPath, 'utf-8');
-    const settings = JSON.parse(content);
-
-    if (!settings.enabledPlugins) {
-      addIssue('settings', 'warning', 'enabledPlugins not found in settings.json');
-    } else if (!settings.enabledPlugins['memesh@pcircle-ai']) {
-      addIssue('settings', 'warning', 'memesh@pcircle-ai not enabled (may need to enable via /plugin command)');
-    } else if (settings.enabledPlugins['memesh@pcircle-ai'] !== true) {
-      addIssue('settings', 'warning', 'memesh@pcircle-ai is disabled');
-    } else {
-      result.checks.settings = true;
-      logSuccess('Plugin enabled in settings');
-    }
-  }
-} catch (error) {
-  addIssue('settings', 'error', `Failed to check settings: ${error.message}`);
-}
-
-// ============================================================================
-// Summary
-// ============================================================================
-
-if (json) {
-  console.log(JSON.stringify(result, null, 2));
-} else if (!silent) {
-  console.log('\n' + '═'.repeat(60));
-
-  if (result.healthy) {
-    console.log('✅ All checks passed - plugin installation healthy');
-    console.log('═'.repeat(60));
-  } else {
-    const errors = result.issues.filter(i => i.severity === 'error');
-    const warnings = result.issues.filter(i => i.severity === 'warning');
-
-    if (errors.length > 0) {
-      console.log(`❌ Found ${errors.length} error(s), ${warnings.length} warning(s)`);
-    } else {
-      console.log(`⚠️  Found ${warnings.length} warning(s) (non-critical)`);
-    }
-    console.log('═'.repeat(60));
-
-    if (errors.length > 0) {
-      const hint = installMode === 'dev' ? 'npm run build' : 'npm install -g @pcircle/memesh';
-      console.log(`\n🔧 Fix errors first. Try: ${hint}\n`);
-    }
-  }
-}
-
-// Exit: errors → 1 or 2, warnings only → 0
-const hasErrors = result.issues.some(i => i.severity === 'error');
-const hasUnrepairableErrors = result.issues.some(i => i.severity === 'error' && !i.repairable);
-process.exit(hasErrors ? (hasUnrepairableErrors ? 2 : 1) : 0);

package/scripts/hooks/README.md

@@ -1,230 +0,0 @@
-# MeMesh Hooks for Claude Code
-
-**What are these?** Scripts that run automatically when you use Claude Code. They provide memory management, smart routing, code quality enforcement, and planning assistance.
-
-## What They Do
-
-| When | What Happens |
-|------|--------------|
-| **You open Claude Code** | Reloads CLAUDE.md, shows last session recap (cache-first) |
-| **Before a tool runs** | Smart routing, planning template injection, dry-run gate, code review reminder |
-| **After a tool runs** | Tracks work patterns, file modifications, test executions |
-| **You make a git commit** | Saves commit context to knowledge graph (batched) |
-| **A subagent finishes** | Saves code review results, tracks completion |
-| **You close Claude Code** | Saves session summary + cache for fast next startup |
-
-## Installation
-
-```bash
-# Copy hooks to Claude Code
-cp scripts/hooks/*.js ~/.claude/hooks/
-cp -r scripts/hooks/templates/ ~/.claude/hooks/templates/
-chmod +x ~/.claude/hooks/*.js
-```
-
-**Done!** Restart Claude Code to activate.
-
----
-
-## Features
-
-### Smart Router (PreToolUse)
-
-Routes subagent tasks to optimal models and controls background execution.
-
-```
-Task(Explore) → model: haiku (fast search)
-Task(Plan)    → inject SDD+BDD planning template
-Task(heavy)   → check for untested code, warn if found
-```
-
-Configuration: `~/.memesh/routing-config.json`
-
-```json
-{
-  "modelRouting": {
-    "rules": [
-      { "subagentType": "Explore", "model": "haiku", "reason": "Fast search" }
-    ]
-  },
-  "backgroundRules": [
-    { "subagentType": "Explore", "forceBackground": false }
-  ],
-  "planningEnforcement": { "enabled": true },
-  "dryRunGate": { "enabled": true },
-  "auditLog": true
-}
-```
-
-Audit log: `~/.memesh/routing-audit.log`
-
-### Planning Enforcement
-
-When a Plan subagent is dispatched, the hook injects a template requiring:
-- System Design Description (SDD)
-- Behavior-Driven Design (BDD) with Gherkin scenarios
-- Edge case handling table
-- Dry-run test plan
-- Risk assessment
-
-The plan is always presented to the user for approval before implementation.
-
-### Dry-Run Gate
-
-Tracks which files were modified (Write/Edit) and which were tested
-(vitest/jest/tsc/node --check). Before heavy Task dispatches, warns if
-modified files haven't been tested yet.
-
-**Advisory only** — never blocks, just informs.
-
-### Pre-Commit Code Review
-
-```
-git commit detected → Code review done? → Yes → Allow
-                                        → No  → Inject reminder
-```
-
-### Auto-Memory (Batched)
-
-```
-Open Claude Code  →  Work normally  →  Git commit  →  Close Claude Code
-      ↓                    ↓                ↓                 ↓
-Cache-first recall   Track patterns   Batch save to KG   Cache + archive
-(0 SQLite spawns)   (async writes)   (2 spawns vs 8)
-```
-
-### What Gets Tracked
-
-| Symbol | Meaning |
-|--------|---------|
-| 📁 | Files you changed |
-| ✅ | Git commits you made |
-| 💡 | Things you learned |
-| ⚠️ | Problems you ran into |
-| 🎯 | Decisions you made |
-| 🔍 | Code review findings |
-
----
-
-## Troubleshooting
-
-### "Hooks not working"
-
-```bash
-ls ~/.claude/hooks/
-cp scripts/hooks/*.js ~/.claude/hooks/
-```
-
-### "No memory showing"
-
-```bash
-ls ~/.memesh/knowledge-graph.db
-```
-
-### "Routing not applying"
-
-```bash
-# Check config
-cat ~/.memesh/routing-config.json
-
-# Check audit log
-tail -20 ~/.memesh/routing-audit.log
-```
-
-## Limitations
-
-| What | Details |
-|------|---------|
-| **Claude Code only** | Doesn't work in Cursor |
-| **30-day memory** | Old session memories auto-deleted |
-| **Local only** | No sync between computers |
-| **Advisory gates** | Dry-run and review are reminders, not blockers |
-
----
-
-## Files
-
-```
-scripts/hooks/
-├── session-start.js    ← SessionStart: reload CLAUDE.md, cache-first recall
-├── pre-tool-use.js     ← PreToolUse: handler registry (4 handlers)
-│   ├── codeReviewHandler  — git commit review enforcement
-│   ├── routingHandler     — model/background selection
-│   ├── planningHandler    — SDD+BDD template injection
-│   └── dryRunGateHandler  — untested code warning
-├── post-tool-use.js    ← PostToolUse: patterns, file/test tracking, async writes
-├── post-commit.js      ← PostToolUse: batch save commit to KG
-├── subagent-stop.js    ← SubagentStop: capture code review results
-├── stop.js             ← Stop: batch save, cache, archive, cleanup
-├── hook-utils.js       ← Shared: sqliteBatch, async I/O, constants
-├── templates/
-│   └── planning-template.md  ← SDD+BDD+edge case template
-└── __tests__/
-    ├── hook-test-harness.js  ← Test runner (no Claude Code needed)
-    └── hooks.test.js         ← 15 test cases
-```
-
-### Handler Flow (PreToolUse)
-
-```
-PreToolUse event
-  ↓
-┌──────────────────────┐
-│   Handler Registry    │
-│   ├─ codeReview      │ → additionalContext (review reminder)
-│   ├─ routing         │ → updatedInput (model, background)
-│   ├─ planning        │ → updatedInput.prompt (template)
-│   └─ dryRunGate      │ → additionalContext (untested warning)
-└──────────────────────┘
-  ↓
-┌──────────────────────┐
-│   Response Merger     │
-│   • updatedInput: deep-merge
-│   • additionalContext: concatenate
-│   • permissionDecision: most-restrictive
-└──────────────────────┘
-  ↓
-Single JSON → Claude Code
-```
-
----
-
-## Testing
-
-```bash
-# Run all 15 tests
-node scripts/hooks/__tests__/hooks.test.js
-
-# Test individual hook with mock input
-node scripts/hooks/__tests__/hook-test-harness.js pre-tool-use.js \
-  '{"tool_name":"Task","tool_input":{"subagent_type":"Plan","prompt":"test"}}'
-
-# Syntax check all hooks
-for f in scripts/hooks/*.js; do node --check "$f" && echo "OK: $f"; done
-```
-
-## Configuration
-
-### Routing Config (`~/.memesh/routing-config.json`)
-
-| Field | Description |
-|-------|-------------|
-| `modelRouting.rules` | Subagent → model mapping |
-| `backgroundRules` | Subagent → force background |
-| `planningEnforcement.enabled` | Inject SDD+BDD template |
-| `dryRunGate.enabled` | Warn on untested code |
-| `auditLog` | Log routing decisions |
-
-### Thresholds (`hook-utils.js`)
-
-```javascript
-THRESHOLDS = {
-  TOKEN_SAVE: 250_000,
-  RETENTION_DAYS: 30,
-  MAX_ARCHIVED_SESSIONS: 30
-}
-```
-
----
-
-Part of MeMesh project. License: MIT.