fix(bootstrap): offer a retry on boot failures a reload can fix (09-10)

A config or manifest request that failed or timed out left only an error code
on screen. The boot shell now explains and offers a "try again" button for
those codes; it never reloads on its own, so the reload-once rule holds.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-25 23:27:14 +09:00
co-authored by Claude Opus 5.5
parent b685b616e4
commit fc8142b2b9
4 changed files with 60 additions and 1 deletions
@@ -4,6 +4,15 @@ import { BOOT_MESSAGES } from "../i18n/boot-messages.ts";
// has to render when the installed feature graph failed to evaluate.
const MESSAGES = BOOT_MESSAGES["ko-KR"];
// 09-10. Failures a fresh load can fix: the config or manifest request did
// not complete. Retrying stays a user action; nothing reloads on its own.
const RETRYABLE_CODES: ReadonlySet<string> = new Set([
"CONFIG_FETCH_FAILED",
"CONFIG_TIMEOUT",
"MANIFEST_FETCH_FAILED",
"MANIFEST_TIMEOUT",
]);
export type BootErrorShellProps = Readonly<{
kind?: string;
code?: string;
@@ -12,6 +21,7 @@ export type BootErrorShellProps = Readonly<{
releaseId?: string;
invalidKeys?: readonly string[];
supportReference: string;
onRetry?: () => void;
}>;
export function BootErrorShell({
@@ -23,7 +33,9 @@ export function BootErrorShell({
releaseId,
invalidKeys,
supportReference,
onRetry,
}: BootErrorShellProps) {
const retry = onRetry !== undefined && RETRYABLE_CODES.has(code);
return (
<main role="alert">
<h1>{MESSAGES["boot.failure.title"]}</h1>
@@ -57,6 +69,14 @@ export function BootErrorShell({
</>
)}
</dl>
{retry && (
<>
<p>{MESSAGES["boot.retry.hint"]}</p>
<button type="button" onClick={onRetry}>
{MESSAGES["boot.retry.action"]}
</button>
</>
)}
<p>
{MESSAGES["boot.supportReference"].replace(
"{reference}",
+4
View File
@@ -13,6 +13,8 @@ export const BOOT_MESSAGES = Object.freeze({
"boot.field.configSchema": "설정 스키마",
"boot.field.release": "릴리스",
"boot.field.invalidKeys": "잘못된 설정 키",
"boot.retry.hint": "네트워크 연결을 확인한 뒤 다시 시도해 주세요.",
"boot.retry.action": "다시 시도",
"boot.supportReference": "지원 참조: {reference}",
} as const),
"en-US": Object.freeze({
@@ -23,6 +25,8 @@ export const BOOT_MESSAGES = Object.freeze({
"boot.field.configSchema": "Configuration schema",
"boot.field.release": "Release",
"boot.field.invalidKeys": "Invalid configuration keys",
"boot.retry.hint": "Check the network connection and try again.",
"boot.retry.action": "Try again",
"boot.supportReference": "Support reference: {reference}",
} as const),
});