principles-disciple 1.11.0 → 1.13.0

package/src/core/nocturnal-trajectory-extractor.ts

@@ -29,7 +29,8 @@
  * FILE: {stateDir}/nocturnal/snapshots/  (cached snapshots if needed, optional)
  */
 
-import { TrajectoryDatabase, TrajectoryRegistry } from './trajectory.js';
+import type { TrajectoryDatabase} from './trajectory.js';
+import { TrajectoryRegistry } from './trajectory.js';
 import { detectThinkingModelMatches, listThinkingModels } from './thinking-models.js';
 
 // ---------------------------------------------------------------------------
@@ -123,6 +124,11 @@ export interface NocturnalSessionSnapshot {
     totalGateBlocks: number;
     failureCount: number;
   };
+  /**
+   * #219: Marker for data source to identify fallback/partial stats.
+   * - 'pain_context_fallback': Stats derived from pain context only (trajectory extractor failed)
+   */
+  _dataSource?: 'pain_context_fallback';
 }
 
 /**
@@ -358,9 +364,10 @@ export class NocturnalTrajectoryExtractor {
  *   const sessions = extractor.listRecentNocturnalCandidateSessions({ limit: 10 });
  *   const snapshot = extractor.getNocturnalSessionSnapshot(sessionId);
  */
+/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: _stateDir parameter kept for API compatibility but unused in implementation */
 export function createNocturnalTrajectoryExtractor(
   workspaceDir: string,
-  _stateDir?: string // Ignored; kept for API compatibility with existing call sites
+  _stateDir?: string
 ): NocturnalTrajectoryExtractor {
   // Use the registry to get or create the TrajectoryDatabase instance
   const trajectory = TrajectoryRegistry.get(workspaceDir);
@@ -424,7 +431,7 @@ export function computeThinkingModelActivation(text: string): number {
  * @returns Planning ratio (0-1), or 0 if no write operations
  */
 export function computePlanningRatio(snapshot: NocturnalSessionSnapshot): number {
-  const toolCalls = snapshot.toolCalls;
+  const {toolCalls} = snapshot;
 
   let totalWrites = 0;
   let writesWithPrecedingRead = 0;