principles-disciple 1.5.4 → 1.7.0

package/dist/index.js

@@ -5,18 +5,29 @@ import { handleAfterToolCall } from './hooks/pain.js';
 import { handleBeforeReset, handleBeforeCompaction, handleAfterCompaction } from './hooks/lifecycle.js';
 import { handleLlmOutput } from './hooks/llm.js';
 import { handleSubagentEnded } from './hooks/subagent.js';
+import { handleBeforeMessageWrite } from './hooks/message-sanitize.js';
 import { handleInitStrategy, handleManageOkr } from './commands/strategy.js';
 import { handleBootstrapTools, handleResearchTools } from './commands/capabilities.js';
 import { handleThinkingOs } from './commands/thinking-os.js';
 import { handleEvolveTask } from './commands/evolver.js';
 import { handleTrustCommand } from './commands/trust.js';
 import { handlePainCommand } from './commands/pain.js';
+import { handleContextCommand } from './commands/context.js';
+import { handleFocusCommand } from './commands/focus.js';
+import { handleRollbackCommand } from './commands/rollback.js';
+import { handleEvolutionStatusCommand } from './commands/evolution-status.js';
+import { handlePrincipleRollbackCommand } from './commands/principle-rollback.js';
+import { handleExportCommand } from './commands/export.js';
+import { handleSamplesCommand } from './commands/samples.js';
 import { EvolutionWorkerService } from './service/evolution-worker.js';
+import { TrajectoryService } from './service/trajectory-service.js';
 import { ensureWorkspaceTemplates } from './core/init.js';
 import { migrateDirectoryStructure } from './core/migration.js';
 import { SystemLogger } from './core/system-logger.js';
-import { deepReflectTool } from './tools/deep-reflect.js';
-import { agentSpawnTool } from './tools/agent-spawn.js';
+import { createDeepReflectTool } from './tools/deep-reflect.js';
+import { createAgentSpawnTool } from './tools/agent-spawn.js';
+import { PathResolver } from './core/path-resolver.js';
+import { createPrinciplesConsoleRoute } from './http/principles-console-route.js';
 // Track initialization to avoid repeated calls
 let workspaceInitialized = false;
 const plugin = {
@@ -24,6 +35,8 @@ const plugin = {
     description: "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
     register(api) {
         api.logger.info("Principles Disciple Plugin registered.");
+        PathResolver.setExtensionRoot(api.rootDir);
+        api.registerHttpRoute(createPrinciplesConsoleRoute(api));
         const language = api.pluginConfig?.language || 'en';
         // ── Hook: Prompt Building ──
         api.on('before_prompt_build', async (event, ctx) => {
@@ -75,6 +88,15 @@ const plugin = {
                 api.logger.error(`[PD] Error in llm_output: ${String(err)}`);
             }
         });
+        // ── Hook: Message Sanitization ──
+        api.on('before_message_write', (event) => {
+            try {
+                return handleBeforeMessageWrite(event);
+            }
+            catch (err) {
+                api.logger.error(`[PD] Error in before_message_write: ${String(err)}`);
+            }
+        });
         // ── Hook: Subagent Loop Closure ──
         api.on('subagent_spawning', (_event, _ctx) => {
             // No-op for now, just to satisfy the interface expected by tests.
@@ -83,7 +105,7 @@ const plugin = {
         api.on('subagent_ended', (event, ctx) => {
             try {
                 const workspaceDir = api.resolvePath('.');
-                handleSubagentEnded(event, { ...ctx, workspaceDir });
+                handleSubagentEnded(event, { ...ctx, workspaceDir, api });
             }
             catch (err) {
                 api.logger.error(`[PD] Error in subagent_ended: ${String(err)}`);
@@ -106,6 +128,7 @@ const plugin = {
         try {
             EvolutionWorkerService.api = api;
             api.registerService(EvolutionWorkerService);
+            api.registerService(TrajectoryService);
         }
         catch (err) {
             api.logger.error(`[PD] Failed to register EvolutionWorkerService: ${String(err)}`);
@@ -165,9 +188,124 @@ const plugin = {
             name: "pd-help",
             description: getCommandDescription('pd-help', language),
             handler: (_ctx) => {
-                return { text: language === 'zh'
-                        ? "我是你的麻辣导师。你可以输入 '执行 pd-mentor 技能' 来获取手把手的流程引导，或者直接问我关于 DNS、Trust Engine 或进化循环的深度问题。记住：痛是进化的燃料，而我是点火的人。"
-                        : "I'm your Spicy Mentor. You can execute the 'pd-mentor' skill for step-by-step guidance, or ask me directly about DNS, Trust Engine, or the evolution loop. Remember: Pain is the fuel of evolution, and I'm the one who lights the fire." };
+                if (language === 'zh') {
+                    return { text: `
+📖 **Principles Disciple 命令大全**
+
+## 🚀 快速开始
+| 命令 | 用途 | 使用时机 |
+|------|------|----------|
+| \`/pd-init\` | 初始化工作区 | 新项目开始时 |
+| \`/pd-bootstrap\` | 环境工具扫描 | 缺少开发工具时 |
+
+## 📊 状态查询
+| 命令 | 用途 | 使用时机 |
+|------|------|----------|
+| \`/pd-status\` | 查看进化状态 | 想了解当前 GFI 和 Pain 情况 |
+| \`/pd-trust\` | 查看信任分数 | 想知道自己的权限等级 |
+| \`/pd-focus\` | 焦点文件管理 | 查看/压缩/回滚历史版本 |
+| \`/pd-export\` | 导出分析/样本 | 导出 analytics 或纠错样本 |
+| \`/pd-samples\` | 审核纠错样本 | 查看待审核样本并批准/拒绝 |
+
+## ⚙️ 配置管理
+| 命令 | 用途 | 使用时机 |
+|------|------|----------|
+| \`/pd-context\` | 控制上下文注入 | 想减少/增加注入内容 |
+| \`/pd-okr\` | OKR 目标管理 | 设置战略目标 |
+
+## 🧠 进化相关
+| 命令 | 用途 | 使用时机 |
+|------|------|----------|
+| \`/pd-evolve\` | 执行进化循环 | 有 Pain 需要处理时 |
+| \`/pd-thinking\` | 思维模型管理 | 更新 Thinking OS |
+| \`/pd-daily\` | 进化日报 | 每日回顾时 |
+| \`/pd-grooming\` | 工作区大扫除 | 定期清理 |
+
+## 💡 常用命令示例
+
+**减少 token 消耗：**
+\`\`\`
+/pd-context minimal
+\`\`\`
+
+**恢复完整上下文：**
+\`\`\`
+/pd-context full
+\`\`\`
+
+**查看当前配置：**
+\`\`\`
+/pd-context status
+\`\`\`
+
+**查看信任分数：**
+\`\`\`
+/pd-trust
+\`\`\`
+
+---
+🔍 输入任意命令后加 \`help\` 可查看详细帮助，如 \`/pd-context help\`
+`.trim() };
+                }
+                else {
+                    return { text: `
+📖 **Principles Disciple Command Reference**
+
+## 🚀 Quick Start
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| \`/pd-init\` | Initialize workspace | Starting a new project |
+| \`/pd-bootstrap\` | Scan environment tools | Missing dev tools |
+
+## 📊 Status Query
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| \`/pd-status\` | View evolution status | Check GFI and Pain status |
+| \`/pd-trust\` | View trust score | Check your permission level |
+| \`/pd-focus\` | Focus file management | View/compress/rollback history |
+| \`/pd-export\` | Export analytics/samples | Export analytics or correction samples |
+| \`/pd-samples\` | Review correction samples | Review pending correction samples |
+
+## ⚙️ Configuration
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| \`/pd-context\` | Control context injection | Reduce/increase injected content |
+| \`/pd-okr\` | OKR goal management | Set strategic goals |
+
+## 🧠 Evolution
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| \`/pd-evolve\` | Run evolution loop | Process Pain signals |
+| \`/pd-thinking\` | Mental model management | Update Thinking OS |
+| \`/pd-daily\` | Evolution report | Daily review |
+| \`/pd-grooming\` | Workspace cleanup | Periodic cleanup |
+
+## 💡 Common Examples
+
+**Reduce token usage:**
+\`\`\`
+/pd-context minimal
+\`\`\`
+
+**Restore full context:**
+\`\`\`
+/pd-context full
+\`\`\`
+
+**View current config:**
+\`\`\`
+/pd-context status
+\`\`\`
+
+**Check trust score:**
+\`\`\`
+/pd-trust
+\`\`\`
+
+---
+🔍 Add \`help\` after any command for details, e.g., \`/pd-context help\`
+`.trim() };
+                }
             }
         });
         api.registerCommand({
@@ -196,9 +334,127 @@ const plugin = {
                 }
             }
         });
+        api.registerCommand({
+            name: "pd-context",
+            description: getCommandDescription('pd-context', language),
+            acceptsArgs: true,
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handleContextCommand(ctx);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-context failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "命令执行失败，请检查日志。" : "Command failed. Check logs." };
+                }
+            }
+        });
+        api.registerCommand({
+            name: "pd-focus",
+            description: getCommandDescription('pd-focus', language),
+            acceptsArgs: true,
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handleFocusCommand(ctx, api);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-focus failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "命令执行失败，请检查日志。" : "Command failed. Check logs." };
+                }
+            }
+        });
+        api.registerCommand({
+            name: "pd-evolution-status",
+            description: getCommandDescription('pd-evolution-status', language),
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handleEvolutionStatusCommand(ctx);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-evolution-status failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "命令执行失败，请检查日志。" : "Command failed. Check logs." };
+                }
+            }
+        });
+        api.registerCommand({
+            name: "pd-principle-rollback",
+            description: getCommandDescription('pd-principle-rollback', language),
+            acceptsArgs: true,
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handlePrincipleRollbackCommand(ctx);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-principle-rollback failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "命令执行失败，请检查日志。" : "Command failed. Check logs." };
+                }
+            }
+        });
+        api.registerCommand({
+            name: "pd-rollback",
+            description: getCommandDescription('pd-rollback', language),
+            acceptsArgs: true,
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handleRollbackCommand(ctx);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-rollback failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "命令执行失败，请检查日志。" : "Command failed. Check logs." };
+                }
+            }
+        });
         // ── Tools ──
-        api.registerTool(deepReflectTool);
-        api.registerTool(agentSpawnTool);
+        api.registerCommand({
+            name: "pd-export",
+            description: getCommandDescription('pd-export', language),
+            acceptsArgs: true,
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handleExportCommand(ctx);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-export failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "导出失败，请检查日志。" : "Export failed. Check logs." };
+                }
+            }
+        });
+        api.registerCommand({
+            name: "pd-samples",
+            description: getCommandDescription('pd-samples', language),
+            acceptsArgs: true,
+            handler: (ctx) => {
+                try {
+                    const workspaceDir = api.resolvePath('.');
+                    if (ctx.config)
+                        ctx.config.workspaceDir = workspaceDir;
+                    return handleSamplesCommand(ctx);
+                }
+                catch (err) {
+                    api.logger.error(`[PD] Command /pd-samples failed: ${String(err)}`);
+                    return { text: language === 'zh' ? "样本命令执行失败，请检查日志。" : "Samples command failed. Check logs." };
+                }
+            }
+        });
+        api.registerTool(createDeepReflectTool(api));
+        api.registerTool(createAgentSpawnTool(api));
     }
 };
 export default plugin;

package/dist/service/control-ui-query-service.d.ts

@@ -0,0 +1,217 @@
+export interface OverviewResponse {
+    workspaceDir: string;
+    generatedAt: string;
+    dataFreshness: string | null;
+    summary: {
+        repeatErrorRate: number;
+        userCorrectionRate: number;
+        pendingSamples: number;
+        approvedSamples: number;
+        thinkingCoverageRate: number;
+        painEvents: number;
+        principleEventCount: number;
+    };
+    dailyTrend: Array<{
+        day: string;
+        toolCalls: number;
+        failures: number;
+        userCorrections: number;
+        thinkingTurns: number;
+    }>;
+    topRegressions: Array<{
+        toolName: string;
+        errorType: string;
+        occurrences: number;
+    }>;
+    sampleQueue: {
+        counters: Record<string, number>;
+        preview: Array<{
+            sampleId: string;
+            sessionId: string;
+            qualityScore: number;
+            reviewStatus: string;
+            createdAt: string;
+        }>;
+    };
+    thinkingSummary: {
+        activeModels: number;
+        dormantModels: number;
+        effectiveModels: number;
+        coverageRate: number;
+    };
+}
+export interface SampleListFilters {
+    status?: string;
+    qualityMin?: number;
+    dateFrom?: string;
+    dateTo?: string;
+    failureMode?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface SamplesResponse {
+    counters: Record<string, number>;
+    items: Array<{
+        sampleId: string;
+        sessionId: string;
+        reviewStatus: string;
+        qualityScore: number;
+        failureMode: string;
+        relatedThinkingCount: number;
+        createdAt: string;
+        updatedAt: string;
+        diffExcerpt: string;
+    }>;
+    pagination: {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    };
+}
+export interface SampleDetailResponse {
+    sampleId: string;
+    sessionId: string;
+    reviewStatus: string;
+    qualityScore: number;
+    createdAt: string;
+    updatedAt: string;
+    badAttempt: {
+        assistantTurnId: number;
+        rawText: string;
+        sanitizedText: string;
+        createdAt: string;
+    };
+    userCorrection: {
+        userTurnId: number;
+        rawText: string;
+        correctionCue: string | null;
+        createdAt: string;
+    };
+    recoveryToolSpan: Array<{
+        id: number;
+        toolName: string;
+    }>;
+    relatedPrinciples: Array<{
+        principleId: string | null;
+        eventType: string;
+        createdAt: string;
+    }>;
+    relatedThinkingHits: Array<{
+        id: number;
+        modelId: string;
+        modelName: string;
+        matchedPattern: string;
+        scenarios: string[];
+        createdAt: string;
+        triggerExcerpt: string;
+    }>;
+    reviewHistory: Array<{
+        reviewStatus: string;
+        note: string | null;
+        createdAt: string;
+    }>;
+}
+export interface ThinkingModelSummary {
+    modelId: string;
+    name: string;
+    description: string;
+    hits: number;
+    coverageRate: number;
+    successRate: number;
+    failureRate: number;
+    painRate: number;
+    correctionRate: number;
+    correctionSampleRate: number;
+    commonScenarios: string[];
+    recommendation: 'reinforce' | 'rework' | 'archive';
+}
+export interface ThinkingOverviewResponse {
+    summary: {
+        totalModels: number;
+        activeModels: number;
+        dormantModels: number;
+        effectiveModels: number;
+        coverageRate: number;
+    };
+    topModels: ThinkingModelSummary[];
+    dormantModels: Array<{
+        modelId: string;
+        name: string;
+        description: string;
+    }>;
+    effectiveModels: ThinkingModelSummary[];
+    scenarioMatrix: Array<{
+        modelId: string;
+        modelName: string;
+        scenario: string;
+        hits: number;
+    }>;
+    coverageTrend: Array<{
+        day: string;
+        assistantTurns: number;
+        thinkingTurns: number;
+        coverageRate: number;
+    }>;
+}
+export interface ThinkingModelDetailResponse {
+    modelMeta: {
+        modelId: string;
+        name: string;
+        description: string;
+        hits: number;
+        coverageRate: number;
+        recommendation: 'reinforce' | 'rework' | 'archive';
+    };
+    usageTrend: Array<{
+        day: string;
+        hits: number;
+    }>;
+    scenarioDistribution: Array<{
+        scenario: string;
+        hits: number;
+    }>;
+    outcomeStats: {
+        events: number;
+        successRate: number;
+        failureRate: number;
+        painRate: number;
+        correctionRate: number;
+        correctionSampleRate: number;
+    };
+    recentEvents: Array<{
+        id: number;
+        createdAt: string;
+        matchedPattern: string;
+        scenarios: string[];
+        triggerExcerpt: string;
+        toolContext: Array<{
+            toolName: string;
+            outcome: string;
+            errorType?: string | null;
+        }>;
+        painContext: Array<{
+            source: string;
+            score: number;
+        }>;
+        principleContext: Array<{
+            principleId: string | null;
+            eventType: string;
+        }>;
+    }>;
+}
+export declare class ControlUiQueryService {
+    private readonly workspaceDir;
+    private readonly trajectory;
+    private readonly uiDb;
+    constructor(workspaceDir: string);
+    dispose(): void;
+    getOverview(): OverviewResponse;
+    listSamples(filters?: SampleListFilters): SamplesResponse;
+    getSampleDetail(sampleId: string): SampleDetailResponse | null;
+    reviewSample(sampleId: string, decision: 'approved' | 'rejected', note?: string): import("../core/trajectory.js").CorrectionSampleRecord;
+    exportCorrections(mode: 'raw' | 'redacted'): import("../core/trajectory.js").TrajectoryExportResult;
+    getThinkingOverview(): ThinkingOverviewResponse;
+    getThinkingModelDetail(modelId: string): ThinkingModelDetailResponse | null;
+    private loadThinkingModelSummaries;
+}