hanoman 0.1.39 → 0.1.41

package/docs/agent-integration.md

@@ -168,6 +168,7 @@ dan tak memakai agent token.
 | `GET /api/specs` | `backlog:read` | backlog. Filter: `project`, `source`, `q`, `stage`, `priority`, `startable=true`, `dateField=created\|started` + `from`/`to` (`YYYY-MM-DD`, inklusif), `page`, `limit`. |
 | `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. |
 | `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/projects/:id/docs` | `docs:read` | index Source of Truth project. |
@@ -271,7 +272,9 @@ capability-nya. Capability menjawab "boleh?", bukan "sebaiknya?".
 | `POST /api/lead/decisions` | putusannya bisa **menggerakkan sesi** (integrate ke main, menghentikan sesi) dan selalu melahirkan baris jejak permanen (ADR-0091/0098). |
 
 Perlakukan `POST /api/specs/:id/integrate`, `DELETE /api/specs/:id`, dan perubahan `stage` dengan
-disiplin yang sama: ketiganya mengubah sejarah git atau membuang pekerjaan.
+disiplin yang sama: ketiganya 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`.
 
 **Preseden yang mengikat:** MCP server resmi (`hanoman mcp`, §13) sengaja **tak punya tool** untuk
 satu pun dari yang di atas — batasnya ada di katalog tool, bukan di token. Token yang punya
@@ -286,6 +289,7 @@ memanggilnya; jangan lakukan tanpa manusia.
 | `q` mencari di `id`, `title`, dan `objective` saja — ia **tak menyentuh `payload`** | untuk mencari isi brief/QA, ambil itemnya lalu baca `payload` sendiri |
 | `id` dan `stage` yang kamu sertakan di `POST /api/specs` **dibuang diam-diam** — tak ada galat | `id` diterbitkan server (`SPEC-nnn` berikutnya), `stage` selalu mulai `brainstorming`. Untuk mengubah stage pakai `PATCH /api/specs/:id`, dan ia hanya boleh **mundur** (ADR-0027) |
 | **`GET /api/specs/:id` tidak ada** | `GET /api/specs?q=SPEC-489` lalu cocokkan `id` **persis** — `q` itu substring, jadi ia bisa mengembalikan lebih dari satu |
+| `POST /api/specs/:id/done` menjawab **409 `{"error":"confirm-required","session":{...}}`** — itu bukan penolakan, melainkan pemberitahuan bahwa masih ada **sesi hidup** untuk item itu | putuskan dulu apakah sesi itu memang sudah tak relevan; bila ya, kirim ulang dengan `{"confirm": true}`. Sesinya **tidak** ikut dihentikan — tutup sesinya sendiri bila perlu. 409 `{"error":"backlog item sudah selesai"}` berarti item itu memang sudah `done` |
 | daftar mengembalikan amplop `{ items, total, page, pageSize }` | jangan perlakukan responsnya sebagai array |
 | tanpa `limit`, daftar mengembalikan **seluruh** item dalam satu halaman | kirim `limit` untuk backlog besar |
 | **`GET /api/notifications` adalah pengecualiannya**: tanpa `limit` ia mengembalikan **50 teratas**, bukan seluruhnya — angka penuhnya ada di `total` | kirim `page`/`limit` bila kamu butuh riwayat lama; jangan simpulkan `items.length` = seluruh notifikasi |

package/package.json

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

package/prisma/migrations/20260815120000_sync_tombstone/migration.sql

@@ -0,0 +1,14 @@
+-- SPEC-799 · ADR-0119 · tombstone sync: penghapusan sebagai keadaan pertama-kelas.
+CREATE TABLE "SyncTombstone" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "entity" TEXT NOT NULL,
+    "recordId" TEXT NOT NULL,
+    "version" INTEGER NOT NULL,
+    "data" JSONB NOT NULL,
+    "deletedAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deviceId" TEXT
+);
+CREATE UNIQUE INDEX "SyncTombstone_entity_recordId_key" ON "SyncTombstone"("entity", "recordId");
+
+-- Additive & default aman: seluruh baris feed lama terbaca sebagai "upsert".
+ALTER TABLE "SyncLog" ADD COLUMN "op" TEXT NOT NULL DEFAULT 'upsert';

package/prisma/migrations/20260815130000_spec_manual_done/migration.sql

@@ -0,0 +1,9 @@
+-- SPEC-804 · ADR-0120 · jejak penandaan selesai manual sebagai kolom.
+--
+-- Ditulis tangan (bukan `migrate dev`): worktree tetangga membuat `migrate dev` me-reset DB saat
+-- ada drift. ADITIF murni — satu kolom NULLABLE tanpa default, tak ada tabel diredefinisi.
+--
+-- TANPA backfill, sengaja: sebelum spec ini jalur "tandai selesai manual" memang tak ada, jadi
+-- tak ada stempel lama yang bisa dipulihkan. Item lama tetap NULL = "selesai lewat sesi / tak
+-- diketahui", dan itu jawaban yang jujur.
+ALTER TABLE "Spec" ADD COLUMN "manualDone" JSONB;

package/prisma/schema.prisma

@@ -63,6 +63,12 @@ model Spec {
   // site adalah kelas bug SPEC-431/448/475. Tulis-sekali: reopen lalu selesai lagi tak
   // memindahkannya, cermin `startedAt` = mulai pertama (ADR-0090).
   doneAt     DateTime?
+  // SPEC-804 · ADR-0120 · jejak penandaan selesai MANUAL: { at, by, reason? }. Satu kolom, bukan
+  // tiga skalar — ketiganya satu peristiwa, dan tiga kolom nullable bisa drift tanpa tipe yang
+  // memaksanya konsisten (kelas gagal-senyap ADR-0090/0093/0094/0105). null = item ini tak pernah
+  // 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?
   // 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`,
@@ -385,6 +391,11 @@ model SyncLog {
   recordId  String
   version   Int
   data      Json
+  // SPEC-799 · ADR-0119 · jenis peristiwa. `@default("upsert")` membuat seluruh baris feed lama
+  // terbaca benar tanpa backfill. Kolom TOP-LEVEL, bukan penanda di dalam `data`: `validateSyncData`
+  // menegakkan allowlist atas `data`, jadi penanda di sana membuat client versi lama MELEMPAR →
+  // `feedHole` menyala → kursornya tertahan selamanya.
+  op        String   @default("upsert")
   deviceId  String?
   createdAt DateTime @default(now())
 
@@ -431,6 +442,27 @@ model SyncConflict {
   @@unique([entity, recordId])
 }
 
+// SPEC-799 · ADR-0119 · LOCAL-ONLY sebagai tabel, tapi maknanya menyeberang: keadaan "record ini
+// dihapus" yang bertahan restart dan menahan setiap upaya membangkitkannya kembali. Hard-delete
+// dipertahankan (bukan soft-delete `deletedAt` per entitas) supaya cascade tingkat-DB tetap bekerja
+// dan tak satu pun query baca yang sudah ada harus berubah — penyaring yang terlewat di bentuk itu
+// gagal SENYAP dengan gejala persis bug yang sedang diperbaiki.
+//
+// `data` = snapshot field tersync tepat sebelum baris dihapus. Ia BUKAN kenyamanan: tanpa snapshot,
+// push delete ke hub versi LAMA (yang membuang `op` sebagai field tak dikenal) berbentuk create
+// tanpa kolom required → P2011 → 500 di setiap siklus push.
+model SyncTombstone {
+  id        String   @id @default(cuid())
+  entity    String
+  recordId  String
+  version   Int      // versi record SESUDAH dihapus (= versi terakhirnya + 1)
+  data      Json
+  deletedAt DateTime @default(now())
+  deviceId  String?
+
+  @@unique([entity, recordId])
+}
+
 // SPEC-294 · ADR-0072 · LOCAL-ONLY (tak disync, cermin SyncOutbox): antrean durable kandidat peluncuran
 // scheduler. specId @unique = idempoten satu-sesi-per-spec (ADR-0015). Unit peluncuran selalu Spec.
 model SchedulerQueueItem {