# Changelog

หน้านี้รวบรวมการเปลี่ยนแปลงทุกอย่างที่กระทบการใช้งาน API ได้แก่ GraphQL Schema, ข้อจำกัดการ Query, Endpoint, กฎการมองเห็นข้อมูล และ MCP Tool

เมื่อมีการเปลี่ยนชื่อหรือลบ Field ที่ผู้ใช้เข้าถึงได้ เราจะพยายามคง Field เดิมไว้ระยะหนึ่งพร้อมกับ Directive `@deprecated` ของ GraphQL และจะแจ้งการลบ Field นั้นเป็นรายการถัดไปในหน้านี้ ยกเว้น Relationship Field ที่ไม่สามารถมีอยู่คู่กับ Field ใหม่ได้ การเปลี่ยนชื่อจึงถูกระบุไว้ในหัวข้อ `Breaking` ทันที

## 2026-09-29

**Added**

- Query `timestamps` สำหรับดึงเวลา (UTC) ที่บอกความใหม่ของข้อมูล ได้แก่
  - `lastNodeUpdatedAt` เวลาที่ข้อมูลถูกเปลี่ยนแปลงล่าสุด
  - `lastVoteEventScrapedAt` เวลาที่ระบบอัตโนมัติดึงข้อมูลการลงมติ (`VoteEvent` และ `Vote`) สำเร็จล่าสุด
  - `lastBillScrapedAt` เวลาที่ระบบอัตโนมัติดึงข้อมูลร่างกฎหมายและเหตุการณ์ของร่างกฎหมายสำเร็จล่าสุด
- เพิ่มคำแนะนำของ MCP Server ให้ Agent ใช้ Query `timestamps` เพื่อตรวจสอบว่าข้อมูลเป็นปัจจุบันแค่ไหน

**Deprecated**

- `lastUpdatedAt` ให้ใช้ `timestamps { lastNodeUpdatedAt }` แทน

## 2026-09-24

**Breaking**

- เปลี่ยนชื่อ `Organization.motions` เป็น `Organization.considered_motions` คำอธิบายเดิมระบุผิดว่าเป็น "ญัตติที่เสนอในนามองค์กร" ในขณะที่ Field นี้หมายถึง "ญัตติที่พิจารณาในองค์กร" มาตลอด หากต้องการความหมายแรก ให้ใช้ `Organization.created_motions`
- `/graphql` ตอบกลับด้วย HTTP `400` แทน `200` เมื่อ Variable ไม่ตรงกับประเภทที่ประกาศไว้ โดย Body ที่เป็น `errors` ยังเหมือนเดิม

**Added**

- `Organization.created_motions` ญัตติที่เสนอในนามองค์กร (Back-reference ของ `CREATED_BY` เช่นเดียวกับ `Person.created_motions`)
- `Organization.considered_motions` ญัตติที่พิจารณาในองค์กร
- `/graphql` รองรับ Header `apollographql-client-name` และ `apollographql-client-version` ที่ไม่บังคับ เพื่อให้ Client ฝั่ง Server ระบุชื่อแอปพลิเคชันของตนได้
- MCP Tool `get-docs` สำหรับดึงสารบัญเอกสาร (`/llms.txt`) หรือหน้าเอกสารแต่ละหน้าในรูปแบบ Markdown เพื่อให้ Agent อ่านวิธีการจัดโครงสร้างข้อมูลและตัวอย่าง Query ได้

**Deprecated**

- `VoteEvent.bills` ให้ใช้ `VoteEvent.bill_vote_events.bills` แทน
- `Bill.requirement` และ `Motion.requirement` ไม่เคยมีข้อมูล และจะถูกลบในอนาคต
- `BillVoteEvent.pass_condition` ไม่เคยมีข้อมูล ให้ใช้ `BillVoteEvent.vote_events.pass_condition` แทน และจะถูกลบในอนาคต

## 2026-09-04

**Added**

- Endpoint `/mcp` พร้อม Tool สำหรับรัน Query อ่าน Schema และแสดงรายการประเภทข้อมูล
- `/llms.txt`, `/llms-full.txt` และเอกสารทุกหน้าในรูปแบบ `.md`

## 2026-08-05

**Added**

- Query `lastUpdatedAt` สำหรับดึงเวลา (UTC) ที่ข้อมูลถูกเปลี่ยนแปลงล่าสุด

## 2026-03-11

**Breaking**

- Query `Person` และ `Vote` คืนค่าได้สูงสุด 1,000 Node ต่อคำขอ ให้ใช้ `limit` และ `offset` เพื่อแบ่งหน้าข้อมูลที่มีจำนวนมากกว่านั้น

## 2026-02-24

**Breaking**

- เปลี่ยนชื่อ `Bill.bill_events` เป็น `Bill.events`
- เปลี่ยนชื่อ `Vote.voter_name` เป็น `Vote.voter_name_raw`
- เปลี่ยนชื่อ Union `MotionProposer` เป็น `MotionCreator`
- เปลี่ยนชื่อ `Bill.proposers` และ `Bill.co_proposers` เป็น `Bill.creators` และ `Bill.co_creators`
- เปลี่ยนชื่อ `Person.proposed_motions` เป็น `Person.created_motions` และเพิ่ม `Person.co_created_motions`

**Added**

- `Bill.creator_type` และ Enum `BillCreatorType`

## 2025-12-16

**Breaking**

- เปลี่ยนประเภทของ `Bill.bill_events` จาก `Event` เป็น Union ใหม่ `BillEvent` โดย `DraftVoteEvent` เปลี่ยนเป็น `BillVoteEvent` และ `BillEnforceEvent` เปลี่ยนเป็น `BillEnactEvent`
- ลบ `BillStatus.ENFORCED` เนื่องจากซ้ำกับ `BillStatus.ENACTED`

**Added**

- `Person.death_date`