feat: bulk edit tickets

Select several tickets in the backlog and change their status, assignee,
sprint, priority or labels at once. Each ticket goes through the normal
rules and may refuse on its own; the result says which did.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

libs/api/tracker/application/src/lib/commands/bulk-update-issues.ts

@@ -0,0 +1,115 @@
+import {
+  Command,
+  CommandBus,
+  CommandHandler,
+  ICommandHandler,
+} from '@nestjs/cqrs';
+import { assertThat } from '@task-stream/api/shared/domain';
+import { IssuePriority } from '@task-stream/api/tracker/domain';
+import { AssignIssueCommand } from './assign-issue.command';
+import { ChangeIssueStatusCommand } from './change-issue-status.command';
+import { SetIssueReleaseCommand } from './set-issue-release.command';
+import { SetIssueSprintCommand } from './sprint.commands';
+import { UpdateIssueCommand } from './update-issue.command';
+import { WriteAccess } from './write-access';
+
+/** At most this many tickets per bulk change. */
+export const MAX_BULK = 100;
+
+/** What to change on every ticket; absent fields stay as they are. */
+export interface BulkChange {
+  status?: string;
+  /** null unassigns. */
+  assigneeId?: string | null;
+  /** null: back to the backlog. */
+  sprintId?: string | null;
+  /** null: out of its release. */
+  releaseId?: string | null;
+  priority?: IssuePriority;
+  /** Added to the ticket's labels. */
+  addLabels?: string[];
+}
+
+export interface BulkResult {
+  updated: number;
+  results: { issueId: string; ok: boolean; error: string | null }[];
+}
+
+/**
+ * The same change on several tickets. Each ticket goes through the normal
+ * commands (permissions, workflow, open sprints and releases), one after
+ * another; one refusing does not stop the rest.
+ */
+export class BulkUpdateIssuesCommand extends Command<BulkResult> {
+  constructor(
+    public readonly actorId: string,
+    public readonly issueIds: string[],
+    public readonly change: BulkChange,
+  ) {
+    super();
+  }
+}
+
+@CommandHandler(BulkUpdateIssuesCommand)
+export class BulkUpdateIssuesCommandHandler
+  implements ICommandHandler<BulkUpdateIssuesCommand>
+{
+  constructor(
+    private readonly commandBus: CommandBus,
+    private readonly access: WriteAccess,
+  ) {}
+
+  async execute(command: BulkUpdateIssuesCommand): Promise<BulkResult> {
+    const ids = [...new Set(command.issueIds)];
+    assertThat(ids.length > 0, 'Pick at least one ticket');
+    assertThat(ids.length <= MAX_BULK, `At most ${MAX_BULK} tickets at once`);
+    const change = command.change;
+    assertThat(
+      Object.values(change).some((v) => v !== undefined),
+      'Nothing to change',
+    );
+    const actor = command.actorId;
+    const result: BulkResult = { updated: 0, results: [] };
+    for (const issueId of ids) {
+      try {
+        if (change.status !== undefined)
+          await this.run(
+            new ChangeIssueStatusCommand(actor, issueId, change.status),
+          );
+        if (change.assigneeId !== undefined)
+          await this.run(
+            new AssignIssueCommand(actor, issueId, change.assigneeId),
+          );
+        if (change.sprintId !== undefined)
+          await this.run(
+            new SetIssueSprintCommand(actor, issueId, change.sprintId),
+          );
+        if (change.releaseId !== undefined)
+          await this.run(
+            new SetIssueReleaseCommand(actor, issueId, change.releaseId),
+          );
+        const details: { priority?: IssuePriority; labels?: string[] } = {};
+        if (change.priority) details.priority = change.priority;
+        if (change.addLabels?.length) {
+          const issue = await this.access.issue(issueId);
+          details.labels = [...issue.labels, ...change.addLabels];
+        }
+        if (Object.keys(details).length)
+          await this.run(new UpdateIssueCommand(actor, issueId, details));
+        result.updated++;
+        result.results.push({ issueId, ok: true, error: null });
+      } catch (error) {
+        result.results.push({
+          issueId,
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    }
+    return result;
+  }
+
+  private run(command: object): Promise<unknown> {
+    return this.commandBus.execute(command as never);
+  }
+}

libs/api/tracker/application/src/lib/commands/command-handlers.ts

@@ -32,6 +32,7 @@ import { SetIssueParentCommandHandler } from './set-issue-parent.command-handler
 import { RankIssueCommandHandler } from './rank-issue.command-handler';
 import { WriteReleaseNotesCommandHandler } from './write-release-notes.command-handler';
 import { SPRINT_COMMAND_HANDLERS } from './sprint.command-handlers';
+import { BulkUpdateIssuesCommandHandler } from './bulk-update-issues';
 import { DetachFromParentCommandHandler } from './detach-from-parent.command-handler';
 import {
   AddChecklistItemCommandHandler,
@@ -75,6 +76,7 @@ export const COMMAND_HANDLERS = [
   RankIssueCommandHandler,
   WriteReleaseNotesCommandHandler,
   ...SPRINT_COMMAND_HANDLERS,
+  BulkUpdateIssuesCommandHandler,
   AddChecklistItemCommandHandler,
   UpdateChecklistItemCommandHandler,
   RemoveChecklistItemCommandHandler,

libs/api/tracker/application/src/lib/commands/commands.spec.ts

@@ -78,6 +78,7 @@ import { DeleteCommentCommand } from './delete-comment.command';
 import { PublishReleaseCommand } from './publish-release.command';
 import { SetIssueReleaseCommand } from './set-issue-release.command';
 import { WriteAccess } from './write-access';
+import { BulkResult, BulkUpdateIssuesCommand } from './bulk-update-issues';
 import { UpdateProjectSettingsCommand } from './update-project-settings.command';
 import { ReadAccess } from '../queries/read-access';
 import { FindProjectsRepository } from '../ports/find-projects.repository';
@@ -626,6 +627,45 @@ describe('tracker commands (event sourced)', () => {
     );
   });
 
+  it('changes several tickets at once and says which refused', async () => {
+    const { run, rehydrator } = await setup();
+    const projectId = await projectWithTeam(run);
+    const ids: string[] = [];
+    for (const title of ['A', 'B'])
+      ids.push(
+        (
+          await run(
+            new CreateIssueCommand('dev', projectId, IssueType.TASK, title, {}),
+          )
+        ).id,
+      );
+    for (const status of ['TODO', 'IN_PROGRESS'])
+      await run(new ChangeIssueStatusCommand('dev', ids[1], status));
+    // A is in BACKLOG: the workflow does not let it jump to review.
+    const result = (await run(
+      new BulkUpdateIssuesCommand('dev', [...ids, ids[1]], {
+        status: 'IN_REVIEW',
+        assigneeId: 'qa',
+        addLabels: ['sprint-14'],
+      }),
+    )) as unknown as BulkResult;
+
+    expect(result.updated).toBe(1);
+    expect(result.results.map((r) => [r.issueId, r.ok])).toEqual([
+      [ids[0], false],
+      [ids[1], true],
+    ]);
+    const b = await rehydrator.rehydrate(ids[1], Issue);
+    expect([b.status, b.assigneeId, b.labels]).toEqual([
+      'IN_REVIEW',
+      'qa',
+      ['sprint-14'],
+    ]);
+    await expect(
+      run(new BulkUpdateIssuesCommand('dev', ids, {})),
+    ).rejects.toThrow(/Nothing to change/);
+  });
+
   it('does not let viewers modify tickets', async () => {
     const { run } = await setup();
     const projectId = await projectWithTeam(run);

libs/api/tracker/application/src/lib/commands/index.ts

@@ -35,3 +35,4 @@ export * from './change-checklist.command';
 export * from './rank-issue.command';
 export * from './sprint.commands';
 export * from './write-release-notes.command';
+export * from './bulk-update-issues';