principles-disciple 1.58.0 → 1.60.0

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.58.0",
+  "version": "1.60.0",
   "skills": [
     "./skills"
   ],
@@ -76,8 +76,8 @@
     }
   },
   "buildFingerprint": {
-    "gitSha": "70500e1475ef",
-    "bundleMd5": "607cfbcb4534d2cfdc45cb0cd019cd0b",
-    "builtAt": "2026-04-16T03:41:17.317Z"
+    "gitSha": "b300ef0761c5",
+    "bundleMd5": "3c16a5198f3559b097d028b6e987cf5b",
+    "builtAt": "2026-04-18T11:02:10.525Z"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.58.0",
+  "version": "1.60.0",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/bundle.js",

package/src/commands/archive-impl.ts

@@ -19,6 +19,7 @@ import {
 } from '../core/principle-tree-ledger.js';
 import type { Implementation, ImplementationLifecycleState } from '../types/principle-tree-schema.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 /**
  * Get all implementations from the ledger.
@@ -43,7 +44,7 @@ function canArchive(state: ImplementationLifecycleState): boolean {
  *   /pd-archive-impl list       - List archivable implementations
  */
 export function handleArchiveImplCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'archive-impl');
   const {stateDir} = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
   const lang = (ctx.config?.language as string) || 'en';
   const isZh = lang === 'zh';

package/src/commands/capabilities.ts

@@ -4,6 +4,7 @@ import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { atomicWriteFileSync } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 const TOOLS_TO_SCAN = [
   { name: 'rg', cmd: ['rg', '--version'] },
@@ -50,7 +51,7 @@ function scanEnvironment(wctx: WorkspaceContext): any {
 }
 
 export function handleBootstrapTools(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'capabilities');
   const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
 
   try {

package/src/commands/context.ts

@@ -2,6 +2,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import { atomicWriteFileSync } from '../utils/io.js';
 import type { ContextInjectionConfig} from '../types.js';
 import { defaultContextConfig } from '../types.js';
@@ -11,11 +12,8 @@ import { loadContextInjectionConfig } from '../hooks/prompt.js';
  * Get workspace directory from context
  */
 function getWorkspaceDir(ctx: PluginCommandContext): string {
-    const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
-    if (!workspaceDir) {
-        throw new Error('[PD:Context] workspaceDir is required but not provided');
-    }
-    return workspaceDir;
+    // resolvePluginCommandWorkspaceDir throws on failure — never returns falsy
+    return resolvePluginCommandWorkspaceDir(ctx, 'context');
 }
 
 /**

package/src/commands/disable-impl.ts

@@ -21,6 +21,7 @@ import {
 } from '../core/principle-tree-ledger.js';
 import type { Implementation, ImplementationLifecycleState } from '../types/principle-tree-schema.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 /**
  * Get all implementations from the ledger.
@@ -133,7 +134,7 @@ function _handleDisableImpl(
  */
      
 export function handleDisableImplCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'disable-impl');
   const {stateDir} = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
   const lang = (ctx.config?.language as string) || 'en';
   const isZh = lang === 'zh';

package/src/commands/evolution-status.ts

@@ -4,6 +4,7 @@ import { WorkspaceContext } from '../core/workspace-context.js';
 import { normalizeLanguage } from '../i18n/commands.js';
 import type { PluginCommandContext } from '../openclaw-sdk.js';
 import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 function formatNumber(value: number | null): string {
   if (value === null || Number.isNaN(value)) {
@@ -74,6 +75,14 @@ function buildEnglishOutput(
     `- 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 — separated from evolution/nocturnal
+    'Heartbeat Diagnostician (Pain → Principle)',
+    `- Pending tasks: ${summary.heartbeatDiagnosis.pendingTasks}`,
+    `- Tasks written today: ${summary.heartbeatDiagnosis.tasksWrittenToday}`,
+    `- Reports written today: ${summary.heartbeatDiagnosis.reportsWrittenToday}`,
+    `- Candidates created today: ${summary.heartbeatDiagnosis.candidatesCreatedToday}`,
+    `- Heartbeats injected today: ${summary.heartbeatDiagnosis.heartbeatsInjectedToday}`,
+    '',
     'Principles',
     `- candidate principles: ${stats.candidateCount}`,
     `- probation principles: ${stats.probationCount}`,
@@ -127,6 +136,14 @@ function buildChineseOutput(
     `- 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 — separated from evolution/nocturnal
+    '心跳诊断链路（Pain → 原则）',
+    `- 等待处理: ${summary.heartbeatDiagnosis.pendingTasks}`,
+    `- 今日写入任务: ${summary.heartbeatDiagnosis.tasksWrittenToday}`,
+    `- 今日写入报告: ${summary.heartbeatDiagnosis.reportsWrittenToday}`,
+    `- 今日创建候选: ${summary.heartbeatDiagnosis.candidatesCreatedToday}`,
+    `- 今日心跳注入: ${summary.heartbeatDiagnosis.heartbeatsInjectedToday}`,
+    '',
     '原则统计',
     `- 候选原则: ${stats.candidateCount}`,
     `- 观察期原则: ${stats.probationCount}`,
@@ -152,7 +169,7 @@ function buildChineseOutput(
 }
 
 export function handleEvolutionStatusCommand(ctx: PluginCommandContext): { text: string } {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'evolution-status');
   const sessionId = (ctx as { sessionId?: string | null }).sessionId ?? null;
   // #207/#210: Use WorkspaceContext to get evolutionReducer with stateDir
   const wctx = WorkspaceContext.fromHookContext({ workspaceDir });

package/src/commands/export.ts

@@ -1,5 +1,6 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import { exportORPOSamples, listExports } from '../core/nocturnal-export.js';
 
 function isZh(ctx: PluginCommandContext): boolean {
@@ -7,7 +8,7 @@ function isZh(ctx: PluginCommandContext): boolean {
 }
 
 export function handleExportCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'export');
   const zh = isZh(ctx);
   const args = (ctx.args || '').trim();
   const parts = args.split(/\s+/).filter(Boolean);

package/src/commands/focus.ts

@@ -13,6 +13,7 @@ import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { atomicWriteFileSync } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import {
   getHistoryDir,
   backupToHistory,
@@ -28,11 +29,7 @@ import {
  * 获取工作区目录
  */
 function getWorkspaceDir(ctx: PluginCommandContext): string {
-  const workspaceDir = ctx.config?.workspaceDir as string | undefined;
-  if (!workspaceDir) {
-    throw new Error('[PD:Focus] workspaceDir is required but not provided');
-  }
-  return workspaceDir;
+  return resolvePluginCommandWorkspaceDir(ctx, 'focus');
 }
 
 /**

package/src/commands/nocturnal-review.ts

@@ -34,6 +34,7 @@ import {
 } from '../core/nocturnal-dataset.js';
 import { getPrincipleState, setPrincipleState } from '../core/principle-training-state.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 function isZh(ctx: PluginCommandContext): boolean {
   return String(ctx.config?.language || 'en').startsWith('zh');
@@ -91,7 +92,7 @@ function statusLabel(status: NocturnalReviewStatus, zh: boolean): string {
 }
 
 export function handleNocturnalReviewCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'nocturnal-review');
   const zh = isZh(ctx);
   const args = (ctx.args || '').trim();
   const parts = args.split(/\s+/).filter(Boolean);

package/src/commands/nocturnal-rollout.ts

@@ -25,6 +25,7 @@
  */
 
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import {
   evaluatePromotionGate,
   advancePromotion,
@@ -99,7 +100,7 @@ function formatConstraintCheck(
 }
 
 export function handleNocturnalRolloutCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'nocturnal-rollout');
   const zh = isZh(ctx);
   const args = (ctx.args || '').trim();
   const parts = args.split(/\s+/).filter(Boolean);

package/src/commands/nocturnal-train.ts

@@ -28,6 +28,7 @@ import { execFileSync, spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { atomicWriteFileSync } from '../utils/io.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import {
   type TrainerBackendKind,
   type HardwareTier,
@@ -100,7 +101,7 @@ function formatTrainingRun(run: ReturnType<typeof getTrainingRun>, zh: boolean):
 }
 
 export async function handleNocturnalTrainCommand(ctx: PluginCommandContext): Promise<PluginCommandResult> {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'nocturnal-train');
   const zh = isZh(ctx);
   const args = (ctx.args || '').trim();
   const parts = args.split(/\s+/).filter(Boolean);

package/src/commands/pain.ts

@@ -1,6 +1,7 @@
 import { resetFriction, getSession } from '../core/session-tracker.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import type { EmpathyEventStats } from '../types/event-types.js';
 
 /**
@@ -92,7 +93,7 @@ interface SessionAwareCommandContext extends PluginCommandContext {
  * Handles the /pd-status command
  */
 export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResult {
-    const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'pain');
     
     const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
     const lang = (ctx.config?.language as string) || 'en';

package/src/commands/pd-reflect.ts

@@ -8,6 +8,7 @@
 import type { PluginCommandDefinition, PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
 import { acquireQueueLock, EVOLUTION_QUEUE_LOCK_SUFFIX } from '../service/evolution-worker.js';
 import { atomicWriteFileSync } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import * as fs from 'fs';
 import * as path from 'path';
 
@@ -23,11 +24,7 @@ export const handlePdReflect: PluginCommandDefinition = {
   requireAuth: false,
   handler: async (ctx: PdReflectContext): Promise<PluginCommandResult> => {
     try {
-       
-      const workspaceDir = ctx.workspaceDir;
-      if (!workspaceDir) {
-        return { text: 'Cannot determine workspace directory. Ensure you are in an active workspace.', isError: true };
-      }
+      const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'pd-reflect');
 
       const stateDir = path.join(workspaceDir, '.state');
       const queuePath = path.join(stateDir, 'evolution_queue.json');
@@ -80,9 +77,10 @@ export const handlePdReflect: PluginCommandDefinition = {
       return {
         text: `Nocturnal reflection task enqueued: \`${taskId}\`\n\nIt will be processed in the next evolution worker cycle (~15s). Check .state/nocturnal/samples/ for results.`,
       };
-    } catch (error) {
+    } catch (err: unknown) {
+      const message = err instanceof Error ? err.message : String(err);
       return {
-        text: `Failed to trigger reflection: ${String(error)}`,
+        text: `Failed to trigger reflection: ${message}`,
         isError: true,
       };
     }

package/src/commands/principle-rollback.ts

@@ -1,9 +1,10 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginCommandContext } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
      
 export function handlePrincipleRollbackCommand(ctx: PluginCommandContext): { text: string } {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'principle-rollback');
   const argText = (ctx.args || '').trim();
   const [principleId = '', ...reasonParts] = argText.split(/\s+/);
   const reason = (reasonParts.join(' ') || 'manual rollback').trim();

package/src/commands/promote-impl.ts

@@ -28,6 +28,7 @@ import {
 } from '../core/principle-tree-ledger.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import type { Implementation, ImplementationLifecycleState } from '../types/principle-tree-schema.js';
 import { withLock } from '../utils/file-lock.js';
 import { atomicWriteFileSync } from '../utils/io.js';
@@ -250,7 +251,7 @@ function _handlePromoteImpl(options: PromoteImplOptions): PluginCommandResult {
 }
 
 export function handlePromoteImplCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'promote-impl');
   const {stateDir} = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
   const lang = (ctx.config?.language as string) || 'en';
   const isZh = lang === 'zh';

package/src/commands/rollback-impl.ts

@@ -25,6 +25,7 @@ import {
 } from '../core/principle-tree-ledger.js';
 import type { Implementation } from '../types/principle-tree-schema.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 /**
  * Get all implementations from the ledger.
@@ -44,7 +45,7 @@ function getAllImplementations(stateDir: string): Implementation[] {
  */
      
 export function handleRollbackImplCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'rollback-impl');
   const {stateDir} = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
   const lang = (ctx.config?.language as string) || 'en';
   const isZh = lang === 'zh';

package/src/commands/rollback.ts

@@ -1,6 +1,7 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { resetFriction } from '../core/session-tracker.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 /**
  * Extended context interface that includes sessionId injected by the plugin framework.
@@ -18,7 +19,7 @@ interface SessionAwareCommandContext extends PluginCommandContext {
  *   /pd-rollback last        - Rollback the last empathy event in current session
  */
 export function handleRollbackCommand(ctx: PluginCommandContext): PluginCommandResult {
-    const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'rollback');
     
     const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
     const lang = (ctx.config?.language as string) || 'en';

package/src/commands/samples.ts

@@ -1,12 +1,13 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 function isZh(ctx: PluginCommandContext): boolean {
   return String(ctx.config?.language || 'en').startsWith('zh');
 }
 
 export function handleSamplesCommand(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'samples');
   const zh = isZh(ctx);
   const args = (ctx.args || '').trim();
   const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });

package/src/commands/strategy.ts

@@ -1,8 +1,9 @@
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 
 export function handleInitStrategy(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'strategy');
   const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
 
   const okrDir = wctx.resolve('OKR_DIR').replace(workspaceDir, '').replace(/^\/+/, '');
@@ -20,7 +21,7 @@ export function handleInitStrategy(ctx: PluginCommandContext): PluginCommandResu
 }
 
 export function handleManageOkr(ctx: PluginCommandContext): PluginCommandResult {
-  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'strategy:manageOkr');
   const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
 
   const focusPath = wctx.resolve('CURRENT_FOCUS').replace(workspaceDir, '').replace(/^\/+/, '');

package/src/commands/thinking-os.ts

@@ -1,10 +1,11 @@
  
 import * as fs from 'fs';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 
 function getWorkspaceDir(ctx: PluginCommandContext): string {
-    return (ctx.config?.workspaceDir as string) || process.cwd();
+    return resolvePluginCommandWorkspaceDir(ctx, 'thinking-os');
 }
 
 function getModels(wctx: WorkspaceContext): Record<string, string> {

package/src/commands/workflow-debug.ts

@@ -1,5 +1,6 @@
 import { WorkflowStore } from '../service/subagent-workflow/workflow-store.js';
 import type { PluginCommandContext } from '../openclaw-sdk.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 
 function formatTimestamp(ts: number | null | undefined): string {
     if (!ts) return '--';
@@ -85,7 +86,7 @@ function buildOutput(
 export function handleWorkflowDebugCommand(
     ctx: PluginCommandContext & { args?: string }
 ): { text: string } {
-    const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'workflow-debug');
     
     // Parse workflow ID from args
     const args = (ctx as { args?: string }).args?.trim() || '';

package/src/core/event-log.ts

@@ -18,6 +18,12 @@ import type {
   EvolutionTaskEventData,
   DeepReflectionEventData,
   EmpathyRollbackEventData,
+  // C: New event data types
+  DiagnosisTaskEventData,
+  HeartbeatDiagnosisEventData,
+  DiagnosticianReportEventData,
+  PrincipleCandidateEventData,
+  RuleEnforcedEventData,
 } from '../types/event-types.js';
 import { createEmptyDailyStats } from '../types/event-types.js';
 import { atomicWriteFileSync } from '../utils/io.js';
@@ -180,9 +186,28 @@ export class EventLog {
   recordWarn(sessionId: string | undefined, message: string, context?: Record<string, unknown>): void {
     this.record('warn', 'failure', sessionId, { message, ...context });
   }
-  
-   
-   
+
+  // C: Diagnostician heartbeat chain event recorders
+  recordDiagnosisTask(data: DiagnosisTaskEventData): void {
+    this.record('diagnosis_task', 'written', undefined, data);
+  }
+
+  recordHeartbeatDiagnosis(data: HeartbeatDiagnosisEventData): void {
+    this.record('heartbeat_diagnosis', 'injected', undefined, data);
+  }
+
+  recordDiagnosticianReport(data: DiagnosticianReportEventData): void {
+    this.record('diagnostician_report', data.success ? 'completed' : 'failure', undefined, data);
+  }
+
+  recordPrincipleCandidate(data: PrincipleCandidateEventData): void {
+    this.record('principle_candidate', 'created', undefined, data);
+  }
+
+  recordRuleEnforced(data: RuleEnforcedEventData): void {
+    this.record('rule_enforced', 'matched', undefined, data);
+  }
+
   private record(
     type: EventType, 
     category: EventCategory, 
@@ -325,6 +350,20 @@ export class EventLog {
         stats.evolution.tasksEnqueued++;
       }
     }
+    // C: Diagnostician heartbeat chain event counters
+    else if (entry.type === 'diagnosis_task') {
+      stats.evolution.diagnosisTasksWritten++;
+    } else if (entry.type === 'heartbeat_diagnosis') {
+      stats.evolution.heartbeatsInjected++;
+    } else if (entry.type === 'diagnostician_report') {
+      if (entry.category === 'completed') {
+        stats.evolution.diagnosticianReportsWritten++;
+      }
+    } else if (entry.type === 'principle_candidate') {
+      stats.evolution.principleCandidatesCreated++;
+    } else if (entry.type === 'rule_enforced') {
+      stats.evolution.rulesEnforced++;
+    }
   }
 
   private startFlushTimer(): void {

package/src/core/init.ts

@@ -192,7 +192,7 @@ export function ensureCorePrinciples(stateDir: string, logger: PluginLogger): bo
     for (const model of CORE_THINKING_MODELS) {
       const state: PrincipleTrainingState = {
         principleId: model.id,
-        evaluability: 'manual_only',
+        evaluability: 'deterministic',
         applicableOpportunityCount: 0,
         observedViolationCount: 0,
         complianceRate: 0,
@@ -217,7 +217,7 @@ export function ensureCorePrinciples(stateDir: string, logger: PluginLogger): bo
         status: 'active',
         priority: 'P1',
         scope: 'general',
-        evaluability: 'manual_only',
+        evaluability: 'deterministic',
         valueScore: 0,
         adherenceRate: 0,
         painPreventedCount: 0,

package/src/core/principle-compiler/ledger-registrar.ts

@@ -52,6 +52,11 @@ export function registerCompiledRule(stateDir: string, input: RegisterInput): Re
   const now = new Date().toISOString();
 
   // Step 1: Create the rule
+  // FIX: Auto-generated rules default to 'warn' enforcement (not 'block') until:
+  // - replay evaluation passes
+  // - coverage confirmation
+  // - human approval
+  // This prevents P_001-style false positives from blocking normal edits.
   const rule: LedgerRule = {
     id: ruleId,
     version: 1,
@@ -59,7 +64,7 @@ export function registerCompiledRule(stateDir: string, input: RegisterInput): Re
     description: `Automatically compiled gate rule generated from principle ${principleId}`,
     type: 'gate',
     triggerCondition: coversCondition,
-    enforcement: 'block',
+    enforcement: 'warn',
     action: codeContent,
     principleId,
     status: 'proposed',
@@ -82,7 +87,11 @@ export function registerCompiledRule(stateDir: string, input: RegisterInput): Re
       version: '1',
       coversCondition,
       coveragePercentage: 100,
-      lifecycleState: 'active' as const,
+      // FIX: Start as 'candidate' instead of 'active'.
+      // RuleHost only loads lifecycleState='active' implementations.
+      // This means auto-generated rules will NOT block until explicitly
+      // promoted to 'active' after replay evaluation + human approval.
+      lifecycleState: 'candidate' as const,
       createdAt: now,
       updatedAt: now,
     };

package/src/core/rule-host-types.ts

@@ -66,6 +66,10 @@ export interface RuleHostResult {
   matched: boolean;
   reason: string;
   diagnostics?: Record<string, unknown>;
+  /** C: Rule ID that produced this result (for observability events) */
+  ruleId?: string;
+  /** C: Principle ID that this rule implements (for observability events) */
+  principleId?: string;
 }
 
 // ---------------------------------------------------------------------------

package/src/core/rule-host.ts

@@ -234,7 +234,13 @@ export class RuleHost {
         meta,
         evaluate: (input: RuleHostInput): RuleHostResult => {
           const frozenHelpers = createRuleHostHelpers(input);
-          return rawEvaluate(input, frozenHelpers);
+          const result = rawEvaluate(input, frozenHelpers);
+          // C: Enrich result with rule/principle IDs for observability
+          if (result.matched && (result.decision === 'block' || result.decision === 'requireApproval')) {
+            result.ruleId = impl.ruleId;
+            result.principleId = meta.ruleId ?? impl.ruleId;
+          }
+          return result;
         },
       };
     } catch (compileError: unknown) {

package/src/hooks/gate.ts

@@ -39,6 +39,7 @@ import {
 } from '../constants/tools.js';
 import { getSession, hasRecentThinking } from '../core/session-tracker.js';
 import { getEvolutionEngine } from '../core/evolution-engine.js';
+import { EventLogService } from '../core/event-log.js';
 
 export function handleBeforeToolCall(
   event: PluginHookBeforeToolCallEvent,
@@ -205,6 +206,20 @@ export function handleBeforeToolCall(
 
     const hostResult = ruleHost.evaluate(hostInput);
     if (hostResult?.decision === 'block' || hostResult?.decision === 'requireApproval') {
+      // C: Record rule_enforced event for matched rules
+      try {
+        const eventLog = EventLogService.get(wctx.stateDir, logger as PluginLogger | undefined);
+        eventLog.recordRuleEnforced({
+          ruleId: hostResult.ruleId || 'unknown',
+          principleId: hostResult.principleId || 'unknown',
+          enforcement: hostResult.decision === 'requireApproval' ? 'requireApproval' : 'block',
+          toolName: event.toolName,
+          filePath: relPath,
+        });
+      } catch (evErr) {
+        logger?.warn?.(`[PD_GATE] Failed to record rule_enforced event: ${String(evErr)}`);
+      }
+
       const reason = hostResult.decision === 'requireApproval'
         ? `[Rule Host] Approval required: ${hostResult.reason}`
         : hostResult.reason;

package/src/hooks/prompt.ts

@@ -23,6 +23,7 @@ import {
 } from '../core/empathy-keyword-matcher.js';
 import { severityToPenalty, DEFAULT_EMPATHY_KEYWORD_CONFIG } from '../core/empathy-types.js';
 import { CorrectionCueLearner } from '../core/correction-cue-learner.js';
+import { EventLogService } from '../core/event-log.js';
 import type { PluginRuntimeSubagent } from '../service/subagent-workflow/runtime-direct-driver.js';
 
 /**
@@ -755,6 +756,18 @@ ${taskBlocks}${processingNote}
 </diagnostician_tasks>\n`;
 
         logger?.info?.(`[PD:Prompt] Injected ${Math.min(pendingCount, 3)}/${pendingCount} pending diagnostician task(s) into heartbeat prompt`);
+
+        // C: Record heartbeat_diagnosis event for observability
+        try {
+          const eventLog = EventLogService.get(wctx.stateDir, logger);
+          eventLog.recordHeartbeatDiagnosis({
+            taskCount: pendingCount,
+            taskIds: pendingTasks.slice(0, 3).map(t => t.id),
+            trigger: 'heartbeat',
+          });
+        } catch (evErr) {
+          logger?.warn?.(`[PD:Prompt] Failed to record heartbeat_diagnosis event: ${String(evErr)}`);
+        }
       }
     } catch (e) {
       logger?.warn?.(`[PD:Prompt] Failed to read diagnostician tasks: ${String(e)}`);