2025-12-17 17:42:37 -08:00
|
|
|
/**
|
2026-07-01 09:16:46 -07:00
|
|
|
* Bun Runtime Test
|
2025-12-17 17:42:37 -08:00
|
|
|
*
|
2026-07-01 09:16:46 -07:00
|
|
|
* Tests that Brainy runs correctly under the Bun runtime (`bun add` / `bun run`) —
|
|
|
|
|
* the supported Bun story. Verifies:
|
2025-12-17 17:42:37 -08:00
|
|
|
* 1. No native binaries required (pure WASM)
|
|
|
|
|
* 2. Model is properly bundled
|
|
|
|
|
* 3. Embeddings work without network access
|
|
|
|
|
*
|
2026-07-01 09:16:46 -07:00
|
|
|
* To run manually:
|
|
|
|
|
* bun tests/integration/bun-runtime-test.ts
|
2025-12-17 17:42:37 -08:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
import { Brainy } from '../../dist/index.js'
|
|
|
|
|
import { embeddingManager } from '../../dist/embeddings/EmbeddingManager.js'
|
|
|
|
|
import { WASMEmbeddingEngine } from '../../dist/embeddings/wasm/index.js'
|
|
|
|
|
|
2026-07-01 09:16:46 -07:00
|
|
|
async function testBunRuntime() {
|
2025-12-17 17:42:37 -08:00
|
|
|
const results: { test: string; passed: boolean; error?: string }[] = []
|
|
|
|
|
|
2026-07-01 09:16:46 -07:00
|
|
|
console.log('🚀 Brainy Bun Runtime Test\n')
|
2025-12-17 17:42:37 -08:00
|
|
|
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,
|
2025-12-17 17:42:37 -08:00
|
|
|
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 {
|
2026-07-01 09:16:46 -07:00
|
|
|
console.log('\n✅ All tests passed! Brainy runs under Bun.')
|
2025-12-17 17:42:37 -08:00
|
|
|
process.exit(0)
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Run tests
|
2026-07-01 09:16:46 -07:00
|
|
|
testBunRuntime().catch(error => {
|
2025-12-17 17:42:37 -08:00
|
|
|
console.error('Fatal error:', error)
|
|
|
|
|
process.exit(1)
|
|
|
|
|
})
|