github-issue-tower-defence-management 2.19.1 → 2.19.3

package/src/domain/usecases/dashboard/ComposeDashboardUseCase.ts

@@ -1,318 +0,0 @@
-import { DashboardRow } from './GenerateDashboardRowUseCase';
-import {
-  SevenDayWindowAggregate,
-  TokenStatus,
-  TokenStatusColor,
-} from './GenerateTokenStatusUseCase';
-
-export const PROJECT_ROW_WIDTH_BUDGET = 32;
-
-export type ComposeDashboardProject = {
-  code: string;
-  row: DashboardRow | null;
-};
-
-export type ComposeDashboardDisk = {
-  title: string;
-  pct: number;
-};
-
-export type ComposeDashboardMachineStatus = {
-  memPct: number | null;
-  cpuPct: number | null;
-  diskPct: number | null;
-  disks?: ComposeDashboardDisk[] | null;
-  load: [number, number, number] | null;
-  cycleMinutes: number | null;
-};
-
-export type ComposeDashboardInput = {
-  projects: ComposeDashboardProject[];
-  machineStatus: ComposeDashboardMachineStatus | null;
-  tokens: TokenStatus[];
-  sevenDayWindowAggregate?: SevenDayWindowAggregate | null;
-};
-
-type ProjectColumn = {
-  header: string;
-  key: keyof DashboardRow;
-};
-
-const PROJECT_COLUMNS: ProjectColumn[] = [
-  { header: 'tdo', key: 'todo' },
-  { header: 'aqc', key: 'qc' },
-  { header: 'fal', key: 'fail' },
-  { header: 'prp', key: 'pr' },
-  { header: 'aws', key: 'ws' },
-  { header: 'dep', key: 'dep' },
-];
-
-const PROJECT_COLUMN_WIDTH = 3;
-
-export const STATUS_DOT_DISPLAY_WIDTH = 2;
-
-const SEVERITY_BLANK = ' '.repeat(STATUS_DOT_DISPLAY_WIDTH);
-
-const TOKEN_NAME_WIDTH = 4;
-
-export const TOKEN_UTILIZATION_WIDTH = 4;
-
-const TOKEN_RESET_WIDTH = 7;
-
-const TOKEN_SEGMENT_SEPARATOR = ' ';
-
-const TOKEN_COLOR_DOT: Record<TokenStatusColor, string> = {
-  G: '🟢',
-  Y: '🟡',
-  K: '⚪',
-  R: '🔴',
-};
-
-const padEnd = (value: string, width: number, fill: string): string => {
-  let result = value;
-  while (result.length < width) {
-    result = result + fill;
-  }
-  return result;
-};
-
-const padStart = (value: string, width: number): string => {
-  let result = value;
-  while (result.length < width) {
-    result = ' ' + result;
-  }
-  return result;
-};
-
-const padStartZero = (value: string, width: number): string => {
-  let result = value;
-  while (result.length < width) {
-    result = '0' + result;
-  }
-  return result;
-};
-
-export const roundHalfToEven = (value: number): number => {
-  const floor = Math.floor(value);
-  const difference = value - floor;
-  if (difference < 0.5) {
-    return floor;
-  }
-  if (difference > 0.5) {
-    return floor + 1;
-  }
-  return floor % 2 === 0 ? floor : floor + 1;
-};
-
-export const formatResetCountdown = (totalSeconds: number): string => {
-  if (totalSeconds < 0) {
-    return '0d00h00';
-  }
-  const whole = Math.trunc(totalSeconds);
-  const days = Math.trunc(whole / 86400);
-  const afterDays = whole % 86400;
-  const hours = Math.trunc(afterDays / 3600);
-  const minutes = Math.trunc((afterDays % 3600) / 60);
-  return `${days}d${padStartZero(String(hours), 2)}h${padStartZero(
-    String(minutes),
-    2,
-  )}`;
-};
-
-const packTokensWithinBudget = (tokens: string[]): string[] => {
-  const lines: string[] = [];
-  let current = '';
-  for (const token of tokens) {
-    const candidate = current === '' ? token : `${current} ${token}`;
-    if (current !== '' && candidate.length > PROJECT_ROW_WIDTH_BUDGET) {
-      lines.push(current);
-      current = token;
-    } else {
-      current = candidate;
-    }
-  }
-  if (current !== '') {
-    lines.push(current);
-  }
-  return lines;
-};
-
-export const formatMachineStatusLines = (
-  machineStatus: ComposeDashboardMachineStatus | null,
-): string[] => {
-  const memText =
-    machineStatus !== null && machineStatus.memPct !== null
-      ? `${machineStatus.memPct}%`
-      : '?%';
-  const cpuText =
-    machineStatus !== null && machineStatus.cpuPct !== null
-      ? `${machineStatus.cpuPct}%`
-      : '?%';
-  const diskText =
-    machineStatus !== null && machineStatus.diskPct !== null
-      ? `${machineStatus.diskPct}%`
-      : '?%';
-  const load = machineStatus !== null ? machineStatus.load : null;
-  const oneMinute = load === null ? '?' : String(roundHalfToEven(load[0]));
-  const fiveMinute = load === null ? '?' : String(roundHalfToEven(load[1]));
-  const fifteenMinute = load === null ? '?' : String(roundHalfToEven(load[2]));
-  const cycle =
-    machineStatus !== null && machineStatus.cycleMinutes !== null
-      ? `cy${machineStatus.cycleMinutes}`
-      : 'cy-';
-  const loadLine = `LA ${oneMinute} ${fiveMinute} ${fifteenMinute}`;
-  const disks =
-    machineStatus !== null && machineStatus.disks ? machineStatus.disks : null;
-  if (disks !== null && disks.length > 0) {
-    const diskTokens = disks.map((disk) => `${disk.title}${disk.pct}%`);
-    const diskLines = packTokensWithinBudget(diskTokens);
-    return [`M${memText} C${cpuText} ${cycle}`, ...diskLines, loadLine];
-  }
-  return [`M${memText} C${cpuText} D${diskText} ${cycle}`, loadLine];
-};
-
-const capThreeDigits = (value: number): string =>
-  value > 999 ? '999' : String(value);
-
-export const formatProjectHeaderLine = (): string => {
-  const head = padEnd('pj', 4, ' ');
-  const columns = PROJECT_COLUMNS.map(
-    (column) => ' ' + padStart(column.header, PROJECT_COLUMN_WIDTH),
-  ).join('');
-  return head + columns;
-};
-
-const severityDot = (row: DashboardRow): string => {
-  if (row.blocker >= 2) {
-    return '🔴';
-  }
-  if (row.blocker === 1) {
-    return '🟣';
-  }
-  if (row.qc >= 15 || row.fail >= 5) {
-    return '🟠';
-  }
-  if (row.qc >= 10 || row.fail >= 3) {
-    return '🟡';
-  }
-  return '🟢';
-};
-
-export const formatProjectRowLine = (
-  project: ComposeDashboardProject,
-): string => {
-  const mark = project.row === null ? SEVERITY_BLANK : severityDot(project.row);
-  const cells = PROJECT_COLUMNS.map((column) => {
-    const cell =
-      project.row === null ? '--' : capThreeDigits(project.row[column.key]);
-    return ' ' + padStart(cell, PROJECT_COLUMN_WIDTH);
-  }).join('');
-  return mark + padEnd(project.code, 2, ' ') + cells;
-};
-
-const formatUtilization = (percent: number | null): string =>
-  padStart(percent === null ? '?' : `${percent}%`, TOKEN_UTILIZATION_WIDTH);
-
-const formatReset = (resetSeconds: number | null): string =>
-  resetSeconds === null ? '?' : formatResetCountdown(resetSeconds);
-
-const tokenSortKey = (token: TokenStatus): [number, number] =>
-  token.sevenDayResetSeconds === null
-    ? [1, 0]
-    : [0, token.sevenDayResetSeconds];
-
-const sortTokens = (tokens: TokenStatus[]): TokenStatus[] =>
-  tokens
-    .map((token, index) => ({ token, index }))
-    .sort((left, right) => {
-      const leftKey = tokenSortKey(left.token);
-      const rightKey = tokenSortKey(right.token);
-      if (leftKey[0] !== rightKey[0]) {
-        return leftKey[0] - rightKey[0];
-      }
-      if (leftKey[1] !== rightKey[1]) {
-        return leftKey[1] - rightKey[1];
-      }
-      return left.index - right.index;
-    })
-    .map((entry) => entry.token);
-
-const joinTokenRowSegments = (segments: string[]): string =>
-  segments.join(TOKEN_SEGMENT_SEPARATOR);
-
-export const SEVEN_DAY_UTILIZATION_COLUMN_START =
-  STATUS_DOT_DISPLAY_WIDTH +
-  TOKEN_NAME_WIDTH +
-  TOKEN_SEGMENT_SEPARATOR.length +
-  TOKEN_UTILIZATION_WIDTH +
-  TOKEN_SEGMENT_SEPARATOR.length +
-  TOKEN_RESET_WIDTH +
-  TOKEN_SEGMENT_SEPARATOR.length;
-
-export const formatSevenDayWindowAggregateLine = (
-  aggregate: SevenDayWindowAggregate | null,
-): string | null => {
-  if (aggregate === null) {
-    return null;
-  }
-  const usedPercent = roundHalfToEven(aggregate.usedPercent);
-  const includedCountSuffix =
-    aggregate.includedTokenCount === aggregate.totalTokenCount
-      ? ''
-      : ` (${aggregate.includedTokenCount})`;
-  return (
-    padEnd('', SEVEN_DAY_UTILIZATION_COLUMN_START, ' ') +
-    formatUtilization(usedPercent) +
-    includedCountSuffix
-  );
-};
-
-export const formatTokenRowLine = (token: TokenStatus): string => {
-  const dot = TOKEN_COLOR_DOT[token.color];
-  const name = padEnd(token.name, TOKEN_NAME_WIDTH, '_');
-  const fiveHourUtilization = formatUtilization(
-    token.fiveHourUtilizationPercent,
-  );
-  const fiveHourReset = formatReset(token.fiveHourResetSeconds);
-  const sevenDayUtilization = formatUtilization(
-    token.sevenDayUtilizationPercent,
-  );
-  const sevenDayReset = formatReset(token.sevenDayResetSeconds);
-  const prep = String(token.prep);
-  const hum = String(token.hum);
-  return joinTokenRowSegments([
-    `${dot}${name}`,
-    fiveHourUtilization,
-    fiveHourReset,
-    sevenDayUtilization,
-    sevenDayReset,
-    prep,
-    hum,
-  ]);
-};
-
-const wrapLine = (line: string): string =>
-  `<tt>${line.replace(/ /g, '&nbsp;')}</tt><br>`;
-
-export class ComposeDashboardUseCase {
-  run = (input: ComposeDashboardInput): string => {
-    const statsLines = formatMachineStatusLines(input.machineStatus);
-    const projectLines = [
-      formatProjectHeaderLine(),
-      ...input.projects.map((project) => formatProjectRowLine(project)),
-    ];
-    const tokenLines = sortTokens(input.tokens).map((token) =>
-      formatTokenRowLine(token),
-    );
-    const aggregateLine = formatSevenDayWindowAggregateLine(
-      input.sevenDayWindowAggregate ?? null,
-    );
-    const lines = [
-      ...statsLines,
-      ...projectLines,
-      aggregateLine === null ? '' : aggregateLine,
-      ...tokenLines,
-    ];
-    return lines.map((line) => wrapLine(line)).join('\n') + '\n';
-  };
-}

package/src/domain/usecases/dashboard/DashboardProjectCode.test.ts

@@ -1,34 +0,0 @@
-import {
-  DASHBOARD_DISPLAY_LABEL_LENGTH,
-  assertDashboardDisplayLabelsUnique,
-  toDashboardDisplayLabel,
-} from './DashboardProjectCode';
-
-describe('DashboardProjectCode', () => {
-  it('derives the display label from the leading characters of the project name', () => {
-    expect(DASHBOARD_DISPLAY_LABEL_LENGTH).toBe(2);
-    expect(toDashboardDisplayLabel('acme')).toBe('ac');
-    expect(toDashboardDisplayLabel('globex')).toBe('gl');
-    expect(toDashboardDisplayLabel('initech')).toBe('in');
-  });
-
-  it('throws for a project name shorter than the display label rather than padding it', () => {
-    expect(() => toDashboardDisplayLabel('a')).toThrow(
-      'Dashboard project name is shorter than the 2-character display label: a',
-    );
-  });
-
-  it('accepts project names whose derived display labels are all distinct', () => {
-    expect(() =>
-      assertDashboardDisplayLabelsUnique(['acme', 'globex', 'initech']),
-    ).not.toThrow();
-  });
-
-  it('throws when two project names derive the same display label', () => {
-    expect(() =>
-      assertDashboardDisplayLabelsUnique(['acme', 'acmelabs']),
-    ).toThrow(
-      'Dashboard project names acme and acmelabs share the display label ac',
-    );
-  });
-});

package/src/domain/usecases/dashboard/DashboardProjectCode.ts

@@ -1,27 +0,0 @@
-export const DASHBOARD_DISPLAY_LABEL_LENGTH = 2;
-
-export const toDashboardDisplayLabel = (projectName: string): string => {
-  if (projectName.length < DASHBOARD_DISPLAY_LABEL_LENGTH) {
-    throw new Error(
-      `Dashboard project name is shorter than the ${DASHBOARD_DISPLAY_LABEL_LENGTH}-character display label: ${projectName}`,
-    );
-  }
-  return projectName.slice(0, DASHBOARD_DISPLAY_LABEL_LENGTH);
-};
-
-export const assertDashboardDisplayLabelsUnique = (
-  projectNames: string[],
-): void => {
-  const projectNameByDisplayLabel = new Map<string, string>();
-  for (const projectName of projectNames) {
-    const displayLabel = toDashboardDisplayLabel(projectName);
-    const alreadyRegistered =
-      projectNameByDisplayLabel.get(displayLabel) ?? null;
-    if (alreadyRegistered !== null) {
-      throw new Error(
-        `Dashboard project names ${alreadyRegistered} and ${projectName} share the display label ${displayLabel}`,
-      );
-    }
-    projectNameByDisplayLabel.set(displayLabel, projectName);
-  }
-};

package/src/domain/usecases/dashboard/GenerateDashboardRowUseCase.test.ts

@@ -1,160 +0,0 @@
-import { Issue } from '../../entities/Issue';
-import { GenerateDashboardRowUseCase } from './GenerateDashboardRowUseCase';
-
-const ASSIGNEE = 'HiromiShikata';
-
-let issueCounter = 0;
-const makeIssue = (overrides: Partial<Issue>): Issue => {
-  issueCounter += 1;
-  return {
-    nameWithOwner: 'demo/repo',
-    number: issueCounter,
-    title: `Issue ${issueCounter}`,
-    state: 'OPEN',
-    status: null,
-    story: null,
-    nextActionDate: null,
-    nextActionHour: null,
-    estimationMinutes: null,
-    dependedIssueUrls: [],
-    completionDate50PercentConfidence: null,
-    url: `https://github.com/demo/repo/issues/${issueCounter}`,
-    assignees: [ASSIGNEE],
-    labels: [],
-    org: 'demo',
-    repo: 'repo',
-    body: '',
-    itemId: `item-${issueCounter}`,
-    isPr: false,
-    isInProgress: false,
-    isClosed: false,
-    createdAt: new Date('2026-06-13T08:18:45.000Z'),
-    author: 'someone',
-    closingIssueReferenceUrls: [],
-    agent: null,
-    stateReason: null,
-    ...overrides,
-  };
-};
-
-describe('GenerateDashboardRowUseCase', () => {
-  const usecase = new GenerateDashboardRowUseCase();
-
-  beforeEach(() => {
-    issueCounter = 0;
-  });
-
-  it('returns all-zero counts for an empty issue list', () => {
-    expect(usecase.run({ issues: [], assigneeLogin: ASSIGNEE })).toEqual({
-      todo: 0,
-      qc: 0,
-      fail: 0,
-      pr: 0,
-      ws: 0,
-      dep: 0,
-      blocker: 0,
-    });
-  });
-
-  it('counts actionable Todo, Awaiting Quality Check and Awaiting Workspace issues', () => {
-    const issues = [
-      makeIssue({ status: 'Todo by human' }),
-      makeIssue({ status: 'Awaiting Quality Check' }),
-      makeIssue({ status: 'Awaiting Workspace' }),
-    ];
-
-    expect(usecase.run({ issues, assigneeLogin: ASSIGNEE })).toEqual({
-      todo: 1,
-      qc: 1,
-      fail: 0,
-      pr: 0,
-      ws: 1,
-      dep: 0,
-      blocker: 0,
-    });
-  });
-
-  it('excludes non-actionable issues from actionable status columns', () => {
-    const issues = [
-      makeIssue({
-        status: 'Awaiting Quality Check',
-        dependedIssueUrls: ['https://github.com/demo/repo/issues/999'],
-      }),
-      makeIssue({ status: 'Todo by human', assignees: ['someone-else'] }),
-      makeIssue({ status: 'Awaiting Workspace', isClosed: true }),
-    ];
-
-    expect(usecase.run({ issues, assigneeLogin: ASSIGNEE })).toEqual({
-      todo: 0,
-      qc: 0,
-      fail: 0,
-      pr: 0,
-      ws: 0,
-      dep: 0,
-      blocker: 0,
-    });
-  });
-
-  it('counts Preparation and Failed Preparation by whole status without the actionable predicate', () => {
-    const issues = [
-      makeIssue({ status: 'Preparation', nextActionHour: 9 }),
-      makeIssue({
-        status: 'Failed Preparation',
-        dependedIssueUrls: ['https://github.com/demo/repo/issues/999'],
-      }),
-      makeIssue({ status: 'Preparation', isClosed: true }),
-      makeIssue({ status: 'Failed Preparation', assignees: ['someone-else'] }),
-    ];
-
-    expect(usecase.run({ issues, assigneeLogin: ASSIGNEE })).toEqual({
-      todo: 0,
-      qc: 0,
-      fail: 1,
-      pr: 1,
-      ws: 0,
-      dep: 0,
-      blocker: 0,
-    });
-  });
-
-  it('counts dep as Awaiting Workspace issues blocked by a dependency, and never as ws', () => {
-    const issues = [
-      makeIssue({ status: 'Awaiting Workspace' }),
-      makeIssue({
-        status: 'Awaiting Workspace',
-        dependedIssueUrls: ['https://github.com/demo/repo/issues/999'],
-      }),
-    ];
-
-    expect(usecase.run({ issues, assigneeLogin: ASSIGNEE })).toMatchObject({
-      ws: 1,
-      dep: 1,
-    });
-  });
-
-  it('counts blocker by case-insensitive workflow blocker story membership for non-closed mine issues', () => {
-    const issues = [
-      makeIssue({
-        status: 'Awaiting Workspace',
-        story: 'Workflow Blocker / urgent',
-      }),
-      makeIssue({ status: 'Awaiting Workspace', story: 'workflow blocker' }),
-      makeIssue({
-        status: 'Awaiting Workspace',
-        story: 'regular / maintenance',
-      }),
-      makeIssue({
-        status: 'Awaiting Workspace',
-        story: 'workflow blocker',
-        isClosed: true,
-      }),
-      makeIssue({
-        status: 'Awaiting Workspace',
-        story: 'workflow blocker',
-        assignees: ['someone-else'],
-      }),
-    ];
-
-    expect(usecase.run({ issues, assigneeLogin: ASSIGNEE }).blocker).toBe(2);
-  });
-});

package/src/domain/usecases/dashboard/GenerateDashboardRowUseCase.ts

@@ -1,69 +0,0 @@
-import { Issue } from '../../entities/Issue';
-import {
-  AWAITING_QUALITY_CHECK_STATUS_NAME,
-  AWAITING_WORKSPACE_STATUS_NAME,
-  FAILED_PREPARATION_STATUS_NAME,
-  PREPARATION_STATUS_NAME,
-  TODO_STATUS_NAME,
-} from '../../entities/WorkflowStatus';
-
-export type DashboardRow = {
-  todo: number;
-  qc: number;
-  fail: number;
-  pr: number;
-  ws: number;
-  dep: number;
-  blocker: number;
-};
-
-export type GenerateDashboardRowInput = {
-  issues: Issue[];
-  assigneeLogin: string;
-};
-
-const WORKFLOW_BLOCKER_STORY_MARKER = 'workflow blocker';
-
-export class GenerateDashboardRowUseCase {
-  run = (input: GenerateDashboardRowInput): DashboardRow => {
-    const { issues, assigneeLogin } = input;
-
-    const mine = (issue: Issue): boolean =>
-      issue.isClosed === false && issue.assignees.includes(assigneeLogin);
-
-    const actionable = (issue: Issue): boolean =>
-      mine(issue) &&
-      issue.dependedIssueUrls.length === 0 &&
-      issue.nextActionDate === null &&
-      issue.nextActionHour === null;
-
-    const countActionableWithStatus = (statusName: string): number =>
-      issues.filter((issue) => issue.status === statusName && actionable(issue))
-        .length;
-
-    const countMineWithStatus = (statusName: string): number =>
-      issues.filter((issue) => mine(issue) && issue.status === statusName)
-        .length;
-
-    return {
-      todo: countActionableWithStatus(TODO_STATUS_NAME),
-      qc: countActionableWithStatus(AWAITING_QUALITY_CHECK_STATUS_NAME),
-      fail: countMineWithStatus(FAILED_PREPARATION_STATUS_NAME),
-      pr: countMineWithStatus(PREPARATION_STATUS_NAME),
-      ws: countActionableWithStatus(AWAITING_WORKSPACE_STATUS_NAME),
-      dep: issues.filter(
-        (issue) =>
-          mine(issue) &&
-          issue.status === AWAITING_WORKSPACE_STATUS_NAME &&
-          issue.dependedIssueUrls.length > 0,
-      ).length,
-      blocker: issues.filter(
-        (issue) =>
-          mine(issue) &&
-          (issue.story ?? '')
-            .toLowerCase()
-            .includes(WORKFLOW_BLOCKER_STORY_MARKER),
-      ).length,
-    };
-  };
-}