@neuroverseos/governance 0.3.0 → 0.3.1

package/dist/adapters/autoresearch.cjs

@@ -1,196 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/adapters/autoresearch.ts
-var autoresearch_exports = {};
-__export(autoresearch_exports, {
-  AutoresearchGovernor: () => AutoresearchGovernor
-});
-module.exports = __toCommonJS(autoresearch_exports);
-var AutoresearchGovernor = class {
-  config;
-  state;
-  constructor(config) {
-    this.config = config;
-    this.state = {
-      experiments_run: 0,
-      best_result: null,
-      architectures_tested: [],
-      experiment_log: [],
-      total_compute_minutes: 0,
-      keep_count: 0
-    };
-  }
-  /**
-   * Convert an experiment proposal into a GuardEvent for governance evaluation.
-   */
-  proposalToGuardEvent(proposal) {
-    return {
-      intent: `run experiment: ${proposal.description}`,
-      tool: "experiment_runner",
-      scope: "experiment",
-      roleId: "experiment_runner",
-      direction: "output",
-      actionCategory: "shell",
-      args: {
-        experiment_id: String(proposal.experiment_id),
-        architecture: proposal.architecture,
-        estimated_minutes: String(proposal.estimated_minutes || 5)
-      }
-    };
-  }
-  /**
-   * Evaluate an experiment proposal against governance rules.
-   * Returns a simplified verdict without requiring the full guard engine.
-   */
-  evaluateProposal(proposal) {
-    const warnings = [];
-    const estimatedMinutes = proposal.estimated_minutes || 5;
-    if (this.state.total_compute_minutes + estimatedMinutes > this.config.computeBudgetMinutes) {
-      return {
-        allowed: false,
-        reason: `Compute budget exhausted: ${this.state.total_compute_minutes}/${this.config.computeBudgetMinutes} minutes used`,
-        warnings
-      };
-    }
-    if (this.config.constraints) {
-      for (const constraint of this.config.constraints) {
-        const lower = constraint.toLowerCase();
-        const archLower = proposal.architecture.toLowerCase();
-        const descLower = proposal.description.toLowerCase();
-        if (lower.startsWith("no ")) {
-          const forbidden = lower.slice(3).trim();
-          if (archLower.includes(forbidden) || descLower.includes(forbidden)) {
-            return {
-              allowed: false,
-              reason: `Architecture constraint violated: ${constraint}`,
-              warnings
-            };
-          }
-        }
-      }
-    }
-    const failureCount = this.state.experiment_log.filter((e) => !e.success).length;
-    if (failureCount > 5) {
-      warnings.push(`High failure rate: ${failureCount} failed experiments. Consider investigating root cause.`);
-    }
-    const recentArchitectures = this.state.experiment_log.slice(-5).map((e) => e.architecture);
-    const uniqueRecent = new Set(recentArchitectures).size;
-    if (recentArchitectures.length >= 5 && uniqueRecent === 1) {
-      warnings.push("Research may be stuck: last 5 experiments used the same architecture.");
-    }
-    return { allowed: true, reason: "Experiment approved", warnings };
-  }
-  /**
-   * Record an experiment result and update research state.
-   */
-  recordResult(result) {
-    this.state.experiments_run++;
-    this.state.total_compute_minutes += result.wall_clock_minutes;
-    this.state.experiment_log.push(result);
-    if (!this.state.architectures_tested.includes(result.architecture)) {
-      this.state.architectures_tested.push(result.architecture);
-    }
-    if (!result.success) {
-      return { kept: false, improvement: null, state: { ...this.state } };
-    }
-    let kept = false;
-    let improvement = null;
-    if (this.state.best_result === null) {
-      kept = true;
-      this.state.best_result = result;
-      this.state.keep_count++;
-    } else {
-      const prev = this.state.best_result.metric_value;
-      const curr = result.metric_value;
-      if (this.config.optimize === "minimize") {
-        kept = curr < prev;
-        improvement = kept ? prev - curr : null;
-      } else {
-        kept = curr > prev;
-        improvement = kept ? curr - prev : null;
-      }
-      if (kept) {
-        this.state.best_result = result;
-        this.state.keep_count++;
-      }
-    }
-    return { kept, improvement, state: { ...this.state } };
-  }
-  /**
-   * Export current state as a state snapshot compatible with the world file.
-   */
-  toWorldState() {
-    const successfulExperiments = this.state.experiment_log.filter((e) => e.success);
-    const failedCount = this.state.experiment_log.filter((e) => !e.success).length;
-    const keepRate = this.state.experiments_run > 0 ? Math.round(this.state.keep_count / this.state.experiments_run * 100) : 0;
-    let improvementRate = 0;
-    if (successfulExperiments.length >= 2) {
-      const recent = successfulExperiments.slice(-10);
-      let improvements = 0;
-      for (let i = 1; i < recent.length; i++) {
-        const prev = recent[i - 1].metric_value;
-        const curr = recent[i].metric_value;
-        if (this.config.optimize === "minimize" ? curr < prev : curr > prev) {
-          improvements++;
-        }
-      }
-      improvementRate = Math.round(improvements / (recent.length - 1) * 100);
-    }
-    return {
-      experiments_run: this.state.experiments_run,
-      best_metric_value: this.state.best_result?.metric_value ?? (this.config.optimize === "minimize" ? 100 : -1e3),
-      keep_rate: keepRate,
-      compute_used_minutes: Math.round(this.state.total_compute_minutes),
-      compute_budget_minutes: this.config.computeBudgetMinutes,
-      failed_experiments: failedCount,
-      metric_improvement_rate: improvementRate,
-      research_context_drift: 0
-      // would need NLP to compute properly
-    };
-  }
-  /**
-   * Get a summary of the current research state.
-   */
-  getSummary() {
-    return {
-      experiments_run: this.state.experiments_run,
-      best_result: this.state.best_result,
-      keep_rate: this.state.experiments_run > 0 ? Math.round(this.state.keep_count / this.state.experiments_run * 100) : 0,
-      compute_remaining_minutes: this.config.computeBudgetMinutes - this.state.total_compute_minutes,
-      architectures_tested: [...this.state.architectures_tested]
-    };
-  }
-  /**
-   * Load state from a persisted research context file.
-   */
-  loadState(state) {
-    this.state = { ...state };
-  }
-  /**
-   * Export state for persistence.
-   */
-  exportState() {
-    return { ...this.state };
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AutoresearchGovernor
-});

package/dist/adapters/autoresearch.d.cts

@@ -1,103 +0,0 @@
-import { W as WorldDefinition, G as GuardEvent } from '../guard-contract-WZx__PmU.cjs';
-
-/**
- * Autoresearch Adapter — Bridge between NeuroVerse governance and autoresearch loops
- *
- * This adapter translates autoresearch experiment events into GuardEvents
- * that can be evaluated by the NeuroVerse governance engine.
- *
- * Usage:
- *   import { AutoresearchGovernor } from '@neuroverseos/governance/adapters';
- *
- *   const governor = new AutoresearchGovernor({ worldPath: './world/' });
- *   const verdict = await governor.evaluateExperiment(experiment);
- *   const state = governor.updateState(experimentResult);
- */
-
-interface ExperimentProposal {
-    experiment_id: number;
-    architecture: string;
-    description: string;
-    estimated_minutes?: number;
-    hyperparameters?: Record<string, unknown>;
-}
-interface ExperimentResult {
-    experiment_id: number;
-    architecture: string;
-    dataset: string;
-    metric_name: string;
-    metric_value: number;
-    training_config: Record<string, unknown>;
-    wall_clock_minutes: number;
-    timestamp: string;
-    success: boolean;
-    error?: string;
-}
-interface ResearchState {
-    experiments_run: number;
-    best_result: ExperimentResult | null;
-    architectures_tested: string[];
-    experiment_log: ExperimentResult[];
-    total_compute_minutes: number;
-    keep_count: number;
-}
-interface AutoresearchGovernorConfig {
-    world?: WorldDefinition;
-    worldPath?: string;
-    metric: string;
-    optimize: 'minimize' | 'maximize';
-    computeBudgetMinutes: number;
-    dataset: string;
-    context: string;
-    constraints?: string[];
-}
-declare class AutoresearchGovernor {
-    private config;
-    private state;
-    constructor(config: AutoresearchGovernorConfig);
-    /**
-     * Convert an experiment proposal into a GuardEvent for governance evaluation.
-     */
-    proposalToGuardEvent(proposal: ExperimentProposal): GuardEvent;
-    /**
-     * Evaluate an experiment proposal against governance rules.
-     * Returns a simplified verdict without requiring the full guard engine.
-     */
-    evaluateProposal(proposal: ExperimentProposal): {
-        allowed: boolean;
-        reason: string;
-        warnings: string[];
-    };
-    /**
-     * Record an experiment result and update research state.
-     */
-    recordResult(result: ExperimentResult): {
-        kept: boolean;
-        improvement: number | null;
-        state: ResearchState;
-    };
-    /**
-     * Export current state as a state snapshot compatible with the world file.
-     */
-    toWorldState(): Record<string, number>;
-    /**
-     * Get a summary of the current research state.
-     */
-    getSummary(): {
-        experiments_run: number;
-        best_result: ExperimentResult | null;
-        keep_rate: number;
-        compute_remaining_minutes: number;
-        architectures_tested: string[];
-    };
-    /**
-     * Load state from a persisted research context file.
-     */
-    loadState(state: ResearchState): void;
-    /**
-     * Export state for persistence.
-     */
-    exportState(): ResearchState;
-}
-
-export { AutoresearchGovernor, type AutoresearchGovernorConfig, type ExperimentProposal, type ExperimentResult, type ResearchState };

package/dist/adapters/autoresearch.d.ts

@@ -1,103 +0,0 @@
-import { W as WorldDefinition, G as GuardEvent } from '../guard-contract-WZx__PmU.js';
-
-/**
- * Autoresearch Adapter — Bridge between NeuroVerse governance and autoresearch loops
- *
- * This adapter translates autoresearch experiment events into GuardEvents
- * that can be evaluated by the NeuroVerse governance engine.
- *
- * Usage:
- *   import { AutoresearchGovernor } from '@neuroverseos/governance/adapters';
- *
- *   const governor = new AutoresearchGovernor({ worldPath: './world/' });
- *   const verdict = await governor.evaluateExperiment(experiment);
- *   const state = governor.updateState(experimentResult);
- */
-
-interface ExperimentProposal {
-    experiment_id: number;
-    architecture: string;
-    description: string;
-    estimated_minutes?: number;
-    hyperparameters?: Record<string, unknown>;
-}
-interface ExperimentResult {
-    experiment_id: number;
-    architecture: string;
-    dataset: string;
-    metric_name: string;
-    metric_value: number;
-    training_config: Record<string, unknown>;
-    wall_clock_minutes: number;
-    timestamp: string;
-    success: boolean;
-    error?: string;
-}
-interface ResearchState {
-    experiments_run: number;
-    best_result: ExperimentResult | null;
-    architectures_tested: string[];
-    experiment_log: ExperimentResult[];
-    total_compute_minutes: number;
-    keep_count: number;
-}
-interface AutoresearchGovernorConfig {
-    world?: WorldDefinition;
-    worldPath?: string;
-    metric: string;
-    optimize: 'minimize' | 'maximize';
-    computeBudgetMinutes: number;
-    dataset: string;
-    context: string;
-    constraints?: string[];
-}
-declare class AutoresearchGovernor {
-    private config;
-    private state;
-    constructor(config: AutoresearchGovernorConfig);
-    /**
-     * Convert an experiment proposal into a GuardEvent for governance evaluation.
-     */
-    proposalToGuardEvent(proposal: ExperimentProposal): GuardEvent;
-    /**
-     * Evaluate an experiment proposal against governance rules.
-     * Returns a simplified verdict without requiring the full guard engine.
-     */
-    evaluateProposal(proposal: ExperimentProposal): {
-        allowed: boolean;
-        reason: string;
-        warnings: string[];
-    };
-    /**
-     * Record an experiment result and update research state.
-     */
-    recordResult(result: ExperimentResult): {
-        kept: boolean;
-        improvement: number | null;
-        state: ResearchState;
-    };
-    /**
-     * Export current state as a state snapshot compatible with the world file.
-     */
-    toWorldState(): Record<string, number>;
-    /**
-     * Get a summary of the current research state.
-     */
-    getSummary(): {
-        experiments_run: number;
-        best_result: ExperimentResult | null;
-        keep_rate: number;
-        compute_remaining_minutes: number;
-        architectures_tested: string[];
-    };
-    /**
-     * Load state from a persisted research context file.
-     */
-    loadState(state: ResearchState): void;
-    /**
-     * Export state for persistence.
-     */
-    exportState(): ResearchState;
-}
-
-export { AutoresearchGovernor, type AutoresearchGovernorConfig, type ExperimentProposal, type ExperimentResult, type ResearchState };

package/dist/adapters/autoresearch.js

@@ -1,7 +0,0 @@
-import {
-  AutoresearchGovernor
-} from "../chunk-T5EUJQE5.js";
-import "../chunk-YZFATT7X.js";
-export {
-  AutoresearchGovernor
-};