hanoman 0.1.5 → 0.1.6

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.5",
-  "sha": "5ae0e2b",
-  "builtAt": "2026-07-31T02:00:54.075Z"
+  "version": "0.1.6",
+  "sha": "0969f50",
+  "builtAt": "2026-07-31T08:27:27.058Z"
 }

package/dist/cli.js

@@ -4359,7 +4359,7 @@ var init_enums = __esm({
 });
 
 // ../shared/src/entities.ts
-var zProject, zBriefPayload, zQaPayload, zGoalPayload, zSpec, NOTIFY_SOUNDS, zCodex, CODEX_DEFAULTS, zSourceCommon, zScheduler, SCHEDULER_DEFAULTS, zGoal, GOAL_DEFAULTS, zConflict, CONFLICT_DEFAULTS, zSetting, zNotification, zDocFile, zDeviceTokenView;
+var zProject, zBriefPayload, zQaPayload, zGoalPayload, zSpec, NOTIFY_SOUNDS, zCodex, CODEX_DEFAULTS, zSourceCommon, zScheduler, SCHEDULER_DEFAULTS, zGoal, GOAL_DEFAULTS, zConflict, CONFLICT_DEFAULTS, zLeadEngine, zLead, LEAD_DEFAULTS, zSetting, zNotification, zDocFile, zDeviceTokenView;
 var init_entities = __esm({
   "../shared/src/entities.ts"() {
     "use strict";
@@ -4417,8 +4417,12 @@ var init_entities = __esm({
       // SPEC-407 · +goal
       branchFrom: external_exports.string().nullable(),
       // SPEC-143 · null = default project (main)
-      baseSha: external_exports.string().nullable()
+      baseSha: external_exports.string().nullable(),
       // SPEC-186 · null = belum pernah ada sesi (belum dimulai)
+      // SPEC-408 · ADR-0090 · stempel waktu backlog (ISO string di wire — kolom DateTime di DB).
+      // `startedAt` null = belum pernah dikerjakan; ia tak pernah ditulis ulang saat sesi dilanjutkan.
+      createdAt: external_exports.string(),
+      startedAt: external_exports.string().nullable()
     });
     NOTIFY_SOUNDS = [
       "off",
@@ -4471,6 +4475,31 @@ var init_entities = __esm({
       effort: external_exports.string().default("xhigh")
     });
     CONFLICT_DEFAULTS = zConflict.parse({});
+    zLeadEngine = external_exports.object({
+      enabled: external_exports.boolean().default(false),
+      agent: zAgent.default("claude"),
+      model: external_exports.string().default("claude-opus-5"),
+      effort: external_exports.string().default("xhigh")
+    });
+    zLead = external_exports.object({
+      enabled: external_exports.boolean().default(false),
+      // master switch (AC-30)
+      paused: external_exports.boolean().default(false),
+      // rem darurat global (AC-27)
+      pausedProjects: external_exports.array(external_exports.string()).default([]),
+      // rem per project (AC-15/US-4)
+      everyMin: external_exports.number().int().min(1).max(1440).default(5),
+      // denyut proaktif (OQ-2)
+      timeoutSec: external_exports.number().int().min(10).max(900).default(120),
+      // batas waktu satu putusan (AC-4/35)
+      // AC-11 / OQ-10 · berapa jawaban otomatis berturut-turut untuk SATU sesi sebelum lead berhenti.
+      maxAutoAnswers: external_exports.number().int().min(1).max(20).default(3),
+      // OQ-3 · syarat objektif sebelum lead boleh mengintegrasikan ke branch utama. Default MENYALA:
+      // risiko "kode masuk main tanpa mata manusia" diterima sadar, tapi syaratnya tetap terukur.
+      requireGreenBeforeIntegrate: external_exports.boolean().default(true),
+      engine: zLeadEngine.default({})
+    });
+    LEAD_DEFAULTS = zLead.parse({});
     zSetting = external_exports.object({
       model: external_exports.string().default("claude-opus-5"),
       effort: external_exports.string().default("xhigh"),
@@ -4497,13 +4526,17 @@ var init_entities = __esm({
       // SPEC-338 · ADR-0074 · model/effort codex
       verifyScope: zVerifyScope.default("changed"),
       // SPEC-376 · ADR-0080 · scope verifikasi sesi
-      conflict: zConflict.default(CONFLICT_DEFAULTS)
+      conflict: zConflict.default(CONFLICT_DEFAULTS),
       // SPEC-383 · ADR-0081 · default sesi konflik rebase/merge
+      lead: zLead.default(LEAD_DEFAULTS)
+      // SPEC-409 · ADR-0091 · hanoman-lead (default mati)
     });
     zNotification = external_exports.object({
       id: external_exports.string(),
-      type: external_exports.enum(["done", "decision", "error", "ticket", "fail"]).default("done"),
       // SPEC-249 · +error; SPEC-253 · +ticket; SPEC-298 · +fail (sesi scheduler gagal/limit)
+      // SPEC-409 · +lead (ADR-0091): keputusan berbobot / ragu / tindakan terkunci ditolak. MEMBERI
+      // TAHU, bukan meminta izin — tak ada pekerjaan yang menunggu notifikasi ini dibaca (AC-25).
+      type: external_exports.enum(["done", "decision", "error", "ticket", "fail", "lead"]).default("done"),
       specId: external_exports.string().nullable(),
       sessionId: external_exports.string().nullable(),
       title: external_exports.string(),
@@ -4553,7 +4586,13 @@ var init_agent = __esm({
       "support:read",
       "support:write",
       "notifications:read",
-      "notifications:write"
+      "notifications:write",
+      // SPEC-409 · ADR-0091 · minta putusan ke hanoman-lead + baca jejak keputusan. Domain TERSENDIRI,
+      // bukan menumpang prefix baca yang sudah ada: meminta putusan adalah operasi TULIS (ia melahirkan
+      // baris jejak & bisa menggerakkan sesi), dan SPEC-405 sudah membuktikan apa yang terjadi saat
+      // endpoint tulis menumpang prefix status yang dipetakan tanpa melihat method (AC-5).
+      "lead:read",
+      "lead:write"
     ];
     zCapability = external_exports.enum(CAPABILITY_IDS);
     zCapabilityInfo = external_exports.object({
@@ -4587,13 +4626,77 @@ var init_agent = __esm({
   }
 });
 
+// ../shared/src/lead.ts
+var zLeadGate, zLeadKind, zLeadConfidence, zLeadStatus, LEAD_ACTIONS, zLeadAction, zLeadVerdict, zLeadAsk, zLeadOverride;
+var init_lead = __esm({
+  "../shared/src/lead.ts"() {
+    "use strict";
+    init_zod();
+    zLeadGate = external_exports.enum(["contract", "detected", "pulse"]);
+    zLeadKind = external_exports.enum(["answer", "order", "collision", "quality", "refusal"]);
+    zLeadConfidence = external_exports.enum(["tinggi", "sedang", "ragu"]);
+    zLeadStatus = external_exports.enum(["berlaku", "ditimpa", "dibatalkan", "gagal"]);
+    LEAD_ACTIONS = [
+      "none",
+      // keputusan murni jawaban; tak ada tindakan menyusul
+      "answer-session",
+      // ketik jawaban ke pane sesi (pintu deteksi otomatis)
+      "start-session",
+      // mulai sesi untuk sebuah backlog (lewat antrean scheduler)
+      "stop-session",
+      // hentikan sesi — worktree DIBIARKAN utuh (AC-32a)
+      "resume-session",
+      // lanjutkan sesi terputus (jalur ADR-0084)
+      "restart-session",
+      // ulangi pekerjaan dari awal
+      "order-queue",
+      // tata urutan antrean yang sudah ada (ADR-0072) — bukan antrean kedua
+      "hold-work",
+      // tunda satu pekerjaan karena tabrakan area kerja
+      "push-branch",
+      // dorong perubahan ke branch
+      "integrate-main",
+      // integrasikan ke branch utama (risiko yang diterima sadar, PRD §Risiko)
+      "run-migration"
+      // jalankan migration pada basis data LOKAL operator
+    ];
+    zLeadAction = external_exports.enum(LEAD_ACTIONS);
+    zLeadVerdict = external_exports.object({
+      decision: external_exports.string().min(1),
+      reason: external_exports.string().min(1),
+      refs: external_exports.array(external_exports.string()).default([]),
+      confidence: zLeadConfidence.default("sedang"),
+      // Sengaja `string`, BUKAN `zLeadAction`: tindakan di luar allowlist harus bisa MASUK supaya
+      // server menolaknya secara sadar — mencatat penolakan & menotifikasi operator (AC-33). Kalau
+      // enum yang menyaring di sini, permintaan "deploy ke produksi" hanya akan tampak sebagai
+      // keluaran rusak, dan justru peristiwa paling layak dilaporkan itulah yang hilang dari jejak.
+      action: external_exports.string().default("none"),
+      /** Teks yang benar-benar diketik ke pane sesi (pintu deteksi otomatis). */
+      reply: external_exports.string().default("")
+    });
+    zLeadAsk = external_exports.object({
+      projectId: external_exports.string().min(1),
+      specId: external_exports.string().nullish(),
+      sessionId: external_exports.string().nullish(),
+      question: external_exports.string().min(1).max(8e3),
+      options: external_exports.array(external_exports.string().max(2e3)).max(20).default([]),
+      context: external_exports.string().max(2e4).default("")
+    });
+    zLeadOverride = external_exports.object({
+      answer: external_exports.string().min(1).max(8e3),
+      reason: external_exports.string().max(8e3).default("")
+    });
+  }
+});
+
 // ../shared/src/dto.ts
-var zIssueDeviceToken, zSessionResult, zSessionHistory, zCreateProject, zProjectId, zRenameProject, zCreateLink, zUpdateProject, zCreateSpec, zPatchSpec, zIntegrate, zSessionSummary, zProjectView, zSchedulerQueueItem, zSchedulerSourceView, zSchedulerSessionView, zSchedulerState, zFlow, zPrdBrief, zPrdDoc, zBreakdownItem, zBreakdownDoc, zBatchCreateSpec, zEscalationTarget, zEscalationPrefill, zAuditEscalation, zAuditEscalationView, zTerminalSession, zDocFileContent, zDocIndexCat, zDocIndex, HOST_RE, USER_RE, zCreateVps, zPatchVps, zLogin, zSignup, zChangePassword, zVpsCheck, zMarkNa, zMarkNaBulk, zAttest, zRemediate, UPDATE_RESTART_EXIT, zUpdateApplyBody, zStackFrame, zSymbolicatedFrame, zSourceMapUpload, zIngestPayload, zErrorGroupView, zErrorEventView, zErrorGroupDetail, zIngestKeyView, zTicketView, zTicketAttachmentView, zTicketDetail, zTicketEditInput, zHelpInfo, zPublicTicketStatus;
+var zIssueDeviceToken, zSessionResult, zSessionHistory, zCreateProject, zProjectId, zRenameProject, zCreateLink, zUpdateProject, zCreateSpec, zPatchSpec, zIntegrate, zSessionSummary, zProjectView, zSchedulerQueueItem, zSchedulerSourceView, zSchedulerSessionView, zSchedulerState, zLeadDecisionView, zLeadAnswer, zLeadProjectStatus, zLeadStatusView, zFlow, zPrdBrief, zPrdDoc, zBreakdownItem, zBreakdownDoc, zBatchCreateSpec, zEscalationTarget, zEscalationPrefill, zAuditEscalation, zAuditEscalationView, zTerminalSession, zDocFileContent, zDocIndexCat, zDocIndex, HOST_RE, USER_RE, zCreateVps, zPatchVps, zLogin, zSignup, zChangePassword, zVpsCheck, zMarkNa, zMarkNaBulk, zAttest, zRemediate, UPDATE_RESTART_EXIT, zUpdateApplyBody, zStackFrame, zSymbolicatedFrame, zSourceMapUpload, zIngestPayload, zErrorGroupView, zErrorEventView, zErrorGroupDetail, zIngestKeyView, zTicketView, zTicketAttachmentView, zTicketDetail, zTicketEditInput, zHelpInfo, zPublicTicketStatus;
 var init_dto = __esm({
   "../shared/src/dto.ts"() {
     "use strict";
     init_zod();
     init_entities();
+    init_lead();
     init_enums();
     zIssueDeviceToken = external_exports.object({ name: external_exports.string().min(1) });
     zSessionResult = external_exports.object({
@@ -4649,8 +4752,10 @@ var init_dto = __esm({
       // SPEC-213 · set git remote resmi project
       repoDir: external_exports.string().nullable().optional(),
       // SPEC-217 · path default/server editable (null = kosongkan)
-      schedulerOptIn: external_exports.boolean().optional()
+      schedulerOptIn: external_exports.boolean().optional(),
       // SPEC-294 · opt-in scheduler otonom (lokal, tak disync)
+      leadOptIn: external_exports.boolean().optional()
+      // SPEC-409 · ADR-0091 · opt-in hanoman-lead (lokal, tak disync)
     });
     zCreateSpec = external_exports.object({
       project: external_exports.string(),
@@ -4698,7 +4803,9 @@ var init_dto = __esm({
       // SPEC-249 · hint prefix DSN (bukan hash/rahasia)
       helpEnabled: external_exports.boolean().default(false),
       // SPEC-253 · Help Center publik aktif
-      schedulerOptIn: external_exports.boolean().default(false)
+      schedulerOptIn: external_exports.boolean().default(false),
+      // SPEC-294 · opt-in scheduler otonom
+      leadOptIn: external_exports.boolean().default(false)
     });
     zSchedulerQueueItem = external_exports.object({
       id: external_exports.string(),
@@ -4738,6 +4845,50 @@ var init_dto = __esm({
       queue: external_exports.array(zSchedulerQueueItem),
       sessions: external_exports.array(zSchedulerSessionView)
     });
+    zLeadDecisionView = external_exports.object({
+      id: external_exports.string(),
+      projectId: external_exports.string(),
+      specId: external_exports.string().nullable(),
+      sessionId: external_exports.string().nullable(),
+      gate: zLeadGate,
+      kind: zLeadKind,
+      question: external_exports.string(),
+      answer: external_exports.string(),
+      reason: external_exports.string(),
+      refs: external_exports.array(external_exports.string()),
+      confidence: zLeadConfidence,
+      action: zLeadAction,
+      status: zLeadStatus,
+      weighty: external_exports.boolean(),
+      supersededById: external_exports.string().nullable(),
+      createdAt: external_exports.string()
+    });
+    zLeadAnswer = external_exports.object({
+      id: external_exports.string(),
+      decision: external_exports.string(),
+      reason: external_exports.string(),
+      refs: external_exports.array(external_exports.string()),
+      confidence: zLeadConfidence,
+      action: zLeadAction
+    });
+    zLeadProjectStatus = external_exports.object({
+      projectId: external_exports.string(),
+      name: external_exports.string(),
+      optIn: external_exports.boolean(),
+      paused: external_exports.boolean(),
+      decisions24h: external_exports.number(),
+      openSessions: external_exports.number()
+    });
+    zLeadStatusView = external_exports.object({
+      config: zLead,
+      projects: external_exports.array(zLeadProjectStatus),
+      queue: external_exports.array(zSchedulerQueueItem),
+      deciding: external_exports.array(external_exports.string()),
+      // id sesi yang sedang disusun keputusannya (AC-3)
+      waiting: external_exports.array(external_exports.string()),
+      // id sesi ber-marker keputusan terisi
+      lastPulseAt: external_exports.string().nullable()
+    });
     zFlow = external_exports.enum(["feature", "qa", "scaffold", "reverse", "prd", "audit", "breakdown", "cross-audit", "goal"]);
     zPrdBrief = external_exports.object({
       title: external_exports.string().min(1),
@@ -5128,6 +5279,12 @@ var init_api = __esm({
       // SPEC-299 · panel scheduler (daun #6) — konsumen read-only fondasi SPEC-294/ADR-0072.
       schedulerConfig: `${API}/scheduler/config`,
       schedulerState: `${API}/scheduler/state`,
+      // SPEC-409 · ADR-0091 · hanoman-lead. Semua HTTP (polling) — tak ada kanal WS baru (AC-26).
+      leadConfig: `${API}/lead/config`,
+      leadStatus: `${API}/lead/status`,
+      leadDecisions: `${API}/lead/decisions`,
+      leadDecisionOverride: (id) => `${API}/lead/decisions/${encodeURIComponent(id)}/override`,
+      leadDecisionCancel: (id) => `${API}/lead/decisions/${encodeURIComponent(id)}/cancel`,
       // SPEC-268 · ADR-0066 · pemicu sync manual (cookie-authed)
       syncNow: `${API}/sync/now`,
       // SPEC-270 · ADR-0067 · antrean konflik rekonsil (cookie-authed)
@@ -5416,6 +5573,7 @@ var init_src2 = __esm({
     init_enums();
     init_entities();
     init_agent();
+    init_lead();
     init_dto();
     init_api();
     init_coverage();
@@ -6067,6 +6225,7 @@ var init_migrate_pg = __esm({
       "SyncConflict",
       "SchedulerQueueItem",
       "RuntimeConfig",
+      "LeadDecision",
       "ErrorGroup",
       "ErrorEvent",
       "SourceMapArtifact",