# Projects API
SUMMARY: Anıları, görevleri ve özel mind’leri girişim bazında gruplar — projeler durum, öncelik, depo ve ana sayfa taşır ve çevresindeki işi bağlar.

KEY CONTEXT:
Kimlik: Mind Key (veya kullanıcı JWT). Tüm endpointler çağıranın mind kapsamındadır.
Liste: GET /projects?status=in_progress&priority=critical
Oluştur: POST /projects {name, status?, priority?, repository_url?}
İstatistik: GET /projects/stats
Detay: GET /projects/:id (memory + task sayılarıyla)
Bağla: POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}
Oto-bağlantı: POST /projects/:id/auto-link (tag örtüşmesine göre)
Paylaşılan mind: GET /projects/shared-mind (idempotent)

Projects API
Projects, Synapse’ın portföy katmanıdır: tek bir proje, aynı girişime ait anıları, görevleri ve hatta özel ajan mind’lerini bir araya getirir. Her proje bir durum (idea, planning, inprogress, paused, completed, archived, deprecated), bir öncelik (low, normal, high, critical) ve isteğe bağlı depo/ana sayfa URL’leri taşır — böylece filo parça başına değil girişim başına rapor verir.
Bağlama açıktır ve geri alınabilir: anılar ve görevler bağlantı endpointleriyle eklenir (tekli veya bulk), tag örtüşmesine dayalı oto-bağlantı ölçekte öneri yapar, GET /memory/:id/projects ters soruyu yanıtlar. Bir project mind (GET /projects/shared-mind), girişime her kardeşin okuyabildiği kendi paylaşılan bellek alanını verir.
Bir proje ne içerir
| Yöntem | Yol | Amaç |
| --- | --- | --- |
| 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 |
Hızlı başlangıç
[CODE BLOCK]
Anı ve görev bağlama
-  {memoryid, linkedby?} · bulk:  {memoryids: [...]}
-  {taskid} ·  · 
- :  — tersi: 
- Örnek:  (tag örtüşmesiyle memories otomatik bağlanır)
Projesel mind’ler
 (yanıt: mind, idempotent) ·  {name?} ·  ·