@heyhuynhgiabuu/pi-diff 0.8.1 → 0.9.0

package/README.md

@@ -53,6 +53,12 @@ pi-diff wraps the built-in `write` and `edit` tools from the pi SDK, including s
 
 For `edit` calls, Pi's SDK performs matching, uniqueness and overlap validation, mutation queueing, and the file write. pi-diff adapts the SDK's returned unified patch into its syntax-highlighted renderer, so the preview reflects the actual matched source rather than the requested text.
 
+### `apply_patch` safety contract
+
+`apply_patch` remains a separate structured JSON tool for multi-file add, update, delete, and move operations. Paths are resolved relative to Pi's current workspace and must remain inside it; ancestor symlinks are rejected. Updates may use one `oldText`/`newText` replacement or an `edits` array of disjoint replacements matched against the original file.
+
+All changes are prepared before the first commit. A commit failure triggers reverse-order rollback, but filesystem rollback is necessarily best effort; callers should treat a failed result as requiring verification. Existing files are never intentionally clobbered by `add` or `move`, and invalid UTF-8 files are rejected rather than rewritten as text.
+
 The rendering pipeline:
 
 ```

package/dist/core/apply-patch.d.ts

@@ -2,10 +2,15 @@
  * apply_patch — Multi-file patch engine.
  *
  * One call can add, update, delete, or move multiple files.
- * Uses replace.ts's conservative matcher for oldText → newText matching.
+ * Updates use a conservative matcher and are committed only after every
+ * change has been prepared successfully.
  */
+export interface ApplyPatchEdit {
+    oldText: string;
+    newText: string;
+}
 export interface ApplyPatchChange {
-    /** Absolute path to the file. */
+    /** Path to the file, relative to the patch workspace or absolute within it. */
     path: string;
     action: "add" | "update" | "delete" | "move";
     /** Content for new files (action=add). */
@@ -14,9 +19,17 @@ export interface ApplyPatchChange {
     oldText?: string;
     /** Replacement text for updates (action=update). */
     newText?: string;
+    /** Multiple disjoint replacements for one update target. */
+    edits?: ApplyPatchEdit[];
     /** Destination path for moves (action=move). */
     movePath?: string;
 }
+export interface ApplyPatchOptions {
+    /** Base directory for relative paths. Defaults to the process cwd. */
+    cwd?: string;
+    /** Workspace boundary. Defaults to cwd. */
+    root?: string;
+}
 export interface ApplyPatchResult {
     ok: boolean;
     applied: AppliedChange[];
@@ -36,6 +49,8 @@ export interface ApplyPatchError {
     action: string;
     error: string;
 }
-export declare function executeApplyPatch(changes: ApplyPatchChange[]): Promise<ApplyPatchResult>;
+/** Decode the model-facing tool payload before it reaches the mutation core. */
+export declare function parseApplyPatchInput(input: unknown): ApplyPatchChange[];
+export declare function executeApplyPatch(changes: ApplyPatchChange[], options?: ApplyPatchOptions): Promise<ApplyPatchResult>;
 export declare function formatApplyPatchResult(result: ApplyPatchResult): string;
 //# sourceMappingURL=apply-patch.d.ts.map

package/dist/core/apply-patch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../src/core/apply-patch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,gBAAgB;IAChC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AA8KD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2D9F;AAMD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgCvE"}
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../src/core/apply-patch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAsCD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAyCvE;AAwbD,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAyG3B;AAMD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgCvE"}