brainy/tests/integration/bun-runtime-test.ts

165 lines
5.9 KiB
TypeScript
Raw Permalink Normal View History

/**
* Bun Runtime Test
*
* Tests that Brainy runs correctly under the Bun runtime (`bun add` / `bun run`)
* the supported Bun story. Verifies:
* 1. No native binaries required (pure WASM)
* 2. Model is properly bundled
* 3. Embeddings work without network access
*
* To run manually:
* bun tests/integration/bun-runtime-test.ts
*/
import { Brainy } from '../../dist/index.js'
import { embeddingManager } from '../../dist/embeddings/EmbeddingManager.js'
import { WASMEmbeddingEngine } from '../../dist/embeddings/wasm/index.js'
async function testBunRuntime() {
const results: { test: string; passed: boolean; error?: string }[] = []
console.log('🚀 Brainy Bun Runtime Test\n')
console.log('Runtime:', typeof Bun !== 'undefined' ? `Bun ${Bun.version}` : `Node.js ${process.version}`)
console.log('')
// Test 1: WASM Engine initialization
try {
console.log('1. Testing WASM Engine initialization...')
const engine = WASMEmbeddingEngine.getInstance()
await engine.initialize()
console.log(' ✅ WASM Engine initialized')
results.push({ test: 'WASM Engine init', passed: true })
} catch (error) {
console.log(' ❌ WASM Engine failed:', (error as Error).message)
results.push({ test: 'WASM Engine init', passed: false, error: (error as Error).message })
}
// Test 2: Generate embedding
try {
console.log('2. Testing embedding generation...')
const engine = WASMEmbeddingEngine.getInstance()
const embedding = await engine.embed('Hello from Bun!')
if (embedding.length !== 384) {
throw new Error(`Expected 384 dimensions, got ${embedding.length}`)
}
console.log(` ✅ Generated ${embedding.length}-dim embedding`)
results.push({ test: 'Embedding generation', passed: true })
} catch (error) {
console.log(' ❌ Embedding failed:', (error as Error).message)
results.push({ test: 'Embedding generation', passed: false, error: (error as Error).message })
}
// Test 3: Semantic similarity
try {
console.log('3. Testing semantic similarity...')
const engine = WASMEmbeddingEngine.getInstance()
const catEmb = await engine.embed('The cat sat on the mat')
const felineEmb = await engine.embed('A feline rests on a rug')
const stockEmb = await engine.embed('Stock market crash')
const cosineSim = (a: number[], b: number[]) => {
let dot = 0
for (let i = 0; i < a.length; i++) dot += a[i] * b[i]
return dot // Already normalized
}
const similarSim = cosineSim(catEmb, felineEmb)
const dissimilarSim = cosineSim(catEmb, stockEmb)
if (similarSim <= dissimilarSim) {
throw new Error(`Semantic similarity failed: similar=${similarSim.toFixed(4)}, dissimilar=${dissimilarSim.toFixed(4)}`)
}
console.log(` ✅ Semantic similarity works (similar: ${similarSim.toFixed(4)} > dissimilar: ${dissimilarSim.toFixed(4)})`)
results.push({ test: 'Semantic similarity', passed: true })
} catch (error) {
console.log(' ❌ Semantic similarity failed:', (error as Error).message)
results.push({ test: 'Semantic similarity', passed: false, error: (error as Error).message })
}
// Test 4: EmbeddingManager
try {
console.log('4. Testing EmbeddingManager...')
await embeddingManager.init()
const emb = await embeddingManager.embed('Test via manager')
if (emb.length !== 384) {
throw new Error(`Expected 384 dimensions, got ${emb.length}`)
}
console.log(' ✅ EmbeddingManager works')
results.push({ test: 'EmbeddingManager', passed: true })
} catch (error) {
console.log(' ❌ EmbeddingManager failed:', (error as Error).message)
results.push({ test: 'EmbeddingManager', passed: false, error: (error as Error).message })
}
// Test 5: Full Brainy initialization with fresh memory storage
try {
console.log('5. Testing Brainy initialization (in-memory)...')
feat(8.0)!: flip requireSubtype default to true (BRAINY-8.0-SUBTYPE-CONTRACT § C-1) Brainy 8.0 makes subtype required by default on every public write path (`add`, `addMany`, `update`, `relate`, `relateMany`, `updateRelation`, import). Per the locked C-1 contract, every entity and relation gets a non-empty subtype string by the time the storage layer sees it. OPT-OUT REMAINS FULLY SUPPORTED The runtime flag is still consumer-controlled. Three opt-out paths cover migration / legacy fixtures / typed escape: - `new Brainy({ requireSubtype: false })` — last-resort: turn off the contract entirely. Recommended only for migration windows or test fixtures that legitimately can't supply a subtype. - `new Brainy({ requireSubtype: { except: [NounType.Thing, ...] } })` — per-type allowlist: strict everywhere except the listed types. - `brain.requireSubtype(type, options)` — per-type registration with optional vocabulary. Composes with the brain-wide flag. Default is now `true`. Opt-out is explicit and documented; nothing silently degrades. TEST SWEEP Bulk-applied `requireSubtype: false` to every `new Brainy({...})` call site across 120 test files. Three sed patterns covered the shapes: - `new Brainy({` → `new Brainy({ requireSubtype: false,` - `new Brainy<T>({` → `new Brainy<T>({ requireSubtype: false,` - `new Brainy()` → `new Brainy({ requireSubtype: false })` tests/helpers/test-factory.ts → createTestConfig() defaults `requireSubtype: false` so test files using the helper inherit the opt-out without per-site edits. The test sites that DO exercise subtype semantics (the subtype-and-facets suite, the strict-mode-self-test suite, the verb- subtype-and-enforcement suite, etc.) already pass real subtypes — they were the 7.30.x acceptance tests for this contract. Those tests continue to pass unchanged. CHANGES src/brainy.ts - normalizeConfig() — `requireSubtype` default `false` → `true`. Comment refreshed to document the three opt-out paths. tests/* (120 files) - Bulk-edited brain construction sites. No functional test changes; the opt-out preserves the test author's original intent. tests/helpers/test-factory.ts - createTestConfig() base config gains `requireSubtype: false`. NO-OP for consumers who were already passing subtype on every write. For consumers who weren't, the upgrade path is one of the three opt-out forms above. Migration recipe documented in 8.0 release notes (next commit). VERIFICATION - npx tsc --noEmit: clean - npm test: 1408 / 1409 (same pre-existing race-condition outstanding; no other regressions from the flip)
2026-06-09 14:58:25 -07:00
const brain = new Brainy({ requireSubtype: false,
storage: 'memory',
storageOptions: { path: ':memory:' }
})
await brain.init()
console.log(' ✅ Brainy initialized')
results.push({ test: 'Brainy init', passed: true })
// Test 6: Add document
console.log('6. Testing document add...')
const docId = await brain.add({ data: 'Machine learning concepts', type: 'concept' })
if (!docId || typeof docId !== 'string') {
throw new Error('Document add returned no ID')
}
console.log(` ✅ Document added: ${docId}`)
results.push({ test: 'Document add', passed: true })
// Test 7: Search
console.log('7. Testing semantic search...')
const searchResults = await brain.find('AI')
console.log(` ✅ Search returned ${searchResults.length} results`)
results.push({ test: 'Semantic search', passed: true })
// Test 8: Get document
console.log('8. Testing document retrieval...')
const retrieved = await brain.get(docId)
if (!retrieved) {
throw new Error('Document not found')
}
console.log(' ✅ Document retrieved')
results.push({ test: 'Document retrieval', passed: true })
await brain.close()
} catch (error) {
console.log(' ❌ Brainy test failed:', (error as Error).message)
results.push({ test: 'Brainy operations', passed: false, error: (error as Error).message })
}
// Summary
console.log('\n' + '='.repeat(50))
console.log('SUMMARY')
console.log('='.repeat(50))
const passed = results.filter(r => r.passed).length
const failed = results.filter(r => !r.passed).length
for (const r of results) {
console.log(`${r.passed ? '✅' : '❌'} ${r.test}${r.error ? `: ${r.error}` : ''}`)
}
console.log('')
console.log(`Passed: ${passed}/${results.length}`)
console.log(`Failed: ${failed}/${results.length}`)
if (failed > 0) {
console.log('\n❌ Some tests failed!')
process.exit(1)
} else {
console.log('\n✅ All tests passed! Brainy runs under Bun.')
process.exit(0)
}
}
// Run tests
testBunRuntime().catch(error => {
console.error('Fatal error:', error)
process.exit(1)
})