soulcraft/brainy
2
0
Fork 0
Code Issues 1 Pull requests Projects Releases 335 Packages Wiki Activity Actions
413 commits 11 branches 524 tags 190 MiB
Commit graph

3 commits

Author SHA1 Message Date
David Snelling
98bf98a228 feat: Complete the 9 Unified Methods with augment() and export()! 🎯 
BREAKING CHANGE: Brainy 1.0 now has 9 unified methods (odd numbers FTW!)

THE 9 UNIFIED METHODS:
1. add() - Smart data addition
2. search() - Unified search
3. import() - Bulk import
4. addNoun() - Typed entities
5. addVerb() - Relationships
6. update() - Smart updates
7. delete() - Soft delete
8. augment() - Complete augmentation management ⭐
9. export() - Universal data export ⭐

Key improvements:
- Renamed register() to augment() for consistency
- Made augment() super flexible - handles ALL operations:
  - augment(new MyAugmentation()) - Register
  - augment('list') - List all with status
  - augment('enable', 'name') - Enable
  - augment('disable', 'name') - Disable
  - augment('unregister', 'name') - Remove
  - augment('enable-type', 'sense') - Bulk enable
- Added export() as 9th method for data portability:
  - Export as JSON, CSV, Graph, or Embeddings
  - Filter, limit, include/exclude options
  - Perfect for backups, migrations, integrations

Documentation:
- Created AUGMENTATION-GUIDE.md - Super simple guide
- Updated UNIFIED-API.md for all 9 methods
- Fixed misleading community package references
- Updated README with 9 methods everywhere

CLI commands now perfectly mirror the API:
- brainy augment <action> - Matches augment() method
- brainy export - Matches export() method

From 40+ methods → 9 unified methods (78% reduction!)
'Make the simple things simple, and the complex things possible'
 2025-08-14 12:29:47 -07:00
David Snelling
c93df7ee8e docs: Fix misleading references to non-existent community packages 
- Clearly marked community augmentations as 'Coming Soon!' and ideas
- Changed examples to show they are future possibilities, not current packages
- Fixed cortex.register() references to use brain.register() consistently
- Updated augmentation interface from ISenseAugmentation to IAugmentation
- Added proper brain.register() example in augmentation creation section
- Added note that community packages are examples of what could be built
- Added 'Be the First!' encouragement for community builders

This ensures documentation is honest about what exists vs what's possible.
 2025-08-14 12:21:30 -07:00
David Snelling
a84aaa7fad feat: Add augmentation management as the 8th unified method! 🧩 
BREAKING CHANGE: Brainy 1.0 now has 8 unified methods (was 7)

Added complete augmentation management system:
- brain.register(augmentation) - Register custom augmentations
- brain.unregister(name) - Remove augmentations
- Existing enable/disable/list methods remain

CLI augmentation commands:
- brainy augment list - Show all augmentations
- brainy augment enable/disable - Toggle augmentations
- brainy augment register - Load custom augmentations
- brainy augment enable-type/disable-type - Bulk operations

Documentation:
- Created UNIFIED-API.md explaining all 8 methods
- Shows complete before/after transformation
- Includes augmentation pipeline architecture
- Examples for creating custom augmentations

The unified API is now complete:
1. add() - Smart data addition
2. search() - Unified search
3. import() - Bulk import
4. addNoun() - Typed entities
5. addVerb() - Relationships
6. update() - Smart updates
7. delete() - Soft delete
8. register() - Augmentations ⭐ NEW!

This completes the vision: ONE way to do everything!
 2025-08-14 12:19:34 -07:00