@neuroverseos/nv-sim 0.1.6 → 0.1.9

package/dist/engine/narrativeInjection.js

@@ -127,126 +127,115 @@ function injectNarrative(reactions, event, stakeholders) {
 // PRESET NARRATIVE EVENTS
 // ============================================
 exports.NARRATIVE_PRESETS = {
-    // Trading / Financial
-    tanker_explosion: {
-        id: "tanker_explosion",
-        headline: "Oil tanker hit by missile in Strait of Hormuz",
-        severity: "extreme",
-        targets: ["Energy", "Traders", "Financial", "Algorithmic"],
+    // Social Simulation
+    viral_misinfo: {
+        id: "viral_misinfo",
+        headline: "Viral misinformation post spreads rapidly — no sources cited",
+        severity: "major",
+        targets: ["Content Creators", "Community Members", "Influencers", "Platform"],
         direction: "negative",
         propagation: "viral",
-        category: "geopolitical",
+        category: "social",
     },
-    rate_cut: {
-        id: "rate_cut",
-        headline: "Federal Reserve announces emergency rate cut",
+    influencer_stance_change: {
+        id: "influencer_stance_change",
+        headline: "Key influencer reverses stance — followers split",
         severity: "major",
-        targets: ["Central Banks", "Institutional", "Financial", "Market"],
-        direction: "positive",
-        propagation: "viral",
-        category: "monetary",
-    },
-    bank_collapse: {
-        id: "bank_collapse",
-        headline: "Major bank reports insolvency — contagion fears",
-        severity: "extreme",
-        targets: ["Institutional", "Retail", "Financial", "Market Makers"],
-        direction: "negative",
+        targets: ["Influencers", "Community Members", "Observers"],
+        direction: "mixed",
         propagation: "viral",
-        category: "financial",
+        category: "social",
     },
-    flash_crash_rumor: {
-        id: "flash_crash_rumor",
-        headline: "Rumors of algorithmic trading malfunction spread",
+    algorithm_change: {
+        id: "algorithm_change",
+        headline: "Platform algorithm change — viral threshold shifts overnight",
         severity: "moderate",
-        targets: ["Algorithmic", "Traders", "Retail"],
-        direction: "negative",
+        targets: ["Content Creators", "Influencers", "Platform", "Community Members"],
+        direction: "mixed",
         propagation: "normal",
-        category: "market",
+        category: "social",
     },
-    sanctions: {
-        id: "sanctions",
-        headline: "New economic sanctions imposed on major oil producer",
+    external_news_event: {
+        id: "external_news_event",
+        headline: "Breaking external news event floods the platform",
         severity: "major",
-        targets: ["Energy", "Government", "OPEC", "Oil"],
+        targets: ["Content Creators", "Community Members", "Influencers", "Observers"],
         direction: "negative",
-        propagation: "normal",
-        category: "geopolitical",
+        propagation: "viral",
+        category: "social",
     },
-    // Geopolitical
-    taiwan_exercises: {
-        id: "taiwan_exercises",
-        headline: "China begins military exercises near Taiwan",
+    coordinated_campaign: {
+        id: "coordinated_campaign",
+        headline: "Coordinated posting campaign detected — same content from multiple agents",
         severity: "major",
-        targets: ["Military", "Government", "Financial", "Traders"],
+        targets: ["Bad Actors", "Community Members", "Platform"],
         direction: "negative",
-        propagation: "viral",
-        category: "geopolitical",
+        propagation: "normal",
+        category: "social",
     },
-    diplomatic_breakthrough: {
-        id: "diplomatic_breakthrough",
-        headline: "Surprise diplomatic agreement reached — tensions ease",
+    whistleblower_post: {
+        id: "whistleblower_post",
+        headline: "Whistleblower post surfaces with sourced evidence — shifts discourse",
         severity: "major",
-        targets: ["Government", "Military", "Financial"],
+        targets: ["Community Members", "Influencers", "Observers", "Platform"],
         direction: "positive",
-        propagation: "normal",
-        category: "geopolitical",
+        propagation: "viral",
+        category: "social",
+    },
+    // Science / Research
+    search_literature: {
+        id: "search_literature",
+        headline: "Agent searches PubMed for peer-reviewed sources",
+        severity: "minor",
+        targets: ["Research Agent", "Peer Reviewers"],
+        direction: "positive",
+        propagation: "slow",
+        category: "research",
     },
-    ceasefire: {
-        id: "ceasefire",
-        headline: "Ceasefire announced — shipping lanes reopening",
+    analyze_findings: {
+        id: "analyze_findings",
+        headline: "Agent analyzes findings and extracts key mechanisms",
         severity: "moderate",
-        targets: ["Energy", "Military", "Government", "Consumers"],
+        targets: ["Research Agent", "Peer Reviewers"],
         direction: "positive",
-        propagation: "normal",
-        category: "geopolitical",
+        propagation: "slow",
+        category: "research",
     },
-    // Political / Regulatory
-    candidate_indicted: {
-        id: "candidate_indicted",
-        headline: "Leading candidate indicted on corruption charges",
-        severity: "major",
-        targets: ["Politicians", "Consumers", "Media"],
-        direction: "mixed",
-        propagation: "viral",
-        category: "political",
+    cross_reference: {
+        id: "cross_reference",
+        headline: "Agent cross-references sources for consistency",
+        severity: "moderate",
+        targets: ["Research Agent", "Peer Reviewers", "Journal Editors"],
+        direction: "positive",
+        propagation: "slow",
+        category: "research",
     },
-    regulation_shock: {
-        id: "regulation_shock",
-        headline: "Unexpected strict AI regulation passed overnight",
+    unsupported_claim: {
+        id: "unsupported_claim",
+        headline: "Agent attempts to publish claim without sufficient sources",
         severity: "major",
-        targets: ["Regulators", "EV", "Grid", "AI"],
+        targets: ["Research Agent", "Public", "Peer Reviewers"],
         direction: "negative",
         propagation: "normal",
-        category: "regulatory",
+        category: "research",
     },
-    stimulus_package: {
-        id: "stimulus_package",
-        headline: "Emergency fiscal stimulus package announced",
-        severity: "moderate",
-        targets: ["Government", "Consumers", "Financial"],
+    hypothesis_validated: {
+        id: "hypothesis_validated",
+        headline: "Hypothesis validated by multiple independent sources",
+        severity: "major",
+        targets: ["Research Agent", "Peer Reviewers", "Funding Bodies"],
         direction: "positive",
         propagation: "normal",
-        category: "economic",
+        category: "research",
     },
-    // Energy
-    grid_failure: {
-        id: "grid_failure",
-        headline: "Regional power grid failure — rolling blackouts",
+    publish_result: {
+        id: "publish_result",
+        headline: "Agent submits findings for publication",
         severity: "major",
-        targets: ["Grid", "Consumers", "EV", "Energy"],
-        direction: "negative",
+        targets: ["Research Agent", "Journal Editors", "Public", "Peer Reviewers"],
+        direction: "mixed",
         propagation: "normal",
-        category: "infrastructure",
-    },
-    oil_discovery: {
-        id: "oil_discovery",
-        headline: "Major new oil field discovered — supply outlook shifts",
-        severity: "moderate",
-        targets: ["Energy", "Oil", "OPEC", "Consumers"],
-        direction: "positive",
-        propagation: "slow",
-        category: "energy",
+        category: "research",
     },
 };
 // ============================================

package/dist/engine/policyEngine.js

@@ -72,18 +72,31 @@ const INTENT_PATTERNS = [
         enforcement: "advisory",
     },
 ];
-/** Keywords for variable detection */
+/** Keywords for variable detection — universal across any domain */
 const VARIABLE_KEYWORDS = {
+    // Universal dynamics
+    risk: ["risk", "exposure", "hazard", "danger", "threat", "unsafe"],
+    stability: ["stability", "stable", "equilibrium", "balance", "steady"],
+    trust: ["trust", "confidence", "credibility", "reputation", "integrity"],
+    quality: ["quality", "accuracy", "correctness", "fidelity", "rigor"],
+    activity: ["activity", "engagement", "participation", "active", "frequency", "rate"],
+    diversity: ["diversity", "diverse", "variety", "opinion", "viewpoint", "perspective"],
+    influence: ["influence", "power", "dominance", "monopoly", "concentration", "control"],
+    sentiment: ["sentiment", "polarity", "emotion", "tone", "negativity", "positivity"],
+    speed: ["speed", "velocity", "fast", "slow", "latency", "delay", "rapid", "throttle"],
+    volume: ["volume", "amount", "quantity", "count", "total", "throughput"],
+    compliance: ["compliance", "compliant", "conform", "adhere", "rule", "policy"],
+    transparency: ["transparency", "transparent", "visible", "audit", "traceable", "source", "attribution"],
+    coordination: ["coordination", "coordinated", "synchronized", "campaign", "collusion", "manipulation"],
+    // Financial (kept for backwards compat)
     liquidity: ["liquidity", "liquid", "cash", "capital", "reserve"],
     leverage: ["leverage", "leveraged", "margin", "borrowed", "debt"],
     volatility: ["volatility", "volatile", "vix", "fluctuation", "swing", "spike"],
     contagion: ["contagion", "spread", "cascade", "chain", "domino", "systemic"],
-    trade: ["trade", "trading", "transaction", "order", "position", "buy", "sell"],
-    price: ["price", "cost", "valuation", "rate", "tariff"],
-    risk: ["risk", "exposure", "hazard", "danger", "threat"],
-    stability: ["stability", "stable", "equilibrium", "balance"],
-    intervention: ["intervention", "intervene", "central bank", "regulator", "authority"],
-    panic: ["panic", "fear", "sentiment", "confidence", "trust"],
+    price: ["price", "cost", "valuation", "tariff"],
+    // Social simulation
+    echo_chamber: ["echo chamber", "echo_chamber", "filter bubble", "clustering", "polarization", "polarized"],
+    viral: ["viral", "amplification", "virality", "trending", "propagation"],
 };
 /**
  * Parse raw policy text into structured rules.
@@ -542,56 +555,103 @@ function applyQuickFix(policyText, fix) {
 // POLICY → WORLD CONVERSION
 // ============================================
 /**
- * Convert parsed policy rules into a WorldDefinitionLite for simulation.
+ * Convert parsed policy rules into a full WorldDefinitionLite.
+ *
+ * This is the core world generator. It takes plain-English rules and produces
+ * a complete governed world — the same structure as the built-in templates.
+ * The generated world has: thesis, state variables, invariants, and gates.
+ *
+ * State variables are inferred from the rules:
+ *   "Limit any agent to 15% of posts" → activity variable with range 0-100
+ *   "Block coordinated posting" → coordination variable (boolean/enum)
+ *   "Dampen sentiment shifts > 0.3" → sentiment variable with range 0-1
+ *
+ * Gates are generated from thresholds mentioned in rules:
+ *   "alert when diversity drops below 30" → gate: diversity < 30
+ *   "block when leverage exceeds 5x" → gate: leverage > 5
  */
 function policyToWorld(parsed) {
-    const invariants = parsed.rules.map((rule) => ({
-        id: rule.id.replace("RULE", "INV"),
+    const invariants = parsed.rules.map((rule, i) => ({
+        id: `INV-${String(i + 1).padStart(3, "0")}`,
         description: rule.description,
         enforceable: rule.enforcement === "structural",
     }));
-    const gates = [];
-    // Generate gates from circuit breakers and prohibitions
+    // Extract thresholds from rules (numbers mentioned in rule text)
+    const thresholdsByVar = new Map();
     for (const rule of parsed.rules) {
-        if (rule.category === "circuit_breaker") {
-            gates.push({
-                id: `GATE-${rule.id}`,
-                label: `Circuit Breaker: ${rule.description.slice(0, 60)}`,
-                condition: buildGateCondition(rule),
-                severity: "critical",
-            });
+        // Extract numeric thresholds: "limit X to 15%", "below 30", "exceeds 5x", "> 0.3"
+        const thresholdMatch = rule.description.match(/(?:(?:below|under|less than|drops? (?:below|under)|<)\s*(\d+(?:\.\d+)?)|(?:above|over|more than|exceeds?|greater than|>)\s*(\d+(?:\.\d+)?)|(?:to|at|limit(?:ed)? to|cap(?:ped)? at|maximum (?:of)?)\s*(\d+(?:\.\d+)?))/i);
+        if (thresholdMatch && rule.affectedVariables.length > 0) {
+            const belowVal = thresholdMatch[1] ? parseFloat(thresholdMatch[1]) : null;
+            const aboveVal = thresholdMatch[2] ? parseFloat(thresholdMatch[2]) : null;
+            const limitVal = thresholdMatch[3] ? parseFloat(thresholdMatch[3]) : null;
+            const primaryVar = rule.affectedVariables[0];
+            if (belowVal !== null) {
+                thresholdsByVar.set(primaryVar, { value: belowVal, direction: "below", ruleDesc: rule.description });
+            }
+            else if (aboveVal !== null) {
+                thresholdsByVar.set(primaryVar, { value: aboveVal, direction: "above", ruleDesc: rule.description });
+            }
+            else if (limitVal !== null) {
+                thresholdsByVar.set(primaryVar, { value: limitVal, direction: "above", ruleDesc: rule.description });
+            }
         }
-        else if (rule.category === "prohibit") {
-            gates.push({
-                id: `GATE-${rule.id}`,
-                label: `Block: ${rule.description.slice(0, 60)}`,
-                condition: buildGateCondition(rule),
-                severity: "critical",
-            });
+    }
+    // Build state variables from affected variables with smart defaults
+    const allVars = [...new Set(parsed.rules.flatMap((r) => r.affectedVariables))];
+    const stateVars = allVars.map((varName) => {
+        const threshold = thresholdsByVar.get(varName);
+        const varConfig = STATE_VARIABLE_DEFAULTS[varName];
+        if (varConfig) {
+            return { ...varConfig };
         }
-        else if (rule.category === "limit") {
-            gates.push({
-                id: `GATE-${rule.id}`,
-                label: `Limit: ${rule.description.slice(0, 60)}`,
-                condition: buildGateCondition(rule),
-                severity: "warning",
-            });
+        // Smart default: if we extracted a threshold, use it to set range and default
+        const maxVal = threshold ? Math.max(100, threshold.value * 2) : 100;
+        const defaultVal = threshold
+            ? (threshold.direction === "above" ? Math.round(threshold.value * 0.6) : Math.round(threshold.value * 1.5))
+            : 50;
+        return {
+            id: `${varName}_index`,
+            label: varName.charAt(0).toUpperCase() + varName.slice(1).replace(/_/g, " "),
+            type: "number",
+            range: { min: 0, max: maxVal },
+            default_value: Math.min(defaultVal, maxVal),
+        };
+    });
+    // Generate gates from rules with thresholds and from high-severity rules
+    const gates = [];
+    let gateIdx = 0;
+    // Gates from extracted thresholds
+    for (const [varName, threshold] of thresholdsByVar.entries()) {
+        gateIdx++;
+        const varId = STATE_VARIABLE_DEFAULTS[varName]?.id ?? `${varName}_index`;
+        const condition = threshold.direction === "below"
+            ? `${varId} < ${threshold.value}`
+            : `${varId} > ${threshold.value}`;
+        gates.push({
+            id: `GATE-${String(gateIdx).padStart(3, "0")}`,
+            label: `${varName.charAt(0).toUpperCase() + varName.slice(1).replace(/_/g, " ")} Threshold`,
+            condition,
+            severity: "warning",
+        });
+    }
+    // Gates from circuit breaker and prohibit rules that didn't produce threshold gates
+    for (const rule of parsed.rules) {
+        if (rule.category === "circuit_breaker" || rule.category === "prohibit") {
+            const hasThresholdGate = rule.affectedVariables.some((v) => thresholdsByVar.has(v));
+            if (!hasThresholdGate) {
+                gateIdx++;
+                gates.push({
+                    id: `GATE-${String(gateIdx).padStart(3, "0")}`,
+                    label: rule.description.slice(0, 60),
+                    condition: buildGateCondition(rule),
+                    severity: rule.category === "circuit_breaker" ? "critical" : "warning",
+                });
+            }
         }
     }
-    // Infer thesis from the policy
-    const enforced = parsed.rules.filter((r) => r.enforcement === "structural");
-    const thesis = enforced.length > 0
-        ? `Policy enforces ${enforced.length} structural constraints covering ${[...new Set(enforced.flatMap((r) => r.affectedVariables))].join(", ") || "system behavior"}`
-        : "Advisory policy providing guidelines without structural enforcement";
-    // Build state variables from affected variables
-    const allVars = [...new Set(parsed.rules.flatMap((r) => r.affectedVariables))];
-    const stateVars = allVars.map((varName) => ({
-        id: `${varName}_index`,
-        label: varName.charAt(0).toUpperCase() + varName.slice(1).replace(/_/g, " ") + " Index",
-        type: "number",
-        range: { min: 0, max: 100 },
-        default_value: 50,
-    }));
+    // Build thesis from the rules
+    const thesis = buildThesis(parsed);
     return {
         thesis,
         state_variables: stateVars,
@@ -599,23 +659,76 @@ function policyToWorld(parsed) {
         gates,
     };
 }
+/** Smart defaults for known variable types */
+const STATE_VARIABLE_DEFAULTS = {
+    diversity: { id: "opinion_diversity", label: "Opinion Diversity", type: "number", range: { min: 0, max: 100 }, default_value: 65 },
+    influence: { id: "influence_concentration", label: "Influence Concentration", type: "number", range: { min: 0, max: 100 }, default_value: 30 },
+    sentiment: { id: "sentiment_polarity", label: "Sentiment Polarity", type: "number", range: { min: 0, max: 100 }, default_value: 40 },
+    echo_chamber: { id: "echo_chamber_strength", label: "Echo Chamber Strength", type: "enum", enum_values: ["none", "forming", "established", "dominant"], default_value: "none" },
+    activity: { id: "engagement_rate", label: "Active Agent %", type: "number", range: { min: 0, max: 100 }, default_value: 60 },
+    viral: { id: "viral_threshold", label: "Viral Amplification Threshold", type: "number", range: { min: 1, max: 100 }, default_value: 20 },
+    risk: { id: "risk_level", label: "Risk Level", type: "number", range: { min: 0, max: 100 }, default_value: 40 },
+    stability: { id: "stability_index", label: "Stability", type: "number", range: { min: 0, max: 100 }, default_value: 65 },
+    trust: { id: "trust_level", label: "Trust Level", type: "number", range: { min: 0, max: 100 }, default_value: 60 },
+    quality: { id: "quality_score", label: "Quality Score", type: "number", range: { min: 0, max: 100 }, default_value: 50 },
+    compliance: { id: "compliance_rate", label: "Compliance Rate %", type: "number", range: { min: 0, max: 100 }, default_value: 70 },
+    transparency: { id: "transparency_index", label: "Transparency", type: "number", range: { min: 0, max: 100 }, default_value: 50 },
+    speed: { id: "action_speed", label: "Action Speed", type: "number", range: { min: 0, max: 100 }, default_value: 50 },
+    volume: { id: "action_volume", label: "Action Volume", type: "number", range: { min: 0, max: 100 }, default_value: 50 },
+    liquidity: { id: "liquidity_index", label: "Liquidity", type: "number", range: { min: 0, max: 100 }, default_value: 50 },
+    leverage: { id: "leverage_ratio", label: "Leverage Ratio", type: "number", range: { min: 1, max: 30 }, default_value: 5 },
+    volatility: { id: "volatility_index", label: "Volatility", type: "number", range: { min: 0, max: 100 }, default_value: 40 },
+    price: { id: "price_index", label: "Price Index", type: "number", range: { min: 0, max: 100 }, default_value: 50 },
+    contagion: { id: "contagion_level", label: "Contagion", type: "enum", enum_values: ["contained", "spreading", "systemic"], default_value: "contained" },
+    coordination: { id: "coordination_detected", label: "Coordinated Activity Detected", type: "boolean", default_value: false },
+};
+/**
+ * Build a thesis from the parsed rules — a one-sentence description of what
+ * this world governs and why.
+ */
+function buildThesis(parsed) {
+    const enforced = parsed.rules.filter((r) => r.enforcement === "structural");
+    if (enforced.length === 0) {
+        return "Advisory policy providing guidelines without structural enforcement";
+    }
+    // Collect the unique domain concepts from all rules
+    const allVars = [...new Set(enforced.flatMap((r) => r.affectedVariables))];
+    const categories = [...new Set(enforced.map((r) => r.category))];
+    // Build human-readable variable list
+    const varLabels = allVars.slice(0, 4).map((v) => {
+        const config = STATE_VARIABLE_DEFAULTS[v];
+        return config ? config.label.toLowerCase() : v.replace(/_/g, " ");
+    });
+    // Build action summary
+    const actions = [];
+    if (categories.includes("prohibit"))
+        actions.push("blocks harmful actions");
+    if (categories.includes("limit"))
+        actions.push("caps extreme behavior");
+    if (categories.includes("require"))
+        actions.push("enforces required standards");
+    if (categories.includes("circuit_breaker"))
+        actions.push("triggers circuit breakers");
+    if (categories.includes("monitor"))
+        actions.push("monitors critical thresholds");
+    const actionStr = actions.length > 0 ? actions.join(", ") : "enforces structural constraints";
+    const varStr = varLabels.length > 0 ? ` across ${varLabels.join(", ")}` : "";
+    return `This world ${actionStr}${varStr} — ${enforced.length} rule${enforced.length > 1 ? "s" : ""} governing agent behavior to maintain system integrity`;
+}
 function buildGateCondition(rule) {
     const vars = rule.affectedVariables;
     if (vars.length === 0)
         return "system_stress > 80";
     return vars
         .map((v) => {
-        if (v === "volatility")
-            return "volatility_index > 80";
-        if (v === "liquidity")
-            return "liquidity_index < 15";
-        if (v === "leverage")
-            return "leverage_ratio > 8";
-        if (v === "risk")
-            return "risk_index > 75";
-        if (v === "contagion")
-            return "contagion_spread == systemic";
-        return `${v}_index > 80`;
+        const config = STATE_VARIABLE_DEFAULTS[v];
+        const varId = config?.id ?? `${v}_index`;
+        // For "positive" variables (diversity, stability, trust), gate fires when LOW
+        // For "negative" variables (risk, volatility, contagion), gate fires when HIGH
+        const positiveVars = ["diversity", "stability", "trust", "quality", "compliance", "transparency", "liquidity"];
+        if (positiveVars.includes(v))
+            return `${varId} < 20`;
+        return `${varId} > 80`;
     })
         .join(" || ");
 }