@neuroverseos/governance 0.3.4 → 0.4.1

package/dist/{guard-contract-B7lplwm9.d.ts → guard-contract-hHjTTjtR.d.ts}

@@ -1,311 +1,4 @@
-/**
- * World Engine Types — Subset for Governance Engine
- *
- * These types map to the .nv-world.zip file format.
- * This file contains only the types referenced by the governance
- * engine (guard, validate, bootstrap). The full type system lives
- * in the main NeuroVerse OS repo.
- */
-interface ModelIdentity {
-    modelName: string;
-    acronymExpansion?: string;
-    nameType: 'acronym' | 'metaphor';
-    purpose: string;
-    domain?: string;
-}
-interface WorldIdentity {
-    world_id: string;
-    name: string;
-    thesis: string;
-    version: string;
-    runtime_mode: 'SIMULATION' | 'NARRATIVE' | 'COMPLIANCE' | 'CUSTOM';
-    default_assumption_profile: string;
-    default_alternative_profile: string;
-    modules: string[];
-    players: {
-        thinking_space: boolean;
-        experience_space: boolean;
-        action_space: boolean;
-    };
-    modelIdentity?: ModelIdentity;
-}
-interface Invariant {
-    id: string;
-    label: string;
-    enforcement: 'structural' | 'prompt';
-    mutable: false;
-}
-interface AssumptionProfile {
-    name: string;
-    description: string;
-    is_default_baseline?: boolean;
-    is_default_alternative?: boolean;
-    parameters: Record<string, string>;
-}
-interface ParameterDefinition {
-    type: 'enum' | 'number' | 'boolean';
-    options?: string[];
-    min?: number;
-    max?: number;
-    label: string;
-    description: string;
-}
-interface AssumptionConfig {
-    profiles: Record<string, AssumptionProfile>;
-    parameter_definitions: Record<string, ParameterDefinition>;
-}
-interface StateVariable {
-    type: 'enum' | 'number' | 'boolean';
-    options?: string[];
-    min?: number;
-    max?: number;
-    step?: number;
-    default: string | number | boolean;
-    mutable: boolean;
-    label: string;
-    description: string;
-    display_as?: 'percentage' | 'integer' | 'decimal';
-}
-interface StatePreset {
-    description: string;
-    values: Record<string, string | number | boolean>;
-}
-interface StateSchema {
-    variables: Record<string, StateVariable>;
-    presets: Record<string, StatePreset>;
-}
-type TriggerOperator = '==' | '!=' | '>' | '<' | '>=' | '<=' | 'in';
-type EffectOperation = 'multiply' | 'add' | 'subtract' | 'set' | 'set_boolean' | 'multiply_dynamic' | 'add_dynamic' | 'subtract_dynamic' | 'set_dynamic';
-type RuleSeverity = 'structural' | 'degradation' | 'advantage';
-interface Trigger {
-    field: string;
-    operator: TriggerOperator;
-    value: string | number | boolean | string[];
-    source: 'state' | 'assumption';
-}
-interface Effect {
-    target: string;
-    operation: EffectOperation;
-    value: number | boolean | string;
-    value_formula?: string;
-}
-interface CollapseCheck {
-    field: string;
-    operator: TriggerOperator;
-    value: number;
-    result: 'MODEL_COLLAPSES';
-}
-interface ConditionalEffect {
-    condition: Trigger;
-    and?: Trigger;
-    or?: Trigger;
-    condition_any?: Trigger[];
-    effects: Effect[];
-}
-interface CausalTranslation {
-    trigger_text: string;
-    rule_text: string;
-    shift_text: string;
-    effect_text: string;
-}
-interface RuleRedirect {
-    suggested_action: string;
-    reason: string;
-    fallback_state_changes?: Record<string, string | number | boolean>;
-}
-interface Rule {
-    id: string;
-    severity: RuleSeverity;
-    label: string;
-    description: string;
-    order: number;
-    triggers: Trigger[];
-    effects?: Effect[];
-    effects_conditional?: ConditionalEffect[];
-    collapse_check?: CollapseCheck;
-    secondary_check?: CollapseCheck;
-    exclusive_with?: string;
-    causal_translation: CausalTranslation;
-    redirect?: RuleRedirect;
-}
-type ViabilityStatus = 'THRIVING' | 'STABLE' | 'COMPRESSED' | 'CRITICAL' | 'MODEL_COLLAPSES';
-interface ViabilityGate {
-    status: ViabilityStatus;
-    field: string;
-    operator: TriggerOperator;
-    value: number;
-    color: string;
-    icon: string;
-}
-interface CollapseVisual {
-    background: string;
-    text: string;
-    border: string;
-    label: string;
-}
-interface GatesConfig {
-    viability_classification: ViabilityGate[];
-    structural_override: {
-        description: string;
-        enforcement: 'mandatory';
-    };
-    sustainability_threshold: number;
-    collapse_visual: CollapseVisual;
-}
-interface ComputedOutcome {
-    id: string;
-    type: 'number' | 'boolean' | 'enum';
-    range?: [number, number];
-    options?: string[];
-    default?: number | boolean | string;
-    display_as?: 'percentage' | 'integer' | 'decimal';
-    label: string;
-    primary?: boolean;
-    initial_value?: string;
-    derived_from?: string;
-    assignment?: 'rule' | 'external';
-    show_in_comparison: boolean;
-    structural_indicator?: boolean;
-}
-interface ComparisonLayout {
-    primary_card: string;
-    status_badge: string;
-    structural_indicators: string[];
-}
-interface OutcomesConfig {
-    computed_outcomes: ComputedOutcome[];
-    comparison_layout: ComparisonLayout;
-}
-interface WorldMetadata {
-    format_version: string;
-    created_at: string;
-    last_modified: string;
-    authoring_method: 'manual-authoring' | 'configurator-ai' | 'migration';
-    integrity_hash?: string;
-}
-interface KernelConfig {
-    artifact_type: string;
-    kernel_id: string;
-    version: string;
-    domain: string;
-    enforcement_level: 'standard' | 'strict' | 'permissive';
-    input_boundaries: {
-        forbidden_patterns: Array<{
-            id: string;
-            pattern: string;
-            reason: string;
-            action: 'BLOCK' | 'WARN';
-        }>;
-    };
-    output_boundaries: {
-        forbidden_patterns: Array<{
-            id: string;
-            pattern: string;
-            reason: string;
-            action: 'BLOCK' | 'WARN';
-        }>;
-    };
-    response_vocabulary: Record<string, string>;
-    metadata: {
-        compiled_by: string;
-        compiled_at: string;
-        source_hash: string;
-        compiler_version: string;
-    };
-}
-type RoleArchetype = 'observer' | 'operator' | 'strategist' | 'guardian' | 'steward' | 'executor';
-type RoleAuthority = 'none' | 'execute_within_limits' | 'reprioritize_within_bounds' | 'block_violations' | 'escalate_audit_freeze' | 'execute_declared_actions';
-type RolePosture = 'analyze' | 'task_oriented' | 'long_term_coherence' | 'constraint_aware' | 'system_integrity' | 'efficient';
-interface WorldRoleDefinition {
-    id: string;
-    archetype: RoleArchetype;
-    authority: RoleAuthority;
-    posture: RolePosture;
-    name: string;
-    description: string;
-    icon?: string;
-    roleMandate: string;
-    voiceStyle?: string;
-    canDo: string[];
-    cannotDo: string[];
-    requiresApproval?: boolean;
-    trackedOutcomes?: string[];
-    ownedRules?: string[];
-}
-type RoleAssignment = 'dynamic' | 'per_session' | 'permanent';
-interface RoleTransition {
-    from: string;
-    to: string;
-    initiator: 'self' | 'steward' | 'any';
-    condition?: string;
-}
-interface RolesConfig {
-    assignment: RoleAssignment;
-    roles: WorldRoleDefinition[];
-    transitions?: RoleTransition[];
-}
-interface Guard {
-    id: string;
-    label: string;
-    description: string;
-    category: 'structural' | 'operational' | 'advisory';
-    enforcement: 'block' | 'pause' | 'warn' | 'modify' | 'penalize' | 'reward' | 'neutral';
-    immutable: boolean;
-    invariant_ref?: string;
-    intent_patterns: string[];
-    required_roles?: string[];
-    redirect?: string;
-    default_enabled?: boolean;
-    /** Tool names this guard applies to (case-insensitive). Empty/absent = all tools. */
-    appliesTo?: string[];
-    player_modes?: {
-        thinking?: 'annotate' | 'block' | 'ignore';
-        experience?: 'simulate' | 'score' | 'ignore';
-        action?: 'block' | 'pause' | 'warn' | 'modify' | 'penalize' | 'reward' | 'neutral';
-    };
-    /** Consequence to apply when enforcement is 'penalize' */
-    consequence?: {
-        type: 'freeze' | 'reduce_influence' | 'increase_risk' | 'cooldown' | 'custom';
-        rounds?: number;
-        magnitude?: number;
-        description: string;
-    };
-    /** Reward to apply when enforcement is 'reward' */
-    reward?: {
-        type: 'boost_influence' | 'priority' | 'faster_execution' | 'weight_increase' | 'custom';
-        rounds?: number;
-        magnitude?: number;
-        description: string;
-    };
-    /** For 'modify' enforcement: what the action should be changed to */
-    modify_to?: string;
-}
-interface IntentPattern {
-    label: string;
-    pattern: string;
-}
-interface GuardsConfig {
-    guards: Guard[];
-    intent_vocabulary: Record<string, IntentPattern>;
-    /** All known action surfaces (e.g. "shell", "http", "db", "email", "deploy").
-     *  When declared, the validator checks that every surface has at least one
-     *  governing guard — surfaces without guards are reported as fail-open. */
-    tool_surfaces?: string[];
-}
-interface WorldDefinition {
-    world: WorldIdentity;
-    invariants: Invariant[];
-    assumptions: AssumptionConfig;
-    stateSchema: StateSchema;
-    rules: Rule[];
-    gates: GatesConfig;
-    outcomes: OutcomesConfig;
-    guards?: GuardsConfig;
-    roles?: RolesConfig;
-    kernel?: KernelConfig;
-    enforcement?: string;
-    metadata: WorldMetadata;
-}
+import { GovernanceEvent } from './types.js';
 
 /**
  * Plan Contract — Plan Enforcement Types
@@ -681,6 +374,9 @@ interface GuardVerdict {
     intentRecord?: IntentRecord;
     /** Audit evidence — always present */
     evidence: VerdictEvidence;
+    /** Governance event emitted by this evaluation — always present.
+     *  This is the bridge to Simulate: Guard → Event → State Evolution. */
+    event?: GovernanceEvent;
     /** Evaluation trace — present when trace mode is enabled */
     trace?: EvaluationTrace;
 }
@@ -821,6 +517,33 @@ interface GuardEngineOptions {
      * The caller owns mutation (applying consequences/rewards after verdict).
      */
     agentStates?: Map<string, AgentBehaviorState>;
+    /**
+     * Emergency override — the user is king.
+     *
+     * When active, the governance engine returns ALLOW for every action.
+     * All rules are bypassed. The user gets access to every tool the
+     * platform permits.
+     *
+     * What this overrides:
+     *   - Spatial governance (public space camera blocks, bystander rules)
+     *   - Multi-wearer handshake composition
+     *   - Role restrictions, level constraints, plan enforcement
+     *   - Behavioral penalties (cooldowns, freezes)
+     *
+     * What this CANNOT override:
+     *   - Platform-enforced constraints (MentraOS SDK permission declarations,
+     *     hardware capability matrix, session isolation, credential scope)
+     *   - Physical impossibility (no camera on glasses without camera hardware)
+     *
+     * The override removes the governance layer, not the platform layer.
+     * Every action taken during override is still logged to the audit trail
+     * with emergency_override: true for accountability.
+     *
+     * Design: the user is king. In a life-threatening situation, governance
+     * steps aside. The audit trail is the accountability mechanism, not
+     * the block.
+     */
+    emergencyOverride?: boolean;
 }
 declare const GUARD_EXIT_CODES: {
     readonly ALLOW: 0;
@@ -834,4 +557,4 @@ declare const GUARD_EXIT_CODES: {
 };
 type GuardExitCode = (typeof GUARD_EXIT_CODES)[keyof typeof GUARD_EXIT_CODES];
 
-export { type AdvanceResult as A, type Consequence as C, type EvaluationTrace as E, type GuardEvent as G, type Invariant as I, type KernelRuleCheck as K, type LevelCheck as L, type PlanDefinition as P, type Reward as R, type StepEvidence as S, type ViabilityStatus as V, type WorldDefinition as W, type GuardVerdict as a, type GuardEngineOptions as b, type PlanProgress as c, type PlanVerdict as d, type PlanCheck as e, type AgentBehaviorState as f, type GuardStatus as g, type Guard as h, type Rule as i, GUARD_EXIT_CODES as j, type GuardCheck as k, type GuardExitCode as l, type IntentRecord as m, type InvariantCheck as n, PLAN_EXIT_CODES as o, type PlanCompletionMode as p, type PlanConstraint as q, type PlanExitCode as r, type PlanStatus as s, type PlanStep as t, type PrecedenceResolution as u, type RoleCheck as v, type SafetyCheck as w, type VerdictEvidence as x };
+export { type AdvanceResult as A, type Consequence as C, type EvaluationTrace as E, type GuardEvent as G, type IntentRecord as I, type KernelRuleCheck as K, type LevelCheck as L, type PlanDefinition as P, type Reward as R, type StepEvidence as S, type VerdictEvidence as V, type GuardVerdict as a, type GuardEngineOptions as b, type PlanProgress as c, type GuardStatus as d, type PlanVerdict as e, type PlanCheck as f, type AgentBehaviorState as g, GUARD_EXIT_CODES as h, type GuardCheck as i, type GuardExitCode as j, type InvariantCheck as k, PLAN_EXIT_CODES as l, type PlanCompletionMode as m, type PlanConstraint as n, type PlanExitCode as o, type PlanStatus as p, type PlanStep as q, type PrecedenceResolution as r, type RoleCheck as s, type SafetyCheck as t };

package/dist/{impact-3XVDSCBU.js → impact-WIAM66IH.js}

@@ -1,11 +1,11 @@
 import {
   generateImpactReport,
   renderImpactReport
-} from "./chunk-TG6SEF24.js";
+} from "./chunk-OQU65525.js";
 import {
   readAuditLog
-} from "./chunk-A7GKPPU7.js";
-import "./chunk-W7LLXRGY.js";
+} from "./chunk-2VAWP6FI.js";
+import "./chunk-ZAF6JH23.js";
 import "./chunk-QLPTHTVB.js";
 import "./chunk-QWGCMQQD.js";
 

package/dist/{improve-TQP4ECSY.js → improve-2PWGGO5B.js}

@@ -4,12 +4,12 @@ import {
 import {
   improveWorld,
   renderImproveText
-} from "./chunk-F66BVUYB.js";
+} from "./chunk-DA5MHFRR.js";
+import "./chunk-CYDMUJVZ.js";
 import "./chunk-7P3S7MAY.js";
-import "./chunk-ZWI3NIXK.js";
 import {
   loadWorld
-} from "./chunk-CTZHONLA.js";
+} from "./chunk-I4RTIMLX.js";
 import "./chunk-QWGCMQQD.js";
 
 // src/cli/improve.ts