fix(engine): 구형 Safari 부팅 실패 해소 및 배포 번들 브라우저 하한 회귀 방지

코어 엔진 번들의 정규식 lookbehind 2건이 Safari 16.4 미만에서 파싱 자체를 거부당해 iOS 15 대 전 기기에서 SPA 가 통째로 뜨지 않았다. 정규식 리터럴은 스크립트 파싱 단계에서 검증되므로 그 문법을 모르는 엔진은 파일을 한 줄도 실행하지 못하고, 번들이 async/defer 없는 동기 classic 스크립트라 폴백 경로도 없었다. 빌드 타깃(es2020)이 이를 막지 못한 이유는 ES 연도와 브라우저 지원 연도가 다르기 때문이며, 정규식 리터럴 문법은 다운레벨 자체가 불가능해 어떤 타깃 설정으로도 걸러지지 않는다. - 두 정규식을 lookbehind 없는 형태로 교체(engine-v1.60.6). 선행 따옴표·구분자를 소비한 뒤 캡처 그룹으로 분기하며, 식별자 인덱스가 match[1] → match[2] 로 이동한다. 무작위 200,034 표본 퍼징에서 교체 전후 결과 불일치 0건. 파싱 하한 실측 Safari 16.4 → 14.1 (제보자 기기 15.6 포함). - 부팅 실패 안내를 사유별로 가른다. 번들을 받았는데 실행되지 않은 경우와 끝내 받지 못한 경우는 사용자가 취할 행동이 정반대인데 같은 문구였다. 사유는 추측이 아니라 window error 이벤트로 SyntaxError 를 관측해 판정한다 (파싱 실패 시 script 는 error 가 아니라 load 를 발생시켜 element 이벤트로는 구분 불가). 비호환 분기는 새로고침해도 낫지 않으므로 버튼을 렌더하지 않는다. 인라인 부트스트랩은 ES5 를 유지해야 이 안내 자체가 구형에서 살아남는다. - 재발 방지: 배포 JS 산출물의 브라우저 하한 초과 문법·API 를 정적 검사로 차단. 부팅 임계 번들(코어 엔진·템플릿 컴포넌트)은 파싱에 실패하면 안내 화면조차 렌더되지 않으므로 하한과 같은 버전을 요구하는 정규식 리터럴 문법도 금지한다. lookbehind 의 Safari 16.4 는 하한과 정확히 같아 하한 초과만 보는 검사로는 영원히 잡히지 않았다 — 그 지점이 이번 사각이었다. - 지원 브라우저 최소 버전(Chrome 111 / Safari 16.4 / Firefox 128)과, 하한 미만 브라우저에서도 화면 표시와 기본 이용은 유지한다는 방침을 문서에 명시. 부수 수정: network-resilience E2E 4건이 자산 URL extensionless 모드에서 URL glob 이 한 건도 매칭되지 않아 실패하고 있었다. 같은 파일의 컴포넌트 번들 테스트만 이중 모드를 알고 형제 케이스는 몰랐던 불균형이라 매처를 통일했다.
2026-08-21 20:55:57 +09:00
parent 80d16c80bc
commit 0db8f9c5fb
16 changed files with 685 additions and 32 deletions
@@ -0,0 +1,154 @@
+<?php
+
+namespace Tests\Feature\View;
+
+use Tests\TestCase;
+
+/**
+ * 부팅 실패 사유별 안내 분기 (공개 #121).
+ *
+ * 번들을 받았는데 실행되지 않는 경우와 끝내 받지 못한 경우는 사용자가 취할 행동이
+ * 정반대다. 전자에 "네트워크가 불안정하다 / 새로고침하라" 를 띄우면 새로고침해도
+ * 낫지 않으므로 사용자는 자기 회선을 탓하게 된다.
+ *
+ * 인라인 부트스트랩은 코어 번들이 없어도 동작해야 하므로 ES5 로만 작성한다 —
+ * 화살표 함수·const·템플릿 리터럴·옵셔널 체이닝이 섞이면 이 계층까지 구형
+ * 브라우저에서 죽어 안내조차 뜨지 않는다.
+ *
+ * @scenario entrypoint=user, failure_mode=parse_error
+ *
+ * @effects bootstrap_partial_emits_reason_branch, incompatible_strings_defined_per_locale
+ */
+class BootstrapFallbackDiagnosisTest extends TestCase
+{
+    /**
+     * 부트스트랩 partial 을 렌더합니다.
+     *
+     * @param  string  $templateType  'user' 또는 'admin'
+     * @return string 렌더된 HTML
+     */
+    private function render(string $templateType = 'user'): string
+    {
+        return view('partials.bootstrap-scripts', [
+            'templateType' => $templateType,
+            'coreEngineSrc' => '/build/core/template-engine.min.js',
+            'componentsSrc' => '/api/templates/assets/sirsoft-basic/js/components.iife.js',
+            'initConfig' => ['templateId' => 'sirsoft-basic', 'locale' => 'ko'],
+        ])->render();
+    }
+
+    public function test_두_진입점_모두_사유별_분기를_렌더한다(): void
+    {
+        foreach (['user', 'admin'] as $templateType) {
+            $html = $this->render($templateType);
+
+            $this->assertStringContainsString(
+                "? 'incompatible' : 'corrupt'",
+                $html,
+                "[{$templateType}] 전역 부재 경로가 SyntaxError 관측 결과로 사유를 가르지 않는다"
+            );
+            $this->assertStringContainsString(
+                "renderFallback('network')",
+                $html,
+                "[{$templateType}] 재시도 소진 경로가 network 사유를 넘기지 않는다"
+            );
+            $this->assertStringContainsString(
+                'data-g7-bootstrap-fallback',
+                $html,
+                "[{$templateType}] 폴백 사유 마커가 없다"
+            );
+        }
+    }
+
+    public function test_파싱_오류_관측_리스너가_설치된다(): void
+    {
+        $html = $this->render();
+
+        // 파싱 실패는 <script> 의 error 가 아니라 load 를 발생시키므로 element
+        // 이벤트로는 구분할 수 없다. window 의 error 이벤트로만 관측된다.
+        $this->assertStringContainsString('bundleSrcs', $html);
+        $this->assertStringContainsString('SyntaxError', $html);
+        $this->assertStringContainsString('syntaxError', $html);
+    }
+
+    public function test_비호환_안내_문구가_지원_로케일마다_정의된다(): void
+    {
+        $original = app()->getLocale();
+
+        try {
+            foreach (['ko', 'en'] as $locale) {
+                app()->setLocale($locale);
+
+                foreach (['incompatible_title', 'incompatible_message'] as $key) {
+                    $value = __("errors.bootstrap.{$key}");
+
+                    $this->assertNotSame(
+                        "errors.bootstrap.{$key}",
+                        $value,
+                        "[{$locale}] errors.bootstrap.{$key} 미정의 — 화면에 키 문자열이 그대로 노출된다"
+                    );
+                    $this->assertNotSame('', trim($value), "[{$locale}] errors.bootstrap.{$key} 가 비어 있다");
+                }
+
+                // 사유가 다르면 문구도 달라야 한다 — 같으면 분기가 무의미하다
+                $this->assertNotSame(
+                    __('errors.bootstrap.message'),
+                    __('errors.bootstrap.incompatible_message'),
+                    "[{$locale}] 비호환 문구가 네트워크 문구와 동일하다"
+                );
+            }
+        } finally {
+            app()->setLocale($original);
+        }
+    }
+
+    public function test_번들_일본어_언어팩에도_비호환_문구가_있다(): void
+    {
+        $path = base_path('lang-packs/_bundled/g7-core-ja/backend/ja/errors.php');
+
+        if (! file_exists($path)) {
+            $this->markTestSkipped('번들 ja 언어팩 미존재');
+        }
+
+        $ja = require $path;
+
+        $this->assertArrayHasKey('bootstrap', $ja);
+        $this->assertArrayHasKey('incompatible_title', $ja['bootstrap']);
+        $this->assertArrayHasKey('incompatible_message', $ja['bootstrap']);
+        $this->assertNotSame(
+            $ja['bootstrap']['message'],
+            $ja['bootstrap']['incompatible_message'],
+            'ja 비호환 문구가 네트워크 문구와 동일하다'
+        );
+    }
+
+    public function test_인라인_부트스트랩은_구형_브라우저_문법만_사용한다(): void
+    {
+        $html = $this->render();
+
+        preg_match('/<script>(.*?)<\/script>/s', $html, $m);
+        $this->assertNotEmpty($m, '인라인 부트스트랩 스크립트를 찾지 못했다');
+
+        // 주석 안의 백틱·화살표는 문법이 아니다 — 블록 주석과 줄 주석을 먼저 걷어낸다.
+        // 콜론 뒤의 `//` 는 URL 스킴이므로 주석으로 보지 않는다.
+        $js = preg_replace('#/\*.*?\*/#s', '', $m[1]);
+        $js = preg_replace('#(^|[^:])//[^\n]*#', '$1', $js);
+
+        // 코어 번들이 없어도 이 계층은 살아 있어야 한다 — ES2015+ 문법 금지.
+        $forbidden = [
+            '화살표 함수' => '/\)\s*=>/',
+            'const 선언' => '/(^|[^\w$])const\s+[A-Za-z_$]/m',
+            'let 선언' => '/(^|[^\w$])let\s+[A-Za-z_$]/m',
+            '템플릿 리터럴' => '/`/',
+            '옵셔널 체이닝' => '/\?\./',
+        ];
+
+        foreach ($forbidden as $label => $pattern) {
+            $this->assertSame(
+                0,
+                preg_match($pattern, $js),
+                "인라인 부트스트랩에 {$label} 사용 — 구형 브라우저에서 안내 화면조차 뜨지 않는다"
+            );
+        }
+    }
+}
@@ -0,0 +1,220 @@
+/**
+ * Smoke: 부팅 실패 사유별 안내 분기 (공개 #121)
+ *
+ * 번들을 **받았는데 실행되지 않는** 경우와 **끝내 받지 못한** 경우는 사용자가 취해야 할
+ * 행동이 정반대다. 전자는 새로고침해도 영원히 낫지 않으므로 "네트워크가 불안정하다 /
+ * 새로고침하라" 는 거짓 진단이고, 사용자는 자기 회선을 탓하게 된다.
+ *
+ * 기존 `network-resilience.spec.ts` 는 `route.abort()` 로 **네트워크 실패만** 모사한다.
+ * "다운로드는 되지만 파싱에 실패" 경로를 덮는 spec 이 없었던 것이 이번 결함(iOS 15 전
+ * 기기 부팅 불능)이 통과한 이유다.
+ *
+ * 파싱 실패 모사: 응답을 가로채 **파싱 불가한 정규식 리터럴**을 본문으로 돌려준다.
+ * 구형 Safari 가 lookbehind 를 거부하던 것과 같은 종류의 실패다 — 스크립트 태그는
+ * `error` 가 아니라 `load` 를 발생시키므로 재시도조차 일어나지 않고 곧장 tryInit 으로 간다.
+ *
+ * 진입점 두 곳(사용자·관리자)을 모두 잰다. 한쪽만 보면 blade 계층이 갈린 지점의
+ * 회귀를 놓친다.
+ */
+import { test, expect, type Page } from '@playwright/test';
+
+/** 코어 엔진 번들 URL 패턴 */
+const CORE_BUNDLE = '**/build/core/template-engine.min.js*';
+
+/**
+ * 파싱 불가한 스크립트 본문.
+ *
+ * `(?<@x)` 는 유효하지 않은 캡처 그룹 이름이라 정규식 **리터럴** 검증 단계에서 거부된다
+ * (구형 WebKit 이 lookbehind 를 거부하던 지점과 동일). 파일 전체가 실행되지 않으므로
+ * 앞줄의 대입조차 수행되지 않고 `window.G7Core` 는 정의되지 않는다.
+ */
+const UNPARSEABLE_JS = 'window.__g7ParseProbe = 1;\nvar broken = /(?<@x)y/;\n';
+
+/**
+ * 폴백 안내가 그려질 때까지 기다린 뒤 그 상태를 읽는다.
+ *
+ * 부재 단언은 **존재를 확정한 뒤**에만 의미가 있다 — 폴백 컨테이너가 뜨기 전에
+ * 버튼 수를 세면 렌더 전이라 0 이 나와 그냥 통과한다.
+ *
+ * @param page Playwright page
+ * @return 폴백 마커·문구·버튼 수
+ */
+async function readFallback(page: Page): Promise<{ reason: string | null; title: string; buttons: number }> {
+  const container = page.locator('#app [data-g7-bootstrap-fallback]');
+  await expect(container).toBeVisible({ timeout: 20_000 });
+
+  return page.evaluate(() => {
+    const el = document.querySelector('#app [data-g7-bootstrap-fallback]');
+    return {
+      reason: el ? el.getAttribute('data-g7-bootstrap-fallback') : null,
+      title: el?.querySelector('h1')?.textContent?.trim() ?? '',
+      buttons: el ? el.querySelectorAll('button').length : 0,
+    };
+  });
+}
+
+/**
+ * 파싱 실패 케이스 본문 — 진입점만 다르다.
+ *
+ * @param page Playwright page
+ * @param url 진입 경로
+ * @return {Promise<void>}
+ */
+async function assertParseFailure(page: Page, url: string): Promise<void> {
+  const pageErrors: string[] = [];
+  page.on('pageerror', (e) => pageErrors.push(String(e)));
+
+  await page.route(CORE_BUNDLE, (route) =>
+    route.fulfill({ status: 200, contentType: 'application/javascript', body: UNPARSEABLE_JS })
+  );
+
+  await page.goto(url);
+  await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
+
+  const fallback = await readFallback(page);
+
+  expect(fallback.reason).toBe('incompatible');
+  expect(fallback.title.length).toBeGreaterThan(0);
+  // 존재를 확정한 뒤의 부재 단언 — 새로고침 버튼이 없어야 한다
+  expect(fallback.buttons).toBe(0);
+
+  const state = await page.evaluate(() => ({
+    hasCore: typeof (window as any).G7Core !== 'undefined',
+    syntaxError: (window as any).__g7Bootstrap?.syntaxError,
+  }));
+  expect(state.hasCore).toBe(false);
+  expect(state.syntaxError).toBe(true);
+
+  expect(pageErrors.join(' | ')).toMatch(/SyntaxError/);
+}
+
+/**
+ * 네트워크 실패 케이스 본문 — 기존 문구·버튼·재시도 상한이 그대로여야 한다.
+ *
+ * @param page Playwright page
+ * @param url 진입 경로
+ * @return {Promise<void>}
+ */
+async function assertNetworkFailure(page: Page, url: string): Promise<void> {
+  let attempts = 0;
+  await page.route(CORE_BUNDLE, (route) => {
+    attempts += 1;
+    return route.abort('failed');
+  });
+
+  await page.goto(url);
+  await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
+
+  const fallback = await readFallback(page);
+
+  expect(fallback.reason).toBe('network');
+  expect(fallback.buttons).toBe(1);
+
+  // 재시도 상한(초기 1 + 재시도 2) 불변
+  expect(attempts).toBe(3);
+}
+
+/**
+ * 정상 부팅 케이스 본문 — 폴백이 오발동하지 않아야 한다.
+ *
+ * @param page Playwright page
+ * @param url 진입 경로
+ * @return {Promise<void>}
+ */
+async function assertNormalBoot(page: Page, url: string): Promise<void> {
+  await page.goto(url);
+  await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
+  await page.waitForFunction(
+    () => (document.querySelector('#app')?.childElementCount ?? 0) > 0,
+    { timeout: 20_000 }
+  );
+
+  const state = await page.evaluate(() => ({
+    failed: (window as any).__g7Bootstrap?.failed,
+    syntaxError: (window as any).__g7Bootstrap?.syntaxError,
+    hasCore: typeof (window as any).G7Core !== 'undefined',
+    fallbacks: document.querySelectorAll('#app [data-g7-bootstrap-fallback]').length,
+  }));
+
+  expect(state.hasCore).toBe(true);
+  expect(state.failed).toBe(false);
+  expect(state.syntaxError).toBe(false);
+  expect(state.fallbacks).toBe(0);
+}
+
+test.describe('부팅 실패 사유별 안내 분기 (공개 #121)', () => {
+  /**
+   * @scenario entrypoint=user, failure_mode=parse_error
+   * @effects syntax_error_renders_incompatible_notice, incompatible_notice_omits_reload_button
+   */
+  test('@smoke [user] 번들 파싱 실패 → 브라우저 비호환 안내 + 새로고침 버튼 부재', async ({ page }) => {
+    await assertParseFailure(page, '/');
+  });
+
+  /**
+   * @scenario entrypoint=admin, failure_mode=parse_error
+   * @effects syntax_error_renders_incompatible_notice, incompatible_notice_omits_reload_button
+   */
+  test('@smoke [admin] 번들 파싱 실패 → 브라우저 비호환 안내 + 새로고침 버튼 부재', async ({ page }) => {
+    await assertParseFailure(page, '/admin');
+  });
+
+  /**
+   * @scenario entrypoint=user, failure_mode=network_exhausted
+   * @effects network_failure_renders_network_notice, network_notice_keeps_reload_button
+   */
+  test('@smoke [user] 번들 상시 부재 → 기존 네트워크 안내 + 새로고침 버튼 유지', async ({ page }) => {
+    await assertNetworkFailure(page, '/');
+  });
+
+  /**
+   * @scenario entrypoint=admin, failure_mode=network_exhausted
+   * @effects network_failure_renders_network_notice, network_notice_keeps_reload_button
+   */
+  test('@smoke [admin] 번들 상시 부재 → 기존 네트워크 안내 + 새로고침 버튼 유지', async ({ page }) => {
+    await assertNetworkFailure(page, '/admin');
+  });
+
+  /**
+   * @scenario entrypoint=user, failure_mode=none
+   * @effects normal_boot_renders_no_fallback
+   */
+  test('@smoke [user] 정상 부팅 → 폴백 미렌더', async ({ page }) => {
+    await assertNormalBoot(page, '/');
+  });
+
+  /**
+   * @scenario entrypoint=admin, failure_mode=none
+   * @effects normal_boot_renders_no_fallback
+   */
+  test('@smoke [admin] 정상 부팅 → 폴백 미렌더', async ({ page }) => {
+    await assertNormalBoot(page, '/admin');
+  });
+
+  /**
+   * 서빙되는 코어 엔진 번들에 lookbehind 가 없다.
+   *
+   * 저장소 산출물은 정적 검사가 덮지만, **실제로 서빙되는 것**이 그 산출물인지는
+   * 별개 축이다(배포 경로·캐시·리버스 프록시). 브라우저가 받는 바이트를 직접 센다.
+   *
+   * @effects shipped_core_bundle_has_no_lookbehind
+   */
+  test('@smoke 서빙 중인 코어 엔진 번들에 정규식 lookbehind 가 없다', async ({ page }) => {
+    await page.goto('/');
+    await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
+
+    const probe = await page.evaluate(async () => {
+      const el = Array.from(document.querySelectorAll('script[src]')).find((s) =>
+        /template-engine\.min\.js/.test((s as HTMLScriptElement).src)
+      ) as HTMLScriptElement | undefined;
+      if (!el) return { found: false, bytes: 0, lookbehind: -1 };
+
+      const body = await fetch(el.src).then((r) => r.text());
+      return { found: true, bytes: body.length, lookbehind: (body.match(/\(\?<[!=]/g) || []).length };
+    });
+
+    expect(probe.found).toBe(true);
+    expect(probe.bytes).toBeGreaterThan(1000);
+    expect(probe.lookbehind).toBe(0);
+  });
+});
@@ -24,16 +24,39 @@ const DEAD_SCREEN = /초기화 실패|페이지 로딩 실패|Unknown action han
 /** 코어/컴포넌트 번들이 끝내 부재할 때 사용자에게 보여야 할 폴백 안내 */
 const FALLBACK_UI = /화면을 불러오지 못했습니다|Failed to load the page/;

+/**
+ * 자산 URL 이 **이중 모드**라는 사실을 흡수하는 매처 생성기.
+ *
+ * `asset_url_mode` 가 `extensionless` 인 사이트에서는 `.../routes.json` 이
+ * `.../routes` 로, `/api/modules/bundle.js` 가 `/api/modules/bundle/js` 로 나간다
+ * (nginx 정적 최적화 블록 우회 — `partials/asset-url-recovery` 참조).
+ * 확장자 형태만 매칭하면 그 사이트에서는 **한 건도 가로채지 못한 채** 테스트가
+ * "복구 성공" 처럼 조용히 통과하거나 카운터 0 으로 실패한다.
+ *
+ * @param base 확장자 앞까지의 경로 정규식 소스 (예: `\\/api\\/templates\\/[^/]+\\/routes`)
+ * @param ext 확장자 (예: 'json')
+ * @return URL 매처
+ */
+function suffixedPath(base: string, ext: string): (url: URL) => boolean {
+  const withExt = new RegExp(`^${base}\\.${ext}$`);
+  const without = new RegExp(`^${base}$`);
+  const segment = new RegExp(`^${base}\\/${ext}$`);
+  return (url: URL) => withExt.test(url.pathname) || without.test(url.pathname) || segment.test(url.pathname);
+}
+
 /**
 * 지정 패턴의 **첫 요청 1건만** 취소한다 (재시도 요청은 통과).
 *
 * 일시적 커넥션 유실을 모사한다 — 재시도가 실제로 복구하는지 보기 위함.
 *
 * @param page Playwright page
- * @param pattern 취소할 요청 URL glob
+ * @param pattern 취소할 요청 URL glob 또는 매처
 * @return 취소·통과 카운터 (재시도 발동 여부 확인용)
 */
-async function abortFirstRequestOnly(page: Page, pattern: string): Promise<{ hits: () => number }> {
+async function abortFirstRequestOnly(
+  page: Page,
+  pattern: string | ((url: URL) => boolean)
+): Promise<{ hits: () => number }> {
  let hits = 0;
  await page.route(pattern, (route) => {
    hits += 1;
@@ -50,10 +73,10 @@ async function bodyText(page: Page): Promise<string> {

 test.describe('네트워크 복원력 — 요청 1건의 일시 실패 (#463)', () => {
  // 각 경로의 첫 요청 1건을 취소해도 재시도로 복구되어 앱이 정상 렌더돼야 한다.
-  const SINGLE_ABORT_PATHS: Array<{ name: string; pattern: string }> = [
-    { name: 'routes.json', pattern: '**/api/templates/*/routes.json*' },
-    { name: 'components.json', pattern: '**/api/templates/*/components.json*' },
-    { name: 'modules/bundle.js', pattern: '**/api/modules/bundle.js*' },
+  const SINGLE_ABORT_PATHS: Array<{ name: string; pattern: string | ((url: URL) => boolean) }> = [
+    { name: 'routes.json', pattern: suffixedPath('\\/api\\/templates\\/[^/]+\\/routes', 'json') },
+    { name: 'components.json', pattern: suffixedPath('\\/api\\/templates\\/[^/]+\\/components', 'json') },
+    { name: 'modules/bundle.js', pattern: suffixedPath('\\/api\\/modules\\/bundle', 'js') },
    { name: 'layouts/*.json', pattern: '**/api/layouts/**' },
  ];

@@ -221,7 +244,7 @@ test.describe('네트워크 복원력 — 번들이 끝내 부재할 때 (#463)'
   */
  test('@smoke routes.json 상시 부재 → 명시적 에러 화면 + 새로고침 버튼', async ({ page }) => {
    let attempts = 0;
-    await page.route('**/api/templates/*/routes.json*', (route) => {
+    await page.route(suffixedPath('\\/api\\/templates\\/[^/]+\\/routes', 'json'), (route) => {
      attempts += 1;
      return route.abort('failed');
    });
@@ -251,7 +274,7 @@ test.describe('네트워크 복원력 — 번들이 끝내 부재할 때 (#463)'
   *   (b) `Unknown action handler: sirsoft-ecommerce.initPreferredCurrency` raw 노출
   */
  test('@smoke 모듈 번들 상시 부재 → 5초 블로킹 없이 렌더 + 내부 식별자 미노출', async ({ page }) => {
-    await page.route('**/api/modules/bundle.js*', (route) => route.abort('failed'));
+    await page.route(suffixedPath('\\/api\\/modules\\/bundle', 'js'), (route) => route.abort('failed'));

    // `waitUntil: 'commit'` — 기본값('load')은 취소된 번들의 재시도 체인까지 포함한
    // 모든 서브리소스를 기다리므로, 측정 시작점이 밀려 "렌더까지 걸린 시간" 이 아니라
@@ -0,0 +1,48 @@
+feature: bootstrap_parse_failure
+
+description: |
+  부팅 스크립트 실패 사유별 안내 분기 (공개 #121).
+
+  번들을 **받았는데 실행되지 않는** 경우와 **끝내 받지 못한** 경우는 사용자가 취해야 할
+  행동이 정반대다. 파싱 실패 시 스크립트 태그는 error 가 아니라 load 를 발생시키므로
+  재시도조차 일어나지 않고 곧장 "전역 부재" 경로로 간다 — 종전에는 그 경로가 네트워크
+  문구를 그대로 그려, 새로고침해도 낫지 않는 상황에서 새로고침을 권했다.
+
+  핵심 동작:
+    - window 의 error 이벤트로 번들 SyntaxError 를 관측(element 이벤트로는 구분 불가)
+    - 관측되면 renderFallback('incompatible') — 전용 문구 + 새로고침 버튼 생략
+    - 관측되지 않으면 renderFallback('corrupt') — 기존 문구 유지(사유 미상)
+    - 재시도 소진 경로는 renderFallback('network') — 기존 문구 + 버튼 유지
+    - 코어 엔진 번들에서 정규식 lookbehind 제거(파싱 하한 Safari 16.4 → 14.1)
+
+axes:
+  entrypoint: [user, admin]
+  failure_mode: [parse_error, network_exhausted, none]
+
+effects:
+  - syntax_error_renders_incompatible_notice
+  - incompatible_notice_omits_reload_button
+  - network_failure_renders_network_notice
+  - network_notice_keeps_reload_button
+  - normal_boot_renders_no_fallback
+  - shipped_core_bundle_has_no_lookbehind
+  - bootstrap_partial_emits_reason_branch
+  - incompatible_strings_defined_per_locale
+  - core_source_has_no_lookbehind
+  - variable_extraction_contract_unchanged
+  - shipped_bundle_lookbehind_blocked_by_static_check
+
+test_files:
+  - tests/Playwright/specs/smoke/bootstrap-parse-failure.spec.ts
+  - tests/Feature/View/BootstrapFallbackDiagnosisTest.php
+  - resources/js/core/template-engine/__tests__/DataBindingEngine.test.ts
+  - .claude/scripts/audit/__tests__/shipped-bundle-browser-baseline.test.cjs
+
+notes: |
+  로케일 축은 E2E cross product 에 넣지 않는다 — 화면 문구는 서버가 렌더한 문자열을
+  그대로 심는 구조라 브라우저 경로가 로케일마다 갈리지 않기 때문이다. ko/en/ja 문구의
+  실존과 상호 구분은 BootstrapFallbackDiagnosisTest 가 직접 단언하고, 번들 ja 언어팩의
+  키 동기는 언어팩 동기 검사가 담당한다.
+
+  하한 미만 실기기(iOS 15) 에서 "깨진 채로 이용 가능한가" 는 재현 수단이 없어 이 매니페스트
+  범위 밖이다 — 최신 WebKit(Playwright) 도 lookbehind 를 지원해 결함 자체가 재현되지 않는다.