github-issue-tower-defence-management 1.89.0 → 1.91.0

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleOperations.ts

@@ -0,0 +1,243 @@
+import { useCallback } from 'react';
+import {
+  type ConsoleIntmuxRequest,
+  type ConsoleReviewRequest,
+  type ConsoleTriageRequest,
+  postConsoleOperation,
+} from '../lib/consoleApi';
+import {
+  type ConsoleCloseAction,
+  type ConsoleNextActionDateAction,
+  type ConsoleReviewAction,
+  TOTALLY_WRONG_COMMENT_BODY,
+  UNNECESSARY_COMMENT_BODY,
+} from '../operations';
+import { overlayKeyForItem } from '../overlay';
+import type {
+  ConsoleFieldOption,
+  ConsoleListItem,
+  ConsoleTabName,
+} from '../types';
+import type { ConsoleOverlayState } from './useConsoleOverlay';
+import { useConsoleToken } from './useConsoleToken';
+
+export const REVIEW_OPERATION_PATH = '/api/review';
+export const TRIAGE_OPERATION_PATH = '/api/triage';
+export const INTMUX_OPERATION_PATH = '/api/intmux';
+
+export type ConsoleOperationsApi = {
+  reviewPullRequest: (
+    item: ConsoleListItem,
+    prUrl: string,
+    action: ConsoleReviewAction,
+  ) => Promise<void>;
+  setNextActionDate: (
+    item: ConsoleListItem,
+    action: ConsoleNextActionDateAction,
+  ) => Promise<void>;
+  setStory: (
+    item: ConsoleListItem,
+    option: ConsoleFieldOption,
+  ) => Promise<void>;
+  setStatus: (
+    item: ConsoleListItem,
+    option: ConsoleFieldOption,
+  ) => Promise<void>;
+  setInTmuxByHuman: (
+    item: ConsoleListItem,
+    option: ConsoleFieldOption,
+  ) => Promise<void>;
+  closeIssue: (
+    item: ConsoleListItem,
+    action: ConsoleCloseAction,
+  ) => Promise<void>;
+};
+
+const reviewRequest = (
+  pjcode: string,
+  item: ConsoleListItem,
+  prUrl: string,
+  action: ConsoleReviewAction,
+): ConsoleReviewRequest => {
+  if (action === 'approve') {
+    return {
+      pjcode,
+      action: 'approve',
+      prUrl,
+      projectItemId: item.projectItemId,
+    };
+  }
+  if (action === 'request_changes') {
+    return {
+      pjcode,
+      action: 'request_changes',
+      prUrl,
+      projectItemId: item.projectItemId,
+      commentBody: '',
+    };
+  }
+  if (action === 'totally_wrong') {
+    return {
+      pjcode,
+      action: 'close',
+      prUrl,
+      projectItemId: item.projectItemId,
+      commentBody: TOTALLY_WRONG_COMMENT_BODY,
+    };
+  }
+  return {
+    pjcode,
+    action: 'close',
+    prUrl,
+    projectItemId: item.projectItemId,
+    commentBody: UNNECESSARY_COMMENT_BODY,
+  };
+};
+
+const missingPjcodeError = (): Error =>
+  new Error('No project specified in the URL path.');
+
+export const useConsoleOperations = (
+  pjcode: string | null,
+  mode: ConsoleTabName,
+  overlayState: ConsoleOverlayState,
+): ConsoleOperationsApi => {
+  const { appendToken } = useConsoleToken();
+  const { patchOverlay } = overlayState;
+
+  const markDone = useCallback(
+    (item: ConsoleListItem) => {
+      patchOverlay(overlayKeyForItem(item), { done: true }, mode);
+    },
+    [patchOverlay, mode],
+  );
+
+  const reviewPullRequest = useCallback(
+    async (
+      item: ConsoleListItem,
+      prUrl: string,
+      action: ConsoleReviewAction,
+    ) => {
+      if (pjcode === null) {
+        throw missingPjcodeError();
+      }
+      await postConsoleOperation(
+        appendToken,
+        REVIEW_OPERATION_PATH,
+        reviewRequest(pjcode, item, prUrl, action),
+      );
+      markDone(item);
+    },
+    [pjcode, appendToken, markDone],
+  );
+
+  const setNextActionDate = useCallback(
+    async (item: ConsoleListItem, action: ConsoleNextActionDateAction) => {
+      if (pjcode === null) {
+        throw missingPjcodeError();
+      }
+      const request: ConsoleTriageRequest = {
+        pjcode,
+        action,
+        issueUrl: item.url,
+        projectItemId: item.projectItemId,
+      };
+      await postConsoleOperation(appendToken, TRIAGE_OPERATION_PATH, request);
+      if (mode === 'todo-by-human') {
+        markDone(item);
+      }
+    },
+    [pjcode, appendToken, markDone, mode],
+  );
+
+  const setStory = useCallback(
+    async (item: ConsoleListItem, option: ConsoleFieldOption) => {
+      if (pjcode === null) {
+        throw missingPjcodeError();
+      }
+      const request: ConsoleTriageRequest = {
+        pjcode,
+        action: 'set_story',
+        issueUrl: item.url,
+        projectItemId: item.projectItemId,
+        storyOptionId: option.id,
+      };
+      await postConsoleOperation(appendToken, TRIAGE_OPERATION_PATH, request);
+      patchOverlay(
+        overlayKeyForItem(item),
+        { done: true, story: { name: option.name, color: option.color } },
+        mode,
+      );
+    },
+    [pjcode, appendToken, patchOverlay, mode],
+  );
+
+  const setStatus = useCallback(
+    async (item: ConsoleListItem, option: ConsoleFieldOption) => {
+      if (pjcode === null) {
+        throw missingPjcodeError();
+      }
+      const request: ConsoleTriageRequest = {
+        pjcode,
+        action: 'set_status',
+        issueUrl: item.url,
+        projectItemId: item.projectItemId,
+        statusName: option.name,
+      };
+      await postConsoleOperation(appendToken, TRIAGE_OPERATION_PATH, request);
+      patchOverlay(
+        overlayKeyForItem(item),
+        { done: true, status: { name: option.name, color: option.color } },
+        mode,
+      );
+    },
+    [pjcode, appendToken, patchOverlay, mode],
+  );
+
+  const setInTmuxByHuman = useCallback(
+    async (item: ConsoleListItem, option: ConsoleFieldOption) => {
+      if (pjcode === null) {
+        throw missingPjcodeError();
+      }
+      const request: ConsoleIntmuxRequest = {
+        pjcode,
+        action: 'set_intmux',
+        issueUrl: item.url,
+        projectItemId: item.projectItemId,
+      };
+      await postConsoleOperation(appendToken, INTMUX_OPERATION_PATH, request);
+      patchOverlay(
+        overlayKeyForItem(item),
+        { done: true, status: { name: option.name, color: option.color } },
+        mode,
+      );
+    },
+    [pjcode, appendToken, patchOverlay, mode],
+  );
+
+  const closeIssue = useCallback(
+    async (item: ConsoleListItem, action: ConsoleCloseAction) => {
+      if (pjcode === null) {
+        throw missingPjcodeError();
+      }
+      const request: ConsoleTriageRequest = {
+        pjcode,
+        action,
+        issueUrl: item.url,
+        projectItemId: item.projectItemId,
+      };
+      await postConsoleOperation(appendToken, TRIAGE_OPERATION_PATH, request);
+      markDone(item);
+    },
+    [pjcode, appendToken, markDone],
+  );
+
+  return {
+    reviewPullRequest,
+    setNextActionDate,
+    setStory,
+    setStatus,
+    setInTmuxByHuman,
+    closeIssue,
+  };
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleOverlay.test.ts

@@ -0,0 +1,40 @@
+import { act, renderHook } from '@testing-library/react';
+import { overlayStorageKey } from '../overlay';
+import { useConsoleOverlay } from './useConsoleOverlay';
+
+describe('useConsoleOverlay', () => {
+  beforeEach(() => {
+    localStorage.clear();
+  });
+
+  it('starts from the persisted overlay', () => {
+    localStorage.setItem(
+      overlayStorageKey('umino'),
+      JSON.stringify({ PVTI_1: { ts: 5, mode: 'prs', done: true } }),
+    );
+    const { result } = renderHook(() => useConsoleOverlay('umino'));
+    expect(result.current.overlay.PVTI_1?.done).toBe(true);
+  });
+
+  it('patches and persists overlay entries with timestamp and mode', () => {
+    const { result } = renderHook(() => useConsoleOverlay('umino'));
+    act(() => {
+      result.current.patchOverlay('PVTI_2', { done: true }, 'triage');
+    });
+    expect(result.current.overlay.PVTI_2?.done).toBe(true);
+    expect(result.current.overlay.PVTI_2?.mode).toBe('triage');
+    const stored = JSON.parse(
+      localStorage.getItem(overlayStorageKey('umino')) ?? '{}',
+    );
+    expect(stored.PVTI_2.done).toBe(true);
+  });
+
+  it('ignores malformed persisted entries', () => {
+    localStorage.setItem(
+      overlayStorageKey('umino'),
+      JSON.stringify({ bad: { no: 'ts' } }),
+    );
+    const { result } = renderHook(() => useConsoleOverlay('umino'));
+    expect(result.current.overlay.bad).toBeUndefined();
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleOverlay.ts

@@ -0,0 +1,71 @@
+import { useCallback, useState } from 'react';
+import { overlayStorageKey, writeOverlayEntry } from '../overlay';
+import type {
+  ConsoleOverlay,
+  ConsoleOverlayEntry,
+  ConsoleTabName,
+} from '../types';
+
+const isOverlayEntry = (value: unknown): value is ConsoleOverlayEntry =>
+  value !== null &&
+  typeof value === 'object' &&
+  typeof (value as { ts?: unknown }).ts === 'number';
+
+const readOverlay = (pjcode: string): ConsoleOverlay => {
+  if (typeof localStorage === 'undefined') {
+    return {};
+  }
+  const raw = localStorage.getItem(overlayStorageKey(pjcode));
+  if (raw === null) {
+    return {};
+  }
+  const parsed: unknown = JSON.parse(raw);
+  if (parsed === null || typeof parsed !== 'object') {
+    return {};
+  }
+  const overlay: ConsoleOverlay = {};
+  for (const [key, value] of Object.entries(parsed)) {
+    if (isOverlayEntry(value)) {
+      overlay[key] = value;
+    }
+  }
+  return overlay;
+};
+
+const persistOverlay = (pjcode: string, overlay: ConsoleOverlay): void => {
+  if (typeof localStorage !== 'undefined') {
+    localStorage.setItem(overlayStorageKey(pjcode), JSON.stringify(overlay));
+  }
+};
+
+export type ConsoleOverlayState = {
+  overlay: ConsoleOverlay;
+  patchOverlay: (
+    key: string,
+    patch: Partial<Omit<ConsoleOverlayEntry, 'ts' | 'mode'>>,
+    mode: ConsoleTabName,
+  ) => void;
+};
+
+export const useConsoleOverlay = (pjcode: string): ConsoleOverlayState => {
+  const [overlay, setOverlay] = useState<ConsoleOverlay>(() =>
+    readOverlay(pjcode),
+  );
+
+  const patchOverlay = useCallback(
+    (
+      key: string,
+      patch: Partial<Omit<ConsoleOverlayEntry, 'ts' | 'mode'>>,
+      mode: ConsoleTabName,
+    ) => {
+      setOverlay((current) => {
+        const next = writeOverlayEntry(current, key, patch, mode, Date.now());
+        persistOverlay(pjcode, next);
+        return next;
+      });
+    },
+    [pjcode],
+  );
+
+  return { overlay, patchOverlay };
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsolePjcode.test.ts

@@ -0,0 +1,24 @@
+import { parsePjcodeFromPath } from './useConsolePjcode';
+
+describe('parsePjcodeFromPath', () => {
+  it('extracts the pjcode from a projects path', () => {
+    expect(parsePjcodeFromPath('/projects/umino')).toBe('umino');
+    expect(parsePjcodeFromPath('/projects/umino/prs')).toBe('umino');
+    expect(parsePjcodeFromPath('/projects/xmile/triage')).toBe('xmile');
+  });
+
+  it('tolerates a trailing slash', () => {
+    expect(parsePjcodeFromPath('/projects/utage3/')).toBe('utage3');
+  });
+
+  it('returns null when the path is not under projects', () => {
+    expect(parsePjcodeFromPath('/')).toBeNull();
+    expect(parsePjcodeFromPath('/index.html')).toBeNull();
+    expect(parsePjcodeFromPath('/assets/app.js')).toBeNull();
+  });
+
+  it('returns null when no pjcode segment follows projects', () => {
+    expect(parsePjcodeFromPath('/projects')).toBeNull();
+    expect(parsePjcodeFromPath('/projects/')).toBeNull();
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsolePjcode.ts

@@ -0,0 +1,17 @@
+export const parsePjcodeFromPath = (pathname: string): string | null => {
+  const segments = pathname.split('/').filter((segment) => segment.length > 0);
+  if (segments.length < 2 || segments[0] !== 'projects') {
+    return null;
+  }
+  const pjcode = segments[1];
+  if (pjcode.length === 0) {
+    return null;
+  }
+  return pjcode;
+};
+
+export const useConsolePjcode = (): string | null => {
+  const pathname =
+    typeof window === 'undefined' ? '' : window.location.pathname;
+  return parsePjcodeFromPath(pathname);
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleResource.test.ts

@@ -0,0 +1,41 @@
+import { renderHook, waitFor } from '@testing-library/react';
+import { ResourceCache } from '../lib/resourceCache';
+import { useConsoleResource } from './useConsoleResource';
+
+describe('useConsoleResource', () => {
+  it('loads the resource and exposes loading then data', async () => {
+    const cache = new ResourceCache<string>(async () => 'loaded');
+    const { result } = renderHook(() =>
+      useConsoleResource(cache, 'k', 'u', 'fallback'),
+    );
+    expect(result.current.isLoading).toBe(true);
+    expect(result.current.data).toBe('fallback');
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(result.current.data).toBe('loaded');
+    expect(result.current.error).toBeNull();
+  });
+
+  it('stays idle with the fallback when the key is null', () => {
+    const cache = new ResourceCache<string>(async () => 'loaded');
+    const { result } = renderHook(() =>
+      useConsoleResource(cache, null, null, 'fallback'),
+    );
+    expect(result.current.isLoading).toBe(false);
+    expect(result.current.data).toBe('fallback');
+  });
+
+  it('surfaces a fetch error', async () => {
+    const cache = new ResourceCache<string>(async () => {
+      throw new Error('boom');
+    });
+    const { result } = renderHook(() =>
+      useConsoleResource(cache, 'k', 'u', 'fallback'),
+    );
+    await waitFor(() => {
+      expect(result.current.error).toBe('boom');
+    });
+    expect(result.current.isLoading).toBe(false);
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleResource.ts

@@ -0,0 +1,57 @@
+import { useEffect, useState } from 'react';
+import type { ResourceCache } from '../lib/resourceCache';
+
+export type ConsoleResourceState<T> = {
+  data: T;
+  isLoading: boolean;
+  error: string | null;
+};
+
+export const useConsoleResource = <T>(
+  cache: ResourceCache<T>,
+  key: string | null,
+  url: string | null,
+  fallback: T,
+): ConsoleResourceState<T> => {
+  const cached = key !== null ? cache.peek(key) : undefined;
+  const [data, setData] = useState<T>(cached ?? fallback);
+  const [isLoading, setIsLoading] = useState<boolean>(
+    key !== null && cached === undefined,
+  );
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (key === null || url === null) {
+      return;
+    }
+    const existing = cache.peek(key);
+    if (existing !== undefined) {
+      setData(existing);
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    cache
+      .load(key, url)
+      .then((value) => {
+        if (!cancelled) {
+          setData(value);
+          setIsLoading(false);
+        }
+      })
+      .catch((cause: unknown) => {
+        if (!cancelled) {
+          setError(cause instanceof Error ? cause.message : String(cause));
+          setIsLoading(false);
+        }
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [cache, key, url]);
+
+  return { data, isLoading, error };
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleTabData.test.ts

@@ -0,0 +1,63 @@
+import { renderHook, waitFor } from '@testing-library/react';
+import { useConsoleTabData } from './useConsoleTabData';
+
+describe('useConsoleTabData', () => {
+  beforeEach(() => {
+    localStorage.clear();
+    window.history.replaceState({}, '', '/?k=token');
+  });
+
+  it('fetches every tab once at startup and parses snapshots', async () => {
+    const fetchMock = jest.fn(async (url: string) => ({
+      ok: true,
+      status: 200,
+      json: async () => ({
+        pjcode: 'umino',
+        generatedAt: '2026-06-19T00:00:00.000Z',
+        statusOptions: [{ id: 's1', name: 'Unread', color: 'ORANGE' }],
+        storyColors: {},
+        items: url.includes('/prs/')
+          ? [{ number: 1, itemId: 'PVTI_1', projectItemId: 'PVTI_1' }]
+          : [],
+      }),
+    }));
+    global.fetch = fetchMock as unknown as typeof fetch;
+
+    const { result } = renderHook(() => useConsoleTabData('umino'));
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(fetchMock).toHaveBeenCalledTimes(5);
+    expect(fetchMock).toHaveBeenCalledWith(
+      expect.stringContaining('/projects/umino/prs/list.json'),
+    );
+    expect(result.current.snapshots.prs?.items.length).toBe(1);
+    expect(result.current.snapshots.prs?.generatedAt).toBe(
+      '2026-06-19T00:00:00.000Z',
+    );
+  });
+
+  it('surfaces an error when a tab fetch fails', async () => {
+    const fetchMock = jest.fn(async () => ({
+      ok: false,
+      status: 500,
+      json: async () => ({}),
+    }));
+    global.fetch = fetchMock as unknown as typeof fetch;
+    const { result } = renderHook(() => useConsoleTabData('umino'));
+    await waitFor(() => {
+      expect(result.current.error).toBe('HTTP 500');
+    });
+  });
+
+  it('reports an error and fetches nothing when no pjcode is in the URL', async () => {
+    const fetchMock = jest.fn();
+    global.fetch = fetchMock as unknown as typeof fetch;
+    const { result } = renderHook(() => useConsoleTabData(null));
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(result.current.error).toBe('No project specified in the URL path.');
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleTabData.ts

@@ -0,0 +1,129 @@
+import { useEffect, useState } from 'react';
+import type {
+  ConsoleFieldOption,
+  ConsoleListItem,
+  ConsoleStoryColorSource,
+  ConsoleTabName,
+} from '../types';
+import { CONSOLE_TABS } from '../types';
+import { useConsoleToken } from './useConsoleToken';
+
+export type ConsoleTabSnapshot = {
+  items: ConsoleListItem[];
+  generatedAt: string;
+  statusOptions: ConsoleFieldOption[];
+  storyOptions: ConsoleFieldOption[];
+  storyColors: ConsoleStoryColorSource;
+};
+
+export type ConsoleTabDataState = {
+  snapshots: Record<ConsoleTabName, ConsoleTabSnapshot | null>;
+  isLoading: boolean;
+  error: string | null;
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  value !== null && typeof value === 'object' && !Array.isArray(value);
+
+const parseItems = (payload: unknown): ConsoleListItem[] => {
+  if (!isRecord(payload) || !Array.isArray(payload.items)) {
+    return [];
+  }
+  return payload.items.filter(isRecord) as unknown as ConsoleListItem[];
+};
+
+const parseOptions = (value: unknown): ConsoleFieldOption[] => {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.filter(isRecord) as unknown as ConsoleFieldOption[];
+};
+
+const parseSnapshot = (payload: unknown): ConsoleTabSnapshot => ({
+  items: parseItems(payload),
+  generatedAt:
+    isRecord(payload) && typeof payload.generatedAt === 'string'
+      ? payload.generatedAt
+      : '',
+  statusOptions: isRecord(payload) ? parseOptions(payload.statusOptions) : [],
+  storyOptions: isRecord(payload) ? parseOptions(payload.storyOptions) : [],
+  storyColors:
+    isRecord(payload) && isRecord(payload.storyColors)
+      ? (payload.storyColors as ConsoleStoryColorSource)
+      : {},
+});
+
+const emptySnapshots = (): Record<
+  ConsoleTabName,
+  ConsoleTabSnapshot | null
+> => {
+  const result = {} as Record<ConsoleTabName, ConsoleTabSnapshot | null>;
+  for (const tab of CONSOLE_TABS) {
+    result[tab.name] = null;
+  }
+  return result;
+};
+
+const buildListUrl = (pjcode: string, tab: ConsoleTabName): string =>
+  `/projects/${pjcode}/${tab}/list.json`;
+
+export const useConsoleTabData = (
+  pjcode: string | null,
+): ConsoleTabDataState => {
+  const { appendToken } = useConsoleToken();
+  const [snapshots, setSnapshots] =
+    useState<Record<ConsoleTabName, ConsoleTabSnapshot | null>>(emptySnapshots);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+
+    if (pjcode === null) {
+      setSnapshots(emptySnapshots());
+      setIsLoading(false);
+      setError('No project specified in the URL path.');
+      return () => {
+        cancelled = true;
+      };
+    }
+
+    Promise.all(
+      CONSOLE_TABS.map(async (tab) => {
+        const url = appendToken(buildListUrl(pjcode, tab.name));
+        const response = await fetch(url);
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
+        const payload: unknown = await response.json();
+        return [tab.name, parseSnapshot(payload)] as const;
+      }),
+    )
+      .then((entries) => {
+        if (cancelled) {
+          return;
+        }
+        const next = emptySnapshots();
+        for (const [name, snapshot] of entries) {
+          next[name] = snapshot;
+        }
+        setSnapshots(next);
+        setIsLoading(false);
+      })
+      .catch((cause: unknown) => {
+        if (cancelled) {
+          return;
+        }
+        setError(cause instanceof Error ? cause.message : String(cause));
+        setIsLoading(false);
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [pjcode, appendToken]);
+
+  return { snapshots, isLoading, error };
+};