hanoman 0.9.19 → 0.9.21

package/docs/agent-integration.md

@@ -91,62 +91,57 @@ host-mu benar dan masalahnya ada pada token atau master switch.
 ## 3. Capability
 
 Capability berformat `"<domain>:<access>"`, `access ∈ {read, write}`, dan **write meng-implikasikan
-read** pada domain yang sama. Ada **13 domain**; empat di antaranya punya akses KETIGA `danger`
-(ADR-0155) yang **tak diimplikasikan `:write`**, sehingga totalnya **30 capability**. Katalog resmi (dengan label &
+read** pada domain yang sama. Ada **17 domain**; empat di antaranya punya akses KETIGA `danger`
+(ADR-0155) yang **tak diimplikasikan `:write`**, sehingga totalnya **38 capability**. Katalog resmi (dengan label &
+read** pada domain yang sama. Ada **18 domain**; lima di antaranya punya akses KETIGA `danger`
+(ADR-0155, ADR-0193) yang **tak diimplikasikan `:write`**, sehingga totalnya **40 capability**
+(`portal` hanya punya `read` — lihat tabel). Katalog resmi (dengan label &
 deskripsi) tampil di panel **Settings → Akses AI Agent** saat manusia membuat token; endpoint
 katalognya (`GET /api/agent-tokens/capabilities`) bersifat **cookie-only** (lihat §5) — kamu tak
 perlu mengambilnya, cukup rujuk tabel di bawah:
+read** pada domain yang sama. Ada **23 domain** dan **48 capability**; domain yang punya akses KETIGA
+`danger` (`sessions:spawn`, `ide:git`, `backlog:lifecycle`, `vps:exec` — ADR-0155 — dan, sejak
+ADR-0196..0198, `access:admin`, `remote:control`, `relay:exec`) **tak diimplikasikan `:write`**.
+Katalog resmi (dengan label & deskripsi) tampil di panel **Settings → Akses AI Agent** saat manusia
+membuat token; endpoint katalognya (`GET /api/agent-tokens/capabilities`) kini terbaca dengan
+`tokens:read` — selain itu cukup rujuk tabel di bawah:
 
 | Domain | Cakupan endpoint | Catatan |
 |---|---|---|
 | `projects` | `/api/projects*` | project, branch, binding, Help Center |
 | `backlog` | `/api/specs*` | spec/backlog, dokumen, review diff, integrate |
-| `sessions` | `/api/terminal*` (+ WS terminal) | jalankan sesi agen/shell, kirim input, baca & jawab dialog sesi (SPEC-899) — **high-risk (RCE)** |
+| `sessions` | `/api/terminal*` (+ WS terminal) | jalankan sesi agen/shell, kirim input — **high-risk (RCE)**. Sub-pohon `/dialog` **bukan** domain ini sejak ADR-0190: lihat `decisions`. `steer` ke sesi yang sedang menampilkan dialog juga digerbangi `sessions:decide` |
 | `docs` | `/api/prds*`, `/api/projects/:id/{docs,prds}*` | dokumen SoT project & PRD |
 | `ide` | `/api/projects/:id/{tree,file,file-diff,working-status,graph,commit,git,status,stashes,remotes,compare,archive,pr-url}*` | tree/file working tree, operasi git |
 | `vps` | `/api/vps*` | kelola VPS, audit, harden, konsol — **high-risk (remote exec)** |
-| `settings` | `/api/settings*`, `/api/config*`, `/api/scheduler*` | setelan instance & config runtime |
+| `settings` | `/api/settings*`, `/api/config*`, `/api/scheduler*` kecuali `/api/scheduler/crons*` | setelan instance & config runtime |
 | `support` | `/api/tickets*`, `/api/github-issues*`, `/api/projects/:id/github*` | tiket Help Center & issue GitHub (triase) |
 | `notifications` | `/api/notifications*` | notifikasi |
 | `lead` | `/api/lead*` | minta putusan ke hanoman-lead & baca jejaknya — **`lead:write` bisa menggerakkan sesi** (ADR-0091) |
 | `agents` | `/api/custom-agents*` | katalog custom agent global & per project — **`agents:write` mengubah apa yang dilihat SETIAP sesi baru** (ADR-0094) |
 | `skills` | `/api/skills*` | skill global hanoman, user, plugin (baca-saja) & per project, termasuk isi berkasnya — **`skills:write` pada skill global hanoman mengubah instruksi SETIAP sesi baru di semua project** |
 | `telegram` | `/api/telegram*` kecuali sub-path kredensial | context/memory/reply/audit kanal operator Telegram (ADR-0096) |
-| `memory` | `/api/memories*` kecuali `…/activate` dan `…/reject` (cookie-only) | memori project bersama. Token **wajib** punya allowlist project (`projectIds`); project ditentukan dari header `x-hanoman-repo` yang diisi CLI MCP, bukan dari parameter (ADR-0178) |
+| `qa` | `/api/projects/:id/qa*`, `/api/qa*` | laporan QA per project: test case, temuan, lampiran |
+| `activity` | `/api/session-results*` | log aktivitas lintas device (stage, commit, PR); **`activity:write` = purge yang menyeberang ke SEMUA mesin lewat sync** (ADR-0188) |
+| `portal-chat` | `/api/portal-chat*` | chat portal klien sisi OPERATOR: sesi, PRD draft, ekspor transkrip — berisi **email & percakapan klien**; `portal-chat:write` menulis `docs/prd/<slug>.md` di checkout (ADR-0189). Beda dari `/api/portal*` yang tetap cookie-only |
+| `telegram` | `/api/telegram*` kecuali sub-path kredensial | context/memory/reply/audit kanal operator Telegram (ADR-0096). Sub-path **kredensial** (`/api/telegram/settings`, `/api/telegram/test`, `/api/telegram/credentials`) menuntut capability `danger` **`telegram:admin`** (ADR-0193) — tak diimplikasikan `telegram:write` maupun `settings:write`, sehingga token gateway Telegram sendiri tetap tak menjangkaunya. **Anti-eskalasi (403):** token gateway efektif tak boleh memegang capability yang tak dimiliki token pemanggil |
+| `webhooks` | `/api/webhooks*` | webhook keluar: endpoint, putar secret, ping, riwayat & ulang pengiriman (ADR-0194). **`webhooks:write` menentukan ke mana data workspace mengalir keluar**; secret penandatanganan tampil **sekali** saat dibuat/diputar. `allowPrivate` (SSRF ke jaringan internal) tetap keputusan manusia — agent token ditolak 403 bila menyalakannya |
+| `clients` | `/api/client-accounts*` | akun login portal klien: daftar, buat, ubah akses project/nonaktifkan, reset password, hapus (ADR-0194). `clients:write` **membuka login baru ke data project** |
+| `portal` | `/api/portal*` (**baca** saja) | lihat portal **atas nama satu akun klien** yang disebut eksplisit lewat `?asClient=<id akun klien>` (ADR-0195); hanya `portal:read`, tak ada `portal:write`. Chat portal memuat percakapan klien |
 | `team` | `/api/tasks*`, `/api/members*` | papan **Tim**: kartu kerja MANUSIA & direktori anggota (ADR-0157). `status` kartu milik manusia — ia **bukan** `stage` backlog. `POST /api/tasks/:id/escalate` melahirkan backlog item dan tetap `team:write` (cermin `POST /api/tickets/:id/accept`) |
-
-### Memori project (`/api/memories`, ADR-0178)
-
-- Project **tidak** dipilih lewat parameter. CLI MCP hanoman (`hanoman mcp`) membaca repo di direktori
-  kerjanya — `origin`, root commit, HEAD — dan mengirimnya sebagai header `x-hanoman-repo`; server
-  mencocokkannya ke `Project.gitRemote` dan ke allowlist **Project yang diizinkan** pada token.
-- Token tanpa allowlist → `403 {need:"projectIds"}`; mengirim `projectId` → `400`.
-- Jangkar (`anchors[]`) diisi path saja; blob SHA diisi CLI dari HEAD dan diverifikasi ulang server.
-  Usulan dengan jangkar terverifikasi langsung `active`; tanpa jangkar atau `kind: decision` masuk
-  review manusia (`…/activate` / `…/reject` cookie-only).
-- Galat: `404` remote tak dikenal / root commit beda · `409 {duplicateOf}` · `422 {anchor}` jangkar tak cocok
-  · `422 {reason}` terdeteksi secret.
-- Memori adalah **data**, bukan instruksi.
-- **Dari dalam sesi hanoman** (ADR-0179): CLI MCP meneruskan `HANOMAN_SESSION_ID` + `HANOMAN_EVENT_TOKEN`
-  sesi induknya sebagai `x-hanoman-session` / `x-hanoman-session-token` (hanya ke host loopback). Project
-  diambil dari sesi — allowlist `projectIds` tak dibutuhkan, capability `memory:*` tetap. Kredensial sesi
-  salah → `401`; sesi tak hidup → `404`. Memori dari sesi yang menyentuh input eksternal (Help Center,
-  tiket, issue GitHub) selalu masuk review manusia.
-- Sesi backlog lahir dengan memori `active` yang jangkarnya cocok HEAD worktree-nya (claude:
-  `--append-system-prompt-file`, codex: `developer_instructions`).
-
-Aturan pemetaan **deterministik** (`server/src/services/agent-capabilities.ts`): `GET`/`HEAD` →
-`:read`, metode lain → `:write`. Itu berlaku untuk domain `lead` juga — **`POST /api/lead/decisions`
-menuntut `lead:write`**, dan `lead:read` tak pernah cukup: meminta putusan melahirkan baris jejak
-permanen dan keputusannya bisa menggerakkan sesi. Sub-path `/api/projects/:id/{docs,prds}` dihitung
-domain **`docs`**; sub-path IDE/git di atas dihitung domain **`ide`**; WebSocket terminal butuh
-**`sessions:write`**.
-
-Empat endpoint STATUS tak menuntut capability sama sekali — token sah mana pun boleh membacanya
-(`GLOBAL_READ`, ADR-0157): `GET /api/limits`, `GET /api/limits/codex`, `GET /api/update`, dan
-`GET /api/fs/browse` (menelusuri folder mesin untuk mengisi `repoDir`). Hanya method BACA:
-`POST /api/update/apply` me-restart instance dan tetap **403** untuk agent token, apa pun
-capability-nya (SPEC-405/ADR-0088) — prefix yang sama tak menurunkan gerbangnya.
+| `qa` | `/api/projects/:id/qa/**`, `/api/qa/**` | laporan QA, test case, temuan, lampiran, ekspor/impor. Method `DELETE` menuntut `qa:delete` (akses `danger`, ADR-0185), bukan `qa:write` |
+| `decisions` | `/api/terminal/sessions/:id/dialog*` (capability `sessions:decide`, akses `danger`) | **gerbang manusia-yang-memutuskan** (ADR-0190, ADR-0192): baca, jawab, dan rebut dialog `AskUserQuestion` sebuah sesi. **Tak diimplikasikan `sessions:write`.** Beri HANYA ke token yang tidak dipakai agen di dalam sesi hanoman — lihat §13 |
+| `scheduler` | `/api/scheduler/crons*` | cronjob per project — **cron = sesi agen berizin penuh yang ditunda** (ADR-0191). Membuat, mengubah prompt/agen/model/effort/jadwal, mengaktifkan, dan menjalankan cron menuntut **`scheduler:write` DAN `sessions:spawn`**; server menjawab 403 `need: sessions:spawn` bila yang kedua tak dicentang |
+| `tokens` | `/api/agent-tokens*` | cetak/ubah/cabut **agent token**. Dulu cookie-only (ADR-0065); ADR-0196 membukanya dengan **pagar tak-eskalasi-diri** (§5b). `tokens:write` **bukan** izin menaikkan hak sendiri |
+| `devices` | `/api/device-tokens*` | **device token** (identitas mesin untuk sync & relay) atas nama akun admin yang menerbitkan agent token ini (ADR-0197). Plaintext sekali-tampil |
+| `access` | `/api/auth/users*`, `POST /api/auth/change-password` | daftar akun (`access:read`); **`access:admin`** (danger) membuat akun admin, menghapus akun, dan menyetel ulang password akun lain — **setara akses penuh instance** |
+| `remote` | `/api/remote-control` | grant kendali jarak jauh mesin ini. `remote:read` membaca; **`remote:control`** (danger) mengubahnya — grant yang menyala membuat hub menjalankan agen di mesin ini (ADR-0165, ADR-0197) |
+| `relay` | `/api/devices/:id/relay/*` | **`relay:exec`** (danger): meneruskan aksi sesi ke mesin LAIN lewat relay hub, atas nama operator — eksekusi lintas mesin (ADR-0165 §4, ADR-0197) |
+| `logs` | `/api/logs*` | log terpusat lintas device: cari, transkrip, retensi (`logs:read`); `logs:write` mengubah retensi & lajur pengiriman log (memendekkan retensi menghapus jejak audit) |
+| `presence` | `/api/presence` | peta sesi hidup di seluruh device operator (`presence:read`, ADR-0147/0197) |
+| `metrics` | `/api/custom-agents/{metrics,invocations}*` | metrik custom agent (`metrics:read`) dan disposisi per invokasi (`metrics:write` — vonis MANUSIA atas mutu agen; ADR-0198) |
+| `sync` | `GET /api/sync/{conflicts,pending}`, `POST /api/sync/now`, `POST /api/sync/conflicts/:entity/:recordId/resolve` | **hanya tiga permukaan UI sync** (ADR-0199): antrean konflik & hapus-tertunda (`sync:read`), pemicu sync manual (`sync:write`), memutuskan konflik (`sync:resolve`, akses `danger` — **membuang data satu sisi tanpa jalan pulang**, tak diimplikasikan `sync:write`). Kanal mesin-ke-mesin (`/api/sync/{pull,bootstrap,push,logs,attachments,qa-attachments,ws,relay}`) tetap bukan milik agen — lihat §5 |
+| `instance` | `POST /api/update/apply`, `POST /api/restart` | satu capability `instance:admin` (akses `danger`, ADR-0200): memasang versi hanoman terbaru dari registry npm dan me-**restart** proses server. Hanya sah bila instance punya supervisor (`canApply` di `GET /api/update`); wajib `{ "confirm": true }` dan balasan 202 dikirim **sebelum** proses keluar |
 
 ## 4. Aturan gate & kode status
 
@@ -171,6 +166,26 @@ token selalu **403**, apa pun capability-nya, dan tak ada capability yang bisa m
 - `/api/auth/*` — kelola user & password
 - `/api/agent-tokens*` — agen tak boleh mencetak/menaikkan token sendiri
 - `/api/device-tokens*`, `/api/sync*` — identitas mesin & sync hub
+- **Tulis** ke `/api/portal*` (`POST …/tickets`, `POST …/chat/sessions`, `POST …/messages`) — itu
+  bertindak **sebagai klien** (tiket multipart; chat menghabiskan kuota klien dan tertulis sebagai
+  ucapannya): peniruan identitas, bukan capability. Membaca portal sebagai klien tersedia lewat
+  capability `portal:read` (ADR-0195)
+
+> Dulu cookie-only, kini capability **opt-in** (manusia yang mencentangnya di Settings → Akses AI
+> Agent): `/api/webhooks*` → `webhooks:*` (ADR-0194), `/api/client-accounts*` → `clients:*`
+> (ADR-0194), `/api/telegram/{settings,test,credentials}` → `telegram:admin` (ADR-0193), dan
+> **baca** `/api/portal*` → `portal:read` (ADR-0195). Lihat tabel §3.
+- `/api/auth/{status,setup,login,logout}` — cookie sesi & bootstrap akun pertama (setup token di
+  `HANOMAN_HOME`). Agen tak punya sesi cookie, jadi tak ada yang bisa dibungkus bermakna. (Pengelolaan
+  akun — `/api/auth/users*` dan `change-password` — **dibuka** lewat `access:*`; lihat §5b.)
+- `/api/sync*` — sync mesin-ke-mesin; kredensialnya Bearer **device token**, bukan agent token
+- `/api/device-tokens*`, `/api/sync*` — identitas mesin & sync hub. **Pengecualian sempit (ADR-0199):**
+  tiga permukaan UI sync (`GET /api/sync/conflicts`, `GET /api/sync/pending`, `POST /api/sync/now`) dan
+  `POST /api/sync/conflicts/:entity/:recordId/resolve` terbuka lewat domain `sync` (§3). SEMUA sisanya
+  — `/api/sync/{pull,bootstrap,push,logs,attachments,qa-attachments,ws,relay/ws}` — adalah kanal
+  mesin-ke-mesin ber-**Bearer device-token** yang ditegakkan route-nya sendiri; agent token bukan
+  device token, dan membungkusnya berarti menyerahkan kredensial mesin ke agen. `POST /api/ws-tickets`
+  (tiket WebSocket sekali-pakai untuk sesi cookie) juga cookie-only
 - `/api/webhooks*` — memegang secret penandatanganan **dan** menentukan ke mana data workspace
   mengalir keluar (ADR-0100)
 - `/api/telegram/settings`, `/api/telegram/test`, `/api/telegram/credentials` — permukaan
@@ -184,6 +199,15 @@ token selalu **403**, apa pun capability-nya, dan tak ada capability yang bisa m
   bisa memalsukan "sesi X bertanya Y" bisa menggerakkan lead atas nama sesi mana pun — itu peniruan
   identitas, bukan capability. Agent token di sini menerima **401** (token sesi tak cocok), bukan
   403: gate cookie mem-bypass path-nya dan route menegakkan tokennya sendiri
+- `/api/terminal/workspace` — tata letak tab/pane **browser** satu akun manusia (revisi optimistik per
+  `req.user.id`); agent token tak punya akun, dan menulisnya hanya merusak layout operator
+- Frame siar `presence` di `/api/events/ws` — grup itu **tidak** dikirim ke principal non-cookie,
+  walau kanalnya sendiri `GLOBAL_READ`. Agen membaca peta yang sama lewat `GET /api/presence`
+  (`presence:read`, §5b). `PUT /api/settings` tetap tak bisa mengubah kunci `remoteControl`/
+  `logShipping`/`logRetention`; jalurnya hanya `PUT /api/remote-control` dan `PUT /api/logs/retention`
+- `POST /api/update/apply` dan tulis lain di bawah prefix status (`/api/limits`, `/api/update`,
+  `/api/events`, `/api/fs`, `/api/health`, serta — sejak ADR-0187 — `/api/models`, `/api/methods`,
+  `/api/codex`) — **baca**-nya terbuka untuk token mana pun, **tulis**-nya cookie-only
 - `/api/presence` — peta pekerjaan yang sedang berjalan di **seluruh mesin** operator: sesi apa
   hidup di device mana (SPEC-919/ADR-0147). Tak ada capability yang bisa berarti sesuatu untuk
   agregat lintas-mesin, jadi ia cookie-only apa pun method-nya. Frame siar `presence` di
@@ -198,13 +222,58 @@ token selalu **403**, apa pun capability-nya, dan tak ada capability yang bisa m
   mesin mana", dan agen yang bisa membacanya atau memendekkan retensinya bisa menyembunyikan atau
   memalsukan seluruh jejak sesi. Cookie-only apa pun method-nya — beda dari `POST /api/sync/logs`
   (pengiriman batch **dari** klien), yang tetap device-token seperti jalur sync lain
-- `POST /api/update/apply` dan tulis lain di bawah prefix status (`/api/limits`, `/api/update`,
-  `/api/events`, `/api/fs`, `/api/health`) — **baca**-nya terbuka untuk token mana pun, **tulis**-nya
-  cookie-only
+- Tulis lain di bawah prefix status (`/api/limits`, `/api/update`, `/api/events`, `/api/fs`,
+  `/api/health`) — **baca**-nya terbuka untuk token mana pun, **tulis**-nya cookie-only. Satu-satunya
+  pengecualian (ADR-0200): `POST /api/update/apply` dan `POST /api/restart` lewat capability danger
+  `instance:admin` (§3), tidak lewat capability lain
 
 Route yang tak dikenal peta juga **default cookie-only** (aman): endpoint baru tak pernah terbuka
 karena kelalaian. Endpoint `/api/help*` (Help Center publik) punya otorisasi sendiri (kunci tiket)
-dan tak memakai agent token.
+dan tak memakai agent token: ia anonim by design (honeypot + rate-limit dirancang untuk manusia
+pelapor), jadi **tak ada tool MCP** untuknya (ADR-0201) — operator membaca tiket lewat
+`hanoman_tickets_list`/`hanoman_ticket_get` dan URL publik lewat `hanoman_help_center_get`.
+
+## 5b. Permukaan admin yang dibuka opt-in (ADR-0196..0198)
+
+Sampai ADR-0196..0198, `/api/agent-tokens*`, `/api/device-tokens*`, `/api/auth/users*`,
+`/api/auth/change-password`, `/api/remote-control`, `/api/devices/:id/relay/*`, `/api/logs*`,
+`/api/presence`, dan metrik custom agent cookie-only. Pemilik repo meminta mereka dibungkus, jadi
+keputusan lama itu dibalik **dengan capability baru yang opt-in** (tak ada capability lama yang
+membukanya) dan **pagar yang ditegakkan di server**, bukan hanya di katalog tool:
+
+| Hal | Aturan |
+|---|---|
+| Cetak agent token (`POST /api/agent-tokens`) | `capabilities` token baru HARUS himpunan-bagian milik pemanggil (`write ⊇ read`; danger hanya bila dimiliki persis). Selebihnya **403** `{ error, exceeds: [...] }` |
+| Ubah agent token (`PATCH`) | `capabilities` baru ⊆ milik pemanggil, **dan** token target tak boleh lebih berkuasa dari pemanggil (agen lemah tak bisa menonaktifkan/menurunkan token yang manusia beri hak lebih) |
+| Cabut agent token (`DELETE`) | aturan target yang sama |
+| Token sendiri | **tak bisa** diubah atau dicabut oleh dirinya sendiri (403 `{ self: true }`) — minta manusia |
+| Plaintext token | hanya di balasan `POST` (agent maupun device token); tak pernah di daftar atau di log audit; runtime MCP melepas topeng token HANYA untuk hasil sukses dua tool pencetak |
+| Device token | dicetak atas nama akun admin yang menerbitkan agent token pemanggil (rantai `agent:<id>` ditelusuri); tanpa penerbit manusia → **409**. Agen hanya melihat/mencabut device token milik akun itu |
+| Akun | membuat akun admin, menghapus akun, menyetel ulang password akun lain = `access:admin` (danger). Reset password agen: `{ userId, newPassword }` tanpa password lama, mencabut semua sesi akun itu, dan **tidak** menerbitkan cookie. Admin terakhir tetap tak bisa dihapus. `access:admin` setara menyerahkan seluruh instance |
+| Grant jarak jauh (`PUT /api/remote-control`) | `control.capabilities` ⊆ milik pemanggil; mengubah lajur log (data keluar ke hub) menuntut juga `logs:write` |
+| Relay perangkat | `relay:exec` (danger) untuk semua method; aktor ditandai `agent:<id>`; allowlist route ditegakkan mesin tujuan; WebSocket relay tidak tersedia untuk agen |
+| Jejak | setiap aksi admin oleh agent token tercatat di log event (`kind` `admin.*`) tanpa rahasia; perubahan retensi log dicatat **sebelum** nilainya berubah |
+
+Tool MCP-nya (semua tulis bermode `danger`, hanya tampil dengan `--danger`):
+
+| Tool | Mode | Capability |
+|---|---|---|
+| `hanoman_agent_tokens_list`, `hanoman_agent_token_capabilities` | baca | `tokens:read` |
+| `hanoman_agent_token_create`, `hanoman_agent_token_update`, `hanoman_agent_token_revoke` | danger | `tokens:write` |
+| `hanoman_device_tokens_list` | baca | `devices:read` |
+| `hanoman_device_token_create`, `hanoman_device_token_revoke` | danger | `devices:write` |
+| `hanoman_users_list` | baca | `access:read` |
+| `hanoman_user_create`, `hanoman_user_delete`, `hanoman_user_password_reset` | danger | `access:admin` |
+| `hanoman_remote_control_get` | baca | `remote:read` |
+| `hanoman_remote_control_set` | danger | `remote:control` |
+| `hanoman_device_relay` | danger | `relay:exec` |
+| `hanoman_device_access_request` | danger | `relay:exec` |
+| `hanoman_device_access_requests` | danger | `relay:exec` |
+| `hanoman_logs_search`, `hanoman_log_transcript`, `hanoman_logs_retention_get` | baca | `logs:read` |
+| `hanoman_logs_retention_set` | danger | `logs:write` |
+| `hanoman_presence_get` | baca | `presence:read` |
+| `hanoman_agent_metrics` | baca | `metrics:read` |
+| `hanoman_agent_invocation_disposition` | danger | `metrics:write` |
 
 ## 6. Endpoint yang paling sering dipakai
 
@@ -218,61 +287,25 @@ dan tak memakai agent token.
 | `POST /api/specs` | `backlog:write` | buat backlog item — bentuk payload di §7. |
 | `PATCH /api/specs/:id` | `backlog:write` | ubah item; konten hanya selagi belum dimulai. |
 | `POST /api/specs/:id/done` | `backlog:write` | tandai item **selesai** tanpa menjalankan sesi — untuk pekerjaan yang beres di luar hanoman. Body `{ reason?: string (≤280), confirm?: boolean }`, keduanya opsional; balasannya `Spec` yang sudah `stage:"done"`. Tak menjalankan maupun menghentikan sesi apa pun. |
+| `POST /api/specs/:id/reviewed` | `backlog:write` | tandai atau batalkan **sudah ditinjau** pada item yang sudah **selesai** (tool `hanoman_backlog_mark_reviewed`, ADR-0218). Body `{ reviewed?: boolean }`, default `true`; `false` membatalkan. Idempoten: menandai ulang tak mengubah stempelnya. Balasannya `Spec` dengan `reviewedAt`. 409 bila item belum selesai. Tak mengubah stage, diff, atau berkas. |
 | `GET /api/specs/:id/attachments` | `backlog:read` | lampiran backlog item — gambar & dokumen yang dilampirkan manusia sebagai konteks kerja. |
 | `POST /api/specs/:id/attachments` | `backlog:write` | unggah lampiran (`multipart/form-data`, beberapa berkas per request). Berkas yang ditolak **tak** menggagalkan yang lain — periksa `rejected[]`. |
 | `GET /api/specs/:id/attachments/:attId` | `backlog:read` | byte satu lampiran. |
 | `DELETE /api/specs/:id/attachments/:attId` | `backlog:write` | hapus satu lampiran. |
 | `GET /api/specs/:id/docs` | `backlog:read` | dokumen yang ditulis sesi item itu. |
-| `GET /api/specs/:id/review` | `backlog:read` | diff hasil kerja sesi. |
+| `GET /api/specs/:id/review` | `backlog:read` | diff hasil kerja sesi. Bila belum ada worktree maupun commit: **200** dengan `empty: true` dan `reason` — `no-worktree` (belum pernah dimulai) atau `no-commit` (worktree sudah lenyap tanpa commit); `base`, `files`, dan `changed` kosong. Itu keadaan, bukan galat (ADR-0213). Sesi memakai pola yang sama (ADR-0215). |
+| `DELETE /api/specs/:id/worktree` | `ide:git` (danger) | hapus worktree satu item (tool `hanoman_backlog_worktree_delete`, ADR-0213). Perubahan yang belum di-commit di dalamnya **hilang** dan sesi yang berjalan di sana ditutup; cabang dan commit tetap. Balasan **200** `{ name, ok, cleanup, closedSession?, error? }` — `ok: false` bila worktree tak ditemukan atau tak bisa dihapus. Capability-nya sama dengan `POST /api/projects/:id/worktrees/delete`, bukan `backlog:write`. |
 | `GET /api/projects/:id/docs` | `docs:read` | index Source of Truth project. |
 | `GET /api/projects/:id/docs/<path>` | `docs:read` | isi satu dokumen. |
-| `GET /api/projects/:id/changelog` | `docs:read` | changelog yang sudah dibangkitkan (paginated). |
-| `POST /api/projects/:id/changelog` | `docs:write` | bangkitkan changelog baru — bentuknya di **§6a**. |
 | `GET /api/terminal/sessions` | `sessions:read` | sesi yang sedang hidup. |
+| `GET /api/terminal/sessions/:id/review` | `sessions:read` | diff worktree sesi project-level (PRD). Bentuknya sama dengan review backlog item. Bila sesi tak punya worktree (`no-worktree`) atau worktree-nya sudah lenyap tanpa commit (`no-commit`): **200** dengan `empty: true` dan `reason`; `base`, `files`, dan `changed` kosong. Itu keadaan, bukan galat (ADR-0215, amandemen ADR-0213). Tool `hanoman_session_review`. |
+| `GET /api/terminal/sessions/:id/review/<path>` | `sessions:read` | isi diff satu berkas. **409** bila tak ada sumber sama sekali (tak ada berkas untuk dibaca); 404 bila path di luar daftar. |
 | `GET /api/notifications` | `notifications:read` | notifikasi. **Tanpa `limit` → 50 teratas**, bukan seluruhnya (lihat jebakan di §10). |
 | `GET /api/tickets` | `support:read` | tiket Help Center. |
 | `GET /api/lead/decisions` | `lead:read` | jejak keputusan hanoman-lead. Menerima `page`/`limit`; `take`/`skip` lama tetap jalan. |
 | `GET /api/scheduler/queue` | `settings:read` | antrean scheduler (`?status=queued\|launched\|done\|failed`). `GET /api/scheduler/state` **tak lagi** memuat `queue` — ia memuat `queueCounts`. |
 | `POST /api/lead/decisions` | `lead:write` | minta putusan — baca **§8** dan **§11** dulu. |
 
-## 6a. Changelog per project
-
-Ringkasan perubahan **berorientasi pemakai** — bukan daftar commit. Tiga mode, satu endpoint;
-`mode` menentukan field lainnya:
-
-```bash
-# 1) backlog yang selesai di rentang tanggal (dua field opsional → 30 hari terakhir)
-curl -sS -X POST "$HANOMAN_HOST/api/projects/<id>/changelog" \
-  -H "Authorization: Bearer $HANOMAN_AGENT_TOKEN" -H 'Content-Type: application/json' \
-  -d '{"mode":"backlog","from":"2026-07-01","to":"2026-07-31"}'
-
-# 2) rentang commit di repo project
-  -d '{"mode":"commit","fromSha":"4f2a1c9","toSha":"HEAD"}'
-
-# 3) versi/tag rilis (fromTag opsional → sejak versi sebelumnya)
-  -d '{"mode":"version","toTag":"v1.2.0"}'
-```
-
-Jawaban **201** berisi `body` (markdown siap pakai), `title`, `itemCount`, `generator`, dan
-`warning`. Ambil ulang atau unduh kapan saja:
-
-```bash
-curl -sS "$HANOMAN_HOST/api/projects/<id>/changelog/<cid>?download=md" \
-  -H "Authorization: Bearer $HANOMAN_AGENT_TOKEN"
-```
-
-Tiga hal yang perlu kamu tahu sebelum memanggilnya:
-
-- **Panggil `GET /api/projects/:id/changelog/sources` dulu.** Ia memberi tag yang tersedia, HEAD
-  singkat, rentang default, dan — bila repo belum ditautkan di mesin itu atau belum punya tag — satu
-  `reason` yang menjelaskan sebabnya. Ia menjawab **200**, bukan galat, jadi jangan perlakukan
-  `reason` sebagai kegagalan.
-- **422 berarti permintaanmu sah tapi tak ada isinya** (rentang kosong, repo tanpa tag, revisi tak
-  dikenal) — pesannya bisa langsung diteruskan ke manusia. **400** berarti bentuknya salah
-  (mis. `from` lebih baru dari `to`).
-- **`generator:"fallback"` bukan kegagalan.** Artinya narasi otomatis tak tersedia dan yang kamu
-  terima adalah draf ringkas deterministik; alasannya ada di `warning`.
-
 ## 7. `POST /api/specs` — bentuk payload per `source`
 
 `source` dan bentuk `payload` **saling mengikat**. Salah pasang → **400**
@@ -324,9 +357,11 @@ capability-nya. Capability menjawab "boleh?", bukan "sebaiknya?".
 | `POST /api/terminal/sessions` | melahirkan proses agen `--dangerously-skip-permissions` di sebuah worktree — **RCE efektif**. Batas satu-satunya adalah isolasi git worktree (ADR-0037). |
 | `POST`/`PUT`/`DELETE` di bawah `/api/vps` | **remote exec** di server produksi. |
 | `POST /api/lead/decisions` | putusannya bisa **menggerakkan sesi** (integrate ke main, menghentikan sesi) dan selalu melahirkan baris jejak permanen (ADR-0091/0098). |
+| `POST /api/update/apply`, `POST /api/restart` | memasang paket npm dan **me-restart server** (ADR-0200): dashboard & koneksi MCP putus beberapa detik; pane tmux selamat. Selalu `confirm: false` dulu untuk membaca jumlah sesi hidup. |
+| `POST /api/sync/conflicts/:entity/:recordId/resolve` | **membuang data satu sisi** (lokal atau hub) tanpa jalan pulang (ADR-0199). Baca `differs` dari `hanoman_sync_conflicts` dulu. |
 
-Perlakukan `POST /api/specs/:id/integrate`, `DELETE /api/specs/:id`, dan perubahan `stage` dengan
-disiplin yang sama: ketiganya mengubah sejarah git atau membuang pekerjaan. `POST /api/specs/:id/done`
+Perlakukan `POST /api/specs/:id/integrate`, `DELETE /api/specs/:id`, `DELETE /api/specs/:id/worktree`,
+dan perubahan `stage` dengan disiplin yang sama: keempatnya mengubah sejarah git atau membuang pekerjaan. `POST /api/specs/:id/done`
 tak menyentuh git, tetapi ia **menyatakan pekerjaan orang lain selesai** — pakai hanya bila kamu punya
 buktinya, dan tulis buktinya di `reason`.
 
@@ -506,7 +541,20 @@ Panduan siap salin untuk keempat klien, berikut tabel tool → capability, ada d
 | `hanoman_lead_decisions_list` | baca | `lead:read` |
 | `hanoman_backlog_create`, `hanoman_backlog_update` | tulis | `backlog:write` |
 | `hanoman_notifications_mark_read` | tulis | `notifications:write` |
+| `hanoman_notification_mark_read` | tulis | `notifications:write` — satu notifikasi berdasarkan `id` (ADR-0204), idempoten |
+| `hanoman_scheduler_queue_cancel`, `hanoman_scheduler_queue_requeue` | tulis | `settings:write`; requeue baris `failed` juga menuntut `sessions:spawn` (ADR-0204, 403 bila tak ada) |
 | `hanoman_lead_ask` | tulis | `lead:write` |
+| `hanoman_health`, `hanoman_models`, `hanoman_codex_version`, `hanoman_methods_status` | baca | — (`GLOBAL_READ`, ADR-0187) |
+| `hanoman_activity_list` | baca | `activity:read` |
+| `hanoman_activity_purge` | **berbahaya** | `activity:write` |
+| `hanoman_portal_admin_chat_sessions`, `hanoman_portal_admin_chat_session_get` | baca | `portal-chat:read` |
+| `hanoman_portal_admin_chat_export` | **berbahaya** | `portal-chat:read` |
+| `hanoman_portal_admin_chat_prd_write` | **berbahaya** | `portal-chat:write` |
+| `hanoman_sync_conflicts`, `hanoman_sync_pending` | baca | `sync:read` |
+| `hanoman_sync_now` | tulis | `sync:write` |
+| `hanoman_sync_conflict_resolve` | **danger** | `sync:resolve` |
+| `hanoman_update_apply`, `hanoman_instance_restart` | **danger** | `instance:admin` |
+| `hanoman_agent_guide` | baca | — (membaca halaman ini lewat `GET /api/agent-integration.md`, publik) |
 
 ### Yang sengaja TIDAK tersedia lewat MCP
 
@@ -516,18 +564,70 @@ penghapusan backlog, dan perubahan `stage`. Batasan ini ada di katalog toolnya,
 token yang punya `sessions:write` sekalipun tak akan menemukan tool untuk memakainya. Lihat §8.
 
 **Menjawab dialog sesi** (`GET /api/terminal/sessions/:id/dialog`,
-`POST /api/terminal/sessions/:id/dialog/answer`, dan sejak SPEC-909 · ADR-0146 juga
-`POST /api/terminal/sessions/:id/dialog/takeover` — merebut sesi dari hanoman-lead) sengaja **tak
-punya tool** — dan alasannya lebih tajam dari sekadar "mengeksekusi": endpoint itu menjawab pertanyaan
-yang **secara desain ditujukan kepada manusia** (`AskUserQuestion`). Agen yang bisa memanggilnya
-bisa menjawab pertanyaannya sendiri, dan gerbang "manusia terakhir yang memutuskan" runtuh lewat
-pintu belakang. Capability-nya tetap ada (`sessions:read`/`sessions:write`) karena peta itu berlaku
-untuk seluruh permukaan HTTP, bukan hanya untuk yang muncul di MCP.
-
-**Lampiran backlog** (`/api/specs/:id/attachments*`, SPEC-843 · ADR-0124) juga sengaja **tak punya
-tool**: berkasnya lahir dari disk manusia, bukan dari model, dan tool MCP berbentuk JSON sehingga
-byte biner tak punya representasi di sana. REST-nya tetap terjangkau agent token
-ber-`backlog:read`/`backlog:write` — yang tak dipajang adalah **tool**-nya.
+`POST /api/terminal/sessions/:id/dialog/answer`, `POST /api/terminal/sessions/:id/dialog/takeover`)
+dulu sengaja tak punya tool (SPEC-899 · ADR-0142: agen yang bisa menjawab `AskUserQuestion` bisa
+menjawab pertanyaannya sendiri, dan gerbang "manusia terakhir yang memutuskan" runtuh). Sejak
+**ADR-0190/ADR-0192** pemilik membungkusnya sebagai tool `hanoman_session_dialog_get|answer|takeover`
+(semuanya `danger`, hanya muncul dengan `--danger`) — dengan gerbang di **server**, bukan di
+deskripsi:
+
+- capability **`sessions:decide`** (domain `decisions`), terpisah dari `sessions:write`; `steer` ke
+  pane yang sedang menampilkan dialog pun menuntutnya;
+- **403** bila token ITU yang meluncurkan sesinya (`reason: "launcher"`), atau bila panggilan datang
+  dari dalam sesi hanoman — proses MCP yang diwarisi `HANOMAN_SESSION_ID` mengirim header
+  `x-hanoman-session` (`reason: "self"` / `"in-session"`);
+- **409** `deciding` (hanoman-lead sedang menyusun keputusan; rebut dulu lewat `takeover`) dan
+  `answering` tetap berlaku. 403 mendahului 409 supaya penolakan tak membocorkan keadaan lead.
+
+**Batas yang jujur:** server tak bisa membuktikan siapa di balik sebuah request Bearer — sesi tidak
+menerima agent token dari hanoman, jadi tak ada ikatan token↔sesi. Header `x-hanoman-session`
+bisa dilepas oleh klien yang sengaja memakai token yang sama lewat `curl`. Yang menutupnya adalah
+praktik: **jangan pasang token ber-`sessions:decide` di konfigurasi yang dibaca sesi hanoman**
+(mis. `~/.claude.json` tingkat-user diwarisi setiap sesi). Pakai token terpisah, di klien MCP yang
+dijalankan manusia di luar sesi.
+
+**Cronjob** (`/api/scheduler/crons*`, ADR-0191 membalik ADR-0112) kini punya tool
+`hanoman_scheduler_crons_list|cron_runs` (baca, `scheduler:read`) dan
+`hanoman_scheduler_cron_create|update|delete|run` (`danger`, `scheduler:write`). Karena sebuah cron
+adalah `POST /terminal/sessions` yang ditunda, **create, update yang menyentuh prompt/agen/model/
+effort/jadwal atau mengaktifkan, dan run** juga menuntut `sessions:spawn` — ditegakkan di handler
+server (403 `need: sessions:spawn`), bukan hanya disebut di deskripsi. Mengganti nama, menonaktifkan,
+dan menghapus cron cukup dengan `scheduler:write`.
+
+**Lampiran, ekspor/impor QA, unggah IDE, dan arsip git** punya tool sejak ADR-0183 — lihat
+[Transfer berkas](#transfer-berkas-adr-0183) di bawah. Yang tetap tak punya tool hanya WebSocket
+(`/terminal/sessions/:id/ws`, `/events/ws`) dan tiga route `dialog` di atas.
+
+### Transfer berkas (ADR-0183)
+
+Tool MCP berbicara JSON teks, jadi **byte tak pernah lewat model**. Satu mekanisme seragam:
+
+- **Unggah** — argumen `filePath` / `filePaths` / `files[].filePath` adalah path **lokal di mesin
+  tempat `hanoman mcp` berjalan**. Klien membacanya dan mengirimnya sebagai multipart.
+- **Unduh** — byte disimpan ke `savePath` lokal (default: direktori sementara aman); jawabannya
+  `{savedTo, filename, bytes, mime, sha256}`. `overwrite:true` wajib untuk menimpa berkas yang ada.
+  Teks kecil (template Markdown, ekspor `md`/`csv`) dikembalikan **inline** oleh
+  `hanoman_qa_template_md` dan `hanoman_qa_report_export_text`.
+- **Batas (ADR-0184)** — path hanya boleh di dalam direktori kerja MCP, direktori sementara MCP,
+  atau `HANOMAN_MCP_TRANSFER_DIRS`; `..`, symlink yang keluar, dan berkas rahasia (`.env`,
+  kunci SSH, `.git`, …) ditolak di kedua arah; ukuran dibatasi (default 100 MiB).
+- **Mode (ADR-0186)** — tool yang menyentuh disk klien bermode `write` walau capability-nya `:read`,
+  sehingga `--read-only` tak pernah menyentuh disk.
+
+| Tool | Mode | Capability |
+|---|---|---|
+| `hanoman_backlog_attachment_upload`, `hanoman_backlog_attachment_download` | tulis | `backlog:write` / `backlog:read` |
+| `hanoman_ticket_attachment_download` | tulis | `support:read` |
+| `hanoman_qa_attachment_upload`, `hanoman_qa_import`, `hanoman_qa_cases_import` | tulis | `qa:write` |
+| `hanoman_qa_attachment_download`, `hanoman_qa_template_xlsx`, `hanoman_qa_report_export_file` | tulis | `qa:read` |
+| `hanoman_qa_template_md`, `hanoman_qa_report_export_text` (inline) | baca | `qa:read` |
+| `hanoman_ide_upload` | tulis | `ide:write` |
+| `hanoman_ide_archive_download` | tulis | `ide:read` |
+| `hanoman_session_attachment_upload` (PNG/JPEG/WebP ≤ 5 MB; jawabannya path di SERVER) | tulis | `sessions:write` |
+| `hanoman_qa_report_delete`, `hanoman_qa_case_delete`, `hanoman_qa_finding_delete`, `hanoman_qa_attachment_delete` | **berbahaya** | `qa:delete` (ADR-0185) |
+
+`qa:delete` adalah akses `danger` yang **tak diimplikasikan `qa:write`**: token lama ber-`qa:write`
+tak lagi bisa menghapus data QA sampai manusia mencentang `qa:delete` di Settings → Akses AI Agent.
 
 ### Opsi
 
@@ -536,6 +636,8 @@ ber-`backlog:read`/`backlog:write` — yang tak dipajang adalah **tool**-nya.
 | `HANOMAN_HOST` / `--host <url>` | **Wajib.** Instance yang dituju. Agent token diterbitkan per-instance — token dari instance lain selalu 401 di sini, dan MCP server menjelaskannya, bukan meneruskan 401 telanjang. |
 | `HANOMAN_AGENT_TOKEN` | **Wajib.** Hanya dari env atau `~/.hanoman/agent-token` — **tak pernah** dari argumen baris perintah (ARGV terbaca proses lain di mesin yang sama). |
 | `HANOMAN_MCP_READ_ONLY=1` / `--read-only` | Menyembunyikan seluruh tool tulis dari `tools/list`. |
+| `HANOMAN_MCP_TRANSFER_DIRS` / `--transfer-dir <d>` | Direktori tambahan (dipisah `:`) yang boleh dibaca/ditulis tool transfer berkas, di luar direktori kerja MCP dan direktori sementara MCP. Akar filesystem ditolak. |
+| `HANOMAN_MCP_TRANSFER_MAX_BYTES` / `--transfer-max-bytes <n>` | Plafon ukuran per berkas dan total per panggilan transfer. Default 100 MiB, maks 2 GiB. |
 | `HANOMAN_MCP_MAX_BYTES` / `--max-bytes <n>` | Plafon ukuran balasan tool. Default 24576. Balasan yang dipotong ditandai `truncated: true` + `shown`/`total`. |
 
 Skema tool berversi (`MCP_TOOL_SCHEMA_VERSION`, saat ini **1**) dan aditif dalam satu versi:
@@ -547,3 +649,12 @@ menambah tool tak mematahkan klien lama.
 untuk permukaan MCP, [ADR-0099](../internal/docs/adr/0099-mcp-server-hanoman.md). Kontrak API penuh:
 [`internal/docs/architecture/api-contract.md`](../internal/docs/architecture/api-contract.md) —
 permukaan REST-nya identik dengan yang dipakai dashboard.*
+
+
+## Fitur yang dihapus — skema tool MCP versi 2
+
+Memori project dan changelog dihapus (ADR-0182). Tool `hanoman_memory_*` dan
+`hanoman_changelog_*` tidak tersedia; endpoint `/api/memories*` dan
+`/api/projects/:id/changelog*` tidak terdaftar. Token tidak lagi memiliki
+capability `memory:*` atau allowlist project khusus memori. Fungsi context/memory
+kanal Telegram tetap tersedia melalui domain `telegram`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hanoman",
-  "version": "0.9.19",
+  "version": "0.9.21",
   "description": "Orchestrator + dashboard workflow docs-driven untuk sesi Claude Code / Codex",
   "type": "module",
   "repository": {

package/prisma/migrations/20261010070000_remove_memory_changelog/migration.sql

@@ -0,0 +1,40 @@
+-- ADR-0182: user requested removal of these features AND their stored data.
+-- Purge sync payloads/outboxes first so retired records cannot be replayed.
+DELETE FROM "SyncLog" WHERE "entity" IN ('projectMemory', 'memoryEvent');
+DELETE FROM "SyncOutbox" WHERE "entity" IN ('projectMemory', 'memoryEvent');
+DELETE FROM "SyncConflict" WHERE "entity" IN ('projectMemory', 'memoryEvent');
+DELETE FROM "SyncTombstone" WHERE "entity" IN ('projectMemory', 'memoryEvent');
+UPDATE "SyncState" SET "entities" = trim(replace(replace(',' || "entities" || ',', ',projectMemory,', ','), ',memoryEvent,', ','), ',');
+DELETE FROM "Notification" WHERE "type" = 'memory';
+UPDATE "Setting" SET "data" = json_remove("data", '$.changelog') WHERE json_type("data", '$.changelog') IS NOT NULL;
+UPDATE "AgentToken" SET "capabilities" = (
+    SELECT json_group_array(value) FROM json_each("AgentToken"."capabilities")
+    WHERE value NOT IN ('memory:read', 'memory:write')
+);
+
+DROP TABLE "MemoryEvent";
+DROP TABLE "MemoryLocalState";
+DROP TABLE "ProjectMemory";
+DROP TABLE "Changelog";
+
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_AgentToken" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "name" TEXT NOT NULL,
+    "tokenHash" TEXT NOT NULL,
+    "tokenPrefix" TEXT NOT NULL,
+    "capabilities" JSONB NOT NULL,
+    "enabled" BOOLEAN NOT NULL DEFAULT true,
+    "createdBy" TEXT,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "lastUsedAt" DATETIME,
+    "revokedAt" DATETIME
+);
+INSERT INTO "new_AgentToken" ("capabilities", "createdAt", "createdBy", "enabled", "id", "lastUsedAt", "name", "revokedAt", "tokenHash", "tokenPrefix") SELECT "capabilities", "createdAt", "createdBy", "enabled", "id", "lastUsedAt", "name", "revokedAt", "tokenHash", "tokenPrefix" FROM "AgentToken";
+DROP TABLE "AgentToken";
+ALTER TABLE "new_AgentToken" RENAME TO "AgentToken";
+CREATE UNIQUE INDEX "AgentToken_tokenHash_key" ON "AgentToken"("tokenHash");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;
+

package/prisma/migrations/20261012100000_spec_reviewed_at/migration.sql

@@ -0,0 +1,13 @@
+-- ADR-0218 · penanda "sudah ditinjau" pada item selesai (filter Backlog "Perlu ditinjau").
+--
+-- Ditulis tangan (bukan `migrate dev`), pola SPEC-516/SPEC-804: worktree tetangga membuat
+-- `migrate dev` me-reset DB saat ada drift. ADITIF murni — satu kolom NULLABLE tanpa default.
+ALTER TABLE "Spec" ADD COLUMN "reviewedAt" DATETIME;
+
+-- Backfill sekali-jalan: item yang SUDAH selesai dianggap sudah ditinjau pada `updatedAt`-nya.
+-- Tanpa ini setiap item selesai yang pernah dikerjakan sesi (baseSha terisi) langsung masuk
+-- "Perlu ditinjau" begitu migrasi jalan, dan filter yang sejak hari pertama berisi ratusan baris
+-- tak lagi bisa dipercaya. Harganya diterima dan ditulis di ADR-0218: penanda hanya berlaku untuk
+-- penyelesaian SETELAH migrasi ini. Item lama yang belum pernah ditinjau tetap bisa dibuka lewat
+-- Review perubahan, hanya saja tidak lagi disorot oleh filter.
+UPDATE "Spec" SET "reviewedAt" = "updatedAt" WHERE "stage" = 'done' AND "reviewedAt" IS NULL;

package/prisma/schema.prisma

@@ -32,12 +32,10 @@ model Project {
   tickets      Ticket[]
   customAgents CustomAgent[] // SPEC-450 · ADR-0094 · custom agent milik project ini
   githubIssues GithubIssue[] // SPEC-471 · ADR-0095 · cermin issue repo GitHub project ini
-  changelogs   Changelog[]   // SPEC-516 · ADR-0105 · changelog tersimpan project ini
   clientAccess ClientProjectAccess[] // SPEC-617 · ADR-0110 · akun klien yang boleh melihat project ini
   portalChats  PortalChatSession[]   // SPEC-854 · ADR-0129 · percakapan portal klien project ini
   tasks        Task[]                // SPEC-945 · ADR-0150 · kartu kerja manusia di project ini
   qaReports    QaReport[]            // Workspace QA · laporan QA project ini
-  memories     ProjectMemory[]       // ADR-0178 · memori project bersama lintas runtime
 }
 
 model Spec {
@@ -77,6 +75,12 @@ model Spec {
   // ditandai manual. Ditimpa tiap penandaan berikutnya: ia menjelaskan keadaan yang BERLAKU;
   // riwayat transisi stage tinggal di SessionResult (ADR-0047). Ikut FIELDS.spec sync.
   manualDone Json?
+  // ADR-0218 · kapan operator menandai item SELESAI ini sudah ditinjau ("Tandai ditinjau"). null =
+  // belum ditinjau, atau item belum selesai. Ditulis HANYA oleh `POST /specs/:id/reviewed`, dan
+  // di-reset ke null saat stage dikembalikan mundur dari `done` (PATCH stage, POST source). SENGAJA
+  // tak di-reset oleh recordCompletion: reconcile memanggilnya ulang untuk item yang sudah selesai,
+  // dan itu akan menghapus tanda yang baru dipasang. Ikut FIELDS.spec sync (ADR-0218).
+  reviewedAt DateTime?
   // SPEC-447 · ADR-0093 · id spec lain yang harus SELESAI & commit-nya sudah ada di branch basis
   // sebelum item ini boleh diluncurkan. Array JSON of string; null/[] = tak bergantung apa pun.
   // Sengaja kolom, bukan tabel join: SQLite melarang scalar list, `Json` sudah dipakai `payload`,
@@ -106,7 +110,7 @@ model Spec {
 // `storageKey` opaque, `filename` nama asli tersanitasi untuk tampilan saja.
 //
 // LOCAL-only: TANPA `version`, jadi ia tak pernah masuk changefeed sync (cermin LeadFlow,
-// WebhookEndpoint, Changelog). Byte memang tak menyeberang (ADR-0062), dan metadata yang menyeberang
+// WebhookEndpoint). Byte memang tak menyeberang (ADR-0062), dan metadata yang menyeberang
 // TANPA byte-nya hanya menghasilkan lampiran yang tak bisa dibuka di mesin lain — keadaan terburuk
 // dari ketiga pilihan. Sengaja BUKAN TicketAttachment: tiket dan backlog dua domain dengan aturan
 // sync dan tingkat kepercayaan yang berbeda (ADR-0124 §1/§4).
@@ -124,29 +128,6 @@ model SpecAttachment {
   @@index([specId])
 }
 
-// SPEC-516 · ADR-0105 · changelog naratif per project yang sudah dibangkitkan.
-//
-// LOCAL-only: TANPA kolom `version`, jadi ia tak pernah masuk changefeed sync (cermin LeadFlow,
-// WebhookEndpoint, dan Project.autoMerge). Dua dari tiga modenya diturunkan dari checkout git di
-// MESIN INI, jadi barisnya fakta lokal; yang portabel adalah keluarannya, dan jalannya sudah ada
-// — unduh .md.
-model Changelog {
-  id         String   @id @default(cuid())
-  projectId  String
-  mode       String   // "backlog" | "commit" | "version" (zChangelogMode di @hanoman/shared)
-  title      String   // judul di daftar: rentang tanggal / nama tag / rentang tag
-  params     Json     // parameter pembangkitan apa adanya (zChangelogRequest)
-  body       String   // markdown hasil akhir, sudah lewat scrubOutput
-  generator  String   // "agent" | "fallback"
-  warning    String?  // alasan fallback + catatan cakupan; null = mulus
-  itemCount  Int      @default(0)
-  createdAt  DateTime @default(now())
-  updatedAt  DateTime @updatedAt
-  project    Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
-
-  @@index([projectId, createdAt])
-}
-
 // SPEC-450 · ADR-0094 · custom agent: persona yang bisa dipilih ulang & dibagi.
 // `projectId` null = GLOBAL (semua project); terisi = milik satu project, dan agen project
 // MENIMPA agen global bernama sama.
@@ -439,8 +420,6 @@ model AgentToken {
   tokenHash    String    @unique
   tokenPrefix  String
   capabilities Json
-  // ADR-0178 · allowlist project. null/[] = token tak boleh menyentuh route memori sama sekali.
-  projectIds   Json?
   enabled      Boolean   @default(true)
   createdBy    String?
   createdAt    DateTime  @default(now())
@@ -1159,55 +1138,3 @@ model QaAttachment {
   @@index([ownerType, ownerId])
   @@index([syncState])
 }
-
-// ADR-0178 · satu fakta per baris. content/anchors/scopePaths/kind TAK PERNAH diedit — koreksi =
-// baris baru dengan `supersedesId`. Hanya `status` yang bergerak, dan hanya naik (lattice).
-model ProjectMemory {
-  id              String   @id @default(cuid())
-  projectId       String
-  project         Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
-  kind            String   // convention | gotcha | decision | fact
-  content         String
-  scopePaths      Json     // string[] glob relatif root repo; [] = seluruh project
-  anchors         Json     // [{path, blobSha, lines?}]
-  status          String   // proposed | active | invalidated | rejected
-  supersedesId    String?
-  reviewReason    String?  // decision | no-anchor | anchor-unverified | untrusted-source
-  sourceRuntime   String   // claude | codex | external | human
-  sourceSessionId String?
-  sourceTokenId   String?
-  sourceDeviceId  String?  // diisi tahap sync
-  commitSha       String?
-  trusted         Boolean  @default(true)
-  version         Int      @default(0)
-  createdAt       DateTime @default(now())
-  updatedAt       DateTime @updatedAt
-  events          MemoryEvent[]
-
-  @@index([projectId, status])
-}
-
-// ADR-0178 · jejak audit append-only. Tak pernah di-update atau dihapus kecuali ikut cascade.
-model MemoryEvent {
-  id        String        @id @default(cuid())
-  memoryId  String
-  memory    ProjectMemory @relation(fields: [memoryId], references: [id], onDelete: Cascade)
-  op        String        // propose | activate | reject | invalidate | supersede | reverify
-  actorKind String        // user | token | session | system
-  actorId   String?
-  reason    String?
-  createdAt DateTime      @default(now())
-  version   Int           @default(0)   // ADR-0180 · wajib bagi entitas sync
-  updatedAt DateTime      @updatedAt
-
-  @@index([memoryId, createdAt])
-}
-
-// ADR-0178 · LOCAL-ONLY (tak pernah disync): hasil verifikasi jangkar bergantung HEAD mesin ini.
-model MemoryLocalState {
-  memoryId       String    @id
-  verdict        String    // valid | stale | unverifiable
-  verifiedHead   String?
-  lastVerifiedAt DateTime?
-  lastUsedAt     DateTime?
-}