결함 기록

이 문서는

MVP를 써 보다 찾은 결함(버그와 품질 문제)의 기록입니다. 결함마다 BUG- 번호를 붙이고, 그 결함이 다시 생기지 않는지 보는 회귀 테스트의 이름에 같은 번호를 적습니다(T-0285 · BUG-01: …, 앞의 T-는 테스트의 ID → DR-0022). 테스트 목록(99-test-list)이 그 번호로 이 문서와 테스트를 잇습니다. 이 문서의 테스트 ID는 테스트 목록의 그 파일 표로 가는 링크입니다(사이트에서는 그 줄로 갑니다). 링크가 다른 표를 가리키면 테스트 목록 검사가 실패합니다.

  • 번호는 불변이고 다시 쓰지 않습니다. 새 결함은 다음 번호를 받습니다.
  • 고친 결함도 지우지 않습니다. 언제 무엇이 깨졌고 무엇이 막고 있는지의 기록입니다.
  • 표에는 ID · 찾은 날 · 증상 · 상태만 두고, 찾은 사람 · 원인 · 고친 곳 · 회귀 테스트는 표 아래 결함마다의 절에 적습니다.
  • 회귀 테스트가 없는 결함은 그 절에 까닭을 적습니다. 테스트 목록의 “테스트가 없는 ID”에도 나옵니다.
  • 개발하다 테스트가 먼저 잡은 것(예: 인수 테스트를 만들며 고친 여섯, 2026-11-01-01-confirmations-terms-mvp)은 그 테스트가 이미 지키므로 여기에 적지 않습니다.
ID찾은 날증상상태
BUG-012026-11-01브라우저 화면보다 큰 다이어그램에 스크롤바가 나오지 않음고침
BUG-022026-11-01툴바의 “예제 ▾” 등 드롭다운을 눌러도 아무것도 보이지 않음고침
BUG-032026-11-01Galaxy S26의 Chrome에서 한참을 기다려도 MVP 화면이 뜨지 않음고침(S26에서 확인함)
BUG-042026-11-01S26의 툴바에 “예제” 버튼이 보이지 않음고침
BUG-052026-11-02메뉴 바의 메뉴를 마우스로 연 뒤 Esc를 눌러도 닫히지 않음고침
BUG-062026-11-03설계 문서 사이트에서 왼쪽 위 AriadneNSD를 누르면 앱이 “불러오는 중…”에서 멈춤고침
BUG-072026-11-03선택한 블록의 주황 테두리가 오른쪽 · 아래에서 안쪽으로 더 들어가 보임고침
BUG-082026-11-03a를 눌러 키 힌트가 뜬 뒤 빈 곳을 클릭해도 힌트가 남음고침
BUG-092026-11-03블록이나 선택 영역을 드래그하면 지나간 블록들의 글자가 하이라이트됨고침
BUG-102026-11-03빈 default 칸에서 복사 · 잘라내기를 하면 “삭제할 default 분기가 없습니다”라고 알림고침
BUG-112026-11-03헤더에서 붙여넣기 · 감싸기 · 풀기를 하면 “먼저 블록을 선택하세요”라고 알림고침
BUG-122026-11-03분기 라벨 · 빈 default 칸에서 Ctrl+← →가 If · Case 블록에서 출발함(If의 오른쪽 라벨에서 Ctrl+→를 누르면 왼쪽 분기의 첫 블록으로 감)고침
BUG-132026-11-03호출 블록을 텍스트로 복사하면 Method 이름이 빠짐(ys ← MergeSort(xs)가 ys xs로, 결과 · 인자가 없으면 빈 줄로)고침
BUG-142026-11-03드래그한 블록을 제자리에 드롭하면 바뀐 것도 실행 취소 단계도 없는데 드롭 함수가 “문서가 바뀜”(true)을 돌려줌고침
BUG-152026-11-04텍스트 외곽선으로 저장한 그림과 PDF에서 기울임 텍스트(이름 없는 접기 영역의 기본 이름, 접힌 분기의 ”⋯ 블록 n개”)가 바로 선 글자로 나옴고침
BUG-162026-11-17접기 영역을 펼치면 이름 띠와 첫 블록 사이의 선이 빠짐(프로토타입에는 있음)고침
BUG-172026-11-19접힌 접기 영역의 펼침 삼각형(▸)이 이름보다 7px 위에 붙음고침
BUG-182026-11-21같은 문서를 연 탭이 둘이면 나중 탭의 우상단에 “보기만 하는 중”만 보이고, 까닭과 편집으로 돌아갈 길을 알 수 없음고침
BUG-192026-11-21110% 같은 배율에서 1px 구조선이 1px과 2px로 섞여 두꺼운 외곽선처럼 보임고침

BUG-01

  • 찾은 사람: 메인테이너
  • 원인: 화면 틀의 자리와 캔버스가 같은 클래스 ans-canvas를 써서 틀의 overflow: hidden이 캔버스에도 먹음
  • 고친 곳: 2026-11-01-03-mvp-scroll-dropdown
  • 회귀 테스트: T-0285 창보다 큰 다이어그램은 캔버스 안에서 스크롤된다 (E2E, apps/web/e2e/examples.spec.ts)

BUG-02

  • 찾은 사람: 메인테이너
  • 원인: 툴바의 overflow-x: auto가 세로도 auto로 만들어 드롭다운이 툴바 안에 갇힘
  • 고친 곳: 2026-11-01-03-mvp-scroll-dropdown
  • 회귀 테스트: T-0284 툴바의 드롭다운은 툴바 안이 아니라 캔버스 위에 열린다 (E2E, apps/web/e2e/examples.spec.ts)

BUG-03

  • 찾은 사람: 메인테이너
  • 원인: 화면을 그리기 전에 IndexedDB를 여는데 시간 제한이 없음(원인 후보였고, 3초 제한을 넣은 뒤 S26에서 뜸)
  • 고친 곳: 2026-11-01-04-examples-button-android-load
  • 회귀 테스트: (E2E, apps/web/e2e/boot.spec.ts)
    • T-0278 indexedDB.open이 끝내 답하지 않아도 편집기가 뜬다
    • T-0279 시작하다 실패하면 시작 화면에 그 사실을 보인다

BUG-04

  • 찾은 사람: 메인테이너
  • 원인: 툴바의 예제를 드롭다운에서 버튼으로 바꿀 때(EX4) “넓은 화면에서만” 클래스를 그대로 둠. E2E가 노트북 크기로만 봐서 못 잡음
  • 고친 곳: 2026-11-01-04-examples-button-android-load
  • 회귀 테스트: T-0290 휴대폰의 툴바에 “예제”가 보이고, 탭하면 모달이 열린다 (E2E, apps/web/e2e/mobile.spec.ts)

BUG-05

  • 찾은 사람: Claude(사용법 그림을 찍다 발견)
  • 원인: 마우스로 열면 포커스가 메뉴 제목 버튼에 남는데, 그 버튼은 ↓만 받고 Esc는 메뉴 안(드롭다운)에서만 받았음
  • 고친 곳: 메뉴가 열려 있는 동안 문서 어디서든 Esc로 닫음(packages/editor/src/ui/menu-bar.tsx의 useCloseMenu)
  • 회귀 테스트: T-0286 마우스로 연 메뉴를 Esc가 닫는다 (E2E, apps/web/e2e/examples.spec.ts)

BUG-06

  • 찾은 사람: 메인테이너
  • 증상의 자세한 모습: 설계 문서 사이트(/about 등)에서 왼쪽 위 AriadneNSD를 누르면 앱이 “불러오는 중…”에서 멈추고 왼쪽 목록이 되풀이됨
  • 원인: Quartz의 SPA가 같은 사이트의 링크를 모두 가로채 받은 HTML의 본문만 갈아 끼움. 첫 화면이 앱이 된 뒤(DR-0021) 앱의 HTML이 문서 사이트 안에 끼워지고 앱의 스크립트는 돌지 않음
  • 고친 곳: site/patch-quartz.mjs: /, /app/, /manual/로 가는 링크는 SPA가 가로채지 않고 브라우저가 새로 불러옴
  • 회귀 테스트: 없음. 사이트 빌드(Quartz)에 붙은 것이라 앱의 E2E 밖. 로컬 사이트 빌드에서 제목을 눌러 앱이 뜨는 것을 확인함

BUG-07

  • 찾은 사람: 메인테이너
  • 증상의 자세한 모습: 주황 테두리가 왼쪽 · 위보다 오른쪽 · 아래에서 안쪽으로 더 들어가 보이고, 오른쪽 · 아래에는 블록의 파란 선이 바깥에 드러남
  • 원인: 문서 그림은 1px 선을 또렷하게 하려고 반 픽셀 밀어 그려서(04-visual-design 9.1) 상자의 오른쪽 · 아래 선이 상자 바깥 1px에 놓임. 오버레이의 테두리는 상자 안에만 그림
  • 고친 곳: packages/editor/src/dom/overlay.ts: 선택 · 호버 테두리가 그 1px까지 덮음
  • 회귀 테스트: T-0229 선택 테두리가 블록의 선을 네 변 모두 똑같이 덮는다 (단위, packages/editor/src/dom/overlay.test.ts)

BUG-08

  • 찾은 사람: 메인테이너
  • 원인: 기다리던 첫 키를 버리는 곳이 다른 키와 Esc뿐이었음
  • 고친 곳: packages/editor/src/dom/canvas-view.ts: 캔버스를 누르거나 포커스가 캔버스를 떠나면 버림 → K4
  • 회귀 테스트: T-0203 빈 캔버스를 클릭하면 a를 기다리던 키 힌트가 닫힌다 (E2E, apps/web/e2e/canvas.spec.ts)

BUG-09

  • 찾은 사람: 메인테이너
  • 원인: 그림의 글자(SVG text)가 브라우저의 글자 선택 대상이었음
  • 고친 곳: packages/editor/src/dom/styles.ts: 캔버스는 user-select: none, 인라인 에디터만 글자 선택
  • 회귀 테스트: T-0205 블록을 끌어도 그려진 글자가 선택되지 않는다 (E2E, apps/web/e2e/canvas.spec.ts)

BUG-10

  • 찾은 사람: Claude(리팩토링 전의 테스트를 더하다 발견, 2026-11-03-05-tests-before-refactoring)
  • 원인: 복사 · 잘라내기 · 삭제가 공통 검사 blocksOnly 하나를 써서 빈 default 칸에서는 셋 모두 삭제의 문구가 나옴
  • 고친 곳: packages/editor/src/commands/editor-commands.ts: blocksOnly가 빈 default 칸의 문구를 명령마다 받음(복사 “빈 칸에는 복사할 블록이 없습니다.”, 잘라내기 “빈 칸에는 잘라낼 블록이 없습니다.”), 메시지 카탈로그(packages/editor/src/i18n/messages.ts)
  • 회귀 테스트: T-0797 빈 default 칸에서 복사 · 잘라내기를 하면 삭제할 default가 없다가 아니라 거기에 블록이 없다고 알린다 (단위, packages/editor/src/commands/editor-commands.test.ts)

BUG-11

  • 찾은 사람: Claude(리팩토링 전의 테스트를 더하다 발견, 2026-11-03-05-tests-before-refactoring)
  • 증상의 자세한 모습: 같은 헤더에서 복사 · 잘라내기는 “헤더에서는 되지 않습니다”라고 알리는데, 붙여넣기 · 감싸기 · 풀기는 선택한 것이 없다고 알림
  • 원인: 붙여넣기 · 감싸기 · 풀기의 when이 헤더를 따로 보지 않아 “선택 없음”의 문구로 떨어짐
  • 고친 곳: packages/editor/src/commands/editor-commands.ts: 헤더에서 붙여넣기는 “헤더에는 붙여넣을 수 없습니다.”, 감싸기는 “헤더는 감쌀 수 없습니다.”, 풀기는 “헤더에서는 되지 않습니다. 블록을 선택하세요.”라고 알림, 메시지 카탈로그(packages/editor/src/i18n/messages.ts)
  • 회귀 테스트: T-0798 헤더에서 붙여넣기 · 감싸기 · 풀기를 하면 선택한 것이 없다가 아니라 헤더라서 안 된다고 알린다 (단위, packages/editor/src/commands/editor-commands.test.ts)

BUG-12

  • 찾은 사람: Claude(리팩토링 전의 테스트를 더하다 발견, 2026-11-03-05-tests-before-refactoring)
  • 원인: Ctrl+← →가 선택의 초점 블록(focusBlock)에서 출발해, 분기 라벨과 빈 default 칸에서는 그 If · Case 블록에서 출발함. If · Case 블록은 분기 밖이라 Ctrl+→가 ↓처럼 움직여 첫 분기로 들어감
  • 고친 곳: packages/editor/src/navigation/navigate.ts: 분기 라벨은 그 분기 안, 빈 default 칸은 그 Case의 가장 오른쪽 칸으로 보고 옆 분기를 찾음. 그쪽에 없으면 한 겹 바깥 If · Case로 가고, 바깥에도 없으면 움직이지 않음
  • 회귀 테스트: T-0799 분기 라벨에서 Ctrl+→는 If · Case 블록에서 출발하지 않고 그 If · Case의 다음 분기로 간다 (단위, packages/editor/src/navigation/navigate.test.ts)

BUG-13

  • 찾은 사람: Claude(리팩토링 전의 테스트를 더하다 발견, 2026-11-03-05-tests-before-refactoring)
  • 원인: 클립보드의 텍스트(clipToText)가 호출 블록에서 결과와 인자만 이어 적고, 레이아웃이 그리는 이름 · 결과 기호 · 괄호를 적지 않음
  • 고친 곳: packages/core/src/layout/call-text.ts: 호출 블록의 그려지는 텍스트(callParts · callText)를 레이아웃에서 떼어 내 내보냄. packages/editor/src/clipboard/clip-format.ts가 그것으로 그려진 대로 적음(ys ← MergeSort(xs), 결과가 없으면 MergeSort(xs), 둘 다 없으면 MergeSort(), 결과 기호는 문서의 =도 따름). 복사할 때 문서의 다이어그램과 결과 기호를 넘김(packages/editor/src/commands/editor-commands.ts)
  • 회귀 테스트: T-0800 복사한 호출 블록은 Method 이름을 잃지 않고, 그려진 대로 적힌다 (단위, packages/editor/src/clipboard/clip-format.test.ts)

BUG-14

  • 찾은 사람: Claude(리팩토링 전의 테스트를 더하다 발견, 2026-11-03-05-tests-before-refactoring)
  • 원인: runDrop이 명령이 받아들여졌는지(session.commit)를 그대로 돌려줌. 제자리로의 이동은 받아들여지지만 내용이 그대로라 실행 취소 단계가 생기지 않음. 함수 주석은 “문서가 바뀌었는지”라고 적혀 있었음. 화면에는 영향 없음, 셸이 이 값을 믿으면 헷갈릴 수 있음
  • 고친 곳: packages/editor/src/commands/drop-command.ts: 드롭 뒤 내용이 그대로면 false를 돌려줌. 주석에 거절되었거나 제자리에 놓였을 때 false라고 적음
  • 회귀 테스트: T-0801 분기 안의 범위를 제자리에 드롭하면 문서가 바뀌지 않았다고 알린다 (단위, packages/editor/src/commands/drop-command.test.ts)

BUG-15

  • 찾은 사람: Claude(2026-11-04, 11-03 밤에 에이전트들이 만든 접기 묶음과 내보내기 묶음을 합친 뒤 → 매듭 뒤 (2026-11-03 밤 ~ 11-04))
  • 증상의 자세한 모습: 화면과 보통의 저장 그림은 기울임(font-style="italic")으로 그리지만, 텍스트 외곽선(문서 설정 → OL1)과 PDF(PD1)는 바로 선 글자로 그림. 레이아웃과 글자 폭은 그대로라 자리는 어긋나지 않음
  • 원인: 외곽선과 PDF는 번들 글꼴(보통 굵기 하나)의 글리프를 그대로 쓰고, 기울임 글꼴이 없어 장면의 기울임 표시(TextRun.isItalic)를 따르지 않음 → ADR-0045. 두 에이전트가 나란히 만들어 서로의 것을 보지 못함
  • 고친 곳: 글리프 외곽선을 기준선 기준으로 기울여 그림 → SL1. packages/core/src/render/outline-text.ts: 놓인 글리프가 런의 기울임을 보유하고 slantedCommands가 외곽선을 기울임(glyphPathData가 사용). packages/core/src/export/pdf.ts: 기울인 글리프를 별도의 폼 XObject로 씀
  • 회귀 테스트:
    • T-1316 기울임 런은 기준선을 기준으로 기울이고 보통 런은 바로 세워 둔다 (단위, packages/core/src/render/outline-text.test.ts)
    • T-1317 굵은 기울임 런의 테두리와 합성 굵게를 글리프와 함께 기울인다 (단위, 같은 파일)
    • T-1318 기울인 좌표도 다른 좌표처럼 소수 둘째 자리로 반올림한다 (단위, 같은 파일)
    • T-1312 기울임 런의 외곽선을 기울이고 보통 텍스트는 바로 세워 둔다 (단위, packages/core/src/export/pdf.test.ts)
    • T-1313 한 요소의 기울임 런과 보통 런을 각자의 폼으로 그린다 (단위, 같은 파일)
    • T-1314 합성 굵게도 글리프와 함께 기울인다 (단위, 같은 파일)
    • T-1315 기울인 글리프를 바로 선 글리프와 같은 자리에 놓고, 다시 만들어도 같은 바이트다 (단위, 같은 파일)

BUG-16

  • 찾은 사람: 메인테이너(2026-11-17 inbox: “MVP는 접기영역을 만들고 폈을 때, 제목 아래 선이 빠졌습니다. 프로토타입과 비교해보시지요.“)
  • 원인: 펼친 접기 영역의 이름 띠는 안의 블록보다 나중에 그린다(테두리가 블록의 바깥 선을 덮도록). 그런데 띠의 사각형이 테두리 선을 띠 배경색(fold.band)으로 그려, 첫 블록의 윗선을 지웠다. 프로토타입은 띠 아래에 구조선을 따로 그렸고, 펴 보인 호출 블록의 띠는 구조선 색으로 그린다
  • 고친 곳: packages/core/src/render/build-scene.ts의 foldFrame: 띠의 테두리를 line.structure로 그림. 띠의 위 · 양옆 선은 3px 테두리 아래에 깔려 보이지 않음
  • 회귀 테스트: T-1174 펼친 접기 영역은 이름 띠 아래의 구조선을 그린다(첫 블록이 처리 · If · 반복일 때, 겹친 접기 영역, 테마 넷) (단위, packages/core/src/layout/fold-layout.test.ts)

BUG-17

  • 찾은 사람: 메인테이너(2026-11-19: “접힌 접기 영역의 작은 삼각형 위치가 위쪽에 붙어있는데, 의도한 것인가요?“)
  • 원인: 펼침 삼각형의 세로 중심을 이름 띠(18px)의 가운데로 계산하는 식을 접힌 칸에도 썼다. 그래서 삼각형의 중심은 칸 위에서 9px, 이름 첫 줄의 가운데는 16px이 되어 7px 어긋났다
  • 고친 곳: packages/editor/src/dom/overlay.ts의 triangle: 접힌 칸의 ▸는 이름 첫 줄의 가운데(space.pad-y + space.line / 2 = 16px)에 둠. 이름 띠와 펴 보기 띠의 ▾는 그대로(9px). 편집 레이어만 바뀌므로 저장되는 그림은 같음 → FD11
  • 회귀 테스트: T-1320 접힌 칸의 삼각형은 이름과 나란하다, T-1321 이름이 여러 줄이어도 첫 줄에 둔다, T-1322 이름 띠의 삼각형은 띠의 가운데에 그대로 둔다 (단위, packages/editor/src/dom/overlay.test.ts)

BUG-18

  • 찾은 사람: 메인테이너(2026-11-21: “로컬서버에서 실행하고 있는데, 보기만 하는 중이라는 우상단 메시지가 나오고 편집가능으로 갈 방법이 없습니다.” 탭을 하나만 남기니 편집이 됨)
  • 원인: 웹 앱은 한 문서를 한 탭에서만 편집한다(탭 잠금, apps/web/src/shell/tab-lock.ts). 잠긴 탭에는 “다른 탭에서 이 파일을 편집하고 있습니다. 이 탭은 보기만 합니다.”를 알리지만 상태 줄의 알림이라 곧 사라지고, 그 뒤에는 까닭 없는 “보기만 하는 중”만 남는다
  • 고친 곳: 셸이 편집기에 보기만 하는 까닭을 알림. EditorHandle.open의 readOnlyReason과 setReadOnly(readOnly, reason)('otherTab'), DocStatus.readOnlyReason(packages/editor/src/contracts.ts, apps/web/src/editor-contract.ts, create-editor.ts). 웹 셸(web-shell.ts)은 switchTo와 start에서 잠금을 못 얻으면 이 까닭을 넘기고, 잠금을 되찾으면 지움. 메뉴 줄 우상단 라벨(ui/menu-bar.tsx)은 까닭이 otherTab이면 “보기만 하는 중 · 다른 탭에서 편집 중”과 “그 탭을 닫으면 여기서 편집할 수 있습니다.” 툴팁을 보임(ui/messages.ts의 status.readOnly.otherTab, 영어 · 한국어). 공유 링크 보기와 그 밖의 보기만 하는 경우는 그대로
  • 회귀 테스트: T-1444 까닭을 넘기고 잠금을 되찾으면 지운다, T-1446 공유 링크의 보기에는 까닭이 없다 (단위, apps/web/src/shell/web-shell.test.ts), T-1447 까닭이 있으면 라벨과 툴팁이 달라진다 (단위, packages/editor/src/ui/editor-app.test.tsx)

BUG-19

  • 찾은 사람: 메인테이너(2026-11-21, inbox: 두꺼운 외곽선이 보인다는 신고와 스크린숏 atelier/sessions/assets/2026-11-21-thick-outline-*.png, 이튿날 110%에서 재현한 atelier/sessions/assets/2026-11-22-thick-outline-zoom-110.png)
  • 원인: 편집 화면은 저장 SVG를 CSS scale(배율)로 키우고 그 위에 devicePixelRatio가 곱해진다. 사각형은 shape-rendering="crispEdges"라 브라우저가 선의 양쪽 가장자리를 장치 픽셀로 반올림하는데, 1px 선이 110%에서는 1.1 장치 픽셀이라 놓인 자리에 따라 1px도 되고 2px도 된다(배율 1.1에서 가로선의 약 1/3이 2px)
  • 고친 곳: 화면에서만, 크리스프 사각형과 가로세로로만 이은 채우지 않은 경로(Case 갈래 선, 호출 막대)의 stroke-width를 max(1, round(굵기 × 배율)) / 배율(배율 = 줌 × devicePixelRatio)로 바꿔 언제나 정수 장치 픽셀이 되게 함(packages/editor/src/dom/crisp-lines.ts, canvas-view.ts). 빗금과 곡선은 안티앨리어싱 그대로. 그림을 다시 그리거나 줌 · devicePixelRatio가 바뀌면 다시 맞춤. 저장하는 .ns.svg의 바이트는 그대로 → 9.2 배율과 출력. 커밋 70deffa
  • 회귀 테스트: T-1480, T-1481, T-1483 (단위, packages/editor/src/dom/crisp-lines.test.ts), T-1482 (단위, packages/editor/src/dom/canvas-view.test.ts)