@aleph-ai/tinyaleph 1.5.6 → 1.6.0

package/examples/08-compound-symbols.js

@@ -0,0 +1,219 @@
+/**
+ * Example: Compound Symbols
+ * 
+ * Demonstrates the compound builder for creating multi-symbol concepts,
+ * cultural variants, and narrative sequences.
+ */
+
+const {
+  CompoundBuilder,
+  CompoundSymbol,
+  SymbolSequence,
+  compoundBuilder,
+  createCompound,
+  getCompound,
+  createSequence,
+  getSequence,
+  symbolDatabase,
+  resonanceSignature
+} = require('../core');
+
+console.log('='.repeat(60));
+console.log('Compound Symbol Builder');
+console.log('='.repeat(60));
+
+// ─────────────────────────────────────────────────────────────────
+// Pre-built Compounds
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n1. Pre-built Cultural Compounds');
+console.log('-'.repeat(40));
+
+const prebuilt = ['greek_warrior', 'viking_warrior', 'samurai_warrior', 'philosopher_king', 'shadow_self'];
+
+for (const id of prebuilt) {
+  const c = getCompound(id);
+  if (c) {
+    const components = c.components.map(s => s.unicode).join('');
+    const resonance = compoundBuilder.calculateCompoundResonance(c);
+    console.log(`  ${components} ${c.id}`);
+    console.log(`    "${c.meaning}"`);
+    console.log(`    prime: ${c.prime.toString().slice(0, 20)}...`);
+    console.log(`    resonance: ${resonance.toFixed(4)}`);
+    console.log(`    tags: [${c.culturalTags.join(', ')}]`);
+    console.log();
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Create Custom Compounds
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n2. Create Custom Compounds');
+console.log('-'.repeat(40));
+
+// Fire Mage
+const fireMage = createCompound('fire_mage', 
+  ['magician', 'fire', 'staff'],
+  'Fire Mage - Wielder of flame magic',
+  ['fantasy', 'magic', 'elemental']
+);
+console.log(`  Created: ${fireMage.unicode} ${fireMage.id}`);
+console.log(`    "${fireMage.meaning}"`);
+
+// Storm Lord
+const stormLord = createCompound('storm_lord',
+  ['ruler', 'thunder', 'lightning'],
+  'Storm Lord - Master of the tempest',
+  ['mythology', 'weather', 'power']
+);
+console.log(`  Created: ${stormLord.unicode} ${stormLord.id}`);
+console.log(`    "${stormLord.meaning}"`);
+
+// Guardian Spirit - using valid symbols
+const guardianSpirit = createCompound('guardian_spirit',
+  ['guardian', 'shadow', 'sanctuary'],
+  'Guardian Spirit - Protective ancestor spirit',
+  ['spiritual', 'protection', 'ancestors']
+);
+console.log(`  Created: ${guardianSpirit.unicode} ${guardianSpirit.id}`);
+console.log(`    "${guardianSpirit.meaning}"`);
+
+// ─────────────────────────────────────────────────────────────────
+// Symbol Sequences (Narratives)
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n3. Pre-built Narrative Sequences');
+console.log('-'.repeat(40));
+
+const herosJourney = getSequence('heros_journey');
+if (herosJourney) {
+  const icons = herosJourney.symbols.map(s => s.unicode).join(' → ');
+  console.log(`  ${herosJourney.id} (${herosJourney.type})`);
+  console.log(`    ${icons}`);
+  console.log(`    "${herosJourney.description}"`);
+}
+
+const alchemical = getSequence('alchemical_transformation');
+if (alchemical) {
+  const icons = alchemical.symbols.map(s => s.unicode).join(' → ');
+  console.log(`\n  ${alchemical.id} (${alchemical.type})`);
+  console.log(`    ${icons}`);
+  console.log(`    "${alchemical.description}"`);
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Create Custom Sequences
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n4. Create Custom Sequences');
+console.log('-'.repeat(40));
+
+// Love story - using valid symbols
+const loveStory = createSequence('love_story',
+  ['lover', 'love', 'conflict', 'unity'],
+  'narrative',
+  'Classic love story arc'
+);
+const loveIcons = loveStory.symbols.map(s => s.unicode).join(' → ');
+console.log(`  ${loveStory.id}: ${loveIcons}`);
+
+// Quest for knowledge
+const knowledgeQuest = createSequence('knowledge_quest',
+  ['scholar', 'path', 'library', 'sage', 'wisdom_concept'],
+  'journey',
+  'The pursuit of wisdom'
+);
+if (knowledgeQuest) {
+  const icons = knowledgeQuest.symbols.map(s => s.unicode).join(' → ');
+  console.log(`  ${knowledgeQuest.id}: ${icons}`);
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Compound Analysis
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n5. Compound Resonance Analysis');
+console.log('-'.repeat(40));
+
+const compounds = compoundBuilder.getAllCompounds();
+console.log(`  Total compounds: ${compounds.length}`);
+
+// Sort by resonance
+const ranked = compounds
+  .map(c => ({ 
+    compound: c, 
+    resonance: compoundBuilder.calculateCompoundResonance(c) 
+  }))
+  .sort((a, b) => b.resonance - a.resonance);
+
+console.log('\n  Top 5 by internal resonance:');
+for (const { compound, resonance } of ranked.slice(0, 5)) {
+  console.log(`    ${compound.unicode} ${compound.id}: ${resonance.toFixed(4)}`);
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Find Resonant Additions
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n6. Find Resonant Additions');
+console.log('-'.repeat(40));
+
+const base = getCompound('greek_warrior');
+if (base) {
+  const candidates = ['sun', 'moon_element', 'stars', 'thunder', 'gold', 'silver'];
+  const best = compoundBuilder.findResonantAddition(base, candidates);
+  
+  console.log(`  Base: ${base.unicode} ${base.id}`);
+  console.log(`  Candidates: [${candidates.join(', ')}]`);
+  if (best) {
+    console.log(`  Most resonant addition: ${best.symbol.unicode} ${best.symbol.id} (r=${best.resonance.toFixed(4)})`);
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Cultural Variants
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n7. Cultural Variants');
+console.log('-'.repeat(40));
+
+// Create variants of greek_warrior
+const norseVariant = compoundBuilder.createCulturalVariant(
+  'greek_warrior', 
+  'norse', 
+  ['ocean'],
+  'Norse-influenced warrior of the seas'
+);
+console.log(`  ${norseVariant.unicode} ${norseVariant.id}`);
+console.log(`    tags: [${norseVariant.culturalTags.join(', ')}]`);
+
+const egyptianVariant = compoundBuilder.createCulturalVariant(
+  'greek_warrior',
+  'egyptian',
+  ['pyramid', 'sun'],
+  'Egyptian warrior under Ra'
+);
+console.log(`  ${egyptianVariant.unicode} ${egyptianVariant.id}`);
+console.log(`    tags: [${egyptianVariant.culturalTags.join(', ')}]`);
+
+// ─────────────────────────────────────────────────────────────────
+// Statistics
+// ─────────────────────────────────────────────────────────────────
+
+console.log('\n8. Builder Statistics');
+console.log('-'.repeat(40));
+
+const stats = compoundBuilder.getStats();
+console.log(`  Total compounds: ${stats.totalCompounds}`);
+console.log(`  Total sequences: ${stats.totalSequences}`);
+console.log(`  Avg components per compound: ${stats.avgComponentsPerCompound.toFixed(1)}`);
+console.log(`  Avg symbols per sequence: ${stats.avgSymbolsPerSequence.toFixed(1)}`);
+console.log('  Cultural distribution:');
+for (const [tag, count] of Object.entries(stats.cultureTags)) {
+  console.log(`    ${tag}: ${count}`);
+}
+
+console.log('\n' + '='.repeat(60));
+console.log('Compounds multiply symbol primes; sequences order them narratively');
+console.log('='.repeat(60));

package/examples/README.md

@@ -0,0 +1,170 @@
+# TinyAleph Examples
+
+Comprehensive examples demonstrating TinyAleph's capabilities across semantic processing, cryptography, quantum simulation, mathematics, physics, and AI applications.
+
+## Quick Start
+
+```bash
+# Run a quick example
+node examples/01-hello-world.js
+
+# Run category-specific examples
+node examples/semantic/01-vocabulary.js
+node examples/crypto/01-password-hash.js
+node examples/scientific/01-single-qubit.js
+```
+
+## Demo Site
+
+Demo site with examples is available at [https://tinyaleph.com](https://tinyaleph.com)
+
+## Example Categories
+
+### 🚀 Quickstart (3 examples)
+Basic examples to get started immediately.
+
+| File | Description |
+|------|-------------|
+| [01-hello-world.js](./01-hello-world.js) | Your first TinyAleph embedding |
+| [02-basic-hash.js](./02-basic-hash.js) | Basic cryptographic hashing |
+| [03-quantum-coin.js](./03-quantum-coin.js) | Quantum coin flip simulation |
+
+### 🤖 AI & Machine Learning (12 examples)
+AI applications using semantic embeddings.
+
+| File | Description |
+|------|-------------|
+| [ai/01-embeddings.js](./ai/01-embeddings.js) | Text embeddings for ML |
+| [ai/02-semantic-memory.js](./ai/02-semantic-memory.js) | Semantic memory systems |
+| [ai/03-reasoning.js](./ai/03-reasoning.js) | Symbolic reasoning chains |
+| [ai/04-knowledge-graph.js](./ai/04-knowledge-graph.js) | Knowledge graph construction |
+| [ai/05-llm-integration.js](./ai/05-llm-integration.js) | LLM integration patterns |
+| [ai/06-agent.js](./ai/06-agent.js) | AI agent implementation |
+| [ai/07-hybrid-ai.js](./ai/07-hybrid-ai.js) | Hybrid neural-symbolic AI |
+| [ai/08-entropy-reasoning.js](./ai/08-entropy-reasoning.js) | Entropy-guided reasoning |
+| [ai/09-concept-learning.js](./ai/09-concept-learning.js) | Concept learning systems |
+| [ai/10-prompt-primes.js](./ai/10-prompt-primes.js) | Prime-based prompt engineering |
+| [ai/11-rag.js](./ai/11-rag.js) | Retrieval-augmented generation |
+| [ai/12-neuro-symbolic.js](./ai/12-neuro-symbolic.js) | Neural-symbolic bridge |
+
+### 📝 Semantic Processing (8 examples)
+Text analysis and NLP applications.
+
+| File | Description |
+|------|-------------|
+| [semantic/01-vocabulary.js](./semantic/01-vocabulary.js) | Word-to-prime mapping |
+| [semantic/02-similarity.js](./semantic/02-similarity.js) | Semantic similarity metrics |
+| [semantic/03-word-algebra.js](./semantic/03-word-algebra.js) | Word vector algebra |
+| [semantic/04-clustering.js](./semantic/04-clustering.js) | Text clustering |
+| [semantic/05-classification.js](./semantic/05-classification.js) | Text classification |
+| [semantic/06-dna-encoding.js](./semantic/06-dna-encoding.js) | DNA-inspired encoding |
+| [semantic/07-search.js](./semantic/07-search.js) | Semantic search engine |
+| [semantic/08-qa-system.js](./semantic/08-qa-system.js) | Question answering |
+
+### 🔐 Cryptography (5 examples)
+Cryptographic operations and security.
+
+| File | Description |
+|------|-------------|
+| [crypto/01-password-hash.js](./crypto/01-password-hash.js) | Password hashing |
+| [crypto/02-key-derivation.js](./crypto/02-key-derivation.js) | Key derivation (PBKDF) |
+| [crypto/03-hmac.js](./crypto/03-hmac.js) | Message authentication |
+| [crypto/04-file-integrity.js](./crypto/04-file-integrity.js) | File integrity verification |
+| [crypto/05-content-hash.js](./crypto/05-content-hash.js) | Content-addressable storage |
+
+### ⚛️ Scientific Computing (7 examples)
+Quantum computing simulation.
+
+| File | Description |
+|------|-------------|
+| [scientific/01-single-qubit.js](./scientific/01-single-qubit.js) | Single qubit operations |
+| [scientific/02-two-qubit.js](./scientific/02-two-qubit.js) | Two-qubit systems |
+| [scientific/03-quantum-circuits.js](./scientific/03-quantum-circuits.js) | Quantum circuits |
+| [scientific/04-measurement.js](./scientific/04-measurement.js) | Quantum measurement |
+| [scientific/05-algorithms.js](./scientific/05-algorithms.js) | Quantum algorithms |
+| [scientific/06-random.js](./scientific/06-random.js) | Quantum random numbers |
+| [scientific/07-wavefunction.js](./scientific/07-wavefunction.js) | Wavefunction simulation |
+
+### ➗ Mathematics (5 examples)
+Mathematical foundations.
+
+| File | Description |
+|------|-------------|
+| [math/01-quaternions.js](./math/01-quaternions.js) | Quaternion algebra |
+| [math/02-octonions.js](./math/02-octonions.js) | Octonion algebra |
+| [math/03-prime-factorization.js](./math/03-prime-factorization.js) | Prime factorization |
+| [math/04-vector-spaces.js](./math/04-vector-spaces.js) | Vector space operations |
+| [math/05-gaussian-primes.js](./math/05-gaussian-primes.js) | Gaussian primes |
+
+### 🌊 Physics Simulation (6 examples)
+Physics and dynamics.
+
+| File | Description |
+|------|-------------|
+| [physics/01-oscillator.js](./physics/01-oscillator.js) | Coupled oscillators |
+| [physics/02-lyapunov.js](./physics/02-lyapunov.js) | Lyapunov exponents |
+| [physics/03-collapse.js](./physics/03-collapse.js) | State collapse |
+| [physics/04-kuramoto.js](./physics/04-kuramoto.js) | Kuramoto synchronization |
+| [physics/05-entropy.js](./physics/05-entropy.js) | Entropy analysis |
+| [physics/06-primeon-ladder.js](./physics/06-primeon-ladder.js) | Primeon Z-ladder dynamics |
+
+## Running Examples
+
+### Prerequisites
+```bash
+npm install
+```
+
+### Run Individual Examples
+```bash
+node examples/ai/01-embeddings.js
+```
+
+### Run All Examples in a Category
+```bash
+for f in examples/ai/*.js; do node "$f"; done
+```
+
+## Example Structure
+
+Each example follows a consistent structure:
+1. **Header comment** - Description and use cases
+2. **Setup** - Import and initialization
+3. **Core demonstration** - Main functionality
+4. **Key takeaways** - Summary of concepts
+
+## Common Patterns
+
+### Semantic Backend
+```javascript
+const { SemanticBackend } = require('../modular');
+const backend = new SemanticBackend({ dimension: 16 });
+const state = backend.textToOrderedState('hello world');
+```
+
+### Cryptographic Backend
+```javascript
+const { CryptographicBackend } = require('../modular');
+const backend = new CryptographicBackend({ dimension: 32 });
+const hash = backend.hash('input', 32);
+```
+
+### Scientific Backend
+```javascript
+const { ScientificBackend } = require('../modular');
+const backend = new ScientificBackend({ dimension: 2 });
+const primes = backend.applyGate(ket0, 'H');
+```
+
+## Contributing Examples
+
+1. Create new example in appropriate category directory
+2. Follow existing naming convention: `XX-name.js`
+3. Include comprehensive header comment
+4. Demonstrate real-world use cases
+5. Add key takeaways section
+6. Update this README
+
+## Documentation
+
+For complete documentation, see [../docs/README.md](../docs/README.md)

package/examples/ai/01-embeddings.js

@@ -0,0 +1,155 @@
+/**
+ * @example Prime Embeddings
+ * @description Generate embeddings for text and concepts using prime resonance
+ * 
+ * TinyAleph generates unique embeddings based on prime factorization and
+ * hypercomplex algebra. Unlike neural embeddings, these are:
+ * - Deterministic (same input = same embedding)
+ * - Interpretable (based on prime structure)
+ * - Order-preserving (word order affects the result)
+ */
+
+const { SemanticBackend, Hypercomplex } = require('../../modular');
+
+// ===========================================
+// SETUP
+// ===========================================
+
+const backend = new SemanticBackend({ dimension: 16 });
+
+// ===========================================
+// BASIC EMBEDDINGS
+// ===========================================
+
+console.log('TinyAleph Prime Embeddings Example');
+console.log('===================================\n');
+
+// Generate embeddings for words
+const words = ['cat', 'dog', 'animal', 'tree', 'forest'];
+const embeddings = {};
+
+console.log('Word Embeddings:');
+console.log('-----------------');
+for (const word of words) {
+    embeddings[word] = backend.textToOrderedState(word);
+    console.log(`${word.padEnd(10)}: [${embeddings[word].c.slice(0, 4).map(c => c.toFixed(3)).join(', ')}, ...]`);
+}
+
+// ===========================================
+// EMBEDDING SIMILARITY
+// ===========================================
+
+console.log('\n===================================');
+console.log('Embedding Similarity (Cosine):');
+console.log('===================================\n');
+
+function cosineSimilarity(a, b) {
+    let dot = 0, magA = 0, magB = 0;
+    for (let i = 0; i < a.c.length; i++) {
+        dot += a.c[i] * b.c[i];
+        magA += a.c[i] * a.c[i];
+        magB += b.c[i] * b.c[i];
+    }
+    return dot / (Math.sqrt(magA) * Math.sqrt(magB));
+}
+
+// Compare embeddings
+const pairs = [
+    ['cat', 'dog'],
+    ['cat', 'animal'],
+    ['tree', 'forest'],
+    ['cat', 'tree'],
+];
+
+for (const [w1, w2] of pairs) {
+    const sim = cosineSimilarity(embeddings[w1], embeddings[w2]);
+    console.log(`${w1} <-> ${w2}: ${sim.toFixed(4)}`);
+}
+
+// ===========================================
+// SENTENCE EMBEDDINGS
+// ===========================================
+
+console.log('\n===================================');
+console.log('Sentence Embeddings:');
+console.log('===================================\n');
+
+const sentences = [
+    'The cat sat on the mat',
+    'The dog sat on the mat',
+    'The mat sat on the cat', // Word order matters!
+];
+
+const sentenceEmbeddings = sentences.map(s => ({
+    text: s,
+    embedding: backend.textToOrderedState(s)
+}));
+
+console.log('Sentence similarities:');
+for (let i = 0; i < sentences.length; i++) {
+    for (let j = i + 1; j < sentences.length; j++) {
+        const sim = cosineSimilarity(
+            sentenceEmbeddings[i].embedding,
+            sentenceEmbeddings[j].embedding
+        );
+        console.log(`"${sentences[i].substring(0, 20)}..." <-> "${sentences[j].substring(0, 20)}...": ${sim.toFixed(4)}`);
+    }
+}
+
+// ===========================================
+// EMBEDDING ARITHMETIC
+// ===========================================
+
+console.log('\n===================================');
+console.log('Embedding Arithmetic:');
+console.log('===================================\n');
+
+// king - man + woman ≈ queen (classic word2vec analogy)
+const king = backend.textToOrderedState('king');
+const man = backend.textToOrderedState('man');
+const woman = backend.textToOrderedState('woman');
+const queen = backend.textToOrderedState('queen');
+
+// Compute: king - man + woman
+const result = Hypercomplex.zero(16);
+for (let i = 0; i < 16; i++) {
+    result.c[i] = king.c[i] - man.c[i] + woman.c[i];
+}
+
+console.log('king - man + woman = ?');
+console.log(`Similarity to "queen": ${cosineSimilarity(result, queen).toFixed(4)}`);
+console.log(`Similarity to "king":  ${cosineSimilarity(result, king).toFixed(4)}`);
+console.log(`Similarity to "man":   ${cosineSimilarity(result, man).toFixed(4)}`);
+
+// ===========================================
+// EMBEDDING STORAGE FORMAT
+// ===========================================
+
+console.log('\n===================================');
+console.log('Embedding Storage:');
+console.log('===================================\n');
+
+// Convert to JSON for storage
+const embedding = backend.textToOrderedState('machine learning');
+const json = JSON.stringify(Array.from(embedding.c));
+console.log('JSON format (for storage):');
+console.log(json.substring(0, 80) + '...');
+console.log(`Size: ${json.length} bytes`);
+
+// Restore from JSON
+const restored = Hypercomplex.zero(16);
+restored.c = new Float64Array(JSON.parse(json));
+console.log(`\nRestored successfully: ${cosineSimilarity(embedding, restored) === 1 ? 'YES ✓' : 'NO'}`);
+
+// ===========================================
+// KEY TAKEAWAYS
+// ===========================================
+
+console.log('\n===================================');
+console.log('KEY TAKEAWAYS:');
+console.log('1. textToOrderedState() generates 16-dimensional hypercomplex embeddings');
+console.log('2. Embeddings are deterministic and reproducible');
+console.log('3. Cosine similarity measures semantic closeness');
+console.log('4. Word order affects embeddings (non-commutative)');
+console.log('5. Embedding arithmetic works for analogies');
+console.log('6. Embeddings serialize to JSON for storage');