@neuroverseos/governance 0.4.0 → 0.5.0

package/dist/adapters/index.cjs

@@ -2779,6 +2779,7 @@ var MentraGovernedExecutor = class {
   _userRules;
   _emergencyOverride = false;
   _emergencyActivatedAt = null;
+  _spatialSession = null;
   constructor(world, options = {}, userRules = DEFAULT_USER_RULES) {
     this.world = world;
     this.options = options;
@@ -2835,13 +2836,36 @@ var MentraGovernedExecutor = class {
   get emergencyActivatedAt() {
     return this._emergencyActivatedAt;
   }
+  // ── Spatial Governance (optional) ────────────────────────────────────────
+  /**
+   * Attach a spatial session to this executor.
+   *
+   * When attached, intents are evaluated against the spatial context
+   * (zone rules + handshake rules) AFTER user rules but BEFORE
+   * hardware and platform checks. This is Layer 1.5.
+   *
+   * Pass null to detach (e.g., when leaving a zone).
+   */
+  setSpatialSession(session) {
+    this._spatialSession = session;
+  }
+  /** Whether a spatial session is currently active */
+  get hasSpatialSession() {
+    return this._spatialSession !== null;
+  }
+  /** Get the current spatial session description */
+  get spatialDescription() {
+    return this._spatialSession?.description ?? null;
+  }
   /**
    * Evaluate an intent against user rules + platform world.
    *
    * Three-layer evaluation:
-   *   0. Emergency override — if active, skip governance (layers 1 + 3),
+   *   0. Emergency override — if active, skip governance (layers 1 + 1.5 + 3),
    *      but STILL enforce platform constraints (layer 2)
    *   1. User rules check — personal governance override, can BLOCK or PAUSE
+   *   1.5. Spatial governance — zone + handshake rules (optional, temporary)
+   *      ↑ ONLY ACTIVE when a spatial session is attached
    *   2. Hardware capability check — validates glasses support
    *      ↑ THIS IS A PLATFORM CONSTRAINT — never overridden
    *   3. Platform guard engine — full world rule evaluation
@@ -2872,6 +2896,47 @@ var MentraGovernedExecutor = class {
         return result2;
       }
     }
+    if (!this._emergencyOverride && this._spatialSession) {
+      const spatialResult = this._spatialSession.evaluate(intent);
+      if (!spatialResult.allowed && !spatialResult.requiresConfirmation) {
+        const verdict2 = {
+          status: "BLOCK",
+          ruleId: "spatial-zone-rule",
+          reason: spatialResult.reason,
+          evidence: makeEvidence("spatial-zone-rule")
+        };
+        const result2 = {
+          allowed: false,
+          requiresConfirmation: false,
+          verdict: verdict2,
+          intentDef,
+          appContext,
+          decidingLayer: "spatial"
+        };
+        this.options.onBlock?.(result2);
+        this.options.onEvaluate?.(result2);
+        return result2;
+      }
+      if (spatialResult.requiresConfirmation) {
+        const verdict2 = {
+          status: "PAUSE",
+          ruleId: "spatial-zone-rule",
+          reason: spatialResult.reason,
+          evidence: makeEvidence("spatial-zone-rule")
+        };
+        const result2 = {
+          allowed: false,
+          requiresConfirmation: true,
+          verdict: verdict2,
+          intentDef,
+          appContext,
+          decidingLayer: "spatial"
+        };
+        this.options.onPause?.(result2);
+        this.options.onEvaluate?.(result2);
+        return result2;
+      }
+    }
     if (intentDef && glassesModel && !intentDef.supported_glasses.includes(glassesModel)) {
       const verdict2 = {
         status: "BLOCK",

package/dist/adapters/index.d.cts

@@ -112,6 +112,27 @@ declare function isAIIntent(intent: string): boolean;
  *   const result = executor.evaluate('ai_send_transcription', appContext);
  */
 
+/**
+ * Reference to a spatial governance session.
+ *
+ * When spatial governance is active, intents are evaluated against
+ * zone rules and handshake rules BEFORE the platform world.
+ * This is an optional layer — if no spatial session is attached,
+ * the executor works exactly as before.
+ *
+ * Import the full spatial module from '@neuroverseos/governance/spatial'
+ * for zone management, handshake negotiation, and session lifecycle.
+ */
+interface SpatialSessionRef {
+    /** Evaluate an intent against the spatial context */
+    evaluate: (intent: string) => {
+        allowed: boolean;
+        requiresConfirmation: boolean;
+        reason: string;
+    };
+    /** Human-readable description of the active spatial context */
+    description: string;
+}
 /**
  * Context for the current app session.
  * This replaces the old SpatialContext — grounded in real app data,
@@ -205,7 +226,7 @@ interface MentraGuardResult {
     /** The app context used for evaluation */
     appContext: AppContext;
     /** Which governance layer produced this verdict */
-    decidingLayer: 'user_rules' | 'hardware' | 'platform' | 'emergency_override';
+    decidingLayer: 'user_rules' | 'spatial' | 'hardware' | 'platform' | 'emergency_override';
 }
 interface MentraExecutorOptions {
     /** Include full evaluation trace in verdicts. Default: false. */
@@ -233,6 +254,7 @@ declare class MentraGovernedExecutor {
     private _userRules;
     private _emergencyOverride;
     private _emergencyActivatedAt;
+    private _spatialSession;
     constructor(world: WorldDefinition, options?: MentraExecutorOptions, userRules?: UserRules);
     /** Get the current user rules */
     get userRules(): UserRules;
@@ -257,13 +279,29 @@ declare class MentraGovernedExecutor {
     get isEmergencyOverrideActive(): boolean;
     /** Timestamp when emergency override was activated, or null */
     get emergencyActivatedAt(): number | null;
+    /**
+     * Attach a spatial session to this executor.
+     *
+     * When attached, intents are evaluated against the spatial context
+     * (zone rules + handshake rules) AFTER user rules but BEFORE
+     * hardware and platform checks. This is Layer 1.5.
+     *
+     * Pass null to detach (e.g., when leaving a zone).
+     */
+    setSpatialSession(session: SpatialSessionRef | null): void;
+    /** Whether a spatial session is currently active */
+    get hasSpatialSession(): boolean;
+    /** Get the current spatial session description */
+    get spatialDescription(): string | null;
     /**
      * Evaluate an intent against user rules + platform world.
      *
      * Three-layer evaluation:
-     *   0. Emergency override — if active, skip governance (layers 1 + 3),
+     *   0. Emergency override — if active, skip governance (layers 1 + 1.5 + 3),
      *      but STILL enforce platform constraints (layer 2)
      *   1. User rules check — personal governance override, can BLOCK or PAUSE
+     *   1.5. Spatial governance — zone + handshake rules (optional, temporary)
+     *      ↑ ONLY ACTIVE when a spatial session is attached
      *   2. Hardware capability check — validates glasses support
      *      ↑ THIS IS A PLATFORM CONSTRAINT — never overridden
      *   3. Platform guard engine — full world rule evaluation

package/dist/adapters/index.d.ts

@@ -112,6 +112,27 @@ declare function isAIIntent(intent: string): boolean;
  *   const result = executor.evaluate('ai_send_transcription', appContext);
  */
 
+/**
+ * Reference to a spatial governance session.
+ *
+ * When spatial governance is active, intents are evaluated against
+ * zone rules and handshake rules BEFORE the platform world.
+ * This is an optional layer — if no spatial session is attached,
+ * the executor works exactly as before.
+ *
+ * Import the full spatial module from '@neuroverseos/governance/spatial'
+ * for zone management, handshake negotiation, and session lifecycle.
+ */
+interface SpatialSessionRef {
+    /** Evaluate an intent against the spatial context */
+    evaluate: (intent: string) => {
+        allowed: boolean;
+        requiresConfirmation: boolean;
+        reason: string;
+    };
+    /** Human-readable description of the active spatial context */
+    description: string;
+}
 /**
  * Context for the current app session.
  * This replaces the old SpatialContext — grounded in real app data,
@@ -205,7 +226,7 @@ interface MentraGuardResult {
     /** The app context used for evaluation */
     appContext: AppContext;
     /** Which governance layer produced this verdict */
-    decidingLayer: 'user_rules' | 'hardware' | 'platform' | 'emergency_override';
+    decidingLayer: 'user_rules' | 'spatial' | 'hardware' | 'platform' | 'emergency_override';
 }
 interface MentraExecutorOptions {
     /** Include full evaluation trace in verdicts. Default: false. */
@@ -233,6 +254,7 @@ declare class MentraGovernedExecutor {
     private _userRules;
     private _emergencyOverride;
     private _emergencyActivatedAt;
+    private _spatialSession;
     constructor(world: WorldDefinition, options?: MentraExecutorOptions, userRules?: UserRules);
     /** Get the current user rules */
     get userRules(): UserRules;
@@ -257,13 +279,29 @@ declare class MentraGovernedExecutor {
     get isEmergencyOverrideActive(): boolean;
     /** Timestamp when emergency override was activated, or null */
     get emergencyActivatedAt(): number | null;
+    /**
+     * Attach a spatial session to this executor.
+     *
+     * When attached, intents are evaluated against the spatial context
+     * (zone rules + handshake rules) AFTER user rules but BEFORE
+     * hardware and platform checks. This is Layer 1.5.
+     *
+     * Pass null to detach (e.g., when leaving a zone).
+     */
+    setSpatialSession(session: SpatialSessionRef | null): void;
+    /** Whether a spatial session is currently active */
+    get hasSpatialSession(): boolean;
+    /** Get the current spatial session description */
+    get spatialDescription(): string | null;
     /**
      * Evaluate an intent against user rules + platform world.
      *
      * Three-layer evaluation:
-     *   0. Emergency override — if active, skip governance (layers 1 + 3),
+     *   0. Emergency override — if active, skip governance (layers 1 + 1.5 + 3),
      *      but STILL enforce platform constraints (layer 2)
      *   1. User rules check — personal governance override, can BLOCK or PAUSE
+     *   1.5. Spatial governance — zone + handshake rules (optional, temporary)
+     *      ↑ ONLY ACTIVE when a spatial session is attached
      *   2. Hardware capability check — validates glasses support
      *      ↑ THIS IS A PLATFORM CONSTRAINT — never overridden
      *   3. Platform guard engine — full world rule evaluation

package/dist/adapters/index.js

@@ -16,7 +16,7 @@ import {
   getMentraIntent,
   isAIIntent,
   isIntentSupported
-} from "../chunk-APU4OZIP.js";
+} from "../chunk-U6FRAEQJ.js";
 import {
   AutoresearchGovernor
 } from "../chunk-YNYCQECH.js";

package/dist/{build-THUEYMVT.js → build-SCAWPA7E.js}

@@ -2,12 +2,12 @@ import {
   DeriveInputError,
   DeriveProviderError,
   deriveWorld
-} from "./chunk-QZ666FCV.js";
+} from "./chunk-4G6WHPLI.js";
 import {
   DERIVE_EXIT_CODES
 } from "./chunk-FMSTRBBS.js";
-import "./chunk-OT6PXH54.js";
 import "./chunk-INWQHLPS.js";
+import "./chunk-OT6PXH54.js";
 import "./chunk-7P3S7MAY.js";
 import {
   parseWorldMarkdown

package/dist/{chunk-APU4OZIP.js → chunk-U6FRAEQJ.js}

@@ -632,6 +632,7 @@ var MentraGovernedExecutor = class {
   _userRules;
   _emergencyOverride = false;
   _emergencyActivatedAt = null;
+  _spatialSession = null;
   constructor(world, options = {}, userRules = DEFAULT_USER_RULES) {
     this.world = world;
     this.options = options;
@@ -688,13 +689,36 @@ var MentraGovernedExecutor = class {
   get emergencyActivatedAt() {
     return this._emergencyActivatedAt;
   }
+  // ── Spatial Governance (optional) ────────────────────────────────────────
+  /**
+   * Attach a spatial session to this executor.
+   *
+   * When attached, intents are evaluated against the spatial context
+   * (zone rules + handshake rules) AFTER user rules but BEFORE
+   * hardware and platform checks. This is Layer 1.5.
+   *
+   * Pass null to detach (e.g., when leaving a zone).
+   */
+  setSpatialSession(session) {
+    this._spatialSession = session;
+  }
+  /** Whether a spatial session is currently active */
+  get hasSpatialSession() {
+    return this._spatialSession !== null;
+  }
+  /** Get the current spatial session description */
+  get spatialDescription() {
+    return this._spatialSession?.description ?? null;
+  }
   /**
    * Evaluate an intent against user rules + platform world.
    *
    * Three-layer evaluation:
-   *   0. Emergency override — if active, skip governance (layers 1 + 3),
+   *   0. Emergency override — if active, skip governance (layers 1 + 1.5 + 3),
    *      but STILL enforce platform constraints (layer 2)
    *   1. User rules check — personal governance override, can BLOCK or PAUSE
+   *   1.5. Spatial governance — zone + handshake rules (optional, temporary)
+   *      ↑ ONLY ACTIVE when a spatial session is attached
    *   2. Hardware capability check — validates glasses support
    *      ↑ THIS IS A PLATFORM CONSTRAINT — never overridden
    *   3. Platform guard engine — full world rule evaluation
@@ -725,6 +749,47 @@ var MentraGovernedExecutor = class {
         return result2;
       }
     }
+    if (!this._emergencyOverride && this._spatialSession) {
+      const spatialResult = this._spatialSession.evaluate(intent);
+      if (!spatialResult.allowed && !spatialResult.requiresConfirmation) {
+        const verdict2 = {
+          status: "BLOCK",
+          ruleId: "spatial-zone-rule",
+          reason: spatialResult.reason,
+          evidence: makeEvidence("spatial-zone-rule")
+        };
+        const result2 = {
+          allowed: false,
+          requiresConfirmation: false,
+          verdict: verdict2,
+          intentDef,
+          appContext,
+          decidingLayer: "spatial"
+        };
+        this.options.onBlock?.(result2);
+        this.options.onEvaluate?.(result2);
+        return result2;
+      }
+      if (spatialResult.requiresConfirmation) {
+        const verdict2 = {
+          status: "PAUSE",
+          ruleId: "spatial-zone-rule",
+          reason: spatialResult.reason,
+          evidence: makeEvidence("spatial-zone-rule")
+        };
+        const result2 = {
+          allowed: false,
+          requiresConfirmation: true,
+          verdict: verdict2,
+          intentDef,
+          appContext,
+          decidingLayer: "spatial"
+        };
+        this.options.onPause?.(result2);
+        this.options.onEvaluate?.(result2);
+        return result2;
+      }
+    }
     if (intentDef && glassesModel && !intentDef.supported_glasses.includes(glassesModel)) {
       const verdict2 = {
         status: "BLOCK",

package/dist/cli/neuroverse.cjs

@@ -10525,6 +10525,7 @@ var init_mentraos = __esm({
       _userRules;
       _emergencyOverride = false;
       _emergencyActivatedAt = null;
+      _spatialSession = null;
       constructor(world, options = {}, userRules = DEFAULT_USER_RULES) {
         this.world = world;
         this.options = options;
@@ -10581,13 +10582,36 @@ var init_mentraos = __esm({
       get emergencyActivatedAt() {
         return this._emergencyActivatedAt;
       }
+      // ── Spatial Governance (optional) ────────────────────────────────────────
+      /**
+       * Attach a spatial session to this executor.
+       *
+       * When attached, intents are evaluated against the spatial context
+       * (zone rules + handshake rules) AFTER user rules but BEFORE
+       * hardware and platform checks. This is Layer 1.5.
+       *
+       * Pass null to detach (e.g., when leaving a zone).
+       */
+      setSpatialSession(session) {
+        this._spatialSession = session;
+      }
+      /** Whether a spatial session is currently active */
+      get hasSpatialSession() {
+        return this._spatialSession !== null;
+      }
+      /** Get the current spatial session description */
+      get spatialDescription() {
+        return this._spatialSession?.description ?? null;
+      }
       /**
        * Evaluate an intent against user rules + platform world.
        *
        * Three-layer evaluation:
-       *   0. Emergency override — if active, skip governance (layers 1 + 3),
+       *   0. Emergency override — if active, skip governance (layers 1 + 1.5 + 3),
        *      but STILL enforce platform constraints (layer 2)
        *   1. User rules check — personal governance override, can BLOCK or PAUSE
+       *   1.5. Spatial governance — zone + handshake rules (optional, temporary)
+       *      ↑ ONLY ACTIVE when a spatial session is attached
        *   2. Hardware capability check — validates glasses support
        *      ↑ THIS IS A PLATFORM CONSTRAINT — never overridden
        *   3. Platform guard engine — full world rule evaluation
@@ -10618,6 +10642,47 @@ var init_mentraos = __esm({
             return result2;
           }
         }
+        if (!this._emergencyOverride && this._spatialSession) {
+          const spatialResult = this._spatialSession.evaluate(intent);
+          if (!spatialResult.allowed && !spatialResult.requiresConfirmation) {
+            const verdict2 = {
+              status: "BLOCK",
+              ruleId: "spatial-zone-rule",
+              reason: spatialResult.reason,
+              evidence: makeEvidence("spatial-zone-rule")
+            };
+            const result2 = {
+              allowed: false,
+              requiresConfirmation: false,
+              verdict: verdict2,
+              intentDef,
+              appContext,
+              decidingLayer: "spatial"
+            };
+            this.options.onBlock?.(result2);
+            this.options.onEvaluate?.(result2);
+            return result2;
+          }
+          if (spatialResult.requiresConfirmation) {
+            const verdict2 = {
+              status: "PAUSE",
+              ruleId: "spatial-zone-rule",
+              reason: spatialResult.reason,
+              evidence: makeEvidence("spatial-zone-rule")
+            };
+            const result2 = {
+              allowed: false,
+              requiresConfirmation: true,
+              verdict: verdict2,
+              intentDef,
+              appContext,
+              decidingLayer: "spatial"
+            };
+            this.options.onPause?.(result2);
+            this.options.onEvaluate?.(result2);
+            return result2;
+          }
+        }
         if (intentDef && glassesModel && !intentDef.supported_glasses.includes(glassesModel)) {
           const verdict2 = {
             status: "BLOCK",

package/dist/cli/neuroverse.js

@@ -104,7 +104,7 @@ async function main() {
       return addMain(subArgs);
     }
     case "build": {
-      const { main: buildMain } = await import("../build-THUEYMVT.js");
+      const { main: buildMain } = await import("../build-SCAWPA7E.js");
       return buildMain(subArgs);
     }
     case "explain": {
@@ -156,7 +156,7 @@ async function main() {
       return demoMain(subArgs);
     }
     case "doctor": {
-      const { main: doctorMain } = await import("../doctor-WIO4FLA3.js");
+      const { main: doctorMain } = await import("../doctor-EY7LKSYY.js");
       return doctorMain(subArgs);
     }
     case "playground": {
@@ -196,7 +196,7 @@ async function main() {
       return worldMain(subArgs);
     }
     case "derive": {
-      const { main: deriveMain } = await import("../derive-5LOMN7GO.js");
+      const { main: deriveMain } = await import("../derive-AUQE3L3P.js");
       return deriveMain(subArgs);
     }
     case "decision-flow": {
@@ -208,7 +208,7 @@ async function main() {
       return equityPenaltiesMain(subArgs);
     }
     case "configure-ai": {
-      const { main: configureAiMain } = await import("../configure-ai-5MP5DWTT.js");
+      const { main: configureAiMain } = await import("../configure-ai-LL3VAPQW.js");
       return configureAiMain(subArgs);
     }
     case "configure-world": {

package/dist/{derive-5LOMN7GO.js → derive-AUQE3L3P.js}

@@ -2,12 +2,12 @@ import {
   DeriveInputError,
   DeriveProviderError,
   deriveWorld
-} from "./chunk-QZ666FCV.js";
+} from "./chunk-4G6WHPLI.js";
 import {
   DERIVE_EXIT_CODES
 } from "./chunk-FMSTRBBS.js";
-import "./chunk-OT6PXH54.js";
 import "./chunk-INWQHLPS.js";
+import "./chunk-OT6PXH54.js";
 import "./chunk-7P3S7MAY.js";
 import "./chunk-3NZMMSOW.js";
 import "./chunk-YPCVY4GS.js";

package/dist/{doctor-WIO4FLA3.js → doctor-EY7LKSYY.js}

@@ -12,7 +12,7 @@ var globImport_adapters = __glob({
   "../adapters/express.ts": () => import("./adapters/express.js"),
   "../adapters/index.ts": () => import("./adapters/index.js"),
   "../adapters/langchain.ts": () => import("./adapters/langchain.js"),
-  "../adapters/mentraos.ts": () => import("./mentraos-YFS7FMJH.js"),
+  "../adapters/mentraos.ts": () => import("./mentraos-LLH7KEV4.js"),
   "../adapters/openai.ts": () => import("./adapters/openai.js"),
   "../adapters/openclaw.ts": () => import("./adapters/openclaw.js"),
   "../adapters/shared.ts": () => import("./shared-7RLUHNMU.js")

package/dist/index.js

@@ -1,3 +1,14 @@
+import {
+  generateImpactReport,
+  generateImpactReportFromFile,
+  renderImpactReport
+} from "./chunk-OQU65525.js";
+import {
+  GUARD_EXIT_CODES,
+  classifyIntentWithAI,
+  evaluateGuardWithAI,
+  extractContentFields
+} from "./chunk-6CV4XG3J.js";
 import {
   actionToGuardEvent,
   createGovernor,
@@ -14,11 +25,6 @@ import {
   detectBehavioralPatterns,
   generateAdaptationNarrative
 } from "./chunk-CNSO6XW5.js";
-import {
-  generateImpactReport,
-  generateImpactReportFromFile,
-  renderImpactReport
-} from "./chunk-OQU65525.js";
 import {
   CompositeAuditLogger,
   ConsoleAuditLogger,
@@ -28,6 +34,10 @@ import {
   summarizeAuditEvents,
   verdictToAuditEvent
 } from "./chunk-2VAWP6FI.js";
+import {
+  explainWorld,
+  renderExplainText
+} from "./chunk-ZJTDUCC2.js";
 import {
   improveWorld,
   renderImproveText
@@ -43,11 +53,18 @@ import {
   VALIDATE_EXIT_CODES
 } from "./chunk-I3RRAYK2.js";
 import {
-  GUARD_EXIT_CODES,
-  classifyIntentWithAI,
-  evaluateGuardWithAI,
-  extractContentFields
-} from "./chunk-6CV4XG3J.js";
+  SessionManager,
+  runInteractiveMode,
+  runPipeMode
+} from "./chunk-UTH7OXTM.js";
+import {
+  applyConsequence,
+  applyReward,
+  createAgentState,
+  generateDecisionFlow,
+  renderDecisionFlow,
+  tickAgentStates
+} from "./chunk-D2UCV5AK.js";
 import {
   ModelAdapter,
   PROVIDERS,
@@ -67,20 +84,16 @@ import {
   deriveWorld,
   extractWorldMarkdown,
   normalizeWorldMarkdown
-} from "./chunk-QZ666FCV.js";
+} from "./chunk-4G6WHPLI.js";
 import {
   CONFIGURE_AI_EXIT_CODES,
   DERIVE_EXIT_CODES
 } from "./chunk-FMSTRBBS.js";
-import "./chunk-OT6PXH54.js";
 import "./chunk-INWQHLPS.js";
+import "./chunk-OT6PXH54.js";
 import {
   validateWorld
 } from "./chunk-7P3S7MAY.js";
-import {
-  explainWorld,
-  renderExplainText
-} from "./chunk-ZJTDUCC2.js";
 import {
   PLAN_EXIT_CODES,
   parsePlanMarkdown
@@ -98,19 +111,6 @@ import {
 import {
   emitWorldDefinition
 } from "./chunk-YPCVY4GS.js";
-import {
-  SessionManager,
-  runInteractiveMode,
-  runPipeMode
-} from "./chunk-UTH7OXTM.js";
-import {
-  applyConsequence,
-  applyReward,
-  createAgentState,
-  generateDecisionFlow,
-  renderDecisionFlow,
-  tickAgentStates
-} from "./chunk-D2UCV5AK.js";
 import {
   evaluateGuard,
   eventToAllowlistKey,

package/dist/{mentraos-YFS7FMJH.js → mentraos-LLH7KEV4.js}

@@ -17,7 +17,7 @@ import {
   getMentraIntent,
   isAIIntent,
   isIntentSupported
-} from "./chunk-APU4OZIP.js";
+} from "./chunk-U6FRAEQJ.js";
 import {
   GovernanceBlockedError
 } from "./chunk-5U2MQO5P.js";