principles-disciple 1.7.4 → 1.7.5

package/dist/commands/focus.js

@@ -9,10 +9,8 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { randomUUID } from 'node:crypto';
 import { WorkspaceContext } from '../core/workspace-context.js';
-import { getHistoryDir, backupToHistory, cleanupHistory, extractVersion, extractDate, } from '../core/focus-history.js';
-import { createAgentSpawnTool } from '../tools/agent-spawn.js';
+import { getHistoryDir, backupToHistory, cleanupHistory, extractVersion, extractDate, extractMilestones, archiveMilestonesToDaily, cleanupStaleInfo, } from '../core/focus-history.js';
 /**
  * 清理 Markdown 代码块围栏
  * 移除开头的 ```lang 和结尾的 ```
@@ -45,10 +43,14 @@ function getWorkspaceDir(ctx) {
  * - 移除：当前任务中已完成的项（- [x]）超过 3 个时
  * - 移除：P0 章节如果全部完成
  * - 保留：参考章节
+ * - 清理：Working Memory 超过 10 条记录时保留最近 10 条
+ * - 验证：文件引用指向不存在的文件时移除
  */
-function compressFocusContent(content) {
-    const lines = content.split('\n');
-    const result = [];
+function compressFocusContent(content, workspaceDir) {
+    // 首先使用 cleanupStaleInfo 进行基础清理
+    let result = cleanupStaleInfo(content, workspaceDir);
+    const lines = result.split('\n');
+    const output = [];
     let currentSection = '';
     let inP0Section = false;
     let p0AllCompleted = true;
@@ -59,7 +61,7 @@ function compressFocusContent(content) {
         if (inP0Section && p0Lines.length > 0) {
             if (!skipIfCompleted || !p0AllCompleted) {
                 // P0 有未完成任务，保留 P0 内容
-                result.push(...p0Lines);
+                output.push(...p0Lines);
             }
             // 重置状态
             p0Lines = [];
@@ -86,7 +88,7 @@ function compressFocusContent(content) {
             // 离开 P0 章节
             flushP0Lines(true); // P0 完成时跳过，未完成时保留
             currentSection = 'current';
-            result.push(line);
+            output.push(line);
             continue;
         }
         else if (/^#{1,3}\s*.*当前任务|🔄/.test(trimmedLine)) {
@@ -120,11 +122,11 @@ function compressFocusContent(content) {
                 }
             }
         }
-        result.push(line);
+        output.push(line);
     }
     // 循环结束后，刷新剩余的 P0 章节
     flushP0Lines(false); // 保留未完成的 P0
-    return result.join('\n');
+    return output.join('\n');
 }
 /**
  * 显示 CURRENT_FOCUS 状态
@@ -237,144 +239,26 @@ async function compressFocus(workspaceDir, isZh, api) {
             ? `✅ 当前文件仅 ${oldLines} 行，无需压缩\n\n💡 文件少于 40 行时不建议压缩`
             : `✅ Current file has only ${oldLines} lines, no need to compress\n\n💡 Compression not recommended for files under 40 lines`;
     }
-    // 备份当前版本
+    // 1. 提取里程碑
+    const milestones = extractMilestones(oldContent);
+    // 2. 归档里程碑到 daily memory（而非 MEMORY.md）
+    const archivePath = archiveMilestonesToDaily(workspaceDir, milestones, oldVersion);
+    const milestonesArchived = archivePath !== null;
+    // 3. 备份当前版本
     const backupPath = backupToHistory(focusPath, oldContent);
-    // 清理过期历史
+    // 4. 清理过期历史
     cleanupHistory(focusPath);
-    // 使用子智能体进行智能压缩
-    // 获取 MEMORY.md 路径
-    const memoryPath = wctx.resolve('MEMORY_MD');
-    const compressPrompt = isZh
-        ? `你是一个专业的项目文档压缩助手。请压缩以下 CURRENT_FOCUS.md 文件内容。
-
-**重要：在压缩前，你需要提取重要里程碑信息！**
-
-**第一步：提取里程碑**
-从原始内容中识别已完成的里程碑，这些信息需要保存到记忆文件中。
-
-**第二步：压缩文件**
-压缩规则：
-1. 保留标题、元数据行（版本、状态、日期）
-2. 保留"📍 状态快照"章节（完整）
-3. 保留"➡️ 下一步"章节（完整，这是最重要的信息）
-4. 保留"📎 参考"章节（完整）
-5. 对于"🔄 当前任务"章节：
-   - 如果 P0/P1 等子章节全部完成，合并为简短"已完成里程碑"列表（最多5项）
-   - 保留所有未完成任务（- [ ]）
-   - 已完成任务最多保留 3 个最近的，其余移除
-6. 移除重复信息和冗余描述
-7. 保持 Markdown 格式和语义连贯
-
-**目标：** 将文件压缩到 40 行以内。
-
-**原始内容：**
-\`\`\`markdown
-${oldContent}
-\`\`\`
-
-**输出格式（必须严格遵循）：**
-\`\`\`
-===MEMORY===
-[需要追加到 memory/MEMORY.md 的里程碑内容，格式：]
-## {YYYY-MM-DD} 里程碑
-- [里程碑1]
-- [里程碑2]
-...
-===COMPRESSED===
-[压缩后的 CURRENT_FOCUS.md 内容]
-\`\`\`
-
-如果没有需要记录的里程碑，===MEMORY=== 部分留空。`
-        : `You are a professional project document compression assistant. Please compress the following CURRENT_FOCUS.md file.
-
-**IMPORTANT: Extract milestones before compression!**
-
-**Step 1: Extract Milestones**
-Identify completed milestones from the original content that should be saved to memory.
-
-**Step 2: Compress File**
-Compression Rules:
-1. Keep title, metadata lines (version, status, date)
-2. Keep "📍 Status Snapshot" section (complete)
-3. Keep "➡️ Next Steps" section (complete, this is the most important)
-4. Keep "📎 References" section (complete)
-5. For "🔄 Current Tasks" section:
-   - If P0/P1 subsections are all completed, merge into a short "Completed Milestones" list (max 5 items)
-   - Keep all incomplete tasks (- [ ])
-   - Keep at most 3 recent completed tasks, remove the rest
-6. Remove duplicate info and redundant descriptions
-7. Maintain Markdown format and semantic coherence
-
-**Goal:** Compress the file to under 40 lines.
-
-**Original Content:**
-\`\`\`markdown
-${oldContent}
-\`\`\`
-
-**Output Format (must follow strictly):**
-\`\`\`
-===MEMORY===
-[Content to append to memory/MEMORY.md, format:]
-## {YYYY-MM-DD} Milestones
-- [milestone 1]
-- [milestone 2]
-...
-===COMPRESSED===
-[Compressed CURRENT_FOCUS.md content]
-\`\`\`
-
-If no milestones to record, leave ===MEMORY=== section empty.`;
+    // 5. 压缩内容
     let compressedContent;
-    let usedAI = false;
-    let memoryUpdated = false;
     try {
-        // 调用子智能体进行压缩
-        const tool = createAgentSpawnTool(api);
-        const result = await tool.execute(`focus-compress-${randomUUID()}`, {
-            agentType: 'reporter', // 使用 reporter 类型，适合总结和压缩
-            task: compressPrompt,
-        });
-        // 解析输出，提取 MEMORY 和 COMPRESSED 部分
-        const resultText = result?.content?.[0]?.text || '';
-        if (resultText.trim()) {
-            const memoryMatch = resultText.match(/===MEMORY===([\s\S]*?)===COMPRESSED===/);
-            const compressedMatch = resultText.match(/===COMPRESSED===([\s\S]*?)$/);
-            if (compressedMatch && compressedMatch[1].trim()) {
-                // 清理 Markdown 代码块围栏
-                compressedContent = stripMarkdownFence(compressedMatch[1]);
-                usedAI = true;
-                // 写入记忆文件（MEMORY.md 在根目录，无需创建目录）
-                if (memoryMatch && memoryMatch[1].trim()) {
-                    // 清理 Markdown 代码块围栏
-                    const memoryContent = stripMarkdownFence(memoryMatch[1]);
-                    // 追加到 MEMORY.md
-                    const existingMemory = fs.existsSync(memoryPath)
-                        ? fs.readFileSync(memoryPath, 'utf-8')
-                        : '';
-                    const newMemory = existingMemory
-                        ? `${existingMemory}\n\n${memoryContent}`
-                        : memoryContent;
-                    fs.writeFileSync(memoryPath, newMemory, 'utf-8');
-                    memoryUpdated = true;
-                }
-            }
-            else {
-                // 无法解析输出，回退到简单压缩
-                compressedContent = compressFocusContent(oldContent);
-            }
-        }
-        else {
-            // 子智能体返回空，回退到简单压缩
-            compressedContent = compressFocusContent(oldContent);
-        }
+        compressedContent = compressFocusContent(oldContent, workspaceDir);
+        api.logger?.info?.(`[PD:Focus] Compressed CURRENT_FOCUS from ${oldLines} lines`);
     }
     catch (error) {
-        // 子智能体失败，回退到简单压缩
-        api.logger?.error(`[PD:Focus] AI compression failed, falling back to simple compression: ${String(error)}`);
-        compressedContent = compressFocusContent(oldContent);
+        api.logger?.error?.(`[PD:Focus] Compression failed: ${String(error)}`);
+        compressedContent = oldContent;
     }
-    // 更新版本号和日期
+    // 6. 更新版本号和日期
     const versionParts = oldVersion.split('.');
     const majorVersion = parseInt(versionParts[0], 10) || 1;
     const newVersion = `${majorVersion + 1}`;
@@ -385,17 +269,10 @@ If no milestones to record, leave ===MEMORY=== section empty.`;
     const newLines = newContent.split('\n').length;
     const savedLines = oldLines - newLines;
     fs.writeFileSync(focusPath, newContent, 'utf-8');
-    const methodNote = usedAI
+    const milestoneNote = milestonesArchived
         ? isZh
-            ? '🤖 使用 AI 智能压缩'
-            : '🤖 AI-powered compression'
-        : isZh
-            ? '📋 使用规则压缩'
-            : '📋 Rule-based compression';
-    const memoryNote = memoryUpdated
-        ? isZh
-            ? '📝 已将里程碑写入 MEMORY.md'
-            : '📝 Milestones saved to MEMORY.md'
+            ? `📝 里程碑已归档到 memory/${today}.md`
+            : `📝 Milestones archived to memory/${today}.md`
         : '';
     if (isZh) {
         return `✅ **压缩完成**
@@ -409,8 +286,7 @@ If no milestones to record, leave ===MEMORY=== section empty.`;
 | 节省 | ${savedLines} 行 |
 | 备份文件 | ${backupPath ? path.basename(backupPath) : '已存在'} |
 
-${methodNote}${memoryNote ? `\n${memoryNote}` : ''}
-
+${milestoneNote ? `${milestoneNote}\n` : ''}
 💡 已压缩版本已备份到历史目录
 💡 输入 \`/pd-focus history\` 查看所有历史版本`;
     }
@@ -425,8 +301,7 @@ ${methodNote}${memoryNote ? `\n${memoryNote}` : ''}
 | Saved | ${savedLines} lines |
 | Backup File | ${backupPath ? path.basename(backupPath) : 'exists'} |
 
-${methodNote}${memoryNote ? `\n${memoryNote}` : ''}
-
+${milestoneNote ? `${milestoneNote}\n` : ''}
 💡 Compressed version backed up to history
 💡 Type \`/pd-focus history\` to view all versions`;
 }

package/dist/constants/diagnostician.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Diagnostician 协议常量
+ *
+ * 用于 evolution-worker.ts（后台心跳）和 prompt.ts（实时路径）
+ * 与 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- 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

@@ -0,0 +1,60 @@
+/**
+ * Diagnostician 协议常量
+ *
+ * 用于 evolution-worker.ts（后台心跳）和 prompt.ts（实时路径）
+ * 与 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**:
+- Read logs: .state/logs/events.jsonl, SYSTEM.log
+- Search code for error patterns from Reason field
+- Record evidence sources
+
+**Phase 2 - Causal Chain**:
+- Each Why must have evidence support
+- Maximum 5 layers
+- Stop when reaching 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
+
+**Phase 4 - Principle Extraction**:
+Extract protection principle with:
+- **trigger_pattern**: When this situation occurs
+- **action**: What to do differently
+
+**Output Format**:
+\`\`\`json
+{
+  "diagnosis_report": {
+    "task_id": "pain-xxx",
+    "summary": "One-line root cause",
+    "causal_chain": [
+      { "why": 1, "answer": "...", "evidence": "..." }
+    ],
+    "root_cause": {
+      "category": "Design|People|Assumption|Tooling",
+      "description": "..."
+    },
+    "principle": {
+      "trigger_pattern": "...",
+      "action": "..."
+    }
+  }
+}
+\`\`\`
+`;
+/**
+ * 完整诊断协议文件路径（相对于插件根目录）
+ */
+export const DIAGNOSTICIAN_SKILL_PATH = 'templates/langs/zh/skills/pd-diagnostician/SKILL.md';

package/dist/constants/tools.d.ts

@@ -2,9 +2,9 @@ export declare const READ_ONLY_TOOL_NAMES: readonly ["read", "read_file", "read_
 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 ["pd_run_worker", "sessions_spawn"];
+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", "pd_run_worker", "sessions_spawn", "evolve-task", "init-strategy"];
+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 READ_ONLY_TOOLS: Set<string>;
 export declare const LOW_RISK_WRITE_TOOLS: Set<string>;

package/dist/constants/tools.js

@@ -23,7 +23,7 @@ export const HIGH_RISK_TOOL_NAMES = [
     ...BASH_TOOL_NAMES,
 ];
 export const AGENT_TOOL_NAMES = [
-    'pd_run_worker', 'sessions_spawn',
+    'sessions_spawn',
 ];
 export const CONTENT_LIMITED_TOOL_NAMES = [
     ...LOW_RISK_WRITE_TOOL_NAMES,

package/dist/core/config.d.ts

@@ -127,6 +127,18 @@ export interface PainSettings {
         model_calibration?: Record<string, number>;
     };
     gfi_gate?: GfiGateSettings;
+    compression?: {
+        /** 触发自动压缩的行数阈值 */
+        line_threshold?: number;
+        /** 触发自动压缩的字节阈值 */
+        size_threshold_kb?: number;
+        /** 自动压缩间隔（小时） */
+        interval_hours?: number;
+        /** 保留的已完成任务数 */
+        keep_completed_tasks?: number;
+        /** Working Memory 最大条数 */
+        max_working_memory_artifacts?: number;
+    };
 }
 export declare const DEFAULT_SETTINGS: PainSettings;
 export declare class PainConfig {

package/dist/core/config.js

@@ -146,6 +146,13 @@ export const DEFAULT_SETTINGS = {
             'docker\\s+push',
             '(curl|wget).*\\|\\s*(ba)?sh',
         ],
+    },
+    compression: {
+        line_threshold: 100, // 超过 100 行触发压缩
+        size_threshold_kb: 15, // 超过 15KB 触发压缩
+        interval_hours: 24, // 每 24 小时最多压缩一次
+        keep_completed_tasks: 3, // 保留最近 3 个已完成任务
+        max_working_memory_artifacts: 10, // Working Memory 最多 10 条
     }
 };
 export class PainConfig {

package/dist/core/evolution-engine.js

@@ -174,7 +174,7 @@ export class EvolutionEngine {
             };
         }
         // 子智能体检查
-        if ((context.toolName === 'pd_run_worker' || context.toolName === 'sessions_spawn') && !perms.allowSubagentSpawn) {
+        if (context.toolName === 'sessions_spawn' && !perms.allowSubagentSpawn) {
             return {
                 allowed: false,
                 reason: `Tier ${this.scorecard.currentTier} (${tierDef.name}) 未解锁子智能体权限`,

package/dist/core/focus-history.d.ts

@@ -116,3 +116,95 @@ export declare function mergeWorkingMemory(content: string, snapshot: WorkingMem
  * 生成工作记忆注入字符串（用于 prompt 注入）
  */
 export declare function workingMemoryToInjection(snapshot: WorkingMemorySnapshot | null): string;
+/**
+ * 压缩配置接口
+ */
+interface CompressionConfig {
+    lineThreshold: number;
+    sizeThreshold: number;
+    intervalMs: number;
+    keepCompletedTasks: number;
+    maxWorkingMemoryArtifacts: number;
+}
+/**
+ * 提取已完成任务作为里程碑
+ */
+export declare function extractMilestones(content: string): {
+    completedTasks: string[];
+    fileArtifacts: string[];
+};
+/**
+ * 归档里程碑到 daily memory 文件
+ */
+export declare function archiveMilestonesToDaily(workspaceDir: string, milestones: {
+    completedTasks: string[];
+    fileArtifacts: string[];
+}, version: string): string | null;
+/**
+ * 清理过期信息和验证文件引用
+ */
+export declare function cleanupStaleInfo(content: string, workspaceDir?: string, config?: CompressionConfig): string;
+/**
+ * 自动压缩 CURRENT_FOCUS.md
+ *
+ * @param focusPath CURRENT_FOCUS.md 的完整路径
+ * @param workspaceDir 工作区目录（可选，用于验证文件引用）
+ * @param stateDir state 目录路径（可选，用于频率限制）
+ * @returns 压缩结果信息，如果不需要压缩则返回 null
+ */
+export declare function autoCompressFocus(focusPath: string, workspaceDir?: string, stateDir?: string): {
+    compressed: boolean;
+    oldLines: number;
+    newLines: number;
+    milestonesArchived: boolean;
+    backupPath: string | null;
+    reason: string;
+};
+/**
+ * 检查是否需要自动压缩
+ */
+export declare function needsAutoCompression(focusPath: string, stateDir?: string): boolean;
+/**
+ * 验证 CURRENT_FOCUS.md 格式
+ *
+ * 仅校验会导致程序崩溃的核心问题，不过度校验
+ *
+ * @param content 文件内容
+ * @returns 验证结果
+ */
+export declare function validateCurrentFocus(content: string): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * 从模板恢复 CURRENT_FOCUS.md
+ *
+ * @param focusPath CURRENT_FOCUS.md 路径
+ * @param extensionRoot 插件根目录
+ * @returns 恢复是否成功
+ */
+export declare function recoverFromTemplate(focusPath: string, extensionRoot: string): {
+    success: boolean;
+    error?: string;
+    templatePath?: string;
+};
+/**
+ * 安全读取 CURRENT_FOCUS.md（自动验证 + 恢复）
+ *
+ * 仅在文件为空或损坏时才恢复，其他情况正常使用
+ *
+ * @param focusPath CURRENT_FOCUS.md 路径
+ * @param extensionRoot 插件根目录
+ * @param logger 日志记录器
+ * @returns 文件内容和恢复状态
+ */
+export declare function safeReadCurrentFocus(focusPath: string, extensionRoot: string, logger?: {
+    warn?: (msg: string) => void;
+    info?: (msg: string) => void;
+}): {
+    content: string;
+    recovered: boolean;
+    validationErrors: string[];
+};
+export {};