@neuroverseos/governance 0.5.1 → 0.6.1

package/README.md

@@ -388,6 +388,61 @@ const overlay = compileLensOverlay([lens]);      // System prompt string
 | `role_default` | Starts as role default. User can override. |
 | `user_choice` | No default. User picks freely. |
 
+### Behavioral Lenses
+
+Lenses are not limited to tone and style. A **behavioral lens** interprets actions, flags patterns, and shapes how the system reads situations — not just how it speaks.
+
+The built-in `behavioral-interpreter` lens is the first behavioral governance overlay:
+
+```typescript
+import { BEHAVIORAL_INTERPRETER_LENS, compileLensOverlay } from '@neuroverseos/governance';
+
+const overlay = compileLensOverlay([BEHAVIORAL_INTERPRETER_LENS]);
+// → Directives that prioritize observed behavior over stated intent,
+//   flag ambiguity and ownership diffusion, and distinguish
+//   observed facts from inference and speculation.
+```
+
+Behavioral lenses can also be declared in world files:
+
+```markdown
+# Lenses
+- policy: role_default
+
+## behavioral-interpreter
+- tagline: Read patterns, not promises.
+- formality: neutral
+- verbosity: concise
+- emotion: neutral
+- confidence: balanced
+- tags: behavior, signals, alignment, analysis
+- default_for_roles: all
+- priority: 65
+
+> response_framing: Prioritize observed behavior over stated intent.
+> behavior_shaping: Detect repeated ambiguity, delay, or ownership diffusion.
+> value_emphasis: Name alignment or misalignment between words and actions.
+> content_filtering: Distinguish observed behavior from inference and speculation.
+```
+
+To extract and compile a behavioral lens from a world file:
+
+```typescript
+import { loadBundledWorld } from '@neuroverseos/governance/loader/world-loader';
+import { lensesFromWorld, compileLensOverlay } from '@neuroverseos/governance';
+
+const world = await loadBundledWorld('behavioral-demo');
+const lenses = lensesFromWorld(world);
+const overlay = compileLensOverlay(lenses);
+console.log(overlay.systemPromptAddition);
+```
+
+Run the end-to-end demo:
+
+```bash
+npx tsx examples/behavioral-lens-demo/demo.ts
+```
+
 ---
 
 ## Worlds: The Universal Container

package/dist/adapters/autoresearch.js

@@ -1,8 +1,8 @@
 import {
   AutoresearchGovernor,
   createAutoresearchGovernor
-} from "../chunk-TL4DLMMW.js";
-import "../chunk-EQUAWNXW.js";
+} from "../chunk-TJ5L2UTE.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/deep-agents.js

@@ -3,9 +3,9 @@ import {
   GovernanceBlockedError,
   createDeepAgentsGuard,
   createDeepAgentsGuardFromWorld
-} from "../chunk-5RAQ5DZW.js";
+} from "../chunk-T6GMRZWC.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/express.js

@@ -1,8 +1,8 @@
 import {
   createGovernanceMiddleware,
   createGovernanceMiddlewareFromWorld
-} from "../chunk-6UPEUMJ2.js";
-import "../chunk-EQUAWNXW.js";
+} from "../chunk-HDNDL6D5.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/github.js

@@ -8,9 +8,9 @@ import {
   createGitHubWebhookHandlerFromWorld,
   formatForActions,
   formatPRComment
-} from "../chunk-FGOSKQDE.js";
+} from "../chunk-A2UZTLRV.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/index.js

@@ -4,19 +4,19 @@ import {
   createMentraGovernedExecutor,
   createMentraGovernedExecutorFromWorld,
   evaluateUserRules
-} from "../chunk-7UU7V3AD.js";
+} from "../chunk-IOVXB6QN.js";
 import {
   GovernanceBlockedError as GovernanceBlockedError4,
   GovernedToolExecutor,
   createGovernedToolExecutor,
   createGovernedToolExecutorFromWorld
-} from "../chunk-R23T5SZG.js";
+} from "../chunk-B3IIPTY3.js";
 import {
   GovernanceBlockedError as GovernanceBlockedError5,
   NeuroVersePlugin,
   createNeuroVersePlugin,
   createNeuroVersePluginFromWorld
-} from "../chunk-RF2L5SYG.js";
+} from "../chunk-TIXVEPS2.js";
 import {
   MENTRA_INTENT_TAXONOMY,
   MENTRA_KNOWN_INTENTS,
@@ -33,23 +33,23 @@ import {
 } from "../chunk-GJ6LM4JZ.js";
 import {
   AutoresearchGovernor
-} from "../chunk-TL4DLMMW.js";
+} from "../chunk-TJ5L2UTE.js";
 import {
   DeepAgentsGuard,
   GovernanceBlockedError as GovernanceBlockedError2,
   createDeepAgentsGuard,
   createDeepAgentsGuardFromWorld
-} from "../chunk-5RAQ5DZW.js";
+} from "../chunk-T6GMRZWC.js";
 import {
   createGovernanceMiddleware,
   createGovernanceMiddlewareFromWorld
-} from "../chunk-6UPEUMJ2.js";
+} from "../chunk-HDNDL6D5.js";
 import {
   GovernanceBlockedError as GovernanceBlockedError3,
   NeuroVerseCallbackHandler,
   createNeuroVerseCallbackHandler,
   createNeuroVerseCallbackHandlerFromWorld
-} from "../chunk-UZBW44KD.js";
+} from "../chunk-FKQCPRKI.js";
 import {
   GovernanceBlockedError,
   buildEngineOptions,
@@ -57,7 +57,7 @@ import {
   extractScope,
   trackPlanProgress
 } from "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/langchain.js

@@ -3,9 +3,9 @@ import {
   NeuroVerseCallbackHandler,
   createNeuroVerseCallbackHandler,
   createNeuroVerseCallbackHandlerFromWorld
-} from "../chunk-UZBW44KD.js";
+} from "../chunk-FKQCPRKI.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/mentraos.js

@@ -4,7 +4,7 @@ import {
   createMentraGovernedExecutor,
   createMentraGovernedExecutorFromWorld,
   evaluateUserRules
-} from "../chunk-7UU7V3AD.js";
+} from "../chunk-IOVXB6QN.js";
 import {
   MENTRA_INTENT_MAP,
   MENTRA_INTENT_TAXONOMY,
@@ -23,7 +23,7 @@ import {
 import {
   GovernanceBlockedError
 } from "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/openai.js

@@ -3,9 +3,9 @@ import {
   GovernedToolExecutor,
   createGovernedToolExecutor,
   createGovernedToolExecutorFromWorld
-} from "../chunk-R23T5SZG.js";
+} from "../chunk-B3IIPTY3.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

package/dist/adapters/openclaw.js

@@ -3,9 +3,9 @@ import {
   NeuroVersePlugin,
   createNeuroVersePlugin,
   createNeuroVersePluginFromWorld
-} from "../chunk-RF2L5SYG.js";
+} from "../chunk-TIXVEPS2.js";
 import "../chunk-5U2MQO5P.js";
-import "../chunk-EQUAWNXW.js";
+import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";

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

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

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

@@ -2,19 +2,19 @@ import {
   DeriveInputError,
   DeriveProviderError,
   deriveWorld
-} from "./chunk-QZ666FCV.js";
+} from "./chunk-FHXXD2TI.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
-} from "./chunk-3NZMMSOW.js";
 import {
   emitWorldDefinition
 } from "./chunk-YPCVY4GS.js";
+import {
+  parseWorldMarkdown
+} from "./chunk-3NZMMSOW.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/build.ts

package/dist/{chunk-TZBERHFM.js → chunk-7FL3U7Z5.js}

@@ -1,6 +1,6 @@
 import {
   loadWorld
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import {
   evaluateGuard
 } from "./chunk-ZAF6JH23.js";

package/dist/{chunk-FGOSKQDE.js → chunk-A2UZTLRV.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-5U2MQO5P.js";
 import {
   loadWorld
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import {
   evaluateGuard
 } from "./chunk-ZAF6JH23.js";