hanoman 0.1.11 → 0.1.13

package/package.json

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

package/prisma/migrations/20260801190000_lead_choice/migration.sql

@@ -0,0 +1,13 @@
+-- SPEC-480 · ADR-0098 · putusan lead yang bisa dipakai mesin: pilihan tersimpan sebagai data.
+--
+-- Ditulis tangan (bukan `migrate dev`): worktree tetangga membuat `migrate dev` me-reset DB saat
+-- ada drift. ADITIF murni — empat kolom NULLABLE tanpa default, tak ada tabel diredefinisi, tak
+-- ada baris disentuh. Larangan SQLite atas `ADD COLUMN … DEFAULT <non-konstan>` (lihat migration
+-- SPEC-408) tak berlaku di sini karena tak ada default sama sekali.
+--
+-- `options` menyimpan menu yang DIKIRIM PEMINTA. Tanpa itu jejaknya tak bisa dibaca ulang:
+-- `question` tersimpan, opsinya tidak, jadi "lead memilih opsi 2" tak bisa diverifikasi kemudian.
+ALTER TABLE "LeadDecision" ADD COLUMN "choice" TEXT;
+ALTER TABLE "LeadDecision" ADD COLUMN "choiceIndex" INTEGER;
+ALTER TABLE "LeadDecision" ADD COLUMN "options" JSONB;
+ALTER TABLE "LeadDecision" ADD COLUMN "missing" JSONB;

package/prisma/migrations/20260801220000_webhook/migration.sql

@@ -0,0 +1,48 @@
+-- SPEC-481 · ADR-0100 · webhook keluar: endpoint + antrean/riwayat pengiriman.
+--
+-- Dua tabel BARU → `CREATE TABLE` polos; tak ada redefinisi tabel seperti migration SPEC-408.
+-- Keduanya LOCAL-only (tanpa kolom `version`): barisnya memegang secret dan menunjuk pengiriman
+-- dari mesin ini.
+CREATE TABLE "WebhookEndpoint" (
+    "id"             TEXT NOT NULL PRIMARY KEY,
+    "name"           TEXT NOT NULL,
+    "url"            TEXT NOT NULL,
+    "secret"         TEXT NOT NULL,
+    "events"         JSONB NOT NULL,
+    "projectIds"     JSONB,
+    "enabled"        BOOLEAN NOT NULL DEFAULT true,
+    "allowPrivate"   BOOLEAN NOT NULL DEFAULT false,
+    "apiVersion"     INTEGER NOT NULL DEFAULT 1,
+    "maxPerMinute"   INTEGER NOT NULL DEFAULT 60,
+    "disabledAt"     DATETIME,
+    "disabledReason" TEXT,
+    "lastSuccessAt"  DATETIME,
+    "lastFailureAt"  DATETIME,
+    "failureStreak"  INTEGER NOT NULL DEFAULT 0,
+    "createdAt"      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt"      DATETIME NOT NULL
+);
+
+CREATE TABLE "WebhookDelivery" (
+    "id"            TEXT NOT NULL PRIMARY KEY,
+    "endpointId"    TEXT NOT NULL,
+    "eventId"       TEXT NOT NULL,
+    "eventType"     TEXT NOT NULL,
+    "projectId"     TEXT,
+    "payload"       JSONB NOT NULL,
+    "status"        TEXT NOT NULL DEFAULT 'pending',
+    "attempt"       INTEGER NOT NULL DEFAULT 0,
+    "maxAttempts"   INTEGER NOT NULL DEFAULT 6,
+    "nextAttemptAt" DATETIME,
+    "httpStatus"    INTEGER,
+    "durationMs"    INTEGER,
+    "error"         TEXT,
+    "createdAt"     DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "sentAt"        DATETIME,
+    CONSTRAINT "WebhookDelivery_endpointId_fkey" FOREIGN KEY ("endpointId")
+        REFERENCES "WebhookEndpoint" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+CREATE INDEX "WebhookDelivery_status_nextAttemptAt_idx" ON "WebhookDelivery" ("status", "nextAttemptAt");
+CREATE INDEX "WebhookDelivery_endpointId_createdAt_idx" ON "WebhookDelivery" ("endpointId", "createdAt");
+CREATE INDEX "WebhookDelivery_eventId_idx" ON "WebhookDelivery" ("eventId");

package/prisma/migrations/20260801230000_auto_merge/migration.sql

@@ -0,0 +1,8 @@
+-- SPEC-486 · ADR-0103 · kebijakan auto-merge saat sesi selesai.
+--
+-- ADITIF & nullable tanpa default → `ADD COLUMN` polos (pola migration SPEC-447). Yang dilarang
+-- SQLite adalah `ADD COLUMN … DEFAULT <non-konstan>`, bukan `ADD COLUMN` itu sendiri. Baris lama
+-- tetap NULL, dan NULL berarti "tanpa auto-merge" di Project / "warisi project" di Spec —
+-- jadi tak ada backfill, dan project lama tak berubah perilaku satu langkah git pun.
+ALTER TABLE "Project" ADD COLUMN "autoMerge" JSONB;
+ALTER TABLE "Spec" ADD COLUMN "autoMerge" JSONB;

package/prisma/migrations/20260801230000_custom_agent_runtime/migration.sql

@@ -0,0 +1,8 @@
+-- SPEC-484 · ADR-0101 · penyaring mesin sesi per definisi agen.
+--
+-- NULLABLE TANPA DEFAULT, dan itu yang membuat migration ini satu baris: setiap baris lama tetap
+-- NULL = "ikut sesi induk" = perilaku ADR-0094 apa adanya, jadi tak ada backfill dan tak ada satu
+-- pun roster yang berubah saat rilis ini mendarat. Larangan SQLite atas
+-- `ADD COLUMN … DEFAULT CURRENT_TIMESTAMP` (migration SPEC-408) tak berlaku di sini justru karena
+-- kolomnya tanpa default — tabel tak perlu diredefinisi.
+ALTER TABLE "CustomAgent" ADD COLUMN "runtime" TEXT;

package/prisma/migrations/20260801234500_lead_flow/migration.sql

@@ -0,0 +1,36 @@
+-- SPEC-485 · ADR-0102 · rantai keputusan lead + pilihan jamak.
+--
+-- Ditulis tangan (bukan `migrate dev`): worktree tetangga membuat `migrate dev` me-reset DB saat
+-- ada drift. ADITIF murni — satu tabel baru + empat kolom NULLABLE tanpa default, tak ada tabel
+-- diredefinisi, tak ada baris disentuh. Larangan SQLite atas `ADD COLUMN … DEFAULT <non-konstan>`
+-- (lihat migration SPEC-408) tak berlaku di sini karena tak ada default sama sekali pada ALTER.
+--
+-- `LeadFlow` LOCAL-only: tanpa kolom `version`, tak pernah masuk changefeed sync — barisnya
+-- menunjuk sesi tmux & worktree di MESIN INI, persis alasan `LeadDecision` juga tak disync.
+CREATE TABLE "LeadFlow" (
+    "id"          TEXT NOT NULL PRIMARY KEY,
+    "projectId"   TEXT NOT NULL,
+    "specId"      TEXT,
+    "sessionId"   TEXT,
+    "gate"        TEXT NOT NULL,
+    "status"      TEXT NOT NULL DEFAULT 'menunggu',
+    "title"       TEXT NOT NULL,
+    "steps"       INTEGER NOT NULL DEFAULT 0,
+    "closeReason" TEXT,
+    "openedAt"    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "closedAt"    DATETIME,
+    "expiresAt"   DATETIME NOT NULL,
+    "createdAt"   DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt"   DATETIME NOT NULL
+);
+CREATE INDEX "LeadFlow_projectId_createdAt_idx" ON "LeadFlow"("projectId", "createdAt");
+CREATE INDEX "LeadFlow_status_idx" ON "LeadFlow"("status");
+
+-- `choices` menggantikan pasangan skalar `choice`/`choiceIndex` sebagai bentuk yang berlaku; yang
+-- lama DIPERTAHANKAN dan diisi dari `choices[0]` supaya pembaca lama (dan baris pra-migrasi) tetap
+-- terbaca tanpa backfill apa pun.
+ALTER TABLE "LeadDecision" ADD COLUMN "flowId" TEXT;
+ALTER TABLE "LeadDecision" ADD COLUMN "step" INTEGER;
+ALTER TABLE "LeadDecision" ADD COLUMN "choices" JSONB;
+ALTER TABLE "LeadDecision" ADD COLUMN "select" JSONB;
+CREATE INDEX "LeadDecision_flowId_idx" ON "LeadDecision"("flowId");

package/prisma/schema.prisma

@@ -21,6 +21,9 @@ model Project {
   helpEnabled Boolean @default(false) // SPEC-253 · opt-in Help Center publik
   schedulerOptIn Boolean @default(false) // SPEC-294 · ADR-0072 · opt-in scheduler otonom (LOCAL — tak masuk FIELDS sync)
   leadOptIn      Boolean @default(false) // SPEC-409 · ADR-0091 · opt-in hanoman-lead (LOCAL — cermin schedulerOptIn)
+  // SPEC-486 · ADR-0103 · kebijakan auto-merge saat backlog item selesai (LOCAL — tak masuk
+  // FIELDS sync, cermin repoDir/schedulerOptIn). null = tanpa auto-merge (default, nol backfill).
+  autoMerge      Json?
   specs        Spec[]
   tickets      Ticket[]
   customAgents CustomAgent[] // SPEC-450 · ADR-0094 · custom agent milik project ini
@@ -54,6 +57,9 @@ model Spec {
   // dan kolom ikut FIELDS.spec sync apa adanya. Integritas ditegakkan di boundary route +
   // pembersihan saat spec dihapus, bukan FK.
   dependsOn  Json?
+  // SPEC-486 · ADR-0103 · override kebijakan auto-merge untuk item ini. null = warisi project.
+  // `Json?` dengan alasan yang sama seperti dependsOn: blok dibaca utuh, tak pernah difilter.
+  autoMerge  Json?
   updatedAt  DateTime @updatedAt
   project   Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
 }
@@ -82,6 +88,7 @@ model CustomAgent {
   tools        Json?
   model        String?
   mentions     Json?
+  runtime      String?  // SPEC-484 · ADR-0101 · penyaring mesin sesi; null = ikut sesi induk
   enabled      Boolean  @default(true)
   version      Int      @default(0) // SPEC-213 · version-stamp sync (ADR-0045)
   createdAt    DateTime @default(now())
@@ -371,6 +378,33 @@ model SchedulerQueueItem {
   @@index([status])
 }
 
+// SPEC-485 · ADR-0102 · satu RANTAI keputusan lead: beberapa pertanyaan berurutan yang satu urusan,
+// dari pertanyaan pertama sampai submit akhir. Sebelum model ini "alur" hanya ada sebagai kebetulan
+// (baris jejak yang berdekatan waktunya), jadi tak ada tempat untuk menegakkan "pertanyaan lanjutan
+// hanya boleh masuk ke alur yang masih aktif" dan tak ada yang bisa ditanya "sudah di-submit belum".
+//
+// LOCAL-ONLY (tanpa `version`, tak pernah disync) dan TANPA FK — cermin LeadDecision di bawah:
+// id project/spec/sesi boleh lenyap tanpa menyeret jejaknya.
+model LeadFlow {
+  id          String    @id @default(cuid())
+  projectId   String
+  specId      String?
+  sessionId   String?
+  gate        String                              // pintu yang membuka rantai (contract|detected|pulse)
+  status      String    @default("menunggu")      // menunggu | sebagian | selesai | dibatalkan
+  title       String                              // pertanyaan pertama, terpangkas — ini yang dibaca operator
+  steps       Int       @default(0)
+  closeReason String?                             // tunggal | submit | operator | kedaluwarsa
+  openedAt    DateTime  @default(now())
+  closedAt    DateTime?
+  expiresAt   DateTime                            // pagar anti-menggantung; penyapunya menumpang tick lead
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  @@index([projectId, createdAt])
+  @@index([status])
+}
+
 // SPEC-409 · ADR-0091 · jejak keputusan hanoman-lead. Data BARU yang harus bertahan (bukan nilai
 // turunan seperti coverage/PRD, ADR-0011/0018): pertanyaan yang ditanyakan sesi yang sudah mati,
 // dan alasan yang dipakai lead, tak bisa dihitung ulang dari sumber mana pun.
@@ -396,12 +430,26 @@ model LeadDecision {
   weighty        Boolean   @default(false)     // memicu notifikasi (AC-25)
   supersededById String?   // baris yang menimpanya (jawaban operator, AC-28)
   actor          String    @default("lead")    // lead | operator — siapa yang mengeluarkan baris ini
+  // SPEC-480 · ADR-0098 · pilihan sebagai DATA. Keempatnya nullable tanpa default: baris yang lahir
+  // sebelum spec ini sah apa adanya, dan "tak ada opsi" beda dari "opsi kosong".
+  choice         String?   // label opsi terpilih, verbatim; null = tak ada opsi / pilihan ditolak
+  choiceIndex    Int?      // 1-basis, sepasang dengan `choice`
+  options        Json?     // string[] — daftar opsi yang DIKIRIM peminta, supaya jejak bisa diaudit
+  missing        Json?     // string[] — apa yang kurang bila lead menyatakan konteksnya tak cukup
+  // SPEC-485 · ADR-0102 · aditif & nullable: baris lama sah apa adanya. `choices` adalah bentuk
+  // penyimpanan yang BERLAKU; `choice`/`choiceIndex` di atas tinggal turunan `choices[0]`, dan
+  // baris pra-migrasi diturunkan balik jadi `choices` saat dibaca (kompatibilitas mundur).
+  flowId         String?   // rantai tempat langkah ini duduk
+  step           Int?      // urutan langkah dalam rantai, 1-basis
+  choices        Json?     // {index,option}[] — SELALU daftar
+  select         Json?     // {mode,min,max} sebagaimana dikirim peminta
   createdAt      DateTime  @default(now())
   updatedAt      DateTime  @updatedAt
 
   @@index([projectId, createdAt])
   @@index([specId])
   @@index([sessionId])
+  @@index([flowId])
 }
 
 // SPEC-215 · ADR-0049 · LOCAL-ONLY: override config runtime (env → DB). Tak pernah disync.
@@ -564,3 +612,58 @@ model TicketAttachment {
 
   @@index([ticketId])
 }
+
+// SPEC-481 · ADR-0100 · endpoint webhook keluar. LOCAL-only (cermin AgentToken/RuntimeConfig):
+// barisnya memegang secret dan menunjuk pengiriman dari MESIN INI, jadi menyiarkannya ke hub
+// akan mengirim kredensial dan riwayat yang tak berlaku di sana. Tanpa `version`/notifySynced.
+//
+// `secret` disimpan sebagai ciphertext `enc:v1:` (services/secret-box.ts, ADR-0097) dan TAK PERNAH
+// dikembalikan utuh oleh API — hanya empat karakter terakhir sebagai `secretHint`.
+model WebhookEndpoint {
+  id             String    @id @default(cuid())
+  name           String
+  url            String
+  secret         String
+  events         Json      // string[]; ["*"] = semua, "spec.*" = satu keluarga
+  projectIds     Json?     // string[] | null = semua project
+  enabled        Boolean   @default(true)
+  allowPrivate   Boolean   @default(false) // izin EKSPLISIT alamat internal/loopback (anti-SSRF)
+  apiVersion     Int       @default(1)     // versi amplop yang diminta penerima
+  maxPerMinute   Int       @default(60)
+  disabledAt     DateTime?
+  disabledReason String?
+  lastSuccessAt  DateTime?
+  lastFailureAt  DateTime?
+  failureStreak  Int       @default(0)
+  createdAt      DateTime  @default(now())
+  updatedAt      DateTime  @updatedAt
+  deliveries     WebhookDelivery[]
+}
+
+// SPEC-481 · ADR-0100 · satu tabel merangkap ANTREAN dan RIWAYAT.
+//
+// `payload` disimpan per pengiriman, bukan dirender ulang: retry wajib mengirim byte yang SAMA
+// supaya `id` peristiwa stabil dan idempotensi penerima berlaku, dan riwayat harus memperlihatkan
+// apa yang benar-benar dikirim, bukan keadaan hari ini.
+model WebhookDelivery {
+  id            String    @id @default(cuid())
+  endpointId    String
+  eventId       String    // SAMA untuk semua endpoint dari satu peristiwa
+  eventType     String
+  projectId     String?
+  payload       Json
+  status        String    @default("pending") // pending | sending | sent | failed | dropped
+  attempt       Int       @default(0)
+  maxAttempts   Int       @default(6)
+  nextAttemptAt DateTime?
+  httpStatus    Int?
+  durationMs    Int?
+  error         String?
+  createdAt     DateTime  @default(now())
+  sentAt        DateTime?
+  endpoint      WebhookEndpoint @relation(fields: [endpointId], references: [id], onDelete: Cascade)
+
+  @@index([status, nextAttemptAt])
+  @@index([endpointId, createdAt])
+  @@index([eventId])
+}