feat: implement comprehensive type safety system with BrainyTypes API

Major enhancements for type safety and developer experience:

- Add BrainyTypes static API for type management and AI-powered suggestions
- Implement strict type validation for all 31 NounType categories
- Remove dangerous generic add() method that bypassed type safety
- Add intelligent type inference with confidence scoring
- Provide helpful error messages with typo suggestions using Levenshtein distance
- Update all internal code, examples, and documentation to use typed methods
- Enhance CLI with new type management commands (types, suggest, validate)

Breaking changes:
- Remove deprecated add() method - use addNoun() with explicit type parameter
- All addNoun() calls now require explicit type as second parameter

This release significantly improves type safety across the entire system while
maintaining backward compatibility for properly typed method calls.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
David Snelling 2025-09-01 09:37:36 -07:00
parent 7e0c111d3c
commit 0f4ab52ad9
40 changed files with 1704 additions and 497 deletions

View file

@ -34,10 +34,10 @@ That's it! No configuration needed. Brainy automatically:
```javascript
// Add a simple string
await brain.addNoun("JavaScript is a versatile programming language")
await brain.addNoun("JavaScript is a versatile programming language", 'concept')
// Add with metadata
await brain.addNoun("React is a JavaScript library", {
await brain.addNoun("React is a JavaScript library", 'concept', {
type: "library",
category: "frontend",
popularity: "high"
@ -48,7 +48,7 @@ await brain.addNoun({
title: "Introduction to TypeScript",
content: "TypeScript adds static typing to JavaScript",
author: "John Doe"
}, {
}, 'document', {
type: "article",
date: "2024-01-15"
})