hanoman 0.1.1 → 0.1.3

package/README.md

@@ -78,6 +78,24 @@ ditolak kecuali `--force`.
 > berkas DB tertentu tanpa menyentuh var itu, pakai `HANOMAN_DATABASE_URL=file:/path/hanoman.db`
 > atau `hanoman --db /path/hanoman.db`.
 
+## Kalau `hanoman` gagal menerapkan migrasi
+
+**`P3005 — The database schema is not empty`** berarti berkas DB itu sudah punya tabel tapi tak
+punya riwayat migrasi hanoman — biasanya bukan DB hanoman versi ini (sisa prototipe lama, atau
+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.1",
-  "sha": "55bc2c6",
-  "builtAt": "2026-07-30T07:00:27.508Z"
+  "version": "0.1.3",
+  "sha": "c5266ce",
+  "builtAt": "2026-07-30T08:59:12.271Z"
 }

package/dist/cli.js

@@ -256,13 +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 };
@@ -307,10 +311,29 @@ function distDir() {
 }
 function runPrisma(args, dbUrl) {
   const prismaCli = prismaCliPath(createRequire(import.meta.url).resolve);
-  execFileSync(process.execPath, [prismaCli, ...args], {
-    env: { ...process.env, DATABASE_URL: dbUrl },
-    stdio: "inherit"
-  });
+  try {
+    const out = execFileSync(process.execPath, [prismaCli, ...args], {
+      env: { ...process.env, DATABASE_URL: dbUrl },
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    process.stdout.write(out);
+    return out;
+  } catch (e) {
+    const err = e;
+    const output = `${err.stdout ?? ""}${err.stderr ?? ""}`;
+    process.stderr.write(output);
+    throw Object.assign(new Error("prisma gagal"), { output });
+  }
+}
+function migrateFailureHint(output, dbFile) {
+  if (!output.includes("P3005")) return null;
+  return `hanoman: berkas DB ${dbFile} sudah berisi tabel, tapi tak punya riwayat migrasi hanoman.
+Biasanya ia bukan DB hanoman versi ini \u2014 mis. sisa prototipe lama atau berkas tool lain.
+Pilih salah satu:
+  \u2022 Pindahkan berkas itu, lalu jalankan ulang:  mv "${dbFile}" "${dbFile}.lama"
+  \u2022 Pakai berkas lain:  hanoman --db /path/baru.db  (atau HANOMAN_DATABASE_URL=file:/path/baru.db)
+Isi berkas lama tidak diubah oleh hanoman \u2014 periksa dulu sebelum menghapusnya.`;
 }
 function applyMigrations(schema, dbUrl) {
   runPrisma(["migrate", "deploy", "--schema", schema], dbUrl);
@@ -335,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 {
@@ -366,13 +427,17 @@ 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)}
 `);
     try {
       applyMigrations(layout.schema, dbUrl);
-    } catch {
-      ctx.stderr("hanoman: `prisma migrate deploy` gagal \u2014 lihat keluaran di atas\n");
+    } catch (e) {
+      const hint = migrateFailureHint(String(e.output ?? ""), dbFilePath(dbUrl));
+      ctx.stderr(hint ? `
+${hint}
+` : "hanoman: `prisma migrate deploy` gagal \u2014 lihat keluaran di atas\n");
       return 1;
     }
   }
@@ -5895,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);
 }
@@ -5910,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"() {
@@ -5925,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();
@@ -5941,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("/"));
     }
   };
@@ -5975,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;
     }
@@ -6059,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)
@@ -6128,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,
@@ -6152,14 +6217,14 @@ function packageJsonFor(version2, deps) {
 }
 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;
@@ -6202,9 +6267,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 = {};
@@ -6224,13 +6289,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;
@@ -6244,20 +6309,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(", ")}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hanoman",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Orchestrator + dashboard workflow docs-driven untuk sesi Claude Code / Codex",
   "type": "module",
   "repository": {
@@ -25,15 +25,17 @@
     "LICENSE"
   ],
   "dependencies": {
-    "fastify": "^4.28.0",
+    "@fastify/cookie": "^9.4.0",
     "@fastify/static": "^7.0.0",
     "@fastify/websocket": "^10.0.1",
-    "@fastify/cookie": "^9.4.0",
-    "@prisma/client": "^6.19.0",
+    "@prisma/client": "^6.19.3",
+    "fastify": "^4.28.0",
     "node-pty": "^1.1.0",
     "pdfkit": "^0.19.1",
-    "prisma": "^6.19.0",
     "pg": "^8.13.1"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {
+    "prisma": "^6.19.3"
+  }
 }