create-principles-disciple 1.104.0 → 1.104.2

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

@@ -1,132 +0,0 @@
-import { WorkflowStore } from '../service/subagent-workflow/workflow-store.js';
-import { normalizeCommandArgs } from '../utils/io.js';
-import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-// rc-1/rc-2: Treat JSON.parse output as unknown and validate before use.
-function isRecord(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-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}`;
-}
-// rc-5: Use Object.hasOwn for untrusted object keys. Returns string or '--'.
-function readStringField(record, key) {
-    if (Object.hasOwn(record, key) && typeof record[key] === 'string') {
-        return record[key];
-    }
-    return '--';
-}
-function buildOutput(workflowId, summary, events, workspaceDir) {
-    if (!summary) {
-        return [
-            `Workflow Debug: ${workflowId}`,
-            '============================',
-            '',
-            '❌ Workflow not found',
-            '',
-            `Workspace: ${workspaceDir}`,
-        ].join('\n');
-    }
-    // rc-1: JSON.parse output is unknown. rc-2: do not bypass with `as`.
-    const rawMetadata = JSON.parse(summary.metadata_json || '{}');
-    const metadata = isRecord(rawMetadata) ? rawMetadata : {};
-    const workspaceField = readStringField(metadata, 'workspaceDir');
-    // rc-4: Validate taskInput element type before substring.
-    let taskInputPreview = '--';
-    if (Object.hasOwn(metadata, 'taskInput') && typeof metadata['taskInput'] === 'string') {
-        const ti = metadata['taskInput'];
-        taskInputPreview = ti.substring(0, 100) + (ti.length > 100 ? '...' : '');
-    }
-    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: ${workspaceField}`,
-        `- Task Input: ${taskInputPreview}`,
-        '',
-        `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');
-    // rc-2: Do not use `as` to bypass; use normalizeCommandArgs for string|string[] union.
-    const args = normalizeCommandArgs(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.js

@@ -1,74 +0,0 @@
-/**
- * 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;
-// ── 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.js

@@ -1,107 +0,0 @@
-/**
- * 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.js

@@ -1,7 +0,0 @@
-/**
- * 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/tools.js

@@ -1,53 +0,0 @@
-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.js

@@ -1,160 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-import { autoCompressFocus, cleanupStaleInfo } from '../focus-history.js';
-function makeFocusContent(artifactRows, extraLines = 0) {
-    const lines = [
-        '# CURRENT_FOCUS',
-        '',
-        '**版本**: v1',
-        '**更新**: 2026-05-09',
-        '',
-        '## 📍 状态快照',
-        '',
-        '当前聚焦于核心功能开发。',
-        '',
-        '## 🔄 当前任务',
-        '',
-        '- [ ] 实现新功能',
-        '- [ ] 修复已知问题',
-        '- [ ] 完善测试覆盖',
-        '',
-        '## ➡️ 下一步',
-        '',
-        '1. 完成 PRI-82 E2E 测试',
-        '2. 提交代码审查',
-        '',
-        '## 🧠 Working Memory',
-        '',
-        '> Last updated: 2026-05-09T12:00:00Z',
-        '',
-        '### 📁 文件输出记录',
-        '',
-        '| 文件路径 | 操作 | 描述 |',
-        '|----------|------|------|',
-    ];
-    for (const row of artifactRows) {
-        lines.push(row);
-    }
-    lines.push('');
-    lines.push('### ⚠️ 活动问题');
-    lines.push('- 测试覆盖不足 → 增加E2E测试');
-    lines.push('');
-    lines.push('### ➡️ 下一步行动');
-    lines.push('1. 完成回归测试');
-    lines.push('2. 提交PR');
-    lines.push('');
-    for (let i = 0; i < extraLines; i++) {
-        lines.push(`<!-- padding line ${i} -->`);
-    }
-    return lines.join('\n');
-}
-describe('autoCompressFocus E2E regression (PRI-82)', () => {
-    let tmpDir;
-    let workspaceDir;
-    let stateDir;
-    let focusPath;
-    beforeEach(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-focus-e2e-'));
-        workspaceDir = tmpDir;
-        stateDir = path.join(tmpDir, '.state');
-        fs.mkdirSync(stateDir, { recursive: true });
-        const focusDir = path.join(tmpDir, 'okr');
-        fs.mkdirSync(focusDir, { recursive: true });
-        focusPath = path.join(focusDir, 'CURRENT_FOCUS.md');
-    });
-    afterEach(() => {
-        fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it('removes missing-file artifact rows via filesystem filtering before core compression', () => {
-        const existingFile = path.join(workspaceDir, 'src', 'existing-module.ts');
-        fs.mkdirSync(path.join(workspaceDir, 'src'), { recursive: true });
-        fs.writeFileSync(existingFile, 'export const x = 1;');
-        const existingRow = '| `src/existing-module.ts` | modified | 核心模块 |';
-        const missingRow = '| `src/deleted-module.ts` | modified | 已删除模块 |';
-        const content = makeFocusContent([existingRow, missingRow], 90);
-        fs.writeFileSync(focusPath, content);
-        const result = autoCompressFocus(focusPath, workspaceDir, stateDir);
-        expect(result.compressed).toBe(true);
-        expect(result.newContent).toBeDefined();
-        expect(result.newContent).not.toContain('deleted-module.ts');
-        expect(result.newLines).toBeLessThan(result.oldLines);
-        expect(result.reason).toContain('Auto-compressed');
-    });
-    it('goes through core compressFocusContent path when threshold is exceeded', () => {
-        const content = makeFocusContent([
-            '| `src/utils.ts` | created | 工具函数 |',
-        ], 90);
-        fs.writeFileSync(focusPath, content);
-        const result = autoCompressFocus(focusPath, workspaceDir, stateDir);
-        expect(result.compressed).toBe(true);
-        expect(result.reason).toContain('Auto-compressed');
-        const writtenContent = fs.readFileSync(focusPath, 'utf-8');
-        expect(writtenContent).not.toBe(content);
-        expect(writtenContent.split('\n').length).toBeLessThan(content.split('\n').length);
-    });
-    it('does not compress when below threshold', () => {
-        const content = makeFocusContent([
-            '| `src/utils.ts` | created | 工具函数 |',
-        ], 0);
-        fs.writeFileSync(focusPath, content);
-        const result = autoCompressFocus(focusPath, workspaceDir, stateDir);
-        expect(result.compressed).toBe(false);
-        expect(result.reason).toBe('Below threshold');
-    });
-    it('creates backup in history when compressing', () => {
-        const content = makeFocusContent([
-            '| `src/utils.ts` | created | 工具函数 |',
-        ], 90);
-        fs.writeFileSync(focusPath, content);
-        const result = autoCompressFocus(focusPath, workspaceDir, stateDir);
-        expect(result.compressed).toBe(true);
-        expect(result.backupPath).not.toBeNull();
-        const historyDir = path.join(path.dirname(focusPath), '.history');
-        expect(fs.existsSync(historyDir)).toBe(true);
-        const historyFiles = fs.readdirSync(historyDir).filter(f => f.startsWith('CURRENT_FOCUS.v'));
-        expect(historyFiles.length).toBeGreaterThanOrEqual(1);
-    });
-    it('handles workspace without existing files gracefully', () => {
-        const content = makeFocusContent([
-            '| `src/ghost-file.ts` | modified | 不存在的文件 |',
-        ], 90);
-        fs.writeFileSync(focusPath, content);
-        const result = autoCompressFocus(focusPath, workspaceDir, stateDir);
-        expect(result.compressed).toBe(true);
-        expect(result.newContent).not.toContain('ghost-file.ts');
-    });
-});
-describe('cleanupStaleInfo filesystem filtering (PRI-82)', () => {
-    let tmpDir;
-    let workspaceDir;
-    beforeEach(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-cleanup-'));
-        workspaceDir = tmpDir;
-    });
-    afterEach(() => {
-        fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it('preserves artifact row for existing file and removes row for missing file', () => {
-        const existingFile = path.join(workspaceDir, 'src', 'real.ts');
-        fs.mkdirSync(path.join(workspaceDir, 'src'), { recursive: true });
-        fs.writeFileSync(existingFile, 'export const a = 1;');
-        const content = makeFocusContent([
-            '| `src/real.ts` | modified | 真实文件 |',
-            '| `src/phantom.ts` | modified | 幽灵文件 |',
-        ], 0);
-        const result = cleanupStaleInfo(content, workspaceDir);
-        expect(result).toContain('real.ts');
-        expect(result).not.toContain('phantom.ts');
-    });
-    it('preserves all artifact rows when no workspaceDir provided', () => {
-        const content = makeFocusContent([
-            '| `src/real.ts` | modified | 真实文件 |',
-            '| `src/phantom.ts` | modified | 幽灵文件 |',
-        ], 0);
-        const result = cleanupStaleInfo(content);
-        expect(result).toContain('real.ts');
-        expect(result).toContain('phantom.ts');
-    });
-});