@soulcraft/brainy 3.18.0 โ†’ 3.19.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/README.md +52 -3
  3. package/bin/brainy.js +9 -2335
  4. package/dist/api/DataAPI.d.ts +1 -1
  5. package/dist/augmentations/cacheAugmentation.d.ts +1 -1
  6. package/dist/augmentations/metricsAugmentation.d.ts +20 -20
  7. package/dist/brainy.d.ts +19 -1
  8. package/dist/brainy.js +24 -0
  9. package/dist/brainyData.js +1 -2
  10. package/dist/cli/catalog.js +8 -12
  11. package/dist/cli/commands/conversation.d.ts +22 -0
  12. package/dist/cli/commands/conversation.js +528 -0
  13. package/dist/cli/commands/core.js +61 -17
  14. package/dist/cli/commands/neural.js +4 -5
  15. package/dist/cli/commands/types.d.ts +30 -0
  16. package/dist/cli/commands/types.js +194 -0
  17. package/dist/cli/commands/utility.js +2 -3
  18. package/dist/cli/index.js +44 -2
  19. package/dist/cli/interactive.d.ts +3 -3
  20. package/dist/cli/interactive.js +5 -5
  21. package/dist/conversation/conversationManager.d.ts +176 -0
  22. package/dist/conversation/conversationManager.js +666 -0
  23. package/dist/conversation/index.d.ts +8 -0
  24. package/dist/conversation/index.js +8 -0
  25. package/dist/conversation/types.d.ts +231 -0
  26. package/dist/conversation/types.js +8 -0
  27. package/dist/hnsw/hnswIndexOptimized.d.ts +1 -1
  28. package/dist/index.d.ts +3 -0
  29. package/dist/index.js +3 -0
  30. package/dist/mcp/brainyMCPBroadcast.d.ts +2 -2
  31. package/dist/mcp/brainyMCPBroadcast.js +1 -1
  32. package/dist/mcp/brainyMCPClient.js +8 -4
  33. package/dist/mcp/conversationTools.d.ts +88 -0
  34. package/dist/mcp/conversationTools.js +470 -0
  35. package/dist/neural/types.d.ts +2 -2
  36. package/dist/streaming/pipeline.d.ts +1 -1
  37. package/dist/types/mcpTypes.d.ts +7 -1
  38. package/dist/universal/fs.d.ts +24 -66
  39. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -2,6 +2,10 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
4
4
 
5
+ ### [3.19.1](https://github.com/soulcraftlabs/brainy/compare/v3.19.0...v3.19.1) (2025-09-29)
6
+
7
+ ## [3.19.0](https://github.com/soulcraftlabs/brainy/compare/v3.18.0...v3.19.0) (2025-09-29)
8
+
5
9
  ## [3.17.0](https://github.com/soulcraftlabs/brainy/compare/v3.16.0...v3.17.0) (2025-09-27)
6
10
 
7
11
  ## [3.15.0](https://github.com/soulcraftlabs/brainy/compare/v3.14.2...v3.15.0) (2025-09-26)
package/README.md CHANGED
@@ -19,6 +19,14 @@
19
19
 
20
20
  ## ๐ŸŽ‰ Key Features
21
21
 
22
+ ### ๐Ÿ’ฌ **Infinite Agent Memory** (NEW!)
23
+
24
+ - **Never Lose Context**: Conversations preserved with semantic search
25
+ - **Smart Context Retrieval**: Triple Intelligence finds relevant past work
26
+ - **Claude Code Integration**: One command (`brainy conversation setup`) enables infinite memory
27
+ - **Automatic Artifact Linking**: Code and files connected to conversations
28
+ - **Scales to Millions**: Messages indexed and searchable in <100ms
29
+
22
30
  ### ๐Ÿง  **Triple Intelligenceโ„ข Engine**
23
31
 
24
32
  - **Vector Search**: HNSW-powered semantic similarity
@@ -44,6 +52,42 @@
44
52
 
45
53
  ```bash
46
54
  npm install @soulcraft/brainy
55
+
56
+ # For Claude Code infinite memory (optional):
57
+ brainy conversation setup
58
+ ```
59
+
60
+ ### ๐Ÿ’ฌ **Infinite Memory for Claude Code**
61
+
62
+ ```javascript
63
+ // One-time setup:
64
+ // $ brainy conversation setup
65
+
66
+ // Claude Code now automatically:
67
+ // - Saves every conversation with embeddings
68
+ // - Retrieves relevant past context
69
+ // - Links code artifacts to conversations
70
+ // - Never loses context or momentum
71
+
72
+ // Use programmatically:
73
+ import { Brainy } from '@soulcraft/brainy'
74
+
75
+ const brain = new Brainy()
76
+ await brain.init()
77
+
78
+ // Save conversations
79
+ await brain.conversation.saveMessage(
80
+ "How do I implement JWT authentication?",
81
+ "user",
82
+ { conversationId: "conv_123" }
83
+ )
84
+
85
+ // Get relevant context (semantic + temporal + graph)
86
+ const context = await brain.conversation.getRelevantContext(
87
+ "JWT token validation",
88
+ { limit: 10, includeArtifacts: true }
89
+ )
90
+ // Returns: Ranked messages, linked code, similar conversations
47
91
  ```
48
92
 
49
93
  ### ๐ŸŽฏ **True Zero Configuration**
@@ -762,10 +806,15 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
762
806
 
763
807
  ## ๐Ÿ“– Documentation
764
808
 
809
+ ### Infinite Agent Memory ๐Ÿ’ฌ
810
+ - [Conversation API Overview](docs/conversation/README.md) - **NEW!** Complete conversation management guide
811
+ - [MCP Integration for Claude Code](docs/conversation/MCP_INTEGRATION.md) - **NEW!** One-command setup
812
+ - [API Reference](docs/conversation/API_REFERENCE.md) - **NEW!** Full API documentation
813
+
765
814
  ### Framework Integration
766
- - [Framework Integration Guide](docs/guides/framework-integration.md) - **NEW!** Complete framework setup guide
767
- - [Next.js Integration](docs/guides/nextjs-integration.md) - **NEW!** React and Next.js examples
768
- - [Vue.js Integration](docs/guides/vue-integration.md) - **NEW!** Vue and Nuxt examples
815
+ - [Framework Integration Guide](docs/guides/framework-integration.md) - Complete framework setup guide
816
+ - [Next.js Integration](docs/guides/nextjs-integration.md) - React and Next.js examples
817
+ - [Vue.js Integration](docs/guides/vue-integration.md) - Vue and Nuxt examples
769
818
 
770
819
  ### Virtual Filesystem (Semantic VFS) ๐Ÿง ๐Ÿ“
771
820
  - [VFS Core Documentation](docs/vfs/VFS_CORE.md) - Complete filesystem architecture and API