@neuroverseos/governance 0.3.1 → 0.3.3

package/dist/adapters/autoresearch.d.cts

@@ -0,0 +1,111 @@
+import { W as WorldDefinition, G as GuardEvent, a as GuardVerdict } from '../guard-contract-DqFcTScd.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;
+    private world?;
+    private engineOptions;
+    constructor(config: AutoresearchGovernorConfig);
+    /**
+     * Convert an experiment proposal into a GuardEvent for governance evaluation.
+     */
+    proposalToGuardEvent(proposal: ExperimentProposal): GuardEvent;
+    /**
+     * Evaluate an experiment proposal against governance rules.
+     * Routes through the guard engine when a world is loaded,
+     * then layers on research-specific checks (budget, constraints, drift).
+     */
+    evaluateProposal(proposal: ExperimentProposal): {
+        allowed: boolean;
+        reason: string;
+        warnings: string[];
+        verdict?: GuardVerdict;
+    };
+    /**
+     * 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;
+}
+/**
+ * Create an AutoresearchGovernor with a world loaded from disk.
+ */
+declare function createAutoresearchGovernor(worldPath: string, config: Omit<AutoresearchGovernorConfig, 'world' | 'worldPath'>): Promise<AutoresearchGovernor>;
+
+export { AutoresearchGovernor, type AutoresearchGovernorConfig, type ExperimentProposal, type ExperimentResult, type ResearchState, createAutoresearchGovernor };

package/dist/adapters/autoresearch.d.ts

@@ -0,0 +1,111 @@
+import { W as WorldDefinition, G as GuardEvent, a as GuardVerdict } from '../guard-contract-DqFcTScd.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;
+    private world?;
+    private engineOptions;
+    constructor(config: AutoresearchGovernorConfig);
+    /**
+     * Convert an experiment proposal into a GuardEvent for governance evaluation.
+     */
+    proposalToGuardEvent(proposal: ExperimentProposal): GuardEvent;
+    /**
+     * Evaluate an experiment proposal against governance rules.
+     * Routes through the guard engine when a world is loaded,
+     * then layers on research-specific checks (budget, constraints, drift).
+     */
+    evaluateProposal(proposal: ExperimentProposal): {
+        allowed: boolean;
+        reason: string;
+        warnings: string[];
+        verdict?: GuardVerdict;
+    };
+    /**
+     * 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;
+}
+/**
+ * Create an AutoresearchGovernor with a world loaded from disk.
+ */
+declare function createAutoresearchGovernor(worldPath: string, config: Omit<AutoresearchGovernorConfig, 'world' | 'worldPath'>): Promise<AutoresearchGovernor>;
+
+export { AutoresearchGovernor, type AutoresearchGovernorConfig, type ExperimentProposal, type ExperimentResult, type ResearchState, createAutoresearchGovernor };

package/dist/adapters/autoresearch.js

@@ -0,0 +1,12 @@
+import {
+  AutoresearchGovernor,
+  createAutoresearchGovernor
+} from "../chunk-QXBFT7NI.js";
+import "../chunk-W7LLXRGY.js";
+import "../chunk-QLPTHTVB.js";
+import "../chunk-CTZHONLA.js";
+import "../chunk-QWGCMQQD.js";
+export {
+  AutoresearchGovernor,
+  createAutoresearchGovernor
+};