hanoman 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dena Meidina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -50,7 +50,8 @@ sedang berjalan tak boleh diputus oleh update yang tak diminta.
 | Env | Default | Untuk apa |
 |---|---|---|
 | `HANOMAN_HOME` | `~/.hanoman` | DB SQLite, key SSH, transkrip sesi |
-| `DATABASE_URL` | `file:$HANOMAN_HOME/hanoman.db` | hanya URL `file:` (SQLite) |
+| `HANOMAN_DATABASE_URL` | — | berkas DB khusus hanoman; hanya URL `file:` (nilai lain **melempar**) |
+| `DATABASE_URL` | `file:$HANOMAN_HOME/hanoman.db` | dipakai bila ber-`file:`; nilai lain **diabaikan** dengan peringatan |
 | `PORT` / `HOST` | `8787` / `127.0.0.1` | alamat bind |
 | `HANOMAN_CLAUDE_BIN` / `HANOMAN_CODEX_BIN` | `claude` / `codex` | biner agen |
 | `HANOMAN_TMUX_SOCKET` | `hanoman` | socket tmux terpisah dari milikmu |
@@ -71,3 +72,19 @@ hanoman migrate-from-postgres --from "postgresql://user:pass@host:5432/hanoman"
 
 `--dry-run` hanya menghitung baris per tabel tanpa menulis apa pun. Target yang sudah berisi data
 ditolak kecuali `--force`.
+
+> **Punya `DATABASE_URL` untuk project lain?** Tidak masalah — hanoman mengabaikan nilai non-`file:`
+> dan tetap memakai `$HANOMAN_HOME/hanoman.db`, sambil mencetak peringatan sekali. Untuk menunjuk
+> 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`.
+
+## Lisensi
+
+MIT — lihat `LICENSE`.

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0",
-  "sha": "6d1867f",
-  "builtAt": "2026-07-30T06:11:24.389Z"
+  "version": "0.1.2",
+  "sha": "f55334d",
+  "builtAt": "2026-07-30T07:38:46.598Z"
 }

package/dist/cli.js

@@ -153,19 +153,36 @@ function resolveHome(env = process.env, home = homedir()) {
   const v = env.HANOMAN_HOME?.trim();
   return v ? v : join(home, ".hanoman");
 }
+function schemeOf(raw) {
+  return raw.split("://")[0] ?? "?";
+}
 function resolveDbUrl(env, schemaDir) {
-  const raw = env.DATABASE_URL?.trim();
-  if (!raw) return `file:${join(resolveHome(env), "hanoman.db")}`;
-  if (!raw.startsWith("file:")) {
-    const scheme = raw.split("://")[0] ?? raw;
-    throw new Error(
-      `DATABASE_URL harus URL SQLite \`file:\u2026\` sejak ADR-0086 (dapat \`${scheme}\`). Masih punya data Postgres? Pindahkan sekali: hanoman migrate-from-postgres --from "${raw}"`
-    );
+  const own = env.HANOMAN_DATABASE_URL?.trim();
+  if (own) {
+    if (!own.startsWith("file:")) {
+      throw new Error(
+        `HANOMAN_DATABASE_URL harus URL SQLite \`file:\u2026\` sejak ADR-0086 (dapat \`${schemeOf(own)}\`). Masih punya data Postgres? Pindahkan sekali: hanoman migrate-from-postgres --from "<url-postgres>"`
+      );
+    }
+    return absoluteFileUrl(own, schemaDir);
   }
+  const raw = env.DATABASE_URL?.trim();
+  if (!raw || !raw.startsWith("file:")) return `file:${join(resolveHome(env), "hanoman.db")}`;
+  return absoluteFileUrl(raw, schemaDir);
+}
+function absoluteFileUrl(raw, schemaDir) {
   const p = raw.slice("file:".length);
   if (p.startsWith(":")) return raw;
   return `file:${isAbsolute(p) ? p : resolve(schemaDir, p)}`;
 }
+function dbUrlNotice(env) {
+  if (env.HANOMAN_DATABASE_URL?.trim()) return null;
+  const raw = env.DATABASE_URL?.trim();
+  if (!raw || raw.startsWith("file:")) return null;
+  return `hanoman: DATABASE_URL bertipe \`${schemeOf(raw)}\` DIABAIKAN \u2014 hanoman memakai SQLite (ADR-0086), dan var itu biasanya milik project lain.
+  \u2022 Punya data Postgres hanoman? Pindahkan sekali: hanoman migrate-from-postgres --from "<url>"
+  \u2022 Mau menunjuk berkas DB tertentu? Pakai HANOMAN_DATABASE_URL=file:/path/hanoman.db (atau --db)`;
+}
 function dbFilePath(url) {
   if (!url.startsWith("file:")) throw new Error(`bukan URL SQLite: ${url}`);
   return url.slice("file:".length);
@@ -239,6 +256,7 @@ __export(start_exports, {
   default: () => start,
   distDir: () => distDir,
   ensurePrismaClient: () => ensurePrismaClient,
+  migrateFailureHint: () => migrateFailureHint,
   parseStartArgs: () => parseStartArgs,
   prismaClientUsable: () => prismaClientUsable
 });
@@ -290,10 +308,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);
@@ -337,6 +374,9 @@ async function start(argv, ctx) {
 `);
     return 1;
   }
+  const notice = dbUrlNotice(ctx.env);
+  if (notice) ctx.stderr(`${notice}
+`);
   const home = resolveHome(ctx.env);
   mkdirSync(home, { recursive: true });
   mkdirSync(dirname2(dbFilePath(dbUrl)), { recursive: true });
@@ -351,8 +391,11 @@ async function start(argv, ctx) {
 `);
     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;
     }
   }
@@ -446,6 +489,10 @@ async function doctor(_argv, ctx) {
   });
   ctx.stdout(`hanoman doctor
 ${r.lines.join("\n")}
+`);
+  const notice = dbUrlNotice(ctx.env);
+  if (notice) ctx.stdout(`
+${notice}
 `);
   if (!r.ok) ctx.stderr("\nada prasyarat yang belum terpenuhi \u2014 hanoman tak akan bisa menjalankan sesi\n");
   return r.ok ? 0 : 1;
@@ -6119,9 +6166,11 @@ function packageJsonFor(version2, deps) {
     // mendeteksi & menggenerate sendiri (ensurePrismaClient).
     scripts: { postinstall: "prisma generate --schema prisma/schema.prisma || true" },
     engines: { node: ">=20" },
-    files: ["bin", "dist", "web", "prisma", "README.md"],
+    files: ["bin", "dist", "web", "prisma", "README.md", "LICENSE"],
     dependencies: deps,
-    license: "UNLICENSED"
+    // 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.
+    license: "MIT"
   };
 }
 function copyPlan(repo) {
@@ -6132,7 +6181,8 @@ function copyPlan(repo) {
     { 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, "internal/docs/operations/npm-readme.md"), to: "README.md" },
+    { from: join8(repo, "LICENSE"), to: "LICENSE" }
   ];
 }
 var PKG_NAME, REPO_URL, RUNTIME_DEPS, REQUIRED_ARTIFACTS, BIN_SHIM;
@@ -6159,7 +6209,8 @@ var init_pack = __esm({
       "dist/server.js",
       "prisma/schema.prisma",
       "web/index.html",
-      "README.md"
+      "README.md",
+      "LICENSE"
     ];
     BIN_SHIM = `#!/usr/bin/env node
 // SPEC-398 \xB7 shim tipis: seluruh logika ada di dist/cli.js (bundle esbuild).

package/dist/server.js

@@ -6078,19 +6078,36 @@ function resolveHome(env = process.env, home = homedir()) {
   const v = env.HANOMAN_HOME?.trim();
   return v ? v : join(home, ".hanoman");
 }
+function schemeOf(raw) {
+  return raw.split("://")[0] ?? "?";
+}
 function resolveDbUrl(env, schemaDir2) {
-  const raw = env.DATABASE_URL?.trim();
-  if (!raw) return `file:${join(resolveHome(env), "hanoman.db")}`;
-  if (!raw.startsWith("file:")) {
-    const scheme = raw.split("://")[0] ?? raw;
-    throw new Error(
-      `DATABASE_URL harus URL SQLite \`file:\u2026\` sejak ADR-0086 (dapat \`${scheme}\`). Masih punya data Postgres? Pindahkan sekali: hanoman migrate-from-postgres --from "${raw}"`
-    );
+  const own = env.HANOMAN_DATABASE_URL?.trim();
+  if (own) {
+    if (!own.startsWith("file:")) {
+      throw new Error(
+        `HANOMAN_DATABASE_URL harus URL SQLite \`file:\u2026\` sejak ADR-0086 (dapat \`${schemeOf(own)}\`). Masih punya data Postgres? Pindahkan sekali: hanoman migrate-from-postgres --from "<url-postgres>"`
+      );
+    }
+    return absoluteFileUrl(own, schemaDir2);
   }
+  const raw = env.DATABASE_URL?.trim();
+  if (!raw || !raw.startsWith("file:")) return `file:${join(resolveHome(env), "hanoman.db")}`;
+  return absoluteFileUrl(raw, schemaDir2);
+}
+function absoluteFileUrl(raw, schemaDir2) {
   const p = raw.slice("file:".length);
   if (p.startsWith(":")) return raw;
   return `file:${isAbsolute2(p) ? p : resolve4(schemaDir2, p)}`;
 }
+function dbUrlNotice(env) {
+  if (env.HANOMAN_DATABASE_URL?.trim()) return null;
+  const raw = env.DATABASE_URL?.trim();
+  if (!raw || raw.startsWith("file:")) return null;
+  return `hanoman: DATABASE_URL bertipe \`${schemeOf(raw)}\` DIABAIKAN \u2014 hanoman memakai SQLite (ADR-0086), dan var itu biasanya milik project lain.
+  \u2022 Punya data Postgres hanoman? Pindahkan sekali: hanoman migrate-from-postgres --from "<url>"
+  \u2022 Mau menunjuk berkas DB tertentu? Pakai HANOMAN_DATABASE_URL=file:/path/hanoman.db (atau --db)`;
+}
 function dbFilePath(url2) {
   if (!url2.startsWith("file:")) throw new Error(`bukan URL SQLite: ${url2}`);
   return url2.slice("file:".length);
@@ -6123,13 +6140,15 @@ import { mkdirSync as mkdirSync2 } from "node:fs";
 import { dirname as dirname3, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { PrismaClient } from "@prisma/client";
-var schemaDir, url, prisma;
+var schemaDir, notice, url, prisma;
 var init_db = __esm({
   "src/db.ts"() {
     "use strict";
     init_env();
     init_src2();
     schemaDir = resolve5(dirname3(fileURLToPath2(import.meta.url)), "../prisma");
+    notice = dbUrlNotice(process.env);
+    if (notice) console.warn(notice);
     url = resolveDbUrl(process.env, schemaDir);
     process.env.DATABASE_URL = url;
     mkdirSync2(dirname3(dbFilePath(url)), { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hanoman",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Orchestrator + dashboard workflow docs-driven untuk sesi Claude Code / Codex",
   "type": "module",
   "repository": {
@@ -21,7 +21,8 @@
     "dist",
     "web",
     "prisma",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "dependencies": {
     "fastify": "^4.28.0",
@@ -34,5 +35,5 @@
     "prisma": "^6.19.0",
     "pg": "^8.13.1"
   },
-  "license": "UNLICENSED"
+  "license": "MIT"
 }