akanjs 2.0.5 → 2.0.6

package/cli/application/application.runner.ts

@@ -25,8 +25,8 @@ import {
   type TypecheckOptions,
   type Workspace,
 } from "akanjs/devkit";
-import openBrowser from "open";
 import ora from "ora";
+import { openBrowser } from "../openBrowser";
 
 export class ApplicationRunner extends runner("application") {
   async createApplication(appName: string, workspace: Workspace, libs: string[] = []) {

package/cli/build.ts

@@ -7,13 +7,14 @@ const OUT_DIR = process.env.DIST_DIR ?? `${WORKSPACE_ROOT}/dist/pkgs/akanjs`;
 
 const build = async () => {
   try {
+    const packageJson = await Bun.file(`${PACKAGE_DIR}/package.json`).json();
     await $`rm -rf ${OUT_DIR}/cli`;
     await Bun.build({
       entrypoints: [`${CLI_DIR}/index.ts`],
       splitting: false,
       target: "bun",
       outdir: `${OUT_DIR}/cli`,
-      external: Object.keys((await Bun.file(`${PACKAGE_DIR}/package.json`).json()).dependencies ?? {}),
+      external: Object.keys({ ...packageJson.dependencies, ...packageJson.peerDependencies }),
     });
     await $`cp -R ${CLI_DIR}/templates ${OUT_DIR}/cli/templates`;
   } catch (error) {

package/cli/cloud/cloud.runner.ts

@@ -11,10 +11,9 @@ import {
   type Workspace,
 } from "akanjs/devkit";
 import chalk from "chalk";
-import latestVersion from "latest-version";
-import open from "open";
 import * as QRcode from "qrcode";
-import { v4 as uuidv4 } from "uuid";
+import { getLatestPackageVersion } from "../npmRegistry";
+import { openBrowser } from "../openBrowser";
 
 export class CloudRunner extends runner("cloud") {
   async login() {
@@ -24,7 +23,7 @@ export class CloudRunner extends runner("cloud") {
       Logger.rawLog(chalk.green(`\n✓ Already logged in akan cloud as ${self.nickname}\n`));
       return true;
     }
-    const remoteId = uuidv4();
+    const remoteId = crypto.randomUUID();
     const signinUrl = `${akanCloudUrl}/signin?remoteId=${remoteId}`;
 
     Logger.rawLog(chalk.bold(`\n${chalk.green("➤")} Authentication Required`));
@@ -39,7 +38,7 @@ export class CloudRunner extends runner("cloud") {
         });
       });
       Logger.rawLog(qrcode);
-      await open(signinUrl);
+      await openBrowser(signinUrl);
       Logger.rawLog(chalk.dim("Opening browser..."));
     } catch {
       Logger.rawLog(chalk.yellow("Could not open browser. Please visit the URL manually."));
@@ -96,13 +95,13 @@ export class CloudRunner extends runner("cloud") {
     const tag = isOfficialRelease ? "latest" : (patchVersion.split("-").at(1) ?? "dev");
     const getNextVersion = async (prefix: string, tag: string) => {
       try {
-        const latestPublishedVersion = await latestVersion("akanjs", { version: tag });
+        const latestPublishedVersion = await getLatestPackageVersion("akanjs", tag);
         const latestPatch = latestPublishedVersion.startsWith(prefix)
           ? parseInt(latestPublishedVersion.split(".").at(-1) ?? "-1")
           : -1;
         const nextVersion = `${prefix}.${latestPatch + 1}`;
         return { nextVersion, latestPublishedVersion };
-      } catch (e) {
+      } catch {
         return { nextVersion: `${prefix}.0`, latestPublishedVersion: null };
       }
     };
@@ -147,7 +146,7 @@ export class CloudRunner extends runner("cloud") {
       ]);
   }
   async #updateAkanPkgs(workspace: Workspace, tag: string = "latest") {
-    const latestPublishedVersion = await latestVersion("akanjs", { version: tag });
+    const latestPublishedVersion = await getLatestPackageVersion("akanjs", tag);
     const rootPackageJson = await workspace.getPackageJson();
     if (!rootPackageJson.dependencies) throw new Error("No dependencies found in package.json");
     if (rootPackageJson.dependencies.akanjs) rootPackageJson.dependencies.akanjs = latestPublishedVersion;

package/cli/index.js

@@ -2203,7 +2203,7 @@ var require_source_map_support = __commonJS((exports, module) => {
 });
 
 var require_typescript = __commonJS((exports, module) => {
-  var __dirname = "/Users/kangminseon/github/Ieading-flight-guidance/node_modules/typescript/lib", __filename = "/Users/kangminseon/github/Ieading-flight-guidance/node_modules/typescript/lib/typescript.js";
+  var __dirname = "/Users/kangminseon/Desktop/Mintaka_Github/bunkan/node_modules/typescript/lib", __filename = "/Users/kangminseon/Desktop/Mintaka_Github/bunkan/node_modules/typescript/lib/typescript.js";
   
   var ts = {};
   ((module2) => {
@@ -176299,6 +176299,8 @@ var builderMsgTypeSet = new Set([
 ]);
 
 class IncrementalBuilderHost {
+  static #restartBaseDelayMs = 1000;
+  static #restartMaxDelayMs = 30000;
   logger = new Logger("IncrementalBuilderHost");
   entry;
   env;
@@ -176306,48 +176308,112 @@ class IncrementalBuilderHost {
   ready = false;
   #onMessage;
   #proc = null;
+  #status = "stopped";
+  #restartAttempts = 0;
+  #restartTimer = null;
+  #manualStop = false;
+  #startOptions = {};
   constructor({ app, entry, env, onMessage }) {
     this.app = app;
     this.entry = entry;
     this.env = env;
     this.#onMessage = onMessage;
   }
-  start({ onExit, onReady }) {
+  get status() {
+    return this.#status;
+  }
+  start(options = {}) {
     if (this.#proc)
       this.stop();
-    this.#proc = Bun.spawn(["bun", this.entry], {
+    this.#manualStop = false;
+    this.#startOptions = options;
+    this.#spawn(false);
+    return this;
+  }
+  #spawn(isRestart) {
+    this.#status = isRestart ? "restarting" : "starting";
+    this.ready = false;
+    let proc;
+    proc = Bun.spawn(["bun", this.entry], {
       cwd: this.app.cwdPath,
       env: { ...this.env, AKAN_WATCH: "1" },
       stdio: ["ignore", "inherit", "inherit"],
       ipc: (msg) => {
+        if (this.#proc !== proc)
+          return;
         if (!msg || typeof msg !== "object")
           return;
         if (builderMsgTypeSet.has(msg.type))
           this.#onMessage(msg);
         if (msg.type === "builder-ready" && !this.ready) {
           this.ready = true;
-          onReady?.();
+          this.#status = "ready";
+          this.#restartAttempts = 0;
+          if (isRestart)
+            this.#startOptions.onRestartReady?.();
+          else
+            this.#startOptions.onReady?.();
         }
       },
       serialization: "advanced",
       onExit: () => {
-        onExit?.();
+        if (this.#proc !== proc)
+          return;
+        this.#proc = null;
+        const wasReady = this.ready;
+        this.ready = false;
+        if (this.#manualStop || this.#status === "stopped")
+          return;
+        if (!wasReady) {
+          this.#status = "stopped";
+          this.#startOptions.onExit?.();
+          return;
+        }
+        this.#scheduleRestart();
       }
     });
-    this.logger.verbose(`builder spawned pid=${this.#proc.pid} entry=${this.entry}`);
-    return this;
+    this.#proc = proc;
+    this.logger.verbose(`builder spawned pid=${proc.pid} entry=${this.entry}${isRestart ? " restart=1" : ""}`);
+  }
+  #scheduleRestart() {
+    if (this.#manualStop || this.#restartTimer)
+      return;
+    this.#status = "restarting";
+    const attempt = this.#restartAttempts;
+    const delay = Math.min(IncrementalBuilderHost.#restartBaseDelayMs * 2 ** attempt, IncrementalBuilderHost.#restartMaxDelayMs);
+    this.#restartAttempts = attempt + 1;
+    this.logger.warn(`builder exited after ready; restarting in ${delay}ms (attempt ${this.#restartAttempts})`);
+    this.#restartTimer = setTimeout(() => {
+      this.#restartTimer = null;
+      if (this.#manualStop)
+        return;
+      this.#spawn(true);
+    }, delay);
   }
   send(message) {
-    if (this.#proc)
+    if (!this.#proc || this.#status !== "ready") {
+      this.logger.warn(`incrementalBuilderHost is ${this.#status}; cannot send ${message.type}`);
+      return false;
+    }
+    try {
       this.#proc.send(message);
-    else
-      this.logger.warn("incrementalBuilderHost is not running");
+      return true;
+    } catch (error) {
+      this.logger.warn(`failed to send ${message.type} to builder: ${error instanceof Error ? error.message : String(error)}`);
+      return false;
+    }
   }
   stop() {
+    this.#manualStop = true;
+    if (this.#restartTimer) {
+      clearTimeout(this.#restartTimer);
+      this.#restartTimer = null;
+    }
     if (this.#proc)
       this.#proc.kill();
     this.#proc = null;
     this.ready = false;
+    this.#status = "stopped";
   }
   static async create(app, env, onMessage) {
     const candidates = [
@@ -176365,6 +176431,8 @@ class IncrementalBuilderHost {
 var backendMsgTypeSet = new Set(["build-route"]);
 var BACKEND_RESTART_DEBOUNCE_MS = 120;
 var BACKEND_GRACEFUL_TIMEOUT_MS = 3000;
+var BACKEND_RECOVERY_BASE_DELAY_MS = 1000;
+var BACKEND_RECOVERY_MAX_DELAY_MS = 30000;
 var BUILDER_READY_TIMEOUT_MS = 15000;
 var BUILDER_START_MAX_ATTEMPTS = 3;
 var SOURCE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
@@ -176488,6 +176556,8 @@ class AkanAppHost {
   #backendReady = false;
   #plannedBackendStops = new WeakSet;
   #restartTimer = null;
+  #backendRecoveryTimer = null;
+  #backendRecoveryAttempts = 0;
   #restartFiles = new Set;
   #latestPagesUpdated = null;
   #latestCssUpdated = null;
@@ -176518,6 +176588,10 @@ class AkanAppHost {
       clearTimeout(this.#restartTimer);
       this.#restartTimer = null;
     }
+    if (this.#backendRecoveryTimer) {
+      clearTimeout(this.#backendRecoveryTimer);
+      this.#backendRecoveryTimer = null;
+    }
     await this.#stopBackend();
     this.#stopBuilder();
     return this;
@@ -176542,6 +176616,7 @@ class AkanAppHost {
           return;
         if (msg.type === "backend-ready") {
           this.#backendReady = true;
+          this.#backendRecoveryAttempts = 0;
           this.logger.verbose(`backend ready pid=${msg.pid}`);
           this.#replayBuilderState();
           return;
@@ -176558,7 +176633,7 @@ class AkanAppHost {
           this.#plannedBackendStops.delete(backend);
           return;
         }
-        this.#stopBuilder();
+        this.#scheduleBackendRecovery("backend-exit");
       }
     });
     this.#backend = backend;
@@ -176606,6 +176681,10 @@ class AkanAppHost {
   #scheduleBackendRestart(files) {
     for (const file of files)
       this.#restartFiles.add(file);
+    if (this.#backendRecoveryTimer) {
+      clearTimeout(this.#backendRecoveryTimer);
+      this.#backendRecoveryTimer = null;
+    }
     if (this.#restartTimer)
       clearTimeout(this.#restartTimer);
     this.#restartTimer = setTimeout(() => {
@@ -176617,9 +176696,27 @@ class AkanAppHost {
   }
   async#restartBackend(files) {
     this.logger.verbose(`[backend-reload] restarting backend for ${files.length} file(s)`);
+    this.#backendRecoveryAttempts = 0;
     await Promise.all([this.#stopBackend(), this.#backendGraph.refresh()]);
     this.#startBackend();
   }
+  #scheduleBackendRecovery(reason) {
+    if (this.#backendRecoveryTimer || this.#backend)
+      return;
+    const attempt = this.#backendRecoveryAttempts;
+    const delay = Math.min(BACKEND_RECOVERY_BASE_DELAY_MS * 2 ** attempt, BACKEND_RECOVERY_MAX_DELAY_MS);
+    this.#backendRecoveryAttempts = attempt + 1;
+    this.logger.warn(`[backend-recovery] backend exited unexpectedly (${reason}); restarting in ${delay}ms (attempt ${this.#backendRecoveryAttempts})`);
+    this.#backendRecoveryTimer = setTimeout(() => {
+      this.#backendRecoveryTimer = null;
+      if (this.#backend)
+        return;
+      this.#backendGraph.refresh().finally(() => {
+        if (!this.#backend)
+          this.#startBackend();
+      });
+    }, delay);
+  }
   #enqueueBuilderMessage(message) {
     this.#builderMessageQueue = this.#builderMessageQueue.then(() => this.#handleBuilderMessage(message)).catch((err) => {
       this.logger.warn(`failed to handle builder message: ${err instanceof Error ? err.message : String(err)}`);
@@ -176688,7 +176785,6 @@ class AkanAppHost {
       if (!this.#builder)
         throw new Error("Builder Not Found");
       let settled = false;
-      let ready = false;
       const settle = (fn) => {
         if (settled)
           return;
@@ -176701,24 +176797,31 @@ class AkanAppHost {
       }, BUILDER_READY_TIMEOUT_MS);
       this.#builder.start({
         onExit: () => {
-          if (settled && ready) {
-            this.#stopBackend();
-            return;
-          }
           settle(() => reject(new Error(`[cli] builder exited before emitting builder-ready (attempt ${attempt})`)));
         },
         onReady: () => {
-          ready = true;
           settle(resolve);
+        },
+        onRestartReady: () => {
+          this.logger.verbose("[builder-recovery] builder ready after restart; replaying latest state");
+          this.#replayBuilderState();
         }
       });
     });
   }
   #sendToBuilder(message) {
-    if (this.#builder)
-      this.#builder.send(message);
-    else
-      this.logger.warn("akanAppHost is not running");
+    if (this.#builder?.send(message))
+      return;
+    if (message.type === "build-route") {
+      this.#sendToBackend({
+        type: "build-route-res",
+        id: message.id,
+        ok: false,
+        error: `builder is ${this.#builder?.status ?? "stopped"}; reload after the builder is ready`
+      });
+      return;
+    }
+    this.logger.warn("akanAppHost builder is not running");
   }
   #stopBuilder() {
     if (!this.#builder)
@@ -182080,7 +182183,20 @@ var jsx_dev_runtime2 = __toESM(require_jsx_dev_runtime(), 1);
 
 import { select as select6 } from "@inquirer/prompts";
 
-import { compareVersions } from "compare-versions";
+function parseVersion(version) {
+  return version.replace(/^[^\d]*/, "").split(/[.-]/).map((part) => Number.parseInt(part, 10)).map((part) => Number.isFinite(part) ? part : 0);
+}
+function compareSemver(a, b) {
+  const left = parseVersion(a);
+  const right = parseVersion(b);
+  const length = Math.max(left.length, right.length);
+  for (let i = 0;i < length; i++) {
+    const diff = (left[i] ?? 0) - (right[i] ?? 0);
+    if (diff !== 0)
+      return diff > 0 ? 1 : -1;
+  }
+  return 0;
+}
 
 class LibraryRunner extends runner("library") {
   async createLibrary(libName, workspace) {
@@ -182124,7 +182240,7 @@ class LibraryRunner extends runner("library") {
     const allDependencies = Object.fromEntries(Object.keys({ ...libDependencies, ...rootDependencies }).map((dep) => {
       const libVersion = libDependencies[dep] ?? "0.0.0";
       const rootVersion = rootDependencies[dep] ?? "0.0.0";
-      const newerVersion = compareVersions(rootVersion, libVersion) > 0 ? rootVersion : libVersion;
+      const newerVersion = compareSemver(rootVersion, libVersion) > 0 ? rootVersion : libVersion;
       return [dep, newerVersion];
     }));
     Object.keys(allDependencies).sort().forEach((dep) => {
@@ -182180,9 +182296,17 @@ import { StringOutputParser } from "@langchain/core/output_parsers";
 import { PromptTemplate as PromptTemplate2 } from "@langchain/core/prompts";
 import { RunnableSequence as RunnableSequence2 } from "@langchain/core/runnables";
 import { ChatOpenAI as ChatOpenAI3 } from "@langchain/openai";
-import openBrowser from "open";
 import ora3 from "ora";
 
+import { spawn as spawn2 } from "child_process";
+function openBrowser(url) {
+  const command3 = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
+  const child = spawn2(command3[0], command3.slice(1), { detached: true, stdio: "ignore" });
+  child.on("error", () => {});
+  child.unref();
+  return Promise.resolve();
+}
+
 class ApplicationRunner extends runner("application") {
   async createApplication(appName, workspace, libs = []) {
     await workspace.applyTemplate({
@@ -182877,10 +183001,19 @@ class PackageScript extends script("package", [PackageRunner]) {
 
 import { confirm as confirm3 } from "@inquirer/prompts";
 import chalk7 from "chalk";
-import latestVersion from "latest-version";
-import open from "open";
 import * as QRcode from "qrcode";
-import { v4 as uuidv4 } from "uuid";
+
+async function getLatestPackageVersion(packageName, tag = "latest") {
+  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName).replace(/^%40/, "@")}`;
+  const res = await fetch(url);
+  if (!res.ok)
+    throw new Error(`Failed to fetch ${packageName} metadata from npm registry`);
+  const metadata = await res.json();
+  const version = metadata["dist-tags"]?.[tag];
+  if (!version)
+    throw new Error(`No npm dist-tag "${tag}" found for ${packageName}`);
+  return version;
+}
 
 class CloudRunner extends runner("cloud") {
   async login() {
@@ -182892,7 +183025,7 @@ class CloudRunner extends runner("cloud") {
 `));
       return true;
     }
-    const remoteId = uuidv4();
+    const remoteId = crypto.randomUUID();
     const signinUrl = `${akanCloudUrl}/signin?remoteId=${remoteId}`;
     Logger.rawLog(chalk7.bold(`
 ${chalk7.green("\u27A4")} Authentication Required`));
@@ -182908,7 +183041,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
         });
       });
       Logger.rawLog(qrcode);
-      await open(signinUrl);
+      await openBrowser(signinUrl);
       Logger.rawLog(chalk7.dim("Opening browser..."));
     } catch {
       Logger.rawLog(chalk7.yellow("Could not open browser. Please visit the URL manually."));
@@ -182969,11 +183102,11 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     const tag = isOfficialRelease ? "latest" : patchVersion.split("-").at(1) ?? "dev";
     const getNextVersion = async (prefix, tag2) => {
       try {
-        const latestPublishedVersion2 = await latestVersion("akanjs", { version: tag2 });
+        const latestPublishedVersion2 = await getLatestPackageVersion("akanjs", tag2);
         const latestPatch = latestPublishedVersion2.startsWith(prefix) ? parseInt(latestPublishedVersion2.split(".").at(-1) ?? "-1") : -1;
         const nextVersion2 = `${prefix}.${latestPatch + 1}`;
         return { nextVersion: nextVersion2, latestPublishedVersion: latestPublishedVersion2 };
-      } catch (e) {
+      } catch {
         return { nextVersion: `${prefix}.0`, latestPublishedVersion: null };
       }
     };
@@ -183012,7 +183145,7 @@ ${chalk7.green("\u27A4")} Authentication Required`));
       ]);
   }
   async#updateAkanPkgs(workspace, tag = "latest") {
-    const latestPublishedVersion = await latestVersion("akanjs", { version: tag });
+    const latestPublishedVersion = await getLatestPackageVersion("akanjs", tag);
     const rootPackageJson = await workspace.getPackageJson();
     if (!rootPackageJson.dependencies)
       throw new Error("No dependencies found in package.json");
@@ -183685,7 +183818,13 @@ var requestUnit = ({
 
 	`;
 
-import pluralize from "pluralize";
+function pluralizeName(name) {
+  if (/[^aeiou]y$/i.test(name))
+    return `${name.slice(0, -1)}ies`;
+  if (/(s|x|z|ch|sh)$/i.test(name))
+    return `${name}es`;
+  return `${name}s`;
+}
 
 class ModuleRunner extends runner("module") {
   async createModule(workspace, sysType, sysName, moduleName, description) {}
@@ -183706,7 +183845,7 @@ class ModuleRunner extends runner("module") {
     };
   }
   async createModuleTemplate(module) {
-    const names = pluralize(module.name);
+    const names = pluralizeName(module.name);
     await module.applyTemplate({
       basePath: `.`,
       template: "module",
@@ -183916,11 +184055,7 @@ class PageCommand extends command("page", [PageScript], ({ public: target }) =>
 })) {
 }
 
-import pluralize3 from "pluralize";
-
 import { input as input5 } from "@inquirer/prompts";
-import pluralize2 from "pluralize";
-
 class ScalarPrompt extends Prompter {
   sys;
   name;
@@ -183940,7 +184075,7 @@ class ScalarPrompt extends Prompter {
     await this.sys.applyTemplate({
       basePath: "./lib/__scalar",
       template: "__scalar",
-      dict: { model: this.name, models: pluralize2(this.name), sysName: this.sys.name }
+      dict: { model: this.name, models: pluralizeName(this.name), sysName: this.sys.name }
     });
     const boilerplate = await this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.constant.ts`);
     return await this.#requestConstant({
@@ -184044,7 +184179,7 @@ class ScalarRunner extends runner("scalar") {
     await sys3.applyTemplate({
       basePath: "./lib/__scalar",
       template: "__scalar",
-      dict: { model: scalarName, models: pluralize3(scalarName), sysName: sys3.name },
+      dict: { model: scalarName, models: pluralizeName(scalarName), sysName: sys3.name },
       overwrite: false
     });
   }
@@ -184100,15 +184235,13 @@ class ScalarCommand extends command("scalar", [ScalarScript], ({ public: target
 import path38 from "path";
 
 import path37 from "path";
-import latestVersion2 from "latest-version";
-
 class WorkspaceRunner extends runner("workspace") {
   async createWorkspace(repoName, appName, { dirname: dirname3 = ".", init = true, akanVersion }) {
     const cwdPath = process.cwd();
     const workspaceRoot = path37.join(cwdPath, dirname3, repoName);
     const workspace = WorkspaceExecutor.fromRoot({ workspaceRoot, repoName });
     const templateSpinner = workspace.spinning(`Creating workspace template files in ${dirname3}/${repoName}...`);
-    const latestTypesBunVersion = await latestVersion2("@types/bun");
+    const latestTypesBunVersion = await getLatestPackageVersion("@types/bun");
     await workspace.applyTemplate({
       basePath: ".",
       template: "workspaceRoot",

package/cli/library/library.runner.ts

@@ -1,5 +1,5 @@
 import { type Lib, LibExecutor, runner, type Workspace } from "akanjs/devkit";
-import { compareVersions } from "compare-versions";
+import { compareSemver } from "../semver";
 
 export class LibraryRunner extends runner("library") {
   async createLibrary(libName: string, workspace: Workspace) {
@@ -44,7 +44,7 @@ export class LibraryRunner extends runner("library") {
       Object.keys({ ...libDependencies, ...rootDependencies }).map((dep) => {
         const libVersion = libDependencies[dep] ?? "0.0.0";
         const rootVersion = rootDependencies[dep] ?? "0.0.0";
-        const newerVersion = compareVersions(rootVersion, libVersion) > 0 ? rootVersion : libVersion;
+        const newerVersion = compareSemver(rootVersion, libVersion) > 0 ? rootVersion : libVersion;
         return [dep, newerVersion];
       }),
     );

package/cli/module/module.runner.ts

@@ -1,6 +1,6 @@
 import { capitalize } from "akanjs/common";
 import { type Module, runner, type Workspace } from "akanjs/devkit";
-import pluralize from "pluralize";
+import { pluralizeName } from "../pluralizeName";
 
 export class ModuleRunner extends runner("module") {
   async createModule(
@@ -30,7 +30,7 @@ export class ModuleRunner extends runner("module") {
   }
 
   async createModuleTemplate(module: Module) {
-    const names = pluralize(module.name);
+    const names = pluralizeName(module.name);
     await module.applyTemplate({
       basePath: `.`,
       template: "module",

package/cli/npmRegistry.ts

@@ -0,0 +1,13 @@
+interface NpmPackageMetadata {
+  "dist-tags"?: Record<string, string>;
+}
+
+export async function getLatestPackageVersion(packageName: string, tag = "latest"): Promise<string> {
+  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName).replace(/^%40/, "@")}`;
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch ${packageName} metadata from npm registry`);
+  const metadata = (await res.json()) as NpmPackageMetadata;
+  const version = metadata["dist-tags"]?.[tag];
+  if (!version) throw new Error(`No npm dist-tag "${tag}" found for ${packageName}`);
+  return version;
+}

package/cli/openBrowser.ts

@@ -0,0 +1,15 @@
+import { spawn } from "node:child_process";
+
+export function openBrowser(url: string): Promise<void> {
+  const command =
+    process.platform === "darwin"
+      ? ["open", url]
+      : process.platform === "win32"
+        ? ["cmd", "/c", "start", "", url]
+        : ["xdg-open", url];
+  const child = spawn(command[0], command.slice(1), { detached: true, stdio: "ignore" });
+  child.on("error", () => {
+  });
+  child.unref();
+  return Promise.resolve();
+}

package/cli/pluralizeName.ts

@@ -0,0 +1,5 @@
+export function pluralizeName(name: string): string {
+  if (/[^aeiou]y$/i.test(name)) return `${name.slice(0, -1)}ies`;
+  if (/(s|x|z|ch|sh)$/i.test(name)) return `${name}es`;
+  return `${name}s`;
+}

package/cli/scalar/scalar.prompt.ts

@@ -1,6 +1,6 @@
 import { input } from "@inquirer/prompts";
 import { type FileContent, Prompter, type Sys } from "akanjs/devkit";
-import pluralize from "pluralize";
+import { pluralizeName } from "../pluralizeName";
 
 export class ScalarPrompt extends Prompter {
   constructor(
@@ -20,7 +20,7 @@ export class ScalarPrompt extends Prompter {
     await this.sys.applyTemplate({
       basePath: "./lib/__scalar",
       template: "__scalar",
-      dict: { model: this.name, models: pluralize(this.name), sysName: this.sys.name },
+      dict: { model: this.name, models: pluralizeName(this.name), sysName: this.sys.name },
     });
     const boilerplate = await this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.constant.ts`);
     return await this.#requestConstant({

package/cli/scalar/scalar.runner.ts

@@ -1,5 +1,5 @@
 import { AiSession, runner, type Sys } from "akanjs/devkit";
-import pluralize from "pluralize";
+import { pluralizeName } from "../pluralizeName";
 
 import { ScalarPrompt } from "./scalar.prompt";
 
@@ -8,7 +8,7 @@ export class ScalarRunner extends runner("scalar") {
     await sys.applyTemplate({
       basePath: "./lib/__scalar",
       template: "__scalar",
-      dict: { model: scalarName, models: pluralize(scalarName), sysName: sys.name },
+      dict: { model: scalarName, models: pluralizeName(scalarName), sysName: sys.name },
       overwrite: false,
     });
   }

package/cli/semver.ts

@@ -0,0 +1,18 @@
+function parseVersion(version: string): number[] {
+  return version
+    .replace(/^[^\d]*/, "")
+    .split(/[.-]/)
+    .map((part) => Number.parseInt(part, 10))
+    .map((part) => (Number.isFinite(part) ? part : 0));
+}
+
+export function compareSemver(a: string, b: string): number {
+  const left = parseVersion(a);
+  const right = parseVersion(b);
+  const length = Math.max(left.length, right.length);
+  for (let i = 0; i < length; i++) {
+    const diff = (left[i] ?? 0) - (right[i] ?? 0);
+    if (diff !== 0) return diff > 0 ? 1 : -1;
+  }
+  return 0;
+}