2025-12-17 17:42:37 -08:00
/ * *
* Bun Compile Test
*
* Tests that Brainy works when compiled with ` bun build --compile ` .
* This verifies :
* 1 . No native binaries required ( pure WASM )
* 2 . Model is properly bundled
* 3 . Embeddings work without network access
*
* To test manually :
* bun build tests / integration / bun - compile - test . ts -- compile -- outfile / tmp / brainy - bun - test
* / t m p / b r a i n y - b u n - t e s t
* /
import { Brainy } from '../../dist/index.js'
import { embeddingManager } from '../../dist/embeddings/EmbeddingManager.js'
import { WASMEmbeddingEngine } from '../../dist/embeddings/wasm/index.js'
async function testBunCompile() {
const results : { test : string ; passed : boolean ; error? : string } [ ] = [ ]
console . log ( '🚀 Brainy Bun Compile 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 ,
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 {
console . log ( '\n✅ All tests passed! Brainy works with Bun compile.' )
process . exit ( 0 )
}
}
// Run tests
testBunCompile ( ) . catch ( error = > {
console . error ( 'Fatal error:' , error )
process . exit ( 1 )
} )