principles-disciple 1.126.0 → 1.128.0

package/dist/commands/evolution-status.js

@@ -0,0 +1,187 @@
+import * as path from 'path';
+import { WorkflowFunnelLoader } from '../core/workflow-funnel-loader.js';
+import { resolvePdPath } from '../core/paths.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { normalizeLanguage } from '../i18n/commands.js';
+import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+function formatNumber(value) {
+    if (value === null || Number.isNaN(value)) {
+        return '--';
+    }
+    return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+function formatSources(sources) {
+    if (sources.length === 0) {
+        return '--';
+    }
+    return sources
+        .map((source) => source.score === undefined
+        ? source.source
+        : `${source.source}(${formatNumber(source.score)})`)
+        .join(', ');
+}
+function formatRouteRecommendations(recommendations, emptyLabel) {
+    if (recommendations.length === 0) {
+        return emptyLabel;
+    }
+    return recommendations
+        .slice(0, 3)
+        .map((recommendation) => `${recommendation.principleId}:${recommendation.route}@${formatNumber(recommendation.confidence)}`)
+        .join(', ');
+}
+function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary, recommendations) {
+    const lines = [
+        'Evolution Status',
+        '================',
+        '',
+        'Control Plane',
+        `- 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})` : ''}`,
+        `- Last Pain Signal: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
+        `- Gate Events: blocks ${formatNumber(summary.gate.recentBlocks)}, bypasses ${formatNumber(summary.gate.recentBypasses)} (${summary.gate.dataQuality})`,
+        '',
+        'Evolution',
+        `- Queue: 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'} (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'}, 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(', ')})` : ''}`,
+        `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
+        '',
+        // D: Heartbeat Diagnostician chain
+        'Heartbeat Diagnostician (Pain → Principle)',
+        `- Pending tasks: ${summary.runtimeDiagnosis.pendingTasks}`,
+        `- Tasks written today: ${summary.runtimeDiagnosis.tasksWrittenToday}`,
+        `- Reports written today: ${summary.runtimeDiagnosis.reportsWrittenToday}`,
+        `- Candidates created today: ${summary.runtimeDiagnosis.candidatesCreatedToday}`,
+        `- Heartbeats injected today: ${summary.runtimeDiagnosis.heartbeatsInjectedToday}`,
+        '',
+        'Principles',
+        `- candidate principles: ${stats.candidateCount}`,
+        `- probation principles: ${stats.probationCount}`,
+        `- active principles: ${stats.activeCount}`,
+        `- deprecated principles: ${stats.deprecatedCount}`,
+        `- last promoted: ${stats.lastPromotedAt ?? 'none'}`,
+        `- internalization routes: ${formatRouteRecommendations(recommendations, '--')}`,
+        '',
+        'Metadata',
+        `- workspace: ${workspaceDir}`,
+        `- session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
+        `- generatedAt: ${summary.metadata.generatedAt}`,
+    ];
+    // E: YAML-driven Workflow Funnels (Phase 6)
+    if (summary.workflowFunnels && summary.workflowFunnels.length > 0) {
+        lines.push('');
+        for (const funnel of summary.workflowFunnels) {
+            lines.push(`Workflow Funnel: ${funnel.funnelLabel}`);
+            for (const stage of funnel.stages) {
+                lines.push(`  - ${stage.label}: ${stage.count}`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        lines.push('', 'Warnings');
+        for (const warning of warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+function buildChineseOutput(workspaceDir, sessionId, warnings, stats, summary, recommendations) {
+    const lines = [
+        '进化状态',
+        '================',
+        '',
+        '控制面',
+        `- 会话 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})`,
+        '',
+        '进化',
+        `- 队列: 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 合格性的真实来源，队列才是唯一权威的执行真相。',
+        `- 当前进化任务: ${summary.evolution.directive.taskPreview ?? '--'}`,
+        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}，queueTruthReady ${summary.phase3.queueTruthReady ? '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(', ')})` : ''}`,
+        `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
+        '',
+        // D: Heartbeat Diagnostician chain
+        '心跳诊断链路（Pain → 原则）',
+        `- 等待处理: ${summary.runtimeDiagnosis.pendingTasks}`,
+        `- 今日写入任务: ${summary.runtimeDiagnosis.tasksWrittenToday}`,
+        `- 今日写入报告: ${summary.runtimeDiagnosis.reportsWrittenToday}`,
+        `- 今日创建候选: ${summary.runtimeDiagnosis.candidatesCreatedToday}`,
+        `- 今日心跳注入: ${summary.runtimeDiagnosis.heartbeatsInjectedToday}`,
+        '',
+        '原则统计',
+        `- 候选原则: ${stats.candidateCount}`,
+        `- 观察期原则: ${stats.probationCount}`,
+        `- 生效原则: ${stats.activeCount}`,
+        `- 已废弃原则: ${stats.deprecatedCount}`,
+        `- 最近晋升: ${stats.lastPromotedAt ?? '无'}`,
+        `- 内化路由: ${formatRouteRecommendations(recommendations, '--')}`,
+        '',
+        '元数据',
+        `- 工作区: ${workspaceDir}`,
+        `- Session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
+        `- 生成时间: ${summary.metadata.generatedAt}`,
+    ];
+    // E: YAML驱动的Workflow Funnels (Phase 6)
+    if (summary.workflowFunnels && summary.workflowFunnels.length > 0) {
+        lines.push('');
+        for (const funnel of summary.workflowFunnels) {
+            lines.push(`Workflow 漏斗: ${funnel.funnelLabel}`);
+            for (const stage of funnel.stages) {
+                lines.push(`  - ${stage.label}: ${stage.count}`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        lines.push('', '警告');
+        for (const warning of warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function handleEvolutionStatusCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'evolution-status');
+    const sessionId = ctx.sessionId ?? null;
+    // #207/#210: Use WorkspaceContext to get evolutionReducer with stateDir
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir });
+    const reducer = wctx.evolutionReducer;
+    const stats = reducer.getStats();
+    // D-12 / YAML-FUNNEL-02: WorkflowFunnelLoader owns funnel lifecycle per workspace
+    const stateDir = path.dirname(resolvePdPath(workspaceDir, 'WORKFLOWS_YAML'));
+    const loader = new WorkflowFunnelLoader(stateDir);
+    loader.watch();
+    try {
+        const summary = RuntimeSummaryService.getSummary(workspaceDir, {
+            sessionId,
+            loaderWarnings: loader.getWarnings(),
+            funnels: loader.getAllFunnels(),
+        });
+        const recommendations = WorkspaceContext.fromHookContext({ workspaceDir })
+            .principleLifecycle
+            .recomputeAll()
+            .map((assessment) => assessment.routeRecommendation);
+        const rawLang = ctx.config?.language || 'en';
+        const lang = normalizeLanguage(rawLang);
+        const warnings = summary.metadata.warnings.slice(0, 12);
+        if (lang === 'zh') {
+            return {
+                text: buildChineseOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary, recommendations),
+            };
+        }
+        return {
+            text: buildEnglishOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary, recommendations),
+        };
+    }
+    finally {
+        loader.dispose(); // YAML-FUNNEL-02: guarantee cleanup on all exit paths
+    }
+}

package/dist/commands/export.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleExportCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/export.js

@@ -0,0 +1,53 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { normalizeCommandArgs } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+function isZh(ctx) {
+    return String(ctx.config?.language || 'en').startsWith('zh');
+}
+export function handleExportCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'export');
+    const zh = isZh(ctx);
+    const args = normalizeCommandArgs(ctx.args).trim();
+    const parts = args.split(/\s+/).filter(Boolean);
+    const [subcommand = 'corrections'] = parts;
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+    try {
+        if (subcommand !== 'analytics' && subcommand !== 'corrections') {
+            return {
+                text: zh
+                    ? '无效的导出类型。请使用 `analytics` 或 `corrections [--redacted]`。'
+                    : 'Invalid export target. Use `analytics` or `corrections [--redacted]`',
+            };
+        }
+        if (subcommand === 'analytics') {
+            const result = wctx.trajectory.exportAnalytics();
+            return {
+                text: zh
+                    ? `已导出 analytics 快照到 ${result.filePath}，共 ${result.count} 条聚合记录。`
+                    : `Exported analytics snapshot to ${result.filePath} (${result.count} aggregated rows).`,
+            };
+        }
+        const redacted = args.includes('--redacted');
+        const result = wctx.trajectory.exportCorrections({
+            mode: redacted ? 'redacted' : 'raw',
+            approvedOnly: true,
+        });
+        return {
+            text: zh
+                ? `已导出纠错样本到 ${result.filePath}，模式 ${result.mode}，共 ${result.count} 条。`
+                : `Exported correction samples to ${result.filePath} (mode=${result.mode}, count=${result.count}).`,
+        };
+    }
+    catch (err) {
+        console.error('[pd-export] Export failed:', {
+            subcommand,
+            error: err instanceof Error ? err.message : String(err),
+            stack: err instanceof Error ? err.stack : undefined,
+        });
+        return {
+            text: zh
+                ? `导出失败 (${subcommand}): ${err instanceof Error ? err.message : String(err)}`
+                : `Export failed (${subcommand}): ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}

package/dist/commands/focus.d.ts

@@ -0,0 +1,14 @@
+/**
+ * /pd-focus 命令 - 管理 CURRENT_FOCUS.md
+ *
+ * 功能：
+ * - status: 查看当前状态和历史版本
+ * - compress: 手动压缩并备份
+ * - history: 查看历史版本列表
+ * - rollback: 回滚到指定历史版本
+ */
+import type { PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
+/**
+ * 处理 /pd-focus 命令
+ */
+export declare function handleFocusCommand(ctx: PluginCommandContext, api: OpenClawPluginApi): Promise<PluginCommandResult>;