[Tracking] cortex 성능·접근성 개선 로드맵 (2026-09)

[akcorca]

cortex(corca-ai/cortex)를 빠르고 유익하게 만들기 위한 wasmtex/cortex 성능·접근성 작업의 트래킹 이슈. 2026-09-02 전방위 검토 결과에서 추린 우선순위 5개를 하나씩 차근차근, 실측하여 성공한 것만 반영한다.

순서

1. [Perf] 콜드 스타트: 의존성 클로저 프리페치, 번들, 영구 캐시 수정, brotli #80 콜드 스타트: 의존성 클로저 프리페치, 번들, 영구 캐시 수정, brotli — cortex 측 corca-ai/cortex#898
2. [Perf] 임의 줄 힙 스냅샷 체크포인트로 증분 컴파일 일반화 #81 임의 줄 힙 스냅샷 체크포인트로 증분 컴파일 일반화
3. [Perf] TikZ/pgfplots 병렬 외부화 워커 풀 #82 TikZ/pgfplots 병렬 외부화 워커 풀
4. [Perf] Emscripten 업그레이드 + O3/LTO/wasm-opt + 메모리 예산 실측 #83 Emscripten 업그레이드 + O3/LTO/wasm-opt + 메모리 예산 실측
5. [A11y] 접근성 PDF 내보내기(\DocumentMetadata 태깅) + alt 린트 #84 접근성 PDF 내보내기 + alt 린트 — cortex 측 corca-ai/cortex#899

현재 실측 기준선

항목	값	출처
콜드 첫 PDF pdfLaTeX / XeLaTeX / LuaLaTeX	9.1s / 12.8s / 15.7s	cortex docs/operations/tex-live-r2-profile-cutover-2026-08-28.md
wasmtex warmup 적용 첫 PDF	~2.9s (미적용 ~4.9s)	wasmtex docs/warmup.md
LuaLaTeX 본문 편집 재컴파일	~0.4–0.5s	wasmtex docs/engine.md
증분 fast paint	~200ms, 단 \clearpage 경계 필요	wasmtex docs/api.md
엔진 빌드	Emscripten 3.1.46, -O2, wasm-opt/LTO/SIMD 없음	wasm-build/

진행 규칙

• 각 이슈는 baseline 측정 → 변경 → 재측정 → 숫자를 첨부한 PR 순서.
• cortex 변경은 origin/main 기반 워크트리에서 PR을 열고 게이트 통과 후 머지.
• WASM 빌드 실험은 neverland(x86_64 Linux + Docker)에서.
• 개선이 재현되지 않으면 반영하지 않고 이유를 해당 이슈에 기록한다.

[akcorca]

2026-09-02 진행 요약

1번(#80) 진행 중, 나머지는 아직 착수 전.

• 머지: wasmtex fix: keep preloaded TFM and VF cache files apart #86, feat: report the exact TeX Live dependency set for prefetch #87, fix: replay a dependency set on top of the built-in warmup manifest #88 / cortex #900.
• 실측: wasmtex 단독 IEEE 콜드 13.7 s → 2.7 s, NeurIPS 44 s → 3.2 s(동기 요청 0). cortex 앱 내 IEEE 재오픈 16.8–19.2 s → 3.8–7.8 s(현 엔진은 네트워크 조회만 기록).
• 대기: wasmtex release: promote pdfTeX components with the preload cache-path fix #89(pdfTeX 패밀리 승격, 드래프트) — 대응 소스 아카이브 GitHub 릴리스 게시가 운영자 단계. 그 뒤 cortex 새 engineRevision 프로파일 → persistentCache: true 복구.
• 운영자 확인 필요: texlive.corca.ai Cloudflare Cache Rule(현재 cf-cache-status: DYNAMIC)과 압축.

[akcorca]

2026-09-02 진행 요약 (2)

• 머지: wasmtex release: promote pdfTeX components with the preload cache-path fix #89(pdfTeX 패밀리 승격, 릴리스 engine-2025-ef5cac8f90e55c51 / engine-2026-8c7d991e953babac 게시), docs: record the mirror's edge cache and compression rules #90(미러 에지 규칙 문서), fix: report the session-cumulative TeX Live dependency set #91(세션 누적 의존성 집합 — 프리앰블 스냅샷 컴파일이 집합을 1–6개로 줄이던 문제).
• 인프라: texlive.corca.ai Cache Rule + Compression Rule 적용(HIT + brotli). 선반입 없는 콜드 IEEE 12–23 s → 7.3 s(HIT), NeurIPS 30–44 s → 16.4 s.
• cortex #901(새 엔진 프로파일 2종, 52/52 × 2회 자격 통과) CI 후 자동 머지 대기. 템플릿 팩 PR은 팩 재생성(약 2h) 후 열림.
• [Perf] 임의 줄 힙 스냅샷 체크포인트로 증분 컴파일 일반화 #81 조사: 임의 줄 체크포인트는 Asyncify 재빌드가 필요 → [Perf] Emscripten 업그레이드 + O3/LTO/wasm-opt + 메모리 예산 실측 #83 툴체인 실험과 묶어 진행 순서 조정([Perf] 콜드 스타트: 의존성 클로저 프리페치, 번들, 영구 캐시 수정, brotli #80 → [Perf] Emscripten 업그레이드 + O3/LTO/wasm-opt + 메모리 예산 실측 #83 → [Perf] 임의 줄 힙 스냅샷 체크포인트로 증분 컴파일 일반화 #81).

[akcorca]

2026-09-02 진행 요약 (3) — #80 1차 사이클 종료

머지: cortex #901(수정 엔진 프로파일 2종, 52/52 × 2회 자격), #902(콘텐츠 주소 엔진 릴리스 디렉터리 immutable), #903(템플릿 의존성 팩 52개 × 2 프로파일, 새 프로젝트·try 워크스페이스 첫 오픈 선반입).

#80에서 남긴 것: 서버측 프로젝트별 집합(새 기기 첫 오픈; 팩이 템플릿 프로젝트를 덮으므로 우선순위 낮음), SW 트림 idle 이동(트림은 이미 응답 후 waitUntil에서 확률·간격 제한으로 실행돼 이득 없음 → 하지 않음).

다음: #83 툴체인 실험 시작(neverland에서 -O3, -O3+LTO 변형 빌드 중; 기준 -O2 벤치: heavy 113 ms 웜/229 ms 전체, IEEE 97/235, ACM 204/534, Beamer 180/522). Asyncify 실험은 #81 전제.

[akcorca]

2026-09-02 진행 요약 (4)

• 프로덕션 인시던트(cortex #905) 두 원인 수정·배포·확인, 유휴 폴링 낭비(#907) 수정·배포.
• [Perf] Emscripten 업그레이드 + O3/LTO/wasm-opt + 메모리 예산 실측 #83: -O3(미반영), -O3+LTO(링크 실패), Emscripten 6.0.9(속도 이득 없음, 미반영). 6.x 이미지는 [Perf] 임의 줄 힙 스냅샷 체크포인트로 증분 컴파일 일반화 #81 실험용 유지.
• [Perf] 임의 줄 힙 스냅샷 체크포인트로 증분 컴파일 일반화 #81: Asyncify +13–27%로 상시 적용 불가, JSPI는 빌드 가능하나 비동기 컨트롤러 포팅 필요 → 설계 선행. 보류.
• 다음: [Perf] TikZ/pgfplots 병렬 외부화 워커 풀 #82 TikZ 병렬 외부화 착수.

[akcorca]

#82 first cycle landed: wasmtex #92 (b7367d0) — TikZ figures externalized via the upstream external library on a sibling-compiler pool. 15-picture doc warm text recompile 1130 ms → 130 ms. cortex pin bump PR in progress; mode: 'auto' deferred to a per-project setting.

[akcorca]

#82 cycle 2 landed: wasmtex #93 (53fd56b) auto mode with never-worse-than-inline contract; cortex #910 (5cd2d96) switches the browser compiler to mode: 'auto'. Per-project opt-out: % !WASMTEX tikz-externalization = off in the main file. #82 complete; next #84.

[akcorca]

#84 first cycle landed: wasmtex #94 (accessible export + a11y lint) and #95 (lazy export/pool modules); cortex #911 adds the preview's Download accessible PDF button with a read-back report dialog (TeX Live 2026 profile, throwaway engine). Left on #84: measuring tagging success across the cortex template set and a veraPDF pass-rate run in CI.

[akcorca]

#81 (arbitrary-line heap checkpoints) shipped: wasmtex #96 (Asyncify checkpoint engine + HeapCheckpointCompiler), #97 (CI artifact), #98 (engine releases engine-2025-02f4435f650ea027 / engine-2026-4f5a81441b5f5fff), #99 (worker fallback). cortex adoption in corca-ai/cortex#912 (qualified profiles tl2025-final-02f4435, tl2026-20260826-4f5a814: features + 52/52 templates).

Roadmap state: #80 done (leftovers listed there), #81 done, #82 done, #83 closed (no measured win), #84 done. Remaining follow-ups: persistent TikZ figure cache, template tagging-rate sweep for #84.

[akcorca]

In-app verification of #81 (2026-09-03), worker message trace on cortex /try with a 24-page article:

• Found two reasons the fast path never ran in the app: /try (and any project without a stored profile id) compiled on the legacy engine profile without a checkpoint build → cortex #916 pins the trial to the latest profile. And cortex re-asserts the main file before every compile while setMainFile() dropped both heap and page-break checkpoints → wasmtex fix: keep checkpoints when setMainFile re-asserts the same main file #101 keeps them when the path is unchanged (cortex #917 pins it).
• After: edits resumed in 21 / 18 / 18 ms against a 200 ms full compile (compileheapcheckpoint in the trace). Before: every edit was dropheapcheckpoints → compilelatex, 127–341 ms.
• Note: existing projects created before per-project profile pinning stay on the legacy engine by policy, so they do not get checkpoints until their profile is advanced.

[akcorca]

Cold first-render mirror misses (2026-09-03): a report of 20–30 mirror 404s at 300–400 ms each per first render. Causes: the pdfTeX worker fetched kpathsea's exact name before the bucket's bare font name (one guaranteed 404 per VF/TFM) and fanned a missing config out into up to seven 404s on a bloom collision (1e-2 filter, measured 0.68 %); and the edge never cached a 404. Fixed by wasmtex #102 (per-candidate bloom filtering), #103 (bloom-filter.v2.bin at 1e-4 with fallback, uploaded to the three active snapshots), the texlive.corca.ai cache rule (404 cached one day under immutable snapshots), engine release #104 (2025-9f8151e4f28266f0, 2026-60d599ede070564a), and cortex #920 (profiles tl2025-final-9f8151e / tl2026-20260826-60d599e, regenerated template dependency packs). Measured on a times+natbib+microtype article: 11 misses / 4.0 s → 2 / 0.3 s before the edge cache; production verification below.

[akcorca]

이번 엔진·SDK·CorTeX 통합 컴파일 성능 실험과 공동 릴리스는 #113 에서 순서와 채택/보류 판정을 통합 관리합니다. 기존 로드맵의 접근성 등 별도 범위와 기록은 그대로 유지합니다. 중간 실험은 최신 origin/main 기반 전용 워크트리에 유지하고, 채택된 조합의 최종 공동 gate 뒤 릴리스합니다.