principles-disciple 1.237.0 → 1.239.0

package/dist/core/event-log.d.ts

@@ -1,4 +1,4 @@
-import type { EventLogEntry, DailyStats, EmpathyEventStats, ToolCallEventData, PainSignalEventData, RulePromotionEventData, GovernanceActionEventData, HookExecutionEventData, GateBlockEventData, GateBypassEventData, EvolutionTaskEventData, EmpathyRollbackEventData, DiagnosisTaskEventData, HeartbeatDiagnosisEventData, DiagnosticianReportEventData, PrincipleCandidateEventData, RuleEnforcedEventData, RuleHostEvaluatedEventData, RuleHostBlockedEventData, RuleHostRequireApprovalEventData, RuleHostAutoCorrectProposedEventData, RuleHostAutoCorrectAppliedEventData, RuntimeV2PromptActivationsInjectedEventData, RuleHostUnhealthyEventData, RuleHostSkippedEventData, TrajectoryObservabilityFailureEventData } from '../types/event-types.js';
+import type { EventLogEntry, DailyStats, EmpathyEventStats, ToolCallEventData, PainSignalEventData, RulePromotionEventData, GovernanceActionEventData, HookExecutionEventData, GateBlockEventData, GateBypassEventData, EmpathyRollbackEventData, DiagnosisTaskEventData, HeartbeatDiagnosisEventData, DiagnosticianReportEventData, PrincipleCandidateEventData, RuleEnforcedEventData, RuleHostEvaluatedEventData, RuleHostBlockedEventData, RuleHostRequireApprovalEventData, RuleHostAutoCorrectProposedEventData, RuleHostAutoCorrectAppliedEventData, RuntimeV2PromptActivationsInjectedEventData, RuleHostUnhealthyEventData, RuleHostSkippedEventData, TrajectoryObservabilityFailureEventData } from '../types/event-types.js';
 import type { PluginLogger } from '../openclaw-sdk.js';
 export declare class EventLog {
     private readonly logsDir;
@@ -27,8 +27,6 @@ export declare class EventLog {
     }): void;
     recordGateBlock(sessionId: string | undefined, data: GateBlockEventData): void;
     recordGateBypass(sessionId: string | undefined, data: GateBypassEventData): void;
-    recordEvolutionTask(data: EvolutionTaskEventData): void;
-    recordEvolutionTaskCompleted(data: EvolutionTaskEventData): void;
     recordEmpathyRollback(sessionId: string | undefined, data: EmpathyRollbackEventData): void;
     recordError(sessionId: string | undefined, message: string, context?: Record<string, unknown>): void;
     recordWarn(sessionId: string | undefined, message: string, context?: Record<string, unknown>): void;

package/dist/core/evolution-types.d.ts

@@ -1,17 +1,20 @@
 /**
- * Evolution Points System V2.0 - MVP
+ * Evolution domain type surface for the plugin.
  *
- * Canonical definitions moved to @principles/core/runtime-v2/evolution/
- * This file re-exports everything for backward compatibility.
+ * Canonical definitions live in @principles/core/runtime-v2 (evolution/).
+ * This file keeps the plugin-facing backward-compatible aliases.
  *
  * NOTE: Principle → EvolutionPrinciple, PrincipleStatus → EvolutionPrincipleStatus
  *       to avoid collision with runtime-v2/types/principle-schema.ts Principle.
  *       Backward-compatible aliases are provided below.
+ *
+ * PRI-770: the Evolution Points/Tier re-exports (tiers, scorecards, storage /
+ * config contracts) and the V2 queue item types were removed — their
+ * subsystems were retired (PRI-737) and no consumer remained.
  */
-import type { TaskKind, TaskPriority } from './trajectory-types.js';
 import type { EvolutionPrinciple as EvolutionPrincipleType, EvolutionPrincipleStatus as EvolutionPrincipleStatusType, EvolutionPrincipleSuggestedRule as EvolutionPrincipleSuggestedRuleType, EvolutionPrincipleValueMetricsSnapshot as EvolutionPrincipleValueMetricsSnapshotType, EvolutionPainDetectedData as EvolutionPainDetectedDataType } from '@principles/core/runtime-v2';
-export { EvolutionTier, TIER_DEFINITIONS, getTierDefinition, getTierByPoints, TASK_DIFFICULTY_CONFIG, DEFAULT_EVOLUTION_CONFIG, isCompleteDetectorMetadata, } from '@principles/core/runtime-v2';
-export type { TierPermissions, TierDefinition, TaskDifficulty, TaskDifficultyConfig, EvolutionEventType, EvolutionEvent, EvolutionScorecard, EvolutionStats, EvolutionStorage, EvolutionConfig, ArchivedEventStats, GateDecision, ToolCallContext, TierPromotionEvent, EvolutionPrincipleStatus, PrincipleEvaluatorLevel, Evaluability, PrincipleDetectorSpec, EvolutionPrinciple, EvolutionPrincipleSuggestedRule, EvolutionPrincipleValueMetricsSnapshot, EvolutionLoopEventType, EvolutionPainDetectedData, CandidateCreatedData, PrinciplePromotedData, PrincipleDeprecatedData, PrincipleRolledBackData, CircuitBreakerOpenedData, LegacyImportData, EvolutionLoopEvent, } from '@principles/core/runtime-v2';
+export { isCompleteDetectorMetadata, } from '@principles/core/runtime-v2';
+export type { EvolutionPrincipleStatus, PrincipleEvaluatorLevel, Evaluability, PrincipleDetectorSpec, EvolutionPrinciple, EvolutionPrincipleSuggestedRule, EvolutionPrincipleValueMetricsSnapshot, EvolutionLoopEventType, EvolutionPainDetectedData, CandidateCreatedData, PrinciplePromotedData, PrincipleDeprecatedData, PrincipleRolledBackData, CircuitBreakerOpenedData, LegacyImportData, EvolutionLoopEvent, } from '@principles/core/runtime-v2';
 /** @deprecated Use EvolutionPrinciple instead. Alias for backward compatibility. */
 export type Principle = EvolutionPrincipleType;
 /** @deprecated Use EvolutionPrincipleStatus instead. Alias for backward compatibility. */
@@ -22,29 +25,3 @@ export type PrincipleSuggestedRule = EvolutionPrincipleSuggestedRuleType;
 export type PrincipleValueMetricsSnapshot = EvolutionPrincipleValueMetricsSnapshotType;
 /** @deprecated Use EvolutionPainDetectedData instead. Alias for backward compatibility. */
 export type PainDetectedData = EvolutionPainDetectedDataType;
-export type QueueStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'canceled';
-export type TaskResolution = 'marker_detected' | 'auto_completed_timeout' | 'failed_max_retries' | 'runtime_unavailable' | 'canceled' | 'late_marker_principle_created' | 'late_marker_no_principle' | 'stub_fallback' | 'skipped_thin_violation' | 'success' | 'failure' | 'skipped' | 'noise_classified' | 'retired';
-export interface EvolutionQueueItem {
-    id: string;
-    taskKind: TaskKind;
-    priority: TaskPriority;
-    source: string;
-    traceId?: string;
-    task?: string;
-    score: number;
-    reason: string;
-    timestamp: string;
-    enqueued_at?: string;
-    started_at?: string;
-    completed_at?: string;
-    assigned_session_key?: string;
-    trigger_text_preview?: string;
-    status: QueueStatus;
-    resolution?: TaskResolution;
-    session_id?: string;
-    agent_id?: string;
-    retryCount: number;
-    maxRetries: number;
-    lastError?: string;
-    resultRef?: string;
-}

package/dist/core/session-tracker.d.ts

@@ -62,11 +62,26 @@ export declare function resetFriction(sessionId: string, workspaceDir?: string,
 }): SessionState;
 export declare function trackBlock(sessionId: string): SessionState;
 export declare function setInjectedProbationIds(sessionId: string, ids: string[], workspaceDir?: string): SessionState;
-/** PRI-534: record the principle ids injected into this session's prompt context. */
+/**
+ * PRI-534: record the principle ids injected into this session's prompt context.
+ * PRI-755 (review fix): call this on EVERY prompt build with the CURRENT set —
+ * including an empty one. An empty array is a known-empty round and overwrites
+ * a stale non-empty set from an earlier turn; the self-report capture validates
+ * against this set, so keeping a stale set would re-admit markers for
+ * principles no longer injected.
+ */
 export declare function setInjectedPrincipleIds(sessionId: string | undefined, ids: readonly string[], workspaceDir?: string): void;
 /** PRI-534: count one applied live auto-correction in this session. */
 export declare function trackReceiptAutoCorrect(sessionId: string | undefined, workspaceDir?: string): void;
 export declare function getInjectedProbationIds(sessionId: string, workspaceDir?: string): string[];
+/**
+ * PRI-755: read-only view of the principle ids injected into this session's
+ * prompt context. Tri-state: an array (possibly empty) means the injection set
+ * is KNOWN; undefined means UNKNOWN (session never built a prompt in this
+ * process, tracker restarted, or session expired). Receipt capture may only
+ * treat verified membership as evidence — unknown must not imply empty.
+ */
+export declare function getInjectedPrincipleIds(sessionId: string): readonly string[] | undefined;
 export declare function clearInjectedProbationIds(sessionId: string, workspaceDir?: string): SessionState;
 export declare function getSession(sessionId: string): SessionState | undefined;
 export declare function listSessions(workspaceDir?: string): SessionState[];

package/dist/core/trajectory.d.ts

@@ -1,4 +1,4 @@
-import type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, EvolutionTaskInput, EvolutionEventInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions, RuleHostContextResult, RuleHostEvidenceRow } from './trajectory-types.js';
+import type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions, RuleHostContextResult, RuleHostEvidenceRow } from './trajectory-types.js';
 export type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, DailyMetricRow, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, TaskKind, TaskPriority, EvolutionTaskInput, EvolutionEventInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions, RuleHostContextRow, RuleHostContextResult, RuleHostEvidenceRow, } from './trajectory-types.js';
 /**
  * Initialize trajectory.db schema at the given workspace directory.
@@ -47,9 +47,15 @@ export declare class TrajectoryDatabase {
     recordTrustChange(input: TrajectoryTrustChangeInput): void;
     recordPrincipleEvent(input: TrajectoryPrincipleEventInput): void;
     recordTaskOutcome(input: TrajectoryTaskOutcomeInput): void;
-    recordEvolutionTask(input: EvolutionTaskInput): void;
-    updateEvolutionTask(taskId: string, updates: Partial<Omit<EvolutionTaskInput, 'taskId' | 'traceId' | 'source'>>): void;
-    recordEvolutionEvent(input: EvolutionEventInput): void;
+    /**
+     * PRI-770: fresh workspaces no longer create the evolution tables (the
+     * writer path was retired with the evolution worker in PRI-737), while
+     * historical workspaces keep theirs. Readers degrade to empty results on a
+     * missing table instead of throwing — the same contract as the SDK readers'
+     * "DB does not exist → empty array" behaviour. This is an expected,
+     * observable state for new workspaces, not a silent failure.
+     */
+    private evolutionTableMissing;
     /**
      * List evolution tasks with optional filtering.
      *