--- InterpreterQuery
+++ InterpreterQuery
@@ -1,1 +1,69 @@
+= [Interpreter]Query
+`#!Query` 는 [InterpreterSchema] 로 적어 둔 속성으로 페이지를 골라 표나 목록으로 보여 줍니다. 노션의 데이터베이스 뷰, 옵시디언의 Bases 와 같은 쓰임인데, 따로 입력할 것이 없습니다 — 위키가 이미 쌓아 둔 `#!Schema` 값을 읽을 뿐입니다.
+
+== 기본 문법
+
+인자는 schema.org class 이름이고(공백으로 여러 개), 본문은 탭으로 구분한 줄입니다. 빈 줄과 `#` 로 시작하는 줄은 무시합니다. `#!Schema` 와 같은 모양입니다.
+
+[[[#!WikiSyntaxPreview Query Person
+where birthDate has
+show birthDate birthPlace
+sort birthDate
+]]]
+
+== 줄의 종류
+
+[[[#!Table tsv 1
+줄 뜻
+`where 속성 연산 값` 조건. 여러 줄이면 모두 만족해야 합니다
+`show 속성 …` 이름 칸 뒤에 보일 속성들. 여러 줄이면 이어 붙입니다
+`sort 속성 [asc|desc]` 정렬. 기본은 이름순
+`group 속성` 그 속성의 값별로 묶어 보입니다. 없는 페이지는 맨 뒤
+`limit N` 최대 N 쪽(기본 100, 상한 500)
+`view table|list` 표(기본) 또는 목록
+]]]
+
+== 조건 (`where`)
+
+속성은 값을 여럿 가질 수 있으므로(`sameAs` 처럼), 조건은 값들의 집합에 대해 묻습니다. `=` 는 '''어느 한 값이라도''' 같으면, `!=` 는 '''어느 값도''' 같지 않으면 참입니다. 그래야 값이 하나 더 생겼다고 답이 바뀌지 않습니다.
+
+[[[#!Table tsv 1
+연산 뜻
+`=` `!=` 같다 / 다르다. 대소문자를 가리지 않습니다
+`~` `!~` 포함한다 / 포함하지 않는다. 대소문자를 가리지 않습니다
+`<` `<=` `>` `>=` 크기 비교. 둘 다 숫자면 숫자로, 아니면 글자로 비교합니다(ISO 날짜 `2026-10-24` 는 글자로 비교해도 날짜순입니다)
+`has` `none` 속성이 있다 / 없다. 값이 필요 없습니다
+`md` 같은 월·일. `--10-23` 과 `1815-10-23` 은 둘 다 «10월 23일» 입니다
+]]]
+
+값 자리에 `today` 를 쓰면 오늘 날짜입니다. `md` 와 쓰면 오늘의 월·일(`--MM-DD`)이 됩니다 — 오늘 생일인 사람은 이렇게 구합니다.
+
+[[[#!WikiSyntaxPreview Query Person
+where birthDate md today
+show birthDate
+]]]
+
+== 정한 것과 그 이유
+ * '''모르는 줄은 오류입니다.''' `shwo` 로 잘못 적은 줄이 조용히 무시되면, 아무것도 안 보이는 것이 «조건에 맞는 페이지가 없다» 와 구별되지 않습니다. 오류 상자가 어느 줄이 문제인지 말합니다.
+ * '''class 도 `where` 도 없는 질의는 거부합니다.''' 위키의 모든 페이지가 되기 때문입니다.
+ * '''속성이 없는 페이지는 정렬에서 맨 뒤입니다''', 오름차순이든 내림차순이든. 없는 것이지 가장 작은 것이 아닙니다. 값이 같으면 이름순이라 렌더링마다 순서가 바뀌지 않습니다.
+ * '''읽을 수 없는 페이지는 목록에도, 개수에도 나오지 않습니다.'''
+ * '''그릴 때 읽습니다.''' 어떤 페이지가 `#!Schema` 를 저장하는 즉시 이 목록에 나타납니다. 이 인터프리터가 따로 저장하는 것은 없습니다.
+ * 값은 [InterpreterSchema] 가 그리는 것과 같이 위키 링크로 나옵니다.
+
+== 아직 없는 것
+ * 카드·보드·달력 보기. 노션과 옵시디언 Bases 는 갖고 있습니다. 표와 목록으로 시작한 것은 나머지가 «데이터를 어떻게 고르는가» 가 아니라 «어떻게 그리는가» 의 문제라서, 고르는 쪽을 먼저 굳히려는 것입니다.
+ * 계산 열(노션의 formula·rollup)과 페이지 간 관계 따라가기.
+ * 여러 값 중 어느 것으로 정렬할지 고르기 — 지금은 첫 값(글자순으로 가장 앞)입니다.
+ * 속성을 `#!Schema` 가 아니라 본문에서 읽기.
+
+== 구현
+ * `QueryEngine` — 순수 함수: 줄을 읽고(`parse`), 조건을 평가하고, 정렬·묶기·자르기를 합니다. 데이터베이스도 HTML 도 모릅니다. `QueryEngineSpec` 이 확인합니다.
+ * `InterpreterQuery` — `CalculatedSchemaOrg` 에서 필요한 속성만(`selectFacts`) 읽어 엔진에 주고 그립니다. 한 번에 읽는 행은 2만으로 막아 두었습니다 — 거의 모든 페이지가 가진 속성으로 물으면 «앞의 행들» 로 줄어들 뿐 테이블을 통째로 읽지는 않습니다.
+ * 같은 데이터 위에 [MacroOnThisDay] 가 먼저 있었습니다. 그것은 «이 날짜에 걸린 페이지» 한 가지를 고정해 둔 질의입니다.
+
+== 관련
+ * [InterpreterSchema]
+ * [MacroOnThisDay]
+ * [Dev Mcp]