@vibe-agent-toolkit/utils 0.2.0-rc.10 → 0.2.0-rc.12

package/dist/text-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-file.js","sourceRoot":"","sources":["../src/text-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAoB,MAAM,mBAAmB,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,OAAO,iBAAiB,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,iBAAiB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"text-file.js","sourceRoot":"","sources":["../src/text-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,IAAI,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,IAAI,EAAmB,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAoB,MAAM,mBAAmB,CAAC;AAE3F;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,OAAO,iBAAiB,CAAC,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACnC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,SAAS,CAAC,iBAAiB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,UAAU,GAAG,mBAAmB,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,mBAAmB;IAC1B,MAAM,WAAW,GAAuB,WAAW,CAAC,UAAU,CAAC;IAC/D,OAAO,WAAW,CAAC,QAAQ,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,qEAAqE;AACrE,SAAS,qBAAqB,CAAC,UAAkB;IAC/C,IAAI,sBAAsB,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,iBAAiB,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,qBAAqB,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/text.d.ts

@@ -12,5 +12,5 @@
  * `readTextContent` from `@vibe-agent-toolkit/utils/fs`, which is this plus a
  * `readFile`.
  */
-export { decodeTextContent, type DecodedText, type EncodingSource, type TextEncoding, type TextProvenance, } from './text-content.js';
+export { decodeTextContent, type DecodedText, type EncodingSource, type TextEncoding, type TextProvenance, TextTooLargeError, } from './text-content.js';
 //# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/text.js

@@ -12,5 +12,5 @@
  * `readTextContent` from `@vibe-agent-toolkit/utils/fs`, which is this plus a
  * `readFile`.
  */
-export { decodeTextContent, } from './text-content.js';
+export { decodeTextContent, TextTooLargeError, } from './text-content.js';
 //# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,iBAAiB,GAKlB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,iBAAiB,EAKjB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/timing-dump.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timing-dump.d.ts","sourceRoot":"","sources":["../src/timing-dump.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAOH;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AA6BxC;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAM3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAOjD;AAyDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,OAAO,GACnB,MAAM,GAAG,IAAI,CAoBf"}
+{"version":3,"file":"timing-dump.d.ts","sourceRoot":"","sources":["../src/timing-dump.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAQH;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AA6BxC;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAM3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAOjD;AA+CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,OAAO,GACnB,MAAM,GAAG,IAAI,CAoBf"}

package/dist/timing-dump.js

@@ -48,6 +48,7 @@
  * itself is its accumulator shape, its dump body and the noun it is called by.
  */
 import { writeFileSync } from 'node:fs';
+import { isAlreadyExistsError } from './errors/errno-table.js';
 import { safePath } from './path-core.js';
 import { mkdirSyncReal } from './path-utils.js';
 /** `process.cpuUsage()` reports microseconds; a dump reports milliseconds. */
@@ -152,15 +153,6 @@ function timingDumpCandidate(directory, stem, collision) {
     const suffix = collision === 0 ? '' : `-${String(collision)}`;
     return safePath.join(directory, `${stem}${suffix}.json`);
 }
-/**
- * Whether a caught write failure means somebody else already holds the name.
- *
- * @param error - Whatever `writeFileSync` threw
- * @returns `true` only for `EEXIST`, which is a lost race and not a fault
- */
-function isNameAlreadyTaken(error) {
-    return error instanceof Error && 'code' in error && error.code === 'EEXIST';
-}
 /**
  * Claim a name by creating it, and fill it in the same operation.
  *
@@ -185,7 +177,7 @@ function claimTimingDump(directory, basename, contents) {
             return { outcome: 'written', path: candidate };
         }
         catch (error) {
-            if (!isNameAlreadyTaken(error))
+            if (!isAlreadyExistsError(error))
                 return { outcome: 'failed', path: candidate, error };
         }
     }

package/dist/timing-dump.js.map

@@ -1 +1 @@
-{"version":3,"file":"timing-dump.js","sourceRoot":"","sources":["../src/timing-dump.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"timing-dump.js","sourceRoot":"","sources":["../src/timing-dump.ts"],"names":[],"mappings":"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"}

package/dist/tree-change/apply-decisions.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The decisions of the apply half of the tree-change primitive, and of its file helpers, that touch
+ * no filesystem: each is handed what was read and answers what to do. `apply.ts` and `files.ts` are
+ * the halves that make the calls — and hold nothing else to decide.
+ */
+import { type FsFaultFacts } from '../errors/errno-table.js';
+import { FsFaultError, type FsSide } from '../errors/fs-fault.js';
+import { VatError } from '../errors/vat-error.js';
+import type { EntryKind, PlannedChange } from './plan.js';
+/** {@link tempDirRefusal}: a directory to dispose of that is not strictly under the temp directory — a defect in the caller. */
+export declare const TEMP_DIR_OUTSIDE_TMPDIR_CODE = "TEMP_DIR_OUTSIDE_TMPDIR";
+/** A replaced entry, parked once the new one was live, that could not be removed. */
+export declare const TREE_CLEANUP_INCOMPLETE_CODE = "TREE_CLEANUP_INCOMPLETE";
+/**
+ * Whether a `write` fill's failure is the DESTINATION's: a path the failing call acted on
+ * ({@link pathsActedOn} — the one reading of an errno's two paths, so never a symlink's target
+ * text) is under the staged tree, all the callback may write. Anything else, an input the
+ * callback read (a sibling of the destination included), is not: it is rethrown as it was, for
+ * the verb's boundary to classify.
+ *
+ * @param facts - The errno, the call and the paths the OS named
+ * @param sideOf - The side a path is on, with the staged tree as the only `destination`
+ */
+export declare function fillFaultIsDestinations(facts: FsFaultFacts, sideOf: (path: string) => FsSide | undefined): boolean;
+/** What is at a destination when the apply reaches it. */
+interface DestinationNow {
+    readonly kind: EntryKind;
+    /** Whether it is a directory holding nothing; read only when the plan took an empty directory as free. */
+    readonly emptyDirectory: boolean;
+}
+/**
+ * Whether a destination is no longer what the plan decided on — staging (a whole copy, a whole
+ * build) runs between the plan and the first rename, and anything can write there meanwhile:
+ * - another KIND of entry than the plan saw (nothing where it parks; something where it creates);
+ * - a directory a `must-be-free` change took because it was EMPTY, and now is not.
+ *
+ * @returns What changed, for the refusal's wording; `undefined` when it is as planned
+ */
+export declare function changedSincePlan(planned: PlannedChange, now: DestinationNow): string | undefined;
+/**
+ * The refusal of a destination that changed under the apply: the table's `occupied` destination
+ * fault (something appeared while the command wrote), naming it and what changed. The entry is
+ * left exactly as it was found.
+ */
+export declare function changedDestinationFault(planned: PlannedChange, what: string): FsFaultError;
+/**
+ * What a finalize does with the parked entries it could not remove: a REMOVE's is thrown (removal
+ * was the job; the first one, with every other recorded beside it), a replace's is a warning — the
+ * new tree is live.
+ *
+ * @param refused - Each parked entry that would not go, with the op of its change
+ * @returns The index of the one to throw, or `undefined` when every one is a warning
+ */
+export declare function finalizeThrows(refused: ReadonlyArray<{
+    readonly op: PlannedChange['change']['op'];
+}>): number | undefined;
+/**
+ * Where the removal of the parents a create made goes next: `dir` is removed only while it is
+ * `top` (the first directory `mkdir` made) or under it, and the walk stops once `top` itself went.
+ *
+ * @param top - The first directory staging made, canonical
+ * @param dir - The directory about to be removed, canonical
+ * @returns `stop` (outside what staging made: never touched), `last` (it is `top`), or `continue` (go on to its parent)
+ */
+export declare function madeParentStep(top: string, dir: string): 'stop' | 'last' | 'continue';
+/**
+ * The refusal of a file VAT writes into a tree it is building, where what was copied into that tree
+ * already holds an entry on the way — a file or a link at the file's own name, or a link (or a file)
+ * where one of its directories goes. Whatever is there came with the tree, so it is the SOURCE's
+ * layout (origin `content`), never something to write over or through.
+ *
+ * @param entry - The entry in the way, as a path
+ * @param writing - What VAT was writing, for the message: `VAT's marketplace marker`
+ * @param cause - The errno that reported it, when one did
+ */
+export declare function entryInTheWayFault(entry: string, writing: string, cause: unknown): FsFaultError;
+/** A rename is tried this many times under win32 when the OS reports contention; the waits between are 50, 100, 200, 400, 800 ms. */
+export declare const RENAME_TRIES = 6;
+/**
+ * Whether a refused rename is tried again, and after how long: only under win32, only for
+ * contention (a scanner, an indexer, a handle still closing), and only while tries are left.
+ *
+ * @param platform - `process.platform`
+ * @param attempt - The 0-based try that just failed
+ * @param contention - Whether the errno is one a rename race raises there
+ * @returns The wait in milliseconds before the next try, or `undefined` when the refusal is final
+ */
+export declare function renameRetryDelay(platform: NodeJS.Platform, attempt: number, contention: boolean): number | undefined;
+/**
+ * The refusal — a defect in the caller — of a directory to dispose of that is not strictly under
+ * the temp directory: the disposal makes a read-only tree writable before it deletes it, so a wrong
+ * argument (an empty string, a project directory) must be refused before anything is touched.
+ *
+ * @param dir - The directory handed to the disposal
+ * @param tmp - The temp directory
+ * @param containment - Where `dir` is against `tmp`, as `isUnderRoot` judged it
+ * @returns The error to throw, or `undefined` when `dir` may be disposed of
+ */
+export declare function tempDirRefusal(dir: string, tmp: string, containment: 'inside' | 'outside' | 'absent'): VatError | undefined;
+export {};
+//# sourceMappingURL=apply-decisions.d.ts.map

package/dist/tree-change/apply-decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-decisions.d.ts","sourceRoot":"","sources":["../../src/tree-change/apply-decisions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1D,gIAAgI;AAChI,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAElH;AAED,0DAA0D;AAC1D,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,0GAA0G;IAC1G,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAMhG;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAW1F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAGzH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAIrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAU/F;AAED,qIAAqI;AACrI,eAAO,MAAM,YAAY,IAAI,CAAC;AAG9B;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpH;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAG3H"}

package/dist/tree-change/apply-decisions.js

@@ -0,0 +1,139 @@
+/**
+ * The decisions of the apply half of the tree-change primitive, and of its file helpers, that touch
+ * no filesystem: each is handed what was read and answers what to do. `apply.ts` and `files.ts` are
+ * the halves that make the calls — and hold nothing else to decide.
+ */
+import { pathsActedOn } from '../errors/errno-table.js';
+import { FsFaultError } from '../errors/fs-fault.js';
+import { VatError } from '../errors/vat-error.js';
+import { relativeEscapesRoot, safePath } from '../path-core.js';
+/** {@link tempDirRefusal}: a directory to dispose of that is not strictly under the temp directory — a defect in the caller. */
+export const TEMP_DIR_OUTSIDE_TMPDIR_CODE = 'TEMP_DIR_OUTSIDE_TMPDIR';
+/** A replaced entry, parked once the new one was live, that could not be removed. */
+export const TREE_CLEANUP_INCOMPLETE_CODE = 'TREE_CLEANUP_INCOMPLETE';
+/**
+ * Whether a `write` fill's failure is the DESTINATION's: a path the failing call acted on
+ * ({@link pathsActedOn} — the one reading of an errno's two paths, so never a symlink's target
+ * text) is under the staged tree, all the callback may write. Anything else, an input the
+ * callback read (a sibling of the destination included), is not: it is rethrown as it was, for
+ * the verb's boundary to classify.
+ *
+ * @param facts - The errno, the call and the paths the OS named
+ * @param sideOf - The side a path is on, with the staged tree as the only `destination`
+ */
+export function fillFaultIsDestinations(facts, sideOf) {
+    return pathsActedOn(facts).some((named) => sideOf(named) === 'destination');
+}
+/**
+ * Whether a destination is no longer what the plan decided on — staging (a whole copy, a whole
+ * build) runs between the plan and the first rename, and anything can write there meanwhile:
+ * - another KIND of entry than the plan saw (nothing where it parks; something where it creates);
+ * - a directory a `must-be-free` change took because it was EMPTY, and now is not.
+ *
+ * @returns What changed, for the refusal's wording; `undefined` when it is as planned
+ */
+export function changedSincePlan(planned, now) {
+    if (now.kind !== planned.existing) {
+        return `it was ${describeKind(planned.existing)} when the change was planned and is ${describeKind(now.kind)} now`;
+    }
+    const tookAsFree = planned.change.ownership.kind === 'must-be-free' && planned.existing === 'directory';
+    return tookAsFree && !now.emptyDirectory ? 'it was an empty directory when the change was planned and holds entries now' : undefined;
+}
+const describeKind = (kind) => (kind === 'absent' ? 'absent' : `a ${kind}`);
+/**
+ * The refusal of a destination that changed under the apply: the table's `occupied` destination
+ * fault (something appeared while the command wrote), naming it and what changed. The entry is
+ * left exactly as it was found.
+ */
+export function changedDestinationFault(planned, what) {
+    const { dest, label } = planned.change;
+    return new FsFaultError({
+        side: 'destination',
+        faultClass: 'occupied',
+        errno: 'EEXIST',
+        path: dest,
+        origin: 'argument',
+        action: `put ${label} in place: something else changed the destination while it was being prepared (${what}); it was left as found`,
+        cause: undefined,
+    });
+}
+/**
+ * What a finalize does with the parked entries it could not remove: a REMOVE's is thrown (removal
+ * was the job; the first one, with every other recorded beside it), a replace's is a warning — the
+ * new tree is live.
+ *
+ * @param refused - Each parked entry that would not go, with the op of its change
+ * @returns The index of the one to throw, or `undefined` when every one is a warning
+ */
+export function finalizeThrows(refused) {
+    const index = refused.findIndex((each) => each.op === 'remove');
+    return index === -1 ? undefined : index;
+}
+/**
+ * Where the removal of the parents a create made goes next: `dir` is removed only while it is
+ * `top` (the first directory `mkdir` made) or under it, and the walk stops once `top` itself went.
+ *
+ * @param top - The first directory staging made, canonical
+ * @param dir - The directory about to be removed, canonical
+ * @returns `stop` (outside what staging made: never touched), `last` (it is `top`), or `continue` (go on to its parent)
+ */
+export function madeParentStep(top, dir) {
+    const below = safePath.relative(top, dir);
+    if (relativeEscapesRoot(below))
+        return 'stop';
+    return below === '' ? 'last' : 'continue';
+}
+/**
+ * The refusal of a file VAT writes into a tree it is building, where what was copied into that tree
+ * already holds an entry on the way — a file or a link at the file's own name, or a link (or a file)
+ * where one of its directories goes. Whatever is there came with the tree, so it is the SOURCE's
+ * layout (origin `content`), never something to write over or through.
+ *
+ * @param entry - The entry in the way, as a path
+ * @param writing - What VAT was writing, for the message: `VAT's marketplace marker`
+ * @param cause - The errno that reported it, when one did
+ */
+export function entryInTheWayFault(entry, writing, cause) {
+    return new FsFaultError({
+        side: 'source',
+        faultClass: 'occupied',
+        errno: 'EEXIST',
+        path: entry,
+        origin: 'content',
+        action: `write ${writing}: the tree it goes into already holds an entry there, which VAT never writes over or through`,
+        cause,
+    });
+}
+/** A rename is tried this many times under win32 when the OS reports contention; the waits between are 50, 100, 200, 400, 800 ms. */
+export const RENAME_TRIES = 6;
+const FIRST_BACKOFF_MS = 50;
+/**
+ * Whether a refused rename is tried again, and after how long: only under win32, only for
+ * contention (a scanner, an indexer, a handle still closing), and only while tries are left.
+ *
+ * @param platform - `process.platform`
+ * @param attempt - The 0-based try that just failed
+ * @param contention - Whether the errno is one a rename race raises there
+ * @returns The wait in milliseconds before the next try, or `undefined` when the refusal is final
+ */
+export function renameRetryDelay(platform, attempt, contention) {
+    if (platform !== 'win32' || !contention || attempt + 1 >= RENAME_TRIES)
+        return undefined;
+    return FIRST_BACKOFF_MS * 2 ** attempt;
+}
+/**
+ * The refusal — a defect in the caller — of a directory to dispose of that is not strictly under
+ * the temp directory: the disposal makes a read-only tree writable before it deletes it, so a wrong
+ * argument (an empty string, a project directory) must be refused before anything is touched.
+ *
+ * @param dir - The directory handed to the disposal
+ * @param tmp - The temp directory
+ * @param containment - Where `dir` is against `tmp`, as `isUnderRoot` judged it
+ * @returns The error to throw, or `undefined` when `dir` may be disposed of
+ */
+export function tempDirRefusal(dir, tmp, containment) {
+    if (containment !== 'outside')
+        return undefined;
+    return new VatError(TEMP_DIR_OUTSIDE_TMPDIR_CODE, `Refusing to dispose of ${dir}: it is not inside the temporary directory ${tmp}`);
+}
+//# sourceMappingURL=apply-decisions.js.map

package/dist/tree-change/apply-decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-decisions.js","sourceRoot":"","sources":["../../src/tree-change/apply-decisions.ts"],"names":[],"mappings":"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"}

package/dist/tree-change/apply.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The apply half of the tree-change primitive: carry out a {@link TreePlan} as one
+ * transaction, in a fixed order —
+ *
+ * 1. **Stage** every new entry beside its destination, on the same filesystem (so
+ *    a swap never crosses devices): a `mkdtemp` directory filled by `copyTree`, a
+ *    fresh directory (plain `mkdir`, the caller's mode) filled by the `write`
+ *    callback, or a fresh name for a file or a link. A failure removes
+ *    every staged entry, and every parent directory a create made; no destination
+ *    has changed.
+ * 2. **Park** every entry being replaced or removed: `rename(dest, <staged>.previous)`.
+ *    Every park happens before any swap, so a name is free before anything lands
+ *    on it — on a case-folding filesystem `Old` and `old` are one name. Each
+ *    destination is examined again first: one that is no longer what the plan decided
+ *    on (another writer filled a directory the plan took as empty, or put an entry
+ *    where it found none) is a `destination` fault, class `occupied`, and is left as
+ *    found — the plan is rolled back.
+ * 3. **Swap** every staged entry in: `rename(staged, dest)`.
+ * 4. **`afterSwap()`** — the caller's own writes that must agree with the tree
+ *    (a registry). A throw rolls back every swap.
+ * 5. **Rollback**, when 2–4 throw: in reverse, each swapped entry is moved off its
+ *    destination and its parked entry renamed back, then the parents a create made
+ *    are removed. A parked entry is NEVER deleted on a failure path: if one cannot
+ *    be put back — or a create's new entry cannot be moved off — the error is
+ *    {@link TreeRollbackIncompleteError}, naming each.
+ * 6. **Finalize**: each parked entry is removed, its modes notwithstanding. For a
+ *    replace a refusal is only a warning ({@link TREE_CLEANUP_INCOMPLETE_CODE}): the
+ *    new tree is live. For a remove, removal is the job, so it is a `destination`
+ *    fault naming the parked path — the data is already off the user's path.
+ *
+ * Every rename is {@link renameFileAtomic}'s, retried under win32 on contention.
+ * The primitive's own filesystem faults are classified `destination` (staging sits
+ * beside the user's destination); a `copy` source's read is already classified on
+ * the fill's declared side; a
+ * `write` fill's raw errno is `destination` only when it names a path under the
+ * destination's parent — anything else (an input the callback read) is rethrown
+ * raw, for the verb's boundary to classify.
+ *
+ * A thrown failure is never mutated. What a failure path could not clean up (a
+ * staged entry, a parent, a replaced tree beside a failed remove) is recorded
+ * beside it, off its cause chain: `suppressedFaultsOf(error)`.
+ */
+import { TREE_CLEANUP_INCOMPLETE_CODE } from './apply-decisions.js';
+import { type TreePlan } from './plan.js';
+export { TREE_CLEANUP_INCOMPLETE_CODE } from './apply-decisions.js';
+export interface ApplyOptions {
+    /**
+     * Runs once every swap is done; a throw rolls every change back and is rethrown.
+     * ⚠️ Its own filesystem faults must be classified `destination` (it writes user
+     * state beside the tree): should the rollback then fail, the error becomes
+     * `TREE_ROLLBACK_INCOMPLETE` (`RUN_INCOMPLETE`), which agrees with every
+     * destination row of the refusal table and with no other side's.
+     */
+    readonly afterSwap?: () => Promise<void>;
+}
+/** A finding a successful apply reports: the change is done, something beside it is left. */
+export interface TreeChangeWarning {
+    readonly code: typeof TREE_CLEANUP_INCOMPLETE_CODE;
+    /** The entry left behind. */
+    readonly path: string;
+    readonly message: string;
+}
+export interface ApplyResult {
+    readonly warnings: readonly TreeChangeWarning[];
+}
+/**
+ * Carry out `plan`: stage, park, swap, `afterSwap`, finalize — or roll back so
+ * every destination is exactly as it was.
+ *
+ * @param plan - What `planTreeChanges` decided; `keep` and `subsumed` changes are not touched
+ * @param options - `afterSwap`, run once the new tree is in place
+ * @returns The warnings of a change that is done: a previous tree left beside a replaced one
+ * @throws the first failure, after the rollback and unchanged: an `FsFaultError` (side
+ *   `destination`, or the fill's declared side for a copy source's read), a `write` fill's own error or raw
+ *   errno, or whatever `afterSwap` threw — with what could not be cleaned up in
+ *   `suppressedFaultsOf(error)`; {@link TreeRollbackIncompleteError} (cause: that
+ *   failure) when the rollback could not undo every change; for a `remove` whose
+ *   parked entry cannot be removed, an `FsFaultError` side `destination` naming it
+ */
+export declare function applyTreePlan(plan: TreePlan, options?: ApplyOptions): Promise<ApplyResult>;
+/** What {@link applyTreePlanOrLeftover} finished with: the warnings of a clean apply, or the failure that came after the commit. */
+export interface ApplyOutcome extends ApplyResult {
+    /**
+     * The failure that came once every change was in place (and `afterSwap` had run): a parked entry of
+     * a `remove` the OS would not delete. It cannot be undone and is no refusal of the change — the
+     * change is DONE, every destination as planned — so it is returned, naming what is left (its `path`
+     * the parked entry), for the verb to report beside the work it finished. Absent when the apply finished clean.
+     */
+    readonly leftover?: unknown;
+}
+/**
+ * {@link applyTreePlan}, for a verb that reports a change it finished even when what it parked could
+ * not then be deleted (an uninstall, a clear): a failure before the commit — every swap made and
+ * `afterSwap` run — rolled back and is thrown, as by `applyTreePlan`; one after it is returned as
+ * `leftover`. The commit is the one line between "nothing finished" and "the change is done".
+ */
+export declare function applyTreePlanOrLeftover(plan: TreePlan, options?: ApplyOptions): Promise<ApplyOutcome>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/tree-change/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/tree-change/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAcH,OAAO,EAAsG,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAIxK,OAAO,EAAgD,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAKpE,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC;IACnD,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AAiQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAE9F;AAED,oIAAoI;AACpI,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAa/G"}