principles-disciple 1.8.1 → 1.8.3

package/dist/core/adaptive-thresholds.d.ts

@@ -1,186 +0,0 @@
-/**
- * Adaptive Thresholds — Bounded Threshold State Management
- * ========================================================
- *
- * PURPOSE: Manage adaptive thresholds for Trinity candidate scoring with
- * bounded, observable, and reproducible threshold changes.
- *
- * DESIGN CONSTRAINTS:
- * - Thresholds only move within bounded ranges (min/max)
- * - Changes depend on explicit observable signals only
- * - No hidden learning loops
- * - Threshold state is persisted and can be rolled back
- * - Corruption or missing state falls back to safe defaults
- *
- * OBSERVABLE SIGNALS:
- * - recent malformed rate (arbiter/executability failures)
- * - recent arbiter reject rate
- * - recent executability reject rate
- * - reviewed subset quality delta
- *
- * PHASE 6 ONLY — No real training, no automatic deployment
- */
-/** File name for threshold state */
-export declare const THRESHOLD_STATE_FILE = "nocturnal-threshold-state.json";
-/** Default threshold values */
-export declare const DEFAULT_THRESHOLDS: {
-    /** Minimum score to pass arbiter validation */
-    readonly schemaCompletenessMin: 0.6;
-    /** Minimum principle alignment score */
-    readonly principleAlignmentMin: 0.7;
-    /** Minimum executability score */
-    readonly executabilityMin: 0.65;
-    /** Minimum boundedness score */
-    readonly boundednessMin: 0.5;
-    /** Minimum confidence/consistency score */
-    readonly confidenceMin: 0.6;
-    /** Minimum aggregate score to be tournament-eligible */
-    readonly aggregateMin: 0.65;
-};
-/** Minimum threshold value (safety bound) */
-export declare const THRESHOLD_MIN = 0;
-/** Maximum threshold value (safety bound) */
-export declare const THRESHOLD_MAX = 1;
-/** Maximum adjustment per update (bounded step size) */
-export declare const MAX_ADJUSTMENT_PER_STEP = 0.05;
-/** Minimum adjustment to trigger a change */
-export declare const MIN_ADJUSTMENT_TO_RECORD = 0.01;
-/**
- * All threshold names that can be adaptively adjusted.
- */
-export type ThresholdName = keyof typeof DEFAULT_THRESHOLDS;
-/**
- * Current threshold values.
- */
-export interface ThresholdValues {
-    schemaCompletenessMin: number;
-    principleAlignmentMin: number;
-    executabilityMin: number;
-    boundednessMin: number;
-    confidenceMin: number;
-    aggregateMin: number;
-}
-/**
- * Threshold state for one threshold.
- */
-export interface ThresholdState {
-    /** Current value */
-    currentValue: number;
-    /** Minimum bound */
-    minValue: number;
-    /** Maximum bound */
-    maxValue: number;
-    /** Last updated timestamp (ISO string) */
-    lastUpdatedAt: string;
-    /** Reason for last adjustment */
-    adjustmentReason?: string;
-    /** Number of adjustments made */
-    adjustmentCount: number;
-}
-/**
- * Complete threshold state persisted to disk.
- */
-export interface ThresholdPersistenceState {
-    /** Individual threshold states */
-    thresholds: Record<ThresholdName, ThresholdState>;
-    /** When the state was last updated (any threshold) */
-    lastUpdatedAt: string;
-    /** Version for migration support */
-    version: number;
-}
-/**
- * Observable signals used to adjust thresholds.
- */
-export interface ThresholdSignals {
-    /** Rate of malformed outputs (0-1) */
-    malformedRate: number;
-    /** Rate of arbiter rejections (0-1) */
-    arbiterRejectRate: number;
-    /** Rate of executability rejections (0-1) */
-    executabilityRejectRate: number;
-    /** Quality delta from reviewed subset comparison (positive = improvement) */
-    qualityDelta: number;
-}
-/**
- * Result of loading threshold state.
- */
-export interface LoadThresholdResult {
-    /** Whether loading succeeded */
-    success: boolean;
-    /** Current threshold values */
-    thresholds: ThresholdValues;
-    /** Whether fallback to defaults was used */
-    usedDefaults: boolean;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Result of updating a threshold.
- */
-export interface UpdateThresholdResult {
-    /** Whether update succeeded */
-    success: boolean;
-    /** The updated threshold values */
-    thresholds: ThresholdValues;
-    /** Whether a change actually occurred */
-    changed: boolean;
-    /** The name of the changed threshold */
-    changedThreshold?: ThresholdName;
-    /** The old value */
-    oldValue?: number;
-    /** The new value */
-    newValue?: number;
-    /** Reason for the change */
-    reason?: string;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Load threshold values with fallback to defaults on corruption.
- *
- * @param stateDir - State directory
- * @returns LoadThresholdResult with current values and status
- */
-export declare function loadThresholdState(stateDir: string): LoadThresholdResult;
-/**
- * Get effective threshold values (alias for loadThresholdState).
- *
- * @param stateDir - State directory
- * @returns Current threshold values
- */
-export declare function getEffectiveThresholds(stateDir: string): ThresholdValues;
-/**
- * Update a single threshold with bounded step size.
- *
- * @param stateDir - State directory
- * @param thresholdName - Name of threshold to update
- * @param newValue - New value (will be clamped to bounds)
- * @param reason - Reason for the adjustment (required for tracking)
- * @returns UpdateThresholdResult
- */
-export declare function updateThresholdState(stateDir: string, thresholdName: ThresholdName, newValue: number, reason: string): UpdateThresholdResult;
-/**
- * Reset all thresholds to defaults.
- *
- * @param stateDir - State directory
- */
-export declare function resetThresholdState(stateDir: string): void;
-/**
- * Get detailed threshold state for debugging/inspection.
- *
- * @param stateDir - State directory
- * @returns Detailed threshold state or null if corrupted
- */
-export declare function getDetailedThresholdState(stateDir: string): ThresholdPersistenceState | null;
-/**
- * Adjust thresholds based on observable signals.
- *
- * This is a simple proportional controller that adjusts thresholds
- * based on observed rejection rates. The adjustment is bounded
- * and requires a minimum signal magnitude to trigger.
- *
- * @param stateDir - State directory
- * @param signals - Observable signals
- * @returns UpdateThresholdResult describing the most significant change
- */
-export declare function adjustThresholdsFromSignals(stateDir: string, signals: ThresholdSignals): UpdateThresholdResult;

package/dist/core/adaptive-thresholds.js

@@ -1,300 +0,0 @@
-/**
- * Adaptive Thresholds — Bounded Threshold State Management
- * ========================================================
- *
- * PURPOSE: Manage adaptive thresholds for Trinity candidate scoring with
- * bounded, observable, and reproducible threshold changes.
- *
- * DESIGN CONSTRAINTS:
- * - Thresholds only move within bounded ranges (min/max)
- * - Changes depend on explicit observable signals only
- * - No hidden learning loops
- * - Threshold state is persisted and can be rolled back
- * - Corruption or missing state falls back to safe defaults
- *
- * OBSERVABLE SIGNALS:
- * - recent malformed rate (arbiter/executability failures)
- * - recent arbiter reject rate
- * - recent executability reject rate
- * - reviewed subset quality delta
- *
- * PHASE 6 ONLY — No real training, no automatic deployment
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { withLock } from '../utils/file-lock.js';
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** File name for threshold state */
-export const THRESHOLD_STATE_FILE = 'nocturnal-threshold-state.json';
-/** Default threshold values */
-export const DEFAULT_THRESHOLDS = {
-    /** Minimum score to pass arbiter validation */
-    schemaCompletenessMin: 0.6,
-    /** Minimum principle alignment score */
-    principleAlignmentMin: 0.7,
-    /** Minimum executability score */
-    executabilityMin: 0.65,
-    /** Minimum boundedness score */
-    boundednessMin: 0.5,
-    /** Minimum confidence/consistency score */
-    confidenceMin: 0.6,
-    /** Minimum aggregate score to be tournament-eligible */
-    aggregateMin: 0.65,
-};
-/** Minimum threshold value (safety bound) */
-export const THRESHOLD_MIN = 0.0;
-/** Maximum threshold value (safety bound) */
-export const THRESHOLD_MAX = 1.0;
-/** Maximum adjustment per update (bounded step size) */
-export const MAX_ADJUSTMENT_PER_STEP = 0.05;
-/** Minimum adjustment to trigger a change */
-export const MIN_ADJUSTMENT_TO_RECORD = 0.01;
-// ---------------------------------------------------------------------------
-// State Persistence
-// ---------------------------------------------------------------------------
-/**
- * Get the threshold state file path.
- */
-function getStatePath(stateDir) {
-    return path.join(stateDir, THRESHOLD_STATE_FILE);
-}
-/**
- * Create default threshold persistence state.
- */
-function createDefaultState() {
-    const now = new Date().toISOString();
-    const thresholds = {};
-    for (const [name, defaultValue] of Object.entries(DEFAULT_THRESHOLDS)) {
-        thresholds[name] = {
-            currentValue: defaultValue,
-            minValue: THRESHOLD_MIN,
-            maxValue: THRESHOLD_MAX,
-            lastUpdatedAt: now,
-            adjustmentCount: 0,
-        };
-    }
-    return {
-        thresholds,
-        lastUpdatedAt: now,
-        version: 1,
-    };
-}
-/**
- * Read threshold state from disk (with locking).
- */
-function readState(stateDir) {
-    const statePath = getStatePath(stateDir);
-    if (!fs.existsSync(statePath)) {
-        return null;
-    }
-    try {
-        const content = fs.readFileSync(statePath, 'utf-8');
-        const parsed = JSON.parse(content);
-        return parsed;
-    }
-    catch {
-        // Corrupted — return null to trigger default fallback
-        return null;
-    }
-}
-/**
- * Write threshold state to disk (with locking).
- */
-function writeState(stateDir, state) {
-    const statePath = getStatePath(stateDir);
-    const stateDirPath = path.dirname(statePath);
-    if (!fs.existsSync(stateDirPath)) {
-        fs.mkdirSync(stateDirPath, { recursive: true });
-    }
-    withLock(statePath, () => {
-        const tmpPath = `${statePath}.tmp`;
-        fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf-8');
-        fs.renameSync(tmpPath, statePath);
-    });
-}
-// ---------------------------------------------------------------------------
-// Core Threshold Operations
-// ---------------------------------------------------------------------------
-/**
- * Load threshold values with fallback to defaults on corruption.
- *
- * @param stateDir - State directory
- * @returns LoadThresholdResult with current values and status
- */
-export function loadThresholdState(stateDir) {
-    const rawState = readState(stateDir);
-    if (!rawState) {
-        return {
-            success: true,
-            thresholds: { ...DEFAULT_THRESHOLDS },
-            usedDefaults: true,
-        };
-    }
-    // Validate and reconstruct threshold values
-    const thresholds = { ...DEFAULT_THRESHOLDS };
-    let usedDefaults = false;
-    for (const [name, defaultValue] of Object.entries(DEFAULT_THRESHOLDS)) {
-        const key = name;
-        const state = rawState.thresholds[key];
-        if (state && typeof state.currentValue === 'number') {
-            // Clamp to bounds (defensive)
-            thresholds[key] = Math.max(state.minValue, Math.min(state.maxValue, state.currentValue));
-        }
-        else {
-            thresholds[key] = defaultValue;
-            usedDefaults = true;
-        }
-    }
-    return {
-        success: true,
-        thresholds: thresholds,
-        usedDefaults,
-    };
-}
-/**
- * Get effective threshold values (alias for loadThresholdState).
- *
- * @param stateDir - State directory
- * @returns Current threshold values
- */
-export function getEffectiveThresholds(stateDir) {
-    const result = loadThresholdState(stateDir);
-    return result.thresholds;
-}
-/**
- * Update a single threshold with bounded step size.
- *
- * @param stateDir - State directory
- * @param thresholdName - Name of threshold to update
- * @param newValue - New value (will be clamped to bounds)
- * @param reason - Reason for the adjustment (required for tracking)
- * @returns UpdateThresholdResult
- */
-export function updateThresholdState(stateDir, thresholdName, newValue, reason) {
-    // Read current state
-    let rawState = readState(stateDir);
-    if (!rawState) {
-        rawState = createDefaultState();
-    }
-    const currentState = rawState.thresholds[thresholdName];
-    if (!currentState) {
-        return {
-            success: false,
-            thresholds: { ...DEFAULT_THRESHOLDS },
-            changed: false,
-            error: `Unknown threshold: ${thresholdName}`,
-        };
-    }
-    // Calculate bounded new value
-    const clampedValue = Math.max(currentState.minValue, Math.min(currentState.maxValue, newValue));
-    // Check if change is meaningful
-    const delta = Math.abs(clampedValue - currentState.currentValue);
-    if (delta < MIN_ADJUSTMENT_TO_RECORD) {
-        return {
-            success: true,
-            thresholds: getEffectiveThresholds(stateDir),
-            changed: false,
-        };
-    }
-    // Enforce maximum step size for bounded, safe threshold adjustments
-    let finalValue = clampedValue;
-    if (delta > MAX_ADJUSTMENT_PER_STEP) {
-        const direction = clampedValue > currentState.currentValue ? 1 : -1;
-        finalValue = currentState.currentValue + direction * MAX_ADJUSTMENT_PER_STEP;
-    }
-    // Update state
-    const now = new Date().toISOString();
-    rawState.thresholds[thresholdName] = {
-        ...currentState,
-        currentValue: finalValue,
-        lastUpdatedAt: now,
-        adjustmentReason: reason,
-        adjustmentCount: currentState.adjustmentCount + 1,
-    };
-    rawState.lastUpdatedAt = now;
-    writeState(stateDir, rawState);
-    return {
-        success: true,
-        thresholds: getEffectiveThresholds(stateDir),
-        changed: true,
-        changedThreshold: thresholdName,
-        oldValue: currentState.currentValue,
-        newValue: finalValue,
-        reason,
-    };
-}
-/**
- * Reset all thresholds to defaults.
- *
- * @param stateDir - State directory
- */
-export function resetThresholdState(stateDir) {
-    const defaultState = createDefaultState();
-    writeState(stateDir, defaultState);
-}
-/**
- * Get detailed threshold state for debugging/inspection.
- *
- * @param stateDir - State directory
- * @returns Detailed threshold state or null if corrupted
- */
-export function getDetailedThresholdState(stateDir) {
-    return readState(stateDir);
-}
-// ---------------------------------------------------------------------------
-// Signal-Based Threshold Adjustment
-// ---------------------------------------------------------------------------
-/**
- * Adjust thresholds based on observable signals.
- *
- * This is a simple proportional controller that adjusts thresholds
- * based on observed rejection rates. The adjustment is bounded
- * and requires a minimum signal magnitude to trigger.
- *
- * @param stateDir - State directory
- * @param signals - Observable signals
- * @returns UpdateThresholdResult describing the most significant change
- */
-export function adjustThresholdsFromSignals(stateDir, signals) {
-    const currentThresholds = getEffectiveThresholds(stateDir);
-    let bestResult = {
-        success: true,
-        thresholds: currentThresholds,
-        changed: false,
-    };
-    // High malformed rate → tighten schema completeness threshold
-    if (signals.malformedRate > 0.3) {
-        const adjustment = signals.malformedRate * 0.1;
-        const newValue = currentThresholds.schemaCompletenessMin + adjustment;
-        const result = updateThresholdState(stateDir, 'schemaCompletenessMin', newValue, `High malformed rate (${signals.malformedRate.toFixed(2)}) → tightening schema threshold`);
-        if (result.changed)
-            bestResult = result;
-    }
-    // High arbiter reject rate → tighten principle alignment threshold
-    if (signals.arbiterRejectRate > 0.25) {
-        const adjustment = signals.arbiterRejectRate * 0.08;
-        const result = updateThresholdState(stateDir, 'principleAlignmentMin', currentThresholds.principleAlignmentMin + adjustment, `High arbiter reject rate (${signals.arbiterRejectRate.toFixed(2)}) → tightening alignment threshold`);
-        if (result.changed && (!bestResult.changed || (result.newValue - result.oldValue) > 0)) {
-            bestResult = result;
-        }
-    }
-    // High executability reject rate → tighten executability threshold
-    if (signals.executabilityRejectRate > 0.3) {
-        const adjustment = signals.executabilityRejectRate * 0.1;
-        const result = updateThresholdState(stateDir, 'executabilityMin', currentThresholds.executabilityMin + adjustment, `High executability reject rate (${signals.executabilityRejectRate.toFixed(2)}) → tightening executability threshold`);
-        if (result.changed && (!bestResult.changed || (result.newValue - result.oldValue) > 0)) {
-            bestResult = result;
-        }
-    }
-    // Good quality delta → slightly loosen thresholds (reward good performance)
-    if (signals.qualityDelta > 0.1) {
-        const reward = Math.min(signals.qualityDelta * 0.05, MAX_ADJUSTMENT_PER_STEP);
-        const result = updateThresholdState(stateDir, 'aggregateMin', Math.max(currentThresholds.aggregateMin - reward, THRESHOLD_MIN), `Positive quality delta (${signals.qualityDelta.toFixed(2)}) → rewarding with slightly lower aggregate threshold`);
-        if (result.changed && (!bestResult.changed || (result.oldValue - result.newValue) > 0)) {
-            bestResult = result;
-        }
-    }
-    return bestResult;
-}

package/dist/core/config-service.d.ts

@@ -1,15 +0,0 @@
-import { PainConfig } from './config.js';
-/**
- * Singleton service to manage the Pain Configuration.
- */
-export declare const ConfigService: {
-    /**
-     * Gets or initializes the Pain Configuration instance.
-     * @param stateDir The directory where the settings JSON is stored.
-     */
-    get(stateDir: string): PainConfig;
-    /**
-     * Resets the singleton instance (primarily for testing).
-     */
-    reset(): void;
-};

package/dist/core/config.d.ts

@@ -1,129 +0,0 @@
-export interface DeepReflectionSettings {
-    enabled: boolean;
-    mode: 'auto' | 'forced' | 'disabled';
-    force_checkpoint?: boolean;
-    checkpoint_message?: string;
-    auto_trigger_conditions?: {
-        min_tool_calls?: number;
-        error_rate_threshold?: number;
-        complexity_keywords?: string[];
-    };
-    default_model?: string;
-    default_depth?: number;
-    timeout_ms?: number;
-    modelsDir?: string;
-}
-export interface GfiGateSettings {
-    enabled: boolean;
-    thresholds: {
-        low_risk_block: number;
-        high_risk_block: number;
-        large_change_block: number;
-    };
-    large_change_lines: number;
-    ep_tier_multipliers: {
-        '1': number;
-        '2': number;
-        '3': number;
-        '4': number;
-        '5': number;
-    };
-    bash_safe_patterns: string[];
-    bash_dangerous_patterns: string[];
-}
-export interface DiagnosticianSettings {
-    context: {
-        time_window_minutes: number;
-        max_message_length: number;
-        max_summary_length: number;
-    };
-}
-export interface PainSettings {
-    language: 'en' | 'zh';
-    trajectory?: {
-        blob_inline_threshold_bytes?: number;
-        busy_timeout_ms?: number;
-        orphan_blob_grace_days?: number;
-    };
-    diagnostician?: DiagnosticianSettings;
-    thresholds: {
-        pain_trigger: number;
-        cognitive_paralysis_input: number;
-        stuck_loops_trigger: number;
-        semantic_min_score: number;
-        promotion_count_threshold: number;
-        promotion_similarity_threshold: number;
-    };
-    scores: {
-        paralysis: number;
-        default_confusion: number;
-        default_loop: number;
-        tool_failure_friction: number;
-        exit_code_penalty: number;
-        spiral_penalty: number;
-        missing_test_command_penalty: number;
-        subagent_error_penalty: number;
-        subagent_timeout_penalty: number;
-    };
-    severity_thresholds: {
-        high: number;
-        medium: number;
-        low: number;
-    };
-    intervals: {
-        worker_poll_ms: number;
-        initial_delay_ms: number;
-        task_timeout_ms: number;
-    };
-    deep_reflection?: DeepReflectionSettings;
-    empathy_engine?: {
-        enabled?: boolean;
-        /** Shadow mode: also run EmpathyObserverWorkflowManager alongside legacy path */
-        helper_empathy_enabled?: boolean;
-        dedupe_window_ms?: number;
-        penalties?: {
-            mild?: number;
-            moderate?: number;
-            severe?: number;
-        };
-        rate_limit?: {
-            max_per_turn?: number;
-            max_per_hour?: number;
-        };
-        model_calibration?: Record<string, number>;
-    };
-    gfi_gate?: GfiGateSettings;
-    compression?: {
-        /** 触发自动压缩的行数阈值 */
-        line_threshold?: number;
-        /** 触发自动压缩的字节阈值 */
-        size_threshold_kb?: number;
-        /** 自动压缩间隔（小时） */
-        interval_hours?: number;
-        /** 保留的已完成任务数 */
-        keep_completed_tasks?: number;
-        /** Working Memory 最大条数 */
-        max_working_memory_artifacts?: number;
-    };
-}
-export declare const DEFAULT_SETTINGS: PainSettings;
-export declare class PainConfig {
-    private settings;
-    private filePath;
-    constructor(stateDir: string);
-    load(): void;
-    save(): void;
-    private deepMerge;
-    /**
-     * Basic validation for critical settings
-     */
-    private validate;
-    /**
-     * Gets a value using dot notation (e.g. 'thresholds.pain_trigger')
-     */
-    get(keyPath: string): any;
-    /**
-     * Returns all settings as a plain object.
-     */
-    getAll(): PainSettings;
-}