@vaubaan/harness 1.3.0 → 1.4.0

package/dist/init.d.ts

@@ -1,7 +1,21 @@
-import { E as Engine, c as RenderOutput, d as RenderedFile } from './render-B9_kNtQc.js';
+import { E as Engine, c as RenderOutput, d as RenderedFile } from './render-Cu2XrkkY.js';
 import './parser/index.js';
 import 'zod';
 
+interface RenderPlanArgs {
+    targetDir: string;
+    engines?: ReadonlyArray<string>;
+    overridesDir?: string;
+    packageDir?: string;
+    mcpServers?: ReadonlyArray<string>;
+    withStopHook?: boolean;
+}
+declare function planInit(args: RenderPlanArgs): {
+    engines: Engine[];
+    output: RenderOutput;
+    stopHookInstalled: boolean;
+};
+
 interface InitArgs {
     targetDir: string;
     engines?: ReadonlyArray<string>;
@@ -23,20 +37,29 @@ interface InitArgs {
      * `HARNESS_LINT_DISABLE=1`).
      */
     withStopHook?: boolean;
+    /** Generated files to leave to the project instead of rendering them. */
+    preserveFiles?: ReadonlyArray<string>;
+    /** Exact new backup directory, outside the project. Defaults to private user state. */
+    backupDir?: string;
 }
 interface InitResult {
+    /** Generated files the harness owns after this run, plus shared configurations it edited. */
     filesWritten: string[];
     /** Files a previous `init` rendered that this one no longer does (layout change, engine dropped). */
     staleFilesRemoved: string[];
     warnings: string[];
     stopHookInstalled: boolean;
-}
-declare function planInit(args: InitArgs): {
     engines: Engine[];
-    output: RenderOutput;
-    stopHookInstalled: boolean;
-};
+    /** Set when existing project files were changed; holds their previous contents. */
+    backupDir?: string;
+}
 declare function writeFilesToTarget(files: ReadonlyArray<RenderedFile>, targetDir: string): string[];
+/**
+ * Installs or re-renders the harness. Shares the planner of `update`: files
+ * the harness does not own are never overwritten or deleted, shared
+ * configurations are merged entry by entry, and changes are applied in one
+ * transaction (see docs/decisions/safe-init.md).
+ */
 declare function initCommand(args: InitArgs): InitResult;
 
 export { type InitArgs, type InitResult, initCommand, planInit, writeFilesToTarget };