principles-disciple 1.126.0 → 1.128.0

package/{src/commands/thinking-os.ts → dist/commands/thinking-os.js}

@@ -1,19 +1,15 @@
- 
 import * as fs from 'fs';
-import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import { normalizeCommandArgs } from '../utils/io.js';
 import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
-
-function getWorkspaceDir(ctx: PluginCommandContext): string {
+function getWorkspaceDir(ctx) {
     return resolvePluginCommandWorkspaceDir(ctx, 'thinking-os');
 }
-
-function getModels(wctx: WorkspaceContext): Record<string, string> {
+function getModels(wctx) {
     const modelsPath = wctx.resolve('THINKING_OS');
-    const models: Record<string, string> = {};
-    if (!fs.existsSync(modelsPath)) return models;
-
+    const models = {};
+    if (!fs.existsSync(modelsPath))
+        return models;
     try {
         const content = fs.readFileSync(modelsPath, 'utf8');
         const lines = content.split('\n');
@@ -23,61 +19,51 @@ function getModels(wctx: WorkspaceContext): Record<string, string> {
                 models[match[1]] = match[2].trim();
             }
         }
-    } catch (e) {
+    }
+    catch (e) {
         console.debug('[PD] Failed to read THINKING_OS.md:', e);
     }
     return models;
 }
-
-function formatUsageReport(wctx: WorkspaceContext): string {
+function formatUsageReport(wctx) {
     const logPath = wctx.resolve('THINKING_OS_USAGE');
-
     if (!fs.existsSync(logPath)) {
         return '📊 No usage data yet. The Thinking OS has not been active long enough to collect statistics.';
     }
-
     try {
-        const usage: Record<string, number> = JSON.parse(fs.readFileSync(logPath, 'utf8'));
+        const usage = JSON.parse(fs.readFileSync(logPath, 'utf8'));
         const totalTurns = usage._total_turns || 1;
         const models = getModels(wctx);
-
         let report = `# 🧠 Thinking OS — Usage Report\n\n`;
         report += `Total turns tracked: **${totalTurns}**\n\n`;
         report += `| Model | Name | Hits | Rate |\n|---|---|---|---|\n`;
-
         for (const [id, name] of Object.entries(models)) {
             const hits = usage[id] || 0;
             const rate = totalTurns > 0 ? ((hits / totalTurns) * 100).toFixed(1) : '0.0';
             const status = hits === 0 ? '⚠️' : (parseFloat(rate) < 5 ? '🔸' : '✅');
             report += `| ${id} | ${name} | ${hits} | ${status} ${rate}% |\n`;
         }
-
         const dormant = Object.entries(models)
             .filter(([id]) => (usage[id] || 0) === 0)
             .map(([id, name]) => `- ${id}: ${name}`);
-
         if (dormant.length > 0) {
             report += `\n### ⚠️ Dormant Models (0 hits)\n${dormant.join('\n')}\n`;
             report += `\nConsider: Are these models not applicable to current tasks, or is the agent ignoring them?\n`;
         }
-
         return report;
-    } catch (e) {
+    }
+    catch (e) {
         return `❌ Failed to read usage data: ${String(e)}`;
     }
 }
-
-function handlePropose(wctx: WorkspaceContext, proposal: string): string {
+function handlePropose(wctx, proposal) {
     if (!proposal.trim()) {
         return '❌ Usage: `/thinking-os propose <description of your proposed mental model>`';
     }
-    
     if (!proposal.toLowerCase().includes('signal') && !proposal.includes('信号')) {
         return '❌ Invalid proposal: A mental model must include a "Signal detection / 信号检测" section explaining how to detect its usage via regex.';
     }
-
     const candidatesPath = wctx.resolve('THINKING_OS_CANDIDATES');
-    
     if (fs.existsSync(candidatesPath)) {
         try {
             const content = fs.readFileSync(candidatesPath, 'utf8');
@@ -85,66 +71,60 @@ function handlePropose(wctx: WorkspaceContext, proposal: string): string {
             if (content.includes(snippet)) {
                 return '❌ Duplicate proposal detected. A similar candidate already exists.';
             }
-        } catch (e) {
+        }
+        catch (e) {
             console.debug('[PD] Error reading candidates file:', e);
         }
     }
-    
     const timestamp = new Date().toISOString();
     const entry = `\n### Candidate (${timestamp})\n${proposal.trim()}\n- Status: PENDING\n- Validated in tasks: 0/3\n---\n`;
-
     try {
         fs.appendFileSync(candidatesPath, entry, 'utf8');
         return `✅ Mental model proposal recorded in \`${candidatesPath.replace(wctx.workspaceDir, '')}\`.\nIt needs validation in ≥3 different task types and human approval before promotion.`;
-    } catch (e) {
+    }
+    catch (e) {
         return `❌ Failed to write proposal: ${String(e)}`;
     }
 }
-
-function formatAuditReport(wctx: WorkspaceContext): string {
+function formatAuditReport(wctx) {
     const logPath = wctx.resolve('THINKING_OS_USAGE');
     const thinkingOsPath = wctx.resolve('THINKING_OS');
-
     let report = `# 🔍 Thinking OS — Audit Report\n\n`;
-
     if (!fs.existsSync(thinkingOsPath)) {
         report += `⚠️ **THINKING_OS.md not found.** The cognitive layer is not active.\n`;
         return report;
     }
-
     const models = getModels(wctx);
     const modelCount = Object.keys(models).length;
     report += `**Active models**: ${modelCount}\n\n`;
-
     if (!fs.existsSync(logPath)) {
         report += `📊 No usage data collected yet. Run some tasks first.\n`;
         return report;
     }
-
     try {
-        const usage: Record<string, number> = JSON.parse(fs.readFileSync(logPath, 'utf8'));
+        const usage = JSON.parse(fs.readFileSync(logPath, 'utf8'));
         const totalTurns = usage._total_turns || 1;
-
-        const overused: string[] = [];
-        const underused: string[] = [];
-        const healthy: string[] = [];
-
+        const overused = [];
+        const underused = [];
+        const healthy = [];
         for (const [id, name] of Object.entries(models)) {
             const hits = usage[id] || 0;
             const rate = (hits / totalTurns) * 100;
-
-            if (rate > 50) overused.push(`- ${id} (${name}): ${rate.toFixed(1)}% — possibly too broad a pattern?`);
-            else if (hits === 0 && totalTurns > 10) underused.push(`- ${id} (${name}): 0 hits in ${totalTurns} turns — candidate for archival?`);
-            else healthy.push(`- ${id} (${name}): ${rate.toFixed(1)}%`);
+            if (rate > 50)
+                overused.push(`- ${id} (${name}): ${rate.toFixed(1)}% — possibly too broad a pattern?`);
+            else if (hits === 0 && totalTurns > 10)
+                underused.push(`- ${id} (${name}): 0 hits in ${totalTurns} turns — candidate for archival?`);
+            else
+                healthy.push(`- ${id} (${name}): ${rate.toFixed(1)}%`);
         }
-
-        if (healthy.length > 0) report += `### ✅ Healthy\n${healthy.join('\n')}\n\n`;
-        if (overused.length > 0) report += `### 🔸 Possibly Over-triggered\n${overused.join('\n')}\n\n`;
+        if (healthy.length > 0)
+            report += `### ✅ Healthy\n${healthy.join('\n')}\n\n`;
+        if (overused.length > 0)
+            report += `### 🔸 Possibly Over-triggered\n${overused.join('\n')}\n\n`;
         if (underused.length > 0) {
             report += `### ⚠️ Candidate for Archival\n${underused.join('\n')}\n`;
             report += `> 💡 Suggestion: Review these models. If they are obsolete, move them to the archive.\n\n`;
         }
-
         const candidatesPath = wctx.resolve('THINKING_OS_CANDIDATES');
         if (fs.existsSync(candidatesPath)) {
             const candidates = fs.readFileSync(candidatesPath, 'utf8');
@@ -153,20 +133,18 @@ function formatAuditReport(wctx: WorkspaceContext): string {
                 report += `### 📝 Pending Candidates: ${pendingCount}\nReview candidates to fill gaps.\n`;
             }
         }
-
         return report;
-    } catch (e) {
+    }
+    catch (e) {
         return `❌ Failed to generate audit report: ${String(e)}`;
     }
 }
-
-export function handleThinkingOs(ctx: PluginCommandContext): PluginCommandResult {
+export function handleThinkingOs(ctx) {
     const workspaceDir = getWorkspaceDir(ctx);
     const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
     const args = normalizeCommandArgs(ctx.args).trim();
     const subCommand = args.split(/\s+/)[0]?.toLowerCase();
     const rest = args.slice(subCommand?.length || 0).trim();
-
     switch (subCommand) {
         case 'status':
             return { text: formatUsageReport(wctx) };
@@ -176,8 +154,7 @@ export function handleThinkingOs(ctx: PluginCommandContext): PluginCommandResult
             return { text: formatAuditReport(wctx) };
         default:
             return {
-                text:
-                    `🧠 **Thinking OS — Governance Console**\n\n` +
+                text: `🧠 **Thinking OS — Governance Console**\n\n` +
                     `Usage:\n` +
                     `- \`/thinking-os status\` — View mental model usage statistics\n` +
                     `- \`/thinking-os propose <model description>\` — Propose a new mental model\n` +

package/dist/commands/workflow-debug.d.ts

@@ -0,0 +1,6 @@
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+export declare function handleWorkflowDebugCommand(ctx: PluginCommandContext & {
+    args?: string;
+}): {
+    text: string;
+};

package/{src/commands/workflow-debug.ts → dist/commands/workflow-debug.js}

@@ -1,14 +1,12 @@
 import { WorkflowStore } from '../service/subagent-workflow/workflow-store.js';
-import type { PluginCommandContext } from '../openclaw-sdk.js';
 import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-
-function formatTimestamp(ts: number | null | undefined): string {
-    if (!ts) return '--';
+function formatTimestamp(ts) {
+    if (!ts)
+        return '--';
     return new Date(ts).toISOString();
 }
-
-function formatState(state: string): string {
-    const stateColors: Record<string, string> = {
+function formatState(state) {
+    const stateColors = {
         'active': '●',
         'wait_result': '◐',
         'finalizing': '◑',
@@ -20,15 +18,7 @@ function formatState(state: string): string {
     const icon = stateColors[state] || '?';
     return `${icon} ${state}`;
 }
-
- 
- 
-function buildOutput(
-    workflowId: string,
-    summary: ReturnType<InstanceType<typeof WorkflowStore>['getWorkflow']>,
-    events: ReturnType<InstanceType<typeof WorkflowStore>['getEvents']>,
-    workspaceDir: string
-): string {
+function buildOutput(workflowId, summary, events, workspaceDir) {
     if (!summary) {
         return [
             `Workflow Debug: ${workflowId}`,
@@ -39,11 +29,9 @@ function buildOutput(
             `Workspace: ${workspaceDir}`,
         ].join('\n');
     }
-
     const metadata = JSON.parse(summary.metadata_json || '{}');
     const recentEvents = events.slice(-10);
-
-    const lines: string[] = [
+    const lines = [
         `Workflow Debug: ${workflowId}`,
         '============================',
         '',
@@ -66,32 +54,25 @@ function buildOutput(
         '',
         `Recent Events (${recentEvents.length})`,
     ];
-
     if (recentEvents.length === 0) {
         lines.push('- (no events)');
-    } else {
+    }
+    else {
         for (const event of recentEvents) {
             const time = formatTimestamp(event.created_at);
             const transition = event.from_state ? `${event.from_state} → ${event.to_state}` : `→ ${event.to_state}`;
             lines.push(`- [${time}] ${event.event_type}: ${transition} (${event.reason})`);
         }
     }
-
     lines.push('');
     lines.push(`Workspace: ${workspaceDir}`);
-
     return lines.join('\n');
 }
-
-export function handleWorkflowDebugCommand(
-    ctx: PluginCommandContext & { args?: string }
-): { text: string } {
+export function handleWorkflowDebugCommand(ctx) {
     const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'workflow-debug');
-    
     // Parse workflow ID from args
-    const args = (ctx as { args?: string }).args?.trim() || '';
+    const args = ctx.args?.trim() || '';
     const [workflowId] = args.split(/\s+/);
-
     if (!workflowId) {
         return {
             text: [
@@ -108,15 +89,14 @@ export function handleWorkflowDebugCommand(
             ].join('\n'),
         };
     }
-
     try {
         const store = new WorkflowStore({ workspaceDir });
         const workflow = store.getWorkflow(workflowId);
         const events = store.getEvents(workflowId);
         store.dispose();
-
         return { text: buildOutput(workflowId, workflow, events, workspaceDir) };
-    } catch (error) {
+    }
+    catch (error) {
         return {
             text: [
                 `Workflow Debug: ${workflowId}`,

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

@@ -0,0 +1,58 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * All runtime-related constants that were previously scattered across modules.
+ * Centralizing these makes it easier to tune behavior and understand limits.
+ */
+/** Milliseconds per second */
+export declare const MS_PER_SECOND = 1000;
+/** Seconds per minute */
+export declare const SECONDS_PER_MINUTE = 60;
+/** Minutes per hour */
+export declare const MINUTES_PER_HOUR = 60;
+/** Hours per day */
+export declare const HOURS_PER_DAY = 24;
+/** Days per week */
+export declare const DAYS_PER_WEEK = 7;
+/** One minute in milliseconds */
+export declare const ONE_MINUTE_MS: number;
+/** One hour in milliseconds */
+export declare const ONE_HOUR_MS: number;
+/** One day in milliseconds */
+export declare const ONE_DAY_MS: number;
+/** One week in milliseconds */
+export declare const ONE_WEEK_MS: number;
+/** Default TTL for helper workflows (5 minutes) */
+export declare const WORKFLOW_TTL_MS: number;
+/** Default workflow timeout (15 minutes) */
+export declare const WORKFLOW_TIMEOUT_MS: number;
+/** Default workflow sweep interval (30 minutes) */
+export declare const WORKFLOW_SWEEP_MS: number;
+/**
+ * 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;
+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 interval (15 minutes) */
+export declare const EVOLUTION_WORKER_POLL_INTERVAL_MS: number;
+/** Evolution queue batch size */
+export declare const EVOLUTION_QUEUE_BATCH_SIZE = 10;
+export declare const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
+export declare const SESSION_MAX_IDLE_MS: number;
+export declare const EVENT_LOG_BUFFER_SIZE = 20;
+export declare const EVENT_LOG_FLUSH_INTERVAL_MS: number;
+/** Default busy timeout for SQLite operations (5 seconds) */
+export declare const DEFAULT_BUSY_TIMEOUT_MS: number;
+/** Max string length for trajectory/event logs */
+export declare const MAX_STRING_LENGTH = 1000;
+/** Default max file size (10MB) */
+export declare const MAX_FILE_SIZE_BYTES: number;
+/** Two hours in milliseconds */
+export declare const TWO_HOURS_MS: number;

package/{src/config/defaults/runtime.ts → dist/config/defaults/runtime.js}

@@ -4,108 +4,71 @@
  * All runtime-related constants that were previously scattered across modules.
  * Centralizing these makes it easier to tune behavior and understand limits.
  */
-
 // ── Time Constants ──────────────────────────────────────────────────────────────
-
 /** Milliseconds per second */
 export const MS_PER_SECOND = 1000;
-
 /** Seconds per minute */
 export const SECONDS_PER_MINUTE = 60;
-
 /** Minutes per hour */
 export const MINUTES_PER_HOUR = 60;
-
 /** Hours per day */
 export const HOURS_PER_DAY = 24;
-
 /** Days per week */
 export const DAYS_PER_WEEK = 7;
-
 /** One minute in milliseconds */
 export const ONE_MINUTE_MS = SECONDS_PER_MINUTE * MS_PER_SECOND;
-
 /** One hour in milliseconds */
 export const ONE_HOUR_MS = MINUTES_PER_HOUR * SECONDS_PER_MINUTE * MS_PER_SECOND;
-
 /** One day in milliseconds */
 export const ONE_DAY_MS = HOURS_PER_DAY * ONE_HOUR_MS;
-
 /** One week in milliseconds */
 export const ONE_WEEK_MS = DAYS_PER_WEEK * ONE_DAY_MS;
-
 // ── Workflow TTL & Timeouts ────────────────────────────────────────────────────
-
 /** Default TTL for helper workflows (5 minutes) */
 export const WORKFLOW_TTL_MS = 5 * ONE_MINUTE_MS;
-
 /** Default workflow timeout (15 minutes) */
 export const WORKFLOW_TIMEOUT_MS = 15 * ONE_MINUTE_MS;
-
 /** Default workflow sweep interval (30 minutes) */
 export const WORKFLOW_SWEEP_MS = 30 * ONE_MINUTE_MS;
-
 // ── Trajectory Gate Block Retry Settings ──────────────────────────────────────
-
 /**
  * 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 * ONE_MINUTE_MS;
 export const THINKING_CHECKPOINT_DEFAULT_HIGH_RISK_TOOLS = [
-  'run_shell_command',
-  'delete_file',
-  'move_file',
-] as const;
-
+    'run_shell_command',
+    'delete_file',
+    'move_file',
+];
 // ── GFI Gate Thresholds ───────────────────────────────────────────────────────
-
 /** 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 Settings ───────────────────────────────────────────────────
-
 /** Evolution worker polling interval (15 minutes) */
 export const EVOLUTION_WORKER_POLL_INTERVAL_MS = 15 * ONE_MINUTE_MS;
-
 /** Evolution queue batch size */
 export const EVOLUTION_QUEUE_BATCH_SIZE = 10;
-
 // ── Session Tracker Settings ───────────────────────────────────────────────────
-
 export const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
 export const SESSION_MAX_IDLE_MS = 30 * ONE_MINUTE_MS;
-
 // ── Event Log Buffer Settings ───────────────────────────────────────────────────
-
 export const EVENT_LOG_BUFFER_SIZE = 20;
 export const EVENT_LOG_FLUSH_INTERVAL_MS = 30 * MS_PER_SECOND;
-
 // ── Default Busy Timeout ───────────────────────────────────────────────────────
-
 /** Default busy timeout for SQLite operations (5 seconds) */
 export const DEFAULT_BUSY_TIMEOUT_MS = 5 * MS_PER_SECOND;
-
 // ── String & Size Limits ────────────────────────────────────────────────────────
-
 /** Max string length for trajectory/event logs */
 export const MAX_STRING_LENGTH = 1000;
-
 /** Default max file size (10MB) */
 export const MAX_FILE_SIZE_BYTES = 10 * 1024 * 1024;
-
 // ── Workflow TTL Settings ───────────────────────────────────────────────────────
-
-
 // ── Time Window Constants ───────────────────────────────────────────────────────
-
 /** Two hours in milliseconds */
 export const TWO_HOURS_MS = 2 * ONE_HOUR_MS;

package/dist/config/errors.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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
+ */
+import type { PDErrorCategory } from '@principles/core';
+/**
+ * Base class for all Principles Disciple errors
+ */
+export declare class PdError extends Error {
+    readonly code: string;
+    readonly category: PDErrorCategory;
+    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;
+    });
+}