keryx 0.29.0 → 0.29.1

package/package.json

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

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);