create-principles-disciple 1.0.0 → 1.73.0

package/plugin/dist/commands/workflow-debug.js

@@ -0,0 +1,111 @@
+import { WorkflowStore } from '../service/subagent-workflow/workflow-store.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+function formatTimestamp(ts) {
+    if (!ts)
+        return '--';
+    return new Date(ts).toISOString();
+}
+function formatState(state) {
+    const stateColors = {
+        'active': '●',
+        'wait_result': '◐',
+        'finalizing': '◑',
+        'completed': '✓',
+        'terminal_error': '✗',
+        'cleanup_pending': '⚠',
+        'expired': '⊘',
+    };
+    const icon = stateColors[state] || '?';
+    return `${icon} ${state}`;
+}
+function buildOutput(workflowId, summary, events, workspaceDir) {
+    if (!summary) {
+        return [
+            `Workflow Debug: ${workflowId}`,
+            '============================',
+            '',
+            '❌ Workflow not found',
+            '',
+            `Workspace: ${workspaceDir}`,
+        ].join('\n');
+    }
+    const metadata = JSON.parse(summary.metadata_json || '{}');
+    const recentEvents = events.slice(-10);
+    const lines = [
+        `Workflow Debug: ${workflowId}`,
+        '============================',
+        '',
+        'Overview',
+        `- Type: ${summary.workflow_type}`,
+        `- Transport: ${summary.transport}`,
+        `- State: ${formatState(summary.state)}`,
+        `- Cleanup: ${summary.cleanup_state}`,
+        `- Created: ${formatTimestamp(summary.created_at)}`,
+        `- Last Observed: ${formatTimestamp(summary.last_observed_at)}`,
+        '',
+        'Sessions',
+        `- Parent: ${summary.parent_session_id}`,
+        `- Child: ${summary.child_session_key}`,
+        `- Run ID: ${summary.run_id ?? '--'}`,
+        '',
+        'Metadata',
+        `- Workspace: ${metadata.workspaceDir ?? '--'}`,
+        `- Task Input: ${typeof metadata.taskInput === 'string' ? metadata.taskInput.substring(0, 100) + (metadata.taskInput.length > 100 ? '...' : '') : '--'}`,
+        '',
+        `Recent Events (${recentEvents.length})`,
+    ];
+    if (recentEvents.length === 0) {
+        lines.push('- (no events)');
+    }
+    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) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'workflow-debug');
+    // Parse workflow ID from args
+    const args = ctx.args?.trim() || '';
+    const [workflowId] = args.split(/\s+/);
+    if (!workflowId) {
+        return {
+            text: [
+                'Workflow Debug',
+                '============================',
+                '',
+                'Usage: /pd-workflow-debug <workflowId>',
+                '',
+                'Description:',
+                '- Display debug summary for a helper workflow',
+                '- Shows state, cleanup status, and recent events',
+                '',
+                'To find workflow IDs, check .state/subagent_workflows.db',
+            ].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) {
+        return {
+            text: [
+                `Workflow Debug: ${workflowId}`,
+                '============================',
+                '',
+                `❌ Error: ${String(error)}`,
+                '',
+                `Workspace: ${workspaceDir}`,
+            ].join('\n'),
+        };
+    }
+}

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

@@ -0,0 +1,64 @@
+/**
+ * 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;
+/** Idle threshold (30 minutes) */
+export declare const DEFAULT_IDLE_THRESHOLD_MS: number;
+/** Quota window (24 hours) */
+export declare const DEFAULT_QUOTA_WINDOW_MS: number;
+/** Cool down period (30 minutes) */
+export declare const DEFAULT_COOLDOWN_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/plugin/dist/config/defaults/runtime.js

@@ -0,0 +1,81 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * 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',
+];
+// ── 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;
+// ── Nocturnal Runtime Settings ─────────────────────────────────────────────────
+/** Idle threshold (30 minutes) */
+export const DEFAULT_IDLE_THRESHOLD_MS = 30 * ONE_MINUTE_MS;
+/** Quota window (24 hours) */
+export const DEFAULT_QUOTA_WINDOW_MS = ONE_DAY_MS;
+/** Cool down period (30 minutes) */
+export const DEFAULT_COOLDOWN_MS = 30 * ONE_MINUTE_MS;
+// ── 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/plugin/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;
+    });
+}

package/plugin/dist/config/errors.js

@@ -0,0 +1,107 @@
+/**
+ * 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
+ */
+/** Maps legacy PdError codes to canonical PDErrorCategory values. */
+const codeToCategory = {
+    LOCK_UNAVAILABLE: 'lease_conflict',
+    PATH_RESOLUTION_ERROR: 'workspace_invalid',
+    WORKSPACE_NOT_FOUND: 'workspace_invalid',
+    SAMPLE_NOT_FOUND: 'storage_unavailable',
+    CONFIGURATION_ERROR: 'input_invalid',
+    DEPENDENCY_ERROR: 'runtime_unavailable',
+    EVOLUTION_PROCESSING_ERROR: 'execution_failed',
+    TRAJECTORY_ERROR: 'storage_unavailable',
+};
+/**
+ * Base class for all Principles Disciple errors
+ */
+export class PdError extends Error {
+    code;
+    category;
+    constructor(message, code, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'PdError';
+        this.category = codeToCategory[code] ?? 'execution_failed';
+    }
+}
+/**
+ * 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/plugin/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/plugin/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/plugin/dist/constants/diagnostician.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Diagnostician 协议常量
+ *
+ * 用于 Runtime V2 diagnostician prompt
+ * 与 templates/langs/zh/skills/pd-diagnostician/SKILL.md 保持一致
+ */
+/**
+ * 诊断协议摘要（用于 HEARTBEAT.md 注入）
+ *
+ * 完整版见: 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- Use the task input/context provided by Runtime V2 for pain context\n- Read .state/logs/events.jsonl recent entries\n- Search codebase for error patterns from Reason field\n- Record all evidence sources (file:line)\n\n**Phase 2 - Causal Chain (5 Whys)**:\n- Why 1: Surface symptom (what you can see)\n- Why 2: Direct cause (what triggered it)\n- Why 3: Process gap (what should have caught it)\n- Why 4: Design flaw (why the gap exists)\n- Why 5: Root cause (systemic issue to fix)\n- Each Why MUST have evidence. Stop at 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- For Design: analyze why existing hooks/rules didn't catch this\n\n**Phase 4 - Principle Extraction**:\nExtract a HIGHLY ABSTRACTED principle (not an operational rule):\n- **trigger_pattern**: regex/keywords for when this occurs\n- **action**: what to do differently\n- **abstracted_principle**: ONE sentence, max 40 chars, cross-scenario applicable\n  - \u274C Bad: \"\u5199\u5165\u524D\u68C0\u67E5\u76EE\u5F55\u662F\u5426\u5B58\u5728\" (too specific)\n  - \u2705 Good: \"\u4EFB\u4F55\u5199\u5165\u64CD\u4F5C\u5FC5\u987B\u786E\u4FDD\u76EE\u6807\u73AF\u5883\u7684\u5B8C\u6574\u6027\" (abstract, reusable)\n\n**Output Format** (single JSON object):\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\": \"file:line\" }\n    ],\n    \"root_cause\": {\n      \"category\": \"Design|People|Assumption|Tooling\",\n      \"description\": \"...\"\n    },\n    \"principle\": {\n      \"trigger_pattern\": \"...\",\n      \"action\": \"...\",\n      \"abstracted_principle\": \"\u9AD8\u5EA6\u62BD\u8C61\u7684\u4E00\u53E5\u8BDD\u539F\u5219\"\n    }\n  }\n}\n```\n";

package/plugin/dist/constants/diagnostician.js

@@ -0,0 +1,65 @@
+/**
+ * Diagnostician 协议常量
+ *
+ * 用于 Runtime V2 diagnostician prompt
+ * 与 templates/langs/zh/skills/pd-diagnostician/SKILL.md 保持一致
+ */
+/**
+ * 诊断协议摘要（用于 HEARTBEAT.md 注入）
+ *
+ * 完整版见: templates/langs/zh/skills/pd-diagnostician/SKILL.md
+ */
+export const DIAGNOSTICIAN_PROTOCOL_SUMMARY = `## Diagnostic Protocol (5 Whys)
+
+**Phase 1 - Evidence Gathering**:
+- Use the task input/context provided by Runtime V2 for pain context
+- Read .state/logs/events.jsonl recent entries
+- Search codebase for error patterns from Reason field
+- Record all evidence sources (file:line)
+
+**Phase 2 - Causal Chain (5 Whys)**:
+- Why 1: Surface symptom (what you can see)
+- Why 2: Direct cause (what triggered it)
+- Why 3: Process gap (what should have caught it)
+- Why 4: Design flaw (why the gap exists)
+- Why 5: Root cause (systemic issue to fix)
+- Each Why MUST have evidence. Stop at actionable root cause.
+
+**Phase 3 - Root Cause Classification**:
+Classify into one of:
+- **People**: Human error, missing knowledge, communication gap
+- **Design**: Architecture flaw, missing validation, poor abstraction
+- **Assumption**: Invalid assumption, outdated context, edge case
+- **Tooling**: Tool limitation, environment issue, dependency problem
+- For Design: analyze why existing hooks/rules didn't catch this
+
+**Phase 4 - Principle Extraction**:
+Extract a HIGHLY ABSTRACTED principle (not an operational rule):
+- **trigger_pattern**: regex/keywords for when this occurs
+- **action**: what to do differently
+- **abstracted_principle**: ONE sentence, max 40 chars, cross-scenario applicable
+  - ❌ Bad: "写入前检查目录是否存在" (too specific)
+  - ✅ Good: "任何写入操作必须确保目标环境的完整性" (abstract, reusable)
+
+**Output Format** (single JSON object):
+\`\`\`json
+{
+  "diagnosis_report": {
+    "task_id": "pain-xxx",
+    "summary": "One-line root cause",
+    "causal_chain": [
+      { "why": 1, "answer": "...", "evidence": "file:line" }
+    ],
+    "root_cause": {
+      "category": "Design|People|Assumption|Tooling",
+      "description": "..."
+    },
+    "principle": {
+      "trigger_pattern": "...",
+      "action": "...",
+      "abstracted_principle": "高度抽象的一句话原则"
+    }
+  }
+}
+\`\`\`
+`;

package/plugin/dist/constants/tools.d.ts

@@ -0,0 +1,17 @@
+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", "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", "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>;
+export declare const BASH_TOOLS_SET: Set<string>;
+export declare const AGENT_TOOLS: Set<string>;
+export declare const CONTENT_LIMITED_TOOLS: Set<string>;
+export declare const CONSTRUCTIVE_TOOLS: Set<string>;
+export declare const EXPLORATORY_TOOLS: Set<string>;
+export declare const WRITE_TOOLS: Set<string>;

package/plugin/dist/constants/tools.js

@@ -0,0 +1,53 @@
+export const READ_ONLY_TOOL_NAMES = [
+    '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',
+    'pd-status', 'report',
+];
+export const LOW_RISK_WRITE_TOOL_NAMES = [
+    'write', 'write_file',
+    'edit', 'edit_file', 'replace', 'apply_patch', 'insert', 'patch',
+];
+// BASH aliases must be defined before HIGH_RISK_TOOL_NAMES
+export const BASH_TOOL_NAMES = [
+    'bash', 'run_shell_command', 'exec', 'execute', 'shell', 'cmd',
+];
+export const HIGH_RISK_TOOL_NAMES = [
+    'delete_file', 'move_file',
+    // Include all BASH aliases for consistent high-risk classification
+    ...BASH_TOOL_NAMES,
+];
+export const AGENT_TOOL_NAMES = [
+    'sessions_spawn',
+];
+export const CONTENT_LIMITED_TOOL_NAMES = [
+    ...LOW_RISK_WRITE_TOOL_NAMES,
+];
+export const CONSTRUCTIVE_TOOL_NAMES = [
+    ...LOW_RISK_WRITE_TOOL_NAMES,
+    'delete_file', 'move_file',
+    // Include all BASH aliases for consistent constructive classification
+    ...BASH_TOOL_NAMES,
+    ...AGENT_TOOL_NAMES,
+    'evolve-task', 'init-strategy',
+];
+export const EXPLORATORY_TOOL_NAMES = [
+    ...READ_ONLY_TOOL_NAMES,
+];
+export const READ_ONLY_TOOLS = new Set(READ_ONLY_TOOL_NAMES);
+export const LOW_RISK_WRITE_TOOLS = new Set(LOW_RISK_WRITE_TOOL_NAMES);
+export const HIGH_RISK_TOOLS = new Set(HIGH_RISK_TOOL_NAMES);
+export const BASH_TOOLS_SET = new Set(BASH_TOOL_NAMES);
+export const AGENT_TOOLS = new Set(AGENT_TOOL_NAMES);
+export const CONTENT_LIMITED_TOOLS = new Set(CONTENT_LIMITED_TOOL_NAMES);
+export const CONSTRUCTIVE_TOOLS = new Set(CONSTRUCTIVE_TOOL_NAMES);
+export const EXPLORATORY_TOOLS = new Set(EXPLORATORY_TOOL_NAMES);
+export const WRITE_TOOLS = new Set([
+    ...LOW_RISK_WRITE_TOOL_NAMES,
+    'delete_file',
+    'move_file',
+]);

package/plugin/dist/core/__tests__/focus-history.test.d.ts

@@ -0,0 +1 @@
+export {};