@neuroverseos/governance 0.3.1 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neuroverseos/governance",
-  "version": "0.3.1",
+  "version": "0.3.4",
   "description": "Deterministic governance engine for AI agents — enforce worlds (permanent rules) and plans (mission constraints) with full audit trace",
   "license": "Apache-2.0",
   "type": "module",
@@ -60,7 +60,10 @@
   "files": [
     "dist",
     "dist/worlds",
+    "dist/viz",
+    "dist/browser.global.js",
     "policies",
+    "examples/social-media-sim",
     "simulate.html",
     "LICENSE.md",
     "README.md",
@@ -70,16 +73,26 @@
     ".well-known"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/cli/neuroverse.ts src/cli/plan.ts src/cli/run.ts src/adapters/index.ts src/adapters/langchain.ts src/adapters/openai.ts src/adapters/openclaw.ts src/adapters/express.ts src/adapters/autoresearch.ts src/adapters/deep-agents.ts --format esm,cjs --dts --clean && cp src/worlds/*.nv-world.md dist/worlds/",
+    "build": "tsup src/index.ts src/cli/neuroverse.ts src/cli/plan.ts src/cli/run.ts src/adapters/index.ts src/adapters/langchain.ts src/adapters/openai.ts src/adapters/openclaw.ts src/adapters/express.ts src/adapters/autoresearch.ts src/adapters/deep-agents.ts --format esm,cjs --dts --clean && npm run build:browser && cp src/worlds/*.nv-world.md dist/worlds/ && npm run build:viz",
+    "build:browser": "tsup src/browser.ts --format iife --global-name NeuroVerse --outDir dist --no-dts",
+    "build:viz": "vite build",
+    "dev:viz": "vite dev",
     "prebuild": "mkdir -p dist/worlds",
     "dev": "tsup src/index.ts src/cli/neuroverse.ts --format esm,cjs --dts --watch",
+    "prepublishOnly": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "devDependencies": {
     "@types/node": "^25.3.3",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",
+    "vite": "^8.0.1",
     "vitest": "^2.0.0"
   },
   "keywords": [
@@ -116,7 +129,7 @@
     "url": "https://github.com/NeuroverseOS/Neuroverseos-governance.git"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "homepage": "https://neuroverseos.com"
 }

package/simulate.html

@@ -727,6 +727,7 @@
   </div>
 </div>
 
+<script src="dist/browser.global.js"></script>
 <script>
 // ═══════════════════════════════════════════════════════════════════════════
 //  MATRIX RAIN
@@ -766,344 +767,11 @@ function drawMatrix() {
 setInterval(drawMatrix, 50);
 
 // ═══════════════════════════════════════════════════════════════════════════
-//  WORLD PARSER (Simplified .nv-world.md → WorldDefinition)
+//  ENGINE — loaded from dist/browser.global.js (NeuroVerse.simulateWorld,
+//  NeuroVerse.parseWorldMarkdown). One engine, one execution path, no drift.
 // ═══════════════════════════════════════════════════════════════════════════
 
-function parseWorldMarkdown(md) {
-  const world = {
-    world: { world_id: '', name: '', thesis: '', version: '1.0.0', runtime_mode: 'SIMULATION',
-      default_assumption_profile: '', default_alternative_profile: '', modules: [],
-      players: { thinking_space: true, experience_space: true, action_space: true } },
-    invariants: [],
-    assumptions: { profiles: {}, parameter_definitions: {} },
-    stateSchema: { variables: {}, presets: {} },
-    rules: [],
-    gates: { viability_classification: [], structural_override: { description: 'Structural violations override all gates', enforcement: 'mandatory' },
-      sustainability_threshold: 50, collapse_visual: { background: '#1a0000', text: '#ff4444', border: '#ff0000', label: 'COLLAPSED' } },
-    outcomes: { computed_outcomes: [], comparison_layout: { primary_card: '', status_badge: '', structural_indicators: [] } },
-    metadata: { format_version: '1.0.0', created_at: new Date().toISOString(), last_modified: new Date().toISOString(), authoring_method: 'manual-authoring' }
-  };
-
-  // Parse frontmatter
-  const fmMatch = md.match(/^---\n([\s\S]*?)\n---/);
-  if (fmMatch) {
-    const fm = fmMatch[1];
-    const getVal = (key) => { const m = fm.match(new RegExp(key + ':\\s*(.+)')); return m ? m[1].trim() : ''; };
-    world.world.world_id = getVal('world_id');
-    world.world.name = getVal('name');
-    world.world.version = getVal('version') || '1.0.0';
-    world.world.runtime_mode = getVal('runtime_mode') || 'SIMULATION';
-    world.world.default_assumption_profile = getVal('default_profile');
-    world.world.default_alternative_profile = getVal('alternative_profile');
-  }
-
-  // Split sections
-  const sections = {};
-  let currentSection = null;
-  for (const line of md.split('\n')) {
-    const h1 = line.match(/^# (.+)/);
-    if (h1) { currentSection = h1[1].trim().toLowerCase(); sections[currentSection] = ''; continue; }
-    if (currentSection) sections[currentSection] += line + '\n';
-  }
-
-  // Thesis
-  world.world.thesis = (sections['thesis'] || '').trim();
-
-  // Invariants
-  if (sections['invariants']) {
-    for (const line of sections['invariants'].split('\n')) {
-      const m = line.match(/^- `([^`]+)` — (.+?) \((\w+), (\w+)\)/);
-      if (m) world.invariants.push({ id: m[1], label: m[2], enforcement: m[3], mutable: false });
-    }
-  }
-
-  // State
-  if (sections['state']) {
-    let varId = null;
-    const vars = {};
-    for (const line of sections['state'].split('\n')) {
-      const h2 = line.match(/^## (\w+)/);
-      if (h2) { varId = h2[1]; vars[varId] = { type: 'number', default: 0, mutable: true, label: varId, description: '' }; continue; }
-      if (!varId) continue;
-      const kv = line.match(/^- (\w+):\s*(.+)/);
-      if (kv) {
-        const [, k, v] = kv;
-        if (k === 'type') vars[varId].type = v.trim();
-        else if (k === 'min') vars[varId].min = parseFloat(v);
-        else if (k === 'max') vars[varId].max = parseFloat(v);
-        else if (k === 'step') vars[varId].step = parseFloat(v);
-        else if (k === 'default') vars[varId].default = isNaN(+v) ? v.trim() : parseFloat(v);
-        else if (k === 'label') vars[varId].label = v.trim();
-        else if (k === 'description') vars[varId].description = v.trim();
-      }
-    }
-    world.stateSchema.variables = vars;
-  }
-
-  // Assumptions
-  if (sections['assumptions']) {
-    let profId = null;
-    for (const line of sections['assumptions'].split('\n')) {
-      const h2 = line.match(/^## (\w+)/);
-      if (h2) { profId = h2[1]; world.assumptions.profiles[profId] = { name: '', description: '', parameters: {} }; continue; }
-      if (!profId) continue;
-      const kv = line.match(/^- (\w+):\s*(.+)/);
-      if (kv) {
-        const [, k, v] = kv;
-        if (k === 'name') world.assumptions.profiles[profId].name = v.trim();
-        else if (k === 'description') world.assumptions.profiles[profId].description = v.trim();
-        else world.assumptions.profiles[profId].parameters[k] = v.trim();
-      }
-    }
-    if (world.world.default_assumption_profile) {
-      const p = world.assumptions.profiles[world.world.default_assumption_profile];
-      if (p) p.is_default_baseline = true;
-    }
-  }
-
-  // Rules
-  if (sections['rules']) {
-    const ruleBlocks = sections['rules'].split(/^## /m).filter(Boolean);
-    let order = 0;
-    for (const block of ruleBlocks) {
-      const headerMatch = block.match(/^(rule-\d+):\s*(.+?)\s*\((\w+)\)/);
-      if (!headerMatch) continue;
-      const [, ruleId, label, severity] = headerMatch;
-      const lines = block.split('\n');
-      let description = '';
-      const triggers = [];
-      const effects = [];
-      let collapseCheck = null;
-      const causal = { trigger_text: '', rule_text: '', shift_text: '', effect_text: '' };
-
-      for (const line of lines) {
-        // Triggers: When field op value [source] (AND field op value [source])*
-        const whenMatch = line.match(/^When (.+)/);
-        if (whenMatch) {
-          const parts = whenMatch[1].split(/\s+AND\s+/);
-          for (const part of parts) {
-            const tm = part.match(/(\w+)\s*(==|!=|>=|<=|>|<)\s*([\w.]+)\s*\[(\w+)\]/);
-            if (tm) triggers.push({ field: tm[1], operator: tm[2], value: isNaN(+tm[3]) ? tm[3] : parseFloat(tm[3]), source: tm[4] });
-          }
-        }
-        // Effects: Then target *= value or target += value
-        const thenMatch = line.match(/^Then (\w+)\s*(\*=|\+=|-=|=)\s*([\w.]+)/);
-        if (thenMatch) {
-          const opMap = { '*=': 'multiply', '+=': 'add', '-=': 'subtract', '=': 'set' };
-          effects.push({ target: thenMatch[1], operation: opMap[thenMatch[2]] || 'set', value: isNaN(+thenMatch[3]) ? thenMatch[3] : parseFloat(thenMatch[3]) });
-        }
-        // Collapse
-        const collapseMatch = line.match(/^Collapse:\s*(\w+)\s*(==|!=|>=|<=|>|<)\s*([\w.]+)/);
-        if (collapseMatch) {
-          collapseCheck = { field: collapseMatch[1], operator: collapseMatch[2], value: parseFloat(collapseMatch[3]), result: 'MODEL_COLLAPSES' };
-        }
-        // Causal
-        const causalMatch = line.match(/^> (\w+):\s*(.+)/);
-        if (causalMatch) causal[causalMatch[1] + '_text'] = causalMatch[2];
-
-        // Description (first non-header, non-directive line)
-        if (!line.startsWith('When ') && !line.startsWith('Then ') && !line.startsWith('Collapse:') && !line.startsWith('>') && !line.match(/^rule-/) && line.trim() && !description) {
-          description = line.trim();
-        }
-      }
-
-      world.rules.push({ id: ruleId, severity, label, description, order: order++, triggers, effects, collapse_check: collapseCheck, causal_translation: causal });
-      world.world.modules.push(ruleId);
-    }
-  }
-
-  // Gates
-  if (sections['gates']) {
-    const gateColors = { 0: '#00ff41', 1: '#00cc33', 2: '#ffaa00', 3: '#ff6600', 4: '#ff4444' };
-    const gateIcons = { 0: '\u2726', 1: '\u25CF', 2: '\u25B2', 3: '\u26A0', 4: '\u2715' };
-    let gi = 0;
-    for (const line of sections['gates'].split('\n')) {
-      const gm = line.match(/^- (\w+):\s*(\w+)\s*(>=|<=|>|<|==)\s*([\d.]+)/);
-      if (gm) {
-        world.gates.viability_classification.push({
-          status: gm[1], field: gm[2], operator: gm[3], value: parseFloat(gm[4]),
-          color: gateColors[gi] || '#888', icon: gateIcons[gi] || '?'
-        });
-        gi++;
-      }
-    }
-  }
-
-  // Outcomes
-  if (sections['outcomes']) {
-    let outId = null;
-    for (const line of sections['outcomes'].split('\n')) {
-      const h2 = line.match(/^## (\w+)/);
-      if (h2) {
-        outId = h2[1];
-        world.outcomes.computed_outcomes.push({ id: outId, type: 'number', label: outId, show_in_comparison: true });
-        continue;
-      }
-      if (!outId) continue;
-      const out = world.outcomes.computed_outcomes.find(o => o.id === outId);
-      if (!out) continue;
-      const kv = line.match(/^- (\w+):\s*(.+)/);
-      if (kv) {
-        if (kv[1] === 'type') out.type = kv[2].trim();
-        if (kv[1] === 'range') { const r = kv[2].match(/([\d.-]+)-([\d.-]+)/); if (r) out.range = [parseFloat(r[1]), parseFloat(r[2])]; }
-        if (kv[1] === 'display') out.display_as = kv[2].trim();
-        if (kv[1] === 'label') out.label = kv[2].trim();
-        if (kv[1] === 'primary' && kv[2].trim() === 'true') { out.primary = true; world.outcomes.comparison_layout.primary_card = outId; }
-      }
-    }
-  }
-
-  return world;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-//  SIMULATE ENGINE (Pure deterministic simulation)
-// ═══════════════════════════════════════════════════════════════════════════
-
-function evaluateOperator(fieldValue, operator, condValue) {
-  switch (operator) {
-    case '==': return fieldValue == condValue;
-    case '!=': return fieldValue != condValue;
-    case '>': return typeof fieldValue === 'number' && typeof condValue === 'number' && fieldValue > condValue;
-    case '<': return typeof fieldValue === 'number' && typeof condValue === 'number' && fieldValue < condValue;
-    case '>=': return typeof fieldValue === 'number' && typeof condValue === 'number' && fieldValue >= condValue;
-    case '<=': return typeof fieldValue === 'number' && typeof condValue === 'number' && fieldValue <= condValue;
-    default: return false;
-  }
-}
-
-function evaluateTriggers(triggers, state, assumptions) {
-  return triggers.every(t => {
-    const source = t.source === 'assumption' ? assumptions : state;
-    const val = source[t.field];
-    if (val === undefined) return false;
-    return evaluateOperator(val, t.operator, t.value);
-  });
-}
-
-function applyEffect(state, effect) {
-  const before = state[effect.target];
-  let after = before;
-  const val = typeof effect.value === 'number' ? effect.value : parseFloat(effect.value);
-
-  switch (effect.operation) {
-    case 'multiply': after = typeof before === 'number' ? before * val : before; break;
-    case 'add': after = typeof before === 'number' ? before + val : before; break;
-    case 'subtract': after = typeof before === 'number' ? before - val : before; break;
-    case 'set': after = val; break;
-  }
-
-  state[effect.target] = typeof after === 'number' ? Math.round(after * 100) / 100 : after;
-  return { target: effect.target, operation: effect.operation, value: effect.value, before, after: state[effect.target] };
-}
-
-function classifyViability(state, world) {
-  const gates = world.gates?.viability_classification ?? [];
-  for (const gate of gates) {
-    const val = state[gate.field];
-    if (typeof val !== 'number') continue;
-    if (evaluateOperator(val, gate.operator, gate.value)) return gate.status;
-  }
-  return 'MODEL_COLLAPSES';
-}
-
-function simulateWorld(world, options = {}) {
-  const steps = Math.min(50, Math.max(1, options.steps || 1));
-  const profile = options.profile || world.world.default_assumption_profile;
-
-  // Build initial state from schema defaults
-  const state = {};
-  for (const [k, v] of Object.entries(world.stateSchema.variables)) {
-    state[k] = v.default;
-  }
-
-  // Initialize outcome fields (primary outcome starts at 100)
-  for (const out of world.outcomes.computed_outcomes) {
-    if (out.primary && !(out.id in state)) state[out.id] = 100;
-    else if (!(out.id in state)) state[out.id] = out.default || 0;
-  }
-
-  // Apply state overrides
-  if (options.stateOverrides) {
-    for (const [k, v] of Object.entries(options.stateOverrides)) {
-      state[k] = v;
-    }
-  }
-
-  // Get assumption parameters
-  const assumptions = world.assumptions?.profiles?.[profile]?.parameters || {};
-
-  const initialState = { ...state };
-  const simSteps = [];
-  let collapsed = false;
-  let collapseStep, collapseRule;
-
-  for (let s = 0; s < steps; s++) {
-    const ruleEvals = [];
-    let firedThisStep = [];
-    let stepCollapsed = false;
-
-    for (const rule of world.rules) {
-      if (collapsed) {
-        ruleEvals.push({ ruleId: rule.id, label: rule.label, triggered: false, excluded: true, effects: [], collapsed: false, severity: rule.severity });
-        continue;
-      }
-
-      // Check exclusive_with
-      if (rule.exclusive_with && firedThisStep.includes(rule.exclusive_with)) {
-        ruleEvals.push({ ruleId: rule.id, label: rule.label, triggered: false, excluded: true, effects: [], collapsed: false, severity: rule.severity });
-        continue;
-      }
-
-      const triggered = evaluateTriggers(rule.triggers, state, assumptions);
-      const appliedEffects = [];
-
-      if (triggered) {
-        firedThisStep.push(rule.id);
-        for (const eff of (rule.effects || [])) {
-          appliedEffects.push(applyEffect(state, eff));
-        }
-
-        // Check collapse
-        if (rule.collapse_check) {
-          const cv = state[rule.collapse_check.field];
-          if (typeof cv === 'number' && evaluateOperator(cv, rule.collapse_check.operator, rule.collapse_check.value)) {
-            collapsed = true;
-            stepCollapsed = true;
-            collapseStep = s + 1;
-            collapseRule = rule.id;
-          }
-        }
-      }
-
-      ruleEvals.push({ ruleId: rule.id, label: rule.label, triggered, excluded: false, effects: appliedEffects, collapsed: stepCollapsed && triggered, severity: rule.severity });
-    }
-
-    simSteps.push({
-      step: s + 1,
-      rulesEvaluated: ruleEvals,
-      rulesFired: ruleEvals.filter(r => r.triggered).length,
-      stateAfter: { ...state },
-      viability: classifyViability(state, world),
-      collapsed: stepCollapsed
-    });
-
-    if (collapsed) break;
-  }
-
-  return {
-    worldId: world.world.world_id,
-    worldName: world.world.name,
-    profile,
-    initialState,
-    steps: simSteps,
-    finalState: { ...state },
-    finalViability: classifyViability(state, world),
-    collapsed,
-    collapseStep,
-    collapseRule
-  };
-}
+const { simulateWorld, parseWorldMarkdown } = NeuroVerse;
 
 // ═══════════════════════════════════════════════════════════════════════════
 //  PRE-BUNDLED WORLDS