@neuroverseos/governance 0.5.0 → 0.6.0

package/dist/worlds/neuroverse-governance.worldmodel.md

@@ -0,0 +1,115 @@
+---
+name: NeuroVerse Governance
+version: 1.0.0
+---
+
+# Core Model Geometry
+
+## Mission
+Provide trustworthy, deterministic, and composable AI governance that any system can adopt, inspect, and evolve.
+
+## Domains
+
+### World Building
+
+#### Skills
+- Constitutional Design
+- State Modeling
+- Rule Authoring
+- Invariant Definition
+
+#### Values
+- Determinism over heuristics
+- Inspectability of all governance logic
+- Composability across systems
+
+### Behavioral Interpretation
+
+#### Skills
+- Signal Detection
+- Drift Analysis
+- Alignment Measurement
+- Emergence Recognition
+
+#### Values
+- Behavior over promises
+- Observation over inference
+- Patterns over isolated events
+
+### Governance Evolution
+
+#### Skills
+- Assumption Testing
+- Model Adaptation
+- Controlled Rollout
+- Impact Assessment
+
+#### Values
+- Stability before change
+- Evidence-based evolution
+- Human review of constitutional changes
+
+## Overlap Effects
+- World Building + Behavioral Interpretation = Structural Clarity
+- Behavioral Interpretation + Governance Evolution = Adaptive Trust
+- Governance Evolution + World Building = Principled Progress
+
+## Center Identity
+Trustworthy Governance Engine
+
+# Contextual Modifiers
+
+## Authority Layers
+- platform maintainer
+- world author
+- agent runtime
+- external consumer
+
+## Spatial Contexts
+- authoring
+- compilation
+- runtime evaluation
+- simulation
+- evolution
+
+## Interpretation Rules
+- governance failures in runtime evaluation are more critical than in simulation
+- world authors carry constitutional responsibility for invariant design
+- agent runtime behavior must be fully traceable to declared rules
+- external consumers should experience governance as transparent constraint, not black box
+- evolution proposals from simulation contexts require human confirmation before promotion
+
+# Evolution Layer
+
+## Aligned Behaviors
+- every guard verdict traces to a declared rule or invariant
+- world files remain human-readable and deterministically parseable
+- governance logic compiles without LLM dependency
+- changes to constitutional assumptions go through explicit review
+- new features compose with existing worlds without breaking them
+
+## Drift Behaviors
+- governance decisions that cannot be traced to source rules
+- world files that require AI to interpret
+- silent changes to invariants or thresholds
+- validation logic that produces different results on repeated runs
+- features that break existing world compatibility
+
+## Signals
+- determinism
+- traceability
+- composability
+- human_readability
+- backward_compatibility
+
+## Decision Priorities
+- correctness > convenience
+- determinism > expressiveness
+- backward_compatibility > new_features
+- traceability > performance
+
+## Evolution Conditions
+- when a world pattern appears in three or more independent adoptions, consider promoting to built-in
+- when validation rules produce false positives across multiple worlds, refine the rule
+- when new governance needs emerge that existing sections cannot express, propose a schema extension
+- require changelog entry for every constitutional change

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neuroverseos/governance",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Deterministic governance engine for AI agents — enforce worlds (permanent rules) and plans (mission constraints) with full audit trace",
   "license": "Apache-2.0",
   "type": "module",
@@ -57,6 +57,46 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./adapters/mentraos": {
+      "types": "./dist/adapters/mentraos.d.ts",
+      "import": "./dist/adapters/mentraos.js",
+      "require": "./dist/adapters/mentraos.cjs"
+    },
+    "./adapters/github": {
+      "types": "./dist/adapters/github.d.ts",
+      "import": "./dist/adapters/github.js",
+      "require": "./dist/adapters/github.cjs"
+    },
+    "./engine/guard-engine": {
+      "types": "./dist/engine/guard-engine.d.ts",
+      "import": "./dist/engine/guard-engine.js",
+      "require": "./dist/engine/guard-engine.cjs"
+    },
+    "./engine/simulate-engine": {
+      "types": "./dist/engine/simulate-engine.d.ts",
+      "import": "./dist/engine/simulate-engine.js",
+      "require": "./dist/engine/simulate-engine.cjs"
+    },
+    "./engine/bootstrap-parser": {
+      "types": "./dist/engine/bootstrap-parser.d.ts",
+      "import": "./dist/engine/bootstrap-parser.js",
+      "require": "./dist/engine/bootstrap-parser.cjs"
+    },
+    "./engine/bootstrap-emitter": {
+      "types": "./dist/engine/bootstrap-emitter.d.ts",
+      "import": "./dist/engine/bootstrap-emitter.js",
+      "require": "./dist/engine/bootstrap-emitter.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    },
+    "./admin": {
+      "types": "./dist/admin/index.d.ts",
+      "import": "./dist/admin/index.js",
+      "require": "./dist/admin/index.cjs"
     }
   },
   "bin": {
@@ -78,14 +118,15 @@
     ".well-known"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/cli/neuroverse.ts src/cli/plan.ts src/cli/run.ts src/adapters/index.ts src/adapters/langchain.ts src/adapters/openai.ts src/adapters/openclaw.ts src/adapters/express.ts src/adapters/autoresearch.ts src/adapters/deep-agents.ts src/spatial/index.ts --format esm,cjs --dts --clean && npm run build:browser && cp src/worlds/*.nv-world.md dist/worlds/ && cp src/spatial/zones/*.nv-world.md dist/worlds/ && npm run build:viz",
+    "prepare": "npm run build",
+    "build": "tsup src/index.ts src/types.ts src/cli/neuroverse.ts src/cli/plan.ts src/cli/run.ts src/cli/worldmodel.ts src/adapters/index.ts src/adapters/langchain.ts src/adapters/openai.ts src/adapters/openclaw.ts src/adapters/express.ts src/adapters/autoresearch.ts src/adapters/deep-agents.ts src/adapters/mentraos.ts src/adapters/github.ts src/engine/guard-engine.ts src/engine/simulate-engine.ts src/engine/bootstrap-parser.ts src/engine/bootstrap-emitter.ts src/engine/worldmodel-parser.ts src/engine/worldmodel-compiler.ts src/spatial/index.ts src/admin/index.ts --format esm,cjs --dts --clean && npm run build:browser && cp src/worlds/*.nv-world.md dist/worlds/ && cp src/worlds/*.worldmodel.md dist/worlds/ && cp src/spatial/zones/*.nv-world.md dist/worlds/ && npm run build:viz",
     "build:browser": "tsup src/browser.ts --format iife --global-name NeuroVerse --outDir dist --no-dts",
     "build:viz": "vite build",
     "dev:viz": "vite dev",
     "prebuild": "mkdir -p dist/worlds",
     "dev": "tsup src/index.ts src/cli/neuroverse.ts --format esm,cjs --dts --watch",
     "prepublishOnly": "npm run build",
-    "test": "vitest run",
+    "test": "node scripts-vitest-runner.mjs",
     "test:watch": "vitest"
   },
   "devDependencies": {

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

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

package/dist/{chunk-4G6WHPLI.js → chunk-735Z3HA4.js}

@@ -1,18 +1,18 @@
-import {
-  createProvider
-} from "./chunk-INWQHLPS.js";
 import {
   loadConfig
 } from "./chunk-OT6PXH54.js";
+import {
+  createProvider
+} from "./chunk-INWQHLPS.js";
 import {
   validateWorld
 } from "./chunk-7P3S7MAY.js";
-import {
-  parseWorldMarkdown
-} from "./chunk-3NZMMSOW.js";
 import {
   emitWorldDefinition
 } from "./chunk-YPCVY4GS.js";
+import {
+  parseWorldMarkdown
+} from "./chunk-3NZMMSOW.js";
 
 // src/engine/derive-normalizer.ts
 function findSections(lines) {

package/dist/{configure-ai-LL3VAPQW.js → configure-ai-5MP5DWTT.js}

@@ -1,15 +1,15 @@
 import {
   CONFIGURE_AI_EXIT_CODES
 } from "./chunk-FMSTRBBS.js";
-import {
-  createProvider
-} from "./chunk-INWQHLPS.js";
 import {
   getConfigPath,
   loadConfig,
   redactConfig,
   saveConfig
 } from "./chunk-OT6PXH54.js";
+import {
+  createProvider
+} from "./chunk-INWQHLPS.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/configure-ai.ts

package/dist/{decision-flow-3K4D72G4.js → decision-flow-IJPNMVQK.js}

@@ -1,10 +1,10 @@
-import {
-  readAuditLog
-} from "./chunk-2VAWP6FI.js";
 import {
   generateDecisionFlow,
   renderDecisionFlow
 } from "./chunk-D2UCV5AK.js";
+import {
+  readAuditLog
+} from "./chunk-2VAWP6FI.js";
 import "./chunk-ZAF6JH23.js";
 import "./chunk-QLPTHTVB.js";
 import "./chunk-QWGCMQQD.js";