principles-disciple 1.7.4 → 1.7.6

package/dist/commands/evolution-status.js

@@ -1,24 +1,6 @@
 import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
 import { normalizeLanguage } from '../i18n/commands.js';
 import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
-function formatAge(ageSeconds, lang) {
-    if (ageSeconds === null) {
-        return '--';
-    }
-    if (ageSeconds < 60) {
-        return lang === 'zh' ? `${ageSeconds} \u79d2` : `${ageSeconds}s`;
-    }
-    const minutes = Math.floor(ageSeconds / 60);
-    if (minutes < 60) {
-        return lang === 'zh' ? `${minutes} \u5206\u949f` : `${minutes}m`;
-    }
-    const hours = Math.floor(minutes / 60);
-    if (hours < 24) {
-        return lang === 'zh' ? `${hours} \u5c0f\u65f6` : `${hours}h`;
-    }
-    const days = Math.floor(hours / 24);
-    return lang === 'zh' ? `${days} \u5929` : `${days}d`;
-}
 function formatNumber(value) {
     if (value === null || Number.isNaN(value)) {
         return '--';
@@ -45,6 +27,7 @@ function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
         '',
         'Control Plane',
         `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100 (stage ${formatStage(summary.legacyTrust.stage)}, legacy/frozen, ${summary.legacyTrust.rewardPolicy})`,
+        `- Runtime Trust Truth: score ${formatNumber(summary.runtime.currentTrustScore)}, classification ${summary.runtime.workspaceState.trustClassification}, frozen ${summary.runtime.workspaceState.frozen === null ? '--' : String(summary.runtime.workspaceState.frozen)}`,
         `- Session GFI: current ${formatNumber(summary.gfi.current)}, peak ${formatNumber(summary.gfi.peak)} (${summary.gfi.dataQuality})`,
         `- GFI Sources: ${formatSources(summary.gfi.sources)}`,
         `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? ` (${summary.pain.activeFlagSource})` : ''}`,
@@ -53,9 +36,11 @@ function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
         '',
         'Evolution',
         `- Queue: pending ${summary.evolution.queue.pending}, in_progress ${summary.evolution.queue.inProgress}, completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
-        `- Directive (derived from queue, compatibility only): ${summary.evolution.directive.exists ? 'present' : 'missing'}, active ${summary.evolution.directive.active === null ? '--' : summary.evolution.directive.active ? 'yes' : 'no'}, age ${formatAge(summary.evolution.directive.ageSeconds, 'en')}`,
-        `- Directive Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
-        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}, queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}, trustInputReady ${summary.phase3.trustInputReady ? 'yes' : 'no'}, eligible ${summary.phase3.evolutionEligible}, rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}${summary.phase3.trustRejectedReasons.length > 0 ? `; trust ${summary.phase3.trustRejectedReasons.slice(0, 2).join(', ')}` : ''}`,
+        `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'} (compatibility-only display artifact)`,
+        `- Note: Legacy directive file is NOT a truth source for Phase 3 eligibility. Queue is the only authoritative execution truth source.`,
+        `- Active Evolution Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
+        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}, queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}, trustInputReady ${summary.phase3.trustInputReady ? 'yes' : 'no'}, eligible ${summary.phase3.evolutionEligible}, reference_only ${summary.phase3.evolutionReferenceOnly}, rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? ` (reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')})` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}${summary.phase3.trustRejectedReasons.length > 0 ? `; trust ${summary.phase3.trustRejectedReasons.slice(0, 2).join(', ')}` : ''}`,
+        `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
         '',
         'Principles',
         `- candidate principles: ${stats.candidateCount}`,
@@ -79,34 +64,37 @@ function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
 }
 function buildChineseOutput(workspaceDir, sessionId, warnings, stats, summary) {
     const lines = [
-        '\u8fdb\u5316\u72b6\u6001',
+        '进化状态',
         '================',
         '',
-        '\u63a7\u5236\u9762',
-        `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100\uff08\u9636\u6bb5 ${formatStage(summary.legacyTrust.stage)}\uff0clegacy/frozen\uff0c${summary.legacyTrust.rewardPolicy}\uff09`,
-        `- \u4f1a\u8bdd GFI: \u5f53\u524d ${formatNumber(summary.gfi.current)}\uff0c\u5cf0\u503c ${formatNumber(summary.gfi.peak)}\uff08${summary.gfi.dataQuality}\uff09`,
-        `- GFI \u6765\u6e90: ${formatSources(summary.gfi.sources)}`,
-        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? `\uff08${summary.pain.activeFlagSource}\uff09` : ''}`,
-        `- \u6700\u8fd1 Pain \u4fe1\u53f7: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
-        `- Gate \u4e8b\u4ef6: block ${formatNumber(summary.gate.recentBlocks)}\uff0cbypass ${formatNumber(summary.gate.recentBypasses)}\uff08${summary.gate.dataQuality}\uff09`,
+        '控制面',
+        `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100（阶段 ${formatStage(summary.legacyTrust.stage)}，legacy/frozen，${summary.legacyTrust.rewardPolicy}）`,
+        `- Runtime Trust Truth: score ${formatNumber(summary.runtime.currentTrustScore)}，classification ${summary.runtime.workspaceState.trustClassification}，frozen ${summary.runtime.workspaceState.frozen === null ? '--' : String(summary.runtime.workspaceState.frozen)}`,
+        `- 会话 GFI: 当前 ${formatNumber(summary.gfi.current)}，峰值 ${formatNumber(summary.gfi.peak)}（${summary.gfi.dataQuality}）`,
+        `- GFI 来源: ${formatSources(summary.gfi.sources)}`,
+        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? `（${summary.pain.activeFlagSource}）` : ''}`,
+        `- 最近 Pain 信号: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
+        `- Gate 事件: block ${formatNumber(summary.gate.recentBlocks)}，bypass ${formatNumber(summary.gate.recentBypasses)}（${summary.gate.dataQuality}）`,
         '',
-        '\u8fdb\u5316',
-        `- \u961f\u5217: pending ${summary.evolution.queue.pending}\uff0cin_progress ${summary.evolution.queue.inProgress}\uff0ccompleted ${summary.evolution.queue.completed}\uff08${summary.evolution.dataQuality}\uff09`,
-        `- Directive\uff08\u7531\u961f\u5217\u6d3e\u751f\uff0c\u517c\u5bb9\u4ec5\uff09: ${summary.evolution.directive.exists ? 'present' : 'missing'}\uff0cactive ${summary.evolution.directive.active === null ? '--' : summary.evolution.directive.active ? 'yes' : 'no'}\uff0cage ${formatAge(summary.evolution.directive.ageSeconds, 'zh')}`,
-        `- Directive \u4efb\u52a1: ${summary.evolution.directive.taskPreview ?? '--'}`,
-        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}\uff0cqueueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}\uff0ctrustInputReady ${summary.phase3.trustInputReady ? 'yes' : 'no'}\uff0celigible ${summary.phase3.evolutionEligible}\uff0crejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionRejectedReasons.length > 0 ? `\uff08${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')}\uff09` : ''}${summary.phase3.trustRejectedReasons.length > 0 ? `\uff1btrust ${summary.phase3.trustRejectedReasons.slice(0, 2).join(', ')}` : ''}`,
+        '进化',
+        `- 队列: pending ${summary.evolution.queue.pending}，in_progress ${summary.evolution.queue.inProgress}，completed ${summary.evolution.queue.completed}（${summary.evolution.dataQuality}）`,
+        `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'} （兼容仅显示产物）`,
+        `- 注：Legacy directive file 不是 Phase 3 合格性的真实源。队列是唯一权威的执行真实源。`,
+        `- Active Evolution Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
+        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}，queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}，trustInputReady ${summary.phase3.trustInputReady ? 'yes' : 'no'}，eligible ${summary.phase3.evolutionEligible}，reference_only ${summary.phase3.evolutionReferenceOnly}，rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? `（reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')}）` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? `（${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')}）` : ''}${summary.phase3.trustRejectedReasons.length > 0 ? `；trust ${summary.phase3.trustRejectedReasons.slice(0, 2).join(', ')}` : ''}`,
+        `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
         '',
-        '\u539f\u5219\u7edf\u8ba1',
-        `- \u5019\u9009\u539f\u5219: ${stats.candidateCount}`,
-        `- \u89c2\u5bdf\u671f\u539f\u5219: ${stats.probationCount}`,
-        `- \u751f\u6548\u539f\u5219: ${stats.activeCount}`,
-        `- \u5df2\u5e9f\u5f03\u539f\u5219: ${stats.deprecatedCount}`,
-        `- \u6700\u8fd1\u664b\u5347: ${stats.lastPromotedAt ?? '\u65e0'}`,
+        '原则统计',
+        `- 候选原则: ${stats.candidateCount}`,
+        `- 观察期原则: ${stats.probationCount}`,
+        `- 生效原则: ${stats.activeCount}`,
+        `- 已废弃原则: ${stats.deprecatedCount}`,
+        `- 最近晋升: ${stats.lastPromotedAt ?? '无'}`,
         '',
-        '\u5143\u6570\u636e',
-        `- \u5de5\u4f5c\u533a: ${workspaceDir}`,
-        `- Session: ${sessionId ?? '--'}\uff08${summary.metadata.selectedSessionReason}\uff09`,
-        `- \u751f\u6210\u65f6\u95f4: ${summary.metadata.generatedAt}`,
+        '元数据',
+        `- 工作区: ${workspaceDir}`,
+        `- Session: ${sessionId ?? '--'}（${summary.metadata.selectedSessionReason}）`,
+        `- 生成时间: ${summary.metadata.generatedAt}`,
     ];
     if (warnings.length > 0) {
         lines.push('', '警告');

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/config/defaults/runtime.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * All runtime-related constants that were previously scattered across modules.
+ * Centralizing these makes it easier to tune behavior and understand limits.
+ */
+/**
+ * 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;
+/**
+ * Thinking checkpoint defaults (P-10)
+ */
+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 intervals
+ */
+export declare const EVOLUTION_WORKER_POLL_INTERVAL_MS: number;
+export declare const EVOLUTION_QUEUE_BATCH_SIZE = 10;
+/**
+ * Session tracker settings
+ */
+export declare const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
+export declare const SESSION_MAX_IDLE_MS: number;
+/**
+ * Event log buffer settings
+ */
+export declare const EVENT_LOG_BUFFER_SIZE = 20;
+export declare const EVENT_LOG_FLUSH_INTERVAL_MS: number;

package/dist/config/defaults/runtime.js

@@ -0,0 +1,44 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * All runtime-related constants that were previously scattered across modules.
+ * Centralizing these makes it easier to tune behavior and understand limits.
+ */
+/**
+ * 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 * 60 * 1000; // 5 minutes
+export const THINKING_CHECKPOINT_DEFAULT_HIGH_RISK_TOOLS = [
+    'run_shell_command',
+    'delete_file',
+    'move_file',
+];
+/**
+ * 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 polling intervals
+ */
+export const EVOLUTION_WORKER_POLL_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+export const EVOLUTION_QUEUE_BATCH_SIZE = 10;
+/**
+ * Session tracker settings
+ */
+export const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
+export const SESSION_MAX_IDLE_MS = 30 * 60 * 1000; // 30 minutes
+/**
+ * Event log buffer settings
+ */
+export const EVENT_LOG_BUFFER_SIZE = 20;
+export const EVENT_LOG_FLUSH_INTERVAL_MS = 30 * 1000; // 30 seconds

package/dist/config/errors.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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
+ */
+/**
+ * Base class for all Principles Disciple errors
+ */
+export declare class PdError extends Error {
+    readonly code: string;
+    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/dist/config/errors.js

@@ -0,0 +1,94 @@
+/**
+ * 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
+ */
+/**
+ * Base class for all Principles Disciple errors
+ */
+export class PdError extends Error {
+    code;
+    constructor(message, code, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'PdError';
+    }
+}
+/**
+ * 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/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/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';