hanoman 0.2.3 → 0.2.4

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.3",
-  "sha": "7f99c250",
-  "builtAt": "2026-08-29T10:43:44.678Z"
+  "version": "0.2.4",
+  "sha": "5675d4f5",
+  "builtAt": "2026-08-31T14:43:04.080Z"
 }

package/dist/cli.js

@@ -4413,6 +4413,15 @@ var init_auto_merge = __esm({
 });
 
 // ../shared/src/entities.ts
+function cmpVersion(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (d !== 0) return d;
+  }
+  return 0;
+}
 var zProject, zBriefPayload, zQaPayload, zGoalPayload, zSpecBlocker, zSourceChange, zManualDone, zSpec, NOTIFY_SOUNDS, zCodex, CODEX_DEFAULTS, zSourceCommon, zScheduler, SCHEDULER_DEFAULTS, zGoal, GOAL_DEFAULTS, zConflict, CONFLICT_DEFAULTS, CHANGELOG_ENGINE_DEFAULTS, zLeadEngine, zLead, LEAD_DEFAULTS, zPortalChat, PORTAL_CHAT_DEFAULTS, zSetting, zNotification, zDocFile, zDeviceTokenView;
 var init_entities = __esm({
   "../shared/src/entities.ts"() {
@@ -4666,7 +4675,10 @@ var init_entities = __esm({
       //
       // LOKAL per mesin: `setting` TIDAK ada di FIELDS sync (server/src/services/sync.ts), jadi dua
       // mesin dengan versi hanoman berbeda tak bisa saling menimpa definisi bolak-balik.
-      builtinAgents: external_exports.record(external_exports.string(), external_exports.string()).default({})
+      builtinAgents: external_exports.record(external_exports.string(), external_exports.string()).default({}),
+      // SPEC-950 · marker safety policy lokal. Terpisah dari fingerprint konten agar policy sekali
+      // jalan tidak membuat seed memperlakukan konfigurasi operator sebagai bawaan.
+      builtinAgentPolicies: external_exports.record(external_exports.string(), external_exports.string()).default({})
     });
     zNotification = external_exports.object({
       id: external_exports.string(),
@@ -4789,13 +4801,28 @@ var init_agent = __esm({
 });
 
 // ../shared/src/custom-agent.ts
-var AGENT_RUNTIMES, zAgentRuntime, AGENT_NAME_RE, DEFAULT_AGENT_TOOLS, zCustomAgent, zCreateCustomAgent, zUpdateCustomAgent;
+function validateCreateWorkspacePolicy(value, ctx) {
+  if (value.workspacePolicy === "isolated-worktree" && value.runtime !== "claude") {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["workspacePolicy"],
+      message: "isolated-worktree hanya tersedia untuk Claude Code"
+    });
+  }
+}
+var AGENT_RUNTIMES, zAgentRuntime, AGENT_ACTIVATIONS, zAgentActivation, AGENT_EFFORTS, zAgentEffort, AGENT_WORKSPACE_POLICIES, zAgentWorkspacePolicy, AGENT_NAME_RE, DEFAULT_AGENT_TOOLS, zCustomAgent, zCreateCustomAgentFields, zCreateCustomAgent, zUpdateCustomAgent;
 var init_custom_agent = __esm({
   "../shared/src/custom-agent.ts"() {
     "use strict";
     init_zod();
     AGENT_RUNTIMES = ["claude", "codex"];
     zAgentRuntime = external_exports.enum(AGENT_RUNTIMES);
+    AGENT_ACTIVATIONS = ["always", "smart"];
+    zAgentActivation = external_exports.enum(AGENT_ACTIVATIONS);
+    AGENT_EFFORTS = ["ultra", "max", "xhigh", "high", "medium", "low", "ultracode"];
+    zAgentEffort = external_exports.enum(AGENT_EFFORTS);
+    AGENT_WORKSPACE_POLICIES = ["inherit", "read-only", "isolated-worktree"];
+    zAgentWorkspacePolicy = external_exports.enum(AGENT_WORKSPACE_POLICIES);
     AGENT_NAME_RE = /^[a-z][a-z0-9-]{1,39}$/;
     DEFAULT_AGENT_TOOLS = [
       "Read",
@@ -4817,11 +4844,16 @@ var init_custom_agent = __esm({
       model: external_exports.string().nullable(),
       mentions: external_exports.array(external_exports.string()).nullable(),
       runtime: external_exports.enum(AGENT_RUNTIMES).nullable(),
+      activation: zAgentActivation.default("always"),
+      effort: zAgentEffort.nullable().default(null),
+      workspacePolicy: zAgentWorkspacePolicy.default("inherit"),
+      maxTurns: external_exports.number().int().min(1).max(200).nullable().default(null),
+      timeoutSeconds: external_exports.number().int().min(30).max(3600).nullable().default(null),
       enabled: external_exports.boolean(),
       createdAt: external_exports.string(),
       updatedAt: external_exports.string()
     });
-    zCreateCustomAgent = external_exports.object({
+    zCreateCustomAgentFields = external_exports.object({
       projectId: external_exports.string().nullable().optional(),
       name: external_exports.string().regex(AGENT_NAME_RE),
       description: external_exports.string().trim().min(1).max(500),
@@ -4831,9 +4863,23 @@ var init_custom_agent = __esm({
       mentions: external_exports.array(external_exports.string()).nullable().optional(),
       // SPEC-484 · ADR-0101 · PENYARING mesin sesi, bukan pemilih proses. null/absen = ikut sesi induk.
       runtime: external_exports.enum(AGENT_RUNTIMES).nullable().optional(),
+      activation: zAgentActivation.optional(),
+      effort: zAgentEffort.nullable().optional(),
+      workspacePolicy: zAgentWorkspacePolicy.optional(),
+      maxTurns: external_exports.number().int().min(1).max(200).nullable().optional(),
+      timeoutSeconds: external_exports.number().int().min(30).max(3600).nullable().optional(),
       enabled: external_exports.boolean().optional()
     });
-    zUpdateCustomAgent = zCreateCustomAgent.omit({ name: true, projectId: true }).partial();
+    zCreateCustomAgent = zCreateCustomAgentFields.superRefine(validateCreateWorkspacePolicy);
+    zUpdateCustomAgent = zCreateCustomAgentFields.omit({ name: true, projectId: true }).partial().superRefine((value, ctx) => {
+      if (value.workspacePolicy === "isolated-worktree" && value.runtime !== void 0 && value.runtime !== "claude") {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          path: ["workspacePolicy"],
+          message: "isolated-worktree hanya tersedia untuk Claude Code"
+        });
+      }
+    });
   }
 });
 
@@ -4848,6 +4894,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan saat perlu tahu DI MANA sesuatu dikerjakan di basis kode, atau bagaimana sebuah alur data mengalir, sebelum menyentuh kode. Ia menyapu banyak berkas dan mengembalikan peta ringkas berisi jangkar path:baris \u2014 bukan isi berkas. Panggil dia alih-alih membaca belasan berkas sendiri.",
         tools: ["Read", "Glob", "Grep"],
         enabledByDefault: true,
+        activation: "smart",
+        effort: "low",
+        workspacePolicy: "read-only",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "haiku", codex: "gpt-5.6-terra" },
         instructions: [
           "Kamu navigator basis kode. Tugasmu MENJAWAB, bukan menyalin.",
           "",
@@ -4874,6 +4926,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan saat ada bug, test merah, atau perilaku tak terduga yang belum jelas sebabnya. Ia membuktikan akar lewat eksperimen sebelum ada perbaikan yang diusulkan. Jangan panggil dia untuk memperbaiki \u2014 dia mendiagnosis.",
         tools: ["Read", "Glob", "Grep", "Bash"],
         enabledByDefault: false,
+        activation: "smart",
+        effort: "high",
+        workspacePolicy: "read-only",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "sonnet", codex: "gpt-5.6" },
         instructions: [
           "Kamu diagnostikus. Kamu TIDAK memperbaiki kode \u2014 kamu membuktikan sebabnya.",
           "",
@@ -4903,7 +4961,13 @@ var init_builtin_agents = __esm({
         name: "qa-verifier",
         description: "Gunakan SEBELUM menyatakan pekerjaan selesai atau test hijau. Ia menjalankan test yang tersentuh perubahan, memisahkan gagal palsu dari regresi, dan membuktikan bahwa test yang lulus itu benar-benar menguji perubahannya.",
         tools: ["Read", "Glob", "Grep", "Bash"],
-        enabledByDefault: true,
+        enabledByDefault: false,
+        activation: "smart",
+        effort: "medium",
+        workspacePolicy: "isolated-worktree",
+        maxTurns: 40,
+        timeoutSeconds: 900,
+        models: { claude: "sonnet", codex: "gpt-5.6-terra" },
         instructions: [
           "Kamu gerbang terakhir sebelum sesuatu diumumkan hijau. Tugasmu MERAGUKAN kehijauan itu.",
           "",
@@ -4915,18 +4979,18 @@ var init_builtin_agents = __esm({
           "   paralelisme antar-berkas test, sisa proses/soket/port dari run sebelumnya, variabel",
           "   lingkungan yang bocor dari shell, dan test yang memang sudah merah SEBELUM perubahan.",
           "   Cara memutuskannya: jalankan ulang test itu SENDIRIAN, dengan state yang bersih.",
-          "4. UJI RELEVANSI \u2014 langkah yang hampir tak pernah dilakukan siapa pun, dan tanpa ini 'hijau'",
-          "   tak berarti apa-apa: siapkan pohon kerja terpisah di commit SEBELUM perubahan",
-          "   (`git worktree add --detach <dir> <base-sha>`), pasang test barunya di sana, jalankan,",
-          "   dan tuntut test itu MERAH. Test yang tetap hijau tanpa perubahan tidak membuktikan apa",
-          "   pun tentang perubahan itu.",
-          "5. Bersihkan pohon kerja sementara (`git worktree remove`).",
+          "4. UJI RELEVANSI hanya di worktree sementara dari `baseSha`, tidak pernah di worktree",
+          "   parent: buat worktree terpisah, pasang patch test di sana, jalankan, dan tuntut test",
+          "   itu MERAH. Bila `baseSha` atau patch test tidak tersedia, laporkan `belum terbukti`;",
+          "   jangan mencoba eksperimen kontrol di source parent.",
+          "5. Bersihkan worktree sementara milikmu. Laporkan secara eksplisit bila cleanup gagal.",
           "",
           "Larangan keras:",
           "- JANGAN `git stash` untuk apa pun. Tumpukan stash milik REPO, bukan pohon kerja \u2014 sesi lain",
           "  bisa mem-pop stash milikmu, dan kamu bisa mem-pop milik mereka. Isolasi memakai",
           "  `git worktree add`, titik.",
           "- JANGAN mengubah test agar lulus. Bila test-nya yang salah, itu temuan, bukan pekerjaan.",
+          "- JANGAN mengubah satu byte pun di worktree parent, termasuk berkas probe sementara.",
           "",
           "Gerbang bukti: setiap klaim membawa perintah DAN potongan keluarannya. Tanpa keluaran, tanpa",
           "klaim. 'Semua test lulus' tanpa keluaran adalah kegagalanmu, bukan laporan.",
@@ -4941,6 +5005,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan saat test yang ada hanya menguji jalur mulus dan kamu ingin batas-batas kontrak benar-benar tertutup. Ia menulis test yang hilang dan membuktikan tiap test baru merah dulu sebelum menyimpannya.",
         tools: ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
         enabledByDefault: false,
+        activation: "smart",
+        effort: "high",
+        workspacePolicy: "isolated-worktree",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "sonnet", codex: "gpt-5.6" },
         instructions: [
           "Kamu penambal jalur bahagia. Cakupan yang terlihat baik bukan urusanmu \u2014 kontrak yang tak",
           "pernah diuji itu urusanmu.",
@@ -4973,6 +5043,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan sesudah perubahan selesai untuk menemukan tempat LAIN yang seharusnya ikut berubah tapi tidak: daftar kolom, cermin tipe antar-paket, enum kembar, dokumen kontrak, tabel konstanta. Ia mencari kegagalan senyap \u2014 yang tak memunculkan satu pun error.",
         tools: ["Read", "Glob", "Grep", "Bash"],
         enabledByDefault: true,
+        activation: "smart",
+        effort: "medium",
+        workspacePolicy: "read-only",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "sonnet", codex: "gpt-5.6-terra" },
         instructions: [
           "Kamu pencari cermin yang hanyut. Kelas bug yang kamu buru punya satu ciri: TIDAK ADA yang",
           "error. Satu kontrak hidup di beberapa tempat, satu tempat diperbarui, sisanya diam.",
@@ -5005,6 +5081,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan sebelum menutup pekerjaan untuk mengadu apa yang DIMINTA dengan apa yang benar-benar ada di diff. Ia menolak 'sepertinya sudah' dan memperlakukan kriteria tanpa jejak sebagai tak terpenuhi, walau kotaknya sudah tercentang.",
         tools: ["Read", "Glob", "Grep", "Bash"],
         enabledByDefault: false,
+        activation: "smart",
+        effort: "high",
+        workspacePolicy: "read-only",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "sonnet", codex: "gpt-5.6-terra" },
         instructions: [
           "Kamu pengadu janji. Kamu tak menilai bagus atau tidaknya kode \u2014 kamu menilai apakah yang",
           "diminta benar-benar ada.",
@@ -5033,6 +5115,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan sebelum menggabungkan perubahan yang menyentuh route, handler, job, CLI, atau apa pun yang menerima input dari luar. Ia menelusuri jalur konkret dari input tak terpercaya sampai ke tempat ia melukai, dan menolak melaporkan kekhawatiran yang tak bisa ia buktikan jalurnya.",
         tools: ["Read", "Glob", "Grep", "Bash"],
         enabledByDefault: true,
+        activation: "smart",
+        effort: "high",
+        workspacePolicy: "read-only",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "sonnet", codex: "gpt-5.6" },
         instructions: [
           "Kamu penelusur sumber-ke-sink. Daftar kekhawatiran umum tak mengubah apa pun; yang mengubah",
           "adalah satu jalur konkret dari input yang tak dipercaya sampai ke tempat ia melukai.",
@@ -5067,6 +5155,12 @@ var init_builtin_agents = __esm({
         description: "Gunakan saat diff menambah atau menaikkan versi dependensi. Ia memeriksa advisory, lisensi, tanda pemeliharaan, dan \u2014 yang paling sering terlewat \u2014 apakah fungsinya sudah tersedia tanpa dependensi baru itu.",
         tools: ["Read", "Glob", "Grep", "Bash", "WebSearch", "WebFetch"],
         enabledByDefault: false,
+        activation: "smart",
+        effort: "medium",
+        workspacePolicy: "read-only",
+        maxTurns: null,
+        timeoutSeconds: null,
+        models: { claude: "haiku", codex: "gpt-5.6-terra" },
         instructions: [
           "Kamu gerbang rantai pasok. Satu dependensi masuk lewat satu baris diff dan tak pernah",
           "diperiksa lagi seumur hidup proyek \u2014 pemeriksaan itu terjadi sekarang atau tidak sama sekali.",
@@ -6217,6 +6311,8 @@ var init_api = __esm({
       leadFlowCancel: (id) => `${API}/lead/flows/${encodeURIComponent(id)}/cancel`,
       // SPEC-450 · ADR-0094 · katalog custom agent. `?projectId=` → himpunan EFEKTIF (global+project).
       customAgents: `${API}/custom-agents`,
+      customAgentMetrics: `${API}/custom-agents/metrics`,
+      customAgentInvocation: (id) => `${API}/custom-agents/invocations/${encodeURIComponent(id)}`,
       // SPEC-484 · ADR-0101 · sumber daftar tools/model/runtime untuk form (mention dari `customAgents`).
       customAgentCatalog: `${API}/custom-agents/catalog`,
       // SPEC-481 · ADR-0100 · webhook keluar (cookie-only)
@@ -11142,17 +11238,27 @@ var init_git = __esm({
 });
 
 // ../runner/src/settings.ts
-var EVENT_HOOK_COMMAND;
+var EVENT_SPOOL_SCRIPT, EVENT_HOOK_COMMAND;
 var init_settings2 = __esm({
   "../runner/src/settings.ts"() {
     "use strict";
+    EVENT_SPOOL_SCRIPT = [
+      'const fs=require("node:fs"),p=require("node:path"),c=require("node:crypto")',
+      'let d=""',
+      'process.stdin.setEncoding("utf8")',
+      'process.stdin.on("data",x=>d+=x)',
+      'process.stdin.on("end",()=>{let t="";try{const n=Date.now()+"-"+process.pid+"-"+c.randomUUID();t=p.join(process.env.HANOMAN_EVENT_DIR,n+".tmp");const f=p.join(process.env.HANOMAN_EVENT_DIR,n+".json");fs.writeFileSync(t,d,{flag:"wx",mode:0o600});fs.renameSync(t,f)}catch{if(t)try{fs.rmSync(t,{force:true})}catch{}}})'
+    ].join(";");
     EVENT_HOOK_COMMAND = [
+      'if [ -n "${HANOMAN_EVENT_DIR:-}" ]; then',
+      `node -e '${EVENT_SPOOL_SCRIPT}' >/dev/null 2>&1;`,
+      "else",
       'curl -sS -m 2 -X POST "$HANOMAN_EVENT_URL"',
       "-H 'content-type: application/json'",
       '-H "authorization: Bearer $HANOMAN_EVENT_TOKEN"',
       '-H "x-hanoman-session: $HANOMAN_SESSION_ID"',
       '${HANOMAN_EVENT_HOST:+-H "host: $HANOMAN_EVENT_HOST"}',
-      "--data-binary @- >/dev/null 2>&1; exit 0"
+      "--data-binary @- >/dev/null 2>&1; fi; exit 0"
     ].join(" ");
   }
 });
@@ -11195,6 +11301,75 @@ var init_custom_agents = __esm({
   }
 });
 
+// ../runner/src/agent-readonly.ts
+var init_agent_readonly = __esm({
+  "../runner/src/agent-readonly.ts"() {
+    "use strict";
+  }
+});
+
+// ../runner/src/runtime-profile.ts
+function resolveHardening(env) {
+  if (env.HANOMAN_HARDENING === "1") return true;
+  return env.HANOMAN_SESSION_SANDBOX === "podman" || filled(env.HANOMAN_PUBLIC_ORIGINS) || filled(env.HANOMAN_TRUST_PROXY);
+}
+var filled;
+var init_runtime_profile = __esm({
+  "../runner/src/runtime-profile.ts"() {
+    "use strict";
+    filled = (v) => !!v && v.trim() !== "";
+  }
+});
+
+// ../runner/src/codex-agent-config.ts
+function codexNativeAgentsSupported(version3) {
+  const parsed = version3 ? /(\d+)\.(\d+)\.(\d+)/.exec(version3)?.[0] : null;
+  return parsed ? cmpVersion(parsed, CODEX_NATIVE_AGENTS_MIN_CLIENT) >= 0 : false;
+}
+function codexNativeVersionProbe(env, codexBin = env.HANOMAN_CODEX_BIN ?? "codex") {
+  const sandbox = env.HANOMAN_SESSION_SANDBOX ?? (resolveHardening(env) ? "required" : "off");
+  if (sandbox !== "podman") return { bin: codexBin, args: ["--version"] };
+  return {
+    bin: env.HANOMAN_PODMAN_BIN ?? "podman",
+    args: [
+      "run",
+      "--rm",
+      "--read-only",
+      "--cap-drop=ALL",
+      "--userns=keep-id",
+      "--network",
+      "none",
+      env.HANOMAN_SESSION_IMAGE ?? "hanoman-agent:latest",
+      "/bin/sh",
+      "-lc",
+      `${shellQuote(codexBin)} --version`
+    ]
+  };
+}
+var CODEX_NATIVE_AGENTS_MIN_CLIENT, shellQuote;
+var init_codex_agent_config = __esm({
+  "../runner/src/codex-agent-config.ts"() {
+    "use strict";
+    init_src();
+    init_custom_agents();
+    init_runtime_profile();
+    CODEX_NATIVE_AGENTS_MIN_CLIENT = "0.151.0";
+    shellQuote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+  }
+});
+
+// ../runner/src/custom-agent-eval.ts
+var init_custom_agent_eval = __esm({
+  "../runner/src/custom-agent-eval.ts"() {
+    "use strict";
+    init_src();
+    init_codex_agent_config();
+    init_codex_settings();
+    init_custom_agents();
+    init_settings2();
+  }
+});
+
 // ../runner/src/paths.ts
 import { homedir } from "node:os";
 import { dirname, isAbsolute, join, resolve } from "node:path";
@@ -11529,19 +11704,6 @@ var init_config_env = __esm({
   }
 });
 
-// ../runner/src/runtime-profile.ts
-function resolveHardening(env) {
-  if (env.HANOMAN_HARDENING === "1") return true;
-  return env.HANOMAN_SESSION_SANDBOX === "podman" || filled(env.HANOMAN_PUBLIC_ORIGINS) || filled(env.HANOMAN_TRUST_PROXY);
-}
-var filled;
-var init_runtime_profile = __esm({
-  "../runner/src/runtime-profile.ts"() {
-    "use strict";
-    filled = (v) => !!v && v.trim() !== "";
-  }
-});
-
 // ../runner/src/sandbox-probe.ts
 import { execFileSync } from "node:child_process";
 import { accessSync, constants } from "node:fs";
@@ -11654,6 +11816,9 @@ var init_src2 = __esm({
     init_codex_settings();
     init_agent_cli();
     init_custom_agents();
+    init_agent_readonly();
+    init_codex_agent_config();
+    init_custom_agent_eval();
     init_verify_scope();
     init_code_style();
     init_paths();
@@ -12039,7 +12204,8 @@ var init_start = __esm({
 var doctor_exports = {};
 __export(doctor_exports, {
   default: () => doctor,
-  doctorReport: () => doctorReport
+  doctorReport: () => doctorReport,
+  resolveDoctorCodexBin: () => resolveDoctorCodexBin
 });
 import { execFileSync as execFileSync4 } from "node:child_process";
 import { accessSync as accessSync2, constants as constants2, existsSync as existsSync4 } from "node:fs";
@@ -12051,19 +12217,22 @@ function doctorReport(p3) {
     { mark: p3.git ? "\u2713" : "\u2717", text: p3.git ?? "git \u2014 TAK ADA (wajib: worktree per sesi)", fatal: !p3.git },
     { mark: p3.tmux ? "\u2713" : "\u2717", text: p3.tmux ?? "tmux \u2014 TAK ADA (wajib: sesi agen hidup di tmux)", fatal: !p3.tmux },
     { mark: p3.claude ? "\u2713" : "\xB7", text: p3.claude ? `claude ${p3.claude}` : "claude \u2014 tak ada", fatal: false },
-    { mark: p3.codex ? "\u2713" : "\xB7", text: p3.codex ? `codex ${p3.codex}` : "codex \u2014 tak ada", fatal: false },
+    {
+      mark: p3.codex ? codexNativeAgentsSupported(p3.codex) ? "\u2713" : "!" : "\xB7",
+      text: p3.codex ? `codex ${p3.codex} \u2014 custom agent native ${codexNativeAgentsSupported(p3.codex) ? "siap" : `butuh >= ${CODEX_NATIVE_AGENTS_MIN_CLIENT}; sesi parent tetap bisa berjalan`}` : "codex \u2014 tak ada",
+      fatal: false
+    },
     // SPEC-471 · ADR-0095 · `gh` opsional: tanpa dia tarik issue jatuh ke HTTPS + GITHUB_TOKEN.
     {
       mark: p3.gh ? "\u2713" : "\xB7",
       text: p3.gh ? `gh ${p3.gh}` : "gh \u2014 tak ada (tarik issue akan lewat HTTP + GITHUB_TOKEN)",
       fatal: false
     },
-    // SPEC-909 · ADR-0146 · NON-FATAL dan itu disengaja: tanpa `curl` hook tetap `exit 0` — ia tak
-    // pernah memblokir agen — tapi hanoman-lead tak akan menerima SATU PUN pertanyaan sesi, dan tak
-    // ada error di mana pun yang akan mengatakannya. Kegagalan senyap justru yang layak dilaporkan.
+    // SPEC-950 · jalur normal memakai spool file bahkan di sandbox. curl hanya fallback untuk hook
+    // lama/tanpa HANOMAN_EVENT_DIR, jadi absennya tidak lagi berarti telemetry utama mati.
     {
       mark: p3.curl ? "\u2713" : "!",
-      text: p3.curl ? `curl ${p3.curl}` : "curl \u2014 TAK ADA: hanoman-lead tak akan menerima pertanyaan sesi (SPEC-909)",
+      text: p3.curl ? `curl ${p3.curl}` : "curl \u2014 tak ada (fallback event tanpa spool tidak tersedia)",
       fatal: false
     },
     // Direktori turunan lahir saat dipakai, jadi izin tulis yang belum ada di situ adalah
@@ -12117,12 +12286,22 @@ function version(bin, args) {
     return null;
   }
 }
+async function resolveDoctorCodexBin(env, dbUrl, read = readRuntimeConfig) {
+  try {
+    const configured = (await read(dbUrl, "HANOMAN_CODEX_BIN"))?.trim();
+    if (configured) return configured;
+  } catch {
+  }
+  return env.HANOMAN_CODEX_BIN?.trim() || "codex";
+}
 async function doctor(_argv, ctx) {
   let layout;
   let db;
+  let dbUrl;
   try {
     layout = resolveLayout(distDir(), existsSync4);
-    db = dbFilePath(resolveDbUrl(ctx.env, dirname5(layout.schema)));
+    dbUrl = resolveDbUrl(ctx.env, dirname5(layout.schema));
+    db = dbFilePath(dbUrl);
   } catch (e) {
     ctx.stderr(`${e.message}
 `);
@@ -12136,7 +12315,8 @@ async function doctor(_argv, ctx) {
     { label: "key SSH", path: d.sshKeys, writable: writable(d.sshKeys), fatal: false }
   ];
   const claude = version(ctx.env.HANOMAN_CLAUDE_BIN ?? "claude", ["--version"]);
-  const codex = version(ctx.env.HANOMAN_CODEX_BIN ?? "codex", ["--version"]);
+  const codexProbe = codexNativeVersionProbe(ctx.env, await resolveDoctorCodexBin(ctx.env, dbUrl));
+  const codex = version(codexProbe.bin, codexProbe.args);
   const method = METHODS[DEFAULT_METHOD];
   const methods = zAgent.options.filter((a) => (a === "codex" ? codex : claude) !== null).map((a) => {
     const s2 = scanAgentSkills(a, ctx.env);
@@ -12172,6 +12352,7 @@ ${notice}
   if (!r.ok) ctx.stderr("\nada prasyarat yang belum terpenuhi \u2014 hanoman tak akan bisa menjalankan sesi\n");
   return r.ok ? 0 : 1;
 }
+var readRuntimeConfig;
 var init_doctor = __esm({
   "src/commands/doctor.ts"() {
     "use strict";
@@ -12179,6 +12360,15 @@ var init_doctor = __esm({
     init_src();
     init_layout();
     init_start();
+    readRuntimeConfig = async (dbUrl, key) => {
+      const { PrismaClient } = await import("@prisma/client");
+      const client = new PrismaClient({ datasourceUrl: dbUrl });
+      try {
+        return (await client.runtimeConfig.findUnique({ where: { key }, select: { value: true } }))?.value ?? null;
+      } finally {
+        await client.$disconnect();
+      }
+    };
   }
 });