hanoman 0.1.58 → 0.2.0

package/docs/agent-integration.md

@@ -154,6 +154,11 @@ 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/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
+  `/api/events/ws` mengikuti gerbang yang sama — grup itu **tidak** dikirim ke principal non-cookie,
+  walau kanalnya sendiri `GLOBAL_READ` bagi agent token
 - `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

package/package.json

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

package/prisma/migrations/20260825120000_team_member_task/migration.sql

@@ -0,0 +1,45 @@
+-- SPEC-945 · ADR-0150 · fondasi papan tim: direktori orang + kartu kerja manusia.
+--
+-- Ditulis tangan (bukan `migrate dev`): worktree tetangga membuat `migrate dev` me-reset DB saat
+-- ada drift. ADITIF murni — dua tabel BARU, tak ada tabel diredefinisi, tanpa backfill.
+--
+-- `Member.id` deterministik (email ternormalisasi) ditulis aplikasi, bukan default DB: itulah yang
+-- mencegah dua mesin melahirkan dua baris untuk orang yang sama (pola CustomAgent, ADR-0094).
+-- `Task.specId` sengaja TANPA FOREIGN KEY, cermin Ticket.specId: changefeed bisa memancarkan Task
+-- sebelum Spec-nya mendarat (kelas SPEC-382), dan FK akan menolaknya.
+CREATE TABLE "Member" (
+    "id"        TEXT NOT NULL PRIMARY KEY,
+    "name"      TEXT NOT NULL,
+    "email"     TEXT NOT NULL,
+    "role"      TEXT,
+    "active"    BOOLEAN NOT NULL DEFAULT true,
+    "version"   INTEGER NOT NULL DEFAULT 0,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL
+);
+
+CREATE UNIQUE INDEX "Member_email_key" ON "Member" ("email");
+
+CREATE TABLE "Task" (
+    "id"        TEXT NOT NULL PRIMARY KEY,
+    "projectId" TEXT,
+    "title"     TEXT NOT NULL,
+    "detail"    TEXT,
+    "status"    TEXT NOT NULL,
+    "priority"  TEXT NOT NULL DEFAULT 'sedang',
+    "memberId"  TEXT,
+    "startDate" DATETIME,
+    "dueDate"   DATETIME,
+    "order"     REAL NOT NULL DEFAULT 0,
+    "specId"    TEXT,
+    "version"   INTEGER NOT NULL DEFAULT 0,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "Task_projectId_fkey" FOREIGN KEY ("projectId")
+        REFERENCES "Project" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "Task_memberId_fkey" FOREIGN KEY ("memberId")
+        REFERENCES "Member" ("id") ON DELETE SET NULL ON UPDATE CASCADE
+);
+
+CREATE INDEX "Task_projectId_status_idx" ON "Task" ("projectId", "status");
+CREATE INDEX "Task_memberId_idx" ON "Task" ("memberId");

package/prisma/schema.prisma

@@ -35,6 +35,7 @@ model Project {
   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
 }
 
 model Spec {
@@ -176,6 +177,68 @@ model CustomAgent {
   @@index([projectId])
 }
 
+// SPEC-945 · ADR-0150 · direktori orang untuk papan tim. GLOBAL, bukan per project: Task boleh
+// tanpa project, jadi direktori orang tak bisa digantung pada project — dan orang yang sama lazim
+// melintasi beberapa project.
+//
+// `id` DETERMINISTIK dari email ternormalisasi (lowercase + trim) ditulis aplikasi, bukan default
+// DB — alasan yang sama dengan CustomAgent (ADR-0094): dengan id acak, dua mesin yang sama-sama
+// membuat "Dena" melahirkan dua baris yang keduanya menyeberang changefeed, dan salah satunya
+// lenyap tanpa jejak begitu papan menyaring per-assignee.
+//
+// Konsekuensinya `email` IMMUTABLE, ditegakkan di boundary route: ganti email = hapus + buat baru.
+// `@unique` di sini bukan redundansi terhadap PK — id menyimpan bentuk ternormalisasi, kolom ini
+// menyimpan yang diketik operator.
+model Member {
+  id        String   @id
+  name      String
+  email     String   @unique
+  role      String?  // label bebas: "desainer", "backend" — BUKAN RBAC
+  active    Boolean  @default(true)
+  version   Int      @default(0) // SPEC-213 · version-stamp sync (ADR-0045)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  tasks     Task[]
+}
+
+// SPEC-945 · ADR-0150 · satuan kerja MANUSIA. Bukan Spec: kolomnya milik manusia dan bebas
+// di-drag, sementara `Spec.stage` diturunkan dari fase sesi (ADR-0008/0024).
+//
+// `specId` sengaja TANPA FK (cermin Ticket.specId, ADR-0062): changefeed bisa memancarkan Task
+// sebelum Spec-nya mendarat (kelas SPEC-382) dan FK akan menolaknya.
+//
+// TIDAK ada kolom `stage`: cermin stage backlog dihitung saat baca lewat join specId → Spec.stage.
+// Aturan ADR-0090 bukan "selalu simpan" melainkan bisakah dihitung ulang dari sumber lain; di sini
+// bisa, jadi kolom kedua hanya menciptakan dua kebenaran yang bisa drift.
+//
+// TIDAK ada `doneAt` dan tak ada stempel transisi kolom: Gantt yang dipilih rencana-saja, jadi
+// tanggal aktual belum punya pembaca. Dihilangkan dengan sengaja, bukan terlupa.
+//
+// `order` Float, bukan Int: drop di antara dua kartu menulis titik tengah tetangganya — tak ada
+// reindex seluruh kolom, dan dua mesin yang menulis bersamaan menghasilkan nilai yang tetap
+// terurut. Seri dipecah oleh `id`.
+model Task {
+  id        String    @id @default(cuid())
+  projectId String?   // null = tugas internal tim, tanpa project
+  title     String
+  detail    String?
+  status    String    // backlog | doing | review | done (zTaskStatus)
+  priority  String    @default("sedang") // zPriority — kosakata yang sama dengan Spec
+  memberId  String?   // null = belum ditugaskan
+  startDate DateTime?
+  dueDate   DateTime?
+  order     Float     @default(0)
+  specId    String?   // soft-link Spec hasil eskalasi
+  version   Int       @default(0) // SPEC-213 · version-stamp sync (ADR-0045)
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  project   Project?  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  member    Member?   @relation(fields: [memberId], references: [id], onDelete: SetNull)
+
+  @@index([projectId, status])
+  @@index([memberId])
+}
+
 // SPEC-471 · ADR-0095 · cermin issue GitHub sebagai record lokal, pola Ticket (ADR-0062).
 // `id` DETERMINISTIK "<projectId>:<owner>/<repo>#<number>" ditulis aplikasi, bukan default DB —
 // alasan yang sama dengan CustomAgent (ADR-0094): dua mesin yang menarik repo yang sama harus