github-issue-tower-defence-management 2.19.0 → 2.19.2

package/src/adapter/entry-points/console/dashboardComposeService.ts

@@ -1,256 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import {
-  ComposeDashboardDisk,
-  ComposeDashboardInput,
-  ComposeDashboardMachineStatus,
-  ComposeDashboardProject,
-  ComposeDashboardUseCase,
-} from '../../../domain/usecases/dashboard/ComposeDashboardUseCase';
-import { toDashboardDisplayLabel } from '../../../domain/usecases/dashboard/DashboardProjectCode';
-import { DashboardRow } from '../../../domain/usecases/dashboard/GenerateDashboardRowUseCase';
-import {
-  SevenDayWindowAggregate,
-  TokenStatus,
-  TokenStatusColor,
-} from '../../../domain/usecases/dashboard/GenerateTokenStatusUseCase';
-
-export type DashboardComposeOptions = {
-  dashboardDataDir: string;
-  projectNames: string[];
-};
-
-const isRecord = (value: unknown): value is Record<string, unknown> =>
-  value !== null && typeof value === 'object' && !Array.isArray(value);
-
-const readJsonFile = (filePath: string): unknown => {
-  let raw: string;
-  try {
-    raw = fs.readFileSync(filePath, 'utf8');
-  } catch {
-    return null;
-  }
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-};
-
-const asFiniteNumber = (value: unknown): number | null =>
-  typeof value === 'number' && Number.isFinite(value) ? value : null;
-
-const parseDashboardRow = (value: unknown): DashboardRow | null => {
-  if (!isRecord(value)) {
-    return null;
-  }
-  const todo = asFiniteNumber(value.todo);
-  const qc = asFiniteNumber(value.qc);
-  const fail = asFiniteNumber(value.fail);
-  const pr = asFiniteNumber(value.pr);
-  const ws = asFiniteNumber(value.ws);
-  const dep = asFiniteNumber(value.dep);
-  const blocker = asFiniteNumber(value.blocker);
-  if (
-    todo === null ||
-    qc === null ||
-    fail === null ||
-    pr === null ||
-    ws === null ||
-    dep === null ||
-    blocker === null
-  ) {
-    return null;
-  }
-  return { todo, qc, fail, pr, ws, dep, blocker };
-};
-
-const readProjectRow = (
-  dashboardDataDir: string,
-  projectName: string,
-): DashboardRow | null =>
-  parseDashboardRow(
-    readJsonFile(
-      path.join(dashboardDataDir, 'projects', `${projectName}.json`),
-    ),
-  );
-
-const parseLoad = (value: unknown): [number, number, number] | null => {
-  if (!Array.isArray(value) || value.length !== 3) {
-    return null;
-  }
-  const oneMinute = asFiniteNumber(value[0]);
-  const fiveMinute = asFiniteNumber(value[1]);
-  const fifteenMinute = asFiniteNumber(value[2]);
-  if (oneMinute === null || fiveMinute === null || fifteenMinute === null) {
-    return null;
-  }
-  return [oneMinute, fiveMinute, fifteenMinute];
-};
-
-const parseDisks = (value: unknown): ComposeDashboardDisk[] | null => {
-  if (!Array.isArray(value)) {
-    return null;
-  }
-  const disks: ComposeDashboardDisk[] = [];
-  for (const entry of value) {
-    if (!isRecord(entry) || typeof entry.title !== 'string') {
-      return null;
-    }
-    const pct = asFiniteNumber(entry.pct);
-    if (pct === null) {
-      return null;
-    }
-    disks.push({ title: entry.title, pct });
-  }
-  return disks;
-};
-
-const readMachineStatus = (
-  dashboardDataDir: string,
-): ComposeDashboardMachineStatus | null => {
-  const value = readJsonFile(
-    path.join(dashboardDataDir, 'machine-status.json'),
-  );
-  if (!isRecord(value)) {
-    return null;
-  }
-  const cycleMinutesRaw = value.cycleMinutes;
-  const cycleMinutes =
-    cycleMinutesRaw === null ? null : asFiniteNumber(cycleMinutesRaw);
-  return {
-    memPct: asFiniteNumber(value.memPct),
-    cpuPct: asFiniteNumber(value.cpuPct),
-    diskPct: asFiniteNumber(value.diskPct),
-    disks: parseDisks(value.disks),
-    load: parseLoad(value.load),
-    cycleMinutes,
-  };
-};
-
-const isTokenColor = (value: unknown): value is TokenStatusColor =>
-  value === 'G' || value === 'Y' || value === 'K' || value === 'R';
-
-const asTokenColor = (value: unknown): TokenStatusColor =>
-  isTokenColor(value) ? value : 'Y';
-
-const asNullableNumber = (value: unknown): number | null =>
-  value === null ? null : asFiniteNumber(value);
-
-const asCount = (value: unknown): number => {
-  const number = asFiniteNumber(value);
-  return number === null ? 0 : number;
-};
-
-const parseTokenStatus = (value: unknown): TokenStatus | null => {
-  if (!isRecord(value) || typeof value.name !== 'string') {
-    return null;
-  }
-  return {
-    name: value.name,
-    fiveHourUtilizationPercent: asNullableNumber(
-      value.fiveHourUtilizationPercent,
-    ),
-    fiveHourResetSeconds: asNullableNumber(value.fiveHourResetSeconds),
-    sevenDayUtilizationPercent: asNullableNumber(
-      value.sevenDayUtilizationPercent,
-    ),
-    sevenDayResetSeconds: asNullableNumber(value.sevenDayResetSeconds),
-    color: asTokenColor(value.color),
-    prep: asCount(value.prep),
-    hum: asCount(value.hum),
-  };
-};
-
-const parseSevenDayWindowAggregate = (
-  value: unknown,
-): SevenDayWindowAggregate | null => {
-  if (!isRecord(value)) {
-    return null;
-  }
-  const usedPercent = asFiniteNumber(value.usedPercent);
-  const includedTokenCount = asFiniteNumber(value.includedTokenCount);
-  const totalTokenCount = asFiniteNumber(value.totalTokenCount);
-  if (
-    usedPercent === null ||
-    includedTokenCount === null ||
-    totalTokenCount === null
-  ) {
-    return null;
-  }
-  return { usedPercent, includedTokenCount, totalTokenCount };
-};
-
-type TokenStatusFileContent = {
-  tokens: TokenStatus[];
-  sevenDayWindowAggregate: SevenDayWindowAggregate | null;
-};
-
-const readTokenStatusFile = (
-  dashboardDataDir: string,
-): TokenStatusFileContent => {
-  const value = readJsonFile(path.join(dashboardDataDir, 'token-status.json'));
-  if (!isRecord(value) || !Array.isArray(value.tokens)) {
-    return { tokens: [], sevenDayWindowAggregate: null };
-  }
-  const tokens: TokenStatus[] = [];
-  for (const entry of value.tokens) {
-    const token = parseTokenStatus(entry);
-    if (token !== null) {
-      tokens.push(token);
-    }
-  }
-  return {
-    tokens,
-    sevenDayWindowAggregate: parseSevenDayWindowAggregate(
-      value.sevenDayWindowAggregate,
-    ),
-  };
-};
-
-export const buildComposeDashboardInput = (
-  options: DashboardComposeOptions,
-): ComposeDashboardInput => {
-  const projects: ComposeDashboardProject[] = options.projectNames.map(
-    (projectName) => ({
-      code: toDashboardDisplayLabel(projectName),
-      row: readProjectRow(options.dashboardDataDir, projectName),
-    }),
-  );
-  const tokenStatusFile = readTokenStatusFile(options.dashboardDataDir);
-  return {
-    projects,
-    machineStatus: readMachineStatus(options.dashboardDataDir),
-    tokens: tokenStatusFile.tokens,
-    sevenDayWindowAggregate: tokenStatusFile.sevenDayWindowAggregate,
-  };
-};
-
-const isExistingFile = (filePath: string): boolean => {
-  try {
-    return fs.statSync(filePath).isFile();
-  } catch {
-    return false;
-  }
-};
-
-export const dashboardComposeFilesPresent = (
-  options: DashboardComposeOptions,
-): boolean => {
-  if (options.projectNames.length === 0) {
-    return false;
-  }
-  const requiredFiles = [
-    path.join(options.dashboardDataDir, 'machine-status.json'),
-    path.join(options.dashboardDataDir, 'token-status.json'),
-    ...options.projectNames.map((projectName) =>
-      path.join(options.dashboardDataDir, 'projects', `${projectName}.json`),
-    ),
-  ];
-  return requiredFiles.every((filePath) => isExistingFile(filePath));
-};
-
-export const composeDashboardText = (
-  options: DashboardComposeOptions,
-): string =>
-  new ComposeDashboardUseCase().run(buildComposeDashboardInput(options));

package/src/adapter/entry-points/console/dashboardEmitterComposerKey.test.ts

@@ -1,180 +0,0 @@
-import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-import { Issue } from '../../../domain/entities/Issue';
-import { toDashboardDisplayLabel } from '../../../domain/usecases/dashboard/DashboardProjectCode';
-import { writeDashboardRow } from '../handlers/dashboardRowWriter';
-import {
-  composeDashboardText,
-  dashboardComposeFilesPresent,
-} from './dashboardComposeService';
-
-const ASSIGNEE = 'HiromiShikata';
-
-const CONFIGURED_PROJECT_NAMES = [
-  'acme',
-  'globex',
-  'initech',
-  'umbrella',
-  'soylent',
-];
-
-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('dashboard emitter filename matches composer lookup key', () => {
-  let dir: string;
-
-  beforeEach(() => {
-    issueCounter = 0;
-    dir = fs.mkdtempSync(path.join(os.tmpdir(), 'dashboard-key-'));
-  });
-
-  afterEach(() => {
-    fs.rmSync(dir, { recursive: true, force: true });
-  });
-
-  it.each(CONFIGURED_PROJECT_NAMES)(
-    'emits projects/%s.json under the full project name the composer reads',
-    (projectName) => {
-      writeDashboardRow({
-        dashboardDataDir: dir,
-        pjcode: projectName,
-        assigneeLogin: ASSIGNEE,
-        issues: [makeIssue({ status: 'Awaiting Workspace' })],
-        generatedAt: '2026-06-26T12:00:00.000Z',
-      });
-
-      const composerLookupPath = path.join(
-        dir,
-        'projects',
-        `${projectName}.json`,
-      );
-      expect(fs.existsSync(composerLookupPath)).toBe(true);
-    },
-  );
-
-  it('detects compose files present when every project name file exists', () => {
-    for (const projectName of CONFIGURED_PROJECT_NAMES) {
-      writeDashboardRow({
-        dashboardDataDir: dir,
-        pjcode: projectName,
-        assigneeLogin: ASSIGNEE,
-        issues: [makeIssue({ status: 'Awaiting Workspace' })],
-        generatedAt: '2026-06-26T12:00:00.000Z',
-      });
-    }
-    fs.writeFileSync(
-      path.join(dir, 'machine-status.json'),
-      JSON.stringify({
-        memPct: 1,
-        cpuPct: 2,
-        diskPct: 3,
-        load: [0, 0, 0],
-        cycleMinutes: 1,
-      }),
-    );
-    fs.writeFileSync(
-      path.join(dir, 'token-status.json'),
-      JSON.stringify({ tokens: [] }),
-    );
-
-    expect(
-      dashboardComposeFilesPresent({
-        dashboardDataDir: dir,
-        projectNames: CONFIGURED_PROJECT_NAMES,
-      }),
-    ).toBe(true);
-  });
-
-  it('composes the full grid with no fallback row and shows the 2-char display labels', () => {
-    const issuesByName: Record<string, Issue[]> = {
-      acme: [
-        makeIssue({ status: 'Failed Preparation' }),
-        makeIssue({ status: 'Failed Preparation' }),
-      ],
-      globex: [makeIssue({ status: 'Awaiting Quality Check' })],
-      initech: [makeIssue({ status: 'Awaiting Workspace' })],
-      umbrella: [makeIssue({ status: 'Todo by human' })],
-      soylent: [makeIssue({ status: 'Preparation' })],
-    };
-    for (const projectName of CONFIGURED_PROJECT_NAMES) {
-      writeDashboardRow({
-        dashboardDataDir: dir,
-        pjcode: projectName,
-        assigneeLogin: ASSIGNEE,
-        issues: issuesByName[projectName],
-        generatedAt: '2026-06-26T12:00:00.000Z',
-      });
-    }
-    fs.writeFileSync(
-      path.join(dir, 'machine-status.json'),
-      JSON.stringify({
-        memPct: 55,
-        cpuPct: 62,
-        diskPct: 93,
-        load: [16, 23, 40],
-        cycleMinutes: 13,
-      }),
-    );
-    fs.writeFileSync(
-      path.join(dir, 'token-status.json'),
-      JSON.stringify({ tokens: [] }),
-    );
-
-    const composed = composeDashboardText({
-      dashboardDataDir: dir,
-      projectNames: CONFIGURED_PROJECT_NAMES,
-    });
-
-    const wrap = (line: string): string =>
-      `<tt>${line.replace(/ /g, '&nbsp;')}</tt><br>`;
-    const expected =
-      [
-        wrap('M55% C62% D93% cy13'),
-        wrap('LA 16 23 40'),
-        wrap('pj   tdo aqc fal prp aws dep'),
-        wrap(`🟢${toDashboardDisplayLabel('acme')}   0   0   2   0   0   0`),
-        wrap(`🟢${toDashboardDisplayLabel('globex')}   0   1   0   0   0   0`),
-        wrap(`🟢${toDashboardDisplayLabel('initech')}   0   0   0   0   1   0`),
-        wrap(
-          `🟢${toDashboardDisplayLabel('umbrella')}   1   0   0   0   0   0`,
-        ),
-        wrap(`🟢${toDashboardDisplayLabel('soylent')}   0   0   0   1   0   0`),
-        wrap(''),
-      ].join('\n') + '\n';
-    expect(composed).toBe(expected);
-    expect(composed).not.toContain('--');
-  });
-});

package/src/adapter/entry-points/console/ensureConsoleRunning.test.ts

@@ -1,115 +0,0 @@
-import * as net from 'net';
-
-const spawnCalls: unknown[][] = [];
-const killMock = jest.fn();
-const unrefMock = jest.fn();
-const spawnReturnValue = { unref: unrefMock, kill: killMock };
-
-jest.mock('child_process', () => ({
-  spawn: (...args: unknown[]): { unref: jest.Mock; kill: jest.Mock } => {
-    spawnCalls.push(args);
-    return spawnReturnValue;
-  },
-}));
-
-import { ensureConsoleRunning } from './ensureConsoleRunning';
-
-describe('ensureConsoleRunning', () => {
-  let server: net.Server | null = null;
-
-  const startProbeServer = (): Promise<number> =>
-    new Promise((resolve) => {
-      server = net.createServer((socket) => socket.end());
-      server.listen(0, '127.0.0.1', () => {
-        const address = server?.address();
-        const portValue =
-          address !== null && typeof address === 'object' ? address.port : 0;
-        resolve(portValue);
-      });
-    });
-
-  const findFreePort = (): Promise<number> =>
-    new Promise((resolve) => {
-      const probe = net.createServer();
-      probe.listen(0, '127.0.0.1', () => {
-        const address = probe.address();
-        const portValue =
-          address !== null && typeof address === 'object' ? address.port : 0;
-        probe.close(() => resolve(portValue));
-      });
-    });
-
-  beforeEach(() => {
-    spawnCalls.length = 0;
-    unrefMock.mockReset();
-    killMock.mockReset();
-  });
-
-  afterEach(async () => {
-    if (server !== null) {
-      await new Promise<void>((resolve) => server?.close(() => resolve()));
-      server = null;
-    }
-  });
-
-  it('should short-circuit and return null when the port already responds', async () => {
-    const port = await startProbeServer();
-    const result = await ensureConsoleRunning('/path/to/config.yaml', port, [
-      'acme',
-      'globex',
-    ]);
-    expect(spawnCalls).toHaveLength(0);
-    expect(result).toBeNull();
-  });
-
-  it('should spawn serveWeb when the port is unresponsive', async () => {
-    const unusedPort = await findFreePort();
-    await ensureConsoleRunning('/path/to/config.yaml', unusedPort, [
-      'acme',
-      'globex',
-    ]);
-
-    expect(spawnCalls).toHaveLength(1);
-    const [program, args, options] = spawnCalls[0];
-    expect(program).toBe(process.execPath);
-    if (!Array.isArray(args)) {
-      throw new Error('Expected spawn args to be an array');
-    }
-    expect(args[0]).toMatch(/cli\/index\.js$/);
-    expect(args[1]).toBe('serveWeb');
-    expect(args[2]).toBe('--configFilePath');
-    expect(args[3]).toBe('/path/to/config.yaml');
-    expect(args[4]).toBe('--port');
-    expect(args[5]).toBe(String(unusedPort));
-    const isObject = (value: unknown): value is { [key: string]: unknown } =>
-      value !== null && typeof value === 'object' && !Array.isArray(value);
-    if (!isObject(options)) {
-      throw new Error('Expected spawn options to be an object');
-    }
-    expect(args[6]).toBe('--dashboardProjectNames');
-    expect(args[7]).toBe('acme,globex');
-    expect(options.detached).toBe(true);
-    expect(options.stdio).toBe('ignore');
-    expect(unrefMock).toHaveBeenCalledTimes(1);
-  });
-
-  it('should refuse to start the console when no project name is configured', async () => {
-    const unusedPort = await findFreePort();
-    await expect(
-      ensureConsoleRunning('/path/to/config.yaml', unusedPort, []),
-    ).rejects.toThrow('consoleProjects is empty');
-    expect(spawnCalls).toHaveLength(0);
-  });
-
-  it('should return an object with a kill method that delegates to the child process', async () => {
-    const unusedPort = await findFreePort();
-    const result = await ensureConsoleRunning(
-      '/path/to/config.yaml',
-      unusedPort,
-      ['acme', 'globex'],
-    );
-    expect(result).not.toBeNull();
-    result?.kill();
-    expect(killMock).toHaveBeenCalledTimes(1);
-  });
-});

package/src/adapter/entry-points/console/ensureConsoleRunning.ts

@@ -1,64 +0,0 @@
-import { spawn } from 'child_process';
-import * as net from 'net';
-import * as path from 'path';
-
-export interface ConsoleProcess {
-  kill: () => void;
-}
-
-const PROBE_TIMEOUT_MS = 200;
-const STARTUP_WAIT_MS = 1500;
-
-const isPortResponding = (port: number): Promise<boolean> =>
-  new Promise((resolve) => {
-    const socket = new net.Socket();
-    let resolved = false;
-    const cleanup = (result: boolean): void => {
-      if (resolved) return;
-      resolved = true;
-      socket.destroy();
-      resolve(result);
-    };
-    socket.setTimeout(PROBE_TIMEOUT_MS);
-    socket.once('connect', () => cleanup(true));
-    socket.once('timeout', () => cleanup(false));
-    socket.once('error', () => cleanup(false));
-    socket.connect(port, '127.0.0.1');
-  });
-
-const sleep = (ms: number): Promise<void> =>
-  new Promise((resolve) => setTimeout(resolve, ms));
-
-export const ensureConsoleRunning = async (
-  configFilePath: string,
-  port: number,
-  dashboardProjectNames: string[],
-): Promise<ConsoleProcess | null> => {
-  if (dashboardProjectNames.length === 0) {
-    throw new Error(
-      `Cannot start the console from ${configFilePath}: consoleProjects is empty, so the dashboard has no project to render`,
-    );
-  }
-  if (await isPortResponding(port)) return null;
-  const cliEntry = path.resolve(__dirname, '../cli/index.js');
-  const child = spawn(
-    process.execPath,
-    [
-      cliEntry,
-      'serveWeb',
-      '--configFilePath',
-      configFilePath,
-      '--port',
-      String(port),
-      '--dashboardProjectNames',
-      dashboardProjectNames.join(','),
-    ],
-    {
-      detached: true,
-      stdio: 'ignore',
-    },
-  );
-  child.unref();
-  await sleep(STARTUP_WAIT_MS);
-  return { kill: () => child.kill() };
-};

package/src/adapter/entry-points/console/ui/.storybook/main.ts

@@ -1,12 +0,0 @@
-import type { StorybookConfig } from '@storybook/react-vite';
-
-const config: StorybookConfig = {
-  stories: ['../src/**/*.stories.@(ts|tsx)'],
-  addons: [],
-  framework: {
-    name: '@storybook/react-vite',
-    options: {},
-  },
-};
-
-export default config;

package/src/adapter/entry-points/console/ui/.storybook/preview.ts

@@ -1,15 +0,0 @@
-import type { Preview } from '@storybook/react-vite';
-import '../src/index.css';
-
-const preview: Preview = {
-  parameters: {
-    controls: {
-      matchers: {
-        color: /(background|color)$/i,
-        date: /Date$/,
-      },
-    },
-  },
-};
-
-export default preview;

package/src/adapter/entry-points/console/ui/biome.json

@@ -1,53 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.4.16/schema.json",
-  "root": false,
-  "vcs": {
-    "enabled": false,
-    "clientKind": "git",
-    "useIgnoreFile": false
-  },
-  "files": {
-    "ignoreUnknown": false,
-    "includes": [
-      "src/**",
-      ".storybook/**",
-      "e2e/**",
-      "!e2e/report/**",
-      "!e2e/test-results/**"
-    ]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 80
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single",
-      "semicolons": "always",
-      "trailingCommas": "all"
-    }
-  },
-  "css": {
-    "parser": {
-      "tailwindDirectives": true
-    },
-    "formatter": {
-      "quoteStyle": "double"
-    }
-  },
-  "assist": {
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  }
-}