github-issue-tower-defence-management 1.94.4 → 1.96.0

package/src/domain/usecases/LiveSessionOauthTokenSelectUseCase.test.ts

@@ -0,0 +1,147 @@
+import { ClaudeLiveSession } from './adapter-interfaces/ClaudeLiveSessionRepository';
+import { LiveSessionOauthTokenSelectUseCase } from './LiveSessionOauthTokenSelectUseCase';
+import {
+  OauthTokenCandidate,
+  OauthTokenWindowSnapshot,
+} from './OauthTokenSelectUseCase';
+
+const NOW = 1_000_000;
+const HOUR = 3600;
+const DAY = 86400;
+
+const snapshot = (
+  overrides: Partial<OauthTokenWindowSnapshot>,
+): OauthTokenWindowSnapshot => ({
+  fiveHourUtilization: 0,
+  fiveHourReset: NOW + HOUR,
+  sevenDayUtilization: 0,
+  sevenDayReset: NOW + DAY,
+  ...overrides,
+});
+
+const candidate = (
+  name: string,
+  snapshotValue: OauthTokenWindowSnapshot | null,
+): OauthTokenCandidate => ({
+  name,
+  token: `fake-token-${name}`,
+  snapshot: snapshotValue,
+});
+
+const session = (name: string, sessionId: string): ClaudeLiveSession => ({
+  token: `fake-token-${name}`,
+  sessionId,
+});
+
+describe('LiveSessionOauthTokenSelectUseCase', () => {
+  const useCase = new LiveSessionOauthTokenSelectUseCase();
+
+  it('prefers the eligible token with zero live sessions', () => {
+    const result = useCase.run(
+      [candidate('busy', snapshot({})), candidate('idle', snapshot({}))],
+      [session('busy', 'session-a')],
+      NOW,
+    );
+
+    expect(result.selected?.name).toBe('idle');
+    expect(result.selected?.token).toBe('fake-token-idle');
+    const idle = result.metrics.find((m) => m.name === 'idle');
+    expect(idle?.liveSessionCount).toBe(0);
+  });
+
+  it('breaks an occupancy tie by the soonest 7d reset', () => {
+    const result = useCase.run(
+      [
+        candidate('far', snapshot({ sevenDayReset: NOW + 6 * DAY })),
+        candidate('soon', snapshot({ sevenDayReset: NOW + 2 * DAY })),
+      ],
+      [session('far', 'session-a'), session('soon', 'session-b')],
+      NOW,
+    );
+
+    expect(result.selected?.name).toBe('soon');
+  });
+
+  it('prefers fewer live sessions over a sooner 7d reset', () => {
+    const result = useCase.run(
+      [
+        candidate('soonButBusy', snapshot({ sevenDayReset: NOW + 2 * DAY })),
+        candidate('farButIdle', snapshot({ sevenDayReset: NOW + 6 * DAY })),
+      ],
+      [
+        session('soonButBusy', 'session-a'),
+        session('soonButBusy', 'session-b'),
+      ],
+      NOW,
+    );
+
+    expect(result.selected?.name).toBe('farButIdle');
+  });
+
+  it('excludes a rate-limit-ineligible token even when it has no live sessions', () => {
+    const result = useCase.run(
+      [
+        candidate('idleButBlocked', snapshot({ fiveHourUtilization: 0.9 })),
+        candidate('busyButFree', snapshot({})),
+      ],
+      [session('busyButFree', 'session-a')],
+      NOW,
+    );
+
+    expect(result.selected?.name).toBe('busyButFree');
+    const blocked = result.metrics.find((m) => m.name === 'idleButBlocked');
+    expect(blocked?.eligible).toBe(false);
+    expect(blocked?.liveSessionCount).toBe(0);
+  });
+
+  it('counts distinct session ids and dedupes child processes sharing one session', () => {
+    const result = useCase.run(
+      [
+        candidate('oneSession', snapshot({ sevenDayReset: NOW + 2 * DAY })),
+        candidate('twoSessions', snapshot({ sevenDayReset: NOW + 6 * DAY })),
+      ],
+      [
+        session('oneSession', 'session-a'),
+        session('oneSession', 'session-a'),
+        session('oneSession', 'session-a'),
+        session('twoSessions', 'session-b'),
+        session('twoSessions', 'session-c'),
+      ],
+      NOW,
+    );
+
+    expect(result.selected?.name).toBe('oneSession');
+    const oneSession = result.metrics.find((m) => m.name === 'oneSession');
+    const twoSessions = result.metrics.find((m) => m.name === 'twoSessions');
+    expect(oneSession?.liveSessionCount).toBe(1);
+    expect(twoSessions?.liveSessionCount).toBe(2);
+  });
+
+  it('returns null selection when no token passes the rate-limit filter', () => {
+    const result = useCase.run(
+      [candidate('blocked', snapshot({ fiveHourUtilization: 0.9 }))],
+      [],
+      NOW,
+    );
+
+    expect(result.selected).toBeNull();
+  });
+
+  it('returns null selection for an empty candidate list', () => {
+    const result = useCase.run([], [], NOW);
+
+    expect(result.selected).toBeNull();
+    expect(result.metrics).toEqual([]);
+  });
+
+  it('reports a zero live session count for tokens with no matching process', () => {
+    const result = useCase.run(
+      [candidate('lonely', snapshot({}))],
+      [session('other', 'session-x')],
+      NOW,
+    );
+
+    const lonely = result.metrics.find((m) => m.name === 'lonely');
+    expect(lonely?.liveSessionCount).toBe(0);
+  });
+});

package/src/domain/usecases/LiveSessionOauthTokenSelectUseCase.ts

@@ -0,0 +1,100 @@
+import { ClaudeLiveSession } from './adapter-interfaces/ClaudeLiveSessionRepository';
+import {
+  OauthTokenCandidate,
+  OauthTokenSelectUseCase,
+} from './OauthTokenSelectUseCase';
+
+export type LiveSessionOauthTokenCandidateMetrics = {
+  name: string;
+  fiveHourFreeRatio: number;
+  sevenDayFreeRatio: number;
+  sevenDayEndEpoch: number;
+  liveSessionCount: number;
+  eligible: boolean;
+  exclusionReason: string | null;
+};
+
+export type LiveSessionOauthTokenSelectResult = {
+  selected: OauthTokenCandidate | null;
+  metrics: LiveSessionOauthTokenCandidateMetrics[];
+};
+
+export class LiveSessionOauthTokenSelectUseCase {
+  constructor(
+    private readonly rateLimitSelectUseCase: OauthTokenSelectUseCase = new OauthTokenSelectUseCase(),
+  ) {}
+
+  run = (
+    candidates: OauthTokenCandidate[],
+    liveSessions: ClaudeLiveSession[],
+    nowEpochSeconds: number,
+  ): LiveSessionOauthTokenSelectResult => {
+    const rateLimitResult = this.rateLimitSelectUseCase.run(
+      candidates,
+      nowEpochSeconds,
+    );
+    const liveSessionCountByToken = this.liveSessionCountByToken(liveSessions);
+
+    const evaluated = candidates.map((candidate, index) => {
+      const rateLimitMetric = rateLimitResult.metrics[index];
+      const liveSessionCount =
+        liveSessionCountByToken.get(candidate.token) ?? 0;
+      return {
+        candidate,
+        metric: {
+          name: rateLimitMetric.name,
+          fiveHourFreeRatio: rateLimitMetric.fiveHourFreeRatio,
+          sevenDayFreeRatio: rateLimitMetric.sevenDayFreeRatio,
+          sevenDayEndEpoch: rateLimitMetric.sevenDayEndEpoch,
+          liveSessionCount,
+          eligible: rateLimitMetric.eligible,
+          exclusionReason: rateLimitMetric.exclusionReason,
+        },
+      };
+    });
+
+    const metrics = evaluated.map((entry) => entry.metric);
+    const eligible = evaluated.filter((entry) => entry.metric.eligible);
+
+    if (eligible.length === 0) {
+      return { selected: null, metrics };
+    }
+
+    const best = eligible.reduce((bestEntry, currentEntry) =>
+      this.preferred(currentEntry.metric, bestEntry.metric)
+        ? currentEntry
+        : bestEntry,
+    );
+
+    return { selected: best.candidate, metrics };
+  };
+
+  private preferred = (
+    candidateMetric: LiveSessionOauthTokenCandidateMetrics,
+    incumbentMetric: LiveSessionOauthTokenCandidateMetrics,
+  ): boolean => {
+    if (candidateMetric.liveSessionCount !== incumbentMetric.liveSessionCount) {
+      return (
+        candidateMetric.liveSessionCount < incumbentMetric.liveSessionCount
+      );
+    }
+    return candidateMetric.sevenDayEndEpoch < incumbentMetric.sevenDayEndEpoch;
+  };
+
+  private liveSessionCountByToken = (
+    liveSessions: ClaudeLiveSession[],
+  ): Map<string, number> => {
+    const sessionIdsByToken = new Map<string, Set<string>>();
+    for (const liveSession of liveSessions) {
+      const sessionIds =
+        sessionIdsByToken.get(liveSession.token) ?? new Set<string>();
+      sessionIds.add(liveSession.sessionId);
+      sessionIdsByToken.set(liveSession.token, sessionIds);
+    }
+    const countByToken = new Map<string, number>();
+    for (const [token, sessionIds] of sessionIdsByToken.entries()) {
+      countByToken.set(token, sessionIds.size);
+    }
+    return countByToken;
+  };
+}

package/src/domain/usecases/adapter-interfaces/ClaudeLiveSessionRepository.ts

@@ -0,0 +1,8 @@
+export type ClaudeLiveSession = {
+  token: string;
+  sessionId: string;
+};
+
+export interface ClaudeLiveSessionRepository {
+  listLiveSessions: () => ClaudeLiveSession[];
+}

package/types/adapter/entry-points/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAkGzB,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAwGzB,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/types/adapter/entry-points/handlers/LiveSessionOauthTokenSelectHandler.d.ts

@@ -0,0 +1,20 @@
+import { ClaudeLiveSessionRepository } from '../../../domain/usecases/adapter-interfaces/ClaudeLiveSessionRepository';
+import { LiveSessionOauthTokenSelectUseCase } from '../../../domain/usecases/LiveSessionOauthTokenSelectUseCase';
+export type LiveSessionOauthTokenSelectHandlerInput = {
+    tokenListJsonPath: string | null;
+    cacheDirectory: string | null;
+    nowEpochSeconds: number;
+};
+export type LiveSessionOauthTokenSelectHandlerOutput = {
+    selectedToken: string | null;
+    selectedName: string | null;
+    diagnostics: string[];
+};
+export declare class LiveSessionOauthTokenSelectHandler {
+    private readonly useCase;
+    private readonly liveSessionRepository;
+    constructor(useCase?: LiveSessionOauthTokenSelectUseCase, liveSessionRepository?: ClaudeLiveSessionRepository);
+    handle: (input: LiveSessionOauthTokenSelectHandlerInput) => LiveSessionOauthTokenSelectHandlerOutput;
+    private formatDiagnostics;
+}
+//# sourceMappingURL=LiveSessionOauthTokenSelectHandler.d.ts.map

package/types/adapter/entry-points/handlers/LiveSessionOauthTokenSelectHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveSessionOauthTokenSelectHandler.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/handlers/LiveSessionOauthTokenSelectHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yEAAyE,CAAC;AACtH,OAAO,EAEL,kCAAkC,EACnC,MAAM,6DAA6D,CAAC;AAUrE,MAAM,MAAM,uCAAuC,GAAG;IACpD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAAG;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,qBAAa,kCAAkC;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBADrB,OAAO,GAAE,kCAA6E,EACtF,qBAAqB,GAAE,2BAAmE;IAG7G,MAAM,GACJ,OAAO,uCAAuC,KAC7C,wCAAwC,CAuDzC;IAEF,OAAO,CAAC,iBAAiB,CAuBvB;CACH"}

package/types/adapter/repositories/ProcClaudeLiveSessionRepository.d.ts

@@ -0,0 +1,11 @@
+import { ClaudeLiveSession, ClaudeLiveSessionRepository } from '../../domain/usecases/adapter-interfaces/ClaudeLiveSessionRepository';
+export declare class ProcClaudeLiveSessionRepository implements ClaudeLiveSessionRepository {
+    private readonly procDirectory;
+    constructor(procDirectory?: string);
+    listLiveSessions: () => ClaudeLiveSession[];
+    private listProcessIdDirectories;
+    private readLiveSession;
+    private isClaudeProcess;
+    private readEnviron;
+}
+//# sourceMappingURL=ProcClaudeLiveSessionRepository.d.ts.map

package/types/adapter/repositories/ProcClaudeLiveSessionRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcClaudeLiveSessionRepository.d.ts","sourceRoot":"","sources":["../../../src/adapter/repositories/ProcClaudeLiveSessionRepository.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,sEAAsE,CAAC;AAiB9E,qBAAa,+BAAgC,YAAW,2BAA2B;IAE/E,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,GAAE,MAA+B;IAGjE,gBAAgB,QAAO,iBAAiB,EAAE,CASxC;IAEF,OAAO,CAAC,wBAAwB,CAQ9B;IAEF,OAAO,CAAC,eAAe,CAqBrB;IAEF,OAAO,CAAC,eAAe,CAgBrB;IAEF,OAAO,CAAC,WAAW,CA4BjB;CACH"}

package/types/domain/usecases/LiveSessionOauthTokenSelectUseCase.d.ts

@@ -0,0 +1,23 @@
+import { ClaudeLiveSession } from './adapter-interfaces/ClaudeLiveSessionRepository';
+import { OauthTokenCandidate, OauthTokenSelectUseCase } from './OauthTokenSelectUseCase';
+export type LiveSessionOauthTokenCandidateMetrics = {
+    name: string;
+    fiveHourFreeRatio: number;
+    sevenDayFreeRatio: number;
+    sevenDayEndEpoch: number;
+    liveSessionCount: number;
+    eligible: boolean;
+    exclusionReason: string | null;
+};
+export type LiveSessionOauthTokenSelectResult = {
+    selected: OauthTokenCandidate | null;
+    metrics: LiveSessionOauthTokenCandidateMetrics[];
+};
+export declare class LiveSessionOauthTokenSelectUseCase {
+    private readonly rateLimitSelectUseCase;
+    constructor(rateLimitSelectUseCase?: OauthTokenSelectUseCase);
+    run: (candidates: OauthTokenCandidate[], liveSessions: ClaudeLiveSession[], nowEpochSeconds: number) => LiveSessionOauthTokenSelectResult;
+    private preferred;
+    private liveSessionCountByToken;
+}
+//# sourceMappingURL=LiveSessionOauthTokenSelectUseCase.d.ts.map

package/types/domain/usecases/LiveSessionOauthTokenSelectUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveSessionOauthTokenSelectUseCase.d.ts","sourceRoot":"","sources":["../../../src/domain/usecases/LiveSessionOauthTokenSelectUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAClD,CAAC;AAEF,qBAAa,kCAAkC;IAE3C,OAAO,CAAC,QAAQ,CAAC,sBAAsB;gBAAtB,sBAAsB,GAAE,uBAAuD;IAGlG,GAAG,GACD,YAAY,mBAAmB,EAAE,EACjC,cAAc,iBAAiB,EAAE,EACjC,iBAAiB,MAAM,KACtB,iCAAiC,CAuClC;IAEF,OAAO,CAAC,SAAS,CAUf;IAEF,OAAO,CAAC,uBAAuB,CAe7B;CACH"}

package/types/domain/usecases/adapter-interfaces/ClaudeLiveSessionRepository.d.ts

@@ -0,0 +1,8 @@
+export type ClaudeLiveSession = {
+    token: string;
+    sessionId: string;
+};
+export interface ClaudeLiveSessionRepository {
+    listLiveSessions: () => ClaudeLiveSession[];
+}
+//# sourceMappingURL=ClaudeLiveSessionRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/ClaudeLiveSessionRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeLiveSessionRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/ClaudeLiveSessionRepository.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,iBAAiB,EAAE,CAAC;CAC7C"}