keryx 0.29.0 → 0.29.4

package/initializers/redis.ts

@@ -2,6 +2,7 @@ import { Redis as RedisClient } from "ioredis";
 import { api, logger } from "../api";
 import { Initializer } from "../classes/Initializer";
 import { config } from "../config";
+
 import {
   formatConnectionStringForLogging,
   throwConnectionError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keryx",
-  "version": "0.29.0",
+  "version": "0.29.4",
   "module": "index.ts",
   "type": "module",
   "license": "MIT",

package/testing/index.ts

@@ -16,16 +16,20 @@ export {
 } from "./websocket";
 
 /**
- * Generous lifecycle hook timeout (15s) for `beforeAll` / `afterAll`.
+ * Generous lifecycle hook timeout (60s) for `beforeAll` / `afterAll`.
  *
  * `api.start()` and `api.stop()` connect to Redis, Postgres, run migrations,
- * etc. — slower than a unit test, especially in CI. Pass this as the second
- * argument to `beforeAll` / `afterAll` so hooks don't time out.
+ * load plugins, bring up workers, and start servers. That can comfortably
+ * exceed 15s on a fresh CI runner with Docker service containers, especially
+ * with plugins loaded. If it times out Bun aborts the hook and `api.stop()`
+ * runs against partially-initialized state, which cascades into confusing
+ * "api.mcp is undefined" style errors during cleanup — always prefer a higher
+ * hook timeout over adding null guards to every initializer's `stop()`.
  *
  * Note: `bun:test`'s `setDefaultTimeout` and `bunfig.toml [test].timeout` only
  * apply to `test()` blocks, not lifecycle hooks.
  */
-export const HOOK_TIMEOUT = 15_000;
+export const HOOK_TIMEOUT = 60_000;
 
 /**
  * Return the actual URL the web server bound to (with resolved port).

package/tsconfig.json

@@ -4,7 +4,7 @@
     "target": "ESNext",
     "module": "ESNext",
     "moduleResolution": "bundler",
-    "types": ["bun-types"],
+    "types": ["bun"],
     "strict": true,
     "skipLibCheck": true,
     "noEmit": true,

package/util/cli.ts

@@ -41,6 +41,10 @@ export async function buildProgram(opts: {
     .option("--no-interactive", "Skip prompts and use defaults")
     .option("--no-db", "Skip database setup files")
     .option("--no-example", "Skip example action")
+    .option(
+      "--force",
+      "Scaffold into an existing directory (skips files that already exist)",
+    )
     .action(async (projectName: string | undefined, cmdOpts) => {
       let options: ScaffoldOptions;
 
@@ -49,11 +53,12 @@ export async function buildProgram(opts: {
         options = {
           includeDb: cmdOpts.db !== false,
           includeExample: cmdOpts.example !== false,
+          force: cmdOpts.force === true,
         };
       } else {
         const result = await interactiveScaffold(projectName);
         projectName = result.projectName;
-        options = result.options;
+        options = { ...result.options, force: cmdOpts.force === true };
       }
 
       const targetDir = path.resolve(process.cwd(), projectName);

package/util/scaffold.ts

@@ -9,6 +9,12 @@ import { loadScaffoldTemplate as loadTemplate } from "./componentRegistry";
 export interface ScaffoldOptions {
   includeDb: boolean;
   includeExample: boolean;
+  /**
+   * When true, scaffold into an existing directory instead of refusing.
+   * Files that already exist on disk are left untouched (merge-skip); only
+   * missing files are created. User files are never overwritten.
+   */
+  force?: boolean;
 }
 
 async function prompt(question: string, defaultValue: string): Promise<string> {
@@ -263,9 +269,15 @@ export async function scaffoldProject(
   const keryxVersion = pkg.version;
   const createdFiles: string[] = [];
 
-  if (fs.existsSync(targetDir)) {
+  const dirExists = fs.existsSync(targetDir);
+  if (dirExists && !options.force) {
     throw new Error(`Directory "${projectName}" already exists`);
   }
+  if (dirExists && options.force) {
+    console.log(
+      `  ⚠ scaffolding into existing directory — existing files will be preserved`,
+    );
+  }
 
   fs.mkdirSync(targetDir, { recursive: true });
 
@@ -273,6 +285,10 @@ export async function scaffoldProject(
 
   const write = async (filePath: string, content: string) => {
     const fullPath = path.join(targetDir, filePath);
+    if (options.force && fs.existsSync(fullPath)) {
+      console.log(`  ⊘ skipped  ${filePath}`);
+      return;
+    }
     fs.mkdirSync(path.dirname(fullPath), { recursive: true });
     await Bun.write(fullPath, content);
     createdFiles.push(filePath);