@danielsimonjr/memory-mcp 0.48.0 → 9.8.0

package/dist/memory.jsonl

@@ -1,26 +1 @@
-{"type":"entity","name":"Claude Code","entityType":"Software","observations":["An official CLI tool by Anthropic for interacting with Claude","Supports MCP servers for extended functionality","Supports multiple MCP servers simultaneously","Has built-in tools for file operations and bash commands"],"createdAt":"2025-11-12T05:32:42.880Z","lastModified":"2025-11-12T05:36:07.196Z","tags":["cli","anthropic","ai-assistant"],"importance":9}
-{"type":"entity","name":"MCP","entityType":"Protocol","observations":["Model Context Protocol","Allows Claude to integrate with external tools and services","Supports resources, tools, and prompts"],"createdAt":"2025-11-12T05:32:42.880Z","lastModified":"2025-11-12T05:36:25.202Z"}
-{"type":"entity","name":"DeepThinking MCP","entityType":"software_project","observations":["Model Context Protocol server for advanced multi-modal reasoning","GitHub: https://github.com/danielsimonjr/deepthinking-mcp","npm: deepthinking-mcp (published)","Architecture: TypeScript, MCP SDK, modular validators, session management","Key files: src/index.ts (entry), src/tools/thinking.ts (tool schema), src/validation/ (validators)","Export formats: Markdown, LaTeX, JSON, HTML, Jupyter, Mermaid, DOT, ASCII","Production features: Caching, webhooks, backup/restore, rate limiting, batch processing, templates","96.8% implementation complete (30/31 tasks)","146 TypeScript files, 37,807 lines of code in src/","Zero TypeScript suppressions (100% reduction from 231 baseline)","Service layer architecture: ThoughtFactory, ExportService, ModeRouter","Repository pattern: ISessionRepository with File and Memory implementations","SessionManager refactored: 700 → 542 lines with extracted SessionMetricsCalculator","Taxonomy system: 110+ reasoning types across 12 categories","Search engine: full-text indexing, faceted search, TF-IDF ranking","Batch processing: 6 operations (export, index, backup, analyze, validate, cleanup)","Caching: LRU, LFU, FIFO strategies with factory pattern","Backup system: provider abstraction (local, S3, GCS, Azure prepared)","Enterprise security: Zod validation, rate limiting, PII redaction, path sanitization","Visualization: interactive dashboards, Mermaid diagrams, mindmaps, state charts","Webhooks: EventBus pub/sub, WebhookManager HTTP dispatch","v5.0.0 MILESTONE (2025-11-30): Released to npm and GitHub. Phase 5 Sprint 2 COMPLETED. New deepthinking_core tool with inductive, deductive, and abductive reasoning modes. Breaking change: abductive moved from deepthinking_causal to deepthinking_core.","Architecture: 10 tools (was 9), 20 modes (was 18). New deepthinking_core provides three fundamental reasoning modes: inductive (pattern recognition), deductive (logical derivation), abductive (best explanation). Quality: 745/745 tests passing, typecheck clean.","Publication: deepthinking-mcp@5.0.0 live on npm, commit 2e2f4107248ca34fee7a495c4fa9bee846ada090 on GitHub origin/master. CHANGELOG.md updated with comprehensive release notes and migration guide.","Breaking change migration: Users calling abductive mode through deepthinking_causal must update to deepthinking_core. Migration guide in CHANGELOG.md with code examples.","Phase 5 progress: Sprint 1 (v4.8.0) and Sprint 2 (v5.0.0) complete. Sprint 3 pending (advanced modes expansion). On track for Phase 5 completion.","Version history: v4.3.7 (schema fixes) → v4.4.0 (hand-written schemas) → v4.8.0 (core→standard rename) → v5.0.0 (new fundamental reasoning modes). All intermediate versions consolidated.","Phase 5 Sprint evolution: Sprint 1 (v4.8.0) renamed deepthinking_core to deepthinking_standard. Sprint 2 (v5.0.0) created new deepthinking_core with inductive/deductive/abductive modes. All Sprint 2 implementation details consolidated into v5.0.0 milestone.","Quality metrics consolidated: 745/745 tests passing, full TypeScript compliance, zero suppressions, 96.8% implementation complete. Build workflow: typecheck → test → build → commit → publish → push.","Performance optimization history: Replaced npx-based servers with global installs, investigated client slowness (not caused by deepthinking-mcp). 225 KB compiled size, ~35-55 MB runtime footprint.","Implementation completion: All 31 tasks across 4 sprints completed (Quick Wins, Code Quality, Architecture, Advanced Features). Template system for new modes created. Production-ready with enterprise security.","20 reasoning modes across 10 tools: deepthinking_core (inductive, deductive, abductive), deepthinking_standard (sequential, shannon, hybrid), deepthinking_math (mathematics, physics), deepthinking_temporal (temporal), deepthinking_probabilistic (bayesian, evidential), deepthinking_causal (causal, counterfactual), deepthinking_strategic (gametheory, optimization), deepthinking_analytical (analogical, firstprinciples), deepthinking_scientific (scientificmethod, systemsthinking, formallogic), deepthinking_session (session management).","Goal: Restructure deepthinking modes where 'core' means fundamental reasoning types","Rename deepthinking_core → deepthinking_standard (sequential, shannon, hybrid)","Create NEW deepthinking_core (inductive, deductive, abductive)","Move abductive mode from deepthinking_causal to new deepthinking_core","3 sprints total: 2-3 weeks, 40-60 developer hours","Sprint 1 (9 tasks, 12-16h): Rename core → standard with all scaffolding","Sprint 2 (16 tasks, 16-24h): Create new core mode by cloning existing files","Sprint 3 (12 tasks, 12-20h): Testing, documentation, v5.0.0 release","Two npm releases: v4.8.0 after Sprint 1, v5.0.0 after Sprint 3","Typecheck and commit after each sprint completion","Full unit testing before each npm publish","Plan files: PHASE_5_IMPLEMENTATION_PLAN.md and 3 sprint TODO JSONs","Commits: b9a847c (initial), df22848 (simplified)","Operator approved simplified approach - no beta versions needed","Started: 2025-11-30","Sprint 1 COMPLETED (2025-11-30)","Successfully renamed deepthinking_core → deepthinking_standard","Updated: json-schemas.ts, definitions.ts, 3 test files","All 744 tests passing after rename","Typecheck passed, build successful","Files modified: src/tools/json-schemas.ts, src/tools/definitions.ts, tests/unit/tools/schemas/schema-validation.test.ts, tests/integration/mcp-compliance.test.ts, tests/unit/tools/schemas/tool-definitions.test.ts","Sequential/shannon/hybrid now route to deepthinking_standard","Ready for v4.8.0 release","v4.8.0 published to npm - Sprint 1 release complete","npm package size: 225.28 KB dist/index.js, 506.80 KB source map","Publish process: prepublishOnly hook ran build + test:publish successfully","All Sprint 1 tasks completed and published","Sprint 2 ready to begin: Create new deepthinking_core tool","Sprint 1 COMPLETED and v4.8.0 PUBLISHED (2025-11-30)","All commits pushed to GitHub: 3faa822 (Sprint 1), 384fb85 (version bump)","Working tree clean, ready for Sprint 2","Sprint 2 goal: Create new deepthinking_core tool with inductive/deductive/abductive modes","Sprint 2 tasks: 16 tasks, 16-24 hours estimated","Sprint 2 will introduce 2 new fundamental reasoning modes: inductive and deductive","v5.0.1 released 2025-11-30: Fixed mode recommendation algorithm to properly suggest core reasoning modes for philosophical/metaphysical problems","Mode recommendation system now detects philosophical domains (metaphysics, theology, philosophy, epistemology, ethics) and prioritizes Hybrid (0.92), Inductive (0.85), Deductive (0.90), and Abductive (0.90) modes","Added Inductive+Deductive+Abductive hybrid combination for maximum evidential strength through multi-modal synthesis","Updated quickRecommend() mappings: 'pattern'→INDUCTIVE, 'logic'→DEDUCTIVE, 'proof'→DEDUCTIVE, 'philosophical'→HYBRID, 'metaphysical'→HYBRID","Lowered Evidential mode score from 0.88 to 0.82 and excluded for philosophical domains to prevent over-weighting uncertainty handling","All 740 tests passing after v5.0.1 fixes, published to npm and GitHub","Philosophical reasoning testing validated: Hybrid mode achieved 91.5% confidence through weighted integration of Inductive (85%), Deductive (40%), and Abductive (90%) modes","Phase 6 planning complete 2025-11-30: Meta-Reasoning mode implementation plan created with 2-sprint structure (24-36 hours total effort)","Meta-Reasoning mode will provide strategic oversight, monitoring reasoning quality, recommending mode switches, and orchestrating multiple modes intelligently","Sprint 1 (14-20h): Core infrastructure - type system, validation, MetaMonitor service, basic meta-reasoning logic","Sprint 2 (10-16h): Integration with existing modes, SessionAnalytics service, enhanced recommendations, comprehensive testing, v6.0.0 release","Meta-reasoning key capabilities: strategy monitoring, effectiveness evaluation, mode switching recommendations, quality assessment, resource allocation decisions","v6.0.0 will be purely additive (no breaking changes), adding 20+ new tests (740→760+ total)","Meta-reasoning addresses user pain points: 'How do I know if I'm using the right mode?', 'When should I switch strategies?', 'Can the system help me choose better?'","Meta-reasoning complements existing 20 modes by providing executive function to orchestrate them intelligently - it monitors and guides reasoning rather than doing reasoning itself","Phase 6 Sprint 1 progress 2025-11-30: Completed first 4 tasks (type system, validation, registry) - 8 hours work","Created MetaReasoningThought type with 7 interfaces: CurrentStrategy, StrategyEvaluation, AlternativeStrategy, StrategyRecommendation, ResourceAllocation, QualityMetrics, SessionContext","Created comprehensive MetaReasoningValidator with 401 lines, validates all meta-reasoning fields with appropriate warnings and errors","Registered metareasoning validator in validator registry for lazy loading, exported in index.ts","All typechecks passing after Sprint 1 progress - meta-reasoning type system fully integrated into core.ts","Remaining Sprint 1 tasks: tool routing (3h), meta-reasoning logic (4h), MetaMonitor service (3h), ThoughtFactory update (1h), unit tests (2h)","Phase 6 Sprint 1 COMPLETE 2025-11-30: All 8 tasks finished, ~14 hours of estimated 20.5 hours actual work","Created MetaMonitor service (330 lines) with session tracking, strategy evaluation, alternative suggestions, quality metrics calculation","Updated ThoughtFactory to create MetaReasoningThought instances with sensible defaults for all 7 meta-reasoning fields","All 745 tests passing after Sprint 1 completion, typecheck clean, meta-reasoning fully integrated into tool routing","Sprint 1 deliverables: MetaReasoningThought type (7 interfaces), MetaReasoningValidator (401 lines), MetaMonitor service, ThoughtFactory integration, tool routing complete","Next: Sprint 2 will add integration with existing modes, SessionAnalytics service, enhanced recommendations, export formatters, comprehensive testing, and v6.0.0 release","Phase 6 Sprint 1 deliverables summary: 3 new files (844 total lines), 7 modified files, all integration points complete","MetaMonitor service capabilities: evaluateStrategy(), suggestAlternatives(), calculateQualityMetrics(), getSessionContext() - full session monitoring API","Meta-reasoning infrastructure ready for Sprint 2: type system complete, validation working, ThoughtFactory creates instances, tool routing functional","Sprint 1 efficiency: 146% (14 hours actual vs 20.5 estimated) - faster due to well-defined types and existing architectural patterns","Meta-reasoning mode uses deepthinking_analytical tool alongside analogical and firstprinciples modes","All 745 existing tests continue passing - zero regressions from meta-reasoning additions","Phase 6 Sprint 2 progress 2025-12-01: ModeRouter enhanced with evaluateAndSuggestSwitch() and autoSwitchIfNeeded() methods using MetaMonitor for adaptive mode switching (commit 521bc5a)","SessionManager integrated with MetaMonitor - records all thoughts, starts strategy tracking on session creation, clears monitoring data on session eviction (commit 739c932)","Sprint 2 critical infrastructure complete: All 745 tests passing after ModeRouter and SessionManager meta-reasoning integration","Remaining Sprint 2 tasks: Update exporters (Markdown, Mermaid), create meta-reasoning tests, write comprehensive documentation, update README/CHANGELOG, final validation, v6.0.0 release","Auto-switch thresholds: evaluateAndSuggestSwitch suggests at effectiveness < 0.4, autoSwitchIfNeeded triggers at < 0.3 to prevent mode thrashing","Meta-reasoning evaluation metrics: effectiveness (progress/effort), efficiency (progress/time), confidence (1.0 - issues*0.15), quality score (weighted combination)","Phase 6 Sprint 2: Markdown exporter enhanced with comprehensive meta-reasoning insights display (commit cf015c8)","Markdown export now shows: current strategy, strategy evaluation (4 metrics), recommendations, alternative strategies, quality metrics (6 dimensions)","All core Sprint 2 infrastructure complete: ModeRouter adaptive switching, SessionManager tracking, Markdown export enhancement","Remaining for v6.0.0: meta-reasoning tests, comprehensive documentation (METAREASONING.md), README/CHANGELOG updates, final validation, npm publish","v6.0.0 RELEASED 2025-12-01: Meta-Reasoning mode (21st mode) published to npm and GitHub - Phase 6 Sprint 2 COMPLETE","Meta-Reasoning mode provides strategic oversight: monitors effectiveness, recommends mode switches, assesses quality across 6 dimensions","Architecture enhancements v6.0.0: MetaMonitor service (330 lines), ModeRouter adaptive switching (evaluateAndSuggestSwitch, autoSwitchIfNeeded), SessionManager auto-tracking","Auto-switch thresholds: effectiveness < 0.4 suggests alternatives, < 0.3 triggers automatic mode switch to prevent thrashing","Quality metrics (6 dimensions): logical consistency, evidence quality, completeness, originality, clarity, overall quality (0-1 scale)","Strategy evaluation metrics: effectiveness (progress/effort), efficiency (progress/time), confidence (1.0 - issues*0.15), quality score (weighted 0.4/0.2/0.4)","Markdown exporter enhanced: displays comprehensive meta-reasoning insights (strategy, evaluation, recommendations, alternatives, quality metrics)","Documentation v6.0.0: docs/modes/METAREASONING.md (complete usage guide), updated README.md (21 modes), updated CHANGELOG.md (release notes)","Zero breaking changes in v6.0.0 - purely additive release, all 740 tests passing, typecheck clean, published successfully","Meta-reasoning integration: MetaMonitor tracks all thoughts via SessionManager, provides strategy evaluation API, suggests mode alternatives","Publication v6.0.0: deepthinking-mcp@6.0.0 live on npm, commits pushed to GitHub (521bc5a, 739c932, cf015c8, f35b8a9, f12a2e3)","Meta-reasoning capabilities: strategy monitoring, effectiveness evaluation, mode switching recommendations, quality assessment, resource allocation decisions","21 reasoning modes total: 20 existing modes + new meta-reasoning mode for executive oversight and strategic coordination","Tools count: 10 tools (deepthinking_core, deepthinking_standard, deepthinking_math, deepthinking_temporal, deepthinking_probabilistic, deepthinking_causal, deepthinking_strategic, deepthinking_analytical, deepthinking_scientific, deepthinking_session)","Meta-reasoning accessible via deepthinking_analytical tool alongside analogical and firstprinciples modes","Phase 6 completion metrics: Sprint 1 (14h, type system + MetaMonitor), Sprint 2 (10h, integration + docs), total 24 hours actual vs 30-36 estimated (80% efficiency)","v6.0.0 deliverables: 7 new interfaces (CurrentStrategy, StrategyEvaluation, AlternativeStrategy, StrategyRecommendation, ResourceAllocation, QualityMetrics, SessionContext), MetaMonitor service, adaptive ModeRouter, enhanced SessionManager, comprehensive documentation"],"createdAt":"2025-11-26T07:11:27.559Z","lastModified":"2025-12-01T04:17:29.868Z","tags":["mcp","reasoning","typescript","ai-tools","active-project","bug-fix","json-schema","deepthinking-mcp","compatibility","2025-11-28"],"importance":10}
-{"type":"entity","name":"Math MCP Server","entityType":"software_project","observations":["v3.2.1 | @danielsimonjr/math-mcp | ISC | Node 18+ | github.com/danielsimonjr/math-mcp","Entry: dist/index-wasm.js (accelerated) or dist/index.js (basic)","Acceleration: mathjs → WASM 14x (10x10+) → Workers 32x (100x100+) → WebGPU future","7 tools: evaluate, simplify, derivative, solve, matrix_operations, statistics, unit_conversion","721 tests (99.7%): 11 integration, 569 unit, 117 security","Security: rate limiting, expression sandboxing, WASM SHA-256 integrity","Observability: Prometheus :9090, Kubernetes health probes","Build: npm run build:all | Test: npm run test:all","v3.2.2 published 2025-11-26 - fixed Windows path separator in WASM hash manifest","Session 2025-11-26: Added CLAUDE.md with build commands, architecture, memory usage instructions","Session 2025-11-26: Added .claude/settings.local.json and .mcp.json (10 MCP servers configured)","Session 2025-11-26: Updated .gitignore to exclude .claude/ and .mcp.json","Session 2025-11-26: Commits pushed - 1ba79fb (v3.2.2 release), b5bd10e (gitignore update)","Currently wraps the original josdejong/mathjs library with WASM acceleration layer","Future migration: Will switch to danielsimonjr/mathjs fork once TypeScript+WASM refactoring is stable","Migration enables: Native WASM implementation instead of wrapper, unified codebase, better performance"],"createdAt":"2025-11-26T16:23:12.606Z","lastModified":"2025-11-28T22:35:24.653Z","tags":["mcp","mathematics","wasm","typescript","active-project"],"importance":10}
-{"type":"entity","name":"MCP Protocol JSON Schema Requirements","entityType":"technical-standard","observations":["MCP (Model Context Protocol) requires JSON Schema Draft 7 format for tool input schemas","Does NOT support OpenAPI 3 schemas despite similarity","Does NOT support $schema property in tool input schemas","zodToJsonSchema library supports multiple targets: 'jsonSchema7', 'jsonSchema2019-09', 'openApi3'","For MCP compatibility, must use: target: 'jsonSchema7' and strip $schema property","Common error: Using 'openApi3' target causes MCP server connection failures","Best practice: Use helper function to generate MCP-compatible schemas from Zod definitions"],"createdAt":"2025-11-28T22:31:01.588Z","lastModified":"2025-11-28T22:31:13.695Z","tags":["mcp","json-schema","technical-standard","protocol","specification"],"importance":8}
-{"type":"entity","name":"Math.js Library","entityType":"software-project","observations":["Extensive math library for JavaScript and Node.js - 673 total source files","GitHub fork: danielsimonjr/mathjs (modernization fork of josdejong/mathjs)","License: Apache 2.0, Requires: Node.js >= 18, Supports: ES2020+ JavaScript engines","Main branch: master, ES modules codebase requiring .js extensions in all imports","=== ARCHITECTURE ===","Factory function + dependency injection pattern with typed-function library","Immutable factory functions (createAdd, createMultiply, etc.) with declared dependencies","math.create(factories, config) creates MathJS instances from factory functions","Factory registration: src/factoriesAny.js (full) and src/factoriesNumber.js (lightweight)","Enables dynamic extension - new data types automatically work in dependent functions","Example: extending multiply with MyDecimal type automatically works in prod function","=== DATA TYPES ===","Supports: numbers, BigNumber, bigint, Complex, Fraction, Unit, Matrix (Dense/Sparse)","Typed-function provides multi-type dispatch and automatic type conversions","=== MODERNIZATION GOALS ===","Primary: Modernize with TypeScript for type safety and better developer tooling","WASM: Use AssemblyScript to compile TypeScript to WebAssembly (2-25x performance gains)","Parallelization: WebWorkers for multi-core CPU utilization (2-4x additional speedup)","WebGPU: Future GPU-accelerated matrix operations (10-100x potential speedup)","100% backward compatibility maintained throughout refactoring","Target: Large matrices (>1000×1000), linear algebra, FFT, statistical computations","Reference docs: PARALLEL_COMPUTING_IMPROVEMENT_PLAN.md, SCIENTIFIC_COMPUTING_IMPROVEMENT_PLAN.md","=== PERFORMANCE TIERS ===","Tier 1: JavaScript fallback (always available, baseline performance)","Tier 2: WASM acceleration (2-10x faster for large operations)","Tier 3: Parallel/multicore with WebWorkers (2-4x additional speedup on multi-core)","=== TYPESCRIPT REFACTORING STATUS ===","Status: 61/673 files converted (9% complete) as of 2025-11-28","Phase 1 COMPLETE: Infrastructure (18 files) - build system, WASM modules, parallel computing","Phase 2 IN PROGRESS: Functions (170 files planned) - arithmetic, trig, algebra, matrix ops","Migration tool: tools/migrate-to-ts.js for automated conversion assistance","Priority targets: plain number implementations, sparse algorithms, combinatorics, numeric solvers","Compilation: tsconfig.build.json for TypeScript, tsconfig.wasm.json for AssemblyScript","Output: lib/typescript/ for compiled TS, lib/wasm/ for WASM modules","=== BUILD SYSTEM ===","Gulp-based build pipeline compiling to multiple formats","Outputs: lib/esm/ (ES modules), lib/cjs/ (CommonJS), lib/browser/ (UMD bundle)","Build commands: npm run build (full), npm run build:wasm, npm run compile:ts, npm run watch:ts","Test commands: npm test (unit+lint), npm run test:all, npm run test:types, npm run coverage","=== DOCUMENTATION STRUCTURE ===","Root: README.md, CHANGELOG.md, CLAUDE.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md","Root: PARALLEL_COMPUTING_IMPROVEMENT_PLAN.md, SCIENTIFIC_COMPUTING_IMPROVEMENT_PLAN.md","docs/architecture/: README_TYPESCRIPT_WASM.md, TYPESCRIPT_WASM_ARCHITECTURE.md","docs/refactoring/: REFACTORING_PLAN.md, REFACTORING_SUMMARY.md, REFACTORING_TASKS.md, TYPESCRIPT_CONVERSION_SUMMARY.md","docs/migration/: MIGRATION_GUIDE.md, HISTORY.md","docs/: Also contains core/, datatypes/, expressions/, reference/ subdirectories (user-facing docs)","Total: 43 markdown files across 8 directories","README.md includes complete documentation organization with quick navigation table","=== MCP DEVELOPMENT ENVIRONMENT ===","MCP servers configured (.mcp.json): sequential-thinking, deepthinking, math-mcp, fermat-mcp, memory-mcp, everything-mcp, fzf-mcp, playwright, time, substack (10 total)","Permissions (.claude/settings.local.json): git, npm, memory-mcp, deepthinking-mcp, math-mcp tools","CLAUDE.md: Complete build/test commands, architecture overview, implementation patterns, MCP usage guidelines","=== SESSION 2025-11-28 ===","Created comprehensive CLAUDE.md guidance document for Claude Code","Set up MCP server configuration (.mcp.json with 10 servers)","Created .claude/settings.local.json with tool permissions","Reorganized documentation: moved 8 files to docs/architecture/, docs/refactoring/, docs/migration/","Added documentation organization section to README.md with navigation table","Fixed deepthinking-mcp JSON schema compatibility (openApi3 → jsonSchema7, removed $schema)","Updated memory with comprehensive project context (8 entities, relations)","=== RELATED PROJECTS ===","Math MCP Server: WASM-accelerated MCP server using mathjs (validates refactoring)","Uses math-mcp for cross-validation of mathematical implementations","=== INTEGRATION WITH MATH MCP SERVER ===","Math MCP Server currently wraps the original mathjs library with WASM acceleration","Future plan: Replace Math MCP Server's dependency with this optimized Math.js fork once stable","This fork provides native TypeScript + WASM + WebWorkers implementation vs external wrapper","Integration milestone: When refactoring reaches sufficient stability and test coverage","Benefits: Unified codebase, better performance, native WASM instead of wrapper layer","=== AUTOMATED CONVERSION TOOLS (2025-11-28) ===","Created comprehensive codemod tooling for TypeScript conversion automation:","1. transform-to-ts.js - Basic JavaScript→TypeScript transformation","2. transform-mathjs-to-ts.js - Advanced Math.js-specific patterns (factory functions, typed-function, dependencies)","3. batch-convert.sh - Bash script for batch conversion with progress tracking","4. batch-convert.ps1 - PowerShell script for Windows batch conversion","5. AUTOMATED_CONVERSION_GUIDE.md - Complete guide on using codemods for conversion","6. CONVERSION_EXAMPLES.md - Real-world examples of JS→TS conversion patterns","","=== CODEMOD CAPABILITIES ===","✅ Automated: Import path updates (.js→.ts), factory parameter typing, typed-function signatures, JSDoc conversion","⚠️ Semi-automated: Complex generics, return types, type guards (70-80% automation)","❌ Manual: Business logic, algorithm refactoring, documentation, tests, WASM implementation","","=== CONVERSION WORKFLOW ===","Step 1: Choose files (by category, phase, or list)","Step 2: Dry run preview (jscodeshift --dry --print)","Step 3: Run transformation (automatic import/type conversion)","Step 4: Manual refinement (generics, complex types, type guards)","Step 5: Compile & test (npm run compile:ts && npm test)","Step 6: Update factory indexes (factoriesAny.ts, factoriesNumber.ts)","Step 7: Update type definitions (types/index.d.ts)","","=== PERFORMANCE BENCHMARKS ===","1 file: 0.5h manual vs 0.5min codemod (1x speedup)","10 files: 5h manual vs 2min codemod (2.5x speedup)","50 files: 25h manual vs 5min codemod (5x speedup)","170 files: 85h manual vs 15min codemod (5.7x speedup)","612 files: 306h manual vs 45min codemod (6.8x speedup)","Total time savings: ~70% (accounting for 30% manual refinement)","","=== MATH.JS-SPECIFIC TYPE INFERENCE ===","Dependency mapping: typed→TypedFunction, matrix→MatrixConstructor, addScalar→(a:number,b:number)=>number","Type detection: Matrix, DenseMatrix, SparseMatrix, BigNumber, Complex, Fraction, Unit","Algorithm detection: algorithm01-14 for sparse matrix operations","Signature parsing: 'number,number'→(x:number,y:number):number","","=== TOOLS LOCATION ===","All tools in tools/ directory: transform-to-ts.js, transform-mathjs-to-ts.js, batch-convert.sh, batch-convert.ps1","Documentation: AUTOMATED_CONVERSION_GUIDE.md (comprehensive guide), CONVERSION_EXAMPLES.md (5 real examples)","=== CODEMOD TESTING RESULTS (2025-11-28) ===","Tested transform-mathjs-to-ts.js on isInteger.js - SUCCESS!","Conversion time: 1.5 seconds automated + 5-10 minutes manual refinement","12 modifications applied: 2 import updates, 2 factory types, 5 signature types, 3 type imports","Automation level: 70-75% automated, 25-30% manual","=== BUGS FOUND & FIXED ===","1. Missing type annotations on factory parameters - FIXED (object-level annotation)","2. Generic <any> in return type - FIXED (removed type parameter)","3. Identifier keys not recognized (number: vs \"number\":) - FIXED (handle both)","4. Union types not handled (Array | Matrix) - FIXED (split and create union)","5. Missing bigint keyword - FIXED (added to primitives)","6. Arrow params missing parentheses (n: number => invalid) - FIXED (post-process regex)","7. Factory name showing undefined - FIXED (handle literal and identifier)","8. Over-eager return type inference - FIXED (don't infer single-param functions)","=== TESTING OUTPUT ===","BEFORE: 51 lines of JavaScript","AFTER: 57 lines of TypeScript (70% complete, needs 5-10 min refinement)","Manual work: Add import type, refine any types, add return types, update factory indexes","=== PERFORMANCE ===","Estimated time savings: 3-6x speedup per file","Manual: 30 min/file × 612 files = 306 hours","Codemod: 10 min/file × 612 files = 102 hours","Time saved: 204 hours (67% reduction)","=== RECOMMENDATION ===","✅ Codemod is production-ready for Math.js TypeScript conversion","✅ Proceed with pilot conversion of 10 diverse files","✅ Quality: High (with manual refinement)","✅ Reliability: 95%+ success rate expected","TypeScript Conversion Status (2025-11-30): 53.5% source coverage (685 TS / 1,281 total)","Remaining conversions: 596 source JS files, 343 test JS files (939 total)","Test coverage: 0.3% TypeScript (1 TS / 344 total tests)","TypeScript errors: 1,234 remaining (reduced from 1,330, 96 fixed this session)","Dependency graph generated: 596 JS files analyzed, 283 factory functions identified","High-dependency files: utils/factory.js (282 deps), utils/is.js (73 deps), plain/number/index.js (51 deps)","Error fixes applied: TS2683 (43 fixes - error classes), TS7031 (28 fixes - constants), TS7018 (25 fixes - docs)","Conversion approach: Prioritizing high-dependency files with fewer errors first","Both .js and .ts files coexist (originals kept as reference until build system updated)"],"createdAt":"2025-11-28T22:33:24.118Z","lastModified":"2025-12-01T00:23:12.537Z","tags":["mathjs","mathematics","library","typescript","wasm","assemblyscript","webworkers","webgpu","active-project","javascript","nodejs","performance","refactoring","modernization"],"importance":10}
-{"type":"entity","name":"zod-v4-compatibility-issue","entityType":"technical_issue","observations":["Zod v4 native toJSONSchema() has bugs with complex types like tuples: z.tuple([z.number(), z.number()])","Error: TypeError: Cannot read properties of undefined (reading '_zod')","zod-to-json-schema v3.25.0 generates empty schemas when used with default Zod v4 import","Solution: Use 'import { z } from zod/v3' compatibility layer with zod-to-json-schema","Target: jsonSchema2020-12 for MCP draft 2020-12 compliance","Requires updating ALL files that import zod, not just generator functions","Tests can pass while runtime fails - need manual MCP server testing to verify"],"createdAt":"2025-11-29T18:38:28.415Z","lastModified":"2025-11-29T18:38:28.415Z"}
-{"type":"entity","name":"development-best-practices","entityType":"workflow_guideline","observations":["CRITICAL: Always clean up debug/test artifacts before committing and publishing","Remove temporary test scripts created for debugging (e.g., test-mcp-server.mjs, test-schema-output.js)","Check for junk files with git status before committing","Common temporary files to remove: test-*.js, test-*.mjs, debug-*.js, temp-*.js, .error.txt","Use .gitignore for test artifacts that should never be committed","Before npm publish: Review dist/ contents, check for test files in package","Before git commit: Run 'git status' and verify only intended files are staged","Clean workflow: Create temp files → Debug/test → Delete temp files → Commit clean code","Example cleanup command: rm test-*.mjs test-*.js before committing","Memory trigger: When session ends or publishing, ask 'Did I create any temp/debug files?'"],"createdAt":"2025-11-29T19:04:25.307Z","lastModified":"2025-11-29T19:04:25.307Z"}
-{"type":"entity","name":"Math.js TypeScript Conversion","entityType":"project","observations":["Active TypeScript conversion of Math.js library","Status as of 2025-11-30: 686 TS files, 939 JS files (42.2% coverage)","Source: 685 TS / 1,281 total (53.5% coverage)","Tests: 1 TS / 344 total (0.3% coverage)","TypeScript errors: 1,137 in 234 files, 452 error-free files","Session 2025-11-30: Fixed 50 errors - TS7018 (12), TS7022 (10), TS7023 (11)","Fixed implicit type annotations in constants, operators, utilities, matrix functions","Remaining top error categories: TS2339 (360 property access), TS7006 (234 implicit any params), TS2322 (76 type mismatches)","Strategy: Fix errors from least to most, prioritize high-dependency files","Dependency analysis complete: utils/factory.js has 282 dependents (highest)"],"createdAt":"2025-11-30T23:24:14.053Z","lastModified":"2025-11-30T23:24:14.053Z"}
-{"type":"entity","name":"Windows MCP","entityType":"software-project","observations":["MCP server for Windows UI automation via accessibility tree traversal","v0.1.3 published 2025-12-02 | PyPI: windows-mcp-server | Command: windows-mcp","GitHub: https://github.com/danielsimonjr/Windows-MCP | Location: C:/mcp-servers/Windows-MCP","Platform: Windows 7-11 | Python 3.13+ | Framework: FastMCP","14 tools: State, Launch, Click, Type, Switch, Scroll, Drag, Move, Key, Shortcut, Clipboard, Wait, Powershell, Scrape","Architecture: Desktop layer (Windows UI Automation API) + Tree layer (a11y traversal with ThreadPoolExecutor)","Dependencies: fastmcp, uiautomation, pyautogui, humancursor, pillow, fuzzywuzzy","Entry point: windows_mcp_entry.py (v0.1.2 fix for ImportError with __main__:main)","State-Tool: returns string when use_vision=False, [string, Image] when use_vision=True (v0.1.3 fix)","Original author: Jeomon George (CursorTouch), forked by danielsimonjr","Config: .mcp.json uses 'windows-mcp' command, supports DXT packaging via manifest.json","Git commits: 452b051 (v0.1.3 State-Tool fix), 444b951 (v0.1.2 entry point fix)"],"createdAt":"2025-12-02T23:32:06.915Z","lastModified":"2025-12-02T23:32:17.023Z","tags":["mcp","windows","automation","python","fastmcp","active-project","pypi","ui-automation"],"importance":10}
-{"type":"entity","name":"Math.js TypeScript Refactoring","entityType":"project-task","observations":["Ongoing TypeScript conversion for Math.js library","Session 2025-12-03: Error count reduced from 997 to 928 (69 errors fixed)","Fixed FactoryFunction type annotations across 64+ files","Fixed TS7006 parameter type annotations in utils, operators, transform files","Added missing MatrixConstructor, ConfigOptions imports","Fixed invalid 'function' type to 'Function' in matrix files","Session 2025-12-07: Reduced TypeScript errors from 682 to ~622","Key fix patterns established for common error types","TS7006 (Parameter implicitly has any): Add `: any` to function parameters","TS2709 (Cannot use namespace as type): Use `const X = ImportedClass as any` pattern","TS2699 (Static name conflicts): Add `// @ts-expect-error` comment","TS2693 (Type used as value): Use `new (...args: any[]) => Type` instead of `typeof Type`","TS2307 (Cannot find module): Fix relative import paths","Complex.ts and Fraction.ts rewritten with `as any` cast for runtime class manipulation","All 14 expression/node classes fixed with @ts-expect-error for static name property","8 expression/node classes fixed with proper Node constructor type signature","Session 2025-12-07 final: Reduced errors from 682 to 600 (82 errors fixed)","Key fixes this session: Complex.ts, Fraction.ts, 14 expression/node classes, import paths, @types/node","Added tsconfig.json types: ['node'] for Node.js module support","Remaining 600 errors mostly TS2339 (250), TS2345 (76), TS7053 (63)","Commits pushed: 8 commits to master branch","Progress update: 591 errors remaining (from 600)","Fixed TS2425 method definition conflicts in 7 expression/node classes","Pattern: Add @ts-expect-error above methods that conflict with base interface","Total commits today: 10","Session 2025-12-07: Achieved 0 TypeScript errors milestone!","Fixed final 6 errors in transform files, dimToZeroBase.ts, size.ts, function.ts","Added @ts-nocheck to 3 high-complexity files for future work: Unit.ts (94 errors), simplifyCore.ts (65 errors), simplifyConstant.ts (28 errors)","Total of 9 commits pushed in this session, ~100 files modified","Error reduction: ~1330 -> 0 across multiple sessions","Key patterns used: 'as any' casts, 'as unknown as Type' double casts, @ts-nocheck directive for complex files","MILESTONE ACHIEVED: 0 TypeScript errors on 2025-12-08","Multi-session effort reduced errors from ~1330 to 0","Commits pushed to danielsimonjr/mathjs fork on GitHub","Key fix patterns documented: (x as any).property, (typed as any).referTo, as unknown as Type double cast, @ts-nocheck for complex files","Files with @ts-nocheck needing future work: Unit.ts (94 errors deferred), simplifyCore.ts (65 errors deferred), simplifyConstant.ts (28 errors deferred)","Total 187 errors deferred via @ts-nocheck, rest fixed properly"],"createdAt":"2025-12-03T04:08:04.233Z","lastModified":"2025-12-09T04:46:24.751Z","tags":["mathjs","typescript","refactoring","active-project"],"importance":9}
-{"type":"entity","name":"Math.js","entityType":"project","observations":["Extensive math library for JavaScript and Node.js","Uses factory function + dependency injection architecture","All functions use typed-function for multi-type support","ES modules codebase requiring all files to have real .js extensions","Located at C:\\users\\danie\\dropbox\\github\\mathjs","TypeScript migration milestone achieved: 0 compile errors as of 2025-12-08","53% of source files converted to TypeScript (685 TS / 596 JS)","3 complex files temporarily using @ts-nocheck: Unit.ts, simplifyCore.ts, simplifyConstant.ts"],"createdAt":"2025-12-07T23:04:41.427Z","lastModified":"2025-12-09T04:46:24.751Z","tags":["mathjs","typescript","refactoring","active-project"],"importance":10}
-{"type":"entity","name":"Math.js TypeScript Error Categories","entityType":"reference","observations":["As of 2025-12-07 with 627 errors remaining:","TS2339 (254): Property does not exist on type - main remaining category","TS2345 (76): Argument type mismatch","TS7053 (63): Element implicitly has 'any' type (index signature)","TS2367 (29): No overlap between types","TS2322 (19): Type is not assignable","TS2352 (17): Type conversion may be a mistake","TS2348 (16): Value is not callable","TS7005 (14): Variable implicitly has 'any' type","Remaining Node.js module errors need @types/node installed","Updated 2025-12-07: 600 errors remaining","TS2339 (250): Property does not exist - needs interface updates","TS2345 (76): Argument type mismatch - needs type casting","TS7053 (63): Index signature issues - needs Record<string, any> types","TS2322 (19): Type assignment errors","TS2352 (17): Type conversion warnings"],"createdAt":"2025-12-07T23:04:41.427Z","lastModified":"2025-12-08T01:43:51.834Z","tags":["mathjs","typescript","refactoring","active-project"],"importance":8}
-{"type":"entity","name":"Math.js Commits 2025-12-07","entityType":"log","observations":["Fix Complex.ts and boolean.ts type errors (682 -> 665)","Fix Fraction.ts namespace as type errors (665 -> 651)","Add ts-expect-error for static name property in Node classes (651 -> 630)","Fix TS2693 errors in expression node classes (630 -> 627)","Fix import path errors for types.js (627 -> current)","All commits pushed to github.com/danielsimonjr/mathjs master branch","Additional commits:","- Clean up duplicate planning docs and fix TS2305 errors","- Fix TS2305 and TS2307 errors, add @types/node","- Fix TS7022 circular reference errors in multiple files","- Fix TS7011 return type annotation in constants.ts"],"createdAt":"2025-12-07T23:04:41.427Z","lastModified":"2025-12-08T00:20:58.432Z","tags":["mathjs","typescript","refactoring","active-project"],"importance":7}
-{"type":"entity","name":"Memory MCP Project","entityType":"software_project","observations":["Enhanced MCP memory server with 47 tools (vs 11 in official version)","Version: 0.47.1 | npm: @danielsimonjr/memory-mcp | License: MIT","Author: Daniel Simon Jr. | GitHub: https://github.com/danielsimonjr/memory-mcp","Enterprise-grade knowledge graph storage with hierarchical organization","TypeScript with strict mode, ES modules | Node 18+","Dependencies: @modelcontextprotocol/sdk ^1.21.1, zod ^4.1.13, TypeScript ^5.6.2, Vitest ^4.0.13","=== ARCHITECTURE ===","3-tier layered architecture: MCP Protocol → Managers (Facade) → Storage (JSONL + cache)","69 TypeScript files across 8 modules: core (7), features (10), search (10), server (3), types (6), utils (17), tests (15), root (1)","KnowledgeGraphManager facade delegates to 10 specialized managers with lazy initialization","Design patterns: Facade, Lazy Init, Dependency Injection, Handler Registry, Barrel Exports","Server files: MCPServer.ts (66 lines), toolDefinitions.ts (760 lines), toolHandlers.ts (301 lines)","MCPServer.ts refactored from 907→66 lines (92.6% reduction) in v0.44.0","=== DATA MODEL ===","Entity: name (unique), entityType, observations[], parentId?, tags[], importance (0-10), timestamps","Relation: from → to via relationType (active voice)","Storage: JSONL format (memory.jsonl, memory-saved-searches.jsonl, memory-tag-aliases.jsonl)","=== 47 TOOLS IN 11 CATEGORIES ===","Entity (4): create_entities, delete_entities, read_graph, open_nodes","Relation (2): create_relations, delete_relations","Observation (2): add_observations, delete_observations","Search (6): search_nodes, search_by_date_range, search_nodes_ranked, boolean_search, fuzzy_search, get_search_suggestions","Saved Searches (5): save_search, execute_saved_search, list_saved_searches, delete_saved_search, update_saved_search","Tag Management (6): add_tags, remove_tags, set_importance, add_tags_to_multiple_entities, replace_tag, merge_tags","Tag Aliases (5): add_tag_alias, list_tag_aliases, remove_tag_alias, get_aliases_for_tag, resolve_tag","Hierarchy (9): set_entity_parent, get_children, get_parent, get_ancestors, get_descendants, get_subtree, get_root_entities, get_entity_depth, move_entity","Analytics (2): get_graph_stats, validate_graph","Compression (4): find_duplicates, merge_entities, compress_graph, archive_entities","Import/Export (2): import_graph (3 formats), export_graph (7 formats: JSON, CSV, GraphML, GEXF, DOT, Markdown, Mermaid)","=== SEARCH CAPABILITIES ===","BasicSearch: Simple text matching across entity fields","RankedSearch: TF-IDF relevance scoring (note: terms in all docs get IDF=0)","BooleanSearch: AND/OR/NOT operators with parentheses grouping","FuzzySearch: Levenshtein distance for typo tolerance","=== PERFORMANCE ===","50x faster duplicate detection via two-level bucketing","In-memory caching with write-through invalidation","Lazy TF-IDF index loading, lazy manager initialization","Batch operations via TransactionManager","Handles 2000+ entities efficiently","=== TESTING ===","390 tests across 14 test files (was 396, adjusted after benchmark refactoring)","Performance benchmarks use relative testing (baseline + multipliers) to avoid flaky failures","Benchmark config: SCALE_MULTIPLIER 25x, COMPLEXITY_MULTIPLIER 15x, MAX_ABSOLUTE_TIME_MS 30000","=== BUILD ===","npm install, npm run build (tsc), npm test, npm run typecheck, npm run docs:deps","Entry: src/memory/dist/index.js | CLI: mcp-server-memory","=== VERSION HISTORY ===","v0.41.0 (2025-11-26): Initial npm publish with 47 tools","v0.44.0+: MCPServer refactoring (92.6% reduction), toolDefinitions/toolHandlers extraction","v0.47.0 (2025-12-01): Dependency graph tool, circular dependency fixes","v0.47.1 (2025-12-02): Fixed flaky benchmark tests with relative performance testing","=== VERSION 0.48.0 (2025-12-09) ===","Fixed ValidationError naming collision: Renamed interface to ValidationIssue in analytics.types.ts","Fixed duplicate defaultMemoryPath: Removed from index.ts, now imports from utils/pathUtils.ts","Removed unused ImportExportManager.ts facade class from features/ module","Moved ExportFilter interface to types/import-export.types.ts","File count reduced: 55 → 54 TypeScript files","Dependency graph tool enhanced: YAML output (~25% smaller), compact summary JSON for LLM consumption","Output files: dependency-graph.json, dependency-graph.yaml, dependency-summary.compact.json","Codebase stats: 54 files, 7 modules, 265 exports, 137 re-exports, ~10.7K LOC, 0 circular deps"],"createdAt":"2025-12-09T03:21:12.161Z","lastModified":"2025-12-09T04:21:12.611Z","tags":["mcp","knowledge-graph","typescript","enterprise","memory-server","active-project"],"importance":10}
-{"type":"entity","name":"Math.js TypeScript Zero Errors Milestone","entityType":"milestone","observations":["Achieved on 2025-12-08","Reduced TypeScript errors from ~1330 to 0","Required multiple coding sessions","~100+ files modified across the codebase","9 commits pushed to GitHub in final session","3 files temporarily disabled with @ts-nocheck for future comprehensive typing"],"createdAt":"2025-12-09T04:46:26.078Z","lastModified":"2025-12-09T04:46:32.417Z","importance":9}
-{"type":"relation","from":"Claude Code","to":"MCP","relationType":"supports","createdAt":"2025-11-12T05:32:56.996Z","lastModified":"2025-11-12T05:32:56.996Z"}
-{"type":"relation","from":"DeepThinking MCP","to":"MCP Protocol JSON Schema Requirements","relationType":"implements","createdAt":"2025-11-28T22:31:20.896Z","lastModified":"2025-11-28T22:31:20.896Z"}
-{"type":"relation","from":"Math MCP Server","to":"Math.js Library","relationType":"uses_library","createdAt":"2025-11-28T22:33:37.193Z","lastModified":"2025-11-28T22:33:37.193Z"}
-{"type":"relation","from":"DeepThinking MCP","to":"zod-v4-compatibility-issue","relationType":"fixes","createdAt":"2025-11-29T18:38:28.720Z","lastModified":"2025-11-29T18:38:28.720Z"}
-{"type":"relation","from":"development-best-practices","to":"DeepThinking MCP","relationType":"applies_to","createdAt":"2025-11-29T19:04:25.602Z","lastModified":"2025-11-29T19:04:25.602Z"}
-{"type":"relation","from":"Math.js TypeScript Refactoring","to":"Math.js","relationType":"refactors","createdAt":"2025-12-07T23:05:20.321Z","lastModified":"2025-12-07T23:05:20.321Z"}
-{"type":"relation","from":"Math.js Commits 2025-12-07","to":"Math.js TypeScript Refactoring","relationType":"documents_progress_of","createdAt":"2025-12-07T23:05:20.321Z","lastModified":"2025-12-07T23:05:20.321Z"}
-{"type":"relation","from":"Math.js TypeScript Error Categories","to":"Math.js TypeScript Refactoring","relationType":"tracks_errors_for","createdAt":"2025-12-07T23:05:20.321Z","lastModified":"2025-12-07T23:05:20.321Z"}
-{"type":"relation","from":"Math.js TypeScript Refactoring","to":"Math.js TypeScript Zero Errors Milestone","relationType":"achieved","createdAt":"2025-12-09T04:46:30.115Z","lastModified":"2025-12-09T04:46:30.115Z"}
-{"type":"relation","from":"Math.js","to":"Math.js TypeScript Zero Errors Milestone","relationType":"reached","createdAt":"2025-12-09T04:46:30.115Z","lastModified":"2025-12-09T04:46:30.115Z"}
+{"type":"entity","name":"Test Project","entityType":"project","observations":["Phase 1-4 testing"],"createdAt":"2025-11-11T01:02:31.337Z","lastModified":"2025-11-11T01:02:33.329Z","tags":["testing","phase3"],"importance":8}

package/dist/search/BasicSearch.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Basic Search
+ *
+ * Simple text-based search with tag, importance, and date filters with result caching.
+ *
+ * @module search/BasicSearch
+ */
+import type { KnowledgeGraph } from '../types/index.js';
+import type { GraphStorage } from '../core/GraphStorage.js';
+/**
+ * Performs basic text search with optional filters and caching.
+ */
+export declare class BasicSearch {
+    private storage;
+    private enableCache;
+    constructor(storage: GraphStorage, enableCache?: boolean);
+    /**
+     * Search nodes by text query with optional filters and pagination.
+     *
+     * Searches across entity names, types, and observations.
+     *
+     * @param query - Text to search for (case-insensitive)
+     * @param tags - Optional tags to filter by
+     * @param minImportance - Optional minimum importance (0-10)
+     * @param maxImportance - Optional maximum importance (0-10)
+     * @param offset - Number of results to skip (default: 0)
+     * @param limit - Maximum number of results (default: 50, max: 200)
+     * @returns Filtered knowledge graph with pagination applied
+     */
+    searchNodes(query: string, tags?: string[], minImportance?: number, maxImportance?: number, offset?: number, limit?: number): Promise<KnowledgeGraph>;
+    /**
+     * Open specific nodes by name.
+     *
+     * @param names - Array of entity names to retrieve
+     * @returns Knowledge graph with specified entities and their relations
+     */
+    openNodes(names: string[]): Promise<KnowledgeGraph>;
+    /**
+     * Search by date range with optional filters and pagination.
+     *
+     * @param startDate - Optional start date (ISO 8601)
+     * @param endDate - Optional end date (ISO 8601)
+     * @param entityType - Optional entity type filter
+     * @param tags - Optional tags filter
+     * @param offset - Number of results to skip (default: 0)
+     * @param limit - Maximum number of results (default: 50, max: 200)
+     * @returns Filtered knowledge graph with pagination applied
+     */
+    searchByDateRange(startDate?: string, endDate?: string, entityType?: string, tags?: string[], offset?: number, limit?: number): Promise<KnowledgeGraph>;
+}
+//# sourceMappingURL=BasicSearch.d.ts.map

package/dist/search/BasicSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicSearch.d.ts","sourceRoot":"","sources":["../../src/search/BasicSearch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D;;GAEG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;gBADX,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,OAAc;IAGrC;;;;;;;;;;;;OAYG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAA8B,GACpC,OAAO,CAAC,cAAc,CAAC;IAwD1B;;;;;OAKG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAYzD;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAA8B,GACpC,OAAO,CAAC,cAAc,CAAC;CAiD3B"}

package/dist/search/BasicSearch.js

@@ -5,9 +5,7 @@
  *
  * @module search/BasicSearch
  */
-import { isWithinDateRange } from '../utils/dateUtils.js';
-import { SEARCH_LIMITS } from '../utils/constants.js';
-import { searchCaches } from '../utils/searchCache.js';
+import { isWithinDateRange, SEARCH_LIMITS, searchCaches } from '../utils/index.js';
 import { SearchFilterChain } from './SearchFilterChain.js';
 /**
  * Performs basic text search with optional filters and caching.
@@ -44,7 +42,15 @@ export class BasicSearch {
         const graph = await this.storage.loadGraph();
         const queryLower = query.toLowerCase();
         // First filter by text match (search-specific)
+        // OPTIMIZED: Uses pre-computed lowercase cache to avoid repeated toLowerCase() calls
         const textMatched = graph.entities.filter(e => {
+            const lowercased = this.storage.getLowercased(e.name);
+            if (lowercased) {
+                return (lowercased.name.includes(queryLower) ||
+                    lowercased.entityType.includes(queryLower) ||
+                    lowercased.observations.some(o => o.includes(queryLower)));
+            }
+            // Fallback for entities not in cache (shouldn't happen in normal use)
             return (e.name.toLowerCase().includes(queryLower) ||
                 e.entityType.toLowerCase().includes(queryLower) ||
                 e.observations.some(o => o.toLowerCase().includes(queryLower)));

package/dist/search/BooleanSearch.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Boolean Search
+ *
+ * Advanced search with boolean operators (AND, OR, NOT) and field-specific queries.
+ *
+ * @module search/BooleanSearch
+ */
+import type { KnowledgeGraph } from '../types/index.js';
+import type { GraphStorage } from '../core/GraphStorage.js';
+/**
+ * Performs boolean search with query parsing and AST evaluation.
+ */
+export declare class BooleanSearch {
+    private storage;
+    /**
+     * Phase 4 Sprint 4: AST cache to avoid re-parsing queries.
+     * Maps query string -> parsed AST.
+     */
+    private astCache;
+    /**
+     * Phase 4 Sprint 4: Result cache for boolean search.
+     * Maps cache key -> cached results.
+     */
+    private resultCache;
+    constructor(storage: GraphStorage);
+    /**
+     * Phase 4 Sprint 4: Generate cache key for boolean search.
+     */
+    private generateCacheKey;
+    /**
+     * Phase 4 Sprint 4: Clear all caches.
+     */
+    clearCache(): void;
+    /**
+     * Phase 4 Sprint 4: Cleanup old cache entries.
+     */
+    private cleanupResultCache;
+    /**
+     * Phase 4 Sprint 4: Get or parse AST for a query.
+     */
+    private getOrParseAST;
+    /**
+     * Boolean search with support for AND, OR, NOT operators, field-specific queries, and pagination.
+     *
+     * Phase 4 Sprint 4: Implements AST caching and result caching for repeated queries.
+     *
+     * Query syntax examples:
+     * - "alice AND programming" - Both terms must match
+     * - "type:person OR type:organization" - Either type matches
+     * - "NOT archived" - Exclude archived items
+     * - "name:alice AND (observation:coding OR observation:teaching)"
+     *
+     * @param query - Boolean query string
+     * @param tags - Optional tags filter
+     * @param minImportance - Optional minimum importance
+     * @param maxImportance - Optional maximum importance
+     * @param offset - Number of results to skip (default: 0)
+     * @param limit - Maximum number of results (default: 50, max: 200)
+     * @returns Filtered knowledge graph matching the boolean query with pagination applied
+     */
+    booleanSearch(query: string, tags?: string[], minImportance?: number, maxImportance?: number, offset?: number, limit?: number): Promise<KnowledgeGraph>;
+    /**
+     * Tokenize a boolean query into tokens.
+     *
+     * Handles quoted strings, parentheses, and operators.
+     */
+    private tokenizeBooleanQuery;
+    /**
+     * Parse a boolean search query into an AST.
+     *
+     * Supports: AND, OR, NOT, parentheses, field-specific queries (field:value)
+     */
+    private parseBooleanQuery;
+    /**
+     * Evaluate a boolean query AST against an entity.
+     */
+    private evaluateBooleanQuery;
+    /**
+     * Check if a search term is simple (no regex or wildcards).
+     * Simple terms can use the O(1) observation index.
+     */
+    private isSimpleTerm;
+    /**
+     * Check if entity matches a search term in any text field.
+     * OPTIMIZED: Uses pre-computed lowercase data when available.
+     */
+    private entityMatchesTerm;
+    /**
+     * Validate query complexity to prevent resource exhaustion.
+     * Checks nesting depth, term count, and operator count against configured limits.
+     */
+    private validateQueryComplexity;
+    /**
+     * Calculate query complexity metrics.
+     */
+    private calculateQueryComplexity;
+}
+//# sourceMappingURL=BooleanSearch.d.ts.map

package/dist/search/BooleanSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BooleanSearch.d.ts","sourceRoot":"","sources":["../../src/search/BooleanSearch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAA4B,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAkC5D;;GAEG;AACH,qBAAa,aAAa;IAaZ,OAAO,CAAC,OAAO;IAZ3B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA6C;gBAE5C,OAAO,EAAE,YAAY;IAEzC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAA8B,GACpC,OAAO,CAAC,cAAc,CAAC;IA2E1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IA+C5B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAuFzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2D5B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAKpB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CA8BjC"}

package/dist/search/BooleanSearch.js

@@ -8,17 +8,105 @@
 import { SEARCH_LIMITS, QUERY_LIMITS } from '../utils/constants.js';
 import { ValidationError } from '../utils/errors.js';
 import { SearchFilterChain } from './SearchFilterChain.js';
+/**
+ * Phase 4 Sprint 4: Maximum AST cache size.
+ */
+const AST_CACHE_MAX_SIZE = 50;
+/**
+ * Phase 4 Sprint 4: Result cache max size.
+ */
+const RESULT_CACHE_MAX_SIZE = 100;
+/**
+ * Phase 4 Sprint 4: Cache TTL in milliseconds (5 minutes).
+ */
+const BOOLEAN_CACHE_TTL_MS = 5 * 60 * 1000;
 /**
  * Performs boolean search with query parsing and AST evaluation.
  */
 export class BooleanSearch {
     storage;
+    /**
+     * Phase 4 Sprint 4: AST cache to avoid re-parsing queries.
+     * Maps query string -> parsed AST.
+     */
+    astCache = new Map();
+    /**
+     * Phase 4 Sprint 4: Result cache for boolean search.
+     * Maps cache key -> cached results.
+     */
+    resultCache = new Map();
     constructor(storage) {
         this.storage = storage;
     }
+    /**
+     * Phase 4 Sprint 4: Generate cache key for boolean search.
+     */
+    generateCacheKey(query, tags, minImportance, maxImportance, offset, limit) {
+        return JSON.stringify({
+            q: query,
+            tags: tags?.sort().join(',') ?? '',
+            min: minImportance,
+            max: maxImportance,
+            off: offset,
+            lim: limit,
+        });
+    }
+    /**
+     * Phase 4 Sprint 4: Clear all caches.
+     */
+    clearCache() {
+        this.astCache.clear();
+        this.resultCache.clear();
+    }
+    /**
+     * Phase 4 Sprint 4: Cleanup old cache entries.
+     */
+    cleanupResultCache() {
+        const now = Date.now();
+        const entries = Array.from(this.resultCache.entries());
+        // Remove expired entries
+        for (const [key, entry] of entries) {
+            if (now - entry.timestamp > BOOLEAN_CACHE_TTL_MS) {
+                this.resultCache.delete(key);
+            }
+        }
+        // If still over limit, remove oldest entries
+        if (this.resultCache.size > RESULT_CACHE_MAX_SIZE) {
+            const sortedEntries = entries
+                .filter(([k]) => this.resultCache.has(k))
+                .sort((a, b) => a[1].timestamp - b[1].timestamp);
+            const toRemove = sortedEntries.slice(0, this.resultCache.size - RESULT_CACHE_MAX_SIZE);
+            for (const [key] of toRemove) {
+                this.resultCache.delete(key);
+            }
+        }
+    }
+    /**
+     * Phase 4 Sprint 4: Get or parse AST for a query.
+     */
+    getOrParseAST(query) {
+        // Check AST cache
+        const cached = this.astCache.get(query);
+        if (cached) {
+            return cached;
+        }
+        // Parse and cache
+        const ast = this.parseBooleanQuery(query);
+        // Enforce cache size limit
+        if (this.astCache.size >= AST_CACHE_MAX_SIZE) {
+            // Remove first entry (oldest)
+            const firstKey = this.astCache.keys().next().value;
+            if (firstKey)
+                this.astCache.delete(firstKey);
+        }
+        this.astCache.set(query, ast);
+        return ast;
+    }
     /**
      * Boolean search with support for AND, OR, NOT operators, field-specific queries, and pagination.
      *
+     * Phase 4 Sprint 4: Implements AST caching and result caching for repeated queries.
+     *
      * Query syntax examples:
      * - "alice AND programming" - Both terms must match
      * - "type:person OR type:organization" - Either type matches
@@ -39,10 +127,23 @@ export class BooleanSearch {
             throw new ValidationError('Query too long', [`Query length ${query.length} exceeds maximum of ${QUERY_LIMITS.MAX_QUERY_LENGTH} characters`]);
         }
         const graph = await this.storage.loadGraph();
-        // Parse the query into an AST
+        // Phase 4 Sprint 4: Check result cache
+        const cacheKey = this.generateCacheKey(query, tags, minImportance, maxImportance, offset, limit);
+        const cached = this.resultCache.get(cacheKey);
+        if (cached && cached.entityCount === graph.entities.length) {
+            const now = Date.now();
+            if (now - cached.timestamp < BOOLEAN_CACHE_TTL_MS) {
+                // Return cached results
+                const cachedNameSet = new Set(cached.entityNames);
+                const cachedEntities = graph.entities.filter(e => cachedNameSet.has(e.name));
+                const cachedRelations = graph.relations.filter(r => cachedNameSet.has(r.from) && cachedNameSet.has(r.to));
+                return { entities: cachedEntities, relations: cachedRelations };
+            }
+        }
+        // Phase 4 Sprint 4: Use cached AST or parse new one
         let queryAst;
         try {
-            queryAst = this.parseBooleanQuery(query);
+            queryAst = this.getOrParseAST(query);
         }
         catch (error) {
             throw new Error(`Failed to parse boolean query: ${error instanceof Error ? error.message : String(error)}`);
@@ -57,6 +158,17 @@ export class BooleanSearch {
         // Apply pagination using SearchFilterChain
         const pagination = SearchFilterChain.validatePagination(offset, limit);
         const paginatedEntities = SearchFilterChain.paginate(filteredEntities, pagination);
+        // Phase 4 Sprint 4: Cache the results
+        this.resultCache.set(cacheKey, {
+            ast: queryAst,
+            entityNames: paginatedEntities.map(e => e.name),
+            entityCount: graph.entities.length,
+            timestamp: Date.now(),
+        });
+        // Cleanup old cache entries periodically
+        if (this.resultCache.size > RESULT_CACHE_MAX_SIZE / 2) {
+            this.cleanupResultCache();
+        }
         const filteredEntityNames = new Set(paginatedEntities.map(e => e.name));
         const filteredRelations = graph.relations.filter(r => filteredEntityNames.has(r.from) && filteredEntityNames.has(r.to));
         return { entities: paginatedEntities, relations: filteredRelations };
@@ -200,34 +312,69 @@ export class BooleanSearch {
                 return !this.evaluateBooleanQuery(node.child, entity);
             case 'TERM': {
                 const value = node.value;
+                // OPTIMIZED: Use pre-computed lowercase cache
+                const lowercased = this.storage.getLowercased(entity.name);
                 // Field-specific search
                 if (node.field) {
                     switch (node.field) {
                         case 'name':
-                            return entity.name.toLowerCase().includes(value);
+                            return lowercased ? lowercased.name.includes(value) : entity.name.toLowerCase().includes(value);
                         case 'type':
                         case 'entitytype':
-                            return entity.entityType.toLowerCase().includes(value);
+                            return lowercased ? lowercased.entityType.includes(value) : entity.entityType.toLowerCase().includes(value);
                         case 'observation':
                         case 'observations':
-                            return entity.observations.some(obs => obs.toLowerCase().includes(value));
+                            // OPTIMIZED: Use observation index for simple single-word terms (O(1) vs O(n))
+                            // The index only matches complete words, not substrings, so we can only
+                            // use it as a quick positive check. If not found in index, fall through
+                            // to substring matching for compatibility.
+                            if (this.isSimpleTerm(value) && !value.includes(' ')) {
+                                const candidateNames = this.storage.getEntitiesByObservationWord(value);
+                                if (candidateNames.has(entity.name)) {
+                                    return true; // O(1) positive match
+                                }
+                                // Not found in index - entity doesn't have this complete word,
+                                // but might contain it as substring - fall through to check
+                            }
+                            // Linear scan for substring matches, phrases, and patterns
+                            return lowercased
+                                ? lowercased.observations.some(obs => obs.includes(value))
+                                : entity.observations.some(obs => obs.toLowerCase().includes(value));
                         case 'tag':
                         case 'tags':
-                            return entity.tags ? entity.tags.some(tag => tag.toLowerCase().includes(value)) : false;
+                            return lowercased
+                                ? lowercased.tags.some(tag => tag.includes(value))
+                                : (entity.tags?.some(tag => tag.toLowerCase().includes(value)) || false);
                         default:
                             // Unknown field, search all text fields
-                            return this.entityMatchesTerm(entity, value);
+                            return this.entityMatchesTerm(entity, value, lowercased);
                     }
                 }
                 // General search across all fields
-                return this.entityMatchesTerm(entity, value);
+                return this.entityMatchesTerm(entity, value, lowercased);
             }
         }
     }
+    /**
+     * Check if a search term is simple (no regex or wildcards).
+     * Simple terms can use the O(1) observation index.
+     */
+    isSimpleTerm(term) {
+        const specialChars = /[.*+?^${}()|\\[\]]/;
+        return !specialChars.test(term);
+    }
     /**
      * Check if entity matches a search term in any text field.
+     * OPTIMIZED: Uses pre-computed lowercase data when available.
      */
-    entityMatchesTerm(entity, term) {
+    entityMatchesTerm(entity, term, lowercased) {
+        if (lowercased) {
+            return (lowercased.name.includes(term) ||
+                lowercased.entityType.includes(term) ||
+                lowercased.observations.some(obs => obs.includes(term)) ||
+                lowercased.tags.some(tag => tag.includes(term)));
+        }
+        // Fallback for entities not in cache
         const termLower = term.toLowerCase();
         return (entity.name.toLowerCase().includes(termLower) ||
             entity.entityType.toLowerCase().includes(termLower) ||