github-issue-tower-defence-management 1.191.0 → 1.193.0

package/src/adapter/entry-points/console/ui-dist/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>TDPM Console</title>
-    <script type="module" crossorigin src="/assets/index-B22eMy23.js"></script>
+    <script type="module" crossorigin src="/assets/index-RaFqjB7u.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-CLHvrafO.css">
   </head>
   <body>

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

@@ -1,4 +1,7 @@
-import { StartPreparationUseCase } from './StartPreparationUseCase';
+import {
+  SPAWN_CANDIDATE_BRANCH_SOURCE_CONCURRENCY,
+  StartPreparationUseCase,
+} from './StartPreparationUseCase';
 import {
   IssueRepository,
   RelatedPullRequest,
@@ -7283,3 +7286,103 @@ describe('StartPreparationUseCase.getTokenConcurrentLimit', () => {
     expect(useCase.getTokenConcurrentLimit(0.1, 0.1, 0.01)).toBe(1);
   });
 });
+
+describe('StartPreparationUseCase.fetchSpawnCandidateBranchSources', () => {
+  const buildRelatedPullRequest = (url: string): RelatedPullRequest => ({
+    url,
+    branchName: 'feature',
+    createdAt: new Date('2026-01-01T00:00:00Z'),
+    isDraft: false,
+    isConflicted: false,
+    mergeable: 'MERGEABLE',
+    isPassedAllCiJob: true,
+    isCiStateSuccess: true,
+    isResolvedAllReviewComments: true,
+    isBranchOutOfDate: false,
+    missingRequiredCheckNames: [],
+  });
+
+  const buildUseCase = (
+    issueRepositoryOverrides: Partial<
+      ConstructorParameters<typeof StartPreparationUseCase>[1]
+    >,
+  ): StartPreparationUseCase =>
+    new StartPreparationUseCase(
+      {
+        getByUrl: jest.fn(),
+        createField: jest.fn(),
+        updateAgentList: jest.fn(),
+      },
+      {
+        getStoryObjectMap: jest.fn(),
+        getAllOpened: jest.fn(),
+        updateStatus: jest.fn(),
+        findRelatedOpenPRs: jest.fn(),
+        getOpenPullRequest: jest.fn(),
+        closePullRequest: jest.fn(),
+        deletePullRequestBranch: jest.fn(),
+        createCommentByUrl: jest.fn(),
+        setIssueAgentField: jest.fn(),
+        removeLabel: jest.fn(),
+        ...issueRepositoryOverrides,
+      },
+      { runCommand: jest.fn() },
+      {
+        ensureObservable: jest.fn(),
+        getAvailableTokenUsages: jest.fn(),
+        getTokenInFlightCounts: jest.fn(),
+        proxyBaseUrl: jest.fn(),
+      },
+      {
+        listSpawns: jest.fn().mockReturnValue([]),
+        listRunningIssueUrls: jest.fn().mockReturnValue([]),
+      },
+    );
+
+  it('looks up related open pull requests for issue urls concurrently up to the configured limit', async () => {
+    const issueUrls = Array.from(
+      { length: 20 },
+      (_, index) => `https://github.com/owner/repo/issues/${index + 1}`,
+    );
+    let inFlightCount = 0;
+    let observedMaxInFlight = 0;
+    const findRelatedOpenPRs = jest.fn(async (issueUrl: string) => {
+      inFlightCount += 1;
+      observedMaxInFlight = Math.max(observedMaxInFlight, inFlightCount);
+      await new Promise((resolve) => setTimeout(resolve, 1));
+      inFlightCount -= 1;
+      return [buildRelatedPullRequest(issueUrl.replace('/issues/', '/pull/'))];
+    });
+    const useCase = buildUseCase({ findRelatedOpenPRs });
+
+    const branchSources =
+      await useCase.fetchSpawnCandidateBranchSources(issueUrls);
+
+    expect(findRelatedOpenPRs).toHaveBeenCalledTimes(20);
+    expect(observedMaxInFlight).toBe(SPAWN_CANDIDATE_BRANCH_SOURCE_CONCURRENCY);
+    expect(branchSources.size).toBe(20);
+    for (const issueUrl of issueUrls) {
+      expect(branchSources.get(issueUrl)?.relatedOpenPullRequests).toHaveLength(
+        1,
+      );
+      expect(branchSources.get(issueUrl)?.openPullRequest).toBeNull();
+    }
+  });
+
+  it('resolves pull request urls through the open pull request lookup instead of the timeline query', async () => {
+    const prUrl = 'https://github.com/owner/repo/pull/7';
+    const openPullRequest = buildRelatedPullRequest(prUrl);
+    const getOpenPullRequest = jest.fn().mockResolvedValue(openPullRequest);
+    const findRelatedOpenPRs = jest.fn();
+    const useCase = buildUseCase({ getOpenPullRequest, findRelatedOpenPRs });
+
+    const branchSources = await useCase.fetchSpawnCandidateBranchSources([
+      prUrl,
+    ]);
+
+    expect(getOpenPullRequest).toHaveBeenCalledWith(prUrl);
+    expect(findRelatedOpenPRs).not.toHaveBeenCalled();
+    expect(branchSources.get(prUrl)?.openPullRequest).toBe(openPullRequest);
+    expect(branchSources.get(prUrl)?.relatedOpenPullRequests).toEqual([]);
+  });
+});

package/src/domain/usecases/StartPreparationUseCase.ts

@@ -1,4 +1,8 @@
-import { IssueRepository } from './adapter-interfaces/IssueRepository';
+import {
+  IssueRepository,
+  RelatedPullRequest,
+} from './adapter-interfaces/IssueRepository';
+import { Issue } from '../entities/Issue';
 import { ProjectRepository } from './adapter-interfaces/ProjectRepository';
 import { LocalCommandRunner } from './adapter-interfaces/LocalCommandRunner';
 import { ClaudeTokenUsageRepository } from './adapter-interfaces/ClaudeTokenUsageRepository';
@@ -19,6 +23,19 @@ const SEVEN_DAY_THROTTLE_START_THRESHOLD = 0.8;
 const FIVE_HOUR_THROTTLE_START_THRESHOLD = 0.8;
 export const DEFAULT_FALLBACK_LLM_MODEL_NAME = 'claude-opus-4-8';
 const LLM_AGENT_LABEL_PREFIX = 'llm-agent:';
+export const SPAWN_CANDIDATE_BRANCH_SOURCE_CONCURRENCY = 8;
+
+export type SpawnCandidateExclusionReason =
+  | 'dependedIssueUrls'
+  | 'futureNextActionDate'
+  | 'nextActionHourNotReached'
+  | 'authorNotAllowed'
+  | 'notAssignedToManager';
+
+export type SpawnCandidateBranchSource = {
+  openPullRequest: RelatedPullRequest | null;
+  relatedOpenPullRequests: RelatedPullRequest[];
+};
 
 export const agentNameFromDesignation = (designation: string): string =>
   designation.startsWith(LLM_AGENT_LABEL_PREFIX)
@@ -173,6 +190,79 @@ export class StartPreparationUseCase {
     );
   };
 
+  spawnCandidateExclusionReasonOf = (
+    issue: Issue,
+    allowedIssueAuthors: string[] | null,
+    manager: string,
+    now: Date,
+  ): SpawnCandidateExclusionReason | null => {
+    if (issue.dependedIssueUrls.length > 0) {
+      return 'dependedIssueUrls';
+    }
+    if (issueReactivationTriggerIsPending(issue, now)) {
+      const startOfTomorrow = new Date(
+        Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate() + 1),
+      );
+      return issue.nextActionDate !== null &&
+        issue.nextActionDate >= startOfTomorrow
+        ? 'futureNextActionDate'
+        : 'nextActionHourNotReached';
+    }
+    if (
+      allowedIssueAuthors === null ||
+      allowedIssueAuthors.length === 0 ||
+      !allowedIssueAuthors.includes(issue.author)
+    ) {
+      return 'authorNotAllowed';
+    }
+    if (!issue.assignees.includes(manager)) {
+      return 'notAssignedToManager';
+    }
+    return null;
+  };
+
+  fetchSpawnCandidateBranchSources = async (
+    issueUrls: string[],
+  ): Promise<Map<string, SpawnCandidateBranchSource>> => {
+    const branchSourceByIssueUrl = new Map<
+      string,
+      SpawnCandidateBranchSource
+    >();
+    let nextIndex = 0;
+    const fetchSequentially = async (): Promise<void> => {
+      while (nextIndex < issueUrls.length) {
+        const issueUrl = issueUrls[nextIndex];
+        nextIndex += 1;
+        branchSourceByIssueUrl.set(
+          issueUrl,
+          issueUrl.includes('/pull/')
+            ? {
+                openPullRequest:
+                  await this.issueRepository.getOpenPullRequest(issueUrl),
+                relatedOpenPullRequests: [],
+              }
+            : {
+                openPullRequest: null,
+                relatedOpenPullRequests:
+                  await this.issueRepository.findRelatedOpenPRs(issueUrl),
+              },
+        );
+      }
+    };
+    await Promise.all(
+      Array.from(
+        {
+          length: Math.min(
+            SPAWN_CANDIDATE_BRANCH_SOURCE_CONCURRENCY,
+            issueUrls.length,
+          ),
+        },
+        fetchSequentially,
+      ),
+    );
+    return branchSourceByIssueUrl;
+  };
+
   private selectRotationTokens = (
     tokenUsages: ClaudeTokenUsage[],
     utilizationPercentageThreshold: number,
@@ -437,6 +527,21 @@ export class StartPreparationUseCase {
 
     const now = new Date();
 
+    const branchSourceByIssueUrl = await this.fetchSpawnCandidateBranchSources(
+      awaitingWorkspaceIssues
+        .filter(
+          (issue) =>
+            !runningIssueUrls.has(issue.url) &&
+            this.spawnCandidateExclusionReasonOf(
+              issue,
+              params.allowedIssueAuthors,
+              params.manager,
+              now,
+            ) === null,
+        )
+        .map((issue) => issue.url),
+    );
+
     for (
       let i = 0;
       i < awaitingWorkspaceIssues.length &&
@@ -452,34 +557,21 @@ export class StartPreparationUseCase {
         console.warn(`Skipping ${issue.url}: worker already running.`);
         continue;
       }
-      if (issueReactivationTriggerIsPending(issue, now)) {
-        const startOfTomorrow = new Date(
-          Date.UTC(
-            now.getUTCFullYear(),
-            now.getUTCMonth(),
-            now.getUTCDate() + 1,
-          ),
-        );
-        if (
-          issue.nextActionDate !== null &&
-          issue.nextActionDate >= startOfTomorrow
-        ) {
-          exclusionCounts.futureNextActionDate++;
-        } else {
-          exclusionCounts.nextActionHourNotReached++;
-        }
-        continue;
-      }
-      if (
-        params.allowedIssueAuthors === null ||
-        params.allowedIssueAuthors.length === 0 ||
-        !params.allowedIssueAuthors.includes(issue.author)
-      ) {
-        exclusionCounts.authorNotAllowed++;
+      const exclusionReason = this.spawnCandidateExclusionReasonOf(
+        issue,
+        params.allowedIssueAuthors,
+        params.manager,
+        now,
+      );
+      if (exclusionReason !== null) {
+        exclusionCounts[exclusionReason]++;
         continue;
       }
-      if (!issue.assignees.includes(params.manager)) {
-        exclusionCounts.notAssignedToManager++;
+      const branchSource = branchSourceByIssueUrl.get(issue.url);
+      if (branchSource === undefined) {
+        console.error(
+          `Skipping ${issue.url}: no branch source was prefetched for this spawn candidate.`,
+        );
         continue;
       }
       await adoptIssueAgentDesignationLabel(
@@ -538,7 +630,7 @@ export class StartPreparationUseCase {
       const isPrUrl = issue.url.includes('/pull/');
       let branchName: string;
       if (isPrUrl) {
-        const pr = await this.issueRepository.getOpenPullRequest(issue.url);
+        const pr = branchSource.openPullRequest;
         if (pr === null) {
           console.warn(
             `Skipping non-OPEN PR ${issue.url}: wrapper requires an open PR.`,
@@ -551,9 +643,7 @@ export class StartPreparationUseCase {
         }
         branchName = pr.branchName;
       } else {
-        const relatedPRs = await this.issueRepository.findRelatedOpenPRs(
-          issue.url,
-        );
+        const relatedPRs = branchSource.relatedOpenPullRequests;
         const sameRepoRelatedPRs = relatedPRs.filter((pr) => {
           const match = /^https?:\/\/[^/]+\/([^/]+\/[^/]+)\//.exec(pr.url);
           return match === null || match[1] === issue.nameWithOwner;

package/types/adapter/entry-points/console/consoleOperationApi.d.ts

@@ -3,6 +3,7 @@ import type { IssueAttachmentRepository } from '../../../domain/usecases/adapter
 import type { IssueRepository } from '../../../domain/usecases/adapter-interfaces/IssueRepository';
 import type { ProjectRepository } from '../../../domain/usecases/adapter-interfaces/ProjectRepository';
 export declare const AWAITING_WORKSPACE_STATUS_NAME = "awaiting workspace";
+export declare const CONFLICT_RETURNED_MESSAGE = "Auto Status Check: CONFLICT\nThis pull request has a merge conflict and has been returned to Awaiting Workspace.";
 export declare const IN_TMUX_BY_HUMAN_STATUS_NAME = "in tmux by human";
 export declare const CHORE_LABEL_NAME = "chore";
 export type ConsoleProjectBinding = {

package/types/adapter/entry-points/console/consoleOperationApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consoleOperationApi.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/console/consoleOperationApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consoleOperationApi.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/console/consoleOperationApi.ts"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,17 @@
-import { IssueRepository } from './adapter-interfaces/IssueRepository';
+import { IssueRepository, RelatedPullRequest } from './adapter-interfaces/IssueRepository';
+import { Issue } from '../entities/Issue';
 import { ProjectRepository } from './adapter-interfaces/ProjectRepository';
 import { LocalCommandRunner } from './adapter-interfaces/LocalCommandRunner';
 import { ClaudeTokenUsageRepository } from './adapter-interfaces/ClaudeTokenUsageRepository';
 import { TakeOwnershipSpawnRepository } from './adapter-interfaces/TakeOwnershipSpawnRepository';
 import { ClaudeTokenUsage } from '../entities/ClaudeTokenUsage';
 export declare const DEFAULT_FALLBACK_LLM_MODEL_NAME = "claude-opus-4-8";
+export declare const SPAWN_CANDIDATE_BRANCH_SOURCE_CONCURRENCY = 8;
+export type SpawnCandidateExclusionReason = 'dependedIssueUrls' | 'futureNextActionDate' | 'nextActionHourNotReached' | 'authorNotAllowed' | 'notAssignedToManager';
+export type SpawnCandidateBranchSource = {
+    openPullRequest: RelatedPullRequest | null;
+    relatedOpenPullRequests: RelatedPullRequest[];
+};
 export declare const agentNameFromDesignation: (designation: string) => string;
 export type RotationOrderEntry = {
     name: string;
@@ -29,6 +36,8 @@ export declare class StartPreparationUseCase {
     private compareBySevenDayDeadlineThenUtilization;
     private taperedConcurrentLimit;
     getTokenConcurrentLimit: (fiveHourUtilization: number, sevenDayUtilization: number, selectionWeight?: number) => number;
+    spawnCandidateExclusionReasonOf: (issue: Issue, allowedIssueAuthors: string[] | null, manager: string, now: Date) => SpawnCandidateExclusionReason | null;
+    fetchSpawnCandidateBranchSources: (issueUrls: string[]) => Promise<Map<string, SpawnCandidateBranchSource>>;
     private selectRotationTokens;
     buildRotationOrder: (tokenUsages: ClaudeTokenUsage[], utilizationPercentageThreshold: number, modelName: string | null) => RotationOrderEntry[];
     run: (params: {

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

@@ -1 +1 @@
-{"version":3,"file":"StartPreparationUseCase.d.ts","sourceRoot":"","sources":["../../../src/domain/usecases/StartPreparationUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAchE,eAAO,MAAM,+BAA+B,oBAAoB,CAAC;AAGjE,eAAO,MAAM,wBAAwB,GAAI,aAAa,MAAM,KAAG,MAGvC,CAAC;AAEzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAIlC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAahC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAC3C,OAAO,CAAC,QAAQ,CAAC,4BAA4B;gBAnB5B,iBAAiB,EAAE,IAAI,CACtC,iBAAiB,EACjB,UAAU,GAAG,aAAa,GAAG,iBAAiB,CAC/C,EACgB,eAAe,EAAE,IAAI,CACpC,eAAe,EACb,mBAAmB,GACnB,cAAc,GACd,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,yBAAyB,GACzB,oBAAoB,GACpB,oBAAoB,GACpB,aAAa,CAChB,EACgB,kBAAkB,EAAE,kBAAkB,EACtC,0BAA0B,EAAE,0BAA0B,EACtD,4BAA4B,EAAE,4BAA4B;IAG7E,OAAO,CAAC,uBAAuB,CAK7B;IAEF,OAAO,CAAC,gBAAgB,CAGgC;IAExD,OAAO,CAAC,0BAA0B,CAQhC;IAEF,OAAO,CAAC,mBAAmB,CAqBzB;IAEF,OAAO,CAAC,yBAAyB,CAc/B;IAEF,OAAO,CAAC,wCAAwC,CAqB9C;IAEF,OAAO,CAAC,sBAAsB,CAS5B;IAEF,uBAAuB,GACrB,qBAAqB,MAAM,EAC3B,qBAAqB,MAAM,EAC3B,kBAAkB,MAAM,KACvB,MAAM,CAcP;IAEF,OAAO,CAAC,oBAAoB,CA6E1B;IAEF,kBAAkB,GAChB,aAAa,gBAAgB,EAAE,EAC/B,gCAAgC,MAAM,EACtC,WAAW,MAAM,GAAG,IAAI,KACvB,kBAAkB,EAAE,CAqDrB;IAEF,GAAG,GAAU,QAAQ;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,cAAc,EAAE,MAAM,CAAC;QACvB,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3C,8BAA8B,EAAE,MAAM,CAAC;QACvC,mBAAmB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,oBAAoB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACtC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;KAC1B,KAAG,OAAO,CAAC;QAAE,aAAa,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CA4YzD;CACH"}
+{"version":3,"file":"StartPreparationUseCase.d.ts","sourceRoot":"","sources":["../../../src/domain/usecases/StartPreparationUseCase.ts"],"names":[],"mappings":"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"}