github-issue-tower-defence-management 1.140.2 → 1.141.0

package/bin/domain/usecases/OutputDegenerationDetector.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputDegenerationDetector = exports.OUTPUT_DEGENERATION_CROSS_TURN_MIN_TURNS = exports.OUTPUT_DEGENERATION_CROSS_TURN_WINDOW = exports.OUTPUT_DEGENERATION_REP4_MIN_TOKENS = exports.OUTPUT_DEGENERATION_REP4_THRESHOLD = exports.OUTPUT_DEGENERATION_ABSOLUTE_RUN_THRESHOLD = exports.OUTPUT_DEGENERATION_MAX_TOKEN_LENGTH = exports.OUTPUT_DEGENERATION_DOMINATION_FRACTION = exports.OUTPUT_DEGENERATION_REPEAT_THRESHOLD = void 0;
+exports.OUTPUT_DEGENERATION_REPEAT_THRESHOLD = 5;
+exports.OUTPUT_DEGENERATION_DOMINATION_FRACTION = 0.8;
+exports.OUTPUT_DEGENERATION_MAX_TOKEN_LENGTH = 32;
+exports.OUTPUT_DEGENERATION_ABSOLUTE_RUN_THRESHOLD = 15;
+exports.OUTPUT_DEGENERATION_REP4_THRESHOLD = 0.3;
+exports.OUTPUT_DEGENERATION_REP4_MIN_TOKENS = 40;
+exports.OUTPUT_DEGENERATION_CROSS_TURN_WINDOW = 10;
+exports.OUTPUT_DEGENERATION_CROSS_TURN_MIN_TURNS = 4;
+const LIST_ITEM_LINE_PATTERN = /^\s*(?:[-*+]\s|\d+[.)]\s)/;
+const TRAILING_ALPHA_TOKEN_PATTERN = /^[A-Za-z]+$/;
+const splitTokens = (text) => text.split(/\s+/).filter((token) => token.length > 0);
+const splitLines = (text) => text.split(/\r\n|\r|\n/);
+class OutputDegenerationDetector {
+    constructor(repeatThreshold = exports.OUTPUT_DEGENERATION_REPEAT_THRESHOLD, dominationFraction = exports.OUTPUT_DEGENERATION_DOMINATION_FRACTION, maxTokenLength = exports.OUTPUT_DEGENERATION_MAX_TOKEN_LENGTH, absoluteRunThreshold = exports.OUTPUT_DEGENERATION_ABSOLUTE_RUN_THRESHOLD, rep4Threshold = exports.OUTPUT_DEGENERATION_REP4_THRESHOLD, rep4MinTokens = exports.OUTPUT_DEGENERATION_REP4_MIN_TOKENS, crossTurnWindow = exports.OUTPUT_DEGENERATION_CROSS_TURN_WINDOW, crossTurnMinTurns = exports.OUTPUT_DEGENERATION_CROSS_TURN_MIN_TURNS) {
+        this.repeatThreshold = repeatThreshold;
+        this.dominationFraction = dominationFraction;
+        this.maxTokenLength = maxTokenLength;
+        this.absoluteRunThreshold = absoluteRunThreshold;
+        this.rep4Threshold = rep4Threshold;
+        this.rep4MinTokens = rep4MinTokens;
+        this.crossTurnWindow = crossTurnWindow;
+        this.crossTurnMinTurns = crossTurnMinTurns;
+        this.maxConsecutiveShortTokenRun = (text) => {
+            let bestToken = null;
+            let bestRun = 0;
+            let totalTokens = 0;
+            let currentToken = null;
+            let currentRun = 0;
+            for (const token of splitTokens(text)) {
+                totalTokens += 1;
+                if (token.length > this.maxTokenLength) {
+                    currentToken = null;
+                    currentRun = 0;
+                    continue;
+                }
+                if (token === currentToken) {
+                    currentRun += 1;
+                }
+                else {
+                    currentToken = token;
+                    currentRun = 1;
+                }
+                if (currentRun > bestRun) {
+                    bestRun = currentRun;
+                    bestToken = currentToken;
+                }
+            }
+            return { token: bestToken, run: bestRun, total: totalTokens };
+        };
+        this.isIntraTurnDegeneration = (text) => {
+            const { run, total } = this.maxConsecutiveShortTokenRun(text);
+            if (total === 0) {
+                return false;
+            }
+            if (run >= this.repeatThreshold && run >= this.dominationFraction * total) {
+                return true;
+            }
+            const filtered = this.stripRepetitionExemptSpans(text);
+            const filteredRun = this.maxConsecutiveShortTokenRun(filtered);
+            if (filteredRun.run >= this.absoluteRunThreshold) {
+                return true;
+            }
+            if (filteredRun.total >= this.rep4MinTokens &&
+                this.duplicateNgramFraction(filtered, 4) >= this.rep4Threshold) {
+                return true;
+            }
+            return false;
+        };
+        this.detectCrossTurnDegeneration = (texts) => {
+            const counts = new Map();
+            for (const text of texts.slice(0, this.crossTurnWindow)) {
+                const token = this.trailingSpuriousToken(text);
+                if (token === null) {
+                    continue;
+                }
+                counts.set(token, (counts.get(token) ?? 0) + 1);
+            }
+            let bestToken = null;
+            let bestCount = 0;
+            for (const [token, count] of counts) {
+                if (count > bestCount) {
+                    bestCount = count;
+                    bestToken = token;
+                }
+            }
+            if (bestToken !== null && bestCount >= this.crossTurnMinTurns) {
+                return { token: bestToken, turnCount: bestCount };
+            }
+            return null;
+        };
+        this.stripRepetitionExemptSpans = (text) => {
+            const keptLines = [];
+            let inFence = false;
+            for (const line of splitLines(text)) {
+                const stripped = line.trim();
+                if (stripped.startsWith('```') || stripped.startsWith('~~~')) {
+                    inFence = !inFence;
+                    continue;
+                }
+                if (inFence) {
+                    continue;
+                }
+                if (line.includes('|')) {
+                    continue;
+                }
+                if (LIST_ITEM_LINE_PATTERN.test(line)) {
+                    continue;
+                }
+                keptLines.push(line);
+            }
+            return keptLines.join('\n');
+        };
+        this.duplicateNgramFraction = (text, n) => {
+            const tokens = splitTokens(text).filter((token) => token.length <= this.maxTokenLength);
+            if (tokens.length < n + 1) {
+                return 0;
+            }
+            const ngrams = [];
+            for (let index = 0; index <= tokens.length - n; index += 1) {
+                ngrams.push(tokens.slice(index, index + n).join('\u0000'));
+            }
+            const total = ngrams.length;
+            if (total < 2) {
+                return 0;
+            }
+            const unique = new Set(ngrams).size;
+            return 1 - unique / total;
+        };
+        this.trailingSpuriousToken = (text) => {
+            const stripped = text.replace(/\s+$/, '');
+            if (stripped.length === 0) {
+                return null;
+            }
+            const lines = splitLines(stripped);
+            const lastLine = lines[lines.length - 1].trim();
+            if (lastLine.length === 0 || lastLine.length > this.maxTokenLength) {
+                return null;
+            }
+            if (!TRAILING_ALPHA_TOKEN_PATTERN.test(lastLine)) {
+                return null;
+            }
+            return lastLine;
+        };
+    }
+}
+exports.OutputDegenerationDetector = OutputDegenerationDetector;
+//# sourceMappingURL=OutputDegenerationDetector.js.map

package/bin/domain/usecases/OutputDegenerationDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputDegenerationDetector.js","sourceRoot":"","sources":["../../../src/domain/usecases/OutputDegenerationDetector.ts"],"names":[],"mappings":"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"}

package/bin/domain/usecases/SessionOutputDegenerationRecoveryUseCase.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionOutputDegenerationRecoveryUseCase = exports.DEFAULT_OUTPUT_DEGENERATION_WARNING_MESSAGE = exports.DEFAULT_OUTPUT_DEGENERATION_COOLDOWN_SECONDS = exports.DEFAULT_OUTPUT_DEGENERATION_GRACE_SECONDS = void 0;
+const OutputDegenerationDetector_1 = require("./OutputDegenerationDetector");
+const ResolveInteractiveLiveSessionsUseCase_1 = require("./ResolveInteractiveLiveSessionsUseCase");
+const NotifySilentLiveSessionsUseCase_1 = require("./NotifySilentLiveSessionsUseCase");
+exports.DEFAULT_OUTPUT_DEGENERATION_GRACE_SECONDS = 5;
+exports.DEFAULT_OUTPUT_DEGENERATION_COOLDOWN_SECONDS = 300;
+exports.DEFAULT_OUTPUT_DEGENERATION_WARNING_MESSAGE = 'OUTPUT DEGENERATION DETECTED: your session is about to be reset. Immediately write a checkpoint to your assigned task issue (single concrete next action to resume, working directory and branch, in-flight sub-agent branch/PR URLs).';
+class SessionOutputDegenerationRecoveryUseCase {
+    constructor(liveSessionProcessSnapshotProvider, interactiveLiveSessionTranscriptResolver, assistantTurnsRepository, notificationRepository, tmuxSessionRepository, cooldownStateRepository, sleeper, detector = new OutputDegenerationDetector_1.OutputDegenerationDetector()) {
+        this.liveSessionProcessSnapshotProvider = liveSessionProcessSnapshotProvider;
+        this.interactiveLiveSessionTranscriptResolver = interactiveLiveSessionTranscriptResolver;
+        this.assistantTurnsRepository = assistantTurnsRepository;
+        this.notificationRepository = notificationRepository;
+        this.tmuxSessionRepository = tmuxSessionRepository;
+        this.cooldownStateRepository = cooldownStateRepository;
+        this.sleeper = sleeper;
+        this.detector = detector;
+        this.resolveInteractiveLiveSessions = new ResolveInteractiveLiveSessionsUseCase_1.ResolveInteractiveLiveSessionsUseCase();
+        this.run = async (params) => {
+            const snapshot = await this.liveSessionProcessSnapshotProvider.getSnapshot();
+            const allInteractiveSessions = this.resolveInteractiveLiveSessions.resolve(snapshot);
+            const interactiveSessions = allInteractiveSessions.filter((session) => (0, NotifySilentLiveSessionsUseCase_1.isGitHubIssueOrPullRequestSessionName)(session.sessionName));
+            const transcriptPathBySessionName = this.interactiveLiveSessionTranscriptResolver.resolveTranscriptPaths(interactiveSessions);
+            const turnsBySessionName = await this.assistantTurnsRepository.listRecentAssistantTurnsBySessionName(transcriptPathBySessionName, OutputDegenerationDetector_1.OUTPUT_DEGENERATION_CROSS_TURN_WINDOW);
+            const lastResetBySessionName = await this.cooldownStateRepository.loadLastResetEpochSecondsBySessionName();
+            const nowEpochSeconds = Math.floor(params.now.getTime() / 1000);
+            let detectedCount = 0;
+            let resetCount = 0;
+            let dryRunCount = 0;
+            let cooldownSkippedCount = 0;
+            for (const session of interactiveSessions) {
+                const sessionName = session.sessionName;
+                const lastResetEpochSeconds = lastResetBySessionName.get(sessionName);
+                if (lastResetEpochSeconds !== undefined &&
+                    nowEpochSeconds - lastResetEpochSeconds < params.cooldownSeconds) {
+                    cooldownSkippedCount += 1;
+                    continue;
+                }
+                const turns = turnsBySessionName.get(sessionName) ?? [];
+                const newestTurn = turns.length > 0 ? turns[0] : null;
+                const intraTurn = newestTurn !== null &&
+                    this.detector.isIntraTurnDegeneration(newestTurn);
+                const crossTurn = this.detector.detectCrossTurnDegeneration(turns);
+                if (!intraTurn && crossTurn === null) {
+                    continue;
+                }
+                detectedCount += 1;
+                if (intraTurn && newestTurn !== null) {
+                    const { token, run, total } = this.detector.maxConsecutiveShortTokenRun(newestTurn);
+                    console.log(`Output degeneration detected (intra-turn) session=${sessionName} token=${JSON.stringify(token)} run=${run} turnTokens=${total} enabled=${params.enabled}`);
+                }
+                if (crossTurn !== null) {
+                    console.log(`Output degeneration detected (cross-turn) session=${sessionName} token=${JSON.stringify(crossTurn.token)} turns=${crossTurn.turnCount}/${Math.min(turns.length, OutputDegenerationDetector_1.OUTPUT_DEGENERATION_CROSS_TURN_WINDOW)} enabled=${params.enabled}`);
+                }
+                if (params.enabled) {
+                    try {
+                        await this.notificationRepository.sendSelfCheckNotification(sessionName, params.warningMessage);
+                        await this.sleeper.sleep(params.graceSeconds * 1000);
+                        await this.tmuxSessionRepository.killSession(sessionName);
+                        resetCount += 1;
+                        console.log(`Output degeneration reset session=${sessionName} graceSeconds=${params.graceSeconds}`);
+                    }
+                    catch (error) {
+                        console.error(`Failed to reset degenerated session ${sessionName}: ${error instanceof Error ? error.message : String(error)}`);
+                        continue;
+                    }
+                }
+                else {
+                    dryRunCount += 1;
+                    console.log(`Output degeneration dry-run: would warn and reset session=${sessionName}`);
+                }
+                await this.cooldownStateRepository.recordReset({
+                    sessionName,
+                    now: params.now,
+                });
+            }
+            console.log(`Output degeneration recovery: detected ${detectedCount} degenerated session(s) of ${interactiveSessions.length} interactive session(s); reset ${resetCount}, dry-run would-reset ${dryRunCount}, cooldown-skipped ${cooldownSkippedCount}.`);
+        };
+    }
+}
+exports.SessionOutputDegenerationRecoveryUseCase = SessionOutputDegenerationRecoveryUseCase;
+//# sourceMappingURL=SessionOutputDegenerationRecoveryUseCase.js.map

package/bin/domain/usecases/SessionOutputDegenerationRecoveryUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionOutputDegenerationRecoveryUseCase.js","sourceRoot":"","sources":["../../../src/domain/usecases/SessionOutputDegenerationRecoveryUseCase.ts"],"names":[],"mappings":"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"}

package/bin/domain/usecases/adapter-interfaces/SessionAssistantTurnsRepository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SessionAssistantTurnsRepository.js.map

package/bin/domain/usecases/adapter-interfaces/SessionAssistantTurnsRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAssistantTurnsRepository.js","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/SessionAssistantTurnsRepository.ts"],"names":[],"mappings":""}

package/bin/domain/usecases/adapter-interfaces/SessionDegenerationCooldownStateRepository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SessionDegenerationCooldownStateRepository.js.map

package/bin/domain/usecases/adapter-interfaces/SessionDegenerationCooldownStateRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionDegenerationCooldownStateRepository.js","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/SessionDegenerationCooldownStateRepository.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-issue-tower-defence-management",
-  "version": "1.140.2",
+  "version": "1.141.0",
   "description": "",
   "main": "bin/index.js",
   "scripts": {

package/src/adapter/entry-points/handlers/HandleScheduledEventUseCaseHandler.ts

@@ -16,6 +16,10 @@ import {
   notifySilentTmuxSessions,
   DEFAULT_NOTIFY_SILENT_TMUX_SESSIONS_PARAMS,
 } from './notifySilentTmuxSessions';
+import {
+  resetDegeneratedTmuxSessions,
+  DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS,
+} from './resetDegeneratedTmuxSessions';
 import { writeRotationOrderFile } from './rotationOrderFileWriter';
 import {
   fetchProjectReadme,
@@ -145,6 +149,11 @@ export class HandleScheduledEventUseCaseHandler {
       silentSubAgentIdleMessageFooter?: string;
       silentSubAgentLongRunningMessageHeader?: string;
       silentSubAgentLongRunningMessageFooter?: string;
+      outputDegenerationResetEnabled?: boolean;
+      outputDegenerationWarningMessage?: string;
+      outputDegenerationGraceSeconds?: number;
+      outputDegenerationCooldownSeconds?: number;
+      outputDegenerationCooldownStateFilePath?: string;
       credentials: {
         manager: {
           github: {
@@ -740,6 +749,41 @@ export class HandleScheduledEventUseCaseHandler {
           }`,
         );
       }
+
+      try {
+        const outputDegenerationResetEnabled =
+          mergedInput.outputDegenerationResetEnabled ??
+          process.env.TDPM_OUTPUT_DEGENERATION_RESET_ENABLED === 'true';
+        await resetDegeneratedTmuxSessions({
+          enabled: outputDegenerationResetEnabled,
+          localCommandRunner: nodeLocalCommandRunner,
+          warningMessage:
+            mergedInput.outputDegenerationWarningMessage ??
+            process.env.TDPM_OUTPUT_DEGENERATION_WARNING_MESSAGE ??
+            DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.warningMessage,
+          graceSeconds: readSilentSeconds(
+            mergedInput.outputDegenerationGraceSeconds,
+            process.env.TDPM_OUTPUT_DEGENERATION_GRACE_SECONDS,
+            DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.graceSeconds,
+          ),
+          cooldownSeconds: readSilentSeconds(
+            mergedInput.outputDegenerationCooldownSeconds,
+            process.env.TDPM_OUTPUT_DEGENERATION_COOLDOWN_SECONDS,
+            DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.cooldownSeconds,
+          ),
+          cooldownStateFilePath:
+            mergedInput.outputDegenerationCooldownStateFilePath ??
+            process.env.TDPM_OUTPUT_DEGENERATION_COOLDOWN_STATE_FILE_PATH ??
+            null,
+          now: inTmuxNow,
+        });
+      } catch (error) {
+        console.error(
+          `Failed to reset degenerated tmux sessions: ${
+            error instanceof Error ? error.message : String(error)
+          }`,
+        );
+      }
     }
     return result;
   };

package/src/adapter/entry-points/handlers/resetDegeneratedTmuxSessions.test.ts

@@ -0,0 +1,69 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import {
+  resetDegeneratedTmuxSessions,
+  DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS,
+} from './resetDegeneratedTmuxSessions';
+import { LocalCommandRunner } from '../../../domain/usecases/adapter-interfaces/LocalCommandRunner';
+
+describe('resetDegeneratedTmuxSessions', () => {
+  let temporaryDirectory: string;
+  let cooldownStateFilePath: string;
+  let loggedMessages: string[];
+  let consoleLogSpy: jest.SpiedFunction<typeof console.log>;
+
+  beforeEach(() => {
+    temporaryDirectory = fs.mkdtempSync(
+      path.join(os.tmpdir(), 'reset-degenerated-'),
+    );
+    cooldownStateFilePath = path.join(temporaryDirectory, 'cooldown.json');
+    loggedMessages = [];
+    consoleLogSpy = jest
+      .spyOn(console, 'log')
+      .mockImplementation((...args: unknown[]): void => {
+        loggedMessages.push(args.map((arg) => String(arg)).join(' '));
+      });
+  });
+
+  afterEach(() => {
+    consoleLogSpy.mockRestore();
+    fs.rmSync(temporaryDirectory, { recursive: true, force: true });
+  });
+
+  it('wires the real adapters and runs end to end without acting when no sessions exist', async () => {
+    const runCommand: jest.MockedFunction<LocalCommandRunner['runCommand']> =
+      jest.fn().mockResolvedValue({ stdout: '', stderr: '', exitCode: 0 });
+    const commandRunner: LocalCommandRunner = { runCommand };
+
+    await resetDegeneratedTmuxSessions({
+      enabled: false,
+      localCommandRunner: commandRunner,
+      warningMessage:
+        DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.warningMessage,
+      graceSeconds: DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.graceSeconds,
+      cooldownSeconds:
+        DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.cooldownSeconds,
+      cooldownStateFilePath,
+      now: new Date('2026-07-26T00:00:00Z'),
+    });
+
+    const summaryLogged = loggedMessages.some((message) =>
+      message.includes(
+        'Output degeneration recovery: detected 0 degenerated session(s) of 0 interactive session(s)',
+      ),
+    );
+    expect(summaryLogged).toBe(true);
+    const killInvoked = runCommand.mock.calls.some((callArguments) =>
+      callArguments[1].includes('kill-session'),
+    );
+    expect(killInvoked).toBe(false);
+  });
+
+  it('exposes safe defaults with a five second grace and 300 second cooldown', () => {
+    expect(DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.graceSeconds).toBe(5);
+    expect(DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS.cooldownSeconds).toBe(
+      300,
+    );
+  });
+});

package/src/adapter/entry-points/handlers/resetDegeneratedTmuxSessions.ts

@@ -0,0 +1,71 @@
+import { LocalCommandRunner } from '../../../domain/usecases/adapter-interfaces/LocalCommandRunner';
+import { ProcessEnvironReader } from '../../../domain/usecases/adapter-interfaces/ProcessEnvironReader';
+import {
+  SessionOutputDegenerationRecoveryUseCase,
+  DEFAULT_OUTPUT_DEGENERATION_GRACE_SECONDS,
+  DEFAULT_OUTPUT_DEGENERATION_COOLDOWN_SECONDS,
+  DEFAULT_OUTPUT_DEGENERATION_WARNING_MESSAGE,
+} from '../../../domain/usecases/SessionOutputDegenerationRecoveryUseCase';
+import { LocalProcessLiveSessionProcessSnapshotProvider } from '../../repositories/LocalProcessLiveSessionProcessSnapshotProvider';
+import { ProcFsProcessEnvironReader } from '../../repositories/ProcFsProcessEnvironReader';
+import { FileSystemInteractiveLiveSessionTranscriptResolver } from '../../repositories/FileSystemInteractiveLiveSessionTranscriptResolver';
+import { FileSystemSessionAssistantTurnsRepository } from '../../repositories/FileSystemSessionAssistantTurnsRepository';
+import { FileSystemSessionDegenerationCooldownStateRepository } from '../../repositories/FileSystemSessionDegenerationCooldownStateRepository';
+import { TmuxSilentSessionNotificationRepository } from '../../repositories/TmuxSilentSessionNotificationRepository';
+import { NodeTmuxSessionRepository } from '../../repositories/NodeTmuxSessionRepository';
+import { RealSleeper } from '../../repositories/RealSleeper';
+
+export type ResetDegeneratedTmuxSessionsParams = {
+  enabled: boolean;
+  localCommandRunner: LocalCommandRunner;
+  processEnvironReader?: ProcessEnvironReader;
+  warningMessage: string;
+  graceSeconds: number;
+  cooldownSeconds: number;
+  cooldownStateFilePath: string | null;
+  now: Date;
+};
+
+export const resetDegeneratedTmuxSessions = async (
+  params: ResetDegeneratedTmuxSessionsParams,
+): Promise<void> => {
+  const {
+    enabled,
+    localCommandRunner,
+    processEnvironReader,
+    warningMessage,
+    graceSeconds,
+    cooldownSeconds,
+    cooldownStateFilePath,
+    now,
+  } = params;
+  const useCase = new SessionOutputDegenerationRecoveryUseCase(
+    new LocalProcessLiveSessionProcessSnapshotProvider(
+      localCommandRunner,
+      processEnvironReader ?? new ProcFsProcessEnvironReader(),
+    ),
+    new FileSystemInteractiveLiveSessionTranscriptResolver(),
+    new FileSystemSessionAssistantTurnsRepository(),
+    new TmuxSilentSessionNotificationRepository(localCommandRunner),
+    new NodeTmuxSessionRepository(localCommandRunner),
+    cooldownStateFilePath !== null
+      ? new FileSystemSessionDegenerationCooldownStateRepository(
+          cooldownStateFilePath,
+        )
+      : new FileSystemSessionDegenerationCooldownStateRepository(),
+    new RealSleeper(),
+  );
+  await useCase.run({
+    enabled,
+    warningMessage,
+    graceSeconds,
+    cooldownSeconds,
+    now,
+  });
+};
+
+export const DEFAULT_RESET_DEGENERATED_TMUX_SESSIONS_PARAMS = {
+  warningMessage: DEFAULT_OUTPUT_DEGENERATION_WARNING_MESSAGE,
+  graceSeconds: DEFAULT_OUTPUT_DEGENERATION_GRACE_SECONDS,
+  cooldownSeconds: DEFAULT_OUTPUT_DEGENERATION_COOLDOWN_SECONDS,
+} as const;

package/src/adapter/repositories/FileSystemSessionAssistantTurnsRepository.test.ts

@@ -0,0 +1,138 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { FileSystemSessionAssistantTurnsRepository } from './FileSystemSessionAssistantTurnsRepository';
+
+describe('FileSystemSessionAssistantTurnsRepository', () => {
+  let temporaryDirectory: string;
+
+  beforeEach(() => {
+    temporaryDirectory = fs.mkdtempSync(
+      path.join(os.tmpdir(), 'assistant-turns-'),
+    );
+  });
+
+  afterEach(() => {
+    fs.rmSync(temporaryDirectory, { recursive: true, force: true });
+  });
+
+  const writeTranscript = (fileName: string, lines: string[]): string => {
+    const filePath = path.join(temporaryDirectory, fileName);
+    fs.writeFileSync(filePath, `${lines.join('\n')}\n`);
+    return filePath;
+  };
+
+  it('returns recent assistant turn texts newest first, ignoring non-assistant lines', async () => {
+    const filePath = writeTranscript('transcript.jsonl', [
+      JSON.stringify({
+        type: 'assistant',
+        message: { content: [{ type: 'text', text: 'first turn' }] },
+      }),
+      JSON.stringify({
+        type: 'user',
+        message: { content: [{ type: 'text', text: 'a user turn' }] },
+      }),
+      JSON.stringify({
+        type: 'assistant',
+        message: {
+          content: [
+            { type: 'text', text: 'second turn' },
+            { type: 'tool_use', id: 'tool-1', name: 'Bash' },
+          ],
+        },
+      }),
+      JSON.stringify({
+        type: 'assistant',
+        message: { content: [{ type: 'text', text: 'third turn' }] },
+      }),
+    ]);
+
+    const repository = new FileSystemSessionAssistantTurnsRepository();
+    const result = await repository.listRecentAssistantTurnsBySessionName(
+      new Map([['session', filePath]]),
+      10,
+    );
+
+    expect(result.get('session')).toEqual([
+      'third turn',
+      'second turn',
+      'first turn',
+    ]);
+  });
+
+  it('limits the number of turns returned to maxTurnsPerSession', async () => {
+    const filePath = writeTranscript('transcript.jsonl', [
+      JSON.stringify({
+        type: 'assistant',
+        message: { content: [{ type: 'text', text: 'oldest' }] },
+      }),
+      JSON.stringify({
+        type: 'assistant',
+        message: { content: [{ type: 'text', text: 'middle' }] },
+      }),
+      JSON.stringify({
+        type: 'assistant',
+        message: { content: [{ type: 'text', text: 'newest' }] },
+      }),
+    ]);
+
+    const repository = new FileSystemSessionAssistantTurnsRepository();
+    const result = await repository.listRecentAssistantTurnsBySessionName(
+      new Map([['session', filePath]]),
+      2,
+    );
+
+    expect(result.get('session')).toEqual(['newest', 'middle']);
+  });
+
+  it('reads a string content assistant message', async () => {
+    const filePath = writeTranscript('transcript.jsonl', [
+      JSON.stringify({
+        type: 'assistant',
+        message: { content: 'plain string turn' },
+      }),
+    ]);
+
+    const repository = new FileSystemSessionAssistantTurnsRepository();
+    const result = await repository.listRecentAssistantTurnsBySessionName(
+      new Map([['session', filePath]]),
+      10,
+    );
+
+    expect(result.get('session')).toEqual(['plain string turn']);
+  });
+
+  it('omits a session whose transcript is missing', async () => {
+    const repository = new FileSystemSessionAssistantTurnsRepository();
+    const result = await repository.listRecentAssistantTurnsBySessionName(
+      new Map([['session', path.join(temporaryDirectory, 'absent.jsonl')]]),
+      10,
+    );
+
+    expect(result.has('session')).toBe(false);
+  });
+
+  it('drops the first partial line when reading only the transcript tail', async () => {
+    const firstLine = JSON.stringify({
+      type: 'assistant',
+      message: { content: [{ type: 'text', text: 'partial old turn' }] },
+    });
+    const secondLine = JSON.stringify({
+      type: 'assistant',
+      message: { content: [{ type: 'text', text: 'complete new turn' }] },
+    });
+    const filePath = writeTranscript('transcript.jsonl', [
+      firstLine,
+      secondLine,
+    ]);
+
+    const tailBytes = Buffer.byteLength(`${secondLine}\n`) + 5;
+    const repository = new FileSystemSessionAssistantTurnsRepository(tailBytes);
+    const result = await repository.listRecentAssistantTurnsBySessionName(
+      new Map([['session', filePath]]),
+      10,
+    );
+
+    expect(result.get('session')).toEqual(['complete new turn']);
+  });
+});