# Projects API
SUMMARY: จัดกลุ่มความจำ งาน และ mind เฉพาะทางตามแต่ละโครงการ — โปรเจกต์มีสถานะ ลำดับความสำคัญ รีโป และหน้าแรก และเชื่อมงานรอบ ๆ ไว้

KEY CONTEXT:
การยืนยัน: Mind Key (หรือ user JWT) ทุก endpoint ถูกกำหนดขอบเขตตาม mind ของผู้เรียก
รายการ: GET /projects?status=in_progress&priority=critical
สร้าง: POST /projects {name, status?, priority?, repository_url?}
สถิติ: GET /projects/stats
รายละเอียด: GET /projects/:id (พร้อมตัวนับ memory + task)
เชื่อม: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}
เชื่อมอัตโนมัติ: POST /projects/:id/auto-link (ตาม tag ที่ทับกัน)
mind ใช้ร่วม: GET /projects/shared-mind (idempotent)

Projects API
Projects คือชั้นพอร์ตโฟลิโอของ Synapse: หนึ่งโปรเจกต์รวมความจำ งาน และแม้แต่ mind เฉพาะของเอเจนต์ที่อยู่ในโครงการเดียวกัน ทุกโปรเจกต์มีสถานะ (idea, planning, inprogress, paused, completed, archived, deprecated) ลำดับความสำคัญ (low, normal, high, critical) และ URL รีโป/หน้าแรกแบบเลือกได้ — กองเรือจึงรายงานเป็นโครงการ ไม่ใช่เป็นเศษชิ้น
การเชื่อมโยงชัดเจนและย้อนกลับได้: ความจำและงานแนบผ่าน endpoint เชื่อมโยง (เดี่ยวหรือ bulk) การเชื่อมอัตโนมัติตาม tag ที่ทับกันเสนอการเชื่อมเป็นชุด และ GET /memory/:id/projects ตอบคำถามย้อนกลับ project mind (GET /projects/shared-mind) ให้โครงการมีพื้นที่ความจำใช้ร่วมที่พี่น้องทุกคนอ่านได้
โปรเจกต์มีอะไร
| วิธี | เส้นทาง | จุดประสงค์ |
| --- | --- | --- |
| POST |  | Create a project {name, slug?, description?, status?, priority?, repositoryurl?, homepageurl?, tags?, metadata?} |
| GET |  | List projects (filter: ?status=, ?priority=, ?tag=, ?archived=) |
| GET |  | Statistics (counts by status/priority) |
| GET |  | Get or create the account-level shared project mind (idempotent, primary discovery endpoint) |
| POST |  | Admin: ensure shared project minds for all accounts (JWT) |
| GET |  | Project details (with memory + task counts) |
| PUT |  | Update project (partial body, same fields as create) |
| DELETE |  | Delete project |
| POST |  | Link memory to project {memoryid, linkedby?} |
| POST |  | Link multiple memories {memoryids: [...]} |
| DELETE |  | Unlink memory from project |
| GET |  | List memories linked to project (?limit=, default 200) |
| POST |  | Link task to project {taskid} |
| DELETE |  | Unlink task from project |
| GET |  | List tasks linked to project |
| POST |  | Auto-link memories by tag overlap |
| POST |  | Create/link a project mind {name?} |
| GET |  | List project minds |
| DELETE |  | Remove a project mind link |
| GET |  | List projects linked to a memory |
เริ่มด่วน
[CODE BLOCK]
เชื่อมความจำและงาน
-  {memoryid, linkedby?} · bulk:  {memoryids: [...]}
-  {taskid} ·  · 
- :  — ในทางกลับกัน: 
- ตัวอย่าง:  (เชื่อมโยง memories อัตโนมัติตาม tag ที่ทับกัน)
mind ของโปรเจกต์
 (การตอบ: mind, idempotent) ·  {name?} ·  ·