@neuroverseos/governance 0.5.1 → 0.6.1

package/dist/worlds/behavioral-demo.nv-world.md

@@ -0,0 +1,177 @@
+---
+world_id: behavioral-demo
+name: Behavioral Governance Runtime
+version: 2.0.0
+default_profile: baseline
+alternative_profile: pressure
+---
+
+# Thesis
+
+Behavior should be interpreted through repeated action, clarity of ownership, and consistency between stated intent and follow-through. Decisions are governed by observed alignment, not stated confidence. When the system must choose — ship, delay, or escalate — it reads behavior, not promises.
+
+# Invariants
+
+- `behavior_over_promises` — Repeated action is stronger evidence than stated intent (structural, immutable)
+- `clarity_matters` — Ambiguity and ownership diffusion are meaningful behavioral signals (structural, immutable)
+- `decisions_follow_alignment` — Decisions must reflect measured alignment, not declared readiness (structural, immutable)
+
+# State
+
+## follow_through
+- type: number
+- min: 0
+- max: 100
+- step: 5
+- default: 70
+- label: Follow Through
+- description: Measures how consistently actions match stated commitments
+
+## clarity
+- type: number
+- min: 0
+- max: 100
+- step: 5
+- default: 75
+- label: Clarity
+- description: Measures directness and explicitness of communication
+
+## alignment_score
+- type: number
+- min: 0
+- max: 100
+- step: 5
+- default: 80
+- label: Alignment Score
+- description: Measures consistency between stated priorities and actual behavior
+
+## decision
+- type: enum
+- options: no_decision, ship_now, delay, escalate
+- default: no_decision
+- label: Decision
+- description: Governed output — what the system recommends based on behavioral alignment
+
+# Assumptions
+
+## baseline
+- name: Baseline
+- description: Normal operating conditions
+- pressure_level: medium
+
+## pressure
+- name: Pressure
+- description: Higher stress and ambiguity environment
+- pressure_level: high
+
+# Rules
+
+## rule-001: ambiguity erodes alignment (degradation)
+Repeated ambiguity weakens trust in stated intent.
+
+When clarity < 50 [state]
+Then alignment_score *= 0.80
+
+> trigger: Communication becomes vague or indirect.
+> rule: Reduced clarity lowers confidence in alignment.
+> shift: Interpretation becomes more cautious.
+> effect: Alignment score declines.
+
+## rule-002: weak follow-through erodes alignment (degradation)
+Failure to follow through consistently weakens credibility.
+
+When follow_through < 60 [state]
+Then alignment_score *= 0.75
+Collapse: alignment_score < 30
+
+> trigger: Commitments are not consistently honored.
+> rule: Action matters more than promises.
+> shift: Behavior is interpreted as misaligned.
+> effect: Alignment score drops sharply.
+
+## rule-003: strong execution reinforces alignment (advantage)
+Consistent action strengthens trust in intent.
+
+When follow_through >= 85 [state] AND clarity >= 80 [state]
+Then alignment_score *= 1.10
+
+> trigger: Clear communication and strong execution occur together.
+> rule: Consistency strengthens alignment.
+> shift: Interpretation becomes more confident.
+> effect: Alignment score improves.
+
+## rule-004: alignment supports shipping (advantage)
+Strong alignment produces a ship decision.
+
+When alignment_score >= 75 [state]
+Then decision = "ship_now"
+
+> trigger: Behavioral alignment is strong enough to act.
+> rule: When actions match intent consistently, the system recommends execution.
+> shift: Decision moves to ship.
+> effect: Decision set to ship_now.
+
+## rule-005: ambiguity requires delay (degradation)
+Moderate alignment produces a delay decision.
+
+When alignment_score < 75 [state] AND alignment_score >= 45 [state]
+Then decision = "delay"
+
+> trigger: Alignment is uncertain — behavior and intent are not fully consistent.
+> rule: When signals are mixed, the system recommends waiting for clarity.
+> shift: Decision moves to delay.
+> effect: Decision set to delay.
+
+## rule-006: misalignment triggers escalation (structural)
+Weak alignment produces an escalate decision.
+
+When alignment_score < 45 [state]
+Then decision = "escalate"
+
+> trigger: Behavioral alignment has degraded below acceptable threshold.
+> rule: When actions consistently contradict stated intent, the system escalates.
+> shift: Decision moves to escalate.
+> effect: Decision set to escalate.
+
+# Gates
+
+- STRONG: alignment_score >= 85
+- STABLE: alignment_score >= 65
+- WATCHING: alignment_score >= 45
+- FRAGILE: alignment_score > 30
+- MISALIGNED: alignment_score <= 30
+
+# Outcomes
+
+## alignment_score
+- type: number
+- range: 0-100
+- display: percentage
+- label: Alignment Score
+- primary: true
+
+## decision
+- type: enum
+- range: ship_now, delay, escalate, no_decision
+- display: label
+- label: Decision
+
+# Lenses
+- policy: role_default
+
+## behavioral-interpreter
+- tagline: Read patterns, not promises.
+- description: Interprets actions as signals, prioritizes repeated behavior over stated intent, and flags ambiguity, ownership diffusion, and misalignment.
+- formality: neutral
+- verbosity: concise
+- emotion: neutral
+- confidence: balanced
+- tags: behavior, signals, alignment, analysis
+- default_for_roles: all
+- priority: 65
+- stackable: true
+
+> response_framing: Prioritize observed behavior and follow-through over stated intent.
+> behavior_shaping: Look for repeated ambiguity, delay, or ownership diffusion as meaningful signals.
+> value_emphasis: Name alignment or misalignment between words and actions clearly.
+> content_filtering: Distinguish observed behavior from inference and speculation.

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.1",
+  "version": "0.6.1",
   "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",
@@ -97,6 +97,11 @@
       "types": "./dist/admin/index.d.ts",
       "import": "./dist/admin/index.js",
       "require": "./dist/admin/index.cjs"
+    },
+    "./radiant": {
+      "types": "./dist/radiant/index.d.ts",
+      "import": "./dist/radiant/index.js",
+      "require": "./dist/radiant/index.cjs"
     }
   },
   "bin": {
@@ -119,7 +124,7 @@
   ],
   "scripts": {
     "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/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/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/spatial/zones/*.nv-world.md dist/worlds/ && npm run build:viz",
+    "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/cli/radiant.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 src/radiant/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",

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-QZ666FCV.js → chunk-FHXXD2TI.js}

@@ -1,18 +1,18 @@
-import {
-  loadConfig
-} from "./chunk-OT6PXH54.js";
 import {
   createProvider
 } from "./chunk-INWQHLPS.js";
+import {
+  loadConfig
+} from "./chunk-OT6PXH54.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-5MP5DWTT.js → configure-ai-LL3VAPQW.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