hanoman 0.1.13 → 0.1.15

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.13",
-  "sha": "d971e65",
-  "builtAt": "2026-08-01T13:47:43.258Z"
+  "version": "0.1.15",
+  "sha": "0a70229",
+  "builtAt": "2026-08-02T03:26:59.946Z"
 }

package/dist/cli.js

@@ -4281,16 +4281,34 @@ var init_enums = __esm({
   }
 });
 
+// ../shared/src/agent-engine.ts
+var zAgentEngine;
+var init_agent_engine = __esm({
+  "../shared/src/agent-engine.ts"() {
+    "use strict";
+    init_zod();
+    init_enums();
+    zAgentEngine = 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")
+    });
+  }
+});
+
 // ../shared/src/telegram.ts
 var zTelegramSettings, TELEGRAM_DEFAULTS, zTelegramReadiness, zTelegramGatewayStatus, zTelegramMemoryRecord, zTelegramChatContext, TELEGRAM_REPLY_KINDS, zTelegramReplyKind, zTelegramConfirmationRequest, zTelegramReplyInput, zTelegramAuditRecord, zTerminalSteerInput;
 var init_telegram = __esm({
   "../shared/src/telegram.ts"() {
     "use strict";
     init_zod();
+    init_agent_engine();
     init_enums();
     zTelegramSettings = external_exports.object({
       enabled: external_exports.boolean().default(false),
-      progress: external_exports.boolean().default(true)
+      progress: external_exports.boolean().default(true),
+      engine: zAgentEngine.default({})
     });
     TELEGRAM_DEFAULTS = zTelegramSettings.parse({});
     zTelegramReadiness = external_exports.enum([
@@ -4407,6 +4425,7 @@ var init_entities = __esm({
     init_zod();
     init_enums();
     init_telegram();
+    init_agent_engine();
     init_auto_merge();
     zProject = external_exports.object({
       id: external_exports.string(),
@@ -4528,12 +4547,7 @@ 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")
-    });
+    zLeadEngine = zAgentEngine;
     zLead = external_exports.object({
       enabled: external_exports.boolean().default(false),
       // master switch (AC-30)
@@ -5384,6 +5398,9 @@ var init_api = __esm({
       limits: `${API}/limits`,
       // SPEC-339 · versi codex CLI (peringatan lunak model GPT-5.6).
       codexVersion: `${API}/codex/version`,
+      // SPEC-489 · panduan AI agent — markdown MENTAH & PUBLIC (tanpa auth). Satu definisi URL untuk
+      // klien web dan untuk tautan yang disalin operator ke agennya.
+      agentDoc: `${API}/agent-integration.md`,
       docs: (id) => `${API}/projects/${id}/docs`,
       docFile: (id, path) => `${API}/projects/${id}/docs/${path}`,
       // SPEC-210 · dokumen PRD project (freshest-wins: worktree sesi prd hidup > repoDir)
@@ -5662,6 +5679,7 @@ var init_config_registry = __esm({
         kind: "url",
         apply: "live",
         category: "knob",
+        example: "https://hanoman.nafanesia.id",
         help: "Base URL hub tujuan sync (REST + WS). Kosong = instance ini murni HUB."
       },
       {
@@ -5671,6 +5689,7 @@ var init_config_registry = __esm({
         kind: "secret",
         apply: "live",
         category: "credential",
+        example: "43 karakter base64url dari tab Perangkat hub",
         help: "Token yang diterbitkan hub (tab Perangkat di hub). Dikirim sebagai Bearer."
       },
       {
@@ -5680,6 +5699,7 @@ var init_config_registry = __esm({
         kind: "int",
         apply: "live",
         category: "knob",
+        example: "15000",
         default: "15000",
         min: 1e3
       },
@@ -5691,13 +5711,14 @@ var init_config_registry = __esm({
         kind: "secret",
         apply: "new-session",
         category: "credential",
+        example: "sk-ant-oat01-\u2026",
         inheritEnv: true,
         help: "Token `claude setup-token`. Diwarisi proses claude yang di-spawn."
       },
-      { key: "ANTHROPIC_API_KEY", group: "claude", label: "Anthropic API key", kind: "secret", apply: "new-session", category: "credential", inheritEnv: true },
-      { key: "HANOMAN_CLAUDE_BIN", group: "claude", label: "Biner claude", kind: "path", apply: "new-session", category: "knob", default: "claude" },
+      { key: "ANTHROPIC_API_KEY", group: "claude", label: "Anthropic API key", kind: "secret", apply: "new-session", category: "credential", example: "sk-ant-api03-\u2026", inheritEnv: true },
+      { key: "HANOMAN_CLAUDE_BIN", group: "claude", label: "Biner claude", kind: "path", apply: "new-session", category: "knob", example: "/opt/homebrew/bin/claude", default: "claude" },
       // codex (SPEC-338 · ADR-0074)
-      { key: "HANOMAN_CODEX_BIN", group: "claude", label: "Biner codex", kind: "path", apply: "new-session", category: "knob", default: "codex" },
+      { key: "HANOMAN_CODEX_BIN", group: "claude", label: "Biner codex", kind: "path", apply: "new-session", category: "knob", example: "/opt/homebrew/bin/codex", default: "codex" },
       {
         key: "CLAUDE_CONFIG_DIR",
         group: "claude",
@@ -5705,11 +5726,12 @@ var init_config_registry = __esm({
         kind: "path",
         apply: "new-session",
         category: "knob",
+        example: "~/.claude",
         help: "Default ~/.claude. Sumber .credentials.json untuk panel usage/limit."
       },
       // vps
-      { key: "HANOMAN_SSH_KEY_DIR", group: "vps", label: "Dir key SSH", kind: "path", apply: "new-session", category: "knob", help: "Default ~/.hanoman." },
-      { key: "HANOMAN_SSH_BIN", group: "vps", label: "Biner ssh", kind: "path", apply: "new-session", category: "knob", default: "ssh" },
+      { key: "HANOMAN_SSH_KEY_DIR", group: "vps", label: "Dir key SSH", kind: "path", apply: "new-session", category: "knob", example: "~/.hanoman", help: "Default ~/.hanoman." },
+      { key: "HANOMAN_SSH_BIN", group: "vps", label: "Biner ssh", kind: "path", apply: "new-session", category: "knob", example: "/usr/bin/ssh", default: "ssh" },
       // github (SPEC-471 · ADR-0095 · tarik issue → backlog). Dua mode auth, satu jalur kode:
       // `gh` memakai keyring mesin; bila GITHUB_TOKEN diisi ia diteruskan sebagai GH_TOKEN ke
       // proses gh DAN dipakai jalur REST (hub VPS yang tak punya keyring).
@@ -5720,6 +5742,7 @@ var init_config_registry = __esm({
         kind: "secret",
         apply: "live",
         category: "credential",
+        example: "ghp_\u2026",
         help: "PAT scope `repo` (atau `public_repo`). Kosong = andalkan `gh auth login` di mesin ini."
       },
       {
@@ -5729,6 +5752,7 @@ var init_config_registry = __esm({
         kind: "path",
         apply: "live",
         category: "knob",
+        example: "/opt/homebrew/bin/gh",
         default: "gh",
         help: "Absen = tarik issue lewat HTTPS langsung ke api.github.com."
       },
@@ -5741,6 +5765,7 @@ var init_config_registry = __esm({
         kind: "secret",
         apply: "live",
         category: "credential",
+        example: "123456789:AAE\u2026",
         pattern: "^\\d{5,}:[A-Za-z0-9_-]{30,}$",
         patternError: "format BotFather: <bot_id>:<secret>",
         help: "Token dari BotFather. Disimpan terenkripsi; tak pernah dikembalikan utuh."
@@ -5752,6 +5777,7 @@ var init_config_registry = __esm({
         kind: "secret",
         apply: "live",
         category: "credential",
+        example: "hnm_agt_\u2026",
         pattern: "^\\S{20,}$",
         patternError: "plaintext AgentToken (hnm_agt_\u2026)",
         help: "Plaintext AgentToken ber-capability Telegram. Dipakai session operator, bukan bot."
@@ -5763,6 +5789,7 @@ var init_config_registry = __esm({
         kind: "string",
         apply: "live",
         category: "credential",
+        example: "123456789, 987654321",
         pattern: "^\\d+(?:[\\s,]+\\d+)*$",
         patternError: "numeric user id, dipisah koma/spasi",
         help: "Siapa yang boleh memerintah bot. Numeric Telegram user id, bukan username."
@@ -5774,12 +5801,13 @@ var init_config_registry = __esm({
         kind: "string",
         apply: "live",
         category: "knob",
+        example: "-1001234567890",
         pattern: "^-?\\d+$",
         patternError: "numeric chat id (channel/supergroup negatif)",
         help: "Tujuan Test Connection. Kosong = pakai satu-satunya id di allowlist."
       },
       // runtime
-      { key: "HANOMAN_EVENTS_TICK_MS", group: "runtime", label: "Interval events (ms)", kind: "int", apply: "live", category: "knob", default: "1000", min: 100 },
+      { key: "HANOMAN_EVENTS_TICK_MS", group: "runtime", label: "Interval events (ms)", kind: "int", apply: "live", category: "knob", example: "1000", default: "1000", min: 100 },
       { key: "HANOMAN_UPDATE_FETCH", group: "runtime", label: "Deteksi update saat boot", kind: "bool", apply: "live", category: "knob", default: "1" },
       // SPEC-398 · ADR-0087 · deteksi update kini membandingkan semver dengan registry npm, bukan
       // menghitung commit di repo git (HANOMAN_REPO_ROOT dicabut bersama jalur git itu).
@@ -5790,6 +5818,7 @@ var init_config_registry = __esm({
         kind: "string",
         apply: "live",
         category: "knob",
+        example: "https://registry.npmjs.org",
         default: "https://registry.npmjs.org",
         help: "Sumber versi terbaru paket `hanoman`."
       },
@@ -5800,15 +5829,16 @@ var init_config_registry = __esm({
         kind: "string",
         apply: "restart",
         category: "knob",
+        example: "hanoman",
         default: "hanoman",
         help: "Mengubah ini TIDAK memindahkan sesi tmux yang sudah hidup \u2014 berlaku setelah restart."
       },
       // gitGraph (SPEC-233 · preferensi tampilan git graph; semua live, dikonsumsi client)
-      { key: "gitGraph.style", group: "gitGraph", label: "Gaya graph", kind: "string", apply: "live", category: "knob", default: "rounded", help: "rounded | angular" },
-      { key: "gitGraph.colours", group: "gitGraph", label: "Warna lane (CSV)", kind: "string", apply: "live", category: "knob", help: "Daftar warna hex dipisah koma; kosong = palet bawaan." },
-      { key: "gitGraph.dateType", group: "gitGraph", label: "Jenis tanggal", kind: "string", apply: "live", category: "knob", default: "author", help: "author | commit" },
-      { key: "gitGraph.commitsInitialLoad", group: "gitGraph", label: "Muat awal", kind: "int", apply: "live", category: "knob", default: "200", min: 1 },
-      { key: "gitGraph.commitsLoadMore", group: "gitGraph", label: "Muat lagi", kind: "int", apply: "live", category: "knob", default: "100", min: 1 },
+      { key: "gitGraph.style", group: "gitGraph", label: "Gaya graph", kind: "string", apply: "live", category: "knob", example: "rounded", default: "rounded", help: "rounded | angular" },
+      { key: "gitGraph.colours", group: "gitGraph", label: "Warna lane (CSV)", kind: "string", apply: "live", category: "knob", example: "#c9a227, #6b8f71, #b4614e", help: "Daftar warna hex dipisah koma; kosong = palet bawaan." },
+      { key: "gitGraph.dateType", group: "gitGraph", label: "Jenis tanggal", kind: "string", apply: "live", category: "knob", example: "author", default: "author", help: "author | commit" },
+      { key: "gitGraph.commitsInitialLoad", group: "gitGraph", label: "Muat awal", kind: "int", apply: "live", category: "knob", example: "200", default: "200", min: 1 },
+      { key: "gitGraph.commitsLoadMore", group: "gitGraph", label: "Muat lagi", kind: "int", apply: "live", category: "knob", example: "100", default: "100", min: 1 },
       { key: "gitGraph.showRemoteBranches", group: "gitGraph", label: "Tampilkan remote", kind: "bool", apply: "live", category: "knob", default: "1" },
       { key: "gitGraph.showTags", group: "gitGraph", label: "Tampilkan tag", kind: "bool", apply: "live", category: "knob", default: "1" },
       { key: "gitGraph.showStashes", group: "gitGraph", label: "Tampilkan stash", kind: "bool", apply: "live", category: "knob", default: "1" },
@@ -5818,7 +5848,7 @@ var init_config_registry = __esm({
       { key: "gitGraph.combineLocalRemote", group: "gitGraph", label: "Gabung label local+remote", kind: "bool", apply: "live", category: "knob", default: "0" },
       { key: "gitGraph.markdown", group: "gitGraph", label: "Render markdown pesan", kind: "bool", apply: "live", category: "knob", default: "1" },
       { key: "gitGraph.emoji", group: "gitGraph", label: "Render emoji shortcode", kind: "bool", apply: "live", category: "knob", default: "1" },
-      { key: "gitGraph.issueLinkPattern", group: "gitGraph", label: "Pola link issue", kind: "string", apply: "live", category: "knob", help: "URL dengan $1 untuk nomor issue, mis. https://github.com/acme/app/issues/$1" },
+      { key: "gitGraph.issueLinkPattern", group: "gitGraph", label: "Pola link issue", kind: "string", apply: "live", category: "knob", example: "https://github.com/acme/app/issues/$1", help: "URL dengan $1 untuk nomor issue, mis. https://github.com/acme/app/issues/$1" },
       // bootstrap (read-only)
       { key: "DATABASE_URL", group: "bootstrap", label: "DATABASE_URL", kind: "secret", apply: "restart", category: "bootstrap" },
       { key: "TEST_DATABASE_URL", group: "bootstrap", label: "TEST_DATABASE_URL", kind: "secret", apply: "restart", category: "bootstrap" },
@@ -6826,6 +6856,7 @@ var init_src = __esm({
   "../shared/src/index.ts"() {
     "use strict";
     init_enums();
+    init_agent_engine();
     init_entities();
     init_agent();
     init_custom_agent();
@@ -28701,7 +28732,7 @@ function packageJsonFor(version3, deps) {
       prepublishOnly: "node dist/cli.js __verify"
     },
     engines: { node: ">=20" },
-    files: ["bin", "dist", "web", "prisma", "README.md", "LICENSE"],
+    files: ["bin", "dist", "web", "prisma", "docs", "README.md", "LICENSE"],
     dependencies: deps,
     // MIT: paket ini didistribusikan publik supaya orang `npm i -g`. `UNLICENSED` berarti "tak ada
     // izin pakai" — 0.1.0 terbit dengan kontradiksi itu, dan versi terbit tak bisa diperbaiki.
@@ -28723,6 +28754,9 @@ function copyPlan(repo) {
     { from: join10(repo, "server/prisma/schema.prisma"), to: "prisma/schema.prisma" },
     { from: join10(repo, "server/prisma/migrations"), to: "prisma/migrations", dir: true },
     { from: join10(repo, "internal/docs/operations/npm-readme.md"), to: "README.md" },
+    // SPEC-489 · dibaca runtime oleh pickGuideFile (kandidat `<pkg>/docs/…`). Bukan README:
+    // README paket adalah npm-readme.md (berhadapan-MANUSIA), ini naskah berhadapan-AGEN.
+    { from: join10(repo, "docs/agent-integration.md"), to: "docs/agent-integration.md" },
     { from: join10(repo, "LICENSE"), to: "LICENSE" }
   ];
 }
@@ -28751,7 +28785,11 @@ var init_pack = __esm({
       "prisma/schema.prisma",
       "web/index.html",
       "README.md",
-      "LICENSE"
+      "LICENSE",
+      // SPEC-489 · naskah panduan AI agent — dibaca runtime & disajikan di GET /api/agent-integration.md.
+      // Tanpa gerbang ini paket bisa terbit tanpa dokumen dan endpoint-nya 404 di SETIAP instalasi npm,
+      // sementara checkout dev terlihat sehat.
+      "docs/agent-integration.md"
     ];
     BIN_SHIM = `#!/usr/bin/env node
 // SPEC-398 \xB7 shim tipis: seluruh logika ada di dist/cli.js (bundle esbuild).