@kahitsan/plugin-sdk 0.2.0 → 0.3.0-staging.41

package/bin/cli.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+// @kahitsan/plugin-sdk CLI — the dev toolkit launcher (Vision §5.1, K3/K4).
+//
+//   npx @kahitsan/plugin-sdk <pluginDir> [<pluginDir> …]   ← headline form
+//   npx @kahitsan/plugin-sdk toolkit <pluginDir> …          ← alias (back-compat)
+//
+// Boots the dev-kernel mediator + each plugin on Bun (local SQLite + a synthetic
+// logged-in admin) entirely from the INSTALLED package — no kernel source required.
+// Pass several plugin dirs to exercise the CONTRACT between plugins (does B expose
+// the method A consumes?) locally — no kernel, no Postgres. The harness is Bun-only,
+// so the launcher re-execs under Bun; install it from https://bun.sh.
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const here = dirname(fileURLToPath(import.meta.url));
+let args = process.argv.slice(2);
+// `toolkit` is an optional leading verb (kept for back-compat); the headline form
+// takes plugin dirs directly, so a global `npx @kahitsan/plugin-sdk ./a ./b` works.
+if (args[0] === "toolkit") args = args.slice(1);
+const wantsHelp = args.includes("-h") || args.includes("--help");
+const dirs = args.filter((a) => !a.startsWith("-"));
+
+if (dirs.length === 0 || wantsHelp) {
+  const out = wantsHelp ? console.log : console.error;
+  out("usage: npx @kahitsan/plugin-sdk <pluginDir> [<pluginDir> …]");
+  out("");
+  out("  Boots the local dev toolkit — a dev-kernel mediator + each plugin on SQLite");
+  out("  + a synthetic logged-in admin, all from this installed package (no kernel");
+  out("  source). Load several plugins at once to exercise their cross-plugin calls:");
+  out("");
+  out("    npx @kahitsan/plugin-sdk ./kplugin_transactions ./kplugin_payees");
+  out("");
+  out("  Requires Bun (https://bun.sh). Ctrl-C stops every plugin.");
+  process.exit(wantsHelp ? 0 : 2);
+}
+
+// The harness ships as Bun source next to the package root (src/dev/), reachable from
+// the published package without any kernel checkout. dev-host.ts takes N plugin dirs.
+const devHost = join(here, "..", "src", "dev", "dev-host.ts");
+const child = spawn("bun", [devHost, ...dirs], { stdio: "inherit" });
+child.on("error", (err) => {
+  if (err && err.code === "ENOENT") {
+    console.error(
+      "The Hilinga plugin toolkit requires Bun (https://bun.sh) — install it and retry.",
+    );
+    process.exit(127);
+  }
+  console.error(err);
+  process.exit(1);
+});
+child.on("exit", (code) => process.exit(code ?? 0));