@neuroverseos/governance 0.3.4 → 0.4.0

package/dist/index.cjs

@@ -419,6 +419,67 @@ function parseValueLiteral(raw) {
   if (!isNaN(num) && raw.trim() !== "") return num;
   return raw;
 }
+function parseLenses(content, startLine, issues) {
+  const lenses = [];
+  const subSections = splitH2Sections(content, startLine);
+  for (const sub of subSections) {
+    const props = parseKeyValueBullets(sub.content);
+    const lineNum = sub.startLine;
+    const directives = [];
+    const lines = sub.content.split("\n");
+    let directiveIndex = 0;
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i].trim();
+      if (line.startsWith(">")) {
+        const blockContent = line.slice(1).trim();
+        const colonIdx = blockContent.indexOf(":");
+        if (colonIdx > 0) {
+          const scope = blockContent.slice(0, colonIdx).trim();
+          let instruction = blockContent.slice(colonIdx + 1).trim();
+          for (let j = i + 1; j < lines.length; j++) {
+            const nextLine = lines[j].trim();
+            if (nextLine.startsWith(">")) {
+              const nextContent = nextLine.slice(1).trim();
+              const nextColon = nextContent.indexOf(":");
+              if (nextColon > 0 && !nextContent.slice(0, nextColon).includes(" ")) {
+                break;
+              }
+              instruction += " " + nextContent;
+              i = j;
+            } else {
+              break;
+            }
+          }
+          directives.push({
+            id: `${sub.name}_directive_${directiveIndex++}`,
+            scope,
+            instruction,
+            line: startLine + i
+          });
+        }
+      }
+    }
+    const tags = (props.tags ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    const defaultForRoles = (props.default_for_roles ?? props.roles ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+    lenses.push({
+      id: sub.name,
+      name: props.name ?? sub.name,
+      tagline: props.tagline ?? "",
+      description: props.description ?? "",
+      tags,
+      formality: props.formality ?? "neutral",
+      verbosity: props.verbosity ?? "balanced",
+      emotion: props.emotion ?? "neutral",
+      confidence: props.confidence ?? "balanced",
+      defaultForRoles,
+      directives,
+      priority: props.priority ? parseInt(props.priority, 10) : 50,
+      stackable: props.stackable === "false" ? false : true,
+      line: lineNum
+    });
+  }
+  return lenses;
+}
 function parseWorldMarkdown(markdown) {
   const issues = [];
   const { frontmatter: fmRaw, sections } = splitSections(markdown);
@@ -456,8 +517,22 @@ function parseWorldMarkdown(markdown) {
   }
   const outcomesSection = findSection("Outcomes");
   const outcomes = outcomesSection ? parseOutcomes(outcomesSection.content, outcomesSection.startLine, issues) : [];
+  const lensesSection = findSection("Lenses");
+  const lenses = lensesSection ? parseLenses(lensesSection.content, lensesSection.startLine, issues) : [];
+  let lensPolicy;
+  let lensLockPin;
+  if (lensesSection) {
+    const topContent = lensesSection.content.split(/^##\s/m)[0];
+    const topProps = parseKeyValueBullets(topContent);
+    if (topProps.policy === "locked" || topProps.policy === "role_default" || topProps.policy === "user_choice") {
+      lensPolicy = topProps.policy;
+    }
+    if (topProps.lock_pin) {
+      lensLockPin = topProps.lock_pin;
+    }
+  }
   const parsedSections = sections.map((s) => s.name);
-  const knownSections = /* @__PURE__ */ new Set(["thesis", "invariants", "state", "assumptions", "rules", "gates", "outcomes"]);
+  const knownSections = /* @__PURE__ */ new Set(["thesis", "invariants", "state", "assumptions", "rules", "gates", "outcomes", "lenses"]);
   for (const section of sections) {
     if (!knownSections.has(section.name.toLowerCase())) {
       issues.push({
@@ -483,7 +558,10 @@ function parseWorldMarkdown(markdown) {
       assumptions,
       rules,
       gates,
-      outcomes
+      outcomes,
+      lenses,
+      lensPolicy,
+      lensLockPin
     },
     issues
   };
@@ -655,6 +733,36 @@ function emitWorldDefinition(parsed) {
       structural_indicators: rules.filter((r) => r.severity === "structural").map((r) => r.id)
     }
   };
+  const validScopes = /* @__PURE__ */ new Set(["response_framing", "language_style", "content_filtering", "value_emphasis", "behavior_shaping"]);
+  const lensConfigs = parsed.lenses.map((pl) => {
+    const directives = pl.directives.map((d) => ({
+      id: d.id,
+      scope: validScopes.has(d.scope) ? d.scope : "behavior_shaping",
+      instruction: d.instruction
+    }));
+    return {
+      id: pl.id,
+      name: pl.name,
+      tagline: pl.tagline,
+      description: pl.description,
+      tags: pl.tags,
+      tone: {
+        formality: pl.formality || "neutral",
+        verbosity: pl.verbosity || "balanced",
+        emotion: pl.emotion || "neutral",
+        confidence: pl.confidence || "balanced"
+      },
+      directives,
+      defaultForRoles: pl.defaultForRoles,
+      priority: pl.priority,
+      stackable: pl.stackable
+    };
+  });
+  const lensesConfig = lensConfigs.length > 0 ? {
+    lenses: lensConfigs,
+    ...parsed.lensPolicy ? { policy: parsed.lensPolicy } : {},
+    ...parsed.lensLockPin ? { lockPin: parsed.lensLockPin } : {}
+  } : void 0;
   const metadata = {
     format_version: "1.0.0",
     created_at: (/* @__PURE__ */ new Date()).toISOString(),
@@ -669,6 +777,7 @@ function emitWorldDefinition(parsed) {
     rules,
     gates,
     outcomes,
+    ...lensesConfig ? { lenses: lensesConfig } : {},
     metadata
   };
   return { world: worldDefinition, issues };
@@ -910,6 +1019,7 @@ __export(index_exports, {
   tickAgentStates: () => tickAgentStates,
   validateWorld: () => validateWorld,
   verdictToAuditEvent: () => verdictToAuditEvent,
+  verdictToEvent: () => verdictToEvent,
   writeTempWorld: () => writeTempWorld
 });
 module.exports = __toCommonJS(index_exports);
@@ -1297,6 +1407,33 @@ function evaluateGuard(event, world, options = {}) {
   let decidingId;
   const guardsMatched = [];
   const rulesMatched = [];
+  if (options.emergencyOverride) {
+    checkInvariantCoverage(world, invariantChecks);
+    return buildVerdict(
+      "ALLOW",
+      void 0,
+      "emergency-override",
+      "Emergency override active \u2014 all governance rules suspended. Platform constraints still apply.",
+      world,
+      level,
+      invariantChecks,
+      guardsMatched,
+      rulesMatched,
+      includeTrace ? buildTrace(
+        invariantChecks,
+        safetyChecks,
+        planCheckResult,
+        roleChecks,
+        guardChecks,
+        kernelRuleChecks,
+        levelChecks,
+        "session-allowlist",
+        "emergency-override",
+        startTime
+      ) : void 0,
+      event.intent
+    );
+  }
   checkInvariantCoverage(world, invariantChecks);
   if (event.roleId && options.agentStates) {
     const agentState = options.agentStates.get(event.roleId);
@@ -1361,7 +1498,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
     }
   }
@@ -1390,7 +1528,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   if (options.plan) {
@@ -1425,7 +1564,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
     }
   }
@@ -1454,7 +1594,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const guardVerdict = checkGuards(event, eventText, world, guardChecks, guardsMatched);
@@ -1492,7 +1633,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
       verdict.intentRecord = intentRecord;
       if (guardVerdict.consequence) verdict.consequence = guardVerdict.consequence;
@@ -1525,7 +1667,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const levelVerdict = checkLevelConstraints(event, level, levelChecks);
@@ -1553,7 +1696,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const warning = guardVerdict?.warning;
@@ -1578,7 +1722,8 @@ function evaluateGuard(event, world, options = {}) {
       decidingLayer,
       decidingId,
       startTime
-    ) : void 0
+    ) : void 0,
+    event.intent
   );
 }
 function checkInvariantCoverage(world, checks) {
@@ -1955,7 +2100,7 @@ function buildTrace(invariantChecks, safetyChecks, planCheck, roleChecks, guardC
   }
   return trace;
 }
-function buildVerdict(status, reason, ruleId, warning, world, level, invariantChecks, guardsMatched, rulesMatched, trace) {
+function buildVerdict(status, reason, ruleId, warning, world, level, invariantChecks, guardsMatched, rulesMatched, trace, eventIntent) {
   const evidence = {
     worldId: world.world.world_id,
     worldName: world.world.name,
@@ -1975,8 +2120,27 @@ function buildVerdict(status, reason, ruleId, warning, world, level, invariantCh
   if (ruleId) verdict.ruleId = ruleId;
   if (warning) verdict.warning = warning;
   if (trace) verdict.trace = trace;
+  verdict.event = verdictToEvent(status, eventIntent);
   return verdict;
 }
+function verdictToEvent(status, intent) {
+  const statusEventMap = {
+    ALLOW: "action_allowed",
+    BLOCK: "action_blocked",
+    PAUSE: "action_paused",
+    MODIFY: "action_modified",
+    PENALIZE: "action_penalized",
+    REWARD: "action_rewarded",
+    NEUTRAL: "action_neutral"
+  };
+  return {
+    type: intent || statusEventMap[status] || "unknown_action",
+    actor: "agent",
+    source: "guard",
+    timestamp: Date.now(),
+    guardStatus: status
+  };
+}
 
 // src/providers/ai-provider.ts
 var ChatCompletionsProvider = class {
@@ -6663,15 +6827,25 @@ function simulateWorld(world, options = {}) {
   let collapseStep;
   let collapseRule;
   const sortedRules = [...world.rules].sort((a, b) => a.order - b.order);
+  const allEvents = options.events ?? [];
+  const eventsByStep = Array.from({ length: steps }, () => []);
+  for (let i = 0; i < allEvents.length; i++) {
+    const stepIdx = Math.min(i, steps - 1);
+    eventsByStep[stepIdx].push(allEvents[i]);
+  }
+  let totalEventsConsumed = 0;
   for (let stepNum = 1; stepNum <= steps; stepNum++) {
     if (collapsed) break;
+    const stepEvents = eventsByStep[stepNum - 1];
     const stepResult = evaluateStep(
       stepNum,
       sortedRules,
       state,
       assumptions,
-      world
+      world,
+      stepEvents
     );
+    totalEventsConsumed += stepResult.eventsApplied.length;
     simulationSteps.push(stepResult);
     if (stepResult.collapsed) {
       collapsed = true;
@@ -6690,14 +6864,38 @@ function simulateWorld(world, options = {}) {
     finalViability,
     collapsed,
     collapseStep,
-    collapseRule
+    collapseRule,
+    eventsConsumed: totalEventsConsumed
   };
 }
-function evaluateStep(stepNum, rules, state, assumptions, world) {
+function evaluateStep(stepNum, rules, state, assumptions, world, events = []) {
   const evaluations = [];
+  const eventApplications = [];
   let rulesFired = 0;
   let collapsed = false;
   const firedRuleIds = /* @__PURE__ */ new Set();
+  for (const evt of events) {
+    const application = {
+      eventType: evt.type,
+      rulesTriggered: [],
+      effects: []
+    };
+    for (const rule of rules) {
+      const eventTrigger = rule.triggers.find(
+        (t) => t.field === "event" && t.source === "state"
+      );
+      if (!eventTrigger) continue;
+      const matches = evaluateOperator(evt.type, eventTrigger.operator, eventTrigger.value);
+      if (!matches) continue;
+      application.rulesTriggered.push(rule.id);
+      firedRuleIds.add(rule.id);
+      for (const effect of rule.effects ?? []) {
+        const applied = applyEffect(effect, state);
+        if (applied) application.effects.push(applied);
+      }
+    }
+    eventApplications.push(application);
+  }
   for (const rule of rules) {
     if (collapsed) {
       evaluations.push({
@@ -6782,6 +6980,7 @@ function evaluateStep(stepNum, rules, state, assumptions, world) {
   const viability = classifyViability(state, world);
   return {
     step: stepNum,
+    eventsApplied: eventApplications,
     rulesEvaluated: evaluations,
     rulesFired,
     stateAfter: { ...state },
@@ -6903,6 +7102,19 @@ function renderSimulateText(result) {
   lines.push("");
   for (const step of result.steps) {
     lines.push(`STEP ${step.step}`);
+    if (step.eventsApplied && step.eventsApplied.length > 0) {
+      for (const evt of step.eventsApplied) {
+        lines.push(`  EVENT: ${evt.eventType}`);
+        if (evt.rulesTriggered.length > 0) {
+          lines.push(`    Rules triggered: ${evt.rulesTriggered.join(", ")}`);
+        }
+        for (const effect of evt.effects) {
+          const beforeStr = formatValue(effect.before);
+          const afterStr = formatValue(effect.after);
+          lines.push(`    ${effect.target}: ${beforeStr} -> ${afterStr}`);
+        }
+      }
+    }
     const fired = step.rulesEvaluated.filter((r) => r.triggered);
     const skipped = step.rulesEvaluated.filter((r) => !r.triggered && !r.excluded);
     const excluded = step.rulesEvaluated.filter((r) => r.excluded);
@@ -6938,6 +7150,9 @@ function renderSimulateText(result) {
     lines.push(`  ${key}: ${formatValue(value)}${marker}`);
   }
   lines.push("");
+  if (result.eventsConsumed > 0) {
+    lines.push(`EVENTS CONSUMED: ${result.eventsConsumed}`);
+  }
   lines.push(`VIABILITY: ${result.finalViability}`);
   if (result.collapsed) {
     lines.push(`COLLAPSED at step ${result.collapseStep} (rule: ${result.collapseRule})`);
@@ -7734,5 +7949,6 @@ function handleCreateCapsule(body) {
   tickAgentStates,
   validateWorld,
   verdictToAuditEvent,
+  verdictToEvent,
   writeTempWorld
 });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { G as GuardEvent, W as WorldDefinition, b as GuardEngineOptions, a as GuardVerdict, P as PlanDefinition, S as StepEvidence, A as AdvanceResult, d as PlanVerdict, e as PlanCheck, c as PlanProgress, f as AgentBehaviorState, g as GuardStatus, C as Consequence, R as Reward, h as Guard, I as Invariant, i as Rule, V as ViabilityStatus } from './guard-contract-B7lplwm9.cjs';
-export { E as EvaluationTrace, j as GUARD_EXIT_CODES, k as GuardCheck, l as GuardExitCode, m as IntentRecord, n as InvariantCheck, K as KernelRuleCheck, L as LevelCheck, o as PLAN_EXIT_CODES, p as PlanCompletionMode, q as PlanConstraint, r as PlanExitCode, s as PlanStatus, t as PlanStep, u as PrecedenceResolution, v as RoleCheck, w as SafetyCheck, x as VerdictEvidence } from './guard-contract-B7lplwm9.cjs';
+import { G as GuardEvent, W as WorldDefinition, b as GuardEngineOptions, a as GuardVerdict, d as GuardStatus, e as GovernanceEvent, P as PlanDefinition, S as StepEvidence, A as AdvanceResult, f as PlanVerdict, g as PlanCheck, c as PlanProgress, h as AgentBehaviorState, C as Consequence, R as Reward, i as Guard, I as Invariant, j as Rule, V as ViabilityStatus } from './guard-contract-CLBbTGK_.cjs';
+export { E as EvaluationTrace, k as GUARD_EXIT_CODES, l as GuardCheck, m as GuardExitCode, n as IntentRecord, o as InvariantCheck, K as KernelRuleCheck, L as LevelCheck, p as PLAN_EXIT_CODES, q as PlanCompletionMode, r as PlanConstraint, s as PlanExitCode, t as PlanStatus, u as PlanStep, v as PrecedenceResolution, w as RoleCheck, x as SafetyCheck, y as VerdictEvidence } from './guard-contract-CLBbTGK_.cjs';
 
 /**
  * Guard Engine — Deterministic Governance Evaluator
@@ -43,6 +43,19 @@ declare function evaluateGuard(event: GuardEvent, world: WorldDefinition, option
  * rather than constructing keys manually.
  */
 declare function eventToAllowlistKey(event: GuardEvent): string;
+/**
+ * Convert a guard verdict into a GovernanceEvent.
+ *
+ * The guard evaluation log IS the event stream.
+ * No Kafka, no queues — just data flowing from Guard → Simulate.
+ *
+ * Mapping:
+ *   ALLOW  → "action_allowed"
+ *   BLOCK  → "action_blocked"
+ *   PAUSE  → "action_paused"
+ *   + semantic type from intent when available
+ */
+declare function verdictToEvent(status: GuardStatus, intent?: string): GovernanceEvent;
 
 /**
  * Derive Contract — AI-Assisted World Synthesis Types
@@ -1572,6 +1585,40 @@ interface ParsedOutcome {
     assignment?: string;
     line: number;
 }
+/**
+ * A parsed lens directive from the Lenses section.
+ */
+interface ParsedLensDirective {
+    id: string;
+    scope: string;
+    instruction: string;
+    line: number;
+}
+/**
+ * A parsed lens from the Lenses section.
+ * Each lens is an H2 subsection with key-value properties and directives.
+ */
+interface ParsedLens {
+    id: string;
+    name: string;
+    tagline: string;
+    description: string;
+    tags: string[];
+    /** Tone: formality, verbosity, emotion, confidence */
+    formality: string;
+    verbosity: string;
+    emotion: string;
+    confidence: string;
+    /** Which roles this lens is the default for */
+    defaultForRoles: string[];
+    /** Behavioral directives */
+    directives: ParsedLensDirective[];
+    /** Priority when stacking (higher = applied later) */
+    priority: number;
+    /** Whether it can be stacked with other lenses */
+    stackable: boolean;
+    line: number;
+}
 /**
  * The full parsed intermediate representation.
  */
@@ -1584,6 +1631,9 @@ interface ParsedWorld {
     rules: ParsedRule[];
     gates: ParsedGate[];
     outcomes: ParsedOutcome[];
+    lenses: ParsedLens[];
+    lensPolicy?: 'locked' | 'role_default' | 'user_choice';
+    lensLockPin?: string;
 }
 declare const BOOTSTRAP_EXIT_CODES: {
     readonly SUCCESS: 0;
@@ -2000,6 +2050,15 @@ interface SimulateOptions {
     stateOverrides?: Record<string, string | number | boolean>;
     /** Assumption profile to use (default: world default) */
     profile?: string;
+    /**
+     * Governance events to inject into the simulation.
+     * Events are applied before state-driven rules each step.
+     * This is the bridge: Guard → Events → Simulate → State Evolution.
+     *
+     * Events are distributed across steps (round-robin) or all applied to step 1
+     * if there are fewer steps than events.
+     */
+    events?: GovernanceEvent[];
 }
 interface SimulationResult {
     worldId: string;
@@ -2012,15 +2071,25 @@ interface SimulationResult {
     collapsed: boolean;
     collapseStep?: number;
     collapseRule?: string;
+    /** Total events consumed during simulation */
+    eventsConsumed: number;
 }
 interface SimulationStep {
     step: number;
+    /** Events applied during this step (before rules) */
+    eventsApplied: EventApplication[];
     rulesEvaluated: RuleEvaluation[];
     rulesFired: number;
     stateAfter: Record<string, string | number | boolean>;
     viability: ViabilityStatus;
     collapsed: boolean;
 }
+/** Record of an event applied during simulation */
+interface EventApplication {
+    eventType: string;
+    rulesTriggered: string[];
+    effects: AppliedEffect[];
+}
 interface RuleEvaluation {
     ruleId: string;
     label: string;
@@ -2347,4 +2416,4 @@ declare function handleCreateCapsule(body: {
     createdAt: string;
 };
 
-export { type AIGuardOptions, type AIGuardVerdict, type AIProvider, type AIProviderConfig, type ActionCategory, type Adaptation, type AddGuardInput, type AddInvariantInput, type AddResult, type AddRuleInput, AdvanceResult, type AgentAction, AgentBehaviorState, type AppliedEffect, type AuditEvent, type AuditLogger, type AuditSummary, BOOTSTRAP_EXIT_CODES, type BehavioralPattern, type BootstrapExitCode, type BootstrapResult, CONFIGURE_AI_EXIT_CODES, type ChatMessage, type ClassifiedIntent, type CollectedSource, CompositeAuditLogger, type Condition, type ConditionOperator, type ConditionResult, Consequence, ConsoleAuditLogger, type ConstructType, type ContentFields, DERIVE_EXIT_CODES, type DecisionFlow, type DecisionFlowMetrics, type DeriveExitCode, type DeriveFinding, type DeriveResult, type ExplainOutput, FileAuditLogger, type FindingCategory, type FindingSeverity, type FlowPath, type FormatVerdictOptions, type GovernanceEngineOptions, type GovernanceHealth, type Governor, type GovernorConfig, GuardEngineOptions, GuardEvent, GuardStatus, GuardVerdict, type ImpactReport, type ImprovementReport, type IntentClassifierOptions, type IntentCluster, type IntentSource, McpGovernanceServer, type McpServerConfig, ModelAdapter, type ModelConfig, type ModelResponse, type NetworkContext, type NormalizationSummary, type OutcomeCluster, PROVIDERS, type ParseIssue, type ParsedAssumptionProfile, type ParsedEffect, type ParsedFrontmatter, type ParsedGate, type ParsedInvariant, type ParsedOutcome, type ParsedRule, type ParsedStateVariable, type ParsedTrigger, type ParsedWorld, PlanCheck, PlanDefinition, type PlanParseResult, PlanProgress, PlanVerdict, type PreventionCategory, type ProviderPreset, Reward, type RuleEvaluation, type RuleObstacle, type SessionConfig, SessionManager, type SessionState, type SimulateOptions, type SimulationResult, type SimulationStep, StepEvidence, type Suggestion, type SuggestionCategory, type SuggestionPriority, type ToolCall, type ToolDefinition, VALIDATE_EXIT_CODES, type ValidateExitCode, type ValidateFinding, type ValidateReport, type ValidateSummary, type ValidationMode, type WorldInfo, type WorldState, actionToGuardEvent, adaptationFromVerdict, addGuard, addInvariant, addRule, advancePlan, applyConsequence, applyReward, buildPlanCheck, classifyAdaptation, classifyIntent, classifyIntentWithAI, createAgentState, createGovernanceEngine, createGovernor, deriveWorld, describeActiveWorld, detectBehavioralPatterns, emitWorldDefinition, evaluateCondition, evaluateGuard, evaluateGuardWithAI, evaluatePlan, eventToAllowlistKey, explainWorld, extractContentFields, extractWorldMarkdown, formatVerdict, formatVerdictOneLine, generateAdaptationNarrative, generateDecisionFlow, generateImpactReport, generateImpactReportFromFile, getActiveWorldName, getPlanProgress, govern, handleCreateCapsule, handleHealthCheck, handleListPresets, handleReasonRequest, improveWorld, listWorlds, loadWorld, loadWorldFromDirectory, normalizeWorldMarkdown, parseGuardDescription, parsePlanMarkdown, parseWorldMarkdown, readAuditLog, renderDecisionFlow, renderExplainText, renderImpactReport, renderImproveText, renderSimulateText, resolveProvider, resolveWorldPath, runInteractiveMode, runPipeMode, setActiveWorld, simulateWorld, summarizeAuditEvents, tickAgentStates, validateWorld, verdictToAuditEvent, writeTempWorld };
+export { type AIGuardOptions, type AIGuardVerdict, type AIProvider, type AIProviderConfig, type ActionCategory, type Adaptation, type AddGuardInput, type AddInvariantInput, type AddResult, type AddRuleInput, AdvanceResult, type AgentAction, AgentBehaviorState, type AppliedEffect, type AuditEvent, type AuditLogger, type AuditSummary, BOOTSTRAP_EXIT_CODES, type BehavioralPattern, type BootstrapExitCode, type BootstrapResult, CONFIGURE_AI_EXIT_CODES, type ChatMessage, type ClassifiedIntent, type CollectedSource, CompositeAuditLogger, type Condition, type ConditionOperator, type ConditionResult, Consequence, ConsoleAuditLogger, type ConstructType, type ContentFields, DERIVE_EXIT_CODES, type DecisionFlow, type DecisionFlowMetrics, type DeriveExitCode, type DeriveFinding, type DeriveResult, type EventApplication, type ExplainOutput, FileAuditLogger, type FindingCategory, type FindingSeverity, type FlowPath, type FormatVerdictOptions, type GovernanceEngineOptions, GovernanceEvent, type GovernanceHealth, type Governor, type GovernorConfig, GuardEngineOptions, GuardEvent, GuardStatus, GuardVerdict, type ImpactReport, type ImprovementReport, type IntentClassifierOptions, type IntentCluster, type IntentSource, McpGovernanceServer, type McpServerConfig, ModelAdapter, type ModelConfig, type ModelResponse, type NetworkContext, type NormalizationSummary, type OutcomeCluster, PROVIDERS, type ParseIssue, type ParsedAssumptionProfile, type ParsedEffect, type ParsedFrontmatter, type ParsedGate, type ParsedInvariant, type ParsedOutcome, type ParsedRule, type ParsedStateVariable, type ParsedTrigger, type ParsedWorld, PlanCheck, PlanDefinition, type PlanParseResult, PlanProgress, PlanVerdict, type PreventionCategory, type ProviderPreset, Reward, type RuleEvaluation, type RuleObstacle, type SessionConfig, SessionManager, type SessionState, type SimulateOptions, type SimulationResult, type SimulationStep, StepEvidence, type Suggestion, type SuggestionCategory, type SuggestionPriority, type ToolCall, type ToolDefinition, VALIDATE_EXIT_CODES, type ValidateExitCode, type ValidateFinding, type ValidateReport, type ValidateSummary, type ValidationMode, type WorldInfo, type WorldState, actionToGuardEvent, adaptationFromVerdict, addGuard, addInvariant, addRule, advancePlan, applyConsequence, applyReward, buildPlanCheck, classifyAdaptation, classifyIntent, classifyIntentWithAI, createAgentState, createGovernanceEngine, createGovernor, deriveWorld, describeActiveWorld, detectBehavioralPatterns, emitWorldDefinition, evaluateCondition, evaluateGuard, evaluateGuardWithAI, evaluatePlan, eventToAllowlistKey, explainWorld, extractContentFields, extractWorldMarkdown, formatVerdict, formatVerdictOneLine, generateAdaptationNarrative, generateDecisionFlow, generateImpactReport, generateImpactReportFromFile, getActiveWorldName, getPlanProgress, govern, handleCreateCapsule, handleHealthCheck, handleListPresets, handleReasonRequest, improveWorld, listWorlds, loadWorld, loadWorldFromDirectory, normalizeWorldMarkdown, parseGuardDescription, parsePlanMarkdown, parseWorldMarkdown, readAuditLog, renderDecisionFlow, renderExplainText, renderImpactReport, renderImproveText, renderSimulateText, resolveProvider, resolveWorldPath, runInteractiveMode, runPipeMode, setActiveWorld, simulateWorld, summarizeAuditEvents, tickAgentStates, validateWorld, verdictToAuditEvent, verdictToEvent, writeTempWorld };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { G as GuardEvent, W as WorldDefinition, b as GuardEngineOptions, a as GuardVerdict, P as PlanDefinition, S as StepEvidence, A as AdvanceResult, d as PlanVerdict, e as PlanCheck, c as PlanProgress, f as AgentBehaviorState, g as GuardStatus, C as Consequence, R as Reward, h as Guard, I as Invariant, i as Rule, V as ViabilityStatus } from './guard-contract-B7lplwm9.js';
-export { E as EvaluationTrace, j as GUARD_EXIT_CODES, k as GuardCheck, l as GuardExitCode, m as IntentRecord, n as InvariantCheck, K as KernelRuleCheck, L as LevelCheck, o as PLAN_EXIT_CODES, p as PlanCompletionMode, q as PlanConstraint, r as PlanExitCode, s as PlanStatus, t as PlanStep, u as PrecedenceResolution, v as RoleCheck, w as SafetyCheck, x as VerdictEvidence } from './guard-contract-B7lplwm9.js';
+import { G as GuardEvent, W as WorldDefinition, b as GuardEngineOptions, a as GuardVerdict, d as GuardStatus, e as GovernanceEvent, P as PlanDefinition, S as StepEvidence, A as AdvanceResult, f as PlanVerdict, g as PlanCheck, c as PlanProgress, h as AgentBehaviorState, C as Consequence, R as Reward, i as Guard, I as Invariant, j as Rule, V as ViabilityStatus } from './guard-contract-CLBbTGK_.js';
+export { E as EvaluationTrace, k as GUARD_EXIT_CODES, l as GuardCheck, m as GuardExitCode, n as IntentRecord, o as InvariantCheck, K as KernelRuleCheck, L as LevelCheck, p as PLAN_EXIT_CODES, q as PlanCompletionMode, r as PlanConstraint, s as PlanExitCode, t as PlanStatus, u as PlanStep, v as PrecedenceResolution, w as RoleCheck, x as SafetyCheck, y as VerdictEvidence } from './guard-contract-CLBbTGK_.js';
 
 /**
  * Guard Engine — Deterministic Governance Evaluator
@@ -43,6 +43,19 @@ declare function evaluateGuard(event: GuardEvent, world: WorldDefinition, option
  * rather than constructing keys manually.
  */
 declare function eventToAllowlistKey(event: GuardEvent): string;
+/**
+ * Convert a guard verdict into a GovernanceEvent.
+ *
+ * The guard evaluation log IS the event stream.
+ * No Kafka, no queues — just data flowing from Guard → Simulate.
+ *
+ * Mapping:
+ *   ALLOW  → "action_allowed"
+ *   BLOCK  → "action_blocked"
+ *   PAUSE  → "action_paused"
+ *   + semantic type from intent when available
+ */
+declare function verdictToEvent(status: GuardStatus, intent?: string): GovernanceEvent;
 
 /**
  * Derive Contract — AI-Assisted World Synthesis Types
@@ -1572,6 +1585,40 @@ interface ParsedOutcome {
     assignment?: string;
     line: number;
 }
+/**
+ * A parsed lens directive from the Lenses section.
+ */
+interface ParsedLensDirective {
+    id: string;
+    scope: string;
+    instruction: string;
+    line: number;
+}
+/**
+ * A parsed lens from the Lenses section.
+ * Each lens is an H2 subsection with key-value properties and directives.
+ */
+interface ParsedLens {
+    id: string;
+    name: string;
+    tagline: string;
+    description: string;
+    tags: string[];
+    /** Tone: formality, verbosity, emotion, confidence */
+    formality: string;
+    verbosity: string;
+    emotion: string;
+    confidence: string;
+    /** Which roles this lens is the default for */
+    defaultForRoles: string[];
+    /** Behavioral directives */
+    directives: ParsedLensDirective[];
+    /** Priority when stacking (higher = applied later) */
+    priority: number;
+    /** Whether it can be stacked with other lenses */
+    stackable: boolean;
+    line: number;
+}
 /**
  * The full parsed intermediate representation.
  */
@@ -1584,6 +1631,9 @@ interface ParsedWorld {
     rules: ParsedRule[];
     gates: ParsedGate[];
     outcomes: ParsedOutcome[];
+    lenses: ParsedLens[];
+    lensPolicy?: 'locked' | 'role_default' | 'user_choice';
+    lensLockPin?: string;
 }
 declare const BOOTSTRAP_EXIT_CODES: {
     readonly SUCCESS: 0;
@@ -2000,6 +2050,15 @@ interface SimulateOptions {
     stateOverrides?: Record<string, string | number | boolean>;
     /** Assumption profile to use (default: world default) */
     profile?: string;
+    /**
+     * Governance events to inject into the simulation.
+     * Events are applied before state-driven rules each step.
+     * This is the bridge: Guard → Events → Simulate → State Evolution.
+     *
+     * Events are distributed across steps (round-robin) or all applied to step 1
+     * if there are fewer steps than events.
+     */
+    events?: GovernanceEvent[];
 }
 interface SimulationResult {
     worldId: string;
@@ -2012,15 +2071,25 @@ interface SimulationResult {
     collapsed: boolean;
     collapseStep?: number;
     collapseRule?: string;
+    /** Total events consumed during simulation */
+    eventsConsumed: number;
 }
 interface SimulationStep {
     step: number;
+    /** Events applied during this step (before rules) */
+    eventsApplied: EventApplication[];
     rulesEvaluated: RuleEvaluation[];
     rulesFired: number;
     stateAfter: Record<string, string | number | boolean>;
     viability: ViabilityStatus;
     collapsed: boolean;
 }
+/** Record of an event applied during simulation */
+interface EventApplication {
+    eventType: string;
+    rulesTriggered: string[];
+    effects: AppliedEffect[];
+}
 interface RuleEvaluation {
     ruleId: string;
     label: string;
@@ -2347,4 +2416,4 @@ declare function handleCreateCapsule(body: {
     createdAt: string;
 };
 
-export { type AIGuardOptions, type AIGuardVerdict, type AIProvider, type AIProviderConfig, type ActionCategory, type Adaptation, type AddGuardInput, type AddInvariantInput, type AddResult, type AddRuleInput, AdvanceResult, type AgentAction, AgentBehaviorState, type AppliedEffect, type AuditEvent, type AuditLogger, type AuditSummary, BOOTSTRAP_EXIT_CODES, type BehavioralPattern, type BootstrapExitCode, type BootstrapResult, CONFIGURE_AI_EXIT_CODES, type ChatMessage, type ClassifiedIntent, type CollectedSource, CompositeAuditLogger, type Condition, type ConditionOperator, type ConditionResult, Consequence, ConsoleAuditLogger, type ConstructType, type ContentFields, DERIVE_EXIT_CODES, type DecisionFlow, type DecisionFlowMetrics, type DeriveExitCode, type DeriveFinding, type DeriveResult, type ExplainOutput, FileAuditLogger, type FindingCategory, type FindingSeverity, type FlowPath, type FormatVerdictOptions, type GovernanceEngineOptions, type GovernanceHealth, type Governor, type GovernorConfig, GuardEngineOptions, GuardEvent, GuardStatus, GuardVerdict, type ImpactReport, type ImprovementReport, type IntentClassifierOptions, type IntentCluster, type IntentSource, McpGovernanceServer, type McpServerConfig, ModelAdapter, type ModelConfig, type ModelResponse, type NetworkContext, type NormalizationSummary, type OutcomeCluster, PROVIDERS, type ParseIssue, type ParsedAssumptionProfile, type ParsedEffect, type ParsedFrontmatter, type ParsedGate, type ParsedInvariant, type ParsedOutcome, type ParsedRule, type ParsedStateVariable, type ParsedTrigger, type ParsedWorld, PlanCheck, PlanDefinition, type PlanParseResult, PlanProgress, PlanVerdict, type PreventionCategory, type ProviderPreset, Reward, type RuleEvaluation, type RuleObstacle, type SessionConfig, SessionManager, type SessionState, type SimulateOptions, type SimulationResult, type SimulationStep, StepEvidence, type Suggestion, type SuggestionCategory, type SuggestionPriority, type ToolCall, type ToolDefinition, VALIDATE_EXIT_CODES, type ValidateExitCode, type ValidateFinding, type ValidateReport, type ValidateSummary, type ValidationMode, type WorldInfo, type WorldState, actionToGuardEvent, adaptationFromVerdict, addGuard, addInvariant, addRule, advancePlan, applyConsequence, applyReward, buildPlanCheck, classifyAdaptation, classifyIntent, classifyIntentWithAI, createAgentState, createGovernanceEngine, createGovernor, deriveWorld, describeActiveWorld, detectBehavioralPatterns, emitWorldDefinition, evaluateCondition, evaluateGuard, evaluateGuardWithAI, evaluatePlan, eventToAllowlistKey, explainWorld, extractContentFields, extractWorldMarkdown, formatVerdict, formatVerdictOneLine, generateAdaptationNarrative, generateDecisionFlow, generateImpactReport, generateImpactReportFromFile, getActiveWorldName, getPlanProgress, govern, handleCreateCapsule, handleHealthCheck, handleListPresets, handleReasonRequest, improveWorld, listWorlds, loadWorld, loadWorldFromDirectory, normalizeWorldMarkdown, parseGuardDescription, parsePlanMarkdown, parseWorldMarkdown, readAuditLog, renderDecisionFlow, renderExplainText, renderImpactReport, renderImproveText, renderSimulateText, resolveProvider, resolveWorldPath, runInteractiveMode, runPipeMode, setActiveWorld, simulateWorld, summarizeAuditEvents, tickAgentStates, validateWorld, verdictToAuditEvent, writeTempWorld };
+export { type AIGuardOptions, type AIGuardVerdict, type AIProvider, type AIProviderConfig, type ActionCategory, type Adaptation, type AddGuardInput, type AddInvariantInput, type AddResult, type AddRuleInput, AdvanceResult, type AgentAction, AgentBehaviorState, type AppliedEffect, type AuditEvent, type AuditLogger, type AuditSummary, BOOTSTRAP_EXIT_CODES, type BehavioralPattern, type BootstrapExitCode, type BootstrapResult, CONFIGURE_AI_EXIT_CODES, type ChatMessage, type ClassifiedIntent, type CollectedSource, CompositeAuditLogger, type Condition, type ConditionOperator, type ConditionResult, Consequence, ConsoleAuditLogger, type ConstructType, type ContentFields, DERIVE_EXIT_CODES, type DecisionFlow, type DecisionFlowMetrics, type DeriveExitCode, type DeriveFinding, type DeriveResult, type EventApplication, type ExplainOutput, FileAuditLogger, type FindingCategory, type FindingSeverity, type FlowPath, type FormatVerdictOptions, type GovernanceEngineOptions, GovernanceEvent, type GovernanceHealth, type Governor, type GovernorConfig, GuardEngineOptions, GuardEvent, GuardStatus, GuardVerdict, type ImpactReport, type ImprovementReport, type IntentClassifierOptions, type IntentCluster, type IntentSource, McpGovernanceServer, type McpServerConfig, ModelAdapter, type ModelConfig, type ModelResponse, type NetworkContext, type NormalizationSummary, type OutcomeCluster, PROVIDERS, type ParseIssue, type ParsedAssumptionProfile, type ParsedEffect, type ParsedFrontmatter, type ParsedGate, type ParsedInvariant, type ParsedOutcome, type ParsedRule, type ParsedStateVariable, type ParsedTrigger, type ParsedWorld, PlanCheck, PlanDefinition, type PlanParseResult, PlanProgress, PlanVerdict, type PreventionCategory, type ProviderPreset, Reward, type RuleEvaluation, type RuleObstacle, type SessionConfig, SessionManager, type SessionState, type SimulateOptions, type SimulationResult, type SimulationStep, StepEvidence, type Suggestion, type SuggestionCategory, type SuggestionPriority, type ToolCall, type ToolDefinition, VALIDATE_EXIT_CODES, type ValidateExitCode, type ValidateFinding, type ValidateReport, type ValidateSummary, type ValidationMode, type WorldInfo, type WorldState, actionToGuardEvent, adaptationFromVerdict, addGuard, addInvariant, addRule, advancePlan, applyConsequence, applyReward, buildPlanCheck, classifyAdaptation, classifyIntent, classifyIntentWithAI, createAgentState, createGovernanceEngine, createGovernor, deriveWorld, describeActiveWorld, detectBehavioralPatterns, emitWorldDefinition, evaluateCondition, evaluateGuard, evaluateGuardWithAI, evaluatePlan, eventToAllowlistKey, explainWorld, extractContentFields, extractWorldMarkdown, formatVerdict, formatVerdictOneLine, generateAdaptationNarrative, generateDecisionFlow, generateImpactReport, generateImpactReportFromFile, getActiveWorldName, getPlanProgress, govern, handleCreateCapsule, handleHealthCheck, handleListPresets, handleReasonRequest, improveWorld, listWorlds, loadWorld, loadWorldFromDirectory, normalizeWorldMarkdown, parseGuardDescription, parsePlanMarkdown, parseWorldMarkdown, readAuditLog, renderDecisionFlow, renderExplainText, renderImpactReport, renderImproveText, renderSimulateText, resolveProvider, resolveWorldPath, runInteractiveMode, runPipeMode, setActiveWorld, simulateWorld, summarizeAuditEvents, tickAgentStates, validateWorld, verdictToAuditEvent, verdictToEvent, writeTempWorld };