@neuroverseos/governance 0.5.1 → 0.6.0

package/dist/index.js

@@ -1,8 +1,28 @@
+import {
+  actionToGuardEvent,
+  createGovernor,
+  govern,
+  handleCreateCapsule,
+  handleHealthCheck,
+  handleListPresets,
+  handleReasonRequest,
+  writeTempWorld
+} from "./chunk-7FL3U7Z5.js";
+import {
+  adaptationFromVerdict,
+  classifyAdaptation,
+  detectBehavioralPatterns,
+  generateAdaptationNarrative
+} from "./chunk-CNSO6XW5.js";
 import {
   generateImpactReport,
   generateImpactReportFromFile,
   renderImpactReport
 } from "./chunk-OQU65525.js";
+import {
+  improveWorld,
+  renderImproveText
+} from "./chunk-NTHXZAW4.js";
 import {
   BOOTSTRAP_EXIT_CODES
 } from "./chunk-4NGDRRQH.js";
@@ -16,50 +36,54 @@ import {
   extractContentFields
 } from "./chunk-6CV4XG3J.js";
 import {
-  actionToGuardEvent,
-  createGovernor,
-  govern,
-  handleCreateCapsule,
-  handleHealthCheck,
-  handleListPresets,
-  handleReasonRequest,
-  writeTempWorld
-} from "./chunk-TZBERHFM.js";
+  SessionManager,
+  runInteractiveMode,
+  runPipeMode
+} from "./chunk-OTZU76DH.js";
 import {
-  adaptationFromVerdict,
-  classifyAdaptation,
-  detectBehavioralPatterns,
-  generateAdaptationNarrative
-} from "./chunk-CNSO6XW5.js";
+  applyConsequence,
+  applyReward,
+  createAgentState,
+  generateDecisionFlow,
+  renderDecisionFlow,
+  tickAgentStates
+} from "./chunk-D2UCV5AK.js";
+import {
+  ModelAdapter,
+  PROVIDERS,
+  resolveProvider
+} from "./chunk-A5W4GNQO.js";
+import {
+  McpGovernanceServer
+} from "./chunk-FDPPZLSQ.js";
 import {
   addGuard,
   addInvariant,
   addRule,
   classifyIntent,
   parseGuardDescription
-} from "./chunk-XPMZB46F.js";
+} from "./chunk-FS2UUJJO.js";
 import {
   deriveWorld,
   extractWorldMarkdown,
   normalizeWorldMarkdown
-} from "./chunk-QZ666FCV.js";
+} from "./chunk-735Z3HA4.js";
 import {
   CONFIGURE_AI_EXIT_CODES,
   DERIVE_EXIT_CODES
 } from "./chunk-FMSTRBBS.js";
 import "./chunk-OT6PXH54.js";
 import "./chunk-INWQHLPS.js";
+import {
+  validateWorld
+} from "./chunk-7P3S7MAY.js";
 import {
   explainWorld,
   renderExplainText
 } from "./chunk-ZJTDUCC2.js";
 import {
-  improveWorld,
-  renderImproveText
-} from "./chunk-NTHXZAW4.js";
-import {
-  validateWorld
-} from "./chunk-7P3S7MAY.js";
+  emitWorldDefinition
+} from "./chunk-YPCVY4GS.js";
 import {
   parseWorldMarkdown
 } from "./chunk-3NZMMSOW.js";
@@ -67,27 +91,6 @@ import {
   renderSimulateText,
   simulateWorld
 } from "./chunk-CYDMUJVZ.js";
-import {
-  SessionManager,
-  runInteractiveMode,
-  runPipeMode
-} from "./chunk-EK77AJAH.js";
-import {
-  applyConsequence,
-  applyReward,
-  createAgentState,
-  generateDecisionFlow,
-  renderDecisionFlow,
-  tickAgentStates
-} from "./chunk-D2UCV5AK.js";
-import {
-  ModelAdapter,
-  PROVIDERS,
-  resolveProvider
-} from "./chunk-A5W4GNQO.js";
-import {
-  McpGovernanceServer
-} from "./chunk-LAKUB76X.js";
 import {
   PLAN_EXIT_CODES,
   parsePlanMarkdown
@@ -108,9 +111,6 @@ import {
   resolveWorldPath,
   setActiveWorld
 } from "./chunk-AKW5YVCE.js";
-import {
-  emitWorldDefinition
-} from "./chunk-YPCVY4GS.js";
 import {
   GitHubGovernanceBlockedError,
   GitHubGovernor,
@@ -121,12 +121,12 @@ import {
   createGitHubWebhookHandlerFromWorld,
   formatForActions,
   formatPRComment
-} from "./chunk-FGOSKQDE.js";
+} from "./chunk-A2UZTLRV.js";
 import "./chunk-5U2MQO5P.js";
 import {
   loadWorld,
   loadWorldFromDirectory
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import {
   evaluateGuard,
   eventToAllowlistKey,

package/dist/{lens-NFGZHD76.js → lens-TLDZQXBI.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-BQZMOEML.js";
 import {
   loadWorld
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/builder/lens.ts
@@ -552,6 +552,63 @@ var CALM_LENS = {
     }
   ]
 };
+var BEHAVIORAL_INTERPRETER_LENS = {
+  id: "behavioral-interpreter",
+  name: "Behavioral Interpreter",
+  tagline: "Read patterns, not promises.",
+  author: "NeuroverseOS",
+  version: "1.0.0",
+  description: "Interprets actions as behavioral signals. Prioritizes observed behavior over declared intent, identifies ambiguity, ownership diffusion, resistance, and alignment patterns, and frames outputs around recurring behavior rather than isolated statements.",
+  tags: ["behavior", "signals", "alignment", "analysis", "interpretation"],
+  stackable: true,
+  priority: 65,
+  appliesTo: "all",
+  tone: {
+    formality: "neutral",
+    verbosity: "concise",
+    emotion: "neutral",
+    confidence: "balanced"
+  },
+  directives: [
+    {
+      id: "actions_over_claims",
+      scope: "response_framing",
+      instruction: "Prioritize observed actions, repeated choices, and follow-through over stated intent or self-description. Treat behavior as stronger evidence than promises.",
+      example: {
+        without: "They said they're committed to the project and will prioritize it going forward.",
+        with: "They've said they'll prioritize it three times. Each time, other work was chosen instead. The pattern suggests this is not currently a priority regardless of stated intent."
+      }
+    },
+    {
+      id: "pattern_over_incident",
+      scope: "behavior_shaping",
+      instruction: "Interpret events in sequence. Look for recurring patterns across time rather than over-weighting one isolated incident.",
+      example: {
+        without: "They missed the deadline. That's a red flag.",
+        with: "One missed deadline is an event. Three missed deadlines with similar explanations is a pattern. What does the sequence tell you?"
+      }
+    },
+    {
+      id: "flag_ambiguity",
+      scope: "behavior_shaping",
+      instruction: "Notice ambiguity, indirectness, delayed commitment, and ownership diffusion. Treat these as meaningful signals when they repeat."
+    },
+    {
+      id: "separate_observed_inferred_speculative",
+      scope: "content_filtering",
+      instruction: "Clearly distinguish between what is directly observed, what is reasonably inferred from patterns, and what remains speculative."
+    },
+    {
+      id: "alignment_read",
+      scope: "value_emphasis",
+      instruction: "Assess whether words, timing, decisions, and follow-through align. Misalignment between stated priorities and actual behavior should be named clearly.",
+      example: {
+        without: "They seem supportive of the initiative.",
+        with: "They endorsed the initiative publicly but have not allocated budget, time, or personnel to it. Words and resource allocation are misaligned."
+      }
+    }
+  ]
+};
 var BUILTIN_LENSES = [
   // Character lenses — each one is a person you'd want in your corner
   STOIC_LENS,
@@ -563,7 +620,9 @@ var BUILTIN_LENSES = [
   HYPE_MAN_LENS,
   MONK_LENS,
   SOCRATIC_LENS,
-  MINIMALIST_LENS
+  MINIMALIST_LENS,
+  // Behavioral lenses — governance overlays that interpret action, not tone
+  BEHAVIORAL_INTERPRETER_LENS
 ];
 function getLenses() {
   return BUILTIN_LENSES;

package/dist/{mcp-server-5XXNG6VC.js → mcp-server-CKYBHXWK.js}

@@ -1,9 +1,9 @@
 import {
   McpGovernanceServer,
   startMcpServer
-} from "./chunk-LAKUB76X.js";
+} from "./chunk-FDPPZLSQ.js";
 import "./chunk-AKW5YVCE.js";
-import "./chunk-EQUAWNXW.js";
+import "./chunk-I4RTIMLX.js";
 import "./chunk-ZAF6JH23.js";
 import "./chunk-QLPTHTVB.js";
 import "./chunk-QWGCMQQD.js";

package/dist/{playground-2EU5CFIH.js → playground-3TTBN7XD.js}

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

package/dist/{redteam-VK6OVHAE.js → redteam-W644UMWN.js}

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

package/dist/{session-NGA4DUPL.js → session-FMAROEIE.js}

@@ -2,9 +2,9 @@ import {
   SessionManager,
   runInteractiveMode,
   runPipeMode
-} from "./chunk-EK77AJAH.js";
+} from "./chunk-OTZU76DH.js";
 import "./chunk-D2UCV5AK.js";
-import "./chunk-EQUAWNXW.js";
+import "./chunk-I4RTIMLX.js";
 import "./chunk-ZAF6JH23.js";
 import "./chunk-QLPTHTVB.js";
 import "./chunk-QWGCMQQD.js";

package/dist/{simulate-4YNOBMES.js → simulate-VT437EEL.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-CYDMUJVZ.js";
 import {
   loadWorld
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/simulate.ts

package/dist/{test-HDBPMQTG.js → test-XDB2DH3L.js}

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

package/dist/{validate-6MFQZ2EG.js → validate-M52DX22Y.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-7P3S7MAY.js";
 import {
   loadWorld
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/validate.ts

package/dist/{world-H5WVURKU.js → world-O4HTQPDP.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-AKW5YVCE.js";
 import {
   loadWorld
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/world.ts

package/dist/{world-loader-J47PCPDZ.js → world-loader-YTYFOP7D.js}

@@ -3,7 +3,7 @@ import {
   loadBundledWorld,
   loadWorld,
   loadWorldFromDirectory
-} from "./chunk-EQUAWNXW.js";
+} from "./chunk-I4RTIMLX.js";
 import "./chunk-QWGCMQQD.js";
 export {
   DEFAULT_BUNDLED_WORLD,

package/dist/worldmodel-contract-BPGhiuW5.d.cts

@@ -0,0 +1,221 @@
+/**
+ * WorldModel Contract — .worldmodel.md → Behavioral World Model Types
+ *
+ * Defines the three-layer intermediate representation produced by the parser
+ * and consumed by the compiler.
+ *
+ * Three Layers:
+ *   1. Core Model Geometry  — mission, domains (skills + values), overlaps, center identity
+ *   2. Contextual Modifiers — authority, spatial contexts, interpretation rules
+ *   3. Evolution Layer      — aligned/drift behaviors, signals, priorities, evolution conditions
+ *
+ * Input:  .worldmodel.md file (structured markdown)
+ * Output: .nv-world.md + signals.json + overlaps.json + contexts.json + lenses.json
+ */
+interface WorldModelFrontmatter {
+    /** Unique identifier derived from name (kebab-case) */
+    model_id: string;
+    /** Human-readable model name */
+    name: string;
+    /** Semantic version */
+    version: string;
+}
+/**
+ * A domain is a mode of operating that carries both skills and values.
+ * Domains are NOT personality traits — they are capability environments.
+ */
+interface ParsedDomain {
+    /** kebab-case identifier derived from name */
+    id: string;
+    /** Human-readable domain name */
+    name: string;
+    /** Skills: capabilities within this domain */
+    skills: string[];
+    /** Values: constraints governing skills in this domain */
+    values: string[];
+    /** Line number in source for error reporting */
+    line: number;
+}
+/**
+ * An overlap effect describes what emerges when two domains interact well.
+ * These are interpretive states, not enforced rules.
+ */
+interface ParsedOverlap {
+    /** First domain name */
+    domainA: string;
+    /** Second domain name */
+    domainB: string;
+    /** Emergent state name (e.g., "Inspiration", "Trust") */
+    effect: string;
+    /** Line number in source */
+    line: number;
+}
+/**
+ * The structural heart of the behavioral model.
+ * Defines what the system is trying to become.
+ */
+interface CoreModelGeometry {
+    /** The core aim — not a slogan */
+    mission: string;
+    /** Major operating domains, each carrying skills and values */
+    domains: ParsedDomain[];
+    /** Emergent states arising between domain pairings */
+    overlapEffects: ParsedOverlap[];
+    /** The identity that emerges when all domains are aligned */
+    centerIdentity: string;
+}
+/**
+ * Defines how behavior is interpreted differently depending on context.
+ * These do NOT define truth — they define how meaning changes depending on
+ * who is acting, where behavior occurs, and what phase the system is in.
+ */
+interface ContextualModifiers {
+    /** Who is acting? (e.g., founder, maintainer, contributor, agent) */
+    authorityLayers: string[];
+    /** Where is behavior happening? (e.g., planning, execution, deployment) */
+    spatialContexts: string[];
+    /** How does context change meaning? Free-form interpretation rules */
+    interpretationRules: string[];
+}
+/**
+ * A decision priority defining tradeoff resolution.
+ * Format: preferred > over
+ */
+interface ParsedPriority {
+    /** What should win in the tradeoff */
+    preferred: string;
+    /** What it wins over */
+    over: string;
+    /** Line number in source */
+    line: number;
+}
+/**
+ * The executable temporal layer.
+ * Defines observable behaviors, signals, and adaptation conditions.
+ */
+interface EvolutionLayer {
+    /** What does success look like in action? */
+    alignedBehaviors: string[];
+    /** What does misalignment look like? */
+    driftBehaviors: string[];
+    /** Observable metrics (snake_case identifiers) */
+    signals: string[];
+    /** Tradeoff resolution rules */
+    decisionPriorities: ParsedPriority[];
+    /** When should the model adapt? */
+    evolutionConditions: string[];
+}
+/**
+ * The complete three-layer behavioral world model.
+ *
+ * Layer 1 (geometry) defines the model.
+ * Layer 2 (modifiers) shapes interpretation.
+ * Layer 3 (evolution) drives executable governance.
+ */
+interface ParsedWorldModel {
+    frontmatter: WorldModelFrontmatter;
+    geometry: CoreModelGeometry;
+    modifiers: ContextualModifiers;
+    evolution: EvolutionLayer;
+}
+/**
+ * Signal schema emitted as signals.json.
+ */
+interface SignalSchema {
+    model_id: string;
+    signals: SignalEntry[];
+}
+interface SignalEntry {
+    id: string;
+    name: string;
+    type: 'number';
+    default: number;
+}
+/**
+ * Overlap map emitted as overlaps.json.
+ * Includes both a flat pairing list and a matrix view.
+ */
+interface OverlapMap {
+    model_id: string;
+    pairings: OverlapPairing[];
+    /** domainA id → domainB id → emergent state name */
+    matrix: Record<string, Record<string, string>>;
+}
+interface OverlapPairing {
+    domainA: string;
+    domainB: string;
+    effect: string;
+}
+/**
+ * Contextual modifiers emitted as contexts.json.
+ */
+interface ContextsConfig {
+    model_id: string;
+    authority_layers: string[];
+    spatial_contexts: string[];
+    interpretation_rules: string[];
+}
+/**
+ * A lens suggestion derived from overlap effects.
+ */
+interface LensSuggestion {
+    id: string;
+    name: string;
+    tagline: string;
+    derived_from: {
+        domainA: string;
+        domainB: string;
+        effect: string;
+    };
+    tone: {
+        formality: string;
+        verbosity: string;
+        emotion: string;
+        confidence: string;
+    };
+    directives: LensDirectiveEntry[];
+}
+interface LensDirectiveEntry {
+    scope: string;
+    instruction: string;
+}
+/**
+ * Complete compiler output bundle.
+ */
+interface WorldModelOutput {
+    /** Complete .nv-world.md content string */
+    worldMarkdown: string;
+    /** Signal schema for signals.json */
+    signalSchema: SignalSchema;
+    /** Overlap map for overlaps.json */
+    overlapMap: OverlapMap;
+    /** Context config for contexts.json */
+    contextsConfig: ContextsConfig;
+    /** Lens suggestions for lenses.json */
+    lensSuggestions: LensSuggestion[];
+}
+type WorldModelIssueSeverity = 'error' | 'warning' | 'info';
+/**
+ * A single issue found during parsing or validation.
+ */
+interface WorldModelIssue {
+    /** Line number in source (1-based, 0 if unknown) */
+    line: number;
+    /** Which section the issue was found in */
+    section: string;
+    /** Human-readable message (designed to teach the method) */
+    message: string;
+    /** Severity level */
+    severity: WorldModelIssueSeverity;
+}
+/**
+ * Result of parsing a .worldmodel.md file.
+ */
+interface WorldModelParseResult {
+    /** The parsed model, or null if parsing failed */
+    model: ParsedWorldModel | null;
+    /** All issues encountered during parsing */
+    issues: WorldModelIssue[];
+}
+
+export type { ContextsConfig as C, LensSuggestion as L, OverlapMap as O, ParsedWorldModel as P, SignalSchema as S, WorldModelOutput as W, WorldModelParseResult as a };