principles-disciple 1.7.4 → 1.7.6

package/dist/constants/diagnostician.d.ts

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

package/dist/constants/diagnostician.js

@@ -0,0 +1,56 @@
+/**
+ * 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": "..."
+    }
+  }
+}
+\`\`\`
+`;

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/control-ui-db.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Control UI database stores ANALYTICS READ MODELS.
+ *
+ * PURPOSE: Aggregated data for dashboard visualization and historical insights.
+ * USAGE: Control UI queries and dashboard displays.
+ * NOT FOR: Control decisions, Phase 3 eligibility, or real-time operations.
+ *
+ * Runtime truth comes from: queue state, workspace trust scorecard, active sessions
+ */
 export interface ThinkingModelEventInput {
     sessionId: string;
     runId: string;
@@ -59,8 +68,26 @@ export declare class ControlUiDatabase {
     constructor(opts: ControlUiDatabaseOptions);
     dispose(): void;
     recordThinkingModelEvent(input: ThinkingModelEventInput): number;
+    /**
+     * Get recent thinking context for a session.
+     *
+     * Returns: Analytics data (read model) aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getRecentThinkingContext(sessionId: string, beforeCreatedAt: string, limit?: number): RecentThinkingContext;
+    /**
+     * Execute SQL query and return all rows.
+     *
+     * Returns: Analytics data (read model) aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     all<T>(sql: string, ...params: unknown[]): T[];
+    /**
+     * Execute SQL query and return first row.
+     *
+     * Returns: Analytics data (read model) aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     get<T>(sql: string, ...params: unknown[]): T | undefined;
     restoreRawText(inlineText?: string | null, blobRef?: string | null): string;
     private initSchema;

package/dist/core/control-ui-db.js

@@ -39,6 +39,12 @@ export class ControlUiDatabase {
             return Number(result.lastInsertRowid);
         });
     }
+    /**
+     * Get recent thinking context for a session.
+     *
+     * Returns: Analytics data (read model) aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getRecentThinkingContext(sessionId, beforeCreatedAt, limit = 5) {
         return {
             toolCalls: this.all(`
@@ -107,9 +113,21 @@ export class ControlUiDatabase {
             })),
         };
     }
+    /**
+     * Execute SQL query and return all rows.
+     *
+     * Returns: Analytics data (read model) aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     all(sql, ...params) {
         return this.db.prepare(sql).all(...params);
     }
+    /**
+     * Execute SQL query and return first row.
+     *
+     * Returns: Analytics data (read model) aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     get(sql, ...params) {
         return this.db.prepare(sql).get(...params);
     }

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 {};