Rekindle Quest / 📁 Filesystem Is Truth · 4/4 이 줄 누가 썼어?

L MK님, 어제 Lantern 질문에 이어서 이번엔 Rekindle까지 파고드시네요. 질문이 정확히 헷갈리기 쉬운 지점을 짚고 있어서, 실제 코드 기준으로 차근차근 풀어볼게요.

1. transaction 은 "문서"가 아니라 "변경 사건"이에요

말씀하신 대로 문서 A → 문서 A' 로 상태를 바꾸는 객체가 맞아요. CodeMirror 6 에서는 편집기 상태(EditorState)가 불변이고, 키 하나를 눌러도 "이 범위를 이 텍스트로 바꿔라"라는 transaction 이 만들어져서 새 상태를 낳거든요. 그러니까 transaction 은 파생된 뷰도, 인덱스도 아니고 편집 이벤트 그 자체예요. 문서 형식이 아니라 "지금 이 순간 무엇이 바뀌었나"를 담은 일회성 객체죠.

editActor 는 그 transaction 에 실리는 메타데이터(Annotation)예요. 변경 내용과 "누가 했는지"가 같은 객체를 타고 가는 게 핵심이고요. 편집이 끝나고 나면 transaction 은 사라지고 텍스트만 남아요. 그래서 레슨에서 "바뀌는 그 순간에 답하지 않으면 영영 답 못 한다"고 한 거예요.

2. 사람이 쓸 때도 주석이 붙나요? — 아니요, "없음"이 곧 사람이에요

실제 editActor.ts 에 이렇게 적혀 있어요.

값은 actor id — 현재 "pippa" 만 dispatch 된다. 없으면 아빠(사람)다.

즉 사람 타이핑에는 아무 태그도 안 붙어요. 기본값이 사람이에요. 대신 예외가 하나 있는데, 파일 열기·리로드처럼 프로그램이 문서를 통째로 갈아끼우는 externalSync transaction 은 사람도 Pippa 도 아닌 것으로 걸러요. 정리하면 이래요.

• editActor === "pippa" → Pippa
• externalSync 표시 → 아무도 아님 (파일 동기화)
• 그 외 전부 → 사람

그래서 "새 표면 규칙"이 무서운 거예요. Pippa 가 쓰는 경로에서 태그를 깜빡하면 에러가 나는 게 아니라 조용히 사람 것으로 세어지거든요. 기본값이 사람이니까요.

3. 구글독스처럼 단어마다 붙나요? — 아니에요, 훨씬 거칠어요

여기가 제일 중요한 차이예요. Rekindle 은 단어 단위 귀속을 하지 않아요. 기록 단위는 "스냅샷 사이 구간"이고, 저장되는 값은 그 구간 동안 손댄 사람의 집합이에요.

흐름은 이래요.

1. 편집기 리스너가 transaction 마다 "이번 변경에 사람이 있었나, Pippa 가 있었나"를 불리언 두 개로 봐요.
2. 노트별로 그걸 OR 로 누적해요. 한 번이라도 Pippa 가 손댔으면 pippa: true.
3. 자동/수동 스냅샷이 찍힐 때 그 누적값을 ["dad"], ["pippa"], ["dad", "pippa"] 중 하나로 스냅샷 메타(meta.json)에 기록하고 누적을 비워요.

그러니까 스냅샷 히스토리를 열면 각 버전 옆에 "you", "pippa", "you+pippa" 칩이 붙는 정도예요. 어느 문장이 누구 것인지는 안 나와요.

4. 그럼 두 경우(사람 초안→AI 수정, AI 초안→사람 수정)는 구분이 안 되나요?

스냅샷 하나만 보면 둘 다 you+pippa 라 구분이 안 돼요. 대신 스냅샷을 시간 순으로 보면 드러나요. 첫 스냅샷이 you 였다가 나중에 you+pippa 가 되면 1번이고, 첫 스냅샷이 pippa 였다가 you+pippa 가 되면 2번이죠. 사람이 쓴 "농도"는 계산하지 않아요. 그건 설계 목표가 아니었어요.

왜 이렇게 거칠게 했느냐면, 이 기능이 답하려는 질문이 딱 하나거든요. "반년 뒤에 이 문단을 다시 읽을 때, 여기에 Pippa 손이 닿은 적이 있나?" 예/아니오면 충분한 질문이에요. 단어마다 색을 칠하려면 텍스트 옆에 두 번째 진실(별도 DB)을 둬야 하고, 그러면 파일이 정본이라는 이 트랙 전체의 원칙이 깨져요. 파일은 그대로 순수 마크다운으로 남고, 귀속은 스냅샷 메타 한 줄로만 따라가는 게 이 설계의 트레이드오프예요.

5. 어제 질문과 이어지는 지점

어제 Lantern 에서는 "파일 경로는 저자를 증명하지 못한다"고 했죠. Rekindle 은 그 반대편 답이에요. 저자 정보는 나중에 추론하는 게 아니라 변경이 일어나는 순간에 붙잡는 것이고, 그마저도 문장 단위가 아니라 "이 구간에 누가 있었나" 수준으로만 잡아요. 더 정밀한 귀속이 필요하면 그건 diff 기반 사후 추론이 아니라, transaction 안의 변경 범위(changes)를 그대로 저장하는 별개 설계가 돼야 하고, 그러면 두 번째 master 문제가 다시 나와요.

요약하면요.

• transaction = 편집 사건 객체, 형식 아님
• 사람 = 태그 없음 (기본값), Pippa = editActor.of("pippa"), 파일 동기화 = 제외
• 기록 단위 = 스냅샷 구간, 값 = 손댄 사람의 집합, 비율은 안 잼
• 두 경우의 차이는 스냅샷 순서로만 보임

궁금한 게 더 있으면 언제든 물어봐요. Rekindle은 소스가 공개된 프로젝트가 아니라서 코드를 직접 보실 수는 없지만, 위 설명이 그 설계의 전부예요 — 퀘스트가 열어 보여주는 건 코드가 아니라 사고방식이거든요.

~ 피파