qwreey
1f56c75978
CLAUDE.md had grown to 3196 lines of accumulated session logs, causing context bloat. Full session narratives (including trial-and-error and later-corrected reasoning — quadnomicon devlog raw material) now live as 39 individual files under .claude/session/. CLAUDE.md keeps only a short "지금 할 일" (re-synced against question.md/pre-implementation-audit.md, stale detail dropped) and a compact per-session summary+link table. No design decisions changed; base/research/question.md were already in sync with every session (verified against README.md/question.md before archiving), so no unreflected content needed migrating first.
3.2 KiB
2026-08-10 세 번째 세션 — OnChange 특수 키 신설: GetPropertyChangedSignal
바인딩, 제네릭 없이 확정
사용자가 GetPropertyChangedSignal을 어떻게 다뤄야 할지 물으며 시작 —
이벤트는 이미 평범한 문자열 키(inst[key]가 곧 Signal)로 확정돼 있는데,
GetPropertyChangedSignal(name)은 프로퍼티 이름을 인자로 받아야 하고 그
이름이 "값 세팅" 키 네임스페이스와 겹쳐서 같은 패턴을 못 씀 — 사용자가
[OnChange "PropertyName"] = function(v) ... end 형태(타입은 콜백에 직접
명시)와 "OnChange.PropertyName을 전부 코드 생성"하는 대안 두 가지를
제시하며 의견을 물음.
확정: OnChange(name) DI 키 팩토리, 제네릭 타입 파라미터 없음 —
Attribute<<T>>와 달리 콜백 파라미터 타입은 호출부가 직접 명시. 이미
확정된 "이벤트 바인딩은 콜백 시그니처를 Luau가 검증 못 하는 대가를
받아들인다"는 결정과 같은 급의 트레이드오프라 새로 정당화할 것 없다는 게
근거 — 오히려 Attribute처럼 제네릭으로 정확히 맞추려 들면 이벤트 키보다
더 엄격한 걸 요구하는 셈이라 일관성이 깨짐. 프로퍼티별 정적 코드 생성 안은
기각(archive/onchange-per-property-codegen-rejected.md) — Attribute의
정적 지름길은 타입 파라미터가 좁고 고정된 프리미티브 집합(~10종)에서만
와서 지름길 후보가 유한한데, 프로퍼티는 클래스마다 이름/타입 집합이 전부
달라 (클래스 수 × 프로퍼티 수) 규모로 폭발함 — 겉보기엔 비슷한 절충
같지만 실제로는 규모가 다른 문제.
패키지 경계는 전부 quad-roblox(Handlers/OnChange.luau, Attribute와
같은 배치 — GetPropertyChangedSignal 자체가 Roblox 엔진 API라 base에 둘
값 타입/API 레이어가 없음). process는 GetPropertyChangedSignal(name):Connect,
retract는 :Disconnect — 일반 Handlers/Event.luau와 같은 결. State<function>
지원도 새 메커니즘 없이 해소 — 이미 확정된 "이벤트도 store-bind 가능
(false로 disconnect)" 메커니즘이 그대로 적용됨, OnChangeHandler는
process/retract만 구현하면 범용 Dispatch/StoreBind.luau가 State/Source
언랩+재귀 재-dispatch를 알아서 해줌.
base/onchange-plan.md(신규)/base/bind-system-plan.md(이벤트 네이밍 절
교차 참조)/base/architecture.md(소스트리 Handlers/OnChange.luau)/
ROADMAP.md(M10 제목·체크박스)/.claude/README.md(base/archive 인덱스)
전부 반영 완료.
다음 세션이 할 일: 안 바뀜(ROADMAP.md M0부터, luau-test 결과 확인
우선) — 이번 세션도 순수 설계 확정이라 M0 착수 우선순위 자체는 그대로.