hanoman 0.1.2 → 0.1.4

package/README.md

@@ -85,6 +85,17 @@ punya riwayat migrasi hanoman — biasanya bukan DB hanoman versi ini (sisa prot
 berkas tool lain yang kebetulan bernama sama). hanoman **tidak** mengubah isinya. Pindahkan berkas
 itu lalu jalankan ulang, atau tunjuk berkas lain dengan `hanoman --db /path/baru.db`.
 
+## Kalau terminal sesi terbuka tapi kosong
+
+Sesi hanoman hidup di dalam **tmux**; layarnya dialirkan ke browser lewat node-pty. Dua sebab:
+
+- **tmux belum terpasang** — `brew install tmux` (macOS) atau paket distro Anda.
+- **`spawn-helper` node-pty tak executable** — node-pty menerbitkan biner pendampingnya dengan mode
+  `0644`, jadi `posix_spawnp` gagal dan tak satu byte pun mengalir ke terminal walau sesinya hidup.
+  Sejak `0.1.3` `hanoman` memperbaikinya sendiri saat start (sekali per instalasi). Bila instalasi
+  global itu milik root dan hanoman dijalankan sebagai pengguna biasa, chmod-nya ditolak — perbaiki
+  manual: `sudo chmod +x "$(npm root -g)"/hanoman/node_modules/node-pty/prebuilds/*/spawn-helper`.
+
 ## Lisensi
 
 MIT — lihat `LICENSE`.

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.2",
-  "sha": "f55334d",
-  "builtAt": "2026-07-30T07:38:46.598Z"
+  "version": "0.1.4",
+  "sha": "ac19a3e",
+  "builtAt": "2026-07-30T09:10:14.186Z"
 }

package/dist/cli.js

@@ -256,14 +256,17 @@ __export(start_exports, {
   default: () => start,
   distDir: () => distDir,
   ensurePrismaClient: () => ensurePrismaClient,
+  ensureSpawnHelpersExecutable: () => ensureSpawnHelpersExecutable,
   migrateFailureHint: () => migrateFailureHint,
   parseStartArgs: () => parseStartArgs,
-  prismaClientUsable: () => prismaClientUsable
+  prismaClientUsable: () => prismaClientUsable,
+  repairSpawnHelper: () => repairSpawnHelper,
+  spawnHelperPaths: () => spawnHelperPaths
 });
 import { spawn, execFileSync } from "node:child_process";
 import { createRequire } from "node:module";
-import { existsSync, mkdirSync } from "node:fs";
-import { dirname as dirname2, resolve as resolvePath } from "node:path";
+import { existsSync, mkdirSync, readdirSync, statSync, chmodSync } from "node:fs";
+import { dirname as dirname2, join as join3, resolve as resolvePath } from "node:path";
 import { fileURLToPath } from "node:url";
 function parseStartArgs(argv) {
   const out = { port: null, host: null, db: null, migrate: true };
@@ -355,6 +358,44 @@ async function ensurePrismaClient(schema, dbUrl, ctx) {
     return false;
   }
 }
+function spawnHelperPaths(ptyDir, listDir, exists) {
+  const dirs = [join3(ptyDir, "build", "Release")];
+  for (const name of listDir(join3(ptyDir, "prebuilds"))) dirs.push(join3(ptyDir, "prebuilds", name));
+  return dirs.map((d) => join3(d, "spawn-helper")).filter(exists);
+}
+function ensureSpawnHelpersExecutable(paths2, ops) {
+  const fixed = [];
+  for (const p of paths2) {
+    try {
+      const mode = ops.mode(p) & 4095;
+      if ((mode & 73) === 73) continue;
+      ops.chmod(p, mode | 73);
+      fixed.push(p);
+    } catch {
+    }
+  }
+  return fixed;
+}
+function repairSpawnHelper(ctx) {
+  let ptyDir;
+  try {
+    ptyDir = dirname2(createRequire(import.meta.url).resolve("node-pty/package.json"));
+  } catch {
+    return;
+  }
+  const paths2 = spawnHelperPaths(ptyDir, (d) => {
+    try {
+      return readdirSync(d);
+    } catch {
+      return [];
+    }
+  }, existsSync);
+  const fixed = ensureSpawnHelpersExecutable(paths2, {
+    mode: (p) => statSync(p).mode,
+    chmod: (p, m) => chmodSync(p, m)
+  });
+  if (fixed.length) ctx.stdout("hanoman \xB7 memperbaiki izin `spawn-helper` node-pty (sekali per instalasi)\n");
+}
 async function start(argv, ctx) {
   let opts;
   try {
@@ -386,6 +427,7 @@ async function start(argv, ctx) {
     return 1;
   }
   if (!await ensurePrismaClient(layout.schema, dbUrl, ctx)) return 1;
+  repairSpawnHelper(ctx);
   if (opts.migrate) {
     ctx.stdout(`hanoman \xB7 menerapkan migrasi ke ${dbFilePath(dbUrl)}
 `);
@@ -5918,9 +5960,9 @@ var init_migrate_pg = __esm({
 
 // src/config.ts
 import { readFileSync, existsSync as existsSync4 } from "node:fs";
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 function loadConfig(repoRoot) {
-  const p = join3(repoRoot, "hanoman.config.json");
+  const p = join4(repoRoot, "hanoman.config.json");
   const raw = existsSync4(p) ? JSON.parse(readFileSync(p, "utf8")) : {};
   return zHanomanConfig.parse(raw);
 }
@@ -5933,12 +5975,12 @@ var init_config2 = __esm({
 
 // src/repo.ts
 import { spawnSync } from "node:child_process";
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 function resolveRepo(cwd) {
   const r = spawnSync("git", ["rev-parse", "--show-toplevel"], { cwd, encoding: "utf8" });
   const root = r.status === 0 ? r.stdout.trim() : cwd;
   const { docsDir } = loadConfig(root);
-  return { root, docsDir, indexPath: join4(root, docsDir, "README.md") };
+  return { root, docsDir, indexPath: join5(root, docsDir, "README.md") };
 }
 var init_repo = __esm({
   "src/repo.ts"() {
@@ -5948,8 +5990,8 @@ var init_repo = __esm({
 });
 
 // src/docs-model.ts
-import { readFileSync as readFileSync2, readdirSync, statSync } from "node:fs";
-import { join as join5, relative } from "node:path";
+import { readFileSync as readFileSync2, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { join as join6, relative } from "node:path";
 function parseIndex(indexPath) {
   const md = readFileSync2(indexPath, "utf8");
   const out = /* @__PURE__ */ new Set();
@@ -5964,10 +6006,10 @@ function parseIndex(indexPath) {
 function walkDocs(docsRoot) {
   const out = [];
   const walk = (dir) => {
-    for (const name of readdirSync(dir)) {
+    for (const name of readdirSync2(dir)) {
       if (name.startsWith(".")) continue;
-      const abs = join5(dir, name);
-      if (statSync(abs).isDirectory()) walk(abs);
+      const abs = join6(dir, name);
+      if (statSync2(abs).isDirectory()) walk(abs);
       else out.push(relative(docsRoot, abs).split("\\").join("/"));
     }
   };
@@ -5998,17 +6040,17 @@ var init_docs_model = __esm({
 });
 
 // src/verify.ts
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
 function scanCoverage(cwd) {
   const { root, docsDir, indexPath } = resolveRepo(cwd);
-  const docsRoot = join6(root, docsDir);
+  const docsRoot = join7(root, docsDir);
   if (!existsSync5(docsRoot)) return { coverage: 100, cats: [] };
   if (!existsSync5(indexPath)) throw new Error(`index Source of Truth tidak ada: ${indexPath}`);
   const corpus = walkDocs(docsRoot);
   const read = (rel) => {
     try {
-      return readFileSync3(join6(docsRoot, rel), "utf8");
+      return readFileSync3(join7(docsRoot, rel), "utf8");
     } catch {
       return null;
     }
@@ -6082,23 +6124,23 @@ __export(docs_index_exports, {
   default: () => docs_index_default
 });
 import { parseArgs as parseArgs2 } from "node:util";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 import { existsSync as existsSync6, readFileSync as readFileSync5 } from "node:fs";
 async function docs_index_default(args, ctx) {
   const { values } = parseArgs2({ args, options: { check: { type: "boolean" }, fix: { type: "boolean" } }, allowPositionals: true });
   const { root, docsDir, indexPath } = resolveRepo(ctx.cwd);
-  const docsRoot = join7(root, docsDir);
+  const docsRoot = join8(root, docsDir);
   const corpus = walkDocs(docsRoot);
   const read = (rel) => {
     try {
-      return readFileSync5(join7(docsRoot, rel), "utf8");
+      return readFileSync5(join8(docsRoot, rel), "utf8");
     } catch {
       return null;
     }
   };
   const linked = linkedSetFrom(INDEX_NAME, corpus, read);
   const unlinked = corpus.filter((f) => f !== INDEX_NAME && !linked.has(f));
-  const dangling = [...parseIndex(indexPath)].filter((p) => !existsSync6(join7(docsRoot, p)));
+  const dangling = [...parseIndex(indexPath)].filter((p) => !existsSync6(join8(docsRoot, p)));
   if (values.fix) {
     for (const f of unlinked) addLink(indexPath, f, f.split("/")[0]);
     ctx.stdout(`linked ${unlinked.length} doc(s)
@@ -6151,7 +6193,7 @@ var init_docs_link = __esm({
 });
 
 // src/release/pack.ts
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 function packageJsonFor(version2, deps) {
   return {
     name: PKG_NAME,
@@ -6164,7 +6206,15 @@ function packageJsonFor(version2, deps) {
     // seketika dengan "@prisma/client did not initialize yet" (terukur di `npm i -g` nyata).
     // Non-fatal (`|| true`): bila npm melewati script (mis. --ignore-scripts), `hanoman start`
     // mendeteksi & menggenerate sendiri (ensurePrismaClient).
-    scripts: { postinstall: "prisma generate --schema prisma/schema.prisma || true" },
+    scripts: {
+      postinstall: "prisma generate --schema prisma/schema.prisma || true",
+      // SPEC-403 · gerbang terakhir sebelum byte meninggalkan mesin. `hanoman@0.1.3` terbit tanpa
+      // `prisma` karena `dist-npm/package.json` DIMUTASI sesudah dirakit — `npm i -g --prefix <dir>
+      // <tarball>` dengan cwd di `dist-npm` menulis ulang berkas itu (terukur, bisa diulang), dan
+      // smoke test itulah yang merusaknya. npm menjalankan `prepublishOnly` tepat sebelum publish,
+      // jadi inilah satu-satunya lapis yang melihat isi berkas SEBENARNYA yang akan dikirim.
+      prepublishOnly: "node dist/cli.js __verify"
+    },
     engines: { node: ">=20" },
     files: ["bin", "dist", "web", "prisma", "README.md", "LICENSE"],
     dependencies: deps,
@@ -6173,16 +6223,22 @@ function packageJsonFor(version2, deps) {
     license: "MIT"
   };
 }
+function verifyPackedDeps(pkg) {
+  const deps = pkg?.dependencies ?? {};
+  return RUNTIME_DEPS.filter((d) => !deps[d]).map(
+    (d) => `dependency wajib hilang dari package.json paket: ${d}`
+  );
+}
 function copyPlan(repo) {
   return [
-    { from: join8(repo, "server/dist/server.js"), to: "dist/server.js" },
-    { from: join8(repo, "server/dist/build-info.json"), to: "dist/build-info.json" },
-    { from: join8(repo, "cli/dist/hanoman.js"), to: "dist/cli.js" },
-    { from: join8(repo, "src/dist"), to: "web", dir: true },
-    { from: join8(repo, "server/prisma/schema.prisma"), to: "prisma/schema.prisma" },
-    { from: join8(repo, "server/prisma/migrations"), to: "prisma/migrations", dir: true },
-    { from: join8(repo, "internal/docs/operations/npm-readme.md"), to: "README.md" },
-    { from: join8(repo, "LICENSE"), to: "LICENSE" }
+    { from: join9(repo, "server/dist/server.js"), to: "dist/server.js" },
+    { from: join9(repo, "server/dist/build-info.json"), to: "dist/build-info.json" },
+    { from: join9(repo, "cli/dist/hanoman.js"), to: "dist/cli.js" },
+    { from: join9(repo, "src/dist"), to: "web", dir: true },
+    { from: join9(repo, "server/prisma/schema.prisma"), to: "prisma/schema.prisma" },
+    { from: join9(repo, "server/prisma/migrations"), to: "prisma/migrations", dir: true },
+    { from: join9(repo, "internal/docs/operations/npm-readme.md"), to: "README.md" },
+    { from: join9(repo, "LICENSE"), to: "LICENSE" }
   ];
 }
 var PKG_NAME, REPO_URL, RUNTIME_DEPS, REQUIRED_ARTIFACTS, BIN_SHIM;
@@ -6225,9 +6281,9 @@ __export(pack_exports, {
   default: () => pack
 });
 import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync6, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
-import { dirname as dirname5, join as join9 } from "node:path";
+import { dirname as dirname5, join as join10 } from "node:path";
 function depVersions(repo) {
-  const read = (p) => JSON.parse(readFileSync6(join9(repo, p), "utf8"));
+  const read = (p) => JSON.parse(readFileSync6(join10(repo, p), "utf8"));
   const server = read("server/package.json"), cli = read("cli/package.json");
   const pools = [server.dependencies, server.devDependencies, cli.dependencies, cli.devDependencies];
   const out = {};
@@ -6247,13 +6303,13 @@ async function pack(argv, ctx) {
 `);
     return 1;
   }
-  if (!existsSync7(join9(repo, "server/prisma/schema.prisma"))) {
+  if (!existsSync7(join10(repo, "server/prisma/schema.prisma"))) {
     ctx.stderr("pack: hanya bisa dijalankan dari checkout repo hanoman\n");
     return 1;
   }
   const outIdx = argv.indexOf("--out");
-  const out = outIdx === -1 ? join9(repo, "dist-npm") : join9(repo, argv[outIdx + 1] ?? "dist-npm");
-  const version2 = JSON.parse(readFileSync6(join9(repo, "package.json"), "utf8")).version;
+  const out = outIdx === -1 ? join10(repo, "dist-npm") : join10(repo, argv[outIdx + 1] ?? "dist-npm");
+  const version2 = JSON.parse(readFileSync6(join10(repo, "package.json"), "utf8")).version;
   if (!version2) {
     ctx.stderr("pack: root package.json tanpa field version\n");
     return 1;
@@ -6267,20 +6323,20 @@ async function pack(argv, ctx) {
     return 1;
   }
   rmSync(out, { recursive: true, force: true });
-  mkdirSync2(join9(out, "bin"), { recursive: true });
+  mkdirSync2(join10(out, "bin"), { recursive: true });
   for (const item of copyPlan(repo)) {
     if (!existsSync7(item.from)) {
       ctx.stderr(`pack: artefak hilang \u2014 ${item.from} (sudah \`pnpm build\`?)
 `);
       return 1;
     }
-    const dest = join9(out, item.to);
+    const dest = join10(out, item.to);
     mkdirSync2(dirname5(dest), { recursive: true });
     cpSync(item.from, dest, item.dir ? { recursive: true } : {});
   }
-  writeFileSync2(join9(out, "bin/hanoman.mjs"), BIN_SHIM);
-  writeFileSync2(join9(out, "package.json"), JSON.stringify(packageJsonFor(version2, deps), null, 2) + "\n");
-  const missing = REQUIRED_ARTIFACTS.filter((a) => !existsSync7(join9(out, a)));
+  writeFileSync2(join10(out, "bin/hanoman.mjs"), BIN_SHIM);
+  writeFileSync2(join10(out, "package.json"), JSON.stringify(packageJsonFor(version2, deps), null, 2) + "\n");
+  const missing = REQUIRED_ARTIFACTS.filter((a) => !existsSync7(join10(out, a)));
   if (missing.length) {
     ctx.stderr(`pack: artefak wajib hilang: ${missing.join(", ")}
 `);
@@ -6300,6 +6356,39 @@ var init_pack2 = __esm({
   }
 });
 
+// src/commands/verify-packed.ts
+var verify_packed_exports = {};
+__export(verify_packed_exports, {
+  default: () => verifyPacked
+});
+import { readFileSync as readFileSync7 } from "node:fs";
+import { join as join11 } from "node:path";
+function verifyPacked(_argv, ctx) {
+  const path = join11(process.cwd(), "package.json");
+  let pkg;
+  try {
+    pkg = JSON.parse(readFileSync7(path, "utf8"));
+  } catch {
+    ctx.stderr(`verify: tak bisa membaca ${path}
+`);
+    return 1;
+  }
+  const keluhan = verifyPackedDeps(pkg);
+  if (keluhan.length === 0) return 0;
+  for (const k of keluhan) ctx.stderr(`verify: ${k}
+`);
+  ctx.stderr(
+    "\nPublish DIBATALKAN. `dist-npm/package.json` tercemar sesudah dirakit \u2014 jangan sunting\nberkas itu, rakit ulang: `pnpm release`. Penyebab yang sudah terukur: menjalankan\n`npm install`/`npm i -g` dengan cwd di dalam `dist-npm/` menulis ulang package.json-nya.\n"
+  );
+  return 1;
+}
+var init_verify_packed = __esm({
+  "src/commands/verify-packed.ts"() {
+    "use strict";
+    init_pack();
+  }
+});
+
 // src/router.ts
 import { createRequire as createRequire2 } from "node:module";
 function currentVersion() {
@@ -6320,6 +6409,7 @@ function route(argv) {
     return { cmd: `docs:${sub}`, args: rest };
   }
   if (group === "__pack") return { cmd: "__pack", args: argv.slice(1) };
+  if (group === "__verify") return { cmd: "__verify", args: argv.slice(1) };
   return { cmd: "unknown", args: argv };
 }
 async function run(argv, ctx) {
@@ -6340,6 +6430,7 @@ async function run(argv, ctx) {
   if (cmd === "docs:index") return (await Promise.resolve().then(() => (init_docs_index(), docs_index_exports))).default(args, ctx);
   if (cmd === "docs:link") return (await Promise.resolve().then(() => (init_docs_link(), docs_link_exports))).default(args, ctx);
   if (cmd === "__pack") return (await Promise.resolve().then(() => (init_pack2(), pack_exports))).default(args, ctx);
+  if (cmd === "__verify") return (await Promise.resolve().then(() => (init_verify_packed(), verify_packed_exports))).default(args, ctx);
   ctx.stderr(`unknown command: ${argv.join(" ")}
 
 ${HELP}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hanoman",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Orchestrator + dashboard workflow docs-driven untuk sesi Claude Code / Codex",
   "type": "module",
   "repository": {
@@ -11,7 +11,8 @@
     "hanoman": "bin/hanoman.mjs"
   },
   "scripts": {
-    "postinstall": "prisma generate --schema prisma/schema.prisma || true"
+    "postinstall": "prisma generate --schema prisma/schema.prisma || true",
+    "prepublishOnly": "node dist/cli.js __verify"
   },
   "engines": {
     "node": ">=20"