principles-disciple 1.7.5 → 1.7.8

package/dist/commands/pain.js

@@ -88,11 +88,6 @@ export function handlePainCommand(ctx) {
         }
         return { text: isZh ? `❌ 无法识别当前会话。` : `❌ Session ID not found. Use /pd-status reset in a chat session.` };
     }
-    if (args === 'trust-reset') {
-        wctx.trust.resetTrust();
-        const newScore = wctx.trust.getScore();
-        return { text: isZh ? `✅ 智能体信任分已重置为初始值 (${newScore})。` : `✅ Agent trust score has been reset to initial value (${newScore}).` };
-    }
     if (args === 'data') {
         const stats = wctx.trajectory.getDataStats();
         return {
@@ -106,11 +101,7 @@ export function handlePainCommand(ctx) {
     const gfi = session ? session.currentGfi : 0;
     const dictionary = wctx.dictionary;
     const stats = dictionary.getStats();
-    const trust = wctx.trust;
-    const trustScore = trust.getScore();
-    const trustStage = trust.getStage();
     const gfiBar = createProgressBar(gfi, 100, 15);
-    const trustBar = createProgressBar(trustScore, 100, 15);
     // Determine Mental Mode (aligned with prompt.ts logic)
     let mentalMode = '';
     if (isZh) {
@@ -133,14 +124,13 @@ export function handlePainCommand(ctx) {
     let healthLabel = 'Healthy';
     let suggestionText = '';
     if (isZh) {
-        if (gfi > 80 || trustStage === 1) {
-            healthLabel = gfi > 80 ? '极度疲劳 🔴' : '信任破产 🔴';
+        if (gfi > 80) {
+            healthLabel = '极度疲劳 🔴';
             suggestionText = `
 💡 **建议 (系统检测到您当前遇到较大阻力)**:
    1. 执行 \`/pd-status reset\` 清零疲劳值。
-   2. 执行 \`/pd-status trust-reset\` 重置信任分。
-   3. 让 AI 调用 \`deep_reflect\` 工具进行深度反思。
-   4. 如果当前上下文太乱，考虑使用 \`/clear\` 开启新会话。`;
+   2. 让 AI 调用 \`deep_reflect\` 工具进行深度反思。
+   3. 如果当前上下文太乱，考虑使用 \`/clear\` 开启新会话。`;
         }
         else if (gfi > 50)
             healthLabel = '遇到阻力 🟡';
@@ -150,13 +140,12 @@ export function handlePainCommand(ctx) {
             healthLabel = '运转良好 🟢';
     }
     else {
-        if (gfi > 80 || trustStage === 1) {
-            healthLabel = gfi > 80 ? 'Critical 🔴' : 'Trust Bankruptcy 🔴';
+        if (gfi > 80) {
+            healthLabel = 'Critical 🔴';
             suggestionText = `
-💡 **Suggestion (High friction or low trust detected)**:
+💡 **Suggestion (High friction detected)**:
    1. Run \`/pd-status reset\` to clear friction.
-   2. Run \`/pd-status trust-reset\` to reset trust score.
-   3. Ask the AI to use the \`deep_reflect\` tool.
+   2. Ask the AI to use the \`deep_reflect\` tool.
    4. Consider starting a new session with \`/clear\`.`;
         }
         else if (gfi > 50)
@@ -178,7 +167,6 @@ export function handlePainCommand(ctx) {
         let text = `📊 **Principles Disciple - 系统健康度监控**\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
         text += `💊 **当前疲劳指数 (GFI)**: ${gfiBar} ${gfi}/100\n`;
-        text += `💰 **当前信任积分 (Trust)**: ${trustBar} ${trustScore}/100 (Stage ${trustStage})\n`;
         text += `🧠 **当前心智模式**: ${mentalMode}\n`;
         text += `   ↳ 状态诊断: ${healthLabel}\n`;
         text += empathyInline;
@@ -197,7 +185,6 @@ export function handlePainCommand(ctx) {
         let text = `📊 **Principles Disciple - System Health Monitor**\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
         text += `💊 **Current Friction (GFI)**: ${gfiBar} ${gfi}/100\n`;
-        text += `💰 **Current Trust Score**: ${trustBar} ${trustScore}/100 (Stage ${trustStage})\n`;
         text += `🧠 **Current Mental Mode**: ${mentalMode}\n`;
         text += `   ↳ Diagnosis: ${healthLabel}\n`;
         text += empathyInline;

package/dist/config/defaults/runtime.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * All runtime-related constants that were previously scattered across modules.
+ * Centralizing these makes it easier to tune behavior and understand limits.
+ */
+/**
+ * Trajectory gate block retry settings
+ * Used when trajectory recording fails and needs to retry
+ */
+export declare const TRAJECTORY_GATE_BLOCK_RETRY_DELAY_MS = 250;
+export declare const TRAJECTORY_GATE_BLOCK_MAX_RETRIES = 3;
+/**
+ * Thinking checkpoint defaults (P-10)
+ */
+export declare const THINKING_CHECKPOINT_WINDOW_MS: number;
+export declare const THINKING_CHECKPOINT_DEFAULT_HIGH_RISK_TOOLS: readonly ["run_shell_command", "delete_file", "move_file"];
+/**
+ * Large change threshold for GFI gate adjustments
+ */
+export declare const GFI_LARGE_CHANGE_LINES = 50;
+/**
+ * Agent spawn GFI threshold (critically high = no spawn)
+ */
+export declare const AGENT_SPAWN_GFI_THRESHOLD = 90;
+/**
+ * Evolution worker polling intervals
+ */
+export declare const EVOLUTION_WORKER_POLL_INTERVAL_MS: number;
+export declare const EVOLUTION_QUEUE_BATCH_SIZE = 10;
+/**
+ * Session tracker settings
+ */
+export declare const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
+export declare const SESSION_MAX_IDLE_MS: number;
+/**
+ * Event log buffer settings
+ */
+export declare const EVENT_LOG_BUFFER_SIZE = 20;
+export declare const EVENT_LOG_FLUSH_INTERVAL_MS: number;

package/dist/config/defaults/runtime.js

@@ -0,0 +1,44 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * All runtime-related constants that were previously scattered across modules.
+ * Centralizing these makes it easier to tune behavior and understand limits.
+ */
+/**
+ * Trajectory gate block retry settings
+ * Used when trajectory recording fails and needs to retry
+ */
+export const TRAJECTORY_GATE_BLOCK_RETRY_DELAY_MS = 250;
+export const TRAJECTORY_GATE_BLOCK_MAX_RETRIES = 3;
+/**
+ * Thinking checkpoint defaults (P-10)
+ */
+export const THINKING_CHECKPOINT_WINDOW_MS = 5 * 60 * 1000; // 5 minutes
+export const THINKING_CHECKPOINT_DEFAULT_HIGH_RISK_TOOLS = [
+    'run_shell_command',
+    'delete_file',
+    'move_file',
+];
+/**
+ * Large change threshold for GFI gate adjustments
+ */
+export const GFI_LARGE_CHANGE_LINES = 50;
+/**
+ * Agent spawn GFI threshold (critically high = no spawn)
+ */
+export const AGENT_SPAWN_GFI_THRESHOLD = 90;
+/**
+ * Evolution worker polling intervals
+ */
+export const EVOLUTION_WORKER_POLL_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+export const EVOLUTION_QUEUE_BATCH_SIZE = 10;
+/**
+ * Session tracker settings
+ */
+export const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
+export const SESSION_MAX_IDLE_MS = 30 * 60 * 1000; // 30 minutes
+/**
+ * Event log buffer settings
+ */
+export const EVENT_LOG_BUFFER_SIZE = 20;
+export const EVENT_LOG_FLUSH_INTERVAL_MS = 30 * 1000; // 30 seconds

package/dist/config/errors.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Domain-Specific Errors for Principles Disciple
+ *
+ * These errors provide semantic meaning to failure modes,
+ * making it easier to distinguish between:
+ * - Lock contention (resource busy)
+ * - Parse/validation failures
+ * - Derived state mismatches
+ * - Configuration issues
+ */
+/**
+ * Base class for all Principles Disciple errors
+ */
+export declare class PdError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a resource lock cannot be acquired
+ * (e.g., queue, trajectory, evolution file)
+ */
+export declare class LockUnavailableError extends PdError {
+    constructor(resource: string, scope: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a path key cannot be resolved
+ */
+export declare class PathResolutionError extends PdError {
+    constructor(key: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a workspace cannot be found
+ */
+export declare class WorkspaceNotFoundError extends PdError {
+    constructor(workspace: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a required sample cannot be found
+ */
+export declare class SampleNotFoundError extends PdError {
+    constructor(sampleId: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when configuration is invalid or missing required fields
+ */
+export declare class ConfigurationError extends PdError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when prompt/logger dependencies are unavailable
+ */
+export declare class DependencyError extends PdError {
+    constructor(component: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when evolution worker encounters a processing error
+ */
+export declare class EvolutionProcessingError extends PdError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when trajectory operations fail
+ */
+export declare class TrajectoryError extends PdError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}

package/dist/config/errors.js

@@ -0,0 +1,94 @@
+/**
+ * Domain-Specific Errors for Principles Disciple
+ *
+ * These errors provide semantic meaning to failure modes,
+ * making it easier to distinguish between:
+ * - Lock contention (resource busy)
+ * - Parse/validation failures
+ * - Derived state mismatches
+ * - Configuration issues
+ */
+/**
+ * Base class for all Principles Disciple errors
+ */
+export class PdError extends Error {
+    code;
+    constructor(message, code, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'PdError';
+    }
+}
+/**
+ * Thrown when a resource lock cannot be acquired
+ * (e.g., queue, trajectory, evolution file)
+ */
+export class LockUnavailableError extends PdError {
+    constructor(resource, scope, options) {
+        super(`[PD:Lock] ${scope}: queue lock unavailable for ${resource}`, 'LOCK_UNAVAILABLE', options);
+        this.name = 'LockUnavailableError';
+    }
+}
+/**
+ * Thrown when a path key cannot be resolved
+ */
+export class PathResolutionError extends PdError {
+    constructor(key, options) {
+        super(`[PD:Path] Unknown path key: ${key}`, 'PATH_RESOLUTION_ERROR', options);
+        this.name = 'PathResolutionError';
+    }
+}
+/**
+ * Thrown when a workspace cannot be found
+ */
+export class WorkspaceNotFoundError extends PdError {
+    constructor(workspace, options) {
+        super(`[PD:Workspace] Workspace not found: ${workspace}`, 'WORKSPACE_NOT_FOUND', options);
+        this.name = 'WorkspaceNotFoundError';
+    }
+}
+/**
+ * Thrown when a required sample cannot be found
+ */
+export class SampleNotFoundError extends PdError {
+    constructor(sampleId, options) {
+        super(`[PD:Sample] Correction sample not found: ${sampleId}`, 'SAMPLE_NOT_FOUND', options);
+        this.name = 'SampleNotFoundError';
+    }
+}
+/**
+ * Thrown when configuration is invalid or missing required fields
+ */
+export class ConfigurationError extends PdError {
+    constructor(message, options) {
+        super(`[PD:Config] ${message}`, 'CONFIGURATION_ERROR', options);
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Thrown when prompt/logger dependencies are unavailable
+ */
+export class DependencyError extends PdError {
+    constructor(component, message, options) {
+        super(`[PD:${component}] ${message}`, 'DEPENDENCY_ERROR', options);
+        this.name = 'DependencyError';
+    }
+}
+/**
+ * Thrown when evolution worker encounters a processing error
+ */
+export class EvolutionProcessingError extends PdError {
+    constructor(message, options) {
+        super(`[PD:Evolution] ${message}`, 'EVOLUTION_PROCESSING_ERROR', options);
+        this.name = 'EvolutionProcessingError';
+    }
+}
+/**
+ * Thrown when trajectory operations fail
+ */
+export class TrajectoryError extends PdError {
+    constructor(message, options) {
+        super(`[PD:Trajectory] ${message}`, 'TRAJECTORY_ERROR', options);
+        this.name = 'TrajectoryError';
+    }
+}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Configuration module for Principles Disciple
+ *
+ * Centralizes all configuration defaults, types, and domain errors.
+ */
+export * from './defaults/runtime.js';
+export * from './errors.js';

package/dist/config/index.js

@@ -0,0 +1,7 @@
+/**
+ * Configuration module for Principles Disciple
+ *
+ * Centralizes all configuration defaults, types, and domain errors.
+ */
+export * from './defaults/runtime.js';
+export * from './errors.js';

package/dist/constants/diagnostician.d.ts

@@ -10,7 +10,3 @@
  * 完整版见: templates/langs/zh/skills/pd-diagnostician/SKILL.md
  */
 export declare const DIAGNOSTICIAN_PROTOCOL_SUMMARY = "## Diagnostic Protocol (5 Whys)\n\n**Phase 1 - Evidence Gathering**:\n- Read logs: .state/logs/events.jsonl, SYSTEM.log\n- Search code for error patterns from Reason field\n- Record evidence sources\n\n**Phase 2 - Causal Chain**:\n- Each Why must have evidence support\n- Maximum 5 layers\n- Stop when reaching actionable root cause\n\n**Phase 3 - Root Cause Classification**:\nClassify into one of:\n- **People**: Human error, missing knowledge, communication gap\n- **Design**: Architecture flaw, missing validation, poor abstraction\n- **Assumption**: Invalid assumption, outdated context, edge case\n- **Tooling**: Tool limitation, environment issue, dependency problem\n\n**Phase 4 - Principle Extraction**:\nExtract protection principle with:\n- **trigger_pattern**: When this situation occurs\n- **action**: What to do differently\n\n**Output Format**:\n```json\n{\n  \"diagnosis_report\": {\n    \"task_id\": \"pain-xxx\",\n    \"summary\": \"One-line root cause\",\n    \"causal_chain\": [\n      { \"why\": 1, \"answer\": \"...\", \"evidence\": \"...\" }\n    ],\n    \"root_cause\": {\n      \"category\": \"Design|People|Assumption|Tooling\",\n      \"description\": \"...\"\n    },\n    \"principle\": {\n      \"trigger_pattern\": \"...\",\n      \"action\": \"...\"\n    }\n  }\n}\n```\n";
-/**
- * 完整诊断协议文件路径（相对于插件根目录）
- */
-export declare const DIAGNOSTICIAN_SKILL_PATH = "templates/langs/zh/skills/pd-diagnostician/SKILL.md";

package/dist/constants/diagnostician.js

@@ -54,7 +54,3 @@ Extract protection principle with:
 }
 \`\`\`
 `;
-/**
- * 完整诊断协议文件路径（相对于插件根目录）
- */
-export const DIAGNOSTICIAN_SKILL_PATH = 'templates/langs/zh/skills/pd-diagnostician/SKILL.md';

package/dist/constants/tools.d.ts

@@ -1,11 +1,11 @@
-export declare const READ_ONLY_TOOL_NAMES: readonly ["read", "read_file", "read_many_files", "image_read", "search_file_content", "grep", "grep_search", "list_directory", "ls", "glob", "lsp_hover", "lsp_goto_definition", "lsp_find_references", "web_fetch", "web_search", "ref_search_documentation", "ref_read_url", "resolve-library-id", "get-library-docs", "memory_recall", "save_memory", "todo_read", "todo_write", "ask_user", "ask_user_question", "deep_reflect", "pd-status", "trust", "report"];
+export declare const READ_ONLY_TOOL_NAMES: readonly ["read", "read_file", "read_many_files", "image_read", "search_file_content", "grep", "grep_search", "list_directory", "ls", "glob", "lsp_hover", "lsp_goto_definition", "lsp_find_references", "web_fetch", "web_search", "ref_search_documentation", "ref_read_url", "resolve-library-id", "get-library-docs", "memory_recall", "save_memory", "todo_read", "todo_write", "ask_user", "ask_user_question", "deep_reflect", "pd-status", "report"];
 export declare const LOW_RISK_WRITE_TOOL_NAMES: readonly ["write", "write_file", "edit", "edit_file", "replace", "apply_patch", "insert", "patch"];
 export declare const BASH_TOOL_NAMES: readonly ["bash", "run_shell_command", "exec", "execute", "shell", "cmd"];
 export declare const HIGH_RISK_TOOL_NAMES: readonly ["delete_file", "move_file", "bash", "run_shell_command", "exec", "execute", "shell", "cmd"];
 export declare const AGENT_TOOL_NAMES: readonly ["sessions_spawn"];
 export declare const CONTENT_LIMITED_TOOL_NAMES: readonly ["write", "write_file", "edit", "edit_file", "replace", "apply_patch", "insert", "patch"];
 export declare const CONSTRUCTIVE_TOOL_NAMES: readonly ["write", "write_file", "edit", "edit_file", "replace", "apply_patch", "insert", "patch", "delete_file", "move_file", "bash", "run_shell_command", "exec", "execute", "shell", "cmd", "sessions_spawn", "evolve-task", "init-strategy"];
-export declare const EXPLORATORY_TOOL_NAMES: readonly ["read", "read_file", "read_many_files", "image_read", "search_file_content", "grep", "grep_search", "list_directory", "ls", "glob", "lsp_hover", "lsp_goto_definition", "lsp_find_references", "web_fetch", "web_search", "ref_search_documentation", "ref_read_url", "resolve-library-id", "get-library-docs", "memory_recall", "save_memory", "todo_read", "todo_write", "ask_user", "ask_user_question", "deep_reflect", "pd-status", "trust", "report"];
+export declare const EXPLORATORY_TOOL_NAMES: readonly ["read", "read_file", "read_many_files", "image_read", "search_file_content", "grep", "grep_search", "list_directory", "ls", "glob", "lsp_hover", "lsp_goto_definition", "lsp_find_references", "web_fetch", "web_search", "ref_search_documentation", "ref_read_url", "resolve-library-id", "get-library-docs", "memory_recall", "save_memory", "todo_read", "todo_write", "ask_user", "ask_user_question", "deep_reflect", "pd-status", "report"];
 export declare const READ_ONLY_TOOLS: Set<string>;
 export declare const LOW_RISK_WRITE_TOOLS: Set<string>;
 export declare const HIGH_RISK_TOOLS: Set<string>;

package/dist/constants/tools.js

@@ -7,7 +7,7 @@ export const READ_ONLY_TOOL_NAMES = [
     'memory_recall', 'save_memory', 'todo_read', 'todo_write',
     'ask_user', 'ask_user_question',
     'deep_reflect',
-    'pd-status', 'trust', 'report',
+    'pd-status', 'report',
 ];
 export const LOW_RISK_WRITE_TOOL_NAMES = [
     'write', 'write_file',

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

@@ -0,0 +1,186 @@
+/**
+ * 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;