@neuroverseos/governance 0.3.4 → 0.4.1

package/dist/adapters/openai.cjs

@@ -420,6 +420,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);
@@ -484,7 +511,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
     }
   }
@@ -513,7 +541,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   if (options.plan) {
@@ -548,7 +577,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
     }
   }
@@ -577,7 +607,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const guardVerdict = checkGuards(event, eventText, world, guardChecks, guardsMatched);
@@ -615,7 +646,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;
@@ -648,7 +680,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const levelVerdict = checkLevelConstraints(event, level, levelChecks);
@@ -676,7 +709,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const warning = guardVerdict?.warning;
@@ -701,7 +735,8 @@ function evaluateGuard(event, world, options = {}) {
       decidingLayer,
       decidingId,
       startTime
-    ) : void 0
+    ) : void 0,
+    event.intent
   );
 }
 function checkInvariantCoverage(world, checks) {
@@ -1078,7 +1113,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,
@@ -1098,8 +1133,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/loader/world-loader.ts
 async function loadWorldFromDirectory(dirPath) {

package/dist/adapters/openai.d.cts

@@ -1,5 +1,6 @@
-import { a as GuardVerdict, G as GuardEvent, P as PlanDefinition, c as PlanProgress, b as GuardEngineOptions, W as WorldDefinition } from '../guard-contract-B7lplwm9.cjs';
-import { G as GovernanceBlockedError$1 } from '../shared-C_zpdvBm.cjs';
+import { a as GuardVerdict, G as GuardEvent, P as PlanDefinition, c as PlanProgress, b as GuardEngineOptions } from '../guard-contract-C991HDZp.cjs';
+import { WorldDefinition } from '../types.cjs';
+import { G as GovernanceBlockedError$1 } from '../shared-DGnn1jiS.cjs';
 
 /**
  * NeuroVerse Adapter — OpenAI

package/dist/adapters/openai.d.ts

@@ -1,5 +1,6 @@
-import { a as GuardVerdict, G as GuardEvent, P as PlanDefinition, c as PlanProgress, b as GuardEngineOptions, W as WorldDefinition } from '../guard-contract-B7lplwm9.js';
-import { G as GovernanceBlockedError$1 } from '../shared-Cf7yxx4-.js';
+import { a as GuardVerdict, G as GuardEvent, P as PlanDefinition, c as PlanProgress, b as GuardEngineOptions } from '../guard-contract-hHjTTjtR.js';
+import { WorldDefinition } from '../types.js';
+import { G as GovernanceBlockedError$1 } from '../shared-U405h52W.js';
 
 /**
  * NeuroVerse Adapter — OpenAI

package/dist/adapters/openai.js

@@ -3,11 +3,11 @@ import {
   GovernedToolExecutor,
   createGovernedToolExecutor,
   createGovernedToolExecutorFromWorld
-} from "../chunk-4FLICVVA.js";
+} from "../chunk-FVOGUCB6.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-W7LLXRGY.js";
+import "../chunk-ZAF6JH23.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-QLPTHTVB.js";
-import "../chunk-CTZHONLA.js";
 import "../chunk-QWGCMQQD.js";
 export {
   GovernanceBlockedError,

package/dist/adapters/openclaw.cjs

@@ -420,6 +420,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);
@@ -484,7 +511,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
     }
   }
@@ -513,7 +541,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   if (options.plan) {
@@ -548,7 +577,8 @@ function evaluateGuard(event, world, options = {}) {
           decidingLayer,
           decidingId,
           startTime
-        ) : void 0
+        ) : void 0,
+        event.intent
       );
     }
   }
@@ -577,7 +607,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const guardVerdict = checkGuards(event, eventText, world, guardChecks, guardsMatched);
@@ -615,7 +646,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;
@@ -648,7 +680,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const levelVerdict = checkLevelConstraints(event, level, levelChecks);
@@ -676,7 +709,8 @@ function evaluateGuard(event, world, options = {}) {
         decidingLayer,
         decidingId,
         startTime
-      ) : void 0
+      ) : void 0,
+      event.intent
     );
   }
   const warning = guardVerdict?.warning;
@@ -701,7 +735,8 @@ function evaluateGuard(event, world, options = {}) {
       decidingLayer,
       decidingId,
       startTime
-    ) : void 0
+    ) : void 0,
+    event.intent
   );
 }
 function checkInvariantCoverage(world, checks) {
@@ -1078,7 +1113,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,
@@ -1098,8 +1133,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/loader/world-loader.ts
 async function loadWorldFromDirectory(dirPath) {

package/dist/adapters/openclaw.d.cts

@@ -1,5 +1,6 @@
-import { a as GuardVerdict, b as GuardEngineOptions, P as PlanDefinition, W as WorldDefinition, G as GuardEvent, c as PlanProgress } from '../guard-contract-B7lplwm9.cjs';
-import { G as GovernanceBlockedError$1 } from '../shared-C_zpdvBm.cjs';
+import { a as GuardVerdict, b as GuardEngineOptions, P as PlanDefinition, G as GuardEvent, c as PlanProgress } from '../guard-contract-C991HDZp.cjs';
+import { WorldDefinition } from '../types.cjs';
+import { G as GovernanceBlockedError$1 } from '../shared-DGnn1jiS.cjs';
 
 /**
  * NeuroVerse Adapter — OpenClaw

package/dist/adapters/openclaw.d.ts

@@ -1,5 +1,6 @@
-import { a as GuardVerdict, b as GuardEngineOptions, P as PlanDefinition, W as WorldDefinition, G as GuardEvent, c as PlanProgress } from '../guard-contract-B7lplwm9.js';
-import { G as GovernanceBlockedError$1 } from '../shared-Cf7yxx4-.js';
+import { a as GuardVerdict, b as GuardEngineOptions, P as PlanDefinition, G as GuardEvent, c as PlanProgress } from '../guard-contract-hHjTTjtR.js';
+import { WorldDefinition } from '../types.js';
+import { G as GovernanceBlockedError$1 } from '../shared-U405h52W.js';
 
 /**
  * NeuroVerse Adapter — OpenClaw

package/dist/adapters/openclaw.js

@@ -3,11 +3,11 @@ import {
   NeuroVersePlugin,
   createNeuroVersePlugin,
   createNeuroVersePluginFromWorld
-} from "../chunk-BNKJPUPQ.js";
+} from "../chunk-A7SHG75T.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-W7LLXRGY.js";
+import "../chunk-ZAF6JH23.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-QLPTHTVB.js";
-import "../chunk-CTZHONLA.js";
 import "../chunk-QWGCMQQD.js";
 export {
   GovernanceBlockedError,

package/dist/{add-ROOZLU62.js → add-XSANI3FK.js}

@@ -4,7 +4,7 @@ import {
   addRule,
   classifyIntent,
   parseGuardDescription
-} from "./chunk-5TPFNWRU.js";
+} from "./chunk-FS2UUJJO.js";
 import "./chunk-7P3S7MAY.js";
 import {
   describeActiveWorld,

package/dist/{behavioral-MJO34S6Q.js → behavioral-SLW7ALEK.js}

@@ -1,12 +1,12 @@
+import {
+  readAuditLog
+} from "./chunk-2VAWP6FI.js";
 import {
   adaptationFromVerdict,
   detectBehavioralPatterns,
   generateAdaptationNarrative
 } from "./chunk-CNSO6XW5.js";
-import {
-  readAuditLog
-} from "./chunk-A7GKPPU7.js";
-import "./chunk-W7LLXRGY.js";
+import "./chunk-ZAF6JH23.js";
 import "./chunk-QLPTHTVB.js";
 import "./chunk-QWGCMQQD.js";
 

package/dist/{bootstrap-CQRZVOXK.js → bootstrap-2OW5ZLBL.js}

@@ -1,12 +1,12 @@
 import {
   BOOTSTRAP_EXIT_CODES
 } from "./chunk-4NGDRRQH.js";
-import {
-  parseWorldMarkdown
-} from "./chunk-EMQDLDAF.js";
 import {
   emitWorldDefinition
-} from "./chunk-PVTQQS3Y.js";
+} from "./chunk-YPCVY4GS.js";
+import {
+  parseWorldMarkdown
+} from "./chunk-3NZMMSOW.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/bootstrap.ts

package/dist/bootstrap-contract-DcV6t-8M.d.cts

@@ -0,0 +1,216 @@
+/**
+ * Bootstrap Contract — Markdown → WorldDefinition Compilation Types
+ *
+ * Defines the input/output contract for `neuroverse bootstrap`.
+ *
+ * Input:  .nv-world.md file (structured markdown)
+ * Output: WorldDefinition (passed to validate, guard, or compileWorldToZip)
+ *
+ * The markdown format is:
+ *   - YAML frontmatter for world identity and metadata
+ *   - H1 sections for each block (Thesis, Invariants, State, etc.)
+ *   - Structured sub-sections within each block
+ *   - Deterministically parseable — no LLM, no heuristics
+ *
+ * Exit codes:
+ *   0 = SUCCESS  (compiled cleanly)
+ *   1 = FAIL     (parse errors, missing required sections)
+ *   3 = ERROR    (file not found, invalid input)
+ */
+type ParseSeverity = 'error' | 'warning' | 'info';
+/**
+ * A single parse issue found during markdown compilation.
+ */
+interface ParseIssue {
+    /** Line number in the source markdown (1-based) */
+    line: number;
+    /** Which section the issue was found in */
+    section: string;
+    /** Human-readable message */
+    message: string;
+    /** Severity */
+    severity: ParseSeverity;
+}
+/**
+ * The result of parsing a .nv-world.md file.
+ */
+interface BootstrapResult {
+    /** Whether compilation succeeded (no errors) */
+    success: boolean;
+    /** Source file path */
+    sourcePath: string;
+    /** All parse issues */
+    issues: ParseIssue[];
+    /** Parsed sections (for debugging) */
+    parsedSections: string[];
+    /** Duration */
+    durationMs: number;
+}
+/**
+ * YAML frontmatter parsed from the markdown header.
+ */
+interface ParsedFrontmatter {
+    world_id: string;
+    name: string;
+    version?: string;
+    runtime_mode?: string;
+    default_profile?: string;
+    alternative_profile?: string;
+}
+/**
+ * A parsed invariant from the Invariants section.
+ */
+interface ParsedInvariant {
+    id: string;
+    label: string;
+    enforcement: string;
+    mutable: boolean;
+    line: number;
+}
+/**
+ * A parsed state variable from the State section.
+ */
+interface ParsedStateVariable {
+    id: string;
+    type: 'number' | 'enum' | 'boolean';
+    default: string | number | boolean;
+    label: string;
+    description: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: string[];
+    line: number;
+}
+/**
+ * A parsed assumption profile from the Assumptions section.
+ */
+interface ParsedAssumptionProfile {
+    id: string;
+    name: string;
+    description: string;
+    parameters: Record<string, string | number | boolean>;
+    line: number;
+}
+/**
+ * A parsed trigger from a rule.
+ */
+interface ParsedTrigger {
+    field: string;
+    operator: string;
+    value: string | number | boolean;
+    source: 'state' | 'assumption';
+}
+/**
+ * A parsed effect from a rule.
+ */
+interface ParsedEffect {
+    target: string;
+    operation: string;
+    value: number | boolean | string;
+}
+/**
+ * A parsed rule from the Rules section.
+ */
+interface ParsedRule {
+    id: string;
+    label: string;
+    severity: string;
+    description?: string;
+    order: number;
+    triggers: ParsedTrigger[];
+    effects: ParsedEffect[];
+    collapse_check?: {
+        field: string;
+        operator: string;
+        value: number;
+    };
+    causal_translation?: {
+        trigger_text: string;
+        rule_text: string;
+        shift_text: string;
+        effect_text: string;
+    };
+    line: number;
+}
+/**
+ * A parsed gate from the Gates section.
+ */
+interface ParsedGate {
+    status: string;
+    field: string;
+    operator: string;
+    value: number;
+    line: number;
+}
+/**
+ * A parsed outcome from the Outcomes section.
+ */
+interface ParsedOutcome {
+    id: string;
+    type: string;
+    range?: [number, number];
+    display?: string;
+    label: string;
+    primary?: boolean;
+    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.
+ */
+interface ParsedWorld {
+    frontmatter: ParsedFrontmatter;
+    thesis: string;
+    invariants: ParsedInvariant[];
+    stateVariables: ParsedStateVariable[];
+    assumptions: ParsedAssumptionProfile[];
+    rules: ParsedRule[];
+    gates: ParsedGate[];
+    outcomes: ParsedOutcome[];
+    lenses: ParsedLens[];
+    lensPolicy?: 'locked' | 'role_default' | 'user_choice';
+    lensLockPin?: string;
+}
+declare const BOOTSTRAP_EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly FAIL: 1;
+    readonly ERROR: 3;
+};
+type BootstrapExitCode = (typeof BOOTSTRAP_EXIT_CODES)[keyof typeof BOOTSTRAP_EXIT_CODES];
+
+export { BOOTSTRAP_EXIT_CODES as B, type ParsedWorld as P, type ParseIssue as a, type BootstrapExitCode as b, type BootstrapResult as c, type ParsedAssumptionProfile as d, type ParsedEffect as e, type ParsedFrontmatter as f, type ParsedGate as g, type ParsedInvariant as h, type ParsedOutcome as i, type ParsedRule as j, type ParsedStateVariable as k, type ParsedTrigger as l };