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

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/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 };
+};

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

@@ -0,0 +1,41 @@
+import { act, renderHook } from '@testing-library/react';
+import { useConsoleToken } from './useConsoleToken';
+
+describe('useConsoleToken', () => {
+  beforeEach(() => {
+    localStorage.clear();
+    window.history.replaceState({}, '', '/');
+  });
+
+  it('reads the token from the query string and appends it to data urls', () => {
+    window.history.replaceState({}, '', '/?k=secret');
+    const { result } = renderHook(() => useConsoleToken());
+    expect(result.current.token).toBe('secret');
+    expect(result.current.appendToken('./prs/list.json')).toBe(
+      './prs/list.json?k=secret',
+    );
+    expect(result.current.appendToken('./api/itembody?url=x')).toBe(
+      './api/itembody?url=x&k=secret',
+    );
+  });
+
+  it('persists the token to localStorage', () => {
+    window.history.replaceState({}, '', '/?k=persisted');
+    renderHook(() => useConsoleToken());
+    expect(localStorage.getItem('tdpm-console-token')).toBe('persisted');
+  });
+
+  it('reads a persisted token when no query token exists', () => {
+    localStorage.setItem('tdpm-console-token', 'stored');
+    const { result } = renderHook(() => useConsoleToken());
+    expect(result.current.token).toBe('stored');
+  });
+
+  it('returns the url unchanged when there is no token', () => {
+    const { result } = renderHook(() => useConsoleToken());
+    act(() => {});
+    expect(result.current.appendToken('./prs/list.json')).toBe(
+      './prs/list.json',
+    );
+  });
+});

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

@@ -0,0 +1,97 @@
+import { CONSOLE_ITEM_ICONS, resolveConsoleItemIconKind } from './itemIcons';
+
+describe('resolveConsoleItemIconKind', () => {
+  it('resolves a draft pull request to prDraft', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: true,
+        state: 'open',
+        merged: false,
+        isDraft: true,
+        stateReason: '',
+      }),
+    ).toBe('prDraft');
+  });
+
+  it('resolves a merged pull request to prMerged', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: true,
+        state: 'closed',
+        merged: true,
+        isDraft: false,
+        stateReason: '',
+      }),
+    ).toBe('prMerged');
+  });
+
+  it('resolves a closed pull request to prClosed', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: true,
+        state: 'closed',
+        merged: false,
+        isDraft: false,
+        stateReason: '',
+      }),
+    ).toBe('prClosed');
+  });
+
+  it('resolves an open pull request to prOpen', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: true,
+        state: 'open',
+        merged: false,
+        isDraft: false,
+        stateReason: '',
+      }),
+    ).toBe('prOpen');
+  });
+
+  it('resolves a completed closed issue to issueClosed', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: false,
+        state: 'closed',
+        merged: false,
+        isDraft: false,
+        stateReason: 'completed',
+      }),
+    ).toBe('issueClosed');
+  });
+
+  it('resolves a not-planned closed issue to issueClosedNotPlanned', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: false,
+        state: 'closed',
+        merged: false,
+        isDraft: false,
+        stateReason: 'not_planned',
+      }),
+    ).toBe('issueClosedNotPlanned');
+  });
+
+  it('resolves an open issue to issueOpen', () => {
+    expect(
+      resolveConsoleItemIconKind({
+        isPr: false,
+        state: 'open',
+        merged: false,
+        isDraft: false,
+        stateReason: '',
+      }),
+    ).toBe('issueOpen');
+  });
+
+  it('uses the documented colors for each kind', () => {
+    expect(CONSOLE_ITEM_ICONS.prDraft.color).toBe('#8b949e');
+    expect(CONSOLE_ITEM_ICONS.prMerged.color).toBe('#a371f7');
+    expect(CONSOLE_ITEM_ICONS.prClosed.color).toBe('#f85149');
+    expect(CONSOLE_ITEM_ICONS.prOpen.color).toBe('#3fb950');
+    expect(CONSOLE_ITEM_ICONS.issueClosedNotPlanned.color).toBe('#848d97');
+    expect(CONSOLE_ITEM_ICONS.issueClosed.color).toBe('#a371f7');
+    expect(CONSOLE_ITEM_ICONS.issueOpen.color).toBe('#3fb950');
+  });
+});

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

@@ -0,0 +1,95 @@
+export type ConsoleItemIconKind =
+  | 'issueOpen'
+  | 'issueClosed'
+  | 'issueClosedNotPlanned'
+  | 'prOpen'
+  | 'prMerged'
+  | 'prClosed'
+  | 'prDraft';
+
+export type ConsoleItemIconDefinition = {
+  color: string;
+  paths: string[];
+};
+
+export const CONSOLE_ITEM_ICONS: Record<
+  ConsoleItemIconKind,
+  ConsoleItemIconDefinition
+> = {
+  issueOpen: {
+    color: '#3fb950',
+    paths: [
+      'M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z',
+      'M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z',
+    ],
+  },
+  issueClosed: {
+    color: '#a371f7',
+    paths: [
+      'M11.28 6.78a.75.75 0 0 0-1.06-1.06L7.25 8.69 5.78 7.22a.75.75 0 0 0-1.06 1.06l2 2a.75.75 0 0 0 1.06 0l3.5-3.5Z',
+      'M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0Zm-1.5 0a6.5 6.5 0 1 0-13 0 6.5 6.5 0 0 0 13 0Z',
+    ],
+  },
+  issueClosedNotPlanned: {
+    color: '#848d97',
+    paths: [
+      'M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm9.78-2.22-5.5 5.5a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734l5.5-5.5a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042Z',
+    ],
+  },
+  prOpen: {
+    color: '#3fb950',
+    paths: [
+      'M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z',
+    ],
+  },
+  prMerged: {
+    color: '#a371f7',
+    paths: [
+      'M5.45 5.154A4.25 4.25 0 0 0 9.25 7.5h1.378a2.251 2.251 0 1 1 0 1.5H9.25A5.734 5.734 0 0 1 5 7.123v3.505a2.25 2.25 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.95-.218ZM4.25 13.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm8.5-4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5ZM5 3.25a.75.75 0 1 0 0 .005V3.25Z',
+    ],
+  },
+  prClosed: {
+    color: '#f85149',
+    paths: [
+      'M3.25 1A2.25 2.25 0 0 1 4 5.372v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.251 2.251 0 0 1 3.25 1Zm9.5 5.5a.75.75 0 0 1 .75.75v3.378a2.251 2.251 0 1 1-1.5 0V7.25a.75.75 0 0 1 .75-.75Zm-2.03-5.273a.75.75 0 0 1 1.06 0l.97.97.97-.97a.748.748 0 0 1 1.265.332.75.75 0 0 1-.205.729l-.97.97.97.97a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-.97-.97-.97.97a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734l.97-.97-.97-.97a.75.75 0 0 1 0-1.06ZM2.5 3.25a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0ZM3.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm9.5 0a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Z',
+    ],
+  },
+  prDraft: {
+    color: '#8b949e',
+    paths: [
+      'M3.25 1A2.25 2.25 0 0 1 4 5.372v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.251 2.251 0 0 1 3.25 1Zm9.5 14a2.25 2.25 0 1 1 0-4.5 2.25 2.25 0 0 1 0 4.5ZM2.5 3.25a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0ZM3.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm9.5 0a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5ZM14 7.5a1.25 1.25 0 1 1-2.5 0 1.25 1.25 0 0 1 2.5 0Zm0-4.25a1.25 1.25 0 1 1-2.5 0 1.25 1.25 0 0 1 2.5 0Z',
+    ],
+  },
+};
+
+export type ConsoleItemIconInput = {
+  isPr: boolean;
+  state: string;
+  merged: boolean;
+  isDraft: boolean;
+  stateReason: string;
+};
+
+export const resolveConsoleItemIconKind = ({
+  isPr,
+  state,
+  merged,
+  isDraft,
+  stateReason,
+}: ConsoleItemIconInput): ConsoleItemIconKind => {
+  if (isPr) {
+    if (isDraft) {
+      return 'prDraft';
+    }
+    if (merged) {
+      return 'prMerged';
+    }
+    return state === 'closed' ? 'prClosed' : 'prOpen';
+  }
+  if (state === 'closed') {
+    return stateReason === 'not_planned'
+      ? 'issueClosedNotPlanned'
+      : 'issueClosed';
+  }
+  return 'issueOpen';
+};