Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

fix(ci): prime-radiant TS2307 install-safety failure β€” indirect the optional-wasm import (#2586)

rUv865dd7dd2b2a
diff --git a/scripts/audit-env-var-precedence.mjs b/scripts/audit-env-var-precedence.mjs
index b0e6419ed0..563534d330 100644
--- a/scripts/audit-env-var-precedence.mjs
+++ b/scripts/audit-env-var-precedence.mjs
@@ -57,6 +57,12 @@ const KNOWN_ESCAPE_HATCHES = new Set([
'RUFLO_SUBLINEAR_NATIVE', // Manual override for native vs WASM sublinear β€” CI/perf knob
'RUFLO_METAHARNESS_CACHE_BASE', // CI/test seam: relocates the ~/.ruflo pinned-cache root in metaharness smoke tests β€” intentionally env-only, plugin scripts have no CLI-flag surface
+ // ── Embedding substrate toggles (3.25.x β€” opt-in tier + fail-closed ops flag) ─
+ 'RUFLO_REQUIRE_REAL_EMBEDDINGS', // Fail-closed "no stubs" strict mode β€” deploy/CI ops toggle, not a per-invocation CLI flag (ADR-176)
+ 'RUFLO_EMBED_WASM_PKG', // Opt-in specifier for the optional WASM embedder tier β€” env-only deployment config, inert by default
+ 'RUFLO_LATTICE_WASM_PKG', // Back-compat alias of RUFLO_EMBED_WASM_PKG
+ 'RUFLO_EMBED_MODEL', // Model name for the optional WASM embedder β€” substrate config, env-only
+
// ── Feature flags (set by init into settings.json, not user-typed CLI) ──────
'CLAUDE_FLOW_V3_ENABLED',
'CLAUDE_FLOW_HOOKS_ENABLED',
diff --git a/v3/plugins/prime-radiant/src/plugin.ts b/v3/plugins/prime-radiant/src/plugin.ts
index 7dd9b64831..a6e7001ea5 100644
--- a/v3/plugins/prime-radiant/src/plugin.ts
+++ b/v3/plugins/prime-radiant/src/plugin.ts
@@ -124,7 +124,10 @@ class PrimeRadiantBridge implements IPrimeRadiantBridge {
private async loadWasmModule(): Promise<unknown> {
// Attempt to load the actual WASM module
try {
- const module = await import('prime-radiant-advanced-wasm');
+ // Specifier behind a string var so tsc doesn't statically resolve this
+ // optionalDependency at build time (TS2307 when it isn't installed).
+ const pkg: string = 'prime-radiant-advanced-wasm';
+ const module = await import(pkg);
if (module.default) {
await module.default();
}
diff --git a/v3/plugins/prime-radiant/src/wasm-bridge.ts b/v3/plugins/prime-radiant/src/wasm-bridge.ts
index b23fcceb79..15ac080047 100644
--- a/v3/plugins/prime-radiant/src/wasm-bridge.ts
+++ b/v3/plugins/prime-radiant/src/wasm-bridge.ts
@@ -176,7 +176,10 @@ export class WasmBridge {
private async loadWasmNode(wasmPath: string): Promise<void> {
try {
// Try dynamic import of the WASM package
- const primeRadiant = await import('prime-radiant-advanced-wasm');
+ // Specifier behind a string var so tsc doesn't statically resolve this
+ // optionalDependency at build time (TS2307 when it isn't installed).
+ const pkg: string = 'prime-radiant-advanced-wasm';
+ const primeRadiant = await import(pkg);
// Initialize the module
if (typeof primeRadiant.default === 'function') {
@@ -235,7 +238,10 @@ export class WasmBridge {
private async loadWasmBrowser(wasmPath: string): Promise<void> {
try {
// Try dynamic import first (bundler support)
- const primeRadiant = await import('prime-radiant-advanced-wasm');
+ // Specifier behind a string var so tsc doesn't statically resolve this
+ // optionalDependency at build time (TS2307 when it isn't installed).
+ const pkg: string = 'prime-radiant-advanced-wasm';
+ const primeRadiant = await import(pkg);
if (typeof primeRadiant.default === 'function') {
await primeRadiant.default();
diff --git a/v3/plugins/ruvector-upstream/src/bridges/attention.ts b/v3/plugins/ruvector-upstream/src/bridges/attention.ts
index efb258b169..9717a8cfff 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/attention.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/attention.ts
@@ -58,7 +58,7 @@ export class AttentionBridge implements WasmBridge<AttentionModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/attention-wasm').catch(() => null);
+ const wasmModule = await import('@ruvector/attention-wasm' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as AttentionModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/cognitive.ts b/v3/plugins/ruvector-upstream/src/bridges/cognitive.ts
index 2356309f41..27ed31afcf 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/cognitive.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/cognitive.ts
@@ -94,7 +94,7 @@ export class CognitiveBridge implements WasmBridge<CognitiveModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/cognitum-gate-kernel').catch(() => null);
+ const wasmModule = await import('@ruvector/cognitum-gate-kernel' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as CognitiveModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/exotic.ts b/v3/plugins/ruvector-upstream/src/bridges/exotic.ts
index 83b8c6eb19..b77c63657f 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/exotic.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/exotic.ts
@@ -88,7 +88,7 @@ export class ExoticBridge implements WasmBridge<ExoticModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/exotic-wasm').catch(() => null);
+ const wasmModule = await import('@ruvector/exotic-wasm' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as ExoticModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/gnn.ts b/v3/plugins/ruvector-upstream/src/bridges/gnn.ts
index e9ba0c5857..134eb0d2a9 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/gnn.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/gnn.ts
@@ -61,7 +61,7 @@ export class GnnBridge implements WasmBridge<GnnModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/gnn-wasm').catch(() => null);
+ const wasmModule = await import('@ruvector/gnn-wasm' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as GnnModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/hnsw.ts b/v3/plugins/ruvector-upstream/src/bridges/hnsw.ts
index 54cdddc571..e9504c9e28 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/hnsw.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/hnsw.ts
@@ -55,7 +55,7 @@ export class HnswBridge implements WasmBridge<HnswModule> {
try {
// Dynamic import of WASM module
- const wasmModule = await import('@ruvector/micro-hnsw-wasm').catch(() => null);
+ const wasmModule = await import('@ruvector/micro-hnsw-wasm' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as HnswModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/hyperbolic.ts b/v3/plugins/ruvector-upstream/src/bridges/hyperbolic.ts
index 1a5fe93c61..ae41e7b818 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/hyperbolic.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/hyperbolic.ts
@@ -67,7 +67,7 @@ export class HyperbolicBridge implements WasmBridge<HyperbolicModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/hyperbolic-hnsw-wasm').catch(() => null);
+ const wasmModule = await import('@ruvector/hyperbolic-hnsw-wasm' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as HyperbolicModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/learning.ts b/v3/plugins/ruvector-upstream/src/bridges/learning.ts
index c29a768648..37fd3826a3 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/learning.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/learning.ts
@@ -75,7 +75,7 @@ export class LearningBridge implements WasmBridge<LearningModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/learning-wasm').catch(() => null);
+ const wasmModule = await import('@ruvector/learning-wasm' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as LearningModule;
diff --git a/v3/plugins/ruvector-upstream/src/bridges/sona.ts b/v3/plugins/ruvector-upstream/src/bridges/sona.ts
index da34551c82..c7ef23d4a1 100644
--- a/v3/plugins/ruvector-upstream/src/bridges/sona.ts
+++ b/v3/plugins/ruvector-upstream/src/bridges/sona.ts
@@ -112,7 +112,7 @@ export class SonaBridge implements WasmBridge<SonaModule> {
this._status = 'loading';
try {
- const wasmModule = await import('@ruvector/sona').catch(() => null);
+ const wasmModule = await import('@ruvector/sona' as string).catch(() => null);
if (wasmModule) {
this._module = wasmModule as unknown as SonaModule;
diff --git a/v3/plugins/teammate-plugin/src/semantic-router.ts b/v3/plugins/teammate-plugin/src/semantic-router.ts
index 4d1302bfb4..af1e6a435d 100644
--- a/v3/plugins/teammate-plugin/src/semantic-router.ts
+++ b/v3/plugins/teammate-plugin/src/semantic-router.ts
@@ -17,7 +17,7 @@ async function loadNeuralBMSSP(): Promise<void> {
if (WasmNeuralBMSSP) return;
try {
- const bmssp = await import('@ruvnet/bmssp');
+ const bmssp = await import('@ruvnet/bmssp' as string);
await bmssp.default(); // Initialize WASM
WasmNeuralBMSSP = bmssp.WasmNeuralBMSSP;
} catch (error) {
diff --git a/v3/plugins/teammate-plugin/src/topology-optimizer.ts b/v3/plugins/teammate-plugin/src/topology-optimizer.ts
index 3e44c3fbc2..2b5c0f8f8f 100644
--- a/v3/plugins/teammate-plugin/src/topology-optimizer.ts
+++ b/v3/plugins/teammate-plugin/src/topology-optimizer.ts
@@ -17,7 +17,7 @@ async function loadBMSSP(): Promise<void> {
if (WasmGraph) return;
try {
- const bmssp = await import('@ruvnet/bmssp');
+ const bmssp = await import('@ruvnet/bmssp' as string);
await bmssp.default(); // Initialize WASM
WasmGraph = bmssp.WasmGraph;
} catch (error) {